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,66 @@
1
+ import { join } from "node:path";
2
+ import { mkdirSync } from "node:fs";
3
+ import { isJobCommandTask, loadJobDefinition, materializeJobRun, resolveJobPaths, } from "../../job/job.js";
4
+ import { resolveProjectPaths } from "../project.js";
5
+ import { releaseLock, tryAcquireLock } from "../slot-lock.js";
6
+ import { runJobMode } from "./job.js";
7
+ import { execLocksDir, ExecRunLockTimeoutError, inheritsExecRunLock } from "./lock.js";
8
+ import { withProjectExecRunLock } from "./shared.js";
9
+ /** A sequence waits for exclusive access, including when invoked by routine/cron. */
10
+ export async function runJobWithProjectLock(opts, resolver) {
11
+ const paths = resolveProjectPaths({ project: opts.project });
12
+ const definition = loadJobDefinition(resolveJobPaths(paths.projectId ?? opts.project), String(opts.job));
13
+ if (!isJobCommandTask(definition.task) || !definition.task.steps) {
14
+ await withProjectExecRunLock(opts, "run", () => runJobMode(opts, resolver));
15
+ return;
16
+ }
17
+ if (opts.dryRun) {
18
+ await runJobMode(opts, resolver);
19
+ return;
20
+ }
21
+ if (inheritsExecRunLock(paths.executionPath)) {
22
+ await withProjectExecRunLock(opts, "run", () => runJobMode(opts, resolver));
23
+ return;
24
+ }
25
+ const preview = await materializeJobRun({
26
+ projectId: paths.projectId ?? opts.project,
27
+ jobId: String(opts.job),
28
+ inputs: opts.input,
29
+ scheduledAt: opts.scheduledAt,
30
+ dryRun: true,
31
+ });
32
+ // Guard the logical Run while waiting too. A duplicate caller must not overwrite a
33
+ // running attempt with a timeout result. Different Runs still queue on the project lock.
34
+ mkdirSync(execLocksDir(paths.executionPath), { recursive: true });
35
+ const guard = tryAcquireLock(join(execLocksDir(paths.executionPath), `${preview.record.run_id}.sequence.lock`), { actor: "job-sequence" });
36
+ if (!guard)
37
+ throw new Error(`Job sequence already running: ${preview.record.run_id}`);
38
+ const frozenOpts = { ...opts, scheduledAt: preview.record.scheduled_at };
39
+ const waitSeconds = isJobCommandTask(preview.record.task)
40
+ ? (preview.record.task.lock_wait_seconds ?? 3600)
41
+ : 3600;
42
+ try {
43
+ if (preview.duplicateComplete) {
44
+ await runJobMode(frozenOpts, resolver);
45
+ return;
46
+ }
47
+ try {
48
+ await withProjectExecRunLock({
49
+ ...frozenOpts,
50
+ ifBusy: "wait",
51
+ lockWaitMs: waitSeconds * 1000,
52
+ }, "run", () => runJobMode(frozenOpts, resolver));
53
+ }
54
+ catch (error) {
55
+ if (!(error instanceof ExecRunLockTimeoutError))
56
+ throw error;
57
+ await runJobMode({
58
+ ...frozenOpts,
59
+ sequenceDeferredReason: `project lock wait timed out after ${waitSeconds} seconds`,
60
+ }, resolver);
61
+ }
62
+ }
63
+ finally {
64
+ releaseLock(guard);
65
+ }
66
+ }
@@ -0,0 +1,137 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { isAbsolute, relative, resolve, sep } from "node:path";
3
+ import { load } from "../../shared/yaml.js";
4
+ import { executeJobCommand, jobCommandText, recordJobSteps, } from "../../job/job.js";
5
+ import { recordCommandEvidence } from "../evidence.js";
6
+ function completionState(task, cwd) {
7
+ if (!task.completion)
8
+ return { status: "succeeded", reason: "command exited 0" };
9
+ const rule = task.completion;
10
+ const path = resolve(cwd, rule.path);
11
+ const rel = relative(cwd, path);
12
+ if (isAbsolute(rule.path) || rel === ".." || rel.startsWith(`..${sep}`))
13
+ return { status: "failed", reason: "completion.path must stay inside the repository" };
14
+ try {
15
+ const text = readFileSync(path, "utf8");
16
+ const frontmatter = text.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/)?.[1];
17
+ const document = path.endsWith(".json") ? JSON.parse(text) : load(frontmatter ?? text);
18
+ let value = document;
19
+ for (const field of rule.field.split(".")) {
20
+ value =
21
+ typeof value === "object" && value !== null && Object.hasOwn(value, field)
22
+ ? value[field]
23
+ : undefined;
24
+ }
25
+ if (typeof value === "string" && rule.succeeded.includes(value))
26
+ return { status: "succeeded", reason: "exit 0 and completion state accepted" };
27
+ if (typeof value === "string" && rule.deferred?.includes(value))
28
+ return { status: "deferred", reason: "completion state requires a later retry" };
29
+ return { status: "failed", reason: "completion state missing or not accepted" };
30
+ }
31
+ catch {
32
+ return { status: "failed", reason: "completion state file unavailable or invalid" };
33
+ }
34
+ }
35
+ /** Runs frozen commands serially. Logs are evidence only, never a completion protocol. */
36
+ export async function executeJobSequence(params) {
37
+ const { task, runId, runPath, cwd, executionPath, deferredReason } = params;
38
+ const startedAt = new Date().toISOString();
39
+ const steps = (task.steps ?? []).map(({ id }) => ({
40
+ id,
41
+ status: "deferred",
42
+ reason: deferredReason ?? "preceding step has not completed",
43
+ }));
44
+ recordJobSteps(runPath, steps);
45
+ if (!deferredReason) {
46
+ for (const [index, step] of (task.steps ?? []).entries()) {
47
+ steps[index] = { id: step.id, status: "running", started_at: new Date().toISOString() };
48
+ recordJobSteps(runPath, steps);
49
+ let outcome;
50
+ try {
51
+ outcome = await executeJobCommand(step.command, cwd, step.timeout_seconds === undefined ? {} : { timeoutMs: step.timeout_seconds * 1000 });
52
+ }
53
+ catch {
54
+ steps[index] = {
55
+ ...steps[index],
56
+ status: "failed",
57
+ completed_at: new Date().toISOString(),
58
+ reason: "command execution threw",
59
+ };
60
+ recordJobSteps(runPath, steps);
61
+ if (step.on_failure !== "continue")
62
+ break;
63
+ continue;
64
+ }
65
+ const verdict = outcome.timedOut
66
+ ? {
67
+ status: "deferred",
68
+ reason: `command exceeded ${step.timeout_seconds} seconds`,
69
+ }
70
+ : outcome.error
71
+ ? { status: "failed", reason: "command could not be executed" }
72
+ : outcome.exitCode === 75
73
+ ? {
74
+ status: "deferred",
75
+ reason: "command exited 75 (temporary unavailability)",
76
+ }
77
+ : outcome.exitCode !== 0
78
+ ? {
79
+ status: "failed",
80
+ reason: `command exited ${outcome.exitCode ?? "by signal"}`,
81
+ }
82
+ : completionState(step, cwd);
83
+ steps[index] = {
84
+ id: step.id,
85
+ ...verdict,
86
+ started_at: outcome.startedAt,
87
+ completed_at: outcome.completedAt,
88
+ exit_code: outcome.exitCode,
89
+ };
90
+ recordJobSteps(runPath, steps);
91
+ const evidence = recordCommandEvidence({
92
+ repoRoot: cwd,
93
+ worktreePath: cwd,
94
+ executionPath,
95
+ taskId: runId,
96
+ runId: `${runId}-attempt-${params.attempt}-step-${step.id}`,
97
+ actor: "specdojo-runner",
98
+ command: step.command,
99
+ shell: process.platform === "win32" ? process.env.ComSpec || "cmd.exe" : "/bin/sh -eu",
100
+ startedAt: outcome.startedAt,
101
+ completedAt: outcome.completedAt,
102
+ exitCode: outcome.exitCode,
103
+ stdout: outcome.stdout,
104
+ stderr: outcome.stderr,
105
+ stdoutTruncated: outcome.stdoutTruncated,
106
+ stderrTruncated: outcome.stderrTruncated,
107
+ ...(outcome.error ? { error: outcome.error } : {}),
108
+ });
109
+ steps[index] = {
110
+ id: step.id,
111
+ ...verdict,
112
+ started_at: outcome.startedAt,
113
+ completed_at: outcome.completedAt,
114
+ exit_code: outcome.exitCode,
115
+ evidence_ref: relative(cwd, evidence.evidencePath).split(sep).join("/"),
116
+ };
117
+ recordJobSteps(runPath, steps);
118
+ if (verdict.status !== "succeeded" && step.on_failure !== "continue")
119
+ break;
120
+ }
121
+ }
122
+ const failed = steps.some((step) => step.status === "failed");
123
+ const deferred = steps.some((step) => step.status === "deferred");
124
+ return {
125
+ command: jobCommandText(task),
126
+ startedAt,
127
+ completedAt: new Date().toISOString(),
128
+ exitCode: failed ? 1 : deferred ? 75 : 0,
129
+ stdout: JSON.stringify({ steps }),
130
+ stderr: "",
131
+ stdoutTruncated: false,
132
+ stderrTruncated: false,
133
+ ...(failed || deferred
134
+ ? { reason: deferredReason ?? "sequence contains failed or deferred steps" }
135
+ : {}),
136
+ };
137
+ }
@@ -1,23 +1,28 @@
1
+ import { readPlanFile } from "../../shared/plan-conventions.js";
1
2
  import { spawnSync } from "node:child_process";
2
3
  import { existsSync, readFileSync, writeFileSync } from "node:fs";
3
4
  import { relative, resolve, sep } from "node:path";
5
+ import { completeJobRun, executeJobCommand, generateJobReviewPlan, isJobCommandTask, jobCommandText, jobRunUsesReviewedIntegration, loadJobDefinition, loadJobRunRecord, materializeJobRun, recordJobRunReview, resolveJobPaths, resolveJobReviewAgentNominations, } from "../../job/job.js";
4
6
  import { selfRunArgs } from "../../shared/spawn-self.js";
7
+ import { specdojoRootDir } from "../../shared/specdojo-config.js";
5
8
  import { loadExecDefaultsConfig, resolveMemberCommand, } from "../agent-config.js";
9
+ import { recordCommandEvidence } from "../evidence.js";
10
+ import { runPostIntegration } from "../post-integration.js";
11
+ import { formatMarkdownFile } from "../format.js";
12
+ import { createPipelineState, pipelineStateLocation, updatePipelineStage, writePipelineState, } from "../pipeline-state.js";
6
13
  import { activateResolvedProjectPaths, resolveProjectPaths } from "../project.js";
7
- import { specdojoRootDir } from "../../shared/specdojo-config.js";
8
- import { ROUTINE_BUSY_SKIP_EXIT_CODE, ROUTINE_EXEC_ENV } from "./lock.js";
14
+ import { evidenceForReporter } from "../reporter.js";
9
15
  import { isResultUnfilled, readResultFrontmatterSnapshot, renderReporterResult, scaffoldResult, stripLeadingListMarker, updateResultStatus, } from "../results.js";
10
- import { formatMarkdownFile } from "../format.js";
11
- import { completeJobRun, executeJobCommand, generateJobReviewPlan, isJobCommandTask, jobRunUsesReviewedIntegration, loadJobDefinition, loadJobRunRecord, materializeJobRun, recordJobRunReview, resolveJobPaths, resolveJobReviewAgentNominations, } from "../../job/job.js";
12
- import { ensureExecWorktree, formatGitResultFailure, gitOutput, gitResult, resolveWorktreeBase, summarizeGitHookFailure, } from "../worktree.js";
16
+ import { runLogPath, taskRecordPrefixes } from "../run-records.js";
13
17
  import { mergeWorktreeIntoCurrent, removeWorktree, stabilizeCommitTargets, stageCommitTargets, worktreeStatusPaths, } from "../worktree-ops.js";
14
- import { recordCommandEvidence } from "../evidence.js";
15
- import { evidenceForReporter } from "../reporter.js";
16
- import { createPipelineState, pipelineStateLocation, updatePipelineStage, writePipelineState, } from "../pipeline-state.js";
17
- import { configuredWorktreeBase, resolveAgentOverride, resolveExecDefaultsPath, selectCandidates, } from "./shared.js";
18
- import { executorRequirements, expandPromptRefs, loadRosterForExecutionPath, resolveReporterAgentCandidates, } from "./agent.js";
18
+ import { ensureExecWorktree, formatGitResultFailure, gitEnvironment, gitOutput, gitResult, resolveWorktreeBase, summarizeGitHookFailure, } from "../worktree.js";
19
19
  import { runAgentPipeline, runReporterStage } from "./agent-pipeline.js";
20
+ import { executorRequirements, expandPromptRefs, loadRosterForExecutionPath, resolveReporterAgentCandidates, } from "./agent.js";
20
21
  import { resolveInPlaceCommand, spawnAgentInPlace } from "./in-place.js";
22
+ import { ROUTINE_BUSY_SKIP_EXIT_CODE, ROUTINE_EXEC_ENV } from "./lock.js";
23
+ import { configuredWorktreeBase, resolveAgentOverride, resolveExecDefaultsPath, selectCandidates, } from "./shared.js";
24
+ import { localJobNoopPath, snapshotJobOutput } from "../../job/noop.js";
25
+ import { executeJobSequence } from "./job-sequence.js";
21
26
  async function runCommandJobMode(params) {
22
27
  const { opts, record, runPath, planPath, projectId, schedulePath, executionPath } = params;
23
28
  if (!isJobCommandTask(record.task))
@@ -31,7 +36,7 @@ async function runCommandJobMode(params) {
31
36
  const repoRoot = specdojoRootDir();
32
37
  const roster = loadRosterForExecutionPath(executionPath);
33
38
  const execDefaults = loadExecDefaultsConfig(resolveExecDefaultsPath(opts, schedulePath), executionPath);
34
- const analysisNickname = record.task.analysis
39
+ const analysisNickname = record.task.analysis && !opts.sequenceDeferredReason
35
40
  ? opts.reporterBy?.trim() || record.task.analysis.agent
36
41
  : undefined;
37
42
  const analysisResolution = analysisNickname
@@ -55,7 +60,9 @@ async function runCommandJobMode(params) {
55
60
  process.stdout.write(`[dry-run] precondition:\n${record.task.precondition.command}\n`);
56
61
  process.stdout.write(`[dry-run] precondition skip_when: ${record.task.precondition.skip_when}\n`);
57
62
  }
58
- process.stdout.write(`[dry-run] command:\n${record.task.command}\n`);
63
+ process.stdout.write(`[dry-run] command:\n${jobCommandText(record.task)}\n`);
64
+ if (record.task.steps)
65
+ process.stdout.write(`[dry-run] sequence:\n${JSON.stringify(record.task.steps, null, 2)}\n`);
59
66
  if (analysisCandidate) {
60
67
  process.stdout.write(`[dry-run] agent: ${analysisCandidate.actor ?? ""} (analysis reporter)\n`);
61
68
  process.stdout.write(`[dry-run] reporter command: ${analysisCandidate.command}\n`);
@@ -77,9 +84,19 @@ async function runCommandJobMode(params) {
77
84
  startedAt: new Date().toISOString(),
78
85
  ...(record.task.targets ? { targets: record.task.targets } : {}),
79
86
  });
80
- const evidenceRunId = `attempt-${record.attempts.length}`;
87
+ const evidenceRunId = record.run_id;
81
88
  process.stdout.write(`Running Job Run ${record.run_id} command in place.\n`);
82
- const commandOutcome = await executeJobCommand(record.task.command, repoRoot);
89
+ const commandOutcome = record.task.steps
90
+ ? await executeJobSequence({
91
+ task: record.task,
92
+ runId: record.run_id,
93
+ attempt: record.attempts.length,
94
+ runPath,
95
+ cwd: repoRoot,
96
+ executionPath,
97
+ deferredReason: opts.sequenceDeferredReason,
98
+ })
99
+ : await executeJobCommand(record.task.command, repoRoot);
83
100
  const commandPartial = !commandOutcome.error &&
84
101
  record.task.partial_exit_code !== undefined &&
85
102
  commandOutcome.exitCode === record.task.partial_exit_code;
@@ -90,7 +107,7 @@ async function runCommandJobMode(params) {
90
107
  taskId: record.run_id,
91
108
  runId: evidenceRunId,
92
109
  actor: "specdojo-runner",
93
- command: record.task.command,
110
+ command: jobCommandText(record.task),
94
111
  shell: process.platform === "win32" ? process.env.ComSpec || "cmd.exe" : "/bin/sh -eu",
95
112
  startedAt: commandOutcome.startedAt,
96
113
  completedAt: commandOutcome.completedAt,
@@ -115,9 +132,11 @@ async function runCommandJobMode(params) {
115
132
  });
116
133
  const reason = commandAccepted
117
134
  ? undefined
118
- : commandOutcome.error
119
- ? `command spawn failed: ${commandOutcome.error}`
120
- : `command exited with code ${commandOutcome.exitCode ?? "unknown"}`;
135
+ : commandOutcome.reason
136
+ ? commandOutcome.reason
137
+ : commandOutcome.error
138
+ ? `command spawn failed: ${commandOutcome.error}`
139
+ : `command exited with code ${commandOutcome.exitCode ?? "unknown"}`;
121
140
  await renderReporterResult(resultPath, {
122
141
  schema_version: 1,
123
142
  mode: "edit",
@@ -149,14 +168,12 @@ async function runCommandJobMode(params) {
149
168
  }
150
169
  else if (commandPartial) {
151
170
  process.stdout.write(`Job Run partial: ${record.run_id}\n`);
152
- if (record.trigger === "routine") {
153
- process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=partial\n`);
154
- }
155
171
  }
156
172
  else {
157
173
  process.stdout.write(`Job Run failed: ${record.run_id}\n`);
158
174
  process.exitCode = commandOutcome.exitCode || 1;
159
175
  }
176
+ process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=${commandSucceeded ? "succeeded" : commandPartial ? "partial" : "failed"}\n`);
160
177
  return;
161
178
  }
162
179
  const stateLocation = pipelineStateLocation({
@@ -191,7 +208,7 @@ async function runCommandJobMode(params) {
191
208
  schedulePath,
192
209
  executionPath,
193
210
  reporterCandidates: [analysisCandidate],
194
- planPrompt: expandPromptRefs(readFileSync(planPath, "utf8")),
211
+ planPrompt: expandPromptRefs(readPlanFile(planPath)),
195
212
  resultPath,
196
213
  execDefaults,
197
214
  evidence: recorded.evidence,
@@ -211,14 +228,12 @@ async function runCommandJobMode(params) {
211
228
  });
212
229
  if (reporterOutcome.exitCode === 0) {
213
230
  process.stdout.write(`Job Run ${commandPartial ? "partial" : "complete"}: ${record.run_id}\n`);
214
- if (commandPartial && record.trigger === "routine") {
215
- process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=partial\n`);
216
- }
217
231
  }
218
232
  else {
219
233
  process.stdout.write(`Job Run failed: ${record.run_id}\n`);
220
234
  process.exitCode = 1;
221
235
  }
236
+ process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=${reporterOutcome.exitCode === 0 ? (commandPartial ? "partial" : "succeeded") : "failed"}\n`);
222
237
  }
223
238
  const ACCEPTED_JOB_REVIEW_VERDICTS = new Set(["complete", "complete-with-findings"]);
224
239
  function acceptsJobReview(record, verdict) {
@@ -383,6 +398,8 @@ async function runJobWorktreeMode(opts) {
383
398
  });
384
399
  if (preview.duplicateComplete) {
385
400
  process.stdout.write(`Job Run already complete: ${preview.record.run_id} (${preview.record.state})\n`);
401
+ if (preview.record.state === "noop")
402
+ process.stdout.write(`[routine-job] noop state=noop\n`);
386
403
  if (trigger === "routine" && preview.record.state === "partial") {
387
404
  process.stdout.write(`[routine-job] complete run_id=${preview.record.run_id} state=partial\n`);
388
405
  }
@@ -420,7 +437,7 @@ async function runJobWorktreeMode(opts) {
420
437
  const child = spawnSync(executable, fullArgs, {
421
438
  cwd: worktree.path,
422
439
  env: {
423
- ...process.env,
440
+ ...gitEnvironment(),
424
441
  [ROUTINE_EXEC_ENV]: trigger === "routine" ? "1" : "0",
425
442
  [JOB_REVIEW_WORKTREE_CHILD_ENV]: "1",
426
443
  },
@@ -441,10 +458,23 @@ async function runJobWorktreeMode(opts) {
441
458
  const worktreeExecutionPath = resolve(worktree.path, executionRel);
442
459
  const worktreeJobPaths = resolveJobPaths(projectId);
443
460
  const runPath = resolve(worktree.path, relative(repoRoot, preview.runPath));
461
+ if (child.status === 0 && existsSync(localJobNoopPath(executionPath, preview.record.run_id))) {
462
+ removeWorktree({
463
+ context: { repoRoot, schedulePath, executionPath },
464
+ worktree,
465
+ taskId: `${preview.record.run_id}-review`,
466
+ deleteBranch: true,
467
+ });
468
+ process.stdout.write(`[routine-job] noop state=noop\n`);
469
+ return;
470
+ }
444
471
  if (!existsSync(runPath)) {
445
472
  throw new Error(`Job Run record was not created in worktree: ${preview.record.run_id}`);
446
473
  }
447
474
  let record = loadJobRunRecord(runPath);
475
+ // The child may fail before printing a completion marker. Its worktree still owns
476
+ // the diagnostic Run record even if commit or review subsequently fails.
477
+ process.stdout.write(`[routine-job] recorded run_id=${record.run_id} state=${record.state}\n`);
448
478
  const outputPaths = worktreeStatusPaths(worktree.path);
449
479
  const outputCommit = commitJobPaths(worktree.path, outputPaths, `chore(routine): ${preview.definition.name}`, `Job Run: ${record.run_id}\nState: ${record.state}`);
450
480
  const reviewTaskId = `${record.run_id}-review`;
@@ -491,7 +521,7 @@ async function runJobWorktreeMode(opts) {
491
521
  executor: agents.executor,
492
522
  reporterCandidates: agents.reporterCandidates,
493
523
  planPath,
494
- planPrompt: expandPromptRefs(readFileSync(planPath, "utf8")),
524
+ planPrompt: expandPromptRefs(readPlanFile(planPath)),
495
525
  resultPath,
496
526
  execDefaults,
497
527
  mode: "review",
@@ -527,7 +557,7 @@ async function runJobWorktreeMode(opts) {
527
557
  process.chdir(originalCwd);
528
558
  }
529
559
  const allowedReviewPrefixes = [
530
- `${relative(worktree.path, worktreeExecutionPath).split(sep).join("/")}/exec/evidence/${reviewTaskId}/`,
560
+ ...taskRecordPrefixes(relative(worktree.path, worktreeExecutionPath), reviewTaskId),
531
561
  ];
532
562
  const allowedReviewFiles = new Set([
533
563
  relative(worktree.path, planPath).split(sep).join("/"),
@@ -570,12 +600,20 @@ async function runJobWorktreeMode(opts) {
570
600
  process.exitCode = child.status || 1;
571
601
  return;
572
602
  }
603
+ const preIntegrationCommit = gitOutput(repoRoot, ["rev-parse", "HEAD"]).trim();
573
604
  mergeWorktreeIntoCurrent({
574
605
  context: { repoRoot, schedulePath, executionPath },
575
606
  worktree,
576
607
  taskId: reviewTaskId,
577
608
  message: `chore(routine): merge ${record.run_id}`,
578
609
  });
610
+ await runPostIntegration({
611
+ entries: execDefaults.pipeline?.post_integration,
612
+ repoRoot,
613
+ baseCommit: preIntegrationCommit,
614
+ outputCommit: gitOutput(repoRoot, ["rev-parse", "HEAD"]).trim(),
615
+ logPath: runLogPath(resolve(repoRoot, relative(worktree.path, resultPath)), "post-integration.log"),
616
+ });
579
617
  removeWorktree({
580
618
  context: { repoRoot, schedulePath, executionPath },
581
619
  worktree,
@@ -584,11 +622,10 @@ async function runJobWorktreeMode(opts) {
584
622
  });
585
623
  process.stdout.write(`[routine-job] merged run_id=${record.run_id} state=${record.state} review=${verdict} branch=${worktree.branch}\n`);
586
624
  }
587
- export async function runJobMode(opts, resolvePipelineAgents) {
625
+ async function runJobModeUnchecked(opts, resolvePipelineAgents, isWorktreeChild) {
588
626
  const resolvedPaths = resolveProjectPaths({ project: opts.project });
589
627
  activateResolvedProjectPaths(resolvedPaths);
590
- const isWorktreeChild = process.env[JOB_REVIEW_WORKTREE_CHILD_ENV] === "1";
591
- if (!isWorktreeChild) {
628
+ if (!isWorktreeChild && !opts.sequenceDeferredReason) {
592
629
  // A Job's task.review declaration takes precedence over the caller: it routes the Run
593
630
  // through the reviewed integration path even without --worktree (routine action.commit).
594
631
  const reviewProjectId = resolvedPaths.projectId ?? opts.project ?? process.env.SPECDOJO_PROJECT ?? "";
@@ -614,6 +651,7 @@ export async function runJobMode(opts, resolvePipelineAgents) {
614
651
  scheduledAt: opts.scheduledAt,
615
652
  trigger,
616
653
  dryRun: !!opts.dryRun,
654
+ skipPrecondition: !!opts.sequenceDeferredReason,
617
655
  });
618
656
  const { definition, record, runPath, planPath } = materialized;
619
657
  if (materialized.preconditionSkipped) {
@@ -624,21 +662,34 @@ export async function runJobMode(opts, resolvePipelineAgents) {
624
662
  }
625
663
  if (materialized.duplicateComplete) {
626
664
  process.stdout.write(`Job Run already complete: ${record.run_id} (${record.state})\n`);
665
+ if (record.state === "noop")
666
+ process.stdout.write(`[routine-job] noop state=noop\n`);
627
667
  if (trigger === "routine" && record.state === "partial") {
628
668
  process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=partial\n`);
629
669
  }
630
670
  return;
631
671
  }
632
672
  if (isJobCommandTask(record.task)) {
633
- await runCommandJobMode({
634
- opts,
635
- record,
636
- runPath,
637
- planPath,
638
- projectId,
639
- schedulePath,
640
- executionPath,
641
- });
673
+ try {
674
+ await runCommandJobMode({
675
+ opts,
676
+ record,
677
+ runPath,
678
+ planPath,
679
+ projectId,
680
+ schedulePath,
681
+ executionPath,
682
+ });
683
+ }
684
+ catch (error) {
685
+ completeJobRun({
686
+ projectId,
687
+ runPath,
688
+ status: "failed",
689
+ reason: error instanceof Error ? error.message : String(error),
690
+ });
691
+ throw error;
692
+ }
642
693
  return;
643
694
  }
644
695
  const task = {
@@ -696,7 +747,7 @@ export async function runJobMode(opts, resolvePipelineAgents) {
696
747
  ...(record.task.targets ? { targets: record.task.targets } : {}),
697
748
  });
698
749
  const resultScaffold = readResultFrontmatterSnapshot(resultPath);
699
- const prompt = expandPromptRefs(readFileSync(planPath, "utf8"));
750
+ const prompt = expandPromptRefs(readPlanFile(planPath));
700
751
  const repoRoot = specdojoRootDir();
701
752
  let exitCode;
702
753
  let reason;
@@ -743,4 +794,47 @@ export async function runJobMode(opts, resolvePipelineAgents) {
743
794
  process.stdout.write(`Job Run failed: ${record.run_id}\n`);
744
795
  process.exitCode = effectiveExit || 1;
745
796
  }
797
+ process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=${effectiveExit === 0 ? "succeeded" : "failed"}\n`);
798
+ }
799
+ export async function runJobMode(opts, resolvePipelineAgents) {
800
+ const isWorktreeChild = process.env[JOB_REVIEW_WORKTREE_CHILD_ENV] === "1";
801
+ // This marker routes only this Job's re-entry. Preconditions, commands, agents and
802
+ // their tests must choose their own worktree/review mode rather than inherit it.
803
+ delete process.env[JOB_REVIEW_WORKTREE_CHILD_ENV];
804
+ const paths = resolveProjectPaths({ project: opts.project });
805
+ activateResolvedProjectPaths(paths);
806
+ const projectId = paths.projectId ?? opts.project;
807
+ const definition = loadJobDefinition(resolveJobPaths(projectId), String(opts.job).trim());
808
+ if (opts.dryRun ||
809
+ opts.sequenceDeferredReason ||
810
+ jobRunUsesReviewedIntegration(definition, {
811
+ worktree: opts.worktree,
812
+ isWorktreeChild,
813
+ }) ||
814
+ // In-place command Jobs also support projects without a Git repository. There is
815
+ // nothing to commit there, and no reliable Git diff for suppressing Run records.
816
+ gitResult(specdojoRootDir(), ["rev-parse", "--is-inside-work-tree"]).status !== 0) {
817
+ await runJobModeUnchecked(opts, resolvePipelineAgents, isWorktreeChild);
818
+ return;
819
+ }
820
+ const preview = await materializeJobRun({
821
+ projectId,
822
+ jobId: String(opts.job).trim(),
823
+ inputs: opts.input,
824
+ scheduledAt: opts.scheduledAt,
825
+ dryRun: true,
826
+ });
827
+ if (preview.duplicateComplete) {
828
+ await runJobModeUnchecked(opts, resolvePipelineAgents, isWorktreeChild);
829
+ return;
830
+ }
831
+ const snapshot = snapshotJobOutput(specdojoRootDir(), paths.executionPath, preview.record);
832
+ await runJobModeUnchecked({ ...opts, scheduledAt: preview.record.scheduled_at }, resolvePipelineAgents, isWorktreeChild);
833
+ if (!existsSync(preview.runPath))
834
+ return;
835
+ const record = loadJobRunRecord(preview.runPath);
836
+ if (record.state === "succeeded" && !snapshot.hasChanges()) {
837
+ snapshot.discard(completeJobRun({ projectId, runPath: preview.runPath, status: "noop" }));
838
+ process.stdout.write(`[routine-job] noop state=noop\n`);
839
+ }
746
840
  }