| name | config-sync-cli-workflow |
| description | Orchestrate multi-target CLI configuration synchronization using config-sync phase runners and planners. |
| allowed-tools | Bash(commands/config-sync/sync-cli.sh *), Bash(commands/config-sync/lib/phases/*.sh *), Bash(commands/config-sync/lib/planners/*.sh *) |
| metadata | [object Object] |
Purpose
Drive the multi-target config-sync CLI workflow using the defined phase pipeline with consistent backup and audit behavior.
IO Semantics
Input: CLI arguments, settings.json parameters, existing plan files, target tool configuration directories.
Output: Execution plans, phase execution metadata, run logs, and backup records.
Side Effects: Writes plan files, creates backups under backup directories, updates target configuration files when write phases execute.
Deterministic Steps
Parameter Normalization
- Read CLI arguments and merge with settings.json.
- Resolve target list and component selection.
Plan Creation or Loading
- Create a new plan describing collect, analyze, plan, prepare, adapt, execute, verify, cleanup, report phases; or load an existing plan file.
Phase Execution
- Run collect and analyze to discover current configuration state.
- Run plan and prepare to build and validate the execution plan, including backup locations.
- Run adapt and execute to apply changes for selected targets and components.
- Run verify, cleanup, and report to validate results, manage temporary artifacts, and emit summaries.
Result Persistence
- Persist plan updates, run metadata, and logs into backup directories.