specdojo 0.2.1 → 0.3.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 (242) hide show
  1. package/.github/agents/specdojo-orchestrator.md +165 -0
  2. package/CHANGELOG.md +298 -0
  3. package/README.md +92 -42
  4. package/dist/agent-response.js +20 -0
  5. package/dist/agent.js +4 -4
  6. package/dist/build-command.js +28 -8
  7. package/dist/catalog-build-references.js +144 -0
  8. package/dist/catalog-build-render.js +144 -0
  9. package/dist/catalog-build.js +13 -290
  10. package/dist/catalog-generate.js +6 -9
  11. package/dist/catalog-plan-generate.js +2 -2
  12. package/dist/catalog-plan.js +6 -6
  13. package/dist/catalog-scaffold.js +4 -4
  14. package/dist/catalog.js +2 -2
  15. package/dist/dashboard-exec-records.js +105 -0
  16. package/dist/dashboard-routines.js +255 -0
  17. package/dist/dashboard-shared.js +14 -0
  18. package/dist/dashboard-timeline.js +175 -0
  19. package/dist/dashboard.js +31 -444
  20. package/dist/deliverable-trash.js +3 -3
  21. package/dist/devcontainer-command.js +43 -0
  22. package/dist/devcontainer-scaffold.js +165 -0
  23. package/dist/doc-index.js +3 -3
  24. package/dist/exec-agent-config.js +107 -9
  25. package/dist/exec-agent-git-state.js +18 -0
  26. package/dist/exec-agent-protected-config.js +46 -8
  27. package/dist/exec-commands.js +557 -0
  28. package/dist/exec-core.js +457 -0
  29. package/dist/exec-evidence.js +254 -11
  30. package/dist/exec-handoff.js +336 -0
  31. package/dist/exec-parent-validation.js +317 -43
  32. package/dist/exec-pipeline-state.js +74 -9
  33. package/dist/exec-plans-core.js +693 -0
  34. package/dist/exec-plans-generation.js +206 -0
  35. package/dist/exec-plans-storage.js +131 -0
  36. package/dist/exec-plans.js +3 -1016
  37. package/dist/exec-protection-handoff.js +43 -2
  38. package/dist/exec-provider-scaffold.js +247 -15
  39. package/dist/exec-register-resume.js +65 -19
  40. package/dist/exec-register.js +9 -3
  41. package/dist/exec-repo-integration-git.js +23 -0
  42. package/dist/exec-repo-integration-sync.js +264 -0
  43. package/dist/exec-repo-integration.js +534 -0
  44. package/dist/exec-repo-trace.js +182 -0
  45. package/dist/exec-reporter-output.js +206 -0
  46. package/dist/exec-reporter.js +525 -248
  47. package/dist/exec-results.js +103 -71
  48. package/dist/exec-run-agent-pipeline.js +256 -0
  49. package/dist/exec-run-agent.js +531 -0
  50. package/dist/exec-run-in-place.js +541 -0
  51. package/dist/exec-run-job.js +717 -0
  52. package/dist/exec-run-lifecycle-commands.js +522 -0
  53. package/dist/exec-run-lock.js +110 -107
  54. package/dist/exec-run-mode-shared.js +140 -0
  55. package/dist/exec-run-register-command.js +244 -0
  56. package/dist/exec-run-register-core.js +386 -0
  57. package/dist/exec-run-register-mode.js +206 -0
  58. package/dist/exec-run-register-resume.js +393 -0
  59. package/dist/exec-run-register-state.js +322 -0
  60. package/dist/exec-run-register-worktree.js +509 -0
  61. package/dist/exec-run-schedule-mode.js +294 -0
  62. package/dist/exec-run-schedule-prepare.js +353 -0
  63. package/dist/exec-run-schedule-task.js +572 -0
  64. package/dist/exec-run-shared.js +399 -0
  65. package/dist/exec-run.js +11 -4953
  66. package/dist/exec-shared.js +9 -2
  67. package/dist/exec-slot-lock.js +242 -0
  68. package/dist/exec-task-repos.js +415 -0
  69. package/dist/exec-trial-commands.js +558 -0
  70. package/dist/exec-trial-core.js +371 -0
  71. package/dist/exec-trial.js +2 -895
  72. package/dist/exec-worktree-command.js +87 -43
  73. package/dist/exec-worktree-ops-commit.js +707 -0
  74. package/dist/exec-worktree-ops-lifecycle.js +292 -0
  75. package/dist/exec-worktree-ops-merge.js +303 -0
  76. package/dist/exec-worktree-ops.js +3 -847
  77. package/dist/exec-worktree.js +146 -31
  78. package/dist/exec.js +2 -999
  79. package/dist/frontmatter-namespace.js +2 -2
  80. package/dist/grade-apply.js +734 -0
  81. package/dist/grade-command-apply.js +250 -0
  82. package/dist/grade-command-inspect.js +138 -0
  83. package/dist/grade-command-plan.js +101 -0
  84. package/dist/grade-command-shared.js +68 -0
  85. package/dist/grade-core.js +307 -0
  86. package/dist/grade-markdown.js +274 -0
  87. package/dist/grade-pipeline-state.js +184 -0
  88. package/dist/grade-plan.js +507 -0
  89. package/dist/grade-result.js +133 -5
  90. package/dist/grade-target-discovery.js +265 -0
  91. package/dist/grade-targets.js +432 -0
  92. package/dist/grade.js +14 -2451
  93. package/dist/init-command.js +443 -0
  94. package/dist/job-definition.js +670 -0
  95. package/dist/job.js +64 -578
  96. package/dist/kata-command.js +2 -2
  97. package/dist/orchestrator.js +213 -0
  98. package/dist/register-command-types.js +1 -0
  99. package/dist/register-core.js +363 -0
  100. package/dist/register-create-commands.js +245 -0
  101. package/dist/register-event-merge.js +169 -0
  102. package/dist/register-events.js +4 -4
  103. package/dist/register-item.js +13 -7
  104. package/dist/register-maintenance-commands.js +187 -0
  105. package/dist/register-migration.js +268 -0
  106. package/dist/register-renumber.js +314 -0
  107. package/dist/register-transition-commands.js +248 -0
  108. package/dist/register-update.js +230 -0
  109. package/dist/register-views.js +256 -0
  110. package/dist/register.js +175 -1975
  111. package/dist/review-grade.js +252 -0
  112. package/dist/review-plan.js +114 -4
  113. package/dist/review-types.js +40 -1
  114. package/dist/routine-definition.js +401 -0
  115. package/dist/routine.js +73 -402
  116. package/dist/schedule-approach.js +2 -2
  117. package/dist/schedule-build.js +2 -2
  118. package/dist/schedule-strategy-generate-document.js +273 -0
  119. package/dist/schedule-strategy-generate-scope.js +199 -0
  120. package/dist/schedule-strategy-generate.js +9 -473
  121. package/dist/schedule.js +19 -6
  122. package/dist/specdojo-config.js +465 -20
  123. package/dist/specdojo-gitignore.js +135 -0
  124. package/dist/specdojo.js +6 -0
  125. package/dist/viewpoint-document-kinds-check.js +128 -0
  126. package/dist/yaml-pages.js +4 -4
  127. package/dist/yaml.js +28 -0
  128. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +348 -90
  129. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +51 -17
  130. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +7 -5
  131. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +29 -31
  132. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +34 -55
  133. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +54 -0
  134. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +28 -37
  135. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +29 -34
  136. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +30 -30
  137. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +29 -34
  138. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +29 -34
  139. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +29 -34
  140. package/docs/ja/specdojo/exec-templates/xrp-template.md +29 -28
  141. package/docs/ja/specdojo/exec-templates/xrr-template.md +11 -9
  142. package/docs/ja/specdojo/guides/docs-editing-guide.md +20 -0
  143. package/docs/ja/specdojo/guides/docs-structure-guide.md +103 -70
  144. package/docs/ja/specdojo/guides/exec-config-guide.md +93 -49
  145. package/docs/ja/specdojo/guides/exec-operation-guide.md +124 -27
  146. package/docs/ja/specdojo/guides/exec-worktree-guide.md +40 -11
  147. package/docs/ja/specdojo/guides/kata-guide.md +4 -4
  148. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +45 -22
  149. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
  150. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +13 -13
  151. package/docs/ja/specdojo/guides/quick-start-guide.md +260 -30
  152. package/docs/ja/specdojo/guides/register-operation-guide.md +31 -14
  153. package/docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md +264 -0
  154. package/docs/ja/specdojo/guides/remote-host-development-guide.md +22 -1
  155. package/docs/ja/specdojo/guides/review-guide.md +195 -158
  156. package/docs/ja/specdojo/guides/routine-operation-guide.md +75 -10
  157. package/docs/ja/specdojo/guides/ryu-guide.md +32 -30
  158. package/docs/ja/specdojo/guides/schedule-design-guide.md +10 -10
  159. package/docs/ja/specdojo/guides/schedule-operation-guide.md +1 -1
  160. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +58 -33
  161. package/docs/ja/specdojo/guides/use-case-guide.md +3 -3
  162. package/docs/ja/specdojo/guides/waza-guide.md +15 -2
  163. package/docs/ja/specdojo/index.md +2 -2
  164. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +5 -5
  165. package/docs/ja/specdojo/recipes/bps-recipe.md +213 -0
  166. package/docs/ja/specdojo/recipes/pm-members-recipe.md +52 -117
  167. package/docs/ja/specdojo/references/command-reference.md +335 -92
  168. package/docs/ja/specdojo/references/deliverables-reference.md +1 -1
  169. package/docs/ja/specdojo/references/directory-layout-reference.md +13 -9
  170. package/docs/ja/specdojo/references/specdojo-config-reference.md +107 -24
  171. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +132 -220
  172. package/docs/ja/specdojo/rulebooks/br-rulebook.md +6 -44
  173. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +2 -0
  174. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +0 -87
  175. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +61 -39
  176. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +0 -87
  177. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +1 -33
  178. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +0 -137
  179. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +0 -247
  180. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +0 -83
  181. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -2
  182. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +78 -150
  183. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +5 -4
  184. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -1
  185. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +0 -11
  186. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +0 -61
  187. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +2 -47
  188. package/docs/ja/specdojo/samples/bps-sample.md +74 -21
  189. package/docs/ja/specdojo/samples/gl-sample.yaml +17 -1
  190. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +28 -0
  191. package/docs/ja/specdojo/samples/pm-members-sample.yaml +2 -67
  192. package/docs/ja/specdojo/samples/pm-organization-sample.md +8 -7
  193. package/docs/ja/specdojo/samples/pm-raci-sample.md +1 -1
  194. package/docs/ja/specdojo/samples/tml-sample.yaml +40 -0
  195. package/docs/ja/specdojo/standards/document-metadata-standard.md +21 -16
  196. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +14 -14
  197. package/docs/ja/specdojo/standards/job-definition-standard.md +37 -17
  198. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +37 -32
  199. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -1
  200. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +21 -11
  201. package/docs/ja/specdojo/templates/agent-members-template.yaml +25 -0
  202. package/docs/ja/specdojo/templates/bps-template.md +91 -0
  203. package/docs/ja/specdojo/templates/pm-members-template.yaml +2 -59
  204. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +76 -0
  205. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -2
  206. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +55 -2
  207. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +93 -6
  208. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +27 -78
  209. package/docs/specdojo/schemas/v1/gl.schema.yaml +87 -0
  210. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +33 -0
  211. package/docs/specdojo/schemas/v1/job-run.schema.yaml +27 -0
  212. package/docs/specdojo/schemas/v1/job.schema.yaml +25 -0
  213. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +49 -1
  214. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +9 -169
  215. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +100 -10
  216. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +13 -0
  217. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +3 -0
  218. package/docs/specdojo/schemas/v1/routine.schema.yaml +7 -0
  219. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +110 -0
  220. package/package.json +17 -12
  221. package/templates/antigravity/README.md +29 -4
  222. package/templates/antigravity/{pm-members-snippet.yaml → agent-members-snippet.yaml} +8 -2
  223. package/templates/antigravity/exec-defaults-snippet.yaml +10 -7
  224. package/templates/antigravity/orchestrator.md +18 -7
  225. package/templates/antigravity/settings.global.json +55 -0
  226. package/templates/claude/agents/claude-executor.md +14 -0
  227. package/templates/claude/agents/claude-reporter.md +16 -0
  228. package/templates/claude/agents/specdojo-orchestrator.md +18 -7
  229. package/templates/claude/settings.edit.json +27 -1
  230. package/templates/codex/README.md +5 -4
  231. package/templates/codex/agents/specdojo-orchestrator.toml +18 -7
  232. package/templates/codex/orchestrator.md +18 -7
  233. package/templates/copilot/README.md +7 -5
  234. package/templates/copilot/{pm-members-snippet.yaml → agent-members-snippet.yaml} +4 -2
  235. package/templates/devcontainer/devcontainer.json +27 -0
  236. package/templates/devcontainer/emacs/init.el +88 -0
  237. package/templates/devcontainer/post-create.sh +62 -0
  238. package/templates/init-agent-members.yaml +200 -0
  239. package/templates/init-exec-defaults.yaml +74 -0
  240. package/templates/opencode/agents/specdojo-orchestrator.md +18 -7
  241. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +0 -7
  242. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +0 -7
@@ -0,0 +1,393 @@
1
+ import { existsSync, readFileSync } from "node:fs";
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";
20
+ // reporter 再開に使う agent を解決する。--reporter-by を優先し、省略時は再開対象 run の
21
+ // pipeline-state に記録された reporter actor(通常は前回と同じ agent)へフォールバックする。
22
+ export function resolveRegisterResumeReporter(roster, opts, execDefaults, recordedActor) {
23
+ const nickname = (opts.reporterBy ?? recordedActor ?? "").trim();
24
+ if (!nickname) {
25
+ return {
26
+ kind: "error",
27
+ message: "reporter agent is unknown for this run; specify --reporter-by <nickname>",
28
+ };
29
+ }
30
+ const resolution = resolveAgentOverride("edit", nickname, {}, roster, execDefaults, "reporter");
31
+ if (resolution.kind === "error") {
32
+ return { kind: "error", message: resolution.message.replace(/^--by/, "--reporter-by") };
33
+ }
34
+ if (resolution.kind !== "command") {
35
+ return {
36
+ kind: "error",
37
+ message: `reporter agent not found in agent-members.yaml: ${nickname}`,
38
+ };
39
+ }
40
+ return {
41
+ kind: "command",
42
+ candidate: {
43
+ command: resolution.command,
44
+ actor: resolution.actor ?? nickname,
45
+ provider: resolution.provider,
46
+ },
47
+ };
48
+ }
49
+ // stale な running executor を既存 worktree 上で再実行するときの agent を解決する。
50
+ // --executor-by を優先し、省略時は pipeline-state に記録された actor を引き継ぐ。
51
+ export function resolveRegisterResumeExecutor(roster, opts, execDefaults, recordedActor) {
52
+ const nickname = (opts.executorBy ?? recordedActor ?? "").trim();
53
+ if (!nickname) {
54
+ return {
55
+ kind: "error",
56
+ message: "executor agent is unknown for this run; specify --executor-by <nickname>",
57
+ };
58
+ }
59
+ const resolution = resolveAgentOverride("edit", nickname, {}, roster, execDefaults, "executor");
60
+ if (resolution.kind === "error") {
61
+ return { kind: "error", message: resolution.message.replace(/^--by/, "--executor-by") };
62
+ }
63
+ if (resolution.kind !== "command") {
64
+ return {
65
+ kind: "error",
66
+ message: `executor agent not found in agent-members.yaml: ${nickname}`,
67
+ };
68
+ }
69
+ return {
70
+ kind: "command",
71
+ candidate: {
72
+ command: resolution.command,
73
+ actor: resolution.actor ?? nickname,
74
+ provider: resolution.provider,
75
+ },
76
+ };
77
+ }
78
+ // 統合段だけの再開。executor と reporter が成功済みで、commit → merge → worktree 撤去のいずれかが
79
+ // 失敗した run を、agent を1つも起動せずに統合からやり直す。worktree の成果物と evidence をそのまま
80
+ // 使い、成功なら通常実行と同じ review 遷移、merge 前の失敗なら waiting へ戻す。すでに merge
81
+ // 済みなら review を維持して cleanup だけを再試行する(失敗時も worktree は保持する)。
82
+ export async function resumeRegisterIntegration(params) {
83
+ const { item, worktree, target, worktreeResultPath, actor } = params;
84
+ process.stdout.write(`Register item: ${item.id} — ${item.title} [${item.type}]\n`);
85
+ process.stdout.write(` Resuming integration from run ${target.runId} (reporter result: ${params.stem}-result.md)\n` +
86
+ ` CWD: ${worktree.path}\n Actor: ${actor} (runner-owned integration)\n`);
87
+ // waiting のまま統合しないよう、通常実行と同じく in-progress へ戻してから統合する。ただし
88
+ // merge 済みで worktree 撤去だけを再試行する場合は、root はすでに review なので遷移を
89
+ // 再記録しない(finalize は cleanup だけを行う)。
90
+ let validationFailure;
91
+ if (!isExecBranchMergedIntoCurrent({
92
+ context: {
93
+ repoRoot: params.context.repoRoot,
94
+ schedulePath: params.context.schedulePath,
95
+ executionPath: params.context.executionPath,
96
+ },
97
+ worktree,
98
+ })) {
99
+ const beginFailure = await params.begin(actor, "integration resumed");
100
+ if (beginFailure)
101
+ return beginFailure;
102
+ // PJR-GENJ: 統合先の最新を取り込んだ worktree で親検証をやり直し、失敗なら統合せず waiting へ
103
+ // 戻す。前回の親検証が失敗・未記録の場合も同じく検証してから統合する。
104
+ if (target.stage === "integrate") {
105
+ const evidence = await refreshParentValidationsForReporterResume({
106
+ execDefaults: params.context.execDefaults,
107
+ cwd: worktree.path,
108
+ productWorktrees: worktree.repos,
109
+ evidence: target.evidence,
110
+ evidencePath: resolve(worktree.path, target.evidenceRef),
111
+ force: params.syncedIntegrationTargets,
112
+ stageLabel: "integration",
113
+ });
114
+ validationFailure = failedParentValidationReason(evidence.validations);
115
+ }
116
+ }
117
+ // reporter が記入済みの result をそのまま使う。agent は起動しないため、成果は success 扱いで
118
+ // 統合だけを実行する(result が未記入なら finalize 側の downgrade が blocked に落とす)。
119
+ const resultScaffold = readResultFrontmatterSnapshot(worktreeResultPath);
120
+ const finalize = async () => finalizeRegisterWorktreeRun({
121
+ context: params.context,
122
+ registerPaths: params.registerPaths,
123
+ item,
124
+ ticketPath: params.ticketPath,
125
+ worktree,
126
+ stem: params.stem,
127
+ worktreeResultPath,
128
+ resultScaffold,
129
+ agentResult: validationFailure ? "failure" : "success",
130
+ stderr: validationFailure ?? "",
131
+ ...(validationFailure ? { runnerBlockReason: validationFailure } : {}),
132
+ actor,
133
+ bookkeepingPaths: params.bookkeepingPaths(),
134
+ pipelineStatePath: target.statePath,
135
+ resumedIntegration: true,
136
+ });
137
+ return params.lifecycleLock ? params.lifecycleLock.runExclusive(finalize) : finalize();
138
+ }
139
+ // register 項目1件の再開。途中で止まった run を、既存 worktree と evidence を保持したまま
140
+ // 止まった段からやり直す。running のまま残った executor は同じ plan/result と worktree 上で
141
+ // 再実行し、reporter 段の再開は reporter だけを起動する。統合段は agent を起動せずに
142
+ // commit → merge → worktree 撤去だけをやり直す。入力は対象 run の
143
+ // `pipeline-state.json`(plan / result の参照と stage 状態)と `evidence.json`(executor の記録)で、
144
+ // 成功後の commit → merge → register review は通常実行と同じ finalizeRegisterWorktreeRun を通す。
145
+ // 再開できない場合(worktree 不在、入力成果物欠損など)は破壊的操作を行わず理由を返す。
146
+ export async function resumeSingleRegisterItemWorktree(context, opts, pjrId, lifecycleLock) {
147
+ const { projectId, schedulePath, executionPath, repoRoot } = context;
148
+ const { registerPaths, item } = resolveRegisterRunTarget(projectId, pjrId);
149
+ const ticketPath = ticketPathFromItem(item, registerPaths.projectRegisterPath);
150
+ requireRunnableRegisterItem(item);
151
+ // 再開できない場合は register の状態も worktree も変更せず、理由だけを返す。
152
+ const refuse = (reason) => {
153
+ process.stderr.write(`resume refused: ${item.id}: ${reason}\n`);
154
+ return {
155
+ id: item.id,
156
+ title: item.title,
157
+ outcome: "failure",
158
+ transition: "none",
159
+ commit: "off",
160
+ reason: sanitizeRegisterConclusion(reason),
161
+ };
162
+ };
163
+ const worktreeTaskId = qualifyTaskId(projectId, item.id);
164
+ const foundWorktree = findExecWorktree(repoRoot, worktreeTaskId);
165
+ if (!foundWorktree) {
166
+ return refuse(`no exec worktree to resume for ${item.id}; run the item again instead`);
167
+ }
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
+ const lookup = findResumableRegisterRun({
178
+ repoRoot,
179
+ worktreePath: worktree.path,
180
+ executionPath,
181
+ taskId: item.id,
182
+ ...(opts.resumeFrom === "executor" ? { resumeFrom: "executor" } : {}),
183
+ });
184
+ if (lookup.kind !== "resumable")
185
+ return refuse(lookup.reason);
186
+ const target = lookup.target;
187
+ const artifacts = resolveRegisterResumeArtifacts({
188
+ repoRoot,
189
+ worktreePath: worktree.path,
190
+ executionPath,
191
+ taskId: item.id,
192
+ state: target.state,
193
+ });
194
+ if (!artifacts)
195
+ return refuse(`cannot restore the plan/result of run ${target.runId}`);
196
+ const worktreeResultPath = resolve(worktree.path, artifacts.resultRef);
197
+ if (!existsSync(worktreeResultPath)) {
198
+ return refuse(`result not found in the worktree: ${artifacts.resultRef}`);
199
+ }
200
+ // root 側の実行管理ファイル。plan / result は前回の wait commit で統合ブランチに入っている。
201
+ // begin は個票と event を root へ写し、派生ビューを再生成する。その後の差分を拾うため、
202
+ // 再開開始前に集合を固定せず finalize の直前に評価する。
203
+ const bookkeepingPaths = () => registerBookkeepingPaths({
204
+ repoRoot,
205
+ registerPaths,
206
+ planPath: resolve(repoRoot, artifacts.planRef),
207
+ resultPath: resolve(repoRoot, artifacts.resultRef),
208
+ ticketPath,
209
+ });
210
+ // waiting のまま再開しないよう、通常実行と同じく in-progress へ戻す。遷移は exec branch
211
+ // 側の worktree で記録し(統合ブランチに独立した resume commit を作らない)、成功時は
212
+ // review とともに merge commit へ畳み込む。再び失敗した場合は finalize が start / wait を
213
+ // root の wait commit 1件へまとめる。root には個票・イベントを未 commit のまま写し、
214
+ // 実行中の状態が root からも見えるようにする(merge 前に解放する)。
215
+ const begin = async (actor, transitionReason) => {
216
+ const start = () => {
217
+ if (!spawnRegisterTransition(projectId, ["start", "--id", item.id, "--by", actor, "--reason", transitionReason], worktree.path)) {
218
+ return refuse(`register start failed: ${item.id}`);
219
+ }
220
+ copyRepoPaths(worktree.path, repoRoot, repoRoot, registerTransitionPaths(registerPaths, ticketPath));
221
+ rebuildRootRegisterViews(projectId, item.id);
222
+ return null;
223
+ };
224
+ return lifecycleLock ? lifecycleLock.runExclusive(start) : start();
225
+ };
226
+ // PJR-GENJ / PJR-PG6W: どの段の再開でも、親検証または agent の起動前に統合先の最新を exec
227
+ // branch と worktree へ取り込む。wait 後に統合先で直した不具合や、人が適用した保護対象設定を
228
+ // executor に反映するためである。register の遷移(begin)より前に行い、取り込めない場合は状態を
229
+ // 変えずに再開を拒否する。merge 済みで撤去だけが残る統合再開は取り込まない。
230
+ // PJR-6RN3: 前回の統合段で統合済み(merged / unchanged)と記録されたプロダクトも取り込まない。
231
+ // 取り込むと exec branch に新しい merge commit ができ、統合段がそのプロダクトを再び統合する。
232
+ let syncedIntegrationTargets = false;
233
+ if (!isExecBranchMergedIntoCurrent({
234
+ context: { repoRoot, schedulePath, executionPath },
235
+ worktree,
236
+ })) {
237
+ let synced;
238
+ try {
239
+ const projectTarget = currentBranch(repoRoot);
240
+ process.stdout.write(` Syncing integration targets before ${target.stage} resume: ${item.id}\n`);
241
+ synced = syncTaskWorktreesWithIntegrationTargets({
242
+ worktree,
243
+ projectTarget,
244
+ message: `exec(register ${item.id}): merge integration target before resume`,
245
+ projectTheirsPaths: bookkeepingPaths().map((path) => repoRelativePath(repoRoot, path)),
246
+ integratedProducts: integratedRepoNames(target.state),
247
+ });
248
+ }
249
+ catch (error) {
250
+ return refuse(`cannot sync the worktree with the integration target before resume: ` +
251
+ `${error instanceof Error ? error.message : String(error)}; ` +
252
+ `resolve it in ${worktree.path} and resume again`);
253
+ }
254
+ for (const entry of synced) {
255
+ process.stdout.write(` [sync] ${entry.repo}: ${entry.status} (${entry.target})` +
256
+ `${entry.detail ? ` — ${entry.detail}` : ""}\n`);
257
+ }
258
+ syncedIntegrationTargets = synced.some((entry) => entry.status === "merged");
259
+ }
260
+ if (target.stage === "integrate") {
261
+ // 統合は runner の作業だが、register の遷移とイベントには実行者が必要になる。前回 run の
262
+ // reporter(無ければ executor)を引き継ぎ、--reporter-by で明示指定もできる。
263
+ const actor = (opts.reporterBy ??
264
+ target.state.stages.reporter.actor ??
265
+ target.state.stages.executor.actor ??
266
+ "").trim();
267
+ if (!actor) {
268
+ return refuse(`the actor of run ${target.runId} is unknown; specify --reporter-by <nickname>`);
269
+ }
270
+ return resumeRegisterIntegration({
271
+ context,
272
+ registerPaths,
273
+ item,
274
+ ticketPath,
275
+ worktree,
276
+ target,
277
+ stem: artifacts.stem,
278
+ worktreeResultPath,
279
+ actor,
280
+ bookkeepingPaths,
281
+ begin,
282
+ lifecycleLock,
283
+ syncedIntegrationTargets,
284
+ });
285
+ }
286
+ // plan は root(統合ブランチ)の checkpoint 済みファイルを正本にする。worktree 側の plan は
287
+ // agent が書き換えられるため、再開のプロンプト入力には使わない。
288
+ const planPath = resolve(repoRoot, artifacts.planRef);
289
+ if (!existsSync(planPath))
290
+ return refuse(`plan not found for the resumed run: ${artifacts.planRef}`);
291
+ const prompt = expandPromptRefs(readFileSync(planPath, "utf8"));
292
+ if (target.stage === "executor") {
293
+ const executor = resolveRegisterResumeExecutor(context.roster, opts, context.execDefaults, target.state.stages.executor.actor);
294
+ if (executor.kind === "error")
295
+ return refuse(executor.message);
296
+ const reporter = resolveRegisterResumeReporter(context.roster, opts, context.execDefaults, target.state.stages.reporter.actor);
297
+ if (reporter.kind === "error")
298
+ return refuse(reporter.message);
299
+ process.stdout.write(`Register item: ${item.id} — ${item.title} [${item.type}]\n`);
300
+ process.stdout.write(` Resuming executor from run ${target.runId} in a new pipeline checkpoint\n` +
301
+ ` CWD: ${worktree.path}\n Agent: ${executor.candidate.actor} (executor)\n`);
302
+ const beginFailure = await begin(executor.candidate.actor, "executor resumed");
303
+ if (beginFailure)
304
+ return beginFailure;
305
+ const resultScaffold = readResultFrontmatterSnapshot(worktreeResultPath);
306
+ const outcome = await runAgentPipeline({
307
+ repoRoot,
308
+ cwd: worktree.path,
309
+ schedulePath,
310
+ executionPath,
311
+ taskId: item.id,
312
+ executor: executor.candidate,
313
+ reporterCandidates: [reporter.candidate],
314
+ planPath,
315
+ planPrompt: prompt,
316
+ resultPath: worktreeResultPath,
317
+ registerPaths: registerReporterManagedPaths(registerPaths),
318
+ execDefaults: context.execDefaults,
319
+ resumedExecutor: true,
320
+ initialChangeTargets: target.initialChanges,
321
+ resumeHandoff: target.handoff,
322
+ providerConcurrencyGate: context.providerConcurrencyGate,
323
+ productWorktrees: worktree.repos,
324
+ });
325
+ const finalize = async () => finalizeRegisterWorktreeRun({
326
+ context,
327
+ registerPaths,
328
+ item,
329
+ ticketPath,
330
+ worktree,
331
+ stem: artifacts.stem,
332
+ worktreeResultPath,
333
+ resultScaffold,
334
+ agentResult: outcome.runResult,
335
+ stderr: outcome.blockReason ?? "",
336
+ actor: executor.candidate.actor,
337
+ bookkeepingPaths: bookkeepingPaths(),
338
+ pipelineStatePath: resolve(worktree.path, outcome.stateRef),
339
+ });
340
+ return lifecycleLock ? lifecycleLock.runExclusive(finalize) : finalize();
341
+ }
342
+ const reporter = resolveRegisterResumeReporter(context.roster, opts, context.execDefaults, target.state.stages.reporter.actor);
343
+ if (reporter.kind === "error")
344
+ return refuse(reporter.message);
345
+ process.stdout.write(`Register item: ${item.id} — ${item.title} [${item.type}]\n`);
346
+ process.stdout.write(` Resuming reporter from run ${target.runId} (executor evidence: ${target.evidenceRef})\n` +
347
+ ` CWD: ${worktree.path}\n Agent: ${reporter.candidate.actor} (reporter)\n`);
348
+ const beginFailure = await begin(reporter.candidate.actor, "reporter resumed");
349
+ if (beginFailure)
350
+ return beginFailure;
351
+ const evidence = await refreshParentValidationsForReporterResume({
352
+ execDefaults: context.execDefaults,
353
+ cwd: worktree.path,
354
+ productWorktrees: worktree.repos,
355
+ evidence: target.evidence,
356
+ evidencePath: resolve(worktree.path, target.evidenceRef),
357
+ force: syncedIntegrationTargets,
358
+ });
359
+ const resultScaffold = readResultFrontmatterSnapshot(worktreeResultPath);
360
+ const outcome = await runReporterStage({
361
+ repoRoot,
362
+ cwd: worktree.path,
363
+ schedulePath,
364
+ executionPath,
365
+ reporterCandidates: [reporter.candidate],
366
+ planPrompt: prompt,
367
+ resultPath: worktreeResultPath,
368
+ registerPaths: registerReporterManagedPaths(registerPaths),
369
+ execDefaults: context.execDefaults,
370
+ evidence,
371
+ evidencePath: resolve(worktree.path, target.evidenceRef),
372
+ state: target.state,
373
+ statePath: target.statePath,
374
+ providerConcurrencyGate: context.providerConcurrencyGate,
375
+ productWorktrees: worktree.repos,
376
+ });
377
+ const finalize = async () => finalizeRegisterWorktreeRun({
378
+ context,
379
+ registerPaths,
380
+ item,
381
+ ticketPath,
382
+ worktree,
383
+ stem: artifacts.stem,
384
+ worktreeResultPath,
385
+ resultScaffold,
386
+ agentResult: outcome.runResult,
387
+ stderr: outcome.blockReason ?? "",
388
+ actor: reporter.candidate.actor,
389
+ bookkeepingPaths: bookkeepingPaths(),
390
+ pipelineStatePath: target.statePath,
391
+ });
392
+ return lifecycleLock ? lifecycleLock.runExclusive(finalize) : finalize();
393
+ }