specdojo 0.4.6 → 0.5.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 (310) hide show
  1. package/.github/agents/specdojo-orchestrator.md +14 -9
  2. package/CHANGELOG.md +62 -0
  3. package/dist/catalog/document-target.js +75 -0
  4. package/dist/commands/agent.js +2 -80
  5. package/dist/commands/init.js +3 -0
  6. package/dist/commands/night-orchestrator.js +33 -4
  7. package/dist/dashboard/dashboard.js +5 -6
  8. package/dist/dashboard/timeline-build.js +5 -1
  9. package/dist/dashboard/timeline.js +6 -3
  10. package/dist/docs/yaml-pages.js +17 -17
  11. package/dist/exec/agent-config.js +28 -16
  12. package/dist/exec/agent-plan.js +108 -0
  13. package/dist/exec/commands.js +3 -3
  14. package/dist/exec/core.js +2 -0
  15. package/dist/exec/grade-checkpoint.js +12 -0
  16. package/dist/exec/pipeline-state.js +5 -2
  17. package/dist/exec/plans-core.js +7 -67
  18. package/dist/exec/plans-generation.js +28 -7
  19. package/dist/exec/plans-grade-findings.js +16 -0
  20. package/dist/exec/plans-planning.js +43 -0
  21. package/dist/exec/plans-storage.js +5 -2
  22. package/dist/exec/project.js +4 -1
  23. package/dist/exec/register.js +82 -6
  24. package/dist/exec/repo-integration-sync.js +9 -0
  25. package/dist/exec/repo-integration.js +17 -2
  26. package/dist/exec/repo-trace.js +17 -4
  27. package/dist/exec/results.js +2 -0
  28. package/dist/exec/run/lifecycle-commands.js +2 -0
  29. package/dist/exec/run/register-core.js +11 -0
  30. package/dist/exec/run/register-mode.js +19 -1
  31. package/dist/exec/run/register-resume.js +23 -0
  32. package/dist/exec/run/register-state.js +4 -1
  33. package/dist/exec/run/register-worktree.js +28 -1
  34. package/dist/exec/run/schedule-prepare.js +7 -1
  35. package/dist/exec/strategy.js +2 -0
  36. package/dist/exec/task-repos.js +18 -4
  37. package/dist/exec/worktree-command.js +8 -1
  38. package/dist/exec/worktree-ops-commit.js +7 -1
  39. package/dist/exec/worktree-ops-merge.js +40 -1
  40. package/dist/grade/apply.js +13 -7
  41. package/dist/grade/command-inspect.js +2 -1
  42. package/dist/grade/command-run.js +39 -0
  43. package/dist/grade/grade.js +3 -1
  44. package/dist/grade/markdown.js +11 -6
  45. package/dist/grade/pipeline-state.js +8 -6
  46. package/dist/grade/plan.js +14 -10
  47. package/dist/grade/run.js +307 -0
  48. package/dist/grade/target-discovery.js +1 -1
  49. package/dist/grade/targets.js +44 -22
  50. package/dist/register/approach.js +35 -0
  51. package/dist/register/catalog-status.js +49 -0
  52. package/dist/register/core.js +5 -0
  53. package/dist/register/create-commands.js +83 -5
  54. package/dist/register/deliverable-target.js +215 -0
  55. package/dist/register/dependency.js +123 -0
  56. package/dist/register/derivation.js +2 -2
  57. package/dist/register/epic.js +42 -0
  58. package/dist/register/event-merge.js +5 -2
  59. package/dist/register/events.js +8 -0
  60. package/dist/register/external-project.js +4 -0
  61. package/dist/register/item.js +18 -0
  62. package/dist/register/maintenance-commands.js +7 -1
  63. package/dist/register/planning.js +37 -0
  64. package/dist/register/register.js +5 -1
  65. package/dist/register/renumber.js +12 -4
  66. package/dist/register/views.js +55 -4
  67. package/dist/review/grade.js +19 -17
  68. package/dist/schedule/schedule.js +3 -1
  69. package/dist/schedule/strategy-generate-scope.js +5 -1
  70. package/dist/schedule/strategy-generate.js +1 -0
  71. package/dist/schedule/strategy-profiles.js +1 -1
  72. package/dist/shared/agent-plan.js +1 -0
  73. package/dist/shared/agent-types.js +3 -0
  74. package/dist/shared/grade-result.js +23 -5
  75. package/dist/shared/markdownlint-config.js +38 -0
  76. package/dist/shared/markdownlint-scaffold.js +2 -9
  77. package/dist/shared/provider-scaffold.js +5 -3
  78. package/dist/shared/specdojo-config.js +10 -3
  79. package/dist/shared/specdojo-gitignore.js +4 -0
  80. package/dist/specdojo.js +5 -1
  81. package/docs/ja/specdojo/exec-templates/xep-catalog-planning-template.md +24 -0
  82. package/docs/ja/specdojo/exec-templates/xep-strategy-planning-template.md +24 -0
  83. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +2 -2
  84. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +2 -2
  85. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +2 -2
  86. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +2 -2
  87. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +2 -2
  88. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +2 -2
  89. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +2 -2
  90. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +2 -2
  91. package/docs/ja/specdojo/exec-templates/xrp-template.md +2 -2
  92. package/docs/ja/specdojo/guides/docs-editing-guide.md +14 -1
  93. package/docs/ja/specdojo/guides/docs-structure-guide.md +10 -8
  94. package/docs/ja/specdojo/guides/exec-config-guide.md +44 -12
  95. package/docs/ja/specdojo/guides/exec-operation-guide.md +20 -15
  96. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +19 -1
  97. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +3 -1
  98. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +2 -0
  99. package/docs/ja/specdojo/guides/quick-start-guide.md +59 -16
  100. package/docs/ja/specdojo/guides/register-operation-guide.md +44 -15
  101. package/docs/ja/specdojo/guides/remote-host-development-guide.md +15 -1
  102. package/docs/ja/specdojo/guides/review-guide.md +2 -2
  103. package/docs/ja/specdojo/guides/ryu-guide.md +12 -0
  104. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +16 -16
  105. package/docs/ja/specdojo/guides/timeline-design-guide.md +37 -33
  106. package/docs/ja/specdojo/recipes/tsd-recipe.md +198 -0
  107. package/docs/ja/specdojo/references/command-reference.md +92 -29
  108. package/docs/ja/specdojo/references/specdojo-config-reference.md +49 -16
  109. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +1 -0
  110. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +1 -0
  111. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +5 -4
  112. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +3 -2
  113. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +4 -3
  114. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +8 -7
  115. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +4 -3
  116. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +1 -0
  117. package/docs/ja/specdojo/rulebooks/br-rulebook.md +1 -0
  118. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +1 -0
  119. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +1 -0
  120. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +1 -0
  121. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +1 -0
  122. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +1 -0
  123. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +3 -2
  124. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +2 -1
  125. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +1 -0
  126. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +1 -0
  127. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +2 -1
  128. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +3 -2
  129. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +1 -0
  130. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +1 -0
  131. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +1 -0
  132. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +1 -0
  133. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +1 -0
  134. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +1 -0
  135. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +1 -0
  136. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +1 -0
  137. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +2 -1
  138. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +2 -1
  139. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +1 -0
  140. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +1 -0
  141. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +9 -6
  142. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +1 -0
  143. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +3 -1
  144. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +2 -1
  145. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +2 -1
  146. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +2 -0
  147. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +4 -2
  148. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +1 -0
  149. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +1 -0
  150. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +1 -0
  151. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +1 -0
  152. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +1 -0
  153. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +1 -0
  154. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +1 -0
  155. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +2 -1
  156. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +1 -0
  157. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +4 -3
  158. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +9 -8
  159. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +10 -9
  160. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +9 -8
  161. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +9 -8
  162. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +9 -8
  163. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +9 -8
  164. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +10 -9
  165. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +9 -8
  166. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +9 -8
  167. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +7 -6
  168. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +1 -0
  169. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +1 -0
  170. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +1 -0
  171. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +1 -0
  172. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +2 -1
  173. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +2 -1
  174. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +56 -36
  175. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +1 -0
  176. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +1 -0
  177. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +1 -0
  178. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +1 -0
  179. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +1 -0
  180. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +1 -0
  181. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +1 -0
  182. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +1 -0
  183. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +1 -0
  184. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +1 -0
  185. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +1 -0
  186. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +1 -0
  187. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +1 -0
  188. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +1 -0
  189. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +1 -0
  190. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +1 -0
  191. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +1 -0
  192. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +1 -0
  193. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +1 -0
  194. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +3 -2
  195. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -0
  196. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +7 -6
  197. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +4 -3
  198. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +2 -1
  199. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +1 -0
  200. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +1 -0
  201. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +1 -0
  202. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +1 -0
  203. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +2 -1
  204. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +9 -8
  205. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +2 -1
  206. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +1 -0
  207. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +1 -0
  208. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +1 -0
  209. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +1 -0
  210. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +80 -61
  211. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +111 -63
  212. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +1 -0
  213. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +3 -2
  214. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +1 -0
  215. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +1 -0
  216. package/docs/ja/specdojo/samples/atc-index-sample.md +1 -1
  217. package/docs/ja/specdojo/samples/atc-sample.md +1 -1
  218. package/docs/ja/specdojo/samples/bac-sample.md +1 -1
  219. package/docs/ja/specdojo/samples/bdd-sample.yaml +1 -1
  220. package/docs/ja/specdojo/samples/bds-sample.md +1 -1
  221. package/docs/ja/specdojo/samples/bes-index-sample.md +1 -1
  222. package/docs/ja/specdojo/samples/bes-sample.md +1 -1
  223. package/docs/ja/specdojo/samples/ccd-sample.md +1 -1
  224. package/docs/ja/specdojo/samples/cdfd-sample.md +1 -1
  225. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +1 -1
  226. package/docs/ja/specdojo/samples/cdsd-sample.md +1 -1
  227. package/docs/ja/specdojo/samples/cld-sample.md +1 -1
  228. package/docs/ja/specdojo/samples/cnd-sample.md +1 -1
  229. package/docs/ja/specdojo/samples/cop-index-sample.md +1 -1
  230. package/docs/ja/specdojo/samples/cop-sample.md +1 -1
  231. package/docs/ja/specdojo/samples/cpd-sample.md +1 -1
  232. package/docs/ja/specdojo/samples/cstd-sample.md +1 -1
  233. package/docs/ja/specdojo/samples/cxd-sample.md +1 -1
  234. package/docs/ja/specdojo/samples/dmd-index-sample.md +1 -1
  235. package/docs/ja/specdojo/samples/dmd-sample.md +1 -1
  236. package/docs/ja/specdojo/samples/etc-index-sample.md +1 -1
  237. package/docs/ja/specdojo/samples/etc-sample.md +1 -1
  238. package/docs/ja/specdojo/samples/gl-sample.yaml +2 -0
  239. package/docs/ja/specdojo/samples/ifd-sample.md +1 -1
  240. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +1 -0
  241. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +1 -1
  242. package/docs/ja/specdojo/samples/ifx-file-sample.md +1 -1
  243. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +1 -0
  244. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +2 -1
  245. package/docs/ja/specdojo/samples/itc-index-sample.md +1 -1
  246. package/docs/ja/specdojo/samples/itc-sample.md +1 -1
  247. package/docs/ja/specdojo/samples/mtp-sample.md +1 -1
  248. package/docs/ja/specdojo/samples/nfr-availability-sample.md +1 -1
  249. package/docs/ja/specdojo/samples/nfr-index-sample.md +1 -1
  250. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +1 -1
  251. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +1 -1
  252. package/docs/ja/specdojo/samples/nfr-operations-sample.md +1 -1
  253. package/docs/ja/specdojo/samples/nfr-performance-sample.md +1 -1
  254. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +1 -1
  255. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +1 -1
  256. package/docs/ja/specdojo/samples/nfr-usability-sample.md +1 -1
  257. package/docs/ja/specdojo/samples/ntp-sample.md +1 -1
  258. package/docs/ja/specdojo/samples/opd-sample.md +1 -1
  259. package/docs/ja/specdojo/samples/opr-sample.md +1 -1
  260. package/docs/ja/specdojo/samples/otp-index-sample.md +1 -1
  261. package/docs/ja/specdojo/samples/otp-sample.md +1 -1
  262. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +1 -1
  263. package/docs/ja/specdojo/samples/sac-sample.md +1 -1
  264. package/docs/ja/specdojo/samples/sf-index-sample.md +1 -1
  265. package/docs/ja/specdojo/samples/sf-sample.md +1 -1
  266. package/docs/ja/specdojo/samples/sld-sample.md +1 -1
  267. package/docs/ja/specdojo/samples/stc-index-sample.md +1 -1
  268. package/docs/ja/specdojo/samples/stc-sample.md +1 -1
  269. package/docs/ja/specdojo/samples/stsd-sample.md +1 -1
  270. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +1 -1
  271. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +1 -1
  272. package/docs/ja/specdojo/samples/sysd-index-sample.md +1 -1
  273. package/docs/ja/specdojo/samples/tsd-index-sample.md +22 -16
  274. package/docs/ja/specdojo/samples/tsd-sample.md +241 -21
  275. package/docs/ja/specdojo/samples/tsp-index-sample.md +1 -1
  276. package/docs/ja/specdojo/samples/uis-sample.md +1 -1
  277. package/docs/ja/specdojo/samples/utc-index-sample.md +1 -1
  278. package/docs/ja/specdojo/samples/utc-sample.md +1 -1
  279. package/docs/ja/specdojo/standards/document-metadata-standard.md +28 -3
  280. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +2 -0
  281. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +16 -11
  282. package/docs/ja/specdojo/standards/sample-authoring-standard.md +1 -0
  283. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +1 -1
  284. package/docs/ja/specdojo/templates/pjr-dependent-items-template.md +22 -0
  285. package/docs/ja/specdojo/templates/pjr-epic-items-template.md +22 -0
  286. package/docs/ja/specdojo/templates/pjr-epic-template.md +44 -0
  287. package/docs/ja/specdojo/templates/pjr-index-template.md +4 -2
  288. package/docs/specdojo/schemas/v1/bdd.schema.yaml +1 -1
  289. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +24 -16
  290. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -1
  291. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +1 -1
  292. package/docs/specdojo/schemas/v1/gl.schema.yaml +8 -0
  293. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  294. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +5 -1
  295. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +2 -1
  296. package/docs/specdojo/schemas/v1/register-events.schema.yaml +20 -0
  297. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +73 -4
  298. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +5 -0
  299. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +21 -3
  300. package/package.json +2 -2
  301. package/templates/antigravity/orchestrator.md +14 -9
  302. package/templates/claude/agents/specdojo-orchestrator.md +14 -9
  303. package/templates/codex/agents/specdojo-orchestrator.toml +14 -9
  304. package/templates/codex/orchestrator.md +14 -9
  305. package/templates/copilot/README.md +2 -1
  306. package/templates/devcontainer/devcontainer.json +1 -0
  307. package/templates/init-agent-members.yaml +46 -3
  308. package/templates/opencode/README.md +118 -14
  309. package/templates/opencode/agents/specdojo-orchestrator.md +15 -10
  310. package/templates/opencode/opencode.json +25 -0
@@ -0,0 +1,215 @@
1
+ import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
2
+ import { dirname, isAbsolute, relative, resolve } from "node:path";
3
+ import { collectDocIndexEntries } from "../docs/doc-index.js";
4
+ import { specdojoReferencePath } from "../docs/template-resolution.js";
5
+ import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
6
+ import { resolveDeliverableByDocId } from "../catalog/document-target.js";
7
+ import { KATA_MISSING, resolveKataDocumentPathIfExists } from "../kata/kata.js";
8
+ import { AUTHORING_KINDS } from "../kata/authoring.js";
9
+ import { loadConfig } from "../shared/specdojo-config.js";
10
+ import { parsePracticeId } from "../shared/practice-id.js";
11
+ import { load } from "../shared/yaml.js";
12
+ export const CATALOG_LESS_APPROACHES = [
13
+ "fully-guided",
14
+ "recipe-guided",
15
+ "freeform",
16
+ "retrofit",
17
+ "bootstrap",
18
+ "finalize",
19
+ "bootstrap-finalize",
20
+ ];
21
+ function metadata(path) {
22
+ const text = readFileSync(path, "utf8");
23
+ if (/\.mdx?$/.test(path))
24
+ return readSpecdojoNamespace(text);
25
+ const parsed = load(text);
26
+ return (parsed?.specdojo ?? parsed ?? {});
27
+ }
28
+ // Resolve the nearest existing ancestor as well, so symlink parents cannot escape the repository.
29
+ export function validateDeliverablePath(root, value) {
30
+ if (!value.trim() || isAbsolute(value) || /^[a-z]:/i.test(value) || value.includes("\\")) {
31
+ throw new Error(`--target-path must be a repository-relative path: ${value}`);
32
+ }
33
+ const absolute = resolve(root, value);
34
+ const path = relative(root, absolute).replaceAll("\\", "/");
35
+ if (!path || path === ".." || path.startsWith("../")) {
36
+ throw new Error(`--target-path points outside the repository: ${value}`);
37
+ }
38
+ let ancestor = absolute;
39
+ while (!existsSync(ancestor))
40
+ ancestor = dirname(ancestor);
41
+ const physical = relative(realpathSync(root), realpathSync(ancestor));
42
+ if (physical === ".." || physical.startsWith("../") || isAbsolute(physical)) {
43
+ throw new Error(`--target-path points outside the repository through a symlink: ${value}`);
44
+ }
45
+ if (existsSync(absolute) && !statSync(absolute).isFile()) {
46
+ throw new Error(`--target-path must name a file: ${value}`);
47
+ }
48
+ return path;
49
+ }
50
+ export function resolveRegisterDeliverableTarget(opts) {
51
+ if (opts.catalogPath) {
52
+ try {
53
+ const resolved = resolveDeliverableByDocId(opts.catalogPath, opts.projectId, opts.targetId, opts.repoRoot);
54
+ return { info: resolved.info, catalogless: false };
55
+ }
56
+ catch (error) {
57
+ if (!(error instanceof Error) ||
58
+ !error.message.startsWith("catalog deliverable target not found"))
59
+ throw error;
60
+ if (!opts.targetPath || !opts.targetRulebook)
61
+ throw error;
62
+ }
63
+ }
64
+ if (!CATALOG_LESS_APPROACHES.includes(opts.approach)) {
65
+ throw new Error(`Approach "${opts.approach}" requires a deliverable target from the project catalog (catalog_path)`);
66
+ }
67
+ const entries = collectDocIndexEntries(resolve(opts.repoRoot, "docs"), opts.repoRoot);
68
+ const indexed = entries[opts.targetId]?.replace(/:\d+$/, "");
69
+ const indexedPath = indexed
70
+ ? relative(opts.repoRoot, resolve(opts.repoRoot, indexed))
71
+ : undefined;
72
+ if (!opts.targetPath && !indexedPath) {
73
+ throw new Error(`Target ${opts.targetId} is not indexed; specify --target-path and --target-rulebook (catalog_path is not configured)`);
74
+ }
75
+ const path = validateDeliverablePath(opts.repoRoot, opts.targetPath ?? indexedPath ?? "");
76
+ if (indexedPath && path !== validateDeliverablePath(opts.repoRoot, indexedPath)) {
77
+ throw new Error(`--target-path conflicts with the indexed document ${opts.targetId}: ${indexedPath}`);
78
+ }
79
+ const absolute = resolve(opts.repoRoot, path);
80
+ const existing = existsSync(absolute);
81
+ const fm = existing ? metadata(absolute) : {};
82
+ if (existing && fm.id !== opts.targetId) {
83
+ throw new Error(`--target-path is occupied by another document: ${path} (expected ${opts.targetId})`);
84
+ }
85
+ if (AUTHORING_KINDS.includes(fm.type)) {
86
+ throw new Error(`Target ${opts.targetId} is a kata, not a deliverable`);
87
+ }
88
+ const declaredRulebook = typeof fm.rulebook === "string" ? fm.rulebook : undefined;
89
+ if (opts.targetRulebook && declaredRulebook && opts.targetRulebook !== declaredRulebook) {
90
+ throw new Error(`--target-rulebook conflicts with specdojo.rulebook of ${opts.targetId}: ${declaredRulebook}`);
91
+ }
92
+ const rulebook = opts.targetRulebook ?? declaredRulebook;
93
+ if (!existing && (!opts.targetPath || !opts.targetRulebook)) {
94
+ throw new Error(`New deliverable ${opts.targetId} requires --target-path and --target-rulebook`);
95
+ }
96
+ if (!rulebook)
97
+ throw new Error(`Target ${opts.targetId} requires --target-rulebook or specdojo.rulebook`);
98
+ if ((opts.approach === "finalize" || opts.approach === "bootstrap-finalize") && !existing) {
99
+ throw new Error(`Approach "${opts.approach}" requires an existing deliverable: ${opts.targetId}`);
100
+ }
101
+ const refs = {
102
+ rulebook: KATA_MISSING,
103
+ recipe: KATA_MISSING,
104
+ sample: KATA_MISSING,
105
+ template: KATA_MISSING,
106
+ };
107
+ const kataIds = [];
108
+ const kataTargets = [];
109
+ const findKata = (kind, id) => {
110
+ const entry = entries[id]?.replace(/:\d+$/, "");
111
+ if (entry) {
112
+ const absolutePath = resolve(opts.repoRoot, entry);
113
+ if (kind !== "sample" && metadata(absolutePath).type !== kind)
114
+ throw new Error(`Kata ${id} must have type ${kind}`);
115
+ return specdojoReferencePath(absolutePath, { repositoryRoot: opts.repoRoot });
116
+ }
117
+ for (const extension of kind === "rulebook" || kind === "recipe"
118
+ ? ["md"]
119
+ : ["md", "yaml", "yml", "json"]) {
120
+ const found = resolveKataDocumentPathIfExists(kind, id, extension, {
121
+ repositoryRoot: opts.repoRoot,
122
+ });
123
+ if (found &&
124
+ metadata(found).id === id &&
125
+ (kind === "sample" || metadata(found).type === kind))
126
+ return specdojoReferencePath(found, { repositoryRoot: opts.repoRoot });
127
+ }
128
+ return undefined;
129
+ };
130
+ if (opts.approach === "bootstrap") {
131
+ if (!opts.targetPath || !opts.targetRulebook)
132
+ throw new Error("Catalog-less bootstrap requires --target-path and --target-rulebook");
133
+ const authority = loadConfig(opts.repoRoot).config?.kata_authority;
134
+ if (!authority)
135
+ throw new Error("Catalog-less bootstrap requires kata_authority in specdojo.config.json");
136
+ const parsed = parsePracticeId(rulebook);
137
+ if (parsed.authority !== authority || !/^[a-z0-9][a-z0-9-]*-rulebook$/.test(parsed.localId)) {
138
+ throw new Error(`Bootstrap rulebook must use kata_authority ${authority} and end with -rulebook: ${rulebook}`);
139
+ }
140
+ if (findKata("rulebook", rulebook))
141
+ throw new Error(`Bootstrap requires a new rulebook id; ${rulebook} already exists`);
142
+ const stem = parsed.localId.slice(0, -"-rulebook".length);
143
+ for (const kind of AUTHORING_KINDS) {
144
+ const id = `${authority}:${stem}-${kind}`;
145
+ const proposedPath = `docs/ja/specdojo/${kind}s/${authority}/${stem}-${kind}.md`;
146
+ validateDeliverablePath(opts.repoRoot, proposedPath);
147
+ // Do not reuse somebody else's kata when the generated id/path collides.
148
+ if (entries[id] || existsSync(resolve(opts.repoRoot, proposedPath)) || findKata(kind, id)) {
149
+ throw new Error(`Bootstrap kata id or path already exists: ${id} (${proposedPath})`);
150
+ }
151
+ refs[kind] = proposedPath;
152
+ kataIds.push(id);
153
+ kataTargets.push({ id, path: proposedPath });
154
+ }
155
+ }
156
+ else {
157
+ const missing = [];
158
+ const rulebookPath = !["none", "not-needed", "undecided"].includes(rulebook)
159
+ ? findKata("rulebook", rulebook)
160
+ : undefined;
161
+ if (rulebookPath) {
162
+ refs.rulebook = rulebookPath;
163
+ kataIds.push(rulebook);
164
+ kataTargets.push({ id: rulebook, path: rulebookPath });
165
+ }
166
+ else if (opts.approach !== "freeform")
167
+ missing.push("rulebook");
168
+ const rb = rulebookPath ? metadata(resolve(opts.repoRoot, rulebookPath)) : {};
169
+ for (const kind of ["recipe", "sample", "template"]) {
170
+ const declaration = rb[kind];
171
+ const ids = Array.isArray(declaration) ? declaration : [declaration];
172
+ const notNeeded = declaration === "not-needed";
173
+ const required = (opts.approach === "fully-guided" && !notNeeded) ||
174
+ (opts.approach === "recipe-guided" && kind === "recipe") ||
175
+ (opts.approach === "bootstrap-finalize" && !notNeeded);
176
+ let resolvedAny = false;
177
+ for (const id of ids) {
178
+ if (typeof id !== "string" || ["none", "not-needed", "undecided"].includes(id))
179
+ continue;
180
+ const found = findKata(kind, id);
181
+ if (found) {
182
+ if (!resolvedAny)
183
+ refs[kind] = found;
184
+ resolvedAny = true;
185
+ kataIds.push(id);
186
+ kataTargets.push({ id, path: found });
187
+ }
188
+ else if (required)
189
+ missing.push(`${kind} (${id})`);
190
+ }
191
+ if (required && !resolvedAny)
192
+ missing.push(kind);
193
+ }
194
+ if (missing.length)
195
+ throw new Error(`Approach "${opts.approach}" is missing kata: ${[...new Set(missing)].join(", ")}`);
196
+ }
197
+ return {
198
+ catalogless: true,
199
+ refs,
200
+ kataIds,
201
+ kataTargets,
202
+ info: {
203
+ catalogless: true,
204
+ resolvedPath: path,
205
+ deliverable: {
206
+ local_id: opts.targetId.split(":").pop(),
207
+ name: opts.targetId,
208
+ kind: "work",
209
+ overview: "個票の概要・完了条件を参照する。",
210
+ path,
211
+ rulebook,
212
+ },
213
+ },
214
+ };
215
+ }
@@ -0,0 +1,123 @@
1
+ import { basename } from "node:path";
2
+ import { gitOutput, gitResult } from "../shared/git.js";
3
+ import { getProjectRegisterPath, loadConfig, specdojoRootDir } from "../shared/specdojo-config.js";
4
+ import { resolveProjectIntegrationBranch } from "./cross-project.js";
5
+ import { parseRegisterItemRef } from "./derivation.js";
6
+ import { loadRegisterItemDocs, readRegisterItemContent } from "./item.js";
7
+ export function normalizeDependsOn(values) {
8
+ if (values === undefined)
9
+ return undefined;
10
+ const refs = [...new Set(values.map((value) => value.trim()).filter(Boolean))];
11
+ if (refs.includes("-")) {
12
+ if (refs.length !== 1)
13
+ throw new Error("--depends-on - cannot be combined with other item IDs");
14
+ return undefined;
15
+ }
16
+ if (refs.length === 0)
17
+ throw new Error("--depends-on must contain a register item ID");
18
+ return refs;
19
+ }
20
+ // Each operation gets a fresh snapshot. Other projects are read from the same local
21
+ // integration branches used to verify derived_from, never from unrelated worktrees.
22
+ function dependencyGraph(paths, replacement) {
23
+ const projects = new Map();
24
+ const local = new Map(loadRegisterItemDocs(paths.projectRegisterPath).map((doc) => [doc.id, doc.item]));
25
+ if (replacement)
26
+ local.set(replacement.id, replacement);
27
+ projects.set(paths.projectId, local);
28
+ const projectItems = (projectId) => {
29
+ const cached = projects.get(projectId);
30
+ if (cached)
31
+ return cached;
32
+ const { config } = loadConfig();
33
+ const project = config?.projects[projectId];
34
+ if (!project)
35
+ throw new Error(`depends_on: unknown project ${projectId}`);
36
+ const registerPath = getProjectRegisterPath(project);
37
+ if (!registerPath)
38
+ throw new Error(`depends_on: project_register_path is not set for ${projectId}`);
39
+ const root = specdojoRootDir();
40
+ const branch = resolveProjectIntegrationBranch(projectId, project);
41
+ if (gitResult(root, ["show-ref", "--verify", "--quiet", `refs/heads/${branch}`]).status !== 0) {
42
+ throw new Error(`depends_on: integration branch does not exist locally: ${branch}`);
43
+ }
44
+ const files = gitOutput(root, [
45
+ "ls-tree",
46
+ "-r",
47
+ "--name-only",
48
+ branch,
49
+ "--",
50
+ registerPath.replaceAll("\\", "/"),
51
+ ]);
52
+ const items = new Map();
53
+ for (const file of files.split(/\r?\n/).filter(Boolean)) {
54
+ if (!/^pjr-[0-9a-z]{4}-.+\.md$/.test(basename(file)))
55
+ continue;
56
+ const parsed = readRegisterItemContent(gitOutput(root, ["show", `${branch}:${file}`]), basename(file));
57
+ if (parsed)
58
+ items.set(parsed.id, parsed.item);
59
+ }
60
+ projects.set(projectId, items);
61
+ return items;
62
+ };
63
+ const lookup = (ref, projectId) => {
64
+ const parsed = parseRegisterItemRef(ref, projectId);
65
+ if (!parsed)
66
+ throw new Error(`Invalid depends_on item ID: "${ref}". Use PJR-XXXX or <project-id>:PJR-XXXX`);
67
+ const item = projectItems(parsed.projectId).get(parsed.itemId);
68
+ if (!item)
69
+ throw new Error(`Depends-on item not found: ${ref} (searched configured project ${parsed.projectId})`);
70
+ return { ...parsed, key: `${parsed.projectId}:${parsed.itemId}`, item };
71
+ };
72
+ const visited = new Set();
73
+ const visiting = [];
74
+ const visit = (item, projectId) => {
75
+ const key = `${projectId}:${item.id}`;
76
+ if (visiting.includes(key))
77
+ throw new Error(`depends_on cycle: ${[...visiting, key].join(" -> ")}`);
78
+ if (visited.has(key))
79
+ return;
80
+ visiting.push(key);
81
+ for (const ref of item.dependsOn ?? []) {
82
+ const target = lookup(ref, projectId);
83
+ if (target.key === key)
84
+ throw new Error(`Item ${key} cannot depend on itself`);
85
+ visit(target.item, target.projectId);
86
+ }
87
+ visiting.pop();
88
+ visited.add(key);
89
+ };
90
+ return { local, lookup, visit };
91
+ }
92
+ export function validateRegisterDependencies(paths, replacement) {
93
+ const graph = dependencyGraph(paths, replacement);
94
+ for (const item of graph.local.values())
95
+ graph.visit(item, paths.projectId);
96
+ }
97
+ export function validateRegisterDependencyDocs(paths) {
98
+ try {
99
+ validateRegisterDependencies(paths);
100
+ return [];
101
+ }
102
+ catch (error) {
103
+ return [error instanceof Error ? error.message : String(error)];
104
+ }
105
+ }
106
+ export function registerDependencyBlockReason(paths, item) {
107
+ if (!item.dependsOn?.length)
108
+ return undefined;
109
+ try {
110
+ const graph = dependencyGraph(paths, item);
111
+ graph.visit(item, paths.projectId);
112
+ const pending = item.dependsOn.flatMap((ref) => {
113
+ const target = graph.lookup(ref, paths.projectId);
114
+ return ["done", "decided"].includes(target.item.status)
115
+ ? []
116
+ : [`${ref} (${target.item.status})`];
117
+ });
118
+ return pending.length ? `Unfinished depends_on: ${pending.join(", ")}` : undefined;
119
+ }
120
+ catch (error) {
121
+ return error instanceof Error ? error.message : String(error);
122
+ }
123
+ }
@@ -147,11 +147,11 @@ function configuredExternalRegisterDirectories(paths) {
147
147
  return existsSync(absolutePath) ? [{ projectId, registerPath: absolutePath }] : [];
148
148
  });
149
149
  }
150
- export function collectDerivedRegisterRelations(paths, currentItems) {
150
+ export function collectDerivedRegisterRelations(paths, currentItems, relationField = "derivedFrom") {
151
151
  const relations = [];
152
152
  const collect = (projectId, items) => {
153
153
  for (const item of items) {
154
- for (const ref of item.item.derivedFrom ?? []) {
154
+ for (const ref of item.item[relationField] ?? []) {
155
155
  const source = parseRegisterItemRef(ref, projectId);
156
156
  if (!source || source.projectId !== paths.projectId)
157
157
  continue;
@@ -0,0 +1,42 @@
1
+ import { existsSync } from "node:fs";
2
+ import { join, resolve } from "node:path";
3
+ import { getProjectTimelinePath, loadConfig, specdojoRootDir } from "../shared/specdojo-config.js";
4
+ import { loadTimelineIndex } from "../shared/timeline-index.js";
5
+ import { loadRegisterItemDocs } from "./item.js";
6
+ // track は epic の担当単位。timeline がない project でも同じ形式の識別子を保持する。
7
+ export function validateRegisterTrack(projectId, itemType, track) {
8
+ if (itemType !== "epic") {
9
+ if (track !== undefined)
10
+ throw new Error("--track is only valid for epic items");
11
+ return;
12
+ }
13
+ if (!track || !/^[a-z0-9][a-z0-9-]*$/.test(track)) {
14
+ throw new Error("An epic requires --track with a lowercase track identifier");
15
+ }
16
+ const { config } = loadConfig();
17
+ const project = config?.projects[projectId];
18
+ if (!project)
19
+ throw new Error(`Cannot validate epic track: unknown project ${projectId}`);
20
+ const indexPath = resolve(specdojoRootDir(), getProjectTimelinePath(project), "tml-index.yaml");
21
+ if (!existsSync(indexPath))
22
+ return;
23
+ const { index, errors } = loadTimelineIndex(indexPath);
24
+ if (errors.length > 0)
25
+ throw new Error(`${indexPath}: ${errors.join("; ")}`);
26
+ if (!index.tracks.some((entry) => entry.track === track)) {
27
+ throw new Error(`Undefined epic track "${track}" in ${indexPath}`);
28
+ }
29
+ }
30
+ export function validateRegisterEpicDocs(paths) {
31
+ return loadRegisterItemDocs(paths.projectRegisterPath).flatMap((doc) => {
32
+ try {
33
+ validateRegisterTrack(paths.projectId, doc.item.type, doc.item.track);
34
+ return [];
35
+ }
36
+ catch (error) {
37
+ return [
38
+ `${join(paths.projectRegisterPath, doc.filename)}: ${error instanceof Error ? error.message : String(error)}`,
39
+ ];
40
+ }
41
+ });
42
+ }
@@ -125,6 +125,8 @@ function fieldUpdateFromChange(change) {
125
125
  switch (change.field) {
126
126
  case "type":
127
127
  return isUnset ? undefined : { item_type: value };
128
+ case "track":
129
+ return { track: isUnset ? REMOVE_REGISTER_ITEM_FIELD : value };
128
130
  case "priority":
129
131
  return isUnset ? undefined : { priority: value };
130
132
  case "difficulty":
@@ -158,13 +160,14 @@ function fieldUpdateFromChange(change) {
158
160
  return undefined;
159
161
  }
160
162
  }
163
+ case "depends_on":
161
164
  case "derived_from": {
162
165
  if (isUnset)
163
- return { derived_from: REMOVE_REGISTER_ITEM_FIELD };
166
+ return { [change.field]: REMOVE_REGISTER_ITEM_FIELD };
164
167
  try {
165
168
  const parsed = JSON.parse(value);
166
169
  return Array.isArray(parsed) && parsed.every((ref) => typeof ref === "string")
167
- ? { derived_from: parsed }
170
+ ? { [change.field]: parsed }
168
171
  : undefined;
169
172
  }
170
173
  catch {
@@ -13,6 +13,7 @@ export const REGISTER_EVENT_FIELDS = [
13
13
  "title",
14
14
  "description",
15
15
  "type",
16
+ "track",
16
17
  "priority",
17
18
  "difficulty",
18
19
  "owner",
@@ -24,7 +25,10 @@ export const REGISTER_EVENT_FIELDS = [
24
25
  "approach",
25
26
  "targets",
26
27
  "sources",
28
+ "target_path",
29
+ "target_rulebook",
27
30
  "derived_from",
31
+ "depends_on",
28
32
  "autopilot",
29
33
  ];
30
34
  export const REGISTER_EVENT_ACTIONS = [
@@ -67,6 +71,7 @@ export function registerEventFieldValues(content, filename, timeZone) {
67
71
  title: item.title,
68
72
  description: item.description,
69
73
  type: item.type,
74
+ track: item.track ?? CELL_NONE,
70
75
  priority: item.priority,
71
76
  difficulty: item.difficulty ?? CELL_NONE,
72
77
  owner: item.owner,
@@ -77,8 +82,11 @@ export function registerEventFieldValues(content, filename, timeZone) {
77
82
  block_reason: parsed.blockReason,
78
83
  approach: item.approach ?? CELL_NONE,
79
84
  targets: item.targets ? JSON.stringify(item.targets) : CELL_NONE,
85
+ target_path: item.targetPath ?? CELL_NONE,
86
+ target_rulebook: item.targetRulebook ?? CELL_NONE,
80
87
  sources: item.sources ? JSON.stringify(item.sources) : CELL_NONE,
81
88
  derived_from: item.derivedFrom ? JSON.stringify(item.derivedFrom) : CELL_NONE,
89
+ depends_on: item.dependsOn ? JSON.stringify(item.dependsOn) : CELL_NONE,
82
90
  autopilot: item.autopilot ?? CELL_NONE,
83
91
  };
84
92
  }
@@ -40,6 +40,7 @@ export function buildExternalRegisterAddArgs(alias, externalProject, opts) {
40
40
  "--conclusion",
41
41
  opts.conclusion,
42
42
  ];
43
+ addValue(args, "--track", opts.track);
43
44
  addValue(args, "--difficulty", opts.difficulty);
44
45
  addValue(args, "--registered", opts.registered);
45
46
  addValue(args, "--approach", opts.approach);
@@ -50,6 +51,9 @@ export function buildExternalRegisterAddArgs(alias, externalProject, opts) {
50
51
  for (const source of opts.from ?? []) {
51
52
  addValue(args, "--from", rewriteExternalDerivedFrom(source, alias, externalProject.project_id));
52
53
  }
54
+ for (const predecessor of opts.dependsOn ?? []) {
55
+ addValue(args, "--depends-on", rewriteExternalDerivedFrom(predecessor, alias, externalProject.project_id));
56
+ }
53
57
  addValue(args, "--id", opts.id);
54
58
  addValue(args, "--topic", opts.topic);
55
59
  addValue(args, "--by", opts.by);
@@ -20,6 +20,7 @@ export const VALID_STATUSES = [
20
20
  ];
21
21
  export const VALID_TYPES = [
22
22
  "todo",
23
+ "epic",
23
24
  "question",
24
25
  "risk",
25
26
  "issue",
@@ -57,6 +58,7 @@ const SPECDOJO_KEY_ORDER = [
57
58
  "part_of",
58
59
  "based_on",
59
60
  "item_type",
61
+ "track",
60
62
  "item_status",
61
63
  "priority",
62
64
  "difficulty",
@@ -67,10 +69,13 @@ const SPECDOJO_KEY_ORDER = [
67
69
  "block_reason",
68
70
  "conclusion",
69
71
  "derived_from",
72
+ "depends_on",
70
73
  "autopilot",
71
74
  "approach",
72
75
  "targets",
73
76
  "sources",
77
+ "target_path",
78
+ "target_rulebook",
74
79
  ];
75
80
  // ================================
76
81
  // Derivation helpers
@@ -226,6 +231,9 @@ export function readRegisterItemContent(content, filename) {
226
231
  const derivedFrom = Array.isArray(fields.derived_from)
227
232
  ? fields.derived_from.filter((entry) => typeof entry === "string" && entry.trim() !== "")
228
233
  : undefined;
234
+ const dependsOn = Array.isArray(fields.depends_on)
235
+ ? fields.depends_on.filter((value) => typeof value === "string" && value.trim() !== "")
236
+ : undefined;
229
237
  const autopilot = fields.autopilot === "approved" ? "approved" : undefined;
230
238
  const difficulty = asString(fields.difficulty);
231
239
  const item = {
@@ -234,6 +242,7 @@ export function readRegisterItemContent(content, filename) {
234
242
  title: titleFromBody(body, id),
235
243
  description: descriptionFromBody(body),
236
244
  type: asString(fields.item_type) ?? CELL_TODO,
245
+ ...(asString(fields.track) ? { track: asString(fields.track) } : {}),
237
246
  priority: asString(fields.priority) ?? "medium",
238
247
  ...(difficulty ? { difficulty } : {}),
239
248
  owner: asString(fields.owner) ?? CELL_TODO,
@@ -246,9 +255,14 @@ export function readRegisterItemContent(content, filename) {
246
255
  conclusion: asString(fields.conclusion) ?? CELL_NONE,
247
256
  ticket: ticketRefCell(filename),
248
257
  ...(approach ? { approach } : {}),
258
+ ...(asString(fields.target_path) ? { targetPath: asString(fields.target_path) } : {}),
259
+ ...(asString(fields.target_rulebook)
260
+ ? { targetRulebook: asString(fields.target_rulebook) }
261
+ : {}),
249
262
  ...(targets && targets.length > 0 ? { targets } : {}),
250
263
  ...(sources && sources.length > 0 ? { sources } : {}),
251
264
  ...(derivedFrom && derivedFrom.length > 0 ? { derivedFrom } : {}),
265
+ ...(dependsOn && dependsOn.length > 0 ? { dependsOn } : {}),
252
266
  ...(autopilot ? { autopilot } : {}),
253
267
  };
254
268
  return {
@@ -370,10 +384,14 @@ export function registerItemFieldsFromItem(item) {
370
384
  conclusion: isPlaceholderCell(item.conclusion)
371
385
  ? null
372
386
  : inlineCodeAnglePlaceholders(item.conclusion.trim()),
387
+ ...(item.track ? { track: item.track } : {}),
373
388
  ...(item.approach ? { approach: item.approach } : {}),
389
+ ...(item.targetPath ? { target_path: item.targetPath } : {}),
390
+ ...(item.targetRulebook ? { target_rulebook: item.targetRulebook } : {}),
374
391
  ...(item.targets && item.targets.length > 0 ? { targets: item.targets } : {}),
375
392
  ...(item.sources && item.sources.length > 0 ? { sources: item.sources } : {}),
376
393
  ...(item.derivedFrom && item.derivedFrom.length > 0 ? { derived_from: item.derivedFrom } : {}),
394
+ ...(item.dependsOn && item.dependsOn.length > 0 ? { depends_on: item.dependsOn } : {}),
377
395
  ...(item.autopilot ? { autopilot: item.autopilot } : {}),
378
396
  };
379
397
  }
@@ -4,6 +4,8 @@ import { createGitTimestampResolver, planRegisterTimestampMigration, summarizeTi
4
4
  import { registerEventFilePath, validateRegisterEventDocs } from "./events.js";
5
5
  import { validateRegisterItemDocs } from "./item.js";
6
6
  import { specdojoRootDir } from "../shared/specdojo-config.js";
7
+ import { validateRegisterDependencyDocs } from "./dependency.js";
8
+ import { validateRegisterEpicDocs } from "./epic.js";
7
9
  import { validateDerivedFromDocs } from "./derivation.js";
8
10
  export function registerMaintenanceCommands(reg, dependencies) {
9
11
  const { addProjectOption, addRegisterCommitOptions, applyRegisterMigrationPlan, generateDerivedViewFiles, loadItemForUpdate, migrateEmbeddedRegisterEvents, migrateRegisterEventsFromGit, parseHistoryIds, planRegisterMigration, planRenumber, printCommandError, registerEventActor, renumberPjrItem, repoRelativePathspec, resolveRegisterPaths, runRegisterMutation, validBuildScopes, writeDerivedViews, } = dependencies;
@@ -87,7 +89,11 @@ export function registerMaintenanceCommands(reg, dependencies) {
87
89
  throw new Error(`Invalid scope: "${opts.scope}". Must be one of: ${validBuildScopes.join(", ")}`);
88
90
  }
89
91
  const validation = validateRegisterItemDocs(paths.projectRegisterPath);
90
- const derivationErrors = validateDerivedFromDocs(paths);
92
+ const derivationErrors = [
93
+ ...validateDerivedFromDocs(paths),
94
+ ...validateRegisterEpicDocs(paths),
95
+ ...validateRegisterDependencyDocs(paths),
96
+ ];
91
97
  const eventErrors = validateRegisterEventDocs(paths.projectRegisterPath, paths.registerDateTimeZone);
92
98
  if (validation.errors.length > 0 || derivationErrors.length > 0 || eventErrors.length > 0) {
93
99
  throw new Error(`Invalid register item files:\n${[
@@ -0,0 +1,37 @@
1
+ import { existsSync } from "node:fs";
2
+ import { join, resolve } from "node:path";
3
+ import { getProjectCatalogPath, getProjectTimelinePath, } from "../shared/specdojo-config.js";
4
+ import { loadTimelineIndex } from "../shared/timeline-index.js";
5
+ export function isPlanningApproach(approach) {
6
+ return approach === "catalog-planning" || approach === "strategy-planning";
7
+ }
8
+ // These targets identify work units, including units whose documents do not exist yet.
9
+ export function planningTarget(approach, target) {
10
+ const prefix = approach === "catalog-planning" ? "domain" : "track";
11
+ const match = target.match(new RegExp(`^${prefix}:([a-z0-9][a-z0-9-]{0,62})$`));
12
+ if (!match)
13
+ throw new Error(`Approach "${approach}" requires --target ${prefix}:<id>`);
14
+ return match[1];
15
+ }
16
+ export function validatePlanningTarget(opts) {
17
+ const unit = planningTarget(opts.approach, opts.target);
18
+ if (!getProjectCatalogPath(opts.project)) {
19
+ throw new Error(`Approach "${opts.approach}" requires catalog_path`);
20
+ }
21
+ if (opts.approach !== "strategy-planning")
22
+ return;
23
+ if (!opts.project.schedule_path?.trim()) {
24
+ throw new Error('Approach "strategy-planning" requires schedule_path');
25
+ }
26
+ const file = resolve(opts.repoRoot, getProjectTimelinePath(opts.project), "tml-index.yaml");
27
+ if (!existsSync(file)) {
28
+ // A declared strategy scope also supports projects without a timeline.
29
+ return;
30
+ }
31
+ const { index, errors } = loadTimelineIndex(file);
32
+ if (errors.length > 0)
33
+ throw new Error(`${file}: ${errors.join("; ")}`);
34
+ if (!index.tracks.some((track) => track.track === unit)) {
35
+ throw new Error(`Undefined strategy track "${unit}" in ${join(getProjectTimelinePath(opts.project), "tml-index.yaml")}`);
36
+ }
37
+ }
@@ -6,6 +6,7 @@ import { inlineCodeAnglePlaceholders } from "../shared/text.js";
6
6
  import { atomicWriteFile, buildRegisterItemContent, derivedTopicNeedsWarning, generatePjrId, printDerivedTopicWarning, registerEventActor, REGISTER_TOPIC_RE, resolveRegisterPaths, slugify, validateFields, } from "./core.js";
7
7
  import { registerCreateCommands, registerUpdateCommand } from "./create-commands.js";
8
8
  import { normalizeRegisterTimestamp } from "./date.js";
9
+ import { validateRegisterDependencyDocs } from "./dependency.js";
9
10
  import { validateDerivedFromDocs } from "./derivation.js";
10
11
  import { appendRegisterEvent, deterministicRegisterEventId, readEmbeddedRegisterEvents, readRegisterEventsFromContent, registerEventFilePath, removeEmbeddedRegisterEvents, serializeRegisterEvents, validateRegisterEventDocs, } from "./events.js";
11
12
  import { collectRegisterHistoryEvents } from "./history.js";
@@ -82,7 +83,10 @@ function defaultRegisterCommitMessage(command, result) {
82
83
  }
83
84
  function rebuildRegisterViews(paths) {
84
85
  const validation = validateRegisterItemDocs(paths.projectRegisterPath);
85
- const derivationErrors = validateDerivedFromDocs(paths);
86
+ const derivationErrors = [
87
+ ...validateDerivedFromDocs(paths),
88
+ ...validateRegisterDependencyDocs(paths),
89
+ ];
86
90
  const eventErrors = validateRegisterEventDocs(paths.projectRegisterPath, paths.registerDateTimeZone);
87
91
  if (validation.errors.length > 0 || derivationErrors.length > 0 || eventErrors.length > 0) {
88
92
  throw new Error(`Invalid register item files:\n${[