workspai 0.44.0 → 0.46.0

package/contracts/runtime-command-surface.v1.json

@@ -39,11 +39,1478 @@
   "coreProjectCommands": [
     "docs"
   ],
+  "npmOwnedTopLevelCommands": [
+    "analyze",
+    "readiness",
+    "doctor",
+    "workspace",
+    "autopilot",
+    "pipeline",
+    "import",
+    "adopt",
+    "snapshot",
+    "bootstrap",
+    "setup",
+    "cache",
+    "mirror",
+    "ai",
+    "config",
+    "product",
+    "infra",
+    "shell",
+    "commands",
+    "create",
+    "project"
+  ],
+  "npmOwnedScopedCommands": [
+    [
+      "ai",
+      "generate-embeddings"
+    ],
+    [
+      "ai",
+      "info"
+    ],
+    [
+      "ai",
+      "recommend"
+    ],
+    [
+      "ai",
+      "update-embeddings"
+    ],
+    [
+      "config",
+      "ai"
+    ],
+    [
+      "config",
+      "remove-api-key"
+    ],
+    [
+      "config",
+      "set-api-key"
+    ],
+    [
+      "config",
+      "show"
+    ],
+    [
+      "infra",
+      "down"
+    ],
+    [
+      "infra",
+      "plan"
+    ],
+    [
+      "infra",
+      "status"
+    ],
+    [
+      "infra",
+      "up"
+    ],
+    [
+      "product",
+      "manifest"
+    ],
+    [
+      "product",
+      "manifest",
+      "create"
+    ],
+    [
+      "product",
+      "plan"
+    ],
+    [
+      "project",
+      "commands"
+    ],
+    [
+      "project",
+      "archives"
+    ],
+    [
+      "project",
+      "archive"
+    ],
+    [
+      "project",
+      "restore"
+    ],
+    [
+      "project",
+      "delete"
+    ],
+    [
+      "snapshot",
+      "create"
+    ],
+    [
+      "snapshot",
+      "inspect"
+    ],
+    [
+      "snapshot",
+      "list"
+    ],
+    [
+      "snapshot",
+      "restore"
+    ]
+  ],
+  "commandDocumentation": [
+    {
+      "invocation": "add",
+      "summary": "Add a supported module or capability to the active project through its runtime adapter.",
+      "canonicalArgv": [
+        "add"
+      ]
+    },
+    {
+      "invocation": "adopt",
+      "summary": "Register an existing local repository as a governed Workspai project without recreating its source.",
+      "canonicalArgv": [
+        "adopt"
+      ]
+    },
+    {
+      "invocation": "ai",
+      "summary": "Manage AI configuration, recommendations, and embedding operations for the active workspace.",
+      "canonicalArgv": [
+        "ai"
+      ]
+    },
+    {
+      "invocation": "ai generate-embeddings",
+      "summary": "Generate the initial semantic embedding index from the current project or workspace sources.",
+      "canonicalArgv": [
+        "ai",
+        "generate-embeddings"
+      ]
+    },
+    {
+      "invocation": "ai info",
+      "summary": "Report the active AI provider, model, and embedding configuration.",
+      "canonicalArgv": [
+        "ai",
+        "info"
+      ]
+    },
+    {
+      "invocation": "ai recommend",
+      "summary": "Recommend relevant modules or actions from the detected project context and configured AI provider.",
+      "canonicalArgv": [
+        "ai",
+        "recommend"
+      ]
+    },
+    {
+      "invocation": "ai update-embeddings",
+      "summary": "Refresh the semantic embedding index after source or workspace context changes.",
+      "canonicalArgv": [
+        "ai",
+        "update-embeddings"
+      ]
+    },
+    {
+      "invocation": "analyze",
+      "summary": "Evaluate workspace evidence and produce governance findings for downstream readiness and release decisions.",
+      "canonicalArgv": [
+        "analyze"
+      ]
+    },
+    {
+      "invocation": "analyze --json",
+      "summary": "Emit the workspace analysis result as structured JSON for CI and contract-aware consumers.",
+      "canonicalArgv": [
+        "analyze",
+        "--json"
+      ]
+    },
+    {
+      "invocation": "autopilot",
+      "summary": "Coordinate supported automated governance actions while preserving explicit evidence and release gates.",
+      "canonicalArgv": [
+        "autopilot"
+      ]
+    },
+    {
+      "invocation": "autopilot release",
+      "summary": "Build a governed release proposal from current analysis, readiness, and verification evidence.",
+      "canonicalArgv": [
+        "autopilot",
+        "release"
+      ]
+    },
+    {
+      "invocation": "bootstrap",
+      "summary": "Establish the selected workspace profile, toolchain, and dependency baseline before project execution.",
+      "canonicalArgv": [
+        "bootstrap"
+      ]
+    },
+    {
+      "invocation": "build",
+      "summary": "Run the detected project build lifecycle through the owning runtime adapter.",
+      "canonicalArgv": [
+        "build"
+      ]
+    },
+    {
+      "invocation": "cache",
+      "summary": "Inspect or clear Workspai cache entries used by workspace and project operations.",
+      "canonicalArgv": [
+        "cache"
+      ]
+    },
+    {
+      "invocation": "checkpoint",
+      "summary": "Capture a named project or workspace checkpoint that can anchor later comparison or recovery.",
+      "canonicalArgv": [
+        "checkpoint"
+      ]
+    },
+    {
+      "invocation": "commands",
+      "summary": "Publish the installed CLI command inventory, ownership boundaries, aliases, options, and integrity verdict.",
+      "canonicalArgv": [
+        "commands"
+      ]
+    },
+    {
+      "invocation": "config",
+      "summary": "Manage persisted Workspai CLI and provider configuration for the current user environment.",
+      "canonicalArgv": [
+        "config"
+      ]
+    },
+    {
+      "invocation": "config ai",
+      "summary": "Inspect or update the active AI provider, model, and embedding configuration.",
+      "canonicalArgv": [
+        "config",
+        "ai"
+      ]
+    },
+    {
+      "invocation": "config remove-api-key",
+      "summary": "Remove a persisted provider API key from Workspai configuration.",
+      "canonicalArgv": [
+        "config",
+        "remove-api-key"
+      ]
+    },
+    {
+      "invocation": "config set-api-key",
+      "summary": "Store a provider API key for authenticated AI operations.",
+      "canonicalArgv": [
+        "config",
+        "set-api-key"
+      ]
+    },
+    {
+      "invocation": "config show",
+      "summary": "Display the effective Workspai configuration with secret values protected.",
+      "canonicalArgv": [
+        "config",
+        "show"
+      ]
+    },
+    {
+      "invocation": "create",
+      "summary": "Create a supported workspace, project, or module through the canonical planner and generator boundary.",
+      "canonicalArgv": [
+        "create"
+      ]
+    },
+    {
+      "invocation": "dev",
+      "summary": "Run the detected project development lifecycle with its runtime-specific development command.",
+      "canonicalArgv": [
+        "dev"
+      ]
+    },
+    {
+      "invocation": "diff",
+      "summary": "Compare governed project state against a selected baseline and report the observed changes.",
+      "canonicalArgv": [
+        "diff"
+      ]
+    },
+    {
+      "invocation": "docs",
+      "summary": "Generate or validate documentation through the detected project documentation lifecycle.",
+      "canonicalArgv": [
+        "docs"
+      ]
+    },
+    {
+      "invocation": "doctor",
+      "summary": "Diagnose the active project or workspace and produce actionable findings with evidence-backed remediation guidance.",
+      "canonicalArgv": [
+        "doctor"
+      ]
+    },
+    {
+      "invocation": "doctor project",
+      "summary": "Diagnose the current project and emit structured project evidence.",
+      "canonicalArgv": [
+        "doctor",
+        "project"
+      ]
+    },
+    {
+      "invocation": "doctor workspace",
+      "summary": "Diagnose cross-project workspace health, contracts, policies, toolchains, and operational evidence.",
+      "canonicalArgv": [
+        "doctor",
+        "workspace"
+      ]
+    },
+    {
+      "invocation": "doctor workspace --json",
+      "summary": "Emit workspace Doctor findings as structured evidence for verification and automation consumers.",
+      "canonicalArgv": [
+        "doctor",
+        "workspace",
+        "--json"
+      ]
+    },
+    {
+      "invocation": "format",
+      "summary": "Run the detected project formatter while respecting workspace policy and runtime ownership.",
+      "canonicalArgv": [
+        "format"
+      ]
+    },
+    {
+      "invocation": "frameworks",
+      "summary": "List scaffold frameworks and kits currently supported by the installed CLI.",
+      "canonicalArgv": [
+        "frameworks"
+      ]
+    },
+    {
+      "invocation": "help",
+      "summary": "Display contextual CLI usage, arguments, options, and command discovery guidance.",
+      "canonicalArgv": [
+        "help"
+      ]
+    },
+    {
+      "invocation": "import",
+      "summary": "Copy or clone an existing project into the workspace and register its detected runtime capabilities.",
+      "canonicalArgv": [
+        "import"
+      ]
+    },
+    {
+      "invocation": "info",
+      "summary": "Report detected project, runtime, workspace, and toolchain information for the current scope.",
+      "canonicalArgv": [
+        "info"
+      ]
+    },
+    {
+      "invocation": "infra",
+      "summary": "Manage governed infrastructure planning and lifecycle operations for the active workspace.",
+      "canonicalArgv": [
+        "infra"
+      ]
+    },
+    {
+      "invocation": "infra down",
+      "summary": "Stop the workspace infrastructure stack and optionally remove governed volumes.",
+      "canonicalArgv": [
+        "infra",
+        "down"
+      ]
+    },
+    {
+      "invocation": "infra plan",
+      "summary": "Generate a versioned infrastructure plan without applying infrastructure changes.",
+      "canonicalArgv": [
+        "infra",
+        "plan"
+      ]
+    },
+    {
+      "invocation": "infra status",
+      "summary": "Inspect infrastructure service state and expose a strict machine-checkable status verdict.",
+      "canonicalArgv": [
+        "infra",
+        "status"
+      ]
+    },
+    {
+      "invocation": "infra up",
+      "summary": "Start the workspace infrastructure stack from its governed configuration.",
+      "canonicalArgv": [
+        "infra",
+        "up"
+      ]
+    },
+    {
+      "invocation": "init",
+      "summary": "Initialize dependencies and required setup for the active project or complete workspace scope.",
+      "canonicalArgv": [
+        "init"
+      ]
+    },
+    {
+      "invocation": "license",
+      "summary": "Inspect or validate the effective Workspai license and feature entitlement state.",
+      "canonicalArgv": [
+        "license"
+      ]
+    },
+    {
+      "invocation": "lint",
+      "summary": "Run the detected project lint lifecycle under workspace compatibility and policy gates.",
+      "canonicalArgv": [
+        "lint"
+      ]
+    },
+    {
+      "invocation": "list",
+      "summary": "List detected or registered resources for the current command scope.",
+      "canonicalArgv": [
+        "list"
+      ]
+    },
+    {
+      "invocation": "merge",
+      "summary": "Combine supported governed configuration or project state through the owning runtime operation.",
+      "canonicalArgv": [
+        "merge"
+      ]
+    },
+    {
+      "invocation": "mirror",
+      "summary": "Manage local package or dependency mirrors used by offline and controlled development workflows.",
+      "canonicalArgv": [
+        "mirror"
+      ]
+    },
+    {
+      "invocation": "modules",
+      "summary": "List supported project modules and their runtime-specific capability state.",
+      "canonicalArgv": [
+        "modules"
+      ]
+    },
+    {
+      "invocation": "optimize",
+      "summary": "Apply supported project optimization operations through the detected runtime adapter.",
+      "canonicalArgv": [
+        "optimize"
+      ]
+    },
+    {
+      "invocation": "pipeline",
+      "summary": "Run the governance pipeline from sync and diagnostics through analysis, readiness, verification, and optional release automation.",
+      "canonicalArgv": [
+        "pipeline",
+        "--json"
+      ],
+      "output": {
+        "defaultFormat": "human-or-json",
+        "modes": [
+          {
+            "selector": "--json",
+            "format": "json",
+            "mediaType": "application/json"
+          }
+        ]
+      },
+      "exitSemantics": {
+        "default": "Warning-only pipeline reports are advisory and return exit code 0.",
+        "strict": "With --strict, warning-only pipeline reports return a non-zero exit code.",
+        "failure": "Execution failures and failed stages return a non-zero exit code in every mode."
+      }
+    },
+    {
+      "invocation": "product",
+      "summary": "Manage governed product manifests and factory planning operations.",
+      "canonicalArgv": [
+        "product"
+      ]
+    },
+    {
+      "invocation": "product manifest",
+      "summary": "Inspect or create the product manifest that defines product factory inputs.",
+      "canonicalArgv": [
+        "product",
+        "manifest"
+      ]
+    },
+    {
+      "invocation": "product manifest create",
+      "summary": "Create a governed product manifest for product planning operations.",
+      "canonicalArgv": [
+        "product",
+        "manifest",
+        "create"
+      ]
+    },
+    {
+      "invocation": "product plan",
+      "summary": "Generate a product factory plan from the current product definition.",
+      "canonicalArgv": [
+        "product",
+        "plan"
+      ]
+    },
+    {
+      "invocation": "project",
+      "summary": "Expose project-scoped command discovery, archive, restore, and deletion operations.",
+      "canonicalArgv": [
+        "project"
+      ]
+    },
+    {
+      "invocation": "project archive",
+      "summary": "Move a project into governed archive storage while preserving registry metadata and recovery evidence.",
+      "canonicalArgv": [
+        "project",
+        "archive"
+      ]
+    },
+    {
+      "invocation": "project archives",
+      "summary": "List governed project archives and their available restoration metadata.",
+      "canonicalArgv": [
+        "project",
+        "archives"
+      ]
+    },
+    {
+      "invocation": "project commands",
+      "summary": "Discover commands supported by the selected project runtime and its current capability tier.",
+      "canonicalArgv": [
+        "project",
+        "commands"
+      ]
+    },
+    {
+      "invocation": "project delete",
+      "summary": "Delete a registered project through guarded workspace safety and recovery checks.",
+      "canonicalArgv": [
+        "project",
+        "delete"
+      ]
+    },
+    {
+      "invocation": "project restore",
+      "summary": "Restore an archived project to its workspace path and reconcile registry ownership.",
+      "canonicalArgv": [
+        "project",
+        "restore"
+      ]
+    },
+    {
+      "invocation": "readiness",
+      "summary": "Evaluate whether current workspace evidence satisfies release-readiness requirements and blockers.",
+      "canonicalArgv": [
+        "readiness"
+      ]
+    },
+    {
+      "invocation": "readiness --json --skip-verify",
+      "summary": "Refresh pre-verification readiness evidence without consuming a verify artifact from an earlier chain run.",
+      "canonicalArgv": [
+        "readiness",
+        "--json",
+        "--skip-verify"
+      ]
+    },
+    {
+      "invocation": "reconcile",
+      "summary": "Reconcile detected project or workspace state with its governed metadata and registered configuration.",
+      "canonicalArgv": [
+        "reconcile"
+      ]
+    },
+    {
+      "invocation": "rollback",
+      "summary": "Restore supported generated or governed state to the previous recorded operation boundary.",
+      "canonicalArgv": [
+        "rollback"
+      ]
+    },
+    {
+      "invocation": "setup",
+      "summary": "Install or validate runtime-specific prerequisites required by the selected workspace profile.",
+      "canonicalArgv": [
+        "setup"
+      ]
+    },
+    {
+      "invocation": "shell",
+      "summary": "Open a workspace-aware shell with resolved project, runtime, and toolchain context.",
+      "canonicalArgv": [
+        "shell"
+      ]
+    },
+    {
+      "invocation": "snapshot",
+      "summary": "Manage governed workspace recovery snapshots independently from Workspace Intelligence model baselines.",
+      "canonicalArgv": [
+        "snapshot"
+      ]
+    },
+    {
+      "invocation": "snapshot create",
+      "summary": "Create a governed workspace snapshot for comparison or recovery.",
+      "canonicalArgv": [
+        "snapshot",
+        "create"
+      ]
+    },
+    {
+      "invocation": "snapshot inspect",
+      "summary": "Inspect snapshot metadata, contents, and recovery compatibility without restoring it.",
+      "canonicalArgv": [
+        "snapshot",
+        "inspect"
+      ]
+    },
+    {
+      "invocation": "snapshot list",
+      "summary": "List governed workspace snapshots available for inspection or recovery.",
+      "canonicalArgv": [
+        "snapshot",
+        "list"
+      ]
+    },
+    {
+      "invocation": "snapshot restore",
+      "summary": "Restore a governed snapshot through the workspace recovery boundary.",
+      "canonicalArgv": [
+        "snapshot",
+        "restore"
+      ]
+    },
+    {
+      "invocation": "start",
+      "summary": "Run the detected project production or service-start lifecycle command.",
+      "canonicalArgv": [
+        "start"
+      ]
+    },
+    {
+      "invocation": "test",
+      "summary": "Run the detected project test lifecycle under workspace compatibility and policy gates.",
+      "canonicalArgv": [
+        "test"
+      ]
+    },
+    {
+      "invocation": "uninstall",
+      "summary": "Remove a supported module, tool, or generated integration through its owning operation.",
+      "canonicalArgv": [
+        "uninstall"
+      ]
+    },
+    {
+      "invocation": "upgrade",
+      "summary": "Upgrade supported Workspai-managed dependencies or generated project capabilities.",
+      "canonicalArgv": [
+        "upgrade"
+      ]
+    },
+    {
+      "invocation": "version",
+      "summary": "Report the installed CLI version and published contract compatibility metadata.",
+      "canonicalArgv": [
+        "version"
+      ]
+    },
+    {
+      "invocation": "workspace",
+      "summary": "Dispatch workspace discovery, intelligence, governance, portability, and fleet lifecycle operations.",
+      "canonicalArgv": [
+        "workspace"
+      ]
+    },
+    {
+      "invocation": "workspace agent-sync",
+      "summary": "Project current workspace context into governed agent instructions, reports, skills, and integration files.",
+      "canonicalArgv": [
+        "workspace",
+        "agent-sync"
+      ]
+    },
+    {
+      "invocation": "workspace agent-sync --write --json --preset enterprise",
+      "summary": "Generate the enterprise agent-grounding pack, persist every governed artifact, and emit a structured result.",
+      "canonicalArgv": [
+        "workspace",
+        "agent-sync",
+        "--write",
+        "--json",
+        "--preset",
+        "enterprise"
+      ]
+    },
+    {
+      "invocation": "workspace archive",
+      "summary": "Create or inspect a governed workspace archive.",
+      "canonicalArgv": [
+        "workspace",
+        "archive"
+      ]
+    },
+    {
+      "invocation": "workspace context",
+      "summary": "Build a scoped workspace context projection from the current model and evidence for human or agent consumption.",
+      "canonicalArgv": [
+        "workspace",
+        "context"
+      ]
+    },
+    {
+      "invocation": "workspace context --for-agent --json --write --no-agent-sync",
+      "summary": "Persist structured agent context without mutating downstream agent instruction surfaces.",
+      "canonicalArgv": [
+        "workspace",
+        "context",
+        "--for-agent",
+        "--json",
+        "--write",
+        "--no-agent-sync"
+      ]
+    },
+    {
+      "invocation": "workspace contract",
+      "summary": "Inspect and verify explicit workspace contracts.",
+      "canonicalArgv": [
+        "workspace",
+        "contract"
+      ]
+    },
+    {
+      "invocation": "workspace contract verify --strict --json",
+      "summary": "Strictly validate workspace contracts and emit a structured evidence artifact that blocks on violations.",
+      "canonicalArgv": [
+        "workspace",
+        "contract",
+        "verify",
+        "--strict",
+        "--json"
+      ]
+    },
+    {
+      "invocation": "workspace diff",
+      "summary": "Compare the current canonical workspace model with a snapshot or source-control baseline.",
+      "canonicalArgv": [
+        "workspace",
+        "diff"
+      ]
+    },
+    {
+      "invocation": "workspace diff --from .workspai/reports/workspace-model-snapshot.json --json",
+      "summary": "Compute structured model changes from the canonical snapshot artifact for downstream impact analysis.",
+      "canonicalArgv": [
+        "workspace",
+        "diff",
+        "--from",
+        ".workspai/reports/workspace-model-snapshot.json",
+        "--json"
+      ]
+    },
+    {
+      "invocation": "workspace explain",
+      "summary": "Explain a workspace relationship, project, or blocker from traceable model and evidence references.",
+      "canonicalArgv": [
+        "workspace",
+        "explain"
+      ]
+    },
+    {
+      "invocation": "workspace explain release-blocked --json --write",
+      "summary": "Persist a structured explanation of release blockers and the evidence that caused the verdict.",
+      "canonicalArgv": [
+        "workspace",
+        "explain",
+        "release-blocked",
+        "--json",
+        "--write"
+      ]
+    },
+    {
+      "invocation": "workspace export",
+      "summary": "Export workspace intelligence into a portable consumer representation.",
+      "canonicalArgv": [
+        "workspace",
+        "export"
+      ]
+    },
+    {
+      "invocation": "workspace feedback",
+      "summary": "Record structured feedback about Workspace Intelligence output.",
+      "canonicalArgv": [
+        "workspace",
+        "feedback",
+        "record",
+        "--json"
+      ],
+      "input": {
+        "transport": "stdin",
+        "mediaType": "application/json",
+        "required": true,
+        "schemaVersion": "agent-action-outcome.v1",
+        "contractPath": "contracts/workspace-intelligence/agent-action-outcome.v1.json"
+      },
+      "output": {
+        "defaultFormat": "human-or-json",
+        "modes": [
+          {
+            "selector": "--json",
+            "format": "json",
+            "mediaType": "application/json"
+          }
+        ]
+      }
+    },
+    {
+      "invocation": "workspace feedback record --json",
+      "summary": "Validate an agent action outcome from stdin and append it to governed Workspace Intelligence history.",
+      "canonicalArgv": [
+        "workspace",
+        "feedback",
+        "record",
+        "--json"
+      ]
+    },
+    {
+      "invocation": "workspace foundation",
+      "summary": "Inspect or establish the foundational metadata required by workspace operations.",
+      "canonicalArgv": [
+        "workspace",
+        "foundation"
+      ]
+    },
+    {
+      "invocation": "workspace graph",
+      "summary": "Render the current workspace dependency graph in a supported representation.",
+      "canonicalArgv": [
+        "workspace",
+        "graph",
+        "emit",
+        "--json"
+      ],
+      "output": {
+        "defaultFormat": "human-or-json",
+        "modes": [
+          {
+            "selector": "emit --json",
+            "format": "json",
+            "mediaType": "application/json"
+          },
+          {
+            "selector": "explain <project> --json",
+            "format": "json",
+            "mediaType": "application/json"
+          },
+          {
+            "selector": "dot",
+            "format": "raw-text",
+            "mediaType": "text/vnd.graphviz"
+          },
+          {
+            "selector": "mermaid",
+            "format": "raw-text",
+            "mediaType": "text/vnd.mermaid"
+          }
+        ]
+      }
+    },
+    {
+      "invocation": "workspace hydrate",
+      "summary": "Restore or materialize workspace state from a portable representation.",
+      "canonicalArgv": [
+        "workspace",
+        "hydrate"
+      ]
+    },
+    {
+      "invocation": "workspace impact",
+      "summary": "Calculate the blast radius of a workspace diff across projects, dependencies, tests, policies, and gates.",
+      "canonicalArgv": [
+        "workspace",
+        "impact"
+      ]
+    },
+    {
+      "invocation": "workspace impact --from .workspai/reports/workspace-model-diff-last-run.json --json",
+      "summary": "Compute structured impact evidence from the latest canonical workspace model diff artifact.",
+      "canonicalArgv": [
+        "workspace",
+        "impact",
+        "--from",
+        ".workspai/reports/workspace-model-diff-last-run.json",
+        "--json"
+      ]
+    },
+    {
+      "invocation": "workspace import",
+      "summary": "Attach an existing project or repository to the workspace inventory.",
+      "canonicalArgv": [
+        "workspace",
+        "import"
+      ]
+    },
+    {
+      "invocation": "workspace init",
+      "summary": "Initialize workspace and project dependencies through the shared init flow.",
+      "canonicalArgv": [
+        "workspace",
+        "init"
+      ]
+    },
+    {
+      "invocation": "workspace intelligence",
+      "summary": "Run the canonical Workspace Intelligence dependency graph as one evidence-coherent operation.",
+      "canonicalArgv": [
+        "workspace",
+        "intelligence"
+      ]
+    },
+    {
+      "invocation": "workspace intelligence run",
+      "summary": "Execute every required Workspace Intelligence stage in dependency order and persist one authoritative run result.",
+      "canonicalArgv": [
+        "workspace",
+        "intelligence",
+        "run"
+      ]
+    },
+    {
+      "invocation": "workspace list",
+      "summary": "List registered workspaces through the canonical workspace discovery boundary.",
+      "canonicalArgv": [
+        "workspace",
+        "list"
+      ]
+    },
+    {
+      "invocation": "workspace mcp",
+      "summary": "Expose Workspace Intelligence through the MCP integration boundary.",
+      "canonicalArgv": [
+        "workspace",
+        "mcp"
+      ]
+    },
+    {
+      "invocation": "workspace model",
+      "summary": "Discover and normalize workspace entities, relationships, ownership, runtime, contract, and evidence state.",
+      "canonicalArgv": [
+        "workspace",
+        "model"
+      ]
+    },
+    {
+      "invocation": "workspace model --json --write",
+      "summary": "Persist the canonical workspace model and emit the same versioned representation as JSON.",
+      "canonicalArgv": [
+        "workspace",
+        "model",
+        "--json",
+        "--write"
+      ]
+    },
+    {
+      "invocation": "workspace policy",
+      "summary": "Inspect or update workspace governance policy.",
+      "canonicalArgv": [
+        "workspace",
+        "policy"
+      ]
+    },
+    {
+      "invocation": "workspace registry",
+      "summary": "Inspect and maintain the canonical workspace registry boundary.",
+      "canonicalArgv": [
+        "workspace",
+        "registry"
+      ]
+    },
+    {
+      "invocation": "workspace remediation-plan",
+      "summary": "Generate a structured remediation plan from current workspace evidence.",
+      "canonicalArgv": [
+        "workspace",
+        "remediation-plan"
+      ]
+    },
+    {
+      "invocation": "workspace run",
+      "summary": "Run a supported lifecycle command across registered workspace projects.",
+      "canonicalArgv": [
+        "workspace",
+        "run"
+      ]
+    },
+    {
+      "invocation": "workspace share",
+      "summary": "Prepare a governed workspace sharing surface.",
+      "canonicalArgv": [
+        "workspace",
+        "share"
+      ]
+    },
+    {
+      "invocation": "workspace snapshot",
+      "summary": "Capture a versioned workspace or model baseline for comparison and recovery.",
+      "canonicalArgv": [
+        "workspace",
+        "snapshot"
+      ]
+    },
+    {
+      "invocation": "workspace sync",
+      "summary": "Reconcile registered projects and workspace identity with the current filesystem state.",
+      "canonicalArgv": [
+        "workspace",
+        "sync"
+      ]
+    },
+    {
+      "invocation": "workspace trace",
+      "summary": "Trace a change or finding through its evidence and dependency relationships.",
+      "canonicalArgv": [
+        "workspace",
+        "trace"
+      ]
+    },
+    {
+      "invocation": "workspace verify",
+      "summary": "Combine impact, diagnostics, contracts, analysis, and readiness evidence into a governed verification verdict.",
+      "canonicalArgv": [
+        "workspace",
+        "verify"
+      ]
+    },
+    {
+      "invocation": "workspace verify --from-impact .workspai/reports/workspace-impact-last-run.json --json",
+      "summary": "Verify the latest impact artifact and append the structured outcome to Workspace Intelligence history.",
+      "canonicalArgv": [
+        "workspace",
+        "verify",
+        "--from-impact",
+        ".workspai/reports/workspace-impact-last-run.json",
+        "--json"
+      ]
+    },
+    {
+      "invocation": "workspace watch",
+      "summary": "Observe relevant workspace changes and publish versioned watch events.",
+      "canonicalArgv": [
+        "workspace",
+        "watch"
+      ]
+    },
+    {
+      "invocation": "workspace why",
+      "summary": "Explain why a relationship, verdict, or workspace fact exists.",
+      "canonicalArgv": [
+        "workspace",
+        "why"
+      ]
+    }
+  ],
+  "artifactContracts": [
+    {
+      "artifactPath": ".workspai/reports/workspace-model.json",
+      "schemaVersion": "workspace-model.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-model.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "model",
+          "--json",
+          "--write"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/workspace-model-snapshot.json",
+      "schemaVersion": "workspace-model-snapshot.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-model-snapshot.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "snapshot"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/workspace-model-diff-last-run.json",
+      "schemaVersion": "workspace-model-diff.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-model-diff.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "diff",
+          "--from",
+          ".workspai/reports/workspace-model-snapshot.json",
+          "--json"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/workspace-impact-last-run.json",
+      "schemaVersion": "workspace-impact.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-impact.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "impact",
+          "--from",
+          ".workspai/reports/workspace-model-diff-last-run.json",
+          "--json"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/analyze-last-run.json",
+      "schemaVersion": "rapidkit-analyze-v1",
+      "contractPath": "contracts/analyze-last-run.v1.json",
+      "producerCommands": [
+        [
+          "analyze",
+          "--json"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/doctor-last-run.json",
+      "schemaVersion": "doctor-workspace-evidence-v1",
+      "contractPath": "contracts/doctor-workspace-evidence.v1.json",
+      "producerCommands": [
+        [
+          "doctor",
+          "workspace",
+          "--json"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/workspace-contract-verify-last-run.json",
+      "schemaVersion": "workspace-contract-verify.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-contract-verify.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "contract",
+          "verify",
+          "--strict",
+          "--json"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/release-readiness-last-run.json",
+      "schemaVersion": "release-readiness-v1",
+      "contractPath": "contracts/release-readiness.v1.json",
+      "producerCommands": [
+        [
+          "readiness",
+          "--json",
+          "--skip-verify"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/workspace-verify-last-run.json",
+      "schemaVersion": "workspace-verify.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-verify.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "verify",
+          "--from-impact",
+          ".workspai/reports/workspace-impact-last-run.json",
+          "--json"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/workspace-intelligence-history.json",
+      "schemaVersion": "workspace-intelligence-history.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-intelligence-history.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "verify",
+          "--from-impact",
+          ".workspai/reports/workspace-impact-last-run.json",
+          "--json"
+        ],
+        [
+          "workspace",
+          "feedback",
+          "record",
+          "--json"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/workspace-context-agent.json",
+      "schemaVersion": "workspace-context.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-context.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "context",
+          "--for-agent",
+          "--json",
+          "--write",
+          "--no-agent-sync"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/INDEX.json",
+      "schemaVersion": "rapidkit-agent-reports-index.v1",
+      "contractPath": "contracts/workspace-intelligence/agent-reports-index.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "agent-sync",
+          "--write",
+          "--json",
+          "--preset",
+          "enterprise"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/agent-customization-pack.json",
+      "schemaVersion": "rapidkit-agent-customization-pack.v1",
+      "contractPath": "contracts/workspace-intelligence/agent-customization-pack-report.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "agent-sync",
+          "--write",
+          "--json",
+          "--preset",
+          "enterprise"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/workspace-skills-index.json",
+      "schemaVersion": "workspace-skills-index.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-skills-index.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "agent-sync",
+          "--write",
+          "--json",
+          "--preset",
+          "enterprise"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/workspace-explain-last-run.json",
+      "schemaVersion": "workspace-explain.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-explain.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "explain",
+          "release-blocked",
+          "--json",
+          "--write"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/workspace-intelligence-run-last-run.json",
+      "schemaVersion": "workspace-intelligence-run.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-intelligence-run.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "intelligence",
+          "run"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/cache/workspace-model.v1.json",
+      "schemaVersion": "workspace-model-cache.v1",
+      "contractPath": "contracts/workspace-model-cache.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "model"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/workspace-registry.v1.json",
+      "schemaVersion": "workspace-registry.v1",
+      "contractPath": "contracts/workspace-registry.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "sync"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/doctor-project-last-run.json",
+      "schemaVersion": "doctor-project-evidence-v1",
+      "contractPath": "contracts/doctor-project-evidence.v1.json",
+      "producerCommands": [
+        [
+          "doctor",
+          "project"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/doctor-remediation-plan-last-run.json",
+      "schemaVersion": "doctor-remediation-plan-v2",
+      "contractPath": "contracts/doctor-remediation-plan.v2.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "remediation-plan"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/artifact-remediation-plan-last-run.json",
+      "schemaVersion": "artifact-remediation-plan-v1",
+      "contractPath": "contracts/artifact-remediation-plan.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "remediation-plan"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/doctor-fix-result-last-run.json",
+      "schemaVersion": "rapidkit-doctor-fix-result-v1",
+      "contractPath": "contracts/workspace-intelligence/doctor-fix-result.v1.json",
+      "producerCommands": [
+        [
+          "doctor",
+          "workspace"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/pipeline-last-run.json",
+      "schemaVersion": "rapidkit-pipeline-v1",
+      "contractPath": "contracts/pipeline-last-run.v1.json",
+      "producerCommands": [
+        [
+          "pipeline"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/autopilot-release-last-run.json",
+      "schemaVersion": "autopilot-release-v1",
+      "contractPath": "contracts/autopilot-release.v1.json",
+      "producerCommands": [
+        [
+          "autopilot",
+          "release"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/autopilot-release.json",
+      "schemaVersion": "autopilot-release-v1",
+      "contractPath": "contracts/autopilot-release.v1.json",
+      "producerCommands": [
+        [
+          "autopilot",
+          "release"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/workspace-run-last.json",
+      "schemaVersion": "workspace-run-v1",
+      "contractPath": "contracts/workspace-run-last.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "run"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/workspai-mcp-design.json",
+      "schemaVersion": "workspai-mcp-design.v1",
+      "contractPath": "contracts/workspace-intelligence/mcp-design.v1.json",
+      "producerCommands": []
+    },
+    {
+      "artifactPath": ".workspai/reports/workspace-why-last-run.json",
+      "schemaVersion": "workspace-explain.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-explain.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "why"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/workspace-trace-last-run.json",
+      "schemaVersion": "workspace-explain.v1",
+      "contractPath": "contracts/workspace-intelligence/workspace-explain.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "trace"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".vscode/workspai-agent-hooks.json",
+      "schemaVersion": "workspai-agent-hooks.v1",
+      "contractPath": "contracts/workspace-intelligence/agent-hooks.v1.json",
+      "producerCommands": [
+        [
+          "workspace",
+          "agent-sync"
+        ]
+      ]
+    },
+    {
+      "artifactPath": ".workspai/reports/infra-plan.json",
+      "schemaVersion": "rapidkit.infra-plan.v1",
+      "contractPath": "contracts/infra-plan.v1.json",
+      "producerCommands": [
+        [
+          "infra",
+          "plan"
+        ]
+      ]
+    }
+  ],
   "workspaceSubcommands": [
     "list",
     "sync",
     "registry",
     "foundation",
+    "intelligence",
     "model",
     "snapshot",
     "diff",
@@ -70,17 +1537,23 @@
     "init"
   ],
   "workspaceIntelligenceSubcommands": [
+    "intelligence",
     "model",
     "snapshot",
     "diff",
     "impact",
+    "contract",
     "verify",
+    "graph",
+    "watch",
     "context",
     "agent-sync",
     "remediation-plan",
     "explain",
     "why",
-    "trace"
+    "trace",
+    "feedback",
+    "mcp"
   ],
   "workspaceIntelligenceRootCommands": [
     "analyze",
@@ -189,7 +1662,8 @@
       "id": "readiness-evidence",
       "argv": [
         "readiness",
-        "--json"
+        "--json",
+        "--skip-verify"
       ],
       "produces": [
         {
@@ -308,7 +1782,8 @@
       "--archive-compression <mode>",
       "--max-download-size <size>",
       "--max-expanded-size <size>",
-      "--download-timeout-ms <ms>"
+      "--download-timeout-ms <ms>",
+      "--allow-private-network"
     ]
   },
   "moduleSuggestionFrameworks": [