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,27 +1,41 @@
1
+ import { withPlanConventionsFiles } from "../../shared/plan-conventions.js";
2
+ import { existsSync } from "node:fs";
1
3
  import { join } from "node:path";
4
+ import { ensureReviewGrade, reviewGradeFreshness, } from "../../review/grade.js";
5
+ import { findDeliverableInfo, reviewGradeSummaryText } from "../plans-core.js";
6
+ import { enforceKataReviewVerdict, kataReviewSummary, scheduleKataReviewSubjects, } from "../review-kata.js";
2
7
  import { resolveMemberCommand } from "../agent-config.js";
3
- import { canCompleteTask, readAllEventFiles, foldEventsToState } from "../events.js";
4
- import { buildScheduleIndex } from "../schedule/schedule.js";
5
- import { buildInitialStateFromStrategy } from "../schedule/initial.js";
6
- import { qualifyTaskId, randomHex } from "../shared.js";
7
- import { generateSinglePlan, finalizeResultSectionsForDeliverable, targetDocIdsForScheduledTask, reviewGradeSubject, } from "../plans.js";
8
- import { ensureReviewGrade } from "../../review/grade.js";
8
+ import { canCompleteTask, foldEventsToState, readAllEventFiles } from "../events.js";
9
9
  import { gradeCheckpointPaths } from "../grade-checkpoint.js";
10
+ import { pipelineStateLocation } from "../pipeline-state.js";
11
+ import { finalizeResultSectionsForDeliverable, generateSinglePlan, reviewGradeSubject, targetDocIdsForScheduledTask, } from "../plans.js";
10
12
  import { isResultUnfilled, readResultFrontmatterSnapshot, scaffoldResult } from "../results.js";
11
- import { worktreeNameFromTaskId } from "../worktree.js";
13
+ import { findRunRecord, recordPathForRead, recordRef, recordStem } from "../run-records.js";
14
+ import { buildInitialStateFromStrategy } from "../schedule/initial.js";
15
+ import { buildScheduleIndex } from "../schedule/schedule.js";
16
+ import { qualifyTaskId } from "../shared.js";
12
17
  import { configuredProductRepos, plannedProjectWorktreePath, preflightProductBranches, productBranchForTask, } from "../task-repos.js";
13
- import { checkpointAndEnsureWorktree, discardStaleExecWorktree } from "../worktree-ops.js";
14
- import { pipelineStateLocation } from "../pipeline-state.js";
15
- import { collectBusyActors, pinnedExecutor, pinnedReporter, resolveAgentOverride, resolveExecDefaultsPath, resolvePinnedRateLimitRunOptions, resolveTaskPhaseContext, selectCandidates, } from "./shared.js";
16
- import { buildExecutorPrompt, executorRequirements, loadPrompt, reportProductWorktrees, reporterRequirements, resolveReporterAgentCandidates, } from "./agent.js";
18
+ import { checkpointAndEnsureWorktree, discardStaleExecWorktree, refreshWorktreeCheckpoint, } from "../worktree-ops.js";
19
+ import { findExecWorktree, worktreeNameFromTaskId } from "../worktree.js";
20
+ import { buildExecutorPrompt, executorRequirements, loadPrompt, pathInsideWorktree, reportProductWorktrees, reporterRequirements, resolveReporterAgentCandidates, } from "./agent.js";
17
21
  import { integrateLogPath, spawnClaim, spawnRelease } from "./mode-shared.js";
18
- export function findClaimEventPath(schedulePath, taskId) {
22
+ import { collectBusyActors, pinnedExecutor, pinnedReporter, resolveAgentOverride, resolveExecDefaultsPath, resolvePinnedRateLimitRunOptions, resolveTaskPhaseContext, selectCandidates, } from "./shared.js";
23
+ export function findClaimEventPath(schedulePath, taskId, worktreeRef) {
19
24
  const claims = readAllEventFiles(schedulePath).filter((item) => item.event.task_id === taskId && item.event.type === "claim");
25
+ if (worktreeRef && existsSync(worktreeRef.worktreePath)) {
26
+ for (let i = claims.length - 1; i >= 0; i -= 1) {
27
+ const candidate = claims[i].path;
28
+ if (existsSync(pathInsideWorktree(worktreeRef.repoRoot, worktreeRef.worktreePath, candidate))) {
29
+ return candidate;
30
+ }
31
+ }
32
+ }
20
33
  return claims[claims.length - 1]?.path ?? null;
21
34
  }
22
35
  // review フェーズの前段で runner が対象文書へ grade を実行する(PJR-KCMH、PJR-2ZVS 3.6)。
23
36
  // executor には実行させない。評価結果が最新(content_hash 一致)なら再実行しない。
24
- // grade の失敗は review を止めず、結果を plan に示して review の verdict に委ねる。
37
+ // grade は失敗すると再試行する。それでも失敗した場合も review は止めず、結果を plan に示すが、
38
+ // runner はそのタスクを done にせず blocked にする(PJR-M18B)。
25
39
  export async function gradeBeforeReviewPlan(params) {
26
40
  const { task, projectId } = params;
27
41
  if ((task.mode ?? "edit") !== "review" || !projectId)
@@ -29,29 +43,115 @@ export async function gradeBeforeReviewPlan(params) {
29
43
  const subject = reviewGradeSubject(params.catalogPath ?? "", task);
30
44
  if (!subject) {
31
45
  process.stdout.write(" [grade] skipped: grade subject is not resolvable\n");
32
- return { action: "not-run", detail: "評価対象のパスを解決できない" };
33
46
  }
34
- process.stdout.write(` [grade] checking ${subject.path} (--target ${subject.target})\n`);
35
- const outcome = await ensureReviewGrade({
36
- taskId: qualifyTaskId(projectId, task.id),
37
- projectId,
38
- subjectPath: subject.path,
39
- target: subject.target,
40
- repoRoot: params.repoRoot,
41
- dryRun: params.dryRun,
42
- by: params.by,
43
- execDefaultsPath: params.execDefaultsPath,
44
- });
47
+ if (subject)
48
+ process.stdout.write(` [grade] checking ${subject.path} (--target ${subject.target})\n`);
49
+ const outcome = subject
50
+ ? await ensureReviewGrade({
51
+ taskId: qualifyTaskId(projectId, task.id),
52
+ projectId,
53
+ subjectPath: subject.path,
54
+ target: subject.target,
55
+ repoRoot: params.repoRoot,
56
+ dryRun: params.dryRun,
57
+ by: params.by,
58
+ execDefaultsPath: params.execDefaultsPath,
59
+ })
60
+ : { action: "not-run", detail: "評価対象のパスを解決できない" };
61
+ const deliverable = task.local_id && params.catalogPath
62
+ ? findDeliverableInfo(params.catalogPath, task.local_id)
63
+ : null;
64
+ for (const kata of scheduleKataReviewSubjects(task, deliverable, projectId)) {
65
+ if (kata.path === subject?.path && subject?.target === "kata")
66
+ continue;
67
+ process.stdout.write(` [grade] checking ${kata.label}: ${kata.path} (--target kata)\n`);
68
+ const kataOutcome = await ensureReviewGrade({
69
+ taskId: qualifyTaskId(projectId, task.id),
70
+ projectId,
71
+ subjectPath: kata.path === "_MISSING_" ? "" : kata.path,
72
+ target: "kata",
73
+ repoRoot: params.repoRoot,
74
+ dryRun: params.dryRun,
75
+ by: params.by,
76
+ execDefaultsPath: params.execDefaultsPath,
77
+ });
78
+ if (kataOutcome.action === "failed" || kataOutcome.action === "not-run") {
79
+ process.stdout.write(` [grade] ${kata.label}: ${kataOutcome.detail}\n`);
80
+ }
81
+ }
45
82
  const summary = outcome.action === "skipped"
46
83
  ? "skipped: content_hash matches the stored grade"
47
84
  : outcome.action === "executed"
48
85
  ? `executed: run id ${outcome.runId}`
49
86
  : outcome.action === "failed"
50
- ? `failed: run id ${outcome.runId}; ${outcome.detail}`
87
+ ? `failed after ${outcome.attempts} attempt(s): run id ${outcome.runId}; ${outcome.detail}`
51
88
  : `not run: ${outcome.detail}`;
52
89
  process.stdout.write(` [grade] ${summary}\n`);
53
90
  return outcome;
54
91
  }
92
+ // Root-side grade sidecars of the deliverable and kata subjects that the review judges.
93
+ export function reviewGradeSidecarPaths(params) {
94
+ const { task, projectId } = params;
95
+ const deliverable = task.local_id && params.catalogPath
96
+ ? findDeliverableInfo(params.catalogPath, task.local_id)
97
+ : null;
98
+ const subjectPaths = [
99
+ reviewGradeSubject(params.catalogPath ?? "", task)?.path,
100
+ ...scheduleKataReviewSubjects(task, deliverable, projectId).map((kata) => kata.path),
101
+ ].filter((path) => !!path && path !== "_MISSING_");
102
+ const sidecars = subjectPaths.flatMap((subjectPath) => {
103
+ const freshness = reviewGradeFreshness({ subjectPath, projectId, rootDir: params.repoRoot });
104
+ return "sidecarPath" in freshness && freshness.sidecarPath ? [freshness.sidecarPath] : [];
105
+ });
106
+ return [...new Set(sidecars)].sort();
107
+ }
108
+ /**
109
+ * A resumed review reuses the exec branch, which still holds the grade from its first checkpoint.
110
+ * Bring the grade the runner just checked into the branch so the review agent and the completion
111
+ * check judge the same grade as the runner (PJR-ZSRD). Returns the refreshed repo-relative paths.
112
+ */
113
+ export function refreshReviewGradeCheckpoint(params) {
114
+ const { task, projectId } = params;
115
+ if ((task.mode ?? "edit") !== "review" || !projectId)
116
+ return [];
117
+ const refreshed = refreshWorktreeCheckpoint({
118
+ repoRoot: params.repoRoot,
119
+ worktreePath: params.worktree.path,
120
+ paths: reviewGradeSidecarPaths({ ...params, projectId }),
121
+ commitMessage: `exec(${task.id}): refresh grade before resumed review`,
122
+ failureLogPath: params.failureLogPath,
123
+ });
124
+ for (const path of refreshed)
125
+ process.stdout.write(` [grade] refreshed in worktree: ${path}\n`);
126
+ return refreshed;
127
+ }
128
+ // The stored plan keeps the grade summary of its first run. Tell the resumed review which grade
129
+ // the runner checked now so it does not judge from the outdated section.
130
+ export function resumedReviewGradeNote(task, projectId, catalogPath, outcome) {
131
+ const subject = reviewGradeSubject(catalogPath ?? "", task);
132
+ const deliverable = task.local_id && catalogPath ? findDeliverableInfo(catalogPath, task.local_id) : null;
133
+ const summary = [
134
+ subject ? reviewGradeSummaryText(projectId, subject.path, outcome) : "",
135
+ kataReviewSummary(scheduleKataReviewSubjects(task, deliverable, projectId), projectId),
136
+ ]
137
+ .filter(Boolean)
138
+ .join("\n\n");
139
+ return [
140
+ "## 再開の前に runner が確認した評価結果",
141
+ "",
142
+ "runner は再開の前に grade を確認し、最新の評価結果サイドカーをこの worktree に取り込んだ。plan の `評価結果` の節は前回の実行の時点のものであり、判定にはこの節と評価結果サイドカーを使う。",
143
+ "",
144
+ summary,
145
+ ].join("\n");
146
+ }
147
+ export function enforceScheduleKataReview(params) {
148
+ if (params.task.mode !== "review" || !params.projectId)
149
+ return;
150
+ const deliverable = params.task.local_id && params.catalogPath
151
+ ? findDeliverableInfo(params.catalogPath, params.task.local_id)
152
+ : null;
153
+ enforceKataReviewVerdict(params.resultPath, scheduleKataReviewSubjects(params.task, deliverable, params.projectId), params.projectId, params.rootDir);
154
+ }
55
155
  export async function prepareSingleTask(task, projectId, repoRoot, schedulePath, executionPath, roster, localIdToPhaseSets, phaseSetSuffixToId, agentNicknameOverride, modeAgentOverrides, stageAgentOverrides, actorOverride, dryRun, skipClaim, worktreeBase, planGenPaths, execDefaults, hasProviderCapacity, pipelineResume, rateLimitOverrides = {}) {
56
156
  const mode = task.mode ?? "edit";
57
157
  process.stdout.write(`Task: ${task.id}${task.name ? ` — ${task.name}` : ""} [${mode}]\n`);
@@ -80,7 +180,9 @@ export async function prepareSingleTask(task, projectId, repoRoot, schedulePath,
80
180
  ]
81
181
  : [];
82
182
  let actor = actorOverride ?? "auto-agent";
83
- if (overrideResolution.kind === "command" && overrideResolution.actor && !skipClaim) {
183
+ if (overrideResolution.kind === "command" &&
184
+ overrideResolution.actor &&
185
+ (!skipClaim || (Boolean(stageAgentOverrides.executor) && pipelineResume?.stage !== "reporter"))) {
84
186
  actor = overrideResolution.actor;
85
187
  }
86
188
  if (agentCandidates.length === 0) {
@@ -162,6 +264,10 @@ export async function prepareSingleTask(task, projectId, repoRoot, schedulePath,
162
264
  const reporterRateLimitOptions = reporterPinned && reporterCandidates?.[0]
163
265
  ? resolvePinnedRateLimitRunOptions(rateLimitOverrides, execDefaults, roster, "reporter", reporterCandidates[0])
164
266
  : undefined;
267
+ // A resumed claim stays with the actor that already holds it, even when a stage override
268
+ // selects another agent to run.
269
+ const claimActor = skipClaim ? (actorOverride ?? actor) : actor;
270
+ // The runner grades before any review agent starts, including an executor resume (PJR-ZSRD).
165
271
  const reviewGradeOutcome = await gradeBeforeReviewPlan({
166
272
  task,
167
273
  projectId,
@@ -171,17 +277,77 @@ export async function prepareSingleTask(task, projectId, repoRoot, schedulePath,
171
277
  by: agentCandidates[0]?.actor,
172
278
  execDefaultsPath: resolveExecDefaultsPath(rateLimitOverrides, schedulePath),
173
279
  });
280
+ const withResumedGradeNote = (text, refreshed) => refreshed.length > 0 && projectId
281
+ ? `${text.trimEnd()}\n\n${resumedReviewGradeNote(task, projectId, planGenPaths.catalogPath, reviewGradeOutcome)}\n`
282
+ : text;
283
+ if (pipelineResume?.executorTarget) {
284
+ const { executorTarget, worktree } = pipelineResume;
285
+ if (!worktree)
286
+ throw new Error(`no exec worktree to resume executor for ${task.id}`);
287
+ const worktreeExecutionPath = pathInsideWorktree(repoRoot, worktree.path, executionPath);
288
+ const refreshed = dryRun
289
+ ? []
290
+ : refreshReviewGradeCheckpoint({
291
+ task,
292
+ projectId,
293
+ catalogPath: planGenPaths.catalogPath,
294
+ repoRoot,
295
+ worktree,
296
+ });
297
+ const storedPlan = loadPrompt(worktreeExecutionPath, task.id);
298
+ const planPrompt = storedPlan ? withResumedGradeNote(storedPlan, refreshed) : storedPlan;
299
+ const resultPath = recordPathForRead(executionPath, "result", task.id);
300
+ const worktreeResultPath = pathInsideWorktree(repoRoot, worktree.path, resultPath);
301
+ if (!planPrompt || !existsSync(resultPath) || !existsSync(worktreeResultPath)) {
302
+ throw new Error(`plan or result is missing for executor resume: ${task.id}`);
303
+ }
304
+ const claimEventPath = findClaimEventPath(schedulePath, task.id, {
305
+ repoRoot,
306
+ worktreePath: worktree.path,
307
+ });
308
+ if (!claimEventPath)
309
+ throw new Error(`claim event is missing for executor resume: ${task.id}`);
310
+ reportProductWorktrees(worktree);
311
+ return {
312
+ task,
313
+ actor,
314
+ claimActor,
315
+ agentCandidates,
316
+ plan: planPrompt,
317
+ prompt: buildExecutorPrompt(planPrompt, execDefaults.pipeline?.parent_validations),
318
+ worktree,
319
+ resultPath,
320
+ resultScaffold: readResultFrontmatterSnapshot(resultPath),
321
+ checkpointPaths: withPlanConventionsFiles([
322
+ recordPathForRead(executionPath, "plan", task.id),
323
+ resultPath,
324
+ claimEventPath,
325
+ ...gradeCheckpointPaths({ repoRoot, executionPath }),
326
+ ]),
327
+ pipelineRunId: executorTarget.runId,
328
+ pipelineResumeStage: "executor",
329
+ pipelineStateRef: executorTarget.stateRef,
330
+ initialChangeTargets: executorTarget.initialChanges,
331
+ resumeHandoff: executorTarget.handoff,
332
+ reporterCandidates,
333
+ executorRateLimitOptions,
334
+ reporterRateLimitOptions,
335
+ ...(reviewGradeOutcome ? { reviewGradeOutcome } : {}),
336
+ ...(refreshed.length > 0 ? { reviewGradeRefreshed: refreshed } : {}),
337
+ };
338
+ }
174
339
  // Plans are generated on demand here; `exec refresh` does not manage them.
175
- await generateSinglePlan({
176
- executionPath,
177
- projectId: projectId ?? "",
178
- catalogPath: planGenPaths.catalogPath ?? "",
179
- rolesPath: planGenPaths.rolesPath,
180
- viewpointsPath: planGenPaths.viewpointsPath,
181
- projectContext: planGenPaths.projectContext,
182
- task,
183
- ...(reviewGradeOutcome ? { reviewGradeOutcome } : {}),
184
- });
340
+ if (!skipClaim || !findRunRecord(executionPath, "plan", task.id))
341
+ await generateSinglePlan({
342
+ executionPath,
343
+ projectId: projectId ?? "",
344
+ catalogPath: planGenPaths.catalogPath ?? "",
345
+ rolesPath: planGenPaths.rolesPath,
346
+ viewpointsPath: planGenPaths.viewpointsPath,
347
+ projectContext: planGenPaths.projectContext,
348
+ task,
349
+ ...(reviewGradeOutcome ? { reviewGradeOutcome } : {}),
350
+ });
185
351
  const planPrompt = loadPrompt(executionPath, task.id);
186
352
  if (!planPrompt) {
187
353
  process.stdout.write(` Plan not found for ${task.id}.\n`);
@@ -191,7 +357,7 @@ export async function prepareSingleTask(task, projectId, repoRoot, schedulePath,
191
357
  ? buildExecutorPrompt(planPrompt, execDefaults.pipeline?.parent_validations)
192
358
  : planPrompt;
193
359
  const pipelineRunId = task.agent_pipeline
194
- ? `${new Date().toISOString().replace(/[-:.]/g, "").replace("Z", "Z")}-${randomHex(4)}`
360
+ ? recordStem(recordPathForRead(executionPath, "plan", task.id))
195
361
  : undefined;
196
362
  const worktreeTaskId = qualifyTaskId(projectId, task.id);
197
363
  const worktreeName = worktreeNameFromTaskId(worktreeTaskId);
@@ -223,6 +389,7 @@ export async function prepareSingleTask(task, projectId, repoRoot, schedulePath,
223
389
  return {
224
390
  task,
225
391
  actor,
392
+ claimActor,
226
393
  agentCandidates,
227
394
  plan: planPrompt,
228
395
  prompt,
@@ -233,6 +400,7 @@ export async function prepareSingleTask(task, projectId, repoRoot, schedulePath,
233
400
  reporterCandidates,
234
401
  executorRateLimitOptions,
235
402
  reporterRateLimitOptions,
403
+ ...(reviewGradeOutcome ? { reviewGradeOutcome } : {}),
236
404
  };
237
405
  }
238
406
  if (skipClaim) {
@@ -245,7 +413,7 @@ export async function prepareSingleTask(task, projectId, repoRoot, schedulePath,
245
413
  return "failure";
246
414
  }
247
415
  }
248
- const planRef = `exec/plans/${task.id}-plan.md`;
416
+ const planRef = recordRef(executionPath, recordPathForRead(executionPath, "plan", task.id));
249
417
  const startedAt = new Date().toISOString();
250
418
  const finalizeSections = task.approach === "finalize" || task.approach === "bootstrap-finalize"
251
419
  ? finalizeResultSectionsForDeliverable(planGenPaths.catalogPath ?? "", task.local_id, task.approach)
@@ -266,7 +434,8 @@ export async function prepareSingleTask(task, projectId, repoRoot, schedulePath,
266
434
  // Keep the execution checkpoint visible at root, but commit it only on the exec branch. The
267
435
  // successful merge later brings plan/result/claim and deliverables to root in one first-parent
268
436
  // commit (see runPreparedTask).
269
- const claimEventPath = findClaimEventPath(schedulePath, task.id);
437
+ const existingWorktree = skipClaim ? findExecWorktree(repoRoot, worktreeTaskId) : null;
438
+ const claimEventPath = findClaimEventPath(schedulePath, task.id, existingWorktree ? { repoRoot, worktreePath: existingWorktree.path } : undefined);
270
439
  if (!claimEventPath) {
271
440
  process.stdout.write(` Claim event not found for ${task.id}\n`);
272
441
  return "failure";
@@ -284,12 +453,12 @@ export async function prepareSingleTask(task, projectId, repoRoot, schedulePath,
284
453
  process.stdout.write(` [run] discarded stale worktree/branch: ${discarded}\n`);
285
454
  }
286
455
  }
287
- const checkpointPaths = [
288
- join(executionPath, "exec", "plans", `${task.id}-plan.md`),
456
+ const checkpointPaths = withPlanConventionsFiles([
457
+ recordPathForRead(executionPath, "plan", task.id),
289
458
  resultPath,
290
459
  claimEventPath,
291
460
  ...gradeCheckpointPaths({ repoRoot, executionPath }),
292
- ];
461
+ ]);
293
462
  const checkpointFailureLogPath = pipelineRunId
294
463
  ? integrateLogPath(pipelineStateLocation({
295
464
  repoRoot,
@@ -324,12 +493,24 @@ export async function prepareSingleTask(task, projectId, repoRoot, schedulePath,
324
493
  const setupAction = worktree.created ? "setup" : "reuse";
325
494
  process.stdout.write(` [run] ${setupAction}: worktree ${worktree.path} (${worktree.branch})\n`);
326
495
  reportProductWorktrees(worktree);
496
+ // A fresh claim checkpoints the current grade; a resume keeps the branch and needs a refresh.
497
+ const reviewGradeRefreshed = skipClaim
498
+ ? refreshReviewGradeCheckpoint({
499
+ task,
500
+ projectId,
501
+ catalogPath: planGenPaths.catalogPath,
502
+ repoRoot,
503
+ worktree,
504
+ failureLogPath: checkpointFailureLogPath,
505
+ })
506
+ : [];
327
507
  return {
328
508
  task,
329
509
  actor,
510
+ claimActor,
330
511
  agentCandidates,
331
- plan: planPrompt,
332
- prompt,
512
+ plan: withResumedGradeNote(planPrompt, reviewGradeRefreshed),
513
+ prompt: withResumedGradeNote(prompt, reviewGradeRefreshed),
333
514
  worktree,
334
515
  resultPath,
335
516
  resultScaffold: readResultFrontmatterSnapshot(resultPath),
@@ -340,6 +521,8 @@ export async function prepareSingleTask(task, projectId, repoRoot, schedulePath,
340
521
  reporterCandidates,
341
522
  executorRateLimitOptions,
342
523
  reporterRateLimitOptions,
524
+ ...(reviewGradeOutcome ? { reviewGradeOutcome } : {}),
525
+ ...(reviewGradeRefreshed.length > 0 ? { reviewGradeRefreshed } : {}),
343
526
  };
344
527
  }
345
528
  // An agent can exit 0 without doing the work (e.g. a permission-denied tool call is fed back as a