specdojo 0.3.1 → 0.4.1

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 (260) hide show
  1. package/.github/agents/specdojo-orchestrator.md +61 -2
  2. package/CHANGELOG.md +90 -0
  3. package/README.md +85 -25
  4. package/dist/{catalog-build-references.js → catalog/build-references.js} +4 -4
  5. package/dist/catalog/build-render.js +32 -0
  6. package/dist/{catalog-build.js → catalog/build.js} +9 -9
  7. package/dist/{catalog.js → catalog/catalog.js} +10 -10
  8. package/dist/{catalog-generate.js → catalog/generate.js} +8 -8
  9. package/dist/catalog/paths.js +1 -0
  10. package/dist/{catalog-plan-generate.js → catalog/plan-generate.js} +4 -4
  11. package/dist/{catalog-plan.js → catalog/plan.js} +4 -4
  12. package/dist/{catalog-scaffold.js → catalog/scaffold.js} +3 -3
  13. package/dist/{agent.js → commands/agent.js} +11 -11
  14. package/dist/{build-command.js → commands/build.js} +2 -2
  15. package/dist/{init-command.js → commands/init.js} +168 -45
  16. package/dist/commands/night-orchestrator.js +287 -0
  17. package/dist/{orchestrator.js → commands/orchestrator.js} +12 -5
  18. package/dist/{watch.js → commands/watch.js} +3 -3
  19. package/dist/{dashboard-timeline.js → dashboard/dashboard-timeline.js} +2 -2
  20. package/dist/{dashboard.js → dashboard/dashboard.js} +11 -10
  21. package/dist/{dashboard-exec-records.js → dashboard/exec-records.js} +2 -2
  22. package/dist/{dashboard-routines.js → dashboard/routines.js} +6 -5
  23. package/dist/{dashboard-shared.js → dashboard/shared.js} +1 -1
  24. package/dist/{timeline-build.js → dashboard/timeline-build.js} +2 -1
  25. package/dist/{timeline.js → dashboard/timeline.js} +1 -1
  26. package/dist/{deliverable.js → deliverable/deliverable.js} +5 -5
  27. package/dist/{deliverable-trash.js → deliverable/trash.js} +5 -5
  28. package/dist/{devcontainer-command.js → devcontainer/command.js} +8 -4
  29. package/dist/devcontainer/scaffold.js +418 -0
  30. package/dist/{doc-index.js → docs/doc-index.js} +1 -1
  31. package/dist/{frontmatter-namespace.js → docs/frontmatter-namespace.js} +1 -1
  32. package/dist/{index-command.js → docs/index-command.js} +1 -1
  33. package/dist/docs/template-resolution.js +1 -0
  34. package/dist/{viewpoint-document-kinds-check.js → docs/viewpoint-document-kinds-check.js} +1 -1
  35. package/dist/{yaml-pages-command.js → docs/yaml-pages-command.js} +1 -1
  36. package/dist/{yaml-pages.js → docs/yaml-pages.js} +2 -2
  37. package/dist/{exec-agent-config.js → exec/agent-config.js} +92 -5
  38. package/dist/{exec-agent-git-state.js → exec/agent-git-state.js} +1 -1
  39. package/dist/{exec-agent-protected-config.js → exec/agent-protected-config.js} +1 -1
  40. package/dist/{exec-commands.js → exec/commands.js} +22 -18
  41. package/dist/{exec-core.js → exec/core.js} +11 -11
  42. package/dist/{exec-events.js → exec/events.js} +2 -2
  43. package/dist/{exec-evidence.js → exec/evidence.js} +11 -6
  44. package/dist/exec/exec.js +2 -0
  45. package/dist/exec/format.js +1 -0
  46. package/dist/{exec-handoff.js → exec/handoff.js} +13 -12
  47. package/dist/{exec-limit.js → exec/limit.js} +93 -12
  48. package/dist/{exec-parent-validation.js → exec/parent-validation.js} +18 -4
  49. package/dist/{exec-pipeline-state.js → exec/pipeline-state.js} +29 -2
  50. package/dist/{exec-plans-core.js → exec/plans-core.js} +68 -114
  51. package/dist/{exec-plans-generation.js → exec/plans-generation.js} +53 -10
  52. package/dist/{exec-plans-storage.js → exec/plans-storage.js} +5 -5
  53. package/dist/{exec-plans.js → exec/plans.js} +3 -3
  54. package/dist/{exec-project.js → exec/project.js} +1 -1
  55. package/dist/{exec-protection-handoff.js → exec/protection-handoff.js} +3 -3
  56. package/dist/{exec-register-resume.js → exec/register-resume.js} +2 -2
  57. package/dist/{exec-register.js → exec/register.js} +114 -9
  58. package/dist/{exec-repo-integration-git.js → exec/repo-integration-git.js} +2 -2
  59. package/dist/{exec-repo-integration-sync.js → exec/repo-integration-sync.js} +4 -4
  60. package/dist/{exec-repo-integration.js → exec/repo-integration.js} +14 -11
  61. package/dist/{exec-repo-trace.js → exec/repo-trace.js} +3 -3
  62. package/dist/{exec-reporter-output.js → exec/reporter-output.js} +2 -2
  63. package/dist/{exec-reporter.js → exec/reporter.js} +142 -25
  64. package/dist/{exec-results.js → exec/results.js} +287 -31
  65. package/dist/{exec-run-agent-pipeline.js → exec/run/agent-pipeline.js} +35 -12
  66. package/dist/{exec-run-agent.js → exec/run/agent.js} +115 -28
  67. package/dist/{exec-run-in-place.js → exec/run/in-place.js} +56 -27
  68. package/dist/{exec-run-job.js → exec/run/job.js} +65 -36
  69. package/dist/{exec-run-lifecycle-commands.js → exec/run/lifecycle-commands.js} +30 -22
  70. package/dist/{exec-run-lock.js → exec/run/lock.js} +4 -3
  71. package/dist/{exec-run-mode-shared.js → exec/run/mode-shared.js} +3 -3
  72. package/dist/{exec-run-register-command.js → exec/run/register-command.js} +38 -11
  73. package/dist/{exec-run-register-core.js → exec/run/register-core.js} +63 -21
  74. package/dist/{exec-run-register-mode.js → exec/run/register-mode.js} +58 -31
  75. package/dist/exec/run/register-post-review.js +420 -0
  76. package/dist/{exec-run-register-resume.js → exec/run/register-resume.js} +48 -27
  77. package/dist/{exec-run-register-state.js → exec/run/register-state.js} +13 -10
  78. package/dist/{exec-run-register-worktree.js → exec/run/register-worktree.js} +119 -24
  79. package/dist/{exec-run.js → exec/run/run.js} +11 -11
  80. package/dist/{exec-run-schedule-mode.js → exec/run/schedule-mode.js} +17 -17
  81. package/dist/{exec-run-schedule-prepare.js → exec/run/schedule-prepare.js} +31 -18
  82. package/dist/{exec-run-schedule-task.js → exec/run/schedule-task.js} +45 -18
  83. package/dist/{exec-run-shared.js → exec/run/shared.js} +78 -30
  84. package/dist/{exec-schedule-calendar.js → exec/schedule/calendar.js} +1 -1
  85. package/dist/{exec-schedule-cpm.js → exec/schedule/cpm.js} +2 -2
  86. package/dist/{exec-schedule-gantt-chart-render.js → exec/schedule/gantt-chart-render.js} +2 -2
  87. package/dist/exec/schedule/gantt-chart.js +2 -0
  88. package/dist/{exec-schedule-hash.js → exec/schedule/hash.js} +2 -2
  89. package/dist/exec/schedule/index.js +1 -0
  90. package/dist/{exec-schedule-initial.js → exec/schedule/initial.js} +2 -2
  91. package/dist/{exec-schedule-progress.js → exec/schedule/progress.js} +2 -2
  92. package/dist/{exec-schedule-ready.js → exec/schedule/ready.js} +2 -2
  93. package/dist/{exec-schedule.js → exec/schedule/schedule.js} +11 -11
  94. package/dist/exec/shared.js +63 -0
  95. package/dist/exec/slot-lock.js +1 -0
  96. package/dist/{exec-strategy.js → exec/strategy.js} +2 -2
  97. package/dist/{exec-task-repos.js → exec/task-repos.js} +104 -17
  98. package/dist/{exec-task-view.js → exec/task-view.js} +4 -4
  99. package/dist/{exec-trial-commands.js → exec/trial-commands.js} +20 -22
  100. package/dist/{exec-trial-core.js → exec/trial-core.js} +6 -6
  101. package/dist/{exec-trial.js → exec/trial.js} +2 -2
  102. package/dist/{exec-worktree-command.js → exec/worktree-command.js} +25 -23
  103. package/dist/{exec-worktree-ops-commit.js → exec/worktree-ops-commit.js} +25 -60
  104. package/dist/{exec-worktree-ops-lifecycle.js → exec/worktree-ops-lifecycle.js} +13 -8
  105. package/dist/{exec-worktree-ops-merge.js → exec/worktree-ops-merge.js} +48 -7
  106. package/dist/{exec-worktree-ops.js → exec/worktree-ops.js} +3 -3
  107. package/dist/exec/worktree.js +305 -0
  108. package/dist/{grade-apply.js → grade/apply.js} +9 -9
  109. package/dist/{grade-command-apply.js → grade/command-apply.js} +7 -7
  110. package/dist/{grade-command-inspect.js → grade/command-inspect.js} +6 -6
  111. package/dist/{grade-command-plan.js → grade/command-plan.js} +5 -5
  112. package/dist/{grade-core.js → grade/core.js} +3 -3
  113. package/dist/grade/grade.js +19 -0
  114. package/dist/{grade-markdown.js → grade/markdown.js} +6 -6
  115. package/dist/{grade-pipeline-state.js → grade/pipeline-state.js} +4 -4
  116. package/dist/{grade-plan.js → grade/plan.js} +5 -5
  117. package/dist/{grade-result.js → grade/result.js} +5 -94
  118. package/dist/{grade-target-discovery.js → grade/target-discovery.js} +7 -7
  119. package/dist/{grade-targets.js → grade/targets.js} +11 -8
  120. package/dist/{job-definition.js → job/definition.js} +25 -6
  121. package/dist/{job.js → job/job.js} +12 -11
  122. package/dist/{kata-command.js → kata/command.js} +3 -3
  123. package/dist/{kata.js → kata/kata.js} +5 -5
  124. package/dist/register/approach.js +134 -0
  125. package/dist/{register-core.js → register/core.js} +26 -8
  126. package/dist/{register-create-commands.js → register/create-commands.js} +171 -8
  127. package/dist/{register-date.js → register/date.js} +1 -1
  128. package/dist/register/derivation.js +163 -0
  129. package/dist/{register-event-merge.js → register/event-merge.js} +44 -3
  130. package/dist/{register-events.js → register/events.js} +13 -3
  131. package/dist/{register-history.js → register/history.js} +7 -6
  132. package/dist/{register-item.js → register/item.js} +32 -5
  133. package/dist/register/lifecycle-lock.js +5 -0
  134. package/dist/{register-maintenance-commands.js → register/maintenance-commands.js} +13 -7
  135. package/dist/{register-migrate-timestamps.js → register/migrate-timestamps.js} +3 -3
  136. package/dist/{register-migration.js → register/migration.js} +5 -4
  137. package/dist/{register.js → register/register.js} +32 -27
  138. package/dist/{register-renumber.js → register/renumber.js} +38 -11
  139. package/dist/{register-transition-commands.js → register/transition-commands.js} +3 -3
  140. package/dist/{register-update.js → register/update.js} +5 -5
  141. package/dist/{register-views.js → register/views.js} +47 -7
  142. package/dist/{review-grade.js → review/grade.js} +2 -2
  143. package/dist/{review-plan.js → review/plan.js} +3 -3
  144. package/dist/{routine-definition.js → routine/definition.js} +2 -2
  145. package/dist/{routine.js → routine/routine.js} +49 -22
  146. package/dist/{schedule-approach.js → schedule/approach.js} +8 -8
  147. package/dist/{schedule-build.js → schedule/build.js} +7 -4
  148. package/dist/{schedule.js → schedule/schedule.js} +6 -6
  149. package/dist/{schedule-strategy-generate-document.js → schedule/strategy-generate-document.js} +2 -2
  150. package/dist/{schedule-strategy-generate-scope.js → schedule/strategy-generate-scope.js} +4 -4
  151. package/dist/{schedule-strategy-generate.js → schedule/strategy-generate.js} +10 -10
  152. package/dist/shared/agent-types.js +23 -0
  153. package/dist/shared/artifact-path.js +9 -0
  154. package/dist/{build-if-stale.js → shared/build-if-stale.js} +1 -1
  155. package/dist/{catalog-build-render.js → shared/catalog-render.js} +3 -32
  156. package/dist/{exec-slot-lock.js → shared/cross-process-lock.js} +3 -1
  157. package/dist/shared/fs.js +30 -0
  158. package/dist/shared/git.js +346 -0
  159. package/dist/shared/grade-result.js +94 -0
  160. package/dist/{package-paths.js → shared/package-paths.js} +3 -3
  161. package/dist/shared/plan-templates.js +114 -0
  162. package/dist/{exec-provider-scaffold.js → shared/provider-scaffold.js} +6 -3
  163. package/dist/shared/random.js +4 -0
  164. package/dist/{exec-schedule-index.js → shared/schedule-index.js} +3 -1
  165. package/dist/shared/schedule-paths.js +9 -0
  166. package/dist/{specdojo-config.js → shared/specdojo-config.js} +162 -21
  167. package/dist/{exec-shared.js → shared/text.js} +4 -135
  168. package/dist/shared/time.js +28 -0
  169. package/dist/shared/workspace-scaffold.js +69 -0
  170. package/dist/specdojo.js +22 -22
  171. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +31 -18
  172. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +1 -2
  173. package/docs/ja/specdojo/exec-templates/xep-register-template.md +3 -2
  174. package/docs/ja/specdojo/exec-templates/xer-template.md +1 -3
  175. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +6 -4
  176. package/docs/ja/specdojo/exec-templates/xrp-register-post-run-template.md +46 -0
  177. package/docs/ja/specdojo/guides/branch-workflow-guide.md +34 -1
  178. package/docs/ja/specdojo/guides/docs-structure-guide.md +2 -0
  179. package/docs/ja/specdojo/guides/exec-config-guide.md +169 -26
  180. package/docs/ja/specdojo/guides/exec-operation-guide.md +184 -13
  181. package/docs/ja/specdojo/guides/exec-worktree-guide.md +2 -0
  182. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +40 -3
  183. package/docs/ja/specdojo/guides/quick-start-guide.md +89 -21
  184. package/docs/ja/specdojo/guides/register-operation-guide.md +44 -1
  185. package/docs/ja/specdojo/guides/remote-host-development-guide.md +61 -6
  186. package/docs/ja/specdojo/guides/review-guide.md +1 -1
  187. package/docs/ja/specdojo/guides/routine-operation-guide.md +5 -5
  188. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +1 -1
  189. package/docs/ja/specdojo/guides/use-case-guide.md +1 -1
  190. package/docs/ja/specdojo/guides/waza-guide.md +1 -1
  191. package/docs/ja/specdojo/references/command-reference.md +124 -55
  192. package/docs/ja/specdojo/references/specdojo-config-reference.md +33 -7
  193. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +22 -13
  194. package/docs/ja/specdojo/standards/job-definition-standard.md +20 -18
  195. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -2
  196. package/docs/ja/specdojo/templates/pjr-derived-items-template.md +22 -0
  197. package/docs/ja/specdojo/templates/pjr-index-template.md +1 -0
  198. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +29 -2
  199. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +111 -17
  200. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +28 -0
  201. package/docs/specdojo/schemas/v1/job-run.schema.yaml +2 -2
  202. package/docs/specdojo/schemas/v1/job.schema.yaml +7 -0
  203. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +38 -0
  204. package/docs/specdojo/schemas/v1/register-events.schema.yaml +5 -0
  205. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +91 -7
  206. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +1 -1
  207. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +36 -1
  208. package/package.json +17 -17
  209. package/templates/antigravity/README.md +6 -2
  210. package/templates/antigravity/agent-members-snippet.yaml +108 -12
  211. package/templates/antigravity/exec-defaults-snippet.yaml +8 -13
  212. package/templates/antigravity/orchestrator.md +61 -2
  213. package/templates/claude/README.md +27 -3
  214. package/templates/claude/agents/claude-executor.md +0 -1
  215. package/templates/claude/agents/claude-reporter.md +2 -1
  216. package/templates/claude/agents/claude-review-executor.md +0 -1
  217. package/templates/claude/agents/specdojo-orchestrator.md +61 -2
  218. package/templates/codex/README.md +40 -4
  219. package/templates/codex/agents/specdojo-orchestrator.toml +61 -2
  220. package/templates/codex/orchestrator.md +61 -2
  221. package/templates/devcontainer/devcontainer.json +5 -2
  222. package/templates/devcontainer/post-create.sh +15 -7
  223. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +102 -0
  224. package/templates/devcontainer/remote-host/ssh-config.sample +19 -0
  225. package/templates/devcontainer/vim/vimrc +37 -0
  226. package/templates/init-agent-members.yaml +75 -25
  227. package/templates/init-exec-defaults.yaml +44 -9
  228. package/templates/opencode/README.md +17 -3
  229. package/templates/opencode/agents/opencode-executor.md +0 -1
  230. package/templates/opencode/agents/opencode-reporter.md +2 -1
  231. package/templates/opencode/agents/opencode-review-executor.md +0 -1
  232. package/templates/opencode/agents/specdojo-orchestrator.md +61 -2
  233. package/dist/devcontainer-scaffold.js +0 -165
  234. package/dist/exec-schedule-gantt-chart.js +0 -2
  235. package/dist/exec-worktree.js +0 -474
  236. package/dist/exec.js +0 -2
  237. package/dist/grade.js +0 -19
  238. package/templates/claude/agents/claude-expert-review-executor.md +0 -14
  239. /package/dist/{catalog-plan-prompt.js → catalog/plan-prompt.js} +0 -0
  240. /package/dist/{catalog-types.js → catalog/types.js} +0 -0
  241. /package/dist/{template-frontmatter.js → docs/template-frontmatter.js} +0 -0
  242. /package/dist/{role-types.js → exec/role-types.js} +0 -0
  243. /package/dist/{exec-schedule-gantt-chart-scope.js → exec/schedule/gantt-chart-scope.js} +0 -0
  244. /package/dist/{exec-types.js → exec/types.js} +0 -0
  245. /package/dist/{grade-command-shared.js → grade/command-shared.js} +0 -0
  246. /package/dist/{register-command-types.js → register/command-types.js} +0 -0
  247. /package/dist/{review-types.js → review/types.js} +0 -0
  248. /package/dist/{schedule-phase-sets.js → schedule/phase-sets.js} +0 -0
  249. /package/dist/{schedule-strategy-profiles.js → schedule/strategy-profiles.js} +0 -0
  250. /package/dist/{agent-response.js → shared/agent-response.js} +0 -0
  251. /package/dist/{catalog-paths.js → shared/catalog-paths.js} +0 -0
  252. /package/dist/{dist-freshness.js → shared/dist-freshness.js} +0 -0
  253. /package/dist/{git-environment.js → shared/git-environment.js} +0 -0
  254. /package/dist/{exec-format.js → shared/markdown-format.js} +0 -0
  255. /package/dist/{practice-id.js → shared/practice-id.js} +0 -0
  256. /package/dist/{spawn-self.js → shared/spawn-self.js} +0 -0
  257. /package/dist/{specdojo-gitignore.js → shared/specdojo-gitignore.js} +0 -0
  258. /package/dist/{template-resolution.js → shared/template-resolution.js} +0 -0
  259. /package/dist/{yaml-schema-modeline.js → shared/yaml-schema-modeline.js} +0 -0
  260. /package/dist/{yaml.js → shared/yaml.js} +0 -0
@@ -0,0 +1,420 @@
1
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
2
+ import { dirname, join, relative, resolve, sep } from "node:path";
3
+ import { resolveMemberCommand } from "../agent-config.js";
4
+ import { buildSpecdojoFrontmatter } from "../../docs/frontmatter-namespace.js";
5
+ import { formatMarkdownFile } from "../../shared/markdown-format.js";
6
+ import { expandTemplate } from "../../shared/text.js";
7
+ import { execTemplatePath } from "../plans.js";
8
+ import { scaffoldResult, stripLeadingListMarker, updateResultStatus } from "../results.js";
9
+ import { readPipelineState } from "../pipeline-state.js";
10
+ import { sanitizeRegisterConclusion } from "../register.js";
11
+ import { gitOutput } from "../worktree.js";
12
+ import { worktreeStatusPaths } from "../worktree-ops.js";
13
+ import { runAgentPipeline } from "./agent-pipeline.js";
14
+ import { expandPromptRefs } from "./agent.js";
15
+ import { registerReporterManagedPaths, spawnRegisterTransition, } from "./register-core.js";
16
+ import { commitRegisterState } from "./register-state.js";
17
+ import { resolveAgentOverride, resolvePinnedRateLimitRunOptions, selectCandidates, } from "./shared.js";
18
+ export const DEFAULT_REGISTER_POST_REVIEW_EXECUTOR = "claude-expert-review-executor";
19
+ const ACCEPTED_POST_REVIEW_VERDICTS = new Set(["complete", "complete-with-findings"]);
20
+ const POST_REVIEW_VERDICTS = new Set(["complete", "complete-with-findings", "incomplete"]);
21
+ const AUTO_CLOSE_REGISTER_TYPES = new Set(["todo", "issue"]);
22
+ export function registerPostReviewDisposition(params) {
23
+ const { itemType, verdict, runnerImplementationChanged = false } = params;
24
+ if (verdict === "incomplete" || !verdict) {
25
+ return {
26
+ transition: "waiting",
27
+ outcome: "failure",
28
+ explanation: verdict === "incomplete" ? "review verdict is incomplete" : "review failed",
29
+ };
30
+ }
31
+ if (!ACCEPTED_POST_REVIEW_VERDICTS.has(verdict)) {
32
+ return {
33
+ transition: "waiting",
34
+ outcome: "failure",
35
+ explanation: `review verdict is not accepted: ${verdict}`,
36
+ };
37
+ }
38
+ if (!AUTO_CLOSE_REGISTER_TYPES.has(itemType)) {
39
+ return {
40
+ transition: "review",
41
+ outcome: "success",
42
+ explanation: `register type ${itemType} is not eligible for automatic close`,
43
+ };
44
+ }
45
+ if (runnerImplementationChanged) {
46
+ return {
47
+ transition: "review",
48
+ outcome: "success",
49
+ explanation: "the integrated change modifies the running SpecDojo implementation; a new process smoke test and human close are required",
50
+ };
51
+ }
52
+ return {
53
+ transition: "done",
54
+ outcome: "success",
55
+ explanation: `review verdict is ${verdict}`,
56
+ };
57
+ }
58
+ export function registerPostReviewVerdict(resultPath) {
59
+ if (!existsSync(resultPath))
60
+ return undefined;
61
+ const match = readFileSync(resultPath, "utf8").match(/^- verdict:\s*(complete|complete-with-findings|incomplete|grade-stale|grade-unavailable|changed-during-review)\s*$/m);
62
+ return match?.[1];
63
+ }
64
+ export function changesModifyRunningSpecDojo(repoRoot, paths) {
65
+ const packagePath = join(repoRoot, "package.json");
66
+ if (!existsSync(packagePath))
67
+ return false;
68
+ try {
69
+ const manifest = JSON.parse(readFileSync(packagePath, "utf8"));
70
+ if (manifest.name !== "specdojo")
71
+ return false;
72
+ }
73
+ catch {
74
+ return false;
75
+ }
76
+ return paths.some((path) => {
77
+ const normalized = path.replaceAll("\\", "/").replace(/^\.\//u, "");
78
+ return (normalized.startsWith("src/") ||
79
+ normalized.startsWith("tools/") ||
80
+ normalized === "package.json" ||
81
+ normalized === "package-lock.json" ||
82
+ normalized === "npm-shrinkwrap.json" ||
83
+ normalized === "pnpm-lock.yaml" ||
84
+ normalized === "yarn.lock");
85
+ });
86
+ }
87
+ function candidateForMember(member, execDefaults) {
88
+ const command = resolveMemberCommand(execDefaults, member);
89
+ return command ? { command, actor: member.nickname, provider: member.provider } : undefined;
90
+ }
91
+ export function resolveRegisterPostReviewAgents(roster, opts, execDefaults) {
92
+ const reviewNickname = opts.reviewBy?.trim() || DEFAULT_REGISTER_POST_REVIEW_EXECUTOR;
93
+ const executorResolution = resolveAgentOverride("review", reviewNickname, {}, roster, execDefaults, "executor");
94
+ if (executorResolution.kind !== "command") {
95
+ const detail = executorResolution.kind === "error"
96
+ ? executorResolution.message
97
+ : `agent not found: ${reviewNickname}`;
98
+ throw new Error(`Register post-review executor is unavailable (${detail.replace(/^--by/u, "--review-by")}). ` +
99
+ "Specify --review-by <nickname>.");
100
+ }
101
+ const executor = {
102
+ command: executorResolution.command,
103
+ actor: executorResolution.actor ?? reviewNickname,
104
+ provider: executorResolution.provider,
105
+ };
106
+ const reporterNickname = opts.reporterBy?.trim();
107
+ if (reporterNickname) {
108
+ const reporterResolution = resolveAgentOverride("review", reporterNickname, {}, roster, execDefaults, "reporter");
109
+ if (reporterResolution.kind !== "command") {
110
+ const detail = reporterResolution.kind === "error"
111
+ ? reporterResolution.message
112
+ : `agent not found: ${reporterNickname}`;
113
+ throw new Error(detail.replace(/^--by/u, "--reporter-by"));
114
+ }
115
+ return {
116
+ executor,
117
+ reporterCandidates: [
118
+ {
119
+ command: reporterResolution.command,
120
+ actor: reporterResolution.actor ?? reporterNickname,
121
+ provider: reporterResolution.provider,
122
+ },
123
+ ],
124
+ };
125
+ }
126
+ const reporterCandidates = selectCandidates({ capabilities: [], stage_role: "reporter" }, roster, undefined, undefined, execDefaults).flatMap((member) => {
127
+ const candidate = candidateForMember(member, execDefaults);
128
+ return candidate ? [candidate] : [];
129
+ });
130
+ if (reporterCandidates.length === 0) {
131
+ throw new Error("No reporter is available for register post-review. Specify --reporter-by <nickname>.");
132
+ }
133
+ return { executor, reporterCandidates };
134
+ }
135
+ function repoRelative(repoRoot, path) {
136
+ return relative(repoRoot, path).split(sep).join("/");
137
+ }
138
+ export async function generateRegisterPostReviewPlan(params) {
139
+ const { context, item, stem } = params;
140
+ const taskId = `${item.id}-post-review`;
141
+ const reviewStem = `${stem}-post-review`;
142
+ const planPath = join(context.executionPath, "exec", "plans", `${reviewStem}-plan.md`);
143
+ const resultPath = join(context.executionPath, "exec", "results", `${reviewStem}-result.md`);
144
+ const templatePath = execTemplatePath("xrp-register-post-run-template.md");
145
+ const frontmatter = buildSpecdojoFrontmatter([
146
+ `id: ${context.projectId}:xrp-${reviewStem}`,
147
+ "type: exec-plan",
148
+ "rulebook: none",
149
+ `task_id: ${taskId}`,
150
+ `name: ${JSON.stringify(`${item.id} ${item.title} の統合後レビュー`)}`,
151
+ "mode: review",
152
+ "status: ready",
153
+ `project_id: ${context.projectId}`,
154
+ "origin: register",
155
+ ]);
156
+ const values = {
157
+ _FRONTMATTER_: frontmatter,
158
+ _ITEM_ID_: item.id,
159
+ _ITEM_TITLE_: item.title,
160
+ _ITEM_PATH_: repoRelative(context.repoRoot, params.ticketPath),
161
+ _EDIT_PLAN_REF_: repoRelative(context.repoRoot, params.editPlanPath),
162
+ _EDIT_RESULT_REF_: repoRelative(context.repoRoot, params.editResultPath),
163
+ _EDIT_EVIDENCE_REF_: params.editEvidenceRef ?? "-",
164
+ _BASE_COMMIT_: params.baseCommit,
165
+ _OUTPUT_COMMIT_: params.outputCommit,
166
+ _RESULT_REF_: repoRelative(context.repoRoot, resultPath),
167
+ };
168
+ const content = expandTemplate(readFileSync(templatePath, "utf8"), values);
169
+ mkdirSync(dirname(planPath), { recursive: true });
170
+ writeFileSync(planPath, content, "utf8");
171
+ await formatMarkdownFile(planPath);
172
+ return { taskId, planPath, resultPath };
173
+ }
174
+ function reviewRationale(resultPath) {
175
+ if (!existsSync(resultPath))
176
+ return "review result is unavailable";
177
+ const content = readFileSync(resultPath, "utf8");
178
+ const section = content.match(/## 2\. 判断根拠\s*\n([\s\S]*?)(?=\n## 3\.)/u)?.[1] ?? "";
179
+ const rationale = section
180
+ .split("\n")
181
+ .map((line) => line.replace(/^\s*-\s*/u, "").trim())
182
+ .filter(Boolean)
183
+ .join(" ");
184
+ return rationale || "review result recorded no rationale";
185
+ }
186
+ async function fillFailedReviewResult(resultPath, reason) {
187
+ const safeReason = reason.replace(/\s+/gu, " ").trim();
188
+ let content = readFileSync(resultPath, "utf8");
189
+ content = content
190
+ .replace(/_TODO_: 評価結果サイドカー[^\n]*/u, `統合後 review を完了できなかった: ${safeReason}`)
191
+ .replace(/_TODO_: 変更内容[^\n]*/u, "- runner が統合後 review を完了できなかった。")
192
+ .replace(/_TODO_: 未充足事項[^\n]*/u, `- ${stripLeadingListMarker(safeReason) || "理由なし"}`)
193
+ .replace(/_TODO_: `approach`[^\n]*/u, "統合済みの出力は変更していない。")
194
+ .replace(/- verdict: _TODO_([^\n]*)/u, "- verdict: incomplete");
195
+ writeFileSync(resultPath, content, "utf8");
196
+ await formatMarkdownFile(resultPath);
197
+ }
198
+ async function forceIncompleteReviewResult(resultPath, reason) {
199
+ let content = readFileSync(resultPath, "utf8");
200
+ content = content.replace(/^- verdict:\s*(?:complete|complete-with-findings|incomplete|grade-stale|grade-unavailable|changed-during-review)\s*$/mu, "- verdict: incomplete");
201
+ const note = `- runner 判定: ${reason.replace(/\s+/gu, " ").trim()}`;
202
+ if (!content.includes(note)) {
203
+ content = content.replace("\n## 4. approach に応じた確認", `\n${note}\n\n## 4. approach に応じた確認`);
204
+ }
205
+ writeFileSync(resultPath, content, "utf8");
206
+ await formatMarkdownFile(resultPath);
207
+ }
208
+ function editEvidenceRefAtRoot(params) {
209
+ if (!params.pipelineStatePath)
210
+ return undefined;
211
+ const stateRel = relative(params.worktreePath, params.pipelineStatePath);
212
+ const rootStatePath = resolve(params.repoRoot, stateRel);
213
+ if (!existsSync(rootStatePath))
214
+ return undefined;
215
+ const state = readPipelineState(rootStatePath);
216
+ const evidenceRef = state.stages.executor.artifact_ref;
217
+ return evidenceRef && existsSync(resolve(params.repoRoot, evidenceRef)) ? evidenceRef : undefined;
218
+ }
219
+ function changedPathsBetween(repoRoot, baseCommit, outputCommit) {
220
+ return gitOutput(repoRoot, ["diff", "--name-only", `${baseCommit}..${outputCommit}`])
221
+ .split("\n")
222
+ .map((path) => path.trim())
223
+ .filter(Boolean);
224
+ }
225
+ // post-review の記帳(個票・イベント・review の plan と result)の commit が hook で失敗すると、
226
+ // 記帳は作業ツリーに残ったまま次の項目へ進む。人が確かめて手で commit できるよう、失敗した
227
+ // hook の名前と最初のエラーの行(commitRegisterState の要約)、残ったファイル、hook の全出力の
228
+ // 置き場所を runner のログへ出す。
229
+ export function postReviewCommitFailureLines(params) {
230
+ const summary = params.message.replace(/^git commit failed:\s*/u, "");
231
+ // summarizeGitHookFailure は失敗した step を `<step>: <最初のエラーの行>` の形で先頭に置く。
232
+ // git 自身の `fatal:` / `error:` は hook 名ではないため、hook 名として扱わない。
233
+ const match = summary.match(/^([\w.-]+): (.*)$/su);
234
+ const isHookName = match !== null && !/^(?:fatal|error|warning|hint)$/iu.test(match[1]);
235
+ const hook = isHookName ? match[1] : "unknown";
236
+ const firstError = isHookName ? match[2] : summary;
237
+ return [
238
+ `Error: post-review bookkeeping commit failed for ${params.itemId}`,
239
+ ` failed hook: ${hook}`,
240
+ ` first error: ${firstError || "unknown"}`,
241
+ ` uncommitted bookkeeping files: ${params.leftFiles.length > 0 ? params.leftFiles.join(", ") : "none"}`,
242
+ ` full hook output: ${params.failureLogPath}`,
243
+ ];
244
+ }
245
+ function reportPostReviewCommitFailure(params) {
246
+ const message = params.error instanceof Error ? params.error.message : String(params.error);
247
+ const leftFiles = worktreeStatusPaths(params.repoRoot)
248
+ .filter((path) => !params.preexisting.includes(path))
249
+ .sort();
250
+ const lines = postReviewCommitFailureLines({
251
+ itemId: params.itemId,
252
+ message,
253
+ leftFiles,
254
+ failureLogPath: repoRelative(params.repoRoot, params.failureLogPath),
255
+ });
256
+ process.stderr.write(`${lines.join("\n")}\n`);
257
+ }
258
+ export async function runRegisterPostReview(params) {
259
+ const { context, opts, item, registerPaths } = params;
260
+ const agents = resolveRegisterPostReviewAgents(context.roster, opts, context.execDefaults);
261
+ const editEvidenceRef = editEvidenceRefAtRoot({
262
+ repoRoot: context.repoRoot,
263
+ worktreePath: params.worktreePath,
264
+ pipelineStatePath: params.editPipelineStatePath,
265
+ });
266
+ const preexisting = worktreeStatusPaths(context.repoRoot);
267
+ const generated = await generateRegisterPostReviewPlan({
268
+ context,
269
+ item,
270
+ ticketPath: params.ticketPath,
271
+ stem: params.stem,
272
+ editPlanPath: params.editPlanPath,
273
+ editResultPath: params.editResultPath,
274
+ ...(editEvidenceRef ? { editEvidenceRef } : {}),
275
+ baseCommit: params.baseCommit,
276
+ outputCommit: params.outputCommit,
277
+ });
278
+ await scaffoldResult({
279
+ executionPath: context.executionPath,
280
+ taskId: generated.taskId,
281
+ mode: "review",
282
+ projectId: context.projectId,
283
+ origin: "register",
284
+ planRef: repoRelative(context.executionPath, generated.planPath),
285
+ agent: agents.executor.actor,
286
+ startedAt: new Date().toISOString(),
287
+ stem: `${params.stem}-post-review`,
288
+ });
289
+ process.stdout.write(`Running post-review for ${item.id}: ${agents.executor.actor} (executor), ${agents.reporterCandidates[0]?.actor ?? "reporter"} (reporter)\n`);
290
+ const reviewExecDefaults = {
291
+ ...context.execDefaults,
292
+ pipeline: { ...context.execDefaults.pipeline, parent_validations: [] },
293
+ };
294
+ const outcome = await runAgentPipeline({
295
+ repoRoot: context.repoRoot,
296
+ cwd: context.repoRoot,
297
+ schedulePath: context.schedulePath,
298
+ executionPath: context.executionPath,
299
+ taskId: generated.taskId,
300
+ executor: agents.executor,
301
+ reporterCandidates: agents.reporterCandidates,
302
+ planPath: generated.planPath,
303
+ planPrompt: expandPromptRefs(readFileSync(generated.planPath, "utf8")),
304
+ resultPath: generated.resultPath,
305
+ registerPaths: registerReporterManagedPaths(registerPaths),
306
+ execDefaults: reviewExecDefaults,
307
+ providerConcurrencyGate: context.providerConcurrencyGate,
308
+ mode: "review",
309
+ executorRateLimitOptions: resolvePinnedRateLimitRunOptions(opts, context.execDefaults, context.roster, "executor", agents.executor),
310
+ ...(opts.reporterBy
311
+ ? {
312
+ reporterRateLimitOptions: resolvePinnedRateLimitRunOptions(opts, context.execDefaults, context.roster, "reporter", agents.reporterCandidates[0]),
313
+ }
314
+ : {}),
315
+ });
316
+ const reviewStatePath = resolve(context.repoRoot, outcome.stateRef);
317
+ const reviewState = readPipelineState(reviewStatePath);
318
+ const reviewActor = reviewState.stages.executor.actor ?? agents.executor.actor;
319
+ const reviewEvidencePath = reviewState.stages.executor.artifact_ref
320
+ ? resolve(context.repoRoot, reviewState.stages.executor.artifact_ref)
321
+ : undefined;
322
+ let reviewFailure = outcome.blockReason;
323
+ if (reviewEvidencePath && existsSync(reviewEvidencePath)) {
324
+ const evidence = JSON.parse(readFileSync(reviewEvidencePath, "utf8"));
325
+ const unexpected = evidence.attempt_changes ?? [];
326
+ if (unexpected.length > 0) {
327
+ reviewFailure = `review executor changed files: ${unexpected.map((change) => change.path).join(", ")}`;
328
+ }
329
+ }
330
+ let verdict = outcome.exitCode === 0 ? registerPostReviewVerdict(generated.resultPath) : undefined;
331
+ if (reviewFailure || !verdict) {
332
+ const reason = reviewFailure ?? "review result has no verdict";
333
+ if (registerPostReviewVerdict(generated.resultPath)) {
334
+ await forceIncompleteReviewResult(generated.resultPath, reason);
335
+ }
336
+ else {
337
+ await fillFailedReviewResult(generated.resultPath, reason);
338
+ }
339
+ verdict = "incomplete";
340
+ await updateResultStatus(generated.resultPath, "blocked", new Date().toISOString(), reason);
341
+ }
342
+ else if (!POST_REVIEW_VERDICTS.has(verdict)) {
343
+ const reason = `register post-review returned unsupported verdict ${verdict}`;
344
+ await forceIncompleteReviewResult(generated.resultPath, reason);
345
+ verdict = "incomplete";
346
+ await updateResultStatus(generated.resultPath, "blocked", new Date().toISOString(), reason);
347
+ }
348
+ else {
349
+ await updateResultStatus(generated.resultPath, "complete", new Date().toISOString());
350
+ }
351
+ const runnerImplementationChanged = changesModifyRunningSpecDojo(context.repoRoot, changedPathsBetween(context.repoRoot, params.baseCommit, params.outputCommit));
352
+ const disposition = registerPostReviewDisposition({
353
+ itemType: item.type,
354
+ verdict,
355
+ runnerImplementationChanged,
356
+ });
357
+ const rationale = sanitizeRegisterConclusion(`post-run review verdict ${verdict}: ${reviewRationale(generated.resultPath)}; ${disposition.explanation}`);
358
+ if (disposition.transition === "done") {
359
+ if (!spawnRegisterTransition(context.projectId, [
360
+ "close",
361
+ "--id",
362
+ item.id,
363
+ "--status",
364
+ "done",
365
+ "--by",
366
+ reviewActor,
367
+ "--reason",
368
+ rationale,
369
+ ])) {
370
+ throw new Error(`register close transition failed after post-review: ${item.id}`);
371
+ }
372
+ }
373
+ else if (disposition.transition === "waiting") {
374
+ if (!spawnRegisterTransition(context.projectId, [
375
+ "wait",
376
+ "--id",
377
+ item.id,
378
+ "--by",
379
+ reviewActor,
380
+ "--reason",
381
+ rationale,
382
+ ])) {
383
+ throw new Error(`register wait transition failed after post-review: ${item.id}`);
384
+ }
385
+ }
386
+ const evidencePrefix = `${repoRelative(context.repoRoot, dirname(reviewStatePath))}/`;
387
+ const managed = worktreeStatusPaths(context.repoRoot)
388
+ .filter((path) => {
389
+ const normalized = path.replaceAll("\\", "/");
390
+ return (normalized === repoRelative(context.repoRoot, generated.planPath) ||
391
+ normalized === repoRelative(context.repoRoot, generated.resultPath) ||
392
+ normalized.startsWith(evidencePrefix));
393
+ })
394
+ .map((path) => resolve(context.repoRoot, path));
395
+ const commitFailureLogPath = join(dirname(reviewStatePath), "post-review-commit.log");
396
+ try {
397
+ commitRegisterState(context.repoRoot, registerPaths, `exec(register ${item.id}): post-review ${verdict}`, params.ticketPath, managed, commitFailureLogPath);
398
+ }
399
+ catch (error) {
400
+ reportPostReviewCommitFailure({
401
+ repoRoot: context.repoRoot,
402
+ itemId: item.id,
403
+ error,
404
+ preexisting,
405
+ failureLogPath: commitFailureLogPath,
406
+ });
407
+ throw error;
408
+ }
409
+ const commit = gitOutput(context.repoRoot, ["rev-parse", "--short", "HEAD"]).trim();
410
+ const introduced = worktreeStatusPaths(context.repoRoot).filter((path) => !preexisting.includes(path));
411
+ if (introduced.length > 0) {
412
+ process.stderr.write(`Warning: post-review left uncommitted files for ${item.id}: ${introduced.join(", ")}\n`);
413
+ }
414
+ return {
415
+ transition: disposition.transition,
416
+ outcome: disposition.outcome,
417
+ reason: rationale,
418
+ commit: `committed ${commit}`,
419
+ };
420
+ }
@@ -1,22 +1,22 @@
1
1
  import { existsSync, readFileSync } from "node:fs";
2
2
  import { resolve } from "node:path";
3
- import { qualifyTaskId } from "./exec-shared.js";
4
- import { requireRunnableRegisterItem, resolveRegisterRunTarget, sanitizeRegisterConclusion, ticketPathFromItem, } from "./exec-register.js";
5
- import { readResultFrontmatterSnapshot } from "./exec-results.js";
6
- import { findExecWorktree } from "./exec-worktree.js";
7
- import { configuredProductRepos, missingProductWorktrees, withProductWorktrees, } from "./exec-task-repos.js";
8
- import { currentBranch, isExecBranchMergedIntoCurrent } from "./exec-worktree-ops.js";
9
- import { syncTaskWorktreesWithIntegrationTargets, } from "./exec-repo-integration.js";
10
- import { failedParentValidationReason } from "./exec-parent-validation.js";
11
- import { findResumableRegisterRun, resolveRegisterResumeArtifacts, } from "./exec-register-resume.js";
12
- import { integratedRepoNames } from "./exec-pipeline-state.js";
13
- import { resolveAgentOverride, } from "./exec-run-shared.js";
14
- import { expandPromptRefs } from "./exec-run-agent.js";
15
- import { refreshParentValidationsForReporterResume, runAgentPipeline, runReporterStage, } from "./exec-run-agent-pipeline.js";
16
- import { repoRelativePath } from "./exec-run-mode-shared.js";
17
- import { spawnRegisterTransition, registerReporterManagedPaths, } from "./exec-run-register-core.js";
18
- import { copyRepoPaths, registerTransitionPaths, registerBookkeepingPaths, rebuildRootRegisterViews, } from "./exec-run-register-state.js";
19
- import { finalizeRegisterWorktreeRun } from "./exec-run-register-worktree.js";
3
+ import { qualifyTaskId } from "../shared.js";
4
+ import { requireRunnableRegisterItem, resolveRegisterRunTarget, sanitizeRegisterConclusion, ticketPathFromItem, } from "../register.js";
5
+ import { readResultFrontmatterSnapshot } from "../results.js";
6
+ import { findExecWorktree } from "../worktree.js";
7
+ import { configuredProductRepos, missingProductWorktrees, resumeIntegrationBranches, withProductWorktrees, } from "../task-repos.js";
8
+ import { currentBranch, isExecBranchMergedIntoCurrent } from "../worktree-ops.js";
9
+ import { syncTaskWorktreesWithIntegrationTargets, } from "../repo-integration.js";
10
+ import { failedParentValidationReason } from "../parent-validation.js";
11
+ import { findResumableRegisterRun, resolveRegisterResumeArtifacts, } from "../register-resume.js";
12
+ import { integratedRepoNames } from "../pipeline-state.js";
13
+ import { resolveAgentOverride, resolvePinnedRateLimitRunOptions, rateLimitRecoveryReason, } from "./shared.js";
14
+ import { expandPromptRefs } from "./agent.js";
15
+ import { refreshParentValidationsForReporterResume, runAgentPipeline, runReporterStage, } from "./agent-pipeline.js";
16
+ import { repoRelativePath } from "./mode-shared.js";
17
+ import { spawnRegisterTransition, registerReporterManagedPaths, } from "./register-core.js";
18
+ import { copyRepoPaths, registerTransitionPaths, registerBookkeepingPaths, rebuildRootRegisterViews, } from "./register-state.js";
19
+ import { finalizeRegisterWorktreeRun } from "./register-worktree.js";
20
20
  // reporter 再開に使う agent を解決する。--reporter-by を優先し、省略時は再開対象 run の
21
21
  // pipeline-state に記録された reporter actor(通常は前回と同じ agent)へフォールバックする。
22
22
  export function resolveRegisterResumeReporter(roster, opts, execDefaults, recordedActor) {
@@ -119,6 +119,7 @@ export async function resumeRegisterIntegration(params) {
119
119
  const resultScaffold = readResultFrontmatterSnapshot(worktreeResultPath);
120
120
  const finalize = async () => finalizeRegisterWorktreeRun({
121
121
  context: params.context,
122
+ opts: params.opts,
122
123
  registerPaths: params.registerPaths,
123
124
  item,
124
125
  ticketPath: params.ticketPath,
@@ -165,18 +166,9 @@ export async function resumeSingleRegisterItemWorktree(context, opts, pjrId, lif
165
166
  if (!foundWorktree) {
166
167
  return refuse(`no exec worktree to resume for ${item.id}; run the item again instead`);
167
168
  }
168
- // PJR-98G4: プロダクトの worktree も揃っていることを再開の条件にする。欠けたまま再開すると、
169
- // agent がプロダクト側の変更先を失う。
170
- const products = configuredProductRepos(schedulePath);
171
- const worktree = withProductWorktrees(foundWorktree, products, worktreeTaskId);
172
- const missingProducts = missingProductWorktrees(products, worktree);
173
- if (missingProducts.length > 0) {
174
- return refuse(`product worktrees are missing for ${item.id}: ${missingProducts.join(", ")}; ` +
175
- `run the item again instead`);
176
- }
177
169
  const lookup = findResumableRegisterRun({
178
170
  repoRoot,
179
- worktreePath: worktree.path,
171
+ worktreePath: foundWorktree.path,
180
172
  executionPath,
181
173
  taskId: item.id,
182
174
  ...(opts.resumeFrom === "executor" ? { resumeFrom: "executor" } : {}),
@@ -184,6 +176,26 @@ export async function resumeSingleRegisterItemWorktree(context, opts, pjrId, lif
184
176
  if (lookup.kind !== "resumable")
185
177
  return refuse(lookup.reason);
186
178
  const target = lookup.target;
179
+ // PJR-XRAB: run 開始時の --integration-branch を checkpoint から引き継ぐ。再開時に別の統合先を
180
+ // 指定することは認めない(run の途中で統合先が変わると、開始点と統合先が食い違う)。
181
+ let products;
182
+ let integrationBranchOverrides;
183
+ try {
184
+ const overrides = resumeIntegrationBranches(target.state.integration_branches, opts.integrationBranch);
185
+ products = configuredProductRepos(schedulePath, overrides);
186
+ integrationBranchOverrides = overrides.size > 0 ? Object.fromEntries(overrides) : undefined;
187
+ }
188
+ catch (error) {
189
+ return refuse(error instanceof Error ? error.message : String(error));
190
+ }
191
+ // PJR-98G4: プロダクトの worktree も揃っていることを再開の条件にする。欠けたまま再開すると、
192
+ // agent がプロダクト側の変更先を失う。
193
+ const worktree = withProductWorktrees(foundWorktree, products, worktreeTaskId);
194
+ const missingProducts = missingProductWorktrees(products, worktree);
195
+ if (missingProducts.length > 0) {
196
+ return refuse(`product worktrees are missing for ${item.id}: ${missingProducts.join(", ")}; ` +
197
+ `run the item again instead`);
198
+ }
187
199
  const artifacts = resolveRegisterResumeArtifacts({
188
200
  repoRoot,
189
201
  worktreePath: worktree.path,
@@ -269,6 +281,7 @@ export async function resumeSingleRegisterItemWorktree(context, opts, pjrId, lif
269
281
  }
270
282
  return resumeRegisterIntegration({
271
283
  context,
284
+ opts,
272
285
  registerPaths,
273
286
  item,
274
287
  ticketPath,
@@ -321,9 +334,13 @@ export async function resumeSingleRegisterItemWorktree(context, opts, pjrId, lif
321
334
  resumeHandoff: target.handoff,
322
335
  providerConcurrencyGate: context.providerConcurrencyGate,
323
336
  productWorktrees: worktree.repos,
337
+ ...(integrationBranchOverrides ? { integrationBranchOverrides } : {}),
338
+ executorRateLimitOptions: resolvePinnedRateLimitRunOptions(opts, context.execDefaults, context.roster, "executor", executor.candidate),
339
+ reporterRateLimitOptions: resolvePinnedRateLimitRunOptions(opts, context.execDefaults, context.roster, "reporter", reporter.candidate),
324
340
  });
325
341
  const finalize = async () => finalizeRegisterWorktreeRun({
326
342
  context,
343
+ opts,
327
344
  registerPaths,
328
345
  item,
329
346
  ticketPath,
@@ -336,6 +353,7 @@ export async function resumeSingleRegisterItemWorktree(context, opts, pjrId, lif
336
353
  actor: executor.candidate.actor,
337
354
  bookkeepingPaths: bookkeepingPaths(),
338
355
  pipelineStatePath: resolve(worktree.path, outcome.stateRef),
356
+ transitionReason: rateLimitRecoveryReason(outcome.rateLimitEvents) || undefined,
339
357
  });
340
358
  return lifecycleLock ? lifecycleLock.runExclusive(finalize) : finalize();
341
359
  }
@@ -372,10 +390,12 @@ export async function resumeSingleRegisterItemWorktree(context, opts, pjrId, lif
372
390
  state: target.state,
373
391
  statePath: target.statePath,
374
392
  providerConcurrencyGate: context.providerConcurrencyGate,
393
+ rateLimitOptions: resolvePinnedRateLimitRunOptions(opts, context.execDefaults, context.roster, "reporter", reporter.candidate),
375
394
  productWorktrees: worktree.repos,
376
395
  });
377
396
  const finalize = async () => finalizeRegisterWorktreeRun({
378
397
  context,
398
+ opts,
379
399
  registerPaths,
380
400
  item,
381
401
  ticketPath,
@@ -388,6 +408,7 @@ export async function resumeSingleRegisterItemWorktree(context, opts, pjrId, lif
388
408
  actor: reporter.candidate.actor,
389
409
  bookkeepingPaths: bookkeepingPaths(),
390
410
  pipelineStatePath: target.statePath,
411
+ transitionReason: rateLimitRecoveryReason(outcome.state.stages.reporter.rate_limit_events ?? []) || undefined,
391
412
  });
392
413
  return lifecycleLock ? lifecycleLock.runExclusive(finalize) : finalize();
393
414
  }
@@ -1,12 +1,12 @@
1
1
  import { copyFileSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
2
2
  import { basename, dirname, resolve } from "node:path";
3
- import { sanitizeRegisterConclusion, } from "./exec-register.js";
4
- import { applyRegisterItemFields, CELL_NONE, readRegisterItemContent, registerItemFieldsFromItem, } from "./register-item.js";
5
- import { appendGitFailureLog, gitOutput, gitResult, summarizeGitHookFailure, } from "./exec-worktree.js";
6
- import { abortMerge, currentBranch, normalizeResultWhitespace, releaseRootWorkingCopies, stabilizeCommitTargets, stageCommitTargets, unstageCommitTargets, worktreeStatusPaths, } from "./exec-worktree-ops.js";
7
- import { pathInsideWorktree } from "./exec-run-agent.js";
8
- import { repoRelativePath } from "./exec-run-mode-shared.js";
9
- import { spawnRegisterTransition, registerEventPathForTicket, registerRunnerManagedPaths, } from "./exec-run-register-core.js";
3
+ import { sanitizeRegisterConclusion, } from "../register.js";
4
+ import { applyRegisterItemFields, CELL_NONE, readRegisterItemContent, registerItemFieldsFromItem, } from "../../register/item.js";
5
+ import { appendGitFailureLog, appendGitResultFailureLog, formatGitResultFailure, gitOutput, gitResult, summarizeGitHookFailure, } from "../worktree.js";
6
+ import { abortMerge, currentBranch, normalizeResultWhitespace, releaseRootWorkingCopies, stabilizeCommitTargets, stageCommitTargets, unstageCommitTargets, worktreeStatusPaths, } from "../worktree-ops.js";
7
+ import { pathInsideWorktree } from "./agent.js";
8
+ import { repoRelativePath } from "./mode-shared.js";
9
+ import { spawnRegisterTransition, registerEventPathForTicket, registerRunnerManagedPaths, } from "./register-core.js";
10
10
  // register の状態遷移(start/review/wait)が変更した調整状態(pjr-index と派生ビュー)だけを
11
11
  // 抽出する。worktree モードでは成功時の遷移を exec branch、失敗時の wait を root で commit
12
12
  // する。plan/result は checkpoint と worktree merge が扱うため、ここでは含めない。
@@ -42,11 +42,14 @@ export function commitRegisterState(repoRoot, registerPaths, message, ticketPath
42
42
  const remainingPaths = () => registerStatePaths(repoRoot, registerPaths, ticketPath);
43
43
  try {
44
44
  stageCommitTargets(repoRoot, paths);
45
- const staged = gitResult(repoRoot, ["diff", "--cached", "--quiet", "--", ...paths]);
45
+ const stagedArgs = ["diff", "--cached", "--quiet", "--", ...paths];
46
+ const staged = gitResult(repoRoot, stagedArgs);
46
47
  if (staged.status === 0)
47
48
  return;
48
- if (staged.status !== 1)
49
- throw new Error("Failed to inspect staged register-state changes.");
49
+ if (staged.status !== 1) {
50
+ appendGitResultFailureLog(failureLogPath, "git diff register-state inspection", staged);
51
+ throw new Error(`Failed to inspect staged register-state changes: ${formatGitResultFailure(stagedArgs, staged)}`);
52
+ }
50
53
  const commit = gitResult(repoRoot, ["commit", "-m", message, "--", ...paths]);
51
54
  if (commit.status !== 0) {
52
55
  const output = [commit.stdout, commit.stderr]