Runtime Command Surface V1

{
  "schemaVersion": "rapidkit-runtime-command-surface-v1",
  "lifecycleCommands": [
    "init",
    "dev",
    "start",
    "build",
    "test",
    "lint",
    "format",
    "help"
  ],
  "moduleMutationCommands": [
    "add",
    "modules",
    "upgrade",
    "diff",
    "merge",
    "reconcile",
    "rollback",
    "uninstall",
    "checkpoint",
    "snapshot",
    "optimize"
  ],
  "globalCommands": [
    "create",
    "list",
    "info",
    "frameworks",
    "license"
  ],
  "universalCommands": [
    "version",
    "commands",
    "doctor",
    "project"
  ],
  "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",
      "summary": "Emit the release-readiness verdict, blockers, and evidence references as structured JSON.",
      "canonicalArgv": [
        "readiness",
        "--json"
      ]
    },
    {
      "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 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"
        ]
      ]
    },
    {
      "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/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",
    "model",
    "snapshot",
    "diff",
    "impact",
    "verify",
    "graph",
    "watch",
    "context",
    "agent-sync",
    "remediation-plan",
    "explain",
    "why",
    "trace",
    "feedback",
    "mcp",
    "policy",
    "contract",
    "share",
    "export",
    "archive",
    "hydrate",
    "import",
    "run",
    "init"
  ],
  "workspaceIntelligenceSubcommands": [
    "model",
    "snapshot",
    "diff",
    "impact",
    "contract",
    "verify",
    "graph",
    "watch",
    "context",
    "agent-sync",
    "remediation-plan",
    "explain",
    "why",
    "trace",
    "feedback",
    "mcp"
  ],
  "workspaceIntelligenceRootCommands": [
    "analyze",
    "readiness",
    "doctor",
    "workspace"
  ],
  "workspaceIntelligenceExecution": [
    {
      "id": "model",
      "argv": [
        "workspace",
        "model",
        "--json",
        "--write"
      ],
      "produces": [
        {
          "path": ".workspai/reports/workspace-model.json",
          "schemaVersion": "workspace-model.v1",
          "contractPath": "contracts/workspace-intelligence/workspace-model.v1.json"
        }
      ]
    },
    {
      "id": "diff",
      "argv": [
        "workspace",
        "diff",
        "--from",
        ".workspai/reports/workspace-model-snapshot.json",
        "--json"
      ],
      "produces": [
        {
          "path": ".workspai/reports/workspace-model-diff-last-run.json",
          "schemaVersion": "workspace-model-diff.v1",
          "contractPath": "contracts/workspace-intelligence/workspace-model-diff.v1.json"
        }
      ]
    },
    {
      "id": "impact",
      "argv": [
        "workspace",
        "impact",
        "--from",
        ".workspai/reports/workspace-model-diff-last-run.json",
        "--json"
      ],
      "produces": [
        {
          "path": ".workspai/reports/workspace-impact-last-run.json",
          "schemaVersion": "workspace-impact.v1",
          "contractPath": "contracts/workspace-intelligence/workspace-impact.v1.json"
        }
      ]
    },
    {
      "id": "doctor-evidence",
      "argv": [
        "doctor",
        "workspace",
        "--json"
      ],
      "produces": [
        {
          "path": ".workspai/reports/doctor-last-run.json",
          "schemaVersion": "doctor-workspace-evidence-v1",
          "contractPath": "contracts/doctor-workspace-evidence.v1.json"
        }
      ]
    },
    {
      "id": "contract-evidence",
      "argv": [
        "workspace",
        "contract",
        "verify",
        "--strict",
        "--json"
      ],
      "produces": [
        {
          "path": ".workspai/reports/workspace-contract-verify-last-run.json",
          "schemaVersion": "workspace-contract-verify.v1",
          "contractPath": "contracts/workspace-intelligence/workspace-contract-verify.v1.json"
        }
      ]
    },
    {
      "id": "analyze-evidence",
      "argv": [
        "analyze",
        "--json"
      ],
      "produces": [
        {
          "path": ".workspai/reports/analyze-last-run.json",
          "schemaVersion": "rapidkit-analyze-v1",
          "contractPath": "contracts/analyze-last-run.v1.json"
        }
      ]
    },
    {
      "id": "readiness-evidence",
      "argv": [
        "readiness",
        "--json"
      ],
      "produces": [
        {
          "path": ".workspai/reports/release-readiness-last-run.json",
          "schemaVersion": "release-readiness-v1",
          "contractPath": "contracts/release-readiness.v1.json"
        }
      ]
    },
    {
      "id": "verify",
      "argv": [
        "workspace",
        "verify",
        "--from-impact",
        ".workspai/reports/workspace-impact-last-run.json",
        "--json"
      ],
      "produces": [
        {
          "path": ".workspai/reports/workspace-verify-last-run.json",
          "schemaVersion": "workspace-verify.v1",
          "contractPath": "contracts/workspace-intelligence/workspace-verify.v1.json"
        },
        {
          "path": ".workspai/reports/workspace-intelligence-history.json",
          "schemaVersion": "workspace-intelligence-history.v1",
          "contractPath": "contracts/workspace-intelligence/workspace-intelligence-history.v1.json"
        }
      ]
    },
    {
      "id": "context",
      "argv": [
        "workspace",
        "context",
        "--for-agent",
        "--json",
        "--write",
        "--no-agent-sync"
      ],
      "produces": [
        {
          "path": ".workspai/reports/workspace-context-agent.json",
          "schemaVersion": "workspace-context.v1",
          "contractPath": "contracts/workspace-intelligence/workspace-context.v1.json"
        }
      ]
    },
    {
      "id": "agent-sync",
      "argv": [
        "workspace",
        "agent-sync",
        "--write",
        "--json",
        "--preset",
        "enterprise"
      ],
      "produces": [
        {
          "path": ".workspai/reports/INDEX.json",
          "schemaVersion": "rapidkit-agent-reports-index.v1",
          "contractPath": "contracts/workspace-intelligence/agent-reports-index.v1.json"
        },
        {
          "path": ".workspai/reports/agent-customization-pack.json",
          "schemaVersion": "rapidkit-agent-customization-pack.v1",
          "contractPath": "contracts/workspace-intelligence/agent-customization-pack-report.v1.json"
        },
        {
          "path": ".workspai/reports/workspace-skills-index.json",
          "schemaVersion": "workspace-skills-index.v1",
          "contractPath": "contracts/workspace-intelligence/workspace-skills-index.v1.json"
        },
        {
          "path": "AGENTS.md",
          "schemaVersion": null,
          "contractPath": null
        }
      ]
    },
    {
      "id": "explain",
      "argv": [
        "workspace",
        "explain",
        "release-blocked",
        "--json",
        "--write"
      ],
      "produces": [
        {
          "path": ".workspai/reports/workspace-explain-last-run.json",
          "schemaVersion": "workspace-explain.v1",
          "contractPath": "contracts/workspace-intelligence/workspace-explain.v1.json"
        }
      ]
    }
  ],
  "jsonOperationResult": {
    "schemaVersion": "workspai-cli-operation-result-v1",
    "contractPath": "contracts/cli-operation-result.v1.json"
  },
  "workspaceArchive": {
    "schemaVersion": "workspai-workspace-archive-capabilities-v1",
    "contractPath": "contracts/workspace-archive-capabilities.v1.json",
    "commands": [
      "export",
      "inspect",
      "verify",
      "doctor",
      "hydrate"
    ],
    "flags": [
      "--archive-compression <mode>",
      "--max-download-size <size>",
      "--max-expanded-size <size>",
      "--download-timeout-ms <ms>"
    ]
  },
  "moduleSuggestionFrameworks": [
    "fastapi",
    "nestjs"
  ],
  "moduleUnsupportedFrameworks": [
    "go",
    "springboot",
    "dotnet",
    "nextjs",
    "remix",
    "vite-react",
    "vite-vue",
    "vite-svelte",
    "vite-solid",
    "vite-vanilla",
    "nuxt",
    "angular",
    "astro",
    "sveltekit"
  ],
  "scaffoldKits": [
    "fastapi.standard",
    "fastapi.ddd",
    "nestjs.standard",
    "gofiber.standard",
    "gogin.standard",
    "springboot.standard",
    "dotnet.webapi.clean",
    "frontend.nextjs",
    "frontend.remix",
    "frontend.vite-react",
    "frontend.vite-vue",
    "frontend.vite-svelte",
    "frontend.vite-solid",
    "frontend.vite-vanilla",
    "frontend.nuxt",
    "frontend.angular",
    "frontend.astro",
    "frontend.sveltekit"
  ],
  "createPlanner": {
    "lanes": {
      "native": {
        "status": "available",
        "meaning": "Workspai owns the scaffold contract, marker, registry, doctor, bootstrap, and workspace model path."
      },
      "official": {
        "status": "available",
        "meaning": "A stable ecosystem generator exists. Available entries run the official generator and then register the project; planned entries fall back to adopt/import."
      },
      "existing": {
        "status": "available",
        "meaning": "The project enters Workspace Intelligence through import/adopt, not native create."
      }
    },
    "nativeCreateKits": [
      "fastapi.standard",
      "fastapi.ddd",
      "nestjs.standard",
      "springboot.standard",
      "gofiber.standard",
      "gogin.standard",
      "dotnet.webapi.clean"
    ],
    "officialCreate": [
      "frontend.nextjs",
      "frontend.remix",
      "frontend.vite-react",
      "frontend.vite-vue",
      "frontend.vite-svelte",
      "frontend.vite-solid",
      "frontend.vite-vanilla",
      "frontend.nuxt",
      "frontend.angular",
      "frontend.astro",
      "frontend.sveltekit",
      "wordpress-site",
      "wordpress-block",
      "laravel",
      "symfony",
      "rails"
    ],
    "existingRuntimeSignals": [
      "php",
      "ruby",
      "rust",
      "elixir",
      "clojure",
      "scala",
      "kotlin"
    ]
  },
  "runtimeMatrix": {
    "python": {
      "tier": "first-class",
      "scaffold": true,
      "import": true,
      "moduleCommands": true,
      "doctor": "full",
      "lifecycleCommands": [
        "init",
        "dev",
        "start",
        "build",
        "test",
        "lint",
        "format",
        "help"
      ]
    },
    "node": {
      "tier": "extended",
      "scaffold": true,
      "import": true,
      "moduleCommands": true,
      "doctor": "full",
      "lifecycleCommands": [
        "init",
        "dev",
        "start",
        "build",
        "test",
        "lint",
        "format",
        "help"
      ]
    },
    "go": {
      "tier": "extended",
      "scaffold": true,
      "import": true,
      "moduleCommands": false,
      "doctor": "readiness",
      "lifecycleCommands": [
        "init",
        "dev",
        "start",
        "build",
        "test",
        "lint",
        "format",
        "help"
      ]
    },
    "java": {
      "tier": "extended",
      "scaffold": true,
      "import": true,
      "moduleCommands": false,
      "doctor": "readiness",
      "lifecycleCommands": [
        "init",
        "dev",
        "start",
        "build",
        "test",
        "lint",
        "format",
        "help"
      ]
    },
    "dotnet": {
      "tier": "extended",
      "scaffold": true,
      "import": true,
      "moduleCommands": false,
      "doctor": "readiness",
      "lifecycleCommands": [
        "init",
        "dev",
        "start",
        "build",
        "test",
        "lint",
        "format",
        "help"
      ]
    },
    "php": {
      "tier": "observed",
      "scaffold": false,
      "import": true,
      "moduleCommands": false,
      "doctor": "observed",
      "lifecycleCommands": [
        "help"
      ]
    },
    "ruby": {
      "tier": "observed",
      "scaffold": false,
      "import": true,
      "moduleCommands": false,
      "doctor": "observed",
      "lifecycleCommands": [
        "help"
      ]
    },
    "rust": {
      "tier": "observed",
      "scaffold": false,
      "import": true,
      "moduleCommands": false,
      "doctor": "observed",
      "lifecycleCommands": [
        "help"
      ]
    },
    "elixir": {
      "tier": "observed",
      "scaffold": false,
      "import": true,
      "moduleCommands": false,
      "doctor": "observed",
      "lifecycleCommands": [
        "help"
      ]
    },
    "clojure": {
      "tier": "observed",
      "scaffold": false,
      "import": true,
      "moduleCommands": false,
      "doctor": "observed",
      "lifecycleCommands": [
        "help"
      ]
    },
    "scala": {
      "tier": "observed",
      "scaffold": false,
      "import": true,
      "moduleCommands": false,
      "doctor": "observed",
      "lifecycleCommands": [
        "help"
      ]
    },
    "kotlin": {
      "tier": "observed",
      "scaffold": false,
      "import": true,
      "moduleCommands": false,
      "doctor": "observed",
      "lifecycleCommands": [
        "help"
      ]
    },
    "deno": {
      "tier": "observed",
      "scaffold": false,
      "import": true,
      "moduleCommands": false,
      "doctor": "observed",
      "lifecycleCommands": [
        "help"
      ]
    },
    "bun": {
      "tier": "observed",
      "scaffold": false,
      "import": true,
      "moduleCommands": false,
      "doctor": "observed",
      "lifecycleCommands": [
        "help"
      ]
    },
    "unknown": {
      "tier": "observed",
      "scaffold": false,
      "import": true,
      "moduleCommands": false,
      "doctor": "observed",
      "lifecycleCommands": [
        "help"
      ]
    }
  }
}