specdojo 0.9.1 → 0.9.2
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 +7 -0
- package/CHANGELOG.md +23 -0
- package/README.md +4 -4
- package/dist/commands/agent.js +15 -24
- package/dist/commands/init.js +8 -5
- package/dist/commands/orchestrator.js +6 -11
- package/dist/dashboard/timeline.js +2 -2
- package/dist/devcontainer/command.js +1 -1
- package/dist/devcontainer/scaffold.js +6 -5
- package/dist/exec/agent-config.js +4 -0
- package/dist/exec/commands.js +54 -4
- package/dist/exec/executor-outcome-checks.js +104 -0
- package/dist/exec/migrate-records.js +3 -1
- package/dist/exec/parent-validation.js +66 -15
- package/dist/exec/pipeline-state.js +16 -0
- package/dist/exec/register.js +4 -0
- package/dist/exec/run/agent-pipeline.js +44 -3
- package/dist/exec/run/register-command.js +9 -0
- package/dist/exec/run/register-core.js +2 -1
- package/dist/exec/run/register-resume.js +19 -2
- package/dist/exec/run/register-worktree.js +2 -1
- package/dist/exec/run/resume-notes.js +50 -0
- package/dist/exec/run/shared.js +5 -0
- package/dist/exec/task-repos.js +6 -0
- package/dist/exec/validation-process-group.js +98 -0
- package/dist/grade/command-inspect.js +3 -1
- package/dist/grade/command-run.js +1 -0
- package/dist/grade/command-shared.js +10 -0
- package/dist/grade/run.js +58 -6
- package/dist/grade/targets.js +106 -0
- package/dist/register/create-commands.js +30 -3
- package/dist/register/events.js +1 -1
- package/dist/register/item.js +1 -0
- package/dist/register/maintenance-commands.js +3 -1
- package/dist/register/renumber.js +14 -1
- package/dist/register/section.js +114 -0
- package/dist/register/update.js +18 -0
- package/dist/shared/antigravity-block.js +24 -0
- package/dist/shared/plan-conventions.js +11 -0
- package/dist/shared/provider-scaffold.js +4 -0
- package/dist/shared/specdojo-config.js +5 -4
- package/dist/shared/where-alias.js +2 -2
- package/docs/ja/specdojo/guides/exec-config-guide.md +15 -12
- package/docs/ja/specdojo/guides/exec-operation-guide.md +21 -7
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +5 -3
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
- package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
- package/docs/ja/specdojo/guides/timeline-design-guide.md +1 -1
- package/docs/ja/specdojo/references/command-reference.md +76 -51
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +10 -42
- package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +10 -50
- package/docs/ja/specdojo/samples/dec-sample.md +3 -30
- package/docs/ja/specdojo/samples/dss-sample.md +12 -12
- package/docs/ja/specdojo/samples/ntp-sample.md +3 -30
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +1 -0
- package/package.json +1 -1
- package/templates/antigravity/orchestrator.md +7 -0
- package/templates/claude/agents/specdojo-orchestrator.md +7 -0
- package/templates/codex/agents/specdojo-orchestrator.toml +7 -0
- package/templates/codex/orchestrator.md +7 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +7 -0
|
@@ -4,10 +4,10 @@ export function registerDeprecatedWhereAlias(parent, printPaths) {
|
|
|
4
4
|
const kind = parent.name();
|
|
5
5
|
parent
|
|
6
6
|
.command("where", { hidden: true })
|
|
7
|
-
.description(`Deprecated: use where ${kind} (
|
|
7
|
+
.description(`Deprecated: use specdojo where ${kind} (will be removed in 0.10.0)`)
|
|
8
8
|
.option("--project <projectId>", "Project id in specdojo.config.json")
|
|
9
9
|
.action((opts) => {
|
|
10
|
-
warnDeprecated(`${kind} where`, `Use specdojo where ${kind}. This alias will be removed
|
|
10
|
+
warnDeprecated(`${kind} where`, `Use specdojo where ${kind}. This alias will be removed in 0.10.0.`);
|
|
11
11
|
printPaths(opts);
|
|
12
12
|
});
|
|
13
13
|
}
|
|
@@ -438,7 +438,7 @@ providers:
|
|
|
438
438
|
expert: { effort: high }
|
|
439
439
|
frontier: { effort: xhigh }
|
|
440
440
|
|
|
441
|
-
antigravity:
|
|
441
|
+
antigravity: # 0.9.2 から使えない(agy を起動しない)
|
|
442
442
|
command_template: 'specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"'
|
|
443
443
|
# model を持たない従来の 1 段の member だけが、次の model を使う
|
|
444
444
|
command_params:
|
|
@@ -612,6 +612,7 @@ executor の出力は、そのまま reporter へ渡さずに run 単位の evid
|
|
|
612
612
|
- result の `changed_files` のパスは evidence の `changes` から、execution の evidence、project register とその派生ビュー、当該 result という runner 管理記録を除いて runner が機械生成します。除外後の変更一覧だけを reporter へ渡し、edit の変更説明は evidence のパスと対にして受け取ります。runner はパスで突き合わせるため、説明の順序は問いません。説明が不足したパスには Git の変更メタデータ(追加・変更・削除・名前の変更、行数)を記録し、変更ファイルが多い場合(50 件超)はディレクトリごとに集約して記録します。evidence にないパスの説明は捨てます。`outcome` と `block_reason` は stage の状態・終了コード・保護機構が保存した理由・executor / 親 runner の検証から機械生成します。reporter の JSON Schema は文章項目と対応づけ用のパスだけを受け付け、いずれかの検証が failed または `not_run` なら、reporter の文章にかかわらず機械判定は blocked です。ただし、executor が `not_run` または `not_applicable` と記録したコマンドを、親 runner が同じリポジトリで同じコマンドとして実行し成功していれば、親 runner の結果を正として executor の報告を無視します。さらに、`npm run <name>` に対応する script がない、`npx <package>` の package が `dependencies` / `devDependencies` にない、検査の対象となる種類の変更ファイルがない、または SpecDojo サブコマンドの設定上の適用条件を満たさないことを runner が機械的に確定できる場合、その `not_run` は block せず、edit result の申し送りへ「適用外の検証(runner の判定)」として追記します。変更ファイル種別で判定する対応は共通規約の検査表を正本とし、`validate:schema:file` は `*.yaml` / `*.yml`、Prettier は `*.md` / `*.ts` / `*.js` / `*.json` / `*.yaml` / `*.yml`、markdownlint は `*.md`、`validate:history-links`(`specdojo-docs-lint history-links` を含む)は履歴蓄積ファイル(`pjr-*.md`(`pjr-index.md` を除く)、または executor 自身が変更した `execution/runs/<origin>/<item>/<run>/` 配下の `plan.md`・`result.md` や旧来の `exec/plans/**/*.md`・`exec/results/**/*.md`)の変更がある場合だけ適用対象とします。変更範囲の判定では、runner が生成・更新する `exec/` 配下(`plans/`・`results/`・`evidence/`・`events/`・`.locks/`)を executor の変更ファイルから除外し、rename は変更前後の両方を見て、プロダクトリポジトリのコマンドはそのリポジトリの変更だけで判定します。`typecheck` など、この対応に含まれない検査の判定は変更しません。SpecDojo の起動形は `specdojo <subcommand>`、`npx specdojo <subcommand>`、ソース/配布済み CLI の直接起動を認識し、`catalog validate`(`npm run validate:catalog` および `tools/catalog-validate-if-configured.mjs` を含む)は対象 project の `catalog_path` で判定します。対象 project は、コマンドの `--project <id>`、run の対象 project(runner が execution path に一致する project を設定から特定したもの)、`current_project` の順に決めます。別の project が `catalog_path` を持っていても、run の対象 project に `catalog_path` がなければ適用外です。対象 project に `catalog_path` があっても、executor の変更(runner が書く `exec/` 配下などの runner 管理記録を除き、rename は変更前後の両方を見ます)が `docs/ja/projects/` 配下に及ばない run では、plan の共通規約の検証表と同じく適用外とし、executor の `not_applicable` も受理します。変更が及ぶ run では従来どおり適用対象です。また、`<repo>:<path>` を引数に含むコマンド、`--prefix <repo>` 付きのコマンド、または `$SPECDOJO_REPO_<NAME>` / `${SPECDOJO_REPO_<NAME>}` を含むコマンドは、対象 project が `repos` で宣言したそのプロダクトリポジトリの `package.json` で script と依存を判定します(`--prefix` はリポジトリ名か設定の `path` と一致するものを対象にします)。設定が読めない、対象 project を特定できない、または適用条件を未定義のサブコマンドは機械的な救済をせず、通常の `not_run` として扱います。executor の failed は親 runner の成功や適用外判定で打ち消しません。`npm run check` のように npm script を `&&` でつないだだけの合成コマンドを executor が `not_run` とした場合は、対象リポジトリの `package.json` の script を展開し、構成する各コマンドが同じリポジトリの親検証か executor 自身の検証で通っていれば満たされたものとして扱います。`npm test` は、`npm run test:unit` と `npm run test:integration` の両方が通っていれば満たされたものとします。構成するコマンドの script の中身と同じコマンドを executor が直接実行して通した場合も満たします(`tsx` の起動の書き方の違いはそろえて比べます)。任意のシェルを含む script は展開しません。理由付きの `not_applicable` は block の理由にせず、runner が edit result の申し送りへ「適用外の検証: `<コマンド>`(<理由>)」として機械的に追記します。ただし、理由がない場合、変更ファイル種別を含む適用条件を満たした `npm run <name>` の script が存在する場合、または同条件を満たした `npx <package>` の package が `dependencies` / `devDependencies` に存在する場合は誤申告として blocked にします。SpecDojo サブコマンドは package の有無だけでは反証せず、既知の適用条件を設定から判定します。適用条件が未定義なら理由付きの agent の申告に従います。`specdojo index build`(`npx specdojo index build`・`node --import tsx src/specdojo.ts index build` などの起動形を含みます)は runner が担う検証です。出力先の `.specdojo/doc-index.json` は agent が書き込めず、index は worktree の準備と統合の前に runner が再生成するため、executor への指示では実行も記録もしないよう伝えます。executor が `not_run` / `not_applicable` と記録しても block の理由にせず、`not_run` の場合は edit result の申し送りへ「runner が担う検証: `<コマンド>`(<理由>)」として追記します。runner の再生成が失敗した場合は worktree の準備で run が止まるか、runner の検証の失敗として block するため、満たしたものとは扱いません。executor の failed は救済せず、ほかの SpecDojo サブコマンドの `not_run` の扱いも変えません。executor の `requires_human` は block の理由にせず、runner が edit result の申し送りへ「人の確認が必要: `<コマンド>`(<要約>)」として機械的に追記します。項目は review へ進み、人が確認してから close します。
|
|
613
613
|
- `completion_status` は作業の完了状態を示す省略可能な欄で、値は `complete` / `incomplete` です。欄のない既存の報告は `complete` として扱います。値が指定されていてこの 2 値に合わない場合は、安全側に倒して `incomplete` として保存します。executor は計画の作業を終えられなかった場合、`incomplete` とし、理由を `final_message`、残作業を `handoff` に書きます。終了コード 0 や親検証の成功では未完了の申告を上書きしません。`exec run --register` は親検証・reporter を起動する前に停止し、項目を `waiting` にして、秘匿処理・文字数制限を適用した `final_message` の要旨を `block_reason` に記録します。worktree 実行では変更と evidence を残し、統合しません。pipeline の executor は `blocked`、evidence の `stage.status` と `exit_code` は実際のプロセス結果のままとします。`--resume --resume-from executor`(または `--resume`)で再開でき、前回の理由と `handoff`、途中の変更を executor に引き継ぎます。完了を申告し直し、必要な検証を通過してから review・統合へ進みます。
|
|
614
614
|
- approach が報告に求める項目は、runner が reporter の起動前に検査します。現在の対象は `condense` の edit が求める `condense_records` で、欠けている、または形式が正しくない場合は reporter の失敗にせず executor の段の失敗とします。evidence を `completion_status: incomplete` とし、理由と再開の操作(schedule は `exec resume --task <id> --resume-from executor`、register は `exec run --register <id> --worktree --resume --resume-from executor`、agent を替える場合は `--executor-by`)を `block_reason` と result に残します。pipeline の executor は `blocked` です。再開は executor の段から始まり、reporter だけを同じ evidence で流し直しません。この検査より前に記録され、reporter の段で止まった run も、reporter の再開時に同じ検査で executor の段へ戻します。
|
|
615
|
+
- edit の executor が `complete` と報告しても、runner は次のどちらかに当たる場合は成功とせず、同じく evidence を `completion_status: incomplete`、pipeline の executor を `blocked` にして、register の項目を `waiting` にします。1 つ目は、プロダクトリポジトリを対象にする項目(plan の `targets`・個票の `target_path` / `targets` に `<repo>:<path>` がある、または approach の無い plan の本文が `<repo>:<path>` を参照する)なのに、そのプロダクトの worktree に未 commit の変更も exec branch の commit も無い場合です。`block_reason` は `no product changes in <repo>` で始まり、runner の要約と `exec status` の末尾の `warnings (no product changes):` に出ます。2 つ目は、executor の出力(報告のタグの中を除く)にツールの権限による拒否(opencode の permission rule の `deny`、Claude Code の `Permission to use ... has been denied` など)がある場合です。シェルの `Permission denied` は対象にしません。プロダクトを対象にしない項目は、プロダクトに変更が無くても従来どおり進みます。
|
|
615
616
|
- `handoff` は executor が申し送る判断の理由、保護された設定の変更案、次のアクションなどの文字列配列です。先頭 100 件、各 4,000 文字までを秘匿処理して evidence に保存し、空文字列や文字列以外の要素は除外します。省略した既存の報告・evidence も有効です。reporter にはこの欄も渡し、edit result の「申し送り」には runner が reporter の補足と合わせて機械的に転記します。同一の文字列は重複させず、reporter が省略しても executor の記録は残します。register の完了条件が result への記録を求める場合、pipeline の executor は個票の対応結果と報告の `handoff` の両方に書きます。close の前には個票の対応結果と result の両方を確認します。
|
|
616
617
|
- reporter の出力は JSON Schema で厳格に検証します。形式不正のときは同じ plan と evidence のまま reporter だけを最大 3 回再実行し、executor は再実行しません。
|
|
617
618
|
- reporter stage の再開では、現在の設定 ID と一致する親検証が保存済み evidence にそろっている場合だけ executor evidence を再利用します。`{ id, repo }` を使う場合は、ID とリポジトリの組が一致することを求めます。再実行時も同じ割り当てで、各リポジトリの worktree を `cwd` にします。保存済みの親検証がすべて成功していれば再実行しません。`failed` / `not_run` があれば、親 runner が現在の worktree で固定許可リストの親検証を再実行し、同じ ID の結果を evidence 上で置換してから reporter へ渡します。過去の親検証ログは置換せず、新しい失敗ログだけを追加します。executor 由来の検証は再実行・置換しません。設定 ID が変わった、または結果が欠けている場合、Schedule 実行は新しい executor run としてやり直し、register 実行は明示的な再実行を促して再開を拒否します。
|
|
@@ -621,15 +622,17 @@ executor の出力は、そのまま reporter へ渡さずに run 単位の evid
|
|
|
621
622
|
|
|
622
623
|
agent が exec 実行時に読み込む provider 固有の設定(agent 定義・permission 設定)は、npm package 内の `templates/<provider>/` を配布原本とし、利用プロジェクトへコピーして使います。worktree 実行はコミット済み内容から worktree を作るため、コピーした設定は必ずコミットします。
|
|
623
624
|
|
|
625
|
+
0.9.2 から、SpecDojo は Antigravity CLI(`agy`)を起動しません。consumer plan では、他社の agent や application の中から agy を起動することを [Antigravity の FAQ](https://antigravity.google/docs/faq) が対象外とし、[Additional Terms](https://antigravity.google/terms) の Section 6 が契約違反としているためです。provider が `antigravity` の member は、名前で指定すると agent の起動前にエラーで止まり、自動選択と代わりの選択では候補から外れます。`agent launch` と `orchestrator launch` の `--provider antigravity`、`init`・`config scaffold`・`devcontainer scaffold` での `antigravity` の指定もエラーになり、止めるのを外す設定はありません。0.9.1 の `init` で antigravity を選んだ場合は、`.specdojo/agent-members.yaml` で agy の member に `disabled: true` を付けるか削除し、ほかの provider を使ってください。以降の agy の設定の説明は 0.9.1 までの記録で、0.9.2 では使えません。
|
|
626
|
+
|
|
624
627
|
配置規則は provider 名から機械的に決まります(`agents/` 配下 → `.<provider>/agents/`、`rules/` 配下 → `.<provider>/rules/`、`opencode.json` → リポジトリ直下の `opencode.json`、それ以外のファイル → `.specdojo/<provider>/`、`README.md` はコピーしません)。provider ごとの配布内容は次のとおりです。
|
|
625
628
|
|
|
626
|
-
| provider | 配布内容
|
|
627
|
-
| ----------- |
|
|
628
|
-
| claude | `agents/*.md`(役割ごとの agent 定義)、`settings.edit.json` / `settings.orchestrator.json` / `settings.review.json` / `settings.report.json`
|
|
629
|
-
| codex | `agents/*.toml`(親 Codex が spawn する subagent 定義)、`rules/*.rules`(command rule)
|
|
630
|
-
| opencode | `agents/*.md`(permission frontmatter 込みの agent 定義)、`opencode.json`(Ollama 接続・モデル設定)
|
|
631
|
-
| copilot | `agent-members-snippet.yaml`(agent 定義)と `exec-defaults-snippet.yaml`(`providers.copilot` の command template・rate limit 検出)の参照スニペット
|
|
632
|
-
| antigravity |
|
|
629
|
+
| provider | 配布内容 | 配置先 |
|
|
630
|
+
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
|
|
631
|
+
| claude | `agents/*.md`(役割ごとの agent 定義)、`settings.edit.json` / `settings.orchestrator.json` / `settings.review.json` / `settings.report.json` | `.claude/agents/`、`.specdojo/claude/` |
|
|
632
|
+
| codex | `agents/*.toml`(親 Codex が spawn する subagent 定義)、`rules/*.rules`(command rule) | `.codex/agents/`、`.codex/rules/` |
|
|
633
|
+
| opencode | `agents/*.md`(permission frontmatter 込みの agent 定義)、`opencode.json`(Ollama 接続・モデル設定) | `.opencode/agents/`、`opencode.json` |
|
|
634
|
+
| copilot | `agent-members-snippet.yaml`(agent 定義)と `exec-defaults-snippet.yaml`(`providers.copilot` の command template・rate limit 検出)の参照スニペット | `.specdojo/copilot/` |
|
|
635
|
+
| antigravity | 0.9.2 から配置できない。0.9.1 までは役割別 `settings.edit.json` / `settings.review.json` / `settings.report.json` / `settings.orchestrator.json`、orchestrator と設定スニペット。旧 `settings.global.json` は互換用途だけに使用 | `.specdojo/antigravity/` |
|
|
633
636
|
|
|
634
637
|
導入手順と手動設定(`.codex/config.toml` や接続先 URL の調整、Modelfile によるローカル派生タグの作成など)は各 `templates/<provider>/README.md` を参照します。
|
|
635
638
|
|
|
@@ -658,7 +661,7 @@ specdojo config scaffold --provider claude
|
|
|
658
661
|
- 配布原本はインストール済み package のルートから解決します。`templates/<name>/` が存在しない provider を指定した場合は、指定可能な provider 一覧を添えてエラーにします。
|
|
659
662
|
- 配置先に同名ファイルが存在する場合は上書きせず `Skipped (already exists):` を出力します。`--force` 指定時のみ上書きします。ファイルごとに `Written:` / `Skipped:` を 1 行ずつ出力します(既存の scaffold 系コマンドの出力形式に合わせます)。
|
|
660
663
|
- `--dry-run` 指定時は書き込みを行わず、コピー予定のファイル一覧を表示します。
|
|
661
|
-
-
|
|
664
|
+
- 0.9.2 から使えません。0.9.1 までは、`antigravity` で `--global` を明示した場合だけ、`~/.gemini/antigravity-cli/settings.json` の `permissions.allow` / `deny` / `ask` へ不足 rule を追記します。既存キーと配列要素は保持し、書き換え前に timestamp 付きバックアップを作ります。`--global --dry-run` は追加 rule の差分だけを表示し、設定もバックアップも作りません。
|
|
662
665
|
- `--global` をサポートしない provider へ指定した場合はエラーにします。`--force` はグローバル設定の既存値を上書きしません。
|
|
663
666
|
- コピー完了後、次の 2 点を案内メッセージとして出力します。配置ファイルのコミットが必要であること(worktree 実行の前提)、および `.specdojo/exec-defaults.yaml` の `providers.claude.command_template` に `--settings` の指定が必要であること。
|
|
664
667
|
- `settings.*.json` の `Edit(...)` / `Write(...)` パスパターンの調整は利用者に委ねます。scaffold は `.specdojo/specdojo.config.json` のパス設定に基づく書き換えを行いません(テンプレートを事実上の推奨レイアウト前提で配布します)。
|
|
@@ -675,7 +678,7 @@ specdojo config scaffold --provider claude
|
|
|
675
678
|
| codex | `luna-executor`・`luna-review-executor`・`luna-reporter` | `codex-executor`・`codex-review-executor`・`codex-reporter` | 実体の `model`(`gpt-6-luna`、effort は `by_proficiency`) |
|
|
676
679
|
| codex | `sol-executor`・`sol-review-executor`(expert) | `codex-expert-executor`・`codex-expert-review-executor` | 実体の `model`(`gpt-6.1-sol`、effort は `by_proficiency`) |
|
|
677
680
|
| opencode | `gemma-executor`・`gemma-review-executor`・`gemma-reporter`、`qwen-executor`・`qwen-review-executor`・`qwen-reporter` | `opencode-executor`・`opencode-review-executor`・`opencode-reporter` | 実体の `model`(`opencode.json` の provider 名込み、原則 `*-mlx-work-64k`) |
|
|
678
|
-
| antigravity | `flash-executor`・`flash-review-executor`・`flash-reporter`
|
|
681
|
+
| antigravity | 0.9.2 から生成しない。0.9.1 までは `flash-executor`・`flash-review-executor`・`flash-reporter` | `agy-executor`・`agy-review-executor`・`agy-reporter` | 実体の `model`(推論強度を含む ID) |
|
|
679
682
|
| copilot | `copilot-executor`・`copilot-review-executor`・`copilot-reporter` | なし(`--model auto` で model を自動選択するため系統で名付けない) | `command_template` の `--model auto` |
|
|
680
683
|
|
|
681
684
|
claude と codex は normal と expert の 2 段を持ちます(0.4.6 から)。expert の実体には `proficiency: expert` を付けます。init が書く振り分けの表(`routing`)は、hard を expert の別名(`claude-expert-executor`・`codex-expert-executor`)、medium と easy を normal の別名にし、reporter はどの難易度でも normal の別名にします。expert の段がない provider(opencode・antigravity など)は、hard も normal の別名を使います。codex の reasoning effort は `by_proficiency` で normal が `medium`、expert が `high` で、`gpt-6-luna` は Max までしか受け付けないため Ultra を割り当てません。
|
|
@@ -741,7 +744,7 @@ provider によらず、exec の実行構造そのものが次の境界を提供
|
|
|
741
744
|
|
|
742
745
|
**claude** は `provider 設定の配布と scaffold` のとおり、pipeline のロール別 `--settings` でパス単位に制限します。executor・review executor・reporter は `git push` と全 `gh` を deny します。対話型オーケストレーターの npm script は専用の `settings.orchestrator.json` を読み込み、保護設定を含む編集を妨げず、`git push` と `gh` の書き込みだけを deny して読み取りを allow します。`--permission-mode bypassPermissions` は使わず、`.claude/settings.json` の `disableBypassPermissionsMode: "disable"` で起動自体を拒否します。
|
|
743
746
|
|
|
744
|
-
**antigravity** は `config scaffold --provider antigravity --global` で fine-grained permission を追記します。グローバル設定は利用者のすべてのリポジトリに効くため、allow は読み取りの Git コマンド(`git status` / `diff` / `log` / `show`)だけとし、`npm run` など任意のスクリプトを実行できる command は含めません。deny には、`git push`、全 `gh`、Git の変更操作・破壊的 command・秘密情報・固定保護設定へのアクセスを入れます。`--dangerously-skip-permissions` は使いません。CLI の permission に加えて、実行後の provider 非依存ガードでも保護設定の変更を block します。
|
|
747
|
+
**antigravity** は 0.9.2 から使えません(`provider 設定の配布と scaffold` を参照)。0.9.1 までは `config scaffold --provider antigravity --global` で fine-grained permission を追記します。グローバル設定は利用者のすべてのリポジトリに効くため、allow は読み取りの Git コマンド(`git status` / `diff` / `log` / `show`)だけとし、`npm run` など任意のスクリプトを実行できる command は含めません。deny には、`git push`、全 `gh`、Git の変更操作・破壊的 command・秘密情報・固定保護設定へのアクセスを入れます。`--dangerously-skip-permissions` は使いません。CLI の permission に加えて、実行後の provider 非依存ガードでも保護設定の変更を block します。
|
|
745
748
|
|
|
746
749
|
**codex** はパス単位の permission 機構を持たず、sandbox(`read-only` / `workspace-write` / `danger-full-access`)の粒度で制御します。review でも result の記入が必要なため `read-only` にはできず、edit / review とも `workspace-write` を使います。command template には次を明示します。
|
|
747
750
|
|
|
@@ -790,7 +793,7 @@ providers:
|
|
|
790
793
|
--deny-tool 'shell(git push)' --deny-tool 'shell(git reset)'
|
|
791
794
|
```
|
|
792
795
|
|
|
793
|
-
**antigravity**(Antigravity CLI `agy
|
|
796
|
+
**antigravity**(Antigravity CLI `agy`)は 0.9.2 から起動できません(`provider 設定の配布と scaffold` を参照)。以下は 0.9.1 までの設定です。pipeline の役割指示は plan の共通規約を正本とし、権限は `agent launch --role {mode}` が分離します。非対話実行は `-p` ですが、プロンプトを引数に取り stdin を読まないので、runner が stdin へ書く plan を `"$(cat)"` で引数に渡します(command は `shell: true` で実行されます)。
|
|
794
797
|
|
|
795
798
|
```yaml
|
|
796
799
|
providers:
|
|
@@ -152,13 +152,14 @@ specdojo exec run --project <project-id> --register PJR-00QV --worktree --join
|
|
|
152
152
|
|
|
153
153
|
親検証の時間切れを調べるときは、run の `evidence.json` と同じディレクトリの `parent-validation-metrics.jsonl` を確認します。trial では `exec/trials/<comparison-id>/trials/<trial-id>/` に保存します。再開時も追記するため、`batch_id` と検証の `id`・`repo` で絞って読みます。
|
|
154
154
|
|
|
155
|
-
| 記録 | 読み方
|
|
156
|
-
| ------------------------------------- |
|
|
157
|
-
| `gate-queued` / `gate-acquired` | 枠の要求・取得時刻。`local_wait_ms` は同一プロセス内、`shared_wait_ms` は共有ロックの取得にかかった時間。各検証の `gate_wait_ms` はバッチ全体の待ち時間で、検証ごとの待ちの合計ではありません
|
|
158
|
-
| `validation-start` / `validation-end` | `at` は UTC の記録時刻、`started_at` は開始時刻、`duration_ms` は単調時計で測った実行時間。`status`・`exit_code`・`timed_out` で終了状態を確認します
|
|
159
|
-
| `validation-timeout` | 上限に達した時点で終了要求より先に保存します。`active_test_files` は開始通知があり終了通知のないテストファイル、`output_tail` は直近 16 Ki 文字の標準出力です。詳細な出力は従来の失敗ログも参照します
|
|
160
|
-
| `
|
|
161
|
-
| `
|
|
155
|
+
| 記録 | 読み方 |
|
|
156
|
+
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
157
|
+
| `gate-queued` / `gate-acquired` | 枠の要求・取得時刻。`local_wait_ms` は同一プロセス内、`shared_wait_ms` は共有ロックの取得にかかった時間。各検証の `gate_wait_ms` はバッチ全体の待ち時間で、検証ごとの待ちの合計ではありません |
|
|
158
|
+
| `validation-start` / `validation-end` | `at` は UTC の記録時刻、`started_at` は開始時刻、`duration_ms` は単調時計で測った実行時間。`status`・`exit_code`・`timed_out` で終了状態を確認します |
|
|
159
|
+
| `validation-timeout` | 上限に達した時点で終了要求より先に保存します。`active_test_files` は開始通知があり終了通知のないテストファイル、`output_tail` は直近 16 Ki 文字の標準出力です。詳細な出力は従来の失敗ログも参照します |
|
|
160
|
+
| `validation-timeout-stop` | 時間切れの後に検証を止め終えた時点で保存します。`survivors_after_term` は SIGTERM の猶予(10 秒)の後に子孫が残っていたか、`kill_sent` は SIGKILL を送ったか、`pipes_closed: false` は group 外の子孫が出力の pipe を持ったまま残り、close を待たずに返したことを示します |
|
|
161
|
+
| `load` | Linux の CPU・memory・I/O の PSI(`pressure`)、`loadavg`、`/proc/meminfo` 由来のメモリ・swap 使用量(bytes)。PSI の `avg10` などは待ちの割合、`total` は累積待ち時間(マイクロ秒)です。開始・終了・時間切れの差分で確認します |
|
|
162
|
+
| `activity` | `scope: project-locks` は同じ project の primary / join run の数と PID、および実行中 executor の子 PID・worktree 名。reporter と終了済み executor は数えません。共有ロックのない実行は `scope: process` として自プロセスだけを数えます |
|
|
162
163
|
|
|
163
164
|
このリポジトリの Vitest 設定は、親検証が渡す `SPECDOJO_PARENT_VALIDATION_METRICS=1` のときだけファイル開始・終了通知を出します。他リポジトリの検証でこの通知がない場合、`active_test_files` は空で、実行ファイルは未特定です。直近の出力が示す完了済みファイルを実行中と解釈しないでください。テストの初期化前の停止も通知がない場合があります。
|
|
164
165
|
|
|
@@ -566,6 +567,19 @@ specdojo exec run \
|
|
|
566
567
|
--resume-from executor
|
|
567
568
|
```
|
|
568
569
|
|
|
570
|
+
申し送りだけでは足りない指示(直す順番、触れてはいけない範囲など)を executor へ渡す場合は、`--resume-note <text>` を足します。plan を手で編集したりスクリプトで書き換えたりせずに、run の plan の共通規約の参照の前へ `## 再開の指示(<日時>)` の節を入れて executor を再開します。繰り返し指定すると 1 つの節に並び、足した指示と日時は `pipeline-state.json` の `resume_notes` に残ります。`--resume-from executor` を伴わない場合や、`--register` の ID が 1 件でない場合は、起動の前にエラーで止まります。
|
|
571
|
+
|
|
572
|
+
```bash
|
|
573
|
+
specdojo exec run \
|
|
574
|
+
--project <project-id> \
|
|
575
|
+
--register <PJR-ID> \
|
|
576
|
+
--worktree \
|
|
577
|
+
--resume \
|
|
578
|
+
--resume-from executor \
|
|
579
|
+
--resume-note "個票の完了条件 3 の文書を先に直す" \
|
|
580
|
+
--resume-note "src 配下は変えない"
|
|
581
|
+
```
|
|
582
|
+
|
|
569
583
|
強制した executor の prompt には、保存済み evidence にある失敗した親検証の ID と要約を申し送ります。保護機構の block から通常どおり executor を再開する場合は、保存済みの block 理由を申し送ります。統合段から executor へ戻す指定、worktree が無い run、再開できない run は、register の状態と既存成果を変えずに拒否します。
|
|
570
584
|
|
|
571
585
|
executor のプロセス結果は、親 runner 検証を始める前に `executor.log` と `evidence.json` へ保存し、`pipeline-state.json` の executor を `succeeded` へ更新します。親検証中にプロセスが中断した場合、`--resume` は保存済みの executor evidence を再利用し、不足している親検証を実行してから reporter へ進みます。agent 実行中の中断で executor が `running` のまま残った場合は、未コミット成果を含む既存 worktree を破棄せず、同じ plan/result を入力に executor から再実行します。`--executor-by` / `--reporter-by` を省略した場合は state に記録された各 agent を引き継ぎます。
|
|
@@ -63,13 +63,15 @@ CLI を直接操作する場合の代表フローは [遂行の技活用ガイ
|
|
|
63
63
|
| `orch:flash` | Antigravity / `gemini-3.8-flash-high` | なし |
|
|
64
64
|
| `orch:flash:work` | Antigravity / `gemini-3.8-flash-high` | `../worktrees/agy-work`(無ければ自動作成) |
|
|
65
65
|
|
|
66
|
+
0.9.2 から、`orch:argon`・`orch:flash` などの Antigravity の行は使えません。`orchestrator launch --provider antigravity` は agy を起動する前にエラーで終了します。理由と代わりの操作は [[specdojo:exec-config-guide|exec設定ガイド]] の `provider 設定の配布と scaffold` を参照してください。以下の agy の説明は 0.9.1 までの記録です。
|
|
67
|
+
|
|
66
68
|
Antigravity CLI(`agy`)はファイル定義の agent を持たないため、Codex と同じく SSOT `.agents/specdojo-orchestrator.agent.md` の本文を `-i`(初期プロンプトを与えて対話を続ける)で渡します。ラッパーは不要で、`.agents/rules/*.md` の薄いラッパー経由で `.github/instructions/` の規則も読み込まれます。
|
|
67
69
|
|
|
68
70
|
Antigravity で使えるモデル ID は `agy models` で確認してください。配布スクリプトは `gemini-4-argon-medium` と `gemini-3.8-flash-high` を指定します。
|
|
69
71
|
|
|
70
|
-
`specdojo init` と `config scaffold` が利用者の `package.json` へ追加するスクリプトは、Claude Code が `orch:opus`・`orch:sonnet`、Codex が `orch:sol`(`gpt-6.1-sol`)・`orch:luna`(`gpt-6-luna`)、
|
|
72
|
+
`specdojo init` と `config scaffold` が利用者の `package.json` へ追加するスクリプトは、Claude Code が `orch:opus`・`orch:sonnet`、Codex が `orch:sol`(`gpt-6.1-sol`)・`orch:luna`(`gpt-6-luna`)、OpenCode が `orch:opencode` です(0.9.2 から Antigravity のスクリプトは追加しません)。Codex のスクリプトは、名前に対応するモデルを起動コマンドで明示します。
|
|
71
73
|
|
|
72
|
-
0.4.0 以前に作った `orch:codex`・`orch:agy` は自動では削除・上書きされません。`config scaffold --provider codex`
|
|
74
|
+
0.4.0 以前に作った `orch:codex`・`orch:agy` は自動では削除・上書きされません。`config scaffold --provider codex` を再実行して新しいスクリプトを追加し、新しい名前で起動できることを確認してから、旧スクリプトを `package.json` から削除してください。
|
|
73
75
|
|
|
74
76
|
用途に応じて使い分けます。
|
|
75
77
|
|
|
@@ -102,7 +104,7 @@ scaffold が追加する `orch:*` は `specdojo orchestrator launch` を経由
|
|
|
102
104
|
|
|
103
105
|
OpenCode は起動引数に追加ルートの指定を持たないため、選択した orchestrator agent の `permission.external_directory` を実行時の inline config で上書きします。全外部ディレクトリを拒否してから宣言済みルートだけを許可し、同じルートの `permission.edit` も許可します。`edit` は起動場所からの相対パスで照合されるため、相対パスのパターンで渡します。設定ファイル自体は変更しません。
|
|
104
106
|
|
|
105
|
-
Antigravity CLI の無人実行に必要な permission rule は、利用者のすべてのリポジトリに効くグローバル設定です。通常の scaffold では変更されないため、明示的に dry-run で追加 rule を確認してから適用します。既存設定は保持され、実適用前にバックアップされます。
|
|
107
|
+
次の Antigravity CLI のグローバル設定は 0.9.2 から使えません(`config scaffold --provider antigravity` はエラーになります)。0.9.1 まで、Antigravity CLI の無人実行に必要な permission rule は、利用者のすべてのリポジトリに効くグローバル設定です。通常の scaffold では変更されないため、明示的に dry-run で追加 rule を確認してから適用します。既存設定は保持され、実適用前にバックアップされます。
|
|
106
108
|
|
|
107
109
|
```bash
|
|
108
110
|
npx specdojo config scaffold --provider antigravity --global --dry-run
|
|
@@ -107,7 +107,7 @@ state と evidence は元も残し、ログは退避先へ移します。退避
|
|
|
107
107
|
|
|
108
108
|
### 2.3. 既存記録の移行
|
|
109
109
|
|
|
110
|
-
`exec migrate-records`
|
|
110
|
+
`exec migrate-records` は非推奨であり、次の版(0.10.0)で削除予定です。現在は新形式の実行記録配置(`execution/runs/`)が標準形式であり、通常の運用や検査を通すためにも本コマンドの実行は不要です。旧配置の記録を CLI の通常の探索で使う場合に移行します。移さない場合の制約は次のとおりです。
|
|
111
111
|
|
|
112
112
|
- `exec run --register ... --resume` と schedule の executor 再開は、`runs/` 内の checkpoint を候補にするため旧 `exec/evidence/` の run を発見しません。schedule の通常実行・統合再開も、plan・result の通常の探索では旧配置を参照しません。保存済みイベントや checkpoint の明示的なパス参照を読む経路はありますが、旧配置を自動探索する互換機能ではありません。
|
|
113
113
|
- `dashboard build` の実行記録一覧と plan・result 件数には、旧配置の記録が含まれません。`exec archive` や task ID からの plan・result の取得も `runs/` のみを探索します。
|
|
@@ -426,7 +426,7 @@ specdojo register history --project <project-id> --since 2026-08-01 --json
|
|
|
426
426
|
- 異なる項目の並行実行は別の個票とイベントファイルへ書くため共有ログ競合を起こしません。同じ項目を複数 worktree で変更してイベントファイルが競合した場合は、統合時に両側のイベントの和集合で解決します。
|
|
427
427
|
- exec event と共通化するのは UTC 秒精度、version、actor、reason、追記・検証の原則です。exec は task state の SSOT で 1 event 1 JSON、Register は現在値を個票に維持し項目別 YAML 配列を監査履歴とするため、保存形式と fold 処理は共通化しません。
|
|
428
428
|
- 生成物(`generated/` 配下)は追跡対象外のため、PR の差分にも Git 履歴にも現れません。レビュー対象は個票と `events/` 配下の項目別ログです。
|
|
429
|
-
- 既存プロジェクトは移行前でも動作し、event のない個票は Git 履歴から再構成します。`register migrate --dry-run` で件数を確認し、`register migrate` で復元可能な Git 履歴を決定的な event ID へ変換します。浅い clone などで履歴が不足する場合は無理に合成せず Git フォールバックを維持します。
|
|
429
|
+
- 既存プロジェクトは移行前でも動作し、event のない個票は Git 履歴から再構成します。`register migrate` は非推奨であり、次の版(0.10.0)で削除予定です(現在は個別個票ファイルと外部イベントファイルが標準形式のため新規移行は不要です)。旧データを移行する場合は `register migrate --dry-run` で件数を確認し、`register migrate` で復元可能な Git 履歴を決定的な event ID へ変換します。浅い clone などで履歴が不足する場合は無理に合成せず Git フォールバックを維持します。
|
|
430
430
|
- 分離前の CLI は `events/` を読まないため、ロールバック時も項目別ログを削除せず、分離対応版の CLI を再適用して履歴を維持します。
|
|
431
431
|
- 個票へ移行する前(`pjr-index.md` の表が正本だった期間)の履歴は、削除済みの一覧ファイルの履歴に残ります。`git log -p --follow -- <登録簿ディレクトリ>/pjr-index.md` で参照します。
|
|
432
432
|
|
|
@@ -44,4 +44,4 @@ specdojo dashboard build
|
|
|
44
44
|
|
|
45
45
|
## 2. 互換運用
|
|
46
46
|
|
|
47
|
-
`tml-index.yaml`・`timeline build`・`timeline_path`
|
|
47
|
+
`tml-index.yaml`・`timeline build`・`timeline_path`(および `timeline where`)は非推奨であり、次の版(0.10.0)で削除予定です。全体計画は epic と `dashboard build`、保存先確認は `specdojo where timeline` を使用してください。削除までの間は警告付きで互換を維持します。epic がある project の全体計画は epic だけから作り、epic のない project は旧 timeline 表示を維持します。strategy の範囲解決は既存 strategy の scope、epic の `domains`、旧 timeline の順です。移行後も既存 scope が優先されるため、範囲が変わる場合は scope も確認してください。旧コマンドの仕様は [[specdojo:command-reference|コマンドリファレンス]] を参照してください。
|