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
@@ -93,12 +93,34 @@ SpecDojo Configuration Reference
93
93
 
94
94
  `projects.<project-id>.run` に指定します。これらのパスは `base_path` の影響を受けず、リポジトリルート基準です。
95
95
 
96
- | キー | 既定値 | 役割・利用箇所 |
97
- | ------------------------ | -------------- | ------------------------------------------------------------------------------------------------------------- |
98
- | `exec_defaults` | なし | provider、権限、リトライなどを定義する exec defaults ファイルです。agent を起動する `exec run` が参照します。 |
99
- | `agent_config` | なし | `exec_defaults` の旧キーです。互換目的でのみ利用し、新しい設定では `exec_defaults` を使います。 |
100
- | `worktree_base` | `../worktrees` | `exec run --worktree` / `--auto` と `exec trial` が作る worktree の親です。リポジトリ外を指定します。 |
101
- | `register_date_timezone` | `UTC` | 登録簿の「登録日」「完了日」を日時から暦日へ変換する IANA タイムゾーン名です。例は `Asia/Tokyo` です。 |
96
+ | キー | 既定値 | 役割・利用箇所 |
97
+ | ------------------------ | -------------- | ---------------------------------------------------------------------------------------------------------------------------- |
98
+ | `exec_defaults` | なし | provider、権限、リトライなどを定義する exec defaults ファイルです。agent を起動する `exec run` が参照します。 |
99
+ | `agent_config` | なし | `exec_defaults` の旧キーです。互換目的でのみ利用し、新しい設定では `exec_defaults` を使います。 |
100
+ | `parent_validations` | `[]` | この project だけで追加する親 runner の検証です。`exec_defaults` の `pipeline.parent_validations` の後ろへ指定順に加えます。 |
101
+ | `worktree_base` | `../worktrees` | `exec run --worktree` / `--auto` と `exec trial` が作る worktree の親です。リポジトリ外を指定します。 |
102
+ | `register_date_timezone` | `UTC` | 登録簿の「登録日」「完了日」を日時から暦日へ変換する IANA タイムゾーン名です。例は `Asia/Tokyo` です。 |
103
+
104
+ `parent_validations` の要素は、共有 defaults と同じく検証 ID、または `{ "id": "<id>", "repo": "<repo>" }` です。共有 defaults を複製せず、プロダクトリポジトリを持つ project だけに検証を追加できます。たとえば `prj-0002` だけで `specdojo-lp` の型と lint を検査する設定は次のとおりです。
105
+
106
+ ```json
107
+ {
108
+ "projects": {
109
+ "prj-0002": {
110
+ "repos": [{ "name": "specdojo-lp", "path": "../specdojo-lp" }],
111
+ "run": {
112
+ "exec_defaults": ".specdojo/exec-defaults.yaml",
113
+ "parent_validations": [
114
+ { "id": "typecheck", "repo": "specdojo-lp" },
115
+ { "id": "lint-ts", "repo": "specdojo-lp" }
116
+ ]
117
+ }
118
+ }
119
+ }
120
+ }
121
+ ```
122
+
123
+ 有効な一覧は「共有 defaults の `pipeline.parent_validations` → project の `run.parent_validations`」の順です。同じ ID と実行先の組が両方にある場合は重複として agent 起動前にエラーになります。`run.parent_validations` を省略した project には共有 defaults だけが適用されるため、`repos` を持たない別 project はプロダクトリポジトリ向けの追加検証に影響されません。許可される ID と実行結果の記録は [[specdojo:exec-config-guide|exec設定ガイド]] を参照してください。
102
124
 
103
125
  `config init` は一般既定の `../worktrees` ではなく、実行したリポジトリのディレクトリ名から作る `../<リポジトリ名>-worktrees` を `worktree_base` へ明示します。例えば `app1-specdojo/` で実行した場合は `../app1-specdojo-worktrees` です。
104
126
 
@@ -115,6 +137,8 @@ SpecDojo Configuration Reference
115
137
  | `integration_branch` | 任意 | そのリポジトリの現在のブランチ | exec が変更を統合する先のブランチです。exec branch もこのブランチの先端から作ります。 |
116
138
  | `setup` | 任意 | 両方 `true` | worktree 作成時の準備の有無です。`install`(依存導入)と `build`(生成物の build)を真偽値で指定します。 |
117
139
 
140
+ register の worktree 実行では、`exec run --integration-branch <repo>=<branch>` により `integration_branch` を run ごとに上書きできます。統合先の優先順位は「run の指定 → `repos[].integration_branch` → そのリポジトリの現在のブランチ」です。指定方法、ローカルブランチの検査、並列実行と再開時の扱いは [[specdojo:command-reference]] を参照してください。
141
+
118
142
  ```json
119
143
  {
120
144
  "base_path": "docs/ja/projects/prj-0001",
@@ -141,7 +165,7 @@ SpecDojo Configuration Reference
141
165
  `repos` を宣言した project の `exec run --worktree` と `exec worktree prepare` は、タスクごとに次の worktree を作ります。宣言の無い project は従来どおり `<worktree_base>/<task-id>/` の直下に 1 つだけ作ります。
142
166
 
143
167
  - `<worktree_base>/<task-id>/project/`: プロジェクトリポジトリの worktree です。agent の作業ディレクトリ(`cwd`)になります。`project` が予約名なのはこのためです。
144
- - `<worktree_base>/<task-id>/<name>/`: 宣言した各リポジトリの worktree です。exec branch は `integration_branch`(省略時は現在のブランチ)の先端から作ります。
168
+ - `<worktree_base>/<task-id>/<name>/`: 宣言した各リポジトリの worktree です。exec branch は run の `--integration-branch`、`integration_branch`、現在のブランチの順で解決した統合先の先端から作ります。
145
169
 
146
170
  agent には、各 worktree の絶対パスを次の環境変数で渡します。
147
171
 
@@ -169,6 +193,8 @@ agent 実行の前後で行う保護設定(`package.json`、CI 設定など)
169
193
 
170
194
  exec worktree の中で設定を読む場合(agent が worktree で `specdojo` を実行する場合など)、`path` の代わりに同じタスクの `<worktree_base>/<task-id>/<name>/` へ解決します。
171
195
 
196
+ `repos` を宣言した project では、`specdojo config scaffold --workspace` を実行すると、リポジトリルートに VS Code のマルチルートワークスペース(`<project-id>.code-workspace`)を生成できます。ワークスペースの `folders` にはプロジェクトリポジトリ(`.`)と宣言した各プロダクトリポジトリ(`repos[].path`)が宣言順に並び、VS Code で 1 つのウィンドウから両リポジトリを同時に操作できます。既存のワークスペースファイルは `--force` を付けない限り上書きしません。
197
+
172
198
  設定の読み込み時に、次の誤りを対象(`projects.<project-id>.repos[<n>]`)と原因を示すエラーにします。誤りは全 project 分をまとめて表示します。
173
199
 
174
200
  - `name` が `[a-z0-9-]` 以外の文字を含む、または同じ project 内で重複している。
@@ -22,7 +22,7 @@ Project Register Documentation Rules
22
22
  ## 1. 全体方針
23
23
 
24
24
  - TODO、要確認事項、リスク、課題、変更要求、決定事項、備忘の全登録項目は、それぞれ 1 件の個票を持つ。
25
- - 個票 Frontmatter の現在値は、分類、処理状態、優先度、担当、日付、結論の唯一の正本である。
25
+ - 個票 Frontmatter の現在値は、分類、処理状態、優先度、担当、日付、結論、起票元の唯一の正本である。
26
26
  - `events/pjr-XXXX.yaml` は、起票・状態遷移・更新を追う監査履歴の正本である。現在値の再計算には使わず、個票の現在値との整合を検証する。
27
27
  - 個票の H1 と本文は、それぞれタイトルと説明・根拠・経緯・対応内容の正本である。
28
28
  - `generated/pjr-index.md` とすべての派生ビューは個票から `register build` で生成し、直接編集しない。
@@ -48,7 +48,7 @@ Project Register Documentation Rules
48
48
  - 個票は `docs/ja/projects/<project-id>/controls/project-register/` 直下に置く。
49
49
  - 項目別イベントログは同ディレクトリの `events/` 配下に置き、個票 1 件につき 1 ファイルとする。
50
50
  - 登録項目一覧は `docs/ja/projects/<project-id>/controls/project-register/generated/pjr-index.md` に生成する。
51
- - 状態別・優先度別・担当者別の補助一覧は同じ `generated/` 配下に生成する。
51
+ - 状態別・優先度別・担当者別の補助一覧と、元の項目から派生先を辿る一覧は同じ `generated/` 配下に生成する。
52
52
  - controls 全体の type 別管理ビューは `controls/generated/` に生成する。生成物の別名コピーは作らない。
53
53
 
54
54
  ## 3. 推奨 Frontmatter 項目
@@ -65,18 +65,22 @@ Project Register Documentation Rules
65
65
  | `item_type` | 登録項目の分類 | ○ |
66
66
  | `item_status` | 登録項目の処理状態 | ○ |
67
67
  | `priority` | 対応優先度 | ○ |
68
+ | `difficulty` | agent 振り分け用の作業難易度 | 任意 |
68
69
  | `owner` | 主担当者または役割 | 任意 |
69
70
  | `registered_at` | 起票日時 | 任意 |
70
71
  | `due_on` | 対応期限または判断期限 | 任意 |
71
72
  | `completed_at` | 完了・却下・決定日時 | 条件 |
72
73
  | `block_reason` | `waiting` へ遷移した直近の理由 | 任意 |
73
74
  | `conclusion` | 終端時の結論要約 | 任意 |
75
+ | `derived_from` | 起票の元になった登録項目 ID の配列 | 任意 |
76
+ | `approach` | 対象を作成・修正するときの進め方 | 任意 |
74
77
  | `targets` | 変更対象文書の doc id リスト | 任意 |
75
78
 
76
79
  - `status` は文書成熟度、`item_status` は処理状態であり、同じ状態軸として扱わない。
77
- - `item_type`、`item_status`、`priority` の値は schema の enum だけを使用する。
80
+ - `item_type`、`item_status`、`priority`、`difficulty` の値は schema の enum だけを使用する。`difficulty` は `hard` / `medium` / `easy` のいずれかとし、省略時は従来の agent 自動選択を使う。
78
81
  - `block_reason` は `waiting` 中の直近の待機・失敗理由、`conclusion` は終端時の結論として用途を分ける。`register wait --reason` は前者だけを更新し、`waiting` 以外へ遷移すると現在値から削除する。削除前の理由は項目別イベントログの変更前の値に残す。
79
82
  - Frontmatter の構造化フィールドを本文や生成一覧へ手作業で複製しない。
83
+ - `derived_from` は同じ project の元項目を `PJR-XXXX`、別 project の元項目を `<project-id>:PJR-XXXX` で記録する。自己参照や存在しない項目は使用しない。別 project が設定にない場合は書式だけを検証し、設定された後に存在確認できるよう project 修飾を維持する。
80
84
 
81
85
  ### 3.1. 日時と日付の使い分け
82
86
 
@@ -109,13 +113,14 @@ Project Register Documentation Rules
109
113
 
110
114
  ### 4.2. 生成一覧と派生ビュー
111
115
 
112
- | 生成物 | 内容 | 編集可否 |
113
- | ------------------------------------ | ------------------- | -------- |
114
- | `generated/pjr-index.md` | 全個票の一覧 | 不可 |
115
- | `generated/pjr-views-by-status.md` | 状態別の補助一覧 | 不可 |
116
- | `generated/pjr-views-by-priority.md` | 優先度別の補助一覧 | 不可 |
117
- | `generated/pjr-views-by-owner.md` | 担当者別の補助一覧 | 不可 |
118
- | `controls/generated/pm-*.md` | type 別の管理ビュー | 不可 |
116
+ | 生成物 | 内容 | 編集可否 |
117
+ | ------------------------------------ | -------------------- | -------- |
118
+ | `generated/pjr-index.md` | 全個票の一覧 | 不可 |
119
+ | `generated/pjr-views-by-status.md` | 状態別の補助一覧 | 不可 |
120
+ | `generated/pjr-views-by-priority.md` | 優先度別の補助一覧 | 不可 |
121
+ | `generated/pjr-views-by-owner.md` | 担当者別の補助一覧 | 不可 |
122
+ | `generated/pjr-derived-items.md` | 元項目と派生先の一覧 | 不可 |
123
+ | `controls/generated/pm-*.md` | type 別の管理ビュー | 不可 |
119
124
 
120
125
  - 一覧の標準列は ID、ステータス、タイトル、説明、分類、優先度、担当、登録日、期限、完了日、結論、個票とする。
121
126
  - タイトルは個票の H1、説明は個票本文、その他の列は個票 Frontmatter から生成する。
@@ -131,14 +136,18 @@ Project Register Documentation Rules
131
136
  - 対応・判断内容には、実施または採択した範囲と、明示的に対象外とした範囲を記載する。
132
137
  - 結果・結論には、完了を判定した根拠と後続対応を記載する。
133
138
  - 関連ドキュメントには、判断根拠、変更対象、影響先、追跡先のうち該当する文書を記載する。
139
+ - 実行中に問題や後続作業を見つけて別の登録項目を起票するときは、起票元を `derived_from` に必ず記録する。decision から todo を起票する場合も同じ関係を使い、decision 本文へ追跡先を重複記載しない。既存本文の追跡先は移行のために書き換えない。
134
140
  - 本項目の実施において確実に変更する対象文書が分かっている場合は、その文書 ID を Frontmatter の `targets` 配列へ宣言する。宣言した `targets` は agent 実行時の変更網羅検証(target coverage)に用いられる。未知の場合や対象を固定しない場合は宣言を省略する。
141
+ - `approach` を宣言する場合、`targets` は 1 件だけ必須とする。`fully-guided`・`recipe-guided`・`freeform`・`bootstrap`・`retrofit`・`cross-deliverable-dedup`・`finalize`・`bootstrap-finalize` の対象は成果物カタログにある成果物の doc id とし、まだ文書がない成果物もカタログで解決する。`rulebook-maintenance`・`recipe-maintenance`・`sample-maintenance`・`template-maintenance` の対象は、名前に対応する種別の kata の doc id とし、文書索引で解決する。対応する正本で解決できない ID や、`approach` と種別が合わない対象は使用しない。
135
142
 
136
143
  ### 5.2. 構造化フィールドと生成
137
144
 
138
145
  - 新しい項目は `register add` で作成し、個票の Frontmatter に初期値を書き込む。全 type で個票を省略しない。
139
- - 担当・期限・結論・topic などを変更するときは `register update`、処理状態を変えるときは状態遷移コマンドを使用する。待機理由は `register wait --reason` で記録し、誤った現在値を手動補正するときは `register update --block-reason -` で削除する。
140
- - `register build` は個票を読み取り、一覧・派生ビューを再生成する。一覧を編集して個票へ反映する経路はない。
141
- - `register add`、状態遷移、`register update`、`register renumber` は現在値を個票へ、イベントを対応する項目別ログへ記録する。`--by` で actor、`--reason` で理由を明示でき、省略時もコマンドが既定値を記録する。
146
+ - 担当・期限・結論・topic・`derived_from`・`approach`・`targets` などを変更するときは `register update`、処理状態を変えるときは状態遷移コマンドを使用する。`register add` と `register update` では、起票元に繰り返し指定できる `--from`、進め方に `--approach`、対象に繰り返し指定できる `--target` を使う。起票元、`approach`、対象を削除するときは、それぞれ `--from -`、`--approach -`、`--target -` を指定する。待機理由は `register wait --reason` で記録し、誤った現在値を手動補正するときは `register update --block-reason -` で削除する。
147
+ - `register build` は個票を読み取り、一覧・派生ビューを再生成する。`generated/pjr-derived-items.md` では `derived_from` を逆引きし、元の項目から派生先を辿れるようにする。一覧を編集して個票へ反映する経路はない。
148
+ - `register add`、状態遷移、`register update`、`register renumber` は現在値を個票へ、イベントを対応する項目別ログへ記録する。`--by` で actor、`--reason` で理由を明示でき、省略時は予約 actor の `SpecDojo` を記録する。
149
+ - `--by` に指定できるのは、project の `pm-members.yaml` にある人の nickname、repository の `.specdojo/agent-members.yaml` にある agent の nickname または alias、予約 actor の `SpecDojo`・`specdojo-orchestrator`・`night-orchestrator` に限る。agent の alias は実体の nickname に解決して記録し、名簿にも予約一覧にもない値は書き込み前に拒否する。
150
+ - 決定・承認を記録する actor には、`PO` などの Role code や予約 actor ではなく、決定・承認した人の nickname を使う。`specdojo-orchestrator` は対話型オーケストレーター自身の操作だけに使い、人の判断主体を代替しない。
142
151
  - 同じ現在値へ同じ操作を再実行した場合は、新しいイベントを追加しない。イベント ID と直前イベント参照を保ったまま再実行し、既存イベントの置換や削除で重複を解消しない。
143
152
  - ID の変更は `register renumber` で行い、個票のファイル名・Frontmatter・参照と生成ビューを整合させる。
144
153
  - 主題の変化に伴う `<topic>` の変更は `register update --topic` で行う。個票のファイル名と Frontmatter の文書 ID、他文書中の旧文書 ID 参照を同時に更新し、生成ビューを再生成する。
@@ -68,9 +68,10 @@ Job Definition Standard
68
68
  - 既存 Job Run の retry は保存済みの対象と再開状態を維持するため precondition を再実行しない。`--dry-run` は precondition を実行せず、解決済みコマンドと skip 条件を表示する。
69
69
  - command から対象プロジェクトを指定するときは template 値 `{{project_id}}` を使い、同じ CLI を子プロセスで呼ぶときは `{{specdojo}}` を使う。`specdojo` という PATH 上の別 checkout を直接呼ばない。
70
70
  - script が中断再開用の ID を要求するときは `{{job_run_id}}` を渡す。期間などの `inputs` から再開キーを組み立てない。
71
- - runner は POSIX 環境では `/bin/sh -eu` でコマンドを実行し、終了コードが0以外なら agent を起動せず Run を失敗にする。
71
+ - runner は POSIX 環境では `/bin/sh -eu` でコマンドを実行する。終了コード0は`succeeded`、`task.partial_exit_code`に明示した非0は`partial`、それ以外の非0は`failed`とする。
72
+ - `task.partial_exit_code`は1〜255の単一値とし、完了した処理と再試行可能な失敗が同じ Run に混在してreviewへ委ねる必要がある command Jobだけが指定する。command 内の前処理などが偶然同じ終了コードを返さないように正規化し、汎用的なエラー終了を部分成功へ読み替えてはならない。
72
73
  - runner はコマンド、終了コード、標準出力、標準エラーを bounded・redacted evidence として保存する。stdout / stderr は監査用ログへの参照に加え、analysis reporter が追加のファイル読取なしで判断できるよう evidence 本体にも同じ bounded 内容を含める。
73
- - `task.analysis` は任意である。省略時は終了コードだけで成否を確定し、指定時はコマンド成功後に evidence を reporter agent へ渡す。
74
+ - `task.analysis` は任意である。省略時は終了コードだけで状態を確定し、指定時は`succeeded`または`partial`のコマンド後に evidence を reporter agent へ渡す。
74
75
  - analysis の根拠にする生成ファイルは command が stdout へ出力する。reporter は evidence 本体に埋め込まれた bounded stdout / stderr だけを読み、参照先ログや作業ツリーのファイルを追加で検査しない。
75
76
 
76
77
  ### 3.4. 責務境界と粒度
@@ -102,22 +103,23 @@ Job Definition Standard
102
103
 
103
104
  ## 4. 値制約・判定基準
104
105
 
105
- | 項目 | 必須 | 判定基準 |
106
- | ---------------------- | ---- | ------------------------------------------------------------------------------- |
107
- | `id` | ○ | `job-<slug>` 形式で、ファイル名の拡張子を除いた部分と一致する |
108
- | `task.mode` | ○ | `edit` / `review` / `command` |
109
- | `task.description` | 条件 | `edit` / `review` で必須。決定論的手順の列挙を含まない |
110
- | `task.command` | 条件 | `command` で必須。入力展開後も非空 |
111
- | `task.precondition` | 任意 | `command` と `empty-output` または 0〜255 の終了コードを指定 |
112
- | `task.analysis` | 任意 | command 結果の判断が必要な場合だけ agent と description を指定 |
113
- | `task.targets` `paths` | 条件 | `edit` / `review` はいずれか必須。`command` では任意 |
114
- | `task.agent.executor` | 任意 | `.specdojo/agent-members.yaml` の nickname 書式(`^[a-z0-9][a-z0-9_-]{0,62}$`) |
115
- | `task.agent.reporter` | 任意 | 同上。executor が result を書かない構成では必須 |
116
- | `task.review` | 任意 | mapping。存在すれば統合前 review の宣言。`agent` 以外のキーを持たない |
117
- | `task.review.agent` | 任意 | `executor` 必須・`reporter` 任意。書式は `task.agent` と同じ nickname 書式 |
118
- | `inputs.*.enum` | 任意 | scalar の値または list の各要素に対する非空の許容値集合 |
119
- | `minimum` / `maximum` | 任意 | integer input だけに指定でき、`minimum <= maximum` |
120
- | `run.idempotency_key` | ○ | 空文字へ解決されず、同じ論理実行を一意に判別できる |
106
+ | 項目 | 必須 | 判定基準 |
107
+ | ------------------------ | ---- | ------------------------------------------------------------------------------- |
108
+ | `id` | ○ | `job-<slug>` 形式で、ファイル名の拡張子を除いた部分と一致する |
109
+ | `task.mode` | ○ | `edit` / `review` / `command` |
110
+ | `task.description` | 条件 | `edit` / `review` で必須。決定論的手順の列挙を含まない |
111
+ | `task.command` | 条件 | `command` で必須。入力展開後も非空 |
112
+ | `task.partial_exit_code` | 任意 | `command` だけで使用する1〜255の終了コード。明示した値だけを`partial`とする |
113
+ | `task.precondition` | 任意 | `command` と `empty-output` または 0〜255 の終了コードを指定 |
114
+ | `task.analysis` | 任意 | command 結果の判断が必要な場合だけ agent と description を指定 |
115
+ | `task.targets` `paths` | 条件 | `edit` / `review` はいずれか必須。`command` では任意 |
116
+ | `task.agent.executor` | 任意 | `.specdojo/agent-members.yaml` の nickname 書式(`^[a-z0-9][a-z0-9_-]{0,62}$`) |
117
+ | `task.agent.reporter` | 任意 | 同上。executor が result を書かない構成では必須 |
118
+ | `task.review` | 任意 | mapping。存在すれば統合前 review の宣言。`agent` 以外のキーを持たない |
119
+ | `task.review.agent` | 任意 | `executor` 必須・`reporter` 任意。書式は `task.agent` と同じ nickname 書式 |
120
+ | `inputs.*.enum` | 任意 | scalar の値または list の各要素に対する非空の許容値集合 |
121
+ | `minimum` / `maximum` | 任意 | integer input だけに指定でき、`minimum <= maximum` |
122
+ | `run.idempotency_key` | ○ | 空文字へ解決されず、同じ論理実行を一意に判別できる |
121
123
 
122
124
  ## 5. 記述例
123
125
 
@@ -145,6 +145,6 @@ specdojo:
145
145
  `document_kinds` の `include` / `exclude` を列挙している観点ごとに、新しい rulebook の扱いを判断する。
146
146
  観点を当てはめない場合は `exclude`(`include` の観点では当てはめる場合に `include`)へ、
147
147
  既定の結果のままにする場合は `confirmed_default` へ rulebook ID を追加する。
148
- - 判断の漏れは `src/viewpoint-document-kinds-check.ts` の検証が観点 ID と rulebook ID の組で
148
+ - 判断の漏れは `src/docs/viewpoint-document-kinds-check.ts` の検証が観点 ID と rulebook ID の組で
149
149
  error として報告する。検証は `npm test`(`npm run check` に含まれる)で実行され、
150
- `npx tsx src/viewpoint-document-kinds-check.ts` で単独でも確認できる。
150
+ `npx tsx src/docs/viewpoint-document-kinds-check.ts` で単独でも確認できる。
@@ -0,0 +1,22 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:pjr-derived-items-template
4
+ type: template
5
+ status: draft
6
+ frontmatter_template:
7
+ specdojo:
8
+ id: _PROJECT_ID_:pjr-derived-items
9
+ type: project
10
+ status: ready
11
+ rulebook: specdojo:pjr-rulebook
12
+ part_of:
13
+ - _PROJECT_ID_:pjr-index
14
+ ---
15
+
16
+ # 登録項目の派生関係
17
+
18
+ > このファイルは個票の `derived_from` から生成された派生ビューです。正本は個票の Frontmatter であり、このファイルは再生成可能です。
19
+
20
+ ## 1. 元の項目から派生先を辿る
21
+
22
+ <!-- specdojo:view-slot=derived-items -->
@@ -40,6 +40,7 @@ Project Register
40
40
  - [[pjr-views-by-status|台帳ビュー(状態別)]]
41
41
  - [[pjr-views-by-priority|台帳ビュー(優先度別)]]
42
42
  - [[pjr-views-by-owner|台帳ビュー(担当者別)]]
43
+ - [[pjr-derived-items|登録項目の派生関係]]
43
44
 
44
45
  ### 2.2. controls 全体の派生管理ビュー
45
46
 
@@ -13,7 +13,18 @@ properties:
13
13
  items:
14
14
  $ref: "#/$defs/AgentMember"
15
15
  uniqueItems: true
16
+ aliases:
17
+ type: array
18
+ description: >
19
+ Backward-compatible names that refer to concrete members. alias_of may refer to
20
+ another alias, but every chain must terminate at an enabled member.
21
+ items:
22
+ $ref: "#/$defs/AgentAlias"
23
+ uniqueItems: true
16
24
  $defs:
25
+ AgentNickname:
26
+ type: string
27
+ pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"
17
28
  RoleLabel:
18
29
  type: string
19
30
  pattern: "^[A-Z]{2,4}$"
@@ -23,8 +34,7 @@ $defs:
23
34
  required: [nickname, display_name, roles, type, provider, capabilities, proficiency, priority]
24
35
  properties:
25
36
  nickname:
26
- type: string
27
- pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"
37
+ $ref: "#/$defs/AgentNickname"
28
38
  display_name:
29
39
  type: string
30
40
  minLength: 1
@@ -42,6 +52,14 @@ $defs:
42
52
  const: agent
43
53
  provider:
44
54
  enum: [opencode, claude, codex, copilot, antigravity, custom]
55
+ model:
56
+ type: string
57
+ minLength: 1
58
+ description: "Provider model identifier, including its version when applicable."
59
+ effort:
60
+ type: string
61
+ minLength: 1
62
+ description: "Provider-specific reasoning effort passed when the provider supports it."
45
63
  persona:
46
64
  type: string
47
65
  minLength: 1
@@ -74,3 +92,12 @@ $defs:
74
92
  enum: [critical-first, dependency-first, fifo, manual]
75
93
  note:
76
94
  type: string
95
+ AgentAlias:
96
+ type: object
97
+ additionalProperties: false
98
+ required: [nickname, alias_of]
99
+ properties:
100
+ nickname:
101
+ $ref: "#/$defs/AgentNickname"
102
+ alias_of:
103
+ $ref: "#/$defs/AgentNickname"
@@ -5,11 +5,11 @@ description: >
5
5
  Defines global defaults for specdojo exec run.
6
6
  Agent selection requirements are declared on sch-strategy phases; this file only
7
7
  contains runtime defaults shared across tracks, such as parent-run pipeline validations,
8
- agent launch command templates, rate-limit detection, and retry policy.
8
+ agent launch command templates, rate-limit / connection-error detection, and retry policy.
9
9
  Detection signals, exit codes, and wait times differ per agent runtime provider, so the
10
- top-level rate_limit_detection / rate_limit_policy act as global defaults and providers.<name>
11
- supplies per-provider overrides keyed by pm-members[].provider. Launch command templates
12
- are provider-specific and have no global default.
10
+ top-level rate_limit_detection / connection_error_detection / rate_limit_policy act as global
11
+ defaults and providers.<name> supplies per-provider overrides keyed by pm-members[].provider.
12
+ Launch command templates are provider-specific and have no global default.
13
13
  type: object
14
14
  additionalProperties: false
15
15
 
@@ -23,21 +23,36 @@ properties:
23
23
  description: "Defaults for `exec run`, including register execution location and project concurrency."
24
24
 
25
25
  rate_limit_detection:
26
- $ref: "#/$defs/RateLimitDetection"
26
+ $ref: "#/$defs/AgentErrorDetection"
27
27
  description: >
28
28
  Global default signals used to detect agent rate-limit / transient failures.
29
29
  Used for members whose provider has no override under providers.<name>.
30
30
 
31
+ connection_error_detection:
32
+ $ref: "#/$defs/AgentErrorDetection"
33
+ description: >
34
+ Global default signals used to detect agent connection failures. A pinned stage switches
35
+ once to its configured fallback agent when these signals match, independently of
36
+ --on-rate-limit. Used when a provider has no override under providers.<name>.
37
+
31
38
  rate_limit_policy:
32
39
  $ref: "#/$defs/RateLimitPolicy"
33
40
  description: >
34
41
  Global default behavior when an agent hits a rate limit during exec run.
35
42
  Used for members whose provider has no override under providers.<name>.
36
43
 
44
+ routing:
45
+ $ref: "#/$defs/DifficultyRouting"
46
+ description: >
47
+ Register pipeline agents and pinned rate-limit handling selected from the register item's
48
+ difficulty. Explicit CLI stage and recovery options override the matching route. Missing
49
+ difficulty entries preserve the existing priority-based automatic selection.
50
+
37
51
  providers:
38
52
  type: object
39
53
  description: >
40
- Per-provider overrides of rate_limit_detection and rate_limit_policy. The key
54
+ Per-provider overrides of rate_limit_detection, connection_error_detection, and
55
+ rate_limit_policy. The key
41
56
  matches pm-members[].provider (the agent runtime that executes the member command).
42
57
  For a given member, exec run resolves detection and policy from its provider override
43
58
  when present, otherwise from the top-level (global) values. This keeps provider-specific
@@ -49,9 +64,53 @@ properties:
49
64
  $ref: "#/$defs/ProviderOverride"
50
65
 
51
66
  $defs:
67
+ AgentNickname:
68
+ type: string
69
+ pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"
70
+
71
+ DifficultyRouting:
72
+ type: object
73
+ additionalProperties: false
74
+ minProperties: 1
75
+ properties:
76
+ hard:
77
+ $ref: "#/$defs/DifficultyRoute"
78
+ medium:
79
+ $ref: "#/$defs/DifficultyRoute"
80
+ easy:
81
+ $ref: "#/$defs/DifficultyRoute"
82
+
83
+ DifficultyRoute:
84
+ type: object
85
+ additionalProperties: false
86
+ required: [executor_by, reporter_by, on_rate_limit]
87
+ properties:
88
+ executor_by:
89
+ $ref: "#/$defs/AgentNickname"
90
+ reporter_by:
91
+ $ref: "#/$defs/AgentNickname"
92
+ on_rate_limit:
93
+ type: string
94
+ enum: [stop, wait, fallback]
95
+ fallback_executor_by:
96
+ $ref: "#/$defs/AgentNickname"
97
+ fallback_reporter_by:
98
+ $ref: "#/$defs/AgentNickname"
99
+
52
100
  ParentValidationId:
53
101
  type: string
54
- enum: [validate-schema, typecheck, test-unit, test-integration, lint-ts, lint-fm, lint-md]
102
+ enum:
103
+ [
104
+ validate-schema,
105
+ typecheck,
106
+ test-unit,
107
+ test-integration,
108
+ lint-ts,
109
+ lint-fm,
110
+ lint-md,
111
+ build,
112
+ format-check,
113
+ ]
55
114
 
56
115
  PipelineDefaults:
57
116
  type: object
@@ -107,6 +166,14 @@ $defs:
107
166
  Default execution location for `exec run --register`. `--worktree` and `--in-place`
108
167
  override this value. When omitted, the historical `in-place` behavior is retained for
109
168
  compatibility with existing repositories.
169
+ register_post_review:
170
+ type: boolean
171
+ default: false
172
+ description: >
173
+ Whether `exec run --register` performs a read-only completion review after worktree
174
+ integration and automatically closes eligible todo/issue items. `--post-review` enables
175
+ the same behavior for one run. This option requires worktree execution and is disabled
176
+ when omitted.
110
177
  max_concurrent_runs:
111
178
  type: integer
112
179
  minimum: 1
@@ -140,8 +207,13 @@ $defs:
140
207
  Extra template variables resolved by member attributes. Resolution precedence is
141
208
  by_nickname, then by_proficiency, then by_mode.
142
209
  rate_limit_detection:
143
- $ref: "#/$defs/RateLimitDetection"
210
+ $ref: "#/$defs/AgentErrorDetection"
144
211
  description: "Provider-specific failure signals. Prefer stderr_patterns over generic exit_codes."
212
+ connection_error_detection:
213
+ $ref: "#/$defs/AgentErrorDetection"
214
+ description: >
215
+ Provider-specific connection failure signals. Prefer stderr_patterns over generic
216
+ exit_codes so ordinary agent failures are not treated as unavailable providers.
145
217
  rate_limit_policy:
146
218
  $ref: "#/$defs/RateLimitPolicy"
147
219
  description: "Provider-specific retry / fallback / block policy."
@@ -200,18 +272,18 @@ $defs:
200
272
  type: string
201
273
  minLength: 1
202
274
 
203
- RateLimitDetection:
275
+ AgentErrorDetection:
204
276
  type: object
205
277
  additionalProperties: false
206
- description: "Exit codes and stderr patterns that identify rate-limit / transient failures."
278
+ description: "Exit codes and output patterns that identify a configured agent failure class."
207
279
  properties:
208
280
  exit_codes:
209
281
  type: array
210
282
  uniqueItems: true
211
283
  description: >
212
- Exit codes treated as a rate-limit / transient signal. Avoid generic codes such as 1:
213
- most agent CLIs also use exit 1 for ordinary failure and for the agent's own block
214
- signal, so a bare exit 1 cannot be distinguished from a rate limit. Prefer stderr_patterns,
284
+ Exit codes treated as the configured failure signal. Avoid generic codes such as 1:
285
+ most agent CLIs also use exit 1 for ordinary failures and for the agent's own block
286
+ signal, so a bare exit 1 cannot identify one failure class. Prefer stderr_patterns,
215
287
  or set provider-specific codes under providers.<name>.
216
288
  items:
217
289
  type: integer
@@ -224,10 +296,10 @@ $defs:
224
296
  stderr_requires_nonzero_exit:
225
297
  type: boolean
226
298
  description: >
227
- Optional. When true (the default), stderr_patterns only count as a rate-limit
228
- signal if the agent process also exited non-zero. This avoids false positives
229
- where a successful run echoes a pattern phrase (e.g. an agent editing a file that
230
- contains the literal text "rate limit"). Set to false to match regardless of exit code.
299
+ Optional. When true (the default), stderr_patterns only count as the configured
300
+ failure signal if the agent process also exited non-zero. This avoids false positives
301
+ where a successful run echoes a pattern phrase. Set to false to match regardless of
302
+ exit code.
231
303
 
232
304
  RateLimitPolicy:
233
305
  type: object
@@ -262,6 +334,28 @@ $defs:
262
334
  oom:
263
335
  type: number
264
336
  exclusiveMinimum: 0
337
+ pinned:
338
+ type: object
339
+ additionalProperties: false
340
+ description: >
341
+ Recovery for an agent selected by nickname. CLI --on-rate-limit and fallback stage
342
+ flags override these values. Omitted action preserves the historical rate-limit stop
343
+ behavior. The fallback nicknames also handle configured connection errors independently
344
+ of action.
345
+ properties:
346
+ action:
347
+ type: string
348
+ enum: [stop, wait, fallback]
349
+ max_wait_seconds:
350
+ type: number
351
+ minimum: 0
352
+ description: Maximum wait for reset/retry-after/cooldown (default 28800 seconds).
353
+ fallback_executor_by:
354
+ type: string
355
+ pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"
356
+ fallback_reporter_by:
357
+ type: string
358
+ pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"
265
359
  on_non_critical:
266
360
  type: object
267
361
  additionalProperties: false
@@ -176,6 +176,34 @@ properties:
176
176
  reason:
177
177
  type: string
178
178
  maxLength: 1000
179
+ rate_limit_events:
180
+ description: >
181
+ Runner-recorded rate-limit wait/fallback and connection-error fallback history for a
182
+ pinned executor. The field name is retained for schema compatibility.
183
+ type: array
184
+ items:
185
+ type: object
186
+ additionalProperties: false
187
+ required: [action, from_actor, to_actor, resumed_at]
188
+ properties:
189
+ action:
190
+ type: string
191
+ enum: [wait, fallback]
192
+ trigger:
193
+ type: string
194
+ enum: [rate_limit, connection_error]
195
+ from_actor:
196
+ type: string
197
+ minLength: 1
198
+ to_actor:
199
+ type: string
200
+ minLength: 1
201
+ resumed_at:
202
+ type: string
203
+ format: date-time
204
+ resume_at:
205
+ type: string
206
+ format: date-time
179
207
  final_message:
180
208
  type: string
181
209
  maxLength: 4000
@@ -46,7 +46,7 @@ properties:
46
46
  type: string
47
47
  format: date-time
48
48
  state:
49
- enum: [running, succeeded, failed, noop]
49
+ enum: [running, succeeded, partial, failed, noop]
50
50
  inputs:
51
51
  type: object
52
52
  task:
@@ -78,7 +78,7 @@ properties:
78
78
  type: string
79
79
  format: date-time
80
80
  status:
81
- enum: [running, succeeded, failed, noop]
81
+ enum: [running, succeeded, partial, failed, noop]
82
82
  result_ref:
83
83
  type: string
84
84
  evidence_ref:
@@ -190,6 +190,13 @@ $defs:
190
190
  command:
191
191
  type: string
192
192
  minLength: 1
193
+ partial_exit_code:
194
+ description: >
195
+ Optional non-zero exit code that records a reviewable partial Job Run. Other non-zero
196
+ exit codes remain failures.
197
+ type: integer
198
+ minimum: 1
199
+ maximum: 255
193
200
  precondition:
194
201
  type: object
195
202
  additionalProperties: false