specdojo 0.4.0 → 0.4.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/agents/specdojo-orchestrator.md +61 -2
- package/CHANGELOG.md +65 -0
- package/README.md +8 -7
- package/dist/commands/init.js +88 -15
- package/dist/commands/night-orchestrator.js +287 -0
- package/dist/commands/orchestrator.js +10 -3
- package/dist/dashboard/timeline-build.js +4 -151
- package/dist/devcontainer/command.js +3 -1
- package/dist/devcontainer/scaffold.js +166 -5
- package/dist/exec/agent-config.js +60 -2
- package/dist/exec/events.js +17 -6
- package/dist/exec/parent-validation.js +14 -0
- package/dist/exec/pipeline-state.js +13 -0
- package/dist/exec/plans-core.js +16 -5
- package/dist/exec/plans-storage.js +11 -3
- package/dist/exec/register.js +23 -1
- package/dist/exec/repo-integration.js +1 -1
- package/dist/exec/reporter.js +113 -13
- package/dist/exec/results.js +36 -14
- package/dist/exec/run/agent-pipeline.js +3 -0
- package/dist/exec/run/agent.js +40 -5
- package/dist/exec/run/job.js +2 -2
- package/dist/exec/run/lifecycle-commands.js +2 -2
- package/dist/exec/run/register-command.js +23 -4
- package/dist/exec/run/register-core.js +17 -0
- package/dist/exec/run/register-mode.js +39 -16
- package/dist/exec/run/register-post-review.js +420 -0
- package/dist/exec/run/register-resume.js +27 -11
- package/dist/exec/run/register-worktree.js +66 -2
- package/dist/exec/run/run.js +1 -1
- package/dist/exec/run/shared.js +22 -24
- package/dist/exec/task-repos.js +102 -15
- package/dist/kata/kata.js +1 -1
- package/dist/register/core.js +17 -4
- package/dist/register/create-commands.js +62 -6
- package/dist/register/cross-project.js +134 -0
- package/dist/register/derivation.js +28 -7
- package/dist/register/event-merge.js +13 -1
- package/dist/register/events.js +4 -0
- package/dist/register/item.js +35 -5
- package/dist/register/migration.js +1 -0
- package/dist/register/register.js +47 -30
- package/dist/schedule/strategy-generate-scope.js +2 -1
- package/dist/shared/catalog-files.js +31 -0
- package/dist/shared/git.js +45 -15
- package/dist/shared/lefthook-scaffold.js +177 -0
- package/dist/shared/provider-scaffold.js +3 -2
- package/dist/shared/specdojo-config.js +87 -17
- package/dist/shared/text.js +4 -1
- package/dist/shared/timeline-index.js +125 -0
- package/dist/shared/workspace-scaffold.js +69 -0
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +2 -1
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +2 -0
- package/docs/ja/specdojo/exec-templates/xrp-register-post-run-template.md +46 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +34 -1
- package/docs/ja/specdojo/guides/docs-structure-guide.md +2 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +79 -11
- package/docs/ja/specdojo/guides/exec-operation-guide.md +39 -1
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +9 -3
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +4 -2
- package/docs/ja/specdojo/guides/quick-start-guide.md +31 -6
- package/docs/ja/specdojo/guides/register-operation-guide.md +54 -0
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +52 -6
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +1 -1
- package/docs/ja/specdojo/guides/waza-guide.md +1 -1
- package/docs/ja/specdojo/references/command-reference.md +138 -64
- package/docs/ja/specdojo/references/specdojo-config-reference.md +41 -12
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +5 -2
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +92 -18
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +6 -1
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +12 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +21 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +40 -0
- package/package.json +17 -17
- package/templates/antigravity/README.md +1 -1
- package/templates/antigravity/orchestrator.md +61 -2
- package/templates/claude/agents/specdojo-orchestrator.md +61 -2
- package/templates/codex/README.md +17 -0
- package/templates/codex/agents/specdojo-orchestrator.toml +61 -2
- package/templates/codex/orchestrator.md +61 -2
- package/templates/devcontainer/devcontainer.json +3 -0
- package/templates/devcontainer/post-create.sh +15 -7
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +38 -5
- package/templates/devcontainer/remote-host/ssh-config.sample +3 -0
- package/templates/devcontainer/vim/vimrc +37 -0
- package/templates/init-agent-members.yaml +6 -6
- package/templates/init-exec-defaults.yaml +20 -1
- package/templates/lefthook/tools/install-lefthook.mjs +46 -0
- package/templates/lefthook/tools/specdojo-pre-commit.mjs +207 -0
- package/templates/opencode/README.md +6 -1
- package/templates/opencode/agents/specdojo-orchestrator.md +62 -3
- /package/dist/{shared → kata}/yaml-schema-modeline.js +0 -0
|
@@ -15,7 +15,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
15
15
|
## 基本方針
|
|
16
16
|
|
|
17
17
|
- 回答は原則として日本語で行う。
|
|
18
|
-
-
|
|
18
|
+
- 操作は「提案 → 承認 → 実行」の順で扱う。状態やファイルを変える操作は、「承認の聞き方」に従って何をするかを日本語で示し、利用者の承認を得てから実行する。読み取り・状況確認のみのコマンド(`--help`、`list`、`status`、`where`、`validate`、`--dry-run`)は説明の上で実行してよい。
|
|
19
19
|
- 破壊的変更や `git push` は行わない。
|
|
20
20
|
- `git commit` は次の方針で行う。実行前に必ず現在のブランチを確認して提示し、`main` では commit しない(対象ブランチを提案して止まる)。
|
|
21
21
|
- register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。register の記帳は `--commit` で commit する。
|
|
@@ -27,6 +27,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
27
27
|
- exec に流す予定の `todo` は、実行前に対象 project の `develop` へ入れておく。worktree は commit から作られるため、feature ブランチにしかない個票は実行できない。
|
|
28
28
|
- commit メッセージは subject を日本語で書き、conventional commit の type と scope を保つ。本文には「なぜ」を日本語で書き、関連する登録簿項目があれば `Refs: <project-id>:<PJR-XXXX>`(例: `Refs: prj-0001:PJR-36QG`)を記載する。項目ごとに 1 行とし、過去の commit の書式は書き換えない。
|
|
29
29
|
- 登録簿項目の実行は既定で `exec run --register` を使う。自分で実装するのは、利用者が実装者として自分を指定した場合に限る。「着手してください」は実行経路の指示であり、自分が実装してよい根拠として扱わない。実装者が読み取れない場合は確認する。
|
|
30
|
+
- 状態遷移の `--by` には、実際にその判断や作業をした主体を書く。利用者が決定・承認した記録は、役割の名前(`PO` など)ではなく人の名簿の nickname で残す。自分が確かめて close する記録や、自分で行った起票・記帳は `specdojo-orchestrator` で残す。`--by` は人と agent の名簿の nickname・alias と予約名(`SpecDojo`・`specdojo-orchestrator`・`night-orchestrator`)だけを受け付け、それ以外は記帳の前にエラーで止まる。
|
|
30
31
|
- 自分が直接対応した項目は `start` を経ずに `close` してよい。実行していない主体を actor とする遷移を、記録の体裁を揃える目的で追加しない。終端イベントの `reason` に対応経路を記録し、実施内容と検証結果は個票の対応結果へ残す。
|
|
31
32
|
- `specdojo.config.json` の project に `repos` で宣言されたプロダクトリポジトリは参照してよい。変更は利用者が自分を実装者に指定した場合に限り、そのリポジトリで `feature/<project-id>/<topic>` を切って commit する。`git push` は行わない。宣言していないリポジトリは参照も変更もしない。
|
|
32
33
|
- 認証情報・秘密鍵・`.env`・`secrets/` を読み込まない。
|
|
@@ -37,10 +38,20 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
|
|
|
37
38
|
|
|
38
39
|
1. 利用者の要望から「対象プロジェクト」「やりたいこと(登録・計画・実行・状況確認)」を特定する。曖昧なら質問して絞り込む。
|
|
39
40
|
2. 対応する `specdojo` サブコマンドと引数へマッピングする。必要なら該当コマンドの `--help` を先に確認する。
|
|
40
|
-
3.
|
|
41
|
+
3. 何をするか・中身・影響(生成・更新されるファイルと commit の先)を、「承認の聞き方」に従って日本語で示す。
|
|
41
42
|
4. 状態を変える操作は承認を得てから実行する。多くのコマンドは `--dry-run` を持つため、影響が大きい場合はまず `--dry-run` を提案する。
|
|
42
43
|
5. 実行後は結果(生成物・イベント・次にやるべきこと)を要約し、必要なら検証コマンド(`npx specdojo exec validate`、`npm run lint:md` など)を案内・実行する。
|
|
43
44
|
|
|
45
|
+
## 承認の聞き方
|
|
46
|
+
|
|
47
|
+
状態やファイルを変える操作の承認を求めるときは、コマンドではなく、次の順で日本語で示して「よろしいですか?」と聞く。コマンドは既定では見せず、利用者が求めたときや、うまく動かなかったときの説明に使う。
|
|
48
|
+
|
|
49
|
+
1. 何をするか(例: 「todo を起票します」「この項目を close します」)を 1 文で。
|
|
50
|
+
2. 中身。起票なら種類・タイトル・優先度・担当・期限・説明の要点、close なら結論と確かめたこと、実行なら対象と使う agent。
|
|
51
|
+
3. 影響。変わるファイルと commit の先(例: 「develop に記帳を 1 件 commit します」)。
|
|
52
|
+
|
|
53
|
+
選択肢がある場合は、案ごとの利点と欠点を表にし、推奨とその理由を添える。CLI のツールが出す「このコマンドを実行してよいか」という権限の確認は、ツール側の仕組みでこの聞き方とは別である。
|
|
54
|
+
|
|
44
55
|
## specdojo コマンド地図
|
|
45
56
|
|
|
46
57
|
| 目的 | サブコマンド | 代表操作 |
|
|
@@ -148,6 +159,54 @@ npx specdojo exec validate --project <project-id>
|
|
|
148
159
|
|
|
149
160
|
失敗して `waiting` になった場合は、個票の `block_reason` と result の申し送りを読み、原因を特定してから再開する。reporter 段だけの再開は `--resume` で行う。
|
|
150
161
|
|
|
162
|
+
## 実行の運び方
|
|
163
|
+
|
|
164
|
+
- `exec run --register` は `--worktree` で流す。同時に流すのは 2〜3 件までとする。親の検証は 1 件ずつ順に流れ、並行が多いと負荷で統合テストが時間切れになる。
|
|
165
|
+
- 時間のかかる run は background で流し、終わりの通知を待つ。途中経過を何度も見に行かない。
|
|
166
|
+
- プロセスを探す・止めるときに `pkill -f`・`pgrep -f` を使わない。探す文字列を含む自分のシェルにも一致し、自分を止める。
|
|
167
|
+
- 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
|
|
168
|
+
- 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
|
|
169
|
+
- 個票の本文を書き換えて普通に commit するのは、統合中の run がないときだけにする(`.git/index.lock` を確かめる)。commit に失敗したら、index に載ったファイルを残さない。残ると次の run の checkpoint が止まる。
|
|
170
|
+
- 保護された設定(agent の定義・名簿・`exec-defaults.yaml`・`package.json` など)は、executor が書き換えると統合の前に止まる。完了条件で「案を result に書く」と指示し、反映は利用者の承認のもと feature ブランチで行う。
|
|
171
|
+
- プロジェクトの文書にオーケストレーター向けの運用メモがあれば、作業を始める前に読む。
|
|
172
|
+
|
|
173
|
+
## close の前の確かめ方
|
|
174
|
+
|
|
175
|
+
- 完了条件を 1 項目ずつ、差分(`git show`)と result に照らして確かめる。親の検証が通っただけで close しない。
|
|
176
|
+
- agent の「直した」「反映済み」という報告は、実物(ファイルの中身、生成物、コマンドの出力)で確かめる。agent は、権限で編集を拒まれたあとでも完了と報告することがある。
|
|
177
|
+
- 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
|
|
178
|
+
- runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
|
|
179
|
+
- 確かめられない条件(ホストでの確認など)が残る場合は close せず `review` のまま残し、利用者に確かめ方を示す。
|
|
180
|
+
- 見つけた別の問題は、元の項目を `--from` で記録して起票する。完了条件の範囲を勝手に広げない。
|
|
181
|
+
|
|
182
|
+
## 止まったときの対処
|
|
183
|
+
|
|
184
|
+
| 止まった理由 | 対処 |
|
|
185
|
+
| ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
|
|
186
|
+
| agent の rate limit・つながらない | `--fallback-executor-by` / `--fallback-reporter-by` で代わりの agent を指定して再開する。解除の時刻が分かれば待つ |
|
|
187
|
+
| 親の検証の失敗(型・lint・テストの本当の失敗) | `--resume --resume-from executor` で executor からやり直す。失敗した検証の結果が引き継がれる |
|
|
188
|
+
| 負荷による時間切れ | 負荷を下げてから `--resume` で親の検証を流し直す |
|
|
189
|
+
| 統合での衝突(CHANGELOG の同じ節など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
|
|
190
|
+
| 保護された設定への変更 | worktree でその変更だけを戻して `--resume` するか、`exec handoff apply` で利用者の承認のもと当てる |
|
|
191
|
+
| commit の hook の失敗 | 失敗した段(markdownlint など)の出力を読み、記録のファイルを規約に合わせてから commit する |
|
|
192
|
+
| 既に統合済みで再開できない | 新しい run として `--force-restart` で流す |
|
|
193
|
+
|
|
194
|
+
## 完了条件の書き方
|
|
195
|
+
|
|
196
|
+
- 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
|
|
197
|
+
- 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
|
|
198
|
+
- CHANGELOG は未公開の版の節に書き、公開済みの版の節を変えないと書く。
|
|
199
|
+
- 保護された設定に触れる場合は、案を result に書き、反映は利用者が行うと書く。
|
|
200
|
+
- 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を result に書かせるかを明記する。
|
|
201
|
+
- Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。
|
|
202
|
+
|
|
203
|
+
## agent の選び方
|
|
204
|
+
|
|
205
|
+
- 具体的な agent の名前は、プロジェクトの設定に従う。`exec-defaults.yaml` に難しさごとの振り分けの設定があれば、個票の `difficulty`(`hard`・`medium`・`easy`)に合わせてそれを使う。
|
|
206
|
+
- 振り分けの設定がなければ、難しい作業(設計の判断を伴う変更、runner のコード)は expert の executor、範囲がはっきりした中程度の作業は normal の executor を選ぶ。
|
|
207
|
+
- 小さなローカル LLM は、編集できる範囲が限られることがあり、確かめずに完了と報告しがちである。plan で直し方が決まった小さな作業に限り、結果は必ず実物で確かめる。
|
|
208
|
+
- rate limit の解除まで長くかかる agent(割り当てが日単位のものなど)は、待たずに代わりの agent を指定する。
|
|
209
|
+
|
|
151
210
|
## プロジェクトの解決順序
|
|
152
211
|
|
|
153
212
|
対象 project は次の順で解決される。通常は `current_project` を使う。会話で対象が特定できない場合は利用者に確認する。
|
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,71 @@
|
|
|
2
2
|
|
|
3
3
|
SpecDojo の利用者に影響する変更を記録します。
|
|
4
4
|
|
|
5
|
+
## [0.4.2] - 2026-10-22
|
|
6
|
+
|
|
7
|
+
### 追加機能
|
|
8
|
+
|
|
9
|
+
- `specdojo init --lefthook` と `specdojo config scaffold --lefthook` で、利用リポジトリ向けの `lefthook.yml`、SpecDojo 文書向けの markdownlint 設定と agent 定義の除外、依存なしの入口スクリプトを生成できるようにしました。pre-commit は staged の Markdown・YAML に対する Prettier、Markdown に対する markdownlint、設定済みパスの変更に対する `register build`・`catalog validate` を実行します。既存ファイル・npm script・依存は上書きせず、package への追加内容を先に表示します(PJR-7H7N)。
|
|
10
|
+
- 別 project の作業ツリーから `register add --project <project-id> --commit` を実行し、対象 project の統合ブランチへ直接起票できるようにしました。統合ブランチは project の `integration_branch` で指定でき、省略時は `project/<project-id>/develop` です。project 修飾した `--from` は参照先 project の統合ブランチから存在を確認します(PJR-W93C)。
|
|
11
|
+
|
|
12
|
+
### 変更
|
|
13
|
+
|
|
14
|
+
- ドキュメントサイトでは exec の plan / result をページ生成の対象から外し、実行記録一覧などからのリンクを GitHub 上の正本へ置き換えるようにしました。元の実行記録と dead link 検査は維持したまま、ページ数とビルド時のメモリ使用量を削減します(PJR-98P8)。
|
|
15
|
+
- `templates/init-agent-members.yaml` で配布する OpenCode の `gemma-reporter` の既定モデルを 26b(`ollama-local/gemma4:26b`)にし、`gemma-executor`・`gemma-review-executor` および対話型オーケストレーターのモデル名からローカル固有のタグ(`-mlx-work-64k`)を除いて利用者が `ollama pull` で取得できるタグ名(`ollama-local/gemma4:31b`)に改めました。また `templates/opencode/README.md` に文脈長拡張のための Modelfile 手順と既存名簿の書き換え案内を追記しました(PJR-2ASZ)。
|
|
16
|
+
|
|
17
|
+
### 不具合修正
|
|
18
|
+
|
|
19
|
+
- plan / result の stem、アーカイブ済み plan、実行 event の乱数部分を2バイトから4バイトへ広げ、同じ slug・UTC秒・乱数が重複した場合は連番で別名にするようにしました。event は排他的な新規作成で既存履歴を上書きせず、旧形式の plan 名も引き続き読み取れます(PJR-CNNT)。
|
|
20
|
+
- `templates/lefthook/tools/specdojo-pre-commit.mjs` で、commit したファイルが `.markdownlintignore` や `.prettierignore` で除外されて検査対象がなくなった場合に、markdownlint や Prettier を呼ばずに成功で終えるようにしました。除外ファイルのみを commit したときに markdownlint の使い方の説明(Usage)が出力される問題を解消します(PJR-62T2)。
|
|
21
|
+
- `register build` が生成する登録簿一覧・派生ビュー・PM ログで、自由記述セルのアスタリスクとアンダースコアをエスケープするようにしました。既存のコードスパンとエスケープ済みの記号は保持し、`orch:*` のような記述が複数ある場合も markdownlint(MD037)で止まりません(PJR-6SQH)。
|
|
22
|
+
|
|
23
|
+
### 文書
|
|
24
|
+
|
|
25
|
+
- `templates/opencode/README.md` に、Mac の Apple シリコン向けに Ollama の公式 mlx 版(`gemma4:26b-mlx`・`gemma4:31b-mlx`)を利用する場合の指定方法と Modelfile での文脈拡張の案内を追記しました(PJR-STB4)。
|
|
26
|
+
|
|
27
|
+
## [0.4.1] - 2026-10-21
|
|
28
|
+
|
|
29
|
+
### 追加機能
|
|
30
|
+
|
|
31
|
+
- `.specdojo/specdojo.config.json` の `projects.<id>.run.parent_validations` で、共有 `exec-defaults.yaml` の `pipeline.parent_validations` に project 固有の親検証を追加できるようにしました。`{ id, repo }` も指定でき、プロダクトリポジトリを持つ project だけに検証を加えても、同じ defaults を使うほかの project には影響しません(PJR-HE9R)。
|
|
32
|
+
- `specdojo config scaffold --workspace` で、`repos` の設定から VS Code のマルチルートワークスペース(`<project-id>.code-workspace`)を生成できるようにしました。プロジェクトリポジトリ自身と `repos` で宣言された各プロダクトリポジトリを `folders` に宣言順で並べ、別リポジトリ構成でも 1 つのウィンドウで開発できます。`--project` で対象 project を指定でき(省略時は `current_project`)、既存のワークスペースファイルは `--force` を指定しない限り上書きしません(PJR-87XS)。
|
|
33
|
+
- `exec run --register --worktree` に、プロダクトリポジトリの統合先を run ごとに上書きする繰り返し可能な `--integration-branch <repo>=<branch>` を追加しました。指定は `repos[].integration_branch` より優先し、指定がなければ従来どおり設定値または現在のブランチを使います。並列実行では各 item run に適用し、再開時は checkpoint に保存した値を再利用して途中変更を拒否します(PJR-XRAB)。
|
|
34
|
+
- register 個票に `difficulty`(`hard` / `medium` / `easy`)を追加し、`exec-defaults.yaml` の `routing` で難易度ごとの executor・reporter・rate limit 対応・fallback を選べるようにしました。`exec run --register` と夜間 orchestrator が同じ表を使い、CLI 指定は表より優先し、難易度または表がない既存個票は従来の `priority` 自動選択を維持します。`specdojo init --exec` も選択した provider に合う表を生成します(PJR-5HYP)。
|
|
35
|
+
|
|
36
|
+
- `devcontainer scaffold --preset recommended` を追加しました。端末版 Emacs と Vim、tmux、SpecDojo の文書作業向け VS Code 拡張・保存時整形・YAML schema 関連付けをまとめて設定し、同じ拡張を `.vscode/extensions.json` にも推薦します。個別の `--editor`・`--tmux` と併用でき、既存のエディタ設定は上書きしません。`specdojo init` では Dev Container を選んだ場合だけ推奨 preset の利用を質問し、`--yes --devcontainer` では利用します(PJR-EN6M)。
|
|
37
|
+
|
|
38
|
+
- 親 runner の検証(`pipeline.parent_validations`)の固定許可リストに `build`(`npm run build`)と `format-check`(`npm run format:check`)を追加しました。別リポジトリ構成などでプロダクトリポジトリのビルドと整形の検証を親 runner に委譲できます(PJR-NS8Y)。
|
|
39
|
+
- `exec run --register --post-review`(または `exec-defaults.yaml` の `register_post_review: true`)で、統合の後に review の agent が完了条件・result・差分・検証の結果を照らして判定するようにしました。`complete`・`complete-with-findings` なら todo と issue を close し、`incomplete` なら `waiting` に戻します。decision と question、SpecDojo 自身のコードを変えた項目は自動では close しません(PJR-T46Y)。
|
|
40
|
+
- `register update --autopilot approved` で夜間に流してよい個票に印を付け、`specdojo orchestrator night` が印のある `open` の todo と issue だけを、worktree・統合後の review・並行で流すようにしました。1 晩の件数・並行数・連続した失敗での停止・rate limit のときの切り替えを指定でき、close したもの・`waiting` に戻したもの・新しく起票した承認待ちを朝の報告にまとめます(PJR-6DHY)。
|
|
41
|
+
|
|
42
|
+
### 変更
|
|
43
|
+
|
|
44
|
+
- `specdojo init` と `config scaffold` が追加するオーケストレーター起動スクリプトをモデルの系統名へ揃えました。Codex は `orch:sol`(`gpt-5.6-sol`)と `orch:terra`(`gpt-5.6-terra`)、Antigravity は `orch:flash`(`gemini-3.8-flash-high`)を追加し、旧 `orch:codex`・`orch:agy` は作りません。既存の `package.json` のスクリプトは上書き・削除しないため、scaffold の再実行後に新しい名前で起動を確認してから旧スクリプトを手動で削除してください。Claude Code と、利用環境ごとにモデルが異なる OpenCode の名前は変わりません(PJR-16S0)。
|
|
45
|
+
- 同梱のオーケストレーターの本文に、承認の聞き方(コマンドではなく、何をするか・中身・影響を日本語で示す)、実行の運び方、close の前の確かめ方、止まったときの対処の表、完了条件の書き方、agent の選び方を加えました(PJR-C50G)。
|
|
46
|
+
|
|
47
|
+
### 不具合修正
|
|
48
|
+
|
|
49
|
+
- `register` の `--by` を人・agent の名簿と予約 actor の一覧に照合し、agent alias は実体名へ解決して event に記録するようにしました。未知の名前や `PO` などの Role code は書き込み前に拒否し、省略時は予約 actor の `SpecDojo` を使います。対話型オーケストレーターの名前は `specdojo-orchestrator` に統一しました(PJR-3K1X)。
|
|
50
|
+
- exec の result へ executor / reporter の自由記述を描くとき、アスタリスクやアンダースコアを含む ASCII トークンをコードの書式にして、Markdown の強調と誤解釈されないようにしました。既にコードの書式で囲まれた部分は保持します。検証の適用外理由に `*.yaml` と `*.yml` を並べても markdownlint(MD037)で統合前に止まりません(PJR-A6PV)。
|
|
51
|
+
- ローカル LLM や provider API へ接続できず、`Cannot connect to API`・`ECONNREFUSED` などで指名した executor / reporter が失敗した場合に、`--fallback-executor-by` / `--fallback-reporter-by` で指定した agent へ切り替えるようにしました。接続不能の文言は provider ごとの `connection_error_detection` で設定し、`--on-rate-limit` の値とは独立して1回だけ fallback します。切替履歴は rate limit と同じく pipeline state・evidence・result に記録します(PJR-DKD8)。
|
|
52
|
+
- devcontainer の scaffold で生成する `post-create.sh` で、volume のマウント先の親(`~/.local`・`~/.local/share`・`~/.config`)の所有者をコンテナの利用者へ戻し、`~/.local/bin` を作成して `PATH` に加えるようにしました。Docker が親ディレクトリを root 所有で作成した環境でも Claude Code などのインストーラが失敗しないようにします。また、常時稼働ホスト接続サンプル `specdojo-tmux.sh.sample` の `docker exec` に `-u` で利用者(`devcontainer.json` の `remoteUser`、既定は `node`)を渡し、コンテナの既定の root で入らないようにしました(PJR-GHBP)。
|
|
53
|
+
- devcontainer の scaffold で生成する `devcontainer.json` に `remoteEnv` を設定し、`/home/<remoteUser>/.local/bin`(既定は `/home/node/.local/bin`)を `PATH` の先頭に追加するようにしました。コンテナ作成後に開く端末や VS Code のターミナルで `~/.local/bin` が `PATH` に入らず、Claude Code などの CLI が見つからない問題を解消します。常時稼働ホスト運用ガイドに既存環境の修正手順を追記しました(PJR-5JRJ)。
|
|
54
|
+
- 常時稼働ホスト接続サンプル `specdojo-tmux.sh.sample` で、`node_bin_dir` を設けて `/opt/homebrew/bin`・`/usr/local/bin` とともに既定で `PATH` の先頭へ追加し、冒頭コメントに `dirname "$(command -v devcontainer)"` による確かめ方と Homebrew・nvm・mise の例を記載しました。また、`devcontainer` と `docker` が見つからない際のエラー案内にその時点の `PATH` と置き場所の確かめ方を表示し、`ssh-config.sample` と常時稼働ホスト運用ガイドに `RemoteCommand` では端末の `PATH` 設定が読み込まれない注意と `ssh <host> 'command -v devcontainer'` による確認方法を記載しました(PJR-EJ4F)。
|
|
55
|
+
|
|
56
|
+
- `validate:schema:file`・Prettier・markdownlint の `not_applicable` を、script や依存 package の有無だけでなく executor が変更したファイルの種類も含めて判定するようにしました。対象種類の変更がない run は適用外として受理し、対象変更がある run の誤申告は従来どおり拒否します(PJR-8WBN)。
|
|
57
|
+
- executor が親検証と同じコマンドを `not_applicable` または `not_run` と報告しても、同じリポジトリで親 runner が実行した結果を正とするようにしました。親検証が成功している run が executor の重複報告によって `waiting` で止まる問題を解消し、親検証でない誤った `not_applicable` は従来どおり拒否します(PJR-7AW0)。
|
|
58
|
+
- exec の雛形を展開するときに、2 行以上続く空行を 1 行にまとめるようにしました。夜間の承認の印(autopilot)がない個票の register の plan では制約の段落が空に展開されて空行が重なり、plan を commit する hook の markdownlint(MD012)で `exec run --register` が止まっていました。agent の Job の plan や保守系の plan など、ほかの雛形で段落が空に展開される場合も同じくまとめます(PJR-283N)。
|
|
59
|
+
- runner の git の操作が `.git/index.lock` の取り合い(`Unable to create '...index.lock': File exists`、日本語のメッセージを含む)で失敗した場合のやり直しを、合計 0.75 秒ほどから 1.5 秒間隔で最大 10 回へ広げ、やり直すたびに警告を出すようにしました。並行の run の統合や記帳と重なっただけで統合が止まり run が `waiting` になる問題を減らします。上限に達した場合は従来どおり失敗として報告し、残っていたロックのファイルのパスをメッセージの先頭に含めます。ロックのファイルは消しません(PJR-G90K)。
|
|
60
|
+
- result(edit・review・post-review)で reporter が返した文を箇条書きに描くとき、文の先頭の `1.`・`1)`・`-` などのリスト記号を外すようにしました。review の agent が判断の根拠に自分で番号を付けると `- 1. ...` が入れ子の番号付きリストになり、post-review の記帳の commit が hook の markdownlint(MD029)で失敗して、close の記帳が作業ツリーに残っていました(PJR-0EFN)。
|
|
61
|
+
- commit の失敗を hook の出力から要約するとき、最初に出力された step ではなく、lefthook の summary で失敗の印が付いた step と、その出力のうち error を含む最初の行を報告するようにしました。post-review の記帳の commit が失敗したときは、失敗した hook の名前・最初のエラーの行・作業ツリーに残った記帳のファイル・hook の全出力のログ(`post-review-commit.log`)を runner のログに出します(PJR-0EFN)。
|
|
62
|
+
- `not_applicable` の判定で、プロダクトリポジトリを `$SPECDOJO_REPO_<NAME>`・`${SPECDOJO_REPO_<NAME>}` で指すコマンドを、そのリポジトリのコマンドとして扱うようにしました(PJR-E412)。
|
|
63
|
+
|
|
64
|
+
### 文書
|
|
65
|
+
|
|
66
|
+
- README・ドキュメントサイトのトップ・全体概要ガイド・遂行の技活用ガイドで、呼び方の表記を「Spec道(仕様道)の道場」に揃えました(PJR-EVAX)。
|
|
67
|
+
- Quick Start ガイドの導入手順で、Dev Container を作成し推奨 preset(tmux・Emacs・Vim・推奨の VS Code 拡張と設定・`.vscode/extensions.json`)を適用する対話例と、`devcontainer scaffold --preset recommended` の例に揃えました。コンテナを開く方法や、Dev Container を使わずに進める手順、`init --yes --devcontainer` で推奨 preset が入る説明も補記しました(PJR-SVHF)。
|
|
68
|
+
- README の「会話で操作する」の例で、オーケストレーターの発言をコマンドの提示から、何をするか・中身・影響を日本語で示して承認を求める形に改めました。コマンドは既定では見せず求めたときに見せる説明に合わせました(PJR-7P27)。
|
|
69
|
+
|
|
5
70
|
## [0.4.0] - 2026-10-18
|
|
6
71
|
|
|
7
72
|
同梱パッケージは `@specdojo/docs-lint` 0.2.1 を同時に公開します。docs-lint は 0.2.0 以降の変更(js-yaml の 5.4.3 への更新。引用符なしの日付と merge key は 4 系と同じ規則で読み込みます。PJR-RCVS)を含みます。`@specdojo/docs-site` は、この版では公開しません。
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# SpecDojo
|
|
2
2
|
|
|
3
|
-
SpecDojo
|
|
3
|
+
SpecDojo は、Spec道(仕様道)の道場です。
|
|
4
4
|
仕様と設計を作り、運用まで保つための体系を整えます。判断を記帳し、型に沿って実戦で書き、評定で鍛え続け、講評で完了を判断します。人と生成 AI が同じ成果物を作成・検証・更新できるようにし、仕様駆動開発のツールに対しては、その上流で仕様と設計の体系を担います。
|
|
5
5
|
|
|
6
6
|
**記して、形にして、磨き続ける。**
|
|
@@ -104,8 +104,8 @@ npm run orch:opus
|
|
|
104
104
|
| ------------- | ------------------------------------------- | --------------------------------- |
|
|
105
105
|
| `claude` | `.claude/agents/specdojo-orchestrator.md` | `npm run orch:opus` ほか |
|
|
106
106
|
| `opencode` | `.opencode/agents/specdojo-orchestrator.md` | `npm run orch:opencode` |
|
|
107
|
-
| `codex` | `.specdojo/codex/orchestrator.md` | `npm run orch:
|
|
108
|
-
| `antigravity` | `.specdojo/antigravity/orchestrator.md` | `npm run orch:
|
|
107
|
+
| `codex` | `.specdojo/codex/orchestrator.md` | `npm run orch:sol` ほか |
|
|
108
|
+
| `antigravity` | `.specdojo/antigravity/orchestrator.md` | `npm run orch:flash` |
|
|
109
109
|
|
|
110
110
|
各設定を個別に管理したい場合は、後述の「設定を個別に行う場合」にある `config init` と `config scaffold` を使います。
|
|
111
111
|
|
|
@@ -135,13 +135,14 @@ npx specdojo devcontainer scaffold --provider claude
|
|
|
135
135
|
|
|
136
136
|
```text
|
|
137
137
|
あなた : このプロジェクトを始めたい。まず登録簿を用意して、最初の作業を起票して。
|
|
138
|
-
オーケストレーター :
|
|
139
|
-
|
|
140
|
-
|
|
138
|
+
オーケストレーター : 登録簿を用意し、todo を 1 件起票します。
|
|
139
|
+
・中身: 種類 todo、タイトル「最初のタスク」、優先度 high
|
|
140
|
+
・影響: 登録簿のファイルを作成し、develop へ commit します
|
|
141
|
+
よろしいですか?
|
|
141
142
|
あなた : お願いします。
|
|
142
143
|
```
|
|
143
144
|
|
|
144
|
-
|
|
145
|
+
コマンドは既定では見せず、求めたときに見せます。状態を変える操作は承認を得てから実行し、`git push` や破壊的操作は行いません。起票した項目の
|
|
145
146
|
実行、状況の確認、成果物の生成も同じ流れで進みます。
|
|
146
147
|
|
|
147
148
|
```text
|
package/dist/commands/init.js
CHANGED
|
@@ -5,6 +5,7 @@ import { dump, load } from "../shared/yaml.js";
|
|
|
5
5
|
import { runScaffold } from "../catalog/scaffold.js";
|
|
6
6
|
import { runDevcontainerScaffold } from "../devcontainer/scaffold.js";
|
|
7
7
|
import { runProviderScaffold } from "../shared/provider-scaffold.js";
|
|
8
|
+
import { runLefthookScaffold } from "../shared/lefthook-scaffold.js";
|
|
8
9
|
import { generateDerivedViewFiles } from "../register/register.js";
|
|
9
10
|
import { defaultWorktreeBase, projectGitignoreLayout, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
10
11
|
import { ensureGitignore, formatGitignoreReport, gitignorePatternsForLayouts, } from "../shared/specdojo-gitignore.js";
|
|
@@ -18,6 +19,8 @@ const PARENT_VALIDATION_SCRIPTS = {
|
|
|
18
19
|
"validate-schema": "validate:schema",
|
|
19
20
|
typecheck: "typecheck",
|
|
20
21
|
"test-unit": "test:unit",
|
|
22
|
+
build: "build",
|
|
23
|
+
"format-check": "format:check",
|
|
21
24
|
};
|
|
22
25
|
const DEFAULTS = {
|
|
23
26
|
projectId: "prj-0001",
|
|
@@ -63,6 +66,14 @@ function parseCatalog(value) {
|
|
|
63
66
|
}
|
|
64
67
|
throw new Error(`Invalid catalog size: ${value}. Must be small, medium, large, or none`);
|
|
65
68
|
}
|
|
69
|
+
function parseDevcontainerPreset(value) {
|
|
70
|
+
const normalized = value?.trim().toLowerCase();
|
|
71
|
+
if (!normalized || normalized === "none" || normalized === "-")
|
|
72
|
+
return undefined;
|
|
73
|
+
if (normalized === "recommended")
|
|
74
|
+
return normalized;
|
|
75
|
+
throw new Error(`Invalid Dev Container preset: ${value}. Must be recommended or none`);
|
|
76
|
+
}
|
|
66
77
|
function validateProjectId(projectId) {
|
|
67
78
|
if (!/^prj-[0-9]{4,}$/.test(projectId)) {
|
|
68
79
|
throw new Error(`Invalid project ID: ${projectId}. Expected prj-0001 style`);
|
|
@@ -97,6 +108,9 @@ function validateAnswers(answers) {
|
|
|
97
108
|
validateNickname(answers.nickname);
|
|
98
109
|
validateDisplayName(answers.displayName);
|
|
99
110
|
validateExecProviders(answers.providers, answers.exec);
|
|
111
|
+
if (answers.devcontainerPreset && !answers.devcontainer) {
|
|
112
|
+
throw new Error("--devcontainer-preset requires --devcontainer");
|
|
113
|
+
}
|
|
100
114
|
return answers;
|
|
101
115
|
}
|
|
102
116
|
async function promptUntilValid(prompter, prompt, parse) {
|
|
@@ -112,6 +126,13 @@ async function promptUntilValid(prompter, prompt, parse) {
|
|
|
112
126
|
}
|
|
113
127
|
export async function collectInitAnswers(options, prompter) {
|
|
114
128
|
if (!prompter) {
|
|
129
|
+
const devcontainer = !!options.devcontainer;
|
|
130
|
+
const explicitPreset = parseDevcontainerPreset(options.devcontainerPreset);
|
|
131
|
+
const devcontainerPreset = devcontainer
|
|
132
|
+
? options.devcontainerPreset === undefined
|
|
133
|
+
? "recommended"
|
|
134
|
+
: explicitPreset
|
|
135
|
+
: explicitPreset;
|
|
115
136
|
const answers = validateAnswers({
|
|
116
137
|
projectId: options.project?.trim() || DEFAULTS.projectId,
|
|
117
138
|
projectName: options.name?.trim() || DEFAULTS.projectName,
|
|
@@ -121,7 +142,9 @@ export async function collectInitAnswers(options, prompter) {
|
|
|
121
142
|
providers: parseProviders(options.provider),
|
|
122
143
|
exec: !!options.exec,
|
|
123
144
|
catalog: parseCatalog(options.catalog),
|
|
124
|
-
devcontainer
|
|
145
|
+
devcontainer,
|
|
146
|
+
lefthook: !!options.lefthook,
|
|
147
|
+
...(devcontainerPreset ? { devcontainerPreset } : {}),
|
|
125
148
|
});
|
|
126
149
|
for (const [label, used] of [
|
|
127
150
|
["project", !options.project],
|
|
@@ -133,6 +156,8 @@ export async function collectInitAnswers(options, prompter) {
|
|
|
133
156
|
["exec=no", !options.exec],
|
|
134
157
|
["catalog=none", !options.catalog],
|
|
135
158
|
["devcontainer=no", !options.devcontainer],
|
|
159
|
+
["lefthook=no", !options.lefthook],
|
|
160
|
+
["devcontainer-preset=recommended", devcontainer && options.devcontainerPreset === undefined],
|
|
136
161
|
]) {
|
|
137
162
|
if (used)
|
|
138
163
|
process.stdout.write(`Using default: ${label}\n`);
|
|
@@ -148,6 +173,8 @@ export async function collectInitAnswers(options, prompter) {
|
|
|
148
173
|
const providerDefault = options.provider?.trim() || DEFAULTS.providers.join(",");
|
|
149
174
|
const execDefault = !!options.exec;
|
|
150
175
|
const devcontainerDefault = !!options.devcontainer;
|
|
176
|
+
const lefthookDefault = !!options.lefthook;
|
|
177
|
+
const explicitDevcontainerPreset = parseDevcontainerPreset(options.devcontainerPreset);
|
|
151
178
|
const providerPrompt = `Orchestrator providers (${PROVIDERS.join(", ")}) [${providerDefault}]: `;
|
|
152
179
|
const projectId = await promptUntilValid(prompter, `Project ID [${projectDefault}]: `, (answer) => validateProjectId(answer.trim() || projectDefault));
|
|
153
180
|
const projectName = await promptUntilValid(prompter, `Project name [${nameDefault}]: `, (answer) => validateProjectName(answer.trim() || nameDefault));
|
|
@@ -162,6 +189,10 @@ export async function collectInitAnswers(options, prompter) {
|
|
|
162
189
|
}
|
|
163
190
|
const catalog = parseCatalog(options.catalog);
|
|
164
191
|
const devcontainer = await promptUntilValid(prompter, `Create a Dev Container? [${devcontainerDefault ? "Y/n" : "y/N"}]: `, (answer) => parseBoolean(answer, devcontainerDefault));
|
|
192
|
+
const devcontainerPreset = devcontainer && options.devcontainerPreset === undefined
|
|
193
|
+
? await promptUntilValid(prompter, "Add the recommended Dev Container settings? [Y/n]: ", (answer) => (parseBoolean(answer, true) ? "recommended" : undefined))
|
|
194
|
+
: explicitDevcontainerPreset;
|
|
195
|
+
const lefthook = await promptUntilValid(prompter, `Create Git hooks with lefthook? [${lefthookDefault ? "Y/n" : "y/N"}]: `, (answer) => parseBoolean(answer, lefthookDefault));
|
|
165
196
|
return validateAnswers({
|
|
166
197
|
projectId,
|
|
167
198
|
projectName,
|
|
@@ -172,6 +203,8 @@ export async function collectInitAnswers(options, prompter) {
|
|
|
172
203
|
exec,
|
|
173
204
|
catalog,
|
|
174
205
|
devcontainer,
|
|
206
|
+
lefthook,
|
|
207
|
+
...(devcontainerPreset ? { devcontainerPreset } : {}),
|
|
175
208
|
});
|
|
176
209
|
}
|
|
177
210
|
finally {
|
|
@@ -305,6 +338,33 @@ function writeExecConfiguration(repoRoot, packageRoot, providers, dryRun) {
|
|
|
305
338
|
const selected = new Set(providers);
|
|
306
339
|
const members = memberTemplate.members.filter((member) => member.provider && selected.has(member.provider));
|
|
307
340
|
const aliases = selectAliases(memberTemplate.aliases ?? [], new Set(members.map((member) => member.nickname)));
|
|
341
|
+
const pairs = providers.map((provider) => {
|
|
342
|
+
const executor = members.find((member) => member.provider === provider && member.stage_role === "executor" && member.mode === "edit");
|
|
343
|
+
const reporter = members.find((member) => member.provider === provider && member.stage_role === "reporter");
|
|
344
|
+
if (!executor || !reporter) {
|
|
345
|
+
throw new Error(`init-agent-members.yaml must define an edit executor and reporter for ${provider}`);
|
|
346
|
+
}
|
|
347
|
+
return {
|
|
348
|
+
executor: preferredAgentName(executor, aliases),
|
|
349
|
+
reporter: preferredAgentName(reporter, aliases),
|
|
350
|
+
};
|
|
351
|
+
});
|
|
352
|
+
const route = (pairIndex, action) => {
|
|
353
|
+
const resolvedIndex = Math.min(pairIndex, pairs.length - 1);
|
|
354
|
+
const pair = pairs[resolvedIndex];
|
|
355
|
+
const fallback = pairs.length > 1 ? pairs[(resolvedIndex + 1) % pairs.length] : undefined;
|
|
356
|
+
return {
|
|
357
|
+
executor_by: pair.executor,
|
|
358
|
+
reporter_by: pair.reporter,
|
|
359
|
+
on_rate_limit: action === "fallback" && !fallback ? "stop" : action,
|
|
360
|
+
...(fallback
|
|
361
|
+
? {
|
|
362
|
+
fallback_executor_by: fallback.executor,
|
|
363
|
+
fallback_reporter_by: fallback.reporter,
|
|
364
|
+
}
|
|
365
|
+
: {}),
|
|
366
|
+
};
|
|
367
|
+
};
|
|
308
368
|
const providerDefaults = Object.fromEntries(Object.entries(defaultsTemplate.providers).filter(([provider]) => selected.has(provider)));
|
|
309
369
|
const { providers: _providers, ...commonDefaults } = defaultsTemplate;
|
|
310
370
|
const commonPipeline = commonDefaults.pipeline && typeof commonDefaults.pipeline === "object"
|
|
@@ -312,7 +372,14 @@ function writeExecConfiguration(repoRoot, packageRoot, providers, dryRun) {
|
|
|
312
372
|
: {};
|
|
313
373
|
const { parent_validations: configuredParentValidations, ...otherPipeline } = commonPipeline;
|
|
314
374
|
const parentValidations = selectParentValidations(repoRoot, configuredParentValidations);
|
|
315
|
-
const configuredDefaults = {
|
|
375
|
+
const configuredDefaults = {
|
|
376
|
+
...commonDefaults,
|
|
377
|
+
routing: {
|
|
378
|
+
hard: route(0, "wait"),
|
|
379
|
+
medium: route(1, "fallback"),
|
|
380
|
+
easy: route(2, "fallback"),
|
|
381
|
+
},
|
|
382
|
+
};
|
|
316
383
|
if (parentValidations.length > 0 || Object.keys(otherPipeline).length > 0) {
|
|
317
384
|
configuredDefaults.pipeline = {
|
|
318
385
|
...otherPipeline,
|
|
@@ -324,17 +391,9 @@ function writeExecConfiguration(repoRoot, packageRoot, providers, dryRun) {
|
|
|
324
391
|
}
|
|
325
392
|
writeNewFile(repoRoot, ".specdojo/agent-members.yaml", dump({ version: 1, members, ...(aliases.length > 0 ? { aliases } : {}) }, { lineWidth: 120, noRefs: true }), dryRun);
|
|
326
393
|
writeNewFile(repoRoot, ".specdojo/exec-defaults.yaml", dump({ ...configuredDefaults, providers: providerDefaults }, { lineWidth: 120, noRefs: true }), dryRun);
|
|
327
|
-
const primaryProvider = providers[0];
|
|
328
|
-
const executor = members.find((member) => member.provider === primaryProvider &&
|
|
329
|
-
member.stage_role === "executor" &&
|
|
330
|
-
member.mode === "edit");
|
|
331
|
-
const reporter = members.find((member) => member.provider === primaryProvider && member.stage_role === "reporter");
|
|
332
|
-
if (!executor || !reporter) {
|
|
333
|
-
throw new Error("init-agent-members.yaml must define an edit executor and reporter");
|
|
334
|
-
}
|
|
335
394
|
return {
|
|
336
|
-
executor:
|
|
337
|
-
reporter:
|
|
395
|
+
executor: pairs[0].executor,
|
|
396
|
+
reporter: pairs[0].reporter,
|
|
338
397
|
};
|
|
339
398
|
}
|
|
340
399
|
function scaffoldRegister(repoRoot, config, answers, dryRun) {
|
|
@@ -454,6 +513,7 @@ export async function runInit(options, deps) {
|
|
|
454
513
|
packageRoot,
|
|
455
514
|
repoRoot,
|
|
456
515
|
workspaceName: options.workspaceName,
|
|
516
|
+
preset: answers.devcontainerPreset,
|
|
457
517
|
providers: answers.providers,
|
|
458
518
|
editors: [],
|
|
459
519
|
ollama: answers.providers.includes("opencode"),
|
|
@@ -463,12 +523,23 @@ export async function runInit(options, deps) {
|
|
|
463
523
|
dryRun,
|
|
464
524
|
});
|
|
465
525
|
}
|
|
526
|
+
if (answers.lefthook) {
|
|
527
|
+
await runLefthookScaffold({
|
|
528
|
+
packageRoot,
|
|
529
|
+
repoRoot,
|
|
530
|
+
config,
|
|
531
|
+
force: false,
|
|
532
|
+
dryRun,
|
|
533
|
+
});
|
|
534
|
+
}
|
|
466
535
|
const firstProvider = answers.providers[0];
|
|
467
536
|
const script = firstProvider === "claude"
|
|
468
537
|
? "orch:opus"
|
|
469
|
-
: firstProvider === "
|
|
470
|
-
? "orch:
|
|
471
|
-
:
|
|
538
|
+
: firstProvider === "codex"
|
|
539
|
+
? "orch:sol"
|
|
540
|
+
: firstProvider === "antigravity"
|
|
541
|
+
? "orch:flash"
|
|
542
|
+
: `orch:${firstProvider}`;
|
|
472
543
|
process.stdout.write("Next steps:\n" +
|
|
473
544
|
(firstProvider
|
|
474
545
|
? ` 1. Run npm run ${script} and create the first register item.\n`
|
|
@@ -495,6 +566,8 @@ export function registerInitCommand(program) {
|
|
|
495
566
|
.option("--exec", "Configure executor and reporter agents", false)
|
|
496
567
|
.option("--catalog <size>", "Create a deliverables catalog (small|medium|large)")
|
|
497
568
|
.option("--devcontainer", "Create a Dev Container for the selected providers", false)
|
|
569
|
+
.option("--lefthook", "Create pre-commit hooks for SpecDojo repositories", false)
|
|
570
|
+
.option("--devcontainer-preset <name>", "Apply a Dev Container preset when creating it (recommended|none)")
|
|
498
571
|
.option("--workspace-name <name>", "Override the Dev Container workspace parent name used under /workspaces")
|
|
499
572
|
.option("--dry-run", "Show planned files and changes without writing", false)
|
|
500
573
|
.action(async (options) => {
|