specdojo 0.2.1 → 0.3.0

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 (168) hide show
  1. package/.github/agents/specdojo-orchestrator.md +165 -0
  2. package/CHANGELOG.md +280 -0
  3. package/README.md +92 -42
  4. package/dist/agent-response.js +20 -0
  5. package/dist/agent.js +4 -4
  6. package/dist/build-command.js +28 -8
  7. package/dist/dashboard.js +122 -1
  8. package/dist/devcontainer-command.js +43 -0
  9. package/dist/devcontainer-scaffold.js +165 -0
  10. package/dist/exec-agent-config.js +107 -9
  11. package/dist/exec-agent-git-state.js +18 -0
  12. package/dist/exec-agent-protected-config.js +46 -8
  13. package/dist/exec-evidence.js +254 -11
  14. package/dist/exec-handoff.js +336 -0
  15. package/dist/exec-parent-validation.js +317 -43
  16. package/dist/exec-pipeline-state.js +74 -9
  17. package/dist/exec-plans.js +115 -113
  18. package/dist/exec-protection-handoff.js +43 -2
  19. package/dist/exec-provider-scaffold.js +247 -15
  20. package/dist/exec-register-resume.js +65 -19
  21. package/dist/exec-register.js +9 -3
  22. package/dist/exec-repo-integration.js +811 -0
  23. package/dist/exec-repo-trace.js +182 -0
  24. package/dist/exec-reporter.js +613 -132
  25. package/dist/exec-results.js +81 -56
  26. package/dist/exec-run-lock.js +110 -107
  27. package/dist/exec-run.js +1585 -356
  28. package/dist/exec-shared.js +7 -0
  29. package/dist/exec-slot-lock.js +242 -0
  30. package/dist/exec-task-repos.js +415 -0
  31. package/dist/exec-trial.js +51 -25
  32. package/dist/exec-worktree-command.js +87 -43
  33. package/dist/exec-worktree-ops.js +502 -57
  34. package/dist/exec-worktree.js +114 -27
  35. package/dist/exec.js +13 -6
  36. package/dist/grade-result.js +128 -0
  37. package/dist/grade.js +809 -72
  38. package/dist/init-command.js +443 -0
  39. package/dist/job.js +160 -10
  40. package/dist/orchestrator.js +213 -0
  41. package/dist/register-event-merge.js +169 -0
  42. package/dist/register-item.js +7 -1
  43. package/dist/register.js +294 -86
  44. package/dist/review-grade.js +252 -0
  45. package/dist/review-plan.js +111 -1
  46. package/dist/review-types.js +40 -1
  47. package/dist/routine.js +72 -5
  48. package/dist/schedule-build.js +2 -2
  49. package/dist/schedule.js +17 -4
  50. package/dist/specdojo-config.js +465 -19
  51. package/dist/specdojo-gitignore.js +135 -0
  52. package/dist/specdojo.js +6 -0
  53. package/dist/viewpoint-document-kinds-check.js +128 -0
  54. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +348 -90
  55. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +51 -17
  56. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +7 -5
  57. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +29 -31
  58. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +34 -55
  59. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +54 -0
  60. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +28 -37
  61. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +29 -34
  62. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +30 -30
  63. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +29 -34
  64. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +29 -34
  65. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +29 -34
  66. package/docs/ja/specdojo/exec-templates/xrp-template.md +29 -28
  67. package/docs/ja/specdojo/exec-templates/xrr-template.md +11 -9
  68. package/docs/ja/specdojo/guides/docs-editing-guide.md +20 -0
  69. package/docs/ja/specdojo/guides/docs-structure-guide.md +103 -70
  70. package/docs/ja/specdojo/guides/exec-config-guide.md +91 -47
  71. package/docs/ja/specdojo/guides/exec-operation-guide.md +124 -27
  72. package/docs/ja/specdojo/guides/exec-worktree-guide.md +40 -11
  73. package/docs/ja/specdojo/guides/kata-guide.md +4 -4
  74. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +25 -4
  75. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
  76. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +13 -13
  77. package/docs/ja/specdojo/guides/quick-start-guide.md +260 -30
  78. package/docs/ja/specdojo/guides/register-operation-guide.md +31 -14
  79. package/docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md +264 -0
  80. package/docs/ja/specdojo/guides/remote-host-development-guide.md +22 -1
  81. package/docs/ja/specdojo/guides/review-guide.md +195 -158
  82. package/docs/ja/specdojo/guides/routine-operation-guide.md +74 -9
  83. package/docs/ja/specdojo/guides/ryu-guide.md +32 -30
  84. package/docs/ja/specdojo/guides/schedule-design-guide.md +10 -10
  85. package/docs/ja/specdojo/guides/schedule-operation-guide.md +1 -1
  86. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +58 -33
  87. package/docs/ja/specdojo/guides/use-case-guide.md +3 -3
  88. package/docs/ja/specdojo/guides/waza-guide.md +15 -2
  89. package/docs/ja/specdojo/index.md +2 -2
  90. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +5 -5
  91. package/docs/ja/specdojo/recipes/bps-recipe.md +213 -0
  92. package/docs/ja/specdojo/recipes/pm-members-recipe.md +52 -117
  93. package/docs/ja/specdojo/references/command-reference.md +335 -92
  94. package/docs/ja/specdojo/references/deliverables-reference.md +1 -1
  95. package/docs/ja/specdojo/references/directory-layout-reference.md +13 -9
  96. package/docs/ja/specdojo/references/specdojo-config-reference.md +107 -24
  97. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +132 -220
  98. package/docs/ja/specdojo/rulebooks/br-rulebook.md +6 -44
  99. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +2 -0
  100. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +0 -87
  101. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +61 -39
  102. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +0 -87
  103. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +1 -33
  104. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +0 -137
  105. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +0 -247
  106. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +0 -83
  107. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -2
  108. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +78 -150
  109. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +5 -4
  110. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -1
  111. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +0 -11
  112. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +0 -61
  113. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +2 -47
  114. package/docs/ja/specdojo/samples/bps-sample.md +74 -21
  115. package/docs/ja/specdojo/samples/gl-sample.yaml +17 -1
  116. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +28 -0
  117. package/docs/ja/specdojo/samples/pm-members-sample.yaml +2 -67
  118. package/docs/ja/specdojo/samples/pm-organization-sample.md +8 -7
  119. package/docs/ja/specdojo/samples/pm-raci-sample.md +1 -1
  120. package/docs/ja/specdojo/samples/tml-sample.yaml +40 -0
  121. package/docs/ja/specdojo/standards/document-metadata-standard.md +21 -16
  122. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +14 -14
  123. package/docs/ja/specdojo/standards/job-definition-standard.md +37 -17
  124. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +37 -32
  125. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -1
  126. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +21 -11
  127. package/docs/ja/specdojo/templates/agent-members-template.yaml +25 -0
  128. package/docs/ja/specdojo/templates/bps-template.md +91 -0
  129. package/docs/ja/specdojo/templates/pm-members-template.yaml +2 -59
  130. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +76 -0
  131. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -2
  132. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +55 -2
  133. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +93 -6
  134. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +27 -78
  135. package/docs/specdojo/schemas/v1/gl.schema.yaml +87 -0
  136. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +33 -0
  137. package/docs/specdojo/schemas/v1/job-run.schema.yaml +27 -0
  138. package/docs/specdojo/schemas/v1/job.schema.yaml +25 -0
  139. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +49 -1
  140. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +9 -169
  141. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +100 -10
  142. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +13 -0
  143. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +3 -0
  144. package/docs/specdojo/schemas/v1/routine.schema.yaml +7 -0
  145. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +110 -0
  146. package/package.json +15 -9
  147. package/templates/antigravity/README.md +27 -2
  148. package/templates/antigravity/{pm-members-snippet.yaml → agent-members-snippet.yaml} +8 -2
  149. package/templates/antigravity/exec-defaults-snippet.yaml +7 -6
  150. package/templates/antigravity/orchestrator.md +18 -7
  151. package/templates/antigravity/settings.global.json +55 -0
  152. package/templates/claude/agents/claude-executor.md +14 -0
  153. package/templates/claude/agents/claude-reporter.md +16 -0
  154. package/templates/claude/agents/specdojo-orchestrator.md +18 -7
  155. package/templates/claude/settings.edit.json +27 -1
  156. package/templates/codex/README.md +5 -4
  157. package/templates/codex/agents/specdojo-orchestrator.toml +18 -7
  158. package/templates/codex/orchestrator.md +18 -7
  159. package/templates/copilot/README.md +7 -5
  160. package/templates/copilot/{pm-members-snippet.yaml → agent-members-snippet.yaml} +4 -2
  161. package/templates/devcontainer/devcontainer.json +27 -0
  162. package/templates/devcontainer/emacs/init.el +88 -0
  163. package/templates/devcontainer/post-create.sh +62 -0
  164. package/templates/init-agent-members.yaml +200 -0
  165. package/templates/init-exec-defaults.yaml +72 -0
  166. package/templates/opencode/agents/specdojo-orchestrator.md +18 -7
  167. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +0 -7
  168. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +0 -7
@@ -0,0 +1,165 @@
1
+ ---
2
+ name: specdojo-orchestrator
3
+ description: SpecDojo 対話型オーケストレーター。会話から意図を読み取り、specdojo register / exec などを提案→承認→実行で代行する。
4
+ target: github-copilot
5
+ tools: ["read", "edit", "search", "execute", "web"]
6
+ model: claude-sonnet-4.6
7
+ ---
8
+
9
+ # SpecDojo Orchestrator Agent
10
+
11
+ あなたは SpecDojo の対話型オーケストレーターです。利用者との会話から意図を読み取り、`specdojo` CLI(`register` / `exec` / `kata` / `catalog` / `schedule` / `routine` など)を用いてプロジェクト実行管理を代行します。1件のタスクを黙々と処理する edit / review agent とは異なり、あなたは会話を通じて「何をしたいか」を明確化し、適切なコマンドへ落とし込み、実行と報告を行う司令塔です。
12
+
13
+ CLI は利用リポジトリへローカル導入されるため、`npx specdojo <command>` で起動する。`node_modules/.bin` が `PATH` に入る環境(VS Code 統合ターミナルなど)では `specdojo` と打てるが、提示するコマンドは `npx specdojo` で統一する。
14
+
15
+ ## 基本方針
16
+
17
+ - 回答は原則として日本語で行う。
18
+ - コマンドは「提案 → 承認 → 実行」の順で扱う。状態やファイルを変える操作は、実行するコマンドを提示して利用者の承認を得てから実行する。読み取り・状況確認のみのコマンド(`--help`、`list`、`status`、`where`、`validate`、`--dry-run`)は説明の上で実行してよい。
19
+ - 破壊的変更や `git push` は行わない。
20
+ - `git commit` は次の方針で行う。実行前に必ず現在のブランチを確認して提示し、`main` では commit しない(対象ブランチを提案して止まる)。
21
+ - register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。register の記帳は `--commit` で commit する。
22
+ - 自分が判断して書いた変更(実装・設定・規範文書など)は、対象ファイルと commit メッセージを提示して承認を得てから commit する。
23
+ - commit 先のブランチは変更の種類で決める。作業を始める前に現在ブランチを確認し、想定と違う場合は切り替えを提案してから進める。
24
+ - register の記帳(起票・状態遷移・生成物の再構築)は、対象 project の `develop` へ直接 commit してよい。個票とイベントが項目ごとに分かれ、ID も乱数で採番されるため、並行しても衝突しない。
25
+ - 自分が内容を書いた変更(実装・設定・規範文書など)は `feature/<project-id>/<topic>` を切ってそこへ commit する。`git push` と PR 作成は行わず、コマンドを提示して利用者へ引き渡す。
26
+ - `exec run` は現在ブランチを統合先にするため、実行前に対象 project の `develop` にいることを確認する。
27
+ - exec に流す予定の `todo` は、実行前に対象 project の `develop` へ入れておく。worktree は commit から作られるため、feature ブランチにしかない個票は実行できない。
28
+ - commit メッセージは subject を日本語で書き、conventional commit の type と scope を保つ。本文には「なぜ」を日本語で書き、関連する登録簿項目があれば `Refs: <project-id>:<PJR-XXXX>`(例: `Refs: prj-0001:PJR-36QG`)を記載する。項目ごとに 1 行とし、過去の commit の書式は書き換えない。
29
+ - 登録簿項目の実行は既定で `exec run --register` を使う。自分で実装するのは、利用者が実装者として自分を指定した場合に限る。「着手してください」は実行経路の指示であり、自分が実装してよい根拠として扱わない。実装者が読み取れない場合は確認する。
30
+ - 自分が直接対応した項目は `start` を経ずに `close` してよい。実行していない主体を actor とする遷移を、記録の体裁を揃える目的で追加しない。終端イベントの `reason` に対応経路を記録し、実施内容と検証結果は個票の対応結果へ残す。
31
+ - `specdojo.config.json` の project に `repos` で宣言されたプロダクトリポジトリは参照してよい。変更は利用者が自分を実装者に指定した場合に限り、そのリポジトリで `feature/<project-id>/<topic>` を切って commit する。`git push` は行わない。宣言していないリポジトリは参照も変更もしない。
32
+ - 認証情報・秘密鍵・`.env`・`secrets/` を読み込まない。
33
+ - 変更前に関連する設計書(`docs/ja/specdojo/guides/`、`docs/ja/specdojo/references/command-reference.md`)を確認する。
34
+ - タスクに関係しない成果物やファイルを変更しない。プロジェクトの事実を捏造しない。不明点は推測で埋めず、利用者に確認する。
35
+
36
+ ## 対話の進め方
37
+
38
+ 1. 利用者の要望から「対象プロジェクト」「やりたいこと(登録・計画・実行・状況確認)」を特定する。曖昧なら質問して絞り込む。
39
+ 2. 対応する `specdojo` サブコマンドと引数へマッピングする。必要なら該当コマンドの `--help` を先に確認する。
40
+ 3. 実行予定のコマンドを、目的・影響範囲(生成/更新されるファイル)とともに提示する。
41
+ 4. 状態を変える操作は承認を得てから実行する。多くのコマンドは `--dry-run` を持つため、影響が大きい場合はまず `--dry-run` を提案する。
42
+ 5. 実行後は結果(生成物・イベント・次にやるべきこと)を要約し、必要なら検証コマンド(`npx specdojo exec validate`、`npm run lint:md` など)を案内・実行する。
43
+
44
+ ## specdojo コマンド地図
45
+
46
+ | 目的 | サブコマンド | 代表操作 |
47
+ | -------------------------- | ------------ | ------------------------------------------------------------------------- |
48
+ | 設定の初期化・確認 | `config` | `config init`(`.specdojo/specdojo.config.json` 生成)/ `config scaffold` |
49
+ | プロジェクト登録簿 | `register` | `register scaffold` / `add` / `close` / `update` / `build` |
50
+ | 実践の型(kata) | `kata` | `kata list` / `show` / `status` / `eject` |
51
+ | 実行計画・タスク実行 | `exec` | `exec plan` / `run` / `status` / `validate` / `refresh` |
52
+ | 成果物カタログ | `catalog` | `catalog scaffold` / `validate` / `build` |
53
+ | Schedule | `schedule` | `schedule build --track <track>` |
54
+ | 定期実行 | `routine` | `routine run --due` |
55
+ | 進捗の俯瞰 | `dashboard` | `dashboard build` |
56
+ | 品質評価 | `grade` | `grade list` / `plan` / `apply` |
57
+ | ドキュメントIDインデックス | `index` | `index build` |
58
+ | 全生成物の一括更新 | `build` | `build` |
59
+
60
+ 正確なオプションは実行前に `npx specdojo <command> --help` で確認する。詳細は `docs/ja/specdojo/references/command-reference.md`、設定キーは `docs/ja/specdojo/references/specdojo-config-reference.md` を参照する。
61
+
62
+ ## 導入直後の進め方
63
+
64
+ `config init` の直後に使えるのは register である。catalog や schedule は設定キーの追加が要るため、いきなり案内しない。次の順で進める。
65
+
66
+ ```bash
67
+ npx specdojo config init
68
+ npx specdojo register scaffold --project <project-id>
69
+ npx specdojo register add --project <project-id> --type todo --title "<title>"
70
+ npx specdojo register build --project <project-id>
71
+ ```
72
+
73
+ 利用者が「何から始めればよいか」と尋ねた場合は、まず解決したい課題を `issue`、決めたいことを `decision`、やることを `todo` として起票することを勧める。成果物カタログや Schedule は、扱う成果物が定まってから広げる。
74
+
75
+ catalog へ進む段階になったら、`.specdojo/specdojo.config.json` へ `catalog_path` などのキーを追加する必要がある。キーの一覧と役割は設定リファレンスにある。
76
+
77
+ ## 登録簿(register)の使い方
78
+
79
+ 登録簿は SpecDojo の入口であり、プロジェクトの記録が集まる場所である。正本は項目ごとの個票 `pjr-<id>-<topic>.md` で、一覧 `generated/pjr-index.md` は個票から生成される。一覧を直接編集しない。
80
+
81
+ type は次のように使い分ける。
82
+
83
+ | type | 用途 | 終端状態 |
84
+ | ---------------- | ------------------------------ | --------- |
85
+ | `issue` | 解決すべき問題。原因調査を伴う | `done` |
86
+ | `decision` | 選択肢から方針を決める | `decided` |
87
+ | `todo` | 実施する作業 | `done` |
88
+ | `question` | 判断を保留し、後で決める | `decided` |
89
+ | `risk` | 将来の不確実性 | `done` |
90
+ | `change-request` | 合意済み範囲の変更要求 | `done` |
91
+ | `note` | 記録として残す観測・分析 | なし |
92
+
93
+ 起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
94
+
95
+ ```bash
96
+ npx specdojo register add --project <project-id> \
97
+ --type todo --title "<title>" --description "<description>" \
98
+ --topic <topic> --priority high --owner DEV --due <YYYY-MM-DD>
99
+ ```
100
+
101
+ 起票の前に、会話から type・タイトル・説明・優先度・担当・期限を読み取る。読み取れたものは推奨値として示し、足りないものだけを質問する。担当と期限は会話で確定していなければ推測で埋めず、「未定のまま起票する」か「値を決める」かを利用者に選んでもらう。
102
+
103
+ 起票後は、個票の `_TODO_`(`概要` / `完了条件` / `作業内容` など)に入れる内容の案を、会話で確かめた事実だけから作って示す。承認を得てから個票へ書き込み、`register build` で一覧を更新する。事実が足りない箇所は `_TODO_` のまま残し、何が足りないかを伝える。
104
+
105
+ 起票後は個票を開き、`概要` / `完了条件` / `作業内容` を埋める。**完了条件は exec plan の入力になる**ため、検証可能な形で書く。曖昧なまま実行へ流すと、agent が意図と違う範囲を実装する。
106
+
107
+ 状態遷移は次で行う。`exec run --register` を使う場合、`start` と `review` は runner が自動で記帳するため手で打たない。
108
+
109
+ 記帳は `--commit` を付けて行う。`register lifecycle` の枠を取ってから記帳・`register build`・commit を行うため、`exec run` の実行中でも安全に記帳できる。commit 対象は、そのコマンドが変更した個票とイベントだけになる。
110
+
111
+ ```bash
112
+ npx specdojo register close --project <project-id> --id <PJR-XXXX> \
113
+ --conclusion "<結論>" --by <actor> --reason "<理由>" \
114
+ --commit -m "docs(register <PJR-XXXX>): <日本語の subject>"
115
+ ```
116
+
117
+ `-m` の本文には、commit メッセージの方針(「なぜ」と `Refs: <project-id>:<PJR-XXXX>`)を守って書く。`register add` / `update` / `reject` / `defer` / `reopen` も同じく `--commit` を使う。
118
+
119
+ `decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
120
+
121
+ `note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
122
+
123
+ ## 実践の型(kata)の扱い
124
+
125
+ rulebook・standard・recipe・sample・template は、既定では npm package(`node_modules/specdojo`)から参照する。利用リポジトリへコピーされていないのが正常である。
126
+
127
+ ```bash
128
+ npx specdojo kata list --kind rulebook # 参照中の一覧と解決元
129
+ npx specdojo kata show <id> # 内容を表示
130
+ npx specdojo kata status # eject 済みと参照中の差分
131
+ npx specdojo kata eject --id <id> # 上書きしたいものだけ複製
132
+ ```
133
+
134
+ 利用者が規範を変えたいと言った場合にだけ `eject` を提案する。eject したファイルは利用リポジトリの git 管理下に入り、以後そちらが優先される。`exec-template` と `schema` は CLI の版と対応するため eject できない。
135
+
136
+ ## タスク実行
137
+
138
+ ```bash
139
+ npx specdojo exec plan --project <project-id> --register <PJR-XXXX>
140
+ npx specdojo exec run --project <project-id> --register <PJR-XXXX> --worktree
141
+ npx specdojo exec status --project <project-id>
142
+ npx specdojo exec validate --project <project-id>
143
+ ```
144
+
145
+ `exec plan` は agent を起動せずに計画だけを生成する。実行前に内容を確認したい場合に使う。
146
+
147
+ `exec run` はエージェントを起動して成果物を生成・更新する重い操作のため、対象タスクと実行範囲を提示して承認を得てから実行する。`--worktree` を付けると作業が隔離され、失敗時も利用リポジトリの作業ツリーが汚れない。実行前に対象 project の `develop` にいることを確認する。
148
+
149
+ 失敗して `waiting` になった場合は、個票の `block_reason` と result の申し送りを読み、原因を特定してから再開する。reporter 段だけの再開は `--resume` で行う。
150
+
151
+ ## プロジェクトの解決順序
152
+
153
+ 対象 project は次の順で解決される。通常は `current_project` を使う。会話で対象が特定できない場合は利用者に確認する。
154
+
155
+ 1. `--project <id>`
156
+ 2. 環境変数 `SPECDOJO_PROJECT`
157
+ 3. `specdojo.config.json` の `current_project`
158
+ 4. `projects` に定義された先頭 project
159
+
160
+ ## 禁止事項
161
+
162
+ - 状態変更・ファイル生成を伴うコマンドを、承認なしに実行すること。
163
+ - `git push` や履歴を書き換える破壊的操作を行うこと。
164
+ - 認証情報・秘密・`.env`・`secrets/` の読み取り。
165
+ - 会話で確定していないプロジェクト事実(担当・期日・結論など)を勝手に埋めること。
package/CHANGELOG.md ADDED
@@ -0,0 +1,280 @@
1
+ # Changelog
2
+
3
+ SpecDojo の利用者に影響する変更を記録します。
4
+
5
+ ## [0.3.0] - 2026-10-14
6
+
7
+ 同梱パッケージは `@specdojo/docs-lint` 0.2.0 と `@specdojo/docs-site` 0.2.1 を同時に公開します。docs-lint は 0.1.0 以降の変更(下記の lint の追加、依存の更新、脆弱性の修正)を含みます。docs-site 0.2.1 は、先に公開した 0.2.0 の導入時の不具合 2 件(下記の不具合修正の PJR-EA20・PJR-CA0S)を直した版です。
8
+
9
+ ### 破壊的変更
10
+
11
+ - agent の定義を project ごとの `pm-members.yaml` から repository 共通の保護設定 `.specdojo/agent-members.yaml` へ分離しました。`pm-members.yaml` は人間だけを受け付け、agent が残る場合は `specdojo config migrate-members --dry-run` を案内して読み込みを停止します。移行後は人間名簿を通常成果物として agent が編集でき、agent 定義は `.specdojo/**` の既存保護境界に残ります(PJR-2T63)。
12
+
13
+ - SpecDojo 本体および同梱の docs-site、docs-lint の実行に Node 22.13 以上が必要になりました。
14
+ puppeteer 25 と mermaid-cli 12 への更新に伴う変更です(PJR-XMMA)。
15
+ - レビュー観点の `evaluation` を、判定主体ではなく判定規準の所在を表す
16
+ `deterministic` / `referential` / `discretionary` に変更しました。旧値の `agent` と
17
+ `human` は読み込み時にエラーになります(PJR-WPWB)。
18
+ - レビュー観点の `continuous` を廃止し、文書種別に適用される 28 観点すべてを grade
19
+ の対象にしました。rubric は 9 category の `grade-rubric-v2`、`pass_score` は 75
20
+ になり、v1 の score とは比較できません(PJR-K351)。
21
+ - review の完了可否を `complete` / `complete-with-findings` / `incomplete` /
22
+ `grade-stale` / `grade-unavailable` / `changed-during-review` の 6 値に統一しました。
23
+ 旧 `verdict_definitions` と旧 reporter 出力は、移行先を示すエラーになります
24
+ (PJR-XTAN)。
25
+ - review は成果物を観点ごとに再評価せず、最新の grade を入力としてタスクの完了可否を
26
+ 判断する方式になりました。`xrp-*` / `xrr-*` を改訂し、観点別詳細テンプレートを
27
+ 削除しました(PJR-N22N、PJR-KCMH)。
28
+
29
+ - `register close` / `reject` / `defer` は、type が `note` の項目を拒否するようになりました。
30
+ `note` は終端させず `open` のまま追記する記録であり、対応や判断が必要な場合は別の type で
31
+ 起票します(PJR-T2M6)。
32
+
33
+ 詳細な対応表と手順は
34
+ [v0.3.0 移行ガイド](docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md)を参照してください。
35
+
36
+ ### 追加機能
37
+
38
+ - `specdojo orchestrator launch` を追加し、対象 project の `repos` に宣言したプロダクトリポジトリだけを対話型オーケストレーターから参照・変更できるようにしました。`config scaffold` が追加する `orch:*` はこの入口を使います。Claude Code、Codex、Antigravity、GitHub Copilot は exec と同じ追加ルート引数を、OpenCode は実行時の `permission.external_directory` を利用します。起動中の `SIGINT` / `SIGQUIT` では子の終了を待ち、`SIGTERM` / `SIGHUP` は子へ転送します(PJR-ZGJ4、PJR-4Y48)。
39
+ - 質問に答えるだけで project、register、人の名簿、provider のオーケストレーター設定、agent
40
+ 実行設定、任意の成果物カタログと Dev Container を用意する `specdojo init` を追加しました。
41
+ 非対話オプション、既存ファイルの非上書き、`--dry-run` にも対応します。親検証は利用先の
42
+ `package.json` に対応 script があるものだけを設定し、worktree 既定先はリポジトリ名から作ります
43
+ (PJR-6QDA)。
44
+ - 人の名簿を設定しない project でも `.specdojo/agent-members.yaml` から agent を読み込めるようにし、
45
+ provider の scaffold が示す配置先とスニペット名を新しい agent 名簿へ統一しました。exec plan の
46
+ 共通規約は、利用先に依存・npm script・project 設定がある検査だけを求めるようになりました
47
+ (PJR-WZYW、PJR-44J9)。
48
+ - 1 つの登録簿項目で、プロジェクトリポジトリと N 個のプロダクトリポジトリを変更できるように
49
+ しました。`specdojo.config.json` の project に `repos` を宣言すると、`exec run --worktree` が
50
+ リポジトリごとの worktree を作り、`targets`・`paths` の `<repo>:<path>` を解決し、親検証を
51
+ `{ id, repo }` でリポジトリへ割り当てます。統合は事前検査の後に宣言順のプロダクト、最後に
52
+ プロジェクトの順で行い、途中で失敗した場合は統合済みのリポジトリを飛ばして再開します
53
+ (PJR-5822、PJR-HQBK、PJR-98G4、PJR-V96B、PJR-0WAA、PJR-69VP)。
54
+ - runner が付ける commit の `Refs:` trailer を `<project-id>:<item-id>` に修飾し、プロダクト側の
55
+ commit と merge commit にも付けるようにしました。統合後の commit snapshot は result の
56
+ トレーサビリティ表に記録します(PJR-1SXK、PJR-30SW)。
57
+ - `exec run --register --worktree --join` で実行中の run へ項目を追加し、
58
+ `run.max_concurrent_runs` の範囲で並行実行できるようにしました。`exec slots` で実行枠を
59
+ 確認でき、項目ごとの executor 指定にも対応しました(PJR-4HBG、PJR-K332)。
60
+ - plan / deliverable の実行で executor と reporter を分離でき、review 前には grade の鮮度を
61
+ 確認して結果を plan へ提示するようにしました(PJR-E2Q3、PJR-KCMH)。
62
+ - grade の再評価対象を内容・依存先・rulebook・rubric の変化から選べるようにしました。
63
+ 旧 rubric の結果は `--rubric-outdated` で抽出できます
64
+ (PJR-N03W、PJR-2F3Y、PJR-Z47X、PJR-BVPS)。
65
+ - grade の reporter の既定を executor の marker の機械変換にし、`grade plan --embed-documents` で
66
+ 評価対象と参考資料を行番号付きで埋め込めるようにしました(PJR-E9H3、PJR-26K4)。finding は
67
+ 英語の `message` を正本、日本語の `message_ja` を表示用として保存し、severity 上限を超える
68
+ level は下方向だけに補正して記録します。翻訳は各件の仮名とインラインコードを点検し、不合格の
69
+ 件だけを再試行します。既定の翻訳 agent は `gemma26-translator` です
70
+ (PJR-27Y0、PJR-JWXK、PJR-WAFC、PJR-PZPA)。
71
+ - `exec run --resume --resume-from executor` を追加しました。既存の worktree と未 commit の成果を
72
+ 保持して executor 段へ戻り、直前の block 理由や失敗した親検証を prompt へ引き継ぎます。
73
+ executor・reporter・統合のどの段から再開するときも、起動前に統合先の最新を取り込みます
74
+ (PJR-PG6W)。
75
+ - executor evidence の検証状態に `requires_human` を追加しました。実 agent CLI、利用枠・課金、
76
+ 認証情報、ホスト側の操作など sandbox から実行できない確認を、機械判定で block せず result の
77
+ 申し送りへ残せます(PJR-BK4K)。失敗した親検証の stdout / stderr は秘匿処理後に evidence へ
78
+ 保存され、要約には出力の先頭と末尾が残ります(PJR-R8WR)。
79
+ - executor evidence の検証状態に、理由必須の `not_applicable` を追加しました。適用外の検査は
80
+ result の申し送りへ残しつつ block せず、存在する npm script や導入済み package に対する
81
+ 誤申告は機械的に block します。SpecDojo サブコマンドは package の有無ではなく project 設定の
82
+ 適用条件で判定し、未導入 package・未定義 npm script・設定上適用外のコマンドを `not_run` とした
83
+ 場合も runner が適用外として result へ記録します(PJR-A0NE、PJR-755T)。
84
+ - `exec run --register` の実行場所を `run.register_execution` で設定できるようにし、`--in-place` を
85
+ 追加しました。設定がない既存 project の既定は従来どおり in-place です(PJR-D0KF)。
86
+ - `register` の記帳コマンドに `--commit` を追加しました。記帳用の実行枠を取得し、対象を
87
+ 限定して commit します(PJR-9XG4)。
88
+ - `config init` が生成物を除外する `.gitignore` を作成・追記するようになりました
89
+ (PJR-HG98)。
90
+ - `config scaffold` が provider 別の起動スクリプトを `package.json` へ追加します。
91
+ Antigravity では、差分確認とバックアップを伴う `--global` により、読み取り専用 Git
92
+ コマンドの permission rule を設定できます(PJR-RPSX、PJR-0FK2)。
93
+ - 試験的な機能として `devcontainer scaffold` を追加しました。provider の CLI、Ollama、cron、
94
+ tmux を選び、利用リポジトリごとに設定・認証情報を分離した環境を生成できます。Codex の
95
+ sandbox 用 seccomp 設定、OpenCode と GitHub CLI の named volume、既存 dotfiles を上書きしない
96
+ Emacs・Eglot のテンプレートにも対応しました。空の `~/.emacs.d` がある場合も Emacs が読み込む
97
+ `~/.emacs.d/init.el` へテンプレートを配置します。Codex は公式 installer(失敗時は npm)、OpenCode
98
+ は `opencode-ai` で導入します。Codex sandbox と Emacs は生成物の unit test まで完了していますが、
99
+ 生成した Dev Container での実機確認は公開前の人の確認事項です
100
+ (PJR-2H5F、PJR-KEQQ、PJR-EZAF、PJR-J7WE、PJR-XBDB)。
101
+ - docs サイトは実行記録をナビゲーションと検索の対象外にし、パス単位でサイドバーを
102
+ 分割しました。package 内の kata を一時配置して、eject していない文書も表示します
103
+ (PJR-E8FY、PJR-QQXP、PJR-SJ3X)。
104
+ - register 由来の plan で変更対象の網羅性を検証し、関連文書の未解決 grade finding を
105
+ 計画へ展開するようにしました(PJR-6WFA、PJR-PPYF、PJR-1JJD)。
106
+
107
+ - fully-guided の edit plan が、rulebook に対応する sample を形式の参考として参照するように
108
+ しました(PJR-AY1R)。
109
+ - 用語集(`gl-*.yaml`)の schema を追加し、`validate:schema` で検証できるようにしました
110
+ (PJR-Y06Y)。
111
+ - 親 runner の検証(`pipeline.parent_validations`)に `lint-ts`・`lint-fm`・`lint-md` を
112
+ 追加し、`npm run lint:ts`・`lint:fm`・`lint:md` を agent の段階で実行できるようにしました
113
+ (PJR-K1Z5)。
114
+ - 用語集の `category` と `relatedTerms` が同じ用語集の中の用語 ID を指すことと、用語 ID の
115
+ 重複がないことを検証する `glossary-references` を docs-lint に追加し、`validate:schema` に
116
+ 組み込みました(PJR-CF15)。
117
+ - 日本語文書へ混入した、日本語と字形の異なる簡体字 20 字を検出する markdownlint の
118
+ `MD061`(`no-chinese-glyphs`)を追加しました。コード、URL、明示的に除外した箇所は対象外です
119
+ (PJR-86JE)。
120
+ - rulebook に埋め込まれていたサンプル章を sample へ外出ししました。sample を持たなかった
121
+ `tml-rulebook` と `ifx-index-rulebook` には sample を新設しました(PJR-GWYJ)。
122
+ - 同梱のオーケストレーター定義に、起票時の対話支援(不足項目の確認と、個票の `_TODO_` の
123
+ 内容案の提示)と、記帳の `--commit` を使う手順を加えました(PJR-N8AW、PJR-NJRH)。
124
+ - SpecDojo の呼び方を「仕様道(Spec-Dō)の道場」に改め、記帳・実戦・評定・講評の技と、
125
+ `approach` に対応する流の名前を利用者向け文書へ加えました。標語は「決めて、書いて、
126
+ 鍛え続ける。」です(PJR-QGP4、PJR-0WYM、PJR-J29X)。
127
+ - Quick Start に、`specdojo init` から question・decision の記帳、設計書の更新、change-request、
128
+ 決定ログの確認までを 10 分で体験する「仕様の判断台帳」の手順を追加しました(PJR-XMQH)。
129
+ - routine が起動する Job Run を、本体の作業場所ではなく exec の worktree
130
+ (`exec/<project-id>-<run-id>`)で実行できるようにしました。runner が Run の出力だけを
131
+ `chore(routine): …` で exec ブランチへ commit し、`mode: review` の plan・result による review を
132
+ 経て、Run が成功し verdict が `complete` / `complete-with-findings` の場合だけ統合先へ `--no-ff` で
133
+ merge します。それ以外は worktree を残して統合せず、理由を Job Run、review result、routine の
134
+ 記録へ残します。Job の実行中に本体の作業場所の HEAD は動きません(PJR-VQZA)。
135
+ - Job Definition に、統合前 review を宣言する `task.review` を追加しました。宣言した Job は routine
136
+ と手動の `exec run --job` のどちらから起動しても、worktree での実行、runner の commit、review、
137
+ verdict による統合の流れで動きます。review agent は `task.review.agent.executor`(必須)と
138
+ `task.review.agent.reporter`(任意)で nickname 指名でき、`--review-by` / `--reporter-by`、Job の
139
+ 指名、自動選択の順に解決します。`exec run --job --dry-run` と `routine run --dry-run` は解決した
140
+ review agent を表示します。routine の `action.commit: true` は互換として読みますが新たには
141
+ 推奨せず、Job が `task.review` を宣言している場合は Job を優先します(PJR-MD3C)。
142
+ - `agent-config-write` の保護で block された設定変更(プロダクトリポジトリの `package.json` など)を、
143
+ result の申し送りに自動記録された提案差分から統合先へ適用・commit する
144
+ `specdojo exec handoff apply --project <project-id> --register <PJR-ID>` を追加しました。差分を
145
+ 表示してから確認を求め、非対話実行では `--yes` がない限り変更しません。保護対象外のパス、
146
+ 未宣言のリポジトリ、切り詰められた差分や適用できない差分は commit 前に拒否します。
147
+ `package.json` を適用した場合は lock ファイルの再生成と、続けて実行する `--resume` のコマンドを
148
+ 案内します(PJR-BJH6)。
149
+
150
+ - 文書の用語を整理しました。成果物体系・実践体系・遂行体系の 3 つの体系を、成果物・型(Kata)・技(Waza)に
151
+ 改め、流(Ryu、`approach`)をそれらをつなぐ属性として説明します。技は PDCA と register・schedule・
152
+ routine + Job の表で説明します。あわせて標語を「記して、形にして、磨き続ける。」に、プロダクト文書を指す
153
+ 「設計書」を「仕様書」に、別リポジトリ構成の親ディレクトリの例を `app1-workspace/` に改めました。
154
+ 文書の id は変わりません(PJR-9G9Y、PJR-34F2)。
155
+
156
+ ### 不具合修正
157
+
158
+ - docs-site の `build` と `dev` が、`docs/en` のないリポジトリでサイドバーの走査に失敗して止まる問題を
159
+ 修正しました。`config init` は `docs/ja` だけを作るため、README の手順どおりに導入すると最初の
160
+ ビルドで失敗していました。`docs/<locale>` のない言語は走査しません(PJR-EA20)。
161
+ - docs-site のビルド結果と cache が package の中(`node_modules/@specdojo/docs-site/.vitepress/`)へ
162
+ 出力され、`npm ci` で消える問題を修正しました。出力先は VitePress の既定と同じ、利用リポジトリ直下の
163
+ `.vitepress/dist` と `.vitepress/cache` です。利用リポジトリの `.gitignore` へ `/.vitepress/dist` と
164
+ `/.vitepress/cache` を加えてください(PJR-CA0S)。
165
+ - `npm test` が単体テストと統合テストを同時に実行すると負荷で時間切れになる問題を、
166
+ 既存の unit / integration 設定を 2 workers で実行し、統合テストには 30 秒の上限を適用する
167
+ project 構成にして修正しました(PJR-W2EB)。
168
+ - `devcontainer scaffold` が利用リポジトリの親ディレクトリをマウントし、別リポジトリ構成の
169
+ `repos` と `worktree_base` をコンテナから利用できるようにしました。親配下の Git リポジトリと
170
+ worktree も `safe.directory` の対象になります(PJR-P08H)。
171
+ - 日本語主体のタイトルで `register add` の `--topic` を省略したとき、`item` や混在する英単語だけの意味の薄い topic が作られる場合に警告し、起票時の指定方法と `register update --topic` による変更方法を案内するようにしました。日本語タイトルには英語の topic を指定する運用もガイドに明記しました(PJR-17HH)。
172
+
173
+ - pre-commit hook が生成コマンドと全テストを並列実行したとき、実リポジトリの生成済み登録簿を
174
+ 読むテストが書き換えと競合して一時的に失敗する問題を、テスト fixture へ隔離して修正しました。
175
+ checkpoint と統合段の commit / merge が失敗した場合は、秘匿処理した stdout / stderr の全文を
176
+ run の `integrate.log` へ保存し、短い失敗理由にも Vitest の `FAIL`・集計行を残します(PJR-Q7GJ)。
177
+ - `exec run` の worktree checkpoint が、root に無関係な staged 変更があるだけで停止する問題を修正しました。checkpoint 対象と重なる場合だけ停止し、commit hook などで checkpoint または register の runner commit が失敗した場合は、runner 対象だけを unstage して既存の staged 変更を保持します(PJR-PJBN)。
178
+ - Claude の edit executor がルート直下の成果物や `app/`・`lib/` などを編集できない問題を修正しました。既定でリポジトリ全体への編集を許可し、agent 設定・CI 設定・`package.json` などの保護対象は Claude の deny と runner の検査で拒否します(PJR-TM1B)。
179
+ - `exec run --resume` で reporter 段または統合段から再開するとき、統合先で直した不具合が
180
+ 親検証に反映されない問題を、親検証の前に統合先の最新を worktree へ取り込む形で修正しました
181
+ (PJR-GENJ)。
182
+ - waiting からの再開時に develop の変更を消す可能性がある merge と、複数回の waiting 後に
183
+ 記帳競合が未解決のまま残る問題を修正しました(PJR-R0XA、PJR-CTV4)。
184
+ - 並行実行時の親検証と遷移・統合をプロセス間で直列化し、イベント競合は両側の和集合で
185
+ 解決するようにしました。一部の項目が失敗しても遷移を項目ごとに記録し、ほかの項目の統合を
186
+ 妨げません(PJR-3HHW、PJR-36CN、PJR-7MF6)。
187
+ - resume 後の executor が plan の残作業を引き継がない問題と、rate limit 後に executor が
188
+ 再起動しない問題を修正しました(PJR-1Y9P、PJR-TDB0)。
189
+ - 再開前の同期で未 commit の成果と統合先の変更が重なる場合に成果を退避・復元し、統合済みの
190
+ product repository は再度取り込まないようにしました。Git の一時的な
191
+ `dubious ownership`、`Not a git repository`、index lock は、対象に `.git` がある場合だけ
192
+ 同じ上限で再試行します(PJR-H9R2、PJR-6RN3、PJR-GHKD、PJR-VX97)。
193
+ - executor が親 runner へ委ねた `not_run` は、project で同じコマンドが成功していれば満たされた
194
+ ものと扱います。`npm run check` のような合成コマンドも、その構成要素が runner または executor
195
+ で成功していれば block しないようにしました(PJR-979N、PJR-SDWF)。
196
+ - reporter が説明した変更ファイルの件数や順序に依存せず、変更パス、outcome、`block_reason` を
197
+ evidence から機械生成するようにしました(PJR-GBEV、PJR-0ECY)。
198
+ - runner が適用外と判定した検証と、executor が変更した runner 管理記録を reporter へ明示し、
199
+ 矛盾する確認依頼を防ぎました。引数付きの `npm run` も、script が存在すれば適用外の申告を
200
+ 反証します(PJR-2GFH)。
201
+ - grade が未完了または途中で打ち切られたときに成功扱いになる問題を修正しました
202
+ (PJR-QJAD、PJR-9PZ7)。
203
+ - agent の一時ファイルが commit や統合前検査へ混入する問題を、commit 対象を限定して
204
+ 修正しました(PJR-FFPK)。
205
+ - 統合段の dubious ownership を一度だけ再試行するようにしました(PJR-BX79)。
206
+ - CDFD / BPS の不整合、存在しない参照、オーケストレーターの `note` の状態説明を修正しました
207
+ (PJR-5RS9、PJR-6V3D、PJR-XW9M)。
208
+
209
+ - grade の reporter の出力が、finding の severity による level の上限に反した場合に、違反内容を
210
+ 添えて 1 回だけ出し直させるようにしました(PJR-AVSR)。
211
+ - 保護設定の検査が、利用上限で止まった直後に再生成可能な生成物を誤検知する問題を修正
212
+ しました。利用上限で止まった場合も検査は行い、止まった理由として利用上限を記録します
213
+ (PJR-GRB5)。OpenCode の導入ファイルは Git で無視されている場合だけ検査対象から除外します
214
+ (PJR-K1ZD)。
215
+ - executor の sandbox で `docs:build` が `tsx` の IPC で失敗する問題を、`docs:generate` を
216
+ `node --import tsx` で実行する形にして回避しました(PJR-M8NA)。
217
+ - 個票のタイトルに Markdown のエスケープ(`\*` など)が含まれると、plan・result・job の
218
+ frontmatter の `name` が不正な YAML になる問題を修正しました(PJR-C44H)。
219
+ - `register add` / `update` のタイトルと説明にある山括弧のプレースホルダを自動でインライン
220
+ コード化しました。waiting 以外への遷移では古い `block_reason` を消し、自動 commit の subject は
221
+ commitlint の長さの上限内に収めます(PJR-A9NC、PJR-SMET、PJR-DAW8)。
222
+ - 文書サイトの mermaid の SVG キャッシュが、mermaid-cli の版と `mermaid-config.json` の変更を
223
+ 判定に含めず、更新後も古い SVG を使い回す問題を修正しました(PJR-XMMA)。
224
+ - 利用者の環境に入る依存のうち、修正版を利用できる脆弱性に対応しました。`js-yaml` を 4.3.2 以上、`dotenv` を 18 に
225
+ 上げ、docs-site を puppeteer 25 と mermaid-cli 12 に上げました(PJR-6TKA、PJR-XMMA)。
226
+ docs-lint は `markdownlint-cli` を 0.49 に上げ、使われていなかった
227
+ `remark-lint-frontmatter-schema` を依存から外しました(PJR-7GAK)。
228
+ - `fast-glob` を、本体では Node 標準 API による再帰走査、docs-lint では `tinyglobby` に置き換え、
229
+ `micromatch` 経由の `braces` の high の脆弱性を本体の実行時依存から除きました(PJR-HQKV)。
230
+ - `repos` を宣言した project の `exec run --worktree` で、`project/` の worktree の `specdojo build` が
231
+ 兄弟のプロダクト worktree より先に設定を読み、`repos[].path` の存在検査で失敗する問題を修正
232
+ しました。プロダクト worktree を作成(または再利用)してから build します(PJR-NN43)。
233
+ - `--project` なしの `specdojo build` が `current_project` の登録簿しか生成せず、project が複数ある
234
+ 生成物のない worktree で index build が失敗する問題を修正しました。`project_register_path` を
235
+ 持つすべての project の登録簿を生成してから index build へ進みます(PJR-WJ83)。
236
+ - `exec run --register` で agent を指定しない場合に、pipeline 用でない agent(翻訳専用の agent など)が
237
+ owner・role から自動選択される問題を修正しました。既定は pipeline 実行とし、`stage_role` が
238
+ executor・reporter の agent から `priority` 順に選びます。該当する agent がない段は明示の指定を
239
+ 求めるエラーになります(PJR-ADZ6)。
240
+ - `not_applicable` の判定で、`<repo>:<path>` を引数に含むコマンドと `--prefix <repo>` 付きの
241
+ コマンドをプロダクトリポジトリの `package.json` で判定するようにしました。
242
+ `specdojo catalog validate` は `--project`、run の対象 project、`current_project` の順に対象を
243
+ 決めて `catalog_path` を判定します(PJR-WP44)。
244
+ - executor がプロダクトリポジトリの検証(`npm --prefix <repo> run <script>`)を `not_run` とした
245
+ 場合、同じリポジトリに割り当てた同じコマンドの親検証が成功したときだけ満たされたものと扱う
246
+ ようにしました。project リポジトリや別のプロダクトリポジトリの成功では代用しません
247
+ (PJR-2GZE)。
248
+ - プロダクト worktree の作成時に、追跡されている `package-lock.json` がないため依存を導入しな
249
+ かったことが分からない問題に対応し、`Skipping worktree dependencies: …` をログへ出すように
250
+ しました。lock を持つプロダクト worktree では従来どおり `npm ci` を実行します(PJR-86Q5)。
251
+ - `--resume` の同期で、統合先に入った内容と同じ未追跡ファイルが worktree に残ると再開を拒否する
252
+ 問題を修正しました。同じ内容なら解消して再開し、内容が異なる場合はパスを示して拒否し、元の
253
+ worktree を復元します(PJR-B2EC)。
254
+ - register 由来のタスクで、worktree の最上位に新規作成したファイル(`.gitignore`、設定、README
255
+ など)が `targets` なしでは commit されず統合前検査で止まる問題を修正しました。最上位の新規
256
+ ファイルを commit 対象に含め、run の `integrate.log` と result の申し送りへ記録します。`tmp/`
257
+ 配下は `.gitignore` の有無によらず commit 対象と統合前検査から除外し、exec plan の共通規約は
258
+ 作業用のファイルを `tmp/` かリポジトリ外へ置くよう指示します(PJR-GBVM)。
259
+ - `config init` が `.gitignore` に `node_modules/` を追記するようにしました。既存の `.gitignore` に
260
+ 同じ意味の行がある場合は追記しません(PJR-J2AS)。
261
+ - executor が実行できない `specdojo index build` を `not_run` と記録すると、index を runner が
262
+ 再生成していても run が止まる問題を直しました。index build は runner が担う検証として扱い、
263
+ executor には実行も記録もしないよう指示します。あわせて、`specdojo catalog validate` の適用を、
264
+ exec plan の共通規約と同じく変更範囲でも判定し、`docs/ja/projects/` 配下を変えない run の
265
+ `not_applicable` を受理します(PJR-HJ99)。
266
+
267
+ ### 既知の問題
268
+
269
+ - v0.3.0 の grade は試験的な機能です。npm package では `grade list` / `plan` / `apply` /
270
+ `validate` / `result` などの部品を利用できますが、通しの実行に使う SpecDojo 本体リポジトリの
271
+ 開発用スクリプト `tools/grade/run-per-document.sh` は package に含まれません。成果物の grade
272
+ には project の `catalog_path` が必要です(PJR-DJFT)。
273
+ - docs-site に high 1 件、moderate 1 件の脆弱性が残っています。mermaid 12 が依存する chevrotain 11 が `lodash-es` 4.17.23 を固定している問題と、vite 経由の `esbuild` に起因するものであり、いずれも上流の対応待ちです(PJR-XMMA)。
274
+ - docs-lint に moderate 1 件の脆弱性が残っています。`markdownlint-cli` 0.49.1 が `js-yaml` を
275
+ `~5.2.1` に固定しているためで、上流の対応待ちです(PJR-7GAK)。
276
+ - 試験的な `devcontainer scaffold` が生成するコンテナは、利用リポジトリの親フォルダを利用者の
277
+ フォルダ名によらず `/workspaces/specdojo-workspace` にマウントします。また、`--tmux` などの
278
+ 任意機能は指定しないと入らず、完了時の案内にも表示されません(PJR-PV5B)。
279
+
280
+ [0.3.0]: https://github.com/specdojo/specdojo/compare/v0.2.1...v0.3.0