preset-cli-mutations

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

1. Resolve source and (if cross-workspace) target workspace.
2. Validate configuration where the command supports it (e.g. sup sync validate) before previewing.
3. Preview / diff to surface what will change.
4. Summarize asset counts, target effects, rollback expectations, and any destructive flags.
5. Ask for typed confirmation containing the literal destructive flag string.
6. Stop before execution and wait for the typed confirmation.
7. 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.