{
  "schemaVersion": "workspai-cli-runtime-command-inventory-v1",
  "commands": [
    {
      "path": [
        "adopt"
      ],
      "command": "adopt",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "Adopt an existing local project into a Workspai workspace without moving or copying source",
      "hidden": false,
      "arguments": [
        {
          "name": "source",
          "required": false,
          "variadic": false
        }
      ],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--name <projectName>",
          "attributeName": "name"
        },
        {
          "flags": "--enable-modules",
          "attributeName": "enableModules"
        },
        {
          "flags": "--project-grounding <mode>",
          "attributeName": "projectGrounding"
        },
        {
          "flags": "--dry-run",
          "attributeName": "dryRun"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "agent"
      ],
      "command": "agent",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "Bootstrap coding agents from canonical Workspai project evidence",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "agent",
        "bootstrap"
      ],
      "command": "bootstrap",
      "parent": "agent",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Issue a portable canonical-first grounding receipt for the current project",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--project <path>",
          "attributeName": "project"
        },
        {
          "flags": "--for-agent <agent>",
          "attributeName": "forAgent"
        },
        {
          "flags": "--no-live-inputs",
          "attributeName": "liveInputs"
        },
        {
          "flags": "--strict",
          "attributeName": "strict"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "agent",
        "framework"
      ],
      "command": "framework",
      "parent": "agent",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Create and attach release-admitted agent runtimes through Workspai governance",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "agent",
        "framework",
        "apply"
      ],
      "command": "apply",
      "parent": "agent framework",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Apply an already authorized hash-bound framework plan",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--change <change-id>",
          "attributeName": "change"
        },
        {
          "flags": "--project <name>",
          "attributeName": "project"
        },
        {
          "flags": "--runtime <runtime>",
          "attributeName": "runtime"
        },
        {
          "flags": "--framework <framework>",
          "attributeName": "framework"
        },
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "agent",
        "framework",
        "attach"
      ],
      "command": "attach",
      "parent": "agent framework",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Plan, approve, and write one isolated governed agent instance",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "-y, --yes",
          "attributeName": "yes"
        },
        {
          "flags": "--granted-by <identity>",
          "attributeName": "grantedBy"
        },
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--project <name>",
          "attributeName": "project"
        },
        {
          "flags": "--runtime <runtime>",
          "attributeName": "runtime"
        },
        {
          "flags": "--framework <framework>",
          "attributeName": "framework"
        },
        {
          "flags": "--name <name>",
          "attributeName": "name"
        },
        {
          "flags": "--goal <goal-id>",
          "attributeName": "goal"
        },
        {
          "flags": "--intent <text>",
          "attributeName": "intent"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "agent",
        "framework",
        "list"
      ],
      "command": "list",
      "parent": "agent framework",
      "registrationKind": "commander",
      "aliases": [],
      "description": "List tested framework runtimes and their release-admission state",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "agent",
        "framework",
        "plan"
      ],
      "command": "plan",
      "parent": "agent framework",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Create a hash-bound attachment plan without writing project files",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--project <name>",
          "attributeName": "project"
        },
        {
          "flags": "--runtime <runtime>",
          "attributeName": "runtime"
        },
        {
          "flags": "--framework <framework>",
          "attributeName": "framework"
        },
        {
          "flags": "--name <name>",
          "attributeName": "name"
        },
        {
          "flags": "--goal <goal-id>",
          "attributeName": "goal"
        },
        {
          "flags": "--intent <text>",
          "attributeName": "intent"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "ai"
      ],
      "command": "ai",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "AI-powered features",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "ai",
        "generate-embeddings"
      ],
      "command": "generate-embeddings",
      "parent": "ai",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Generate AI embeddings for all modules (one-time setup)",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--force",
          "attributeName": "force"
        }
      ]
    },
    {
      "path": [
        "ai",
        "info"
      ],
      "command": "info",
      "parent": "ai",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Show AI features information",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "ai",
        "recommend"
      ],
      "command": "recommend",
      "parent": "ai",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Get AI-powered module recommendations",
      "hidden": false,
      "arguments": [
        {
          "name": "query",
          "required": false,
          "variadic": false
        }
      ],
      "options": [
        {
          "flags": "-n, --number <count>",
          "attributeName": "number"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "ai",
        "update-embeddings"
      ],
      "command": "update-embeddings",
      "parent": "ai",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Update existing embeddings with latest modules",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "analyze"
      ],
      "command": "analyze",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "Analyze workspace/project health and generate enterprise-ready evidence",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--output <file>",
          "attributeName": "output"
        },
        {
          "flags": "--strict",
          "attributeName": "strict"
        }
      ]
    },
    {
      "path": [
        "autopilot"
      ],
      "command": "autopilot",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "Run end-to-end release autopilot workflows",
      "hidden": false,
      "arguments": [
        {
          "name": "action",
          "required": true,
          "variadic": false
        }
      ],
      "options": [
        {
          "flags": "--mode <mode>",
          "attributeName": "mode"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--output <file>",
          "attributeName": "output"
        },
        {
          "flags": "--since <ref>",
          "attributeName": "since"
        },
        {
          "flags": "--parallel",
          "attributeName": "parallel"
        },
        {
          "flags": "--max-workers <count>",
          "attributeName": "maxWorkers"
        }
      ]
    },
    {
      "path": [
        "bootstrap"
      ],
      "command": "bootstrap",
      "parent": null,
      "registrationKind": "manual-handler",
      "aliases": [],
      "description": "Bootstrap project or workspace dependencies through runtime-aware setup rules.",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "cache"
      ],
      "command": "cache",
      "parent": null,
      "registrationKind": "manual-handler",
      "aliases": [],
      "description": "Inspect or clear Workspai cache state through the managed cache boundary.",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "change"
      ],
      "command": "change",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "Create and verify tamper-evident, architecture-aware change capsules",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "change",
        "abort"
      ],
      "command": "abort",
      "parent": "change",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Terminate an open change without deleting evidence",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--change <change-id>",
          "attributeName": "change"
        },
        {
          "flags": "--reason <text>",
          "attributeName": "reason"
        },
        {
          "flags": "--actor <identity>",
          "attributeName": "actor"
        }
      ]
    },
    {
      "path": [
        "change",
        "authorize"
      ],
      "command": "authorize",
      "parent": "change",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Grant bounded effect capabilities",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--change <change-id>",
          "attributeName": "change"
        },
        {
          "flags": "--effects <classes>",
          "attributeName": "effects"
        },
        {
          "flags": "--granted-by <identity>",
          "attributeName": "grantedBy"
        }
      ]
    },
    {
      "path": [
        "change",
        "begin"
      ],
      "command": "begin",
      "parent": "change",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Pin an active Goal and architecture baseline",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--goal <goal-id>",
          "attributeName": "goal"
        }
      ]
    },
    {
      "path": [
        "change",
        "capsule"
      ],
      "command": "capsule",
      "parent": "change",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Validate or export a change capsule",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "change",
        "capsule",
        "export"
      ],
      "command": "export",
      "parent": "change capsule",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Export a validated portable capsule manifest",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--change <change-id>",
          "attributeName": "change"
        },
        {
          "flags": "--output <path>",
          "attributeName": "output"
        }
      ]
    },
    {
      "path": [
        "change",
        "capsule",
        "validate"
      ],
      "command": "validate",
      "parent": "change capsule",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Validate capsule and referenced local evidence",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--change <change-id>",
          "attributeName": "change"
        }
      ]
    },
    {
      "path": [
        "change",
        "effect"
      ],
      "command": "effect",
      "parent": "change",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Record typed observed effects",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "change",
        "effect",
        "record"
      ],
      "command": "record",
      "parent": "change effect",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Append an idempotent effect receipt",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--change <change-id>",
          "attributeName": "change"
        },
        {
          "flags": "--file <receipt.json>",
          "attributeName": "file"
        }
      ]
    },
    {
      "path": [
        "change",
        "explain"
      ],
      "command": "explain",
      "parent": "change",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Explain proof, uncertainty, and next actions",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--change <change-id>",
          "attributeName": "change"
        }
      ]
    },
    {
      "path": [
        "change",
        "list"
      ],
      "command": "list",
      "parent": "change",
      "registrationKind": "commander",
      "aliases": [],
      "description": "List discoverable change capsules and integrity",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "change",
        "predict"
      ],
      "command": "predict",
      "parent": "change",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Attach a noncanonical architecture prediction",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--change <change-id>",
          "attributeName": "change"
        },
        {
          "flags": "--file <prediction.json>",
          "attributeName": "file"
        }
      ]
    },
    {
      "path": [
        "change",
        "resume"
      ],
      "command": "resume",
      "parent": "change",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Resume a blocked transaction with human intent",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--change <change-id>",
          "attributeName": "change"
        },
        {
          "flags": "--to <state>",
          "attributeName": "to"
        },
        {
          "flags": "--reason <text>",
          "attributeName": "reason"
        },
        {
          "flags": "--actor <identity>",
          "attributeName": "actor"
        }
      ]
    },
    {
      "path": [
        "change",
        "status"
      ],
      "command": "status",
      "parent": "change",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Inspect the derived transaction and assurance state",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--change <change-id>",
          "attributeName": "change"
        }
      ]
    },
    {
      "path": [
        "change",
        "verification"
      ],
      "command": "verification",
      "parent": "change",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Record independent Goal-criterion verification",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "change",
        "verification",
        "record"
      ],
      "command": "record",
      "parent": "change verification",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Append an exact-generation verification receipt",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--change <change-id>",
          "attributeName": "change"
        },
        {
          "flags": "--file <receipt.json>",
          "attributeName": "file"
        }
      ]
    },
    {
      "path": [
        "change",
        "verify"
      ],
      "command": "verify",
      "parent": "change",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Re-observe architecture and verify exact effects",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--change <change-id>",
          "attributeName": "change"
        },
        {
          "flags": "--strict",
          "attributeName": "strict"
        },
        {
          "flags": "--no-refresh",
          "attributeName": "refresh"
        }
      ]
    },
    {
      "path": [
        "commands"
      ],
      "command": "commands",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "Show effective Workspai command ownership and runtime support",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "config"
      ],
      "command": "config",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "Configure Workspai settings",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "config",
        "ai"
      ],
      "command": "ai",
      "parent": "config",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Enable or disable AI features (enable|disable)",
      "hidden": false,
      "arguments": [
        {
          "name": "action",
          "required": true,
          "variadic": false
        }
      ],
      "options": []
    },
    {
      "path": [
        "config",
        "remove-api-key"
      ],
      "command": "remove-api-key",
      "parent": "config",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Remove stored OpenAI API key",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--yes",
          "attributeName": "yes"
        }
      ]
    },
    {
      "path": [
        "config",
        "set-api-key"
      ],
      "command": "set-api-key",
      "parent": "config",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Set OpenAI API key for AI features",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--key <key>",
          "attributeName": "key"
        }
      ]
    },
    {
      "path": [
        "config",
        "show"
      ],
      "command": "show",
      "parent": "config",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Show current configuration",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "create"
      ],
      "command": "create",
      "parent": null,
      "registrationKind": "manual-handler",
      "aliases": [],
      "description": "Create a supported workspace or project through the canonical planner boundary.",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "doctor"
      ],
      "command": "doctor",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "🩺 Check Workspai system health by default; use workspace or project for scoped checks",
      "hidden": false,
      "arguments": [
        {
          "name": "scope",
          "required": false,
          "variadic": false
        }
      ],
      "options": [
        {
          "flags": "--workspace [path]",
          "attributeName": "workspace"
        },
        {
          "flags": "--project",
          "attributeName": "project"
        },
        {
          "flags": "--json [mode]",
          "attributeName": "json"
        },
        {
          "flags": "--fresh",
          "attributeName": "fresh"
        },
        {
          "flags": "--verbose",
          "attributeName": "verbose"
        },
        {
          "flags": "--strict",
          "attributeName": "strict"
        },
        {
          "flags": "--ci",
          "attributeName": "ci"
        },
        {
          "flags": "--profile <profile>",
          "attributeName": "profile"
        },
        {
          "flags": "--fix",
          "attributeName": "fix"
        },
        {
          "flags": "--plan",
          "attributeName": "plan"
        },
        {
          "flags": "--apply",
          "attributeName": "apply"
        },
        {
          "flags": "--runtime <runtime>",
          "attributeName": "runtime"
        },
        {
          "flags": "--framework <framework>",
          "attributeName": "framework"
        },
        {
          "flags": "--validate",
          "attributeName": "validate"
        },
        {
          "flags": "--write",
          "attributeName": "write"
        }
      ]
    },
    {
      "path": [
        "goal"
      ],
      "command": "goal",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "Compile a plain-language engineering intent into a governed, evidence-bound Goal Pack",
      "hidden": false,
      "arguments": [
        {
          "name": "intent",
          "required": false,
          "variadic": false
        }
      ],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--scope <scope>",
          "attributeName": "scope"
        },
        {
          "flags": "--runtime <runtime>",
          "attributeName": "runtime"
        },
        {
          "flags": "--for-agent <consumer>",
          "attributeName": "forAgent"
        },
        {
          "flags": "--max-attempts <count>",
          "attributeName": "maxAttempts"
        },
        {
          "flags": "--refresh",
          "attributeName": "refresh"
        },
        {
          "flags": "--dry-run",
          "attributeName": "dryRun"
        },
        {
          "flags": "--status [goal-id]",
          "attributeName": "status"
        },
        {
          "flags": "--list",
          "attributeName": "list"
        },
        {
          "flags": "--activate <goal-id>",
          "attributeName": "activate"
        },
        {
          "flags": "--cancel <goal-id>",
          "attributeName": "cancel"
        },
        {
          "flags": "--prepare <goal-id>",
          "attributeName": "prepare"
        },
        {
          "flags": "--verify <goal-id>",
          "attributeName": "verify"
        },
        {
          "flags": "--no-run",
          "attributeName": "run"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "import"
      ],
      "command": "import",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "Import a local project folder or clone a git repository into the current workspace",
      "hidden": false,
      "arguments": [
        {
          "name": "source",
          "required": true,
          "variadic": false
        }
      ],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--name <projectName>",
          "attributeName": "name"
        },
        {
          "flags": "--enable-modules",
          "attributeName": "enableModules"
        },
        {
          "flags": "--project-grounding <mode>",
          "attributeName": "projectGrounding"
        },
        {
          "flags": "--git",
          "attributeName": "git"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "infra"
      ],
      "command": "infra",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "Plan and manage workspace infrastructure (Docker sidecar stack)",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "infra",
        "down"
      ],
      "command": "down",
      "parent": "infra",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Stop planned infrastructure services",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--volumes",
          "attributeName": "volumes"
        }
      ]
    },
    {
      "path": [
        "infra",
        "plan"
      ],
      "command": "plan",
      "parent": "infra",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Discover infra needs and generate compose plan artifacts",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--dry-run",
          "attributeName": "dryRun"
        },
        {
          "flags": "--verbose",
          "attributeName": "verbose"
        }
      ]
    },
    {
      "path": [
        "infra",
        "status"
      ],
      "command": "status",
      "parent": "infra",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Show Docker Compose status for planned infrastructure",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--strict",
          "attributeName": "strict"
        }
      ]
    },
    {
      "path": [
        "infra",
        "up"
      ],
      "command": "up",
      "parent": "infra",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Start planned infrastructure services via Docker Compose",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--detach",
          "attributeName": "detach"
        },
        {
          "flags": "--build",
          "attributeName": "build"
        },
        {
          "flags": "--no-plan",
          "attributeName": "plan"
        }
      ]
    },
    {
      "path": [
        "live"
      ],
      "command": "live",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "Open a live cross-terminal execution graph for Workspai activity",
      "hidden": false,
      "arguments": [
        {
          "name": "target",
          "required": false,
          "variadic": false
        }
      ],
      "options": [
        {
          "flags": "--global",
          "attributeName": "global"
        },
        {
          "flags": "--run <runId>",
          "attributeName": "run"
        },
        {
          "flags": "--once",
          "attributeName": "once"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--projection <projection>",
          "attributeName": "projection"
        },
        {
          "flags": "--refresh-ms <milliseconds>",
          "attributeName": "refreshMs"
        },
        {
          "flags": "--max-runs <count>",
          "attributeName": "maxRuns"
        },
        {
          "flags": "--max-scopes <count>",
          "attributeName": "maxScopes"
        },
        {
          "flags": "--classic",
          "attributeName": "classic"
        },
        {
          "flags": "--no-color",
          "attributeName": "color"
        },
        {
          "flags": "--no-motion",
          "attributeName": "motion"
        },
        {
          "flags": "--ascii",
          "attributeName": "ascii"
        },
        {
          "flags": "--accessible",
          "attributeName": "accessible"
        },
        {
          "flags": "--capture <file>",
          "attributeName": "capture"
        },
        {
          "flags": "--capture-preset <preset>",
          "attributeName": "capturePreset"
        },
        {
          "flags": "--capture-theme <theme>",
          "attributeName": "captureTheme"
        },
        {
          "flags": "--no-capture-redact",
          "attributeName": "captureRedact"
        },
        {
          "flags": "--replay <runId>",
          "attributeName": "replay"
        },
        {
          "flags": "--replay-speed <multiplier>",
          "attributeName": "replaySpeed"
        }
      ]
    },
    {
      "path": [
        "mirror"
      ],
      "command": "mirror",
      "parent": null,
      "registrationKind": "manual-handler",
      "aliases": [],
      "description": "Coordinate supported mirror lifecycle operations for the current project.",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "pipeline"
      ],
      "command": "pipeline",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "🔗 Run governance pipeline: sync → doctor → analyze → readiness → autopilot (writes pipeline-last-run.json)",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--strict",
          "attributeName": "strict"
        },
        {
          "flags": "--skip-verify",
          "attributeName": "skipVerify"
        },
        {
          "flags": "--skip-analyze",
          "attributeName": "skipAnalyze"
        },
        {
          "flags": "--skip-autopilot",
          "attributeName": "skipAutopilot"
        },
        {
          "flags": "--autopilot-mode <mode>",
          "attributeName": "autopilotMode"
        },
        {
          "flags": "--no-agent-sync",
          "attributeName": "agentSync"
        },
        {
          "flags": "--agent-sync",
          "attributeName": "agentSync"
        }
      ]
    },
    {
      "path": [
        "product"
      ],
      "command": "product",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "Product Factory commands for private workspace product manifests",
      "hidden": true,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "product",
        "manifest"
      ],
      "command": "manifest",
      "parent": "product",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Create or inspect private product manifests",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "product",
        "manifest",
        "create"
      ],
      "command": "create",
      "parent": "product manifest",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Create a private product manifest from a backlog product slug",
      "hidden": false,
      "arguments": [
        {
          "name": "slug",
          "required": true,
          "variadic": false
        }
      ],
      "options": [
        {
          "flags": "--from-backlog <file>",
          "attributeName": "fromBacklog"
        },
        {
          "flags": "--output <fileOrDir>",
          "attributeName": "output"
        },
        {
          "flags": "--kit <kit>",
          "attributeName": "kit"
        },
        {
          "flags": "--workspace-output <dir>",
          "attributeName": "workspaceOutput"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--force",
          "attributeName": "force"
        }
      ]
    },
    {
      "path": [
        "product",
        "plan"
      ],
      "command": "plan",
      "parent": "product",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Build a deterministic Product Factory plan from a workspace backlog JSON",
      "hidden": false,
      "arguments": [
        {
          "name": "backlog",
          "required": true,
          "variadic": false
        }
      ],
      "options": [
        {
          "flags": "--output <file>",
          "attributeName": "output"
        },
        {
          "flags": "--kit <kit>",
          "attributeName": "kit"
        },
        {
          "flags": "--tier <tier>",
          "attributeName": "tier"
        },
        {
          "flags": "--category <category>",
          "attributeName": "category"
        },
        {
          "flags": "--limit <count>",
          "attributeName": "limit"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "project"
      ],
      "command": "project",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "Safe workspace project lifecycle operations",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "project",
        "agent-entry"
      ],
      "command": "agent-entry",
      "parent": "project",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Verify canonical-first project entry coverage for supported agent hosts",
      "hidden": false,
      "arguments": [
        {
          "name": "action",
          "required": false,
          "variadic": false
        }
      ],
      "options": [
        {
          "flags": "--project <path>",
          "attributeName": "project"
        },
        {
          "flags": "--for-agent <agent>",
          "attributeName": "forAgent"
        },
        {
          "flags": "--no-live-inputs",
          "attributeName": "liveInputs"
        },
        {
          "flags": "--strict",
          "attributeName": "strict"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "project",
        "archive"
      ],
      "command": "archive",
      "parent": "project",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Move a project into .workspai/archive with a safety snapshot",
      "hidden": false,
      "arguments": [
        {
          "name": "project",
          "required": true,
          "variadic": false
        }
      ],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--reason <text>",
          "attributeName": "reason"
        },
        {
          "flags": "--dry-run",
          "attributeName": "dryRun"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "project",
        "archives"
      ],
      "command": "archives",
      "parent": "project",
      "registrationKind": "commander",
      "aliases": [],
      "description": "List archived workspace projects",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "project",
        "commands"
      ],
      "command": "commands",
      "parent": "project",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Show effective commands supported by the current Workspai project",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "project",
        "coverage"
      ],
      "command": "coverage",
      "parent": "project",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Inspect or run runtime-native test coverage and publish normalized project evidence",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--project <path>",
          "attributeName": "project"
        },
        {
          "flags": "--target <percent>",
          "attributeName": "target"
        },
        {
          "flags": "--run",
          "attributeName": "run"
        },
        {
          "flags": "--strict",
          "attributeName": "strict"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "project",
        "delete"
      ],
      "command": "delete",
      "parent": "project",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Archive by default; permanently delete only with --permanent and exact --confirm",
      "hidden": false,
      "arguments": [
        {
          "name": "project",
          "required": true,
          "variadic": false
        }
      ],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--reason <text>",
          "attributeName": "reason"
        },
        {
          "flags": "--permanent",
          "attributeName": "permanent"
        },
        {
          "flags": "--confirm <projectName>",
          "attributeName": "confirm"
        },
        {
          "flags": "--dry-run",
          "attributeName": "dryRun"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "project",
        "restore"
      ],
      "command": "restore",
      "parent": "project",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Restore an archived project back into the workspace",
      "hidden": false,
      "arguments": [
        {
          "name": "archive",
          "required": true,
          "variadic": false
        }
      ],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--name <projectName>",
          "attributeName": "name"
        },
        {
          "flags": "--reason <text>",
          "attributeName": "reason"
        },
        {
          "flags": "--force",
          "attributeName": "force"
        },
        {
          "flags": "--dry-run",
          "attributeName": "dryRun"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "project",
        "workspace"
      ],
      "command": "workspace",
      "parent": "project",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Show or repair the canonical workspace binding for the current Workspai project",
      "hidden": false,
      "arguments": [
        {
          "name": "action",
          "required": false,
          "variadic": false
        }
      ],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--project <path>",
          "attributeName": "project"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "readiness"
      ],
      "command": "readiness",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "🚦 Generate machine-readable release readiness summary (env + doctor + analyze + verify + dependency)",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--strict",
          "attributeName": "strict"
        },
        {
          "flags": "--skip-verify",
          "attributeName": "skipVerify"
        }
      ]
    },
    {
      "path": [
        "setup"
      ],
      "command": "setup",
      "parent": null,
      "registrationKind": "manual-handler",
      "aliases": [],
      "description": "Prepare a selected runtime toolchain through the supported adapter boundary.",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "shell"
      ],
      "command": "shell",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "Shell helpers (activate virtualenv in current shell)",
      "hidden": false,
      "arguments": [
        {
          "name": "action",
          "required": true,
          "variadic": false
        }
      ],
      "options": []
    },
    {
      "path": [
        "snapshot"
      ],
      "command": "snapshot",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "Create, list, and restore Workspai workspace snapshots",
      "hidden": false,
      "arguments": [],
      "options": []
    },
    {
      "path": [
        "snapshot",
        "create"
      ],
      "command": "create",
      "parent": "snapshot",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Create a recoverable workspace snapshot",
      "hidden": false,
      "arguments": [
        {
          "name": "name",
          "required": false,
          "variadic": false
        }
      ],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--reason <text>",
          "attributeName": "reason"
        },
        {
          "flags": "--include-projects",
          "attributeName": "includeProjects"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "snapshot",
        "inspect"
      ],
      "command": "inspect",
      "parent": "snapshot",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Inspect snapshot manifest and estimated payload size",
      "hidden": false,
      "arguments": [
        {
          "name": "name",
          "required": true,
          "variadic": false
        }
      ],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "snapshot",
        "list"
      ],
      "command": "list",
      "parent": "snapshot",
      "registrationKind": "commander",
      "aliases": [],
      "description": "List workspace snapshots",
      "hidden": false,
      "arguments": [],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "snapshot",
        "restore"
      ],
      "command": "restore",
      "parent": "snapshot",
      "registrationKind": "commander",
      "aliases": [],
      "description": "Restore a workspace snapshot",
      "hidden": false,
      "arguments": [
        {
          "name": "name",
          "required": true,
          "variadic": false
        }
      ],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--reason <text>",
          "attributeName": "reason"
        },
        {
          "flags": "--dry-run",
          "attributeName": "dryRun"
        },
        {
          "flags": "--force",
          "attributeName": "force"
        },
        {
          "flags": "--no-safety-snapshot",
          "attributeName": "safetySnapshot"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        }
      ]
    },
    {
      "path": [
        "workspace"
      ],
      "command": "workspace",
      "parent": null,
      "registrationKind": "commander",
      "aliases": [],
      "description": "Manage Workspai workspaces (list, sync, policy, share, export, run, intelligence)\n  workspace run <stage>   — fleet stage execution across discovered projects\n                            stages: init | test | build | start | <custom-from-context>\n  workspace explain|why   — blocker/project narrative (--write for artifact)\n  workspace trace         — diff → blast radius → gates narrative (--from <diff>)\n  workspace mcp serve     — read-mostly stdio MCP bridge over workspace evidence",
      "hidden": false,
      "arguments": [
        {
          "name": "action",
          "required": true,
          "variadic": false
        },
        {
          "name": "subaction",
          "required": false,
          "variadic": false
        },
        {
          "name": "key",
          "required": false,
          "variadic": false
        },
        {
          "name": "value",
          "required": false,
          "variadic": false
        }
      ],
      "options": [
        {
          "flags": "--workspace <path>",
          "attributeName": "workspace"
        },
        {
          "flags": "--output <file>",
          "attributeName": "output"
        },
        {
          "flags": "--from <file>",
          "attributeName": "from"
        },
        {
          "flags": "--from-impact <file>",
          "attributeName": "fromImpact"
        },
        {
          "flags": "--include-paths",
          "attributeName": "includePaths"
        },
        {
          "flags": "--write",
          "attributeName": "write"
        },
        {
          "flags": "--include-evidence",
          "attributeName": "includeEvidence"
        },
        {
          "flags": "--scan-depth <count>",
          "attributeName": "scanDepth"
        },
        {
          "flags": "--graph-inventory-limit <count>",
          "attributeName": "graphInventoryLimit"
        },
        {
          "flags": "--graph-semantic-budget <count>",
          "attributeName": "graphSemanticBudget"
        },
        {
          "flags": "--graph-deep-budget <count>",
          "attributeName": "graphDeepBudget"
        },
        {
          "flags": "--graph-source-budget <count>",
          "attributeName": "graphSourceBudget"
        },
        {
          "flags": "--limit <count>",
          "attributeName": "limit"
        },
        {
          "flags": "--kind <kind>",
          "attributeName": "kind"
        },
        {
          "flags": "--refresh-graph",
          "attributeName": "refreshGraph"
        },
        {
          "flags": "--cache",
          "attributeName": "cache"
        },
        {
          "flags": "--incremental",
          "attributeName": "incremental"
        },
        {
          "flags": "--once",
          "attributeName": "once"
        },
        {
          "flags": "--graph-stream",
          "attributeName": "graphStream"
        },
        {
          "flags": "--for-agent [agent]",
          "attributeName": "forAgent"
        },
        {
          "flags": "--agent-sync",
          "attributeName": "agentSync"
        },
        {
          "flags": "--no-agent-sync",
          "attributeName": "agentSync"
        },
        {
          "flags": "--target <targets>",
          "attributeName": "target"
        },
        {
          "flags": "--preset <preset>",
          "attributeName": "preset"
        },
        {
          "flags": "--project-grounding <mode>",
          "attributeName": "projectGrounding"
        },
        {
          "flags": "--refresh-context",
          "attributeName": "refreshContext"
        },
        {
          "flags": "--experimental-hooks",
          "attributeName": "experimentalHooks"
        },
        {
          "flags": "--hydrate-prompts",
          "attributeName": "hydratePrompts"
        },
        {
          "flags": "--scope <scope>",
          "attributeName": "scope"
        },
        {
          "flags": "--no-doctor",
          "attributeName": "doctor"
        },
        {
          "flags": "--no-blueprint",
          "attributeName": "blueprint"
        },
        {
          "flags": "--include-env",
          "attributeName": "includeEnv"
        },
        {
          "flags": "--archive-compression <mode>",
          "attributeName": "archiveCompression"
        },
        {
          "flags": "--max-download-size <size>",
          "attributeName": "maxDownloadSize"
        },
        {
          "flags": "--max-expanded-size <size>",
          "attributeName": "maxExpandedSize"
        },
        {
          "flags": "--download-timeout-ms <ms>",
          "attributeName": "downloadTimeoutMs"
        },
        {
          "flags": "--allow-private-network",
          "attributeName": "allowPrivateNetwork"
        },
        {
          "flags": "--force",
          "attributeName": "force"
        },
        {
          "flags": "--refresh",
          "attributeName": "refresh"
        },
        {
          "flags": "--dry-run",
          "attributeName": "dryRun"
        },
        {
          "flags": "--affected",
          "attributeName": "affected"
        },
        {
          "flags": "--blast-radius",
          "attributeName": "blastRadius"
        },
        {
          "flags": "--since <ref>",
          "attributeName": "since"
        },
        {
          "flags": "--parallel",
          "attributeName": "parallel"
        },
        {
          "flags": "--plan",
          "attributeName": "plan"
        },
        {
          "flags": "--runtime <runtime>",
          "attributeName": "runtime"
        },
        {
          "flags": "--max-workers <count>",
          "attributeName": "maxWorkers"
        },
        {
          "flags": "--continue-on-error",
          "attributeName": "continueOnError"
        },
        {
          "flags": "--reuse-passed",
          "attributeName": "reusePassed"
        },
        {
          "flags": "--json",
          "attributeName": "json"
        },
        {
          "flags": "--ci",
          "attributeName": "ci"
        },
        {
          "flags": "--strict",
          "attributeName": "strict"
        },
        {
          "flags": "--no-gates",
          "attributeName": "gates"
        },
        {
          "flags": "--allow-breaking",
          "attributeName": "allowBreaking"
        },
        {
          "flags": "--allow-force",
          "attributeName": "allowForce"
        },
        {
          "flags": "--card <id>",
          "attributeName": "card"
        },
        {
          "flags": "--action-id <id>",
          "attributeName": "actionId"
        },
        {
          "flags": "--project <name>",
          "attributeName": "project"
        },
        {
          "flags": "--proposal <path>",
          "attributeName": "proposal"
        },
        {
          "flags": "--transaction <id>",
          "attributeName": "transaction"
        },
        {
          "flags": "--approved-by <actor>",
          "attributeName": "approvedBy"
        },
        {
          "flags": "--decision <choice>",
          "attributeName": "decision"
        },
        {
          "flags": "--max-risk <risk>",
          "attributeName": "maxRisk"
        },
        {
          "flags": "--no-auto-rollback",
          "attributeName": "autoRollback"
        },
        {
          "flags": "--no-build",
          "attributeName": "build"
        },
        {
          "flags": "--no-tests",
          "attributeName": "tests"
        },
        {
          "flags": "--no-run",
          "attributeName": "run"
        },
        {
          "flags": "--reuse-intelligence",
          "attributeName": "reuseIntelligence"
        }
      ]
    }
  ],
  "topLevelCommands": [
    "adopt",
    "agent",
    "ai",
    "analyze",
    "autopilot",
    "bootstrap",
    "cache",
    "change",
    "commands",
    "config",
    "create",
    "doctor",
    "goal",
    "import",
    "infra",
    "live",
    "mirror",
    "pipeline",
    "product",
    "project",
    "readiness",
    "setup",
    "shell",
    "snapshot",
    "workspace"
  ],
  "integrity": {
    "ok": true,
    "registeredButUndeclared": [],
    "declaredButUnregistered": [],
    "registeredScopedButUndeclared": [],
    "declaredScopedButUnregistered": []
  }
}