Workspace Intelligence command

workspai workspace repair

Own a durable repair transaction from governed planning and approval through checkpoint, execution, validation, canonical verification, closure, or rollback.

Category: Workspace Intelligence
Workspace Intelligence: Yes
Produced artifacts: 1
Related contracts: 3
Registration: contract-declared
Registered options: 0

Operational role

This purpose is versioned in the CLI runtime command surface. It is not inferred from page copy or a generic command template.

Own a durable repair transaction from governed planning and approval through checkpoint, execution, validation, canonical verification, closure, or rollback.

workspai workspace repair operational flowThe diagram is generated from this command's canonical invocation, declared input and output modes, artifact producers, contracts, and exit semantics.

Canonical invocation

This invocation is derived from the runtime command surface. Commands with a registered intelligence execution include their canonical evidence-producing flags.

npx workspai workspace repair

Operational variants

These flag or action variants are separately described by the runtime contract but remain part of this canonical command rather than separate command pages.

npx workspai workspace repair approve

Bind explicit local approval to the exact hash of an immutable repair transaction plan.

npx workspai workspace repair cancel

Cancel an unmutated repair transaction and expire any prior approval.

npx workspai workspace repair decide

Submit an available decision and either roll back, release control, or compile a fresh immutable policy plan.

npx workspai workspace repair execute

Checkpoint bounded files and execute approved repair, reconcile, audit, test, build, and canonical verification stages.

npx workspai workspace repair plan

Resolve current canonical remediation evidence into an immutable, risk-bounded repair transaction plan.

npx workspai workspace repair propose

Validate a model-authored, hash-pinned source proposal and compile it into a CLI-owned immutable repair transaction.

npx workspai workspace repair resume

Resume an interrupted approved transaction from its first unfinished durable stage.

npx workspai workspace repair rollback

Restore bounded checkpoint files only when their post-repair hashes still match the transaction.

Runtime signature

Arguments, aliases, and options come from the versioned snapshot of the live Commander tree emitted by the CLI. Contract-declared delegated commands intentionally expose only their canonical invocation.

This command is declared by the cross-runtime capability contract and delegated outside the npm Commander tree. Its invocation remains canonical, but runtime-specific flags are documented by the selected project adapter.

Contract relationships

Capability contracts govern whether the command exists; artifact contracts govern the structured output it produces.

Contractcontracts/runtime-command-surface.v1.jsonContractcontracts/command-capabilities.v1.jsonContractcontracts/workspace-intelligence/workspace-repair-transaction.v1.json

Produced artifacts

Artifacts are durable machine-readable outputs. Their schema, path, and producer relationship must remain stable across CLI, CI, IDE, MCP, and agent consumers.

Artifact	Schema version	Contract
.workspai/reports/workspace-repair-last-run.json	workspai.workspace-repair-transaction.v1	contracts/workspace-intelligence/workspace-repair-transaction.v1.json

Operational interpretation

Run this command inside the scope documented by its category. Treat declared structured output, raw renderer modes, and generated artifacts according to their published media type; human terminal prose must not be parsed as a stable contract. Consumers must preserve schema version, provenance, freshness, and verdict semantics when forwarding the result.