specdojo 0.7.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (462) hide show
  1. package/.github/agents/specdojo-orchestrator.md +7 -3
  2. package/CHANGELOG.md +217 -0
  3. package/dist/catalog/build.js +24 -1
  4. package/dist/catalog/catalog.js +16 -14
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +5 -3
  8. package/dist/commands/build.js +69 -10
  9. package/dist/commands/git.js +206 -0
  10. package/dist/commands/init.js +9 -3
  11. package/dist/commands/night-orchestrator.js +6 -4
  12. package/dist/commands/where.js +25 -0
  13. package/dist/dashboard/dashboard-timeline.js +18 -16
  14. package/dist/dashboard/dashboard.js +616 -261
  15. package/dist/dashboard/epic-plan.js +81 -0
  16. package/dist/dashboard/exec-records.js +16 -20
  17. package/dist/dashboard/routines.js +11 -12
  18. package/dist/dashboard/timeline-build.js +5 -9
  19. package/dist/dashboard/timeline.js +23 -18
  20. package/dist/devcontainer/scaffold.js +18 -0
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/index-command.js +2 -2
  23. package/dist/docs/yaml-business-tables.js +243 -0
  24. package/dist/docs/yaml-interface-tables.js +106 -0
  25. package/dist/docs/yaml-pages-command.js +5 -3
  26. package/dist/docs/yaml-pages.js +268 -3
  27. package/dist/docs/yaml-table-shared.js +70 -0
  28. package/dist/docs/yaml-tables.js +39 -0
  29. package/dist/exec/agent-config.js +31 -0
  30. package/dist/exec/agent-plan.js +3 -2
  31. package/dist/exec/agent-protected-config.js +2 -0
  32. package/dist/exec/commands.js +100 -39
  33. package/dist/exec/commit-hook-skips.js +78 -0
  34. package/dist/exec/core.js +19 -7
  35. package/dist/exec/events.js +179 -8
  36. package/dist/exec/evidence.js +77 -19
  37. package/dist/exec/handoff.js +9 -13
  38. package/dist/exec/limit.js +1 -1
  39. package/dist/exec/mechanical-result.js +45 -0
  40. package/dist/exec/migrate-records.js +249 -0
  41. package/dist/exec/parent-validation.js +209 -15
  42. package/dist/exec/pipeline-state.js +27 -5
  43. package/dist/exec/plans-condense-findings.js +89 -0
  44. package/dist/exec/plans-core.js +45 -19
  45. package/dist/exec/plans-generation.js +52 -30
  46. package/dist/exec/plans-grade-findings.js +8 -3
  47. package/dist/exec/plans-kata-findings.js +61 -0
  48. package/dist/exec/plans-planning.js +3 -3
  49. package/dist/exec/plans-storage.js +12 -24
  50. package/dist/exec/post-integration.js +162 -0
  51. package/dist/exec/queue-command.js +166 -0
  52. package/dist/exec/queue.js +285 -0
  53. package/dist/exec/register-foreign-wait.js +84 -0
  54. package/dist/exec/register-resume.js +55 -56
  55. package/dist/exec/register.js +26 -22
  56. package/dist/exec/repo-integration-sync.js +21 -5
  57. package/dist/exec/repo-integration.js +21 -1
  58. package/dist/exec/reporter.js +121 -23
  59. package/dist/exec/results.js +106 -25
  60. package/dist/exec/review-completion.js +47 -0
  61. package/dist/exec/review-kata.js +112 -0
  62. package/dist/exec/run/agent-pipeline.js +78 -8
  63. package/dist/exec/run/agent.js +32 -13
  64. package/dist/exec/run/change-scope.js +365 -0
  65. package/dist/exec/run/deferred-cleanup.js +31 -0
  66. package/dist/exec/run/in-place.js +73 -33
  67. package/dist/exec/run/job-lock.js +66 -0
  68. package/dist/exec/run/job-sequence.js +137 -0
  69. package/dist/exec/run/job.js +135 -41
  70. package/dist/exec/run/lifecycle-commands.js +189 -37
  71. package/dist/exec/run/lock.js +22 -1
  72. package/dist/exec/run/mode-shared.js +11 -3
  73. package/dist/exec/run/register-command.js +14 -15
  74. package/dist/exec/run/register-core.js +20 -13
  75. package/dist/exec/run/register-mode.js +77 -17
  76. package/dist/exec/run/register-post-review.js +21 -9
  77. package/dist/exec/run/register-resume.js +95 -31
  78. package/dist/exec/run/register-state.js +23 -15
  79. package/dist/exec/run/register-worktree.js +184 -139
  80. package/dist/exec/run/schedule-mode.js +79 -18
  81. package/dist/exec/run/schedule-prepare.js +204 -59
  82. package/dist/exec/run/schedule-task.js +203 -49
  83. package/dist/exec/run/shared.js +9 -3
  84. package/dist/exec/run/trailing-records.js +35 -0
  85. package/dist/exec/run-records.js +2 -0
  86. package/dist/exec/schedule/schedule.js +116 -4
  87. package/dist/exec/shared.js +1 -1
  88. package/dist/exec/smoke.js +190 -0
  89. package/dist/exec/strategy.js +14 -3
  90. package/dist/exec/task-view.js +6 -4
  91. package/dist/exec/trailing-records.js +242 -0
  92. package/dist/exec/trial-commands.js +8 -4
  93. package/dist/exec/trial-core.js +6 -1
  94. package/dist/exec/validate-records-commit.js +110 -0
  95. package/dist/exec/validate-records.js +148 -0
  96. package/dist/exec/validation-metrics.js +181 -0
  97. package/dist/exec/worktree-cleanup-lock.js +26 -0
  98. package/dist/exec/worktree-command.js +38 -17
  99. package/dist/exec/worktree-ops-commit.js +119 -48
  100. package/dist/exec/worktree-ops-lifecycle.js +77 -48
  101. package/dist/exec/worktree-ops-merge.js +13 -2
  102. package/dist/exec/worktree-ops.js +2 -2
  103. package/dist/exec/worktree.js +32 -4
  104. package/dist/grade/apply.js +32 -6
  105. package/dist/grade/command-apply.js +3 -3
  106. package/dist/grade/command-inspect.js +7 -5
  107. package/dist/grade/command-plan.js +1 -1
  108. package/dist/grade/command-run.js +7 -1
  109. package/dist/grade/command-shared.js +1 -1
  110. package/dist/grade/core.js +18 -5
  111. package/dist/grade/markdown.js +3 -3
  112. package/dist/grade/pipeline-state.js +15 -11
  113. package/dist/grade/plan.js +37 -17
  114. package/dist/grade/result.js +3 -3
  115. package/dist/grade/run.js +87 -11
  116. package/dist/grade/target-discovery.js +17 -4
  117. package/dist/grade/targets.js +12 -11
  118. package/dist/job/definition.js +84 -8
  119. package/dist/job/job.js +109 -39
  120. package/dist/job/noop.js +104 -0
  121. package/dist/register/authoring-sources.js +22 -16
  122. package/dist/register/core.js +2 -0
  123. package/dist/register/create-commands.js +28 -3
  124. package/dist/register/deliverable-target.js +9 -1
  125. package/dist/register/epic.js +104 -26
  126. package/dist/register/event-merge.js +3 -0
  127. package/dist/register/events.js +4 -0
  128. package/dist/register/external-project.js +3 -0
  129. package/dist/register/item.js +6 -0
  130. package/dist/register/maintenance-commands.js +6 -3
  131. package/dist/register/planning.js +7 -14
  132. package/dist/register/register.js +74 -16
  133. package/dist/register/track-domains.js +34 -0
  134. package/dist/register/track-plan.js +78 -0
  135. package/dist/register/transition-commands.js +8 -0
  136. package/dist/register/work-table.js +64 -0
  137. package/dist/review/grade.js +35 -13
  138. package/dist/routine/definition.js +13 -3
  139. package/dist/routine/failure.js +30 -0
  140. package/dist/routine/routine.js +189 -71
  141. package/dist/routine/status.js +62 -0
  142. package/dist/routine/storage.js +33 -0
  143. package/dist/schedule/schedule.js +39 -39
  144. package/dist/schedule/strategy-generate-document.js +26 -14
  145. package/dist/schedule/strategy-generate-scope.js +17 -45
  146. package/dist/schedule/strategy-generate.js +33 -3
  147. package/dist/schedule/strategy-profiles.js +86 -12
  148. package/dist/shared/agent-types.js +7 -0
  149. package/dist/shared/condense-records.js +25 -0
  150. package/dist/shared/cross-process-lock.js +9 -1
  151. package/dist/shared/deprecation.js +8 -0
  152. package/dist/shared/dist-freshness.js +8 -2
  153. package/dist/shared/document-metadata.js +20 -0
  154. package/dist/shared/finding-cause.js +20 -0
  155. package/dist/shared/frontmatter-namespace.js +48 -0
  156. package/dist/shared/git-environment.js +2 -1
  157. package/dist/shared/git.js +186 -16
  158. package/dist/shared/grade-result.js +17 -1
  159. package/dist/shared/lefthook-scaffold.js +3 -0
  160. package/dist/shared/local-config.js +244 -0
  161. package/dist/shared/local-state.js +20 -0
  162. package/dist/shared/markdownlint-config.js +8 -3
  163. package/dist/shared/plan-conventions.js +129 -0
  164. package/dist/shared/plan-templates.js +57 -41
  165. package/dist/shared/run-records.js +224 -0
  166. package/dist/shared/specdojo-config.js +73 -41
  167. package/dist/shared/specdojo-gitignore.js +1 -0
  168. package/dist/shared/text.js +74 -6
  169. package/dist/shared/timeline-index.js +2 -0
  170. package/dist/shared/where-alias.js +13 -0
  171. package/dist/specdojo.js +4 -0
  172. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  173. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  174. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  175. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  176. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  177. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  178. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  179. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  180. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  181. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  182. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  183. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  184. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  185. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  186. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  187. package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
  188. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  189. package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
  190. package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
  191. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  192. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  193. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  194. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  195. package/docs/ja/specdojo/guides/quick-start-guide.md +73 -17
  196. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
  197. package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
  198. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  199. package/docs/ja/specdojo/guides/routine-operation-guide.md +23 -12
  200. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  201. package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
  202. package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
  203. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  204. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  205. package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
  206. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  207. package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
  208. package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
  209. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  210. package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
  211. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  212. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  213. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +92 -99
  214. package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
  215. package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
  216. package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
  217. package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
  218. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
  219. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
  220. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  221. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  222. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -48
  223. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
  224. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
  225. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
  226. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
  227. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
  228. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  229. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
  230. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  231. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  232. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  233. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  234. package/docs/ja/specdojo/recipes/stsd-recipe.md +88 -80
  235. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
  236. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
  237. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
  238. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  239. package/docs/ja/specdojo/references/command-reference.md +303 -148
  240. package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
  241. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  242. package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
  243. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  244. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  245. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +63 -290
  246. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
  247. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
  248. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
  249. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
  250. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  251. package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
  252. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
  253. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  254. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  255. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  256. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  257. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +51 -55
  258. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  259. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
  260. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
  261. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  262. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
  263. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  264. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
  265. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  266. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  267. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  268. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +79 -249
  269. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  270. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
  271. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
  272. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
  273. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -14
  274. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  275. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  276. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +171 -0
  277. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  278. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  279. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +93 -57
  280. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
  281. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  282. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
  283. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
  284. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
  285. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  286. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
  287. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  288. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
  289. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  290. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  291. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  292. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  293. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  294. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +12 -23
  295. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  296. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  297. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  298. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  299. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  300. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  301. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  302. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  303. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  304. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  305. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  306. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  307. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  308. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  309. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  310. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  311. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +92 -102
  312. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  313. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  314. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  315. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  316. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +45 -59
  317. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
  318. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
  319. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
  320. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  321. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
  322. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
  323. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
  324. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  325. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
  326. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  327. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  328. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  329. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  330. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  331. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +106 -32
  332. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
  333. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
  334. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  335. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  336. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +46 -40
  337. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
  338. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
  339. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
  340. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
  341. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  342. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  343. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
  344. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  345. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  346. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  347. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  348. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +91 -161
  349. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  350. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  351. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  352. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  353. package/docs/ja/specdojo/samples/bds-sample.md +87 -21
  354. package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
  355. package/docs/ja/specdojo/samples/bes-sample.md +70 -21
  356. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  357. package/docs/ja/specdojo/samples/br-sample.md +57 -15
  358. package/docs/ja/specdojo/samples/ccd-sample.md +80 -19
  359. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  360. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
  361. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  362. package/docs/ja/specdojo/samples/cdsd-sample.md +73 -20
  363. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  364. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  365. package/docs/ja/specdojo/samples/clis-sample.md +125 -0
  366. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  367. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  368. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  369. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  370. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  371. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  372. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  373. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  374. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  375. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  376. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  377. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  378. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  379. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  380. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  381. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  382. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  383. package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
  384. package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
  385. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
  386. package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
  387. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  388. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
  389. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  390. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
  391. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  392. package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
  393. package/docs/ja/specdojo/samples/sf-sample.md +109 -21
  394. package/docs/ja/specdojo/samples/sld-sample.md +88 -21
  395. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  396. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  397. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  398. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  399. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  400. package/docs/ja/specdojo/samples/uis-sample.md +141 -20
  401. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  402. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  403. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  404. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  405. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  406. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  407. package/docs/ja/specdojo/templates/br-template.md +64 -0
  408. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  409. package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
  410. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  411. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  412. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  413. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  414. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  415. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  416. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  417. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  418. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  419. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  420. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  421. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  422. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  423. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  424. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  425. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  426. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  427. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  428. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  429. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  430. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  431. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  432. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  433. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  434. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  435. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  436. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  437. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  438. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  439. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
  440. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
  441. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -0
  442. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  443. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  444. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  445. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  446. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  447. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  448. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  449. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  450. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  451. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  452. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  453. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  454. package/package.json +10 -7
  455. package/templates/antigravity/orchestrator.md +7 -3
  456. package/templates/claude/agents/specdojo-orchestrator.md +7 -3
  457. package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
  458. package/templates/codex/orchestrator.md +7 -3
  459. package/templates/devcontainer/tmux.conf +6 -0
  460. package/templates/init-exec-defaults.yaml +13 -0
  461. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  462. package/templates/opencode/agents/specdojo-orchestrator.md +8 -4
@@ -0,0 +1,89 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { resolve } from "node:path";
3
+ import { collectDocIndexEntries } from "../docs/doc-index.js";
4
+ import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
5
+ import { isGeneratedGradeTarget, isTrashedGradeTarget, resolveSafeMarkdownPath, resolveSafeRepositoryPath, } from "../grade/targets.js";
6
+ import { resolveKataRefs } from "../kata/kata.js";
7
+ import { isCondenseRecords } from "../shared/condense-records.js";
8
+ import { getProjectExecutionPath, loadConfig, specdojoRootDir } from "../shared/specdojo-config.js";
9
+ import { load } from "../shared/yaml.js";
10
+ import { inlineCode } from "./plans-grade-findings.js";
11
+ import { listRunRecords } from "./run-records.js";
12
+ /** Latest completed condense result per deliverable, independent of grade freshness. */
13
+ export function condenseKataFindingsText(projectId, kind, kataPath) {
14
+ const root = specdojoRootDir();
15
+ const project = loadConfig(root).config?.projects[projectId];
16
+ if (!project)
17
+ return [];
18
+ const latest = new Map();
19
+ for (const path of listRunRecords(resolve(root, getProjectExecutionPath(project)), "result")) {
20
+ if (!path.endsWith(".md"))
21
+ continue;
22
+ try {
23
+ const meta = readSpecdojoNamespace(readFileSync(path, "utf8"));
24
+ if (meta.type !== "exec-result" ||
25
+ meta.project_id !== projectId ||
26
+ meta.approach !== "condense" ||
27
+ meta.mode !== "edit" ||
28
+ meta.status !== "complete")
29
+ continue;
30
+ if (!Array.isArray(meta.targets) ||
31
+ meta.targets.length !== 1 ||
32
+ typeof meta.targets[0] !== "string")
33
+ continue;
34
+ const timestamp = meta.completed_at ?? meta.started_at;
35
+ const time = typeof timestamp === "string" ? Date.parse(timestamp) : NaN;
36
+ if (!Number.isFinite(time))
37
+ continue;
38
+ const previous = latest.get(meta.targets[0]);
39
+ if (!previous || previous.time <= time)
40
+ latest.set(meta.targets[0], { meta, path, time });
41
+ }
42
+ catch {
43
+ // An unreadable result is not evidence for editing a Kata.
44
+ }
45
+ }
46
+ if (latest.size === 0)
47
+ return [];
48
+ const entries = collectDocIndexEntries(resolve(root, "docs"), root);
49
+ const lines = [];
50
+ for (const [document, { meta, path: resultPath }] of latest) {
51
+ try {
52
+ // Select the latest result before validating records: an empty or invalid latest result
53
+ // must never revive records from an older condense run.
54
+ if (!isCondenseRecords(meta.condense_records))
55
+ continue;
56
+ const indexed = entries[document];
57
+ if (!indexed)
58
+ continue;
59
+ const indexedPath = indexed.replace(/:\d+$/, "");
60
+ const path = indexedPath.endsWith(".md")
61
+ ? resolveSafeMarkdownPath(indexedPath, root, projectId)
62
+ : resolveSafeRepositoryPath(indexedPath, "condense target");
63
+ if (isGeneratedGradeTarget(path, root) || isTrashedGradeTarget(path, root))
64
+ continue;
65
+ const content = readFileSync(path, "utf8");
66
+ const parsed = path.endsWith(".md") ? readSpecdojoNamespace(content) : load(content);
67
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
68
+ continue;
69
+ const metadata = parsed;
70
+ const documentMeta = metadata.specdojo && typeof metadata.specdojo === "object"
71
+ ? metadata.specdojo
72
+ : metadata;
73
+ if (documentMeta.id !== document || typeof documentMeta.rulebook !== "string")
74
+ continue;
75
+ const refs = resolveKataRefs(documentMeta.rulebook);
76
+ if (resolve(root, refs[kind]) !== resolve(root, kataPath))
77
+ continue;
78
+ for (const record of meta.condense_records) {
79
+ if (record.cause.type !== "kata" || record.cause.kind !== kind)
80
+ continue;
81
+ lines.push(`- source=condense; result=${inlineCode(String(meta.id ?? resultPath))}; document=${inlineCode(document)}; location=${inlineCode(record.location)}; category=${inlineCode(record.category)}; action=${inlineCode(record.action)}; reason=${inlineCode(record.reason)}; cause=kata:${kind}; location=${inlineCode(record.cause.location)}`);
82
+ }
83
+ }
84
+ catch {
85
+ // Missing documents or unresolved declarations cannot identify the target Kata.
86
+ }
87
+ }
88
+ return lines;
89
+ }
@@ -1,21 +1,22 @@
1
1
  import { deliverableDocId, loadPlanCatalogDocs as loadCatalogDocs, } from "../catalog/document-target.js";
2
- export { deliverableDocId, resolveDeliverableByDocId, loadPlanCatalogDocs as loadCatalogDocs, } from "../catalog/document-target.js";
2
+ import { recordStem } from "./run-records.js";
3
+ export { deliverableDocId, loadPlanCatalogDocs as loadCatalogDocs, resolveDeliverableByDocId, } from "../catalog/document-target.js";
4
+ export { execTemplatePath, execTemplatesDir, injectCommonConventions, loadPlanTemplate, MISSING, } from "../shared/plan-templates.js";
3
5
  import { existsSync, readFileSync } from "node:fs";
4
6
  import { basename, join, relative, resolve } from "node:path";
5
- import { load } from "../shared/yaml.js";
6
- import { specdojoRootDir } from "../shared/specdojo-config.js";
7
- import { kataDirsForKinds, resolveIncludedRulebooks, resolveKataRefs } from "../kata/kata.js";
8
7
  import { resolveBasePath, resolveDeliverablePath } from "../catalog/paths.js";
9
8
  import { isDctPlanFileName } from "../catalog/plan.js";
10
- import { readSpecdojoNamespace, buildSpecdojoFrontmatter } from "../docs/frontmatter-namespace.js";
11
- import { qualifyPracticeId, SPECDOJO_PRACTICE_AUTHORITY } from "../shared/practice-id.js";
12
- import { MISSING } from "../shared/plan-templates.js";
13
- export { MISSING, execTemplatePath, execTemplatesDir, injectCommonConventions, loadPlanTemplate, } from "../shared/plan-templates.js";
9
+ import { buildSpecdojoFrontmatter, readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
10
+ import { kataDirsForKinds, resolveIncludedRulebooks, resolveKataRefs } from "../kata/kata.js";
11
+ import { renderReviewGradeSummary, reviewGradeFreshness } from "../review/grade.js";
14
12
  import { resolveViewpointsDoc, viewpointAppliesToDocument } from "../review/plan.js";
15
- import { listFilesRecursive, nowUtcIsoSeconds, randomHex, tsForFilenameUtc } from "./shared.js";
16
13
  import { gradeResultPathForDocument, readGradeResultForDocument } from "../shared/grade-result.js";
17
- import { renderReviewGradeSummary, reviewGradeFreshness } from "../review/grade.js";
14
+ import { MISSING } from "../shared/plan-templates.js";
15
+ import { qualifyPracticeId, SPECDOJO_PRACTICE_AUTHORITY } from "../shared/practice-id.js";
16
+ import { specdojoRootDir } from "../shared/specdojo-config.js";
17
+ import { load } from "../shared/yaml.js";
18
18
  import { planGradeFindingText } from "./plans-grade-findings.js";
19
+ import { listFilesRecursive, nowUtcIsoSeconds, randomHex, tsForFilenameUtc } from "./shared.js";
19
20
  export function execDocId(projectId, prefix, localBase) {
20
21
  const localId = `${prefix}-${localBase.toLowerCase()}`;
21
22
  return projectId ? `${projectId}:${localId}` : localId;
@@ -37,10 +38,10 @@ export function buildInPlaceStem(slug, dependencies = {}) {
37
38
  issuedInPlaceStems.add(stem);
38
39
  return stem;
39
40
  }
40
- // Recover the shared stem from a plan path: `.../exec/plans/<stem>-plan.md` → `<stem>`.
41
+ // Recover the shared stem from a plan path: `.../runs/<origin>/<item>/<stem>/plan.md` → `<stem>`.
41
42
  // Used when re-running `--plan <path>` so the tied result is overwritten in place.
42
43
  export function stemFromPlanPath(planPath) {
43
- return basename(planPath).replace(/-plan\.md$/, "");
44
+ return recordStem(planPath);
44
45
  }
45
46
  // ---------------------------------------------------------------------------
46
47
  // Catalog helpers
@@ -220,7 +221,7 @@ export function deliverablePath(deliverable) {
220
221
  export function deliverableName(deliverable) {
221
222
  return deliverable?.deliverable.name ?? MISSING;
222
223
  }
223
- export function gradeFindingsText(projectId, targetPath) {
224
+ export function gradeFindingsText(projectId, targetPath, includeCause = false) {
224
225
  if (!targetPath || targetPath === MISSING || !existsSync(join(specdojoRootDir(), targetPath))) {
225
226
  return "- なし";
226
227
  }
@@ -229,13 +230,32 @@ export function gradeFindingsText(projectId, targetPath) {
229
230
  if (!result || result.findings.length === 0)
230
231
  return "- なし";
231
232
  return result.findings
232
- .map((finding) => `- ${finding.id} ${planGradeFindingText(finding)}`)
233
+ .map((finding) => `- ${finding.id} ${planGradeFindingText(finding, includeCause)}`)
233
234
  .join("\n");
234
235
  }
235
236
  catch {
236
237
  return "- なし";
237
238
  }
238
239
  }
240
+ // 実践の型を整備する approach。成果物ではなく、成果物が宣言する実践の型そのものを編集対象にする。
241
+ const KATA_MAINTENANCE_APPROACHES = new Set([
242
+ "rulebook-maintenance",
243
+ "recipe-maintenance",
244
+ "sample-maintenance",
245
+ "template-maintenance",
246
+ ]);
247
+ // 実践の型の参照を解決するときの成果物の kind。kind: generated の成果物は CLI が生成するため
248
+ // 既定では実践の型を参照しないが、型の整備の段はカタログが宣言する rulebook 自体を整備するので、
249
+ // generated の扱いを外して宣言どおりに解決する(PJR-DM9B)。
250
+ export function kataRefTargetKind(kind, approach) {
251
+ return kind === "generated" && approach && KATA_MAINTENANCE_APPROACHES.has(approach)
252
+ ? undefined
253
+ : kind;
254
+ }
255
+ // タスクの approach を踏まえて、成果物が宣言する実践の型の参照を解決する。
256
+ export function deliverableKataRefs(deliverable, approach) {
257
+ return resolveKataRefs(deliverable?.deliverable.rulebook, kataRefTargetKind(deliverable?.deliverable.kind, approach));
258
+ }
239
259
  export function gradeFindingTargetPath(approach, deliverable, refs) {
240
260
  if (approach === "rulebook-maintenance")
241
261
  return refs.rulebook;
@@ -261,7 +281,7 @@ export function gradeTargetKind(approach) {
261
281
  // 同じ規則で決めるため、plan 生成と runner の実行対象が食い違わない。
262
282
  export function reviewGradeSubject(catalogPath, task) {
263
283
  const deliverable = task.local_id && catalogPath ? findDeliverableInfo(catalogPath, task.local_id) : null;
264
- const refs = resolveKataRefs(deliverable?.deliverable.rulebook, deliverable?.deliverable.kind);
284
+ const refs = deliverableKataRefs(deliverable, task.approach);
265
285
  const path = gradeFindingTargetPath(task.approach, deliverable, refs);
266
286
  if (!path || path === MISSING)
267
287
  return undefined;
@@ -298,12 +318,13 @@ export function kataRefState(refPath) {
298
318
  return existsSync(resolve(specdojoRootDir(), refPath)) ? "existing" : "missing";
299
319
  }
300
320
  // 対象成果物の depends_on を、依存先 doc の [[id]] 参照の入れ子リストで提示する。
301
- // id は依存先の frontmatter、未作成なら配置規約から解決する。agent へ plan を渡すときに
321
+ // id は依存先の frontmatter、未作成なら配置規約から解決する。markMissing の場合は
322
+ // 未作成の依存をインラインコードで示す。agent へ plan を渡すときに
302
323
  // expandPromptRefs(src/exec/run/agent.ts, format:'path')が
303
324
  // この [[id]] を doc-index 経由でリポジトリ相対パスへ展開し、agent が先行成果物を直接開ける。
304
325
  // テンプレート側はラベル直後にこの値を差し込むため、件数 0・成果物未解決時は先頭スペース付きの
305
326
  // インライン値、依存ありの場合は改行始まりの入れ子リストを返す。
306
- export function deliverableDependsOn(deliverable, projectId, catalogPath) {
327
+ export function deliverableDependsOn(deliverable, projectId, catalogPath, markMissing = false) {
307
328
  if (!deliverable)
308
329
  return ` ${MISSING}`;
309
330
  const deps = deliverable.deliverable.depends_on ?? [];
@@ -311,7 +332,11 @@ export function deliverableDependsOn(deliverable, projectId, catalogPath) {
311
332
  return " -";
312
333
  const lines = deps.map((dep) => {
313
334
  const info = findDeliverableInfo(catalogPath, dep);
314
- return ` - [[${deliverableDocId(projectId, dep, info?.resolvedPath)}]]`;
335
+ const id = deliverableDocId(projectId, dep, info?.resolvedPath);
336
+ if (markMissing && (!info || !existsSync(resolve(specdojoRootDir(), info.resolvedPath)))) {
337
+ return ` - \`${id}\`(未作成)`;
338
+ }
339
+ return ` - [[${id}]]`;
315
340
  });
316
341
  return `\n${lines.join("\n")}`;
317
342
  }
@@ -343,6 +368,7 @@ export function deliverableBasedOn(deliverable) {
343
368
  return ids.length ? ids.map((ref) => `[[${ref}]]`).join("、") : "なし";
344
369
  }
345
370
  const PROJECT_CONTEXT_EXCLUDED_APPROACHES = new Set([
371
+ "condense",
346
372
  "cross-deliverable-dedup",
347
373
  "rulebook-authoring",
348
374
  "recipe-authoring",
@@ -501,7 +527,7 @@ export function targetDocIds(projectId, deliverable, approach, fallbackLocalId)
501
527
  const kinds = approach ? (TARGET_REF_KINDS[approach] ?? []) : [];
502
528
  if (kinds.length === 0)
503
529
  return ids;
504
- const refs = resolveKataRefs(deliverable.deliverable.rulebook, deliverable.deliverable.kind);
530
+ const refs = deliverableKataRefs(deliverable, approach);
505
531
  for (const kind of kinds) {
506
532
  const refPath = refs[kind];
507
533
  if (refPath !== MISSING)
@@ -1,14 +1,18 @@
1
+ import { existsSync, mkdirSync, writeFileSync } from "node:fs";
2
+ import { expandPlanConventions } from "../shared/plan-conventions.js";
3
+ import { dirname, resolve } from "node:path";
4
+ import { isAuthoringApproach } from "../kata/authoring.js";
5
+ import { resolveDeliverableSchemaRef } from "../kata/kata.js";
1
6
  import { registerInputSection } from "../register/input.js";
2
- import { mkdirSync, writeFileSync } from "node:fs";
3
- import { join } from "node:path";
7
+ import { isPlanningApproach } from "../register/planning.js";
4
8
  import { DEFAULT_PROJECT_CONTEXT, specdojoRootDir } from "../shared/specdojo-config.js";
5
- import { resolveDeliverableSchemaRef, resolveKataRefs } from "../kata/kata.js";
6
9
  import { formatMarkdownFile } from "./format.js";
7
10
  import { assertPlanMarkdownlint } from "./plan-markdownlint.js";
11
+ import { applicableReviewCriteria, buildInPlaceStem, crossDeliverableTargetDetails, deliverableBasedOn, deliverableBrief, deliverableDependsOn, deliverableKataRefs, deliverableName, deliverableOverview, deliverablePath, doneCriteriaChecklist, doneCriteriaGoals, doneCriteriaItems, execDocId, findDeliverableInfo, frontmatter, gradeFindingsText, gradeFindingTargetPath, gradeResultRef, gradeTargetKind, implementationEvidence, injectCommonConventions, kataRefState, kataRefTargetKind, loadPlanTemplate, loadRoles, loadViewpoints, MISSING, ownerRoleFields, phaseDescriptionText, projectContextSection, repoRelativePath, reviewDoneCriteriaRows, reviewGradeSummaryText, rulebookIncludesText, targetDocIds, targetDocIdsForTask, } from "./plans-core.js";
12
+ import { kataCauseFindingsText } from "./plans-kata-findings.js";
13
+ import { kataReviewSummary, scheduleKataReviewSubjects } from "./review-kata.js";
14
+ import { isRunRecordPath, resultForPlan, taskRecordPaths } from "./run-records.js";
8
15
  import { expandTemplate } from "./shared.js";
9
- import { isAuthoringApproach } from "../kata/authoring.js";
10
- import { isPlanningApproach } from "../register/planning.js";
11
- import { MISSING, applicableReviewCriteria, crossDeliverableTargetDetails, deliverableDependsOn, deliverableBasedOn, deliverableBrief, deliverableName, deliverableOverview, deliverablePath, doneCriteriaChecklist, doneCriteriaGoals, doneCriteriaItems, execDocId, findDeliverableInfo, frontmatter, gradeFindingsText, gradeFindingTargetPath, gradeResultRef, gradeTargetKind, implementationEvidence, injectCommonConventions, kataRefState, loadPlanTemplate, loadRoles, loadViewpoints, ownerRoleFields, phaseDescriptionText, projectContextSection, repoRelativePath, reviewDoneCriteriaRows, reviewGradeSummaryText, rulebookIncludesText, targetDocIds, targetDocIdsForTask, } from "./plans-core.js";
12
16
  function buildEditPlanMarkdown(template, task, deliverable, roleMap, vpMap, projectId, catalogPath, projectContext, resultRef, stem, crossDeliverables = new Map(), planOverrides) {
13
17
  const cpm = task.cpm;
14
18
  const onCriticalPath = cpm !== undefined && cpm.slack === 0;
@@ -32,14 +36,17 @@ function buildEditPlanMarkdown(template, task, deliverable, roleMap, vpMap, proj
32
36
  };
33
37
  const criteria = deliverable?.deliverable.done_criteria ?? [];
34
38
  const ownerRole = ownerRoleFields(task.owner, roleMap, vpMap, deliverable?.deliverable.rulebook);
35
- const refs = planOverrides?.refs ??
36
- resolveKataRefs(deliverable?.deliverable.rulebook, deliverable?.deliverable.kind);
39
+ const refs = planOverrides?.refs ?? deliverableKataRefs(deliverable, task.approach);
40
+ const usesOptionalImplementationEvidence = task.approach === "draft" ||
41
+ task.approach === "fully-guided" ||
42
+ task.approach === "recipe-guided";
43
+ const evidence = implementationEvidence(deliverable);
37
44
  const values = {
38
45
  _FRONTMATTER_: frontmatter(meta),
39
46
  _TASK_ID_: task.id,
40
47
  _PHASE_DESCRIPTION_: phaseDescriptionText(task),
41
48
  _DELIVERABLE_NAME_: deliverableName(deliverable),
42
- _DELIVERABLE_DEPENDS_ON_: deliverableDependsOn(deliverable, projectId, catalogPath),
49
+ _DELIVERABLE_DEPENDS_ON_: deliverableDependsOn(deliverable, projectId, catalogPath, usesOptionalImplementationEvidence),
43
50
  _DELIVERABLE_BASED_ON_: deliverableBasedOn(deliverable),
44
51
  _REGISTER_INPUT_: registerInputSection(planOverrides?.registerInput)
45
52
  ? "下記「個票の入力(前提)」を参照。"
@@ -47,14 +54,18 @@ function buildEditPlanMarkdown(template, task, deliverable, roleMap, vpMap, proj
47
54
  _DELIVERABLE_BRIEF_: deliverableBrief(deliverable),
48
55
  _PROJECT_CONTEXT_: projectContextSection(projectContext, deliverable, task.approach, projectId),
49
56
  _DELIVERABLE_OVERVIEW_: deliverableOverview(deliverable),
50
- _IMPLEMENTATION_EVIDENCE_: deliverable?.catalogless
51
- ? "個票に指定された実装のパスを読み取り専用の調査入力とする。パスが未指定なら実装反映の前に個票へ明記する。"
52
- : implementationEvidence(deliverable),
57
+ _IMPLEMENTATION_EVIDENCE_: usesOptionalImplementationEvidence
58
+ ? evidence === MISSING
59
+ ? "なし(`evidence_refs` 未指定またはカタログなし)。"
60
+ : evidence
61
+ : deliverable?.catalogless
62
+ ? "個票に指定された実装のパスを読み取り専用の調査入力とする。パスが未指定なら実装反映の前に個票へ明記する。"
63
+ : evidence,
53
64
  _DELIVERABLE_PATH_: deliverablePath(deliverable),
54
65
  _RESULT_REF_: resultRef,
55
66
  _RULEBOOK_REF_: refs.rulebook,
56
67
  _RULEBOOK_STATE_: kataRefState(refs.rulebook),
57
- _RULEBOOK_INCLUDES_: rulebookIncludesText(deliverable?.deliverable.rulebook, deliverable?.deliverable.kind),
68
+ _RULEBOOK_INCLUDES_: rulebookIncludesText(deliverable?.deliverable.rulebook, kataRefTargetKind(deliverable?.deliverable.kind, task.approach)),
58
69
  _RECIPE_REF_: refs.recipe,
59
70
  _RECIPE_STATE_: kataRefState(refs.recipe),
60
71
  _SAMPLE_REF_: refs.sample,
@@ -69,7 +80,10 @@ function buildEditPlanMarkdown(template, task, deliverable, roleMap, vpMap, proj
69
80
  : doneCriteriaGoals(criteria, task.owner),
70
81
  _DONE_CRITERIA_CHECKLIST_: doneCriteriaChecklist(criteria),
71
82
  _DONE_CRITERIA_ITEMS_: doneCriteriaItems(criteria),
72
- _GRADE_FINDINGS_: gradeFindingsText(projectId, gradeFindingTargetPath(task.approach, deliverable, refs)),
83
+ _GRADE_FINDINGS_: gradeFindingsText(projectId, gradeFindingTargetPath(task.approach, deliverable, refs), task.approach === "fully-guided"),
84
+ _KATA_CAUSE_FINDINGS_: task.approach?.endsWith("-maintenance")
85
+ ? kataCauseFindingsText(projectId, task.approach.replace(/-maintenance$/, ""), gradeFindingTargetPath(task.approach, deliverable, refs))
86
+ : "- なし",
73
87
  _TARGET_DELIVERABLES_: crossDeliverableTargetDetails(projectId, task.target_local_ids ?? [], crossDeliverables, catalogPath),
74
88
  _AUTHORING_KATA_ID_: planOverrides?.authoring?.id ?? MISSING,
75
89
  _AUTHORING_KATA_KIND_: planOverrides?.authoring?.kind ?? MISSING,
@@ -147,7 +161,7 @@ function buildReviewPlanMarkdown(template, task, deliverable, criteria, vpMap, p
147
161
  ...(task.approach ? { approach: task.approach } : {}),
148
162
  ...(targets.length > 0 ? { targets } : {}),
149
163
  };
150
- const refs = resolveKataRefs(deliverable?.deliverable.rulebook, deliverable?.deliverable.kind);
164
+ const refs = deliverableKataRefs(deliverable, task.approach);
151
165
  const applicableCriteria = applicableReviewCriteria(criteria, vpMap, deliverable?.deliverable.rulebook);
152
166
  const gradeSubjectPath = gradeFindingTargetPath(task.approach, deliverable, refs);
153
167
  const values = {
@@ -165,14 +179,19 @@ function buildReviewPlanMarkdown(template, task, deliverable, criteria, vpMap, p
165
179
  _DELIVERABLE_PATH_: deliverablePath(deliverable),
166
180
  _RESULT_REF_: resultRef,
167
181
  _RULEBOOK_REF_: refs.rulebook,
168
- _RULEBOOK_INCLUDES_: rulebookIncludesText(deliverable?.deliverable.rulebook, deliverable?.deliverable.kind),
182
+ _RULEBOOK_INCLUDES_: rulebookIncludesText(deliverable?.deliverable.rulebook, kataRefTargetKind(deliverable?.deliverable.kind, task.approach)),
169
183
  _RECIPE_REF_: refs.recipe,
170
184
  _SAMPLE_REF_: refs.sample,
171
185
  _TEMPLATE_REF_: refs.template,
172
186
  _GRADE_SUBJECT_PATH_: gradeSubjectPath,
173
187
  _GRADE_TARGET_: gradeTargetKind(task.approach),
174
188
  _GRADE_RESULT_PATH_: gradeResultRef(projectId, gradeSubjectPath),
175
- _GRADE_SUMMARY_: reviewGradeSummaryText(projectId, gradeSubjectPath, reviewGradeOutcome),
189
+ _GRADE_SUMMARY_: [
190
+ reviewGradeSummaryText(projectId, gradeSubjectPath, reviewGradeOutcome),
191
+ kataReviewSummary(scheduleKataReviewSubjects(task, deliverable, projectId), projectId),
192
+ ]
193
+ .filter(Boolean)
194
+ .join("\n\n"),
176
195
  _DONE_CRITERIA_ROWS_: reviewDoneCriteriaRows(applicableCriteria),
177
196
  };
178
197
  const hasBrief = Boolean(deliverable?.deliverable.brief?.trim());
@@ -203,11 +222,12 @@ async function writeTaskPlan(ctx, task, override) {
203
222
  : localId && ctx.catalogPath
204
223
  ? findDeliverableInfo(ctx.catalogPath, localId)
205
224
  : null;
206
- // The stem links a plan to its result (both share `<stem>-{plan,result}.md` and the doc id).
207
- // Defaults to the task id (fixed-name worktree/claim flow); in-place callers pass a unique stem.
208
- const stem = override?.stem ?? task.id;
209
- const resultRef = `${repoRelativePath(ctx.executionPath)}/exec/results/${stem}-result.md`;
210
- const outPath = override?.outPath ?? join(ctx.plansDir, `${stem}-plan.md`);
225
+ // Keep the existing document-id convention, with a unique stem for each retained run.
226
+ const stem = override?.stem ?? buildInPlaceStem(task.id);
227
+ const records = taskRecordPaths(ctx.executionPath, task.id, stem, override?.origin ?? "schedule");
228
+ const outPath = override?.outPath ?? records.plan;
229
+ mkdirSync(dirname(outPath), { recursive: true });
230
+ const resultRef = repoRelativePath(isRunRecordPath(outPath) ? resultForPlan(outPath) : records.result);
211
231
  const criteria = deliverable?.deliverable.done_criteria ?? [];
212
232
  if ((task.execution ?? "agent") === "human") {
213
233
  throw new Error(`Task ${task.id} has execution: human; claim it to create and use its result instead of a plan.`);
@@ -218,14 +238,22 @@ async function writeTaskPlan(ctx, task, override) {
218
238
  implementationEvidence(deliverable) === MISSING) {
219
239
  throw new Error(`Task ${task.id} uses approach: retrofit but the target deliverable has no evidence_refs.`);
220
240
  }
241
+ if (task.approach === "condense" &&
242
+ (mode !== "edit" ||
243
+ !deliverable?.resolvedPath ||
244
+ !existsSync(resolve(specdojoRootDir(), deliverable.resolvedPath)) ||
245
+ (override?.targets ??
246
+ targetDocIdsForTask(ctx.projectId, task, deliverable, crossDeliverables)).length !== 1)) {
247
+ throw new Error(`Task ${task.id} uses condense; exactly one existing deliverable and edit mode are required`);
248
+ }
221
249
  const template = loadPlanTemplate(mode, task.approach, ctx.templateCache);
222
250
  const body = mode === "review"
223
251
  ? buildReviewPlanMarkdown(template, planTask, deliverable, criteria, ctx.vpMap, ctx.projectId, ctx.catalogPath, ctx.projectContext, resultRef, stem, ctx.reviewGradeOutcome)
224
252
  : buildEditPlanMarkdown(template, planTask, deliverable, ctx.roleMap, ctx.vpMap, ctx.projectId, ctx.catalogPath, ctx.projectContext, resultRef, stem, crossDeliverables, override);
225
253
  const schemaRef = resolveDeliverableSchemaRef(deliverable?.resolvedPath);
226
- const content = `${injectCommonConventions(body, schemaRef, ctx.templateCache, mode).replace(/[\r\n]+$/u, "")}\n`;
254
+ const content = `${injectCommonConventions(body, schemaRef, ctx.templateCache, mode, { executionPath: ctx.executionPath, planPath: outPath }).replace(/[\r\n]+$/u, "")}\n`;
227
255
  if (task.schedule_file && override?.origin !== "register") {
228
- await assertPlanMarkdownlint(specdojoRootDir(), task.id, outPath, content);
256
+ await assertPlanMarkdownlint(specdojoRootDir(), task.id, outPath, expandPlanConventions(content, dirname(outPath)));
229
257
  }
230
258
  writeFileSync(outPath, content, "utf8");
231
259
  await formatMarkdownFile(outPath);
@@ -300,10 +328,7 @@ export async function generateRegisterApproachPlan(opts) {
300
328
  });
301
329
  }
302
330
  function newPlanGenContext(opts) {
303
- const plansDir = join(opts.executionPath, "exec", "plans");
304
- mkdirSync(plansDir, { recursive: true });
305
331
  return {
306
- plansDir,
307
332
  executionPath: opts.executionPath,
308
333
  projectId: opts.projectId,
309
334
  catalogPath: opts.catalogPath,
@@ -318,6 +343,3 @@ function newPlanGenContext(opts) {
318
343
  templateCache: new Map(),
319
344
  };
320
345
  }
321
- // Move a completed plan to exec/plans/done/ with a unique UTC + random suffix
322
- // (same convention as event filenames), or delete it. The plan is regenerable
323
- // from the catalog, so deletion is safe; the result remains as the record.
@@ -1,6 +1,7 @@
1
1
  import { gradeFindingDisplayMessage } from "../shared/grade-result.js";
2
+ import { findingCause } from "../shared/finding-cause.js";
2
3
  // 引用した文書や finding 本文の Markdown を、plan 自身のリンクとして解釈させない。
3
- function inlineCode(value) {
4
+ export function inlineCode(value) {
4
5
  const text = value.replace(/\r\n?|\n/g, " ").trim();
5
6
  const longestRun = Math.max(0, ...(text.match(/`+/g) ?? []).map((run) => run.length));
6
7
  const delimiter = "`".repeat(longestRun + 1);
@@ -8,9 +9,13 @@ function inlineCode(value) {
8
9
  const padding = /^`|`$/.test(text) ? " " : "";
9
10
  return `${delimiter}${padding}${text}${padding}${delimiter}`;
10
11
  }
11
- export function planGradeFindingText(finding) {
12
+ export function planGradeFindingText(finding, includeCause = false) {
12
13
  const anchor = inlineCode(JSON.stringify(finding.anchor));
13
14
  const message = inlineCode(gradeFindingDisplayMessage(finding));
14
15
  // register の箇条書き先頭でも [判定情報]: 本文 が参照リンク定義にならないようにする。
15
- return `\\[${finding.severity}/${finding.rule}; line=${finding.line}; anchor=${anchor}\\]: ${message}`;
16
+ const cause = findingCause(finding);
17
+ const causeText = includeCause
18
+ ? `; cause=${cause.type === "kata" ? `kata:${cause.kind}; location=${inlineCode(cause.location)}` : "document"}`
19
+ : "";
20
+ return `\\[${finding.severity}/${finding.rule}; line=${finding.line}; anchor=${anchor}${causeText}\\]: ${message}`;
16
21
  }
@@ -0,0 +1,61 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { resolve } from "node:path";
3
+ import { resolveKataRefs } from "../kata/kata.js";
4
+ import { isGeneratedGradeTarget, isTrashedGradeTarget, resolveSafeMarkdownPath, } from "../grade/targets.js";
5
+ import { listFilesRecursive } from "../shared/fs.js";
6
+ import { gradeContentHash, gradeResultPathForDocument, readGradeResult, resolveGradeResultsDirectory, } from "../shared/grade-result.js";
7
+ import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
8
+ import { specdojoRootDir } from "../shared/specdojo-config.js";
9
+ import { MISSING } from "../shared/plan-templates.js";
10
+ import { inlineCode, planGradeFindingText } from "./plans-grade-findings.js";
11
+ import { condenseKataFindingsText } from "./plans-condense-findings.js";
12
+ /** Pull current deliverable findings into maintenance of the declared Kata. */
13
+ export function kataCauseFindingsText(projectId, kind, kataPath) {
14
+ if (!kataPath || kataPath === MISSING)
15
+ return "- なし";
16
+ const root = specdojoRootDir();
17
+ const lines = condenseKataFindingsText(projectId, kind, kataPath);
18
+ let sidecars;
19
+ try {
20
+ sidecars = listFilesRecursive(resolveGradeResultsDirectory(projectId)).sort();
21
+ }
22
+ catch {
23
+ sidecars = [];
24
+ }
25
+ for (const sidecar of sidecars) {
26
+ if (!/\.ya?ml$/.test(sidecar))
27
+ continue;
28
+ try {
29
+ const result = readGradeResult(sidecar);
30
+ if (!result || result.target !== "deliverable")
31
+ continue;
32
+ const path = resolveSafeMarkdownPath(result.path, root, projectId);
33
+ if (isGeneratedGradeTarget(path, root) || isTrashedGradeTarget(path, root))
34
+ continue;
35
+ const content = readFileSync(path, "utf8");
36
+ if (gradeContentHash(content) !== result.content_hash)
37
+ continue;
38
+ // Historical copies and moved documents must not resurrect superseded findings.
39
+ if (resolve(gradeResultPathForDocument({ documentPath: path, project: projectId })) !==
40
+ resolve(sidecar))
41
+ continue;
42
+ const metadata = readSpecdojoNamespace(content);
43
+ if (metadata.id !== result.document)
44
+ continue;
45
+ const rulebook = typeof metadata?.rulebook === "string" ? metadata.rulebook : undefined;
46
+ const refs = resolveKataRefs(rulebook);
47
+ if (refs[kind] === MISSING || resolve(root, refs[kind]) !== resolve(root, kataPath))
48
+ continue;
49
+ for (const finding of result.findings) {
50
+ if (finding.cause?.type !== "kata" || finding.cause.kind !== kind)
51
+ continue;
52
+ lines.push(`- source=grade; ${inlineCode(result.document)} (${inlineCode(result.path)}) ${inlineCode(finding.id)} ${planGradeFindingText(finding, true)}`);
53
+ }
54
+ }
55
+ catch {
56
+ // Missing, unreadable, or invalid source results are not evidence for a Kata edit.
57
+ continue;
58
+ }
59
+ }
60
+ return lines.join("\n") || "- なし";
61
+ }
@@ -5,7 +5,7 @@ import { loadTemplatesForDomain, resolvePlanPath } from "../catalog/plan.js";
5
5
  import { resolveSpecdojoPath } from "../docs/template-resolution.js";
6
6
  import { resolveKataRefs } from "../kata/kata.js";
7
7
  import { planningTarget } from "../register/planning.js";
8
- import { getProjectSchedulePath, getProjectTimelinePath, } from "../shared/specdojo-config.js";
8
+ import { getProjectSchedulePath, getProjectRegisterPath, } from "../shared/specdojo-config.js";
9
9
  export function planningPlanFields(opts) {
10
10
  const unit = planningTarget(opts.approach, opts.target);
11
11
  const path = (file) => relative(opts.repoRoot, file).replaceAll("\\", "/");
@@ -33,11 +33,11 @@ export function planningPlanFields(opts) {
33
33
  if (templates.length === 0)
34
34
  throw new Error(`No catalog template found for domain '${unit}'`);
35
35
  const plan = path(resolvePlanPath(opts.catalogPath, unit));
36
- common.push("### 判定・生成手順と完了条件", "", ...templates.map((template) => `- domain の雛形: \`${template.template.id}\`(\`${template.relPath}\`)`), "", `1. \`specdojo catalog plan prompt ${projectArg} --domain ${unit}\` を実行し、その入力文書・判定規約に従う。データフローがない場合は、個票が指定する上流資料を \`--input <path>\` で明示する。入力不足なら停止して必要資料を申し送る。`, "2. agent の判定を YAML に出力する。インスタンス・根拠・除外・未確定事項を記録する。既存カタログと kata を優先して参照し、テンプレート由来の構造を独自に再作成しない。", `3. \`specdojo catalog plan scaffold ${projectArg} --domain ${unit} --from <agent-output>.yaml\` で \`${plan}\` に検証保存する。prompt に入力を追加した場合は同じ \`--input\` を渡す。`, `4. \`specdojo catalog plan validate ${projectArg} --domain ${unit}\` を通す。blocking な \`open_questions\` を解消する。`, `5. \`specdojo catalog scaffold ${projectArg} --domain ${unit} --plan\` で \`dct-${unit}.yaml\`(物理分割時は全 part)を生成する。\`dct-index.yaml\` の \`size\` がない場合は個票の範囲に合わせて \`--size <small|medium|large>\` を明示する。既存ファイルは差分を確認し、必要な場合だけ \`--force\` を使う。`, `6. \`specdojo catalog validate ${projectArg}\` を通す。先に \`dct-index.yaml\` の全 domain の索引を整備し、生成した domain を登録する(物理分割も同じ domain の一項目とする)。判定計画とカタログの保存、参照・依存・完了条件の整合を完了基準とする。`, "7. 個票の作業内容・対応結果と実行記録に判断・検証結果を記録する。todo の close は runner と人が行う。close 後の `timeline build` が domain を `primary` と導く。`tml-index.yaml` は変更しない。");
36
+ common.push("### 判定・生成手順と完了条件", "", ...templates.map((template) => `- domain の雛形: \`${template.template.id}\`(\`${template.relPath}\`)`), "", `1. \`specdojo catalog plan prompt ${projectArg} --domain ${unit}\` を実行し、その入力文書・判定規約に従う。データフローがない場合は、個票が指定する上流資料を \`--input <path>\` で明示する。入力不足なら停止して必要資料を申し送る。`, "2. agent の判定を YAML に出力する。インスタンス・根拠・除外・未確定事項を記録する。既存カタログと kata を優先して参照し、テンプレート由来の構造を独自に再作成しない。", `3. \`specdojo catalog plan scaffold ${projectArg} --domain ${unit} --from <agent-output>.yaml\` で \`${plan}\` に検証保存する。prompt に入力を追加した場合は同じ \`--input\` を渡す。`, `4. \`specdojo catalog plan validate ${projectArg} --domain ${unit}\` を通す。blocking な \`open_questions\` を解消する。`, `5. \`specdojo catalog scaffold ${projectArg} --domain ${unit} --plan\` で \`dct-${unit}.yaml\`(物理分割時は全 part)を生成する。\`dct-index.yaml\` の \`size\` がない場合は個票の範囲に合わせて \`--size <small|medium|large>\` を明示する。既存ファイルは差分を確認し、必要な場合だけ \`--force\` を使う。`, `6. \`specdojo catalog validate ${projectArg}\` を通す。先に \`dct-index.yaml\` の全 domain の索引を整備し、生成した domain を登録する(物理分割も同じ domain の一項目とする)。判定計画とカタログの保存、参照・依存・完了条件の整合を完了基準とする。`, "7. `evidence_refs` がある成果物は参照先を読み、状態遷移・判定・検証の本体を含むファイルが参照にあるか確認する。re-export だけのファイルを根拠にせず、転送先をたどって本体を特定する。不足する本体の参照を補い、`catalog validate` を再実行する。確認した本体のパス・判断根拠・未確認範囲を記録する。", "8. 個票の作業内容・対応結果と実行記録に判断・検証結果を記録する。todo の close は runner と人が行う。close 後の `dashboard build` がカタログの状態を導出する。`tml-index.yaml` は変更しない。");
37
37
  }
38
38
  else {
39
39
  const strategy = join(getProjectSchedulePath(opts.project), `sch-strategy-${unit}.yaml`).replaceAll("\\", "/");
40
- common.push("### scope・intent の宣言と完了条件", "", `1. \`${join(getProjectTimelinePath(opts.project), "tml-index.yaml").replaceAll("\\", "/")}\` があれば対象 track の domains と依存・着手順を確認する。\`timeline build\` の register 由来の状態と既存カタログも確認する。`, `2. \`${strategy}\` に \`scope.catalogs\`(ID・リポジトリルートからのパス)、\`scope.include_kinds\` と \`approach_rules\` を宣言する。既存 scope の意図を保ち、各成果物の \`local_ids\` と \`intent\`(例: author-deliverable / bootstrap-kata-set / confirm-deliverable)、必要時の \`kata_target\` / \`bootstrap_scope\` を根拠付きで決める。`, "3. 主担当を `owner_rules` または生成時の `--owner` / `--default-owner` で明示する。`done_criteria.roles` を主担当と解釈しない。必要な kata の grade が不足なら先に評価し、不明な判断を推測で補わない。", " 人の文脈記入から始める場合は `intent: draft-with-context` を選ぶ。必要な kata がすべて利用可能なら `draft` profile(context → draft → refine → review → finalize)になる。context と finalize は human、他は agent とし、refine は `fully-guided` で磨き込む。", ` context の担当者は \`specdojo exec claim ${projectArg} --task <context-task-id> --by <human>\` で着手し、\`specdojo deliverable scaffold ${projectArg} --target <doc-id>\` で雛形を作る。既存成果物は上書きしない。本文の \`_CONTEXT_:\` に固定前提・制約・調査や選定を任せる範囲を書く(例: \`_CONTEXT_: 既存 API を維持し、認証方式の候補を調べて提案してほしい。\`)。result に記入内容を残して \`specdojo exec complete ${projectArg} --task <context-task-id> --by <human>\` で draft へ渡す。human 用の plan は生成しない。`, `4. \`specdojo schedule strategy generate ${projectArg} --track ${unit}\` を実行し、scope・intent・担当・依存関係に関するエラーを解消する。既存 strategy の変更は差分を確認し、必要な場合だけ \`--force\` を指定する。`, `5. \`specdojo schedule build ${projectArg} --track ${unit}\` を通し、\`sch-track-${unit}.yaml\` が生成され、scope の成果物とタスクの対応・依存が一致することを確認する。`, "6. strategy と track の保存、scope 全件の intent と担当の解決、生成・検証の成功を完了基準とし、個票の作業内容・対応結果と実行記録へ判断と検証を記録する。カタログ本体と `tml-index.yaml` は変更しない。");
40
+ common.push("### scope・intent の宣言と完了条件", "", `1. \`${getProjectRegisterPath(opts.project) ?? "controls/project-register"}\` の対象 track を担う epic の domains と depends_on を確認する。範囲は既存 strategy の scope、epic の domains、互換用 tml-index.yaml の順で解決する。\`dashboard build\` のカタログ検出と既存カタログも確認する。`, `2. \`${strategy}\` に \`scope.catalogs\`(ID・リポジトリルートからのパス)、\`scope.include_kinds\` と \`approach_rules\` を宣言する。既存 scope の意図を保ち、各成果物の \`local_ids\` と \`intent\`(例: author-deliverable / bootstrap-kata-set / confirm-deliverable)、必要時の \`kata_target\` / \`bootstrap_scope\` を根拠付きで決める。`, "3. 主担当を `owner_rules` または生成時の `--owner` / `--default-owner` で明示する。`done_criteria.roles` を主担当と解釈しない。必要な kata の grade が不足なら先に評価し、不明な判断を推測で補わない。", " 人の文脈記入から始める場合は `intent: draft-with-context` を選ぶ。必要な kata がすべて利用可能なら `draft` profile(context → draft → refine → condense → review → finalize)になる。context と finalize は human、他は agent とし、refine は `fully-guided` で磨き込む。", ` context の担当者は \`specdojo exec claim ${projectArg} --task <context-task-id> --by <human>\` で着手し、\`specdojo deliverable scaffold ${projectArg} --target <doc-id>\` で雛形を作る。既存成果物は上書きしない。本文の \`_CONTEXT_:\` に固定前提・制約・調査や選定を任せる範囲を書く(例: \`_CONTEXT_: 既存 API を維持し、認証方式の候補を調べて提案してほしい。\`)。result に記入内容を残して \`specdojo exec complete ${projectArg} --task <context-task-id> --by <human>\` で draft へ渡す。human 用の plan は生成しない。`, `4. \`specdojo schedule strategy generate ${projectArg} --track ${unit}\` を実行し、scope・intent・担当・依存関係に関するエラーを解消する。既存 strategy の変更は差分を確認し、必要な場合だけ \`--force\` を指定する。`, `5. \`specdojo schedule build ${projectArg} --track ${unit}\` を通し、\`sch-track-${unit}.yaml\` が生成され、scope の成果物とタスクの対応・依存が一致することを確認する。`, "6. strategy と track の保存、scope 全件の intent と担当の解決、生成・検証の成功を完了基準とし、個票の作業内容・対応結果と実行記録へ判断と検証を記録する。カタログ本体と `tml-index.yaml` は変更しない。");
41
41
  }
42
42
  return { refs, conditions: common.join("\n") };
43
43
  }
@@ -1,47 +1,35 @@
1
- import { existsSync, mkdirSync, readFileSync, renameSync, rmSync } from "node:fs";
1
+ import { existsSync, readFileSync, rmSync } from "node:fs";
2
2
  import { join, relative } from "node:path";
3
- import { specdojoRootDir } from "../shared/specdojo-config.js";
4
- import { nowUtcIsoSeconds, randomHex, tsForFilenameUtc } from "./shared.js";
3
+ import { lookupDocIndex } from "../docs/doc-index.js";
5
4
  import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
6
5
  import { gradeResultPathForDocument, readGradeResultForDocument } from "../shared/grade-result.js";
7
- import { lookupDocIndex } from "../docs/doc-index.js";
6
+ import { specdojoRootDir } from "../shared/specdojo-config.js";
7
+ import { readPlanFile } from "../shared/plan-conventions.js";
8
8
  import { planGradeFindingText } from "./plans-grade-findings.js";
9
- export function archivePlan(opts, dependencies = {}) {
10
- const plansDir = join(opts.executionPath, "exec", "plans");
11
- const from = join(plansDir, `${opts.slug}-plan.md`);
9
+ import { recordPathForRead } from "./run-records.js";
10
+ export function archivePlan(opts) {
11
+ const from = recordPathForRead(opts.executionPath, "plan", opts.slug);
12
12
  if (!existsSync(from))
13
13
  throw new Error(`plan not found: ${from}`);
14
14
  if (opts.delete) {
15
15
  rmSync(from, { force: true });
16
16
  return { from, deleted: true };
17
17
  }
18
- const doneDir = join(plansDir, "done");
19
- mkdirSync(doneDir, { recursive: true });
20
- const now = dependencies.now ?? nowUtcIsoSeconds;
21
- const makeRandomHex = dependencies.randomHex ?? randomHex;
22
- const stamp = tsForFilenameUtc(now());
23
- const base = `${opts.slug}-${stamp}-${makeRandomHex(4)}`;
24
- let sequence = 0;
25
- let to = join(doneDir, `${base}-plan.md`);
26
- while (existsSync(to)) {
27
- sequence += 1;
28
- to = join(doneDir, `${base}-${sequence}-plan.md`);
29
- }
30
- renameSync(from, to);
31
- return { from, to, deleted: false };
18
+ return { from, to: from, deleted: false };
32
19
  }
33
20
  export function planPathForTask(executionPath, taskId) {
34
- return join(executionPath, "exec", "plans", `${taskId}-plan.md`);
21
+ return recordPathForRead(executionPath, "plan", taskId);
35
22
  }
36
23
  export function loadPlan(executionPath, taskId) {
37
24
  const planPath = planPathForTask(executionPath, taskId);
38
25
  if (existsSync(planPath))
39
- return readFileSync(planPath, "utf8");
26
+ return readPlanFile(planPath);
40
27
  return null;
41
28
  }
42
29
  const PLAN_APPROACHES = [
43
30
  "draft",
44
31
  "fully-guided",
32
+ "condense",
45
33
  "recipe-guided",
46
34
  "freeform",
47
35
  "bootstrap",
@@ -79,7 +67,7 @@ export function parsePlanTaskIdentity(planContent) {
79
67
  ? parsed.targets.filter((entry) => typeof entry === "string")
80
68
  : [];
81
69
  // 未知の値は採用せず undefined(= schedule)として扱う。
82
- const origin = parsed.origin === "register" || parsed.origin === "schedule"
70
+ const origin = parsed.origin === "register" || parsed.origin === "schedule" || parsed.origin === "job"
83
71
  ? parsed.origin
84
72
  : undefined;
85
73
  return {