specdojo 0.4.7 → 0.6.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 (312) hide show
  1. package/.github/agents/specdojo-orchestrator.md +16 -9
  2. package/CHANGELOG.md +106 -0
  3. package/dist/catalog/generate.js +144 -13
  4. package/dist/commands/init.js +4 -0
  5. package/dist/commands/night-orchestrator.js +33 -4
  6. package/dist/dashboard/dashboard.js +5 -6
  7. package/dist/dashboard/timeline-build.js +5 -1
  8. package/dist/dashboard/timeline.js +6 -3
  9. package/dist/deliverable/deliverable.js +77 -4
  10. package/dist/docs/yaml-pages.js +17 -17
  11. package/dist/exec/core.js +3 -0
  12. package/dist/exec/parent-validation.js +7 -0
  13. package/dist/exec/pipeline-state.js +5 -2
  14. package/dist/exec/plans-core.js +49 -3
  15. package/dist/exec/plans-generation.js +48 -8
  16. package/dist/exec/plans-grade-findings.js +16 -0
  17. package/dist/exec/plans-planning.js +43 -0
  18. package/dist/exec/plans-storage.js +6 -2
  19. package/dist/exec/product-branch-records.js +105 -0
  20. package/dist/exec/product-branches.js +52 -0
  21. package/dist/exec/register-product-message.js +50 -0
  22. package/dist/exec/register.js +22 -1
  23. package/dist/exec/repo-integration-sync.js +11 -0
  24. package/dist/exec/repo-integration.js +58 -6
  25. package/dist/exec/repo-trace.js +19 -4
  26. package/dist/exec/results.js +11 -5
  27. package/dist/exec/run/register-command.js +16 -0
  28. package/dist/exec/run/register-core.js +11 -0
  29. package/dist/exec/run/register-mode.js +19 -1
  30. package/dist/exec/run/register-resume.js +33 -1
  31. package/dist/exec/run/register-worktree.js +52 -8
  32. package/dist/exec/run/schedule-prepare.js +7 -3
  33. package/dist/exec/strategy.js +4 -1
  34. package/dist/exec/task-repos.js +92 -16
  35. package/dist/exec/worktree-command.js +2 -2
  36. package/dist/exec/worktree-ops-commit.js +7 -1
  37. package/dist/exec/worktree.js +3 -3
  38. package/dist/grade/apply.js +6 -2
  39. package/dist/grade/markdown.js +7 -2
  40. package/dist/grade/plan.js +6 -4
  41. package/dist/register/approach.js +19 -0
  42. package/dist/register/catalog-status.js +49 -0
  43. package/dist/register/core.js +8 -0
  44. package/dist/register/create-commands.js +86 -4
  45. package/dist/register/deliverable-target.js +24 -17
  46. package/dist/register/dependency.js +123 -0
  47. package/dist/register/derivation.js +2 -2
  48. package/dist/register/epic.js +42 -0
  49. package/dist/register/event-merge.js +9 -2
  50. package/dist/register/events.js +10 -0
  51. package/dist/register/external-project.js +6 -0
  52. package/dist/register/input.js +168 -0
  53. package/dist/register/item.js +71 -0
  54. package/dist/register/maintenance-commands.js +7 -1
  55. package/dist/register/planning.js +37 -0
  56. package/dist/register/register.js +7 -3
  57. package/dist/register/renumber.js +16 -4
  58. package/dist/register/update.js +6 -0
  59. package/dist/register/views.js +55 -4
  60. package/dist/schedule/approach.js +9 -0
  61. package/dist/schedule/schedule.js +3 -1
  62. package/dist/schedule/strategy-generate-scope.js +5 -1
  63. package/dist/schedule/strategy-generate.js +1 -0
  64. package/dist/schedule/strategy-profiles.js +22 -2
  65. package/dist/shared/agent-types.js +7 -1
  66. package/dist/shared/branch-template.js +26 -0
  67. package/dist/shared/commit-message-template.js +38 -0
  68. package/dist/shared/commit-types.js +15 -0
  69. package/dist/shared/grade-result.js +23 -5
  70. package/dist/shared/markdownlint-config.js +38 -0
  71. package/dist/shared/markdownlint-scaffold.js +2 -9
  72. package/dist/shared/specdojo-config.js +42 -4
  73. package/dist/shared/specdojo-gitignore.js +4 -0
  74. package/docs/ja/specdojo/exec-templates/xep-catalog-planning-template.md +24 -0
  75. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +93 -0
  76. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +9 -2
  77. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +2 -0
  78. package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
  79. package/docs/ja/specdojo/exec-templates/xep-strategy-planning-template.md +24 -0
  80. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +2 -0
  81. package/docs/ja/specdojo/exec-templates/xer-human-draft-template.md +23 -0
  82. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +2 -0
  83. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +7 -4
  84. package/docs/ja/specdojo/guides/docs-editing-guide.md +14 -1
  85. package/docs/ja/specdojo/guides/docs-structure-guide.md +10 -8
  86. package/docs/ja/specdojo/guides/exec-config-guide.md +3 -1
  87. package/docs/ja/specdojo/guides/exec-operation-guide.md +111 -16
  88. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +19 -1
  89. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +2 -0
  90. package/docs/ja/specdojo/guides/quick-start-guide.md +37 -14
  91. package/docs/ja/specdojo/guides/register-operation-guide.md +58 -16
  92. package/docs/ja/specdojo/guides/remote-host-development-guide.md +1 -1
  93. package/docs/ja/specdojo/guides/ryu-guide.md +114 -23
  94. package/docs/ja/specdojo/guides/schedule-design-guide.md +31 -4
  95. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +16 -16
  96. package/docs/ja/specdojo/guides/timeline-design-guide.md +37 -33
  97. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +1 -0
  98. package/docs/ja/specdojo/recipes/tsd-recipe.md +206 -0
  99. package/docs/ja/specdojo/references/command-reference.md +86 -15
  100. package/docs/ja/specdojo/references/specdojo-config-reference.md +81 -8
  101. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +1 -0
  102. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +1 -0
  103. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +5 -4
  104. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +3 -2
  105. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +4 -3
  106. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +8 -7
  107. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +4 -3
  108. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +1 -0
  109. package/docs/ja/specdojo/rulebooks/br-rulebook.md +1 -0
  110. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +1 -0
  111. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +1 -0
  112. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +1 -0
  113. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +1 -0
  114. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +1 -0
  115. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +3 -2
  116. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +2 -1
  117. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +1 -0
  118. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +1 -0
  119. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +2 -1
  120. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +3 -2
  121. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +1 -0
  122. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +1 -0
  123. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +1 -0
  124. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +1 -0
  125. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +1 -0
  126. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +1 -0
  127. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -0
  128. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +1 -0
  129. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +2 -1
  130. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +2 -1
  131. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +1 -0
  132. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +1 -0
  133. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +9 -6
  134. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +1 -0
  135. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +3 -1
  136. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +2 -1
  137. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +2 -1
  138. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +2 -0
  139. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +4 -2
  140. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +1 -0
  141. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +1 -0
  142. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +1 -0
  143. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +1 -0
  144. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +1 -0
  145. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +1 -0
  146. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +1 -0
  147. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +2 -1
  148. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +1 -0
  149. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +4 -3
  150. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +9 -8
  151. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +10 -9
  152. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +9 -8
  153. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +9 -8
  154. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +9 -8
  155. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +9 -8
  156. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +10 -9
  157. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +9 -8
  158. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +9 -8
  159. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +7 -6
  160. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +1 -0
  161. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +1 -0
  162. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +1 -0
  163. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +1 -0
  164. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +2 -1
  165. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +2 -1
  166. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +54 -36
  167. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +1 -0
  168. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +1 -0
  169. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +1 -0
  170. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +1 -0
  171. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +1 -0
  172. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +1 -0
  173. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +1 -0
  174. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +1 -0
  175. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +1 -0
  176. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +1 -0
  177. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +1 -0
  178. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +1 -0
  179. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +1 -0
  180. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +1 -0
  181. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +1 -0
  182. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +1 -0
  183. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +1 -0
  184. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +1 -0
  185. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +1 -0
  186. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +3 -2
  187. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +4 -1
  188. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +7 -6
  189. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +4 -3
  190. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +2 -1
  191. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +1 -0
  192. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +1 -0
  193. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +1 -0
  194. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +1 -0
  195. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +2 -1
  196. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +9 -8
  197. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +2 -1
  198. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +1 -0
  199. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +1 -0
  200. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +1 -0
  201. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +1 -0
  202. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +80 -61
  203. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +111 -63
  204. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +1 -0
  205. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +3 -2
  206. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +1 -0
  207. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +1 -0
  208. package/docs/ja/specdojo/samples/atc-index-sample.md +1 -1
  209. package/docs/ja/specdojo/samples/atc-sample.md +1 -1
  210. package/docs/ja/specdojo/samples/bac-sample.md +1 -1
  211. package/docs/ja/specdojo/samples/bdd-sample.yaml +1 -1
  212. package/docs/ja/specdojo/samples/bds-sample.md +1 -1
  213. package/docs/ja/specdojo/samples/bes-index-sample.md +1 -1
  214. package/docs/ja/specdojo/samples/bes-sample.md +1 -1
  215. package/docs/ja/specdojo/samples/ccd-sample.md +1 -1
  216. package/docs/ja/specdojo/samples/cdfd-sample.md +1 -1
  217. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +1 -1
  218. package/docs/ja/specdojo/samples/cdsd-sample.md +1 -1
  219. package/docs/ja/specdojo/samples/cld-sample.md +1 -1
  220. package/docs/ja/specdojo/samples/cnd-sample.md +1 -1
  221. package/docs/ja/specdojo/samples/cop-index-sample.md +1 -1
  222. package/docs/ja/specdojo/samples/cop-sample.md +1 -1
  223. package/docs/ja/specdojo/samples/cpd-sample.md +1 -1
  224. package/docs/ja/specdojo/samples/cstd-sample.md +1 -1
  225. package/docs/ja/specdojo/samples/cxd-sample.md +1 -1
  226. package/docs/ja/specdojo/samples/dct-sample.yaml +5 -1
  227. package/docs/ja/specdojo/samples/dmd-index-sample.md +1 -1
  228. package/docs/ja/specdojo/samples/dmd-sample.md +1 -1
  229. package/docs/ja/specdojo/samples/etc-index-sample.md +1 -1
  230. package/docs/ja/specdojo/samples/etc-sample.md +1 -1
  231. package/docs/ja/specdojo/samples/gl-sample.yaml +2 -0
  232. package/docs/ja/specdojo/samples/ifd-sample.md +1 -1
  233. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +1 -0
  234. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +1 -1
  235. package/docs/ja/specdojo/samples/ifx-file-sample.md +1 -1
  236. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +1 -0
  237. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +2 -1
  238. package/docs/ja/specdojo/samples/itc-index-sample.md +1 -1
  239. package/docs/ja/specdojo/samples/itc-sample.md +1 -1
  240. package/docs/ja/specdojo/samples/mtp-sample.md +1 -1
  241. package/docs/ja/specdojo/samples/nfr-availability-sample.md +1 -1
  242. package/docs/ja/specdojo/samples/nfr-index-sample.md +1 -1
  243. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +1 -1
  244. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +1 -1
  245. package/docs/ja/specdojo/samples/nfr-operations-sample.md +1 -1
  246. package/docs/ja/specdojo/samples/nfr-performance-sample.md +1 -1
  247. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +1 -1
  248. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +1 -1
  249. package/docs/ja/specdojo/samples/nfr-usability-sample.md +1 -1
  250. package/docs/ja/specdojo/samples/ntp-sample.md +1 -1
  251. package/docs/ja/specdojo/samples/opd-sample.md +1 -1
  252. package/docs/ja/specdojo/samples/opr-sample.md +1 -1
  253. package/docs/ja/specdojo/samples/otp-index-sample.md +1 -1
  254. package/docs/ja/specdojo/samples/otp-sample.md +1 -1
  255. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +1 -1
  256. package/docs/ja/specdojo/samples/sac-sample.md +1 -1
  257. package/docs/ja/specdojo/samples/sf-index-sample.md +1 -1
  258. package/docs/ja/specdojo/samples/sf-sample.md +1 -1
  259. package/docs/ja/specdojo/samples/sld-sample.md +1 -1
  260. package/docs/ja/specdojo/samples/stc-index-sample.md +1 -1
  261. package/docs/ja/specdojo/samples/stc-sample.md +1 -1
  262. package/docs/ja/specdojo/samples/stsd-sample.md +1 -1
  263. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +1 -1
  264. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +1 -1
  265. package/docs/ja/specdojo/samples/sysd-index-sample.md +1 -1
  266. package/docs/ja/specdojo/samples/tsd-index-sample.md +22 -16
  267. package/docs/ja/specdojo/samples/tsd-sample.md +241 -21
  268. package/docs/ja/specdojo/samples/tsp-index-sample.md +1 -1
  269. package/docs/ja/specdojo/samples/uis-sample.md +1 -1
  270. package/docs/ja/specdojo/samples/utc-index-sample.md +1 -1
  271. package/docs/ja/specdojo/samples/utc-sample.md +1 -1
  272. package/docs/ja/specdojo/standards/document-metadata-standard.md +44 -3
  273. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +1 -0
  274. package/docs/ja/specdojo/standards/guide-authoring-standard.md +2 -1
  275. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +2 -0
  276. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -0
  277. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +2 -1
  278. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +18 -12
  279. package/docs/ja/specdojo/standards/sample-authoring-standard.md +1 -0
  280. package/docs/ja/specdojo/standards/standard-authoring-standard.md +2 -1
  281. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +1 -1
  282. package/docs/ja/specdojo/templates/pjr-change-request-template.md +10 -4
  283. package/docs/ja/specdojo/templates/pjr-dependent-items-template.md +22 -0
  284. package/docs/ja/specdojo/templates/pjr-epic-items-template.md +22 -0
  285. package/docs/ja/specdojo/templates/pjr-epic-template.md +44 -0
  286. package/docs/ja/specdojo/templates/pjr-index-template.md +4 -2
  287. package/docs/ja/specdojo/templates/pjr-issue-template.md +10 -4
  288. package/docs/ja/specdojo/templates/pjr-question-template.md +11 -5
  289. package/docs/ja/specdojo/templates/pjr-risk-template.md +10 -4
  290. package/docs/ja/specdojo/templates/pjr-todo-template.md +10 -4
  291. package/docs/specdojo/schemas/v1/bdd.schema.yaml +1 -1
  292. package/docs/specdojo/schemas/v1/dct.schema.yaml +9 -0
  293. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +24 -16
  294. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
  295. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +1 -0
  296. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +1 -1
  297. package/docs/specdojo/schemas/v1/gl.schema.yaml +8 -0
  298. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +5 -1
  299. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +2 -1
  300. package/docs/specdojo/schemas/v1/register-events.schema.yaml +21 -0
  301. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +75 -3
  302. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +5 -0
  303. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +1 -0
  304. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +43 -0
  305. package/package.json +4 -3
  306. package/templates/antigravity/orchestrator.md +16 -9
  307. package/templates/claude/agents/specdojo-orchestrator.md +16 -9
  308. package/templates/codex/agents/specdojo-orchestrator.toml +16 -9
  309. package/templates/codex/orchestrator.md +16 -9
  310. package/templates/copilot/README.md +2 -1
  311. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +14 -8
  312. package/templates/opencode/agents/specdojo-orchestrator.md +16 -9
@@ -93,18 +93,21 @@ catalog へ進む段階になったら、`.specdojo/specdojo.config.json` へ `c
93
93
 
94
94
  type は次のように使い分ける。
95
95
 
96
- | type | 用途 | 終端状態 |
97
- | ---------------- | ------------------------------ | --------- |
98
- | `issue` | 解決すべき問題。原因調査を伴う | `done` |
99
- | `decision` | 選択肢から方針を決める | `decided` |
100
- | `todo` | 実施する作業 | `done` |
101
- | `question` | 判断を保留し、後で決める | `decided` |
102
- | `risk` | 将来の不確実性 | `done` |
103
- | `change-request` | 合意済み範囲の変更要求 | `done` |
104
- | `note` | 記録として残す観測・分析 | なし |
96
+ | type | 用途 | 終端状態 |
97
+ | ---------------- | ---------------------------------- | --------- |
98
+ | `issue` | 解決すべき問題。原因調査を伴う | `done` |
99
+ | `decision` | 選択肢から方針を決める | `decided` |
100
+ | `todo` | 実施する作業 | `done` |
101
+ | `question` | 判断を保留し、後で決める | `decided` |
102
+ | `risk` | 将来の不確実性 | `done` |
103
+ | `change-request` | 合意済み範囲の変更要求 | `done` |
104
+ | `note` | 記録として残す観測・分析 | なし |
105
+ | `epic` | track ごとの仕事の着手と完了の管理 | `done` |
105
106
 
106
107
  起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
107
108
 
109
+ 対話で得た前提・制約・調査や選定を任せる範囲は、起票時に `--input <text>` を繰り返して個票の `入力` へ記録する。完了条件とは分け、会話で確認できた事実と明示的な委任範囲だけを書く。更新時の `--input` は一覧置換なので、追記では既存分も含めて渡し、全削除は `--input -` とする。
110
+
108
111
  ```bash
109
112
  npx specdojo register add --project <project-id> \
110
113
  --type todo --title "<title>" --description "<description>" \
@@ -131,6 +134,10 @@ npx specdojo register close --project <project-id> --id <PJR-XXXX> \
131
134
 
132
135
  `decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
133
136
 
137
+ `epic` は `--track <track>` で担う track を指定して起票し、具体的な作業は `--from <epic-id>` を付けた子 todo に分解する。epic 自体は `exec run --register` で実行せず、夜間の実行でも飛ばされる。子項目の状態は `register build` が生成する epic ごとのビューで確かめ、子項目と schedule を材料に人が close を判断する。
138
+
139
+ 順番のある項目は `--depends-on <PJR-XXXX>`(繰り返し指定できる)で先に終わっているべき項目を記録する。起票の由来を表す `--from`(`derived_from`)とは別の意味で、どちらかで他方を兼ねない。先行の項目がすべて `done` / `decided` になるまで、`exec run --register` は止まり、夜間の実行では飛ばされる。状態は自動では `waiting` にならない。外すときは `--depends-on -` を指定する。後続の項目は一覧の `depends_on` 列と `generated/pjr-dependent-items.md` で確かめる。
140
+
134
141
  `note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
135
142
 
136
143
  ## 実践の型(kata)の扱い
package/CHANGELOG.md CHANGED
@@ -2,6 +2,112 @@
2
2
 
3
3
  SpecDojo の利用者に影響する変更を記録します。
4
4
 
5
+ ## [0.6.0] - 2026-10-31
6
+
7
+ 同梱パッケージは `@specdojo/docs-lint` 0.4.0 を同時に公開します。docs-lint 0.4.0 は、成果物の文脈の目印 `_CONTEXT_:` の検出(`status: ready` の文書ではエラー、それ以外は情報。PJR-JRSY・PJR-D0GB)を含みます。`remark/md-content` を options なしで読み込むと失敗する問題の修正(PJR-5EN3)と、0.3.1(2026-10-29 公開)の rulebook 一覧のキャッシュ(PJR-SC8T)も含みます。`@specdojo/docs-site` は変更がないため 0.3.0 のままです。
8
+
9
+ ### 利用者から見て動きが変わる点
10
+
11
+ この版に破壊的変更はありません。ただし、次の 2 点は既存の使い方で結果が変わります。
12
+
13
+ - schedule の strategy の `guided-pass`(草案作成)の approach が、`fully-guided` から `draft` に変わりました。既存の schedule を作り直すと、草案の段の plan が `draft` の雛形で作られます(PJR-3MY5・PJR-E45K)。
14
+ - `fully-guided` は、既存成果物の磨き込み専用になりました。参照するのは宣言された文書(rulebook・recipe・sample、`based_on`、個票の `入力`、カタログの `brief` など)だけで、template から本文を新しく作ることはしません。文脈から下書きを作る場合は `draft` を使います(PJR-3MY5)。
15
+
16
+ ### 追加機能
17
+
18
+ - 本リポジトリの開発用に `node tools/lint-mermaid.mjs '<Markdown のパスまたは glob>'` を追加しました。docs-site と同じ Mermaid で、ブラウザを使わずに図の構文を検査し、エラーの文書・開始行・図の種類と未検査の件数を報告します。引数なしでは `docs/` 全体を検査します。本リポジトリでは `npm run lint:mermaid` として `npm run check` と commit 時の hook(変更した Markdown)に組み込みました(PJR-B5TY)。
19
+
20
+ - exec の親の検証に `lint-mermaid`(`npm run lint:mermaid`)を追加しました。`pipeline.parent_validations` に指定でき、利用するリポジトリに `lint:mermaid` script が必要です(PJR-B5TY)。
21
+
22
+ - プロダクトの作業ブランチ名を `repos[].branch_template` と `exec run --branch <repo>=<name>` で選べるようにしました。項目とブランチの対応を runner が記録し、再開・片付けに使います。別項目との名前の重なりは開始前に停止します。`integration_strategy: ff` は merge commit を作らず早送りだけで統合し、分岐した履歴では停止します。未設定時の名前と `merge`・`branch-only` の動作は従来どおりです(PJR-M1DH)。
23
+
24
+ - プロダクトリポジトリの `repos[].commit_subject_template` と `repos[].merge_message_template` で、register の exec が作る commit と merge commit の書式を選べるようにしました。8 種類の変数と空 scope の括弧除去に対応し、本文末尾の `Refs:` は常に付けます。未設定時の書式と SpecDojo の記帳は従来どおりです(PJR-Z7GX)。
25
+
26
+ - 個票に `commit_type` と `commit_scope` を追加し、`register add` / `update` に `--commit-type` と `--commit-scope` を追加しました。Conventional Commits の type・scope を個票ごとに指定でき、`update` では `-` で削除できます。未指定時は項目の type から既定の対応(`issue` は `fix`、`todo`・`change-request` は `feat` など)で解決し、`specdojo.config.json` の `projects.<project-id>.commit_types` や `repos[].commit_types` で対応を上書きできます(PJR-TC62)。
27
+
28
+ - `deliverable scaffold` に `--target <doc-id>` を追加しました。成果物を 1 つだけ指定して雛形を作成できます(`--dct` との併用は不可)。カタログにない成果物は `--target-path` と `--target-rulebook` を指定して作成できます。template のない rulebook でも最小構成の雛形を生成します(PJR-S23T)。
29
+
30
+ - 文脈を渡して成果物を作成する流れ(scaffold・文脈記入・`draft`・`fully-guided`・`finalize`)と、文脈の置き場所(成果物内の `_CONTEXT_:`、個票の `入力` / `--input`、カタログの `brief`)の使い分けを `exec-operation-guide` と `ryu-guide` にまとめました。あわせて `tsd-recipe` の「作成前に集める情報」に文脈の置き場所の対応を追加し、静的サイト向け TSD の技術選定を指示して作成する例を掲載しました(PJR-6A2B)。
31
+
32
+ - schedule に `draft` profile を追加しました。`strategy-planning` で `intent: draft-with-context` を宣言すると、雛形作成・文脈記入(human)→ draft → refine → review → finalize(human)を生成します。human は claim / complete で記録し、文脈記入用の result に雛形作成と `_CONTEXT_:` の案内を表示します(PJR-E45K)。
33
+
34
+ - `register add` / `update` に繰り返し指定できる `--input` を追加しました。対話で得た前提を個票の `入力` 節と event に記録し、register 経由の plan へ完了条件とは別に渡します。update は一覧置換、`--input -` は全削除です(PJR-6DD7)。
35
+
36
+ - 成果物内の文脈の目印 `_CONTEXT_:` を定めました。`draft` で反映した指示を result に記録し、`fully-guided` では未反映の指示を論点として残します。finalize の確認と文書 lint で残りを検出し、lint は `ready` で error、それ以外で warning とします(PJR-JRSY)。
37
+ - `draft` approach を追加しました。文脈で任された範囲を調べて下書きし、選定値を提案として示して出典と選定理由を記録します。register・schedule・plan で使えます(PJR-3MY5)。
38
+
39
+ - 成果物カタログ(dct)の成果物に `brief` を追加しました。成果物の外から継続して渡す前提(技術スタックや制約など)を記載でき、schedule の task の plan および register 経由の plan に「前提」として反映します。`brief` が無い場合は plan に載せません。複数成果物で共有する場合は YAML アンカーを利用できます(PJR-YKMA)。
40
+
41
+ ### 変更
42
+
43
+ - `schedule-design-guide`・`xer-human-draft-template`・`plans-planning.ts` に残っていた雛形作成の案内を、成果物を 1 つだけ作成する `deliverable scaffold --project <project-id> --target <doc-id>` の形にそろえました。これに伴い、カタログ全体の未作成成果物も生成される旨の注意事項を案内から削除しました(PJR-73KT)。
44
+
45
+ - strategy の `guided-pass`(草案作成)の approach を `fully-guided` から `draft` に変更しました。型がそろった未作成成果物を、文脈の記入がなくても template から下書きできます。調査・選定の委任がない範囲は保留し、後続の refine で `fully-guided` による磨き込みを行います。既存 strategy へは再生成時に反映されます(PJR-E45K)。
46
+
47
+ - `@specdojo/docs-lint` の `_CONTEXT_:` の検出において、`status: ready` 以外の文書では warning ではなく情報(info)として報告するように変更しました。下書き時に `_CONTEXT_:` を残したまま実行しても `--frail` 付きの `npm run lint:fm` が失敗せず、親の検証を妨げません。`status: ready` の文書では従来どおり error として失敗させます(PJR-D0GB)。
48
+
49
+ - 配布するオーケストレーターの指示に、対話で得た前提・制約・委任範囲を `--input` で個票の `入力` へ記録し、完了条件と分ける扱いを書き足しました(PJR-6DD7)。
50
+
51
+ - `fully-guided` を既存成果物の磨き込み専用に整理しました。参照は宣言された文書だけとし、対象成果物の `based_on`、個票の `入力`、カタログの `brief` を参照範囲に加えました。`入力`・`brief` の差し込み口は、値が無ければ「なし」と表示します(PJR-3MY5)。
52
+
53
+ ### 不具合修正
54
+
55
+ - `specdojo-tmux.sh.sample` の `find_container` で、ラベル `devcontainer.local_folder` が一致するコンテナが見つからない場合に `vsc-` で始まる別のコンテナへ誤って接続していた問題を修正しました。ラベルの一致するコンテナだけを検索対象とし、見つからない場合は `devcontainer up` を呼び出して起動するようにしました。あわせて `docker exec` の前にコンテナ内の作業ディレクトリの存在を確認し、存在しない場合は明示的なメッセージで停止するようにしました(PJR-P9ZC)。
56
+
57
+ - `decision`・`note`・`epic` など `入力` の章がない種類の個票へ `--input` を指定した際に、末尾に番号のない `## 入力` が追加されて章番号の連続性規約に違反していた問題を修正しました。最初の章の直後に `## 2. 入力` として挿入し、以降の章番号を 1 つずつ繰り下げます。既存の個票に番号のない `## 入力` がある場合も、同様に番号付きの章として適切な位置へ移動します(PJR-790T)。
58
+
59
+ - `deliverable scaffold` の一括生成と `--target` において、template のない rulebook の最小の雛形の `type` を rulebook の frontmatter で宣言された `deliverable_type` に合わせるように修正しました(未宣言時は従来どおり `project`)。これにより、template のない rulebook を指定して生成した雛形が docs-lint の `frontmatter-deliverable-type` で警告にならず、コミット時ガードを通過します(PJR-YKYK)。
60
+
61
+ - `@specdojo/docs-lint` の Markdown / YAML frontmatter 検証において、rulebook 一覧の生成をプロセス内でワークスペースごとに 1 回だけ行いキャッシュするように修正しました。remark のファイルごとのプラグイン読み込みで rulebook 一覧が毎回再生成されて `lint:fm` が著しく低速化していた問題を解消します。本修正は `@specdojo/docs-lint` 0.3.1 で公開済みです(PJR-SC8T)。
62
+
63
+ - `@specdojo/docs-lint` の `remark/md-content` を options なしで読み込んだ場合に `TypeError` で失敗する問題を修正しました。options が渡されないときは空の options として扱い、`schemas` は空、`workspaceRoot` は `process.cwd()` として動作します。これにより options なしでも `_CONTEXT_:` の検出が動作します(PJR-5EN3)。
64
+
65
+ ## [0.5.0] - 2026-10-29
66
+
67
+ 同梱パッケージは `@specdojo/docs-lint` 0.3.0 と `@specdojo/docs-site` 0.3.0 を同時に公開します。docs-lint 0.3.0 は、rulebook の `deliverable_type` と成果物の `type` の照合、YAML 成果物の旧 type のエラー化(下記の破壊的変更の PJR-484B・PJR-0D0T)を含みます。下記の移行手順の検査には docs-lint 0.3.0 が必要です。docs-site 0.3.0 は、生成物の `.vitepress/` への集約(PJR-9ZN5)と、Mermaid の構文エラーで生成を止めない変更(PJR-N9JC)を含みます。
68
+
69
+ ### 破壊的変更
70
+
71
+ 成果物の `type` を rulebook の宣言と照合するようにし、宣言と違う値や旧値は移行期間なしでエラーになります。次の順で移行してください。詳細は下記の各項目を参照してください。
72
+
73
+ 1. `specdojo` を 0.5.0、`@specdojo/docs-lint` を 0.3.0 に更新する(docs-site を使う場合は `@specdojo/docs-site` も 0.3.0 に更新する)。
74
+ 2. eject した rulebook に `specdojo.deliverable_type` を追加する。
75
+ 3. Markdown 成果物・sample・テンプレートの生成物 Frontmatter の `type` を宣言値に書き換え、`lint:fm` を通す。
76
+ 4. YAML 成果物の旧 type(`domain` / `command` / `message`)を置き換え、`validate:schema:yaml` を通す。
77
+ 5. `specdojo yaml-pages build` で表示ページを再生成する。
78
+
79
+ - 成果物の `type` に `requirement`(機能・非機能要件・受入基準)と `glossary`(用語集)を追加し、`project` はプロジェクトの管理文書に限定しました。各 rulebook の `specdojo.deliverable_type` を必須とし、Markdown 成果物・sample・テンプレートの生成物 Frontmatter と `lint:fm` で照合します(PJR-484B)。
80
+ - 既存の rulebook には、扱う成果物の `type` を `specdojo.deliverable_type` として追加してください。次に、その rulebook を参照する成果物・sample の `specdojo.type` と、テンプレートの `specdojo.frontmatter_template.specdojo.type` を宣言値に書き換えてください。テンプレート自身の `specdojo.type` は `template` のままにします。`lint:fm` を実行し、エラーに表示される宣言値にそろえてください。移行期間は設けず、従来の `project` や `sample` も宣言と違えばエラーにします。
81
+ - YAML 成果物も rulebook の宣言と照合します(PJR-0D0T)。既存の bdd は `type: domain` を `data`、ifx-cmd は `command` を `api`、ifx-msg の `x-spec-meta.type` は `message` を `api` に変更してください。gl には `type: glossary` と `rulebook: specdojo:gl-rulebook` を追加し、OpenAPI / AsyncAPI の `x-spec-meta` と IF 一覧にも対応する `rulebook` を記載してください。YAML テンプレートの `metadata_template.type` も宣言値に合わせ、自身の `type: template` は維持します。`npm run validate:schema:yaml` を実行し、エラーに示された置き換え先へ修正してください。旧値は即時エラーとなり、`specdojo-schema: none` / `validate=false` でもメタ情報は検証します。最後に `specdojo yaml-pages build` で表示ページを再生成してください。表示ページは元 YAML の `type` を引き継ぎます。
82
+
83
+ ### 追加機能
84
+
85
+ - `repos[].integration_strategy` に `branch-only` を指定すると、プロダクトをローカルで merge せず、commit 済みの exec branch を残してプロダクト側の PR レビューへ渡せるようにしました。既定は従来どおり `merge` です。成功後は worktree を撤去し、プロジェクト側は `review` へ進んで result に未統合・branch 名・trace key を記録します。push と PR 作成は行いません(PJR-EXH2)。
86
+
87
+ - register の子 todo からカタログの判定・生成を行う `catalog-planning` と、scope・intent の宣言から strategy・track を生成する `strategy-planning` を追加しました。対象は `domain:<domain>` / `track:<track>` で指定します。`timeline build` と strategy 生成は、カタログ作成 todo の完了から `catalog_status` を導き、手書き計画との差を警告します(PJR-WAGY)。
88
+
89
+ - register に track ごとの仕事を管理する `epic` type と個票テンプレートを追加しました。`add` / `update --track` で担当 track を記録・検証し、`--from` でつないだ子項目と状態を epic 別ビューに表示します。epic 自体は `exec run --register`・filter・夜間 queue の実行対象から外し、完了は子項目と schedule を材料に人が判断します(PJR-B4Y4)。
90
+
91
+ - 登録項目の実行順序を `depends_on` と `register add` / `update --depends-on` で指定できるようにしました。参照先・自己参照・循環を検証し、先行項目が `done` / `decided` になるまで直接実行を停止、sweep・夜間 queue を理由付きでスキップします。一覧の依存列と後続項目の逆引きビューも追加しました(PJR-6RVJ)。
92
+
93
+ ### 変更
94
+
95
+ - 配布するオーケストレーターの指示(`templates/` の各環境向け)の type の表に `epic` を加え、track を指定して起票し、子 todo へ分解し、epic 自体は実行しない扱いを書き足しました。
96
+ - 配布するオーケストレーターの指示に、`--depends-on` で順番のある項目の先行を記録し、`--from` の由来とは区別する扱いを書き足しました。
97
+ - `@specdojo/docs-site` が生成するファイルを `.vitepress/` の下にまとめました。Mermaid の SVG と manifest は `.vitepress/mermaid/`、kata のステージングは `.vitepress/kata-staging/` に出力し、ビルド結果には SVG だけを含めます。利用者の `public/` は変更しません。package 同梱の文書は `/ja/specdojo/...` で公開し、eject 済みの文書は利用リポジトリ側を優先します。`config init` が生成する `.gitignore` に `/.vitepress/dist/`・`/.vitepress/cache/`・`/.vitepress/mermaid/`・`/.vitepress/kata-staging/` を追加しました。旧配置の `public/mermaid/` と `specdojo-kata-staging/` は自動では削除しないため、不要になったら削除してください(PJR-9ZN5)。
98
+ - 技術領域別の TSD を作成する `specdojo:tsd-recipe` を追加し、`tsd-rulebook` から参照するようにしました。一冊・分冊の判断、採用値と未決事項の整理、段階的な動作確認、秘密情報の扱いを作業順に辿れます(PJR-05GN)。
99
+ - `specdojo:tsd-sample` を新しい `tsd-rulebook` に合わせて見直しました。駄菓子屋きぬや販売管理システムのデータベース詳細定義(PostgreSQL / Prisma)を題材とし、対象環境・前提条件、採用設定、導入手順、動作確認、制約・トラブルシュートを満たす完成例に再構成しました(PJR-EVAE)。
100
+ - `specdojo:tsd-index-sample` を新しい `tsd-index-rulebook` に合わせて見直しました。技術スタック一覧に版・正本と適用範囲の列を設け、開発・検証・文書化・運用の技術区分と必須・任意の区別を追加し、詳細 TSD サンプルへのリンクを整備しました(PJR-9SXH)。
101
+ - sample の `type` は見本にする成果物の種類とし、sample の識別は `id` とファイル名の `-sample` で行う原則を明文化しました。同梱 sample 5 件の `type` を揃え、既存の `type: sample` は互換性のためスキーマで許容します(PJR-XSM8)。
102
+
103
+ ### 不具合修正
104
+
105
+ - markdownlint の設定がない利用リポジトリで、result の commit 前検査が日本語の長い行(MD013)を拒否する問題を修正しました。設定がない場合は SpecDojo の基本規則を使い、既存設定は優先します。通常の `init` と `config init` は不足する `.markdownlint.yaml` を上書きせずに生成します(PJR-0QW0)。
106
+ - plan に展開する grade の finding の `anchor` と本文を、バッククォートを含む場合も壊れないインラインコードで囲むようにしました。引用元に Markdown リンクがあっても、生成した plan が `validate:history-links` に失敗しません(PJR-H988)。
107
+ - `@specdojo/docs-site` の Mermaid 図に構文エラーがあっても、`dev` は対象文書とエラーを警告してほかの図とページの生成を続けるようにしました。`build` と `mermaid` は全図を処理し、失敗した図をまとめて報告してから失敗します。失敗した図の SVG を cache に残さず、修正後の変更検知で再生成します(PJR-N9JC)。
108
+ - `register add` / `update` の `sample-maintenance` が成果物の `type` を持つ sample を拒否する問題を修正しました。索引で対象を解決し、`id` の末尾 `-sample` で判定します(PJR-XSM8)。
109
+ - `project.repos` の文書の grade 結果を `results/<repo 名>/<文書 ID>.yaml` に分離し、別リポジトリの同じ ID による上書きと前回結果の誤参照を修正しました。plan・apply・run の再開・dashboard なども同じ配置を使い、本リポジトリの既存結果の保存先は維持します(PJR-8NWR)。
110
+
5
111
  ## [0.4.7] - 2026-10-26
6
112
 
7
113
  ### 追加機能
@@ -3,12 +3,14 @@ import { dirname, join } from "node:path";
3
3
  import { dump, load } from "../shared/yaml.js";
4
4
  import { collectResolvedDeliverables } from "./build.js";
5
5
  import { resolveBasePath } from "./paths.js";
6
- import { buildSpecdojoFrontmatter, readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
6
+ import { buildSpecdojoFrontmatter, parseSpecdojoDocument, readSpecdojoNamespace, } from "../docs/frontmatter-namespace.js";
7
7
  import { parsePracticeId, practiceLocalId } from "../shared/practice-id.js";
8
8
  import { resolveKataDocumentPathIfExists } from "../kata/kata.js";
9
9
  import { flattenTemplateFrontmatter } from "../docs/template-frontmatter.js";
10
10
  import { isDctCatalogFileName } from "./types.js";
11
11
  import { resolveSpecdojoPathIfExists, } from "../docs/template-resolution.js";
12
+ import { resolveDeliverableByDocId } from "./document-target.js";
13
+ import { validateDeliverableTargetPath } from "../register/deliverable-target.js";
12
14
  const PROJECT_ID_PLACEHOLDER = "_PROJECT_ID_";
13
15
  const LOCAL_ID_PLACEHOLDER = "_LOCAL_ID_";
14
16
  const DELIVERABLE_NAME_PLACEHOLDER = "_DELIVERABLE_NAME_";
@@ -62,10 +64,8 @@ function normalizeDctName(name) {
62
64
  .replace(/\.ya?ml$/i, "")
63
65
  .replace(/^dct-/, "");
64
66
  }
65
- // Resolve a deliverable template from the rulebook frontmatter declaration. The declaration is
66
- // the SSOT, so local_id naming conventions are deliberately not used as a fallback. This lets
67
- // every deliverable in one rulebook lineage share a single template.
68
- function findTemplate(templatesPath, rulebooksPath, repoRoot, rulebookId, ext, resourceRoots) {
67
+ // Resolve the path to a rulebook file. The declaration is the SSOT.
68
+ function resolveRulebookPath(rulebooksPath, repoRoot, rulebookId, resourceRoots) {
69
69
  if (!rulebookId ||
70
70
  rulebookId === "none" ||
71
71
  rulebookId === "not-needed" ||
@@ -83,11 +83,41 @@ function findTemplate(templatesPath, rulebooksPath, repoRoot, rulebookId, ext, r
83
83
  : resourceRoots
84
84
  ? resolveSpecdojoPathIfExists(`docs/ja/specdojo/rulebooks/${rulebookFileName}`, resourceRoots)
85
85
  : join(rulebooksPath, rulebookFileName);
86
+ if (!rulebookPath || !existsSync(rulebookPath))
87
+ return null;
88
+ return rulebookPath;
89
+ }
90
+ // Resolve a rulebook's declared deliverable_type from its frontmatter.
91
+ // Falls back to "project" if the rulebook is absent, unreadable, or omits deliverable_type.
92
+ function resolveDeliverableType(rulebooksPath, repoRoot, rulebookId, resourceRoots) {
93
+ const rulebookPath = resolveRulebookPath(rulebooksPath, repoRoot, rulebookId, resourceRoots);
94
+ if (!rulebookPath)
95
+ return "project";
96
+ try {
97
+ const meta = readSpecdojoNamespace(readFileSync(rulebookPath, "utf8"));
98
+ if (typeof meta.deliverable_type === "string" && meta.deliverable_type.trim().length > 0) {
99
+ return meta.deliverable_type.trim();
100
+ }
101
+ }
102
+ catch {
103
+ return "project";
104
+ }
105
+ return "project";
106
+ }
107
+ // Resolve a deliverable template from the rulebook frontmatter declaration. The declaration is
108
+ // the SSOT, so local_id naming conventions are deliberately not used as a fallback. This lets
109
+ // every deliverable in one rulebook lineage share a single template.
110
+ function findTemplate(templatesPath, rulebooksPath, repoRoot, rulebookId, ext, resourceRoots) {
111
+ const rulebookPath = resolveRulebookPath(rulebooksPath, repoRoot, rulebookId, resourceRoots);
86
112
  if (!rulebookPath)
87
113
  return null;
88
- if (!existsSync(rulebookPath))
114
+ let templateId;
115
+ try {
116
+ templateId = readSpecdojoNamespace(readFileSync(rulebookPath, "utf8")).template;
117
+ }
118
+ catch {
89
119
  return null;
90
- const templateId = readSpecdojoNamespace(readFileSync(rulebookPath, "utf8")).template;
120
+ }
91
121
  if (typeof templateId !== "string" ||
92
122
  templateId === "none" ||
93
123
  templateId === "not-needed" ||
@@ -112,10 +142,10 @@ function findTemplate(templatesPath, rulebooksPath, repoRoot, rulebookId, ext, r
112
142
  // Minimal Markdown scaffold built from catalog metadata when no template exists.
113
143
  // Fills the generated Frontmatter, an H1 from `name`, the catalog `overview`, and a
114
144
  // single `_TODO_` line so the author knows the body is unwritten.
115
- function fallbackMarkdown(item, projectId) {
145
+ function fallbackMarkdown(item, projectId, deliverableType = "project") {
116
146
  const inner = {
117
147
  id: `${projectId}:${item.local_id}`,
118
- type: "project",
148
+ type: deliverableType,
119
149
  status: "draft",
120
150
  };
121
151
  if (item.rulebook && item.rulebook !== "undecided") {
@@ -129,10 +159,10 @@ function fallbackMarkdown(item, projectId) {
129
159
  return `${frontmatter}\n\n# ${item.name}\n\n${item.overview}\n\n_TODO_: 本文を記述する\n`;
130
160
  }
131
161
  // Minimal YAML scaffold built from catalog metadata when no template exists.
132
- function fallbackYaml(item, projectId) {
162
+ function fallbackYaml(item, projectId, deliverableType = "project") {
133
163
  const doc = {
134
164
  id: `${projectId}:${item.local_id}`,
135
- type: "project",
165
+ type: deliverableType,
136
166
  status: "draft",
137
167
  };
138
168
  if (item.rulebook && item.rulebook !== "undecided") {
@@ -156,14 +186,19 @@ function expandYamlTemplate(templatePath, item, projectId) {
156
186
  function generateContent(item, resolvedPath, projectId, templatesPath, rulebooksPath, repoRoot, resourceRoots) {
157
187
  if (isYamlPath(resolvedPath)) {
158
188
  const template = findTemplate(templatesPath, rulebooksPath, repoRoot, item.rulebook, ".yaml", resourceRoots);
159
- return template ? expandYamlTemplate(template, item, projectId) : fallbackYaml(item, projectId);
189
+ if (template) {
190
+ return expandYamlTemplate(template, item, projectId);
191
+ }
192
+ const deliverableType = resolveDeliverableType(rulebooksPath, repoRoot, item.rulebook, resourceRoots);
193
+ return fallbackYaml(item, projectId, deliverableType);
160
194
  }
161
195
  const template = findTemplate(templatesPath, rulebooksPath, repoRoot, item.rulebook, ".md", resourceRoots);
162
196
  if (template) {
163
197
  const raw = readFileSync(template, "utf8");
164
198
  return replaceGeneratedPlaceholders(flattenTemplateFrontmatter(raw), item, projectId);
165
199
  }
166
- return fallbackMarkdown(item, projectId);
200
+ const deliverableType = resolveDeliverableType(rulebooksPath, repoRoot, item.rulebook, resourceRoots);
201
+ return fallbackMarkdown(item, projectId, deliverableType);
167
202
  }
168
203
  // Materialize the deliverable files a project's catalog points to. Only `kind: work`
169
204
  // items are generated; `control` deliverables have dedicated scaffolds (e.g. register
@@ -236,3 +271,99 @@ export function runGenerate(opts) {
236
271
  }
237
272
  return { written, skipped, errors };
238
273
  }
274
+ function ensureFrontmatterProperties(content, isYaml, expected) {
275
+ if (isYaml) {
276
+ const loaded = load(content);
277
+ const doc = loaded && typeof loaded === "object" && !Array.isArray(loaded) ? loaded : {};
278
+ doc.id = expected.id;
279
+ doc.status = expected.status;
280
+ if (expected.rulebook && expected.rulebook !== "undecided") {
281
+ doc.rulebook = expected.rulebook === "not-needed" ? "none" : expected.rulebook;
282
+ }
283
+ return dump(doc, { lineWidth: 120, noRefs: true });
284
+ }
285
+ const { data, body } = parseSpecdojoDocument(content);
286
+ data.id = expected.id;
287
+ data.status = expected.status;
288
+ if (expected.rulebook && expected.rulebook !== "undecided") {
289
+ data.rulebook = expected.rulebook === "not-needed" ? "none" : expected.rulebook;
290
+ }
291
+ const innerLines = dump(data, { lineWidth: 120, noRefs: true }).replace(/\n+$/, "").split("\n");
292
+ const fm = buildSpecdojoFrontmatter(innerLines);
293
+ return `${fm}\n\n${body.replace(/^\n+/, "")}`;
294
+ }
295
+ export function runGenerateTarget(opts) {
296
+ const { catalogPath, templatesPath, rulebooksPath, repoRoot, projectId, targetId, targetPath, targetRulebook, force, dryRun = false, resourceRoots, } = opts;
297
+ const written = [];
298
+ const skipped = [];
299
+ const errors = [];
300
+ const localId = targetId.includes(":") ? targetId.slice(targetId.indexOf(":") + 1) : targetId;
301
+ const canonicalDocId = targetId.includes(":") ? targetId : `${projectId}:${targetId}`;
302
+ let item;
303
+ let resolvedPath;
304
+ if (catalogPath && existsSync(catalogPath)) {
305
+ try {
306
+ const resolved = resolveDeliverableByDocId(catalogPath, projectId, targetId, repoRoot);
307
+ item = resolved.info.deliverable;
308
+ resolvedPath = resolved.info.resolvedPath;
309
+ }
310
+ catch (error) {
311
+ if (!(error instanceof Error) ||
312
+ !error.message.startsWith("catalog deliverable target not found")) {
313
+ errors.push(error instanceof Error ? error.message : String(error));
314
+ return { written, skipped, errors };
315
+ }
316
+ if (!targetPath || !targetRulebook) {
317
+ errors.push(error.message);
318
+ return { written, skipped, errors };
319
+ }
320
+ }
321
+ }
322
+ if (!item || !resolvedPath) {
323
+ if (!targetPath || !targetRulebook) {
324
+ errors.push(`Catalog-less deliverable ${targetId} requires both --target-path and --target-rulebook`);
325
+ return { written, skipped, errors };
326
+ }
327
+ try {
328
+ resolvedPath = validateDeliverableTargetPath(repoRoot, canonicalDocId, targetPath);
329
+ }
330
+ catch (err) {
331
+ errors.push(err instanceof Error ? err.message : String(err));
332
+ return { written, skipped, errors };
333
+ }
334
+ item = {
335
+ local_id: localId,
336
+ name: localId,
337
+ kind: "work",
338
+ overview: "",
339
+ path: resolvedPath,
340
+ rulebook: targetRulebook,
341
+ };
342
+ }
343
+ if (item.kind !== "work") {
344
+ errors.push(`Deliverable ${targetId} is kind '${item.kind}', only 'work' deliverables can be scaffolded`);
345
+ return { written, skipped, errors };
346
+ }
347
+ const outputPath = join(repoRoot, resolvedPath);
348
+ if (existsSync(outputPath) && !force) {
349
+ skipped.push(resolvedPath);
350
+ return { written, skipped, errors };
351
+ }
352
+ try {
353
+ let content = generateContent(item, resolvedPath, projectId, templatesPath, rulebooksPath, repoRoot, resourceRoots);
354
+ content = ensureFrontmatterProperties(content, isYamlPath(resolvedPath), {
355
+ id: canonicalDocId,
356
+ status: "draft",
357
+ rulebook: item.rulebook,
358
+ });
359
+ if (!dryRun) {
360
+ mkdirSync(dirname(outputPath), { recursive: true });
361
+ writeFileSync(outputPath, content, "utf8");
362
+ }
363
+ written.push(resolvedPath);
364
+ }
365
+ catch (err) {
366
+ errors.push(`${resolvedPath}: ${err instanceof Error ? err.message : String(err)}`);
367
+ }
368
+ return { written, skipped, errors };
369
+ }
@@ -6,6 +6,7 @@ import { runScaffold } from "../catalog/scaffold.js";
6
6
  import { runDevcontainerScaffold } from "../devcontainer/scaffold.js";
7
7
  import { runProviderScaffold } from "../shared/provider-scaffold.js";
8
8
  import { runLefthookScaffold } from "../shared/lefthook-scaffold.js";
9
+ import { ensureMarkdownlintConfig } from "../shared/markdownlint-config.js";
9
10
  import { runSlidevScaffold, SLIDEV_KATA_PATTERNS } from "../shared/slidev-scaffold.js";
10
11
  import { generateDerivedViewFiles } from "../register/register.js";
11
12
  import { defaultWorktreeBase, projectGitignoreLayout, specdojoRootDir, } from "../shared/specdojo-config.js";
@@ -16,6 +17,7 @@ const PARENT_VALIDATION_SCRIPTS = {
16
17
  "lint-ts": "lint:ts",
17
18
  "lint-fm": "lint:fm",
18
19
  "lint-md": "lint:md",
20
+ "lint-mermaid": "lint:mermaid",
19
21
  "test-integration": "test:integration",
20
22
  "validate-schema": "validate:schema",
21
23
  typecheck: "typecheck",
@@ -559,6 +561,8 @@ export async function runInit(options, deps) {
559
561
  if (answers.slidev) {
560
562
  await runSlidevScaffold({ repoRoot, dryRun });
561
563
  }
564
+ if (!answers.lefthook && !answers.slidev)
565
+ ensureMarkdownlintConfig(repoRoot, dryRun);
562
566
  const firstProvider = answers.providers[0];
563
567
  const script = firstProvider === "claude"
564
568
  ? "orch:opus"
@@ -1,3 +1,4 @@
1
+ import { registerDependencyBlockReason } from "../register/dependency.js";
1
2
  import { spawn } from "node:child_process";
2
3
  import { mkdirSync, writeFileSync } from "node:fs";
3
4
  import { join, relative } from "node:path";
@@ -192,19 +193,47 @@ export function registerNightOrchestratorCommand(orchestrator) {
192
193
  if (!projectId)
193
194
  throw new Error("orchestrator night requires --project <id>.");
194
195
  const items = loadRegisterItems(resolveRegisterPaths({ project: projectId })).map((view) => view.item);
195
- const selected = selectApprovedNightItems(items, maxItems);
196
+ const registerPaths = resolveRegisterPaths({ project: projectId });
197
+ const dependencyOutcomes = [];
198
+ const dependencyItems = [];
199
+ const selected = selectApprovedNightItems(items, Number.MAX_SAFE_INTEGER)
200
+ .filter((item) => {
201
+ const reason = registerDependencyBlockReason(registerPaths, item);
202
+ if (!reason)
203
+ return true;
204
+ process.stdout.write(`[night] skipping ${item.id}: ${reason}\n`);
205
+ dependencyItems.push(item);
206
+ dependencyOutcomes.push({
207
+ id: item.id,
208
+ outcome: "skipped",
209
+ transition: "none",
210
+ reason,
211
+ });
212
+ return false;
213
+ })
214
+ .slice(0, maxItems);
196
215
  process.stdout.write(`[night] approved queue (${selected.length}/${maxItems}): ${selected.map((item) => item.id).join(", ") || "none"}\n`);
197
216
  if (opts.dryRun)
198
217
  return;
199
218
  const startedAt = opts.scheduledAt
200
219
  ? new Date(opts.scheduledAt).toISOString()
201
220
  : new Date().toISOString();
202
- const outcomes = [];
221
+ const outcomes = [...dependencyOutcomes];
203
222
  const approvalIssues = new Map();
204
223
  let consecutiveFailures = 0;
205
224
  let stopReason;
206
225
  for (let offset = 0; offset < selected.length; offset += parallel) {
207
- const wave = selected.slice(offset, offset + parallel);
226
+ const current = new Map(loadRegisterItems(registerPaths).map((view) => [view.id, view.item]));
227
+ const wave = selected.slice(offset, offset + parallel).filter((item) => {
228
+ const reason = registerDependencyBlockReason(registerPaths, current.get(item.id) ?? item);
229
+ if (!reason)
230
+ return true;
231
+ outcomes.push({ id: item.id, outcome: "skipped", transition: "none", reason });
232
+ process.stdout.write(`[night] skipping ${item.id}: ${reason}\n`);
233
+ return false;
234
+ });
235
+ if (wave.length === 0)
236
+ continue;
208
237
  const [command, args] = cliInvocation([
209
238
  "exec",
210
239
  "run",
@@ -270,7 +299,7 @@ export function registerNightOrchestratorCommand(orchestrator) {
270
299
  projectId,
271
300
  startedAt,
272
301
  completedAt,
273
- selected,
302
+ selected: [...dependencyItems, ...selected],
274
303
  outcomes,
275
304
  approvalIssues,
276
305
  ...(stopReason ? { stopReason } : {}),
@@ -1,7 +1,7 @@
1
- import { mkdirSync, existsSync, readFileSync, writeFileSync, readdirSync } from "node:fs";
1
+ import { mkdirSync, existsSync, readFileSync, writeFileSync } from "node:fs";
2
2
  import { join } from "node:path";
3
3
  import { toArtifactPath } from "../shared/artifact-path.js";
4
- import { readJson } from "../shared/fs.js";
4
+ import { listFilesRecursive, readJson } from "../shared/fs.js";
5
5
  import { readAllEventFiles } from "../exec/events.js";
6
6
  import { getProjectExecutionPath, getProjectRoutinesPath, getProjectSchedulePath, getProjectTimelinePath, loadConfig, loadEnv, specdojoRootDir, } from "../shared/specdojo-config.js";
7
7
  import { resolveRegisterPaths, loadRegisterItems, } from "../register/register.js";
@@ -381,11 +381,10 @@ function renderDailyRoutineSection(paths) {
381
381
  export function readDashboardGradeResults(resultsPath) {
382
382
  if (!existsSync(resultsPath))
383
383
  return [];
384
- return readdirSync(resultsPath)
385
- .filter((name) => name.endsWith(".yaml") || name.endsWith(".yml"))
384
+ return listFilesRecursive(resultsPath)
385
+ .filter((path) => path.endsWith(".yaml") || path.endsWith(".yml"))
386
386
  .sort()
387
- .flatMap((name) => {
388
- const path = join(resultsPath, name);
387
+ .flatMap((path) => {
389
388
  try {
390
389
  return [parseGradeResult(readFileSync(path, "utf8"), path)];
391
390
  }
@@ -1,6 +1,7 @@
1
1
  import { existsSync } from "node:fs";
2
2
  import { join } from "node:path";
3
3
  import { collectCatalogFilesByDomain } from "../shared/catalog-files.js";
4
+ import { resolveTimelineCatalogStatus } from "../register/catalog-status.js";
4
5
  import { loadTimelineIndex, } from "../shared/timeline-index.js";
5
6
  export { collectCatalogFilesByDomain, loadTimelineIndex };
6
7
  // depends_on の未定義参照・循環・order との矛盾を検出する。
@@ -107,6 +108,9 @@ export function buildTimeline(opts) {
107
108
  const { index, errors: loadErrors } = loadTimelineIndex(indexFile);
108
109
  const errors = [...loadErrors];
109
110
  const warnings = [];
111
+ const derived = resolveTimelineCatalogStatus(index.tracks, opts.registerPath);
112
+ index.tracks = derived.tracks;
113
+ warnings.push(...derived.warnings);
110
114
  const structure = validateTimelineTracks(index.tracks);
111
115
  errors.push(...structure.errors);
112
116
  warnings.push(...structure.warnings);
@@ -147,7 +151,7 @@ export function renderTimelineOrderMarkdown(result) {
147
151
  lines.push(`- catalog_scaffold_targets: \`${result.scaffolds.length}\``);
148
152
  lines.push("");
149
153
  lines.push(`この文書は \`tml-index.yaml\` から \`specdojo timeline build\` が生成した派生ビューです。` +
150
- `直接編集せず、\`tml-index.yaml\` を更新してください。`);
154
+ `直接編集せず、計画は \`tml-index.yaml\`、カタログ作成の完了は register の todo に記録してください。`);
151
155
  for (const wave of result.waves) {
152
156
  lines.push("");
153
157
  lines.push(`## ${wave.wave}. Wave ${wave.wave}`);
@@ -1,6 +1,6 @@
1
1
  import { existsSync, mkdirSync, writeFileSync } from "node:fs";
2
2
  import { join, resolve } from "node:path";
3
- import { getProjectCatalogPath, getProjectTimelinePath, loadConfig, loadEnv, specdojoRootDir, } from "../shared/specdojo-config.js";
3
+ import { getProjectCatalogPath, getProjectTimelinePath, getProjectRegisterPath, loadConfig, loadEnv, specdojoRootDir, } from "../shared/specdojo-config.js";
4
4
  import { buildTimeline, renderCatalogScaffoldMarkdown, renderTimelineOrderMarkdown, } from "./timeline-build.js";
5
5
  function resolveTimelinePaths(opts) {
6
6
  loadEnv();
@@ -20,9 +20,11 @@ function resolveTimelinePaths(opts) {
20
20
  throw new Error(`Unknown project: ${projectId} (check ${configPath})`);
21
21
  }
22
22
  const catalogPath = getProjectCatalogPath(project);
23
+ const registerPath = getProjectRegisterPath(project);
23
24
  return {
24
25
  timelinePath: resolve(baseDir, getProjectTimelinePath(project)),
25
26
  catalogPath: catalogPath ? resolve(baseDir, catalogPath) : null,
27
+ ...(registerPath ? { registerPath: resolve(baseDir, registerPath) } : {}),
26
28
  };
27
29
  }
28
30
  function printCommandError(error) {
@@ -37,6 +39,7 @@ function buildTimelineJson(result) {
37
39
  return (JSON.stringify({
38
40
  project_id: result.projectId,
39
41
  schedule_ready_tracks: result.scheduleReadyTracks,
42
+ track_catalog_status: Object.fromEntries(result.waves.flatMap((wave) => wave.tracks.map((track) => [track.track, track.catalog_status]))),
40
43
  waves: result.waves.map((wave) => ({
41
44
  wave: wave.wave,
42
45
  tracks: wave.tracks.map((track) => track.track),
@@ -70,8 +73,8 @@ export function registerTimelineCommands(program) {
70
73
  bcmd.option("--dry-run", "Print generated content to stdout without writing", false);
71
74
  bcmd.action((opts) => {
72
75
  try {
73
- const { timelinePath, catalogPath } = resolveTimelinePaths(opts);
74
- const result = buildTimeline({ timelinePath, catalogPath });
76
+ const { timelinePath, catalogPath, registerPath } = resolveTimelinePaths(opts);
77
+ const result = buildTimeline({ timelinePath, catalogPath, registerPath });
75
78
  for (const warning of result.warnings)
76
79
  process.stdout.write(`WARN: ${warning}\n`);
77
80
  for (const error of result.errors)