specdojo 0.4.5 → 0.4.7

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 (101) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -4
  2. package/CHANGELOG.md +41 -0
  3. package/dist/catalog/document-target.js +75 -0
  4. package/dist/commands/agent.js +2 -80
  5. package/dist/commands/init.js +33 -7
  6. package/dist/devcontainer/scaffold.js +5 -1
  7. package/dist/exec/agent-config.js +28 -16
  8. package/dist/exec/agent-plan.js +108 -0
  9. package/dist/exec/commands.js +3 -3
  10. package/dist/exec/evidence.js +35 -3
  11. package/dist/exec/grade-checkpoint.js +12 -0
  12. package/dist/exec/pipeline-state.js +1 -0
  13. package/dist/exec/plans-core.js +11 -67
  14. package/dist/exec/plans-generation.js +22 -5
  15. package/dist/exec/project.js +4 -1
  16. package/dist/exec/register-resume.js +8 -4
  17. package/dist/exec/register.js +66 -5
  18. package/dist/exec/reporter.js +8 -1
  19. package/dist/exec/results.js +1 -1
  20. package/dist/exec/run/agent-pipeline.js +7 -5
  21. package/dist/exec/run/agent.js +14 -1
  22. package/dist/exec/run/lifecycle-commands.js +2 -0
  23. package/dist/exec/run/register-resume.js +2 -0
  24. package/dist/exec/run/register-state.js +4 -1
  25. package/dist/exec/run/register-worktree.js +8 -1
  26. package/dist/exec/run/schedule-prepare.js +7 -1
  27. package/dist/exec/worktree-command.js +8 -1
  28. package/dist/exec/worktree-ops-lifecycle.js +4 -2
  29. package/dist/exec/worktree-ops-merge.js +40 -1
  30. package/dist/grade/apply.js +7 -5
  31. package/dist/grade/command-inspect.js +2 -1
  32. package/dist/grade/command-run.js +39 -0
  33. package/dist/grade/grade.js +3 -1
  34. package/dist/grade/markdown.js +4 -4
  35. package/dist/grade/pipeline-state.js +8 -6
  36. package/dist/grade/plan.js +8 -6
  37. package/dist/grade/run.js +307 -0
  38. package/dist/grade/target-discovery.js +1 -1
  39. package/dist/grade/targets.js +44 -22
  40. package/dist/kata/command.js +54 -9
  41. package/dist/register/approach.js +16 -0
  42. package/dist/register/core.js +2 -0
  43. package/dist/register/create-commands.js +57 -7
  44. package/dist/register/deliverable-target.js +215 -0
  45. package/dist/register/events.js +4 -0
  46. package/dist/register/external-project.js +18 -7
  47. package/dist/register/item.js +8 -0
  48. package/dist/register/views.js +3 -0
  49. package/dist/review/grade.js +19 -17
  50. package/dist/shared/agent-plan.js +1 -0
  51. package/dist/shared/git.js +3 -2
  52. package/dist/shared/lefthook-scaffold.js +5 -22
  53. package/dist/shared/markdownlint-scaffold.js +67 -0
  54. package/dist/shared/provider-scaffold.js +7 -5
  55. package/dist/shared/slidev-scaffold.js +102 -0
  56. package/dist/shared/specdojo-config.js +9 -3
  57. package/dist/specdojo.js +5 -1
  58. package/docs/ja/specdojo/exec-templates/xep-register-template.md +5 -4
  59. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +2 -2
  60. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +2 -2
  61. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +2 -2
  62. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +2 -2
  63. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +2 -2
  64. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +2 -2
  65. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +2 -2
  66. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +2 -2
  67. package/docs/ja/specdojo/exec-templates/xrp-template.md +2 -2
  68. package/docs/ja/specdojo/guides/exec-config-guide.md +81 -19
  69. package/docs/ja/specdojo/guides/exec-operation-guide.md +4 -0
  70. package/docs/ja/specdojo/guides/kata-guide.md +108 -1
  71. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +6 -6
  72. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +3 -1
  73. package/docs/ja/specdojo/guides/quick-start-guide.md +22 -2
  74. package/docs/ja/specdojo/guides/register-operation-guide.md +2 -0
  75. package/docs/ja/specdojo/guides/remote-host-development-guide.md +15 -1
  76. package/docs/ja/specdojo/guides/review-guide.md +2 -2
  77. package/docs/ja/specdojo/guides/ryu-guide.md +12 -0
  78. package/docs/ja/specdojo/references/command-reference.md +178 -62
  79. package/docs/ja/specdojo/references/specdojo-config-reference.md +31 -8
  80. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +28 -22
  81. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +17 -1
  82. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  83. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  84. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +33 -1
  85. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +16 -3
  86. package/package.json +5 -5
  87. package/templates/antigravity/orchestrator.md +4 -4
  88. package/templates/claude/README.md +2 -0
  89. package/templates/claude/agents/specdojo-orchestrator.md +4 -4
  90. package/templates/codex/README.md +38 -9
  91. package/templates/codex/agents/codex-executor.toml +1 -1
  92. package/templates/codex/agents/codex-expert-executor.toml +1 -1
  93. package/templates/codex/agents/codex-expert-review-executor.toml +1 -1
  94. package/templates/codex/agents/codex-review-executor.toml +1 -1
  95. package/templates/codex/agents/specdojo-orchestrator.toml +5 -5
  96. package/templates/codex/orchestrator.md +4 -4
  97. package/templates/devcontainer/devcontainer.json +1 -0
  98. package/templates/init-agent-members.yaml +131 -16
  99. package/templates/opencode/README.md +118 -14
  100. package/templates/opencode/agents/specdojo-orchestrator.md +5 -5
  101. package/templates/opencode/opencode.json +25 -0
@@ -169,12 +169,12 @@ npx specdojo exec validate --project <project-id>
169
169
  - 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
170
170
  - 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
171
171
  - 個票の本文を書き換えて普通に commit するのは、統合中の run がないときだけにする(`.git/index.lock` を確かめる)。commit に失敗したら、index に載ったファイルを残さない。残ると次の run の checkpoint が止まる。
172
- - 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor が書き換えると統合の前に止まる。完了条件で「案を result に書く」と指示し、反映は利用者の承認のもと feature ブランチで行う。
172
+ - 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor が書き換えると統合の前に止まる。register の完了条件では「案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く」と指示する。「案を result に書く」は executor が result を直接書ける実行形式に限る。反映は利用者の承認のもと feature ブランチで行う。
173
173
  - プロジェクトの文書にオーケストレーター向けの運用メモがあれば、作業を始める前に読む。
174
174
 
175
175
  ## close の前の確かめ方
176
176
 
177
- - 完了条件を 1 項目ずつ、差分(`git show`)と result に照らして確かめる。親の検証が通っただけで close しない。
177
+ - 完了条件を 1 項目ずつ、差分(`git show`)と個票の対応結果と result の両方に照らして確かめる。完了条件が求める記録を result だけで未達と判定せず、個票の対応結果にもあるかを確認する。親の検証が通っただけで close しない。
178
178
  - agent の「直した」「反映済み」という報告は、実物(ファイルの中身、生成物、コマンドの出力)で確かめる。agent は、権限で編集を拒まれたあとでも完了と報告することがある。
179
179
  - 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
180
180
  - runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
@@ -198,8 +198,8 @@ npx specdojo exec validate --project <project-id>
198
198
  - 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
199
199
  - 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
200
200
  - CHANGELOG は未公開の版の節に書き、公開済みの版の節を変えないと書く。
201
- - 保護された設定に触れる場合は、案を result に書き、反映は利用者が行うと書く。
202
- - 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を result に書かせるかを明記する。
201
+ - 保護された設定に触れる場合、register の項目では案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く。反映は利用者の承認のもとで行うと書く。「result に書く」は executor が result を直接書ける実行形式に限る。
202
+ - 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を記録させるかを明記する。register の項目では個票の対応結果に書かせ、pipeline では報告の `handoff` にも書かせる。「result に書く」は executor が result を直接書ける実行形式に限る。
203
203
  - Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。
204
204
 
205
205
  ## agent の選び方
package/CHANGELOG.md CHANGED
@@ -2,6 +2,47 @@
2
2
 
3
3
  SpecDojo の利用者に影響する変更を記録します。
4
4
 
5
+ ## [0.4.7] - 2026-10-26
6
+
7
+ ### 追加機能
8
+
9
+ - カタログのない project でも、既存文書の索引・frontmatter、または個票の `--target-path`・`--target-rulebook` から成果物の approach plan を作れるようにしました。`fully-guided` などの kata 不足は起票時に検証し、`bootstrap` の未作成 kata と `finalize` 系の個票からのチェック表にも対応します。`cross-deliverable-dedup` は引き続きカタログが必要です(PJR-6WQY)。
10
+
11
+ - `projects.<id>.run.parent_validations_exclude` で、共有 `exec-defaults.yaml` の親検証から ID と実行先が一致する検証を project ごとに除外できるようにしました。除外後に既存の `parent_validations` を追記し、指定のない project の検証は維持します。未知の ID、共有一覧にない組の除外、重複する組は agent 起動前にエラーになります(PJR-P14M)。
12
+
13
+ - npm package に `specdojo grade run` を追加しました。文書の選択、評価 plan、名簿に基づく agent 実行、marker の機械変換とサイドカー反映を単段で実行し、同じ `--run-id` で未完了の文書だけを再開します。`--by` の別名は実体名で記録し、`--dry-run` で選択と actor を確認できます(PJR-K87Y)。
14
+
15
+ ### 不具合修正
16
+
17
+ - review 前の grade を CLI 本体で実行し、開発用の `tools/grade/run-per-document.sh` への依存を解消しました。宣言済み `project.repos` の相対パスを grade で扱い、grade 結果・完了条件サイドカーを worktree 分岐前の checkpoint に含めます。`exec scaffold --project` の共通観点を `defaults/` から解決し、観点未設定時は同梱定義を使います。review plan の完了条件表を MD060 に適合させました(PJR-K87Y)。
18
+ - OpenCode の scaffold でローカル Ollama の接続・モデル設定を含む `opencode.json`(provider: `ollama-local`)をリポジトリ直下に配置するようにしました。配布する名簿の雛形・agent 定義・接続設定のモデル指定を整合させ、Gemma および Qwen は文脈長 64k を確保するローカル派生タグ(`*-mlx-work-64k`)を標準としました。派生タグ作成手順、接続先設定手順、既存環境の修正手順を OpenCode テンプレートの README および設定ガイドに追記しました(PJR-MB92)。
19
+ - `devcontainer scaffold` で生成する `devcontainer.json` の雛形に `shutdownAction: "none"` を追加し、VS Code などのクライアント切断時にコンテナが停止しないようにしました。既存環境の修正手順を常時稼働ホスト運用ガイドに追記しました(PJR-TVGA)。
20
+
21
+ ## [0.4.6] - 2026-10-25
22
+
23
+ ### 追加機能
24
+
25
+ - `init --slidev` と `config scaffold --slidev` で、Slidev 本体・Prettier plugin と kata 用の整形・markdownlint 除外設定を追加できるようにしました。既存設定・依存は保持し、追加内容を表示します。`init` の Dev Container preset が `full` の場合は Slidev 導入を既定で選び、`--no-slidev` で解除できます。`full` の VS Code 拡張に `antfu.slidev` を追加しました(PJR-84F7)。
26
+
27
+ ### 変更
28
+
29
+ - 同梱のオーケストレーターの本文で、register の完了条件の記録の書き先を「個票の対応結果」と報告の `handoff` にし、close の前に result だけでなく個票の対応結果も確かめるようにしました(PJR-R1FB)。
30
+ - `specdojo init --exec` が書く agent の名簿の雛形を、GPT-6 の系統と normal・expert の 2 段にそろえました。codex の normal は `gpt-6-luna` の `luna-executor`・`luna-review-executor`・`luna-reporter`、expert は `gpt-6.1-sol` の `sol-executor`・`sol-review-executor` です。claude には expert の `opus-executor`・`opus-review-executor` を加えました。別名 `claude-expert-executor`・`claude-expert-review-executor`・`codex-expert-executor`・`codex-expert-review-executor` を加え、`codex-executor` などの既存の別名は `luna-*` を指します。振り分けの表(`routing`)は hard を expert の別名、medium と easy と reporter を normal の別名にします。`init` と `config scaffold` が加える codex の起動スクリプトは `orch:sol`(`gpt-6.1-sol`)と `orch:luna`(`gpt-6-luna`)になり、`orch:terra` は作りません(PJR-9482)。
31
+ - 配布する `templates/codex/agents/*.toml` のモデルを名簿の雛形と同じ GPT-6 の系統へ引き上げました。`codex-executor`・`codex-review-executor` は `gpt-6-luna`(`medium`)、`codex-expert-executor`・`codex-expert-review-executor` は `gpt-6.1-sol`(`high`)、`specdojo-orchestrator` は `gpt-6.1-sol`(`medium`)です。既存の `.codex/agents/*.toml` は上書きされないため、移行する場合は `specdojo config scaffold --provider codex --force` で再配置するか、各ファイルの `model` を手動で書き換えます(PJR-EVAQ)。
32
+ - 既存の `.specdojo/agent-members.yaml`・`.specdojo/exec-defaults.yaml`・`package.json` は書き換えません。新しい名前へそろえる場合は、名簿の `terra-*` を `luna-*`(`model: gpt-6-luna`)へ、`sol-*` の `model` を `gpt-6.1-sol` へ変え、`aliases` の向き先を合わせます。`package.json` の `orch:terra` は `orch:luna`(`-m gpt-6-luna`)へ、`orch:sol` は `-m gpt-6.1-sol` へ手で直します。手順は exec 設定ガイドの `agent の名簿の 2 段構成と移行` にあります。
33
+
34
+ ### 不具合修正
35
+
36
+ - 登録簿に項目が 1 件もないとき、`register build` が生成する担当者別と状態別の派生ビューの空の章で空行が連続し、markdownlint の `MD012` に当たる問題を直しました。項目のない章には「該当なし」を書きます。項目がある場合の生成物は変わりません(PJR-ZG0A)。
37
+ - `init --lefthook` と `config scaffold --lefthook` の基本設定を `.markdownlintrc` に変更し、これを読み込む `.markdownlint-cli2.yaml` も生成するようにしました。VS Code で CLI2 のファイル別 overrides が効き、`--slidev` は kata の glob に Slidev 用の規則を当てます。commit hook と result 検査は markdownlint-cli を使い続けます。既存設定は保持し、追加例と移行手順を案内します(PJR-50YH)。
38
+ - executor の報告に省略可能な `completion_status`(`complete` / `incomplete`)を追加しました。未完了を申告した register 項目は終了コード 0 でも `waiting` となり、理由と残作業、worktree を保持して統合を止めます。`--resume --resume-from executor` で再開でき、欄のない既存報告は従来どおり扱います(PJR-XTE6)。
39
+ - `kata list`・`kata status` の kata 候補と `kata eject` の ID 選択を `.md`・`.mdx`・`.yaml`・`.yml`・`.json` にそろえ、同名 CSS などを別の kata として扱わないようにしました。`kata eject`・`kata install --all` は同名の付属ファイルと同名ディレクトリ内の画像などもコピーし、`--dry-run`・`--force` をファイルごとに適用します。付属ファイルだけの差分も親 kata の `modified` に含めます(PJR-6HS2)。
40
+ - `register update` で approach・target・source を変更しない場合、記録済みの組み合わせを再検証しないようにしました。authoring の kata が作成された後も、担当・期限・優先度などの更新を続けられます。approach 関連の値を変更する場合と `register add` では従来どおり検証します(PJR-JJBY)。
41
+ - executor の報告に省略可能な `handoff`(申し送り)を追加し、reporter の処理後に runner が edit result の申し送りへ確実に転記するようにしました。register の plan も、result への記載を求める完了条件を個票の対応結果と報告の `handoff` に記録するようにしました。`handoff` のない既存の報告も引き続き受け付けます(PJR-R1FB)。
42
+ - `external_projects` で SpecDojo 自身のリポジトリへ起票できるようにしました。相手に `node_modules/.bin/specdojo` がなく、`package.json` の `name` が `specdojo` の場合は `node <相手>/dist/specdojo.js` を使います。未ビルドの場合は `npm run build` を案内して停止します(PJR-PM2R)。
43
+ - 着手の checkpoint・待ち状態の記帳・統合の commit が hook で失敗したとき、空白を含む step 名(`lint Markdown documentation` など)でも、成功した Prettier の step ではなく、失敗印の付いた step と最初の error の行を要約するようにしました。checkpoint の失敗要約を補足説明より前に置き、`block_reason` にも原因を残します(PJR-68KR)。
44
+ - owner の role に当てはまるレビュー観点がないとき(カタログや `pm-roles.yaml`・`pm-review-viewpoints.yaml` がない project など)、edit plan のレビュー観点の欄を `_MISSING_` だけの段落ではなく箇条書きの 1 項目(`- _MISSING_`)にしました。`rulebook-maintenance` などの kata の見直しの plan が、着手の checkpoint の commit で hook の markdownlint(MD036)に止められていました(PJR-SS72)。
45
+
5
46
  ## [0.4.5] - 2026-10-24
6
47
 
7
48
  ### 追加機能
@@ -0,0 +1,75 @@
1
+ import { existsSync, readFileSync } from "node:fs";
2
+ import { basename, resolve } from "node:path";
3
+ import { collectResolvedDeliverables } from "./build.js";
4
+ import { resolveBasePath } from "./paths.js";
5
+ import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
6
+ import { load } from "../shared/yaml.js";
7
+ import { listFilesRecursive } from "../shared/fs.js";
8
+ import { isDctPlanFileName } from "./plan.js";
9
+ import { specdojoRootDir } from "../shared/specdojo-config.js";
10
+ // Existing document metadata is authoritative; uncreated product docs use a bare id.
11
+ export function deliverableDocId(projectId, localId, resolvedPath, repoRoot = specdojoRootDir()) {
12
+ if (resolvedPath) {
13
+ const absolutePath = resolve(repoRoot, resolvedPath);
14
+ if (existsSync(absolutePath)) {
15
+ try {
16
+ const id = readSpecdojoNamespace(readFileSync(absolutePath, "utf8")).id;
17
+ if (typeof id === "string" && id.trim())
18
+ return id.trim();
19
+ }
20
+ catch {
21
+ // Invalid metadata falls back to the placement convention.
22
+ }
23
+ }
24
+ const normalized = resolvedPath.replaceAll("\\", "/").replace(/^\/+/, "");
25
+ if (/^docs\/[a-z]{2}\/product(?:\/|$)/.test(normalized))
26
+ return localId;
27
+ }
28
+ return projectId ? `${projectId}:${localId}` : localId;
29
+ }
30
+ export function loadPlanCatalogDocs(catalogPath) {
31
+ if (!catalogPath || !existsSync(catalogPath))
32
+ return [];
33
+ // Catalog scans walk subdirectories, so agent judgment plans (plans/dct-plan-*.yaml)
34
+ // must be excluded; they share the dct- prefix but carry no catalog structure.
35
+ const files = listFilesRecursive(catalogPath)
36
+ .filter((f) => {
37
+ const name = basename(f);
38
+ return /^dct-.+\.ya?ml$/i.test(name) && !isDctPlanFileName(name);
39
+ })
40
+ .sort();
41
+ const docs = [];
42
+ for (const filePath of files) {
43
+ try {
44
+ docs.push(load(readFileSync(filePath, "utf8")));
45
+ }
46
+ catch {
47
+ continue;
48
+ }
49
+ }
50
+ return docs;
51
+ }
52
+ export function resolveDeliverableByDocId(catalogPath, projectId, targetId, repoRoot = specdojoRootDir()) {
53
+ const matches = [];
54
+ for (const doc of loadPlanCatalogDocs(catalogPath)) {
55
+ const deliverables = [];
56
+ collectResolvedDeliverables(doc.groups, resolveBasePath("", doc.base_path), deliverables);
57
+ for (const { item, resolvedPath } of deliverables) {
58
+ if (targetId === deliverableDocId(projectId, item.local_id, resolvedPath, repoRoot) ||
59
+ targetId === item.local_id ||
60
+ targetId === `${projectId}:${item.local_id}`) {
61
+ matches.push({
62
+ domain: doc.domain,
63
+ localId: item.local_id,
64
+ slug: item.local_id,
65
+ info: { deliverable: item, resolvedPath },
66
+ });
67
+ }
68
+ }
69
+ }
70
+ if (matches.length === 0)
71
+ throw new Error(`catalog deliverable target not found for document id: ${targetId}`);
72
+ if (matches.length > 1)
73
+ throw new Error(`ambiguous catalog deliverable target for document id ${targetId}: ${matches.map((match) => match.localId).join(", ")}`);
74
+ return matches[0];
75
+ }
@@ -1,83 +1,5 @@
1
- import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
2
- import { dirname, resolve } from "node:path";
3
- import { defaultExecDefaultsPath, loadExecDefaultsConfig, resolveMemberCommand, resolveRateLimitDetection, resolveRateLimitPolicy, } from "../exec/agent-config.js";
4
- import { resolveProjectPaths } from "../exec/project.js";
5
- import { executeAgent, loadRosterForExecutionPath } from "../exec/run/run.js";
6
- import { gitEnvironment } from "../shared/git-environment.js";
7
- import { resolveAgentMember as resolveRosterAgentMember, specdojoRootDir, } from "../shared/specdojo-config.js";
8
- // Rate limit は通常失敗と異なり、呼び出し側が処理済みにせず中断・再開する必要がある。
9
- // shell script が出力文字列を解析せず分岐できるよう、一時失敗を表す専用コードにする。
10
- export const AGENT_RUN_RATE_LIMIT_EXIT_CODE = 75;
11
- export function resolveAgentMember(roster, nickname) {
12
- const directMembers = roster?.members.filter((candidate) => {
13
- return candidate.type === "agent" && candidate.nickname === nickname;
14
- });
15
- if (directMembers && directMembers.length > 1) {
16
- return { error: `--by agent nickname is not unique in agent-members.yaml: ${nickname}` };
17
- }
18
- const member = resolveRosterAgentMember(roster, nickname);
19
- if (!member) {
20
- return { error: `--by agent nickname not found in agent-members.yaml: ${nickname}` };
21
- }
22
- if (member.disabled) {
23
- return { error: `--by agent is disabled in agent-members.yaml: ${nickname}` };
24
- }
25
- return { member };
26
- }
27
- export function resolveAgentCommand(execDefaults, member) {
28
- let command;
29
- try {
30
- command = resolveMemberCommand(execDefaults, member);
31
- }
32
- catch (error) {
33
- return { error: error instanceof Error ? error.message : String(error) };
34
- }
35
- if (!command) {
36
- return { error: `--by agent has no resolvable command: ${member.nickname}` };
37
- }
38
- return { command };
39
- }
40
- export function readAgentPlan(planPath) {
41
- const absolutePath = resolve(planPath);
42
- if (!existsSync(absolutePath)) {
43
- throw new Error(`--plan not found: ${planPath}`);
44
- }
45
- const prompt = readFileSync(absolutePath, "utf8");
46
- if (!prompt.trim()) {
47
- throw new Error(`--plan is empty: ${planPath}`);
48
- }
49
- return prompt;
50
- }
51
- export function writeAgentOutput(outPath, stdout) {
52
- const absolutePath = resolve(outPath);
53
- mkdirSync(dirname(absolutePath), { recursive: true });
54
- writeFileSync(absolutePath, stdout, "utf8");
55
- return absolutePath;
56
- }
57
- export async function runAgentPlan(opts) {
58
- const prompt = readAgentPlan(opts.planPath);
59
- const paths = resolveProjectPaths({ project: opts.project });
60
- const roster = loadRosterForExecutionPath(paths.executionPath);
61
- const memberResult = resolveAgentMember(roster, opts.nickname);
62
- if ("error" in memberResult)
63
- throw new Error(memberResult.error);
64
- const { member } = memberResult;
65
- const execDefaults = loadExecDefaultsConfig(opts.execDefaultsPath ?? defaultExecDefaultsPath(), paths.executionPath);
66
- const commandResult = resolveAgentCommand(execDefaults, member);
67
- if ("error" in commandResult)
68
- throw new Error(commandResult.error);
69
- const { command } = commandResult;
70
- if (opts.dryRun) {
71
- process.stdout.write(`${command}\n`);
72
- return { command, actor: member.nickname };
73
- }
74
- const execution = await executeAgent(command, prompt, resolveRateLimitDetection(execDefaults, member.provider), member.provider, resolveRateLimitPolicy(execDefaults, member.provider)?.cooldown_seconds, specdojoRootDir(), {
75
- ...gitEnvironment(),
76
- SPECDOJO_SCHEDULE_PATH: paths.schedulePath,
77
- SPECDOJO_EXECUTION_PATH: paths.executionPath,
78
- }, opts.quiet);
79
- return { execution, command, actor: member.nickname };
80
- }
1
+ import { AGENT_RUN_RATE_LIMIT_EXIT_CODE, runAgentPlan, writeAgentOutput, } from "../exec/agent-plan.js";
2
+ export { AGENT_RUN_RATE_LIMIT_EXIT_CODE, resolveAgentMember, resolveAgentCommand, readAgentPlan, writeAgentOutput, runAgentPlan, } from "../exec/agent-plan.js";
81
3
  export function registerAgentCommands(program) {
82
4
  const agent = program.command("agent").description("Run a plan with a specific agent");
83
5
  agent
@@ -6,6 +6,7 @@ import { runScaffold } from "../catalog/scaffold.js";
6
6
  import { runDevcontainerScaffold } from "../devcontainer/scaffold.js";
7
7
  import { runProviderScaffold } from "../shared/provider-scaffold.js";
8
8
  import { runLefthookScaffold } from "../shared/lefthook-scaffold.js";
9
+ import { runSlidevScaffold, SLIDEV_KATA_PATTERNS } from "../shared/slidev-scaffold.js";
9
10
  import { generateDerivedViewFiles } from "../register/register.js";
10
11
  import { defaultWorktreeBase, projectGitignoreLayout, specdojoRootDir, } from "../shared/specdojo-config.js";
11
12
  import { ensureGitignore, formatGitignoreReport, gitignorePatternsForLayouts, } from "../shared/specdojo-gitignore.js";
@@ -147,6 +148,7 @@ export async function collectInitAnswers(options, prompter) {
147
148
  catalog: parseCatalog(options.catalog),
148
149
  devcontainer,
149
150
  lefthook: !!options.lefthook,
151
+ slidev: options.slidev ?? (devcontainer && devcontainerPreset === "full"),
150
152
  ...(devcontainerPreset ? { devcontainerPreset } : {}),
151
153
  });
152
154
  for (const [label, used] of [
@@ -160,6 +162,7 @@ export async function collectInitAnswers(options, prompter) {
160
162
  ["catalog=none", !options.catalog],
161
163
  ["devcontainer=no", !options.devcontainer],
162
164
  ["lefthook=no", !options.lefthook],
165
+ [`slidev=${answers.slidev ? "yes" : "no"}`, options.slidev === undefined],
163
166
  ["devcontainer-preset=recommended", devcontainer && options.devcontainerPreset === undefined],
164
167
  ]) {
165
168
  if (used)
@@ -196,6 +199,8 @@ export async function collectInitAnswers(options, prompter) {
196
199
  ? await promptUntilValid(prompter, "Dev Container preset (minimal, recommended, full) [recommended]: ", (answer) => parseDevcontainerPreset(answer.trim() || "recommended"))
197
200
  : explicitDevcontainerPreset;
198
201
  const lefthook = await promptUntilValid(prompter, `Create Git hooks with lefthook? [${lefthookDefault ? "Y/n" : "y/N"}]: `, (answer) => parseBoolean(answer, lefthookDefault));
202
+ const slidevDefault = options.slidev ?? (devcontainer && devcontainerPreset === "full");
203
+ const slidev = await promptUntilValid(prompter, `Set up Slidev for kata? [${slidevDefault ? "Y/n" : "y/N"}]: `, (answer) => parseBoolean(answer, slidevDefault));
199
204
  return validateAnswers({
200
205
  projectId,
201
206
  projectName,
@@ -207,6 +212,7 @@ export async function collectInitAnswers(options, prompter) {
207
212
  catalog,
208
213
  devcontainer,
209
214
  lefthook,
215
+ slidev,
210
216
  ...(devcontainerPreset ? { devcontainerPreset } : {}),
211
217
  });
212
218
  }
@@ -341,28 +347,42 @@ function writeExecConfiguration(repoRoot, packageRoot, providers, dryRun) {
341
347
  const selected = new Set(providers);
342
348
  const members = memberTemplate.members.filter((member) => member.provider && selected.has(member.provider));
343
349
  const aliases = selectAliases(memberTemplate.aliases ?? [], new Set(members.map((member) => member.nickname)));
350
+ // normal の段(medium・easy と全 reporter)と expert の段(hard)を provider ごとに選ぶ。
351
+ // expert の段がない provider(opencode・antigravity など)は hard も normal の段を使う。
344
352
  const pairs = providers.map((provider) => {
345
- const executor = members.find((member) => member.provider === provider && member.stage_role === "executor" && member.mode === "edit");
346
- const reporter = members.find((member) => member.provider === provider && member.stage_role === "reporter");
353
+ const executor = members.find((member) => member.provider === provider &&
354
+ member.stage_role === "executor" &&
355
+ member.mode === "edit" &&
356
+ member.proficiency !== "expert");
357
+ const expertExecutor = members.find((member) => member.provider === provider &&
358
+ member.stage_role === "executor" &&
359
+ member.mode === "edit" &&
360
+ member.proficiency === "expert");
361
+ const reporter = members.find((member) => member.provider === provider &&
362
+ member.stage_role === "reporter" &&
363
+ member.proficiency !== "expert");
347
364
  if (!executor || !reporter) {
348
365
  throw new Error(`init-agent-members.yaml must define an edit executor and reporter for ${provider}`);
349
366
  }
367
+ const normalExecutor = preferredAgentName(executor, aliases);
350
368
  return {
351
- executor: preferredAgentName(executor, aliases),
369
+ executor: normalExecutor,
370
+ hardExecutor: expertExecutor ? preferredAgentName(expertExecutor, aliases) : normalExecutor,
352
371
  reporter: preferredAgentName(reporter, aliases),
353
372
  };
354
373
  });
355
- const route = (pairIndex, action) => {
374
+ const route = (pairIndex, action, tier = "normal") => {
375
+ const executorOf = (pair) => tier === "expert" ? pair.hardExecutor : pair.executor;
356
376
  const resolvedIndex = Math.min(pairIndex, pairs.length - 1);
357
377
  const pair = pairs[resolvedIndex];
358
378
  const fallback = pairs.length > 1 ? pairs[(resolvedIndex + 1) % pairs.length] : undefined;
359
379
  return {
360
- executor_by: pair.executor,
380
+ executor_by: executorOf(pair),
361
381
  reporter_by: pair.reporter,
362
382
  on_rate_limit: action === "fallback" && !fallback ? "stop" : action,
363
383
  ...(fallback
364
384
  ? {
365
- fallback_executor_by: fallback.executor,
385
+ fallback_executor_by: executorOf(fallback),
366
386
  fallback_reporter_by: fallback.reporter,
367
387
  }
368
388
  : {}),
@@ -378,7 +398,7 @@ function writeExecConfiguration(repoRoot, packageRoot, providers, dryRun) {
378
398
  const configuredDefaults = {
379
399
  ...commonDefaults,
380
400
  routing: {
381
- hard: route(0, "wait"),
401
+ hard: route(0, "wait", "expert"),
382
402
  medium: route(1, "fallback"),
383
403
  easy: route(2, "fallback"),
384
404
  },
@@ -531,10 +551,14 @@ export async function runInit(options, deps) {
531
551
  packageRoot,
532
552
  repoRoot,
533
553
  config,
554
+ slidevKataPatterns: answers.slidev ? SLIDEV_KATA_PATTERNS : [],
534
555
  force: false,
535
556
  dryRun,
536
557
  });
537
558
  }
559
+ if (answers.slidev) {
560
+ await runSlidevScaffold({ repoRoot, dryRun });
561
+ }
538
562
  const firstProvider = answers.providers[0];
539
563
  const script = firstProvider === "claude"
540
564
  ? "orch:opus"
@@ -570,6 +594,8 @@ export function registerInitCommand(program) {
570
594
  .option("--catalog <size>", "Create a deliverables catalog (small|medium|large)")
571
595
  .option("--devcontainer", "Create a Dev Container for the selected providers", false)
572
596
  .option("--lefthook", "Create pre-commit hooks for SpecDojo repositories", false)
597
+ .option("--slidev", "Set up Slidev and formatting for kata (default with full preset)")
598
+ .option("--no-slidev", "Skip Slidev setup, including with the full preset")
573
599
  .option("--devcontainer-preset <name>", "Apply a Dev Container preset when creating it (minimal|recommended|full; none aliases minimal)")
574
600
  .option("--workspace-name <name>", "Override the Dev Container workspace parent name used under /workspaces")
575
601
  .option("--dry-run", "Show planned files and changes without writing", false)
@@ -274,7 +274,11 @@ fi`);
274
274
  let vscodeExtensions = [];
275
275
  let extensionsFile;
276
276
  if (includesRecommended) {
277
- vscodeExtensions = unique([...RECOMMENDED_VSCODE_EXTENSIONS, ...providerExtensions(providers)]);
277
+ vscodeExtensions = unique([
278
+ ...RECOMMENDED_VSCODE_EXTENSIONS,
279
+ ...providerExtensions(providers),
280
+ ...(full ? ["antfu.slidev"] : []),
281
+ ]);
278
282
  const customizations = (devcontainer.customizations ??= {});
279
283
  const vscode = (customizations.vscode ??= {});
280
284
  const existingExtensions = Array.isArray(vscode.extensions)
@@ -3,7 +3,7 @@ import { isAbsolute, join, resolve } from "node:path";
3
3
  import { listFilesRecursive, readYaml } from "./shared.js";
4
4
  import { acquirePoolSlot, releaseLock } from "./slot-lock.js";
5
5
  import { getProjectExecutionPath, loadConfig, specdojoRootDir, } from "../shared/specdojo-config.js";
6
- import { resolveParentValidationConcurrency, resolveParentValidationDefinitions, } from "./parent-validation.js";
6
+ import { resolveParentValidationConcurrency, resolveParentValidationAssignments, resolveParentValidationDefinitions, } from "./parent-validation.js";
7
7
  const PLACEHOLDER_PATTERN = /\{([a-z][a-z0-9_]*)\}/g;
8
8
  const BUILTIN_VARIABLE_NAMES = new Set(["nickname", "mode", "proficiency"]);
9
9
  // Mirror of the nickname pattern in docs/specdojo/schemas/v1/agent-members.schema.yaml.
@@ -283,12 +283,12 @@ function loadLegacyRateLimitPolicy(executionPath) {
283
283
  }
284
284
  return undefined;
285
285
  }
286
- function projectParentValidations(executionPath) {
286
+ function projectParentValidationOverrides(executionPath) {
287
287
  if (!executionPath)
288
- return [];
288
+ return {};
289
289
  const { config } = loadConfig();
290
290
  if (!config)
291
- return [];
291
+ return {};
292
292
  const rootDir = specdojoRootDir();
293
293
  const targetExecutionPath = resolve(executionPath);
294
294
  const normalizedTarget = targetExecutionPath.replaceAll("\\", "/");
@@ -303,16 +303,18 @@ function projectParentValidations(executionPath) {
303
303
  normalizedTarget.endsWith(`/${normalizedConfigured.replace(/^\.\//, "")}`);
304
304
  if (resolvedExecutionPath !== targetExecutionPath && !isProjectWorktreePath)
305
305
  continue;
306
- const entries = project.run
307
- ?.parent_validations;
308
- if (entries === undefined)
309
- return [];
310
- if (!Array.isArray(entries)) {
311
- throw new Error(`Invalid .specdojo/specdojo.config.json: projects.${projectId}.run.parent_validations must be an array`);
306
+ for (const key of ["parent_validations", "parent_validations_exclude"]) {
307
+ const entries = project.run?.[key];
308
+ if (entries !== undefined && !Array.isArray(entries)) {
309
+ throw new Error(`Invalid .specdojo/specdojo.config.json: projects.${projectId}.run.${key} must be an array`);
310
+ }
312
311
  }
313
- return entries;
312
+ return {
313
+ append: project.run?.parent_validations,
314
+ exclude: project.run?.parent_validations_exclude,
315
+ };
314
316
  }
315
- return [];
317
+ return {};
316
318
  }
317
319
  export function loadExecDefaultsConfig(configPath, executionPath) {
318
320
  const path = configPath ?? defaultExecDefaultsPath();
@@ -331,15 +333,25 @@ export function loadExecDefaultsConfig(configPath, executionPath) {
331
333
  if (legacyPolicy)
332
334
  defaults.rate_limit_policy = legacyPolicy;
333
335
  }
334
- const additionalParentValidations = projectParentValidations(executionPath);
335
- if (additionalParentValidations.length > 0) {
336
+ const overrides = projectParentValidationOverrides(executionPath);
337
+ if (overrides.exclude?.length || overrides.append?.length) {
338
+ const sharedEntries = defaults.pipeline?.parent_validations ?? [];
339
+ // Validate the shared list before filtering so an exclusion cannot hide invalid defaults.
340
+ const sharedAssignments = resolveParentValidationAssignments(sharedEntries);
341
+ const sharedLabels = new Set(sharedAssignments.map(({ label }) => label));
342
+ const excludedLabels = new Set(resolveParentValidationAssignments(overrides.exclude).map(({ label }) => label));
343
+ for (const label of excludedLabels) {
344
+ if (!sharedLabels.has(label)) {
345
+ throw new Error(`Invalid run.parent_validations_exclude: ${label} is not present in shared pipeline.parent_validations`);
346
+ }
347
+ }
336
348
  defaults = {
337
349
  ...defaults,
338
350
  pipeline: {
339
351
  ...defaults.pipeline,
340
352
  parent_validations: [
341
- ...(defaults.pipeline?.parent_validations ?? []),
342
- ...additionalParentValidations,
353
+ ...sharedEntries.filter((_, index) => !excludedLabels.has(sharedAssignments[index].label)),
354
+ ...(overrides.append ?? []),
343
355
  ],
344
356
  },
345
357
  };
@@ -0,0 +1,108 @@
1
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
2
+ import { dirname, resolve } from "node:path";
3
+ import { defaultExecDefaultsPath, loadExecDefaultsConfig, resolveMemberCommand, resolveRateLimitDetection, resolveRateLimitPolicy, } from "./agent-config.js";
4
+ import { resolveProjectPaths } from "./project.js";
5
+ import { selectCandidates } from "./run/shared.js";
6
+ import { executeAgent, loadRosterForExecutionPath } from "./run/agent.js";
7
+ import { gitEnvironment } from "../shared/git-environment.js";
8
+ import { resolveAgentMember as resolveRosterAgentMember, specdojoRootDir, loadMemberRoster, getProjectExecutionPath, loadConfig, } from "../shared/specdojo-config.js";
9
+ // Rate limit は通常失敗と異なり、呼び出し側が処理済みにせず中断・再開する必要がある。
10
+ // shell script が出力文字列を解析せず分岐できるよう、一時失敗を表す専用コードにする。
11
+ export const AGENT_RUN_RATE_LIMIT_EXIT_CODE = 75;
12
+ /** Select a grading executor using the same roster eligibility and priority as exec. */
13
+ export function resolveGradingPlanActor(opts) {
14
+ const { config } = loadConfig();
15
+ const projectId = opts.project ?? config?.current_project ?? Object.keys(config?.projects ?? {})[0];
16
+ const project = projectId ? config?.projects[projectId] : undefined;
17
+ if (!project)
18
+ throw new Error(`Unknown project: ${projectId}`);
19
+ const roster = loadMemberRoster(specdojoRootDir(), project);
20
+ const defaults = loadExecDefaultsConfig(opts.execDefaultsPath ?? defaultExecDefaultsPath(), getProjectExecutionPath(project));
21
+ let nickname = opts.by;
22
+ if (!nickname) {
23
+ const candidates = selectCandidates({ capabilities: [], stage_role: "executor" }, roster, "review", undefined, defaults);
24
+ const legacy = selectCandidates({ capabilities: [] }, roster, "review", undefined, defaults);
25
+ nickname = (candidates[0] ?? legacy[0])?.nickname;
26
+ }
27
+ if (!nickname)
28
+ throw new Error("No runnable grading agent in agent-members.yaml; supply --by");
29
+ const found = resolveAgentMember(roster, nickname);
30
+ if ("error" in found)
31
+ throw new Error(found.error);
32
+ if (found.member.stage_role === "reporter" || found.member.mode === "report")
33
+ throw new Error(`Grading agent must be an executor: ${nickname}`);
34
+ const command = resolveAgentCommand(defaults, found.member);
35
+ if ("error" in command)
36
+ throw new Error(command.error);
37
+ return found.member.nickname;
38
+ }
39
+ export function resolveAgentMember(roster, nickname) {
40
+ const directMembers = roster?.members.filter((candidate) => {
41
+ return candidate.type === "agent" && candidate.nickname === nickname;
42
+ });
43
+ if (directMembers && directMembers.length > 1) {
44
+ return { error: `--by agent nickname is not unique in agent-members.yaml: ${nickname}` };
45
+ }
46
+ const member = resolveRosterAgentMember(roster, nickname);
47
+ if (!member) {
48
+ return { error: `--by agent nickname not found in agent-members.yaml: ${nickname}` };
49
+ }
50
+ if (member.disabled) {
51
+ return { error: `--by agent is disabled in agent-members.yaml: ${nickname}` };
52
+ }
53
+ return { member };
54
+ }
55
+ export function resolveAgentCommand(execDefaults, member) {
56
+ let command;
57
+ try {
58
+ command = resolveMemberCommand(execDefaults, member);
59
+ }
60
+ catch (error) {
61
+ return { error: error instanceof Error ? error.message : String(error) };
62
+ }
63
+ if (!command) {
64
+ return { error: `--by agent has no resolvable command: ${member.nickname}` };
65
+ }
66
+ return { command };
67
+ }
68
+ export function readAgentPlan(planPath) {
69
+ const absolutePath = resolve(planPath);
70
+ if (!existsSync(absolutePath)) {
71
+ throw new Error(`--plan not found: ${planPath}`);
72
+ }
73
+ const prompt = readFileSync(absolutePath, "utf8");
74
+ if (!prompt.trim()) {
75
+ throw new Error(`--plan is empty: ${planPath}`);
76
+ }
77
+ return prompt;
78
+ }
79
+ export function writeAgentOutput(outPath, stdout) {
80
+ const absolutePath = resolve(outPath);
81
+ mkdirSync(dirname(absolutePath), { recursive: true });
82
+ writeFileSync(absolutePath, stdout, "utf8");
83
+ return absolutePath;
84
+ }
85
+ export async function runAgentPlan(opts) {
86
+ const prompt = readAgentPlan(opts.planPath);
87
+ const paths = resolveProjectPaths({ project: opts.project });
88
+ const roster = loadRosterForExecutionPath(paths.executionPath);
89
+ const memberResult = resolveAgentMember(roster, opts.nickname);
90
+ if ("error" in memberResult)
91
+ throw new Error(memberResult.error);
92
+ const { member } = memberResult;
93
+ const execDefaults = loadExecDefaultsConfig(opts.execDefaultsPath ?? defaultExecDefaultsPath(), paths.executionPath);
94
+ const commandResult = resolveAgentCommand(execDefaults, member);
95
+ if ("error" in commandResult)
96
+ throw new Error(commandResult.error);
97
+ const { command } = commandResult;
98
+ if (opts.dryRun) {
99
+ process.stdout.write(`${command}\n`);
100
+ return { command, actor: member.nickname };
101
+ }
102
+ const execution = await executeAgent(command, prompt, resolveRateLimitDetection(execDefaults, member.provider), member.provider, resolveRateLimitPolicy(execDefaults, member.provider)?.cooldown_seconds, specdojoRootDir(), {
103
+ ...gitEnvironment(),
104
+ SPECDOJO_SCHEDULE_PATH: paths.schedulePath,
105
+ SPECDOJO_EXECUTION_PATH: paths.executionPath,
106
+ }, opts.quiet);
107
+ return { execution, command, actor: member.nickname };
108
+ }
@@ -10,7 +10,7 @@ import { displayWidth, nowUtcIsoSeconds, padEndDisplay, requireNonEmpty } from "
10
10
  import { archivePlan, buildInPlaceStem, generateDeliverablePlan, generateSinglePlan, resolveDeliverableTarget, stemFromPlanPath, } from "./plans.js";
11
11
  import { runProviderScaffold, specdojoPackageRootDir } from "../shared/provider-scaffold.js";
12
12
  import { generateRegisterPlan, normalizePjrId, resolveRegisterRunTarget } from "./register.js";
13
- import { scaffoldViewpoints } from "../review/plan.js";
13
+ import { commonViewpointsPath, scaffoldViewpoints } from "../review/plan.js";
14
14
  import { registerCycleCommand, registerResumeCommand, registerRunCommand, registerSlotsCommand, } from "./run/run.js";
15
15
  import { buildTaskView } from "./task-view.js";
16
16
  import { registerExecWorktreeCommands } from "./worktree-command.js";
@@ -466,7 +466,7 @@ export function registerExecCommands(program) {
466
466
  if (!project)
467
467
  throw new Error(`Unknown project: ${projectId}`);
468
468
  const baseDir = specdojoRootDir();
469
- const commonPath = join(baseDir, "docs", "ja", "specdojo", "standards", "pm-review-viewpoints.yaml");
469
+ const commonPath = commonViewpointsPath();
470
470
  const viewpointsRel = getProjectViewpointsPath(project);
471
471
  if (viewpointsRel) {
472
472
  const outputPath = pathResolve(baseDir, viewpointsRel);
@@ -484,7 +484,7 @@ export function registerExecCommands(program) {
484
484
  }
485
485
  }
486
486
  else {
487
- process.stdout.write(`viewpoints_path not set for project '${projectId}'. Add it to specdojo.config.json.\n`);
487
+ process.stdout.write(`viewpoints_path not set for project '${projectId}'; using specdojo:pm-review-viewpoints (${commonPath}).\n`);
488
488
  }
489
489
  }
490
490
  catch (error) {