NPM wrapper command
workspai change
Compose Goal intent, architecture generations, typed effects, independent verification, and uncertainty into a tamper-evident change capsule.
- Category
- NPM wrapper
- Workspace Intelligence
- No
- Produced artifacts
- 7
- Related contracts
- 9
- Registration
- commander
- 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.
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 changeRuntime 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.
contracts/runtime-command-surface.v1.jsonContractcontracts/command-capabilities.v1.jsonContractcontracts/workspace-intelligence/workspace-knowledge-graph-change-overlay.v1.jsonContractcontracts/workspace-intelligence/architecture-surprise-report.v1.jsonContractcontracts/workspace-intelligence/proof-carrying-change-capsule.v1.jsonContractcontracts/workspace-intelligence/architecture-change-lease.v1.jsonContractcontracts/workspace-intelligence/predicted-architecture-change.v1.jsonContractcontracts/workspace-intelligence/decision-checkpoint.v1.jsonContractcontracts/workspace-intelligence/decision-transaction.v1.jsonProduced 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/changes/change-id/actual-overlay.json | workspace-knowledge-graph-change-overlay.v1 | contracts/workspace-intelligence/workspace-knowledge-graph-change-overlay.v1.json |
| .workspai/changes/change-id/architecture-surprises.json | workspai.architecture-surprise-report.v1 | contracts/workspace-intelligence/architecture-surprise-report.v1.json |
| .workspai/changes/change-id/capsule.json | workspai.proof-carrying-change-capsule.v1 | contracts/workspace-intelligence/proof-carrying-change-capsule.v1.json |
| .workspai/changes/change-id/lease.json | workspai.architecture-change-lease.v1 | contracts/workspace-intelligence/architecture-change-lease.v1.json |
| .workspai/changes/change-id/predicted-overlay.json | workspai.predicted-architecture-change.v1 | contracts/workspace-intelligence/predicted-architecture-change.v1.json |
| .workspai/decisions/change-id/checkpoint.json | workspai.decision-checkpoint.v1 | contracts/workspace-intelligence/decision-checkpoint.v1.json |
| .workspai/decisions/change-id/transaction.json | workspai.decision-transaction.v1 | contracts/workspace-intelligence/decision-transaction.v1.json |