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,110 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { mkdirSync, mkdtempSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
3
+ import { tmpdir } from "node:os";
4
+ import { basename, dirname, join, relative, resolve, sep } from "node:path";
5
+ import { gitEnvironment } from "../shared/git-environment.js";
6
+ import { validateRunRecordLayout } from "./validate-records.js";
7
+ // commit の tree を対象に配置を検査する(PJR-1ZQK)。作業ツリーの検査は、ローカルにしかない
8
+ // 未 commit の run(中断中の plan 単独や空のディレクトリ)も拾うため、push の前の検査には使えない。
9
+ // tree を一時ディレクトリへ書き出し、同じ検査を流す。中身を読むのは `execution: human` を判定する
10
+ // result.md だけで、ほかのファイルは空で置く。
11
+ const GIT_MAX_BUFFER = 256 * 1024 * 1024;
12
+ function git(repoRoot, args, input) {
13
+ const result = spawnSync("git", args, {
14
+ cwd: repoRoot,
15
+ env: gitEnvironment(),
16
+ encoding: "utf8",
17
+ maxBuffer: GIT_MAX_BUFFER,
18
+ ...(input === undefined ? {} : { input }),
19
+ });
20
+ if (result.error)
21
+ throw new Error(`git ${args[0]} failed in ${repoRoot}: ${result.error.message}`, {
22
+ cause: result.error,
23
+ });
24
+ if (result.status !== 0)
25
+ throw new Error(`git ${args.join(" ")} failed in ${repoRoot}: ${result.stderr.trim()}`);
26
+ return result.stdout;
27
+ }
28
+ function listTree(repoRoot, commit, paths) {
29
+ const output = git(repoRoot, ["ls-tree", "-r", "-z", "--full-tree", commit, "--", ...paths]);
30
+ return output
31
+ .split("\0")
32
+ .filter(Boolean)
33
+ .map((line) => {
34
+ const tab = line.indexOf("\t");
35
+ const [mode = "", type = "", object = ""] = line.slice(0, tab).split(" ");
36
+ return { mode, type, object, path: line.slice(tab + 1) };
37
+ });
38
+ }
39
+ // `git cat-file --batch` の出力(`<oid> blob <size>\n<content>\n` の繰り返し)を順に切り出す。
40
+ function readBlobs(repoRoot, objects) {
41
+ if (objects.length === 0)
42
+ return [];
43
+ const output = spawnSync("git", ["cat-file", "--batch"], {
44
+ cwd: repoRoot,
45
+ env: gitEnvironment(),
46
+ input: `${objects.join("\n")}\n`,
47
+ maxBuffer: GIT_MAX_BUFFER,
48
+ });
49
+ if (output.error || output.status !== 0)
50
+ throw new Error(`git cat-file --batch failed in ${repoRoot}: ${output.error?.message ?? String(output.stderr)}`);
51
+ const buffer = output.stdout;
52
+ const contents = [];
53
+ let offset = 0;
54
+ for (const object of objects) {
55
+ const newline = buffer.indexOf(0x0a, offset);
56
+ const header = buffer.subarray(offset, newline).toString("utf8").split(" ");
57
+ if (header[0] !== object || header[1] !== "blob")
58
+ throw new Error(`unexpected git cat-file output for ${object}: ${header.join(" ")}`);
59
+ const size = Number(header[2]);
60
+ contents.push(buffer.subarray(newline + 1, newline + 1 + size).toString("utf8"));
61
+ offset = newline + 1 + size + 1;
62
+ }
63
+ return contents;
64
+ }
65
+ function materialize(root, entries, contents) {
66
+ for (const entry of entries) {
67
+ const target = resolve(root, entry.path);
68
+ if (!target.startsWith(`${root}${sep}`) && target !== root)
69
+ throw new Error(`tree path escapes the check directory: ${entry.path}`);
70
+ if (entry.type === "commit") {
71
+ mkdirSync(target, { recursive: true });
72
+ continue;
73
+ }
74
+ mkdirSync(dirname(target), { recursive: true });
75
+ // symlink は通常のファイルとして数えない。検査が lstat で判定するので、宛先のない link で表す。
76
+ if (entry.mode === "120000")
77
+ symlinkSync("missing-symlink-target", target);
78
+ else
79
+ writeFileSync(target, contents.get(entry.path) ?? "", "utf8");
80
+ }
81
+ }
82
+ export function validateRunRecordLayoutAtCommit(options) {
83
+ const repoRoot = resolve(options.repoRoot);
84
+ const toRepo = (path) => relative(repoRoot, resolve(path)).replaceAll("\\", "/");
85
+ const executionPath = toRepo(options.executionPath);
86
+ const routineLocks = options.routinesPath ? `${toRepo(options.routinesPath)}/.locks` : undefined;
87
+ const commit = git(repoRoot, [
88
+ "rev-parse",
89
+ "--verify",
90
+ "--end-of-options",
91
+ `${options.commit}^{commit}`,
92
+ ]).trim();
93
+ const entries = listTree(repoRoot, commit, routineLocks ? [executionPath, routineLocks] : [executionPath]);
94
+ const results = entries.filter((entry) => entry.type === "blob" && entry.mode !== "120000" && basename(entry.path) === "result.md");
95
+ const blobs = readBlobs(repoRoot, results.map((entry) => entry.object));
96
+ const contents = new Map(results.map((entry, index) => [entry.path, blobs[index] ?? ""]));
97
+ const root = mkdtempSync(join(tmpdir(), "specdojo-record-layout-commit-"));
98
+ try {
99
+ materialize(root, entries, contents);
100
+ return validateRunRecordLayout({
101
+ repoRoot: root,
102
+ executionPath: join(root, executionPath),
103
+ ...(options.routinesPath ? { routinesPath: join(root, toRepo(options.routinesPath)) } : {}),
104
+ lockPolicy: "tracked",
105
+ });
106
+ }
107
+ finally {
108
+ rmSync(root, { recursive: true, force: true });
109
+ }
110
+ }
@@ -0,0 +1,148 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { existsSync, lstatSync, readdirSync, readFileSync } from "node:fs";
3
+ import { basename, dirname, join, relative, resolve, sep } from "node:path";
4
+ import { readSpecdojoNamespace } from "../shared/frontmatter-namespace.js";
5
+ import { gitEnvironment } from "../shared/git-environment.js";
6
+ import { runRecordLocation, runRecordsDirectory } from "../shared/run-records.js";
7
+ function isRegularFile(path) {
8
+ return existsSync(path) && lstatSync(path).isFile();
9
+ }
10
+ /**
11
+ * Required records missing from one run directory, as absolute paths. A path that is not an
12
+ * exact runs/<origin>/<item ID>/<run ID>/ directory has no requirement. `isFile` lets callers
13
+ * judge a state that is not the working tree, such as the files a commit will contain.
14
+ */
15
+ export function missingRunRecords(executionPath, directory, options = {}) {
16
+ const isFile = options.isFile ?? isRegularFile;
17
+ const itemHasPair = options.itemHasPair ?? new Map();
18
+ const paths = runRecordLocation(executionPath, directory);
19
+ if (!paths)
20
+ return [];
21
+ const exists = (path) => isFile(path) || existsSync(path);
22
+ // Before evidence existed, a plan/result pair was a complete run.
23
+ if (isFile(paths.plan) && isFile(paths.result) && !exists(paths.state) && !exists(paths.evidence))
24
+ return [];
25
+ // Migration consolidated shared plan/result pairs into another run of the same item.
26
+ if (!exists(paths.plan) &&
27
+ !exists(paths.result) &&
28
+ isFile(paths.state) &&
29
+ isFile(paths.evidence) &&
30
+ hasSiblingPair(executionPath, directory, isFile, itemHasPair))
31
+ return [];
32
+ // Human work is explicitly result-only; absent or malformed metadata gets no exemption.
33
+ const human = isRegularFile(paths.result) &&
34
+ readSpecdojoNamespace(readFileSync(paths.result, "utf8")).execution === "human";
35
+ return (human ? [paths.result] : [paths.plan, paths.result, paths.evidence]).filter((path) => !isFile(path));
36
+ }
37
+ function hasSiblingPair(executionPath, directory, isFile, itemHasPair) {
38
+ const item = dirname(directory);
39
+ const cached = itemHasPair.get(item);
40
+ if (cached !== undefined)
41
+ return cached;
42
+ const found = readdirSync(item, { withFileTypes: true }).some((entry) => {
43
+ if (!entry.isDirectory() || entry.name === basename(directory))
44
+ return false;
45
+ const paths = runRecordLocation(executionPath, join(item, entry.name));
46
+ return paths !== undefined && isFile(paths.plan) && isFile(paths.result);
47
+ });
48
+ itemHasPair.set(item, found);
49
+ return found;
50
+ }
51
+ /** Read-only layout audit. Logs, evidence and checkpoint contents are never read. */
52
+ export function validateRunRecordLayout(options) {
53
+ const { executionPath, repoRoot, routinesPath } = options;
54
+ const issues = [];
55
+ const locks = new Set();
56
+ const report = (path, reason, message) => {
57
+ issues.push({ path: relative(repoRoot, path).replaceAll("\\", "/"), reason, message });
58
+ };
59
+ const entries = (directory) => readdirSync(directory, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
60
+ function collectLocks(path) {
61
+ if (lstatSync(path).isDirectory()) {
62
+ // Empty directory trees cannot contain runtime locks and Git cannot track them.
63
+ const children = entries(path).map((entry) => collectLocks(join(path, entry.name)));
64
+ if (!children.some(Boolean))
65
+ return false;
66
+ }
67
+ locks.add(resolve(path));
68
+ return true;
69
+ }
70
+ const itemHasPair = new Map();
71
+ function checkRun(directory) {
72
+ for (const path of missingRunRecords(executionPath, directory, { itemHasPair }))
73
+ report(path, "missing", "required run record is missing or not a regular file");
74
+ }
75
+ const runs = resolve(runRecordsDirectory(executionPath));
76
+ // These have independent formats and lifecycles (PJR-VH8D / PJR-9BY9 / PJR-PZBP).
77
+ const separateTrees = new Set([
78
+ "grade/results",
79
+ "grade/generated",
80
+ "jobs/runs",
81
+ "exec/events",
82
+ "exec/trials",
83
+ "exec/plans",
84
+ "exec/results",
85
+ "exec/evidence",
86
+ "conventions",
87
+ "generated",
88
+ "routines/failures",
89
+ ]);
90
+ function walk(directory) {
91
+ checkRun(directory);
92
+ for (const entry of entries(directory)) {
93
+ const path = join(directory, entry.name);
94
+ const rel = relative(executionPath, path).replaceAll("\\", "/");
95
+ if (entry.name === ".locks" || entry.name.endsWith(".lock")) {
96
+ collectLocks(path);
97
+ continue;
98
+ }
99
+ if (separateTrees.has(rel))
100
+ continue;
101
+ const inRuns = resolve(path).startsWith(`${runs}${sep}`);
102
+ if (entry.isDirectory()) {
103
+ // Validate empty run directories too; reject unknown origins and extra nesting.
104
+ const depth = relative(runs, path).split(/[\\/]/).length;
105
+ if (inRuns && depth >= 3 && !runRecordLocation(executionPath, path)) {
106
+ report(path, "misplaced", "expected runs/<origin>/<item ID>/<run ID>/");
107
+ }
108
+ walk(path);
109
+ }
110
+ else if (inRuns
111
+ ? !entry.isFile() || !runRecordLocation(executionPath, directory)
112
+ : /^(?:plan\.md|result\.md|evidence(?:\.attempt-\d+)?\.json|pipeline-state(?:\.attempt-\d+)?\.json)$/.test(basename(path)) || /(?:-(?:plan|result)\.md|\.log)$/.test(entry.name)) {
113
+ report(path, "misplaced", "execution record must be a regular file directly in runs/<origin>/<item ID>/<run ID>/");
114
+ }
115
+ }
116
+ }
117
+ if (existsSync(executionPath))
118
+ walk(executionPath);
119
+ const oldRoutineLocks = routinesPath && join(routinesPath, ".locks");
120
+ if (oldRoutineLocks && existsSync(oldRoutineLocks))
121
+ collectLocks(oldRoutineLocks);
122
+ if (locks.size && options.lockPolicy === "tracked") {
123
+ for (const path of locks)
124
+ report(path, "lock-not-ignored", "runtime lock is tracked by Git");
125
+ }
126
+ else if (locks.size) {
127
+ const candidates = [...locks].sort();
128
+ // Without --no-index, tracked locks are correctly rejected even if a rule now ignores them.
129
+ const result = spawnSync("git", ["check-ignore", "-z", "--stdin"], {
130
+ cwd: repoRoot,
131
+ env: gitEnvironment(),
132
+ input: `${candidates.join("\0")}\0`,
133
+ encoding: "utf8",
134
+ timeout: 10_000,
135
+ });
136
+ if (result.error || (result.status !== 0 && result.status !== 1)) {
137
+ report(candidates[0], "git-check-failed", "cannot verify lock exclusion with git check-ignore");
138
+ }
139
+ else {
140
+ const ignored = new Set(result.stdout.split("\0"));
141
+ for (const path of candidates) {
142
+ if (!ignored.has(path))
143
+ report(path, "lock-not-ignored", "runtime lock is tracked or not ignored by Git");
144
+ }
145
+ }
146
+ }
147
+ return issues.sort((a, b) => a.path.localeCompare(b.path) || a.reason.localeCompare(b.reason));
148
+ }
@@ -0,0 +1,181 @@
1
+ import { AsyncLocalStorage } from "node:async_hooks";
2
+ import { randomUUID } from "node:crypto";
3
+ import { appendFileSync, mkdirSync, readdirSync, readFileSync, unlinkSync, writeFileSync, } from "node:fs";
4
+ import { basename, dirname, join } from "node:path";
5
+ import { performance } from "node:perf_hooks";
6
+ import { getActiveExecLocksDir, isLiveLock, livePoolHolders, readLockOwner } from "./slot-lock.js";
7
+ import { redactSensitiveText } from "./evidence.js";
8
+ // Diagnostics are observational: inaccessible /proc, locks, or output must never fail a run.
9
+ function optional(read) {
10
+ try {
11
+ return read();
12
+ }
13
+ catch {
14
+ return undefined;
15
+ }
16
+ }
17
+ export function collectValidationLoad(procRoot = "/proc") {
18
+ const pressure = Object.fromEntries(["cpu", "memory", "io"].flatMap((resource) => {
19
+ const value = optional(() => readFileSync(join(procRoot, "pressure", resource), "utf8").trim());
20
+ return value === undefined ? [] : [[resource, value]];
21
+ }));
22
+ const memory = optional(() => {
23
+ const text = readFileSync(join(procRoot, "meminfo"), "utf8");
24
+ const fields = Object.fromEntries([...text.matchAll(/^(\w+):\s+(\d+) kB$/gm)].map((match) => [
25
+ match[1],
26
+ Number(match[2]) * 1024,
27
+ ]));
28
+ if (![fields.MemTotal, fields.MemAvailable, fields.SwapTotal, fields.SwapFree].every(Number.isFinite))
29
+ return undefined;
30
+ return {
31
+ total_bytes: fields.MemTotal,
32
+ available_bytes: fields.MemAvailable,
33
+ used_bytes: fields.MemTotal - fields.MemAvailable,
34
+ swap_total_bytes: fields.SwapTotal,
35
+ swap_used_bytes: fields.SwapTotal - fields.SwapFree,
36
+ };
37
+ });
38
+ const loadavg = optional(() => readFileSync(join(procRoot, "loadavg"), "utf8").trim());
39
+ return {
40
+ ...(Object.keys(pressure).length ? { pressure } : {}),
41
+ ...(memory ? { memory } : {}),
42
+ ...(loadavg ? { loadavg } : {}),
43
+ };
44
+ }
45
+ const localExecutors = new Map();
46
+ /** Called only while an executor child is alive; no command, prompt, or environment is stored. */
47
+ export function trackExecutor(pid, cwd) {
48
+ if (!pid)
49
+ return () => undefined;
50
+ const key = `${process.pid}-${pid}-${randomUUID()}`;
51
+ const activity = { pid, runner_pid: process.pid, worktree: basename(cwd) };
52
+ localExecutors.set(key, activity);
53
+ const root = getActiveExecLocksDir();
54
+ const file = root ? join(root, "metrics-executors", `${key}.json`) : undefined;
55
+ if (file)
56
+ optional(() => {
57
+ mkdirSync(dirname(file), { recursive: true });
58
+ writeFileSync(file, JSON.stringify(activity));
59
+ });
60
+ return () => {
61
+ localExecutors.delete(key);
62
+ if (file)
63
+ optional(() => unlinkSync(file));
64
+ };
65
+ }
66
+ function alive(pid) {
67
+ try {
68
+ process.kill(pid, 0);
69
+ return true;
70
+ }
71
+ catch (error) {
72
+ return error.code === "EPERM";
73
+ }
74
+ }
75
+ export function collectValidationActivity(lockRoot = getActiveExecLocksDir()) {
76
+ const executors = new Map(localExecutors);
77
+ const runs = [];
78
+ if (lockRoot) {
79
+ optional(() => {
80
+ const primary = join(lockRoot, "exec-run.lock");
81
+ const owner = isLiveLock(primary) ? readLockOwner(primary) : null;
82
+ if (owner)
83
+ runs.push({ pid: owner.pid, actor: owner.actor });
84
+ for (const slot of livePoolHolders(join(lockRoot, "exec-run-join"))) {
85
+ if (slot.owner)
86
+ runs.push({ pid: slot.owner.pid, actor: slot.owner.actor });
87
+ }
88
+ });
89
+ const directory = join(lockRoot, "metrics-executors");
90
+ for (const name of optional(() => readdirSync(directory)) ?? []) {
91
+ if (!name.endsWith(".json"))
92
+ continue;
93
+ optional(() => {
94
+ const value = JSON.parse(readFileSync(join(directory, name), "utf8"));
95
+ if (Number.isSafeInteger(value.pid) &&
96
+ value.pid > 0 &&
97
+ Number.isSafeInteger(value.runner_pid) &&
98
+ value.runner_pid > 0 &&
99
+ typeof value.worktree === "string" &&
100
+ alive(value.pid) &&
101
+ alive(value.runner_pid))
102
+ executors.set(name.slice(0, -5), value);
103
+ });
104
+ }
105
+ }
106
+ return {
107
+ scope: lockRoot ? "project-locks" : "process",
108
+ run_count: lockRoot ? runs.length : 1,
109
+ runs: lockRoot ? runs : [{ pid: process.pid }],
110
+ executor_count: executors.size,
111
+ executors: [...executors.values()],
112
+ };
113
+ }
114
+ const contexts = new AsyncLocalStorage();
115
+ export function withValidationMetrics(label, path, task) {
116
+ return contexts.run({ batch: randomUUID(), label, path, gateWaitMs: 0 }, task);
117
+ }
118
+ export function validationMetric(event, fields = {}) {
119
+ const context = contexts.getStore();
120
+ if (!context)
121
+ return;
122
+ optional(() => {
123
+ const line = redactSensitiveText(JSON.stringify({
124
+ schema_version: 1,
125
+ batch_id: context.batch,
126
+ label: context.label,
127
+ runner_pid: process.pid,
128
+ event,
129
+ at: new Date().toISOString(),
130
+ gate_wait_ms: context.gateWaitMs,
131
+ ...fields,
132
+ load: collectValidationLoad(),
133
+ activity: collectValidationActivity(),
134
+ })) + "\n";
135
+ if (context.path) {
136
+ mkdirSync(dirname(context.path), { recursive: true });
137
+ appendFileSync(context.path, line);
138
+ }
139
+ else
140
+ process.stdout.write(` Parent validation metrics: ${line}`);
141
+ });
142
+ }
143
+ export function recordValidationGateWait(start, localWaitMs) {
144
+ const context = contexts.getStore();
145
+ const total = performance.now() - start;
146
+ if (context)
147
+ context.gateWaitMs = total;
148
+ validationMetric("gate-acquired", {
149
+ local_wait_ms: localWaitMs,
150
+ shared_wait_ms: Math.max(0, total - localWaitMs),
151
+ });
152
+ }
153
+ export const TEST_FILE_METRIC_PREFIX = "[parent-validation:test-file] ";
154
+ /** Bounded stream parser; active files come from notifications, never guessed from completed tests. */
155
+ export class ValidationTestFiles {
156
+ pending = "";
157
+ active = new Set();
158
+ tail = "";
159
+ observe(chunk) {
160
+ this.tail = (this.tail + chunk).slice(-16_384);
161
+ const lines = (this.pending + chunk).split("\n");
162
+ this.pending = (lines.pop() ?? "").slice(-16_384);
163
+ for (const line of lines) {
164
+ const index = line.indexOf(TEST_FILE_METRIC_PREFIX);
165
+ if (index < 0)
166
+ continue;
167
+ optional(() => {
168
+ const value = JSON.parse(line.slice(index + TEST_FILE_METRIC_PREFIX.length));
169
+ if (typeof value.file !== "string" || value.file.length > 4096)
170
+ return;
171
+ if (value.event === "start" && this.active.size < 256)
172
+ this.active.add(value.file);
173
+ if (value.event === "end")
174
+ this.active.delete(value.file);
175
+ });
176
+ }
177
+ }
178
+ snapshot() {
179
+ return { active_test_files: [...this.active], output_tail: redactSensitiveText(this.tail) };
180
+ }
181
+ }
@@ -0,0 +1,26 @@
1
+ import { join } from "node:path";
2
+ import { ensureDir } from "../shared/fs.js";
3
+ import { isLiveLock, releaseLock, tryAcquireLock } from "./slot-lock.js";
4
+ import { worktreeNameFromTaskId } from "./worktree.js";
5
+ // PJR-NHT7: 統合の後の片付けは exec-lifecycle のロックの外で行う。その間に同じ項目の再実行・
6
+ // 再開・`exec worktree remove` が同じ worktree を消し始めないよう、worktree ごとのロックを取る。
7
+ // ロックは heartbeat を持つため、片付けの途中でプロセスが落ちても古くなれば次の操作が引き継ぐ。
8
+ export function worktreeCleanupLockDir(executionPath, worktreeTaskId) {
9
+ return join(executionPath, "exec", ".locks", "worktree-cleanup", worktreeNameFromTaskId(worktreeTaskId));
10
+ }
11
+ export function isWorktreeCleanupInProgress(executionPath, worktreeTaskId) {
12
+ return isLiveLock(worktreeCleanupLockDir(executionPath, worktreeTaskId));
13
+ }
14
+ export function worktreeCleanupInProgressReason(worktreeTaskId) {
15
+ return (`the worktree of ${worktreeTaskId} is still being removed after its integration; ` +
16
+ `retry after the cleanup finishes`);
17
+ }
18
+ // 取れなかった場合(別の片付けが進行中)は null を返す。呼び出し側は片付けを始めない。
19
+ export function tryAcquireWorktreeCleanupLock(executionPath, worktreeTaskId, actor) {
20
+ const lockDir = worktreeCleanupLockDir(executionPath, worktreeTaskId);
21
+ ensureDir(join(lockDir, ".."));
22
+ return tryAcquireLock(lockDir, { actor, label: `worktree cleanup ${worktreeTaskId}` });
23
+ }
24
+ export function releaseWorktreeCleanupLock(handle) {
25
+ releaseLock(handle);
26
+ }
@@ -1,24 +1,27 @@
1
- import { gradeCheckpointPaths } from "./grade-checkpoint.js";
2
1
  import { spawn } from "node:child_process";
3
2
  import { existsSync } from "node:fs";
4
- import { join, resolve } from "node:path";
5
- import { acquireSchedulerLock, foldEventsToState, readAllEventFiles, releaseSchedulerLock, } from "./events.js";
3
+ import { resolve } from "node:path";
4
+ import { getProjectSchedulePath, loadConfig, resolveAgentMember, specdojoRootDir, } from "../shared/specdojo-config.js";
6
5
  import { hasMemberCommandSource, loadExecDefaultsConfig, resolveMemberCommand, } from "./agent-config.js";
7
- import { activateResolvedProjectPaths, resolveProjectPaths } from "./project.js";
8
6
  import { agentGitStateViolation, captureAgentGitStateAcrossRepos, changedAgentGitStateAcrossRepos, qualifiedGitStateFields, } from "./agent-git-state.js";
9
7
  import { agentProtectedConfigViolation, captureAgentProtectedConfigAcrossRepos, changedAgentProtectedConfigAcrossRepos, qualifiedRepoPaths, } from "./agent-protected-config.js";
8
+ import { acquireSchedulerLock, foldEventsToState, readAllEventFiles, releaseSchedulerLock, } from "./events.js";
9
+ import { gradeCheckpointPaths } from "./grade-checkpoint.js";
10
+ import { generateSinglePlan } from "./plans.js";
11
+ import { activateResolvedProjectPaths, resolveProjectPaths } from "./project.js";
10
12
  import { recordGitStateBlockAcrossRepos, recordProtectedConfigBlockAcrossRepos, } from "./protection-handoff.js";
11
- import { configuredProductRepos, missingProductWorktrees, plannedProjectWorktreePath, productBranchForTask, pruneOrphanedProductExecBranches, productRepoEnvironment, withAgentExtraRoots, withoutInheritedRepoEnvironment, withProductRepoPrompt, withProductWorktrees, } from "./task-repos.js";
12
- import { resolveAgentMember } from "../shared/specdojo-config.js";
13
+ import { recordPathForRead, recordStem } from "./run-records.js";
13
14
  import { buildTaskPhaseMap, loadPrompt, loadRosterForExecutionPath, resolveTaskPhaseContext, selectCandidates, } from "./run/run.js";
14
- import { buildScheduleIndex } from "./schedule/schedule.js";
15
15
  import { buildInitialStateFromStrategy } from "./schedule/initial.js";
16
- import { generateSinglePlan } from "./plans.js";
16
+ import { buildScheduleIndex } from "./schedule/schedule.js";
17
17
  import { qualifyTaskId } from "./shared.js";
18
+ import { localConfigEnvironment } from "../shared/local-config.js";
19
+ import { configuredProductRepos, missingProductWorktrees, plannedProjectWorktreePath, productBranchForTask, productRepoEnvironment, pruneOrphanedProductExecBranches, withAgentExtraRoots, withoutInheritedRepoEnvironment, withProductRepoPrompt, withProductWorktrees, } from "./task-repos.js";
18
20
  import { buildTaskView } from "./task-view.js";
19
- import { findExecWorktree, gitEnvironment, gitOutput, gitResult, resolveWorktreeBase, worktreeNameFromTaskId, } from "./worktree.js";
20
21
  import { checkpointAndEnsureWorktree, commitWorktreeChanges, mergeWorktreeIntoCurrent, pruneOrphanedExecBranches, removeWorktree, taskPaths, worktreeStatusPaths, } from "./worktree-ops.js";
21
- import { getProjectSchedulePath, loadConfig, specdojoRootDir } from "../shared/specdojo-config.js";
22
+ import { branchOwnedRunRecordPaths } from "./trailing-records.js";
23
+ import { findExecWorktree, gitEnvironment, gitOutput, gitResult, resolveWorktreeBase, worktreeNameFromTaskId, } from "./worktree.js";
24
+ import { isWorktreeCleanupInProgress, worktreeCleanupInProgressReason, } from "./worktree-cleanup-lock.js";
22
25
  export { isCommitTargetPath, stabilizeCommitTargets } from "./worktree-ops.js";
23
26
  const DEFAULT_LOCK_TIMEOUT_MS = 10_000;
24
27
  const DEFAULT_LOCK_STALE_MS = 300_000;
@@ -168,8 +171,8 @@ async function prepare(opts) {
168
171
  lockStaleMs: DEFAULT_LOCK_STALE_MS,
169
172
  });
170
173
  const lockedState = requireDoingTask(context.schedulePath, opts.task);
171
- const planPath = join(context.executionPath, "exec", "plans", `${opts.task}-plan.md`);
172
- const resultPath = join(context.executionPath, "exec", "results", `${opts.task}-result.md`);
174
+ const planPath = recordPathForRead(context.executionPath, "plan", opts.task);
175
+ const resultPath = recordPathForRead(context.executionPath, "result", opts.task);
173
176
  // Plans are generated on demand (exec refresh does not manage them). Generate
174
177
  // one if absent; keep an existing plan so a hand-edited plan is not clobbered.
175
178
  if (!existsSync(planPath)) {
@@ -181,6 +184,8 @@ async function prepare(opts) {
181
184
  viewpointsPath: context.viewpointsPath,
182
185
  projectContext: context.projectContext,
183
186
  task: buildTaskView(context.schedulePath, context.executionPath, opts.task),
187
+ outPath: planPath,
188
+ stem: recordStem(planPath),
184
189
  });
185
190
  }
186
191
  for (const path of [planPath, resultPath, lockedState.claimEventPath]) {
@@ -224,7 +229,7 @@ function status(opts) {
224
229
  return;
225
230
  }
226
231
  const worktree = withProductWorktrees(found, products, worktreeTaskId);
227
- const { planRel, resultRel } = taskPaths(context, opts.task);
232
+ const { planRel, resultRel } = taskPaths(context, opts.task, worktree.path);
228
233
  const compareBase = gitOutput(context.repoRoot, ["merge-base", "HEAD", branch]).trim();
229
234
  const merged = gitResult(context.repoRoot, ["merge-base", "--is-ancestor", branch, "HEAD"]).status === 0;
230
235
  const resultChanged = gitResult(worktree.path, ["diff", "--quiet", compareBase, "--", resultRel]).status === 1;
@@ -274,6 +279,7 @@ async function agent(opts) {
274
279
  cwd: worktree.path,
275
280
  env: {
276
281
  ...withoutInheritedRepoEnvironment(gitEnvironment()),
282
+ ...localConfigEnvironment(worktree.path),
277
283
  SPECDOJO_SCHEDULE_PATH: context.schedulePath,
278
284
  SPECDOJO_EXECUTION_PATH: context.executionPath,
279
285
  ...productRepoEnvironment(worktree.path, worktree.repos),
@@ -287,7 +293,7 @@ async function agent(opts) {
287
293
  child.once("close", (code) => resolveExit(code ?? 1));
288
294
  });
289
295
  // 保護機構が block した場合も、対象と提案差分を worktree 側 result の申し送りへ残す。
290
- const worktreeResultPath = resolve(worktree.path, taskPaths(context, opts.task).resultRel);
296
+ const worktreeResultPath = resolve(worktree.path, taskPaths(context, opts.task, worktree.path).resultRel);
291
297
  const protectedConfigChanges = changedAgentProtectedConfigAcrossRepos(protectedConfigBefore);
292
298
  if (protectedConfigChanges.length > 0) {
293
299
  const reason = agentProtectedConfigViolation(qualifiedRepoPaths(protectedConfigChanges));
@@ -335,8 +341,8 @@ function merge(opts) {
335
341
  // carries the commit). Release them so the merge can bring the committed versions in.
336
342
  const { claimEventPath } = taskExecutionState(context.schedulePath, opts.task);
337
343
  const releaseRootPaths = [
338
- join(context.executionPath, "exec", "plans", `${opts.task}-plan.md`),
339
- join(context.executionPath, "exec", "results", `${opts.task}-result.md`),
344
+ recordPathForRead(context.executionPath, "plan", opts.task),
345
+ recordPathForRead(context.executionPath, "result", opts.task),
340
346
  ...(claimEventPath ? [claimEventPath] : []),
341
347
  ...gradeCheckpointPaths(context),
342
348
  ];
@@ -345,13 +351,28 @@ function merge(opts) {
345
351
  worktree,
346
352
  taskId: opts.task,
347
353
  releaseRootPaths,
354
+ // run の終わりの記帳 commit が先に入れた作業コピーとの競合は、exec branch 側で解決する。
355
+ resolveConflictsWithBranchPaths: [
356
+ ...releaseRootPaths,
357
+ ...branchOwnedRunRecordPaths({
358
+ repoRoot: context.repoRoot,
359
+ executionPath: context.executionPath,
360
+ branch: worktree.branch,
361
+ taskId: opts.task,
362
+ }),
363
+ ],
348
364
  ffOnly: opts.ffOnly,
349
365
  dryRun: opts.dryRun,
350
366
  });
351
367
  }
352
368
  function remove(opts) {
353
369
  const context = resolveContext(opts);
354
- const worktree = requireWorktree(context, qualifyTaskId(context.projectId, opts.task));
370
+ const worktreeTaskId = qualifyTaskId(context.projectId, opts.task);
371
+ // runner が統合の後の撤去をロックの外で進めている間は、同じ worktree を二重に消さない。
372
+ if (isWorktreeCleanupInProgress(context.executionPath, worktreeTaskId)) {
373
+ throw new Error(worktreeCleanupInProgressReason(worktreeTaskId));
374
+ }
375
+ const worktree = requireWorktree(context, worktreeTaskId);
355
376
  removeWorktree({
356
377
  context,
357
378
  worktree,