specdojo 0.7.0 → 0.9.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 (462) hide show
  1. package/.github/agents/specdojo-orchestrator.md +7 -3
  2. package/CHANGELOG.md +217 -0
  3. package/dist/catalog/build.js +24 -1
  4. package/dist/catalog/catalog.js +16 -14
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +5 -3
  8. package/dist/commands/build.js +69 -10
  9. package/dist/commands/git.js +206 -0
  10. package/dist/commands/init.js +9 -3
  11. package/dist/commands/night-orchestrator.js +6 -4
  12. package/dist/commands/where.js +25 -0
  13. package/dist/dashboard/dashboard-timeline.js +18 -16
  14. package/dist/dashboard/dashboard.js +616 -261
  15. package/dist/dashboard/epic-plan.js +81 -0
  16. package/dist/dashboard/exec-records.js +16 -20
  17. package/dist/dashboard/routines.js +11 -12
  18. package/dist/dashboard/timeline-build.js +5 -9
  19. package/dist/dashboard/timeline.js +23 -18
  20. package/dist/devcontainer/scaffold.js +18 -0
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/index-command.js +2 -2
  23. package/dist/docs/yaml-business-tables.js +243 -0
  24. package/dist/docs/yaml-interface-tables.js +106 -0
  25. package/dist/docs/yaml-pages-command.js +5 -3
  26. package/dist/docs/yaml-pages.js +268 -3
  27. package/dist/docs/yaml-table-shared.js +70 -0
  28. package/dist/docs/yaml-tables.js +39 -0
  29. package/dist/exec/agent-config.js +31 -0
  30. package/dist/exec/agent-plan.js +3 -2
  31. package/dist/exec/agent-protected-config.js +2 -0
  32. package/dist/exec/commands.js +100 -39
  33. package/dist/exec/commit-hook-skips.js +78 -0
  34. package/dist/exec/core.js +19 -7
  35. package/dist/exec/events.js +179 -8
  36. package/dist/exec/evidence.js +77 -19
  37. package/dist/exec/handoff.js +9 -13
  38. package/dist/exec/limit.js +1 -1
  39. package/dist/exec/mechanical-result.js +45 -0
  40. package/dist/exec/migrate-records.js +249 -0
  41. package/dist/exec/parent-validation.js +209 -15
  42. package/dist/exec/pipeline-state.js +27 -5
  43. package/dist/exec/plans-condense-findings.js +89 -0
  44. package/dist/exec/plans-core.js +45 -19
  45. package/dist/exec/plans-generation.js +52 -30
  46. package/dist/exec/plans-grade-findings.js +8 -3
  47. package/dist/exec/plans-kata-findings.js +61 -0
  48. package/dist/exec/plans-planning.js +3 -3
  49. package/dist/exec/plans-storage.js +12 -24
  50. package/dist/exec/post-integration.js +162 -0
  51. package/dist/exec/queue-command.js +166 -0
  52. package/dist/exec/queue.js +285 -0
  53. package/dist/exec/register-foreign-wait.js +84 -0
  54. package/dist/exec/register-resume.js +55 -56
  55. package/dist/exec/register.js +26 -22
  56. package/dist/exec/repo-integration-sync.js +21 -5
  57. package/dist/exec/repo-integration.js +21 -1
  58. package/dist/exec/reporter.js +121 -23
  59. package/dist/exec/results.js +106 -25
  60. package/dist/exec/review-completion.js +47 -0
  61. package/dist/exec/review-kata.js +112 -0
  62. package/dist/exec/run/agent-pipeline.js +78 -8
  63. package/dist/exec/run/agent.js +32 -13
  64. package/dist/exec/run/change-scope.js +365 -0
  65. package/dist/exec/run/deferred-cleanup.js +31 -0
  66. package/dist/exec/run/in-place.js +73 -33
  67. package/dist/exec/run/job-lock.js +66 -0
  68. package/dist/exec/run/job-sequence.js +137 -0
  69. package/dist/exec/run/job.js +135 -41
  70. package/dist/exec/run/lifecycle-commands.js +189 -37
  71. package/dist/exec/run/lock.js +22 -1
  72. package/dist/exec/run/mode-shared.js +11 -3
  73. package/dist/exec/run/register-command.js +14 -15
  74. package/dist/exec/run/register-core.js +20 -13
  75. package/dist/exec/run/register-mode.js +77 -17
  76. package/dist/exec/run/register-post-review.js +21 -9
  77. package/dist/exec/run/register-resume.js +95 -31
  78. package/dist/exec/run/register-state.js +23 -15
  79. package/dist/exec/run/register-worktree.js +184 -139
  80. package/dist/exec/run/schedule-mode.js +79 -18
  81. package/dist/exec/run/schedule-prepare.js +204 -59
  82. package/dist/exec/run/schedule-task.js +203 -49
  83. package/dist/exec/run/shared.js +9 -3
  84. package/dist/exec/run/trailing-records.js +35 -0
  85. package/dist/exec/run-records.js +2 -0
  86. package/dist/exec/schedule/schedule.js +116 -4
  87. package/dist/exec/shared.js +1 -1
  88. package/dist/exec/smoke.js +190 -0
  89. package/dist/exec/strategy.js +14 -3
  90. package/dist/exec/task-view.js +6 -4
  91. package/dist/exec/trailing-records.js +242 -0
  92. package/dist/exec/trial-commands.js +8 -4
  93. package/dist/exec/trial-core.js +6 -1
  94. package/dist/exec/validate-records-commit.js +110 -0
  95. package/dist/exec/validate-records.js +148 -0
  96. package/dist/exec/validation-metrics.js +181 -0
  97. package/dist/exec/worktree-cleanup-lock.js +26 -0
  98. package/dist/exec/worktree-command.js +38 -17
  99. package/dist/exec/worktree-ops-commit.js +119 -48
  100. package/dist/exec/worktree-ops-lifecycle.js +77 -48
  101. package/dist/exec/worktree-ops-merge.js +13 -2
  102. package/dist/exec/worktree-ops.js +2 -2
  103. package/dist/exec/worktree.js +32 -4
  104. package/dist/grade/apply.js +32 -6
  105. package/dist/grade/command-apply.js +3 -3
  106. package/dist/grade/command-inspect.js +7 -5
  107. package/dist/grade/command-plan.js +1 -1
  108. package/dist/grade/command-run.js +7 -1
  109. package/dist/grade/command-shared.js +1 -1
  110. package/dist/grade/core.js +18 -5
  111. package/dist/grade/markdown.js +3 -3
  112. package/dist/grade/pipeline-state.js +15 -11
  113. package/dist/grade/plan.js +37 -17
  114. package/dist/grade/result.js +3 -3
  115. package/dist/grade/run.js +87 -11
  116. package/dist/grade/target-discovery.js +17 -4
  117. package/dist/grade/targets.js +12 -11
  118. package/dist/job/definition.js +84 -8
  119. package/dist/job/job.js +109 -39
  120. package/dist/job/noop.js +104 -0
  121. package/dist/register/authoring-sources.js +22 -16
  122. package/dist/register/core.js +2 -0
  123. package/dist/register/create-commands.js +28 -3
  124. package/dist/register/deliverable-target.js +9 -1
  125. package/dist/register/epic.js +104 -26
  126. package/dist/register/event-merge.js +3 -0
  127. package/dist/register/events.js +4 -0
  128. package/dist/register/external-project.js +3 -0
  129. package/dist/register/item.js +6 -0
  130. package/dist/register/maintenance-commands.js +6 -3
  131. package/dist/register/planning.js +7 -14
  132. package/dist/register/register.js +74 -16
  133. package/dist/register/track-domains.js +34 -0
  134. package/dist/register/track-plan.js +78 -0
  135. package/dist/register/transition-commands.js +8 -0
  136. package/dist/register/work-table.js +64 -0
  137. package/dist/review/grade.js +35 -13
  138. package/dist/routine/definition.js +13 -3
  139. package/dist/routine/failure.js +30 -0
  140. package/dist/routine/routine.js +189 -71
  141. package/dist/routine/status.js +62 -0
  142. package/dist/routine/storage.js +33 -0
  143. package/dist/schedule/schedule.js +39 -39
  144. package/dist/schedule/strategy-generate-document.js +26 -14
  145. package/dist/schedule/strategy-generate-scope.js +17 -45
  146. package/dist/schedule/strategy-generate.js +33 -3
  147. package/dist/schedule/strategy-profiles.js +86 -12
  148. package/dist/shared/agent-types.js +7 -0
  149. package/dist/shared/condense-records.js +25 -0
  150. package/dist/shared/cross-process-lock.js +9 -1
  151. package/dist/shared/deprecation.js +8 -0
  152. package/dist/shared/dist-freshness.js +8 -2
  153. package/dist/shared/document-metadata.js +20 -0
  154. package/dist/shared/finding-cause.js +20 -0
  155. package/dist/shared/frontmatter-namespace.js +48 -0
  156. package/dist/shared/git-environment.js +2 -1
  157. package/dist/shared/git.js +186 -16
  158. package/dist/shared/grade-result.js +17 -1
  159. package/dist/shared/lefthook-scaffold.js +3 -0
  160. package/dist/shared/local-config.js +244 -0
  161. package/dist/shared/local-state.js +20 -0
  162. package/dist/shared/markdownlint-config.js +8 -3
  163. package/dist/shared/plan-conventions.js +129 -0
  164. package/dist/shared/plan-templates.js +57 -41
  165. package/dist/shared/run-records.js +224 -0
  166. package/dist/shared/specdojo-config.js +73 -41
  167. package/dist/shared/specdojo-gitignore.js +1 -0
  168. package/dist/shared/text.js +74 -6
  169. package/dist/shared/timeline-index.js +2 -0
  170. package/dist/shared/where-alias.js +13 -0
  171. package/dist/specdojo.js +4 -0
  172. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  173. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  174. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  175. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  176. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  177. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  178. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  179. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  180. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  181. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  182. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  183. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  184. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  185. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  186. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  187. package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
  188. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  189. package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
  190. package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
  191. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  192. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  193. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  194. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  195. package/docs/ja/specdojo/guides/quick-start-guide.md +73 -17
  196. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
  197. package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
  198. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  199. package/docs/ja/specdojo/guides/routine-operation-guide.md +23 -12
  200. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  201. package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
  202. package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
  203. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  204. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  205. package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
  206. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  207. package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
  208. package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
  209. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  210. package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
  211. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  212. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  213. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +92 -99
  214. package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
  215. package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
  216. package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
  217. package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
  218. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
  219. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
  220. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  221. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  222. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -48
  223. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
  224. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
  225. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
  226. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
  227. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
  228. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  229. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
  230. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  231. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  232. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  233. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  234. package/docs/ja/specdojo/recipes/stsd-recipe.md +88 -80
  235. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
  236. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
  237. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
  238. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  239. package/docs/ja/specdojo/references/command-reference.md +303 -148
  240. package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
  241. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  242. package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
  243. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  244. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  245. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +63 -290
  246. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
  247. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
  248. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
  249. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
  250. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  251. package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
  252. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
  253. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  254. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  255. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  256. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  257. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +51 -55
  258. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  259. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
  260. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
  261. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  262. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
  263. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  264. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
  265. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  266. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  267. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  268. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +79 -249
  269. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  270. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
  271. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
  272. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
  273. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -14
  274. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  275. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  276. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +171 -0
  277. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  278. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  279. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +93 -57
  280. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
  281. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  282. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
  283. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
  284. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
  285. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  286. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
  287. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  288. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
  289. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  290. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  291. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  292. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  293. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  294. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +12 -23
  295. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  296. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  297. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  298. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  299. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  300. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  301. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  302. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  303. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  304. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  305. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  306. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  307. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  308. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  309. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  310. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  311. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +92 -102
  312. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  313. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  314. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  315. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  316. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +45 -59
  317. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
  318. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
  319. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
  320. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  321. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
  322. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
  323. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
  324. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  325. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
  326. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  327. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  328. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  329. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  330. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  331. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +106 -32
  332. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
  333. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
  334. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  335. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  336. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +46 -40
  337. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
  338. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
  339. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
  340. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
  341. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  342. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  343. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
  344. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  345. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  346. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  347. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  348. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +91 -161
  349. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  350. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  351. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  352. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  353. package/docs/ja/specdojo/samples/bds-sample.md +87 -21
  354. package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
  355. package/docs/ja/specdojo/samples/bes-sample.md +70 -21
  356. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  357. package/docs/ja/specdojo/samples/br-sample.md +57 -15
  358. package/docs/ja/specdojo/samples/ccd-sample.md +80 -19
  359. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  360. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
  361. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  362. package/docs/ja/specdojo/samples/cdsd-sample.md +73 -20
  363. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  364. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  365. package/docs/ja/specdojo/samples/clis-sample.md +125 -0
  366. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  367. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  368. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  369. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  370. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  371. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  372. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  373. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  374. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  375. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  376. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  377. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  378. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  379. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  380. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  381. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  382. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  383. package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
  384. package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
  385. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
  386. package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
  387. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  388. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
  389. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  390. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
  391. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  392. package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
  393. package/docs/ja/specdojo/samples/sf-sample.md +109 -21
  394. package/docs/ja/specdojo/samples/sld-sample.md +88 -21
  395. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  396. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  397. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  398. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  399. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  400. package/docs/ja/specdojo/samples/uis-sample.md +141 -20
  401. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  402. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  403. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  404. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  405. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  406. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  407. package/docs/ja/specdojo/templates/br-template.md +64 -0
  408. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  409. package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
  410. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  411. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  412. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  413. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  414. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  415. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  416. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  417. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  418. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  419. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  420. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  421. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  422. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  423. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  424. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  425. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  426. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  427. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  428. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  429. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  430. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  431. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  432. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  433. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  434. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  435. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  436. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  437. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  438. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  439. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
  440. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
  441. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -0
  442. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  443. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  444. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  445. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  446. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  447. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  448. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  449. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  450. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  451. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  452. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  453. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  454. package/package.json +10 -7
  455. package/templates/antigravity/orchestrator.md +7 -3
  456. package/templates/claude/agents/specdojo-orchestrator.md +7 -3
  457. package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
  458. package/templates/codex/orchestrator.md +7 -3
  459. package/templates/devcontainer/tmux.conf +6 -0
  460. package/templates/init-exec-defaults.yaml +13 -0
  461. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  462. package/templates/opencode/agents/specdojo-orchestrator.md +8 -4
@@ -1,42 +1,120 @@
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) {
1
+ import { readFileSync } from "node:fs";
2
+ import { resolve } from "node:path";
3
+ import { getProjectRegisterPath, loadConfig, specdojoRootDir } from "../shared/specdojo-config.js";
4
+ import { loadRegisterItemDocs, readSpecdojoFields } from "./item.js";
5
+ export function validateRegisterStartOn(itemType, value, allowRemove = false) {
6
+ if (value === undefined)
7
+ return;
8
+ if (itemType !== "epic")
9
+ throw new Error("--start-on / start_on is only valid for epic items");
10
+ if (allowRemove && value === "-")
11
+ return;
12
+ const date = typeof value === "string" ? new Date(`${value}T00:00:00Z`) : undefined;
13
+ if (typeof value !== "string" ||
14
+ !/^\d{4}-\d{2}-\d{2}$/.test(value) ||
15
+ !date ||
16
+ Number.isNaN(date.getTime()) ||
17
+ date.toISOString().slice(0, 10) !== value) {
18
+ throw new Error(`Invalid start_on: "${String(value)}". Must be a valid calendar date (YYYY-MM-DD)`);
19
+ }
20
+ }
21
+ export function hasReversedEpicDates(item) {
22
+ return (item.startOn !== undefined && /^\d{4}-\d{2}-\d{2}$/.test(item.due) && item.startOn > item.due);
23
+ }
24
+ export function registerEpicDateWarnings(paths) {
25
+ return loadRegisterItemDocs(paths.projectRegisterPath)
26
+ .filter(({ item }) => item.type === "epic" && hasReversedEpicDates(item))
27
+ .map(({ item }) => `${item.id}: start_on (${item.startOn}) is after due_on (${item.due}); period is unknown`);
28
+ }
29
+ export function validateRegisterDomains(itemType, domains) {
30
+ if (domains === undefined)
31
+ return;
32
+ if (itemType !== "epic")
33
+ throw new Error("--domain / domains is only valid for epic items");
34
+ if (!Array.isArray(domains) ||
35
+ domains.some((v) => typeof v !== "string" || !v.trim() || v === "-")) {
36
+ throw new Error("domains must be an array of non-empty strings");
37
+ }
38
+ if (new Set(domains).size !== domains.length)
39
+ throw new Error("Duplicate epic domains");
40
+ }
41
+ function validateTrack(itemType, track) {
8
42
  if (itemType !== "epic") {
9
43
  if (track !== undefined)
10
44
  throw new Error("--track is only valid for epic items");
11
- return;
12
45
  }
13
- if (!track || !/^[a-z0-9][a-z0-9-]*$/.test(track)) {
46
+ else if (!track || !/^[a-z0-9][a-z0-9-]*$/.test(track)) {
14
47
  throw new Error("An epic requires --track with a lowercase track identifier");
15
48
  }
49
+ }
50
+ export function validateRegisterTrack(projectId, itemType, track, excludingId) {
51
+ validateTrack(itemType, track);
52
+ if (itemType !== "epic")
53
+ return;
16
54
  const { config } = loadConfig();
17
55
  const project = config?.projects[projectId];
18
56
  if (!project)
19
57
  throw new Error(`Cannot validate epic track: unknown project ${projectId}`);
20
- const indexPath = resolve(specdojoRootDir(), getProjectTimelinePath(project), "tml-index.yaml");
21
- if (!existsSync(indexPath))
58
+ const path = getProjectRegisterPath(project);
59
+ if (!path)
22
60
  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}`);
61
+ const duplicate = loadRegisterItemDocs(resolve(specdojoRootDir(), path)).find((doc) => doc.id !== excludingId && doc.item.type === "epic" && doc.item.track === track);
62
+ if (duplicate)
63
+ throw new Error(`Duplicate epic track "${track}": ${duplicate.id}`);
64
+ }
65
+ // Only local epic edges determine the overall plan. Qualified references to this project
66
+ // are equivalent to local IDs; dependencies on other items remain execution constraints.
67
+ export function epicPredecessors(item, projectId, epics) {
68
+ return (item.dependsOn ?? []).flatMap((ref) => {
69
+ const id = ref.startsWith(`${projectId}:`) ? ref.slice(projectId.length + 1) : ref;
70
+ const predecessor = epics.get(id);
71
+ return predecessor ? [predecessor] : [];
72
+ });
73
+ }
74
+ export function orderEpics(items, projectId) {
75
+ const epics = new Map(items.filter((item) => item.type === "epic").map((item) => [item.id, item]));
76
+ const ordered = [];
77
+ const visited = new Set();
78
+ const visiting = new Set();
79
+ const tracks = new Set();
80
+ for (const item of epics.values()) {
81
+ validateTrack(item.type, item.track);
82
+ validateRegisterDomains(item.type, item.domains);
83
+ if (tracks.has(item.track))
84
+ throw new Error(`Duplicate epic track "${item.track}"`);
85
+ tracks.add(item.track);
28
86
  }
87
+ const visit = (item) => {
88
+ if (visiting.has(item.id))
89
+ throw new Error(`Epic depends_on cycle: ${[...visiting, item.id].join(" -> ")}`);
90
+ if (visited.has(item.id))
91
+ return;
92
+ visiting.add(item.id);
93
+ for (const predecessor of epicPredecessors(item, projectId, epics))
94
+ visit(predecessor);
95
+ visiting.delete(item.id);
96
+ visited.add(item.id);
97
+ ordered.push(item);
98
+ };
99
+ for (const item of [...epics.values()].sort((a, b) => a.id.localeCompare(b.id)))
100
+ visit(item);
101
+ return ordered;
29
102
  }
30
103
  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 [];
104
+ const docs = loadRegisterItemDocs(paths.projectRegisterPath);
105
+ try {
106
+ for (const doc of docs) {
107
+ const fields = readSpecdojoFields(readFileSync(doc.path, "utf8"));
108
+ validateRegisterStartOn(doc.item.type, fields.start_on);
109
+ validateTrack(doc.item.type, doc.item.track);
110
+ validateRegisterDomains(doc.item.type, fields.domains);
35
111
  }
36
- catch (error) {
37
- return [
38
- `${join(paths.projectRegisterPath, doc.filename)}: ${error instanceof Error ? error.message : String(error)}`,
39
- ];
40
- }
41
- });
112
+ orderEpics(docs.map((doc) => doc.item), paths.projectId);
113
+ return [];
114
+ }
115
+ catch (error) {
116
+ return [
117
+ `${paths.projectRegisterPath}: ${error instanceof Error ? error.message : String(error)}`,
118
+ ];
119
+ }
42
120
  }
@@ -127,6 +127,8 @@ function fieldUpdateFromChange(change) {
127
127
  return isUnset ? undefined : { item_type: value };
128
128
  case "track":
129
129
  return { track: isUnset ? REMOVE_REGISTER_ITEM_FIELD : value };
130
+ case "start_on":
131
+ return { start_on: isUnset ? REMOVE_REGISTER_ITEM_FIELD : value };
130
132
  case "priority":
131
133
  return isUnset ? undefined : { priority: value };
132
134
  case "difficulty":
@@ -160,6 +162,7 @@ function fieldUpdateFromChange(change) {
160
162
  return undefined;
161
163
  }
162
164
  }
165
+ case "domains":
163
166
  case "depends_on":
164
167
  case "derived_from": {
165
168
  if (isUnset)
@@ -15,10 +15,12 @@ export const REGISTER_EVENT_FIELDS = [
15
15
  "input",
16
16
  "type",
17
17
  "track",
18
+ "domains",
18
19
  "priority",
19
20
  "difficulty",
20
21
  "owner",
21
22
  "registered",
23
+ "start_on",
22
24
  "due",
23
25
  "completed",
24
26
  "conclusion",
@@ -76,10 +78,12 @@ export function registerEventFieldValues(content, filename, timeZone) {
76
78
  input: item.inputs?.length ? JSON.stringify(item.inputs) : CELL_NONE,
77
79
  type: item.type,
78
80
  track: item.track ?? CELL_NONE,
81
+ domains: item.domains ? JSON.stringify(item.domains) : CELL_NONE,
79
82
  priority: item.priority,
80
83
  difficulty: item.difficulty ?? CELL_NONE,
81
84
  owner: item.owner,
82
85
  registered: item.registered,
86
+ start_on: item.startOn ?? CELL_NONE,
83
87
  due: item.due,
84
88
  completed: item.completed,
85
89
  conclusion: item.conclusion,
@@ -41,8 +41,11 @@ export function buildExternalRegisterAddArgs(alias, externalProject, opts) {
41
41
  opts.conclusion,
42
42
  ];
43
43
  addValue(args, "--track", opts.track);
44
+ for (const domain of opts.domain ?? [])
45
+ addValue(args, "--domain", domain);
44
46
  addValue(args, "--difficulty", opts.difficulty);
45
47
  addValue(args, "--registered", opts.registered);
48
+ addValue(args, "--start-on", opts.startOn);
46
49
  addValue(args, "--approach", opts.approach);
47
50
  for (const input of opts.input ?? [])
48
51
  addValue(args, "--input", input);
@@ -71,11 +71,13 @@ const SPECDOJO_KEY_ORDER = [
71
71
  "based_on",
72
72
  "item_type",
73
73
  "track",
74
+ "domains",
74
75
  "item_status",
75
76
  "priority",
76
77
  "difficulty",
77
78
  "owner",
78
79
  "registered_at",
80
+ "start_on",
79
81
  "due_on",
80
82
  "completed_at",
81
83
  "block_reason",
@@ -261,10 +263,12 @@ export function readRegisterItemContent(content, filename) {
261
263
  ...(inputs ? { inputs } : {}),
262
264
  type: asString(fields.item_type) ?? CELL_TODO,
263
265
  ...(asString(fields.track) ? { track: asString(fields.track) } : {}),
266
+ ...(Array.isArray(fields.domains) ? { domains: fields.domains } : {}),
264
267
  priority: asString(fields.priority) ?? "medium",
265
268
  ...(difficulty ? { difficulty } : {}),
266
269
  owner: asString(fields.owner) ?? CELL_TODO,
267
270
  registeredAt: asString(fields.registered_at) ?? CELL_TODO,
271
+ ...(asString(fields.start_on) ? { startOn: asString(fields.start_on) } : {}),
268
272
  due: fields.due_on === null
269
273
  ? CELL_NONE
270
274
  : (asString(fields.due_on) ??
@@ -405,6 +409,8 @@ export function registerItemFieldsFromItem(item) {
405
409
  ? null
406
410
  : inlineCodeAnglePlaceholders(item.conclusion.trim()),
407
411
  ...(item.track ? { track: item.track } : {}),
412
+ ...(item.startOn !== undefined ? { start_on: item.startOn } : {}),
413
+ ...(item.domains !== undefined ? { domains: item.domains } : {}),
408
414
  ...(item.approach ? { approach: item.approach } : {}),
409
415
  ...(item.targetPath ? { target_path: item.targetPath } : {}),
410
416
  ...(item.targetRulebook ? { target_rulebook: item.targetRulebook } : {}),
@@ -5,7 +5,7 @@ import { registerEventFilePath, validateRegisterEventDocs } from "./events.js";
5
5
  import { validateRegisterItemDocs } from "./item.js";
6
6
  import { specdojoRootDir } from "../shared/specdojo-config.js";
7
7
  import { validateRegisterDependencyDocs } from "./dependency.js";
8
- import { validateRegisterEpicDocs } from "./epic.js";
8
+ import { registerEpicDateWarnings, validateRegisterEpicDocs } from "./epic.js";
9
9
  import { validateDerivedFromDocs } from "./derivation.js";
10
10
  export function registerMaintenanceCommands(reg, dependencies) {
11
11
  const { addProjectOption, addRegisterCommitOptions, applyRegisterMigrationPlan, generateDerivedViewFiles, loadItemForUpdate, migrateEmbeddedRegisterEvents, migrateRegisterEventsFromGit, parseHistoryIds, planRegisterMigration, planRenumber, printCommandError, registerEventActor, renumberPjrItem, repoRelativePathspec, resolveRegisterPaths, runRegisterMutation, validBuildScopes, writeDerivedViews, } = dependencies;
@@ -72,8 +72,8 @@ export function registerMaintenanceCommands(reg, dependencies) {
72
72
  });
73
73
  // --- build ---
74
74
  const buildCmd = reg
75
- .command("build")
76
- .description("Generate the register list and derived views from register item files");
75
+ .command("build", { hidden: true })
76
+ .description("Internal compatibility entry for build --only register");
77
77
  addProjectOption(buildCmd);
78
78
  buildCmd.option("--scope <scope>", "Generation scope: register | controls | all", "all");
79
79
  buildCmd.option("--dry-run", "Print generated content without writing", false);
@@ -102,6 +102,9 @@ export function registerMaintenanceCommands(reg, dependencies) {
102
102
  ...eventErrors,
103
103
  ].join("\n")}`);
104
104
  }
105
+ for (const warning of registerEpicDateWarnings(paths)) {
106
+ process.stderr.write(`Warning: ${warning}\n`);
107
+ }
105
108
  const views = generateDerivedViewFiles(paths, scope);
106
109
  if (opts.dryRun) {
107
110
  for (const view of views) {
@@ -1,7 +1,6 @@
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";
1
+ import { resolve } from "node:path";
2
+ import { loadRegisterItemDocs } from "./item.js";
3
+ import { getProjectCatalogPath, getProjectRegisterPath, } from "../shared/specdojo-config.js";
5
4
  export function isPlanningApproach(approach) {
6
5
  return approach === "catalog-planning" || approach === "strategy-planning";
7
6
  }
@@ -23,15 +22,9 @@ export function validatePlanningTarget(opts) {
23
22
  if (!opts.project.schedule_path?.trim()) {
24
23
  throw new Error('Approach "strategy-planning" requires schedule_path');
25
24
  }
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")}`);
25
+ const path = getProjectRegisterPath(opts.project);
26
+ const epics = path ? loadRegisterItemDocs(resolve(opts.repoRoot, path)) : [];
27
+ if (!epics.some((doc) => doc.item.type === "epic" && doc.item.track === unit)) {
28
+ throw new Error(`Undefined strategy track "${unit}": create an epic governing this track first`);
36
29
  }
37
30
  }
@@ -1,7 +1,8 @@
1
1
  import { existsSync, readFileSync } from "node:fs";
2
2
  import { relative, sep } from "node:path";
3
+ import { setImmediate } from "node:timers/promises";
3
4
  import { CrossProcessMutex } from "../shared/cross-process-lock.js";
4
- import { gitOutput, gitResult, repoRelative, stageCommitTargets, unstageCommitTargets, worktreeStatusPaths, } from "../shared/git.js";
5
+ import { gitOutput, gitResult, repoRelative, restoreIndexAfterPathspecCommit, stageCommitTargets, unstageCommitTargets, worktreeStatusPaths, } from "../shared/git.js";
5
6
  import { inlineCodeAnglePlaceholders } from "../shared/text.js";
6
7
  import { atomicWriteFile, buildRegisterItemContent, derivedTopicNeedsWarning, generatePjrId, printDerivedTopicWarning, registerEventActor, REGISTER_TOPIC_RE, resolveRegisterPaths, slugify, validateFields, } from "./core.js";
7
8
  import { registerCreateCommands, registerUpdateCommand } from "./create-commands.js";
@@ -59,8 +60,10 @@ function addProjectOption(cmd) {
59
60
  return cmd.option("--project <projectId>", "Project id in specdojo.config.json");
60
61
  }
61
62
  function assertRegisterItemCommitTargetsClean(context, view) {
62
- if (!view.ticketPath)
63
+ if (!view.ticketPath) {
64
+ context.assertCommitTargetsClean([context.paths.pjrIndexPath]);
63
65
  return;
66
+ }
64
67
  context.assertCommitTargetsClean([
65
68
  view.ticketPath,
66
69
  registerEventFilePath(context.paths.projectRegisterPath, view.id),
@@ -69,7 +72,20 @@ function assertRegisterItemCommitTargetsClean(context, view) {
69
72
  function addRegisterCommitOptions(cmd) {
70
73
  return cmd
71
74
  .option("--commit", "Take the register lifecycle lock, rebuild views, and commit only this command's changes", false)
72
- .option("-m, --message <message>", "Override the register commit message");
75
+ .option("-m, --message <message>", "Override the register commit message (repeatable; each value becomes a paragraph, as in git commit -m)", collectRegisterCommitMessage);
76
+ }
77
+ // commander は値付きオプションの繰り返しを最後の値で上書きする。`-m <subject> -m <body>` の
78
+ // subject が失われて body だけが commit message になり、commitlint に拒否されていた(PJR-Y3XS)。
79
+ function collectRegisterCommitMessage(value, previous) {
80
+ return [...(previous ?? []), value];
81
+ }
82
+ // git commit -m と同じく、空でない各値を段落として空行でつなぐ。
83
+ export function registerCommitMessageFromParagraphs(paragraphs) {
84
+ const text = (paragraphs ?? [])
85
+ .map((paragraph) => paragraph.trim())
86
+ .filter((paragraph) => paragraph !== "")
87
+ .join("\n\n");
88
+ return text === "" ? undefined : text;
73
89
  }
74
90
  const REGISTER_COMMIT_SUBJECT_MAX_LENGTH = 100;
75
91
  const REGISTER_COMMIT_STABILIZATION_ATTEMPTS = 3;
@@ -103,14 +119,34 @@ function isGeneratedRegisterPath(repoRoot, paths, path) {
103
119
  return (normalized === ".specdojo/doc-index.json" ||
104
120
  generatedPrefixes.some((prefix) => normalized.startsWith(prefix)));
105
121
  }
106
- function commitRegisterMutation(repoRoot, paths, command, result, preexisting, message) {
107
- const changed = worktreeStatusPaths(repoRoot).filter((path) => !preexisting.has(path) && !isGeneratedRegisterPath(repoRoot, paths, path));
122
+ async function commitRegisterMutation(repoRoot, paths, command, result, preexisting, targets, message) {
123
+ const changed = worktreeStatusPaths(repoRoot).filter((path) => targets.has(path) &&
124
+ !preexisting.has(path) &&
125
+ !isGeneratedRegisterPath(repoRoot, paths, path));
108
126
  if (changed.length === 0) {
109
127
  process.stdout.write(`No register changes to commit for ${result.id}.\n`);
110
128
  return;
111
129
  }
130
+ // spawnSync delays JS signal callbacks until Git returns. Yield before committing and after
131
+ // each commit so a pending interruption uses the same targeted rollback as a hook failure.
132
+ let interrupted;
133
+ const signals = ["SIGINT", "SIGTERM", "SIGHUP"];
134
+ const handlers = signals.map((signal) => {
135
+ const handler = () => {
136
+ interrupted = signal;
137
+ };
138
+ process.on(signal, handler);
139
+ return handler;
140
+ });
141
+ const checkInterruption = async () => {
142
+ await setImmediate();
143
+ if (interrupted)
144
+ throw new Error(`Register commit interrupted by ${interrupted}; staged changes rolled back.`);
145
+ };
146
+ let committed = false;
112
147
  try {
113
148
  stageCommitTargets(repoRoot, changed);
149
+ await checkInterruption();
114
150
  const staged = gitResult(repoRoot, ["diff", "--cached", "--quiet", "--", ...changed]);
115
151
  if (staged.status === 0) {
116
152
  process.stdout.write(`No register changes to commit for ${result.id}.\n`);
@@ -118,11 +154,14 @@ function commitRegisterMutation(repoRoot, paths, command, result, preexisting, m
118
154
  }
119
155
  if (staged.status !== 1)
120
156
  throw new Error("Failed to inspect staged register changes.");
121
- const commitMessage = message?.trim() || defaultRegisterCommitMessage(command, result);
122
- if (commitMessage === "")
123
- throw new Error("Register commit message must not be empty");
157
+ const commitMessage = registerCommitMessageFromParagraphs(message) ?? defaultRegisterCommitMessage(command, result);
124
158
  // --only は初回・amend とも指定し、開始前からある staged 変更を混ぜない。
125
159
  gitOutput(repoRoot, ["commit", "--only", "-m", commitMessage, "--", ...changed]);
160
+ committed = true;
161
+ // hook の整形は一時 index にだけ入る。HEAD と一致した対象を index でも HEAD へ戻し、
162
+ // 整形前の内容を staged のまま残さない(PJR-Y3XS)。
163
+ restoreIndexAfterPathspecCommit(repoRoot, changed);
164
+ await checkInterruption();
126
165
  for (let attempt = 0; attempt < REGISTER_COMMIT_STABILIZATION_ATTEMPTS; attempt++) {
127
166
  const remaining = worktreeStatusPaths(repoRoot).filter((path) => changed.includes(path));
128
167
  if (remaining.length === 0) {
@@ -131,7 +170,10 @@ function commitRegisterMutation(repoRoot, paths, command, result, preexisting, m
131
170
  return;
132
171
  }
133
172
  stageCommitTargets(repoRoot, remaining);
173
+ await checkInterruption();
134
174
  gitOutput(repoRoot, ["commit", "--only", "--amend", "--no-edit", "--", ...remaining]);
175
+ restoreIndexAfterPathspecCommit(repoRoot, remaining);
176
+ await checkInterruption();
135
177
  }
136
178
  const remaining = worktreeStatusPaths(repoRoot).filter((path) => changed.includes(path));
137
179
  if (remaining.length === 0) {
@@ -145,10 +187,21 @@ function commitRegisterMutation(repoRoot, paths, command, result, preexisting, m
145
187
  catch (error) {
146
188
  // changed は開始前に clean だった対象だけ。本文を残して、自分の stage だけを戻す。
147
189
  unstageCommitTargets(repoRoot, changed);
148
- throw error;
190
+ await setImmediate();
191
+ if (committed)
192
+ throw error;
193
+ // 記帳は作業ツリーに残り commit だけが無い。最後の行に結果が出るよう、原因の後に状態を書く。
194
+ const cause = error instanceof Error ? error.message : String(error);
195
+ throw new Error(`Register commit failed for ${result.id}: ${cause}\n` +
196
+ `The register changes were written but not committed:\n` +
197
+ changed.map((path) => ` ${path}`).join("\n"), { cause: error });
198
+ }
199
+ finally {
200
+ signals.forEach((signal, index) => process.removeListener(signal, handlers[index]));
149
201
  }
150
202
  }
151
- async function runRegisterMutationInCurrentWorktree(command, opts, mutate, requireCleanRegister) {
203
+ // Throws on failure so composite commands can stop before the next lifecycle step.
204
+ export async function runRegisterMutationInCurrentWorktree(command, opts, mutate, requireCleanRegister = false) {
152
205
  const paths = resolveRegisterPaths(opts);
153
206
  if (!opts.commit || opts.dryRun) {
154
207
  mutate({ paths, assertCommitTargetsClean: () => undefined });
@@ -164,8 +217,9 @@ async function runRegisterMutationInCurrentWorktree(command, opts, mutate, requi
164
217
  }, {
165
218
  onWait: () => process.stdout.write("Waiting for the register lifecycle lock held by another operation\n"),
166
219
  });
167
- await mutex.runExclusive(() => {
220
+ await mutex.runExclusive(async () => {
168
221
  const preexisting = new Set(worktreeStatusPaths(repoRoot));
222
+ const commitTargets = new Set();
169
223
  if (requireCleanRegister) {
170
224
  const registerPrefix = `${repoRelative(repoRoot, paths.projectRegisterPath)}/`;
171
225
  const dirtyRegisterPaths = [...preexisting].filter((path) => path === registerPrefix.slice(0, -1) || path.startsWith(registerPrefix));
@@ -174,18 +228,22 @@ async function runRegisterMutationInCurrentWorktree(command, opts, mutate, requi
174
228
  dirtyRegisterPaths.map((path) => ` ${path}`).join("\n"));
175
229
  }
176
230
  }
231
+ // These paths are declared by add/update/transition/rename before they write. A repository
232
+ // status delta also contains files created by concurrent schedule processes, so it is not
233
+ // an ownership boundary for this commit.
177
234
  const assertCommitTargetsClean = (targets) => {
178
- const overlapping = targets
179
- .map((target) => repoRelative(repoRoot, target))
180
- .filter((target) => preexisting.has(target));
181
- if (overlapping.length === 0)
235
+ const relativeTargets = targets.map((target) => repoRelative(repoRoot, target));
236
+ const overlapping = relativeTargets.filter((target) => preexisting.has(target));
237
+ if (overlapping.length === 0) {
238
+ relativeTargets.forEach((target) => commitTargets.add(target));
182
239
  return;
240
+ }
183
241
  throw new Error(`Cannot use --commit because register targets already have uncommitted changes:\n` +
184
242
  overlapping.map((path) => ` ${path}`).join("\n"));
185
243
  };
186
244
  const result = mutate({ paths, assertCommitTargetsClean });
187
245
  rebuildRegisterViews(paths);
188
- commitRegisterMutation(repoRoot, paths, command, result, preexisting, opts.message);
246
+ await commitRegisterMutation(repoRoot, paths, command, result, preexisting, commitTargets, opts.message);
189
247
  });
190
248
  }
191
249
  async function runRegisterMutation(command, opts, mutate) {
@@ -0,0 +1,34 @@
1
+ import { existsSync } from "node:fs";
2
+ import { join, resolve } from "node:path";
3
+ import { loadRegisterItemDocs } from "./item.js";
4
+ import { readYaml } from "../shared/fs.js";
5
+ import { loadTimelineIndex } from "../shared/timeline-index.js";
6
+ export function resolveTrackDomains(opts) {
7
+ const legacyPath = join(opts.timelinePath, "tml-index.yaml");
8
+ const legacy = existsSync(legacyPath) ? loadTimelineIndex(legacyPath) : undefined;
9
+ const scope = opts.existingStrategy?.scope;
10
+ if (Array.isArray(scope?.catalogs)) {
11
+ const domains = scope.catalogs.flatMap((entry) => {
12
+ if (!entry || typeof entry !== "object" || typeof entry.path !== "string")
13
+ return [];
14
+ const path = resolve(opts.repoRoot ?? ".", entry.path.replace(/^\//, ""));
15
+ const doc = existsSync(path) ? readYaml(path) : null;
16
+ const domain = doc?.domain ?? entry.id?.split(":dct-")[1] ?? entry.path.match(/dct-(.+)\.ya?ml$/)?.[1];
17
+ return domain ? [domain] : [];
18
+ });
19
+ return { domains: [...new Set(domains)], source: "strategy", errors: [] };
20
+ }
21
+ const items = opts.registerItems ??
22
+ (opts.registerPath ? loadRegisterItemDocs(opts.registerPath).map((doc) => doc.item) : []);
23
+ const epics = items.filter((item) => item.type === "epic" && item.track === opts.track);
24
+ if (epics.length > 1)
25
+ return { domains: [], source: "epic", errors: [`Duplicate epic track "${opts.track}"`] };
26
+ if (epics[0]?.domains !== undefined) {
27
+ return { domains: epics[0].domains, source: "epic", errors: [] };
28
+ }
29
+ return {
30
+ domains: legacy?.index.tracks.find((entry) => entry.track === opts.track)?.domains ?? [],
31
+ source: "timeline",
32
+ errors: legacy?.errors ?? [],
33
+ };
34
+ }
@@ -0,0 +1,78 @@
1
+ import { existsSync, readdirSync } from "node:fs";
2
+ import { join } from "node:path";
3
+ import { epicPredecessors, orderEpics } from "./epic.js";
4
+ import { loadRegisterItemDocs } from "./item.js";
5
+ import { readYaml } from "../shared/fs.js";
6
+ import { loadTimelineIndex } from "../shared/timeline-index.js";
7
+ import { resolveTrackDomains } from "./track-domains.js";
8
+ /** Epic order and domains supersede legacy plans; legacy-only tracks remain readable. */
9
+ export function loadTrackPlan(opts) {
10
+ const file = join(opts.timelinePath, "tml-index.yaml");
11
+ const loaded = existsSync(file)
12
+ ? loadTimelineIndex(file)
13
+ : {
14
+ index: {
15
+ id: "",
16
+ project_id: opts.projectId ?? "",
17
+ status: "draft",
18
+ tracks: [],
19
+ },
20
+ errors: [],
21
+ };
22
+ const items = opts.registerPath
23
+ ? loadRegisterItemDocs(opts.registerPath).map((doc) => doc.item)
24
+ : [];
25
+ const epics = orderEpics(items, loaded.index.project_id);
26
+ if (epics.length === 0 && !existsSync(file) && !opts.registerPath && !opts.schedulePath) {
27
+ throw new Error(`Timeline index not found: ${file}`);
28
+ }
29
+ const byId = new Map(epics.map((item) => [item.id, item]));
30
+ const depth = new Map();
31
+ for (const item of epics) {
32
+ const predecessors = epicPredecessors(item, loaded.index.project_id, byId);
33
+ const order = 1 + Math.max(0, ...predecessors.map((p) => depth.get(p.id) ?? 0));
34
+ depth.set(item.id, order);
35
+ const previous = loaded.index.tracks.find((track) => track.track === item.track);
36
+ const plan = {
37
+ ...previous,
38
+ track: item.track,
39
+ domains: item.domains ?? previous?.domains ?? [],
40
+ catalog_status: previous?.catalog_status ?? "not_started",
41
+ order,
42
+ depends_on: predecessors.map((p) => p.track),
43
+ };
44
+ loaded.index.tracks = loaded.index.tracks.filter((track) => track.track !== item.track);
45
+ loaded.index.tracks.push(plan);
46
+ }
47
+ if (opts.schedulePath && existsSync(opts.schedulePath)) {
48
+ for (const name of readdirSync(opts.schedulePath).filter((name) => /^sch-strategy-.+\.yaml$/.test(name))) {
49
+ const doc = readYaml(join(opts.schedulePath, name));
50
+ if (doc?.track && !loaded.index.tracks.some((entry) => entry.track === doc.track)) {
51
+ loaded.index.tracks.push({
52
+ track: doc.track,
53
+ domains: [],
54
+ catalog_status: "not_started",
55
+ order: 1,
56
+ depends_on: [],
57
+ });
58
+ }
59
+ }
60
+ }
61
+ for (const track of loaded.index.tracks) {
62
+ const strategyPath = opts.schedulePath
63
+ ? join(opts.schedulePath, `sch-strategy-${track.track}.yaml`)
64
+ : undefined;
65
+ const existingStrategy = strategyPath && existsSync(strategyPath)
66
+ ? readYaml(strategyPath)
67
+ : undefined;
68
+ const resolved = resolveTrackDomains({
69
+ ...opts,
70
+ registerItems: items,
71
+ track: track.track,
72
+ existingStrategy,
73
+ });
74
+ track.domains = resolved.domains;
75
+ loaded.errors.push(...resolved.errors);
76
+ }
77
+ return loaded;
78
+ }
@@ -1,6 +1,8 @@
1
+ import { readFileSync } from "node:fs";
1
2
  import { inlineCodeAnglePlaceholders } from "../shared/text.js";
2
3
  import { nowUtcTimestamp } from "./date.js";
3
4
  import { CELL_NONE } from "./item.js";
5
+ import { registerWorkTableIssueMessage, registerWorkTableIssues } from "./work-table.js";
4
6
  export function registerTransitionCommands(reg, dependencies) {
5
7
  const { addProjectOption, addRegisterCommitOptions, applyItemUpdate, assertRegisterItemCommitTargetsClean, assertTerminalOperationAllowed, loadItemForUpdate, parseRegisterTimestampOption, registerEventActor, runRegisterMutation, updateTicketStatusForItem, } = dependencies;
6
8
  // --- close ---
@@ -20,6 +22,12 @@ export function registerTransitionCommands(reg, dependencies) {
20
22
  const view = loadItemForUpdate(paths, opts.id, "require-active");
21
23
  const item = view.item;
22
24
  assertTerminalOperationAllowed(item, "close");
25
+ if (view.ticketPath) {
26
+ const issues = registerWorkTableIssues(readFileSync(view.ticketPath, "utf8"));
27
+ if (issues.length > 0) {
28
+ throw new Error(`Cannot close ${item.id}: ${registerWorkTableIssueMessage(item.id, issues)}`);
29
+ }
30
+ }
23
31
  assertRegisterItemCommitTargetsClean(context, view);
24
32
  const targetStatus = opts.status ?? (["decision", "question"].includes(item.type) ? "decided" : "done");
25
33
  if (targetStatus !== "done" && targetStatus !== "decided") {