specdojo 0.6.0 → 0.8.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 (366) hide show
  1. package/.github/agents/specdojo-orchestrator.md +3 -2
  2. package/CHANGELOG.md +193 -0
  3. package/README.md +2 -2
  4. package/dist/catalog/build.js +24 -1
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +33 -0
  8. package/dist/commands/init.js +6 -1
  9. package/dist/commands/night-orchestrator.js +6 -4
  10. package/dist/commands/orchestrator.js +10 -1
  11. package/dist/dashboard/dashboard-timeline.js +18 -16
  12. package/dist/dashboard/dashboard.js +612 -259
  13. package/dist/dashboard/epic-plan.js +81 -0
  14. package/dist/dashboard/exec-records.js +16 -20
  15. package/dist/dashboard/routines.js +8 -6
  16. package/dist/dashboard/timeline-build.js +5 -9
  17. package/dist/dashboard/timeline.js +9 -4
  18. package/dist/devcontainer/command.js +18 -0
  19. package/dist/devcontainer/host-script.js +21 -0
  20. package/dist/devcontainer/scaffold.js +22 -3
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/yaml-pages.js +125 -3
  23. package/dist/exec/agent-config.js +22 -0
  24. package/dist/exec/agent-plan.js +3 -2
  25. package/dist/exec/antigravity-session.js +154 -0
  26. package/dist/exec/commands.js +69 -21
  27. package/dist/exec/commit-hook-skips.js +78 -0
  28. package/dist/exec/core.js +19 -7
  29. package/dist/exec/events.js +159 -8
  30. package/dist/exec/evidence.js +64 -16
  31. package/dist/exec/handoff.js +9 -13
  32. package/dist/exec/limit.js +1 -1
  33. package/dist/exec/mechanical-result.js +45 -0
  34. package/dist/exec/migrate-records.js +249 -0
  35. package/dist/exec/parent-validation.js +160 -12
  36. package/dist/exec/pipeline-state.js +27 -5
  37. package/dist/exec/plan-markdownlint.js +89 -0
  38. package/dist/exec/plans-condense-findings.js +89 -0
  39. package/dist/exec/plans-core.js +24 -17
  40. package/dist/exec/plans-generation.js +52 -25
  41. package/dist/exec/plans-grade-findings.js +8 -3
  42. package/dist/exec/plans-kata-findings.js +61 -0
  43. package/dist/exec/plans-planning.js +3 -3
  44. package/dist/exec/plans-storage.js +12 -24
  45. package/dist/exec/register-resume.js +69 -42
  46. package/dist/exec/register.js +26 -22
  47. package/dist/exec/repo-integration-sync.js +8 -4
  48. package/dist/exec/repo-integration.js +21 -1
  49. package/dist/exec/reporter.js +121 -23
  50. package/dist/exec/results.js +85 -24
  51. package/dist/exec/review-completion.js +47 -0
  52. package/dist/exec/review-kata.js +109 -0
  53. package/dist/exec/run/agent-pipeline.js +75 -6
  54. package/dist/exec/run/agent.js +20 -7
  55. package/dist/exec/run/in-place.js +69 -32
  56. package/dist/exec/run/job.js +81 -24
  57. package/dist/exec/run/lifecycle-commands.js +264 -43
  58. package/dist/exec/run/mode-shared.js +11 -3
  59. package/dist/exec/run/register-command.js +12 -10
  60. package/dist/exec/run/register-core.js +20 -13
  61. package/dist/exec/run/register-mode.js +12 -12
  62. package/dist/exec/run/register-post-review.js +21 -9
  63. package/dist/exec/run/register-resume.js +28 -18
  64. package/dist/exec/run/register-state.js +10 -7
  65. package/dist/exec/run/register-worktree.js +60 -30
  66. package/dist/exec/run/schedule-mode.js +26 -6
  67. package/dist/exec/run/schedule-prepare.js +228 -45
  68. package/dist/exec/run/schedule-task.js +132 -25
  69. package/dist/exec/run/shared.js +4 -3
  70. package/dist/exec/run/trailing-records.js +35 -0
  71. package/dist/exec/run-records.js +2 -0
  72. package/dist/exec/strategy.js +1 -0
  73. package/dist/exec/trailing-records.js +242 -0
  74. package/dist/exec/trial-commands.js +3 -2
  75. package/dist/exec/validate-records-commit.js +110 -0
  76. package/dist/exec/validate-records.js +148 -0
  77. package/dist/exec/worktree-command.js +29 -16
  78. package/dist/exec/worktree-ops-commit.js +118 -59
  79. package/dist/exec/worktree-ops-lifecycle.js +77 -44
  80. package/dist/exec/worktree-ops-merge.js +13 -2
  81. package/dist/exec/worktree-ops.js +2 -2
  82. package/dist/exec/worktree.js +19 -2
  83. package/dist/grade/apply.js +32 -6
  84. package/dist/grade/command-inspect.js +2 -2
  85. package/dist/grade/command-run.js +2 -0
  86. package/dist/grade/command-shared.js +1 -1
  87. package/dist/grade/core.js +18 -5
  88. package/dist/grade/markdown.js +3 -3
  89. package/dist/grade/pipeline-state.js +15 -11
  90. package/dist/grade/plan.js +37 -17
  91. package/dist/grade/result.js +3 -3
  92. package/dist/grade/run.js +23 -3
  93. package/dist/grade/target-discovery.js +17 -4
  94. package/dist/grade/targets.js +12 -11
  95. package/dist/job/job.js +31 -17
  96. package/dist/job/noop.js +104 -0
  97. package/dist/register/core.js +2 -0
  98. package/dist/register/create-commands.js +28 -3
  99. package/dist/register/deliverable-target.js +9 -1
  100. package/dist/register/epic.js +104 -26
  101. package/dist/register/event-merge.js +3 -0
  102. package/dist/register/events.js +4 -0
  103. package/dist/register/external-project.js +3 -0
  104. package/dist/register/item.js +6 -0
  105. package/dist/register/maintenance-commands.js +4 -1
  106. package/dist/register/planning.js +7 -14
  107. package/dist/register/register.js +74 -32
  108. package/dist/register/track-domains.js +34 -0
  109. package/dist/register/track-plan.js +78 -0
  110. package/dist/register/transition-commands.js +8 -0
  111. package/dist/register/work-table.js +64 -0
  112. package/dist/review/grade.js +35 -13
  113. package/dist/routine/definition.js +4 -3
  114. package/dist/routine/failure.js +30 -0
  115. package/dist/routine/routine.js +56 -32
  116. package/dist/routine/storage.js +33 -0
  117. package/dist/schedule/schedule.js +1 -0
  118. package/dist/schedule/strategy-generate-document.js +26 -14
  119. package/dist/schedule/strategy-generate-scope.js +17 -45
  120. package/dist/schedule/strategy-generate.js +33 -3
  121. package/dist/schedule/strategy-profiles.js +86 -12
  122. package/dist/shared/agent-types.js +2 -0
  123. package/dist/shared/condense-records.js +25 -0
  124. package/dist/shared/deprecation.js +8 -0
  125. package/dist/shared/document-metadata.js +20 -0
  126. package/dist/shared/finding-cause.js +20 -0
  127. package/dist/shared/frontmatter-namespace.js +48 -0
  128. package/dist/shared/git.js +149 -15
  129. package/dist/shared/grade-result.js +17 -1
  130. package/dist/shared/local-state.js +20 -0
  131. package/dist/shared/markdownlint-config.js +8 -3
  132. package/dist/shared/plan-conventions.js +129 -0
  133. package/dist/shared/plan-templates.js +57 -41
  134. package/dist/shared/provider-scaffold.js +2 -0
  135. package/dist/shared/run-records.js +224 -0
  136. package/dist/shared/specdojo-config.js +39 -21
  137. package/dist/shared/specdojo-gitignore.js +1 -0
  138. package/dist/shared/text.js +65 -5
  139. package/dist/shared/timeline-index.js +2 -0
  140. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  141. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  142. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  143. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  144. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  145. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  146. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  147. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  148. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  149. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  150. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  151. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  152. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  153. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  154. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  155. package/docs/ja/specdojo/guides/docs-editing-guide.md +48 -0
  156. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  157. package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
  158. package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
  159. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  160. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  161. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  162. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  163. package/docs/ja/specdojo/guides/quick-start-guide.md +589 -807
  164. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
  165. package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
  166. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  167. package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
  168. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  169. package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
  170. package/docs/ja/specdojo/guides/schedule-operation-guide.md +41 -3
  171. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  172. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  173. package/docs/ja/specdojo/guides/use-case-guide.md +471 -74
  174. package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
  175. package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
  176. package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
  177. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  178. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
  179. package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
  180. package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
  181. package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
  182. package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
  183. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
  184. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
  185. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
  186. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
  187. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
  188. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
  189. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
  190. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
  191. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
  192. package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
  193. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
  194. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
  195. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
  196. package/docs/ja/specdojo/references/command-reference.md +146 -99
  197. package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
  198. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  199. package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
  200. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
  201. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
  202. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
  203. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
  204. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
  205. package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
  206. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
  207. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  208. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  209. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  210. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  211. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
  212. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
  213. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
  214. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  215. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
  216. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
  217. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
  218. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
  219. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
  220. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
  221. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
  222. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
  223. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
  224. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
  225. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
  226. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
  227. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
  228. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
  229. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
  230. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
  231. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
  232. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
  233. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
  234. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
  235. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
  236. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
  237. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
  238. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
  239. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
  240. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
  241. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
  242. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
  243. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
  244. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
  245. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
  246. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
  247. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
  248. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
  249. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
  250. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
  251. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
  252. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
  253. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
  254. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  255. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
  256. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
  257. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
  258. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  259. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  260. package/docs/ja/specdojo/samples/bds-sample.md +100 -21
  261. package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
  262. package/docs/ja/specdojo/samples/bes-sample.md +80 -21
  263. package/docs/ja/specdojo/samples/br-sample.md +68 -14
  264. package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
  265. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  266. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  267. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
  268. package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
  269. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  270. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  271. package/docs/ja/specdojo/samples/clis-sample.md +132 -0
  272. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  273. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  274. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  275. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  276. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  277. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  278. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  279. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  280. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  281. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  282. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  283. package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
  284. package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
  285. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
  286. package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
  287. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  288. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
  289. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
  290. package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
  291. package/docs/ja/specdojo/samples/sf-sample.md +121 -21
  292. package/docs/ja/specdojo/samples/sld-sample.md +107 -21
  293. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  294. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  295. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  296. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  297. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  298. package/docs/ja/specdojo/samples/uis-sample.md +164 -20
  299. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  300. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  301. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  302. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  303. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  304. package/docs/ja/specdojo/templates/br-template.md +64 -0
  305. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  306. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  307. package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
  308. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  309. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  310. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  311. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  312. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  313. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  314. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  315. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  316. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  317. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  318. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  319. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  320. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  321. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  322. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  323. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  324. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  325. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  326. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  327. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  328. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  329. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  330. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  331. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  332. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  333. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  334. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  335. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  336. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
  337. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +54 -3
  338. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
  339. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  340. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  341. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  342. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  343. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  344. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  345. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  346. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  347. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  348. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
  349. package/package.json +6 -3
  350. package/templates/antigravity/README.md +19 -46
  351. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  352. package/templates/antigravity/orchestrator.md +3 -2
  353. package/templates/antigravity/settings.edit.json +73 -0
  354. package/templates/antigravity/settings.orchestrator.json +15 -0
  355. package/templates/antigravity/settings.report.json +7 -0
  356. package/templates/antigravity/settings.review.json +7 -0
  357. package/templates/claude/agents/specdojo-orchestrator.md +3 -2
  358. package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
  359. package/templates/codex/orchestrator.md +3 -2
  360. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  361. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
  362. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  363. package/templates/devcontainer/tmux.conf +6 -0
  364. package/templates/init-agent-members.yaml +1 -0
  365. package/templates/init-exec-defaults.yaml +1 -1
  366. package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
@@ -1,26 +1,29 @@
1
+ import { readPlanFile } from "../../shared/plan-conventions.js";
1
2
  import { spawn } from "node:child_process";
2
3
  import { existsSync, readFileSync } from "node:fs";
3
- import { join, relative, resolve, sep } from "node:path";
4
+ import { relative, resolve, sep } from "node:path";
5
+ import { extractLocalId } from "../../schedule/phase-sets.js";
6
+ import { resolveAgentMember, specdojoRootDir, } from "../../shared/specdojo-config.js";
4
7
  import { loadExecDefaultsConfig, resolveMemberCommand, } from "../agent-config.js";
8
+ import { agentGitStateViolation, captureAgentGitStateSnapshot, changedAgentGitStateFields, } from "../agent-git-state.js";
9
+ import { agentProtectedConfigViolation, captureAgentProtectedConfigSnapshot, changedAgentProtectedConfigPaths, } from "../agent-protected-config.js";
10
+ import { enforceExecutorReportContract, executorStageResumeHint, recordExecutorEvidence, recordReporterFailureOutput, writeExecutorEvidence, } from "../evidence.js";
11
+ import { createPipelineState, pipelineStateLocation, updatePipelineStage, writePipelineState, } from "../pipeline-state.js";
12
+ import { archivePlan, buildInPlaceStem, finalizeResultSectionsForDeliverable, generateDeliverablePlan, generateSinglePlan, parsePlanTaskIdentity, resolveDeliverableTarget, stemFromPlanPath, targetDocIdsForScheduledTask, } from "../plans.js";
5
13
  import { activateResolvedProjectPaths, resolveProjectPaths } from "../project.js";
14
+ import { recordGitStateBlock, recordProtectedConfigBlock } from "../protection-handoff.js";
15
+ import { deriveReporterFacts, evidenceForReporter, runReporterWithFormatRetry, } from "../reporter.js";
16
+ import { isResultUnfilled, readResultFrontmatterSnapshot, renderReporterResult, scaffoldResult, updateResultStatus, } from "../results.js";
17
+ import { isRunRecordPath, recordRef, recordStem, taskRecordPaths } from "../run-records.js";
6
18
  import { randomHex } from "../shared.js";
7
- import { specdojoRootDir, resolveAgentMember, } from "../../shared/specdojo-config.js";
8
- import { extractLocalId } from "../../schedule/phase-sets.js";
9
- import { archivePlan, buildInPlaceStem, generateDeliverablePlan, generateSinglePlan, parsePlanTaskIdentity, resolveDeliverableTarget, finalizeResultSectionsForDeliverable, targetDocIdsForScheduledTask, stemFromPlanPath, } from "../plans.js";
19
+ import { configuredProductCheckouts, productRepoEnvironment, withAgentExtraRoots, withoutInheritedRepoEnvironment, } from "../task-repos.js";
10
20
  import { buildTaskView } from "../task-view.js";
11
- import { isResultUnfilled, readResultFrontmatterSnapshot, renderReporterResult, scaffoldResult, updateResultStatus, } from "../results.js";
12
21
  import { gitEnvironment } from "../worktree.js";
13
- import { agentProtectedConfigViolation, captureAgentProtectedConfigSnapshot, changedAgentProtectedConfigPaths, } from "../agent-protected-config.js";
14
- import { agentGitStateViolation, captureAgentGitStateSnapshot, changedAgentGitStateFields, } from "../agent-git-state.js";
15
- import { recordGitStateBlock, recordProtectedConfigBlock } from "../protection-handoff.js";
16
- import { recordExecutorEvidence, recordReporterFailureOutput, writeExecutorEvidence, } from "../evidence.js";
17
- import { deriveReporterFacts, evidenceForReporter, runReporterWithFormatRetry, } from "../reporter.js";
18
- import { createPipelineState, pipelineStateLocation, updatePipelineStage, writePipelineState, } from "../pipeline-state.js";
19
- import { pinnedExecutor, pinnedReporter, resolvePinnedRateLimitRunOptions, resolveExecDefaultsPath, selectCandidates, } from "./shared.js";
20
22
  import { appendParentValidationsToExecutorEvidence, buildExecutorPrompt, executorRequirements, expandPromptRefs, extractBlockReason, loadRosterForExecutionPath, reportProtectionHandoffRecord, resolveReporterAgentCandidates, runWithRetry, } from "./agent.js";
21
- import { gradeBeforeReviewPlan } from "./schedule-prepare.js";
22
- import { pipelineRecoveryMeta, spawnBlock, spawnClaim, spawnComplete } from "./mode-shared.js";
23
- import { configuredProductCheckouts, productRepoEnvironment, withoutInheritedRepoEnvironment, withAgentExtraRoots, } from "../task-repos.js";
23
+ import { pipelineRecoveryMeta, spawnBlock, spawnClaim, spawnComplete, stageActorMeta, } from "./mode-shared.js";
24
+ import { enforceScheduleKataReview, gradeBeforeReviewPlan } from "./schedule-prepare.js";
25
+ import { reviewTaskBlockReason } from "../review-completion.js";
26
+ import { pinnedExecutor, pinnedReporter, resolveExecDefaultsPath, resolvePinnedRateLimitRunOptions, selectCandidates, } from "./shared.js";
24
27
  // Resolve the agent command and the actor for an in-place run, ignoring task state. Unlike the
25
28
  // worktree flow, this never requires the task to be claimable. The actor is derived the same way
26
29
  // as the worktree path (`prepareTask`): explicit --by wins, otherwise the resolved member's
@@ -162,18 +165,11 @@ export async function runInPlaceMode(opts) {
162
165
  const projectId = resolvedPaths.projectId ?? opts.project ?? process.env.SPECDOJO_PROJECT ?? "";
163
166
  const roster = loadRosterForExecutionPath(executionPath);
164
167
  const execDefaults = loadExecDefaultsConfig(resolveExecDefaultsPath(opts, schedulePath), executionPath);
165
- // --track-state controls whether this run records claim/complete events; it no longer affects
166
- // file naming. Task-identity runs (--task) always use the fixed `<task-id>` stem (shared with
167
- // claim / run --track-state), so an in-place result can be adopted by claim/complete without
168
- // renaming; re-runs overwrite the same plan/result and git history is the audit trail. Only
169
- // --deliverable / ad-hoc runs (no task identity) use a unique stem to avoid id collisions.
168
+ // State tracking and artifact identity are independent: each new execution gets its own run.
170
169
  const trackState = !!opts.trackState;
171
- const plansDir = join(executionPath, "exec", "plans");
172
170
  let planPath;
173
171
  let slug;
174
- // Shared plan/result stem. For --task it is the fixed task id; for bring-your-own --plan it is
175
- // recovered from the plan filename so re-running the same plan overwrites the tied result; for
176
- // --deliverable it is unique per run (`<slug>-<UTC>-<rand>`).
172
+ // The run id is recovered from a supplied managed plan or minted for a new execution.
177
173
  let stem;
178
174
  let task = null;
179
175
  // null target = bring-your-own --plan (not generated, not archived).
@@ -212,14 +208,14 @@ export async function runInPlaceMode(opts) {
212
208
  const taskId = opts.task.trim();
213
209
  task = buildTaskView(schedulePath, executionPath, taskId);
214
210
  slug = taskId;
215
- stem = taskId;
216
- planPath = join(plansDir, `${stem}-plan.md`);
211
+ stem = buildInPlaceStem(taskId);
212
+ planPath = taskRecordPaths(executionPath, taskId, stem).plan;
217
213
  }
218
214
  else {
219
215
  target = resolveDeliverableTarget(catalogPath ?? "", opts.deliverable.trim());
220
216
  slug = target.slug;
221
217
  stem = buildInPlaceStem(slug);
222
- planPath = join(plansDir, `${stem}-plan.md`);
218
+ planPath = taskRecordPaths(executionPath, slug, stem).plan;
223
219
  task = {
224
220
  id: slug,
225
221
  local_id: target.localId,
@@ -259,8 +255,9 @@ export async function runInPlaceMode(opts) {
259
255
  }
260
256
  // Generate the plan on demand (skip for bring-your-own --plan).
261
257
  const generatedPlan = !opts.plan;
258
+ let reviewGradeOutcome;
262
259
  if (opts.task && task) {
263
- const reviewGradeOutcome = await gradeBeforeReviewPlan({
260
+ reviewGradeOutcome = await gradeBeforeReviewPlan({
264
261
  task,
265
262
  projectId,
266
263
  catalogPath,
@@ -275,6 +272,7 @@ export async function runInPlaceMode(opts) {
275
272
  viewpointsPath,
276
273
  projectContext,
277
274
  task,
275
+ outPath: planPath,
278
276
  ...(stem ? { stem } : {}),
279
277
  ...(reviewGradeOutcome ? { reviewGradeOutcome } : {}),
280
278
  });
@@ -288,10 +286,11 @@ export async function runInPlaceMode(opts) {
288
286
  viewpointsPath,
289
287
  projectContext,
290
288
  target,
289
+ outPath: planPath,
291
290
  ...(stem ? { stem } : {}),
292
291
  });
293
292
  }
294
- const planPrompt = expandPromptRefs(readFileSync(planPath, "utf8"));
293
+ const planPrompt = expandPromptRefs(readPlanFile(planPath));
295
294
  const prompt = task?.agent_pipeline
296
295
  ? buildExecutorPrompt(planPrompt, execDefaults.pipeline?.parent_validations)
297
296
  : planPrompt;
@@ -318,7 +317,7 @@ export async function runInPlaceMode(opts) {
318
317
  taskId: slug,
319
318
  mode: task.mode ?? "edit",
320
319
  projectId: projectId || planProjectId,
321
- planRef: `exec/plans/${stem ?? slug}-plan.md`,
320
+ planRef: recordRef(executionPath, planPath),
322
321
  agent: actor,
323
322
  startedAt: new Date().toISOString(),
324
323
  ...(stem ? { stem } : {}),
@@ -335,9 +334,12 @@ export async function runInPlaceMode(opts) {
335
334
  let pipelineStateRef;
336
335
  let pipelineRunId;
337
336
  let pipelineFailureStage = "executor";
337
+ let failedStageActor = actor;
338
338
  if (task?.agent_pipeline) {
339
339
  const startedAt = new Date().toISOString();
340
- pipelineRunId = `${new Date().toISOString().replace(/[-:.]/g, "")}-${randomHex(4)}`;
340
+ pipelineRunId = isRunRecordPath(planPath)
341
+ ? recordStem(planPath)
342
+ : `${new Date().toISOString().replace(/[-:.]/g, "")}-${randomHex(4)}`;
341
343
  const stateLocation = pipelineStateLocation({
342
344
  repoRoot,
343
345
  worktreePath: repoRoot,
@@ -414,7 +416,25 @@ export async function runInPlaceMode(opts) {
414
416
  evidencePath: recorded.evidencePath,
415
417
  });
416
418
  }
417
- if (outcome.result === "success") {
419
+ failedStageActor = outcome.actor ?? actor;
420
+ // PJR-1GCD: a missing approach-required field is an executor failure, not a reporter failure.
421
+ const contractFailure = outcome.result === "success"
422
+ ? enforceExecutorReportContract({
423
+ evidence: recorded.evidence,
424
+ evidencePath: recorded.evidencePath,
425
+ contract: { approach: task.approach, mode: task.mode ?? "edit" },
426
+ resumeHint: executorStageResumeHint({ kind: "schedule", taskId: task.id }),
427
+ })
428
+ : undefined;
429
+ if (contractFailure) {
430
+ const blockedAt = new Date().toISOString();
431
+ pipelineState = updatePipelineStage(pipelineState, "executor", { status: "blocked", completed_at: blockedAt }, blockedAt);
432
+ writePipelineState(stateLocation.path, pipelineState);
433
+ process.stdout.write(`Executor report rejected before the reporter: ${contractFailure}\n`);
434
+ pipelineBlockReason = contractFailure;
435
+ exitCode = 1;
436
+ }
437
+ else if (outcome.result === "success") {
418
438
  pipelineFailureStage = "reporter";
419
439
  const reporterEvidence = evidenceForReporter(recorded.evidence, {
420
440
  repoRoot,
@@ -493,6 +513,7 @@ export async function runInPlaceMode(opts) {
493
513
  invocationOutputs: reporter.invocationOutputs,
494
514
  });
495
515
  }
516
+ failedStageActor = reporterActor ?? failedStageActor;
496
517
  const reporterCompletedAt = new Date().toISOString();
497
518
  pipelineState = updatePipelineStage(pipelineState, "reporter", {
498
519
  status: exitCode === 0
@@ -528,7 +549,22 @@ export async function runInPlaceMode(opts) {
528
549
  // normally. The agent's core duty is to fill the result while preserving its scaffold
529
550
  // frontmatter, so treat an incomplete or modified result as a block even on exit 0.
530
551
  let effectiveExit = exitCode;
552
+ if (exitCode === 0 && task && resultPath) {
553
+ enforceScheduleKataReview({ task, catalogPath, resultPath, projectId, rootDir: repoRoot });
554
+ }
531
555
  let blockReason = pipelineBlockReason;
556
+ const reviewBlockReason = exitCode === 0 && task && resultPath
557
+ ? reviewTaskBlockReason({
558
+ mode: task.mode,
559
+ resultPath,
560
+ ...(reviewGradeOutcome ? { gradeOutcome: reviewGradeOutcome } : {}),
561
+ })
562
+ : undefined;
563
+ if (reviewBlockReason) {
564
+ effectiveExit = 1;
565
+ blockReason = reviewBlockReason;
566
+ process.stdout.write(`run blocked: ${label} (${reviewBlockReason})\n`);
567
+ }
532
568
  if (exitCode === 0 &&
533
569
  resultPath &&
534
570
  task &&
@@ -549,6 +585,7 @@ export async function runInPlaceMode(opts) {
549
585
  else
550
586
  spawnBlock(projectId, opts.task.trim(), actor, blockReason ?? "agent exited with non-zero code", {
551
587
  limit_deferred: "false",
588
+ ...stageActorMeta(actor, failedStageActor),
552
589
  ...(pipelineRunId
553
590
  ? pipelineRecoveryMeta({
554
591
  stage: pipelineFailureStage,
@@ -1,23 +1,26 @@
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, 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 { formatMarkdownFile } from "../format.js";
11
+ import { createPipelineState, pipelineStateLocation, updatePipelineStage, writePipelineState, } from "../pipeline-state.js";
6
12
  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";
13
+ import { evidenceForReporter } from "../reporter.js";
9
14
  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";
15
+ import { taskRecordPrefixes } from "../run-records.js";
13
16
  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";
17
+ import { ensureExecWorktree, formatGitResultFailure, gitEnvironment, gitOutput, gitResult, resolveWorktreeBase, summarizeGitHookFailure, } from "../worktree.js";
19
18
  import { runAgentPipeline, runReporterStage } from "./agent-pipeline.js";
19
+ import { executorRequirements, expandPromptRefs, loadRosterForExecutionPath, resolveReporterAgentCandidates, } from "./agent.js";
20
20
  import { resolveInPlaceCommand, spawnAgentInPlace } from "./in-place.js";
21
+ import { ROUTINE_BUSY_SKIP_EXIT_CODE, ROUTINE_EXEC_ENV } from "./lock.js";
22
+ import { configuredWorktreeBase, resolveAgentOverride, resolveExecDefaultsPath, selectCandidates, } from "./shared.js";
23
+ import { localJobNoopPath, snapshotJobOutput } from "../../job/noop.js";
21
24
  async function runCommandJobMode(params) {
22
25
  const { opts, record, runPath, planPath, projectId, schedulePath, executionPath } = params;
23
26
  if (!isJobCommandTask(record.task))
@@ -77,7 +80,7 @@ async function runCommandJobMode(params) {
77
80
  startedAt: new Date().toISOString(),
78
81
  ...(record.task.targets ? { targets: record.task.targets } : {}),
79
82
  });
80
- const evidenceRunId = `attempt-${record.attempts.length}`;
83
+ const evidenceRunId = record.run_id;
81
84
  process.stdout.write(`Running Job Run ${record.run_id} command in place.\n`);
82
85
  const commandOutcome = await executeJobCommand(record.task.command, repoRoot);
83
86
  const commandPartial = !commandOutcome.error &&
@@ -149,14 +152,12 @@ async function runCommandJobMode(params) {
149
152
  }
150
153
  else if (commandPartial) {
151
154
  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
155
  }
156
156
  else {
157
157
  process.stdout.write(`Job Run failed: ${record.run_id}\n`);
158
158
  process.exitCode = commandOutcome.exitCode || 1;
159
159
  }
160
+ process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=${commandSucceeded ? "succeeded" : commandPartial ? "partial" : "failed"}\n`);
160
161
  return;
161
162
  }
162
163
  const stateLocation = pipelineStateLocation({
@@ -191,7 +192,7 @@ async function runCommandJobMode(params) {
191
192
  schedulePath,
192
193
  executionPath,
193
194
  reporterCandidates: [analysisCandidate],
194
- planPrompt: expandPromptRefs(readFileSync(planPath, "utf8")),
195
+ planPrompt: expandPromptRefs(readPlanFile(planPath)),
195
196
  resultPath,
196
197
  execDefaults,
197
198
  evidence: recorded.evidence,
@@ -211,14 +212,12 @@ async function runCommandJobMode(params) {
211
212
  });
212
213
  if (reporterOutcome.exitCode === 0) {
213
214
  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
215
  }
218
216
  else {
219
217
  process.stdout.write(`Job Run failed: ${record.run_id}\n`);
220
218
  process.exitCode = 1;
221
219
  }
220
+ process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=${reporterOutcome.exitCode === 0 ? (commandPartial ? "partial" : "succeeded") : "failed"}\n`);
222
221
  }
223
222
  const ACCEPTED_JOB_REVIEW_VERDICTS = new Set(["complete", "complete-with-findings"]);
224
223
  function acceptsJobReview(record, verdict) {
@@ -383,6 +382,8 @@ async function runJobWorktreeMode(opts) {
383
382
  });
384
383
  if (preview.duplicateComplete) {
385
384
  process.stdout.write(`Job Run already complete: ${preview.record.run_id} (${preview.record.state})\n`);
385
+ if (preview.record.state === "noop")
386
+ process.stdout.write(`[routine-job] noop state=noop\n`);
386
387
  if (trigger === "routine" && preview.record.state === "partial") {
387
388
  process.stdout.write(`[routine-job] complete run_id=${preview.record.run_id} state=partial\n`);
388
389
  }
@@ -420,7 +421,7 @@ async function runJobWorktreeMode(opts) {
420
421
  const child = spawnSync(executable, fullArgs, {
421
422
  cwd: worktree.path,
422
423
  env: {
423
- ...process.env,
424
+ ...gitEnvironment(),
424
425
  [ROUTINE_EXEC_ENV]: trigger === "routine" ? "1" : "0",
425
426
  [JOB_REVIEW_WORKTREE_CHILD_ENV]: "1",
426
427
  },
@@ -441,10 +442,23 @@ async function runJobWorktreeMode(opts) {
441
442
  const worktreeExecutionPath = resolve(worktree.path, executionRel);
442
443
  const worktreeJobPaths = resolveJobPaths(projectId);
443
444
  const runPath = resolve(worktree.path, relative(repoRoot, preview.runPath));
445
+ if (child.status === 0 && existsSync(localJobNoopPath(executionPath, preview.record.run_id))) {
446
+ removeWorktree({
447
+ context: { repoRoot, schedulePath, executionPath },
448
+ worktree,
449
+ taskId: `${preview.record.run_id}-review`,
450
+ deleteBranch: true,
451
+ });
452
+ process.stdout.write(`[routine-job] noop state=noop\n`);
453
+ return;
454
+ }
444
455
  if (!existsSync(runPath)) {
445
456
  throw new Error(`Job Run record was not created in worktree: ${preview.record.run_id}`);
446
457
  }
447
458
  let record = loadJobRunRecord(runPath);
459
+ // The child may fail before printing a completion marker. Its worktree still owns
460
+ // the diagnostic Run record even if commit or review subsequently fails.
461
+ process.stdout.write(`[routine-job] recorded run_id=${record.run_id} state=${record.state}\n`);
448
462
  const outputPaths = worktreeStatusPaths(worktree.path);
449
463
  const outputCommit = commitJobPaths(worktree.path, outputPaths, `chore(routine): ${preview.definition.name}`, `Job Run: ${record.run_id}\nState: ${record.state}`);
450
464
  const reviewTaskId = `${record.run_id}-review`;
@@ -491,7 +505,7 @@ async function runJobWorktreeMode(opts) {
491
505
  executor: agents.executor,
492
506
  reporterCandidates: agents.reporterCandidates,
493
507
  planPath,
494
- planPrompt: expandPromptRefs(readFileSync(planPath, "utf8")),
508
+ planPrompt: expandPromptRefs(readPlanFile(planPath)),
495
509
  resultPath,
496
510
  execDefaults,
497
511
  mode: "review",
@@ -527,7 +541,7 @@ async function runJobWorktreeMode(opts) {
527
541
  process.chdir(originalCwd);
528
542
  }
529
543
  const allowedReviewPrefixes = [
530
- `${relative(worktree.path, worktreeExecutionPath).split(sep).join("/")}/exec/evidence/${reviewTaskId}/`,
544
+ ...taskRecordPrefixes(relative(worktree.path, worktreeExecutionPath), reviewTaskId),
531
545
  ];
532
546
  const allowedReviewFiles = new Set([
533
547
  relative(worktree.path, planPath).split(sep).join("/"),
@@ -584,10 +598,9 @@ async function runJobWorktreeMode(opts) {
584
598
  });
585
599
  process.stdout.write(`[routine-job] merged run_id=${record.run_id} state=${record.state} review=${verdict} branch=${worktree.branch}\n`);
586
600
  }
587
- export async function runJobMode(opts, resolvePipelineAgents) {
601
+ async function runJobModeUnchecked(opts, resolvePipelineAgents, isWorktreeChild) {
588
602
  const resolvedPaths = resolveProjectPaths({ project: opts.project });
589
603
  activateResolvedProjectPaths(resolvedPaths);
590
- const isWorktreeChild = process.env[JOB_REVIEW_WORKTREE_CHILD_ENV] === "1";
591
604
  if (!isWorktreeChild) {
592
605
  // A Job's task.review declaration takes precedence over the caller: it routes the Run
593
606
  // through the reviewed integration path even without --worktree (routine action.commit).
@@ -624,6 +637,8 @@ export async function runJobMode(opts, resolvePipelineAgents) {
624
637
  }
625
638
  if (materialized.duplicateComplete) {
626
639
  process.stdout.write(`Job Run already complete: ${record.run_id} (${record.state})\n`);
640
+ if (record.state === "noop")
641
+ process.stdout.write(`[routine-job] noop state=noop\n`);
627
642
  if (trigger === "routine" && record.state === "partial") {
628
643
  process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=partial\n`);
629
644
  }
@@ -696,7 +711,7 @@ export async function runJobMode(opts, resolvePipelineAgents) {
696
711
  ...(record.task.targets ? { targets: record.task.targets } : {}),
697
712
  });
698
713
  const resultScaffold = readResultFrontmatterSnapshot(resultPath);
699
- const prompt = expandPromptRefs(readFileSync(planPath, "utf8"));
714
+ const prompt = expandPromptRefs(readPlanFile(planPath));
700
715
  const repoRoot = specdojoRootDir();
701
716
  let exitCode;
702
717
  let reason;
@@ -743,4 +758,46 @@ export async function runJobMode(opts, resolvePipelineAgents) {
743
758
  process.stdout.write(`Job Run failed: ${record.run_id}\n`);
744
759
  process.exitCode = effectiveExit || 1;
745
760
  }
761
+ process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=${effectiveExit === 0 ? "succeeded" : "failed"}\n`);
762
+ }
763
+ export async function runJobMode(opts, resolvePipelineAgents) {
764
+ const isWorktreeChild = process.env[JOB_REVIEW_WORKTREE_CHILD_ENV] === "1";
765
+ // This marker routes only this Job's re-entry. Preconditions, commands, agents and
766
+ // their tests must choose their own worktree/review mode rather than inherit it.
767
+ delete process.env[JOB_REVIEW_WORKTREE_CHILD_ENV];
768
+ const paths = resolveProjectPaths({ project: opts.project });
769
+ activateResolvedProjectPaths(paths);
770
+ const projectId = paths.projectId ?? opts.project;
771
+ const definition = loadJobDefinition(resolveJobPaths(projectId), String(opts.job).trim());
772
+ if (opts.dryRun ||
773
+ jobRunUsesReviewedIntegration(definition, {
774
+ worktree: opts.worktree,
775
+ isWorktreeChild,
776
+ }) ||
777
+ // In-place command Jobs also support projects without a Git repository. There is
778
+ // nothing to commit there, and no reliable Git diff for suppressing Run records.
779
+ gitResult(specdojoRootDir(), ["rev-parse", "--is-inside-work-tree"]).status !== 0) {
780
+ await runJobModeUnchecked(opts, resolvePipelineAgents, isWorktreeChild);
781
+ return;
782
+ }
783
+ const preview = await materializeJobRun({
784
+ projectId,
785
+ jobId: String(opts.job).trim(),
786
+ inputs: opts.input,
787
+ scheduledAt: opts.scheduledAt,
788
+ dryRun: true,
789
+ });
790
+ if (preview.duplicateComplete) {
791
+ await runJobModeUnchecked(opts, resolvePipelineAgents, isWorktreeChild);
792
+ return;
793
+ }
794
+ const snapshot = snapshotJobOutput(specdojoRootDir(), paths.executionPath, preview.record);
795
+ await runJobModeUnchecked({ ...opts, scheduledAt: preview.record.scheduled_at }, resolvePipelineAgents, isWorktreeChild);
796
+ if (!existsSync(preview.runPath))
797
+ return;
798
+ const record = loadJobRunRecord(preview.runPath);
799
+ if (record.state === "succeeded" && !snapshot.hasChanges()) {
800
+ snapshot.discard(completeJobRun({ projectId, runPath: preview.runPath, status: "noop" }));
801
+ process.stdout.write(`[routine-job] noop state=noop\n`);
802
+ }
746
803
  }