specdojo 0.3.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (104) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/dist/catalog-build-references.js +144 -0
  3. package/dist/catalog-build-render.js +144 -0
  4. package/dist/catalog-build.js +13 -290
  5. package/dist/catalog-generate.js +6 -9
  6. package/dist/catalog-plan-generate.js +2 -2
  7. package/dist/catalog-plan.js +6 -6
  8. package/dist/catalog-scaffold.js +4 -4
  9. package/dist/catalog.js +2 -2
  10. package/dist/dashboard-exec-records.js +105 -0
  11. package/dist/dashboard-routines.js +255 -0
  12. package/dist/dashboard-shared.js +14 -0
  13. package/dist/dashboard-timeline.js +175 -0
  14. package/dist/dashboard.js +10 -544
  15. package/dist/deliverable-trash.js +3 -3
  16. package/dist/doc-index.js +3 -3
  17. package/dist/exec-commands.js +557 -0
  18. package/dist/exec-core.js +457 -0
  19. package/dist/exec-plans-core.js +693 -0
  20. package/dist/exec-plans-generation.js +206 -0
  21. package/dist/exec-plans-storage.js +131 -0
  22. package/dist/exec-plans.js +3 -1018
  23. package/dist/exec-repo-integration-git.js +23 -0
  24. package/dist/exec-repo-integration-sync.js +264 -0
  25. package/dist/exec-repo-integration.js +4 -281
  26. package/dist/exec-reporter-output.js +206 -0
  27. package/dist/exec-reporter.js +2 -206
  28. package/dist/exec-results.js +22 -15
  29. package/dist/exec-run-agent-pipeline.js +256 -0
  30. package/dist/exec-run-agent.js +531 -0
  31. package/dist/exec-run-in-place.js +541 -0
  32. package/dist/exec-run-job.js +717 -0
  33. package/dist/exec-run-lifecycle-commands.js +522 -0
  34. package/dist/exec-run-mode-shared.js +140 -0
  35. package/dist/exec-run-register-command.js +244 -0
  36. package/dist/exec-run-register-core.js +386 -0
  37. package/dist/exec-run-register-mode.js +206 -0
  38. package/dist/exec-run-register-resume.js +393 -0
  39. package/dist/exec-run-register-state.js +322 -0
  40. package/dist/exec-run-register-worktree.js +509 -0
  41. package/dist/exec-run-schedule-mode.js +294 -0
  42. package/dist/exec-run-schedule-prepare.js +353 -0
  43. package/dist/exec-run-schedule-task.js +572 -0
  44. package/dist/exec-run-shared.js +399 -0
  45. package/dist/exec-run.js +11 -6182
  46. package/dist/exec-shared.js +2 -2
  47. package/dist/exec-trial-commands.js +558 -0
  48. package/dist/exec-trial-core.js +371 -0
  49. package/dist/exec-trial.js +2 -921
  50. package/dist/exec-worktree-ops-commit.js +707 -0
  51. package/dist/exec-worktree-ops-lifecycle.js +292 -0
  52. package/dist/exec-worktree-ops-merge.js +303 -0
  53. package/dist/exec-worktree-ops.js +3 -1292
  54. package/dist/exec-worktree.js +32 -4
  55. package/dist/exec.js +2 -1006
  56. package/dist/frontmatter-namespace.js +2 -2
  57. package/dist/grade-apply.js +734 -0
  58. package/dist/grade-command-apply.js +250 -0
  59. package/dist/grade-command-inspect.js +138 -0
  60. package/dist/grade-command-plan.js +101 -0
  61. package/dist/grade-command-shared.js +68 -0
  62. package/dist/grade-core.js +307 -0
  63. package/dist/grade-markdown.js +274 -0
  64. package/dist/grade-pipeline-state.js +184 -0
  65. package/dist/grade-plan.js +507 -0
  66. package/dist/grade-result.js +5 -5
  67. package/dist/grade-target-discovery.js +265 -0
  68. package/dist/grade-targets.js +432 -0
  69. package/dist/grade.js +14 -3188
  70. package/dist/init-command.js +7 -7
  71. package/dist/job-definition.js +670 -0
  72. package/dist/job.js +9 -673
  73. package/dist/kata-command.js +2 -2
  74. package/dist/register-command-types.js +1 -0
  75. package/dist/register-core.js +363 -0
  76. package/dist/register-create-commands.js +245 -0
  77. package/dist/register-events.js +4 -4
  78. package/dist/register-item.js +6 -6
  79. package/dist/register-maintenance-commands.js +187 -0
  80. package/dist/register-migration.js +268 -0
  81. package/dist/register-renumber.js +314 -0
  82. package/dist/register-transition-commands.js +248 -0
  83. package/dist/register-update.js +230 -0
  84. package/dist/register-views.js +256 -0
  85. package/dist/register.js +61 -2069
  86. package/dist/review-plan.js +3 -3
  87. package/dist/routine-definition.js +401 -0
  88. package/dist/routine.js +6 -402
  89. package/dist/schedule-approach.js +2 -2
  90. package/dist/schedule-strategy-generate-document.js +273 -0
  91. package/dist/schedule-strategy-generate-scope.js +199 -0
  92. package/dist/schedule-strategy-generate.js +9 -473
  93. package/dist/schedule.js +4 -4
  94. package/dist/specdojo-config.js +3 -4
  95. package/dist/viewpoint-document-kinds-check.js +3 -3
  96. package/dist/yaml-pages.js +4 -4
  97. package/dist/yaml.js +28 -0
  98. package/docs/ja/specdojo/guides/exec-config-guide.md +6 -6
  99. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +20 -18
  100. package/docs/ja/specdojo/guides/routine-operation-guide.md +1 -1
  101. package/package.json +4 -5
  102. package/templates/antigravity/README.md +3 -3
  103. package/templates/antigravity/exec-defaults-snippet.yaml +6 -4
  104. package/templates/init-exec-defaults.yaml +3 -1
@@ -261,9 +261,9 @@ providers:
261
261
  command_params:
262
262
  by_proficiency:
263
263
  normal: { model: gemini-3.8-flash-medium }
264
- expert: { model: gemini-3.1-pro-high }
264
+ expert: { model: gemini-3.8-flash-high }
265
265
  by_nickname:
266
- agy-claude-expert-executor: { model: claude-opus-4-6-thinking }
266
+ agy-claude-expert-executor: { model: claude-opus-5-5-high }
267
267
  ```
268
268
 
269
269
  `by_nickname` は、同じ provider の一部 member だけモデルなどを差し替える用途です。層をまたぐ同名変数は意図的な上書きとして許可されます。一方、`nickname`、`mode`、`proficiency` は組み込み変数なので、どの `command_params` 層でも再定義できません。
@@ -537,11 +537,11 @@ providers:
537
537
  command_params:
538
538
  by_proficiency:
539
539
  normal: { model: gemini-3.8-flash-medium }
540
- expert: { model: gemini-3.1-pro-high }
540
+ expert: { model: gemini-3.8-flash-high }
541
541
  by_nickname:
542
- agy-claude-executor: { model: claude-sonnet-4-6 }
543
- agy-claude-expert-executor: { model: claude-opus-4-6-thinking }
544
- agy-claude-expert-review-executor: { model: claude-opus-4-6-thinking }
542
+ agy-claude-executor: { model: claude-sonnet-5-5-medium }
543
+ agy-claude-expert-executor: { model: claude-opus-5-5-high }
544
+ agy-claude-expert-review-executor: { model: claude-opus-5-5-high }
545
545
  agy-gpt-executor: { model: gpt-oss-120b-medium }
546
546
  ```
547
547
 
@@ -42,27 +42,29 @@ CLI を直接操作する場合の代表フローは [遂行の技活用ガイ
42
42
 
43
43
  `package.json` に、対話起動用の npm スクリプトを `orch:` 接頭辞で用意しています。Claude Code / Codex はモデル別に用意し、`:work` 付きは固定 worktree で起動します。
44
44
 
45
- | スクリプト | CLI・モデル | worktree |
46
- | ------------------- | ----------------------------------- | ----------------------------------------------- |
47
- | `orch:sonnet` | Claude Code / `sonnet` | なし |
48
- | `orch:sonnet:work` | Claude Code / `sonnet` | `../worktrees/claude-work`(無ければ自動作成) |
49
- | `orch:opus` | Claude Code / `opus` | なし |
50
- | `orch:opus:work` | Claude Code / `opus` | `../worktrees/claude-work`(無ければ自動作成) |
51
- | `orch:terra` | Codex / `gpt-5.6-terra` | なし |
52
- | `orch:terra:work` | Codex / `gpt-5.6-terra` | `../worktrees/codex-work`(無ければ自動作成) |
53
- | `orch:sol` | Codex / `gpt-5.6-sol` | なし |
54
- | `orch:sol:work` | Codex / `gpt-5.6-sol` | `../worktrees/codex-work`(無ければ自動作成) |
55
- | `orch:copilot` | GitHub Copilot | なし |
56
- | `orch:copilot:work` | GitHub Copilot | `../worktrees/copilot-work`(無ければ自動作成) |
57
- | `orch:qwen` | OpenCode / Qwen 3.8 | なし |
58
- | `orch:qwen:work` | OpenCode / Qwen 3.8 | `../worktrees/qwen-work`(無ければ自動作成) |
59
- | `orch:gemma` | OpenCode / Gemma 4 | なし |
60
- | `orch:gemma:work` | OpenCode / Gemma 4 | `../worktrees/gemma-work`(無ければ自動作成) |
61
- | `orch:agy` | Antigravity / `gemini-3.1-pro-high` | なし |
62
- | `orch:agy:work` | Antigravity / `gemini-3.1-pro-high` | `../worktrees/agy-work`(無ければ自動作成) |
45
+ | スクリプト | CLI・モデル | worktree |
46
+ | ------------------- | ------------------------------------- | ----------------------------------------------- |
47
+ | `orch:sonnet` | Claude Code / `sonnet` | なし |
48
+ | `orch:sonnet:work` | Claude Code / `sonnet` | `../worktrees/claude-work`(無ければ自動作成) |
49
+ | `orch:opus` | Claude Code / `opus` | なし |
50
+ | `orch:opus:work` | Claude Code / `opus` | `../worktrees/claude-work`(無ければ自動作成) |
51
+ | `orch:terra` | Codex / `gpt-5.6-terra` | なし |
52
+ | `orch:terra:work` | Codex / `gpt-5.6-terra` | `../worktrees/codex-work`(無ければ自動作成) |
53
+ | `orch:sol` | Codex / `gpt-5.6-sol` | なし |
54
+ | `orch:sol:work` | Codex / `gpt-5.6-sol` | `../worktrees/codex-work`(無ければ自動作成) |
55
+ | `orch:copilot` | GitHub Copilot | なし |
56
+ | `orch:copilot:work` | GitHub Copilot | `../worktrees/copilot-work`(無ければ自動作成) |
57
+ | `orch:qwen` | OpenCode / Qwen 3.8 | なし |
58
+ | `orch:qwen:work` | OpenCode / Qwen 3.8 | `../worktrees/qwen-work`(無ければ自動作成) |
59
+ | `orch:gemma` | OpenCode / Gemma 4 | なし |
60
+ | `orch:gemma:work` | OpenCode / Gemma 4 | `../worktrees/gemma-work`(無ければ自動作成) |
61
+ | `orch:agy` | Antigravity / `gemini-3.8-flash-high` | なし |
62
+ | `orch:agy:work` | Antigravity / `gemini-3.8-flash-high` | `../worktrees/agy-work`(無ければ自動作成) |
63
63
 
64
64
  Antigravity CLI(`agy`)はファイル定義の agent を持たないため、Codex と同じく SSOT `.agents/specdojo-orchestrator.agent.md` の本文を `-i`(初期プロンプトを与えて対話を続ける)で渡します。ラッパーは不要で、`.agents/rules/*.md` の薄いラッパー経由で `.github/instructions/` の規則も読み込まれます。
65
65
 
66
+ Antigravity で使えるモデル ID は `agy models` で確認してください。配布時点の既定値は、agy 1.3.5 で提供される `gemini-3.8-flash-high` です。
67
+
66
68
  用途に応じて使い分けます。
67
69
 
68
70
  ```bash
@@ -164,7 +164,7 @@ Kata と成果物の定期評価は、SpecDojo 本体リポジトリ内で execu
164
164
 
165
165
  成果物は `rtn-grade-deliverable-recheck` が `job-grade-deliverable` を起動します。Job は同じ script を `--stages 1 --target deliverable` で実行し、成果物カタログから変更済み・未評価・段未完了・旧 rubric の Markdown 成果物だけを最大10件選びます。評価結果は成果物の最新 grade と成果物ごとの `done_criteria` 詳細へ上書きされるため、実行ごとの review result は増やしません。
166
166
 
167
- `rtn-grade-deliverable-recheck` は毎日1時、`rtn-grade-recheck` は毎日6時に実行し、いずれも `missed_run: skip` とします。`rtn-dashboard-refresh` は `action.kind: specdojo` で毎時 `dashboard build` を直接起動します(exec の実行ロックを取らないため、grade や register の実行中でも並行して動きます)。devcontainer の cron は毎時 `routine run --due` を呼びますが、各 routine の発火時刻は routine 側の cron で決まります。コンテナ停止中の実行枠を日中へ持ち越さず、対話的な register 実行との競合を避けます。
167
+ `rtn-grade-deliverable-recheck` は毎日1時、`rtn-grade-recheck` は毎日5時に実行し、いずれも `missed_run: skip` とします。`rtn-dashboard-refresh` は `action.kind: specdojo` で毎時 `dashboard build` を直接起動します(exec の実行ロックを取らないため、grade や register の実行中でも並行して動きます)。devcontainer の cron は毎時 `routine run --due` を呼びますが、各 routine の発火時刻は routine 側の cron で決まります。コンテナ停止中の実行枠を日中へ持ち越さず、対話的な register 実行との競合を避けます。
168
168
 
169
169
  `changed_only: true` は、本文の変更に加えて、観点定義の `comparison_sources` で宣言した突き合わせ先(成果物カタログの自身の項目、依存先、Schedule、メンバー定義、ロール定義、RACI、組織定義)の変更も検出します。検出範囲と検出しない変更は `command-reference.md` の `grade` の説明に従います。突き合わせ先の記録(`source_hashes`)を持たない既存の評価は一度だけ変更扱いになるため、導入直後は `rtn-grade-deliverable-recheck` の選択が上限の10件に張り付きます。2026-09-27 時点の成果物 46 件がすべて該当し、約5日で記録が揃います。その後は突き合わせ先を変更した日だけ、その突き合わせ先を持つ成果物が選ばれます。現在の宣言では Kata に適用される観点は突き合わせ先を持たないため、`rtn-grade-recheck` の選択は変わりません。
170
170
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "specdojo",
3
- "version": "0.3.0",
3
+ "version": "0.3.1",
4
4
  "description": "A dojo for Spec-Dō, the way of specification: decide with a register, write specs and designs with kata, and keep sharpening them with AI.",
5
5
  "license": "MIT",
6
6
  "author": "naoji3x",
@@ -69,8 +69,8 @@
69
69
  "orch:sol:work": "tools/worktree/open-agent-worktree.sh codex-work codex -m gpt-5.6-sol \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
70
70
  "orch:copilot": "copilot --agent specdojo-orchestrator",
71
71
  "orch:copilot:work": "tools/worktree/open-agent-worktree.sh copilot-work copilot --agent specdojo-orchestrator",
72
- "orch:agy": "agy --add-dir \"$(pwd)\" --model gemini-3.1-pro-high -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
73
- "orch:agy:work": "tools/worktree/open-agent-worktree.sh agy-work agy --add-dir \"$(pwd)\" --model gemini-3.1-pro-high -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
72
+ "orch:agy": "agy --add-dir \"$(pwd)\" --model gemini-3.8-flash-high -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
73
+ "orch:agy:work": "tools/worktree/open-agent-worktree.sh agy-work agy --add-dir \"$(pwd)\" --model gemini-3.8-flash-high -i \"$(cat .agents/specdojo-orchestrator.agent.md)\"",
74
74
  "orch:qwen": "opencode --agent qwen-orchestrator",
75
75
  "orch:qwen:work": "tools/worktree/open-agent-worktree.sh qwen-work opencode --agent qwen-orchestrator",
76
76
  "orch:gemma": "opencode --agent gemma-orchestrator",
@@ -120,7 +120,7 @@
120
120
  "ajv": "^8.20.0",
121
121
  "commander": "^15.0.0",
122
122
  "dotenv": "^18.0.4",
123
- "js-yaml": "^4.3.2",
123
+ "js-yaml": "^5.4.3",
124
124
  "prettier": "^3.8.4",
125
125
  "remark-parse": "^11.0.0",
126
126
  "unified": "^11.0.5"
@@ -128,7 +128,6 @@
128
128
  "devDependencies": {
129
129
  "@commitlint/cli": "^21.0.2",
130
130
  "@commitlint/config-conventional": "^21.0.2",
131
- "@types/js-yaml": "^4.0.9",
132
131
  "@types/node": "^25.9.2",
133
132
  "@typescript-eslint/eslint-plugin": "^8.61.0",
134
133
  "@typescript-eslint/parser": "^8.61.0",
@@ -40,7 +40,7 @@ npx specdojo config scaffold --provider antigravity --global
40
40
  Antigravity CLI(`agy`)はファイル定義の agent を持たないため、`--agent <name>` では起動できません。規範の本文を `-i` で渡します。
41
41
 
42
42
  ```sh
43
- agy --add-dir "$(pwd)" --model gemini-3.1-pro-high -i "$(cat .specdojo/antigravity/orchestrator.md)"
43
+ agy --add-dir "$(pwd)" --model gemini-3.8-flash-high -i "$(cat .specdojo/antigravity/orchestrator.md)"
44
44
  ```
45
45
 
46
46
  `--add-dir "$(pwd)"` を付けないと、作業ディレクトリのファイルを読み書きできず、`AGENTS.md` と `.agents/rules/*.md` も読み込まれません。
@@ -50,11 +50,11 @@ agy --add-dir "$(pwd)" --model gemini-3.1-pro-high -i "$(cat .specdojo/antigravi
50
50
  ```json
51
51
  {
52
52
  "scripts": {
53
- "orch:agy": "agy --add-dir \"$(pwd)\" --model gemini-3.1-pro-high -i \"$(cat .specdojo/antigravity/orchestrator.md)\""
53
+ "orch:agy": "agy --add-dir \"$(pwd)\" --model gemini-3.8-flash-high -i \"$(cat .specdojo/antigravity/orchestrator.md)\""
54
54
  }
55
55
  }
56
56
  ```
57
57
 
58
58
  ## executor / reporter として使う
59
59
 
60
- `exec-defaults-snippet.yaml` を `.specdojo/exec-defaults.yaml` の `providers` へ、`agent-members-snippet.yaml` の member 定義をリポジトリ共通の `.specdojo/agent-members.yaml` の `members` へ写します。agent は project ごとの `pm-members.yaml` へ書きません。モデル ID は推論強度を含むため、`--effort` を併用すると起動に失敗します。headless 実行に必要な command は上記のグローバル permission で許可し、`--dangerously-skip-permissions` は使いません。
60
+ `exec-defaults-snippet.yaml` を `.specdojo/exec-defaults.yaml` の `providers` へ、`agent-members-snippet.yaml` の member 定義をリポジトリ共通の `.specdojo/agent-members.yaml` の `members` へ写します。agent は project ごとの `pm-members.yaml` へ書きません。使えるモデル ID は `agy models` で確認します。モデル ID は推論強度を含むため、`--effort` を併用すると起動に失敗します。headless 実行に必要な command は上記のグローバル permission で許可し、`--dangerously-skip-permissions` は使いません。
@@ -17,17 +17,19 @@ providers:
17
17
  # agy のモデル ID は推論強度を含む(gemini-3.8-flash-{high,medium,low} など)。--effort を
18
18
  # 併用すると ID と食い違ったときに "invalid model selection" で起動に失敗するため、
19
19
  # 強度はモデル ID だけで指定する(2026-09-21 実測: flash-high + --effort medium で失敗)。
20
+ # 使える model の ID は `agy models` で確かめる。Gemini の Pro 系は提供されなくなったため、
21
+ # expert は Flash の high とする(2026-10-15、agy 1.3.5 で確認)。
20
22
  command_template: 'agy --sandbox --add-dir "$(pwd)" --model {model} -p "$(cat)"'
21
23
  command_params:
22
24
  by_proficiency:
23
25
  normal: { model: gemini-3.8-flash-medium }
24
- expert: { model: gemini-3.1-pro-high }
26
+ expert: { model: gemini-3.8-flash-high }
25
27
  # Gemini 以外の Antigravity 提供モデルは member nickname で明示的に選ぶ。
26
28
  # by_nickname は proficiency / mode の既定値より優先される。
27
29
  by_nickname:
28
- agy-claude-executor: { model: claude-sonnet-4-6 }
29
- agy-claude-expert-executor: { model: claude-opus-4-6-thinking }
30
- agy-claude-expert-review-executor: { model: claude-opus-4-6-thinking }
30
+ agy-claude-executor: { model: claude-sonnet-5-5-medium }
31
+ agy-claude-expert-executor: { model: claude-opus-5-5-high }
32
+ agy-claude-expert-review-executor: { model: claude-opus-5-5-high }
31
33
  agy-gpt-executor: { model: gpt-oss-120b-medium }
32
34
  # Gemini API の制限文言は未観測。429 / quota / RESOURCE_EXHAUSTED を初期値とし、
33
35
  # 実観測した文言で更新する(observed-agent-limit-stderr と同じ扱い)。
@@ -51,11 +51,13 @@ providers:
51
51
  exit_codes: []
52
52
  stderr_patterns: [timeout, connection refused, out of memory, model is loading]
53
53
  antigravity:
54
+ # 使える model の ID は `agy models` で確かめる。Gemini の Pro 系は提供されなくなったため、
55
+ # expert は Flash の high とする(2026-10-15、agy 1.3.5 で確認)。
54
56
  command_template: 'agy --sandbox --add-dir "$(pwd)" --model {model} -p "$(cat)"'
55
57
  command_params:
56
58
  by_proficiency:
57
59
  normal: { model: gemini-3.8-flash-medium }
58
- expert: { model: gemini-3.1-pro-high }
60
+ expert: { model: gemini-3.8-flash-high }
59
61
  rate_limit_detection:
60
62
  stderr_patterns: [rate limit, "429", quota, RESOURCE_EXHAUSTED]
61
63
  copilot: