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
@@ -1,28 +1,35 @@
1
- import { gradeCheckpointPaths } from "../grade-checkpoint.js";
1
+ import { withPlanConventionsFiles } from "../../shared/plan-conventions.js";
2
2
  import { existsSync } from "node:fs";
3
- import { join } from "node:path";
3
+ import { specdojoRootDir } from "../../shared/specdojo-config.js";
4
4
  import { loadExecDefaultsConfig, providerSlotPoolPath, resolveMaxConcurrency, resolveMaxConcurrentRuns, } from "../agent-config.js";
5
- import { activateResolvedProjectPaths, resolveProjectPaths } from "../project.js";
6
- import { acquireSchedulerLock, buildEvent, readAllEventFiles, foldEventsToState, releaseSchedulerLock, writeEventFile, } from "../events.js";
5
+ import { acquireSchedulerLock, buildEvent, claimOwnerOf, foldEventsToState, readAllEventFiles, releaseSchedulerLock, writeEventFile, } from "../events.js";
6
+ import { gradeCheckpointPaths } from "../grade-checkpoint.js";
7
7
  import { selectDueDeferredLimitTasks } from "../limit.js";
8
- import { buildScheduleIndex } from "../schedule/schedule.js";
8
+ import { parentValidationPoolPath, resolveParentValidationConcurrency, } from "../parent-validation.js";
9
+ import { integratedRepoNames, loadPipelineResumeCheckpoint, } from "../pipeline-state.js";
10
+ import { activateResolvedProjectPaths, resolveProjectPaths } from "../project.js";
11
+ import { loadRegisterResumeCandidates, selectScheduleExecutorResume, } from "../register-resume.js";
12
+ import { readResultFrontmatterSnapshot, updateResultStatus } from "../results.js";
13
+ import { recordPathForRead } from "../run-records.js";
9
14
  import { buildInitialStateFromStrategy } from "../schedule/initial.js";
15
+ import { buildScheduleIndex } from "../schedule/schedule.js";
10
16
  import { qualifyTaskId } from "../shared.js";
11
- import { specdojoRootDir } from "../../shared/specdojo-config.js";
12
- import { collectExecLockUsage, execLocksDir, formatExecLockUsage } from "./lock.js";
17
+ import { configuredProductRepos, withProductWorktrees } from "../task-repos.js";
13
18
  import { buildTaskView } from "../task-view.js";
14
- import { readResultFrontmatterSnapshot, updateResultStatus } from "../results.js";
19
+ import { PROJECT_REPO_NAME, mergeInProgress } from "../repo-integration-git.js";
20
+ import { syncTaskWorktreesWithIntegrationTargets, } from "../repo-integration-sync.js";
15
21
  import { findExecWorktree, resolveWorktreeBase } from "../worktree.js";
16
- import { configuredProductRepos, withProductWorktrees } from "../task-repos.js";
17
- import { parentValidationPoolPath, resolveParentValidationConcurrency, } from "../parent-validation.js";
18
- import { loadPipelineResumeCheckpoint } from "../pipeline-state.js";
19
- import { loadRegisterResumeCandidates, selectScheduleExecutorResume, } from "../register-resume.js";
20
- import { buildTaskPhaseMap, configuredWorktreeBase, parseParallel, resolveExecDefaultsPath, withProjectExecRunLock, } from "./shared.js";
22
+ import { currentBranch, isExecBranchMergedIntoCurrent } from "../worktree-ops.js";
21
23
  import { loadRosterForExecutionPath, pathInsideWorktree } from "./agent.js";
24
+ import { collectExecLockUsage, execLocksDir, formatExecLockUsage } from "./lock.js";
25
+ import { spawnBlock, spawnIndexBuild, spawnRefresh, spawnValidate, stageActorMeta, } from "./mode-shared.js";
26
+ import { rebuildStaleGeneratedTracksForCycle, resolveClaimingActor, runBatchMode, } from "./schedule-mode.js";
22
27
  import { findClaimEventPath, prepareSingleTask, } from "./schedule-prepare.js";
23
28
  import { runPreparedTask } from "./schedule-task.js";
24
- import { rebuildStaleGeneratedTracksForCycle, resolveClaimingActor, runBatchMode, } from "./schedule-mode.js";
25
- import { spawnBlock, spawnIndexBuild, spawnRefresh, spawnValidate } from "./mode-shared.js";
29
+ import { withTrailingRunRecords } from "./trailing-records.js";
30
+ import { branchOwnedRunRecordPaths } from "../trailing-records.js";
31
+ import { repoRelative } from "../../shared/git.js";
32
+ import { buildTaskPhaseMap, configuredWorktreeBase, parseParallel, resolveExecDefaultsPath, withProjectExecRunLock, } from "./shared.js";
26
33
  // 同じ project の exec run が共有する枠(主 run・--join run・register lifecycle・provider の
27
34
  // max_concurrency・親検証)の上限と現在の使用数を表示する。ロックは取得しない。
28
35
  export function formatExecSlotsReport(executionPath, execDefaults) {
@@ -58,7 +65,7 @@ export function formatExecSlotsReport(executionPath, execDefaults) {
58
65
  }
59
66
  export function registerSlotsCommand(exec) {
60
67
  const cmd = exec
61
- .command("slots")
68
+ .command("slots", { hidden: true })
62
69
  .description("Show the limits and current usage of the slots shared by concurrent exec runs of a project");
63
70
  cmd.option("--project <projectId>", "Project id in .specdojo/specdojo.config.json");
64
71
  cmd.option("--exec-defaults <path>", "Path to exec-defaults.yaml global config (default: .specdojo/exec-defaults.yaml)");
@@ -153,7 +160,7 @@ export async function runCycleMode(opts) {
153
160
  // Step 4/5: validate + refresh schedule state before selecting Ready tasks.
154
161
  process.stdout.write("[cycle] step 4/5: validate + refresh schedule state\n");
155
162
  if (dryRun) {
156
- process.stdout.write(" [dry-run] specdojo exec validate\n");
163
+ process.stdout.write(" [dry-run] specdojo exec validate --schedule-only\n");
157
164
  process.stdout.write(" [dry-run] specdojo exec refresh\n");
158
165
  stepOutcomes.push("refresh=success");
159
166
  }
@@ -231,7 +238,7 @@ export function registerCycleCommand(exec) {
231
238
  cmd.option("--dry-run", "Print resolved steps without executing", false);
232
239
  cmd.action(async (opts) => {
233
240
  try {
234
- await withProjectExecRunLock(opts, "cycle", () => runCycleMode(opts));
241
+ await withProjectExecRunLock(opts, "cycle", () => withTrailingRunRecords(opts, "cycle", () => runCycleMode(opts)));
235
242
  }
236
243
  catch (error) {
237
244
  const message = error instanceof Error ? error.message : String(error);
@@ -267,23 +274,27 @@ export function prepareScheduleIntegrationResume(params) {
267
274
  checkpoint.state.stages.reporter.status !== "succeeded") {
268
275
  throw new Error(`integration resume requires succeeded executor and reporter stages for ${task.id}`);
269
276
  }
270
- const resultPath = join(executionPath, "exec", "results", `${task.id}-result.md`);
277
+ const resultPath = recordPathForRead(executionPath, "result", task.id);
271
278
  const worktreeResultPath = pathInsideWorktree(repoRoot, worktree.path, resultPath);
272
279
  if (!existsSync(resultPath) || !existsSync(worktreeResultPath)) {
273
280
  throw new Error(`result is missing for integration resume: ${task.id}-result.md`);
274
281
  }
275
282
  // 統合再開でも、root に未 commit のまま残る claim / plan / result の作業コピーを merge 前に
276
283
  // 解放できるよう、通常実行と同じ checkpoint パスを持たせる。
277
- const claimEventPath = findClaimEventPath(schedulePath, task.id);
278
- const checkpointPaths = [
279
- join(executionPath, "exec", "plans", `${task.id}-plan.md`),
284
+ const claimEventPath = findClaimEventPath(schedulePath, task.id, {
285
+ repoRoot,
286
+ worktreePath: worktree.path,
287
+ });
288
+ const checkpointPaths = withPlanConventionsFiles([
289
+ recordPathForRead(executionPath, "plan", task.id),
280
290
  resultPath,
281
291
  ...(claimEventPath ? [claimEventPath] : []),
282
292
  ...gradeCheckpointPaths({ repoRoot, executionPath }),
283
- ];
293
+ ]);
284
294
  return {
285
295
  task,
286
296
  actor,
297
+ claimActor: claimOwnerOf(taskState) ?? actor,
287
298
  agentCandidates: [],
288
299
  plan: "",
289
300
  prompt: "",
@@ -296,6 +307,74 @@ export function prepareScheduleIntegrationResume(params) {
296
307
  pipelineStateRef: stateRef,
297
308
  };
298
309
  }
310
+ // 統合の段(reporter の後の commit・検査・merge)まで進んでから止まった run か。
311
+ function stoppedInIntegration(state) {
312
+ return (state.stages.reporter.status === "succeeded" || (state.stages.integrate?.attempts ?? 0) > 0);
313
+ }
314
+ // task 自身の run の記録(repo 相対)。block の後の記帳 commit(PJR-DVNV)が統合先へ入れた
315
+ // 作業コピーは、exec branch 側の同じ記録と両側の追加として競合する。再開の取り込みでは exec branch
316
+ // 側を採る。統合の merge と同じ向きで、再開した executor はこの記録を引き継いで書き直し、後の統合も
317
+ // 統合先の側に変更が無いため競合しない。
318
+ function taskRunRecordPaths(params) {
319
+ const paths = params.branches.flatMap((branch) => branchOwnedRunRecordPaths({ ...params, branch }).map((path) => repoRelative(params.repoRoot, path)));
320
+ return [...new Set(paths)].sort();
321
+ }
322
+ // 統合の段で止まった task を executor へ戻す前の準備(PJR-ED0K)。worktree が merge の途中なら、
323
+ // 解消に `git merge --abort` が要り stage 済みの成果を失うため、状態を変えずに止める。止まって
324
+ // いなければ、統合先(project は root の現在ブランチ)の直しを exec branch へ取り込む。
325
+ // 未 commit の成果と run の記録は取り込みの前に控えて戻し、戻せない場合は取り込み前へ戻して止める。
326
+ export function prepareExecutorResumeFromIntegration(params) {
327
+ const { taskId, worktree, repoRoot } = params;
328
+ const context = {
329
+ repoRoot,
330
+ schedulePath: params.schedulePath,
331
+ executionPath: params.executionPath,
332
+ };
333
+ if (isExecBranchMergedIntoCurrent({ context, worktree })) {
334
+ throw new Error(`cannot resume the executor for ${taskId}: ${worktree.branch} is already merged; ` +
335
+ `run exec resume --task ${taskId} to finish the integration cleanup`);
336
+ }
337
+ const merging = [
338
+ ...(worktree.repos ?? [])
339
+ .filter((product) => existsSync(product.path) && mergeInProgress(product.path))
340
+ .map((product) => product.name),
341
+ ...(mergeInProgress(worktree.path) ? [PROJECT_REPO_NAME] : []),
342
+ ];
343
+ if (merging.length > 0) {
344
+ throw new Error(`cannot resume the executor for ${taskId}: a merge is in progress in ${merging.join(", ")} ` +
345
+ `(${worktree.path}); aborting it would discard staged changes. Commit or resolve the ` +
346
+ `merge in the worktree, then run exec resume --task ${taskId} --resume-from executor again`);
347
+ }
348
+ if (params.dryRun)
349
+ return [];
350
+ process.stdout.write(` Syncing integration targets before executor resume: ${taskId}\n`);
351
+ let synced;
352
+ try {
353
+ const projectTarget = currentBranch(repoRoot);
354
+ synced = syncTaskWorktreesWithIntegrationTargets({
355
+ worktree,
356
+ projectTarget,
357
+ message: `exec(${taskId}): merge integration target before executor resume`,
358
+ projectOursPaths: taskRunRecordPaths({
359
+ repoRoot,
360
+ executionPath: params.executionPath,
361
+ branches: [worktree.branch, projectTarget],
362
+ taskId,
363
+ }),
364
+ integratedProducts: integratedRepoNames(params.state),
365
+ });
366
+ }
367
+ catch (error) {
368
+ throw new Error(`cannot sync the worktree with the integration target before executor resume of ` +
369
+ `${taskId}: ${error instanceof Error ? error.message : String(error)}; ` +
370
+ `resolve it in ${worktree.path} and run exec resume --task ${taskId} --resume-from executor again`, { cause: error });
371
+ }
372
+ for (const entry of synced) {
373
+ process.stdout.write(` [sync] ${entry.repo}: ${entry.status} (${entry.target})` +
374
+ `${entry.detail ? ` — ${entry.detail}` : ""}\n`);
375
+ }
376
+ return synced;
377
+ }
299
378
  function validateScheduleResumeOptions(opts) {
300
379
  if (opts.resumeFrom !== undefined) {
301
380
  if (opts.resumeFrom !== "executor")
@@ -330,6 +409,10 @@ export async function runResumeMode(opts) {
330
409
  const events = readAllEventFiles(schedulePath);
331
410
  const initTasks = buildInitialStateFromStrategy(schedulePath, schedule);
332
411
  let snapshot = foldEventsToState(events, schedule, schedulePath, initTasks);
412
+ const initialTaskStates = new Map(Object.entries(snapshot.tasks).map(([id, state]) => [
413
+ id,
414
+ { ...state, ...(state.meta ? { meta: { ...state.meta } } : {}) },
415
+ ]));
333
416
  let doingIds;
334
417
  let executorResume;
335
418
  let executorWorktree;
@@ -341,12 +424,14 @@ export async function runResumeMode(opts) {
341
424
  if (!task.agent_pipeline)
342
425
  throw new Error("--resume-from requires an agent_pipeline task.");
343
426
  const taskState = snapshot.tasks[opts.task];
344
- if (taskState?.meta?.pipeline_stage === "integrate") {
345
- throw new Error("cannot resume the executor from the integrate stage");
346
- }
427
+ const blockedStage = taskState?.state === "blocked" ? taskState.meta?.pipeline_stage : undefined;
428
+ // A blocked executor stage is accepted here; selectScheduleExecutorResume admits it only when
429
+ // the runner rejected the executor report before the reporter (PJR-1GCD).
347
430
  if (taskState?.state !== "doing" &&
348
- !(taskState?.state === "blocked" && taskState.meta?.pipeline_stage === "reporter")) {
349
- throw new Error("--resume-from executor requires a doing task or a blocked reporter stage.");
431
+ blockedStage !== "reporter" &&
432
+ blockedStage !== "integrate" &&
433
+ blockedStage !== "executor") {
434
+ throw new Error("--resume-from executor requires a doing task or a blocked reporter, integrate, or executor stage.");
350
435
  }
351
436
  const worktreeTaskId = qualifyTaskId(projectId, opts.task);
352
437
  const found = findExecWorktree(repoRoot, worktreeTaskId);
@@ -364,6 +449,17 @@ export async function runResumeMode(opts) {
364
449
  throw new Error("no executor stage to resume");
365
450
  executorResume = lookup.target;
366
451
  executorWorktree = withProductWorktrees(found, configuredProductRepos(schedulePath), worktreeTaskId);
452
+ if (stoppedInIntegration(executorResume.state)) {
453
+ prepareExecutorResumeFromIntegration({
454
+ taskId: opts.task,
455
+ worktree: executorWorktree,
456
+ state: executorResume.state,
457
+ repoRoot,
458
+ schedulePath,
459
+ executionPath,
460
+ dryRun,
461
+ });
462
+ }
367
463
  }
368
464
  if (opts.due) {
369
465
  let lockDir = "";
@@ -425,7 +521,7 @@ export async function runResumeMode(opts) {
425
521
  blockedPipelineStage === "integrate") &&
426
522
  typeof taskState.meta?.pipeline_state_ref === "string";
427
523
  if (canResumeBlockedPipeline) {
428
- const actor = taskState.last_by ?? opts.by ?? "exec-pipeline-resume";
524
+ const actor = claimOwnerOf(taskState) ?? opts.by ?? "exec-pipeline-resume";
429
525
  if (!dryRun) {
430
526
  const resumeMeta = {
431
527
  ...taskState.meta,
@@ -447,7 +543,7 @@ export async function runResumeMode(opts) {
447
543
  : "resume executor from persisted pipeline state",
448
544
  meta,
449
545
  });
450
- if (executorResume)
546
+ if (executorResume || opts.executorBy)
451
547
  pendingExecutorUnblock = event;
452
548
  else
453
549
  writeEventFile(schedulePath, event);
@@ -483,11 +579,12 @@ export async function runResumeMode(opts) {
483
579
  try {
484
580
  const task = buildTaskView(schedulePath, executionPath, taskId);
485
581
  const resolved = resolveClaimingActor(snapshot.tasks[taskId], opts.by);
486
- const prepared = snapshot.tasks[taskId]?.meta?.pipeline_stage === "integrate"
582
+ // --resume-from executor は統合の段で止まった task でも executor から再実行する。
583
+ const prepared = !executorResume && snapshot.tasks[taskId]?.meta?.pipeline_stage === "integrate"
487
584
  ? prepareScheduleIntegrationResume({
488
585
  task,
489
586
  taskState: snapshot.tasks[taskId],
490
- actor: resolved.actor ?? snapshot.tasks[taskId]?.last_by ?? "exec-pipeline-resume",
587
+ actor: resolved.actor ?? claimOwnerOf(snapshot.tasks[taskId]) ?? "exec-pipeline-resume",
491
588
  projectId,
492
589
  repoRoot,
493
590
  executionPath,
@@ -511,9 +608,61 @@ export async function runResumeMode(opts) {
511
608
  : {}),
512
609
  }, opts);
513
610
  if (typeof prepared !== "string") {
514
- if (pendingExecutorUnblock) {
515
- writeEventFile(schedulePath, pendingExecutorUnblock);
611
+ const priorTaskState = initialTaskStates.get(taskId);
612
+ const previousActor = claimOwnerOf(priorTaskState);
613
+ const resumingExecutorStage = prepared.pipelineResumeStage !== "reporter" &&
614
+ prepared.pipelineResumeStage !== "integrate";
615
+ if (resumingExecutorStage &&
616
+ previousActor &&
617
+ prepared.actor &&
618
+ prepared.actor !== previousActor) {
619
+ if (!dryRun) {
620
+ const releaseEvent = buildEvent("release", {
621
+ task: taskId,
622
+ by: previousActor,
623
+ msg: opts.resumeFrom === "executor"
624
+ ? `release claim to switch executor to ${prepared.actor} (--resume-from executor)`
625
+ : `release claim to switch executor to ${prepared.actor}`,
626
+ meta: ["pipeline_resume_released=true", `replaced_by=${prepared.actor}`],
627
+ });
628
+ const resumeMeta = {
629
+ ...(priorTaskState?.meta ?? {}),
630
+ ...(executorResume
631
+ ? { pipeline_stage: "executor", pipeline_state_ref: executorResume.stateRef }
632
+ : {}),
633
+ pipeline_resume_claimed: "true",
634
+ previous_actor: previousActor,
635
+ };
636
+ const meta = Object.entries(resumeMeta).map(([key, value]) => `${key}=${String(value)}`);
637
+ const claimEvent = buildEvent("claim", {
638
+ task: taskId,
639
+ by: prepared.actor,
640
+ msg: opts.resumeFrom === "executor"
641
+ ? `claim task as resumed executor ${prepared.actor} (--resume-from executor)`
642
+ : `claim task as resumed executor ${prepared.actor}`,
643
+ meta,
644
+ });
645
+ writeEventFile(schedulePath, releaseEvent);
646
+ writeEventFile(schedulePath, claimEvent);
647
+ }
516
648
  pendingExecutorUnblock = undefined;
649
+ snapshot.tasks[taskId] = {
650
+ ...snapshot.tasks[taskId],
651
+ state: "doing",
652
+ last_by: prepared.actor,
653
+ claimed_by: prepared.actor,
654
+ last_type: "claim",
655
+ };
656
+ prepared.claimActor = prepared.actor;
657
+ }
658
+ else {
659
+ if (pendingExecutorUnblock) {
660
+ if (!dryRun)
661
+ writeEventFile(schedulePath, pendingExecutorUnblock);
662
+ pendingExecutorUnblock = undefined;
663
+ }
664
+ // The claim stays with its holder when --by or a stage override runs another agent.
665
+ prepared.claimActor = snapshot.tasks[taskId]?.last_by ?? prepared.claimActor;
517
666
  }
518
667
  const attempts = snapshot.tasks[taskId]?.meta?.limit_attempts;
519
668
  prepared.priorLimitAttempts =
@@ -529,7 +678,7 @@ export async function runResumeMode(opts) {
529
678
  const message = error instanceof Error ? error.message : String(error);
530
679
  process.stderr.write(`[resume] setup error for ${taskId}: ${message}\n`);
531
680
  if (opts.due && !dryRun) {
532
- spawnBlock(projectId, taskId, snapshot.tasks[taskId]?.last_by ?? "exec-limit-resume", `resume setup error: ${message}`);
681
+ spawnBlock(projectId, taskId, claimOwnerOf(snapshot.tasks[taskId]) ?? "exec-limit-resume", `resume setup error: ${message}`);
533
682
  }
534
683
  process.exitCode = 1;
535
684
  }
@@ -546,7 +695,10 @@ export async function runResumeMode(opts) {
546
695
  const completedAt = new Date().toISOString();
547
696
  if (prepared.resultPath)
548
697
  await updateResultStatus(prepared.resultPath, "blocked", completedAt);
549
- spawnBlock(projectId, prepared.task.id, prepared.actor, `runner error: ${message}`);
698
+ spawnBlock(projectId, prepared.task.id, prepared.claimActor, `runner error: ${message}`, {
699
+ limit_deferred: "false",
700
+ ...stageActorMeta(prepared.claimActor, prepared.actor),
701
+ });
550
702
  }
551
703
  process.exitCode = 1;
552
704
  }
@@ -590,7 +742,7 @@ export function registerResumeCommand(exec) {
590
742
  process.exitCode = 1;
591
743
  return;
592
744
  }
593
- await withProjectExecRunLock(opts, "resume", () => runResumeMode(opts));
745
+ await withProjectExecRunLock(opts, "resume", () => withTrailingRunRecords(opts, "resume", () => runResumeMode(opts)));
594
746
  }
595
747
  catch (error) {
596
748
  const message = error instanceof Error ? error.message : String(error);
@@ -17,6 +17,15 @@ export class ExecRunBusyError extends Error {
17
17
  this.name = "ExecRunBusyError";
18
18
  }
19
19
  }
20
+ export class ExecRunLockTimeoutError extends ExecRunBusyError {
21
+ waitTimeoutMs;
22
+ constructor(lockDir, owner, waitTimeoutMs) {
23
+ super(lockDir, owner);
24
+ this.waitTimeoutMs = waitTimeoutMs;
25
+ this.name = "ExecRunLockTimeoutError";
26
+ this.message = `Exec lock wait timed out after ${waitTimeoutMs} ms.\n${this.message}`;
27
+ }
28
+ }
20
29
  export function execLocksDir(executionPath) {
21
30
  return join(executionPath, "exec", ".locks");
22
31
  }
@@ -81,7 +90,16 @@ export async function acquireExecRunLock(executionPath, opts) {
81
90
  const staleMs = opts.staleMs ?? EXEC_RUN_LOCK_STALE_MS;
82
91
  const pollMs = opts.pollMs ?? LOCK_POLL_MS;
83
92
  let waitingAnnounced = false;
93
+ if (opts.waitTimeoutMs !== undefined &&
94
+ (!Number.isFinite(opts.waitTimeoutMs) || opts.waitTimeoutMs < 0))
95
+ throw new Error("waitTimeoutMs must be a finite non-negative number");
96
+ const deadline = opts.waitTimeoutMs === undefined ? Infinity : Date.now() + opts.waitTimeoutMs;
97
+ let firstAttempt = true;
84
98
  while (true) {
99
+ if (!firstAttempt && opts.ifBusy === "wait" && Date.now() >= deadline) {
100
+ throw new ExecRunLockTimeoutError(execRunLockPath(executionPath), describeHolders(executionPath, staleMs), opts.waitTimeoutMs);
101
+ }
102
+ firstAttempt = false;
85
103
  const handle = opts.join
86
104
  ? tryAcquireJoin(executionPath, opts, opts.join.limit, staleMs)
87
105
  : tryAcquireExclusive(executionPath, opts, staleMs);
@@ -96,7 +114,10 @@ export async function acquireExecRunLock(executionPath, opts) {
96
114
  opts.onWait?.();
97
115
  waitingAnnounced = true;
98
116
  }
99
- await delay(pollMs);
117
+ if (Date.now() >= deadline) {
118
+ throw new ExecRunLockTimeoutError(execRunLockPath(executionPath), describeHolders(executionPath, staleMs), opts.waitTimeoutMs);
119
+ }
120
+ await delay(Math.min(pollMs, Math.max(0, deadline - Date.now())));
100
121
  }
101
122
  }
102
123
  export function releaseExecRunLock(handle) {
@@ -1,16 +1,19 @@
1
1
  import { spawnSync } from "node:child_process";
2
2
  import { existsSync } from "node:fs";
3
- import { dirname, join, relative, sep } from "node:path";
3
+ import { relative, sep } from "node:path";
4
4
  import { selfRunArgs } from "../../shared/spawn-self.js";
5
5
  import { specdojoRootDir } from "../../shared/specdojo-config.js";
6
6
  import { readPipelineState, updatePipelineRepoIntegration, updatePipelineStage, writePipelineState, } from "../pipeline-state.js";
7
+ import { runLogPath } from "../run-records.js";
7
8
  export function spawnSelf(args, cwd = specdojoRootDir()) {
8
9
  const [exe, fullArgs] = selfRunArgs(args);
9
10
  const result = spawnSync(exe, fullArgs, { stdio: "inherit", cwd });
10
11
  return result.status === 0;
11
12
  }
12
13
  export function spawnValidate(projectId) {
13
- const args = ["exec", "validate"];
14
+ // Run records can still be incomplete at startup or resume, and the run lock is held.
15
+ // Audit persisted records explicitly or in CI, independently of schedule readiness.
16
+ const args = ["exec", "validate", "--schedule-only"];
14
17
  if (projectId)
15
18
  args.push("--project", projectId);
16
19
  return spawnSelf(args);
@@ -82,6 +85,11 @@ export function pipelineRecoveryMeta(input) {
82
85
  ...(input.runId ? { pipeline_run_id: input.runId } : {}),
83
86
  };
84
87
  }
88
+ // The runner blocks a failed task as the actor holding its claim, because another agent may have
89
+ // run the failed stage (fallback, --executor-by, --reporter-by). Record both actors on the event.
90
+ export function stageActorMeta(claimActor, stageActor) {
91
+ return { claim_actor: claimActor, stage_actor: stageActor || claimActor };
92
+ }
85
93
  export function spawnBlock(projectId, taskId, by, reason, meta = { limit_deferred: "false" }) {
86
94
  const args = ["exec", "block", "--task", taskId, "--by", by, "--msg", reason];
87
95
  for (const [key, value] of Object.entries(meta))
@@ -136,5 +144,5 @@ export function recordRepoIntegration(statePath, repo, patch) {
136
144
  }
137
145
  }
138
146
  export function integrateLogPath(statePath) {
139
- return statePath ? join(dirname(statePath), "integrate.log") : undefined;
147
+ return statePath ? runLogPath(statePath, "integrate.log") : undefined;
140
148
  }
@@ -1,15 +1,17 @@
1
- import { parseProductBranchOverrides } from "../product-branches.js";
2
1
  import { loadExecDefaultsConfig, resolveRegisterPostReview } from "../agent-config.js";
2
+ import { parseProductBranchOverrides } from "../product-branches.js";
3
3
  import { resolveProjectPaths } from "../project.js";
4
4
  import { isRegisterFailureMode } from "../register.js";
5
5
  import { configuredProductRepos } from "../task-repos.js";
6
- import { EXCLUSIVE_EXEC_RUN, parseParallel, resolveExecDefaultsPath, resolveRegisterWorktree, withProjectExecRunLock, } from "./shared.js";
7
- import { runBatchMode, runManualMode } from "./schedule-mode.js";
8
6
  import { runInPlaceMode } from "./in-place.js";
9
- import { runJobMode } from "./job.js";
7
+ import { runJobWithProjectLock } from "./job-lock.js";
10
8
  import { spawnRefresh, spawnValidate } from "./mode-shared.js";
11
9
  import { resolveRegisterPipelineCommand } from "./register-core.js";
12
10
  import { runRegisterMode } from "./register-mode.js";
11
+ import { runBatchMode, runManualMode } from "./schedule-mode.js";
12
+ import { EXCLUSIVE_EXEC_RUN, parseParallel, resolveExecDefaultsPath, resolveRegisterWorktree, withProjectExecRunLock, } from "./shared.js";
13
+ import { withTrailingRunRecords } from "./trailing-records.js";
14
+ import { parseUnknownScopePolicy } from "./change-scope.js";
13
15
  export function registerRunCommand(exec) {
14
16
  const rcmd = exec
15
17
  .command("run")
@@ -40,10 +42,11 @@ export function registerRunCommand(exec) {
40
42
  rcmd.option("--worktree", "Use a git worktree and integrate back (requires --task, --register, or --job; Job runs are committed and reviewed before merge)", false);
41
43
  rcmd.option("--in-place", "Run a register item in the current working tree (overrides run.register_execution; cannot be combined with --worktree)", false);
42
44
  rcmd.option("--track-state", "Record claim/complete events (requires --task; --by optional, actor auto-derived from the resolved agent)", false);
43
- rcmd.option("--archive-on-success", "Archive the generated plan to exec/plans/done/ after a successful in-place run", false);
45
+ rcmd.option("--archive-on-success", "Keep the completed plan in its run directory after a successful in-place run", false);
44
46
  rcmd.option("--integration-branch <repo=branch>", "With register worktree mode: integrate the declared product repository <repo> into the local branch <branch> for this run (repeatable; overrides repos[].integration_branch; resume reuses the value recorded at the start)", (value, previous = []) => [...previous, value]);
45
47
  rcmd.option("--branch <repo=name>", "With register worktree mode: override a declared product work branch (repeatable; resume keeps the recorded branch)", (value, previous = []) => [...previous, value]);
46
48
  rcmd.option("--parallel <n>", "Number of worktree instances to run in parallel", "1");
49
+ rcmd.option("--unknown-scope <policy>", "Items with an unknown change scope: parallel|serialize (default: parallel)");
47
50
  rcmd.option("--worktree-base <path>", "Override worktree base directory");
48
51
  rcmd.option("--strategy <s>", "Task selection strategy: critical-first|fifo (default: critical-first)");
49
52
  rcmd.option("--loop", "Repeat rounds until no ready tasks remain, rebuilding doc-index and running exec refresh between rounds", false);
@@ -62,6 +65,7 @@ export function registerRunCommand(exec) {
62
65
  rcmd.option("--dry-run", "Print resolved command without executing", false);
63
66
  rcmd.action(async (opts) => {
64
67
  try {
68
+ parseUnknownScopePolicy(opts.unknownScope);
65
69
  const isAuto = !!opts.auto;
66
70
  const hasTask = !!opts.task;
67
71
  const hasDeliverable = !!opts.deliverable;
@@ -245,6 +249,10 @@ export function registerRunCommand(exec) {
245
249
  }
246
250
  // register worktree 実行だけが共有資源をプロセス横断で統制するため、後から --join する
247
251
  // run を受け入れる。それ以外の run は従来どおり project 全体を排他する。
252
+ if (hasJob) {
253
+ await runJobWithProjectLock(opts, resolveRegisterPipelineCommand);
254
+ return;
255
+ }
248
256
  const registerWorktreeLockSharing = hasRegister && opts.worktree ? { shareable: true, join: !!opts.join } : EXCLUSIVE_EXEC_RUN;
249
257
  await withProjectExecRunLock(opts, "run", async () => {
250
258
  // Register-item run: use the configured location or an explicit CLI override, with state tracked
@@ -253,10 +261,6 @@ export function registerRunCommand(exec) {
253
261
  await runRegisterMode(opts);
254
262
  return;
255
263
  }
256
- if (hasJob) {
257
- await runJobMode(opts, resolveRegisterPipelineCommand);
258
- return;
259
- }
260
264
  // In-place manual run (default): generate the plan on demand and run in the
261
265
  // current repository. No validate/refresh pass — that is orchestration only.
262
266
  if (isManual && !opts.worktree) {
@@ -276,12 +280,7 @@ export function registerRunCommand(exec) {
276
280
  return;
277
281
  }
278
282
  process.stdout.write("[run] refresh: ok\n");
279
- if (isBatch) {
280
- await runBatchMode(opts);
281
- }
282
- else {
283
- await runManualMode(opts);
284
- }
283
+ await withTrailingRunRecords(opts, "run", () => isBatch ? runBatchMode(opts) : runManualMode(opts));
285
284
  }, registerWorktreeLockSharing);
286
285
  }
287
286
  catch (error) {
@@ -1,22 +1,25 @@
1
- import { registerDependencyBlockReason } from "../../register/dependency.js";
1
+ import { readPlanFile } from "../../shared/plan-conventions.js";
2
2
  import { existsSync, readFileSync } from "node:fs";
3
- import { basename } from "node:path";
4
- import { resolveMemberCommand, } from "../agent-config.js";
3
+ import { basename, dirname } from "node:path";
4
+ import { isAuthoringApproach } from "../../kata/authoring.js";
5
+ import { registerDependencyBlockReason } from "../../register/dependency.js";
6
+ import { registerEventFilePath } from "../../register/events.js";
7
+ import { displayIdFromTicketFilename } from "../../register/item.js";
5
8
  import { resolveAgentMember, } from "../../shared/specdojo-config.js";
9
+ import { resolveMemberCommand, } from "../agent-config.js";
6
10
  import { buildInPlaceStem } from "../plans.js";
7
11
  import { generateRegisterPlan, normalizePjrId, requireRunnableRegisterItem, resolveRegisterRunTarget, sanitizeRegisterConclusion, selectRegisterCommitPaths, selectRegisterRunArtifactResidue, ticketPathFromItem, } from "../register.js";
8
- import { registerEventFilePath } from "../../register/events.js";
9
- import { displayIdFromTicketFilename } from "../../register/item.js";
10
12
  import { isResultUnfilled, readResultFrontmatterSnapshot, scaffoldResult, updateResultStatus, } from "../results.js";
11
- import { formatGitResultFailure, gitOutput, gitResult } from "../worktree.js";
13
+ import { recordRef } from "../run-records.js";
14
+ import { configuredProductCheckouts } from "../task-repos.js";
12
15
  import { stabilizeCommitTargets, stageCommitTargets, unstageCommitTargets, worktreeStatusPaths, } from "../worktree-ops.js";
13
- import { resolveAgentOverride, resolvePinnedRateLimitRunOptions, rateLimitRecoveryReason, selectCandidates, } from "./shared.js";
14
- import { expandPromptRefs } from "./agent.js";
16
+ import { formatGitResultFailure, gitOutput, gitResult } from "../worktree.js";
15
17
  import { runAgentPipeline } from "./agent-pipeline.js";
18
+ import { expandPromptRefs } from "./agent.js";
19
+ import { planConventionsFiles } from "../../shared/plan-conventions.js";
16
20
  import { spawnAgentInPlace } from "./in-place.js";
17
21
  import { commitSubject, repoRelativePath, spawnSelf } from "./mode-shared.js";
18
- import { isAuthoringApproach } from "../../kata/authoring.js";
19
- import { configuredProductCheckouts } from "../task-repos.js";
22
+ import { rateLimitRecoveryReason, resolveAgentOverride, resolvePinnedRateLimitRunOptions, selectCandidates, } from "./shared.js";
20
23
  // CLI choices are the highest-priority layer. A difficulty route only supplies omitted stage and
21
24
  // recovery options; without a matching route the historical priority-based selection is kept.
22
25
  export function applyRegisterDifficultyRouting(item, opts, execDefaults) {
@@ -214,7 +217,10 @@ export function registerRunnerManagedPaths(repoRoot, registerPaths, planPath, re
214
217
  // 状態遷移の書き込み先は個票(正本)。pjr-index と派生ビューは生成物として同時に更新される。
215
218
  // 移行完了後の pjr-index.md は非追跡の生成物になり存在しないため、存在する場合のみ対象に含める
216
219
  // (存在しないパスを git add すると pathspec エラーになる)。
217
- const managed = [planPath, resultPath, ...additionalManagedPaths];
220
+ const versions = existsSync(planPath)
221
+ ? planConventionsFiles(readFileSync(planPath, "utf8"), dirname(planPath))
222
+ : [];
223
+ const managed = [planPath, resultPath, ...versions, ...additionalManagedPaths];
218
224
  if (existsSync(registerPaths.pjrIndexPath))
219
225
  managed.push(registerPaths.pjrIndexPath);
220
226
  if (ticketPath)
@@ -289,14 +295,14 @@ export async function runSingleRegisterItem(context, opts, pjrId) {
289
295
  item,
290
296
  stem,
291
297
  });
292
- const prompt = expandPromptRefs(readFileSync(planPath, "utf8"));
298
+ const prompt = expandPromptRefs(readPlanFile(planPath));
293
299
  const { resultPath, supersededPaths } = await scaffoldResult({
294
300
  executionPath,
295
301
  taskId: item.id,
296
302
  mode: "edit",
297
303
  projectId,
298
304
  origin: "register",
299
- planRef: `exec/plans/${stem}-plan.md`,
305
+ planRef: recordRef(executionPath, planPath),
300
306
  agent: actor,
301
307
  startedAt: new Date().toISOString(),
302
308
  stem,
@@ -328,6 +334,7 @@ export async function runSingleRegisterItem(context, opts, pjrId) {
328
334
  executor: pipelineAgents.executor,
329
335
  reporterCandidates: pipelineAgents.reporterCandidates,
330
336
  planPath,
337
+ runId: stem,
331
338
  planPrompt: prompt,
332
339
  resultPath,
333
340
  registerPaths: registerReporterManagedPaths(registerPaths),