workspai 0.57.0 → 0.59.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (144) hide show
  1. package/README.md +80 -30
  2. package/contracts/agent-customization-pack.v1.json +62 -4
  3. package/contracts/cli-runtime-command-inventory.v1.snapshot.json +167 -0
  4. package/contracts/extension-cli-compatibility.v1.json +8 -1
  5. package/contracts/project-workspace-resolution.v1.json +15 -2
  6. package/contracts/published-contract-catalog.v1.json +35 -0
  7. package/contracts/runtime-command-surface.v1.json +99 -0
  8. package/contracts/workspace-intelligence/agent-bootstrap-receipt.v1.json +247 -0
  9. package/contracts/workspace-intelligence/agent-customization-pack-report.v1.json +16 -1
  10. package/contracts/workspace-intelligence/goal-agent-handoff.v1.json +96 -0
  11. package/contracts/workspace-intelligence/goal-index.v1.json +51 -0
  12. package/contracts/workspace-intelligence/goal-lifecycle-result.v1.json +96 -0
  13. package/contracts/workspace-intelligence/goal-pack.v1.json +251 -0
  14. package/contracts/workspace-intelligence/goal-plan-result.v1.json +46 -0
  15. package/contracts/workspace-intelligence/project-agent-entry.v1.json +204 -0
  16. package/contracts/workspace-intelligence/project-context-agent.v1.json +43 -26
  17. package/contracts/workspace-intelligence/workspace-context.v1.json +14 -1
  18. package/contracts/workspace-intelligence/workspace-repair-proposal.v1.json +1 -0
  19. package/contracts/workspace-intelligence/workspace-repair-transaction.v1.json +15 -2
  20. package/contracts/workspace-intelligence-architecture.v1.json +20 -0
  21. package/contracts/workspace-repair-capabilities.v1.json +5 -0
  22. package/dist/analyze-52TEGLDR.js +1 -0
  23. package/dist/{artifact-remediation-plan-BPLON5VX.js → artifact-remediation-plan-HPNQTNJ2.js} +1 -1
  24. package/dist/autopilot-release-KQGDM2AA.js +1 -0
  25. package/dist/capabilities-command-VBLZXP2T.js +1 -0
  26. package/dist/chunk-4PUJVYRM.js +1 -0
  27. package/dist/{workspace-knowledge-graph-snapshot-XSQADCNR.js → chunk-5NIZNXRS.js} +1 -1
  28. package/dist/chunk-5PSKBJKJ.js +1 -0
  29. package/dist/{chunk-AA4PNQKR.js → chunk-5SFCBZOH.js} +1 -1
  30. package/dist/{chunk-N2BIIUDH.js → chunk-6FBNSTUS.js} +1 -1
  31. package/dist/{chunk-YJTEMJFV.js → chunk-7DSYI7YN.js} +1 -1
  32. package/dist/chunk-7SFXADXO.js +2 -0
  33. package/dist/{chunk-ADL3CK44.js → chunk-CCDGHPEJ.js} +1 -1
  34. package/dist/{chunk-LYVDRRDO.js → chunk-D65FCQIO.js} +1 -1
  35. package/dist/{chunk-YM77FQB3.js → chunk-DGGTTRYE.js} +1 -1
  36. package/dist/{chunk-TTFQWH55.js → chunk-ENKGGWRX.js} +1 -1
  37. package/dist/{chunk-ZPA6ECBJ.js → chunk-GPOZILMY.js} +1 -1
  38. package/dist/{chunk-L36ZASME.js → chunk-HCFWT42C.js} +1 -1
  39. package/dist/chunk-HOUQIT7U.js +1 -0
  40. package/dist/{chunk-IXOLHPTN.js → chunk-HS3DJMU5.js} +1 -1
  41. package/dist/{chunk-XMTLKDPP.js → chunk-J3X56S7L.js} +1 -1
  42. package/dist/{chunk-64JUYYRC.js → chunk-KBR4Y4RW.js} +1 -1
  43. package/dist/{chunk-E53BGUOW.js → chunk-KTN2ARZJ.js} +1 -1
  44. package/dist/chunk-LPCWROQ3.js +1 -0
  45. package/dist/{chunk-VL3APTVB.js → chunk-M3IKRWXA.js} +1 -1
  46. package/dist/{chunk-P475BOJW.js → chunk-M4UOXP5T.js} +1 -1
  47. package/dist/{chunk-GBMCHFOV.js → chunk-N4QQADXX.js} +1 -1
  48. package/dist/{chunk-75HOCFNH.js → chunk-NOZ4JCH7.js} +1 -1
  49. package/dist/chunk-NZ3WZYD5.js +1 -0
  50. package/dist/{chunk-QHY6F4SS.js → chunk-OFWSZYUX.js} +1 -1
  51. package/dist/{chunk-IUYZ3NHS.js → chunk-OLC7EYUA.js} +3 -3
  52. package/dist/chunk-PVXSIYLP.js +1 -0
  53. package/dist/{chunk-NHTLE3WN.js → chunk-PXWKMPPI.js} +1 -1
  54. package/dist/{chunk-V5EYVQ63.js → chunk-QCKWQFCD.js} +1 -1
  55. package/dist/{chunk-GDKFN3CM.js → chunk-QFBVQUKV.js} +1 -1
  56. package/dist/{chunk-W5ZFXKSL.js → chunk-QJCCZLOF.js} +1 -1
  57. package/dist/{chunk-Z57G62KE.js → chunk-QMPFNXI7.js} +1 -1
  58. package/dist/chunk-RBBBXFEU.js +1 -0
  59. package/dist/{chunk-DF4NWPB7.js → chunk-RHK53ZK7.js} +1 -1
  60. package/dist/chunk-S45YGN2I.js +142 -0
  61. package/dist/chunk-S4CWUZ4K.js +1 -0
  62. package/dist/{chunk-SNO3WG4V.js → chunk-SP5EHSWG.js} +1 -1
  63. package/dist/chunk-TCURN5VD.js +2 -0
  64. package/dist/{chunk-GTJY55QK.js → chunk-UVBPEX3E.js} +1 -1
  65. package/dist/chunk-V3ABABV5.js +39 -0
  66. package/dist/{chunk-IZLEMTES.js → chunk-W6FHVXNL.js} +1 -1
  67. package/dist/{chunk-UQEQ6CXU.js → chunk-WQX3JYEP.js} +1 -1
  68. package/dist/{chunk-GXTCU4WF.js → chunk-WSRUPDZN.js} +1 -1
  69. package/dist/{chunk-6OFGLNFS.js → chunk-YEEAWZWI.js} +1 -1
  70. package/dist/{chunk-QK5QOXOE.js → chunk-ZJCM37KX.js} +1 -1
  71. package/dist/{create-O2KLTN5H.js → create-6QWIJTGU.js} +1 -1
  72. package/dist/{doctor-AL5YWO5X.js → doctor-NAZEKMGU.js} +1 -1
  73. package/dist/goal-command-contract-CHE7U6YY.js +1 -0
  74. package/dist/goal-lifecycle-ECIRCHN5.js +1 -0
  75. package/dist/goal-pack-HBOPVZFO.js +1 -0
  76. package/dist/index.d.ts +25 -3
  77. package/dist/index.js +150 -148
  78. package/dist/{pipeline-4ST4BQWY.js → pipeline-5LLFP5ZH.js} +1 -1
  79. package/dist/project-agent-entry-AFKDDRDL.js +1 -0
  80. package/dist/{project-intelligence-lens-JHYECYOK.js → project-intelligence-lens-U2V3VNZG.js} +1 -1
  81. package/dist/project-test-coverage-HP37HUV2.js +1 -0
  82. package/dist/{verified-goal-KFNRGOKT.js → verified-goal-HUYJ6LBI.js} +1 -1
  83. package/dist/{workspace-O4E5CCGK.js → workspace-CQ43AWUF.js} +1 -1
  84. package/dist/{workspace-agent-sync-N5DPGU2E.js → workspace-agent-sync-YMXYUGYY.js} +1 -1
  85. package/dist/{workspace-archive-BA3ONVXX.js → workspace-archive-ZBCKJHXS.js} +1 -1
  86. package/dist/{workspace-context-ETZNEHOJ.js → workspace-context-RAO62QVU.js} +1 -1
  87. package/dist/{workspace-contract-OSI7NBXS.js → workspace-contract-ACSIHJIO.js} +1 -1
  88. package/dist/workspace-explain-RH27OQB4.js +1 -0
  89. package/dist/workspace-explain-contract-ZL4NMLZI.js +1 -0
  90. package/dist/{workspace-feedback-PCZKXG5R.js → workspace-feedback-RQ4TGJW6.js} +1 -1
  91. package/dist/{workspace-foundation-QQHX66KE.js → workspace-foundation-JH2GFSAZ.js} +1 -1
  92. package/dist/{workspace-graph-stream-UZJQ75XZ.js → workspace-graph-stream-ZZZEQQTE.js} +1 -1
  93. package/dist/workspace-graph-token-efficiency-D7CUT6NX.js +1 -0
  94. package/dist/{workspace-history-CHJOABME.js → workspace-history-SYCDK7FO.js} +1 -1
  95. package/dist/{workspace-intelligence-A7O7MN6T.js → workspace-intelligence-3YERTBA3.js} +1 -1
  96. package/dist/{workspace-intelligence-evaluation-YMY3C5AW.js → workspace-intelligence-evaluation-CQDKOYZZ.js} +1 -1
  97. package/dist/{workspace-intelligence-runner-4EF66L66.js → workspace-intelligence-runner-YXMOT6GK.js} +1 -1
  98. package/dist/{workspace-intelligence-runtime-registry-NCVHKCMP.js → workspace-intelligence-runtime-registry-IW6J53LO.js} +1 -1
  99. package/dist/{workspace-knowledge-graph-BVN4NTJ6.js → workspace-knowledge-graph-HZZP6ZRB.js} +1 -1
  100. package/dist/{workspace-knowledge-graph-query-6DAOXGGT.js → workspace-knowledge-graph-query-ON45H6Y7.js} +1 -1
  101. package/dist/workspace-knowledge-graph-snapshot-7DWHMEM2.js +1 -0
  102. package/dist/{workspace-mcp-serve-TKX4J3SX.js → workspace-mcp-serve-5TTAN243.js} +1 -1
  103. package/dist/{workspace-model-7ESEP366.js → workspace-model-EIQSKDX7.js} +1 -1
  104. package/dist/{workspace-onboarding-SY255V7L.js → workspace-onboarding-SHHW4R4G.js} +1 -1
  105. package/dist/{workspace-readme-IVJXSIBS.js → workspace-readme-56YZ4EAZ.js} +1 -1
  106. package/dist/{workspace-registry-summary-7ISKYEPM.js → workspace-registry-summary-OV5KX3WC.js} +1 -1
  107. package/dist/workspace-repair-engine-BNXZHW35.js +3 -0
  108. package/dist/workspace-run-7EJEBHAH.js +1 -0
  109. package/dist/{workspace-verify-CNXZPWS5.js → workspace-verify-W4P6LBIH.js} +1 -1
  110. package/dist/{workspace-watch-HGFL2EU3.js → workspace-watch-EZ4D4VCF.js} +1 -1
  111. package/docs/GLOSSARY.md +13 -10
  112. package/docs/README.md +24 -17
  113. package/docs/README_CONTENT_CONTRACT.md +12 -8
  114. package/docs/agent-entry.md +194 -0
  115. package/docs/ci-workflows.md +1 -1
  116. package/docs/commands-reference.md +38 -2
  117. package/docs/contracts/ARTIFACT_CATALOG.md +17 -0
  118. package/docs/contracts/COMMAND_OWNERSHIP_MATRIX.md +4 -0
  119. package/docs/contracts/README.md +7 -0
  120. package/docs/goal-packs.md +235 -0
  121. package/docs/real-world-qualification.md +22 -3
  122. package/docs/workspace-operations.md +16 -8
  123. package/docs/workspace-repair-engine.md +36 -5
  124. package/package.json +3 -2
  125. package/scripts/enterprise-package-smoke.mjs +4 -0
  126. package/dist/analyze-HJ774J3E.js +0 -1
  127. package/dist/autopilot-release-WIFFFQKW.js +0 -1
  128. package/dist/capabilities-command-44JVOE5S.js +0 -1
  129. package/dist/chunk-3U4VLIGW.js +0 -1
  130. package/dist/chunk-5EPPPMAS.js +0 -1
  131. package/dist/chunk-CNWUIXF3.js +0 -1
  132. package/dist/chunk-D4RST2HE.js +0 -1
  133. package/dist/chunk-DT4X7I5M.js +0 -81
  134. package/dist/chunk-FPJNWPKU.js +0 -1
  135. package/dist/chunk-PKIRVQLG.js +0 -1
  136. package/dist/chunk-RPHM7LQW.js +0 -36
  137. package/dist/chunk-VUR7H2FU.js +0 -2
  138. package/dist/chunk-VZPWIILU.js +0 -1
  139. package/dist/project-test-coverage-FRMVYTFB.js +0 -1
  140. package/dist/workspace-explain-EM7IUV6L.js +0 -1
  141. package/dist/workspace-explain-contract-KVQO57RC.js +0 -1
  142. package/dist/workspace-graph-token-efficiency-TF23UYEF.js +0 -1
  143. package/dist/workspace-repair-engine-GMA2YTCF.js +0 -3
  144. package/dist/workspace-run-ZZXVNFUS.js +0 -1
@@ -0,0 +1,251 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://workspai.dev/schemas/workspace-intelligence/goal-pack.v1.json",
4
+ "title": "Workspai Goal Pack",
5
+ "type": "object",
6
+ "required": ["schemaVersion", "id", "fingerprint", "generatedAt", "state", "intent", "workspace", "scope", "sourceBinding", "baseline", "preflight", "successCriteria", "policy", "orchestration", "artifacts", "commands"],
7
+ "properties": {
8
+ "schemaVersion": { "const": "workspai.goal-pack.v1" },
9
+ "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{7,95}$" },
10
+ "fingerprint": { "$ref": "#/$defs/hash" },
11
+ "generatedAt": { "type": "string", "format": "date-time" },
12
+ "state": { "enum": ["ready-to-plan", "needs-confirmation", "needs-evidence", "blocked"] },
13
+ "intent": {
14
+ "type": "object",
15
+ "required": ["original", "normalized", "statement", "category", "confidence", "ambiguities"],
16
+ "properties": {
17
+ "original": { "type": "string", "minLength": 1, "maxLength": 2000 },
18
+ "normalized": { "type": "string", "minLength": 1, "maxLength": 2000 },
19
+ "statement": { "type": "string", "minLength": 1, "maxLength": 2000 },
20
+ "category": { "enum": ["release-readiness", "dependency-security", "test-coverage", "defect-repair", "feature-change", "refactor", "performance", "documentation", "system-understanding"] },
21
+ "confidence": { "enum": ["high", "medium", "low"] },
22
+ "ambiguities": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
23
+ "requestedTarget": {
24
+ "type": "object",
25
+ "required": ["metric", "operator", "value"],
26
+ "properties": {
27
+ "metric": { "const": "test-coverage-percent" },
28
+ "operator": { "const": "at-least" },
29
+ "value": { "type": "number", "minimum": 0, "maximum": 100 }
30
+ },
31
+ "additionalProperties": false
32
+ }
33
+ },
34
+ "additionalProperties": false
35
+ },
36
+ "workspace": {
37
+ "type": "object",
38
+ "required": ["name"],
39
+ "properties": { "name": { "type": "string", "minLength": 1 } },
40
+ "additionalProperties": false
41
+ },
42
+ "scope": { "$ref": "#/$defs/scope" },
43
+ "sourceBinding": {
44
+ "type": "object",
45
+ "required": ["model", "graph"],
46
+ "properties": {
47
+ "model": { "$ref": "#/$defs/modelBinding" },
48
+ "graph": { "$ref": "#/$defs/graphBinding" }
49
+ },
50
+ "additionalProperties": false
51
+ },
52
+ "baseline": {
53
+ "type": "object",
54
+ "required": ["projectCount", "runtimes", "frameworks", "graph"],
55
+ "properties": {
56
+ "projectCount": { "type": "integer", "minimum": 0 },
57
+ "runtimes": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
58
+ "frameworks": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
59
+ "graph": {
60
+ "type": "object",
61
+ "required": ["entities", "relationships", "proofs", "unresolved", "proofCoveragePercent"],
62
+ "properties": {
63
+ "entities": { "type": "integer", "minimum": 0 },
64
+ "relationships": { "type": "integer", "minimum": 0 },
65
+ "proofs": { "type": "integer", "minimum": 0 },
66
+ "unresolved": { "type": "integer", "minimum": 0 },
67
+ "proofCoveragePercent": { "type": "number", "minimum": 0, "maximum": 100 }
68
+ },
69
+ "additionalProperties": false
70
+ }
71
+ },
72
+ "additionalProperties": false
73
+ },
74
+ "preflight": {
75
+ "type": "object",
76
+ "required": ["workspaceIntelligence", "measurement", "retrieval"],
77
+ "properties": {
78
+ "workspaceIntelligence": {
79
+ "type": "object",
80
+ "required": ["status", "artifact", "blockedStages"],
81
+ "properties": {
82
+ "status": { "enum": ["passed", "blocked", "unknown"] },
83
+ "artifact": { "const": ".workspai/reports/workspace-intelligence-run-last-run.json" },
84
+ "blockedStages": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true }
85
+ },
86
+ "additionalProperties": false
87
+ },
88
+ "measurement": {
89
+ "type": "object",
90
+ "required": ["status", "runtime", "runner", "existingEvidence", "prerequisites"],
91
+ "properties": {
92
+ "status": { "enum": ["available", "requires-setup", "unsupported", "not-applicable"] },
93
+ "runtime": { "type": ["string", "null"] },
94
+ "runner": { "type": ["string", "null"] },
95
+ "existingEvidence": { "type": "array", "items": { "type": "object", "required": ["project", "path", "sha256"], "properties": { "project": { "type": "string", "minLength": 1 }, "path": { "type": "string", "minLength": 1 }, "sha256": { "$ref": "#/$defs/hash" } }, "additionalProperties": false } },
96
+ "prerequisites": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true }
97
+ },
98
+ "additionalProperties": false
99
+ },
100
+ "retrieval": { "$ref": "#/$defs/retrieval" }
101
+ },
102
+ "additionalProperties": false
103
+ },
104
+ "successCriteria": {
105
+ "type": "array",
106
+ "minItems": 1,
107
+ "items": {
108
+ "type": "object",
109
+ "required": ["id", "kind", "expected", "producerCommand", "machineVerifiable"],
110
+ "properties": {
111
+ "id": { "type": "string", "minLength": 1 },
112
+ "kind": { "enum": ["workspace-verify", "release-readiness", "dependency-security", "test-coverage"] },
113
+ "expected": { "type": "string", "minLength": 1 },
114
+ "producerCommand": { "type": "string", "minLength": 1 },
115
+ "machineVerifiable": { "type": "boolean" }
116
+ },
117
+ "additionalProperties": false
118
+ }
119
+ },
120
+ "policy": {
121
+ "type": "object",
122
+ "required": ["mutationMode", "approval", "verificationOwner", "rollbackOwner", "maxAttempts", "allowBreakingChanges", "allowForce", "networkAccess", "scopeExpansion"],
123
+ "properties": {
124
+ "mutationMode": { "const": "proposal-only" },
125
+ "approval": { "const": "required-before-mutation" },
126
+ "verificationOwner": { "const": "workspai-cli" },
127
+ "rollbackOwner": { "const": "workspai-cli" },
128
+ "maxAttempts": { "type": "integer", "minimum": 1, "maximum": 25 },
129
+ "allowBreakingChanges": { "const": false },
130
+ "allowForce": { "const": false },
131
+ "networkAccess": { "const": "not-granted" },
132
+ "scopeExpansion": { "const": "requires-decision" }
133
+ },
134
+ "additionalProperties": false
135
+ },
136
+ "orchestration": {
137
+ "type": "array",
138
+ "minItems": 6,
139
+ "maxItems": 6,
140
+ "items": {
141
+ "type": "object",
142
+ "required": ["id", "owner", "status", "summary"],
143
+ "properties": {
144
+ "id": { "enum": ["understand", "impact", "propose", "approve", "execute", "verify"] },
145
+ "owner": { "enum": ["workspai-cli", "agent", "human"] },
146
+ "status": { "enum": ["complete", "pending", "blocked"] },
147
+ "summary": { "type": "string", "minLength": 1 }
148
+ },
149
+ "additionalProperties": false
150
+ }
151
+ },
152
+ "decision": {
153
+ "type": "object",
154
+ "required": ["required", "reason", "question"],
155
+ "properties": {
156
+ "required": { "const": true },
157
+ "reason": { "type": "string", "minLength": 1 },
158
+ "question": { "type": "string", "minLength": 1 }
159
+ },
160
+ "additionalProperties": false
161
+ },
162
+ "artifacts": {
163
+ "type": "object",
164
+ "required": ["goalPack", "agentHandoff", "latestReport"],
165
+ "properties": {
166
+ "goalPack": { "type": "string", "pattern": "^\\.workspai/goals/[^/]+/goal-pack\\.json$" },
167
+ "agentHandoff": { "type": "string", "pattern": "^\\.workspai/goals/[^/]+/agent-handoff\\.json$" },
168
+ "latestReport": { "const": ".workspai/reports/goal-pack-last-run.json" }
169
+ },
170
+ "additionalProperties": false
171
+ },
172
+ "commands": {
173
+ "type": "object",
174
+ "required": ["refreshEvidence", "inspectGraph", "proposeRepair"],
175
+ "properties": {
176
+ "refreshEvidence": { "const": "workspai workspace intelligence run --for-agent generic --strict --json" },
177
+ "inspectGraph": { "type": "string", "pattern": "^workspai workspace graph search " },
178
+ "planVerifiedGoal": { "type": "string", "pattern": "^workspai workspace goal plan " },
179
+ "proposeRepair": { "const": "workspai workspace repair propose --file <proposal.json> --json" }
180
+ },
181
+ "additionalProperties": false
182
+ }
183
+ },
184
+ "$defs": {
185
+ "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
186
+ "scope": {
187
+ "type": "object",
188
+ "required": ["kind", "projects", "selectionSource"],
189
+ "properties": {
190
+ "kind": { "enum": ["workspace", "project"] },
191
+ "projects": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
192
+ "selectionSource": { "enum": ["workspace", "invocation-project", "explicit"] }
193
+ },
194
+ "additionalProperties": false
195
+ },
196
+ "modelBinding": {
197
+ "type": "object",
198
+ "required": ["artifact", "schemaVersion", "hashAlgorithm", "hashSemantics", "hash", "generatedAt"],
199
+ "properties": {
200
+ "artifact": { "const": ".workspai/reports/workspace-model.json" },
201
+ "schemaVersion": { "const": "workspace-model.v1" },
202
+ "hashAlgorithm": { "const": "sha256" },
203
+ "hashSemantics": { "const": "workspace-model-structural-v1" },
204
+ "hash": { "$ref": "#/$defs/hash" },
205
+ "generatedAt": { "type": "string", "format": "date-time" }
206
+ },
207
+ "additionalProperties": false
208
+ },
209
+ "graphBinding": {
210
+ "type": "object",
211
+ "required": ["artifact", "schemaVersion", "hashAlgorithm", "hashSemantics", "hash", "generatedAt", "modelHash"],
212
+ "properties": {
213
+ "artifact": { "const": ".workspai/reports/workspace-knowledge-graph.json" },
214
+ "schemaVersion": { "const": "workspace-knowledge-graph.v1" },
215
+ "hashAlgorithm": { "const": "sha256" },
216
+ "hashSemantics": { "const": "canonical-json-v1" },
217
+ "hash": { "$ref": "#/$defs/hash" },
218
+ "generatedAt": { "type": "string", "format": "date-time" },
219
+ "modelHash": { "$ref": "#/$defs/hash" },
220
+ "inputHash": { "$ref": "#/$defs/hash" }
221
+ },
222
+ "additionalProperties": false
223
+ },
224
+ "retrieval": {
225
+ "type": "object",
226
+ "required": ["status", "strategy", "queries", "anchors"],
227
+ "properties": {
228
+ "status": { "enum": ["grounded", "partial", "empty"] },
229
+ "strategy": { "const": "deterministic-category-v1" },
230
+ "queries": { "type": "array", "minItems": 1, "maxItems": 3, "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
231
+ "anchors": {
232
+ "type": "array",
233
+ "maxItems": 20,
234
+ "items": {
235
+ "type": "object",
236
+ "required": ["entityId", "kind", "label", "proofIds"],
237
+ "properties": {
238
+ "entityId": { "type": "string", "minLength": 1 },
239
+ "kind": { "type": "string", "minLength": 1 },
240
+ "label": { "type": "string", "minLength": 1 },
241
+ "proofIds": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true }
242
+ },
243
+ "additionalProperties": false
244
+ }
245
+ }
246
+ },
247
+ "additionalProperties": false
248
+ }
249
+ },
250
+ "additionalProperties": false
251
+ }
@@ -0,0 +1,46 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://workspai.dev/schemas/workspace-intelligence/goal-plan-result.v1.json",
4
+ "title": "Workspai Goal Plan Result",
5
+ "type": "object",
6
+ "required": ["schemaVersion", "result", "resolution", "goalPack", "agentHandoff", "writtenArtifacts", "dryRun", "resumed"],
7
+ "properties": {
8
+ "schemaVersion": { "const": "workspai.goal-plan-result.v1" },
9
+ "result": { "enum": ["planned", "needs-confirmation", "needs-evidence", "blocked"] },
10
+ "resolution": {
11
+ "type": "object",
12
+ "required": ["source", "invocationScope"],
13
+ "properties": {
14
+ "source": { "enum": ["explicit", "parent", "local-link", "registry"] },
15
+ "invocationScope": { "enum": ["workspace", "project"] }
16
+ },
17
+ "additionalProperties": false
18
+ },
19
+ "goalPack": {
20
+ "type": "object",
21
+ "required": ["schemaVersion", "id", "fingerprint"],
22
+ "properties": {
23
+ "schemaVersion": { "const": "workspai.goal-pack.v1" },
24
+ "id": { "type": "string" },
25
+ "fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
26
+ }
27
+ },
28
+ "agentHandoff": {
29
+ "type": "object",
30
+ "required": ["schemaVersion", "goalId", "goalFingerprint"],
31
+ "properties": {
32
+ "schemaVersion": { "const": "workspai.goal-agent-handoff.v1" },
33
+ "goalId": { "type": "string" },
34
+ "goalFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
35
+ }
36
+ },
37
+ "writtenArtifacts": {
38
+ "type": "array",
39
+ "items": { "type": "string", "pattern": "^\\.workspai/" },
40
+ "uniqueItems": true
41
+ },
42
+ "dryRun": { "type": "boolean" },
43
+ "resumed": { "type": "boolean" }
44
+ },
45
+ "additionalProperties": false
46
+ }
@@ -0,0 +1,204 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://workspai.dev/schemas/workspace-intelligence/project-agent-entry.v1.json",
4
+ "title": "Workspai Project Agent Entry",
5
+ "description": "Portable host-discovery and canonical-first entry contract for an adopted or managed project.",
6
+ "type": "object",
7
+ "additionalProperties": false,
8
+ "required": [
9
+ "schemaVersion",
10
+ "generatedAt",
11
+ "project",
12
+ "workspace",
13
+ "canonical",
14
+ "protocol",
15
+ "hosts",
16
+ "integrity"
17
+ ],
18
+ "properties": {
19
+ "schemaVersion": { "const": "workspai.agent-entry.v1" },
20
+ "generatedAt": { "type": "string", "format": "date-time" },
21
+ "project": {
22
+ "type": "object",
23
+ "additionalProperties": false,
24
+ "required": ["name", "relativePath"],
25
+ "properties": {
26
+ "name": { "type": "string", "minLength": 1 },
27
+ "relativePath": { "$ref": "#/$defs/portablePath" },
28
+ "runtime": { "type": "string", "minLength": 1 },
29
+ "framework": { "type": "string", "minLength": 1 }
30
+ }
31
+ },
32
+ "workspace": {
33
+ "type": "object",
34
+ "additionalProperties": false,
35
+ "required": [
36
+ "name",
37
+ "relationship",
38
+ "localBinding",
39
+ "identityIsFilesystemPath",
40
+ "resolverCommand",
41
+ "portableUriScheme",
42
+ "resolvedPathPolicy"
43
+ ],
44
+ "properties": {
45
+ "name": { "type": "string", "minLength": 1 },
46
+ "relationship": {
47
+ "enum": ["managed", "adopted", "imported", "linked", "restored"]
48
+ },
49
+ "localBinding": { "const": ".workspai/workspace-link.local.json" },
50
+ "identityIsFilesystemPath": { "const": false },
51
+ "resolverCommand": { "const": "workspai project workspace status --json" },
52
+ "portableUriScheme": { "const": "workspace:" },
53
+ "resolvedPathPolicy": { "const": "runtime-private-never-persist" }
54
+ }
55
+ },
56
+ "canonical": {
57
+ "type": "object",
58
+ "additionalProperties": false,
59
+ "required": [
60
+ "projectContext",
61
+ "projectGrounding",
62
+ "goalIndex",
63
+ "workspaceIndex",
64
+ "workspaceContext",
65
+ "workspaceModel",
66
+ "knowledgeGraph"
67
+ ],
68
+ "properties": {
69
+ "projectContext": { "const": ".workspai/reports/project-context-agent.json" },
70
+ "projectGrounding": { "const": ".workspai/PROJECT-GROUNDING.md" },
71
+ "goalIndex": { "const": "workspace:.workspai/goals/index.json" },
72
+ "workspaceIndex": { "const": "workspace:.workspai/reports/INDEX.json" },
73
+ "workspaceContext": {
74
+ "const": "workspace:.workspai/reports/workspace-context-agent.json"
75
+ },
76
+ "workspaceModel": { "const": "workspace:.workspai/reports/workspace-model.json" },
77
+ "knowledgeGraph": {
78
+ "const": "workspace:.workspai/reports/workspace-knowledge-graph.json"
79
+ }
80
+ }
81
+ },
82
+ "protocol": {
83
+ "type": "object",
84
+ "additionalProperties": false,
85
+ "required": [
86
+ "mode",
87
+ "bootstrapCommand",
88
+ "verifyCommand",
89
+ "requiredReadOrder",
90
+ "sourcePolicy",
91
+ "degradedMode"
92
+ ],
93
+ "properties": {
94
+ "mode": { "const": "canonical-first" },
95
+ "bootstrapCommand": { "type": "string", "minLength": 1 },
96
+ "verifyCommand": { "type": "string", "minLength": 1 },
97
+ "requiredReadOrder": {
98
+ "type": "array",
99
+ "minItems": 6,
100
+ "maxItems": 16,
101
+ "uniqueItems": true,
102
+ "items": { "type": "string", "minLength": 1 }
103
+ },
104
+ "sourcePolicy": {
105
+ "type": "object",
106
+ "additionalProperties": false,
107
+ "required": [
108
+ "liveSourceAuthority",
109
+ "workspaceEvidenceAuthority",
110
+ "broadScanBeforeBootstrap",
111
+ "sourceMutation",
112
+ "verificationClaims"
113
+ ],
114
+ "properties": {
115
+ "liveSourceAuthority": { "const": "exact-implementation" },
116
+ "workspaceEvidenceAuthority": { "const": "identity-topology-readiness-goals" },
117
+ "broadScanBeforeBootstrap": { "const": false },
118
+ "sourceMutation": { "const": "governed-only" },
119
+ "verificationClaims": { "const": "cli-evidence-only" }
120
+ }
121
+ },
122
+ "degradedMode": {
123
+ "type": "object",
124
+ "additionalProperties": false,
125
+ "required": [
126
+ "discloseMissingEvidence",
127
+ "allowCompleteArchitectureClaims",
128
+ "allowReadOnlySourceInspection"
129
+ ],
130
+ "properties": {
131
+ "discloseMissingEvidence": { "const": true },
132
+ "allowCompleteArchitectureClaims": { "const": false },
133
+ "allowReadOnlySourceInspection": { "const": true }
134
+ }
135
+ }
136
+ }
137
+ },
138
+ "hosts": {
139
+ "type": "array",
140
+ "minItems": 11,
141
+ "maxItems": 11,
142
+ "items": { "$ref": "#/$defs/host" }
143
+ },
144
+ "integrity": {
145
+ "type": "object",
146
+ "additionalProperties": false,
147
+ "required": [
148
+ "algorithm",
149
+ "projectContextHash",
150
+ "payloadHash",
151
+ "portable",
152
+ "absolutePathsEmitted"
153
+ ],
154
+ "properties": {
155
+ "algorithm": { "const": "sha256" },
156
+ "projectContextHash": { "$ref": "#/$defs/hash" },
157
+ "payloadHash": { "$ref": "#/$defs/hash" },
158
+ "portable": { "const": true },
159
+ "absolutePathsEmitted": { "const": false }
160
+ }
161
+ }
162
+ },
163
+ "$defs": {
164
+ "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
165
+ "portablePath": {
166
+ "type": "string",
167
+ "minLength": 1,
168
+ "not": { "pattern": "^(?:/|[A-Za-z]:[\\\\/])" }
169
+ },
170
+ "host": {
171
+ "type": "object",
172
+ "additionalProperties": false,
173
+ "required": ["id", "discovery", "entryFiles", "status", "managed"],
174
+ "properties": {
175
+ "id": {
176
+ "enum": [
177
+ "generic",
178
+ "codex",
179
+ "claude",
180
+ "gemini",
181
+ "qwen",
182
+ "kimi",
183
+ "grok",
184
+ "copilot",
185
+ "cursor",
186
+ "windsurf",
187
+ "amazon-q"
188
+ ]
189
+ },
190
+ "discovery": { "enum": ["native", "adapter", "portable-fallback"] },
191
+ "entryFiles": {
192
+ "type": "array",
193
+ "minItems": 1,
194
+ "maxItems": 3,
195
+ "uniqueItems": true,
196
+ "items": { "$ref": "#/$defs/portablePath" }
197
+ },
198
+ "status": { "enum": ["ready", "degraded", "blocked"] },
199
+ "managed": { "type": "boolean" },
200
+ "reason": { "type": "string", "minLength": 1 }
201
+ }
202
+ }
203
+ }
204
+ }
@@ -28,17 +28,28 @@
28
28
  "relationship": {
29
29
  "enum": ["managed", "adopted", "imported", "linked", "restored"]
30
30
  },
31
- "contract": { "const": ".workspai/workspace.contract.json" },
32
- "model": { "const": ".workspai/reports/workspace-model.json" },
31
+ "contract": { "const": "workspace:.workspai/workspace.contract.json" },
32
+ "model": { "const": "workspace:.workspai/reports/workspace-model.json" },
33
33
  "knowledgeGraph": {
34
- "const": ".workspai/reports/workspace-knowledge-graph.json"
34
+ "const": "workspace:.workspai/reports/workspace-knowledge-graph.json"
35
35
  },
36
36
  "access": {
37
37
  "type": "object",
38
- "required": ["localBinding", "canonicalEvidenceAvailableAtGeneration"],
38
+ "required": [
39
+ "localBinding",
40
+ "canonicalEvidenceAvailableAtGeneration",
41
+ "identityIsFilesystemPath",
42
+ "resolverCommand",
43
+ "portableUriScheme",
44
+ "resolvedPathPolicy"
45
+ ],
39
46
  "properties": {
40
47
  "localBinding": { "const": ".workspai/workspace-link.local.json" },
41
- "canonicalEvidenceAvailableAtGeneration": { "type": "boolean" }
48
+ "canonicalEvidenceAvailableAtGeneration": { "type": "boolean" },
49
+ "identityIsFilesystemPath": { "const": false },
50
+ "resolverCommand": { "const": "workspai project workspace status --json" },
51
+ "portableUriScheme": { "const": "workspace:" },
52
+ "resolvedPathPolicy": { "const": "runtime-private-never-persist" }
42
53
  },
43
54
  "additionalProperties": false
44
55
  }
@@ -283,6 +294,7 @@
283
294
  "required": [
284
295
  "enforcement",
285
296
  "mandatoryPreflight",
297
+ "workspaceLocator",
286
298
  "workspaceEvidenceRequiredFor",
287
299
  "requiredReadOrder",
288
300
  "degradedMode"
@@ -293,8 +305,30 @@
293
305
  "type": "object",
294
306
  "required": ["command", "successCondition"],
295
307
  "properties": {
296
- "command": { "const": "npx workspai project workspace status --json" },
297
- "successCondition": { "const": "resolved" }
308
+ "command": {
309
+ "const": "workspai agent bootstrap --for-agent generic --strict --json"
310
+ },
311
+ "successCondition": { "const": "ready" }
312
+ },
313
+ "additionalProperties": false
314
+ },
315
+ "workspaceLocator": {
316
+ "type": "object",
317
+ "required": [
318
+ "command",
319
+ "successCondition",
320
+ "outputClassification",
321
+ "persistence",
322
+ "disclosure",
323
+ "portableUriScheme"
324
+ ],
325
+ "properties": {
326
+ "command": { "const": "workspai project workspace status --json" },
327
+ "successCondition": { "const": "resolved" },
328
+ "outputClassification": { "const": "machine-local" },
329
+ "persistence": { "const": "forbidden" },
330
+ "disclosure": { "const": "forbidden" },
331
+ "portableUriScheme": { "const": "workspace:" }
298
332
  },
299
333
  "additionalProperties": false
300
334
  },
@@ -408,16 +442,7 @@
408
442
  },
409
443
  "relation": {
410
444
  "type": "object",
411
- "required": [
412
- "id",
413
- "from",
414
- "to",
415
- "kind",
416
- "derivation",
417
- "trust",
418
- "confidence",
419
- "proofIds"
420
- ],
445
+ "required": ["id", "from", "to", "kind", "derivation", "trust", "confidence", "proofIds"],
421
446
  "properties": {
422
447
  "id": { "type": "string" },
423
448
  "from": { "type": "string" },
@@ -432,15 +457,7 @@
432
457
  },
433
458
  "proof": {
434
459
  "type": "object",
435
- "required": [
436
- "id",
437
- "provider",
438
- "artifact",
439
- "derivation",
440
- "trust",
441
- "confidence",
442
- "freshness"
443
- ],
460
+ "required": ["id", "provider", "artifact", "derivation", "trust", "confidence", "freshness"],
444
461
  "properties": {
445
462
  "id": { "type": "string" },
446
463
  "provider": { "type": "string" },
@@ -26,7 +26,20 @@
26
26
  "format": "date-time"
27
27
  },
28
28
  "agent": {
29
- "enum": ["generic", "codex", "claude", "cursor", "orca"]
29
+ "enum": [
30
+ "generic",
31
+ "codex",
32
+ "claude",
33
+ "cursor",
34
+ "gemini",
35
+ "qwen",
36
+ "kimi",
37
+ "grok",
38
+ "copilot",
39
+ "windsurf",
40
+ "amazon-q",
41
+ "orca"
42
+ ]
30
43
  },
31
44
  "workspaceSummary": { "type": "string" },
32
45
  "modelRef": { "type": "string" },
@@ -9,6 +9,7 @@
9
9
  "properties": {
10
10
  "schemaVersion": { "const": "workspai.workspace-repair-proposal.v1" },
11
11
  "cardId": { "type": "string", "minLength": 1, "maxLength": 160 },
12
+ "goalId": { "type": "string", "pattern": "^goal-[A-Za-z0-9._-]{3,90}$" },
12
13
  "blockerSignature": { "type": "string", "minLength": 1, "maxLength": 256 },
13
14
  "targetActionIds": {
14
15
  "type": "array",