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.
- package/.github/agents/specdojo-orchestrator.md +61 -2
- package/CHANGELOG.md +90 -0
- package/README.md +85 -25
- package/dist/{catalog-build-references.js → catalog/build-references.js} +4 -4
- package/dist/catalog/build-render.js +32 -0
- package/dist/{catalog-build.js → catalog/build.js} +9 -9
- package/dist/{catalog.js → catalog/catalog.js} +10 -10
- package/dist/{catalog-generate.js → catalog/generate.js} +8 -8
- package/dist/catalog/paths.js +1 -0
- package/dist/{catalog-plan-generate.js → catalog/plan-generate.js} +4 -4
- package/dist/{catalog-plan.js → catalog/plan.js} +4 -4
- package/dist/{catalog-scaffold.js → catalog/scaffold.js} +3 -3
- package/dist/{agent.js → commands/agent.js} +11 -11
- package/dist/{build-command.js → commands/build.js} +2 -2
- package/dist/{init-command.js → commands/init.js} +168 -45
- package/dist/commands/night-orchestrator.js +287 -0
- package/dist/{orchestrator.js → commands/orchestrator.js} +12 -5
- package/dist/{watch.js → commands/watch.js} +3 -3
- package/dist/{dashboard-timeline.js → dashboard/dashboard-timeline.js} +2 -2
- package/dist/{dashboard.js → dashboard/dashboard.js} +11 -10
- package/dist/{dashboard-exec-records.js → dashboard/exec-records.js} +2 -2
- package/dist/{dashboard-routines.js → dashboard/routines.js} +6 -5
- package/dist/{dashboard-shared.js → dashboard/shared.js} +1 -1
- package/dist/{timeline-build.js → dashboard/timeline-build.js} +2 -1
- package/dist/{timeline.js → dashboard/timeline.js} +1 -1
- package/dist/{deliverable.js → deliverable/deliverable.js} +5 -5
- package/dist/{deliverable-trash.js → deliverable/trash.js} +5 -5
- package/dist/{devcontainer-command.js → devcontainer/command.js} +8 -4
- package/dist/devcontainer/scaffold.js +418 -0
- package/dist/{doc-index.js → docs/doc-index.js} +1 -1
- package/dist/{frontmatter-namespace.js → docs/frontmatter-namespace.js} +1 -1
- package/dist/{index-command.js → docs/index-command.js} +1 -1
- package/dist/docs/template-resolution.js +1 -0
- package/dist/{viewpoint-document-kinds-check.js → docs/viewpoint-document-kinds-check.js} +1 -1
- package/dist/{yaml-pages-command.js → docs/yaml-pages-command.js} +1 -1
- package/dist/{yaml-pages.js → docs/yaml-pages.js} +2 -2
- package/dist/{exec-agent-config.js → exec/agent-config.js} +92 -5
- package/dist/{exec-agent-git-state.js → exec/agent-git-state.js} +1 -1
- package/dist/{exec-agent-protected-config.js → exec/agent-protected-config.js} +1 -1
- package/dist/{exec-commands.js → exec/commands.js} +22 -18
- package/dist/{exec-core.js → exec/core.js} +11 -11
- package/dist/{exec-events.js → exec/events.js} +2 -2
- package/dist/{exec-evidence.js → exec/evidence.js} +11 -6
- package/dist/exec/exec.js +2 -0
- package/dist/exec/format.js +1 -0
- package/dist/{exec-handoff.js → exec/handoff.js} +13 -12
- package/dist/{exec-limit.js → exec/limit.js} +93 -12
- package/dist/{exec-parent-validation.js → exec/parent-validation.js} +18 -4
- package/dist/{exec-pipeline-state.js → exec/pipeline-state.js} +29 -2
- package/dist/{exec-plans-core.js → exec/plans-core.js} +68 -114
- package/dist/{exec-plans-generation.js → exec/plans-generation.js} +53 -10
- package/dist/{exec-plans-storage.js → exec/plans-storage.js} +5 -5
- package/dist/{exec-plans.js → exec/plans.js} +3 -3
- package/dist/{exec-project.js → exec/project.js} +1 -1
- package/dist/{exec-protection-handoff.js → exec/protection-handoff.js} +3 -3
- package/dist/{exec-register-resume.js → exec/register-resume.js} +2 -2
- package/dist/{exec-register.js → exec/register.js} +114 -9
- package/dist/{exec-repo-integration-git.js → exec/repo-integration-git.js} +2 -2
- package/dist/{exec-repo-integration-sync.js → exec/repo-integration-sync.js} +4 -4
- package/dist/{exec-repo-integration.js → exec/repo-integration.js} +14 -11
- package/dist/{exec-repo-trace.js → exec/repo-trace.js} +3 -3
- package/dist/{exec-reporter-output.js → exec/reporter-output.js} +2 -2
- package/dist/{exec-reporter.js → exec/reporter.js} +142 -25
- package/dist/{exec-results.js → exec/results.js} +287 -31
- package/dist/{exec-run-agent-pipeline.js → exec/run/agent-pipeline.js} +35 -12
- package/dist/{exec-run-agent.js → exec/run/agent.js} +115 -28
- package/dist/{exec-run-in-place.js → exec/run/in-place.js} +56 -27
- package/dist/{exec-run-job.js → exec/run/job.js} +65 -36
- package/dist/{exec-run-lifecycle-commands.js → exec/run/lifecycle-commands.js} +30 -22
- package/dist/{exec-run-lock.js → exec/run/lock.js} +4 -3
- package/dist/{exec-run-mode-shared.js → exec/run/mode-shared.js} +3 -3
- package/dist/{exec-run-register-command.js → exec/run/register-command.js} +38 -11
- package/dist/{exec-run-register-core.js → exec/run/register-core.js} +63 -21
- package/dist/{exec-run-register-mode.js → exec/run/register-mode.js} +58 -31
- package/dist/exec/run/register-post-review.js +420 -0
- package/dist/{exec-run-register-resume.js → exec/run/register-resume.js} +48 -27
- package/dist/{exec-run-register-state.js → exec/run/register-state.js} +13 -10
- package/dist/{exec-run-register-worktree.js → exec/run/register-worktree.js} +119 -24
- package/dist/{exec-run.js → exec/run/run.js} +11 -11
- package/dist/{exec-run-schedule-mode.js → exec/run/schedule-mode.js} +17 -17
- package/dist/{exec-run-schedule-prepare.js → exec/run/schedule-prepare.js} +31 -18
- package/dist/{exec-run-schedule-task.js → exec/run/schedule-task.js} +45 -18
- package/dist/{exec-run-shared.js → exec/run/shared.js} +78 -30
- package/dist/{exec-schedule-calendar.js → exec/schedule/calendar.js} +1 -1
- package/dist/{exec-schedule-cpm.js → exec/schedule/cpm.js} +2 -2
- package/dist/{exec-schedule-gantt-chart-render.js → exec/schedule/gantt-chart-render.js} +2 -2
- package/dist/exec/schedule/gantt-chart.js +2 -0
- package/dist/{exec-schedule-hash.js → exec/schedule/hash.js} +2 -2
- package/dist/exec/schedule/index.js +1 -0
- package/dist/{exec-schedule-initial.js → exec/schedule/initial.js} +2 -2
- package/dist/{exec-schedule-progress.js → exec/schedule/progress.js} +2 -2
- package/dist/{exec-schedule-ready.js → exec/schedule/ready.js} +2 -2
- package/dist/{exec-schedule.js → exec/schedule/schedule.js} +11 -11
- package/dist/exec/shared.js +63 -0
- package/dist/exec/slot-lock.js +1 -0
- package/dist/{exec-strategy.js → exec/strategy.js} +2 -2
- package/dist/{exec-task-repos.js → exec/task-repos.js} +104 -17
- package/dist/{exec-task-view.js → exec/task-view.js} +4 -4
- package/dist/{exec-trial-commands.js → exec/trial-commands.js} +20 -22
- package/dist/{exec-trial-core.js → exec/trial-core.js} +6 -6
- package/dist/{exec-trial.js → exec/trial.js} +2 -2
- package/dist/{exec-worktree-command.js → exec/worktree-command.js} +25 -23
- package/dist/{exec-worktree-ops-commit.js → exec/worktree-ops-commit.js} +25 -60
- package/dist/{exec-worktree-ops-lifecycle.js → exec/worktree-ops-lifecycle.js} +13 -8
- package/dist/{exec-worktree-ops-merge.js → exec/worktree-ops-merge.js} +48 -7
- package/dist/{exec-worktree-ops.js → exec/worktree-ops.js} +3 -3
- package/dist/exec/worktree.js +305 -0
- package/dist/{grade-apply.js → grade/apply.js} +9 -9
- package/dist/{grade-command-apply.js → grade/command-apply.js} +7 -7
- package/dist/{grade-command-inspect.js → grade/command-inspect.js} +6 -6
- package/dist/{grade-command-plan.js → grade/command-plan.js} +5 -5
- package/dist/{grade-core.js → grade/core.js} +3 -3
- package/dist/grade/grade.js +19 -0
- package/dist/{grade-markdown.js → grade/markdown.js} +6 -6
- package/dist/{grade-pipeline-state.js → grade/pipeline-state.js} +4 -4
- package/dist/{grade-plan.js → grade/plan.js} +5 -5
- package/dist/{grade-result.js → grade/result.js} +5 -94
- package/dist/{grade-target-discovery.js → grade/target-discovery.js} +7 -7
- package/dist/{grade-targets.js → grade/targets.js} +11 -8
- package/dist/{job-definition.js → job/definition.js} +25 -6
- package/dist/{job.js → job/job.js} +12 -11
- package/dist/{kata-command.js → kata/command.js} +3 -3
- package/dist/{kata.js → kata/kata.js} +5 -5
- package/dist/register/approach.js +134 -0
- package/dist/{register-core.js → register/core.js} +26 -8
- package/dist/{register-create-commands.js → register/create-commands.js} +171 -8
- package/dist/{register-date.js → register/date.js} +1 -1
- package/dist/register/derivation.js +163 -0
- package/dist/{register-event-merge.js → register/event-merge.js} +44 -3
- package/dist/{register-events.js → register/events.js} +13 -3
- package/dist/{register-history.js → register/history.js} +7 -6
- package/dist/{register-item.js → register/item.js} +32 -5
- package/dist/register/lifecycle-lock.js +5 -0
- package/dist/{register-maintenance-commands.js → register/maintenance-commands.js} +13 -7
- package/dist/{register-migrate-timestamps.js → register/migrate-timestamps.js} +3 -3
- package/dist/{register-migration.js → register/migration.js} +5 -4
- package/dist/{register.js → register/register.js} +32 -27
- package/dist/{register-renumber.js → register/renumber.js} +38 -11
- package/dist/{register-transition-commands.js → register/transition-commands.js} +3 -3
- package/dist/{register-update.js → register/update.js} +5 -5
- package/dist/{register-views.js → register/views.js} +47 -7
- package/dist/{review-grade.js → review/grade.js} +2 -2
- package/dist/{review-plan.js → review/plan.js} +3 -3
- package/dist/{routine-definition.js → routine/definition.js} +2 -2
- package/dist/{routine.js → routine/routine.js} +49 -22
- package/dist/{schedule-approach.js → schedule/approach.js} +8 -8
- package/dist/{schedule-build.js → schedule/build.js} +7 -4
- package/dist/{schedule.js → schedule/schedule.js} +6 -6
- package/dist/{schedule-strategy-generate-document.js → schedule/strategy-generate-document.js} +2 -2
- package/dist/{schedule-strategy-generate-scope.js → schedule/strategy-generate-scope.js} +4 -4
- package/dist/{schedule-strategy-generate.js → schedule/strategy-generate.js} +10 -10
- package/dist/shared/agent-types.js +23 -0
- package/dist/shared/artifact-path.js +9 -0
- package/dist/{build-if-stale.js → shared/build-if-stale.js} +1 -1
- package/dist/{catalog-build-render.js → shared/catalog-render.js} +3 -32
- package/dist/{exec-slot-lock.js → shared/cross-process-lock.js} +3 -1
- package/dist/shared/fs.js +30 -0
- package/dist/shared/git.js +346 -0
- package/dist/shared/grade-result.js +94 -0
- package/dist/{package-paths.js → shared/package-paths.js} +3 -3
- package/dist/shared/plan-templates.js +114 -0
- package/dist/{exec-provider-scaffold.js → shared/provider-scaffold.js} +6 -3
- package/dist/shared/random.js +4 -0
- package/dist/{exec-schedule-index.js → shared/schedule-index.js} +3 -1
- package/dist/shared/schedule-paths.js +9 -0
- package/dist/{specdojo-config.js → shared/specdojo-config.js} +162 -21
- package/dist/{exec-shared.js → shared/text.js} +4 -135
- package/dist/shared/time.js +28 -0
- package/dist/shared/workspace-scaffold.js +69 -0
- package/dist/specdojo.js +22 -22
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +31 -18
- package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +1 -2
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +3 -2
- package/docs/ja/specdojo/exec-templates/xer-template.md +1 -3
- package/docs/ja/specdojo/exec-templates/xrp-job-template.md +6 -4
- package/docs/ja/specdojo/exec-templates/xrp-register-post-run-template.md +46 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +34 -1
- package/docs/ja/specdojo/guides/docs-structure-guide.md +2 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +169 -26
- package/docs/ja/specdojo/guides/exec-operation-guide.md +184 -13
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +2 -0
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +40 -3
- package/docs/ja/specdojo/guides/quick-start-guide.md +89 -21
- package/docs/ja/specdojo/guides/register-operation-guide.md +44 -1
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +61 -6
- package/docs/ja/specdojo/guides/review-guide.md +1 -1
- package/docs/ja/specdojo/guides/routine-operation-guide.md +5 -5
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +1 -1
- package/docs/ja/specdojo/guides/use-case-guide.md +1 -1
- package/docs/ja/specdojo/guides/waza-guide.md +1 -1
- package/docs/ja/specdojo/references/command-reference.md +124 -55
- package/docs/ja/specdojo/references/specdojo-config-reference.md +33 -7
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +22 -13
- package/docs/ja/specdojo/standards/job-definition-standard.md +20 -18
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -2
- package/docs/ja/specdojo/templates/pjr-derived-items-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-index-template.md +1 -0
- package/docs/specdojo/schemas/v1/agent-members.schema.yaml +29 -2
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +111 -17
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +28 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +2 -2
- package/docs/specdojo/schemas/v1/job.schema.yaml +7 -0
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +38 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +5 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +91 -7
- package/docs/specdojo/schemas/v1/routine-run.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +36 -1
- package/package.json +17 -17
- package/templates/antigravity/README.md +6 -2
- package/templates/antigravity/agent-members-snippet.yaml +108 -12
- package/templates/antigravity/exec-defaults-snippet.yaml +8 -13
- package/templates/antigravity/orchestrator.md +61 -2
- package/templates/claude/README.md +27 -3
- package/templates/claude/agents/claude-executor.md +0 -1
- package/templates/claude/agents/claude-reporter.md +2 -1
- package/templates/claude/agents/claude-review-executor.md +0 -1
- package/templates/claude/agents/specdojo-orchestrator.md +61 -2
- package/templates/codex/README.md +40 -4
- package/templates/codex/agents/specdojo-orchestrator.toml +61 -2
- package/templates/codex/orchestrator.md +61 -2
- package/templates/devcontainer/devcontainer.json +5 -2
- package/templates/devcontainer/post-create.sh +15 -7
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +102 -0
- package/templates/devcontainer/remote-host/ssh-config.sample +19 -0
- package/templates/devcontainer/vim/vimrc +37 -0
- package/templates/init-agent-members.yaml +75 -25
- package/templates/init-exec-defaults.yaml +44 -9
- package/templates/opencode/README.md +17 -3
- package/templates/opencode/agents/opencode-executor.md +0 -1
- package/templates/opencode/agents/opencode-reporter.md +2 -1
- package/templates/opencode/agents/opencode-review-executor.md +0 -1
- package/templates/opencode/agents/specdojo-orchestrator.md +61 -2
- package/dist/devcontainer-scaffold.js +0 -165
- package/dist/exec-schedule-gantt-chart.js +0 -2
- package/dist/exec-worktree.js +0 -474
- package/dist/exec.js +0 -2
- package/dist/grade.js +0 -19
- package/templates/claude/agents/claude-expert-review-executor.md +0 -14
- /package/dist/{catalog-plan-prompt.js → catalog/plan-prompt.js} +0 -0
- /package/dist/{catalog-types.js → catalog/types.js} +0 -0
- /package/dist/{template-frontmatter.js → docs/template-frontmatter.js} +0 -0
- /package/dist/{role-types.js → exec/role-types.js} +0 -0
- /package/dist/{exec-schedule-gantt-chart-scope.js → exec/schedule/gantt-chart-scope.js} +0 -0
- /package/dist/{exec-types.js → exec/types.js} +0 -0
- /package/dist/{grade-command-shared.js → grade/command-shared.js} +0 -0
- /package/dist/{register-command-types.js → register/command-types.js} +0 -0
- /package/dist/{review-types.js → review/types.js} +0 -0
- /package/dist/{schedule-phase-sets.js → schedule/phase-sets.js} +0 -0
- /package/dist/{schedule-strategy-profiles.js → schedule/strategy-profiles.js} +0 -0
- /package/dist/{agent-response.js → shared/agent-response.js} +0 -0
- /package/dist/{catalog-paths.js → shared/catalog-paths.js} +0 -0
- /package/dist/{dist-freshness.js → shared/dist-freshness.js} +0 -0
- /package/dist/{git-environment.js → shared/git-environment.js} +0 -0
- /package/dist/{exec-format.js → shared/markdown-format.js} +0 -0
- /package/dist/{practice-id.js → shared/practice-id.js} +0 -0
- /package/dist/{spawn-self.js → shared/spawn-self.js} +0 -0
- /package/dist/{specdojo-gitignore.js → shared/specdojo-gitignore.js} +0 -0
- /package/dist/{template-resolution.js → shared/template-resolution.js} +0 -0
- /package/dist/{yaml-schema-modeline.js → shared/yaml-schema-modeline.js} +0 -0
- /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
|
-
| `
|
|
101
|
-
| `
|
|
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 は
|
|
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
|
-
-
|
|
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
|
-
| `
|
|
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
|
|
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`
|
|
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`
|
|
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`
|
|
108
|
-
| `task.mode`
|
|
109
|
-
| `task.description`
|
|
110
|
-
| `task.command`
|
|
111
|
-
| `task.
|
|
112
|
-
| `task.
|
|
113
|
-
| `task.
|
|
114
|
-
| `task.
|
|
115
|
-
| `task.agent.
|
|
116
|
-
| `task.
|
|
117
|
-
| `task.review
|
|
118
|
-
| `
|
|
119
|
-
| `
|
|
120
|
-
| `
|
|
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 -->
|
|
@@ -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
|
-
|
|
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
|
|
11
|
-
supplies per-provider overrides keyed by pm-members[].provider.
|
|
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/
|
|
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
|
|
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:
|
|
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/
|
|
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
|
-
|
|
275
|
+
AgentErrorDetection:
|
|
204
276
|
type: object
|
|
205
277
|
additionalProperties: false
|
|
206
|
-
description: "Exit codes and
|
|
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
|
|
213
|
-
most agent CLIs also use exit 1 for ordinary
|
|
214
|
-
signal, so a bare exit 1 cannot
|
|
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
|
|
228
|
-
signal if the agent process also exited non-zero. This avoids false positives
|
|
229
|
-
where a successful run echoes a pattern phrase
|
|
230
|
-
|
|
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
|