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
package/dist/job/job.js CHANGED
@@ -1,25 +1,29 @@
1
- import { createHash } from "node:crypto";
1
+ import { registerDeprecatedWhereAlias } from "../shared/where-alias.js";
2
2
  import { spawn, spawnSync } from "node:child_process";
3
+ import { createHash } from "node:crypto";
3
4
  import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
4
5
  import { join, relative, resolve } from "node:path";
5
6
  import { buildSpecdojoFrontmatter } from "../docs/frontmatter-namespace.js";
7
+ import { recordRef, taskRecordPaths } from "../shared/run-records.js";
6
8
  import { listFilesRecursive, writeJson } from "../shared/fs.js";
7
9
  import { gitEnvironment } from "../shared/git.js";
8
10
  import { formatMarkdownFile } from "../shared/markdown-format.js";
9
11
  import { execTemplatePath, injectCommonConventions, MISSING } from "../shared/plan-templates.js";
10
- import { expandTemplate } from "../shared/text.js";
11
- import { isJobAgentTask, isJobCommandTask, getPath, loadAllJobs, loadJobDefinition, loadJobRunRecord, parseInputValue, parseJobInputs, renderJobTemplate, resolveJobPaths, validateJobInputValue, } from "./definition.js";
12
- import { specdojoRootDir } from "../shared/specdojo-config.js";
13
12
  import { selfRunCommand } from "../shared/spawn-self.js";
14
- export { isJobAgentTask, isJobCommandTask, jobDeclaresReview, jobRunUsesReviewedIntegration, loadAllJobs, loadJobDefinition, loadJobRunRecord, parseJobDefinition, parseJobInputs, renderJobTemplate, resolveJobPaths, resolveJobReviewAgentNominations, } from "./definition.js";
13
+ import { specdojoRootDir } from "../shared/specdojo-config.js";
14
+ import { expandTemplate } from "../shared/text.js";
15
+ import { getPath, isJobAgentTask, isJobCommandTask, jobCommandText, loadAllJobs, loadJobDefinition, loadJobRunRecord, parseInputValue, parseJobInputs, renderJobTemplate, resolveJobPaths, validateJobInputValue, } from "./definition.js";
16
+ import { jobNoopDirectory, localJobNoopPath } from "./noop.js";
17
+ export { jobCommandText, isJobAgentTask, isJobCommandTask, jobDeclaresReview, jobRunUsesReviewedIntegration, loadAllJobs, loadJobDefinition, loadJobRunRecord, parseJobDefinition, parseJobInputs, renderJobTemplate, resolveJobPaths, resolveJobReviewAgentNominations, } from "./definition.js";
15
18
  export function jobCheckpoint(paths, jobId) {
16
19
  return deriveJobState(paths).jobs[jobId]?.checkpoint ?? {};
17
20
  }
18
21
  export function deriveJobState(paths) {
19
22
  const state = { version: 1, jobs: {} };
20
- if (!existsSync(paths.runsPath))
21
- return state;
22
- for (const filePath of listFilesRecursive(paths.runsPath)
23
+ for (const filePath of [
24
+ ...listFilesRecursive(paths.runsPath),
25
+ ...listFilesRecursive(jobNoopDirectory(paths.executionPath)),
26
+ ]
23
27
  .filter((path) => path.endsWith(".json"))
24
28
  .sort()) {
25
29
  try {
@@ -118,7 +122,7 @@ function commandOutputText(chunks, truncated) {
118
122
  return truncated ? text.replace(/\uFFFD$/u, "") : text;
119
123
  }
120
124
  /** Executes a materialized Job command directly in the runner process, never through an agent. */
121
- export async function executeJobCommand(command, cwd) {
125
+ export async function executeJobCommand(command, cwd, options = {}) {
122
126
  const startedAt = new Date().toISOString();
123
127
  return await new Promise((resolveResult) => {
124
128
  const stdoutChunks = [];
@@ -128,6 +132,9 @@ export async function executeJobCommand(command, cwd) {
128
132
  let stdoutTruncated = false;
129
133
  let stderrTruncated = false;
130
134
  let settled = false;
135
+ let timedOut = false;
136
+ let timeout;
137
+ let killTimeout;
131
138
  const executable = process.platform === "win32" ? process.env.ComSpec || "cmd.exe" : "/bin/sh";
132
139
  const args = process.platform === "win32" ? ["/d", "/s", "/c", command] : ["-eu", "-c", command];
133
140
  const child = spawn(executable, args, {
@@ -136,7 +143,27 @@ export async function executeJobCommand(command, cwd) {
136
143
  shell: false,
137
144
  stdio: ["ignore", "pipe", "pipe"],
138
145
  windowsHide: true,
146
+ detached: options.timeoutMs !== undefined && process.platform !== "win32",
139
147
  });
148
+ const kill = (signal) => {
149
+ try {
150
+ if (process.platform !== "win32" && child.pid)
151
+ process.kill(-child.pid, signal);
152
+ else
153
+ child.kill(signal);
154
+ }
155
+ catch (error) {
156
+ if (error.code !== "ESRCH")
157
+ child.kill(signal);
158
+ }
159
+ };
160
+ if (options.timeoutMs !== undefined) {
161
+ timeout = setTimeout(() => {
162
+ timedOut = true;
163
+ kill("SIGTERM");
164
+ killTimeout = setTimeout(() => kill("SIGKILL"), 1000);
165
+ }, options.timeoutMs);
166
+ }
140
167
  child.stdout.on("data", (chunk) => {
141
168
  process.stdout.write(chunk);
142
169
  const appended = appendCommandOutput(stdoutChunks, chunk, stdoutBytes);
@@ -153,6 +180,10 @@ export async function executeJobCommand(command, cwd) {
153
180
  if (settled)
154
181
  return;
155
182
  settled = true;
183
+ clearTimeout(timeout);
184
+ clearTimeout(killTimeout);
185
+ if (timedOut)
186
+ kill("SIGKILL");
156
187
  resolveResult({
157
188
  command,
158
189
  startedAt,
@@ -163,6 +194,7 @@ export async function executeJobCommand(command, cwd) {
163
194
  stdoutTruncated,
164
195
  stderrTruncated,
165
196
  ...(error ? { error } : {}),
197
+ ...(timedOut ? { timedOut: true, error: "command timed out" } : {}),
166
198
  });
167
199
  };
168
200
  child.once("error", (error) => finish(null, error.message));
@@ -230,7 +262,7 @@ export async function generateJobPlan(paths, definition, record) {
230
262
  const templatePath = execTemplatePath("xep-job-template.md");
231
263
  if (!existsSync(templatePath))
232
264
  throw new Error(`Template not found: ${templatePath}`);
233
- const planPath = join(paths.executionPath, "exec", "plans", `${record.run_id}-plan.md`);
265
+ const planPath = taskRecordPaths(paths.executionPath, record.run_id, record.run_id, "job").plan;
234
266
  mkdirSync(resolve(planPath, ".."), { recursive: true });
235
267
  const commandTask = isJobCommandTask(record.task) ? record.task : undefined;
236
268
  const values = {
@@ -252,7 +284,7 @@ export async function generateJobPlan(paths, definition, record) {
252
284
  "runner が次の解決済みコマンドを agent の sandbox 外で直接実行する。",
253
285
  "",
254
286
  "```sh",
255
- commandTask.command,
287
+ jobCommandText(commandTask),
256
288
  "```",
257
289
  "",
258
290
  commandTask.analysis
@@ -263,10 +295,13 @@ export async function generateJobPlan(paths, definition, record) {
263
295
  _JOB_INPUTS_: JSON.stringify(record.inputs, null, 2),
264
296
  _JOB_TARGETS_: record.task.targets?.map((target) => `- [[${target}]]`).join("\n") ?? "- -",
265
297
  _JOB_PATHS_: record.task.paths?.map((path) => `- \`${path}\``).join("\n") ?? "- -",
266
- _RESULT_REF_: repoRelative(join(paths.executionPath, "exec", "results", `${record.run_id}-result.md`)),
298
+ _RESULT_REF_: repoRelative(taskRecordPaths(paths.executionPath, record.run_id, record.run_id, "job").result),
267
299
  };
268
300
  const body = expandTemplate(readFileSync(templatePath, "utf8"), values);
269
- const content = injectCommonConventions(body, MISSING, new Map());
301
+ const content = injectCommonConventions(body, MISSING, new Map(), "edit", {
302
+ executionPath: paths.executionPath,
303
+ planPath,
304
+ });
270
305
  writeFileSync(planPath, content, "utf8");
271
306
  await formatMarkdownFile(planPath);
272
307
  return planPath;
@@ -290,8 +325,7 @@ export async function generateJobReviewPlan(paths, definition, record, opts) {
290
325
  const templatePath = execTemplatePath("xrp-job-template.md");
291
326
  if (!existsSync(templatePath))
292
327
  throw new Error(`Template not found: ${templatePath}`);
293
- const planPath = join(paths.executionPath, "exec", "plans", `${record.run_id}-review-plan.md`);
294
- const resultPath = join(paths.executionPath, "exec", "results", `${record.run_id}-review-result.md`);
328
+ const { plan: planPath, result: resultPath } = taskRecordPaths(paths.executionPath, record.run_id, `${record.run_id}-review`, "job");
295
329
  mkdirSync(resolve(planPath, ".."), { recursive: true });
296
330
  const values = {
297
331
  _FRONTMATTER_: jobReviewPlanFrontmatter(paths.projectId, definition, record),
@@ -310,7 +344,10 @@ export async function generateJobReviewPlan(paths, definition, record, opts) {
310
344
  _RUN_RESULT_REF_: repoRelative(join(paths.executionPath, record.result_ref)),
311
345
  };
312
346
  const body = expandTemplate(readFileSync(templatePath, "utf8"), values);
313
- const content = injectCommonConventions(body, MISSING, new Map(), "review");
347
+ const content = injectCommonConventions(body, MISSING, new Map(), "review", {
348
+ executionPath: paths.executionPath,
349
+ planPath,
350
+ });
314
351
  writeFileSync(planPath, content, "utf8");
315
352
  await formatMarkdownFile(planPath);
316
353
  return { planPath, resultPath };
@@ -362,7 +399,23 @@ export async function materializeJobRun(opts) {
362
399
  command: renderJobTemplate(task.precondition.command, context),
363
400
  };
364
401
  }
365
- task.command = renderJobTemplate(task.command, context);
402
+ if (task.command !== undefined)
403
+ task.command = renderJobTemplate(task.command, context);
404
+ if (task.steps) {
405
+ task.steps = task.steps.map((step) => ({
406
+ ...step,
407
+ command: renderJobTemplate(step.command, context),
408
+ ...(step.completion
409
+ ? {
410
+ completion: {
411
+ ...step.completion,
412
+ path: renderJobTemplate(step.completion.path, context),
413
+ field: renderJobTemplate(step.completion.field, context),
414
+ },
415
+ }
416
+ : {}),
417
+ }));
418
+ }
366
419
  if (task.analysis) {
367
420
  task.analysis = {
368
421
  ...task.analysis,
@@ -374,10 +427,11 @@ export async function materializeJobRun(opts) {
374
427
  task.description = renderJobTemplate(task.description, context);
375
428
  }
376
429
  const now = new Date().toISOString();
377
- const existingRun = existsSync(runPath);
430
+ const localNoop = localJobNoopPath(paths.executionPath, runId);
431
+ const existingRun = existsSync(localNoop) || existsSync(runPath);
378
432
  let record;
379
433
  if (existingRun) {
380
- record = loadJobRunRecord(runPath);
434
+ record = loadJobRunRecord(existsSync(localNoop) ? localNoop : runPath);
381
435
  if (record.idempotency_key !== idempotencyKey || record.job_id !== definition.id) {
382
436
  throw new Error(`Job Run identity collision: ${runId}`);
383
437
  }
@@ -406,12 +460,21 @@ export async function materializeJobRun(opts) {
406
460
  inputs,
407
461
  task,
408
462
  checkpoint_before: checkpoint,
409
- plan_ref: `exec/plans/${runId}-plan.md`,
410
- result_ref: `exec/results/${runId}-result.md`,
463
+ plan_ref: recordRef(paths.executionPath, taskRecordPaths(paths.executionPath, runId, runId, "job").plan),
464
+ result_ref: recordRef(paths.executionPath, taskRecordPaths(paths.executionPath, runId, runId, "job").result),
411
465
  attempts: [],
412
466
  };
413
467
  }
414
- if (!existingRun && !opts.dryRun && isJobCommandTask(task) && task.precondition) {
468
+ record = {
469
+ ...record,
470
+ plan_ref: recordRef(paths.executionPath, taskRecordPaths(paths.executionPath, runId, runId, "job").plan),
471
+ result_ref: recordRef(paths.executionPath, taskRecordPaths(paths.executionPath, runId, runId, "job").result),
472
+ };
473
+ if (!existingRun &&
474
+ !opts.dryRun &&
475
+ !opts.skipPrecondition &&
476
+ isJobCommandTask(task) &&
477
+ task.precondition) {
415
478
  const precondition = await executeJobPrecondition(task.precondition, specdojoRootDir());
416
479
  if (precondition.skipped) {
417
480
  return {
@@ -501,28 +564,35 @@ export function completeJobRun(opts) {
501
564
  }
502
565
  return updated;
503
566
  }
567
+ /** Persist each step immediately so a stopped runner retains its last known progress. */
568
+ export function recordJobSteps(runPath, steps) {
569
+ const record = loadJobRunRecord(runPath);
570
+ const attempt = record.attempts.at(-1);
571
+ if (!attempt)
572
+ throw new Error(`Job Run has no attempt: ${record.run_id}`);
573
+ attempt.steps = steps;
574
+ record.updated_at = new Date().toISOString();
575
+ writeJson(runPath, record);
576
+ }
504
577
  export function jobRunRelativePath(runPath) {
505
578
  return repoRelative(runPath);
506
579
  }
580
+ export function printJobPaths(opts) {
581
+ try {
582
+ const paths = resolveJobPaths(opts.project);
583
+ process.stdout.write(`project: ${paths.projectId}\n`);
584
+ process.stdout.write(`jobs: ${paths.jobsPath}\n`);
585
+ process.stdout.write(`runs: ${paths.runsPath}\n`);
586
+ process.stdout.write(`state: ${paths.statePath}\n`);
587
+ }
588
+ catch (error) {
589
+ process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
590
+ process.exitCode = 1;
591
+ }
592
+ }
507
593
  export function registerJobCommands(program) {
508
594
  const command = program.command("job").description("Reusable Job Definition and Run helpers");
509
- command
510
- .command("where")
511
- .description("Print resolved Job paths")
512
- .option("--project <projectId>", "Project id")
513
- .action((opts) => {
514
- try {
515
- const paths = resolveJobPaths(opts.project);
516
- process.stdout.write(`project: ${paths.projectId}\n`);
517
- process.stdout.write(`jobs: ${paths.jobsPath}\n`);
518
- process.stdout.write(`runs: ${paths.runsPath}\n`);
519
- process.stdout.write(`state: ${paths.statePath}\n`);
520
- }
521
- catch (error) {
522
- process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
523
- process.exitCode = 1;
524
- }
525
- });
595
+ registerDeprecatedWhereAlias(command, printJobPaths);
526
596
  command
527
597
  .command("validate")
528
598
  .description("Validate job-*.yaml definitions")
@@ -0,0 +1,104 @@
1
+ import { createHash } from "node:crypto";
2
+ import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, readlinkSync, rmSync, writeFileSync, } from "node:fs";
3
+ import { dirname, join, relative, sep } from "node:path";
4
+ import { gitOutput, gitResult, worktreeStatusPaths } from "../shared/git.js";
5
+ import { listFilesRecursive, writeJson } from "../shared/fs.js";
6
+ import { localStateDirectory } from "../shared/local-state.js";
7
+ import { listRunRecords, planConventionsDirectory, runItemDirectory, } from "../shared/run-records.js";
8
+ import { planConventionsFiles } from "../shared/plan-conventions.js";
9
+ import { specdojoRootDir } from "../shared/specdojo-config.js";
10
+ export function jobNoopDirectory(executionPath, repoRoot = specdojoRootDir()) {
11
+ const key = createHash("sha256").update(relative(repoRoot, executionPath)).digest("hex");
12
+ return join(localStateDirectory(repoRoot), "jobs", key, "noops");
13
+ }
14
+ export function localJobNoopPath(executionPath, runId, repoRoot = specdojoRootDir()) {
15
+ return join(jobNoopDirectory(executionPath, repoRoot), `${runId}.json`);
16
+ }
17
+ function fingerprint(file) {
18
+ if (!existsSync(file))
19
+ return "missing";
20
+ const stat = lstatSync(file);
21
+ const value = stat.isSymbolicLink()
22
+ ? readlinkSync(file)
23
+ : stat.isFile()
24
+ ? readFileSync(file)
25
+ : "directory";
26
+ return `${stat.mode}:${createHash("sha256").update(value).digest("hex")}`;
27
+ }
28
+ /** Only this Run's bookkeeping is excluded; nested exec events and grade results are output. */
29
+ export function jobBookkeepingPaths(executionPath, record) {
30
+ const directory = runItemDirectory(executionPath, "job", record.run_id);
31
+ const paths = [
32
+ ...new Set([
33
+ join(executionPath, "jobs", "runs", `${record.run_id}.json`),
34
+ directory,
35
+ join(executionPath, record.plan_ref),
36
+ join(executionPath, record.result_ref),
37
+ ]),
38
+ ];
39
+ return paths.filter((file) => !paths.some((parent) => file !== parent && file.startsWith(`${parent}${sep}`)));
40
+ }
41
+ export function snapshotJobOutput(repoRoot, executionPath, record) {
42
+ const artifacts = jobBookkeepingPaths(executionPath, record);
43
+ const conventionsDirectory = planConventionsDirectory(executionPath);
44
+ const previousVersions = new Set(existsSync(conventionsDirectory) ? readdirSync(conventionsDirectory) : []);
45
+ const ignored = artifacts.map((file) => relative(repoRoot, file).split(sep).join("/"));
46
+ ignored.push(relative(repoRoot, conventionsDirectory).split(sep).join("/"), relative(repoRoot, join(executionPath, "exec", ".locks"))
47
+ .split(sep)
48
+ .join("/"));
49
+ const substantive = (file) => !ignored.some((item) => file === item || file.startsWith(`${item}/`)) &&
50
+ !file.split("/").includes("generated");
51
+ const changes = new Map(worktreeStatusPaths(repoRoot)
52
+ .filter(substantive)
53
+ .map((file) => [file, fingerprint(join(repoRoot, file))]));
54
+ const previous = new Map();
55
+ for (const file of artifacts.flatMap((item) => existsSync(item) && lstatSync(item).isDirectory() ? listFilesRecursive(item) : [item])) {
56
+ if (existsSync(file))
57
+ previous.set(file, readFileSync(file));
58
+ }
59
+ // An initialized repository need not have its first commit yet.
60
+ const headResult = gitResult(repoRoot, ["rev-parse", "--verify", "HEAD"]);
61
+ const head = headResult.status === 0 ? String(headResult.stdout).trim() : undefined;
62
+ return {
63
+ hasChanges() {
64
+ const after = new Map(worktreeStatusPaths(repoRoot)
65
+ .filter(substantive)
66
+ .map((file) => [file, fingerprint(join(repoRoot, file))]));
67
+ if ([...new Set([...changes.keys(), ...after.keys()])].some((file) => changes.get(file) !== after.get(file)))
68
+ return true;
69
+ return (!!head &&
70
+ gitOutput(repoRoot, ["diff", "--name-only", "-z", head, "HEAD", "--"])
71
+ .split("\0")
72
+ .filter(Boolean)
73
+ .some(substantive));
74
+ },
75
+ discard(record) {
76
+ // Keep idempotency and checkpoints locally even though no Run artifacts enter Git.
77
+ const local = localJobNoopPath(executionPath, record.run_id, repoRoot);
78
+ mkdirSync(dirname(local), { recursive: true });
79
+ const noop = {
80
+ ...record,
81
+ state: "noop",
82
+ attempts: record.attempts.map((attempt, index) => index === record.attempts.length - 1 ? { ...attempt, status: "noop" } : attempt),
83
+ };
84
+ writeJson(local, noop);
85
+ const versions = existsSync(join(executionPath, record.plan_ref))
86
+ ? planConventionsFiles(readFileSync(join(executionPath, record.plan_ref), "utf8"), dirname(join(executionPath, record.plan_ref)))
87
+ : [];
88
+ for (const file of artifacts)
89
+ rmSync(file, { recursive: true, force: true });
90
+ for (const [file, content] of previous) {
91
+ mkdirSync(dirname(file), { recursive: true });
92
+ writeFileSync(file, content);
93
+ }
94
+ // Remove only snapshots introduced by this discarded Run. Preserve versions
95
+ // referenced by retained plans, including completed plans.
96
+ const retained = new Set(listRunRecords(executionPath, "plan").flatMap((plan) => planConventionsFiles(readFileSync(plan, "utf8"), dirname(plan))));
97
+ for (const version of versions) {
98
+ if (!previousVersions.has(version.slice(conventionsDirectory.length + 1)) &&
99
+ !retained.has(version))
100
+ rmSync(version);
101
+ }
102
+ },
103
+ };
104
+ }
@@ -1,6 +1,5 @@
1
- import { existsSync, realpathSync, statSync } from "node:fs";
1
+ import { existsSync, globSync, realpathSync, statSync } from "node:fs";
2
2
  import { extname, isAbsolute, posix, relative, resolve, sep } from "node:path";
3
- import { globSync } from "tinyglobby";
4
3
  import { collectDocIndexEntries } from "../docs/doc-index.js";
5
4
  import { getProjectRepos, resolveRepoQualifiedRef, resolveRepoRoot, } from "../shared/specdojo-config.js";
6
5
  // A bounded source set keeps generated plans reviewable and prevents a broad glob from handing an
@@ -28,6 +27,23 @@ function assertInsideRoot(root, path, ref) {
28
27
  throw new Error(`Authoring source resolves outside its repository: ${ref}`);
29
28
  }
30
29
  }
30
+ const IGNORED_SOURCE_DIRECTORIES = new Set([".git", "node_modules"]);
31
+ function isExcludedSourceEntry(entry) {
32
+ if (entry.isSymbolicLink())
33
+ return true;
34
+ return entry.isDirectory() && IGNORED_SOURCE_DIRECTORIES.has(entry.name);
35
+ }
36
+ /**
37
+ * Lists regular files matching the patterns as slash-separated paths relative to `cwd`.
38
+ * node:fs globSync skips dot entries unless a pattern names them; symbolic links found while
39
+ * walking, `.git`, and `node_modules` are excluded.
40
+ */
41
+ function globSourceFiles(patterns, cwd) {
42
+ const root = resolve(cwd);
43
+ return globSync(patterns, { cwd: root, withFileTypes: true, exclude: isExcludedSourceEntry })
44
+ .filter((entry) => entry.isFile())
45
+ .map((entry) => relative(root, resolve(entry.parentPath, entry.name)).replaceAll("\\", "/"));
46
+ }
31
47
  function expandPath(root, rawPath, ref) {
32
48
  if (!existsSync(root) || !statSync(root).isDirectory()) {
33
49
  throw new Error(`Repository root for authoring source does not exist: ${ref}`);
@@ -38,26 +54,16 @@ function expandPath(root, rawPath, ref) {
38
54
  if (existsSync(exact)) {
39
55
  assertInsideRoot(root, exact, ref);
40
56
  if (statSync(exact).isDirectory()) {
41
- paths = globSync("**/*", {
42
- cwd: exact,
43
- onlyFiles: true,
44
- dot: false,
45
- followSymbolicLinks: false,
46
- ignore: ["**/.git/**", "**/node_modules/**"],
47
- }).map((entry) => posix.join(normalized, entry.replaceAll("\\", "/")));
57
+ paths = globSourceFiles(["**/*"], exact).map((entry) => posix.join(normalized, entry));
48
58
  }
49
59
  else {
50
60
  paths = [normalized];
51
61
  }
52
62
  }
53
63
  else {
54
- paths = globSync(normalized, {
55
- cwd: root,
56
- onlyFiles: true,
57
- dot: false,
58
- followSymbolicLinks: false,
59
- ignore: ["**/.git/**", "**/node_modules/**"],
60
- }).map((entry) => entry.replaceAll("\\", "/"));
64
+ // A pattern that does not end with "*" also matches the files below a matching directory.
65
+ const patterns = normalized.endsWith("*") ? [normalized] : [normalized, `${normalized}/**`];
66
+ paths = globSourceFiles(patterns, root);
61
67
  }
62
68
  const sorted = [...new Set(paths)].sort();
63
69
  if (sorted.length === 0) {
@@ -372,10 +372,12 @@ export function buildRegisterItemContent(opts) {
372
372
  description: opts.fields.description,
373
373
  type: opts.fields.type,
374
374
  ...(opts.fields.track ? { track: opts.fields.track } : {}),
375
+ ...(opts.fields.domains !== undefined ? { domains: opts.fields.domains } : {}),
375
376
  priority: opts.fields.priority,
376
377
  ...(opts.fields.difficulty ? { difficulty: opts.fields.difficulty } : {}),
377
378
  owner: opts.fields.owner,
378
379
  registeredAt: opts.fields.registeredAt,
380
+ ...(opts.fields.startOn !== undefined ? { startOn: opts.fields.startOn } : {}),
379
381
  due: opts.fields.due,
380
382
  completedAt: opts.fields.completedAt,
381
383
  conclusion: opts.fields.conclusion,
@@ -11,7 +11,7 @@ import { validateRegisterApproachTargetsForProject } from "./approach.js";
11
11
  import { normalizeDependsOn, validateRegisterDependencies } from "./dependency.js";
12
12
  import { normalizeDerivedFrom, validateDerivedFrom } from "./derivation.js";
13
13
  import { delegateExternalRegisterAdd } from "./external-project.js";
14
- import { validateRegisterTrack } from "./epic.js";
14
+ import { validateRegisterDomains, validateRegisterStartOn, validateRegisterTrack } from "./epic.js";
15
15
  import { isAuthoringApproach } from "../kata/authoring.js";
16
16
  function collectTarget(value, previous = []) {
17
17
  return [...previous, value];
@@ -76,6 +76,7 @@ export function registerCreateCommands(reg, dependencies) {
76
76
  addProjectOption(addCmd);
77
77
  addCmd.requiredOption("--type <type>", `Item type: ${VALID_TYPES.join(" | ")}`);
78
78
  addCmd.option("--track <track>", "Track governed by an epic (required for epic)");
79
+ addCmd.option("--domain <domain>", "Catalog domain governed by an epic (repeatable)", collectTarget);
79
80
  addCmd.requiredOption("--title <title>", "Short title for the item");
80
81
  addCmd.option("--input <text>", "Premise recorded in the ticket (repeatable)", collectTarget);
81
82
  addCmd.option("--description <text>", "Description shown in the list", "_TODO_");
@@ -85,6 +86,7 @@ export function registerCreateCommands(reg, dependencies) {
85
86
  addCmd.option("--owner <owner>", "Owner or role", "_TODO_");
86
87
  addCmd.option("--registered <datetime>", "Registration date-time (RFC 3339 with time zone, or _TODO_; defaults to now in UTC)");
87
88
  addCmd.option("--due <date>", "Due date (YYYY-MM-DD, -, or _TODO_)", "_TODO_");
89
+ addCmd.option("--start-on <date>", "Planned epic start date (YYYY-MM-DD; - omits)");
88
90
  addCmd.option("--completed <datetime>", "Completion date-time (RFC 3339 with time zone, or -)", "-");
89
91
  addCmd.option("--conclusion <text>", "Conclusion or resolution summary", "-");
90
92
  addCmd.option("--target-path <path>", "Repository-relative deliverable file path");
@@ -156,8 +158,12 @@ export function registerCreateCommands(reg, dependencies) {
156
158
  validateTargetsWithoutApproach: opts.target !== undefined || opts.source !== undefined,
157
159
  });
158
160
  const track = opts.track?.trim();
161
+ validateRegisterStartOn(opts.type, opts.startOn, true);
159
162
  validateRegisterTrack(paths.projectId, opts.type, track);
163
+ const domains = opts.domain?.map((value) => value.trim());
164
+ validateRegisterDomains(opts.type, domains);
160
165
  const fields = {
166
+ ...(domains !== undefined ? { domains } : {}),
161
167
  ...(track !== undefined ? { track } : {}),
162
168
  type: opts.type,
163
169
  title: opts.title,
@@ -168,6 +174,7 @@ export function registerCreateCommands(reg, dependencies) {
168
174
  status: opts.status,
169
175
  owner: opts.owner,
170
176
  registeredAt: registeredAt ?? nowUtcTimestamp(),
177
+ ...(opts.startOn !== undefined && opts.startOn !== "-" ? { startOn: opts.startOn } : {}),
171
178
  due: opts.due,
172
179
  completedAt: completedAt ?? CELL_NONE,
173
180
  conclusion: opts.conclusion,
@@ -258,12 +265,14 @@ export function registerUpdateCommand(reg, dependencies) {
258
265
  addProjectOption(updateCmd);
259
266
  updateCmd.requiredOption("--id <id>", "Item ID (PJR-XXXX)");
260
267
  updateCmd.option("--track <track>", "Replace the track governed by an epic");
268
+ updateCmd.option("--domain <domain>", "Replace epic domains (repeatable; - removes)", collectTarget);
261
269
  updateCmd.option("--title <title>", "Update title");
262
270
  updateCmd.option("--description <text>", "Update description");
263
271
  updateCmd.option("--priority <priority>", `Update priority: ${VALID_PRIORITIES.join(" | ")}`);
264
272
  updateCmd.option("--difficulty <difficulty>", `Update difficulty: ${VALID_DIFFICULTIES.join(" | ")}; use - to remove`);
265
273
  updateCmd.option("--owner <owner>", "Update owner or role");
266
274
  updateCmd.option("--due <date>", "Update due date (YYYY-MM-DD, -, or _TODO_)");
275
+ updateCmd.option("--start-on <date>", "Update planned epic start date (YYYY-MM-DD; - removes)");
267
276
  updateCmd.option("--conclusion <text>", "Update conclusion or use - to remove it");
268
277
  updateCmd.option("--block-reason <text>", "Update the waiting reason or use - to remove it");
269
278
  updateCmd.option("--autopilot <approval>", "Night orchestrator approval: approved, or - to revoke");
@@ -289,12 +298,14 @@ export function registerUpdateCommand(reg, dependencies) {
289
298
  const item = view.item;
290
299
  const hasUpdates = [
291
300
  "track",
301
+ "domain",
292
302
  "title",
293
303
  "description",
294
304
  "priority",
295
305
  "difficulty",
296
306
  "owner",
297
307
  "due",
308
+ "startOn",
298
309
  "conclusion",
299
310
  "blockReason",
300
311
  "autopilot",
@@ -311,7 +322,7 @@ export function registerUpdateCommand(reg, dependencies) {
311
322
  "topic",
312
323
  ].some((key) => opts[key] !== undefined);
313
324
  if (!hasUpdates) {
314
- throw new Error("At least one field option must be specified (--track, --title, --description, --priority, --difficulty, --owner, --due, --conclusion, --block-reason, --autopilot, --approach, --target, --source, --input, --from, --depends-on, --commit-type, --commit-scope, --topic)");
325
+ throw new Error("At least one field option must be specified (--track, --domain, --title, --description, --priority, --difficulty, --owner, --due, --start-on, --conclusion, --block-reason, --autopilot, --approach, --target, --source, --input, --from, --depends-on, --commit-type, --commit-scope, --topic)");
315
326
  }
316
327
  if (opts.priority !== undefined &&
317
328
  !VALID_PRIORITIES.includes(opts.priority)) {
@@ -432,6 +443,9 @@ export function registerUpdateCommand(reg, dependencies) {
432
443
  (authoring && opts.source !== undefined && (item.targets?.length ?? 0) > 1);
433
444
  const shouldUpdateSources = opts.source !== undefined || (authoring && providedLegacySources.length > 0);
434
445
  const approachTargetUpdates = {
446
+ ...(opts.startOn !== undefined
447
+ ? { start_on: opts.startOn === "-" ? REMOVE_REGISTER_ITEM_FIELD : opts.startOn }
448
+ : {}),
435
449
  ...(opts.dependsOn !== undefined
436
450
  ? { depends_on: nextDependsOn ?? REMOVE_REGISTER_ITEM_FIELD }
437
451
  : {}),
@@ -478,10 +492,21 @@ export function registerUpdateCommand(reg, dependencies) {
478
492
  : {}),
479
493
  };
480
494
  const track = opts.track === undefined ? item.track : opts.track.trim();
481
- validateRegisterTrack(paths.projectId, item.type, track);
495
+ validateRegisterStartOn(item.type, opts.startOn, true);
496
+ validateRegisterTrack(paths.projectId, item.type, track, item.id);
497
+ const domains = opts.domain?.map((value) => value.trim());
498
+ const removeDomains = domains?.length === 1 && domains[0] === "-";
499
+ if (domains !== undefined) {
500
+ validateRegisterDomains(item.type, removeDomains ? [] : domains);
501
+ approachTargetUpdates.domains = removeDomains ? REMOVE_REGISTER_ITEM_FIELD : domains;
502
+ }
482
503
  const inputs = normalizeRegisterInput(opts.input, true);
483
504
  const updated = {
484
505
  ...item,
506
+ ...(opts.startOn !== undefined
507
+ ? { startOn: opts.startOn === "-" ? undefined : opts.startOn }
508
+ : {}),
509
+ ...(domains !== undefined ? { domains: removeDomains ? undefined : domains } : {}),
485
510
  ...(inputs !== undefined ? { inputs } : {}),
486
511
  ...(track !== undefined ? { track } : {}),
487
512
  ...(opts.title !== undefined ? { title: opts.title } : {}),
@@ -12,6 +12,7 @@ import { load } from "../shared/yaml.js";
12
12
  export const CATALOG_LESS_APPROACHES = [
13
13
  "draft",
14
14
  "fully-guided",
15
+ "condense",
15
16
  "recipe-guided",
16
17
  "freeform",
17
18
  "retrofit",
@@ -74,6 +75,10 @@ export function resolveRegisterDeliverableTarget(opts) {
74
75
  if (opts.catalogPath) {
75
76
  try {
76
77
  const resolved = resolveDeliverableByDocId(opts.catalogPath, opts.projectId, opts.targetId, opts.repoRoot);
78
+ if (opts.approach === "condense" &&
79
+ !existsSync(resolve(opts.repoRoot, resolved.info.resolvedPath))) {
80
+ throw new Error(`Approach "condense" requires an existing deliverable: ${opts.targetId}`);
81
+ }
77
82
  return { info: resolved.info, catalogless: false };
78
83
  }
79
84
  catch (error) {
@@ -102,7 +107,10 @@ export function resolveRegisterDeliverableTarget(opts) {
102
107
  }
103
108
  if (!rulebook)
104
109
  throw new Error(`Target ${opts.targetId} requires --target-rulebook or specdojo.rulebook`);
105
- if ((opts.approach === "finalize" || opts.approach === "bootstrap-finalize") && !existing) {
110
+ if ((opts.approach === "condense" ||
111
+ opts.approach === "finalize" ||
112
+ opts.approach === "bootstrap-finalize") &&
113
+ !existing) {
106
114
  throw new Error(`Approach "${opts.approach}" requires an existing deliverable: ${opts.targetId}`);
107
115
  }
108
116
  const refs = {