Gov Uninstall

/gov_uninstall

Purpose

Provide an official uninstall path for workspace governance artifacts created by bootstrap/migration. This command is for workspace cleanup + legacy restore, not plugin package removal.

Inputs

• Optional mode:
  • quick (recommended one-click chain)
  • check or uninstall
  • alias: auto (same as quick)

Hard rules

1. Explicit /gov_uninstall uninstall MUST execute uninstall workflow; do not downgrade to read-only.
2. Uninstall must create workspace backup evidence under archive/_gov_uninstall_backup_<ts>/ before removals.
3. Legacy restore must prefer latest archive/_bootstrap_backup_<ts>/ when available.
4. Do not patch platform control-plane files (for example ~/.openclaw/openclaw.json) inside this command.
5. This command must never claim completion without a run report under _runs/.

Deterministic runner (authoritative)

• check: node {plugin_root}/tools/gov_uninstall_sync.mjs check
• uninstall: node {plugin_root}/tools/gov_uninstall_sync.mjs uninstall
• quick/auto:
  • run check
  • if status is RESIDUAL, run uninstall
  • if status is CLEAN, stop with CLEAN

Expected behavior

1. check mode:
   • detect governance residuals under workspace (prompts/governance, skills/gov_*, governance _control/*, governance run files, governance BOOT markers)
   • report restore candidates from latest bootstrap backup
   • detect Brain Docs autofix backup roots (archive/_brain_docs_autofix_<ts>/) and restore candidates
   • return CLEAN or RESIDUAL
2. quick/auto mode:
   • execute check -> uninstall automatically when residual exists
   • keep backup-first safety and run-report evidence rules unchanged
   • return PASS/CLEAN/BLOCKED with explicit next steps
3. uninstall mode:
   • backup detected residual paths first
   • remove detected governance residual paths
   • restore legacy files from latest bootstrap backup when available
   • restore Brain Docs from detected autofix backup plan (deterministic strategy reported in output)
   • write run report _runs/gov_uninstall_<ts>.md
   • return PASS or BLOCKED

Output order

1. STATUS
2. WHY
3. NEXT STEP (Operator)
4. COMMAND TO COPY

Operator notes

• Never uninstall plugin package first. Default to one-click /gov_uninstall quick (or /gov_uninstall auto) for safe cleanup; use /gov_uninstall check as optional strict verification before/after uninstall.
• After workspace uninstall PASS, disable or uninstall the plugin package with official OpenClaw commands.
• If warnings mention missing legacy backups, recovery files are still preserved in _gov_uninstall_backup_<ts>.