@devtrack-solution/codesdd 1.2.2 → 1.2.3

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 (345) hide show
  1. package/.sdd/skills/curated/api-clean-flask-langgraph/SKILL.md +17 -17
  2. package/.sdd/skills/curated/devtrack-api/SKILL.md +160 -28
  3. package/.sdd/skills/curated/devtrack-api/agents/openai.yaml +1 -1
  4. package/.sdd/skills/curated/devtrack-api/references/architecture-governance.md +8 -7
  5. package/.sdd/skills/curated/devtrack-api/references/consumer-sync-policy.md +93 -0
  6. package/.sdd/skills/curated/devtrack-api/references/contract-pack.yaml +317 -0
  7. package/.sdd/skills/curated/devtrack-api/references/field-validation-protocol.md +95 -0
  8. package/.sdd/skills/curated/devtrack-api/references/foundation-layout.md +295 -0
  9. package/.sdd/skills/curated/devtrack-api/references/implementation-checklist.md +4 -4
  10. package/.sdd/skills/curated/devtrack-api/references/imports-lint.md +4 -0
  11. package/.sdd/skills/curated/devtrack-api/references/testing-validation.md +2 -2
  12. package/LICENSE +1 -1
  13. package/README.md +243 -51
  14. package/bin/codesdd.js +3 -2
  15. package/dist/cli/index.d.ts +2 -2
  16. package/dist/cli/index.js +11 -558
  17. package/dist/cli/program.d.ts +14 -0
  18. package/dist/cli/program.js +645 -0
  19. package/dist/commands/change.js +5 -5
  20. package/dist/commands/completion.d.ts +1 -1
  21. package/dist/commands/completion.js +9 -2
  22. package/dist/commands/config.js +159 -20
  23. package/dist/commands/feedback.js +1 -1
  24. package/dist/commands/schema.d.ts +63 -0
  25. package/dist/commands/schema.js +12 -12
  26. package/dist/commands/sdd/backlog.d.ts +3 -0
  27. package/dist/commands/sdd/backlog.js +54 -0
  28. package/dist/commands/sdd/execution.js +147 -16
  29. package/dist/commands/sdd/plugin.d.ts +3 -0
  30. package/dist/commands/sdd/plugin.js +153 -0
  31. package/dist/commands/sdd/shared.js +2 -23
  32. package/dist/commands/sdd/skills.js +7 -0
  33. package/dist/commands/sdd.js +69 -12
  34. package/dist/commands/spec.js +9 -9
  35. package/dist/commands/validate.js +6 -6
  36. package/dist/commands/workflow/instructions.js +6 -6
  37. package/dist/commands/workflow/new-change.js +3 -3
  38. package/dist/commands/workflow/shared.d.ts +1 -1
  39. package/dist/commands/workflow/shared.js +4 -4
  40. package/dist/core/archive.js +15 -5
  41. package/dist/core/artifact-graph/instruction-loader.d.ts +1 -1
  42. package/dist/core/artifact-graph/instruction-loader.js +3 -3
  43. package/dist/core/artifact-graph/resolver.d.ts +4 -4
  44. package/dist/core/artifact-graph/resolver.js +6 -6
  45. package/dist/core/branding.js +3 -3
  46. package/dist/core/cli/command-matrix.js +10 -1
  47. package/dist/core/cli-command-quality.d.ts +27 -0
  48. package/dist/core/cli-command-quality.js +171 -0
  49. package/dist/core/command-generation/adapters/costrict.d.ts +1 -1
  50. package/dist/core/command-generation/adapters/costrict.js +2 -2
  51. package/dist/core/command-generation/types.d.ts +1 -1
  52. package/dist/core/completions/command-registry.d.ts +1 -1
  53. package/dist/core/completions/command-registry.js +155 -12
  54. package/dist/core/completions/completion-provider.d.ts +14 -1
  55. package/dist/core/completions/completion-provider.js +29 -1
  56. package/dist/core/completions/generators/bash-generator.d.ts +1 -1
  57. package/dist/core/completions/generators/bash-generator.js +20 -12
  58. package/dist/core/completions/generators/fish-generator.d.ts +9 -1
  59. package/dist/core/completions/generators/fish-generator.js +39 -25
  60. package/dist/core/completions/generators/powershell-generator.d.ts +1 -1
  61. package/dist/core/completions/generators/powershell-generator.js +21 -11
  62. package/dist/core/completions/generators/zsh-generator.d.ts +3 -6
  63. package/dist/core/completions/generators/zsh-generator.js +21 -42
  64. package/dist/core/completions/installers/bash-installer.js +6 -6
  65. package/dist/core/completions/installers/fish-installer.js +1 -1
  66. package/dist/core/completions/installers/powershell-installer.js +14 -14
  67. package/dist/core/completions/installers/zsh-installer.d.ts +7 -1
  68. package/dist/core/completions/installers/zsh-installer.js +36 -8
  69. package/dist/core/completions/templates/bash-templates.d.ts +1 -1
  70. package/dist/core/completions/templates/bash-templates.js +12 -6
  71. package/dist/core/completions/templates/fish-templates.d.ts +2 -2
  72. package/dist/core/completions/templates/fish-templates.js +20 -9
  73. package/dist/core/completions/templates/powershell-templates.d.ts +1 -1
  74. package/dist/core/completions/templates/powershell-templates.js +13 -4
  75. package/dist/core/completions/templates/zsh-templates.d.ts +1 -1
  76. package/dist/core/completions/templates/zsh-templates.js +18 -9
  77. package/dist/core/config-schema.d.ts +3 -1
  78. package/dist/core/config-schema.js +26 -1
  79. package/dist/core/config.d.ts +3 -3
  80. package/dist/core/config.js +4 -4
  81. package/dist/core/global-config.d.ts +41 -12
  82. package/dist/core/global-config.js +344 -27
  83. package/dist/core/index.d.ts +1 -1
  84. package/dist/core/index.js +2 -2
  85. package/dist/core/init.d.ts +6 -1
  86. package/dist/core/init.js +99 -77
  87. package/dist/core/legacy-cleanup.d.ts +17 -17
  88. package/dist/core/legacy-cleanup.js +96 -79
  89. package/dist/core/list.js +18 -4
  90. package/dist/core/migration.d.ts +3 -1
  91. package/dist/core/migration.js +7 -8
  92. package/dist/core/parsers/change-parser.js +1 -1
  93. package/dist/core/parsers/markdown-parser.js +2 -2
  94. package/dist/core/profile-sync-drift.d.ts +1 -1
  95. package/dist/core/profile-sync-drift.js +13 -13
  96. package/dist/core/project-config.d.ts +4 -4
  97. package/dist/core/project-config.js +11 -11
  98. package/dist/core/schemas/change.schema.d.ts +1 -1
  99. package/dist/core/schemas/change.schema.js +1 -1
  100. package/dist/core/schemas/spec.schema.d.ts +1 -1
  101. package/dist/core/schemas/spec.schema.js +1 -1
  102. package/dist/core/sdd/adr.js +23 -1
  103. package/dist/core/sdd/agent-binding.d.ts +346 -0
  104. package/dist/core/sdd/agent-binding.js +343 -0
  105. package/dist/core/sdd/backlog-cli.d.ts +16 -0
  106. package/dist/core/sdd/backlog-cli.js +146 -0
  107. package/dist/core/sdd/backlog-conflict-policy.d.ts +58 -0
  108. package/dist/core/sdd/backlog-conflict-policy.js +230 -0
  109. package/dist/core/sdd/backlog-projection.d.ts +8 -0
  110. package/dist/core/sdd/backlog-projection.js +89 -0
  111. package/dist/core/sdd/backlog-provider-contract.d.ts +252 -0
  112. package/dist/core/sdd/backlog-provider-contract.js +158 -0
  113. package/dist/core/sdd/bootstrap.js +2 -2
  114. package/dist/core/sdd/check.d.ts +42 -0
  115. package/dist/core/sdd/check.js +22 -22
  116. package/dist/core/sdd/contract.d.ts +13 -0
  117. package/dist/core/sdd/contract.js +36 -0
  118. package/dist/core/sdd/coordination/coordination-adapters.d.ts +38 -0
  119. package/dist/core/sdd/coordination/coordination-adapters.js +139 -1
  120. package/dist/core/sdd/deepagent-contracts.d.ts +276 -0
  121. package/dist/core/sdd/deepagent-contracts.js +173 -0
  122. package/dist/core/sdd/deepagents/adr-governor.d.ts +2 -0
  123. package/dist/core/sdd/deepagents/adr-governor.js +30 -0
  124. package/dist/core/sdd/deepagents/backend.d.ts +63 -0
  125. package/dist/core/sdd/deepagents/backend.js +174 -0
  126. package/dist/core/sdd/deepagents/codesdd-tools.d.ts +39 -0
  127. package/dist/core/sdd/deepagents/codesdd-tools.js +83 -0
  128. package/dist/core/sdd/deepagents/evidence-mapper.d.ts +86 -0
  129. package/dist/core/sdd/deepagents/evidence-mapper.js +178 -0
  130. package/dist/core/sdd/deepagents/model-provider.d.ts +53 -0
  131. package/dist/core/sdd/deepagents/model-provider.js +379 -0
  132. package/dist/core/sdd/deepagents/policy-enforcement.d.ts +30 -0
  133. package/dist/core/sdd/deepagents/policy-enforcement.js +90 -0
  134. package/dist/core/sdd/deepagents/policy.d.ts +75 -0
  135. package/dist/core/sdd/deepagents/policy.js +358 -0
  136. package/dist/core/sdd/deepagents/quality-witness.d.ts +3 -0
  137. package/dist/core/sdd/deepagents/quality-witness.js +77 -0
  138. package/dist/core/sdd/deepagents/reversa-subagents.d.ts +75 -0
  139. package/dist/core/sdd/deepagents/reversa-subagents.js +182 -0
  140. package/dist/core/sdd/deepagents/runtime-factory.d.ts +90 -0
  141. package/dist/core/sdd/deepagents/runtime-factory.js +231 -0
  142. package/dist/core/sdd/deepagents/runtime-loader.d.ts +16 -0
  143. package/dist/core/sdd/deepagents/runtime-loader.js +65 -0
  144. package/dist/core/sdd/default-bootstrap-files.d.ts +2 -2
  145. package/dist/core/sdd/default-bootstrap-files.js +36 -2
  146. package/dist/core/sdd/default-skills.d.ts +30 -0
  147. package/dist/core/sdd/default-skills.js +181 -5
  148. package/dist/core/sdd/devtrack-api-appliance.d.ts +84 -0
  149. package/dist/core/sdd/devtrack-api-appliance.js +257 -0
  150. package/dist/core/sdd/devtrack-api-architecture.d.ts +31 -0
  151. package/dist/core/sdd/devtrack-api-architecture.js +608 -0
  152. package/dist/core/sdd/devtrack-api-import-boundary.d.ts +19 -0
  153. package/dist/core/sdd/devtrack-api-import-boundary.js +32 -0
  154. package/dist/core/sdd/diagnose.d.ts +59 -0
  155. package/dist/core/sdd/diagnose.js +37 -37
  156. package/dist/core/sdd/docs-sync.js +33 -5
  157. package/dist/core/sdd/domain/post-active-validation.d.ts +7 -0
  158. package/dist/core/sdd/domain/post-active-validation.js +61 -0
  159. package/dist/core/sdd/domain/transition-engine.js +1 -0
  160. package/dist/core/sdd/entity-reference.d.ts +5 -0
  161. package/dist/core/sdd/entity-reference.js +22 -0
  162. package/dist/core/sdd/governance-backfill.d.ts +31 -0
  163. package/dist/core/sdd/governance-backfill.js +359 -0
  164. package/dist/core/sdd/governance-parser.d.ts +21 -0
  165. package/dist/core/sdd/governance-parser.js +91 -0
  166. package/dist/core/sdd/governance-schemas.d.ts +245 -0
  167. package/dist/core/sdd/governance-schemas.js +143 -0
  168. package/dist/core/sdd/{import-openspec.d.ts → import-legacy-spec.d.ts} +7 -7
  169. package/dist/core/sdd/{import-openspec.js → import-legacy-spec.js} +21 -29
  170. package/dist/core/sdd/init.d.ts +3 -0
  171. package/dist/core/sdd/init.js +6 -3
  172. package/dist/core/sdd/json-schema.js +100 -6
  173. package/dist/core/sdd/knowledge-graph.d.ts +45 -0
  174. package/dist/core/sdd/knowledge-graph.js +288 -0
  175. package/dist/core/sdd/legacy-operations.js +431 -43
  176. package/dist/core/sdd/lenses.d.ts +1 -0
  177. package/dist/core/sdd/lenses.js +29 -1
  178. package/dist/core/sdd/migrate-workspace.js +56 -2
  179. package/dist/core/sdd/migrate.d.ts +1 -1
  180. package/dist/core/sdd/migrate.js +36 -2
  181. package/dist/core/sdd/package-structure-gate.d.ts +83 -0
  182. package/dist/core/sdd/package-structure-gate.js +362 -0
  183. package/dist/core/sdd/parallel-feat-automation.d.ts +152 -0
  184. package/dist/core/sdd/parallel-feat-automation.js +212 -0
  185. package/dist/core/sdd/plugin-broker.d.ts +558 -0
  186. package/dist/core/sdd/plugin-broker.js +482 -0
  187. package/dist/core/sdd/plugin-certification.d.ts +79 -0
  188. package/dist/core/sdd/plugin-certification.js +453 -0
  189. package/dist/core/sdd/plugin-cli.d.ts +109 -0
  190. package/dist/core/sdd/plugin-cli.js +198 -0
  191. package/dist/core/sdd/plugin-evidence.d.ts +275 -0
  192. package/dist/core/sdd/plugin-evidence.js +307 -0
  193. package/dist/core/sdd/plugin-manifest.d.ts +164 -0
  194. package/dist/core/sdd/plugin-manifest.js +215 -0
  195. package/dist/core/sdd/plugin-policy-pack.d.ts +88 -0
  196. package/dist/core/sdd/plugin-policy-pack.js +236 -0
  197. package/dist/core/sdd/plugin-policy.d.ts +68 -0
  198. package/dist/core/sdd/plugin-policy.js +212 -0
  199. package/dist/core/sdd/plugin-registry.d.ts +311 -0
  200. package/dist/core/sdd/plugin-registry.js +138 -0
  201. package/dist/core/sdd/plugin-skill-binding.d.ts +151 -0
  202. package/dist/core/sdd/plugin-skill-binding.js +339 -0
  203. package/dist/core/sdd/quality-artifact-manifest-validator.d.ts +28 -0
  204. package/dist/core/sdd/quality-artifact-manifest-validator.js +167 -0
  205. package/dist/core/sdd/quality-evidence-renderer.d.ts +65 -0
  206. package/dist/core/sdd/quality-evidence-renderer.js +218 -0
  207. package/dist/core/sdd/quality-scenario-runner.d.ts +42 -0
  208. package/dist/core/sdd/quality-scenario-runner.js +613 -0
  209. package/dist/core/sdd/quality-validation.d.ts +547 -0
  210. package/dist/core/sdd/quality-validation.js +239 -0
  211. package/dist/core/sdd/resolve-project-root.d.ts +2 -2
  212. package/dist/core/sdd/resolve-project-root.js +11 -5
  213. package/dist/core/sdd/sanitize.d.ts +30 -1
  214. package/dist/core/sdd/sanitize.js +23 -23
  215. package/dist/core/sdd/services/agent-run.service.d.ts +65 -0
  216. package/dist/core/sdd/services/agent-run.service.js +189 -0
  217. package/dist/core/sdd/services/breakdown.service.js +2 -1
  218. package/dist/core/sdd/services/context.service.js +18 -16
  219. package/dist/core/sdd/services/debate.service.js +15 -2
  220. package/dist/core/sdd/services/feature-lint.service.d.ts +22 -0
  221. package/dist/core/sdd/services/feature-lint.service.js +105 -5
  222. package/dist/core/sdd/services/finalize.service.d.ts +80 -0
  223. package/dist/core/sdd/services/finalize.service.js +323 -24
  224. package/dist/core/sdd/services/frontend-gap.service.js +22 -7
  225. package/dist/core/sdd/services/governance-control-plane-runtime-adapters.d.ts +17 -0
  226. package/dist/core/sdd/services/governance-control-plane-runtime-adapters.js +38 -0
  227. package/dist/core/sdd/services/governance-control-plane.service.d.ts +66 -0
  228. package/dist/core/sdd/services/governance-control-plane.service.js +134 -0
  229. package/dist/core/sdd/services/ingest-deposito.service.js +1 -1
  230. package/dist/core/sdd/services/legacy-capability.service.d.ts +10 -7
  231. package/dist/core/sdd/services/legacy-capability.service.js +38 -21
  232. package/dist/core/sdd/services/mcp-runtime.service.d.ts +123 -8
  233. package/dist/core/sdd/services/mcp-runtime.service.js +1085 -33
  234. package/dist/core/sdd/services/onboard.service.js +2 -1
  235. package/dist/core/sdd/services/rebuild.service.js +6 -1
  236. package/dist/core/sdd/services/skills-sync.service.d.ts +17 -5
  237. package/dist/core/sdd/services/skills-sync.service.js +55 -2
  238. package/dist/core/sdd/services/start.service.js +6 -4
  239. package/dist/core/sdd/skill-bundles-curation-schema.d.ts +66 -0
  240. package/dist/core/sdd/skill-bundles-curation-schema.js +52 -0
  241. package/dist/core/sdd/skill-evidence.d.ts +19 -0
  242. package/dist/core/sdd/skill-evidence.js +38 -0
  243. package/dist/core/sdd/skill-policy-pool.d.ts +46 -0
  244. package/dist/core/sdd/skill-policy-pool.js +185 -0
  245. package/dist/core/sdd/state.d.ts +22 -0
  246. package/dist/core/sdd/state.js +66 -41
  247. package/dist/core/sdd/structural-health.d.ts +42 -42
  248. package/dist/core/sdd/types.d.ts +33 -7
  249. package/dist/core/sdd/types.js +17 -0
  250. package/dist/core/sdd/upgrade-to-codesdd.d.ts +45 -0
  251. package/dist/core/sdd/upgrade-to-codesdd.js +179 -0
  252. package/dist/core/sdd/workspace-schemas.d.ts +285 -14
  253. package/dist/core/sdd/workspace-schemas.js +148 -0
  254. package/dist/core/sdd/write-manifest.js +22 -4
  255. package/dist/core/shared/skill-generation.d.ts +1 -1
  256. package/dist/core/shared/skill-generation.js +15 -15
  257. package/dist/core/shared/tool-detection.d.ts +3 -3
  258. package/dist/core/shared/tool-detection.js +14 -14
  259. package/dist/core/specs-apply.js +6 -6
  260. package/dist/core/templates/index.d.ts +1 -1
  261. package/dist/core/templates/index.js +1 -1
  262. package/dist/core/templates/workflows/apply-change.js +14 -14
  263. package/dist/core/templates/workflows/archive-change.js +32 -32
  264. package/dist/core/templates/workflows/bulk-archive-change.js +25 -25
  265. package/dist/core/templates/workflows/continue-change.js +12 -12
  266. package/dist/core/templates/workflows/explore.js +29 -29
  267. package/dist/core/templates/workflows/feedback.js +6 -6
  268. package/dist/core/templates/workflows/ff-change.js +24 -24
  269. package/dist/core/templates/workflows/new-change.js +20 -20
  270. package/dist/core/templates/workflows/onboard.js +33 -33
  271. package/dist/core/templates/workflows/propose.js +23 -23
  272. package/dist/core/templates/workflows/sdd.js +8 -8
  273. package/dist/core/templates/workflows/sync-specs.js +19 -19
  274. package/dist/core/templates/workflows/verify-change.js +17 -17
  275. package/dist/core/update.d.ts +2 -2
  276. package/dist/core/update.js +16 -15
  277. package/dist/core/validation/constants.d.ts +1 -1
  278. package/dist/core/validation/constants.js +1 -1
  279. package/dist/core/view.js +11 -11
  280. package/dist/telemetry/config.d.ts +2 -1
  281. package/dist/telemetry/config.js +17 -8
  282. package/dist/telemetry/index.d.ts +10 -2
  283. package/dist/telemetry/index.js +40 -7
  284. package/dist/ui/ascii-patterns.d.ts +2 -2
  285. package/dist/ui/ascii-patterns.js +2 -2
  286. package/dist/ui/welcome-screen.js +2 -2
  287. package/dist/utils/change-metadata.d.ts +4 -4
  288. package/dist/utils/change-metadata.js +6 -6
  289. package/dist/utils/change-utils.d.ts +3 -3
  290. package/dist/utils/change-utils.js +5 -5
  291. package/dist/utils/file-system.js +1 -1
  292. package/dist/utils/interactive.js +1 -1
  293. package/dist/utils/item-discovery.js +4 -4
  294. package/dist/utils/legacy-spec-compat.d.ts +2 -0
  295. package/dist/utils/legacy-spec-compat.js +2 -0
  296. package/dist/utils/shell-detection.d.ts +1 -0
  297. package/dist/utils/shell-detection.js +16 -0
  298. package/package.json +27 -17
  299. package/schemas/sdd/1-spec.schema.json +1 -1
  300. package/schemas/sdd/2-plan.schema.json +73 -1
  301. package/schemas/sdd/3-tasks.schema.json +73 -1
  302. package/schemas/sdd/4-changelog.schema.json +1 -1
  303. package/schemas/sdd/5-quality.schema.json +442 -2
  304. package/schemas/sdd/adr.schema.json +148 -0
  305. package/schemas/sdd/agent-binding-adapter.schema.json +210 -0
  306. package/schemas/sdd/agent-binding-resolution.schema.json +338 -0
  307. package/schemas/sdd/backlog-projection-plan.schema.json +180 -0
  308. package/schemas/sdd/backlog-provider-contract.schema.json +260 -0
  309. package/schemas/sdd/codesdd-plugin.schema.json +474 -0
  310. package/schemas/sdd/debate.schema.json +244 -0
  311. package/schemas/sdd/deepagent-decision-evidence.schema.json +58 -0
  312. package/schemas/sdd/deepagent-env-contract.schema.json +143 -0
  313. package/schemas/sdd/deepagent-quality-evidence.schema.json +108 -0
  314. package/schemas/sdd/deepagent-run-evidence.schema.json +192 -0
  315. package/schemas/sdd/deepagent-run-plan.schema.json +197 -0
  316. package/schemas/sdd/deepagent-run-request.schema.json +321 -0
  317. package/schemas/sdd/deepagent-subagent-evidence.schema.json +110 -0
  318. package/schemas/sdd/deepagent-tool-call-evidence.schema.json +78 -0
  319. package/schemas/sdd/discarded.schema.json +127 -0
  320. package/schemas/sdd/epic.schema.json +147 -0
  321. package/schemas/sdd/insight.schema.json +136 -0
  322. package/schemas/sdd/parallel-feat-automation-plan.schema.json +215 -0
  323. package/schemas/sdd/parallel-feat-automation-request.schema.json +109 -0
  324. package/schemas/sdd/plugin-artifact-manifest.schema.json +150 -0
  325. package/schemas/sdd/plugin-compliance-index.schema.json +136 -0
  326. package/schemas/sdd/plugin-dry-run-plan.schema.json +260 -0
  327. package/schemas/sdd/plugin-evidence-manifest.schema.json +569 -0
  328. package/schemas/sdd/plugin-policy-evaluation.schema.json +92 -0
  329. package/schemas/sdd/plugin-policy-pack-evaluation.schema.json +94 -0
  330. package/schemas/sdd/plugin-policy-pack.schema.json +196 -0
  331. package/schemas/sdd/plugin-registry.schema.json +558 -0
  332. package/schemas/sdd/plugin-rollback-manifest.schema.json +87 -0
  333. package/schemas/sdd/plugin-runtime-invocation-plan.schema.json +845 -0
  334. package/schemas/sdd/plugin-skill-binding-resolution.schema.json +305 -0
  335. package/schemas/sdd/plugin-skill-binding.schema.json +88 -0
  336. package/schemas/sdd/plugin-validation-manifest.schema.json +123 -0
  337. package/schemas/sdd/quality-architecture-schema.schema.json +216 -0
  338. package/schemas/sdd/quality-evidence-bundle.schema.json +1228 -0
  339. package/schemas/sdd/quality-run.schema.json +197 -0
  340. package/schemas/sdd/quality-scenario.schema.json +252 -0
  341. package/schemas/sdd/workspace-catalog.schema.json +9841 -22
  342. package/schemas/spec-driven/schema.yaml +4 -4
  343. package/schemas/spec-driven/templates/proposal.md +1 -1
  344. package/dist/utils/openspec-compat.d.ts +0 -2
  345. package/dist/utils/openspec-compat.js +0 -2
package/schemas/sdd/deepagent-decision-evidence.schema.json ADDED
@@ -0,0 +1,58 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "type": "object",
4
+ "properties": {
5
+ "schema_version": {
6
+ "type": "number",
7
+ "const": 1
8
+ },
9
+ "contract": {
10
+ "type": "string",
11
+ "const": "deepagent-decision-evidence/v1"
12
+ },
13
+ "decision_point": {
14
+ "type": "string",
15
+ "minLength": 1
16
+ },
17
+ "alternatives": {
18
+ "minItems": 1,
19
+ "type": "array",
20
+ "items": {
21
+ "type": "string",
22
+ "minLength": 1
23
+ }
24
+ },
25
+ "selected_option": {
26
+ "type": "string",
27
+ "minLength": 1
28
+ },
29
+ "adr_required": {
30
+ "type": "boolean"
31
+ },
32
+ "rationale": {
33
+ "type": "string",
34
+ "minLength": 1
35
+ },
36
+ "approvals": {
37
+ "default": [],
38
+ "type": "array",
39
+ "items": {
40
+ "type": "string",
41
+ "minLength": 1
42
+ }
43
+ }
44
+ },
45
+ "required": [
46
+ "schema_version",
47
+ "contract",
48
+ "decision_point",
49
+ "alternatives",
50
+ "selected_option",
51
+ "adr_required",
52
+ "rationale",
53
+ "approvals"
54
+ ],
55
+ "additionalProperties": false,
56
+ "title": "CodeSDD DeepAgent Decision Evidence",
57
+ "description": "Machine-readable decision trace contract for DeepAgents runs, including alternatives, approvals, ADR requirement, and rationale."
58
+ }
package/schemas/sdd/deepagent-env-contract.schema.json ADDED
@@ -0,0 +1,143 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "type": "object",
4
+ "properties": {
5
+ "schema_version": {
6
+ "type": "number",
7
+ "const": 1
8
+ },
9
+ "contract": {
10
+ "type": "string",
11
+ "const": "deepagent-env-contract/v1"
12
+ },
13
+ "runtime_mode": {
14
+ "default": "disabled",
15
+ "type": "string",
16
+ "enum": [
17
+ "disabled",
18
+ "fake",
19
+ "deepagents-js"
20
+ ]
21
+ },
22
+ "model_ref": {
23
+ "type": "string",
24
+ "minLength": 1
25
+ },
26
+ "planner_model_ref": {
27
+ "type": "string",
28
+ "minLength": 1
29
+ },
30
+ "reviewer_model_ref": {
31
+ "type": "string",
32
+ "minLength": 1
33
+ },
34
+ "coder_model_ref": {
35
+ "type": "string",
36
+ "minLength": 1
37
+ },
38
+ "execution_limits": {
39
+ "default": {},
40
+ "type": "object",
41
+ "properties": {
42
+ "max_iterations": {
43
+ "type": "integer",
44
+ "exclusiveMinimum": 0,
45
+ "maximum": 9007199254740991
46
+ },
47
+ "max_subagents": {
48
+ "type": "integer",
49
+ "exclusiveMinimum": 0,
50
+ "maximum": 9007199254740991
51
+ },
52
+ "max_parallel": {
53
+ "type": "integer",
54
+ "exclusiveMinimum": 0,
55
+ "maximum": 9007199254740991
56
+ }
57
+ },
58
+ "additionalProperties": false
59
+ },
60
+ "provider_profile": {
61
+ "type": "string",
62
+ "minLength": 1
63
+ },
64
+ "env_allowlist": {
65
+ "default": [],
66
+ "type": "array",
67
+ "items": {
68
+ "type": "string",
69
+ "minLength": 1
70
+ }
71
+ },
72
+ "secret_refs": {
73
+ "default": [],
74
+ "type": "array",
75
+ "items": {
76
+ "type": "string",
77
+ "minLength": 1
78
+ }
79
+ },
80
+ "credential_env_refs": {
81
+ "default": [],
82
+ "type": "array",
83
+ "items": {
84
+ "type": "string",
85
+ "minLength": 1
86
+ }
87
+ },
88
+ "endpoint_env_refs": {
89
+ "default": [],
90
+ "type": "array",
91
+ "items": {
92
+ "type": "string",
93
+ "minLength": 1
94
+ }
95
+ },
96
+ "sandbox_passthrough_rules": {
97
+ "default": [],
98
+ "type": "array",
99
+ "items": {
100
+ "type": "string",
101
+ "minLength": 1
102
+ }
103
+ },
104
+ "network_mode": {
105
+ "default": "disabled",
106
+ "type": "string",
107
+ "enum": [
108
+ "disabled",
109
+ "restricted",
110
+ "enabled"
111
+ ]
112
+ },
113
+ "blocked_paths": {
114
+ "default": [],
115
+ "type": "array",
116
+ "items": {
117
+ "type": "string",
118
+ "minLength": 1
119
+ }
120
+ },
121
+ "masked_config_fingerprint": {
122
+ "type": "string",
123
+ "minLength": 1
124
+ }
125
+ },
126
+ "required": [
127
+ "schema_version",
128
+ "contract",
129
+ "runtime_mode",
130
+ "execution_limits",
131
+ "env_allowlist",
132
+ "secret_refs",
133
+ "credential_env_refs",
134
+ "endpoint_env_refs",
135
+ "sandbox_passthrough_rules",
136
+ "network_mode",
137
+ "blocked_paths",
138
+ "masked_config_fingerprint"
139
+ ],
140
+ "additionalProperties": false,
141
+ "title": "CodeSDD DeepAgent Environment Contract",
142
+ "description": "Machine-readable execution environment contract for DeepAgents runs, including env allowlist, secrets references, pass-through rules, and blocked paths."
143
+ }
package/schemas/sdd/deepagent-quality-evidence.schema.json ADDED
@@ -0,0 +1,108 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "type": "object",
4
+ "properties": {
5
+ "schema_version": {
6
+ "type": "number",
7
+ "const": 1
8
+ },
9
+ "contract": {
10
+ "type": "string",
11
+ "const": "deepagent-quality-evidence/v1"
12
+ },
13
+ "matrix": {
14
+ "minItems": 1,
15
+ "type": "array",
16
+ "items": {
17
+ "type": "object",
18
+ "properties": {
19
+ "requirement_id": {
20
+ "type": "string",
21
+ "minLength": 1
22
+ },
23
+ "validation_id": {
24
+ "type": "string",
25
+ "minLength": 1
26
+ },
27
+ "evidence_refs": {
28
+ "default": [],
29
+ "type": "array",
30
+ "items": {
31
+ "type": "object",
32
+ "properties": {
33
+ "kind": {
34
+ "type": "string",
35
+ "minLength": 1
36
+ },
37
+ "ref": {
38
+ "type": "string",
39
+ "minLength": 1
40
+ },
41
+ "path": {
42
+ "type": "string",
43
+ "minLength": 1
44
+ }
45
+ },
46
+ "required": [
47
+ "kind",
48
+ "ref"
49
+ ],
50
+ "additionalProperties": false
51
+ }
52
+ },
53
+ "residual_risks": {
54
+ "default": [],
55
+ "type": "array",
56
+ "items": {
57
+ "type": "object",
58
+ "properties": {
59
+ "id": {
60
+ "type": "string",
61
+ "minLength": 1
62
+ },
63
+ "severity": {
64
+ "type": "string",
65
+ "enum": [
66
+ "low",
67
+ "medium",
68
+ "high",
69
+ "critical"
70
+ ]
71
+ },
72
+ "summary": {
73
+ "type": "string",
74
+ "minLength": 1
75
+ },
76
+ "mitigation": {
77
+ "type": "string",
78
+ "minLength": 1
79
+ }
80
+ },
81
+ "required": [
82
+ "id",
83
+ "severity",
84
+ "summary"
85
+ ],
86
+ "additionalProperties": false
87
+ }
88
+ }
89
+ },
90
+ "required": [
91
+ "requirement_id",
92
+ "validation_id",
93
+ "evidence_refs",
94
+ "residual_risks"
95
+ ],
96
+ "additionalProperties": false
97
+ }
98
+ }
99
+ },
100
+ "required": [
101
+ "schema_version",
102
+ "contract",
103
+ "matrix"
104
+ ],
105
+ "additionalProperties": false,
106
+ "title": "CodeSDD DeepAgent Quality Evidence",
107
+ "description": "Machine-readable requirement-to-validation evidence matrix contract for DeepAgents runs, including residual risk traceability."
108
+ }
package/schemas/sdd/deepagent-run-evidence.schema.json ADDED
@@ -0,0 +1,192 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "type": "object",
4
+ "properties": {
5
+ "schema_version": {
6
+ "type": "number",
7
+ "const": 1
8
+ },
9
+ "contract": {
10
+ "type": "string",
11
+ "const": "deepagent-run-evidence/v1"
12
+ },
13
+ "run_id": {
14
+ "type": "string",
15
+ "minLength": 1
16
+ },
17
+ "feature_ref": {
18
+ "type": "string",
19
+ "pattern": "^FEAT-\\d{4}$"
20
+ },
21
+ "mode": {
22
+ "type": "string",
23
+ "enum": [
24
+ "read-only",
25
+ "plan",
26
+ "validate",
27
+ "apply-sandbox",
28
+ "apply-approved"
29
+ ]
30
+ },
31
+ "status": {
32
+ "type": "string",
33
+ "enum": [
34
+ "allowed",
35
+ "blocked",
36
+ "running",
37
+ "completed",
38
+ "failed"
39
+ ]
40
+ },
41
+ "model_metadata": {
42
+ "default": {},
43
+ "type": "object",
44
+ "propertyNames": {
45
+ "type": "string"
46
+ },
47
+ "additionalProperties": {}
48
+ },
49
+ "config_fingerprint": {
50
+ "type": "string",
51
+ "minLength": 1
52
+ },
53
+ "plan_ref": {
54
+ "type": "string",
55
+ "minLength": 1
56
+ },
57
+ "artifacts": {
58
+ "default": [],
59
+ "type": "array",
60
+ "items": {
61
+ "type": "string",
62
+ "minLength": 1
63
+ }
64
+ },
65
+ "validations": {
66
+ "default": [],
67
+ "type": "array",
68
+ "items": {
69
+ "type": "string",
70
+ "minLength": 1
71
+ }
72
+ },
73
+ "decisions": {
74
+ "default": [],
75
+ "type": "array",
76
+ "items": {
77
+ "type": "object",
78
+ "properties": {
79
+ "schema_version": {
80
+ "type": "number",
81
+ "const": 1
82
+ },
83
+ "contract": {
84
+ "type": "string",
85
+ "const": "deepagent-decision-evidence/v1"
86
+ },
87
+ "decision_point": {
88
+ "type": "string",
89
+ "minLength": 1
90
+ },
91
+ "alternatives": {
92
+ "minItems": 1,
93
+ "type": "array",
94
+ "items": {
95
+ "type": "string",
96
+ "minLength": 1
97
+ }
98
+ },
99
+ "selected_option": {
100
+ "type": "string",
101
+ "minLength": 1
102
+ },
103
+ "adr_required": {
104
+ "type": "boolean"
105
+ },
106
+ "rationale": {
107
+ "type": "string",
108
+ "minLength": 1
109
+ },
110
+ "approvals": {
111
+ "default": [],
112
+ "type": "array",
113
+ "items": {
114
+ "type": "string",
115
+ "minLength": 1
116
+ }
117
+ }
118
+ },
119
+ "required": [
120
+ "schema_version",
121
+ "contract",
122
+ "decision_point",
123
+ "alternatives",
124
+ "selected_option",
125
+ "adr_required",
126
+ "rationale",
127
+ "approvals"
128
+ ],
129
+ "additionalProperties": false
130
+ }
131
+ },
132
+ "risks": {
133
+ "default": [],
134
+ "type": "array",
135
+ "items": {
136
+ "type": "object",
137
+ "properties": {
138
+ "id": {
139
+ "type": "string",
140
+ "minLength": 1
141
+ },
142
+ "severity": {
143
+ "type": "string",
144
+ "enum": [
145
+ "low",
146
+ "medium",
147
+ "high",
148
+ "critical"
149
+ ]
150
+ },
151
+ "summary": {
152
+ "type": "string",
153
+ "minLength": 1
154
+ },
155
+ "mitigation": {
156
+ "type": "string",
157
+ "minLength": 1
158
+ }
159
+ },
160
+ "required": [
161
+ "id",
162
+ "severity",
163
+ "summary"
164
+ ],
165
+ "additionalProperties": false
166
+ }
167
+ },
168
+ "finalize_intent": {
169
+ "default": false,
170
+ "type": "boolean"
171
+ }
172
+ },
173
+ "required": [
174
+ "schema_version",
175
+ "contract",
176
+ "run_id",
177
+ "feature_ref",
178
+ "mode",
179
+ "status",
180
+ "model_metadata",
181
+ "config_fingerprint",
182
+ "plan_ref",
183
+ "artifacts",
184
+ "validations",
185
+ "decisions",
186
+ "risks",
187
+ "finalize_intent"
188
+ ],
189
+ "additionalProperties": false,
190
+ "title": "CodeSDD DeepAgent Run Evidence",
191
+ "description": "Machine-readable evidence contract for DeepAgents run execution status, artifacts, validations, decisions, and finalize intent."
192
+ }
package/schemas/sdd/deepagent-run-plan.schema.json ADDED
@@ -0,0 +1,197 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "type": "object",
4
+ "properties": {
5
+ "schema_version": {
6
+ "type": "number",
7
+ "const": 1
8
+ },
9
+ "contract": {
10
+ "type": "string",
11
+ "const": "deepagent-run-plan/v1"
12
+ },
13
+ "run_id": {
14
+ "type": "string",
15
+ "minLength": 1
16
+ },
17
+ "feature_ref": {
18
+ "type": "string",
19
+ "pattern": "^FEAT-\\d{4}$"
20
+ },
21
+ "mode": {
22
+ "type": "string",
23
+ "enum": [
24
+ "read-only",
25
+ "plan",
26
+ "validate",
27
+ "apply-sandbox",
28
+ "apply-approved"
29
+ ]
30
+ },
31
+ "tactical_steps": {
32
+ "minItems": 1,
33
+ "type": "array",
34
+ "items": {
35
+ "type": "object",
36
+ "properties": {
37
+ "id": {
38
+ "type": "string",
39
+ "minLength": 1
40
+ },
41
+ "title": {
42
+ "type": "string",
43
+ "minLength": 1
44
+ },
45
+ "objective": {
46
+ "type": "string",
47
+ "minLength": 1
48
+ },
49
+ "subagent": {
50
+ "type": "string",
51
+ "minLength": 1
52
+ }
53
+ },
54
+ "required": [
55
+ "id",
56
+ "title",
57
+ "objective"
58
+ ],
59
+ "additionalProperties": false
60
+ }
61
+ },
62
+ "subagent_routing": {
63
+ "type": "array",
64
+ "items": {
65
+ "type": "object",
66
+ "properties": {
67
+ "subagent": {
68
+ "type": "string",
69
+ "minLength": 1
70
+ },
71
+ "purpose": {
72
+ "type": "string",
73
+ "minLength": 1
74
+ },
75
+ "task_ids": {
76
+ "default": [],
77
+ "type": "array",
78
+ "items": {
79
+ "type": "string",
80
+ "minLength": 1
81
+ }
82
+ }
83
+ },
84
+ "required": [
85
+ "subagent",
86
+ "purpose",
87
+ "task_ids"
88
+ ],
89
+ "additionalProperties": false
90
+ }
91
+ },
92
+ "required_approvals": {
93
+ "default": [],
94
+ "type": "array",
95
+ "items": {
96
+ "type": "string",
97
+ "minLength": 1
98
+ }
99
+ },
100
+ "expected_tool_calls": {
101
+ "default": [],
102
+ "type": "array",
103
+ "items": {
104
+ "type": "string",
105
+ "minLength": 1
106
+ }
107
+ },
108
+ "write_manifest_preview": {
109
+ "default": [],
110
+ "type": "array",
111
+ "items": {
112
+ "type": "string",
113
+ "minLength": 1
114
+ }
115
+ },
116
+ "validation_matrix": {
117
+ "default": [],
118
+ "type": "array",
119
+ "items": {
120
+ "type": "object",
121
+ "properties": {
122
+ "requirement": {
123
+ "type": "string",
124
+ "minLength": 1
125
+ },
126
+ "validation": {
127
+ "type": "string",
128
+ "minLength": 1
129
+ },
130
+ "evidence_kind": {
131
+ "type": "string",
132
+ "minLength": 1
133
+ }
134
+ },
135
+ "required": [
136
+ "requirement",
137
+ "validation",
138
+ "evidence_kind"
139
+ ],
140
+ "additionalProperties": false
141
+ }
142
+ },
143
+ "residual_risks": {
144
+ "default": [],
145
+ "type": "array",
146
+ "items": {
147
+ "type": "object",
148
+ "properties": {
149
+ "id": {
150
+ "type": "string",
151
+ "minLength": 1
152
+ },
153
+ "severity": {
154
+ "type": "string",
155
+ "enum": [
156
+ "low",
157
+ "medium",
158
+ "high",
159
+ "critical"
160
+ ]
161
+ },
162
+ "summary": {
163
+ "type": "string",
164
+ "minLength": 1
165
+ },
166
+ "mitigation": {
167
+ "type": "string",
168
+ "minLength": 1
169
+ }
170
+ },
171
+ "required": [
172
+ "id",
173
+ "severity",
174
+ "summary"
175
+ ],
176
+ "additionalProperties": false
177
+ }
178
+ }
179
+ },
180
+ "required": [
181
+ "schema_version",
182
+ "contract",
183
+ "run_id",
184
+ "feature_ref",
185
+ "mode",
186
+ "tactical_steps",
187
+ "subagent_routing",
188
+ "required_approvals",
189
+ "expected_tool_calls",
190
+ "write_manifest_preview",
191
+ "validation_matrix",
192
+ "residual_risks"
193
+ ],
194
+ "additionalProperties": false,
195
+ "title": "CodeSDD DeepAgent Run Plan",
196
+ "description": "Machine-readable tactical plan contract for DeepAgents runs with subagent routing, approvals, validation matrix, and residual risks."
197
+ }