| name | preset-cli-mutations |
| description | State-changing Preset `sup` CLI workflows: chart/dashboard/dataset push, user push/invite, destructive flags, and cross-workspace sync. Use only for CLI mutation workflows. Do not use for MCP-only work. Do not use for direct HTTP/SDK mutations. |
preset-cli-mutations
Use for state-changing CLI operations: single-workspace writes (push, --force, --overwrite) and cross-workspace promotion (sync).
Always
- Use
preset-cli first to establish auth, workspace, and output context.
- CLI mutation surface only; route HTTP mutations to
preset-api-skills.
- Preview before execution: native
--dry-run for sup sync run, sup user push, and sup user invite; pull-and-diff for sup chart push / sup dashboard push / sup dataset push (no native --dry-run).
- Identify source AND target workspace explicitly before any cross-workspace operation.
- Require explicit typed user confirmation that contains the literal
--force / --overwrite flag string when applicable.
- Redact tokens and credential-bearing output in transcripts.
Decision Rules
- Distinguish single-workspace writes (
sup chart/dashboard/dataset push) from cross-workspace sync (sup sync run).
- Treat
--force and --overwrite as destructive flags; never invoke without explicit per-flag confirmation.
- For mutating command groups not named on this card, load command coverage and stop unless it explicitly marks the command as mutation-gated.
- Do not let CI / automation context bypass the confirmation step; refuse if no interactive operator is available.
- Route HTTP mutations to the API plugin; route MCP-driven workflows to the MCP plugin.
Workflow Order
- Resolve source and (if cross-workspace) target workspace.
- Validate configuration where the command supports it (e.g.
sup sync validate) before previewing.
- Preview / diff to surface what will change.
- Summarize asset counts, target effects, rollback expectations, and any destructive flags.
- Ask for typed confirmation containing the literal destructive flag string.
- Stop before execution and wait for the typed confirmation.
- Execute only after confirmation.
Retrieve
- Single-workspace writes (push,
--overwrite, --force, dependency handling): references/write-operations.md
- Cross-workspace promotion (sync, source/target, Jinja2,
--dry-run): references/cross-workspace-sync.md
- Sync templating, rollback, and multi-target risk: references/sync-templating-and-rollback.md
- Preview and dry-run handling: references/preview-and-dry-run.md
- Confirmation template and abort triggers: references/confirmation-template.md
- Confirmation overview and audit expectations: references/confirmation-and-dry-run.md
- Registered command coverage and uncovered mutation routing: load
preset-cli and then references/command-coverage.md.
- Approval gates, redaction, abort triggers: load
preset-cli and then references/safety-policy.md.
