specdojo 0.4.1 → 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.
Files changed (30) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/dist/commands/init.js +16 -0
  3. package/dist/dashboard/timeline-build.js +4 -151
  4. package/dist/exec/events.js +17 -6
  5. package/dist/exec/plans-core.js +16 -5
  6. package/dist/exec/plans-storage.js +11 -3
  7. package/dist/kata/kata.js +1 -1
  8. package/dist/register/core.js +3 -2
  9. package/dist/register/cross-project.js +134 -0
  10. package/dist/register/derivation.js +28 -7
  11. package/dist/register/item.js +26 -5
  12. package/dist/register/register.js +45 -28
  13. package/dist/schedule/strategy-generate-scope.js +2 -1
  14. package/dist/shared/catalog-files.js +31 -0
  15. package/dist/shared/lefthook-scaffold.js +177 -0
  16. package/dist/shared/specdojo-config.js +21 -4
  17. package/dist/shared/timeline-index.js +125 -0
  18. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +4 -2
  19. package/docs/ja/specdojo/guides/quick-start-guide.md +23 -1
  20. package/docs/ja/specdojo/guides/register-operation-guide.md +12 -0
  21. package/docs/ja/specdojo/references/command-reference.md +39 -10
  22. package/docs/ja/specdojo/references/specdojo-config-reference.md +8 -5
  23. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +5 -0
  24. package/package.json +1 -1
  25. package/templates/init-agent-members.yaml +3 -3
  26. package/templates/lefthook/tools/install-lefthook.mjs +46 -0
  27. package/templates/lefthook/tools/specdojo-pre-commit.mjs +207 -0
  28. package/templates/opencode/README.md +6 -1
  29. package/templates/opencode/agents/specdojo-orchestrator.md +1 -1
  30. /package/dist/{shared → kata}/yaml-schema-modeline.js +0 -0
@@ -38,16 +38,16 @@ project の解決順序と設定は [遂行の技活用ガイド](../guides/waza
38
38
 
39
39
  ## 2. init / config / project
40
40
 
41
- | コマンド | 用途 | 例 |
42
- | ------------------------ | ------------------------------------------------------- | ------------------------------------------- |
43
- | `init` | project から agent 実行までを質問式で初期設定する | `specdojo init` |
44
- | `config init` | `specdojo.config.json` と `.gitignore` を個別に用意する | `specdojo config init` |
45
- | `config migrate-members` | agent 定義を保護設定へ移す | `specdojo config migrate-members --dry-run` |
46
- | `config scaffold` | provider や VS Code ワークスペースを個別に配置する | `specdojo config scaffold --provider codex` |
47
- | `project list` | 登録済み project を表示する | `specdojo project list` |
41
+ | コマンド | 用途 | 例 |
42
+ | ------------------------ | ----------------------------------------------------------- | ------------------------------------------- |
43
+ | `init` | project から agent 実行までを質問式で初期設定する | `specdojo init` |
44
+ | `config init` | `specdojo.config.json` と `.gitignore` を個別に用意する | `specdojo config init` |
45
+ | `config migrate-members` | agent 定義を保護設定へ移す | `specdojo config migrate-members --dry-run` |
46
+ | `config scaffold` | provider、VS Code ワークスペース、Git hook を個別に配置する | `specdojo config scaffold --lefthook` |
47
+ | `project list` | 登録済み project を表示する | `specdojo project list` |
48
48
 
49
49
  `init` は対話できる端末で、project ID と名前、register、人の nickname と表示名、複数指定可能な
50
- provider、exec、Dev Container の順に質問します。Dev Container を選んだ場合だけ、続けて推奨 preset を入れるかを質問します(既定は「入れる」)。成果物カタログは対話では質問せず、`--catalog <size>` を
50
+ provider、exec、Dev Container、Git hook の順に質問します。Dev Container を選んだ場合だけ、続けて推奨 preset を入れるかを質問します(既定は「入れる」)。Git hook は既定では作りません。成果物カタログは対話では質問せず、`--catalog <size>` を
51
51
  明示した場合にだけ作成します。既存ファイルは上書きせず、スキップしたパスを表示します。`--dry-run` は
52
52
  予定だけを表示し、ファイルや `package.json` を変更しません。各回答は質問の直後に検証され、誤りの理由を
53
53
  表示して同じ質問だけをやり直します。それまでの回答は保持されます。`--exec` を選んだのに provider が
@@ -68,6 +68,7 @@ provider、exec、Dev Container の順に質問します。Dev Container を選
68
68
  | `--exec` | executor / reporter の名簿と起動設定を作る | 作らない |
69
69
  | `--catalog <size>` | `small` / `medium` / `large` の成果物カタログを作る(対話では質問しない) | 作らない |
70
70
  | `--devcontainer` | 選んだ provider の Dev Container を作る | 作らない |
71
+ | `--lefthook` | commit 前の文書・SpecDojo 検査を行う Git hook を作る | 作らない |
71
72
  | `--devcontainer-preset <name>` | Dev Container の preset(`recommended` / `none`)を選ぶ | `recommended` |
72
73
  | `--workspace-name <name>` | Dev Container 内で使う親ディレクトリ名 | ホスト側の親名 |
73
74
  | `--dry-run` | 作成・変更予定だけを表示する | 書き込む |
@@ -103,6 +104,32 @@ specdojo config scaffold --provider antigravity --global
103
104
 
104
105
  `--force` はリポジトリ内の scaffold ファイルだけを上書きし、グローバル設定の既存項目は上書きしません。従来の `exec scaffold --provider antigravity` でも同じ `--global` / `--dry-run` の挙動を利用できます。
105
106
 
107
+ `config scaffold --lefthook` は、利用リポジトリに `lefthook.yml`、`.markdownlint.jsonc`、
108
+ `.markdownlintignore`、依存なしで起動できる `tools/install-lefthook.mjs` と
109
+ `tools/specdojo-pre-commit.mjs` を生成します。pre-commit では staged の Markdown と YAML だけを
110
+ Prettier で整形し、staged の Markdown だけを markdownlint で検査します。
111
+ また、`.specdojo/specdojo.config.json` の `project_register_path` 配下に staged の変更がある project では
112
+ `specdojo register build`、`catalog_path` 配下に変更がある project では `specdojo catalog validate` を
113
+ 実行します。`catalog_path` がない構成には catalog の command を生成せず、テストは hook に含めません。
114
+
115
+ ```bash
116
+ specdojo config scaffold --lefthook --dry-run
117
+ specdojo config scaffold --lefthook
118
+ npm install
119
+ ```
120
+
121
+ 生成する markdownlint 設定は SpecDojo の文書向けに行長などの規則を調整し、ignore は Claude Code、
122
+ GitHub Copilot、OpenCode の agent 定義を検査対象から外します。既存の markdownlint 設定と ignore は
123
+ `--force` を付けても上書きしません。既存の `lefthook.yml` と `tools/` のファイルは `--force` なしでは
124
+ 上書きしません。必要な
125
+ `lefthook`・`prettier`・`markdownlint-cli` の devDependencies と `prepare`・`pre-commit` npm script は、
126
+ 不足している項目を `package.json` の変更前に表示してから追加します。同名の script、dependencies、
127
+ devDependencies は `--force` を指定しても保持します。`package.json` がない場合は必要な JSON を表示する
128
+ だけで、ファイルを新規作成しません。installer は linked worktree と `node_modules/lefthook` がない環境を
129
+ 成功扱いで skip します。primary worktree で `npm install`、または既存の `prepare` を保持した場合は
130
+ `node tools/install-lefthook.mjs` を実行してください。hook 内から Git を呼ぶ入口は `GIT_DIR` などの
131
+ repository-local 環境変数を除いてから staged files を調べます。
132
+
106
133
  `config scaffold --workspace` は、`.specdojo/specdojo.config.json` の `repos` 宣言から VS Code のマルチルートワークスペース(`<project-id>.code-workspace`)をリポジトリルートに生成します。`folders` にはプロジェクトリポジトリ(`.`)と各プロダクトリポジトリ(`repos[].path`)を宣言順に並べ、別リポジトリ構成でも 1 つの VS Code ウィンドウでプロジェクトとプロダクトを同時に開けます。`--project <id>` で対象 project を指定でき、省略時は `current_project` を使います。既存のファイルは `--force` を指定しない限り上書きしません。`repos` が宣言されていない project ではエラーになります。`--dry-run` は書き込まず予定の内容だけを表示します。
107
134
 
108
135
  ```bash
@@ -349,7 +376,7 @@ specdojo schedule strategy generate \
349
376
  | `register history` | 追記型 event と旧 Git 履歴から変更を再構成する | `specdojo register history --project prj-0001 --since 2026-08-01` |
350
377
  | `register migrate` | 旧形式の登録簿データを現行形式へ移行する | `specdojo register migrate --project prj-0001 --dry-run` |
351
378
 
352
- `register add` は ID を省略すると自動採番し、現在の作業ツリーに type 別の個票を作成します。ID は乱数部分を持ち、曖昧文字(`I` / `L` / `O` / `U`)を除いた英大文字+数字の 32 文字セットによる 4 桁(例: `PJR-4B7K`)です。個票 Frontmatter が分類、処理状態、優先度、担当、日付、結論の正本であり、`register build` は個票から一覧と派生ビューを生成します。`register` 系コマンドはすべて、成功時の通常出力を標準出力へ、エラーメッセージを標準エラー出力へ書きます。
379
+ `register add` は ID を省略すると自動採番し、現在の project では現在の作業ツリーに type 別の個票を作成します。別 project を `--project` で指定して `--commit` を付けると、対象 project の統合ブランチを開いている worktree、または CLI が作る一時 worktree で起票・再生成・commit を完了します。ID は乱数部分を持ち、曖昧文字(`I` / `L` / `O` / `U`)を除いた英大文字+数字の 32 文字セットによる 4 桁(例: `PJR-4B7K`)です。個票 Frontmatter が分類、処理状態、優先度、担当、日付、結論の正本であり、`register build` は個票から一覧と派生ビューを生成します。`register` 系コマンドはすべて、成功時の通常出力を標準出力へ、エラーメッセージを標準エラー出力へ書きます。
353
380
 
354
381
  主要オプション:
355
382
 
@@ -387,12 +414,14 @@ specdojo schedule strategy generate \
387
414
 
388
415
  `register update --topic <slug>` は個票のファイル名と Frontmatter の文書 ID を同時に変更し、`docs/ja` 配下の旧文書 ID 参照を更新してから生成ビューを再生成します。変更は `action: update` の event に文書 ID の変更として記録されます。形式は英小文字・数字・単一ハイフン区切りに限り、変更先ファイルが存在する場合は書き込み前に停止します。
389
416
 
390
- `register add --from <ID>` は、起票の元になった登録項目を個票 Frontmatter の `derived_from` へ記録します。`--from` は複数回指定でき、同じ project の項目は `PJR-XXXX`、別 project の項目は `<project-id>:PJR-XXXX` を使います。自己参照と存在しない項目は書き込み前に拒否します。別 project が設定にあれば存在も確認し、未設定なら書式だけを確認します。`register update --from <ID>` は一覧を置換し、`--from -` で削除します。`register build` は `generated/pjr-derived-items.md` を生成し、元の項目から派生先を逆引きできるようにします。decision から todo を起票するときも、この関係を追跡先として使います。
417
+ `register add --from <ID>` は、起票の元になった登録項目を個票 Frontmatter の `derived_from` へ記録します。`--from` は複数回指定でき、同じ project の項目は `PJR-XXXX`、別 project の項目は `<project-id>:PJR-XXXX` を使います。自己参照、未設定の project、存在しない項目は書き込み前に拒否します。別 project の項目は、その project の `integration_branch`(省略時は `project/<project-id>/develop`)の Git tree を読んで存在を確認します。`register update --from <ID>` は一覧を置換し、`--from -` で削除します。`register build` は `generated/pjr-derived-items.md` を生成し、元の項目から派生先を逆引きできるようにします。decision から todo を起票するときも、この関係を追跡先として使います。
391
418
 
392
419
  `register add --approach <approach> --target <doc-id>` は、個票 Frontmatter に進め方と対象を書きます。`approach` を指定すると対象は 1 件だけ必須です。成果物を作成・修正する進め方は成果物カタログにある文書を、`rulebook-maintenance` などの保守の進め方は名前に対応する kata 種別を対象にします。文書索引で解決できない ID、対象種別の不一致、複数対象との組み合わせは書き込み前に拒否します。`approach` を指定しない `--target` は複数回指定でき、従来どおり変更網羅検証の対象宣言として使えます。`register update` でも同じ検証を行います。
393
420
 
394
421
  記帳系コマンドの `--commit` は、register の worktree 実行と同じ project の `register lifecycle` 枠を取得してから、記帳、`register build` 相当の検証・派生ビュー再生成、pathspec を限定した commit を行います。commit 対象はコマンドが新たに変更した個票・event・参照文書だけで、開始前からあるほかの変更を含めません。対象個票・event・参照文書に開始前の未 commit 変更がある場合は、既存差分との混在を避けるため記帳前に停止します。既定件名は `docs(register PJR-XXXX): <command> <title>` で、`-m` / `--message` により上書きできます。`--dry-run --commit` は変更予定だけを表示し、枠の取得と commit は行いません。
395
422
 
423
+ 別 project への `register add` は `--commit` が必須です。対象 project の登録簿に未 commit 変更がある場合、または統合ブランチがローカルに存在しない場合は、何も書き込まず終了コード 1 で停止します。元の worktree とブランチは変更しません。`close`、`reject` など別 project の状態遷移は受け付けず、対象 project の worktree での実行を案内します。
424
+
396
425
  一覧・派生ビューの「登録日」「完了日」は、保存した日時を config の `run.register_date_timezone`(IANA タイムゾーン名、既定 `UTC`)へ変換して導出する表示値です。
397
426
 
398
427
  `register migrate` は旧形式の登録簿データを現行形式へ移す一度限りの移行コマンドです。追跡対象だった `pjr-index.md` の表を個票 Frontmatter へ移し、旧日時を UTC へ変換し、個票内の `register_events` を `events/pjr-XXXX.yaml` へ分離します。イベントがまだない項目は、利用可能な Git 履歴を項目別イベントファイルへ変換します。event ID は commit・項目 ID・変更内容から決定的に生成するため、再実行で重複しません。
@@ -83,11 +83,14 @@ SpecDojo Configuration Reference
83
83
 
84
84
  ## 4. projectの非パスキー
85
85
 
86
- | キー | 既定値 | 役割・利用箇所 |
87
- | ----------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
88
- | `project_context` | `["prj-overview"]` | edit / review plan へ常に渡す project 共通文書のローカル ID です。空配列 `[]` で無効化できます。`depends_on` や成果物の `based_on` は変更しません。 |
89
- | `run` | `{}` | agent 実行、worktree、登録日の表示に関する project 単位の設定です。 |
90
- | `repos` | なし | project のタスクが変更するプロダクトリポジトリの宣言です。詳細は「`repos`のキー」を参照してください。 |
86
+ | キー | 既定値 | 役割・利用箇所 |
87
+ | -------------------- | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
88
+ | `integration_branch` | `project/<project-id>/develop` | 別 project の作業ツリーから `register add --project <project-id> --commit` で直接記帳する統合ブランチです。 |
89
+ | `project_context` | `["prj-overview"]` | edit / review plan へ常に渡す project 共通文書のローカル ID です。空配列 `[]` で無効化できます。`depends_on` や成果物の `based_on` は変更しません。 |
90
+ | `run` | `{}` | agent 実行、worktree、登録日の表示に関する project 単位の設定です。 |
91
+ | `repos` | なし | project のタスクが変更するプロダクトリポジトリの宣言です。詳細は「`repos`のキー」を参照してください。 |
92
+
93
+ project の `integration_branch` は、`repos[].integration_branch` とは別の設定です。前者は project リポジトリ内の登録簿へ直接記帳するブランチ、後者は exec が各プロダクトリポジトリへ変更を統合するブランチを表します。指定した project の統合ブランチはローカルに存在していなければなりません。
91
94
 
92
95
  ## 5. `run`のキー
93
96
 
@@ -57,6 +57,11 @@ $defs:
57
57
  properties:
58
58
  base_path:
59
59
  type: string
60
+ integration_branch:
61
+ description: >-
62
+ Branch that receives direct project-register commits. Defaults to
63
+ project/<project-id>/develop.
64
+ $ref: "#/$defs/NonEmptyString"
60
65
  catalog_path:
61
66
  type: string
62
67
  schedule_path:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "specdojo",
3
- "version": "0.4.1",
3
+ "version": "0.4.2",
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",
@@ -103,7 +103,7 @@ members:
103
103
  roles: []
104
104
  type: agent
105
105
  provider: opencode
106
- model: ollama-local/gemma4:31b-mlx-work-64k
106
+ model: ollama-local/gemma4:31b
107
107
  mode: edit
108
108
  stage_role: executor
109
109
  capabilities: [web_search]
@@ -117,7 +117,7 @@ members:
117
117
  roles: []
118
118
  type: agent
119
119
  provider: opencode
120
- model: ollama-local/gemma4:31b-mlx-work-64k
120
+ model: ollama-local/gemma4:31b
121
121
  mode: review
122
122
  stage_role: executor
123
123
  capabilities: [web_search]
@@ -131,7 +131,7 @@ members:
131
131
  roles: []
132
132
  type: agent
133
133
  provider: opencode
134
- model: ollama-local/gemma4:31b-mlx-work-64k
134
+ model: ollama-local/gemma4:26b
135
135
  mode: report
136
136
  stage_role: reporter
137
137
  capabilities: []
@@ -0,0 +1,46 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { existsSync, lstatSync } from "node:fs";
3
+ import { join } from "node:path";
4
+
5
+ const repoRoot = process.cwd();
6
+ const gitEntry = join(repoRoot, ".git");
7
+ const lefthookCli = join(repoRoot, "node_modules", "lefthook", "bin", "index.js");
8
+
9
+ if (!existsSync(gitEntry) || !lstatSync(gitEntry).isDirectory()) {
10
+ process.stdout.write("Skipping lefthook install outside the primary Git worktree.\n");
11
+ process.exit(0);
12
+ }
13
+ if (!existsSync(lefthookCli)) {
14
+ process.stdout.write(
15
+ "Skipping lefthook install because node_modules/lefthook is unavailable. Run npm install first.\n",
16
+ );
17
+ process.exit(0);
18
+ }
19
+
20
+ const env = { ...process.env };
21
+ for (const name of [
22
+ "GIT_ALTERNATE_OBJECT_DIRECTORIES",
23
+ "GIT_COMMON_DIR",
24
+ "GIT_DIR",
25
+ "GIT_GRAFT_FILE",
26
+ "GIT_IMPLICIT_WORK_TREE",
27
+ "GIT_INDEX_FILE",
28
+ "GIT_NAMESPACE",
29
+ "GIT_NO_REPLACE_OBJECTS",
30
+ "GIT_OBJECT_DIRECTORY",
31
+ "GIT_PREFIX",
32
+ "GIT_QUARANTINE_PATH",
33
+ "GIT_REPLACE_REF_BASE",
34
+ "GIT_SHALLOW_FILE",
35
+ "GIT_WORK_TREE",
36
+ ]) {
37
+ delete env[name];
38
+ }
39
+
40
+ const result = spawnSync(process.execPath, [lefthookCli, "install"], {
41
+ cwd: repoRoot,
42
+ env,
43
+ stdio: "inherit",
44
+ });
45
+ if (result.error) throw result.error;
46
+ process.exit(result.status ?? 1);
@@ -0,0 +1,207 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { existsSync, readFileSync } from "node:fs";
3
+ import { createRequire } from "node:module";
4
+ import { join, posix } from "node:path";
5
+
6
+ const repoRoot = process.cwd();
7
+ const command = process.argv[2];
8
+ const files = process.argv.slice(3);
9
+
10
+ function cleanGitEnvironment() {
11
+ const env = { ...process.env };
12
+ for (const name of [
13
+ "GIT_ALTERNATE_OBJECT_DIRECTORIES",
14
+ "GIT_COMMON_DIR",
15
+ "GIT_DIR",
16
+ "GIT_GRAFT_FILE",
17
+ "GIT_IMPLICIT_WORK_TREE",
18
+ "GIT_INDEX_FILE",
19
+ "GIT_NAMESPACE",
20
+ "GIT_NO_REPLACE_OBJECTS",
21
+ "GIT_OBJECT_DIRECTORY",
22
+ "GIT_PREFIX",
23
+ "GIT_QUARANTINE_PATH",
24
+ "GIT_REPLACE_REF_BASE",
25
+ "GIT_SHALLOW_FILE",
26
+ "GIT_WORK_TREE",
27
+ ]) {
28
+ delete env[name];
29
+ }
30
+ return env;
31
+ }
32
+
33
+ function runNode(entry, args) {
34
+ if (!existsSync(entry)) {
35
+ process.stdout.write(`[specdojo-hook] skipped: ${entry} is unavailable; run npm install.\n`);
36
+ return 0;
37
+ }
38
+ const result = spawnSync(process.execPath, [entry, ...args], {
39
+ cwd: repoRoot,
40
+ env: cleanGitEnvironment(),
41
+ stdio: "inherit",
42
+ });
43
+ if (result.error) throw result.error;
44
+ return result.status ?? 1;
45
+ }
46
+
47
+ function stagedFiles() {
48
+ const result = spawnSync("git", ["diff", "--cached", "--name-only", "-z", "--diff-filter=ACMR"], {
49
+ cwd: repoRoot,
50
+ env: cleanGitEnvironment(),
51
+ encoding: "utf8",
52
+ });
53
+ if (result.error) throw result.error;
54
+ if (result.status !== 0) {
55
+ process.stderr.write(result.stderr || "Unable to inspect staged files.\n");
56
+ process.exit(result.status ?? 1);
57
+ }
58
+ return result.stdout
59
+ .split("\0")
60
+ .filter(Boolean)
61
+ .map((file) => file.replaceAll("\\", "/"));
62
+ }
63
+
64
+ function configuredProjects() {
65
+ const configPath = join(repoRoot, ".specdojo", "specdojo.config.json");
66
+ if (!existsSync(configPath)) return [];
67
+ const config = JSON.parse(readFileSync(configPath, "utf8"));
68
+ if (!config.projects || typeof config.projects !== "object") return [];
69
+ return Object.entries(config.projects).map(([id, project]) => ({ id, project }));
70
+ }
71
+
72
+ function configuredPath(project, key) {
73
+ const relativePath = typeof project[key] === "string" ? project[key].trim() : "";
74
+ if (!relativePath) return undefined;
75
+ const basePath = typeof project.base_path === "string" ? project.base_path.trim() : "";
76
+ return posix
77
+ .normalize(
78
+ basePath
79
+ ? `${basePath.replaceAll("\\", "/")}/${relativePath.replaceAll("\\", "/")}`
80
+ : relativePath.replaceAll("\\", "/"),
81
+ )
82
+ .replace(/^\.\//, "");
83
+ }
84
+
85
+ function isWithin(file, directory) {
86
+ return file === directory || file.startsWith(`${directory}/`);
87
+ }
88
+
89
+ function runSpecDojoForChangedProjects(key, args) {
90
+ const changed = stagedFiles();
91
+ const projects = configuredProjects().filter(({ project }) => {
92
+ const directory = configuredPath(project, key);
93
+ return directory && changed.some((file) => isWithin(file, directory));
94
+ });
95
+ if (projects.length === 0) return 0;
96
+ const specdojoCli = join(repoRoot, "node_modules", "specdojo", "dist", "specdojo.js");
97
+ for (const { id } of projects) {
98
+ const status = runNode(specdojoCli, [...args, "--project", id]);
99
+ if (status !== 0) return status;
100
+ }
101
+ return 0;
102
+ }
103
+
104
+ function getIgnoreModule() {
105
+ const tryPaths = [
106
+ join(repoRoot, "node_modules", "markdownlint-cli", "markdownlint.js"),
107
+ join(repoRoot, "package.json"),
108
+ ];
109
+ for (const candidatePath of tryPaths) {
110
+ if (existsSync(candidatePath)) {
111
+ try {
112
+ const req = createRequire(candidatePath);
113
+ return req("ignore");
114
+ } catch {
115
+ // Continue searching
116
+ }
117
+ }
118
+ }
119
+ return null;
120
+ }
121
+
122
+ function parseSimpleIgnore(content) {
123
+ const rules = content
124
+ .split(/\r?\n/)
125
+ .map((line) => line.trim())
126
+ .filter((line) => line && !line.startsWith("#"));
127
+
128
+ return (file) => {
129
+ const normalized = posix.normalize(file.replaceAll("\\", "/")).replace(/^\.\//, "");
130
+ for (const rule of rules) {
131
+ const isNegated = rule.startsWith("!");
132
+ const pattern = (isNegated ? rule.slice(1) : rule).replace(/^\.\//, "");
133
+ let matches = false;
134
+ if (pattern.endsWith("/")) {
135
+ matches = normalized === pattern.slice(0, -1) || normalized.startsWith(pattern);
136
+ } else {
137
+ matches =
138
+ normalized === pattern ||
139
+ normalized.endsWith(`/${pattern}`) ||
140
+ normalized.startsWith(`${pattern}/`);
141
+ }
142
+ if (matches) {
143
+ return !isNegated;
144
+ }
145
+ }
146
+ return false;
147
+ };
148
+ }
149
+
150
+ function getIgnoreFilter(ignoreFileName) {
151
+ const ignorePath = join(repoRoot, ignoreFileName);
152
+ if (!existsSync(ignorePath)) return () => false;
153
+ const content = readFileSync(ignorePath, "utf8");
154
+ const ignoreFactory = getIgnoreModule();
155
+ if (ignoreFactory) {
156
+ const ig = ignoreFactory().add(content);
157
+ return (file) => ig.ignores(posix.normalize(file.replaceAll("\\", "/")).replace(/^\.\//, ""));
158
+ }
159
+ return parseSimpleIgnore(content);
160
+ }
161
+
162
+ function filterFiles(candidateFiles, ignoreFileName) {
163
+ if (candidateFiles.length === 0) return [];
164
+ const isIgnored = getIgnoreFilter(ignoreFileName);
165
+ return candidateFiles.filter((file) => !isIgnored(file));
166
+ }
167
+
168
+ function isMarkdownFile(file) {
169
+ return /\.(md|markdown)$/i.test(file);
170
+ }
171
+
172
+ let status;
173
+ switch (command) {
174
+ case "prettier": {
175
+ const targetFiles = filterFiles(files, ".prettierignore");
176
+ status =
177
+ targetFiles.length === 0
178
+ ? 0
179
+ : runNode(join(repoRoot, "node_modules", "prettier", "bin", "prettier.cjs"), [
180
+ "--write",
181
+ "--",
182
+ ...targetFiles,
183
+ ]);
184
+ break;
185
+ }
186
+ case "markdownlint": {
187
+ const targetFiles = filterFiles(files.filter(isMarkdownFile), ".markdownlintignore");
188
+ status =
189
+ targetFiles.length === 0
190
+ ? 0
191
+ : runNode(join(repoRoot, "node_modules", "markdownlint-cli", "markdownlint.js"), [
192
+ "--",
193
+ ...targetFiles,
194
+ ]);
195
+ break;
196
+ }
197
+ case "register-build":
198
+ status = runSpecDojoForChangedProjects("project_register_path", ["register", "build"]);
199
+ break;
200
+ case "catalog-validate":
201
+ status = runSpecDojoForChangedProjects("catalog_path", ["catalog", "validate"]);
202
+ break;
203
+ default:
204
+ process.stderr.write(`Unknown SpecDojo hook command: ${command ?? "(missing)"}\n`);
205
+ status = 1;
206
+ }
207
+ process.exit(status);
@@ -42,7 +42,7 @@ specdojo exec scaffold --provider opencode
42
42
  report: { agent: opencode-reporter }
43
43
  ```
44
44
 
45
- 2. `.specdojo/agent-members.yaml` を実体と別名の 2 段で書く。実体は model の系統で名付け(`gemma-executor`・`qwen-executor` など)、`model` に `opencode.json` の provider 名を含む ID(`ollama-local/gemma4:31b-mlx-work-64k` など)を持つ。従来の名前(`opencode-executor` など)は `aliases` で実体を指す別名にする。
45
+ 2. `.specdojo/agent-members.yaml` を実体と別名の 2 段で書く。実体は model の系統で名付け(`gemma-executor`・`qwen-executor` など)、`model` に `opencode.json` の provider 名を含む ID(`ollama-local/gemma4:31b` や `ollama-local/gemma4:26b` など)を持つ。従来の名前(`opencode-executor` など)は `aliases` で実体を指す別名にする。
46
46
  3. モデル接続設定(`opencode.json` の provider / model)を利用環境に合わせて作成する。ローカル Ollama の接続先などマシン固有の値を含むため、このテンプレートには含めていない。
47
47
  4. コピーしたファイルをコミットする。worktree はコミット済み内容から作られるため、未コミットだと agent 実行時に設定が読めない。
48
48
 
@@ -50,6 +50,11 @@ specdojo exec scaffold --provider opencode
50
50
 
51
51
  - edit agent の `permission.edit` は既定で `docs/**`、`src/**`、`tests/**` を許可する。`permission.edit` / `permission.bash` のパターンは、利用プロジェクトの成果物・execution ディレクトリ配置に合わせて調整する。
52
52
  - 従来の `opencode run --agent {nickname}` と model を持つ定義ファイルで組んだ 1 段の名簿は、そのまま動く。scaffold は既存ファイルを上書きしないため、`--force` で役割ごとの定義(model を持たない)に置き換える場合だけ、上の `command_template` と 2 段の名簿へ移す。
53
+ - 文脈の長さ(`num_ctx` など)を広げたい場合は、Modelfile(`FROM gemma4:31b`、`PARAMETER num_ctx 65536` など)を用意して Ollama で別タグを作成し(`ollama create gemma4:31b-work-64k -f Modelfile` など)、`.specdojo/agent-members.yaml` の各 member の `model` をそのタグ名へ書き換えます。
54
+ - `specdojo init` や `config scaffold` は既存の `.specdojo/agent-members.yaml` を上書きしません。既に導入したプロジェクトで reporter を 26b に変えたい場合は、`.specdojo/agent-members.yaml` の `gemma-reporter` の `model` を `ollama-local/gemma4:26b`(または独自タグ)へ直接書き換えてください。
55
+ - Mac の Apple シリコンでは、Ollama の公式の mlx 版(`gemma4:26b-mlx`・`gemma4:31b-mlx`)を `ollama pull` で取得して使えます。
56
+ - 使う場合は `.specdojo/agent-members.yaml` の `model` を `ollama-local/gemma4:26b-mlx` などに書き換えてください。Modelfile で文脈を広げる場合は `FROM` に mlx 版のタグを書きます。
57
+ - 既定の雛形は環境を選ばない無印のタグ(`gemma4:26b`・`gemma4:31b`)のままとします。
53
58
  - executor の result パス deny と reporter の全ツール deny は、pipeline の責務境界なので維持する。
54
59
  - `bash` は deny 基点の許可リストを維持する。`git add` / `git commit` を許可しないこと(許可すると specdojo CLI の commit 許可リストを迂回できる)。
55
60
  - 権限設計の背景は `exec-config-guide.md` の `agent 権限とプロンプトインジェクション対策` を参照する。
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  description: SpecDojo 対話型オーケストレーター。会話から意図を読み取り、specdojo register / exec などを提案→承認→実行で代行する。
3
3
  mode: primary
4
- model: ollama-local/gemma4:31b-mlx-work-64k
4
+ model: ollama-local/gemma4:31b
5
5
  temperature: 0.2
6
6
  permission:
7
7
  read:
File without changes