NPM wrapper command

workspai workspace

Dispatch workspace discovery, intelligence, governance, portability, and fleet lifecycle operations.

Category: NPM wrapper
Workspace Intelligence: No
Produced artifacts: 20
Related contracts: 20
Registration: commander
Registered options: 41

Operational role

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

Dispatch workspace discovery, intelligence, governance, portability, and fleet lifecycle operations.

workspai workspace 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

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.

Arguments and aliases

Aliases: None

action · required
subaction · optional
key · optional
value · optional

Options

--workspace <path>
--output <file>
--from <file>
--from-impact <file>
--include-paths
--write
--include-evidence
--scan-depth <count>
--cache
--incremental
--once
--for-agent [agent]
--agent-sync
--no-agent-sync
--target <targets>
--preset <preset>
--refresh-context
--experimental-hooks
--hydrate-prompts
--scope <scope>
--no-doctor
--no-blueprint
--include-env
--archive-compression <mode>
--max-download-size <size>
--max-expanded-size <size>
--download-timeout-ms <ms>
--force
--refresh
--dry-run
--affected
--blast-radius
--since <ref>
--parallel
--max-workers <count>
--continue-on-error
--reuse-passed
--json
--ci
--strict
--no-gates

Contract relationships

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

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
.vscode/workspai-agent-hooks.json	workspai-agent-hooks.v1	contracts/workspace-intelligence/agent-hooks.v1.json
.workspai/cache/workspace-model.v1.json	workspace-model-cache.v1	contracts/workspace-model-cache.v1.json
.workspai/reports/agent-customization-pack.json	rapidkit-agent-customization-pack.v1	contracts/workspace-intelligence/agent-customization-pack-report.v1.json
.workspai/reports/artifact-remediation-plan-last-run.json	artifact-remediation-plan-v1	contracts/artifact-remediation-plan.v1.json
.workspai/reports/doctor-remediation-plan-last-run.json	doctor-remediation-plan-v2	contracts/doctor-remediation-plan.v2.json
.workspai/reports/INDEX.json	rapidkit-agent-reports-index.v1	contracts/workspace-intelligence/agent-reports-index.v1.json
.workspai/reports/workspace-context-agent.json	workspace-context.v1	contracts/workspace-intelligence/workspace-context.v1.json
.workspai/reports/workspace-contract-verify-last-run.json	workspace-contract-verify.v1	contracts/workspace-intelligence/workspace-contract-verify.v1.json
.workspai/reports/workspace-explain-last-run.json	workspace-explain.v1	contracts/workspace-intelligence/workspace-explain.v1.json
.workspai/reports/workspace-impact-last-run.json	workspace-impact.v1	contracts/workspace-intelligence/workspace-impact.v1.json
.workspai/reports/workspace-intelligence-history.json	workspace-intelligence-history.v1	contracts/workspace-intelligence/workspace-intelligence-history.v1.json
.workspai/reports/workspace-model-diff-last-run.json	workspace-model-diff.v1	contracts/workspace-intelligence/workspace-model-diff.v1.json
.workspai/reports/workspace-model-snapshot.json	workspace-model-snapshot.v1	contracts/workspace-intelligence/workspace-model-snapshot.v1.json
.workspai/reports/workspace-model.json	workspace-model.v1	contracts/workspace-intelligence/workspace-model.v1.json
.workspai/reports/workspace-run-last.json	workspace-run-v1	contracts/workspace-run-last.v1.json
.workspai/reports/workspace-skills-index.json	workspace-skills-index.v1	contracts/workspace-intelligence/workspace-skills-index.v1.json
.workspai/reports/workspace-trace-last-run.json	workspace-explain.v1	contracts/workspace-intelligence/workspace-explain.v1.json
.workspai/reports/workspace-verify-last-run.json	workspace-verify.v1	contracts/workspace-intelligence/workspace-verify.v1.json
.workspai/reports/workspace-why-last-run.json	workspace-explain.v1	contracts/workspace-intelligence/workspace-explain.v1.json
.workspai/workspace-registry.v1.json	workspace-registry.v1	contracts/workspace-registry.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.