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,81 @@
1
+ import { existsSync, readFileSync } from "node:fs";
2
+ import { addWorkingDaysToDate, isWorkingDateUtc } from "../exec/schedule/calendar.js";
3
+ import { epicPredecessors, hasReversedEpicDates, orderEpics } from "../register/epic.js";
4
+ import { registerDateFromTimestamp } from "../register/date.js";
5
+ import { loadRegisterItemDocs } from "../register/item.js";
6
+ import { readRegisterEventsFromContent, registerEventFilePath } from "../register/events.js";
7
+ export function computeEpicSchedules(opts) {
8
+ const epics = orderEpics(opts.items, opts.projectId);
9
+ const byId = new Map(epics.map((item) => [item.id, item]));
10
+ const rows = new Map();
11
+ for (const item of epics) {
12
+ const predecessors = epicPredecessors(item, opts.projectId, byId);
13
+ const actualStart = opts.starts.get(item.id);
14
+ const completed = ["done", "decided", "rejected"].includes(item.status);
15
+ let endDate = completed
16
+ ? registerDateFromTimestamp(item.completedAt, opts.timeZone)
17
+ : /^\d{4}-\d{2}-\d{2}$/.test(item.due)
18
+ ? item.due
19
+ : undefined;
20
+ let startDate = item.startOn ??
21
+ (actualStart ? registerDateFromTimestamp(actualStart, opts.timeZone) : undefined);
22
+ if (!startDate && predecessors.length > 0) {
23
+ const ends = predecessors.map((p) => rows.get(p.id)?.endDate);
24
+ if (ends.every((end) => end !== undefined)) {
25
+ startDate = addWorkingDaysToDate(ends.sort().at(-1), 1, opts.calendar);
26
+ }
27
+ }
28
+ if (hasReversedEpicDates(item) || (startDate && endDate && startDate > endDate)) {
29
+ startDate = undefined;
30
+ endDate = undefined;
31
+ }
32
+ // Unknown start/end stays unknown; do not fabricate a date or propagate it downstream.
33
+ let estimateDays;
34
+ if (startDate && endDate && endDate >= startDate) {
35
+ estimateDays = 0;
36
+ const cursor = new Date(`${startDate}T00:00:00Z`);
37
+ const end = new Date(`${endDate}T00:00:00Z`);
38
+ while (cursor <= end) {
39
+ if (isWorkingDateUtc(cursor, opts.calendar))
40
+ estimateDays += 1;
41
+ cursor.setUTCDate(cursor.getUTCDate() + 1);
42
+ }
43
+ }
44
+ rows.set(item.id, {
45
+ id: item.id,
46
+ title: item.title,
47
+ itemStatus: item.status,
48
+ track: item.track,
49
+ domains: item.domains ?? [],
50
+ status: completed ? "primary" : item.status === "open" ? "not_started" : "draft",
51
+ order: rows.size + 1,
52
+ wave: 1 + Math.max(0, ...predecessors.map((p) => rows.get(p.id)?.wave ?? 0)),
53
+ depends_on: predecessors.map((p) => p.track),
54
+ startDate,
55
+ endDate: endDate === "-" || endDate === "_TODO_" ? undefined : endDate,
56
+ estimateDays,
57
+ });
58
+ }
59
+ const schedule = [...rows.values()];
60
+ const plannedStartDate = schedule
61
+ .flatMap((row) => (row.startDate ? [row.startDate] : []))
62
+ .sort()[0];
63
+ return { schedule, plannedStartDate };
64
+ }
65
+ export function loadEpicSchedules(opts) {
66
+ const items = loadRegisterItemDocs(opts.registerPath).map((doc) => doc.item);
67
+ const starts = new Map();
68
+ for (const item of items.filter((item) => item.type === "epic")) {
69
+ const file = registerEventFilePath(opts.registerPath, item.id);
70
+ const events = existsSync(file)
71
+ ? readRegisterEventsFromContent(readFileSync(file, "utf8"), file)
72
+ : [];
73
+ const start = events
74
+ .filter((event) => event.action === "start")
75
+ .map((event) => event.ts)
76
+ .sort()[0];
77
+ if (start)
78
+ starts.set(item.id, start);
79
+ }
80
+ return computeEpicSchedules({ ...opts, items, starts });
81
+ }
@@ -1,5 +1,6 @@
1
- import { existsSync, readFileSync, readdirSync } from "node:fs";
2
- import { join } from "node:path";
1
+ import { readFileSync } from "node:fs";
2
+ import { dirname, relative } from "node:path";
3
+ import { executionRecordLink, listRunRecords } from "../exec/run-records.js";
3
4
  import { load } from "../shared/yaml.js";
4
5
  import { sanitizeDashboardCell } from "./shared.js";
5
6
  export const EXEC_RECORDS_FILE = "exec-records.md";
@@ -29,14 +30,7 @@ function frontmatterText(value) {
29
30
  return value.toISOString();
30
31
  return undefined;
31
32
  }
32
- function listMarkdownFiles(dir, suffix) {
33
- if (!existsSync(dir))
34
- return [];
35
- return readdirSync(dir)
36
- .filter((name) => name.endsWith(suffix))
37
- .sort();
38
- }
39
- // execution/exec/{plans,results} の記録を実行単位(ファイル名の stem)でまとめる。
33
+ // 記録を run 単位でまとめる。
40
34
  // 並びは開始日時の新しい順、開始日時が無いものは後ろに stem 順で置く。
41
35
  export function collectExecRecords(execPath) {
42
36
  const rows = new Map();
@@ -48,17 +42,17 @@ export function collectExecRecords(execPath) {
48
42
  rows.set(stem, created);
49
43
  return created;
50
44
  };
51
- for (const name of listMarkdownFiles(join(execPath, "plans"), "-plan.md")) {
52
- const row = rowFor(name.slice(0, -"-plan.md".length));
53
- const fm = readSpecdojoFrontmatter(join(execPath, "plans", name));
54
- row.planFile = name;
45
+ for (const path of listRunRecords(dirname(execPath), "plan")) {
46
+ const row = rowFor(relative(dirname(execPath), dirname(path)).replaceAll("\\", "/"));
47
+ const fm = readSpecdojoFrontmatter(path);
48
+ row.planFile = relative(execPath, path).replaceAll("\\", "/");
55
49
  row.taskId ??= frontmatterText(fm.task_id);
56
50
  row.mode ??= frontmatterText(fm.mode);
57
51
  }
58
- for (const name of listMarkdownFiles(join(execPath, "results"), "-result.md")) {
59
- const row = rowFor(name.slice(0, -"-result.md".length));
60
- const fm = readSpecdojoFrontmatter(join(execPath, "results", name));
61
- row.resultFile = name;
52
+ for (const path of listRunRecords(dirname(execPath), "result")) {
53
+ const row = rowFor(relative(dirname(execPath), dirname(path)).replaceAll("\\", "/"));
54
+ const fm = readSpecdojoFrontmatter(path);
55
+ row.resultFile = relative(execPath, path).replaceAll("\\", "/");
62
56
  row.taskId = frontmatterText(fm.task_id) ?? row.taskId;
63
57
  row.mode = frontmatterText(fm.mode) ?? row.mode;
64
58
  row.status = frontmatterText(fm.status);
@@ -76,7 +70,9 @@ export function collectExecRecords(execPath) {
76
70
  });
77
71
  }
78
72
  function execRecordLink(dir, file, label) {
79
- return file ? `[${label}](../exec/${dir}/${file})` : "-";
73
+ return file
74
+ ? `[${label}](${executionRecordLink(file, dir === "plans" ? "plan" : "result")})`
75
+ : "-";
80
76
  }
81
77
  export function buildExecRecordsMarkdown(projectId, rows) {
82
78
  const lines = [
@@ -85,7 +81,7 @@ export function buildExecRecordsMarkdown(projectId, rows) {
85
81
  `- project_id: \`${projectId}\``,
86
82
  `- 再生成: \`specdojo dashboard build --project ${projectId}\``,
87
83
  "",
88
- "> このページは `specdojo dashboard build` が生成した派生ビューです。正本は `execution/exec/` 配下の plan / result であり、このページを手編集しても次回のビルドで失われます。実行記録はサイドバーに載せないため、このページから辿ります。",
84
+ "> このページは `specdojo dashboard build` が生成した派生ビューです。正本は `execution/runs/`配下の plan / result であり、このページを手編集しても次回のビルドで失われます。実行記録はサイドバーに載せないため、このページから辿ります。",
89
85
  "",
90
86
  ];
91
87
  if (rows.length === 0) {
@@ -2,19 +2,21 @@ import { existsSync, readFileSync, readdirSync } from "node:fs";
2
2
  import { join } from "node:path";
3
3
  import { load } from "../shared/yaml.js";
4
4
  import { readJson } from "../shared/fs.js";
5
- import { cronMatches, cronOccurrences, isRoutineDue, routineActionKindLabel, } from "../routine/routine.js";
6
- // routine ファイル(rtn-*.yaml)を読み、状態ファイル generated/routine-state.json と突き合わせて
5
+ import { migrateRoutineStorage } from "../routine/storage.js";
6
+ import { cronMatches, isRoutineEntryDue, routineActionKindLabel, } from "../routine/definition.js";
7
+ // routine ファイル(rtn-*.yaml)を読み、端末側の状態ファイルと突き合わせて
7
8
  // 最終実行・実行結果・due 状況を得る。CLI 出力(routine list)の転記に依存しない。
8
- export function aggregateRoutines(routinesPath) {
9
+ export function aggregateRoutines(routinesPath, repoRoot) {
9
10
  if (!routinesPath || !existsSync(routinesPath))
10
11
  return { rows: [], docs: [], history: [] };
12
+ const storage = migrateRoutineStorage(routinesPath, repoRoot);
11
13
  const result = {
12
14
  rows: [],
13
15
  docs: [],
14
- history: readRoutineRunHistory(join(routinesPath, "generated", "routine-runs.jsonl")),
16
+ history: readRoutineRunHistory(storage.runsPath),
15
17
  error: undefined,
16
18
  };
17
- const stateEntries = readRoutineStateEntries(join(routinesPath, "generated", "routine-state.json"));
19
+ const stateEntries = readRoutineStateEntries(storage.statePath);
18
20
  const now = new Date();
19
21
  const files = readdirSync(routinesPath)
20
22
  .filter((name) => /^rtn-.*\.(ya?ml)$/.test(name))
@@ -172,7 +174,7 @@ export function collapseFrequentRoutineRows(rows) {
172
174
  }
173
175
  return collapsed;
174
176
  }
175
- // generated/routine-state.json の routines.<id> が状態の正本。破損時は空。
177
+ // 端末側の routine-state.json の routines.<id> が状態の正本。破損時は空。
176
178
  function readRoutineStateEntries(statePath) {
177
179
  const entries = {};
178
180
  if (!existsSync(statePath))
@@ -188,6 +190,7 @@ function readRoutineStateEntries(statePath) {
188
190
  last_run: typeof entry.last_run === "string" ? entry.last_run : undefined,
189
191
  last_result: typeof entry.last_result === "string" ? entry.last_result : undefined,
190
192
  last_scheduled_for: typeof entry.last_scheduled_for === "string" ? entry.last_scheduled_for : undefined,
193
+ busy_skip_count: typeof entry.busy_skip_count === "number" ? entry.busy_skip_count : undefined,
191
194
  };
192
195
  }
193
196
  }
@@ -236,12 +239,8 @@ function buildRoutineRow(result, doc, stateEntries, now) {
236
239
  export function computeRoutineDue(doc, stateEntry, enabled, now) {
237
240
  if (!enabled)
238
241
  return "disabled";
239
- if (doc.trigger) {
240
- const occurrences = cronOccurrences(doc, stateEntry?.last_scheduled_for, now);
241
- return occurrences.length > 0 ? "due" : "-";
242
- }
243
- if (doc.interval) {
244
- return isRoutineDue(doc, stateEntry?.last_run, now) ? "due" : "-";
242
+ if (doc.trigger || doc.interval) {
243
+ return isRoutineEntryDue(doc, stateEntry, now) ? "due" : "-";
245
244
  }
246
245
  return "-";
247
246
  }
@@ -1,4 +1,4 @@
1
- import { existsSync } from "node:fs";
1
+ import { loadTrackPlan } from "../register/track-plan.js";
2
2
  import { join } from "node:path";
3
3
  import { collectCatalogFilesByDomain } from "../shared/catalog-files.js";
4
4
  import { resolveTimelineCatalogStatus } from "../register/catalog-status.js";
@@ -101,11 +101,7 @@ export function buildCatalogScaffoldPlans(tracks, catalogPath) {
101
101
  return { scaffolds, warnings };
102
102
  }
103
103
  export function buildTimeline(opts) {
104
- const indexFile = join(opts.timelinePath, "tml-index.yaml");
105
- if (!existsSync(indexFile)) {
106
- throw new Error(`Timeline index not found: ${indexFile}`);
107
- }
108
- const { index, errors: loadErrors } = loadTimelineIndex(indexFile);
104
+ const { index, errors: loadErrors } = loadTrackPlan(opts);
109
105
  const errors = [...loadErrors];
110
106
  const warnings = [];
111
107
  const derived = resolveTimelineCatalogStatus(index.tracks, opts.registerPath);
@@ -150,8 +146,8 @@ export function renderTimelineOrderMarkdown(result) {
150
146
  lines.push(`- schedule_ready_tracks: \`${result.scheduleReadyTracks.length}\``);
151
147
  lines.push(`- catalog_scaffold_targets: \`${result.scaffolds.length}\``);
152
148
  lines.push("");
153
- lines.push(`この文書は \`tml-index.yaml\` から \`specdojo timeline build\` が生成した派生ビューです。` +
154
- `直接編集せず、計画は \`tml-index.yaml\`、カタログ作成の完了は register の todo に記録してください。`);
149
+ lines.push(`この文書は epic・strategy(互換用 \`tml-index.yaml\`)から非推奨の \`specdojo timeline build\` が生成した派生ビューです。` +
150
+ `計画は register の epic、範囲は strategy の scope、カタログ作成の完了は register の todo に記録し、通常は \`dashboard build\` を使ってください。`);
155
151
  for (const wave of result.waves) {
156
152
  lines.push("");
157
153
  lines.push(`## ${wave.wave}. Wave ${wave.wave}`);
@@ -174,7 +170,7 @@ export function renderCatalogScaffoldMarkdown(result) {
174
170
  lines.push(`- project_id: \`${result.projectId}\``);
175
171
  lines.push(`- targets: \`${result.scaffolds.length}\``);
176
172
  lines.push("");
177
- lines.push(`\`tml-index.yaml\` の各トラックが対象とするドメインのうち、\`dct-<domain>.yaml\` が未作成のものを列挙します。`);
173
+ lines.push(`既存 strategy の scope、epic の domains、互換用 \`tml-index.yaml\` の順で対象を解決し、\`dct-<domain>.yaml\` が未作成のものを列挙します。`);
178
174
  lines.push("");
179
175
  if (result.scaffolds.length === 0) {
180
176
  lines.push(`未作成の成果物カタログはありません。`);
@@ -1,6 +1,8 @@
1
+ import { registerDeprecatedWhereAlias } from "../shared/where-alias.js";
2
+ import { warnDeprecated } from "../shared/deprecation.js";
1
3
  import { existsSync, mkdirSync, writeFileSync } from "node:fs";
2
4
  import { join, resolve } from "node:path";
3
- import { getProjectCatalogPath, getProjectTimelinePath, getProjectRegisterPath, loadConfig, loadEnv, specdojoRootDir, } from "../shared/specdojo-config.js";
5
+ import { getProjectCatalogPath, getProjectTimelinePath, getProjectSchedulePath, getProjectRegisterPath, loadConfig, loadEnv, specdojoRootDir, } from "../shared/specdojo-config.js";
4
6
  import { buildTimeline, renderCatalogScaffoldMarkdown, renderTimelineOrderMarkdown, } from "./timeline-build.js";
5
7
  function resolveTimelinePaths(opts) {
6
8
  loadEnv();
@@ -23,6 +25,9 @@ function resolveTimelinePaths(opts) {
23
25
  const registerPath = getProjectRegisterPath(project);
24
26
  return {
25
27
  timelinePath: resolve(baseDir, getProjectTimelinePath(project)),
28
+ schedulePath: resolve(baseDir, getProjectSchedulePath(project)),
29
+ repoRoot: baseDir,
30
+ projectId,
26
31
  catalogPath: catalogPath ? resolve(baseDir, catalogPath) : null,
27
32
  ...(registerPath ? { registerPath: resolve(baseDir, registerPath) } : {}),
28
33
  };
@@ -50,31 +55,31 @@ function buildTimelineJson(result) {
50
55
  })),
51
56
  }, null, 2) + "\n");
52
57
  }
58
+ export function printTimelinePaths(opts) {
59
+ try {
60
+ const { timelinePath, catalogPath } = resolveTimelinePaths(opts);
61
+ process.stdout.write(`timeline-path: ${timelinePath}\n`);
62
+ process.stdout.write(`catalog-path: ${catalogPath ?? "(not configured)"}\n`);
63
+ const indexFile = join(timelinePath, "tml-index.yaml");
64
+ process.stdout.write(`tml-index: ${indexFile}${existsSync(indexFile) ? "" : " (does not exist)"}\n`);
65
+ }
66
+ catch (error) {
67
+ printCommandError(error);
68
+ }
69
+ }
53
70
  export function registerTimelineCommands(program) {
54
71
  const tml = program.command("timeline").description("Timeline build commands");
55
- const wcmd = tml.command("where").description("Print resolved timeline paths");
56
- addProjectOption(wcmd);
57
- wcmd.action((opts) => {
58
- try {
59
- const { timelinePath, catalogPath } = resolveTimelinePaths(opts);
60
- process.stdout.write(`timeline-path: ${timelinePath}\n`);
61
- process.stdout.write(`catalog-path: ${catalogPath ?? "(not configured)"}\n`);
62
- const indexFile = join(timelinePath, "tml-index.yaml");
63
- process.stdout.write(`tml-index: ${indexFile}${existsSync(indexFile) ? "" : " (does not exist)"}\n`);
64
- }
65
- catch (error) {
66
- printCommandError(error);
67
- }
68
- });
72
+ registerDeprecatedWhereAlias(tml, printTimelinePaths);
69
73
  const bcmd = tml
70
74
  .command("build")
71
- .description("Derive track start order and catalog scaffold targets from tml-index.yaml");
75
+ .description("Deprecated: derive track order and catalog targets from epics and legacy tml-index.yaml");
72
76
  addProjectOption(bcmd);
73
77
  bcmd.option("--dry-run", "Print generated content to stdout without writing", false);
74
78
  bcmd.action((opts) => {
75
79
  try {
76
- const { timelinePath, catalogPath, registerPath } = resolveTimelinePaths(opts);
77
- const result = buildTimeline({ timelinePath, catalogPath, registerPath });
80
+ warnDeprecated("timeline build", "Use dashboard build; move domains and dependencies to register epics.");
81
+ const { timelinePath, ...paths } = resolveTimelinePaths(opts);
82
+ const result = buildTimeline({ timelinePath, ...paths });
78
83
  for (const warning of result.warnings)
79
84
  process.stdout.write(`WARN: ${warning}\n`);
80
85
  for (const error of result.errors)
@@ -192,6 +192,7 @@ export async function runDevcontainerScaffold(opts) {
192
192
  // options に応じて json と script を改変
193
193
  const aptPackages = [];
194
194
  const extraScripts = [];
195
+ let tmuxConfTemplate;
195
196
  let emacsInitTemplate;
196
197
  let vimrcTemplate;
197
198
  if (includesRecommended) {
@@ -207,6 +208,14 @@ fi`);
207
208
  }
208
209
  if (effectiveTmux) {
209
210
  aptPackages.push("tmux");
211
+ tmuxConfTemplate = await readFile(path.join(templateDir, "tmux.conf"), "utf8");
212
+ extraScripts.push(`# Link bundled tmux.conf when tmux is enabled, preserving any non-symlink user configuration.
213
+ SCRIPT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"
214
+ if [ -f "\${SCRIPT_DIR}/tmux.conf" ]; then
215
+ if [ ! -e "$HOME/.tmux.conf" ] || [ -L "$HOME/.tmux.conf" ]; then
216
+ ln -sfn "\${SCRIPT_DIR}/tmux.conf" "$HOME/.tmux.conf"
217
+ fi
218
+ fi`);
210
219
  }
211
220
  if (effectiveCron) {
212
221
  aptPackages.push("cron");
@@ -386,6 +395,9 @@ fi`);
386
395
  if (dryRun) {
387
396
  process.stdout.write(`[dry-run] would write: .devcontainer/devcontainer.json\n`);
388
397
  process.stdout.write(`[dry-run] would write: .devcontainer/post-create.sh\n`);
398
+ if (tmuxConfTemplate !== undefined) {
399
+ process.stdout.write(`[dry-run] would write: .devcontainer/tmux.conf\n`);
400
+ }
389
401
  if (emacsInitTemplate !== undefined) {
390
402
  process.stdout.write(`[dry-run] would write: .devcontainer/emacs/init.el\n`);
391
403
  }
@@ -402,6 +414,9 @@ fi`);
402
414
  await mkdir(devcontainerDir, { recursive: true });
403
415
  await writeFile(path.join(devcontainerDir, "devcontainer.json"), JSON.stringify(devcontainer, null, 2) + "\n", "utf8");
404
416
  await writeFile(path.join(devcontainerDir, "post-create.sh"), postCreateScript, "utf8");
417
+ if (tmuxConfTemplate !== undefined) {
418
+ await writeFile(path.join(devcontainerDir, "tmux.conf"), tmuxConfTemplate, "utf8");
419
+ }
405
420
  if (emacsInitTemplate !== undefined) {
406
421
  await mkdir(path.join(devcontainerDir, "emacs"), { recursive: true });
407
422
  await writeFile(path.join(devcontainerDir, "emacs", "init.el"), emacsInitTemplate, "utf8");
@@ -420,6 +435,9 @@ fi`);
420
435
  await writeFile(path.join(remoteHostDir, "ssh-config.sample"), sshConfigScript, "utf8");
421
436
  process.stdout.write(`Written: .devcontainer/devcontainer.json\n`);
422
437
  process.stdout.write(`Written: .devcontainer/post-create.sh\n`);
438
+ if (tmuxConfTemplate !== undefined) {
439
+ process.stdout.write(`Written: .devcontainer/tmux.conf\n`);
440
+ }
423
441
  if (emacsInitTemplate !== undefined) {
424
442
  process.stdout.write(`Written: .devcontainer/emacs/init.el\n`);
425
443
  }
@@ -1,48 +1 @@
1
- // SpecDojo が所有する Markdown frontmatter は `specdojo:` 名前空間配下に置く
2
- // (document-metadata-standard.md)。他フレームワークの frontmatter キーとの衝突を避け、
3
- // トップレベルを第三者ツールへ明け渡すための共通ユーティリティ。
4
- //
5
- // 対象は Markdown frontmatter のみ。独立 YAML データファイル(dct-*.yaml / pm-*.yaml /
6
- // sch-*.yaml など)は名前空間化しないため、本モジュールは使わない。
7
- import { load } from "../shared/yaml.js";
8
- const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
9
- function specdojoFromBlock(block) {
10
- let parsed;
11
- try {
12
- parsed = load(block);
13
- }
14
- catch {
15
- return {};
16
- }
17
- if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
18
- return {};
19
- const namespace = parsed.specdojo;
20
- if (!namespace || typeof namespace !== "object" || Array.isArray(namespace))
21
- return {};
22
- return namespace;
23
- }
24
- // Markdown 文書先頭の frontmatter から `specdojo:` 名前空間オブジェクトを取り出す。
25
- // frontmatter が無い / 解析不能 / `specdojo:` を欠く場合は空オブジェクトを返す。
26
- export function readSpecdojoNamespace(content) {
27
- const match = content.match(FRONTMATTER_RE);
28
- if (!match)
29
- return {};
30
- return specdojoFromBlock(match[1]);
31
- }
32
- // readSpecdojoNamespace と同じだが、frontmatter に続く本文も返す(read-modify-write 用)。
33
- export function parseSpecdojoDocument(content) {
34
- const match = content.match(FRONTMATTER_RE);
35
- if (!match)
36
- return { data: {}, body: content };
37
- return { data: specdojoFromBlock(match[1]), body: match[2] ?? "" };
38
- }
39
- // トップレベルの `key: value` 行群を `specdojo:` 配下へ字下げし、`---` で囲んだ
40
- // frontmatter ブロック文字列にして返す。frontmatter を生成する各所で使う。
41
- export function buildSpecdojoFrontmatter(innerLines) {
42
- return [
43
- "---",
44
- "specdojo:",
45
- ...innerLines.map((line) => (line.length === 0 ? "" : ` ${line}`)),
46
- "---",
47
- ].join("\n");
48
- }
1
+ export { buildSpecdojoFrontmatter, parseSpecdojoDocument, readSpecdojoNamespace, } from "../shared/frontmatter-namespace.js";
@@ -10,8 +10,8 @@ function printCommandError(error) {
10
10
  export function registerIndexCommands(program) {
11
11
  const idx = program.command("index").description("Document ID index commands");
12
12
  idx
13
- .command("build")
14
- .description("Scan docs and build .specdojo/doc-index.json")
13
+ .command("build", { hidden: true })
14
+ .description("Internal compatibility entry for build --only index")
15
15
  .option("--root <path>", "Root directory to scan", "docs")
16
16
  .option("--output <path>", "Output path", ".specdojo/doc-index.json")
17
17
  .action((opts) => {