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
@@ -0,0 +1,62 @@
1
+ import { existsSync, readFileSync } from "node:fs";
2
+ import { isRecord, isRoutineEntryDue, } from "./definition.js";
3
+ // routine status が読む履歴。壊れた行は読み飛ばし、状態の表示を止めない(検証は dashboard 側)。
4
+ export function readRoutineHistoryLenient(runsPath) {
5
+ if (!existsSync(runsPath))
6
+ return [];
7
+ const entries = [];
8
+ for (const line of readFileSync(runsPath, "utf8").split(/\r?\n/)) {
9
+ if (!line.trim())
10
+ continue;
11
+ let value;
12
+ try {
13
+ value = JSON.parse(line);
14
+ }
15
+ catch {
16
+ continue;
17
+ }
18
+ if (isRecord(value) &&
19
+ typeof value.routine_id === "string" &&
20
+ typeof value.scheduled_for === "string" &&
21
+ typeof value.started_at === "string" &&
22
+ typeof value.result === "string") {
23
+ entries.push(value);
24
+ }
25
+ }
26
+ return entries;
27
+ }
28
+ function formatHistoryEntry(entry) {
29
+ const details = [
30
+ entry.skip_reason,
31
+ entry.retry_pending ? "retry pending" : undefined,
32
+ entry.reason,
33
+ ].filter((item) => typeof item === "string" && item.length > 0);
34
+ const suffix = details.length ? ` (${details.join(", ")})` : "";
35
+ return ` ${entry.started_at} scheduled_for=${entry.scheduled_for} ${entry.result}${suffix}`;
36
+ }
37
+ /**
38
+ * 1 routine ぶんの状態を行の配列で返す。busy skip の流し直し待ちは `busy skips` 行で示し、
39
+ * 直近の履歴には skip の内訳(busy / precondition)と流し直し待ちを添える。
40
+ */
41
+ export function formatRoutineStatus(doc, entry, history, now, limit) {
42
+ const enabled = doc.enabled !== false;
43
+ const lines = [
44
+ `${doc.id}${doc.name ? ` ${doc.name}` : ""}`,
45
+ ` schedule: ${doc.interval ?? (doc.trigger ? `cron ${doc.trigger.cron} (${doc.trigger.timezone})` : "-")}${doc.policy?.missed_run ? ` missed_run=${doc.policy.missed_run}` : ""}`,
46
+ ` enabled: ${enabled ? "yes" : "no"}`,
47
+ ` due: ${enabled && isRoutineEntryDue(doc, entry, now) ? "due" : "-"}`,
48
+ ` last run: ${entry?.last_run ? `${entry.last_run} (${entry.last_result ?? "-"}${entry.last_skip_reason ? `, ${entry.last_skip_reason}` : ""})` : "-"}`,
49
+ ];
50
+ if (doc.trigger)
51
+ lines.push(` scheduled to: ${entry?.last_scheduled_for ?? "-"}`);
52
+ if (entry?.last_reason)
53
+ lines.push(` last reason: ${entry.last_reason}`);
54
+ if ((entry?.busy_skip_count ?? 0) > 0) {
55
+ lines.push(` busy skips: ${entry?.busy_skip_count} (retried on the next routine run --due)`);
56
+ }
57
+ const recent = history.filter((item) => item.routine_id === doc.id).slice(-limit);
58
+ lines.push(` recent runs:${recent.length ? "" : " -"}`);
59
+ for (const item of recent)
60
+ lines.push(formatHistoryEntry(item));
61
+ return lines;
62
+ }
@@ -0,0 +1,33 @@
1
+ import { constants, copyFileSync, existsSync, mkdirSync } from "node:fs";
2
+ import { createHash } from "node:crypto";
3
+ import { join, relative, resolve } from "node:path";
4
+ import { localStateDirectory } from "../shared/local-state.js";
5
+ import { specdojoRootDir } from "../shared/specdojo-config.js";
6
+ export function routineStoragePaths(routinesPath, repoRoot = specdojoRootDir()) {
7
+ const key = createHash("sha256").update(relative(repoRoot, routinesPath)).digest("hex");
8
+ const stateDirectory = join(localStateDirectory(repoRoot), "routines", key);
9
+ return {
10
+ stateDirectory,
11
+ statePath: join(stateDirectory, "routine-state.json"),
12
+ runsPath: join(stateDirectory, "routine-runs.jsonl"),
13
+ lockPath: join(stateDirectory, ".locks", "routine-run.lock"),
14
+ };
15
+ }
16
+ /** Copy once, preserving the old files for rollback and never overwriting newer state. */
17
+ export function migrateRoutineStorage(routinesPath, repoRoot = specdojoRootDir()) {
18
+ const paths = routineStoragePaths(routinesPath, repoRoot);
19
+ for (const destination of [paths.statePath, paths.runsPath]) {
20
+ const source = join(routinesPath, "generated", destination === paths.statePath ? "routine-state.json" : "routine-runs.jsonl");
21
+ if (!existsSync(source) || existsSync(destination))
22
+ continue;
23
+ mkdirSync(resolve(destination, ".."), { recursive: true });
24
+ try {
25
+ copyFileSync(source, destination, constants.COPYFILE_EXCL);
26
+ }
27
+ catch (error) {
28
+ if (error.code !== "EEXIST")
29
+ throw error;
30
+ }
31
+ }
32
+ return paths;
33
+ }
@@ -1,3 +1,4 @@
1
+ import { registerDeprecatedWhereAlias } from "../shared/where-alias.js";
1
2
  import { dirname, join, relative, resolve, sep } from "node:path";
2
3
  import { existsSync, readdirSync, writeFileSync } from "node:fs";
3
4
  import { dump } from "../shared/yaml.js";
@@ -289,6 +290,7 @@ function registerScheduleStrategyCommands(sch) {
289
290
  schedulePath: context.schedulePath,
290
291
  track,
291
292
  content: result.content,
293
+ repoRoot: context.baseDir,
292
294
  force: !!opts.force,
293
295
  dryRun: !!opts.dryRun,
294
296
  });
@@ -315,48 +317,46 @@ function registerScheduleStrategyCommands(sch) {
315
317
  }
316
318
  });
317
319
  }
318
- export function registerScheduleCommands(program) {
319
- const sch = program.command("schedule").description("Schedule build commands");
320
- // --- where ---
321
- const wcmd = sch.command("where").description("Print resolved schedule paths and file list");
322
- addProjectOption(wcmd);
323
- wcmd.action((opts) => {
324
- try {
325
- const { schedulePath } = resolveSchedulePath(opts);
326
- process.stdout.write(`schedule-path: ${schedulePath}\n`);
327
- if (!existsSync(schedulePath)) {
328
- process.stdout.write(`(path does not exist)\n`);
329
- return;
330
- }
331
- const files = readdirSync(schedulePath)
332
- .filter((f) => /^sch-.+\.yaml$/.test(f))
333
- .sort();
334
- const strategyFiles = files.filter((f) => f.startsWith("sch-strategy-"));
335
- const trackFiles = files.filter((f) => f.startsWith("sch-track-"));
336
- process.stdout.write(`strategy-files:\n`);
337
- if (strategyFiles.length === 0) {
338
- process.stdout.write(` (none)\n`);
339
- }
340
- else {
341
- for (const f of strategyFiles)
342
- process.stdout.write(` - ${f}\n`);
343
- }
344
- process.stdout.write(`track-files:\n`);
345
- if (trackFiles.length === 0) {
346
- process.stdout.write(` (none)\n`);
347
- }
348
- else {
349
- for (const f of trackFiles)
350
- process.stdout.write(` - ${f}\n`);
351
- }
320
+ export function printSchedulePaths(opts) {
321
+ try {
322
+ const { schedulePath } = resolveSchedulePath(opts);
323
+ process.stdout.write(`schedule-path: ${schedulePath}\n`);
324
+ if (!existsSync(schedulePath)) {
325
+ process.stdout.write(`(path does not exist)\n`);
326
+ return;
352
327
  }
353
- catch (error) {
354
- printCommandError(error);
328
+ const files = readdirSync(schedulePath)
329
+ .filter((f) => /^sch-.+\.yaml$/.test(f))
330
+ .sort();
331
+ const strategyFiles = files.filter((f) => f.startsWith("sch-strategy-"));
332
+ const trackFiles = files.filter((f) => f.startsWith("sch-track-"));
333
+ process.stdout.write(`strategy-files:\n`);
334
+ if (strategyFiles.length === 0) {
335
+ process.stdout.write(` (none)\n`);
355
336
  }
356
- });
337
+ else {
338
+ for (const f of strategyFiles)
339
+ process.stdout.write(` - ${f}\n`);
340
+ }
341
+ process.stdout.write(`track-files:\n`);
342
+ if (trackFiles.length === 0) {
343
+ process.stdout.write(` (none)\n`);
344
+ }
345
+ else {
346
+ for (const f of trackFiles)
347
+ process.stdout.write(` - ${f}\n`);
348
+ }
349
+ }
350
+ catch (error) {
351
+ printCommandError(error);
352
+ }
353
+ }
354
+ export function registerScheduleCommands(program) {
355
+ const sch = program.command("schedule").description("Schedule build commands");
356
+ registerDeprecatedWhereAlias(sch, printSchedulePaths);
357
357
  const bcmd = sch
358
- .command("build")
359
- .description("Build sch-track-<track>.yaml from sch-strategy-<track>.yaml and catalogs");
358
+ .command("build", { hidden: true })
359
+ .description("Internal compatibility entry for build --only schedule");
360
360
  addProjectOption(bcmd);
361
361
  bcmd.requiredOption("--track <track>", "Track name (e.g. launch)");
362
362
  bcmd.option("--force", "Overwrite existing sch-track-<track>.yaml", false);
@@ -1,7 +1,7 @@
1
1
  import { AUTHOR_PHASE_SETS, PHASE_SET_ORDER, profileFor, renderPhase, STRATEGY_PHASE_SETS, } from "./strategy-profiles.js";
2
2
  import { artifactNameFromCatalogTitle, } from "./strategy-generate-scope.js";
3
- function phaseSetsOf(approach) {
4
- return profileFor(approach).phase_sets;
3
+ function phaseSetsOf(deliverable) {
4
+ return profileFor(deliverable.approach).phase_sets.filter((name) => !deliverable.not_needed_kata?.some((kind) => name === `${kind}-maintenance-pass`));
5
5
  }
6
6
  function orderPhaseSets(names) {
7
7
  const unique = [...new Set(names)];
@@ -38,7 +38,7 @@ export function buildStrategyDocument(input) {
38
38
  return false;
39
39
  });
40
40
  const sorted = [...eligibleDeliverables].sort((left, right) => left.local_id.localeCompare(right.local_id));
41
- // --- owner_rules: one rule per (owner, approach) pair -------------------------
41
+ // Group by the effective sequence too: the same approach can omit different not-needed Kata.
42
42
  const groups = new Map();
43
43
  for (const deliverable of sorted) {
44
44
  const owner = input.owners.get(deliverable.local_id);
@@ -46,22 +46,34 @@ export function buildStrategyDocument(input) {
46
46
  errors.push(`${deliverable.local_id}: owner が解決できていない。`);
47
47
  continue;
48
48
  }
49
- const key = JSON.stringify([owner, deliverable.approach]);
50
- const group = groups.get(key) ?? { owner, approach: deliverable.approach, localIds: [] };
49
+ const sequence = phaseSetsOf(deliverable);
50
+ const key = JSON.stringify([owner, deliverable.approach, sequence]);
51
+ const group = groups.get(key) ?? {
52
+ owner,
53
+ approach: deliverable.approach,
54
+ sequence,
55
+ localIds: [],
56
+ };
51
57
  group.localIds.push(deliverable.local_id);
52
58
  groups.set(key, group);
53
59
  }
54
60
  const orderedGroups = [...groups.values()].sort((left, right) => left.owner === right.owner
55
- ? left.approach.localeCompare(right.approach)
61
+ ? left.approach.localeCompare(right.approach) ||
62
+ left.sequence.join(",").localeCompare(right.sequence.join(","))
56
63
  : left.owner.localeCompare(right.owner));
57
64
  // The most common profile becomes default_phase_sets so rules that follow it stay compact.
58
- const byApproach = new Map();
65
+ const bySequence = new Map();
59
66
  for (const deliverable of sorted) {
60
- byApproach.set(deliverable.approach, (byApproach.get(deliverable.approach) ?? 0) + 1);
67
+ const sequence = phaseSetsOf(deliverable);
68
+ const key = JSON.stringify(sequence);
69
+ const entry = bySequence.get(key) ?? { sequence, count: 0 };
70
+ entry.count++;
71
+ bySequence.set(key, entry);
61
72
  }
62
- const defaultApproach = [...byApproach.entries()].sort((left, right) => right[1] === left[1] ? left[0].localeCompare(right[0]) : right[1] - left[1])[0]?.[0];
63
- const defaultSequence = defaultApproach ? phaseSetsOf(defaultApproach) : [];
64
- const usedPhaseSets = orderPhaseSets(sorted.flatMap((d) => phaseSetsOf(d.approach)));
73
+ const defaultSequence = [...bySequence.entries()].sort((left, right) => right[1].count === left[1].count
74
+ ? left[0].localeCompare(right[0])
75
+ : right[1].count - left[1].count)[0]?.[1].sequence ?? [];
76
+ const usedPhaseSets = orderPhaseSets(sorted.flatMap(phaseSetsOf));
65
77
  const phaseSets = {};
66
78
  for (const name of usedPhaseSets) {
67
79
  const definition = STRATEGY_PHASE_SETS[name];
@@ -72,7 +84,7 @@ export function buildStrategyDocument(input) {
72
84
  phaseSets[name] = definition.map(renderPhase);
73
85
  }
74
86
  const ownerRules = orderedGroups.map((group) => {
75
- const sequence = phaseSetsOf(group.approach);
87
+ const sequence = group.sequence;
76
88
  const sameAsDefault = sequence.length === defaultSequence.length &&
77
89
  sequence.every((name, index) => name === defaultSequence[index]);
78
90
  const finalizeApproach = profileFor(group.approach).finalize_approach;
@@ -86,7 +98,7 @@ export function buildStrategyDocument(input) {
86
98
  };
87
99
  });
88
100
  // --- phase gates -------------------------------------------------------------
89
- const countUsing = (phaseSetName) => sorted.filter((d) => phaseSetsOf(d.approach).includes(phaseSetName)).length;
101
+ const countUsing = (phaseSetName) => sorted.filter((d) => phaseSetsOf(d).includes(phaseSetName)).length;
90
102
  const authorPhaseSets = orderPhaseSets(usedPhaseSets.filter((name) => AUTHOR_PHASE_SETS.includes(name)));
91
103
  const catalogScope = { catalogs: input.catalogs.map((catalog) => catalog.id) };
92
104
  const artifactName = input.catalogs.length === 1 ? artifactNameFromCatalogTitle(input.catalogs[0].title) : undefined;
@@ -94,7 +106,7 @@ export function buildStrategyDocument(input) {
94
106
  const dedupLocalIds = sorted
95
107
  .filter((d) => d.approach === "cross-deliverable-dedup")
96
108
  .map((d) => d.local_id);
97
- const authorPassDeliverables = sorted.filter((d) => phaseSetsOf(d.approach).some((name) => AUTHOR_PHASE_SETS.includes(name))).length;
109
+ const authorPassDeliverables = sorted.filter((d) => phaseSetsOf(d).some((name) => AUTHOR_PHASE_SETS.includes(name))).length;
98
110
  const firstPassGateId = `G-${trackUpper}-first-pass`;
99
111
  const gates = [];
100
112
  const needsFirstPassGate = authorPhaseSets.length > 0 && (authorPassDeliverables >= 2 || dedupLocalIds.length >= 2);
@@ -1,11 +1,10 @@
1
1
  import { existsSync } from "node:fs";
2
- import { basename, join, relative, resolve } from "node:path";
2
+ import { relative, resolve } from "node:path";
3
3
  import { collectResolvedDeliverables } from "../catalog/build.js";
4
4
  import { resolveBasePath } from "../catalog/paths.js";
5
5
  import { collectCatalogFilesByDomain } from "../shared/catalog-files.js";
6
6
  import { readYaml } from "../shared/fs.js";
7
- import { loadTimelineIndex } from "../shared/timeline-index.js";
8
- import { resolveTimelineCatalogStatus } from "../register/catalog-status.js";
7
+ import { resolveTrackDomains } from "../register/track-domains.js";
9
8
  export function isRecord(value) {
10
9
  return typeof value === "object" && value !== null && !Array.isArray(value);
11
10
  }
@@ -20,10 +19,10 @@ export function artifactNameFromCatalogTitle(title) {
20
19
  return match ? match[1] : undefined;
21
20
  }
22
21
  // Resolves the catalogs a track covers. An existing strategy is authoritative (a human may have
23
- // narrowed the scope on purpose); otherwise the Timeline track plan decides which domains belong
22
+ // narrowed the scope on purpose); otherwise epic domains, then the legacy track plan decide what belongs
24
23
  // to the track, and every catalog file of those domains (including physical splits) is included.
25
24
  export function resolveTrackScopeCatalogs(opts) {
26
- const { repoRoot, catalogPath, timelinePath, track } = opts;
25
+ const { repoRoot, catalogPath, track } = opts;
27
26
  const warnings = [];
28
27
  const errors = [];
29
28
  const byDomain = collectCatalogFilesByDomain(catalogPath);
@@ -41,44 +40,24 @@ export function resolveTrackScopeCatalogs(opts) {
41
40
  ...(doc.title ? { title: doc.title } : {}),
42
41
  };
43
42
  };
43
+ const resolved = resolveTrackDomains(opts);
44
+ errors.push(...resolved.errors);
44
45
  const timelineCatalogs = [];
45
- const indexFile = join(timelinePath, "tml-index.yaml");
46
- if (existsSync(indexFile)) {
47
- const { index, errors: loadErrors } = loadTimelineIndex(indexFile);
48
- const derived = resolveTimelineCatalogStatus(index.tracks, opts.registerPath);
49
- index.tracks = derived.tracks;
50
- warnings.push(...derived.warnings);
51
- if (loadErrors.length > 0) {
52
- warnings.push(`${basename(indexFile)}: ${loadErrors.join(" / ")}`);
53
- }
54
- const plan = index.tracks.find((entry) => entry.track === track);
55
- if (plan) {
56
- for (const domain of plan.domains) {
57
- const files = byDomain.get(domain) ?? [];
58
- if (files.length === 0) {
59
- warnings.push(`timeline: track '${track}' の domain '${domain}' に対応する dct-*.yaml が無い(scope から除外)。`);
60
- continue;
61
- }
62
- for (const filePath of files) {
63
- const ref = refFor(filePath);
64
- if (ref)
65
- timelineCatalogs.push(ref);
66
- }
67
- }
68
- if (plan.catalog_status !== "primary") {
69
- warnings.push(`timeline: track '${track}' の catalog_status は '${plan.catalog_status}'。` +
70
- `カタログ作成 todo の完了を確認して timeline build を実行する。todo がない domain は手書きの計画値を使う。`);
71
- }
72
- }
73
- else {
74
- warnings.push(`timeline: track '${track}' が tml-index.yaml に無い。`);
46
+ for (const domain of resolved.source === "strategy" ? [] : resolved.domains) {
47
+ const files = byDomain.get(domain) ?? [];
48
+ if (files.length === 0)
49
+ warnings.push(`${resolved.source}: track '${track}' の domain '${domain}' に対応する dct-*.yaml が無い(scope から除外)。`);
50
+ for (const filePath of files) {
51
+ const ref = refFor(filePath);
52
+ if (ref)
53
+ timelineCatalogs.push(ref);
75
54
  }
76
55
  }
77
56
  const existingScope = isRecord(opts.existingStrategy?.scope)
78
57
  ? opts.existingStrategy.scope
79
58
  : undefined;
80
59
  const existingCatalogs = Array.isArray(existingScope?.catalogs) ? existingScope.catalogs : [];
81
- if (existingCatalogs.length > 0) {
60
+ if (Array.isArray(existingScope?.catalogs)) {
82
61
  const catalogs = [];
83
62
  for (const entry of existingCatalogs) {
84
63
  if (!isRecord(entry) || typeof entry.path !== "string")
@@ -103,20 +82,13 @@ export function resolveTrackScopeCatalogs(opts) {
103
82
  if (ref)
104
83
  catalogs.push(ref);
105
84
  }
106
- const known = new Set(catalogs.map((catalog) => catalog.id));
107
- for (const catalog of timelineCatalogs) {
108
- if (known.has(catalog.id))
109
- continue;
110
- warnings.push(`timeline の domain から解決した ${catalog.id} が既存 scope に無い。scope を広げる場合は ` +
111
- `sch-strategy-${track}.yaml の scope.catalogs を先に更新する。`);
112
- }
113
85
  return { catalogs, source: "strategy", warnings, errors };
114
86
  }
115
87
  if (timelineCatalogs.length === 0) {
116
- errors.push(`track '${track}' の scope を解決できない。tml-index.yaml の domains と ` +
88
+ errors.push(`track '${track}' の scope を解決できない。epic の domains と ` +
117
89
  `dct-<domain>.yaml を用意するか、既存 strategy の scope.catalogs を先に定義する。`);
118
90
  }
119
- return { catalogs: timelineCatalogs, source: "timeline", warnings, errors };
91
+ return { catalogs: timelineCatalogs, source: resolved.source, warnings, errors };
120
92
  }
121
93
  // Deliverables of the scoped catalogs, in catalog order. `include_kinds` mirrors the strategy
122
94
  // scope (work by default).
@@ -4,7 +4,7 @@
4
4
  // by code so `schedule build` and `exec refresh` stay deterministic.
5
5
  import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync, } from "node:fs";
6
6
  import { tmpdir } from "node:os";
7
- import { basename, join, resolve } from "node:path";
7
+ import { basename, dirname, join, relative, resolve, sep } from "node:path";
8
8
  import { dump, load as loadYaml } from "../shared/yaml.js";
9
9
  import { resolveSpecdojoPath } from "../docs/template-resolution.js";
10
10
  import Ajv2020Module from "ajv/dist/2020.js";
@@ -124,6 +124,30 @@ export function dryRunStrategy(opts) {
124
124
  rmSync(candidateDir, { recursive: true, force: true });
125
125
  }
126
126
  }
127
+ const YAML_SCHEMA_MODELINE_RE = /^#\s*yaml-language-server:\s+\$schema=\S+\s*$/;
128
+ function findSchemaModeline(content) {
129
+ for (const line of content.split(/\r?\n/)) {
130
+ if (line.trim() === "")
131
+ continue;
132
+ if (!line.startsWith("#"))
133
+ return undefined;
134
+ if (YAML_SCHEMA_MODELINE_RE.test(line))
135
+ return line;
136
+ }
137
+ return undefined;
138
+ }
139
+ // validate:schema は modeline から schema を解決するため、modeline の無い strategy は検証で失敗する。
140
+ // 書き出す内容に modeline が無ければ、既存ファイルの modeline を保ち、無ければ schema への相対参照を作る。
141
+ export function withStrategySchemaModeline(opts) {
142
+ if (findSchemaModeline(opts.content))
143
+ return opts.content;
144
+ const existing = findSchemaModeline(opts.current);
145
+ if (existing)
146
+ return `${existing}\n${opts.content}`;
147
+ const schemaPath = resolveSpecdojoPath(SCH_STRATEGY_SCHEMA_PATH, opts.repoRoot ? { repositoryRoot: opts.repoRoot } : {});
148
+ const schemaRef = relative(dirname(opts.path), schemaPath).split(sep).join("/");
149
+ return `# yaml-language-server: $schema=${schemaRef}\n${opts.content}`;
150
+ }
127
151
  export function strategyPathFor(schedulePath, track) {
128
152
  return join(schedulePath, `sch-strategy-${track}.yaml`);
129
153
  }
@@ -134,7 +158,13 @@ export function writeStrategyFile(opts) {
134
158
  const path = strategyPathFor(opts.schedulePath, opts.track);
135
159
  const exists = existsSync(path);
136
160
  const current = exists ? readFileSync(path, "utf8") : "";
137
- const diff = diffPlanText(current, opts.content);
161
+ const content = withStrategySchemaModeline({
162
+ path,
163
+ content: opts.content,
164
+ current,
165
+ ...(opts.repoRoot ? { repoRoot: opts.repoRoot } : {}),
166
+ });
167
+ const diff = diffPlanText(current, content);
138
168
  if (exists && diff.length === 0) {
139
169
  return { path, written: false, skippedReason: "unchanged", diff };
140
170
  }
@@ -147,7 +177,7 @@ export function writeStrategyFile(opts) {
147
177
  mkdirSync(opts.schedulePath, { recursive: true });
148
178
  const temporaryPath = join(opts.schedulePath, `.sch-strategy-${opts.track}.${process.pid}.tmp`);
149
179
  try {
150
- writeFileSync(temporaryPath, opts.content, "utf8");
180
+ writeFileSync(temporaryPath, content, "utf8");
151
181
  renameSync(temporaryPath, path);
152
182
  }
153
183
  finally {
@@ -4,18 +4,34 @@
4
4
  // the same phase ids, task suffixes, durations, modes and execution kinds.
5
5
  const EXPERT_PIPELINE = { executor: "expert", reporter: "normal" };
6
6
  const NORMAL_PIPELINE = { executor: "normal", reporter: "normal" };
7
+ // Shared authoring policy from the hand-maintained Kata strategies (T88P / kata-wave-1).
8
+ const KATA_AUTHORING_POLICY = "[[specdojo:rulebook-authoring-standard|Rulebook 記述標準]]の章立てに合わせ、" +
9
+ "rulebook に完成例の章を置かず sample へ外出しする。Markdown の第2〜第4階層の見出しに階層ごとの連番を付け、" +
10
+ "記述ガイドには章ごとの判断基準と良い例・悪い例を書く。sample は " +
11
+ "[[specdojo:clis-sample|CLI仕様の完成例]]程度の厚さとし、YAML は対象形式に合わせて内容を充実させる。" +
12
+ "recipe と template の要否を判断し、rulebook frontmatter に対応する ID または not-needed を宣言して理由を result に残す。" +
13
+ "実装・schema・リファレンスの値・構文・構造の詳細を再掲せず、正本を参照する。";
14
+ const MAINTENANCE_DETAILS = {
15
+ rulebook: "代表成果物の実績から rulebook の規則・判断基準を見直す。後続の段で recipe・sample・template を同期する。",
16
+ recipe: "改訂した rulebook に沿って recipe を同期する。問いと作成手順に責務を絞り、rulebook の規則を再定義しない。",
17
+ sample: "改訂した rulebook に沿って sample を完成例として手入れする。共通サンプル文脈を用い、" +
18
+ "代表成果物を単純に複写せず、判断に要る場面・例外を拾う。",
19
+ template: "改訂した rulebook に沿って template を同期する。骨組みに責務を絞り、" +
20
+ "必須の章・項目・表の列名を整合させ、説明や完成例を転載しない。",
21
+ };
7
22
  function maintenancePhase(kind) {
8
23
  return {
9
24
  id: `${kind}-maintenance`,
10
25
  name: `${kind} の見直し`,
11
- task_suffix: "040",
26
+ task_suffix: { rulebook: "040", recipe: "045", sample: "050", template: "060" }[kind],
12
27
  duration_days: 0.5,
13
28
  execution: "agent",
14
29
  mode: "edit",
15
30
  approach: `${kind}-maintenance`,
16
31
  pipeline: EXPERT_PIPELINE,
17
- description: `完成済みの成果物の実績から ${kind} を見直す。実際に書かれた内容と ${kind} の記述が食い違う箇所を洗い出し、` +
18
- `再現可能な規則として ${kind} 側へ反映する。成果物本体はこのフェーズで書き換えない。`,
32
+ description: MAINTENANCE_DETAILS[kind] +
33
+ "成果物本体はこの段で変更しない。実行時に対象が not-needed なら変更せず、その旨を result に記録して完了する。\n\n" +
34
+ KATA_AUTHORING_POLICY,
19
35
  };
20
36
  }
21
37
  // Named phase sets. Keys are the phase_set names written into the generated strategy.
@@ -32,7 +48,9 @@ export const STRATEGY_PHASE_SETS = {
32
48
  pipeline: EXPERT_PIPELINE,
33
49
  description: "実践の型の作成条件から要否を判断し、代表成果物と必要な rulebook / recipe / sample / template を" +
34
50
  "同じタスクで初期整備する。不要な3種は rulebook frontmatter へ not-needed と宣言し、必要な一式の構造・" +
35
- "用語・粒度を整合させる。判断できない前提は推測せず result に残す。",
51
+ "用語・粒度を整合させる。代表が既存なら型との整合に必要な範囲だけ直し、業務判断は確定しない。" +
52
+ "判断できない前提は推測せず result に残す。\n\n" +
53
+ KATA_AUTHORING_POLICY,
36
54
  },
37
55
  ],
38
56
  "retrofit-pass": [
@@ -124,6 +142,20 @@ export const STRATEGY_PHASE_SETS = {
124
142
  "沿った情報の受け渡しを確認し、不足や不整合だけを最小限修正して done_criteria を満たす状態へ整える。",
125
143
  },
126
144
  ],
145
+ "condense-pass": [
146
+ {
147
+ id: "condense",
148
+ name: "冗長さの整理",
149
+ task_suffix: "080",
150
+ duration_days: 0.25,
151
+ execution: "agent",
152
+ mode: "edit",
153
+ approach: "condense",
154
+ pipeline: NORMAL_PIPELINE,
155
+ description: "1 文書の冗長さを削る・まとめる・参照に置き換える。判断に要る背景・制約・例外・完了条件と意味を保ち、" +
156
+ "新しい内容を足さず、修正・保持した箇所と原因を result に記録する。",
157
+ },
158
+ ],
127
159
  "review-pass": [
128
160
  {
129
161
  id: "review",
@@ -180,6 +212,7 @@ export const PHASE_SET_ORDER = [
180
212
  "sample-maintenance-pass",
181
213
  "template-maintenance-pass",
182
214
  "refine-pass",
215
+ "condense-pass",
183
216
  "review-pass",
184
217
  "retrofit-review-pass",
185
218
  "finalize-pass",
@@ -202,37 +235,73 @@ export const AUTHOR_PHASE_SETS = [
202
235
  export const STRATEGY_PROFILES = {
203
236
  bootstrap: {
204
237
  approach: "bootstrap",
205
- phase_sets: ["bootstrap-pass", "refine-pass", "retrofit-review-pass", "finalize-pass"],
238
+ phase_sets: [
239
+ "bootstrap-pass",
240
+ "rulebook-maintenance-pass",
241
+ "recipe-maintenance-pass",
242
+ "sample-maintenance-pass",
243
+ "template-maintenance-pass",
244
+ "refine-pass",
245
+ "condense-pass",
246
+ "retrofit-review-pass",
247
+ "finalize-pass",
248
+ ],
206
249
  finalize_approach: "bootstrap-finalize",
207
250
  },
208
251
  retrofit: {
209
252
  approach: "retrofit",
210
- phase_sets: ["retrofit-pass", "refine-pass", "retrofit-review-pass", "finalize-pass"],
253
+ phase_sets: [
254
+ "retrofit-pass",
255
+ "refine-pass",
256
+ "condense-pass",
257
+ "retrofit-review-pass",
258
+ "finalize-pass",
259
+ ],
211
260
  finalize_approach: "finalize",
212
261
  },
213
262
  "fully-guided": {
214
263
  approach: "fully-guided",
215
- phase_sets: ["guided-pass", "refine-pass", "review-pass", "finalize-pass"],
264
+ phase_sets: ["guided-pass", "refine-pass", "condense-pass", "review-pass", "finalize-pass"],
216
265
  finalize_approach: "finalize",
217
266
  },
218
267
  draft: {
219
268
  approach: "draft",
220
- phase_sets: ["context-pass", "guided-pass", "refine-pass", "review-pass", "finalize-pass"],
269
+ phase_sets: [
270
+ "context-pass",
271
+ "guided-pass",
272
+ "refine-pass",
273
+ "condense-pass",
274
+ "review-pass",
275
+ "finalize-pass",
276
+ ],
221
277
  finalize_approach: "finalize",
222
278
  },
223
279
  "recipe-guided": {
224
280
  approach: "recipe-guided",
225
- phase_sets: ["recipe-guided-pass", "refine-pass", "review-pass", "finalize-pass"],
281
+ phase_sets: [
282
+ "recipe-guided-pass",
283
+ "refine-pass",
284
+ "condense-pass",
285
+ "review-pass",
286
+ "finalize-pass",
287
+ ],
226
288
  finalize_approach: "finalize",
227
289
  },
228
290
  freeform: {
229
291
  approach: "freeform",
230
- phase_sets: ["freeform-pass", "refine-pass", "review-pass", "finalize-pass"],
292
+ phase_sets: ["freeform-pass", "refine-pass", "condense-pass", "review-pass", "finalize-pass"],
231
293
  finalize_approach: "finalize",
232
294
  },
233
295
  "rulebook-maintenance": {
234
296
  approach: "rulebook-maintenance",
235
- phase_sets: ["rulebook-maintenance-pass", "review-pass", "finalize-pass"],
297
+ phase_sets: [
298
+ "rulebook-maintenance-pass",
299
+ "recipe-maintenance-pass",
300
+ "sample-maintenance-pass",
301
+ "template-maintenance-pass",
302
+ "review-pass",
303
+ "finalize-pass",
304
+ ],
236
305
  finalize_approach: "finalize",
237
306
  },
238
307
  "recipe-maintenance": {
@@ -254,7 +323,12 @@ export const STRATEGY_PROFILES = {
254
323
  // starts at refine-pass; the pass is generated separately and blocks that first task.
255
324
  "cross-deliverable-dedup": {
256
325
  approach: "cross-deliverable-dedup",
257
- phase_sets: ["refine-pass", "review-pass", "finalize-pass"],
326
+ phase_sets: ["refine-pass", "condense-pass", "review-pass", "finalize-pass"],
327
+ finalize_approach: "finalize",
328
+ },
329
+ condense: {
330
+ approach: "condense",
331
+ phase_sets: ["condense-pass", "review-pass", "finalize-pass"],
258
332
  finalize_approach: "finalize",
259
333
  },
260
334
  finalize: {
@@ -6,6 +6,7 @@
6
6
  // bootstrap は成果物とその参考資料一式(rulebook/recipe/sample/template)を一貫した一組として
7
7
  // 同一タスクで作成・整備する進め方(初期立ち上げ専用)。
8
8
  // retrofit は宣言済みの実装エビデンスを現在動作の根拠として読み、成果物へ反映・新設する。
9
+ // condense は 1 文書の冗長さを直し、修正・保持の記録と原因を result に残す。
9
10
  // cross-deliverable-dedup は明示した成果物群を横断して正本を選び、重複を要約と参照へ置換する。
10
11
  // finalize は human が成果物のみを最終確認して status を ready へ確定する進め方、
11
12
  // bootstrap-finalize は bootstrap と対になり、成果物と参考資料一式をまとめて確定する進め方。
@@ -13,6 +14,7 @@
13
14
  export const APPROACHES = [
14
15
  "draft",
15
16
  "fully-guided",
17
+ "condense",
16
18
  "recipe-guided",
17
19
  "freeform",
18
20
  "bootstrap",
@@ -31,3 +33,8 @@ export const APPROACHES = [
31
33
  "finalize",
32
34
  "bootstrap-finalize",
33
35
  ];
36
+ // Frontier is above expert and requires an explicit tier request or a named agent.
37
+ export const PROFICIENCIES = ["low", "normal", "high", "expert", "frontier"];
38
+ export function isProficiency(value) {
39
+ return PROFICIENCIES.some((proficiency) => proficiency === value);
40
+ }