Compatibility / Capability contract
Extension Cli Compatibility V1
Defines the versioned extension cli compatibility v1 boundary used by Workspai and its consumers.
- Schema version
rapidkit-extension-cli-compatibility.v1- Contract path
contracts/extension-cli-compatibility.v1.json- Publication
- capability-contract
- Defined fields
- 128
- Artifact bindings
- 0
Why this contract exists
Architecture role
Defines a versioned interoperability boundary used by Workspai and contract-aware consumers.
Consumption boundary
- • Workspai CLI
- • Documentation portal
- • Extensions and adapters
Related commands
Commands are linked only when the runtime contract identifies a direct production relationship. Supporting contracts may be consumed without having a single producer command.
This is a supporting, capability, cache, compatibility, or consumer contract. It has no single direct producer command in the canonical Workspace Intelligence execution registry.
Produced artifacts
These durable files are emitted by registered commands and validated against this contract.
No canonical file artifact is registered for this contract. It may describe capabilities, embedded data, runtime exchange, or supporting state instead of a standalone report.
Field reference
Every declared schema property or published capability path is listed here. Required means the contract declares or publishes that field at the shown boundary.
| Field path | Type | Required | Meaning | Constraints |
|---|---|---|---|---|
| cli | string | Yes | Published cli capability data. | — |
| minimumVerifiedCliVersion | string | Yes | Published minimumverifiedcliversion capability data. | — |
| publishedContractSchemas | object | Yes | Published publishedcontractschemas capability data. | — |
| publishedContractSchemas.adoptEffects | string | Yes | Published adopteffects capability data. | — |
| publishedContractSchemas.agentActionOutcome | string | Yes | Published agentactionoutcome capability data. | — |
| publishedContractSchemas.agentBootstrapReceipt | string | Yes | Published agentbootstrapreceipt capability data. | — |
| publishedContractSchemas.agentCustomizationPackCapabilities | string | Yes | Published agentcustomizationpackcapabilities capability data. | — |
| publishedContractSchemas.agentCustomizationPackReport | string | Yes | Published agentcustomizationpackreport capability data. | — |
| publishedContractSchemas.agentHooks | string | Yes | Published agenthooks capability data. | — |
| publishedContractSchemas.agentReportsIndex | string | Yes | Published agentreportsindex capability data. | — |
| publishedContractSchemas.artifactRemediationPlan | string | Yes | Published artifactremediationplan capability data. | — |
| publishedContractSchemas.autopilotRelease | string | Yes | Published autopilotrelease capability data. | — |
| publishedContractSchemas.backendImportStackParitySnapshot | string | Yes | Published backendimportstackparitysnapshot capability data. | — |
| publishedContractSchemas.blockerResolution | string | Yes | Published blockerresolution capability data. | — |
| publishedContractSchemas.bootstrapCompliance | string | Yes | Published bootstrapcompliance capability data. | — |
| publishedContractSchemas.cliLogEvent | string | Yes | Published clilogevent capability data. | — |
| publishedContractSchemas.cliOperationResult | string | Yes | Published clioperationresult capability data. | — |
| publishedContractSchemas.cliRuntimeCommandInventory | string | Yes | Published cliruntimecommandinventory capability data. | — |
| publishedContractSchemas.commandCapabilities | string | Yes | Published commandcapabilities capability data. | — |
| publishedContractSchemas.compatibilityMatrix | string | Yes | Published compatibilitymatrix capability data. | — |
| publishedContractSchemas.createPlannerCapabilities | string | Yes | Published createplannercapabilities capability data. | — |
| publishedContractSchemas.doctorCapabilities | string | Yes | Published doctorcapabilities capability data. | — |
| publishedContractSchemas.doctorDependencyRepairTransaction | string | Yes | Published doctordependencyrepairtransaction capability data. | — |
| publishedContractSchemas.doctorDiagnosis | string | Yes | Published doctordiagnosis capability data. | — |
| publishedContractSchemas.doctorFixResult | string | Yes | Published doctorfixresult capability data. | — |
| publishedContractSchemas.doctorGraphDiagnosis | string | Yes | Published doctorgraphdiagnosis capability data. | — |
| publishedContractSchemas.doctorProjectEvidence | string | Yes | Published doctorprojectevidence capability data. | — |
| publishedContractSchemas.doctorProjectScan | string | Yes | Published doctorprojectscan capability data. | — |
| publishedContractSchemas.doctorReceipt | string | Yes | Published doctorreceipt capability data. | — |
| publishedContractSchemas.doctorRemediationPlan | string | Yes | Published doctorremediationplan capability data. | — |
| publishedContractSchemas.doctorRemediationPlanLegacy | string | Yes | Published doctorremediationplanlegacy capability data. | — |
| publishedContractSchemas.doctorSummary | string | Yes | Published doctorsummary capability data. | — |
| publishedContractSchemas.doctorValidation | string | Yes | Published doctorvalidation capability data. | — |
| publishedContractSchemas.doctorWorkspaceCache | string | Yes | Published doctorworkspacecache capability data. | — |
| publishedContractSchemas.doctorWorkspaceEvidence | string | Yes | Published doctorworkspaceevidence capability data. | — |
| publishedContractSchemas.extensionCliCompatibility | string | Yes | Published extensionclicompatibility capability data. | — |
| publishedContractSchemas.factFreshness | string | Yes | Published factfreshness capability data. | — |
| publishedContractSchemas.freshnessMetadata | string | Yes | Published freshnessmetadata capability data. | — |
| publishedContractSchemas.goalAgentHandoff | string | Yes | Published goalagenthandoff capability data. | — |
| publishedContractSchemas.goalIndex | string | Yes | Published goalindex capability data. | — |
| publishedContractSchemas.goalLifecycleResult | string | Yes | Published goallifecycleresult capability data. | — |
| publishedContractSchemas.goalPack | string | Yes | Published goalpack capability data. | — |
| publishedContractSchemas.goalPlanResult | string | Yes | Published goalplanresult capability data. | — |
| publishedContractSchemas.infraPlan | string | Yes | Published infraplan capability data. | — |
| publishedContractSchemas.infraStack | string | Yes | Published infrastack capability data. | — |
| publishedContractSchemas.ingestionPlan | string | Yes | Published ingestionplan capability data. | — |
| publishedContractSchemas.ingestionResult | string | Yes | Published ingestionresult capability data. | — |
| publishedContractSchemas.mcpDesign | string | Yes | Published mcpdesign capability data. | — |
| publishedContractSchemas.mirrorOps | string | Yes | Published mirrorops capability data. | — |
| publishedContractSchemas.modelUsageEvent | string | Yes | Published modelusageevent capability data. | — |
| publishedContractSchemas.moduleLayout | string | Yes | Published modulelayout capability data. | — |
| publishedContractSchemas.moduleSupport | string | Yes | Published modulesupport capability data. | — |
| publishedContractSchemas.pipelineLastRun | string | Yes | Published pipelinelastrun capability data. | — |
| publishedContractSchemas.privateProductManifest | string | Yes | Published privateproductmanifest capability data. | — |
| publishedContractSchemas.productFactoryPlan | string | Yes | Published productfactoryplan capability data. | — |
| publishedContractSchemas.projectAgentEntry | string | Yes | Published projectagententry capability data. | — |
| publishedContractSchemas.projectArchive | string | Yes | Published projectarchive capability data. | — |
| publishedContractSchemas.projectContextAgent | string | Yes | Published projectcontextagent capability data. | — |
| publishedContractSchemas.projectEntryCapability | string | Yes | Published projectentrycapability capability data. | — |
| publishedContractSchemas.projectTestCoverage | string | Yes | Published projecttestcoverage capability data. | — |
| publishedContractSchemas.projectWorkspaceLink | string | Yes | Published projectworkspacelink capability data. | — |
| publishedContractSchemas.projectWorkspaceResolution | string | Yes | Published projectworkspaceresolution capability data. | — |
| publishedContractSchemas.publishedContractCatalog | string | Yes | Published publishedcontractcatalog capability data. | — |
| publishedContractSchemas.runtimeCommandSurface | string | Yes | Published runtimecommandsurface capability data. | — |
| publishedContractSchemas.studioBlockerHandoff | string | Yes | Published studioblockerhandoff capability data. | — |
| publishedContractSchemas.studioCardRepairCapabilities | string | Yes | Published studiocardrepaircapabilities capability data. | — |
| publishedContractSchemas.transparencyEvidence | string | Yes | Published transparencyevidence capability data. | — |
| publishedContractSchemas.verifiedGoal | string | Yes | Published verifiedgoal capability data. | — |
| publishedContractSchemas.verifiedGoalStatus | string | Yes | Published verifiedgoalstatus capability data. | — |
| publishedContractSchemas.version | string | Yes | Published version capability data. | — |
| publishedContractSchemas.workspaceArchiveCapabilities | string | Yes | Published workspacearchivecapabilities capability data. | — |
| publishedContractSchemas.workspaceArchiveManifest | string | Yes | Published workspacearchivemanifest capability data. | — |
| publishedContractSchemas.workspaceArchiveOperationResult | string | Yes | Published workspacearchiveoperationresult capability data. | — |
| publishedContractSchemas.workspaceContext | string | Yes | Published workspacecontext capability data. | — |
| publishedContractSchemas.workspaceContract | number | Yes | Published workspacecontract capability data. | — |
| publishedContractSchemas.workspaceDependencyGraph | string | Yes | Published workspacedependencygraph capability data. | — |
| publishedContractSchemas.workspaceExplain | string | Yes | Published workspaceexplain capability data. | — |
| publishedContractSchemas.workspaceGraphStream | string | Yes | Published workspacegraphstream capability data. | — |
| publishedContractSchemas.workspaceGraphTokenEfficiency | string | Yes | Published workspacegraphtokenefficiency capability data. | — |
| publishedContractSchemas.workspaceImpact | string | Yes | Published workspaceimpact capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArchitecture | string | Yes | Published workspaceintelligencearchitecture capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts | object | Yes | Published workspaceintelligenceartifacts capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.agentContext | string | Yes | Published agentcontext capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.agentCustomizationPack | string | Yes | Published agentcustomizationpack capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.agentIndex | string | Yes | Published agentindex capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.agents | null | Yes | Published agents capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.analyze | string | Yes | Published analyze capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.contractVerify | string | Yes | Published contractverify capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.diff | string | Yes | Published diff capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.doctor | string | Yes | Published doctor capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.evaluationLastRun | string | Yes | Published evaluationlastrun capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.evaluationLive | string | Yes | Published evaluationlive capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.explain | string | Yes | Published explain capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.history | string | Yes | Published history capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.impact | string | Yes | Published impact capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.intelligenceRun | string | Yes | Published intelligencerun capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.knowledgeGraph | string | Yes | Published knowledgegraph capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.model | string | Yes | Published model capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.readiness | string | Yes | Published readiness capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.repairTransaction | string | Yes | Published repairtransaction capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.skillsIndex | string | Yes | Published skillsindex capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.snapshot | string | Yes | Published snapshot capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.verifiedGoalStatus | string | Yes | Published verifiedgoalstatus capability data. | — |
| publishedContractSchemas.workspaceIntelligenceArtifacts.verify | string | Yes | Published verify capability data. | — |
| publishedContractSchemas.workspaceIntelligenceChain | string | Yes | Published workspaceintelligencechain capability data. | — |
| publishedContractSchemas.workspaceIntelligenceEvaluation | string | Yes | Published workspaceintelligenceevaluation capability data. | — |
| publishedContractSchemas.workspaceIntelligenceEvaluationComparison | string | Yes | Published workspaceintelligenceevaluationcomparison capability data. | — |
| publishedContractSchemas.workspaceIntelligenceHistory | string | Yes | Published workspaceintelligencehistory capability data. | — |
| publishedContractSchemas.workspaceKnowledgeGraph | string | Yes | Published workspaceknowledgegraph capability data. | — |
| publishedContractSchemas.workspaceKnowledgeGraphChangeOverlay | string | Yes | Published workspaceknowledgegraphchangeoverlay capability data. | — |
| publishedContractSchemas.workspaceKnowledgeSearch | string | Yes | Published workspaceknowledgesearch capability data. | — |
| publishedContractSchemas.workspaceList | string | Yes | Published workspacelist capability data. | — |
| publishedContractSchemas.workspaceModel | string | Yes | Published workspacemodel capability data. | — |
| publishedContractSchemas.workspaceModelCache | string | Yes | Published workspacemodelcache capability data. | — |
| publishedContractSchemas.workspaceOperationalSkill | string | Yes | Published workspaceoperationalskill capability data. | — |
| publishedContractSchemas.workspaceRegistry | string | Yes | Published workspaceregistry capability data. | — |
| publishedContractSchemas.workspaceRepairCapabilities | string | Yes | Published workspacerepaircapabilities capability data. | — |
| publishedContractSchemas.workspaceRepairProposal | string | Yes | Published workspacerepairproposal capability data. | — |
| publishedContractSchemas.workspaceRepairTransaction | string | Yes | Published workspacerepairtransaction capability data. | — |
| publishedContractSchemas.workspaceRunLast | string | Yes | Published workspacerunlast capability data. | — |
| publishedContractSchemas.workspaceShareBundle | string | Yes | Published workspacesharebundle capability data. | — |
| publishedContractSchemas.workspaceSkillsIndex | string | Yes | Published workspaceskillsindex capability data. | — |
| publishedContractSchemas.workspaceSnapshot | string | Yes | Published workspacesnapshot capability data. | — |
| publishedContractSchemas.workspaceSnapshotV2 | string | Yes | Published workspacesnapshotv2 capability data. | — |
| publishedContractSchemas.workspaceSync | string | Yes | Published workspacesync capability data. | — |
| publishedContractSchemas.workspaceVerify | string | Yes | Published workspaceverify capability data. | — |
| publishedContractSchemas.workspaceWatchEvent | string | Yes | Published workspacewatchevent capability data. | — |
| schemaVersion | string | Yes | Published schemaversion capability data. | — |
Canonical machine-readable definition
The raw synchronized contract remains authoritative. The educational sections above are projections of this definition.
Show raw JSON
{
"schemaVersion": "rapidkit-extension-cli-compatibility.v1",
"cli": "workspai",
"minimumVerifiedCliVersion": "0.61.0",
"publishedContractSchemas": {
"workspaceContract": 1,
"runtimeCommandSurface": "rapidkit-runtime-command-surface-v1",
"cliRuntimeCommandInventory": "workspai-cli-runtime-command-inventory-v1",
"cliOperationResult": "workspai-cli-operation-result-v1",
"publishedContractCatalog": "workspai-published-contract-catalog-v1",
"workspaceArchiveCapabilities": "workspai-workspace-archive-capabilities-v1",
"workspaceArchiveManifest": "workspai-workspace-archive-manifest-v1",
"workspaceArchiveOperationResult": "workspai-workspace-archive-operation-result-v1",
"ingestionPlan": "workspai.ingestion-plan.v1",
"ingestionResult": "workspai.ingestion-result.v1",
"adoptEffects": "workspai.adopt-effects.v1",
"projectEntryCapability": "workspai-project-entry-capability-v1",
"projectWorkspaceLink": "project-workspace-link.v1",
"projectWorkspaceResolution": "project-workspace-resolution.v1",
"projectContextAgent": "project-context-agent.v1",
"projectAgentEntry": "workspai.agent-entry.v1",
"agentBootstrapReceipt": "workspai.agent-bootstrap-receipt.v1",
"doctorProjectEvidence": "doctor-project-evidence-v1",
"doctorWorkspaceEvidence": "doctor-workspace-evidence-v1",
"doctorGraphDiagnosis": "doctor-graph-diagnosis.v1",
"doctorDiagnosis": "workspai.doctor-diagnosis.v1",
"doctorCapabilities": "workspai.doctor-capabilities.v1",
"doctorValidation": "workspai.doctor-validation.v1",
"doctorReceipt": "workspai.doctor-receipt.v1",
"doctorSummary": "workspai.doctor-summary.v1",
"projectTestCoverage": "workspai.project-test-coverage.v1",
"verifiedGoal": "workspai.verified-goal.v1",
"verifiedGoalStatus": "workspai.verified-goal-status.v1",
"goalPack": "workspai.goal-pack.v1",
"goalAgentHandoff": "workspai.goal-agent-handoff.v1",
"goalPlanResult": "workspai.goal-plan-result.v1",
"goalIndex": "workspai.goal-index.v1",
"goalLifecycleResult": "workspai.goal-lifecycle-result.v1",
"workspaceIntelligenceArchitecture": "workspai-workspace-intelligence-architecture-v1",
"workspaceIntelligenceChain": "workspai-workspace-intelligence-chain-v1",
"workspaceIntelligenceArtifacts": {
"model": "workspace-model.v1",
"knowledgeGraph": "workspace-knowledge-graph.v1",
"snapshot": "workspace-model-snapshot.v1",
"diff": "workspace-model-diff.v1",
"impact": "workspace-impact.v1",
"analyze": "rapidkit-analyze-v1",
"doctor": "doctor-workspace-evidence-v1",
"contractVerify": "workspace-contract-verify.v1",
"readiness": "release-readiness-v1",
"verify": "workspace-verify.v1",
"history": "workspace-intelligence-history.v1",
"agentContext": "workspace-context.v1",
"agentIndex": "rapidkit-agent-reports-index.v1",
"agentCustomizationPack": "rapidkit-agent-customization-pack.v1",
"skillsIndex": "workspace-skills-index.v1",
"agents": null,
"explain": "workspace-explain.v1",
"intelligenceRun": "workspace-intelligence-run.v1",
"evaluationLive": "workspace-intelligence-evaluation.v1",
"evaluationLastRun": "workspace-intelligence-evaluation.v1",
"verifiedGoalStatus": "workspai.verified-goal-status.v1",
"repairTransaction": "workspai.workspace-repair-transaction.v1"
},
"cliLogEvent": "cli-log-event-v1",
"freshnessMetadata": "rapidkit-freshness-metadata-v1",
"factFreshness": "rapidkit-fact-freshness-v1",
"blockerResolution": "rapidkit-blocker-resolution-v1",
"workspaceModel": "workspace-model.v1",
"workspaceImpact": "workspace-impact.v1",
"workspaceVerify": "workspace-verify.v1",
"workspaceContext": "workspace-context.v1",
"workspaceDependencyGraph": "workspace-dependency-graph.v1",
"workspaceKnowledgeGraph": "workspace-knowledge-graph.v1",
"workspaceGraphStream": "workspace-graph-stream.v1",
"workspaceKnowledgeGraphChangeOverlay": "workspace-knowledge-graph-change-overlay.v1",
"workspaceKnowledgeSearch": "workspace-knowledge-search.v1",
"workspaceGraphTokenEfficiency": "workspace-graph-token-efficiency.v1",
"modelUsageEvent": "model-usage-event.v1",
"workspaceIntelligenceEvaluation": "workspace-intelligence-evaluation.v1",
"workspaceIntelligenceEvaluationComparison": "workspace-intelligence-evaluation-comparison.v1",
"workspaceIntelligenceHistory": "workspace-intelligence-history.v1",
"agentCustomizationPackCapabilities": "workspai-agent-customization-pack-capabilities.v1",
"agentCustomizationPackReport": "rapidkit-agent-customization-pack.v1",
"agentReportsIndex": "rapidkit-agent-reports-index.v1",
"workspaceOperationalSkill": "workspace-operational-skill.v1",
"workspaceSkillsIndex": "workspace-skills-index.v1",
"workspaceExplain": "workspace-explain.v1",
"agentActionOutcome": "agent-action-outcome.v1",
"doctorRemediationPlan": "doctor-remediation-plan-v2",
"doctorDependencyRepairTransaction": "workspai.doctor-dependency-repair-transaction.v1",
"artifactRemediationPlan": "artifact-remediation-plan-v1",
"studioCardRepairCapabilities": "workspai.studio-card-repair-capabilities.v1",
"workspaceRepairProposal": "workspai.workspace-repair-proposal.v1",
"workspaceRepairCapabilities": "workspai.workspace-repair-capabilities.v1",
"workspaceRepairTransaction": "workspai.workspace-repair-transaction.v1",
"doctorFixResult": "rapidkit-doctor-fix-result-v1",
"backendImportStackParitySnapshot": "backend-import-stack-parity-v1",
"bootstrapCompliance": "bootstrap-compliance.v1",
"commandCapabilities": "rapidkit-command-capabilities-v1",
"createPlannerCapabilities": "rapidkit-create-planner-capabilities-v1",
"doctorRemediationPlanLegacy": "doctor-remediation-plan-v2",
"extensionCliCompatibility": "rapidkit-extension-cli-compatibility.v1",
"infraStack": "rapidkit.infra-stack.v1",
"mirrorOps": "mirror-ops.v1",
"moduleLayout": "rapidkit.module-layout.v1",
"moduleSupport": "rapidkit-module-support-v1",
"pipelineLastRun": "rapidkit-pipeline-v1",
"transparencyEvidence": "transparency-evidence.v1",
"version": "rapidkit-version-v1",
"studioBlockerHandoff": "rapidkit-studio-blocker-handoff-v1",
"workspaceRegistry": "workspace-registry.v1",
"workspaceRunLast": "workspace-run-v1",
"workspaceShareBundle": "1.1",
"autopilotRelease": "autopilot-release-v1",
"workspaceList": "rapidkit-workspace-list-v1",
"workspaceSync": "rapidkit-workspace-sync-v1",
"compatibilityMatrix": "rapidkit.compatibility-matrix.v1",
"mcpDesign": "workspai-mcp-design.v1",
"agentHooks": "workspai-agent-hooks.v1",
"projectArchive": "rapidkit-project-archive-v1",
"workspaceSnapshot": "rapidkit-workspace-snapshot-v1",
"workspaceSnapshotV2": "rapidkit-workspace-snapshot-v2",
"infraPlan": "rapidkit.infra-plan.v1",
"privateProductManifest": "rapidkit.private-product-manifest.v1",
"productFactoryPlan": "rapidkit.product-factory-plan.v1",
"workspaceModelCache": "workspace-model-cache.v1",
"workspaceWatchEvent": "workspace-watch-event.v1",
"doctorProjectScan": "doctor-project-scan-v2",
"doctorWorkspaceCache": "doctor-workspace-cache-v2"
}
}