specdojo 0.7.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 (337) hide show
  1. package/.github/agents/specdojo-orchestrator.md +3 -2
  2. package/CHANGELOG.md +153 -0
  3. package/dist/catalog/build.js +24 -1
  4. package/dist/catalog/plan.js +1 -1
  5. package/dist/catalog/scaffold.js +4 -1
  6. package/dist/commands/init.js +5 -1
  7. package/dist/commands/night-orchestrator.js +6 -4
  8. package/dist/dashboard/dashboard-timeline.js +18 -16
  9. package/dist/dashboard/dashboard.js +612 -259
  10. package/dist/dashboard/epic-plan.js +81 -0
  11. package/dist/dashboard/exec-records.js +16 -20
  12. package/dist/dashboard/routines.js +8 -6
  13. package/dist/dashboard/timeline-build.js +5 -9
  14. package/dist/dashboard/timeline.js +9 -4
  15. package/dist/devcontainer/scaffold.js +18 -0
  16. package/dist/docs/frontmatter-namespace.js +1 -48
  17. package/dist/docs/yaml-pages.js +125 -3
  18. package/dist/exec/agent-config.js +22 -0
  19. package/dist/exec/agent-plan.js +3 -2
  20. package/dist/exec/commands.js +69 -21
  21. package/dist/exec/commit-hook-skips.js +78 -0
  22. package/dist/exec/core.js +19 -7
  23. package/dist/exec/events.js +159 -8
  24. package/dist/exec/evidence.js +64 -16
  25. package/dist/exec/handoff.js +9 -13
  26. package/dist/exec/limit.js +1 -1
  27. package/dist/exec/mechanical-result.js +45 -0
  28. package/dist/exec/migrate-records.js +249 -0
  29. package/dist/exec/parent-validation.js +153 -12
  30. package/dist/exec/pipeline-state.js +27 -5
  31. package/dist/exec/plans-condense-findings.js +89 -0
  32. package/dist/exec/plans-core.js +24 -17
  33. package/dist/exec/plans-generation.js +48 -25
  34. package/dist/exec/plans-grade-findings.js +8 -3
  35. package/dist/exec/plans-kata-findings.js +61 -0
  36. package/dist/exec/plans-planning.js +3 -3
  37. package/dist/exec/plans-storage.js +12 -24
  38. package/dist/exec/register-resume.js +55 -56
  39. package/dist/exec/register.js +26 -22
  40. package/dist/exec/repo-integration-sync.js +8 -4
  41. package/dist/exec/repo-integration.js +21 -1
  42. package/dist/exec/reporter.js +121 -23
  43. package/dist/exec/results.js +85 -24
  44. package/dist/exec/review-completion.js +47 -0
  45. package/dist/exec/review-kata.js +109 -0
  46. package/dist/exec/run/agent-pipeline.js +75 -6
  47. package/dist/exec/run/agent.js +20 -7
  48. package/dist/exec/run/in-place.js +69 -32
  49. package/dist/exec/run/job.js +81 -24
  50. package/dist/exec/run/lifecycle-commands.js +188 -36
  51. package/dist/exec/run/mode-shared.js +11 -3
  52. package/dist/exec/run/register-command.js +6 -10
  53. package/dist/exec/run/register-core.js +20 -13
  54. package/dist/exec/run/register-mode.js +12 -12
  55. package/dist/exec/run/register-post-review.js +21 -9
  56. package/dist/exec/run/register-resume.js +28 -18
  57. package/dist/exec/run/register-state.js +10 -7
  58. package/dist/exec/run/register-worktree.js +60 -30
  59. package/dist/exec/run/schedule-mode.js +4 -4
  60. package/dist/exec/run/schedule-prepare.js +201 -59
  61. package/dist/exec/run/schedule-task.js +129 -25
  62. package/dist/exec/run/shared.js +4 -3
  63. package/dist/exec/run/trailing-records.js +35 -0
  64. package/dist/exec/run-records.js +2 -0
  65. package/dist/exec/strategy.js +1 -0
  66. package/dist/exec/trailing-records.js +242 -0
  67. package/dist/exec/trial-commands.js +3 -2
  68. package/dist/exec/validate-records-commit.js +110 -0
  69. package/dist/exec/validate-records.js +148 -0
  70. package/dist/exec/worktree-command.js +29 -16
  71. package/dist/exec/worktree-ops-commit.js +119 -48
  72. package/dist/exec/worktree-ops-lifecycle.js +77 -48
  73. package/dist/exec/worktree-ops-merge.js +13 -2
  74. package/dist/exec/worktree-ops.js +2 -2
  75. package/dist/exec/worktree.js +19 -2
  76. package/dist/grade/apply.js +32 -6
  77. package/dist/grade/command-inspect.js +2 -2
  78. package/dist/grade/command-run.js +2 -0
  79. package/dist/grade/command-shared.js +1 -1
  80. package/dist/grade/core.js +18 -5
  81. package/dist/grade/markdown.js +3 -3
  82. package/dist/grade/pipeline-state.js +15 -11
  83. package/dist/grade/plan.js +37 -17
  84. package/dist/grade/result.js +3 -3
  85. package/dist/grade/run.js +23 -3
  86. package/dist/grade/target-discovery.js +17 -4
  87. package/dist/grade/targets.js +12 -11
  88. package/dist/job/job.js +31 -17
  89. package/dist/job/noop.js +104 -0
  90. package/dist/register/core.js +2 -0
  91. package/dist/register/create-commands.js +28 -3
  92. package/dist/register/deliverable-target.js +9 -1
  93. package/dist/register/epic.js +104 -26
  94. package/dist/register/event-merge.js +3 -0
  95. package/dist/register/events.js +4 -0
  96. package/dist/register/external-project.js +3 -0
  97. package/dist/register/item.js +6 -0
  98. package/dist/register/maintenance-commands.js +4 -1
  99. package/dist/register/planning.js +7 -14
  100. package/dist/register/register.js +43 -9
  101. package/dist/register/track-domains.js +34 -0
  102. package/dist/register/track-plan.js +78 -0
  103. package/dist/register/transition-commands.js +8 -0
  104. package/dist/register/work-table.js +64 -0
  105. package/dist/review/grade.js +35 -13
  106. package/dist/routine/definition.js +4 -3
  107. package/dist/routine/failure.js +30 -0
  108. package/dist/routine/routine.js +56 -32
  109. package/dist/routine/storage.js +33 -0
  110. package/dist/schedule/schedule.js +1 -0
  111. package/dist/schedule/strategy-generate-document.js +26 -14
  112. package/dist/schedule/strategy-generate-scope.js +17 -45
  113. package/dist/schedule/strategy-generate.js +33 -3
  114. package/dist/schedule/strategy-profiles.js +86 -12
  115. package/dist/shared/agent-types.js +2 -0
  116. package/dist/shared/condense-records.js +25 -0
  117. package/dist/shared/deprecation.js +8 -0
  118. package/dist/shared/document-metadata.js +20 -0
  119. package/dist/shared/finding-cause.js +20 -0
  120. package/dist/shared/frontmatter-namespace.js +48 -0
  121. package/dist/shared/git.js +142 -15
  122. package/dist/shared/grade-result.js +17 -1
  123. package/dist/shared/local-state.js +20 -0
  124. package/dist/shared/markdownlint-config.js +8 -3
  125. package/dist/shared/plan-conventions.js +129 -0
  126. package/dist/shared/plan-templates.js +57 -41
  127. package/dist/shared/run-records.js +224 -0
  128. package/dist/shared/specdojo-config.js +39 -21
  129. package/dist/shared/text.js +65 -5
  130. package/dist/shared/timeline-index.js +2 -0
  131. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +9 -2
  132. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  133. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  134. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  135. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  136. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  137. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  138. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  139. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  140. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  141. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  142. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  143. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  144. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  145. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  146. package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
  147. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  148. package/docs/ja/specdojo/guides/exec-config-guide.md +47 -16
  149. package/docs/ja/specdojo/guides/exec-operation-guide.md +53 -17
  150. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  151. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  152. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  153. package/docs/ja/specdojo/guides/quick-start-guide.md +70 -14
  154. package/docs/ja/specdojo/guides/register-operation-guide.md +25 -5
  155. package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
  156. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  157. package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
  158. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  159. package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
  160. package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
  161. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  162. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  163. package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
  164. package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
  165. package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
  166. package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
  167. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +36 -24
  168. package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
  169. package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
  170. package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
  171. package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
  172. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
  173. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
  174. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
  175. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
  176. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
  177. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
  178. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
  179. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
  180. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
  181. package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
  182. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
  183. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
  184. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
  185. package/docs/ja/specdojo/references/command-reference.md +79 -64
  186. package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
  187. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  188. package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
  189. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
  190. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
  191. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
  192. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
  193. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
  194. package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
  195. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
  196. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +56 -35
  197. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
  198. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
  199. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  200. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
  201. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
  202. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
  203. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
  204. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
  205. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
  206. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
  207. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
  208. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
  209. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
  210. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
  211. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
  212. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
  213. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
  214. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
  215. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
  216. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
  217. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
  218. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
  219. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
  220. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
  221. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
  222. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
  223. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
  224. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
  225. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
  226. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
  227. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
  228. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
  229. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
  230. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
  231. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
  232. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
  233. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
  234. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
  235. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
  236. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
  237. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
  238. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
  239. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  240. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
  241. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
  242. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
  243. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  244. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  245. package/docs/ja/specdojo/samples/bds-sample.md +100 -21
  246. package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
  247. package/docs/ja/specdojo/samples/bes-sample.md +80 -21
  248. package/docs/ja/specdojo/samples/br-sample.md +68 -14
  249. package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
  250. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  251. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
  252. package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
  253. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  254. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  255. package/docs/ja/specdojo/samples/clis-sample.md +132 -0
  256. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  257. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  258. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  259. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  260. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  261. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  262. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  263. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  264. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  265. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  266. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  267. package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
  268. package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
  269. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
  270. package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
  271. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  272. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
  273. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
  274. package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
  275. package/docs/ja/specdojo/samples/sf-sample.md +121 -21
  276. package/docs/ja/specdojo/samples/sld-sample.md +107 -21
  277. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  278. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  279. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  280. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  281. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  282. package/docs/ja/specdojo/samples/uis-sample.md +164 -20
  283. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  284. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  285. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  286. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  287. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  288. package/docs/ja/specdojo/templates/br-template.md +64 -0
  289. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  290. package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
  291. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  292. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  293. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  294. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  295. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  296. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  297. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  298. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  299. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  300. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  301. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  302. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  303. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  304. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  305. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  306. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  307. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  308. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  309. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  310. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  311. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  312. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  313. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  314. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  315. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  316. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  317. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  318. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  319. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
  320. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +53 -3
  321. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
  322. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  323. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  324. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  325. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  326. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  327. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  328. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  329. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  330. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  331. package/package.json +2 -2
  332. package/templates/antigravity/orchestrator.md +3 -2
  333. package/templates/claude/agents/specdojo-orchestrator.md +3 -2
  334. package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
  335. package/templates/codex/orchestrator.md +3 -2
  336. package/templates/devcontainer/tmux.conf +6 -0
  337. package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
@@ -1,9 +1,10 @@
1
1
  import { existsSync, readFileSync } from "node:fs";
2
2
  import { join, relative, resolve, sep } from "node:path";
3
- import { executorCompletionFailure } from "./evidence.js";
4
- import { PARENT_VALIDATION_PROJECT_REPO, failedParentValidationReason, } from "./parent-validation.js";
5
3
  import { getProjectExecutionPath, resolveRepoRoot, specdojoRootDir, } from "../shared/specdojo-config.js";
4
+ import { executorCompletionFailure } from "./evidence.js";
5
+ import { PARENT_VALIDATION_PROJECT_REPO, failedParentValidationReason, isAggregatedParentValidationSatisfied, } from "./parent-validation.js";
6
6
  import { MAX_TEXT_LENGTH, parseReporterOutput, reporterOutputSchemaForMode, } from "./reporter-output.js";
7
+ import { isRunRecordPath, runnerRecordPrefixes } from "./run-records.js";
7
8
  import { repoEnvironmentVariableName } from "./task-repos.js";
8
9
  export { REPORTER_OUTPUT_SCHEMA, REVIEW_VERDICTS, parseReporterOutput, reporterOutputSchemaForMode, } from "./reporter-output.js";
9
10
  const REPORTER_FORMAT_ATTEMPTS = 3;
@@ -41,6 +42,7 @@ function isRunnerManagedChangePath(path, scope) {
41
42
  const execRoot = repoRelativePath(scope.repoRoot, join(scope.executionPath, "exec"));
42
43
  const managedRoots = [
43
44
  execRoot,
45
+ ...runnerRecordPrefixes(repoRelativePath(scope.repoRoot, scope.executionPath)).map((path) => path.replace(/\/$/u, "")),
44
46
  ...(scope.registerPaths ?? []).map((path) => repoRelativePath(scope.repoRoot, path)),
45
47
  ];
46
48
  const resultPath = scope.resultPath
@@ -69,10 +71,15 @@ export function evidenceForReporter(evidence, scope) {
69
71
  const projectId = scope.projectId ??
70
72
  factOptions.projectId ??
71
73
  projectIdForExecutionPath(config, scope.repoRoot, scope.executionPath);
74
+ const resultPath = scope.resultPath
75
+ ? repoRelativePath(scope.worktreePath, scope.resultPath)
76
+ : undefined;
77
+ const executorAttemptPaths = factOptions.executorAttemptPaths ?? executorAttemptPathsForEvidence(evidence, resultPath);
72
78
  const scopedFactOptions = {
73
79
  ...factOptions,
74
80
  ...(projectId ? { projectId } : {}),
75
81
  changedPaths: changes.map((change) => change.path),
82
+ ...(executorAttemptPaths ? { executorAttemptPaths } : {}),
76
83
  };
77
84
  const mechanicallyNotApplicable = evidence.validations.flatMap((validation) => {
78
85
  if (validation.source === "runner" || validation.status !== "not_run")
@@ -143,6 +150,7 @@ export function deriveReporterFacts(evidence, options = {}) {
143
150
  const packageDependencies = options.packageDependencies ?? defaultPackageDependencies();
144
151
  const specdojoConfig = options.specdojoConfig === undefined ? defaultSpecdojoConfig() : options.specdojoConfig;
145
152
  const projectId = options.projectId ?? evidence.runner_scope?.project_id;
153
+ const executorAttemptPaths = options.executorAttemptPaths ?? executorAttemptPathsForEvidence(evidence);
146
154
  const applicabilityOptions = {
147
155
  packageScripts,
148
156
  packageDependencies,
@@ -152,6 +160,7 @@ export function deriveReporterFacts(evidence, options = {}) {
152
160
  ? { productPackageManifests: options.productPackageManifests }
153
161
  : {}),
154
162
  changedPaths: options.changedPaths ?? evidence.changes.map((change) => change.path),
163
+ ...(executorAttemptPaths ? { executorAttemptPaths } : {}),
155
164
  };
156
165
  const passedCommandsByRepo = new Map();
157
166
  const runnerPassedCommandsByRepo = new Map();
@@ -165,6 +174,11 @@ export function deriveReporterFacts(evidence, options = {}) {
165
174
  // 親検証の結果を正として満たされたものと扱う。executor の failed は runner の結果で
166
175
  // 打ち消さない(PJR-2GZE、PJR-7AW0)。
167
176
  for (const validation of evidence.validations) {
177
+ // runner が変更の種類で流さなかった検証(PJR-T01P)も、委譲先として済んだものと扱う。
178
+ if (validation.source === "runner" && validation.status === "not_applicable") {
179
+ addPassedCommand(runnerPassedCommandsByRepo, validation.repo ?? PARENT_VALIDATION_PROJECT_REPO, normalizeValidationCommand(validation.command));
180
+ continue;
181
+ }
168
182
  if (validation.status !== "passed")
169
183
  continue;
170
184
  if (validation.source === "runner") {
@@ -224,6 +238,11 @@ export function deriveReporterFacts(evidence, options = {}) {
224
238
  isPassedParentValidation(validation.command)) {
225
239
  return false;
226
240
  }
241
+ // 親検証をまとめて書いた 1 行は、挙がった検証がすべて親 runner で通っていれば満たす(PJR-Q2AT)。
242
+ if ((validation.status === "not_run" || validation.status === "not_applicable") &&
243
+ isAggregatedParentValidationSatisfied(validation.command, evidence.validations)) {
244
+ return false;
245
+ }
227
246
  if (validation.status === "not_applicable") {
228
247
  return !isValidNotApplicableValidation(validation.command, validation.reason, applicabilityOptions);
229
248
  }
@@ -288,6 +307,34 @@ function specdojoCommandArgs(command) {
288
307
  return (/^(?:npx\s+)?specdojo\s+(.+)$/u.exec(normalized)?.[1] ??
289
308
  /^(?:(?:node --import tsx|npx tsx|tsx)\s+(?:\.\/)?src\/specdojo\.ts|node\s+(?:\.\/)?dist\/specdojo\.js)\s+(.+)$/u.exec(normalized)?.[1]);
290
309
  }
310
+ function catalogValidateCommandArgs(command, scripts) {
311
+ const normalized = normalizeValidationCommand(command);
312
+ const direct = specdojoCommandArgs(normalized);
313
+ if (direct !== undefined && /^catalog\s+validate(?:\s|$)/u.test(direct)) {
314
+ return direct;
315
+ }
316
+ const helperMatch = /^node\s+(?:--import\s+tsx\s+)?(?:\.\/)?tools\/catalog-validate-if-configured\.mjs(?:\s+(.*))?$/u.exec(normalized);
317
+ if (helperMatch) {
318
+ return `catalog validate${helperMatch[1] ? ` ${helperMatch[1]}` : ""}`;
319
+ }
320
+ const scriptMatch = /^npm run ([A-Za-z0-9:_.-]+)(?:\s+(.*))?$/u.exec(normalized);
321
+ if (!scriptMatch)
322
+ return undefined;
323
+ const [, scriptName, rest] = scriptMatch;
324
+ if (!scriptName || (scripts !== undefined && !hasApplicableScript(scripts, scriptName))) {
325
+ return undefined;
326
+ }
327
+ const suffix = rest ? ` ${rest.replace(/^--\s*/u, "")}` : "";
328
+ if (scriptName === "validate:catalog") {
329
+ return `catalog validate${suffix}`;
330
+ }
331
+ const body = scripts?.[scriptName];
332
+ const bodyArgs = body ? specdojoCommandArgs(body) : undefined;
333
+ if (bodyArgs !== undefined && /^catalog\s+validate(?:\s|$)/u.test(bodyArgs)) {
334
+ return `${bodyArgs}${suffix}`;
335
+ }
336
+ return undefined;
337
+ }
291
338
  /**
292
339
  * Returns why a validation is owned by the runner rather than the executor. `specdojo index build`
293
340
  * writes `.specdojo/doc-index.json`, which agents may not write; the runner regenerates the index
@@ -301,12 +348,45 @@ export function runnerOwnedValidationReason(command) {
301
348
  return "index は runner が worktree の準備と統合の前に再生成する";
302
349
  }
303
350
  const PROJECT_DOCUMENTS_ROOT = "docs/ja/projects/";
351
+ const RUNNER_MANAGED_EXEC_RECORD_PATTERN = /(?:^|\/)exec\/(?:plans|results|evidence|events|\.locks)\//u;
352
+ const EXECUTOR_EDITABLE_EXEC_HISTORY_PATTERN = /(?:^|\/)exec\/(?:plans|results)\/.+\.md$/u;
353
+ function executorAttemptPathsForEvidence(evidence, resultPath) {
354
+ const entries = [
355
+ ...(evidence.attempt_changes ?? []),
356
+ ...(evidence.runner_context?.runner_managed_attempt_changes ?? []),
357
+ ];
358
+ if (entries.length === 0)
359
+ return undefined;
360
+ return new Set(entries
361
+ .flatMap((change) => changedPathSides(change.path))
362
+ .filter((path) => path !== resultPath));
363
+ }
364
+ function isRunnerManagedExecRecordPath(path, executorAttemptPaths) {
365
+ const normalized = path.replaceAll("\\", "/").replace(/^\.\//u, "");
366
+ if (!RUNNER_MANAGED_EXEC_RECORD_PATTERN.test(normalized) && !isRunRecordPath(normalized))
367
+ return false;
368
+ if (executorAttemptPaths?.has(normalized) &&
369
+ (EXECUTOR_EDITABLE_EXEC_HISTORY_PATTERN.test(normalized) ||
370
+ (isRunRecordPath(normalized) && /\/(plan|result)\.md$/u.test(normalized)))) {
371
+ return false;
372
+ }
373
+ return true;
374
+ }
375
+ function isHistoryLinkTargetPath(path) {
376
+ const normalized = path.replaceAll("\\", "/").replace(/^\.\//u, "");
377
+ if (normalized === "pjr-index.md" || normalized.endsWith("/pjr-index.md")) {
378
+ return false;
379
+ }
380
+ return (/(?:^|\/)pjr-[^/]+\.md$/u.test(normalized) ||
381
+ /^docs\/ja\/projects\/.+\/exec\/(?:plans|results)\/.+\.md$/u.test(normalized) ||
382
+ (isRunRecordPath(normalized) && /\/(plan|result)\.md$/u.test(normalized)));
383
+ }
304
384
  const hasExtension = (extensions) => (path) => {
305
385
  const normalized = path.toLowerCase();
306
386
  return extensions.some((extension) => normalized.endsWith(extension));
307
387
  };
308
388
  // The command-to-change mapping is kept in one place and mirrors the change-type rows in
309
- // xep-common-conventions-template.md. Checks such as typecheck intentionally remain outside this
389
+ // xp-common-conventions-template.md. Checks such as typecheck intentionally remain outside this
310
390
  // table: PJR-8WBN requires their existing script-based applicability to stay unchanged.
311
391
  const CHANGE_SCOPED_VALIDATIONS = [
312
392
  {
@@ -326,13 +406,25 @@ const CHANGE_SCOPED_VALIDATIONS = [
326
406
  /^node\s+\S*specdojo-docs-lint\.js\s+markdownlint(?:\s|$)/u.test(command),
327
407
  matchesPath: hasExtension([".md"]),
328
408
  },
409
+ {
410
+ pathCondition: "履歴蓄積ファイル(pjr-*.md など、pjr-index.md と runner が書く plan・result を除く)",
411
+ matchesCommand: (command) => /^npm run validate:history-links(?:\s|$)/u.test(command) ||
412
+ /^(?:npx\s+)?specdojo-docs-lint\s+history-links(?:\s|$)/u.test(command) ||
413
+ /^node\s+\S*specdojo-docs-lint\.js\s+history-links(?:\s|$)/u.test(command),
414
+ matchesPath: isHistoryLinkTargetPath,
415
+ },
329
416
  ];
330
417
  function changedPathSides(path) {
331
418
  return path.split(" -> ").map((side) => side.replaceAll("\\", "/").replace(/^\.\//u, ""));
332
419
  }
333
- function changePathsForCommand(changedPaths, repoName, config, projectId) {
420
+ function deliverableChangedPathSides(changedPaths, executorAttemptPaths) {
421
+ return changedPaths
422
+ .flatMap(changedPathSides)
423
+ .filter((path) => !isRunnerManagedExecRecordPath(path, executorAttemptPaths));
424
+ }
425
+ function changePathsForCommand(changedPaths, repoName, config, projectId, executorAttemptPaths) {
334
426
  const repoNames = declaredRepos(config, projectId).map((repo) => repo.name);
335
- return changedPaths.flatMap(changedPathSides).flatMap((path) => {
427
+ return deliverableChangedPathSides(changedPaths, executorAttemptPaths).flatMap((path) => {
336
428
  if (repoName !== undefined) {
337
429
  const prefix = `${repoName}:`;
338
430
  return path.startsWith(prefix) ? [path.slice(prefix.length)] : [];
@@ -340,13 +432,13 @@ function changePathsForCommand(changedPaths, repoName, config, projectId) {
340
432
  return repoNames.some((name) => path.startsWith(`${name}:`)) ? [] : [path];
341
433
  });
342
434
  }
343
- function changeScopedValidationApplicability(command, changedPaths, repoName, config, projectId) {
435
+ function changeScopedValidationApplicability(command, changedPaths, repoName, config, projectId, executorAttemptPaths) {
344
436
  const validation = CHANGE_SCOPED_VALIDATIONS.find(({ matchesCommand }) => matchesCommand(command));
345
437
  if (!validation)
346
438
  return { recognized: false };
347
439
  if (changedPaths === undefined)
348
440
  return { recognized: true };
349
- const relevantPaths = changePathsForCommand(changedPaths, repoName, config, projectId);
441
+ const relevantPaths = changePathsForCommand(changedPaths, repoName, config, projectId, executorAttemptPaths);
350
442
  return relevantPaths.some(validation.matchesPath)
351
443
  ? { recognized: true, applicable: true }
352
444
  : {
@@ -355,19 +447,19 @@ function changeScopedValidationApplicability(command, changedPaths, repoName, co
355
447
  reason: `変更に ${validation.pathCondition} がない`,
356
448
  };
357
449
  }
358
- function changesReachProjectDocuments(changedPaths) {
359
- return changedPaths
360
- .flatMap((path) => path.split(" -> "))
361
- .some((path) => path.replaceAll("\\", "/").replace(/^\.\//u, "").startsWith(PROJECT_DOCUMENTS_ROOT));
450
+ function changesReachProjectDocuments(changedPaths, executorAttemptPaths) {
451
+ return deliverableChangedPathSides(changedPaths, executorAttemptPaths).some((path) => path.startsWith(PROJECT_DOCUMENTS_ROOT));
362
452
  }
363
453
  function projectOptionOf(args) {
364
454
  return /(?:^|\s)--project(?:=|\s+)([A-Za-z0-9_-]+)(?=\s|$)/u.exec(args)?.[1];
365
455
  }
366
- function specdojoCommandApplicability(command, config, runProjectId, changedPaths) {
367
- const args = specdojoCommandArgs(command);
368
- if (args === undefined)
456
+ function specdojoCommandApplicability(command, config, runProjectId, changedPaths, scripts, executorAttemptPaths) {
457
+ const directArgs = specdojoCommandArgs(command);
458
+ const catalogArgs = catalogValidateCommandArgs(command, scripts);
459
+ if (directArgs === undefined && catalogArgs === undefined)
369
460
  return { recognized: false };
370
- if (!/^catalog\s+validate(?:\s|$)/u.test(args)) {
461
+ const args = catalogArgs ?? directArgs;
462
+ if (args === undefined || !/^catalog\s+validate(?:\s|$)/u.test(args)) {
371
463
  return { recognized: true, applicable: undefined };
372
464
  }
373
465
  const configuredProjectId = config?.current_project;
@@ -381,8 +473,10 @@ function specdojoCommandApplicability(command, config, runProjectId, changedPath
381
473
  return { recognized: true, applicable: undefined };
382
474
  }
383
475
  if (typeof project.catalog_path === "string" && project.catalog_path.trim()) {
384
- // plan の共通規約は catalog validate を docs/ja/projects/ 配下の変更に限って求める。
385
- if (changedPaths !== undefined && !changesReachProjectDocuments(changedPaths)) {
476
+ // plan の共通規約は catalog validate を docs/ja/projects/ 配下の変更(runner が書く
477
+ // exec/ 配下の plan・result などを除く)に限って求める。
478
+ if (changedPaths !== undefined &&
479
+ !changesReachProjectDocuments(changedPaths, executorAttemptPaths)) {
386
480
  return {
387
481
  recognized: true,
388
482
  applicable: false,
@@ -407,12 +501,12 @@ function specdojoCommandApplicability(command, config, runProjectId, changedPath
407
501
  export function mechanicallyNotApplicableReason(command, options = {}) {
408
502
  const normalized = normalizeValidationCommand(command);
409
503
  const config = options.specdojoConfig === undefined ? defaultSpecdojoConfig() : options.specdojoConfig;
410
- const specdojo = specdojoCommandApplicability(normalized, config, options.projectId, options.changedPaths);
504
+ const manifest = commandManifest(normalized, options, config);
505
+ const specdojo = specdojoCommandApplicability(manifest.command, config, options.projectId, options.changedPaths, manifest.scripts, options.executorAttemptPaths);
411
506
  if (specdojo.recognized) {
412
507
  return specdojo.applicable === false ? specdojo.reason : undefined;
413
508
  }
414
- const manifest = commandManifest(normalized, options, config);
415
- const changeScoped = changeScopedValidationApplicability(manifest.command, options.changedPaths, manifest.repoName, config, options.projectId);
509
+ const changeScoped = changeScopedValidationApplicability(manifest.command, options.changedPaths, manifest.repoName, config, options.projectId, options.executorAttemptPaths);
416
510
  if (changeScoped.applicable === false)
417
511
  return changeScoped.reason;
418
512
  const packageJson = manifest.repoName === undefined ? "package.json" : `${manifest.repoName} の package.json`;
@@ -433,13 +527,17 @@ function isValidNotApplicableValidation(command, reason, options) {
433
527
  return false;
434
528
  const normalized = normalizeValidationCommand(command);
435
529
  const config = options.specdojoConfig === undefined ? defaultSpecdojoConfig() : options.specdojoConfig;
436
- const specdojo = specdojoCommandApplicability(normalized, config, options.projectId, options.changedPaths);
530
+ const manifest = commandManifest(normalized, options, config);
531
+ const specdojo = specdojoCommandApplicability(manifest.command, config, options.projectId, options.changedPaths, manifest.scripts, options.executorAttemptPaths);
437
532
  if (specdojo.recognized)
438
533
  return specdojo.applicable !== true;
439
- const manifest = commandManifest(normalized, options, config);
440
- const changeScoped = changeScopedValidationApplicability(manifest.command, options.changedPaths, manifest.repoName, config, options.projectId);
534
+ const changeScoped = changeScopedValidationApplicability(manifest.command, options.changedPaths, manifest.repoName, config, options.projectId, options.executorAttemptPaths);
441
535
  if (changeScoped.applicable === false)
442
536
  return true;
537
+ if (changeScoped.applicable === true &&
538
+ /^node\s+\S*specdojo-docs-lint\.js\s+(?:history-links|markdownlint)(?:\s|$)/u.test(manifest.command)) {
539
+ return false;
540
+ }
443
541
  const scriptName = invokedScriptNameOf(manifest.command);
444
542
  if (scriptName !== undefined && hasApplicableScript(manifest.scripts, scriptName))
445
543
  return false;
@@ -1,14 +1,17 @@
1
1
  import { execFileSync } from "node:child_process";
2
- import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
2
+ import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
3
3
  import { dirname, join, resolve, sep } from "node:path";
4
4
  import { isDeepStrictEqual } from "node:util";
5
5
  import { buildSpecdojoFrontmatter, parseSpecdojoDocument } from "../docs/frontmatter-namespace.js";
6
- import { escapeMarkdownInline, expandTemplate, stripTerminalControlSequences } from "./shared.js";
7
- import { formatMarkdownFile } from "./format.js";
8
- import { deriveReporterFacts, mechanicallyNotApplicableReason, runnerOwnedValidationReason, } from "./reporter.js";
9
6
  import { resolveSpecdojoPath, resolveSpecdojoPathIfExists } from "../docs/template-resolution.js";
10
- import { dump } from "../shared/yaml.js";
11
7
  import { gitEnvironment } from "../shared/git-environment.js";
8
+ import { dump } from "../shared/yaml.js";
9
+ import { formatMarkdownFile } from "./format.js";
10
+ import { deriveReporterFacts, mechanicallyNotApplicableReason, runnerOwnedValidationReason, } from "./reporter.js";
11
+ import { isRunRecordPath, listRunRecords, recordPathForRead, recordStem, resolveRunPlanRef, resultForPlan, taskRecordPaths, } from "./run-records.js";
12
+ import { escapeMarkdownInline, expandTemplate, stripTerminalControlSequences } from "./shared.js";
13
+ import { isCondenseRecords } from "../shared/condense-records.js";
14
+ import { inlineCode } from "./plans-grade-findings.js";
12
15
  export const MAX_INDIVIDUAL_CHANGED_FILES = 50;
13
16
  // ---------------------------------------------------------------------------
14
17
  // Frontmatter helpers
@@ -56,6 +59,11 @@ function serializeFrontmatter(meta) {
56
59
  for (const target of meta.targets)
57
60
  inner.push(` - ${serializeYamlString(target)}`);
58
61
  }
62
+ if (meta.condense_records) {
63
+ inner.push(...dump({ condense_records: meta.condense_records }, { lineWidth: -1, noRefs: true })
64
+ .trimEnd()
65
+ .split("\n"));
66
+ }
59
67
  // reason は agent stderr や subprocess の生出力由来で任意文字を含みうる。まず ANSI エスケープ
60
68
  // シーケンスや制御文字を除去し(色付き hook 出力が result 表示を壊すのを防ぐ)、JSON の
61
69
  // 文字列形式で YAML へ埋め込む。改行・引用符・バックスラッシュも値を変えずに保持できる。
@@ -84,7 +92,12 @@ function parseFrontmatter(content) {
84
92
  else if (typeof value === "number" || typeof value === "boolean")
85
93
  meta[key] = String(value);
86
94
  }
87
- return { meta, ...(targets ? { targets } : {}), body };
95
+ return {
96
+ meta,
97
+ ...(targets ? { targets } : {}),
98
+ body,
99
+ ...(isCondenseRecords(data.condense_records) ? { condenseRecords: data.condense_records } : {}),
100
+ };
88
101
  }
89
102
  function frontmatterWithBody(frontmatter, body) {
90
103
  return `${frontmatter}\n\n${body.replace(/^\n+/, "")}`;
@@ -111,6 +124,9 @@ function loadResultTemplate(mode, approach, execution) {
111
124
  if (mode === "edit" && execution === "human" && approach === "draft") {
112
125
  return readFileSync(resolveSpecdojoPath("docs/ja/specdojo/exec-templates/xer-human-draft-template.md"), "utf8");
113
126
  }
127
+ if (mode === "edit" && approach === "condense") {
128
+ return readFileSync(resolveSpecdojoPath("docs/ja/specdojo/exec-templates/xer-condense-template.md"), "utf8");
129
+ }
114
130
  if (mode === "edit" && approach === "cross-deliverable-dedup") {
115
131
  const crossDeliverablePath = resolveSpecdojoPathIfExists("docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md");
116
132
  if (crossDeliverablePath)
@@ -128,17 +144,14 @@ function loadResultTemplate(mode, approach, execution) {
128
144
  // Public API
129
145
  // ---------------------------------------------------------------------------
130
146
  export function resultPathForTask(executionPath, nameBase) {
131
- return join(executionPath, "exec", "results", `${nameBase}-result.md`);
147
+ return recordPathForRead(executionPath, "result", nameBase);
132
148
  }
133
149
  // A unique-name run retains every attempt as a separate result. When a new result is scaffolded,
134
150
  // close older unfinished attempts for the same task so they no longer look active or actionable.
135
151
  // Fixed-name runs return before this helper is reached and continue to reuse their single result.
136
152
  async function supersedePriorResults(resultsDir, taskId, nextResultPath, supersededAt) {
137
153
  const supersededPaths = [];
138
- for (const fileName of readdirSync(resultsDir).sort()) {
139
- if (!fileName.endsWith("-result.md"))
140
- continue;
141
- const candidatePath = join(resultsDir, fileName);
154
+ for (const candidatePath of listRunRecords(resultsDir, "result")) {
142
155
  if (candidatePath === nextResultPath)
143
156
  continue;
144
157
  let meta;
@@ -172,13 +185,18 @@ const APPROACH_SECTION_WITHOUT_APPROACH = [
172
185
  ].join("\n");
173
186
  export async function scaffoldResult(opts) {
174
187
  const { executionPath, taskId, mode, projectId, planRef, agent, startedAt, approach } = opts;
175
- const stem = opts.stem ?? taskId;
176
- const resultPath = resultPathForTask(executionPath, stem);
188
+ if (approach === "condense" && (mode !== "edit" || opts.targets?.length !== 1)) {
189
+ throw new Error("condense requires edit mode and exactly one target");
190
+ }
191
+ const stem = opts.stem ?? (planRef && isRunRecordPath(planRef) ? recordStem(planRef) : taskId);
192
+ const resultPath = planRef && isRunRecordPath(planRef)
193
+ ? resultForPlan(resolveRunPlanRef(executionPath, planRef))
194
+ : taskRecordPaths(executionPath, taskId, opts.runId ?? stem, opts.origin).result;
177
195
  // Idempotent: claim and exec run can both reach this; never clobber an in-progress result.
178
196
  if (existsSync(resultPath)) {
179
197
  return { resultPath, created: false, supersededPaths: [] };
180
198
  }
181
- const resultsDir = join(executionPath, "exec", "results");
199
+ const resultsDir = dirname(resultPath);
182
200
  if (!existsSync(resultsDir))
183
201
  mkdirSync(resultsDir, { recursive: true });
184
202
  const template = loadResultTemplate(mode, approach, opts.execution);
@@ -197,6 +215,7 @@ export async function scaffoldResult(opts) {
197
215
  ...(planRef ? { plan_ref: planRef } : {}),
198
216
  ...(opts.execution ? { execution: opts.execution } : {}),
199
217
  ...(approach ? { approach } : {}),
218
+ ...(approach === "condense" ? { condense_records: [] } : {}),
200
219
  ...(opts.targets && opts.targets.length > 0 ? { targets: opts.targets } : {}),
201
220
  };
202
221
  const values = {
@@ -218,7 +237,7 @@ export async function scaffoldResult(opts) {
218
237
  }
219
238
  writeFileSync(resultPath, content, "utf8");
220
239
  await formatMarkdownFile(resultPath);
221
- const supersededPaths = await supersedePriorResults(resultsDir, taskId, resultPath, startedAt);
240
+ const supersededPaths = await supersedePriorResults(executionPath, taskId, resultPath, startedAt);
222
241
  return { resultPath, created: true, supersededPaths };
223
242
  }
224
243
  // 必須節が未記入(テンプレートのプレースホルダのまま)かを検知するためのマーカー。
@@ -295,10 +314,24 @@ export function isResultUnfilled(resultPath, mode, scaffoldFrontmatter, original
295
314
  return true;
296
315
  if (!hasNonEmptyScaffoldFields(current.data, mode))
297
316
  return true;
317
+ if (current.data.approach === "condense" &&
318
+ (mode !== "edit" ||
319
+ !isCondenseRecords(current.data.condense_records) ||
320
+ !Array.isArray(current.data.targets) ||
321
+ current.data.targets.length !== 1))
322
+ return true;
323
+ // Condense records are executor facts, filled after scaffolding. Identity and lifecycle
324
+ // fields retain the same comparisons as every other approach.
325
+ const comparable = (data) => {
326
+ const copy = { ...data };
327
+ if (data.approach === "condense" && isCondenseRecords(data.condense_records))
328
+ delete copy.condense_records;
329
+ return copy;
330
+ };
298
331
  if (scaffoldFrontmatter !== undefined) {
299
332
  if (!hasNonEmptyScaffoldFields(scaffoldFrontmatter, mode))
300
333
  return true;
301
- if (!isDeepStrictEqual(current.data, scaffoldFrontmatter))
334
+ if (!isDeepStrictEqual(comparable(current.data), comparable(scaffoldFrontmatter)))
302
335
  return true;
303
336
  }
304
337
  // resume 時は、実行直前の worktree result を上の厳密比較に使う。さらに root に保持した
@@ -307,7 +340,7 @@ export function isResultUnfilled(resultPath, mode, scaffoldFrontmatter, original
307
340
  if (originalScaffoldFrontmatter !== undefined) {
308
341
  if (!hasNonEmptyScaffoldFields(originalScaffoldFrontmatter, mode))
309
342
  return true;
310
- if (!isDeepStrictEqual(immutableScaffoldFields(current.data), immutableScaffoldFields(originalScaffoldFrontmatter))) {
343
+ if (!isDeepStrictEqual(immutableScaffoldFields(comparable(current.data)), immutableScaffoldFields(comparable(originalScaffoldFrontmatter)))) {
311
344
  return true;
312
345
  }
313
346
  }
@@ -610,7 +643,7 @@ export function renderEditReporterBody(output, evidence, options) {
610
643
  ? `rate limit 後に ${event.resume_at ?? "再開可能時刻"} まで待ち、${event.to_actor} で ${event.resumed_at} に再開`
611
644
  : `${event.trigger === "connection_error" ? "接続エラー" : "rate limit"}後に ${event.from_actor} から ${event.to_actor} へ切り替え、${event.resumed_at} に再開`);
612
645
  return [
613
- "# Edit Result",
646
+ options?.approach === "condense" ? "# Condense Result" : "# Edit Result",
614
647
  "",
615
648
  "## 1. 実施内容",
616
649
  "",
@@ -667,9 +700,24 @@ function renderReviewReporterBody(output, evidence) {
667
700
  `- verdict: ${output.verdict}`,
668
701
  ].join("\n");
669
702
  }
703
+ function renderCondenseRecords(records) {
704
+ if (!records.length)
705
+ return "なし";
706
+ const cell = (text) => inlineCode(text).replaceAll("|", "\\|");
707
+ return [
708
+ "| 場所(修正前) | 種類 | 直し方 | 残した理由/意味の維持 | 原因 |",
709
+ "| --- | --- | --- | --- | --- |",
710
+ ...records.map((record) => {
711
+ const cause = record.cause.type === "kata"
712
+ ? `kata:${record.cause.kind}; location=${record.cause.location}`
713
+ : "document";
714
+ return `| ${[record.location, record.category, record.action, record.reason, cause].map(cell).join(" | ")} |`;
715
+ }),
716
+ ].join("\n");
717
+ }
670
718
  /**
671
- * Replaces only the result body from schema-validated reporter data. The scaffolded frontmatter
672
- * remains byte-for-byte runner-owned until the lifecycle status update serializes it.
719
+ * Renders reporter prose and runner-owned facts. Condense records come only from validated
720
+ * executor evidence; all other approaches preserve the scaffold frontmatter byte-for-byte.
673
721
  */
674
722
  export async function renderReporterResult(resultPath, output, evidence, options) {
675
723
  if (!existsSync(resultPath))
@@ -679,7 +727,7 @@ export async function renderReporterResult(resultPath, output, evidence, options
679
727
  if (parsed.data.mode !== output.mode) {
680
728
  throw new Error(`reporter mode does not match result scaffold: ${output.mode}`);
681
729
  }
682
- const frontmatter = content.match(/^---\r?\n[\s\S]*?\r?\n---/)?.[0];
730
+ let frontmatter = content.match(/^---\r?\n[\s\S]*?\r?\n---/)?.[0];
683
731
  if (!frontmatter)
684
732
  throw new Error(`Result frontmatter not found: ${resultPath}`);
685
733
  const approach = options?.approach ??
@@ -691,17 +739,27 @@ export async function renderReporterResult(resultPath, output, evidence, options
691
739
  ...(approach ? { approach } : {}),
692
740
  worktreeDir: options?.worktreeDir ?? findGitRoot(dirname(resultPath)) ?? undefined,
693
741
  };
742
+ let recordsBody = "";
743
+ if (approach === "condense" && output.mode === "edit") {
744
+ if (!isCondenseRecords(evidence.condense_records)) {
745
+ throw new Error("condense requires valid executor condense_records (use [] when no candidates)");
746
+ }
747
+ // Preserve scaffold ownership; add only validated executor facts, never reporter prose.
748
+ const scaffold = { ...parsed.data, condense_records: evidence.condense_records };
749
+ frontmatter = `---\n${dump({ specdojo: scaffold }, { lineWidth: -1, noRefs: true }).trimEnd()}\n---`;
750
+ recordsBody = `\n\n## 5. 修正・保持の記録\n\n${renderCondenseRecords(evidence.condense_records)}`;
751
+ }
694
752
  const body = output.mode === "edit"
695
753
  ? renderEditReporterBody(output, evidence, resolvedOptions)
696
754
  : renderReviewReporterBody(output, evidence);
697
- writeFileSync(resultPath, frontmatterWithBody(frontmatter, body), "utf8");
755
+ writeFileSync(resultPath, frontmatterWithBody(frontmatter, body + recordsBody), "utf8");
698
756
  await formatMarkdownFile(resultPath);
699
757
  }
700
758
  export async function updateResultStatus(resultPath, status, completedAt, reason) {
701
759
  if (!existsSync(resultPath))
702
760
  return;
703
761
  const content = readFileSync(resultPath, "utf8");
704
- const { meta: existingMeta, targets: existingTargets, body } = parseFrontmatter(content);
762
+ const { meta: existingMeta, targets: existingTargets, condenseRecords, body, } = parseFrontmatter(content);
705
763
  // block 理由は blocked のときのみ保持する。新しい reason を優先し、無ければ既存値を残す。
706
764
  // complete へ遷移した場合は理由を消す。
707
765
  const blockReason = status === "blocked" ? (reason ?? existingMeta.block_reason ?? undefined) : undefined;
@@ -724,6 +782,7 @@ export async function updateResultStatus(resultPath, status, completedAt, reason
724
782
  : {}),
725
783
  approach: existingMeta.approach ? existingMeta.approach : undefined,
726
784
  ...(existingTargets ? { targets: existingTargets } : {}),
785
+ ...(condenseRecords ? { condense_records: condenseRecords } : {}),
727
786
  ...(blockReason ? { block_reason: blockReason } : {}),
728
787
  };
729
788
  writeFileSync(resultPath, frontmatterWithBody(serializeFrontmatter(updatedMeta), body), "utf8");
@@ -736,7 +795,7 @@ export async function resetResultForClaim(resultPath, agent, startedAt, executio
736
795
  if (!existsSync(resultPath))
737
796
  return;
738
797
  const content = readFileSync(resultPath, "utf8");
739
- const { meta: existingMeta, targets: existingTargets, body } = parseFrontmatter(content);
798
+ const { meta: existingMeta, targets: existingTargets, condenseRecords, body, } = parseFrontmatter(content);
740
799
  const existingExecution = existingMeta.execution === "human" || existingMeta.execution === "agent"
741
800
  ? existingMeta.execution
742
801
  : undefined;
@@ -757,6 +816,7 @@ export async function resetResultForClaim(resultPath, agent, startedAt, executio
757
816
  ...(nextExecution ? { execution: nextExecution } : {}),
758
817
  approach: existingMeta.approach ? existingMeta.approach : undefined,
759
818
  ...(existingTargets ? { targets: existingTargets } : {}),
819
+ ...(condenseRecords ? { condense_records: condenseRecords } : {}),
760
820
  };
761
821
  writeFileSync(resultPath, frontmatterWithBody(serializeFrontmatter(updatedMeta), body), "utf8");
762
822
  await formatMarkdownFile(resultPath);
@@ -775,6 +835,7 @@ export function parseResultTaskIdentity(resultContent) {
775
835
  [
776
836
  "draft",
777
837
  "fully-guided",
838
+ "condense",
778
839
  "recipe-guided",
779
840
  "freeform",
780
841
  "bootstrap",
@@ -0,0 +1,47 @@
1
+ import { existsSync, readFileSync } from "node:fs";
2
+ import { isReviewVerdict } from "../review/types.js";
3
+ // review の verdict のうち、タスクの完了可否を判断していない(保留を表す)値。review result を
4
+ // 記録できても、runner はこの verdict のタスクを done にせず blocked にする(PJR-M18B)。
5
+ export const PENDING_REVIEW_VERDICTS = new Set([
6
+ "grade-stale",
7
+ "grade-unavailable",
8
+ "changed-during-review",
9
+ ]);
10
+ const PENDING_VERDICT_NEXT_ACTION = {
11
+ "grade-stale": "run `specdojo grade run` for the review subject until it succeeds, then re-run the review task",
12
+ "grade-unavailable": "repair the unreadable grade result sidecar or re-run `specdojo grade run`, then re-run the review task",
13
+ "changed-during-review": "re-run the review task against the current content of the review subject",
14
+ };
15
+ /** Read the review verdict recorded in a review result. */
16
+ export function reviewResultVerdict(resultPath) {
17
+ if (!existsSync(resultPath))
18
+ return undefined;
19
+ const value = readFileSync(resultPath, "utf8").match(/^- verdict:\s*(\S+)\s*$/m)?.[1];
20
+ return isReviewVerdict(value) ? value : undefined;
21
+ }
22
+ /**
23
+ * Decide whether a review task must be blocked instead of completed. A grade that still failed
24
+ * after its retries, or a pending verdict, leaves the subject without a usable grade.
25
+ * Returns the block reason with the next action, or undefined when completion may proceed.
26
+ */
27
+ export function reviewCompletionBlockReason(params) {
28
+ const { verdict, gradeOutcome } = params;
29
+ if (gradeOutcome?.action === "failed") {
30
+ return (`review grade failed after ${gradeOutcome.attempts} attempt(s): ${gradeOutcome.detail}` +
31
+ `; need=fix the grade failure (for example the grade output format) and re-run the review task` +
32
+ `; ref=grade run ${gradeOutcome.runId}`);
33
+ }
34
+ if (verdict && PENDING_REVIEW_VERDICTS.has(verdict)) {
35
+ return `review verdict is ${verdict}; need=${PENDING_VERDICT_NEXT_ACTION[verdict]}`;
36
+ }
37
+ return undefined;
38
+ }
39
+ /** Read the result verdict and decide the block reason for a review-mode task. */
40
+ export function reviewTaskBlockReason(params) {
41
+ if (params.mode !== "review")
42
+ return undefined;
43
+ return reviewCompletionBlockReason({
44
+ verdict: reviewResultVerdict(params.resultPath),
45
+ ...(params.gradeOutcome ? { gradeOutcome: params.gradeOutcome } : {}),
46
+ });
47
+ }