specdojo 0.6.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (366) hide show
  1. package/.github/agents/specdojo-orchestrator.md +3 -2
  2. package/CHANGELOG.md +193 -0
  3. package/README.md +2 -2
  4. package/dist/catalog/build.js +24 -1
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +33 -0
  8. package/dist/commands/init.js +6 -1
  9. package/dist/commands/night-orchestrator.js +6 -4
  10. package/dist/commands/orchestrator.js +10 -1
  11. package/dist/dashboard/dashboard-timeline.js +18 -16
  12. package/dist/dashboard/dashboard.js +612 -259
  13. package/dist/dashboard/epic-plan.js +81 -0
  14. package/dist/dashboard/exec-records.js +16 -20
  15. package/dist/dashboard/routines.js +8 -6
  16. package/dist/dashboard/timeline-build.js +5 -9
  17. package/dist/dashboard/timeline.js +9 -4
  18. package/dist/devcontainer/command.js +18 -0
  19. package/dist/devcontainer/host-script.js +21 -0
  20. package/dist/devcontainer/scaffold.js +22 -3
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/yaml-pages.js +125 -3
  23. package/dist/exec/agent-config.js +22 -0
  24. package/dist/exec/agent-plan.js +3 -2
  25. package/dist/exec/antigravity-session.js +154 -0
  26. package/dist/exec/commands.js +69 -21
  27. package/dist/exec/commit-hook-skips.js +78 -0
  28. package/dist/exec/core.js +19 -7
  29. package/dist/exec/events.js +159 -8
  30. package/dist/exec/evidence.js +64 -16
  31. package/dist/exec/handoff.js +9 -13
  32. package/dist/exec/limit.js +1 -1
  33. package/dist/exec/mechanical-result.js +45 -0
  34. package/dist/exec/migrate-records.js +249 -0
  35. package/dist/exec/parent-validation.js +160 -12
  36. package/dist/exec/pipeline-state.js +27 -5
  37. package/dist/exec/plan-markdownlint.js +89 -0
  38. package/dist/exec/plans-condense-findings.js +89 -0
  39. package/dist/exec/plans-core.js +24 -17
  40. package/dist/exec/plans-generation.js +52 -25
  41. package/dist/exec/plans-grade-findings.js +8 -3
  42. package/dist/exec/plans-kata-findings.js +61 -0
  43. package/dist/exec/plans-planning.js +3 -3
  44. package/dist/exec/plans-storage.js +12 -24
  45. package/dist/exec/register-resume.js +69 -42
  46. package/dist/exec/register.js +26 -22
  47. package/dist/exec/repo-integration-sync.js +8 -4
  48. package/dist/exec/repo-integration.js +21 -1
  49. package/dist/exec/reporter.js +121 -23
  50. package/dist/exec/results.js +85 -24
  51. package/dist/exec/review-completion.js +47 -0
  52. package/dist/exec/review-kata.js +109 -0
  53. package/dist/exec/run/agent-pipeline.js +75 -6
  54. package/dist/exec/run/agent.js +20 -7
  55. package/dist/exec/run/in-place.js +69 -32
  56. package/dist/exec/run/job.js +81 -24
  57. package/dist/exec/run/lifecycle-commands.js +264 -43
  58. package/dist/exec/run/mode-shared.js +11 -3
  59. package/dist/exec/run/register-command.js +12 -10
  60. package/dist/exec/run/register-core.js +20 -13
  61. package/dist/exec/run/register-mode.js +12 -12
  62. package/dist/exec/run/register-post-review.js +21 -9
  63. package/dist/exec/run/register-resume.js +28 -18
  64. package/dist/exec/run/register-state.js +10 -7
  65. package/dist/exec/run/register-worktree.js +60 -30
  66. package/dist/exec/run/schedule-mode.js +26 -6
  67. package/dist/exec/run/schedule-prepare.js +228 -45
  68. package/dist/exec/run/schedule-task.js +132 -25
  69. package/dist/exec/run/shared.js +4 -3
  70. package/dist/exec/run/trailing-records.js +35 -0
  71. package/dist/exec/run-records.js +2 -0
  72. package/dist/exec/strategy.js +1 -0
  73. package/dist/exec/trailing-records.js +242 -0
  74. package/dist/exec/trial-commands.js +3 -2
  75. package/dist/exec/validate-records-commit.js +110 -0
  76. package/dist/exec/validate-records.js +148 -0
  77. package/dist/exec/worktree-command.js +29 -16
  78. package/dist/exec/worktree-ops-commit.js +118 -59
  79. package/dist/exec/worktree-ops-lifecycle.js +77 -44
  80. package/dist/exec/worktree-ops-merge.js +13 -2
  81. package/dist/exec/worktree-ops.js +2 -2
  82. package/dist/exec/worktree.js +19 -2
  83. package/dist/grade/apply.js +32 -6
  84. package/dist/grade/command-inspect.js +2 -2
  85. package/dist/grade/command-run.js +2 -0
  86. package/dist/grade/command-shared.js +1 -1
  87. package/dist/grade/core.js +18 -5
  88. package/dist/grade/markdown.js +3 -3
  89. package/dist/grade/pipeline-state.js +15 -11
  90. package/dist/grade/plan.js +37 -17
  91. package/dist/grade/result.js +3 -3
  92. package/dist/grade/run.js +23 -3
  93. package/dist/grade/target-discovery.js +17 -4
  94. package/dist/grade/targets.js +12 -11
  95. package/dist/job/job.js +31 -17
  96. package/dist/job/noop.js +104 -0
  97. package/dist/register/core.js +2 -0
  98. package/dist/register/create-commands.js +28 -3
  99. package/dist/register/deliverable-target.js +9 -1
  100. package/dist/register/epic.js +104 -26
  101. package/dist/register/event-merge.js +3 -0
  102. package/dist/register/events.js +4 -0
  103. package/dist/register/external-project.js +3 -0
  104. package/dist/register/item.js +6 -0
  105. package/dist/register/maintenance-commands.js +4 -1
  106. package/dist/register/planning.js +7 -14
  107. package/dist/register/register.js +74 -32
  108. package/dist/register/track-domains.js +34 -0
  109. package/dist/register/track-plan.js +78 -0
  110. package/dist/register/transition-commands.js +8 -0
  111. package/dist/register/work-table.js +64 -0
  112. package/dist/review/grade.js +35 -13
  113. package/dist/routine/definition.js +4 -3
  114. package/dist/routine/failure.js +30 -0
  115. package/dist/routine/routine.js +56 -32
  116. package/dist/routine/storage.js +33 -0
  117. package/dist/schedule/schedule.js +1 -0
  118. package/dist/schedule/strategy-generate-document.js +26 -14
  119. package/dist/schedule/strategy-generate-scope.js +17 -45
  120. package/dist/schedule/strategy-generate.js +33 -3
  121. package/dist/schedule/strategy-profiles.js +86 -12
  122. package/dist/shared/agent-types.js +2 -0
  123. package/dist/shared/condense-records.js +25 -0
  124. package/dist/shared/deprecation.js +8 -0
  125. package/dist/shared/document-metadata.js +20 -0
  126. package/dist/shared/finding-cause.js +20 -0
  127. package/dist/shared/frontmatter-namespace.js +48 -0
  128. package/dist/shared/git.js +149 -15
  129. package/dist/shared/grade-result.js +17 -1
  130. package/dist/shared/local-state.js +20 -0
  131. package/dist/shared/markdownlint-config.js +8 -3
  132. package/dist/shared/plan-conventions.js +129 -0
  133. package/dist/shared/plan-templates.js +57 -41
  134. package/dist/shared/provider-scaffold.js +2 -0
  135. package/dist/shared/run-records.js +224 -0
  136. package/dist/shared/specdojo-config.js +39 -21
  137. package/dist/shared/specdojo-gitignore.js +1 -0
  138. package/dist/shared/text.js +65 -5
  139. package/dist/shared/timeline-index.js +2 -0
  140. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  141. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  142. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  143. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  144. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  145. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  146. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  147. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  148. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  149. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  150. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  151. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  152. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  153. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  154. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  155. package/docs/ja/specdojo/guides/docs-editing-guide.md +48 -0
  156. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  157. package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
  158. package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
  159. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  160. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  161. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  162. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  163. package/docs/ja/specdojo/guides/quick-start-guide.md +589 -807
  164. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
  165. package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
  166. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  167. package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
  168. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  169. package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
  170. package/docs/ja/specdojo/guides/schedule-operation-guide.md +41 -3
  171. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  172. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  173. package/docs/ja/specdojo/guides/use-case-guide.md +471 -74
  174. package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
  175. package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
  176. package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
  177. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  178. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
  179. package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
  180. package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
  181. package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
  182. package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
  183. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
  184. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
  185. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
  186. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
  187. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
  188. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
  189. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
  190. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
  191. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
  192. package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
  193. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
  194. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
  195. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
  196. package/docs/ja/specdojo/references/command-reference.md +146 -99
  197. package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
  198. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  199. package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
  200. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
  201. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
  202. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
  203. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
  204. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
  205. package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
  206. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
  207. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  208. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  209. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  210. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  211. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
  212. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
  213. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
  214. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  215. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
  216. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
  217. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
  218. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
  219. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
  220. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
  221. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
  222. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
  223. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
  224. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
  225. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
  226. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
  227. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
  228. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
  229. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
  230. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
  231. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
  232. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
  233. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
  234. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
  235. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
  236. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
  237. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
  238. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
  239. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
  240. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
  241. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
  242. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
  243. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
  244. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
  245. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
  246. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
  247. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
  248. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
  249. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
  250. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
  251. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
  252. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
  253. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
  254. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  255. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
  256. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
  257. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
  258. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  259. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  260. package/docs/ja/specdojo/samples/bds-sample.md +100 -21
  261. package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
  262. package/docs/ja/specdojo/samples/bes-sample.md +80 -21
  263. package/docs/ja/specdojo/samples/br-sample.md +68 -14
  264. package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
  265. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  266. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  267. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
  268. package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
  269. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  270. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  271. package/docs/ja/specdojo/samples/clis-sample.md +132 -0
  272. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  273. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  274. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  275. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  276. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  277. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  278. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  279. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  280. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  281. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  282. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  283. package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
  284. package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
  285. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
  286. package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
  287. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  288. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
  289. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
  290. package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
  291. package/docs/ja/specdojo/samples/sf-sample.md +121 -21
  292. package/docs/ja/specdojo/samples/sld-sample.md +107 -21
  293. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  294. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  295. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  296. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  297. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  298. package/docs/ja/specdojo/samples/uis-sample.md +164 -20
  299. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  300. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  301. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  302. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  303. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  304. package/docs/ja/specdojo/templates/br-template.md +64 -0
  305. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  306. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  307. package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
  308. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  309. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  310. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  311. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  312. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  313. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  314. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  315. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  316. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  317. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  318. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  319. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  320. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  321. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  322. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  323. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  324. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  325. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  326. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  327. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  328. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  329. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  330. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  331. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  332. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  333. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  334. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  335. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  336. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
  337. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +54 -3
  338. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
  339. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  340. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  341. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  342. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  343. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  344. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  345. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  346. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  347. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  348. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
  349. package/package.json +6 -3
  350. package/templates/antigravity/README.md +19 -46
  351. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  352. package/templates/antigravity/orchestrator.md +3 -2
  353. package/templates/antigravity/settings.edit.json +73 -0
  354. package/templates/antigravity/settings.orchestrator.json +15 -0
  355. package/templates/antigravity/settings.report.json +7 -0
  356. package/templates/antigravity/settings.review.json +7 -0
  357. package/templates/claude/agents/specdojo-orchestrator.md +3 -2
  358. package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
  359. package/templates/codex/orchestrator.md +3 -2
  360. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  361. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
  362. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  363. package/templates/devcontainer/tmux.conf +6 -0
  364. package/templates/init-agent-members.yaml +1 -0
  365. package/templates/init-exec-defaults.yaml +1 -1
  366. package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
@@ -0,0 +1,249 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
3
+ import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
4
+ import { readSpecdojoNamespace } from "../shared/frontmatter-namespace.js";
5
+ import { listFilesRecursive } from "../shared/fs.js";
6
+ import { gitEnvironment } from "../shared/git.js";
7
+ import { rebasePlanConventions } from "../shared/plan-conventions.js";
8
+ import { recordIdentity, taskRecordPaths } from "../shared/run-records.js";
9
+ import { specdojoRootDir } from "../shared/specdojo-config.js";
10
+ import { addProjectOptions, resolveProjectContext, resolveProjectId } from "./core.js";
11
+ import { qualifyTaskId } from "./shared.js";
12
+ import { listRegisteredWorktrees, worktreeNameFromTaskId } from "./worktree.js";
13
+ const posix = (path) => path.split(sep).join("/");
14
+ const json = (path) => JSON.parse(readFileSync(path, "utf8"));
15
+ /** Retain formatting and every non-reference value, including historical change paths. */
16
+ function rewriteJsonPaths(source, rewrite) {
17
+ JSON.parse(source);
18
+ const stack = [];
19
+ return source.replace(/"(?:[^"\\]|\\.)*"|[{}[\]]/g, (token, offset) => {
20
+ const parent = stack.at(-1);
21
+ if (token === "{" || token === "[") {
22
+ stack.push({ field: parent?.key ?? "", key: "" });
23
+ }
24
+ else if (token === "}" || token === "]") {
25
+ stack.pop();
26
+ }
27
+ else if (/^\s*:/.test(source.slice(offset + token.length))) {
28
+ if (parent)
29
+ parent.key = JSON.parse(token);
30
+ }
31
+ else if (parent &&
32
+ (/(?:_ref|_path)$/.test(parent.key) ||
33
+ (parent.key === "path" && stack.some((frame) => frame.field === "log_refs")))) {
34
+ return JSON.stringify(rewrite(JSON.parse(token)));
35
+ }
36
+ return token;
37
+ });
38
+ }
39
+ /** Plan first, validate every destination, then mutate. No clock or random identity is used. */
40
+ export function planRecordMigration(repoRoot, executionPath, projectId) {
41
+ const root = resolve(repoRoot);
42
+ const execution = resolve(executionPath);
43
+ const repoRef = (path) => posix(relative(root, path));
44
+ const pairs = new Map();
45
+ for (const kind of ["plan", "result"]) {
46
+ for (const path of listFilesRecursive(join(execution, "exec", `${kind}s`)).sort()) {
47
+ if (!path.endsWith(`-${kind}.md`))
48
+ throw new Error(`Unknown legacy record: ${path}`);
49
+ const stem = basename(path).replace(new RegExp(`-${kind}\\.md$`), "");
50
+ const fm = readSpecdojoNamespace(readFileSync(path, "utf8"));
51
+ if (typeof fm.task_id !== "string" || !fm.task_id.trim())
52
+ throw new Error(`Missing task_id: ${path}`);
53
+ const pair = pairs.get(stem) ?? { stem, task: fm.task_id };
54
+ if (pair[kind] || pair.task !== fm.task_id)
55
+ throw new Error(`Ambiguous pair: ${stem}`);
56
+ pair[kind] = path;
57
+ pairs.set(stem, pair);
58
+ }
59
+ }
60
+ const evidenceRoot = join(execution, "exec", "evidence");
61
+ const directories = new Map();
62
+ for (const path of listFilesRecursive(evidenceRoot).sort()) {
63
+ const directory = dirname(path);
64
+ directories.set(directory, [...(directories.get(directory) ?? []), path]);
65
+ }
66
+ const groups = [];
67
+ for (const [directory, files] of directories) {
68
+ const parts = relative(evidenceRoot, directory).split(sep);
69
+ if (parts.length !== 2)
70
+ throw new Error(`Unknown evidence directory: ${directory}`);
71
+ const metadata = ["pipeline-state.json", "evidence.json"]
72
+ .map((name) => join(directory, name))
73
+ .filter(existsSync)
74
+ .map(json);
75
+ const state = metadata.find((record) => record.artifacts);
76
+ const artifacts = state?.artifacts;
77
+ const task = metadata[0]?.task_id ?? parts[0];
78
+ const run = metadata[0]?.run_id ?? parts[1];
79
+ if (typeof task !== "string" || typeof run !== "string")
80
+ throw new Error(`Invalid evidence identity: ${directory}`);
81
+ if (metadata.some((record) => record.task_id !== task || record.run_id !== run))
82
+ throw new Error(`Conflicting evidence identities: ${directory}`);
83
+ groups.push({
84
+ task,
85
+ run,
86
+ files,
87
+ refs: Object.values(artifacts ?? {}).filter((value) => typeof value === "string"),
88
+ updated: String(metadata[0]?.updated_at ?? run),
89
+ });
90
+ }
91
+ // A retained exec worktree may still resume with the old paths and its own index.
92
+ // Refuse even dry-runs before planning updates; stopped processes alone are insufficient.
93
+ const tasks = new Set([...pairs.values(), ...groups].map(({ task }) => task));
94
+ if (tasks.size) {
95
+ for (const worktree of listRegisteredWorktrees(root)) {
96
+ if (!worktree.branch?.startsWith("exec/") || !existsSync(worktree.path))
97
+ continue;
98
+ for (const task of tasks) {
99
+ const names = [task, recordIdentity(task).itemId].map(worktreeNameFromTaskId);
100
+ const branchTask = worktree.branch.slice("exec/".length);
101
+ const matches = names.some((name) => branchTask === name ||
102
+ (projectId
103
+ ? branchTask === worktreeNameFromTaskId(qualifyTaskId(projectId, name))
104
+ : branchTask.endsWith(`-${name}`)));
105
+ if (matches)
106
+ throw new Error(`Migration target ${task} has a retained exec worktree: ${worktree.path} ` +
107
+ `(${worktree.branch}). Finish or discard the run and remove its worktree before migrating`);
108
+ }
109
+ }
110
+ }
111
+ const virtualRefs = [];
112
+ const moves = [];
113
+ const add = (from, to) => moves.push({ from: repoRef(from), to: repoRef(to) });
114
+ for (const group of groups) {
115
+ const records = taskRecordPaths(execution, group.task, group.run);
116
+ for (const path of group.files)
117
+ add(path, records.log(basename(path)));
118
+ virtualRefs.push({ from: repoRef(dirname(group.files[0])), to: repoRef(records.directory) });
119
+ }
120
+ const missing = [];
121
+ for (const pair of pairs.values()) {
122
+ if (!pair.plan || !pair.result)
123
+ missing.push({ stem: pair.stem, missing: pair.plan ? "result" : "plan" });
124
+ // Exact checkpoint refs are authoritative. For pre-checkpoint records, associate only
125
+ // an unambiguous task/pair; otherwise retain separate runs instead of guessing by time.
126
+ let candidates = groups.filter((group) => group.refs.some((ref) => [pair.plan, pair.result].some((path) => path && (ref === repoRef(path) || ref === posix(relative(execution, path))))));
127
+ if (candidates.length === 0 &&
128
+ [...pairs.values()].filter((p) => p.task === pair.task).length === 1)
129
+ candidates = groups.filter((group) => group.task === pair.task && group.refs.length === 0);
130
+ const latest = candidates
131
+ .sort((a, b) => a.updated.localeCompare(b.updated) || a.run.localeCompare(b.run))
132
+ .at(-1);
133
+ const records = taskRecordPaths(execution, pair.task, latest?.run ?? pair.stem);
134
+ if (pair.plan)
135
+ add(pair.plan, records.plan);
136
+ if (pair.result)
137
+ add(pair.result, records.result);
138
+ for (const kind of ["plan", "result"]) {
139
+ if (!pair[kind])
140
+ virtualRefs.push({
141
+ from: repoRef(join(execution, "exec", `${kind}s`, `${pair.stem}-${kind}.md`)),
142
+ to: repoRef(records[kind]),
143
+ });
144
+ }
145
+ }
146
+ moves.sort((a, b) => a.from.localeCompare(b.from));
147
+ const destinations = new Set();
148
+ for (const move of moves) {
149
+ if (destinations.has(move.to) || existsSync(join(root, move.to)))
150
+ throw new Error(`Migration destination already exists: ${move.to}`);
151
+ if (isAbsolute(move.to) || move.to.startsWith("../"))
152
+ throw new Error(`Migration destination outside repository: ${move.to}`);
153
+ destinations.add(move.to);
154
+ }
155
+ // References can be repository-relative, execution-relative, or absolute under a previous
156
+ // checkout. Match the execution suffix without changing prose, commands, IDs, or log bodies.
157
+ const refs = new Map();
158
+ for (const move of [...moves, ...virtualRefs]) {
159
+ refs.set(move.from, move.to);
160
+ refs.set(posix(relative(execution, join(root, move.from))), posix(relative(execution, join(root, move.to))));
161
+ }
162
+ const rewrite = (value) => {
163
+ const direct = refs.get(value);
164
+ if (direct)
165
+ return direct;
166
+ for (let slash = value.indexOf("/"); slash >= 0; slash = value.indexOf("/", slash + 1)) {
167
+ const target = refs.get(value.slice(slash + 1));
168
+ if (target)
169
+ return `${value.slice(0, slash + 1)}${target}`;
170
+ }
171
+ return value;
172
+ };
173
+ const updates = [];
174
+ const targets = new Map(moves.map((move) => [move.from, move.to]));
175
+ const structured = [
176
+ ...moves.map((move) => join(root, move.from)),
177
+ ...listFilesRecursive(join(execution, "jobs", "runs")),
178
+ ];
179
+ for (const path of structured) {
180
+ if (!/\.(json|md)$/.test(path))
181
+ continue;
182
+ const original = readFileSync(path, "utf8");
183
+ let content = original;
184
+ if (path.endsWith(".json")) {
185
+ content = rewriteJsonPaths(original, rewrite);
186
+ }
187
+ else if (path.endsWith(".md")) {
188
+ content = original.replace(/^---\r?\n[\s\S]*?\r?\n---/, (fm) => fm.replace(/^(\s*[\w]+(?:_ref|_path):\s*)([^\r\n]+)$/gm, (_line, key, raw) => {
189
+ const quote = raw.startsWith('"') ? '"' : raw.startsWith("'") ? "'" : "";
190
+ const value = quote ? raw.slice(1, -1) : raw;
191
+ return `${key}${quote}${rewrite(value)}${quote}`;
192
+ }));
193
+ if (path.endsWith("-plan.md"))
194
+ content = rebasePlanConventions(content, path, join(root, targets.get(repoRef(path))));
195
+ }
196
+ if (content !== original)
197
+ updates.push({ path: targets.get(repoRef(path)) ?? repoRef(path), content });
198
+ }
199
+ return { moves, updates, missing, skipped: [] };
200
+ }
201
+ export function applyRecordMigration(repoRoot, plan) {
202
+ if (!plan.moves.length && !plan.updates.length)
203
+ return;
204
+ const tracked = spawnSync("git", ["ls-files", "-z"], {
205
+ cwd: repoRoot,
206
+ env: gitEnvironment(),
207
+ encoding: "utf8",
208
+ });
209
+ if (tracked.status !== 0)
210
+ throw new Error(`git ls-files failed: ${tracked.stderr}`);
211
+ const files = new Set(tracked.stdout.split("\0"));
212
+ for (const move of plan.moves) {
213
+ if (!files.has(move.from))
214
+ throw new Error(`Migration source is not tracked: ${move.from}`);
215
+ }
216
+ for (const move of plan.moves) {
217
+ mkdirSync(dirname(join(repoRoot, move.to)), { recursive: true });
218
+ const result = spawnSync("git", ["mv", "--", move.from, move.to], {
219
+ cwd: repoRoot,
220
+ env: gitEnvironment(),
221
+ encoding: "utf8",
222
+ });
223
+ if (result.status !== 0)
224
+ throw new Error(`git mv failed: ${move.from}: ${result.stderr}`);
225
+ }
226
+ for (const update of plan.updates)
227
+ writeFileSync(join(repoRoot, update.path), update.content);
228
+ }
229
+ export function registerRecordMigrationCommand(exec) {
230
+ const command = exec
231
+ .command("migrate-records")
232
+ .description("Move tracked legacy run records with git mv");
233
+ addProjectOptions(command);
234
+ command.option("--dry-run", "List moves and reference updates without writing", false);
235
+ command.action((opts) => {
236
+ try {
237
+ const { executionPath } = resolveProjectContext(opts);
238
+ const root = specdojoRootDir();
239
+ const plan = planRecordMigration(root, executionPath, resolveProjectId(opts));
240
+ process.stdout.write(`${JSON.stringify({ ...plan, updates: plan.updates.map(({ path }) => path) }, null, 2)}\n`);
241
+ if (!opts.dryRun)
242
+ applyRecordMigration(root, plan);
243
+ }
244
+ catch (error) {
245
+ process.stderr.write(`blocked: ${error instanceof Error ? error.message : String(error)}; need=resolve migration precondition; ref=${opts.project ?? "current project"}\n`);
246
+ process.exitCode = 1;
247
+ }
248
+ });
249
+ }
@@ -2,7 +2,7 @@ import { spawn } from "node:child_process";
2
2
  import { join } from "node:path";
3
3
  import { gitEnvironment } from "./worktree.js";
4
4
  import { acquirePoolSlot, getActiveExecLocksDir, releaseLock } from "./slot-lock.js";
5
- import { redactSensitiveText } from "./evidence.js";
5
+ import { MAX_CHANGE_FILES, redactSensitiveText } from "./evidence.js";
6
6
  import { PROJECT_REPO_WORKTREE_DIRNAME, REPO_NAME_PATTERN } from "../shared/specdojo-config.js";
7
7
  export const MAX_PARENT_VALIDATION_STREAM_BYTES = 1024 * 1024;
8
8
  const MAX_SUMMARY_LENGTH = 1_000;
@@ -64,6 +64,13 @@ const PARENT_VALIDATION_REGISTRY = {
64
64
  displayCommand: "npm run lint:mermaid",
65
65
  timeoutMs: 10 * 60 * 1_000,
66
66
  },
67
+ "lint-d2": {
68
+ id: "lint-d2",
69
+ command: process.platform === "win32" ? "npm.cmd" : "npm",
70
+ args: ["run", "lint:d2"],
71
+ displayCommand: "npm run lint:d2",
72
+ timeoutMs: 10 * 60 * 1_000,
73
+ },
67
74
  build: {
68
75
  id: "build",
69
76
  command: process.platform === "win32" ? "npm.cmd" : "npm",
@@ -157,15 +164,25 @@ function isRecord(value) {
157
164
  function assignmentLabel(id, repo) {
158
165
  return repo === PARENT_VALIDATION_PROJECT_REPO ? id : `${repo}:${id}`;
159
166
  }
167
+ function parsePaths(value, where) {
168
+ if (value === undefined)
169
+ return undefined;
170
+ if (!Array.isArray(value) ||
171
+ value.length === 0 ||
172
+ !value.every((pattern) => typeof pattern === "string" && pattern.trim().length > 0)) {
173
+ throw new Error(`${where}.paths must be a non-empty array of non-empty glob strings`);
174
+ }
175
+ return value.map((pattern) => pattern.trim());
176
+ }
160
177
  function parseEntry(entry, index) {
161
178
  const where = `pipeline.parent_validations[${index}] in exec-defaults`;
162
179
  if (typeof entry === "string")
163
180
  return { id: entry, repo: PARENT_VALIDATION_PROJECT_REPO };
164
181
  if (!isRecord(entry)) {
165
- throw new Error(`${where} must be a validation id or { id, repo }: ${JSON.stringify(entry)}`);
182
+ throw new Error(`${where} must be a validation id or { id, repo?, paths? }: ${JSON.stringify(entry)}`);
166
183
  }
167
184
  const unknownKeys = Object.keys(entry)
168
- .filter((key) => key !== "id" && key !== "repo")
185
+ .filter((key) => key !== "id" && key !== "repo" && key !== "paths")
169
186
  .sort();
170
187
  if (unknownKeys.length > 0) {
171
188
  throw new Error(`${where}: unknown key(s) ${unknownKeys.map((key) => `"${key}"`).join(", ")}`);
@@ -173,17 +190,22 @@ function parseEntry(entry, index) {
173
190
  if (typeof entry.id !== "string" || entry.id.length === 0) {
174
191
  throw new Error(`${where}.id must be a non-empty string`);
175
192
  }
176
- if (typeof entry.repo !== "string" || !REPO_NAME_PATTERN.test(entry.repo)) {
193
+ const paths = parsePaths(entry.paths, where);
194
+ if (entry.repo === undefined && paths === undefined) {
195
+ throw new Error(`${where} must set repo or paths when written as an object`);
196
+ }
197
+ const repo = entry.repo ?? PARENT_VALIDATION_PROJECT_REPO;
198
+ if (typeof repo !== "string" || !REPO_NAME_PATTERN.test(repo)) {
177
199
  throw new Error(`${where}.repo must match ${String(REPO_NAME_PATTERN)} (got ${JSON.stringify(entry.repo)})`);
178
200
  }
179
- return { id: entry.id, repo: entry.repo };
201
+ return { id: entry.id, repo, ...(paths ? { paths } : {}) };
180
202
  }
181
203
  export function resolveParentValidationAssignments(entries) {
182
204
  if (!entries)
183
205
  return [];
184
206
  const seen = new Set();
185
207
  return entries.map((entry, index) => {
186
- const { id, repo } = parseEntry(entry, index);
208
+ const { id, repo, paths } = parseEntry(entry, index);
187
209
  const label = assignmentLabel(id, repo);
188
210
  if (seen.has(label)) {
189
211
  throw new Error(`Duplicate parent validation id in exec-defaults: ${label}`);
@@ -195,9 +217,76 @@ export function resolveParentValidationAssignments(entries) {
195
217
  if (!definition) {
196
218
  throw new Error(`Unknown parent validation id in exec-defaults: ${id} (allowed: ${Object.keys(PARENT_VALIDATION_REGISTRY).join(", ")})`);
197
219
  }
198
- return { definition, repo, label };
220
+ return { definition, repo, label, ...(paths ? { paths } : {}) };
199
221
  });
200
222
  }
223
+ function escapeRegExp(value) {
224
+ return value.replace(/[.+^${}()|[\]\\]/g, "\\$&");
225
+ }
226
+ // lefthook の glob と同じ書き方のうち、`**`・`*`・`?`・入れ子のない `{a,b}` だけを扱う。
227
+ function globSource(pattern) {
228
+ let source = "";
229
+ for (let index = 0; index < pattern.length; index++) {
230
+ const char = pattern[index];
231
+ if (char === "*" && pattern[index + 1] === "*") {
232
+ const followedBySlash = pattern[index + 2] === "/";
233
+ source += followedBySlash ? "(?:.*/)?" : ".*";
234
+ index += followedBySlash ? 2 : 1;
235
+ }
236
+ else if (char === "*") {
237
+ source += "[^/]*";
238
+ }
239
+ else if (char === "?") {
240
+ source += "[^/]";
241
+ }
242
+ else if (char === "{" && pattern.indexOf("}", index) > index) {
243
+ const end = pattern.indexOf("}", index);
244
+ const alternatives = pattern
245
+ .slice(index + 1, end)
246
+ .split(",")
247
+ .map(globSource);
248
+ source += `(?:${alternatives.join("|")})`;
249
+ index = end;
250
+ }
251
+ else {
252
+ source += escapeRegExp(char);
253
+ }
254
+ }
255
+ return source;
256
+ }
257
+ export function matchesParentValidationPaths(path, patterns) {
258
+ return patterns.some((pattern) => new RegExp(`^${globSource(pattern)}$`).test(path));
259
+ }
260
+ // evidence の変更一覧は、プロジェクトの変更を相対パス、プロダクトの変更を `<repo>:<path>`、
261
+ // 名前の変更を `old -> new` で記録する。割り当てたリポジトリの相対パスへ戻して照合する。
262
+ function changedPathsForRepo(changedPaths, repo, productRepos) {
263
+ const sides = changedPaths.flatMap((path) => path.split(" -> "));
264
+ if (repo !== PARENT_VALIDATION_PROJECT_REPO) {
265
+ const prefix = `${repo}:`;
266
+ return sides.filter((path) => path.startsWith(prefix)).map((path) => path.slice(prefix.length));
267
+ }
268
+ return sides.filter((path) => !productRepos.some((name) => path.startsWith(`${name}:`)));
269
+ }
270
+ /**
271
+ * Selection from the executor's recorded changes. A truncated change list (the evidence keeps at
272
+ * most MAX_CHANGE_FILES entries) is treated as unknown so no validation is skipped.
273
+ */
274
+ export function parentValidationSelectionForEvidence(evidence) {
275
+ if (evidence.changes.length >= MAX_CHANGE_FILES)
276
+ return {};
277
+ return { changedPaths: evidence.changes.map((change) => change.path) };
278
+ }
279
+ /**
280
+ * Whether a validation declared with `paths` is skipped for the given change set. Validations
281
+ * without `paths` always run, and so does every validation when the change set is unknown.
282
+ */
283
+ export function isParentValidationSkipped(assignment, selection, productRepos = []) {
284
+ const patterns = assignment.paths;
285
+ const changedPaths = selection?.changedPaths;
286
+ if (!patterns || changedPaths === undefined)
287
+ return false;
288
+ return !changedPathsForRepo(changedPaths, assignment.repo, productRepos).some((path) => matchesParentValidationPaths(path, patterns));
289
+ }
201
290
  export function resolveParentValidationDefinitions(entries) {
202
291
  return resolveParentValidationAssignments(entries).map((assignment) => assignment.definition);
203
292
  }
@@ -284,15 +373,32 @@ function validationSummary(result) {
284
373
  * without spawning anything. Results carry `repo` when the run spans product repositories or the
285
374
  * assignment names one, so single-repository evidence keeps its previous shape.
286
375
  */
287
- export async function runParentValidationBatch(entries, cwd, invoke = invokeParentValidation) {
376
+ export async function runParentValidationBatch(entries, cwd, invoke = invokeParentValidation, selection) {
288
377
  const assignments = resolveParentValidationAssignments(entries);
289
378
  const roots = typeof cwd === "string" ? { project: cwd } : cwd;
290
379
  const recordsRepo = Object.keys(roots.repos ?? {}).length > 0 ||
291
380
  assignments.some((assignment) => assignment.repo !== PARENT_VALIDATION_PROJECT_REPO);
292
381
  const validations = [];
293
382
  const failureOutputs = [];
294
- for (const { definition, repo } of assignments) {
383
+ const productRepos = Object.keys(roots.repos ?? {});
384
+ for (const assignment of assignments) {
385
+ const { definition, repo } = assignment;
295
386
  const repoField = recordsRepo ? { repo } : {};
387
+ if (isParentValidationSkipped(assignment, selection, productRepos)) {
388
+ // 変更の種類に合わない検証は流さず、記録だけを残す(PJR-T01P)。ラベルの並びを保つため、
389
+ // 再開時の hasRecordedParentValidations は流し直しを要求しない。
390
+ const reason = truncateHead(`skipped by change type: no changed file matches paths (${(assignment.paths ?? []).join(", ")})`, MAX_SUMMARY_LENGTH);
391
+ validations.push({
392
+ id: definition.id,
393
+ source: "runner",
394
+ ...repoField,
395
+ command: definition.displayCommand,
396
+ status: "not_applicable",
397
+ summary: reason,
398
+ reason,
399
+ });
400
+ continue;
401
+ }
296
402
  const root = repo === PARENT_VALIDATION_PROJECT_REPO
297
403
  ? roots.project
298
404
  : Object.hasOwn(roots.repos ?? {}, repo)
@@ -331,8 +437,8 @@ export async function runParentValidationBatch(entries, cwd, invoke = invokePare
331
437
  }
332
438
  return { validations, failureOutputs };
333
439
  }
334
- export async function runParentValidations(entries, cwd, invoke = invokeParentValidation) {
335
- return (await runParentValidationBatch(entries, cwd, invoke)).validations;
440
+ export async function runParentValidations(entries, cwd, invoke = invokeParentValidation, selection) {
441
+ return (await runParentValidationBatch(entries, cwd, invoke, selection)).validations;
336
442
  }
337
443
  /** `<id>` or `<repo>:<id>` of a recorded runner validation (no `repo` means the project). */
338
444
  export function recordedParentValidationLabel(validation) {
@@ -432,11 +538,53 @@ export function parentValidationGateFor(execDefaults, lockRoot = getActiveExecLo
432
538
  return gate;
433
539
  }
434
540
  export function failedParentValidationReason(validations) {
435
- const failed = validations.filter((validation) => validation.source === "runner" && validation.status !== "passed");
541
+ // runner の `not_applicable` は、`paths` に合う変更が無く流さなかった検証である(PJR-T01P)。
542
+ const failed = validations.filter((validation) => validation.source === "runner" &&
543
+ validation.status !== "passed" &&
544
+ validation.status !== "not_applicable");
436
545
  if (failed.length === 0)
437
546
  return undefined;
438
547
  return `parent validation failed: ${failed.map(recordedParentValidationLabel).join(", ")}`;
439
548
  }
549
+ // PJR-Q2AT: executor が親検証をまとめて 1 行(例: `parent runner: lint-ts, lint-fm`、
550
+ // `親 runner 指定検査(lint-ts, lint-fm)`)に書いた場合に、末尾の区切り列を検証ラベルとして取り出す。
551
+ const AGGREGATE_LABEL_PATTERN = "(?:[A-Za-z0-9][A-Za-z0-9_-]*:)?[a-z][a-z0-9-]*";
552
+ const AGGREGATE_LINE_PATTERN = new RegExp(`^(\\S.*?)(?:[::((\\[]|\\s)\\s*(${AGGREGATE_LABEL_PATTERN}(?:\\s*[,、]\\s*${AGGREGATE_LABEL_PATTERN})*)\\s*[))\\]]?\\s*$`, "u");
553
+ // コマンドそのもの(`npm run lint:md` など)をまとめた行と取り違えない。
554
+ const COMMAND_PREFIX_PATTERN = /^(?:npm|npx|pnpm|yarn|node|tsx|specdojo)(?:\s|$)/u;
555
+ function aggregatedParentValidationLabels(command) {
556
+ const normalized = command.trim().replace(/\s+/gu, " ");
557
+ if (COMMAND_PREFIX_PATTERN.test(normalized))
558
+ return undefined;
559
+ const match = AGGREGATE_LINE_PATTERN.exec(normalized);
560
+ if (!match)
561
+ return undefined;
562
+ return match[2].split(/\s*[,、]\s*/u).filter((label) => label.length > 0);
563
+ }
564
+ /**
565
+ * Whether an executor validation line that lists parent validation labels together
566
+ * (e.g. `parent runner: lint-ts, lint-fm`) is covered by the runner's own results.
567
+ * Every listed label must have a runner record (so it is configured in
568
+ * `pipeline.parent_validations`) that passed or was skipped by change type.
569
+ */
570
+ export function isAggregatedParentValidationSatisfied(command, validations) {
571
+ const labels = aggregatedParentValidationLabels(command);
572
+ if (!labels || labels.length === 0)
573
+ return false;
574
+ const runnerStatuses = new Map();
575
+ for (const validation of validations) {
576
+ if (validation.source !== "runner" || typeof validation.id !== "string")
577
+ continue;
578
+ const label = recordedParentValidationLabel(validation);
579
+ runnerStatuses.set(label, [...(runnerStatuses.get(label) ?? []), validation.status]);
580
+ }
581
+ return labels.every((label) => {
582
+ const statuses = runnerStatuses.get(label);
583
+ return (statuses !== undefined &&
584
+ statuses.length > 0 &&
585
+ statuses.every((status) => status === "passed" || status === "not_applicable"));
586
+ });
587
+ }
440
588
  /**
441
589
  * Replaces stale runner-owned validation results while preserving executor-owned evidence.
442
590
  * The caller must supply results produced from the fixed parent-validation allowlist.
@@ -1,6 +1,7 @@
1
1
  import { existsSync, readFileSync, renameSync, writeFileSync } from "node:fs";
2
2
  import { dirname, join, relative, resolve, sep } from "node:path";
3
- import { ensureDir, safeSlug } from "./shared.js";
3
+ import { runEvidencePath, taskEvidencePaths } from "./run-records.js";
4
+ import { ensureDir } from "./shared.js";
4
5
  function emptyStage(actor) {
5
6
  return {
6
7
  status: "pending",
@@ -33,7 +34,7 @@ function executionRelative(repoRoot, executionPath) {
33
34
  return rel;
34
35
  }
35
36
  export function pipelineStateLocation(input) {
36
- const path = join(input.worktreePath, executionRelative(input.repoRoot, input.executionPath), "exec", "evidence", safeSlug(input.taskId), safeSlug(input.runId), "pipeline-state.json");
37
+ const path = taskEvidencePaths(join(input.worktreePath, executionRelative(input.repoRoot, input.executionPath)), input.taskId, input.runId).state;
37
38
  return { path, ref: relative(input.worktreePath, path).split(sep).join("/") };
38
39
  }
39
40
  function isStageState(value) {
@@ -196,6 +197,29 @@ function resolveArtifactRef(worktreePath, ref) {
196
197
  return null;
197
198
  return path;
198
199
  }
200
+ /**
201
+ * Validations recorded in the executor evidence of a run (PJR-T01P: the integration commit reads
202
+ * the parent-validation results). Returns an empty list when the state or evidence is unreadable.
203
+ */
204
+ export function recordedRunValidations(worktreePath, statePath) {
205
+ if (!statePath || !existsSync(statePath))
206
+ return [];
207
+ try {
208
+ const state = readPipelineState(statePath);
209
+ const ref = state.stages.executor.artifact_ref;
210
+ const evidencePath = ref ? resolveArtifactRef(worktreePath, ref) : null;
211
+ if (!evidencePath || !existsSync(evidencePath))
212
+ return [];
213
+ const evidence = JSON.parse(readFileSync(evidencePath, "utf8"));
214
+ if (!isExecutorEvidence(evidence, state.task_id, state.run_id))
215
+ return [];
216
+ return Array.isArray(evidence.validations) ? evidence.validations : [];
217
+ }
218
+ catch {
219
+ // 読めない場合は hook を外さない(すべて流す)側へ倒す。
220
+ return [];
221
+ }
222
+ }
199
223
  function isExecutorEvidence(value, taskId, runId) {
200
224
  if (!value || typeof value !== "object" || Array.isArray(value))
201
225
  return false;
@@ -226,9 +250,7 @@ export function loadPipelineResumeCheckpoint(input) {
226
250
  const recordedEvidenceRef = state.stages.executor.artifact_ref;
227
251
  const evidenceRef = recordedEvidenceRef ??
228
252
  (state.stages.executor.status === "running"
229
- ? relative(input.worktreePath, join(dirname(statePath), "evidence.json"))
230
- .split(sep)
231
- .join("/")
253
+ ? relative(input.worktreePath, runEvidencePath(statePath)).split(sep).join("/")
232
254
  : null);
233
255
  if (!evidenceRef)
234
256
  return { state, statePath };
@@ -0,0 +1,89 @@
1
+ import { existsSync } from "node:fs";
2
+ import { createRequire } from "node:module";
3
+ import { dirname, join, relative } from "node:path";
4
+ import { pathToFileURL } from "node:url";
5
+ import { load } from "../shared/yaml.js";
6
+ import { DEFAULT_MARKDOWNLINT_CONFIG } from "../shared/markdownlint-config.js";
7
+ async function markdownlintApi(repoRoot) {
8
+ // Prefer the consumer's installation, then SpecDojo's development installation.
9
+ // Resolve from markdownlint-cli as well, for package managers without hoisting.
10
+ for (let require of [
11
+ createRequire(join(repoRoot, "package.json")),
12
+ createRequire(import.meta.url),
13
+ ]) {
14
+ try {
15
+ try {
16
+ require = createRequire(require.resolve("markdownlint-cli/markdownlint.js"));
17
+ }
18
+ catch {
19
+ // A direct markdownlint installation is sufficient too.
20
+ }
21
+ const api = (await import(pathToFileURL(require.resolve("markdownlint/sync")).href));
22
+ const parsers = [];
23
+ try {
24
+ const jsonc = require("jsonc-parser");
25
+ parsers.push((text) => {
26
+ const errors = [];
27
+ const value = jsonc.parse(text, errors, { allowTrailingComma: true });
28
+ if (errors.length)
29
+ throw new Error("Invalid JSONC configuration");
30
+ return value;
31
+ });
32
+ }
33
+ catch {
34
+ // JSON and YAML remain supported without markdownlint-cli's JSONC parser.
35
+ }
36
+ parsers.push((text) => load(text));
37
+ return { ...api, parsers };
38
+ }
39
+ catch {
40
+ // Try the next installation without downloading a package.
41
+ }
42
+ }
43
+ throw new Error("markdownlint not available; install markdownlint-cli in the project to validate plans.");
44
+ }
45
+ function planLintConfig(repoRoot, api) {
46
+ let config;
47
+ // Merge ancestor .markdownlintrc files from outermost to nearest, like the CLI.
48
+ const rcPaths = [];
49
+ for (let dir = repoRoot;; dir = dirname(dir)) {
50
+ const candidate = join(dir, ".markdownlintrc");
51
+ if (existsSync(candidate))
52
+ rcPaths.unshift(candidate);
53
+ if (dirname(dir) === dir)
54
+ break;
55
+ }
56
+ for (const file of rcPaths)
57
+ config = { ...config, ...api.readConfig(file, api.parsers) };
58
+ for (const ext of ["jsonc", "json", "yaml", "yml"]) {
59
+ const file = join(repoRoot, `.markdownlint.${ext}`);
60
+ if (existsSync(file)) {
61
+ config = { ...config, ...api.readConfig(file, api.parsers) };
62
+ break;
63
+ }
64
+ }
65
+ return config ?? DEFAULT_MARKDOWNLINT_CONFIG;
66
+ }
67
+ // Lint rendered source before formatting or replacing an existing schedule plan.
68
+ // A string input bypasses ignore globs for generated history directories.
69
+ export async function assertPlanMarkdownlint(repoRoot, taskId, outPath, content) {
70
+ const planPath = relative(repoRoot, outPath);
71
+ const label = `Task ${taskId}, plan ${planPath}`;
72
+ let errors;
73
+ try {
74
+ const api = await markdownlintApi(repoRoot);
75
+ const issues = api.lint({
76
+ strings: { [planPath]: content },
77
+ config: planLintConfig(repoRoot, api),
78
+ configParsers: api.parsers,
79
+ })[planPath] ?? [];
80
+ errors = issues
81
+ .map((issue) => `${planPath}: ${issue.lineNumber} ${issue.ruleNames.join("/")} ${issue.ruleDescription}${issue.errorDetail ? ` [${issue.errorDetail}]` : ""}`)
82
+ .join("\n");
83
+ }
84
+ catch (error) {
85
+ throw new Error(`${label}: Failed to run markdownlint before plan generation: ${error instanceof Error ? error.message : String(error)}`);
86
+ }
87
+ if (errors)
88
+ throw new Error(`${label}: Plan Markdown notation violation before generation\n${errors}`);
89
+ }