specdojo 0.7.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (462) hide show
  1. package/.github/agents/specdojo-orchestrator.md +7 -3
  2. package/CHANGELOG.md +217 -0
  3. package/dist/catalog/build.js +24 -1
  4. package/dist/catalog/catalog.js +16 -14
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +5 -3
  8. package/dist/commands/build.js +69 -10
  9. package/dist/commands/git.js +206 -0
  10. package/dist/commands/init.js +9 -3
  11. package/dist/commands/night-orchestrator.js +6 -4
  12. package/dist/commands/where.js +25 -0
  13. package/dist/dashboard/dashboard-timeline.js +18 -16
  14. package/dist/dashboard/dashboard.js +616 -261
  15. package/dist/dashboard/epic-plan.js +81 -0
  16. package/dist/dashboard/exec-records.js +16 -20
  17. package/dist/dashboard/routines.js +11 -12
  18. package/dist/dashboard/timeline-build.js +5 -9
  19. package/dist/dashboard/timeline.js +23 -18
  20. package/dist/devcontainer/scaffold.js +18 -0
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/index-command.js +2 -2
  23. package/dist/docs/yaml-business-tables.js +243 -0
  24. package/dist/docs/yaml-interface-tables.js +106 -0
  25. package/dist/docs/yaml-pages-command.js +5 -3
  26. package/dist/docs/yaml-pages.js +268 -3
  27. package/dist/docs/yaml-table-shared.js +70 -0
  28. package/dist/docs/yaml-tables.js +39 -0
  29. package/dist/exec/agent-config.js +31 -0
  30. package/dist/exec/agent-plan.js +3 -2
  31. package/dist/exec/agent-protected-config.js +2 -0
  32. package/dist/exec/commands.js +100 -39
  33. package/dist/exec/commit-hook-skips.js +78 -0
  34. package/dist/exec/core.js +19 -7
  35. package/dist/exec/events.js +179 -8
  36. package/dist/exec/evidence.js +77 -19
  37. package/dist/exec/handoff.js +9 -13
  38. package/dist/exec/limit.js +1 -1
  39. package/dist/exec/mechanical-result.js +45 -0
  40. package/dist/exec/migrate-records.js +249 -0
  41. package/dist/exec/parent-validation.js +209 -15
  42. package/dist/exec/pipeline-state.js +27 -5
  43. package/dist/exec/plans-condense-findings.js +89 -0
  44. package/dist/exec/plans-core.js +45 -19
  45. package/dist/exec/plans-generation.js +52 -30
  46. package/dist/exec/plans-grade-findings.js +8 -3
  47. package/dist/exec/plans-kata-findings.js +61 -0
  48. package/dist/exec/plans-planning.js +3 -3
  49. package/dist/exec/plans-storage.js +12 -24
  50. package/dist/exec/post-integration.js +162 -0
  51. package/dist/exec/queue-command.js +166 -0
  52. package/dist/exec/queue.js +285 -0
  53. package/dist/exec/register-foreign-wait.js +84 -0
  54. package/dist/exec/register-resume.js +55 -56
  55. package/dist/exec/register.js +26 -22
  56. package/dist/exec/repo-integration-sync.js +21 -5
  57. package/dist/exec/repo-integration.js +21 -1
  58. package/dist/exec/reporter.js +121 -23
  59. package/dist/exec/results.js +106 -25
  60. package/dist/exec/review-completion.js +47 -0
  61. package/dist/exec/review-kata.js +112 -0
  62. package/dist/exec/run/agent-pipeline.js +78 -8
  63. package/dist/exec/run/agent.js +32 -13
  64. package/dist/exec/run/change-scope.js +365 -0
  65. package/dist/exec/run/deferred-cleanup.js +31 -0
  66. package/dist/exec/run/in-place.js +73 -33
  67. package/dist/exec/run/job-lock.js +66 -0
  68. package/dist/exec/run/job-sequence.js +137 -0
  69. package/dist/exec/run/job.js +135 -41
  70. package/dist/exec/run/lifecycle-commands.js +189 -37
  71. package/dist/exec/run/lock.js +22 -1
  72. package/dist/exec/run/mode-shared.js +11 -3
  73. package/dist/exec/run/register-command.js +14 -15
  74. package/dist/exec/run/register-core.js +20 -13
  75. package/dist/exec/run/register-mode.js +77 -17
  76. package/dist/exec/run/register-post-review.js +21 -9
  77. package/dist/exec/run/register-resume.js +95 -31
  78. package/dist/exec/run/register-state.js +23 -15
  79. package/dist/exec/run/register-worktree.js +184 -139
  80. package/dist/exec/run/schedule-mode.js +79 -18
  81. package/dist/exec/run/schedule-prepare.js +204 -59
  82. package/dist/exec/run/schedule-task.js +203 -49
  83. package/dist/exec/run/shared.js +9 -3
  84. package/dist/exec/run/trailing-records.js +35 -0
  85. package/dist/exec/run-records.js +2 -0
  86. package/dist/exec/schedule/schedule.js +116 -4
  87. package/dist/exec/shared.js +1 -1
  88. package/dist/exec/smoke.js +190 -0
  89. package/dist/exec/strategy.js +14 -3
  90. package/dist/exec/task-view.js +6 -4
  91. package/dist/exec/trailing-records.js +242 -0
  92. package/dist/exec/trial-commands.js +8 -4
  93. package/dist/exec/trial-core.js +6 -1
  94. package/dist/exec/validate-records-commit.js +110 -0
  95. package/dist/exec/validate-records.js +148 -0
  96. package/dist/exec/validation-metrics.js +181 -0
  97. package/dist/exec/worktree-cleanup-lock.js +26 -0
  98. package/dist/exec/worktree-command.js +38 -17
  99. package/dist/exec/worktree-ops-commit.js +119 -48
  100. package/dist/exec/worktree-ops-lifecycle.js +77 -48
  101. package/dist/exec/worktree-ops-merge.js +13 -2
  102. package/dist/exec/worktree-ops.js +2 -2
  103. package/dist/exec/worktree.js +32 -4
  104. package/dist/grade/apply.js +32 -6
  105. package/dist/grade/command-apply.js +3 -3
  106. package/dist/grade/command-inspect.js +7 -5
  107. package/dist/grade/command-plan.js +1 -1
  108. package/dist/grade/command-run.js +7 -1
  109. package/dist/grade/command-shared.js +1 -1
  110. package/dist/grade/core.js +18 -5
  111. package/dist/grade/markdown.js +3 -3
  112. package/dist/grade/pipeline-state.js +15 -11
  113. package/dist/grade/plan.js +37 -17
  114. package/dist/grade/result.js +3 -3
  115. package/dist/grade/run.js +87 -11
  116. package/dist/grade/target-discovery.js +17 -4
  117. package/dist/grade/targets.js +12 -11
  118. package/dist/job/definition.js +84 -8
  119. package/dist/job/job.js +109 -39
  120. package/dist/job/noop.js +104 -0
  121. package/dist/register/authoring-sources.js +22 -16
  122. package/dist/register/core.js +2 -0
  123. package/dist/register/create-commands.js +28 -3
  124. package/dist/register/deliverable-target.js +9 -1
  125. package/dist/register/epic.js +104 -26
  126. package/dist/register/event-merge.js +3 -0
  127. package/dist/register/events.js +4 -0
  128. package/dist/register/external-project.js +3 -0
  129. package/dist/register/item.js +6 -0
  130. package/dist/register/maintenance-commands.js +6 -3
  131. package/dist/register/planning.js +7 -14
  132. package/dist/register/register.js +74 -16
  133. package/dist/register/track-domains.js +34 -0
  134. package/dist/register/track-plan.js +78 -0
  135. package/dist/register/transition-commands.js +8 -0
  136. package/dist/register/work-table.js +64 -0
  137. package/dist/review/grade.js +35 -13
  138. package/dist/routine/definition.js +13 -3
  139. package/dist/routine/failure.js +30 -0
  140. package/dist/routine/routine.js +189 -71
  141. package/dist/routine/status.js +62 -0
  142. package/dist/routine/storage.js +33 -0
  143. package/dist/schedule/schedule.js +39 -39
  144. package/dist/schedule/strategy-generate-document.js +26 -14
  145. package/dist/schedule/strategy-generate-scope.js +17 -45
  146. package/dist/schedule/strategy-generate.js +33 -3
  147. package/dist/schedule/strategy-profiles.js +86 -12
  148. package/dist/shared/agent-types.js +7 -0
  149. package/dist/shared/condense-records.js +25 -0
  150. package/dist/shared/cross-process-lock.js +9 -1
  151. package/dist/shared/deprecation.js +8 -0
  152. package/dist/shared/dist-freshness.js +8 -2
  153. package/dist/shared/document-metadata.js +20 -0
  154. package/dist/shared/finding-cause.js +20 -0
  155. package/dist/shared/frontmatter-namespace.js +48 -0
  156. package/dist/shared/git-environment.js +2 -1
  157. package/dist/shared/git.js +186 -16
  158. package/dist/shared/grade-result.js +17 -1
  159. package/dist/shared/lefthook-scaffold.js +3 -0
  160. package/dist/shared/local-config.js +244 -0
  161. package/dist/shared/local-state.js +20 -0
  162. package/dist/shared/markdownlint-config.js +8 -3
  163. package/dist/shared/plan-conventions.js +129 -0
  164. package/dist/shared/plan-templates.js +57 -41
  165. package/dist/shared/run-records.js +224 -0
  166. package/dist/shared/specdojo-config.js +73 -41
  167. package/dist/shared/specdojo-gitignore.js +1 -0
  168. package/dist/shared/text.js +74 -6
  169. package/dist/shared/timeline-index.js +2 -0
  170. package/dist/shared/where-alias.js +13 -0
  171. package/dist/specdojo.js +4 -0
  172. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  173. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  174. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  175. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  176. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  177. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  178. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  179. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  180. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  181. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  182. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  183. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  184. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  185. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  186. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  187. package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
  188. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  189. package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
  190. package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
  191. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  192. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  193. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  194. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  195. package/docs/ja/specdojo/guides/quick-start-guide.md +73 -17
  196. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
  197. package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
  198. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  199. package/docs/ja/specdojo/guides/routine-operation-guide.md +23 -12
  200. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  201. package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
  202. package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
  203. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  204. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  205. package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
  206. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  207. package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
  208. package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
  209. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  210. package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
  211. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  212. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  213. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +92 -99
  214. package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
  215. package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
  216. package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
  217. package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
  218. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
  219. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
  220. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  221. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  222. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -48
  223. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
  224. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
  225. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
  226. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
  227. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
  228. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  229. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
  230. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  231. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  232. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  233. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  234. package/docs/ja/specdojo/recipes/stsd-recipe.md +88 -80
  235. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
  236. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
  237. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
  238. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  239. package/docs/ja/specdojo/references/command-reference.md +303 -148
  240. package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
  241. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  242. package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
  243. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  244. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  245. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +63 -290
  246. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
  247. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
  248. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
  249. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
  250. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  251. package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
  252. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
  253. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  254. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  255. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  256. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  257. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +51 -55
  258. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  259. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
  260. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
  261. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  262. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
  263. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  264. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
  265. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  266. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  267. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  268. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +79 -249
  269. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  270. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
  271. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
  272. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
  273. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -14
  274. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  275. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  276. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +171 -0
  277. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  278. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  279. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +93 -57
  280. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
  281. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  282. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
  283. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
  284. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
  285. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  286. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
  287. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  288. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
  289. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  290. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  291. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  292. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  293. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  294. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +12 -23
  295. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  296. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  297. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  298. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  299. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  300. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  301. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  302. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  303. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  304. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  305. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  306. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  307. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  308. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  309. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  310. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  311. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +92 -102
  312. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  313. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  314. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  315. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  316. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +45 -59
  317. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
  318. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
  319. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
  320. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  321. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
  322. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
  323. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
  324. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  325. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
  326. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  327. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  328. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  329. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  330. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  331. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +106 -32
  332. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
  333. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
  334. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  335. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  336. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +46 -40
  337. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
  338. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
  339. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
  340. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
  341. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  342. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  343. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
  344. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  345. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  346. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  347. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  348. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +91 -161
  349. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  350. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  351. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  352. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  353. package/docs/ja/specdojo/samples/bds-sample.md +87 -21
  354. package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
  355. package/docs/ja/specdojo/samples/bes-sample.md +70 -21
  356. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  357. package/docs/ja/specdojo/samples/br-sample.md +57 -15
  358. package/docs/ja/specdojo/samples/ccd-sample.md +80 -19
  359. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  360. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
  361. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  362. package/docs/ja/specdojo/samples/cdsd-sample.md +73 -20
  363. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  364. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  365. package/docs/ja/specdojo/samples/clis-sample.md +125 -0
  366. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  367. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  368. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  369. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  370. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  371. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  372. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  373. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  374. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  375. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  376. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  377. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  378. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  379. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  380. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  381. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  382. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  383. package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
  384. package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
  385. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
  386. package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
  387. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  388. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
  389. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  390. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
  391. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  392. package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
  393. package/docs/ja/specdojo/samples/sf-sample.md +109 -21
  394. package/docs/ja/specdojo/samples/sld-sample.md +88 -21
  395. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  396. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  397. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  398. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  399. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  400. package/docs/ja/specdojo/samples/uis-sample.md +141 -20
  401. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  402. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  403. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  404. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  405. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  406. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  407. package/docs/ja/specdojo/templates/br-template.md +64 -0
  408. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  409. package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
  410. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  411. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  412. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  413. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  414. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  415. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  416. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  417. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  418. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  419. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  420. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  421. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  422. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  423. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  424. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  425. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  426. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  427. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  428. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  429. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  430. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  431. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  432. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  433. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  434. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  435. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  436. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  437. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  438. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  439. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
  440. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
  441. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -0
  442. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  443. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  444. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  445. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  446. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  447. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  448. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  449. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  450. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  451. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  452. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  453. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  454. package/package.json +10 -7
  455. package/templates/antigravity/orchestrator.md +7 -3
  456. package/templates/claude/agents/specdojo-orchestrator.md +7 -3
  457. package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
  458. package/templates/codex/orchestrator.md +7 -3
  459. package/templates/devcontainer/tmux.conf +6 -0
  460. package/templates/init-exec-defaults.yaml +13 -0
  461. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  462. package/templates/opencode/agents/specdojo-orchestrator.md +8 -4
@@ -2,6 +2,7 @@ import { spawnSync } from "node:child_process";
2
2
  import { existsSync, lstatSync, mkdirSync, rmSync, unlinkSync } from "node:fs";
3
3
  import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
4
4
  import { describeGitProcessFailure, formatGitCommandFailure, GitCommandError, gitEnvironment, gitOutput, gitResult, } from "../shared/git.js";
5
+ import { localConfigEnvironment } from "../shared/local-config.js";
5
6
  export { appendGitFailureLog, appendGitResultFailureLog, describeGitProcessFailure, formatGitCommandFailure, formatGitResultFailure, GIT_LOCAL_ENV_VARS, GIT_OUTPUT_MAX_BUFFER, GitCommandError, gitEnvironment, gitOutput, gitResult, isGitDubiousOwnership, isGitIndexLockContention, isGitNotRepositoryWithGitMetadata, runGitWithTransientRetry, summarizeGitArguments, summarizeGitHookFailure, summarizeGitStderr, transientGitFailureReason, } from "../shared/git.js";
6
7
  export function worktreeNameFromTaskId(value) {
7
8
  const slug = value
@@ -15,7 +16,15 @@ export function worktreeNameFromTaskId(value) {
15
16
  }
16
17
  export function resolveWorktreeBase(repoRoot, override, configured) {
17
18
  const value = override?.trim() || configured?.trim() || "../worktrees";
18
- return isAbsolute(value) ? resolve(value) : resolve(repoRoot, value);
19
+ if (isAbsolute(value))
20
+ return resolve(value);
21
+ // An explicit CLI override remains relative to the invoking checkout. Persistent
22
+ // configuration and the default use the main checkout, also from a Job worktree.
23
+ if (override?.trim())
24
+ return resolve(repoRoot, value);
25
+ const listed = gitResult(repoRoot, ["worktree", "list", "--porcelain"]);
26
+ const mainPath = listed.status === 0 ? String(listed.stdout ?? "").match(/^worktree (.+)$/m)?.[1] : undefined;
27
+ return resolve(mainPath ?? repoRoot, value);
19
28
  }
20
29
  export function listRegisteredWorktrees(repoRoot) {
21
30
  const output = gitOutput(repoRoot, ["worktree", "list", "--porcelain"]);
@@ -80,9 +89,18 @@ function trackedPackageLockDirs(worktreePath) {
80
89
  }
81
90
  return [...dirs].sort();
82
91
  }
92
+ export const NPM_CI_ARGS = [
93
+ "ci",
94
+ "--include=dev",
95
+ "--prefer-offline",
96
+ "--no-audit",
97
+ "--no-fund",
98
+ ];
83
99
  function runNpmCi(packageDir) {
84
100
  const command = process.platform === "win32" ? "npm.cmd" : "npm";
85
- const result = spawnSync(command, ["ci", "--include=dev"], {
101
+ // PJR-T01P: lock から入れる依存は主の作業ツリーと同じになるため、cache にある tarball を
102
+ // 再検証せずに使い(--prefer-offline)、準備に要らない audit と fund の問い合わせを省く。
103
+ const result = spawnSync(command, NPM_CI_ARGS, {
86
104
  cwd: packageDir,
87
105
  env: { ...gitEnvironment(), CI: "true", LEFTHOOK: "0" },
88
106
  stdio: "inherit",
@@ -128,6 +146,15 @@ export function formatWorktreeBuildFailure(worktreePath, detail) {
128
146
  `Generated docs are gitignored and must be rebuilt per worktree, so this is a ` +
129
147
  `preparation failure, not a task deliverable failure.`);
130
148
  }
149
+ /** Environment of `specdojo build` in a worktree, including the main tree's local config. */
150
+ export function worktreeBuildEnvironment(worktreePath) {
151
+ return {
152
+ ...gitEnvironment(),
153
+ ...localConfigEnvironment(worktreePath),
154
+ CI: "true",
155
+ LEFTHOOK: "0",
156
+ };
157
+ }
131
158
  // build は worktree 内で完結させる。依存と同じく、worktree の checkout にある CLI を使うため、
132
159
  // 実行元プロセスの entry(テストランナー等)へは依存しない。SpecDojo 自身のリポジトリでは
133
160
  // src の entry を worktree の tsx で、CLI を依存として使うリポジトリでは
@@ -148,7 +175,8 @@ export function resolveWorktreeBuildCommand(worktreePath) {
148
175
  return null;
149
176
  }
150
177
  // worktree を cwd にして build を実行する。child は cwd から .specdojo/specdojo.config.json を
151
- // 辿るため、生成先は worktree 側になる。
178
+ // 辿るため、生成先は worktree 側になる。ローカル設定は worktree へ複製せず、主の作業ツリーの
179
+ // ファイルのパスを環境変数で渡す(PJR-NC9R)。
152
180
  function runWorktreeBuild(worktreePath) {
153
181
  const resolved = resolveWorktreeBuildCommand(worktreePath);
154
182
  if (!resolved) {
@@ -158,7 +186,7 @@ function runWorktreeBuild(worktreePath) {
158
186
  process.stdout.write("Generating worktree artifacts: specdojo build\n");
159
187
  const result = spawnSync(resolved.command, resolved.args, {
160
188
  cwd: worktreePath,
161
- env: { ...gitEnvironment(), CI: "true", LEFTHOOK: "0" },
189
+ env: worktreeBuildEnvironment(worktreePath),
162
190
  stdio: "inherit",
163
191
  });
164
192
  if (result.error) {
@@ -3,13 +3,14 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
3
3
  import { dirname, join, relative, resolve, sep } from "node:path";
4
4
  import { dump } from "../shared/yaml.js";
5
5
  import { extractJsonText } from "../shared/agent-response.js";
6
- import { CRITERION_ID_RE, CRITERION_STATUSES, DONE_CRITERIA_SCHEMA, SEVERITY_LEVEL_CAP, agentViewpoints, correctViewpointLevels, isRecord, levelCapForFindings, parseMarkdown, preserveStoredFindingSeverities, sanitizeCommentText, } from "./core.js";
6
+ import { CRITERION_ID_RE, CRITERION_STATUSES, DONE_CRITERIA_SCHEMA, SEVERITY_LEVEL_CAP, agentViewpoints, correctViewpointLevels, isRecord, levelCapForFindings, parseMarkdown, parseGradeDocument, preserveStoredFindingSeverities, sanitizeCommentText, } from "./core.js";
7
7
  import { applicableDoneCriteria, deterministicResults, gradePlanFilename } from "./plan.js";
8
- import { gradeContentHash, gradeResultPathForDocument, markdownDocumentId, readGradeResult, writeGradeResult, } from "./result.js";
8
+ import { gradeContentHash, gradeResultPathForDocument, gradeDocumentId, readGradeResult, writeGradeResult, } from "./result.js";
9
9
  import { gradeMarkdownDocument, resolveGradeReferenceId, scoreDocument, summarizeDoneCriteria, } from "./markdown.js";
10
10
  import { assertRubric, createGradeSourceContext, gradeSourceHashes, repoRelativePath, resolveSafeMarkdownPath, resolveSafeRepositoryPath, } from "./targets.js";
11
11
  import { specdojoRootDir } from "../shared/specdojo-config.js";
12
12
  import { resolveSpecdojoPath } from "../docs/template-resolution.js";
13
+ import { findingCause, isFindingCause } from "../shared/finding-cause.js";
13
14
  export function normalizeGradeExecutorLine(line) {
14
15
  let normalized = line.replace(/^\s*(?:>\s*)*(?:[-*+]\s+)?/, "");
15
16
  const wrappedMarker = normalized.match(/^\*\*(\[(?:END )?(?:VIEWPOINT[^\]]*|DONE_CRITERIA)\])\*\*\s*$/);
@@ -18,7 +19,7 @@ export function normalizeGradeExecutorLine(line) {
18
19
  const wrappedLevel = normalized.match(/^\*\*(LEVEL:\s*[0-4])\*\*\s*$/);
19
20
  if (wrappedLevel)
20
21
  return wrappedLevel[1];
21
- normalized = normalized.replace(/^\*\*(LEVEL|FINDING(?:\s+[a-z]+)?(?:\s+line=[0-9]+)?|DC-[0-9]{3,})(:?)\*\*(:?)/, (_match, head, innerColon, outerColon) => `${head}${innerColon}${outerColon}`);
22
+ normalized = normalized.replace(/^\*\*(LEVEL|CAUSE|FINDING(?:\s+[a-z]+)?(?:\s+line=[0-9]+)?|DC-[0-9]{3,})(:?)\*\*(:?)/, (_match, head, innerColon, outerColon) => `${head}${innerColon}${outerColon}`);
22
23
  return normalized;
23
24
  }
24
25
  export function parseGradeExecutorAnalysis(raw) {
@@ -79,6 +80,18 @@ export function parseGradeExecutorAnalysis(raw) {
79
80
  }
80
81
  if (!current)
81
82
  continue;
83
+ const causeLine = line.match(/^CAUSE:\s*(.*)$/);
84
+ if (causeLine) {
85
+ const finding = current.findings.at(-1);
86
+ if (!finding || finding.cause !== undefined) {
87
+ throw new Error(`line ${lineIndex + 1}: CAUSE requires a preceding FINDING without cause`);
88
+ }
89
+ const cause = JSON.parse(causeLine[1]);
90
+ if (!isFindingCause(cause))
91
+ throw new Error(`line ${lineIndex + 1}: invalid finding cause`);
92
+ finding.cause = cause;
93
+ continue;
94
+ }
82
95
  const level = line.match(/^LEVEL:\s*([0-4])\s*$/);
83
96
  if (level) {
84
97
  if (current.level !== undefined) {
@@ -129,6 +142,7 @@ function findingFidelityKey(finding) {
129
142
  severity: finding.severity,
130
143
  line: finding.line ?? null,
131
144
  message: normalizeFindingMessageForFidelity(finding.message),
145
+ cause: finding.cause === undefined ? null : findingCause(finding),
132
146
  });
133
147
  }
134
148
  function unmatchedFindings(declared, reported) {
@@ -154,6 +168,10 @@ function unmatchedFindings(declared, reported) {
154
168
  }
155
169
  function findingDifferenceMessage(declared, reported) {
156
170
  const differences = [];
171
+ if (JSON.stringify(declared.cause === undefined ? null : findingCause(declared)) !==
172
+ JSON.stringify(reported.cause === undefined ? null : findingCause(reported))) {
173
+ differences.push(`cause executor=${JSON.stringify(declared.cause ?? null)} reporter=${JSON.stringify(reported.cause ?? null)}`);
174
+ }
157
175
  if (declared.severity !== reported.severity) {
158
176
  differences.push(`severity executor=${declared.severity} reporter=${reported.severity}`);
159
177
  }
@@ -413,7 +431,7 @@ export function validateGradeSubmission(submission, doc, target, options = {}) {
413
431
  const absoluteDocumentPath = resolve(specdojoRootDir(), document.path);
414
432
  const normalizedDocumentPath = repoRelativePath(absoluteDocumentPath);
415
433
  const metadata = existsSync(absoluteDocumentPath)
416
- ? parseMarkdown(readFileSync(absoluteDocumentPath, "utf8"), normalizedDocumentPath).data
434
+ ? parseGradeDocument(readFileSync(absoluteDocumentPath, "utf8"), normalizedDocumentPath).data
417
435
  .specdojo
418
436
  : {};
419
437
  const required = agentViewpoints(doc, target, metadata);
@@ -464,6 +482,13 @@ export function validateGradeSubmission(submission, doc, target, options = {}) {
464
482
  });
465
483
  continue;
466
484
  }
485
+ if (finding.cause !== undefined &&
486
+ (target !== "deliverable" || !isFindingCause(finding.cause))) {
487
+ issues.push({
488
+ path: `${resultPath}.findings[${findingIndex}].cause`,
489
+ message: "cause must be document or kata with kind and location, and is accepted only for deliverable targets",
490
+ });
491
+ }
467
492
  if (finding.message_ja !== undefined &&
468
493
  (typeof finding.message_ja !== "string" || !finding.message_ja.trim())) {
469
494
  issues.push({
@@ -574,14 +599,14 @@ export function applyGradeSubmission(opts) {
574
599
  throw new Error(`${rel}: criteriaDirectory is required to record done_criteria`);
575
600
  }
576
601
  if (opts.resultsDirectory) {
577
- const documentId = markdownDocumentId(current, rel);
602
+ const documentId = gradeDocumentId(current, rel);
578
603
  const resultPath = gradeResultPathForDocument({
579
604
  documentPath: absolute,
580
605
  project: opts.project,
581
606
  resultsDirectory: opts.resultsDirectory,
582
607
  });
583
608
  const previous = readGradeResult(resultPath);
584
- const document = parseMarkdown(current, rel);
609
+ const document = parseGradeDocument(current, rel);
585
610
  const agentResults = preserveStoredFindingSeverities(previous, input.viewpoints);
586
611
  const correctionByViewpoint = new Map((input.level_corrections ?? []).map((correction) => [
587
612
  correction.viewpoint,
@@ -630,6 +655,7 @@ export function applyGradeSubmission(opts) {
630
655
  anchor: bodyLines[Math.min(bodyLines.length, line) - 1]?.trim() ?? "",
631
656
  message: sanitizeCommentText(finding.message),
632
657
  message_ja: sanitizeCommentText(finding.message_ja ?? finding.message),
658
+ ...(finding.cause !== undefined ? { cause: finding.cause } : {}),
633
659
  };
634
660
  }));
635
661
  const criteriaResults = opts.target === "deliverable" && definitions && input.done_criteria && detailPath
@@ -22,7 +22,7 @@ export function renderGradeFindingTranslationPlan(result, translationIndex) {
22
22
  }
23
23
  export function registerGradeApplyCommands(grade) {
24
24
  addSelection(grade
25
- .command("apply")
25
+ .command("apply", { hidden: true })
26
26
  .description("Convert executor markers (or validate reporter JSON), calculate scores, and update documents"))
27
27
  .option("--from <path>", "GradeSubmission JSON produced by an LLM reporter; omit to convert --analysis-from mechanically")
28
28
  .requiredOption("--by <nickname>", "Grading agent nickname from agent-members.yaml")
@@ -144,7 +144,7 @@ export function registerGradeApplyCommands(grade) {
144
144
  }
145
145
  });
146
146
  addSelection(grade
147
- .command("translation-plan")
147
+ .command("translation-plan", { hidden: true })
148
148
  .description("Create a Japanese translation request for the latest canonical findings"))
149
149
  .requiredOption("--out <path>", "Write the translation plan to this repository path")
150
150
  .option("--translation-index <index>", "Translate only this zero-based index from the translatable findings", requireNonNegativeInteger)
@@ -189,7 +189,7 @@ export function registerGradeApplyCommands(grade) {
189
189
  }
190
190
  });
191
191
  addSelection(grade
192
- .command("localize")
192
+ .command("localize", { hidden: true })
193
193
  .description("Attach Japanese display messages to the latest canonical grade findings"))
194
194
  .requiredOption("--from <path>", "JSON string array returned by the translation agent")
195
195
  .option("--translation-index <index>", "Apply a retry for this zero-based index from the translatable findings", requireNonNegativeInteger)
@@ -6,7 +6,9 @@ import { readGradeResultForDocument } from "./result.js";
6
6
  import { repoRelativePath, resolveSafeMarkdownPath } from "./targets.js";
7
7
  import { specdojoRootDir } from "../shared/specdojo-config.js";
8
8
  export function registerGradeInspectionCommands(grade) {
9
- addSelection(grade.command("validate").description("Validate stored grade hashes and finding counts")).action((options) => {
9
+ addSelection(grade
10
+ .command("validate", { hidden: true })
11
+ .description("Validate stored grade hashes and finding counts")).action((options) => {
10
12
  try {
11
13
  const target = requireTarget(options.target);
12
14
  const paths = discoverGradeTargets({
@@ -36,9 +38,9 @@ export function registerGradeInspectionCommands(grade) {
36
38
  }
37
39
  });
38
40
  grade
39
- .command("result")
41
+ .command("result", { hidden: true })
40
42
  .description("Print the stored grade result sidecar for one document as JSON")
41
- .requiredOption("--path <path>", "Markdown document whose grade result is read")
43
+ .requiredOption("--path <path>", "Markdown or YAML document whose grade result is read")
42
44
  .option("--project <projectId>", "Project id in specdojo.config.json")
43
45
  .action((options) => {
44
46
  try {
@@ -53,11 +55,11 @@ export function registerGradeInspectionCommands(grade) {
53
55
  }
54
56
  });
55
57
  grade
56
- .command("state")
58
+ .command("state", { hidden: true })
57
59
  .description("Read or update persistent per-document grade pipeline state")
58
60
  .requiredOption("--target <target>", "kata or deliverable")
59
61
  .option("--project <projectId>", "Project id in specdojo.config.json")
60
- .option("--path <path>", "Markdown document whose pipeline state is read or updated")
62
+ .option("--path <path>", "Markdown or YAML document whose pipeline state is read or updated")
61
63
  .option("--status <status>", "Record passed, failed, or complete", requirePipelineStatus)
62
64
  .option("--stage <number>", "Current pipeline stage", requirePositiveInteger)
63
65
  .option("--stage-total <number>", "Total pipeline stages", requirePositiveInteger, 3)
@@ -30,7 +30,7 @@ export function registerGradePlanCommands(grade) {
30
30
  }
31
31
  });
32
32
  addSelection(grade
33
- .command("plan")
33
+ .command("plan", { hidden: true })
34
34
  .description("Write reusable executor and reporter plans per selected document"))
35
35
  .option("--out <directory>", "Write plans below this repository-relative directory")
36
36
  .option("--reference <path>", "Use this document as the comparison reference")
@@ -1,5 +1,5 @@
1
1
  import { addGradeSelectionOptions, commandError, requirePositiveInteger, requireTarget, } from "./command-shared.js";
2
- import { runGrade } from "./run.js";
2
+ import { GradeRunIncompleteError, runGrade } from "./run.js";
3
3
  export function registerGradeRunCommand(grade, runtime) {
4
4
  addGradeSelectionOptions(grade
5
5
  .command("run")
@@ -10,7 +10,10 @@ export function registerGradeRunCommand(grade, runtime) {
10
10
  .option("--stage-1-executor <nickname>", "Alias for --by")
11
11
  .option("--stages <count>", "Native pipeline stage count (1)", "1")
12
12
  .option("--work-dir <directory>", "Repository-relative run state directory")
13
+ .option("--isolate-pipeline-state", "Keep retry state inside this run directory")
14
+ .option("--if-busy <policy>", "Project grade lock policy: fail or wait")
13
15
  .option("--reference <path>", "Comparison reference document")
16
+ .option("--reference-per-kind", "Kata only: compare each document with the same-kind prj-overview document", false)
14
17
  .option("--embed-documents", "Embed target and reference contents", false)
15
18
  .option("--max-stage-failures <count>", "Consecutive failure limit", requirePositiveInteger, 3)
16
19
  .option("--limit <count>", "Maximum number of documents", requirePositiveInteger)
@@ -34,6 +37,9 @@ export function registerGradeRunCommand(grade, runtime) {
34
37
  }
35
38
  catch (error) {
36
39
  commandError(error);
40
+ // Exit 2 marks a partial run and 75 a rate limit; scheduled jobs tell them apart.
41
+ if (error instanceof GradeRunIncompleteError)
42
+ process.exitCode = error.exitCode;
37
43
  }
38
44
  });
39
45
  }
@@ -54,7 +54,7 @@ export function addGradeSelectionOptions(command) {
54
54
  return command
55
55
  .requiredOption("--target <target>", "kata or deliverable")
56
56
  .option("--project <projectId>", "Project id in specdojo.config.json")
57
- .option("--path <path>", "Grade only this Markdown document (repeatable)", collectPathOption, [])
57
+ .option("--path <path>", "Grade only this Markdown or YAML document (repeatable)", collectPathOption, [])
58
58
  .option("--changed-only", "Select documents changed since their latest grade", false)
59
59
  .option("--dependency-changed", "Select documents whose dependencies have been graded more recently", false)
60
60
  .option("--rulebook-changed", "Select documents whose declared rulebook has been graded more recently", false)
@@ -4,6 +4,7 @@ import remarkParse from "remark-parse";
4
4
  import { unified } from "unified";
5
5
  import { viewpointAppliesToDocument } from "../review/plan.js";
6
6
  import { gradeContentHash } from "./result.js";
7
+ import { isYamlDocument, readYamlMetadata } from "../shared/document-metadata.js";
7
8
  export const GRADE_TARGETS = ["kata", "deliverable"];
8
9
  export const FINDING_RE = /^[ \t]*<!--[ \t]*specdojo:finding[ \t]+id=([^ \t]+)[ \t]+severity=(blocker|major|minor|note)[ \t]+rule=([^ \t]+)(?:[ \t]+line=([1-9][0-9]*))?[ \t]+(.*?)[ \t]*-->[ \t]*(?:\r?\n|$)/gm;
9
10
  export const KATA_DIRS = ["rulebooks", "recipes", "samples", "templates"];
@@ -50,10 +51,17 @@ export function preservePreviousFindingSeverities(body, viewpoints) {
50
51
  export function preserveStoredFindingSeverities(previous, viewpoints) {
51
52
  const previousByMessage = new Map();
52
53
  for (const finding of previous?.findings ?? []) {
53
- const message = sanitizeCommentText(finding.message);
54
- const stored = previousByMessage.get(message);
55
- if (stored === undefined || SEVERITY_LEVEL_CAP[finding.severity] < SEVERITY_LEVEL_CAP[stored]) {
56
- previousByMessage.set(message, finding.severity);
54
+ // 英語を正本にした旧結果では、grade plan が表示用の日本語を前回の指摘として示す。
55
+ // 正本と表示用の両方を照合し、日本語で再掲された指摘の severity も引き継ぐ。
56
+ const keys = new Set([finding.message, finding.message_ja]
57
+ .filter((message) => typeof message === "string")
58
+ .map((message) => sanitizeCommentText(message)));
59
+ for (const message of keys) {
60
+ const stored = previousByMessage.get(message);
61
+ if (stored === undefined ||
62
+ SEVERITY_LEVEL_CAP[finding.severity] < SEVERITY_LEVEL_CAP[stored]) {
63
+ previousByMessage.set(message, finding.severity);
64
+ }
57
65
  }
58
66
  }
59
67
  return viewpoints.map((viewpoint) => {
@@ -105,6 +113,11 @@ export function parseMarkdown(content, path) {
105
113
  }
106
114
  return { data: parsed, body: (match[2] ?? "").replace(/^(?:\r?\n)+/, "") };
107
115
  }
116
+ export function parseGradeDocument(content, path) {
117
+ if (!isYamlDocument(path))
118
+ return parseMarkdown(content, path);
119
+ return { data: { specdojo: readYamlMetadata(content, path) }, body: content, format: "yaml" };
120
+ }
108
121
  function serializeGrade(grade) {
109
122
  const gradeForDump = structuredClone(grade);
110
123
  const findings = isRecord(gradeForDump.findings) ? gradeForDump.findings : undefined;
@@ -197,7 +210,7 @@ function stableContentHash(document) {
197
210
  // pipeline 状態は成果物そのもののハッシュで識別する。grade apply は成果物を変更しないため、
198
211
  // grade / finding や空行を除外する正規化は不要である。
199
212
  export function pipelineContentHash(document) {
200
- return stableContentHash(document);
213
+ return document.format === "yaml" ? gradeContentHash(document.body) : stableContentHash(document);
201
214
  }
202
215
  export function sanitizeCommentText(value) {
203
216
  return (value
@@ -1,5 +1,5 @@
1
1
  import { readFileSync, writeFileSync } from "node:fs";
2
- import { FINDING_RE, insertFindings, isRecord, legacyInlineContentHash, parseMarkdown, preservePreviousFindingSeverities, serializeMarkdown, withoutFindingComments, } from "./core.js";
2
+ import { FINDING_RE, insertFindings, isRecord, legacyInlineContentHash, parseMarkdown, parseGradeDocument, preservePreviousFindingSeverities, serializeMarkdown, withoutFindingComments, } from "./core.js";
3
3
  import { discoverGradeTargets } from "./target-discovery.js";
4
4
  import { applicableDoneCriteria, deterministicResults } from "./plan.js";
5
5
  import { gradeContentHash, gradeResultPathForDocument, markdownDocumentId, readGradeResultForDocument, resolveGradeResultsDirectory, validateGradeResult, writeGradeResult, } from "./result.js";
@@ -41,10 +41,10 @@ export function scoreDocument(input, rubric, doc, target) {
41
41
  // 引数にはパスと ID のどちらも渡せる。パスの場合は Frontmatter の id を読み取る。
42
42
  export function resolveGradeReferenceId(pathOrId, project) {
43
43
  const trimmed = pathOrId.trim();
44
- if (!trimmed.endsWith(".md"))
44
+ if (!/\.(md|ya?ml)$/i.test(trimmed))
45
45
  return trimmed;
46
46
  const absolute = resolveSafeMarkdownPath(trimmed, specdojoRootDir(), project);
47
- const document = parseMarkdown(readFileSync(absolute, "utf8"), repoRelativePath(absolute));
47
+ const document = parseGradeDocument(readFileSync(absolute, "utf8"), repoRelativePath(absolute));
48
48
  const metadata = document.data.specdojo;
49
49
  if (!isRecord(metadata) || typeof metadata.id !== "string" || metadata.id.length === 0) {
50
50
  throw new Error(`${repoRelativePath(absolute)}: reference document has no specdojo.id`);
@@ -1,19 +1,22 @@
1
+ import { isGradeDocument } from "../shared/document-metadata.js";
1
2
  import { createHash } from "node:crypto";
2
3
  import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
3
4
  import { basename, dirname, extname, isAbsolute, join, resolve } from "node:path";
4
5
  import { listFilesRecursive } from "../shared/fs.js";
5
- import { isRecord, parseMarkdown, pipelineContentHash, } from "./core.js";
6
- import { relativePathFromRoot, repoRelativePath, resolveProject, resolveSafeMarkdownPath, } from "./targets.js";
6
+ import { isRecord, parseGradeDocument, pipelineContentHash, } from "./core.js";
7
+ import { relativePathFromRoot, repoRelativePath, resolveProject, resolveSafeMarkdownPath, resolveSafeRepositoryPath, } from "./targets.js";
7
8
  import { getProjectExecutionPath, specdojoRootDir } from "../shared/specdojo-config.js";
8
9
  function gradePipelineStateDirectory(projectOption, rootDir = specdojoRootDir()) {
9
10
  const { project } = resolveProject(projectOption);
10
11
  return resolve(rootDir, getProjectExecutionPath(project), "grade", "pipeline");
11
12
  }
12
- function gradePipelineStatePath(documentPath, projectOption, rootDir = specdojoRootDir()) {
13
+ function gradePipelineStatePath(documentPath, projectOption, rootDir = specdojoRootDir(), directory) {
13
14
  const relativeDocument = relativePathFromRoot(resolve(rootDir, documentPath), rootDir);
14
15
  const stem = basename(relativeDocument, extname(relativeDocument)).replace(/[^A-Za-z0-9._-]/g, "-");
15
16
  const digest = createHash("sha256").update(relativeDocument).digest("hex").slice(0, 12);
16
- return join(gradePipelineStateDirectory(projectOption, rootDir), `${stem}-${digest}.json`);
17
+ return join(directory === undefined
18
+ ? gradePipelineStateDirectory(projectOption, rootDir)
19
+ : resolveSafeRepositoryPath(directory, "grade pipeline state directory"), `${stem}-${digest}.json`);
17
20
  }
18
21
  function parseGradePipelineState(value, path) {
19
22
  if (!isRecord(value))
@@ -59,8 +62,8 @@ function parseGradePipelineState(value, path) {
59
62
  if (!/^[a-f0-9]{64}$/.test(state.content_hash)) {
60
63
  throw new Error(`${path}: content_hash must be a SHA-256 hex digest`);
61
64
  }
62
- if (isAbsolute(state.document) || !state.document.endsWith(".md")) {
63
- throw new Error(`${path}: document must be a relative Markdown path`);
65
+ if (isAbsolute(state.document) || !isGradeDocument(state.document)) {
66
+ throw new Error(`${path}: document must be a relative Markdown or YAML path`);
64
67
  }
65
68
  if (state.stage_completed >= state.stage_total) {
66
69
  throw new Error(`${path}: completed pipeline state must be removed`);
@@ -103,7 +106,7 @@ export function isIncompleteGradePipelineState(state) {
103
106
  export function readGradePipelineState(opts) {
104
107
  const absolute = resolveSafeMarkdownPath(opts.path, specdojoRootDir(), opts.project);
105
108
  const relativeDocument = repoRelativePath(absolute);
106
- const statePath = gradePipelineStatePath(relativeDocument, opts.project);
109
+ const statePath = gradePipelineStatePath(relativeDocument, opts.project, specdojoRootDir(), opts.directory);
107
110
  if (!existsSync(statePath))
108
111
  return undefined;
109
112
  const state = parseGradePipelineState(JSON.parse(readFileSync(statePath, "utf8")), repoRelativePath(statePath));
@@ -111,7 +114,7 @@ export function readGradePipelineState(opts) {
111
114
  if (state.project_id !== projectId) {
112
115
  throw new Error(`${repoRelativePath(statePath)}: project_id must be ${projectId}`);
113
116
  }
114
- const document = parseMarkdown(readFileSync(absolute, "utf8"), relativeDocument);
117
+ const document = parseGradeDocument(readFileSync(absolute, "utf8"), relativeDocument);
115
118
  return currentGradePipelineState(document, relativeDocument, state, opts.target);
116
119
  }
117
120
  export function listExhaustedGradePipelineStates(opts) {
@@ -124,7 +127,7 @@ export function listExhaustedGradePipelineStates(opts) {
124
127
  if (!existsSync(absolute))
125
128
  return false;
126
129
  resolveSafeMarkdownPath(state.document, specdojoRootDir(), opts.project);
127
- const document = parseMarkdown(readFileSync(absolute, "utf8"), state.document);
130
+ const document = parseGradeDocument(readFileSync(absolute, "utf8"), state.document);
128
131
  return currentGradePipelineState(document, state.document, state, opts.target) !== undefined;
129
132
  })
130
133
  .sort((left, right) => left.document.localeCompare(right.document));
@@ -132,7 +135,7 @@ export function listExhaustedGradePipelineStates(opts) {
132
135
  export function recordGradePipelineStage(opts) {
133
136
  const absolute = resolveSafeMarkdownPath(opts.path, specdojoRootDir(), opts.project);
134
137
  const relativeDocument = repoRelativePath(absolute);
135
- const statePath = gradePipelineStatePath(relativeDocument, opts.project);
138
+ const statePath = gradePipelineStatePath(relativeDocument, opts.project, specdojoRootDir(), opts.directory);
136
139
  if (opts.status === "complete") {
137
140
  if (existsSync(statePath))
138
141
  unlinkSync(statePath);
@@ -146,8 +149,9 @@ export function recordGradePipelineStage(opts) {
146
149
  opts.maxFailures < 1) {
147
150
  throw new Error("grade pipeline stage, total, and failure limit are invalid");
148
151
  }
149
- const document = parseMarkdown(readFileSync(absolute, "utf8"), relativeDocument);
152
+ const document = parseGradeDocument(readFileSync(absolute, "utf8"), relativeDocument);
150
153
  const previous = readGradePipelineState({
154
+ directory: opts.directory,
151
155
  target: opts.target,
152
156
  project: opts.project,
153
157
  path: relativeDocument,
@@ -3,7 +3,8 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
3
3
  import { specdojoRootDir } from "../shared/specdojo-config.js";
4
4
  import { basename, extname, join } from "node:path";
5
5
  import { dump } from "../shared/yaml.js";
6
- import { GRADE_PLAN_EMBEDDED_DOCUMENT_CHARACTER_LIMIT, agentViewpoints, gradedViewpoints, levelCapForFindings, parseMarkdown, } from "./core.js";
6
+ import { isYamlDocument } from "../shared/document-metadata.js";
7
+ import { GRADE_PLAN_EMBEDDED_DOCUMENT_CHARACTER_LIMIT, agentViewpoints, gradedViewpoints, levelCapForFindings, parseGradeDocument, } from "./core.js";
7
8
  import { gradeResultPathForDocument, readGradeResult } from "./result.js";
8
9
  import { assertRubric, loadKataReferences, parseGradeReferenceExample, repoRelativePath, resolveGradeReferencePathsFromCatalog, resolveSafeMarkdownPath, resolveSafeRepositoryPath, selectGradeReferenceExampleFromCatalog, } from "./targets.js";
9
10
  import { viewpointAppliesToDocument } from "../review/plan.js";
@@ -18,12 +19,14 @@ export function deterministicResults(document, definitions, target) {
18
19
  if (typeof specdojo[key] !== "string" || !String(specdojo[key]).trim()) {
19
20
  findings.push({
20
21
  severity: "major",
21
- message: `Frontmatter の specdojo.${key} が未設定です。`,
22
+ message: document.format === "yaml"
23
+ ? `YAML のメタ情報 ${key} が未設定です。`
24
+ : `Frontmatter の specdojo.${key} が未設定です。`,
22
25
  line: 1,
23
26
  });
24
27
  }
25
28
  }
26
- if (!/^#\s+\S/m.test(document.body)) {
29
+ if (document.format !== "yaml" && !/^#\s+\S/m.test(document.body)) {
27
30
  findings.push({ severity: "major", message: "本文に H1 見出しがありません。", line: 1 });
28
31
  }
29
32
  }
@@ -84,7 +87,10 @@ function splitDocumentForEmbedding(content) {
84
87
  }
85
88
  function renderEmbeddedGradeDocument(path, roles) {
86
89
  const content = readFileSync(resolveSafeRepositoryPath(path, "embedded document"), "utf8");
87
- const { frontmatter, body } = splitDocumentForEmbedding(content);
90
+ const yaml = isYamlDocument(path);
91
+ const { frontmatter, body } = yaml
92
+ ? { body: content.replace(/\r\n?/g, "\n").replace(/\n$/, "") }
93
+ : splitDocumentForEmbedding(content);
88
94
  const bodyLines = body === "" ? [] : body.split("\n");
89
95
  const numberedBody = bodyLines.map((line, index) => `${index + 1} | ${line}`).join("\n");
90
96
  const lines = [
@@ -101,7 +107,9 @@ function renderEmbeddedGradeDocument(path, roles) {
101
107
  lines.push(`${fence}yaml`, frontmatter, fence, "");
102
108
  }
103
109
  const bodyFence = markdownFence(numberedBody);
104
- lines.push("本文(左端は `finding.line` と同じ、Frontmatter を除く1始まりの行番号):", "", `${bodyFence}text`, numberedBody, bodyFence, "");
110
+ lines.push(yaml
111
+ ? "YAML 全文(左端は元ファイルの1始まりの行番号であり、`finding.line` に使う):"
112
+ : "本文(左端は `finding.line` と同じ、Frontmatter を除く1始まりの行番号):", "", `${bodyFence}text`, numberedBody, bodyFence, "");
105
113
  return lines;
106
114
  }
107
115
  function gradePlanEmbedding(opts) {
@@ -141,7 +149,7 @@ function renderGradePlanWithEmbedding(opts) {
141
149
  const rubric = assertRubric(opts.viewpoints);
142
150
  const absolute = resolveSafeMarkdownPath(opts.path, specdojoRootDir(), opts.projectId);
143
151
  const rel = repoRelativePath(absolute);
144
- const document = parseMarkdown(readFileSync(absolute, "utf8"), rel);
152
+ const document = parseGradeDocument(readFileSync(absolute, "utf8"), rel);
145
153
  const metadata = document.data.specdojo;
146
154
  const viewpoints = agentViewpoints(opts.viewpoints, opts.target, metadata);
147
155
  const documentId = typeof metadata.id === "string" ? metadata.id : rel;
@@ -236,7 +244,9 @@ function renderGradePlanWithEmbedding(opts) {
236
244
  "",
237
245
  ...(embedding.embedded
238
246
  ? [
239
- "1. plan の「埋め込み資料」にある評価対象の本文を全文読む。Frontmatter は行番号の対象外であり、本文左端の番号を finding の `line` に使う。",
247
+ document.format === "yaml"
248
+ ? "1. plan の「埋め込み資料」にある YAML 全文を読む。左端の元ファイル行番号を finding の `line` に使う。"
249
+ : "1. plan の「埋め込み資料」にある評価対象の本文を全文読む。Frontmatter は行番号の対象外であり、本文左端の番号を finding の `line` に使う。",
240
250
  "2. 埋め込まれた参考資料と良い実例がある場合はすべて読む。ファイル読み取りツールと検索ツールを使わず、plan に埋め込まれた資料だけで判定し、参考資料や良い実例を評価対象と混同しない。",
241
251
  ]
242
252
  : [
@@ -245,13 +255,20 @@ function renderGradePlanWithEmbedding(opts) {
245
255
  ]),
246
256
  "3. 良い実例がある場合は、章ごとの具体性、根拠の密度、過不足を評価対象と比較して記載水準を判定する。表現の類似や実例自体の欠点を評価理由にせず、rubric と viewpoint を最終的な判定基準にする。",
247
257
  "4. 評価対象を次の rubric と viewpoint に照らし、各 viewpoint を 0-4 で判定する。ある viewpoint の finding の有無から、ほかの viewpoint の判定を推論しない。",
248
- "5. 判定根拠と新しい finding の message は英語で記述する。固有名詞・識別子・引用は原文を保ってよい。日本語だけの既存 finding は互換用の正本として扱い、未解消ならその message を翻訳せず原文のまま再掲する。",
249
- "6. level 3 以下には finding を付ける。finding には severity(blocker / major / minor / note)、対象直前の本文行番号、具体的な修正理由を含める。line は Frontmatter を除く本文の1始まり(通常は H1 が1行目)とする。level 4 は finding なしとする。",
250
- "7. 前回の指摘を対象の現在内容と照合し、解消済みか確認する。未解消なら前回の canonical message を変更せず今回の finding に含め、severity は前回と同等以上を指定する。前回の rule は前回評価時の分類として扱い、各 viewpoint は現在の根拠から独立に評価する。前回の問題が解消され、別の軽微な問題だけが残るため severity を引き下げる場合は、その根拠を新しい finding の message に含める。",
258
+ "5. 判定根拠と新しい finding の message は日本語で記述する。固有名詞・識別子・引用は原文を保ってよい。",
259
+ document.format === "yaml"
260
+ ? "6. level 3 以下には finding を付ける。finding には severity(blocker / major / minor / note)、元の YAML ファイルの1始まりの行番号、具体的な修正理由を含める。コメント・メタ情報を含む YAML 全文を評価し、Markdown の見出しや Frontmatter を要求しない。level 4 は finding なしとする。"
261
+ : "6. level 3 以下には finding を付ける。finding には severity(blocker / major / minor / note)、対象直前の本文行番号、具体的な修正理由を含める。line は Frontmatter を除く本文の1始まり(通常は H1 が1行目)とする。level 4 は finding なしとする。",
262
+ ...(opts.target === "deliverable"
263
+ ? [
264
+ '各 finding の直後に `CAUSE: <JSON>` を1行で記す。原因は `{"type":"document"}`、または `{"type":"kata","kind":"rulebook|recipe|sample|template","location":"Kata 内の見出し・行・引用箇所"}` とする(kind は1種類を選ぶ)。冗長さに限らず全 viewpoint で原因を判断する。成果物が宣言した rulebook とそこから辿る Kata を根拠とし、Kata の問題箇所を実際に読んで location に示せる場合だけ kata とする。資料にない・箇所を示せない場合は document とする。原因は点数・判定・前の指摘の引き継ぎを変えない。',
265
+ ]
266
+ : ["Kata そのものの grade では原因を付けず、`CAUSE` 行を出力しない。"]),
267
+ "7. 前回の指摘を対象の現在内容と照合し、解消済みか確認する。未解消なら「前回の指摘」に示した message を一字一句変えずに今回の finding に含め(英語で示された場合も訳さずそのまま再掲する)、severity は前回と同等以上を指定する。前回の rule は前回評価時の分類として扱い、各 viewpoint は現在の根拠から独立に評価する。前回の問題が解消され、別の軽微な問題だけが残るため severity を引き下げる場合は、その根拠を新しい finding の message に含める。",
251
268
  "8. 前回の指摘の確認だけで終了せず、前回の指摘にない問題もすべての viewpoint で独立して検出する。",
252
269
  ...(doneCriteria.length > 0
253
270
  ? [
254
- "9. 完了条件(done_criteria)を1件ずつ本文の根拠と照合し、`satisfied` / `unsatisfied` を判定する。viewpoint の level や総合 score とは独立した判定であり、level が高いことを理由に条件を満たしたとみなさない。`unsatisfied` には不足している内容を英語で1行に記す。",
271
+ "9. 完了条件(done_criteria)を1件ずつ本文の根拠と照合し、`satisfied` / `unsatisfied` を判定する。viewpoint の level や総合 score とは独立した判定であり、level が高いことを理由に条件を満たしたとみなさない。`unsatisfied` には不足している内容を日本語で1行に記す。",
255
272
  ]
256
273
  : []),
257
274
  "",
@@ -260,15 +277,17 @@ function renderGradePlanWithEmbedding(opts) {
260
277
  "grade result サイドカーに記録された前回の finding を示す。対象本文には評価コメントを書き込まない。",
261
278
  "",
262
279
  // 前回の id は今回の採番と混同させないため渡さない。事実(severity / rule / 位置 / message)だけを示す。
280
+ // 英語を正本にした旧結果は、表示用の日本語(message_ja)があればそれを示す。再掲された日本語は
281
+ // grade apply が message_ja とも照合して severity を引き継ぎ、新しい正本になる。
263
282
  ...(priorFindings.length > 0
264
283
  ? [
265
284
  "```json",
266
- JSON.stringify(priorFindings.map(({ severity, rule, line, anchor, message }) => ({
285
+ JSON.stringify(priorFindings.map(({ severity, rule, line, anchor, message, message_ja }) => ({
267
286
  severity,
268
287
  rule,
269
288
  line,
270
289
  anchor,
271
- message,
290
+ message: message_ja ?? message,
272
291
  })), null, 2),
273
292
  "```",
274
293
  ]
@@ -286,8 +305,8 @@ function renderGradePlanWithEmbedding(opts) {
286
305
  "## 4. 完了手順",
287
306
  "",
288
307
  "1. すべての agent viewpoint の判定と、必要な finding が揃っていることを確認する。",
289
- "2. 最終応答では各 viewpoint を次のマーカーで1回ずつ宣言する。マーカー間には根拠や検討過程を自由形式で詳しく記述してよい。JSON、Markdown コードフェンス、GradeSubmission は出力しない。",
290
- "3. `LEVEL` と各 `FINDING` は `grade apply` が機械的に読み取る申告値である。marker・`LEVEL`・`FINDING` はそれぞれ行頭に1行で記し、message は英語で1行に具体的に記す。message は正本としてそのまま記録される。finding がない場合は `FINDING` 行を記さない。",
308
+ "2. 最終応答では各 viewpoint を次のマーカーで1回ずつ宣言する。マーカー間には根拠や検討過程を自由形式で詳しく記述してよい。JSON は `CAUSE` 行の値だけに用い、Markdown コードフェンスや GradeSubmission は出力しない。",
309
+ "3. `LEVEL` と各 `FINDING` は `grade apply` が機械的に読み取る申告値である。marker・`LEVEL`・`FINDING` はそれぞれ行頭に1行で記し、message は日本語で1行に具体的に記す。message は正本としてそのまま記録される。finding がない場合は `FINDING` 行を記さない。",
291
310
  "4. すべての viewpoint marker、0-4 の level、level 3 以下の finding、severity と非空 message が揃っていることを確認する。",
292
311
  ...(doneCriteria.length > 0
293
312
  ? [
@@ -301,6 +320,7 @@ function renderGradePlanWithEmbedding(opts) {
301
320
  "LEVEL: <0-4>",
302
321
  "根拠を自由形式で記述する。",
303
322
  "FINDING <severity> line=<line>: level 3 以下の場合だけ、具体的な修正理由を1行で記述する。",
323
+ ...(opts.target === "deliverable" ? ['CAUSE: {"type":"document"}'] : []),
304
324
  "[END VIEWPOINT]",
305
325
  "",
306
326
  ]),
@@ -336,7 +356,7 @@ export function renderGradeReporterPlan(opts) {
336
356
  const rubric = assertRubric(opts.viewpoints);
337
357
  const absolute = resolveSafeMarkdownPath(opts.path, specdojoRootDir(), opts.projectId);
338
358
  const rel = repoRelativePath(absolute);
339
- const document = parseMarkdown(readFileSync(absolute, "utf8"), rel);
359
+ const document = parseGradeDocument(readFileSync(absolute, "utf8"), rel);
340
360
  const metadata = document.data.specdojo;
341
361
  const viewpoints = agentViewpoints(opts.viewpoints, opts.target, metadata);
342
362
  const documentId = typeof metadata.id === "string" ? metadata.id : rel;
@@ -380,7 +400,7 @@ export function renderGradeReporterPlan(opts) {
380
400
  "## 3. 進め方",
381
401
  "",
382
402
  "1. `<grade_executor_output>` の `[VIEWPOINT <id>]` ごとに `LEVEL` とすべての `FINDING` を読み取る。対象文書や参考資料は読まない。",
383
- "2. level、severity、line、message を executor の申告どおりにコピーする。message の要約、言い換え、校正を行わない。",
403
+ "2. level、severity、line、message を executor の申告どおりにコピーする。`CAUSE: <JSON>` は直前の finding の `cause` に構造を保ってコピーし、省略時は cause を足さない。message の要約、言い換え、校正を行わない。",
384
404
  "3. executor が述べていない finding を追加せず、述べた finding を省略しない。finding の `id` は出力しない。",
385
405
  "4. finding の severity により viewpoint の level に上限がある(`blocker` は上限 0、`major` は上限 2、`minor` は上限 3)。executor の申告が上限を超えていても level は申告どおりにコピーし、補正は `grade apply` に委ねる。marker 欠落など、それ以外の GradeSubmission 契約違反は推測で補わず異常終了する。",
386
406
  ...(doneCriteria.length > 0