@infodb/p3 0.9.0 → 0.11.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 (65) hide show
  1. package/README.md +5 -2
  2. package/dist/web/assets/{Outputs-CQi0oba1.js → Outputs-ddwte0jj.js} +1 -1
  3. package/dist/web/assets/{RequestStatus-grC0F_SQ.js → RequestStatus-Bg1OLbRc.js} +1 -1
  4. package/dist/web/assets/{Tabs-BJRGzidj.js → Tabs-DTmggzgg.js} +1 -1
  5. package/dist/web/assets/{TagInput-cIIwXAHA.js → TagInput-BHAgjLP7.js} +1 -1
  6. package/dist/web/assets/{TaskDrawer-CSZ7Z0JC.js → TaskDrawer-Dz_5c2NH.js} +1 -1
  7. package/dist/web/assets/{_requestId-Z3CBhTIL.js → _requestId-D9-gtIcG.js} +1 -1
  8. package/dist/web/assets/_requestId-DzCNYvqf.js +30 -0
  9. package/dist/web/assets/{appCtx-DCiGJFAe.js → appCtx-Cm24VpAf.js} +1 -1
  10. package/dist/web/assets/{board-DyfGX5h0.js → board-MCHcZ-PU.js} +1 -1
  11. package/dist/web/assets/{directTask-Dk3H5Q2B.js → directTask-C1NWDkZp.js} +1 -1
  12. package/dist/web/assets/{done-Bhxqy7bH.js → done-zq10Bt08.js} +1 -1
  13. package/dist/web/assets/{index-Bt13tvIX.js → index-Ce0ndpne.js} +3 -3
  14. package/dist/web/assets/index-D68mkSnw.css +2 -0
  15. package/dist/web/assets/{new-BRsIUNIb.js → new-9TKiNT4O.js} +1 -1
  16. package/dist/web/assets/{preload-helper-B40dBmwL.js → preload-helper-FBLw7u7x.js} +1 -1
  17. package/dist/web/assets/release-notes-hK5XezLW.js +5 -0
  18. package/dist/web/assets/{requestData-w6fhCYmh.js → requestData-BnN7mctX.js} +1 -1
  19. package/dist/web/assets/{routes-QNgQHe48.js → routes-usHwrrA0.js} +1 -1
  20. package/dist/web/assets/{settings-CoKJahEe.js → settings-BVZDnL6O.js} +1 -1
  21. package/dist/web/index.html +4 -4
  22. package/docs/architecture.md +151 -8
  23. package/docs/development.md +19 -9
  24. package/docs/how-to-use.md +128 -7
  25. package/docs/installation.md +26 -10
  26. package/docs/publishing.md +5 -1
  27. package/lib/cli/args.js +2 -0
  28. package/lib/cli/help.js +14 -2
  29. package/lib/cli/main.js +28 -5
  30. package/lib/cli/preflightCommands.js +30 -7
  31. package/lib/cli/project.js +31 -9
  32. package/lib/cli/requestCommands.js +207 -14
  33. package/lib/core/context.js +4 -1
  34. package/lib/core/milestoneReview/code.js +129 -0
  35. package/lib/core/milestoneReview/material.js +138 -0
  36. package/lib/core/milestoneReview/mockReviewer.js +27 -0
  37. package/lib/core/milestoneReview/review.js +261 -0
  38. package/lib/core/milestoneReview/service.js +278 -0
  39. package/lib/core/milestoneReview/store.js +226 -0
  40. package/lib/core/preflight/codexEngine.js +75 -17
  41. package/lib/core/preflight/codexImage.js +49 -19
  42. package/lib/core/preflight/docker.js +149 -0
  43. package/lib/core/preflight/owner.js +118 -0
  44. package/lib/core/preflight/render-image/Dockerfile +1 -1
  45. package/lib/core/preflight/service.js +235 -16
  46. package/lib/core/projectRegistry.js +5 -4
  47. package/lib/core/requestOps.js +4 -0
  48. package/lib/core/store/dataWatcher.js +122 -0
  49. package/lib/core/store/normalize.js +36 -2
  50. package/lib/core/store/preflightStore.js +20 -2
  51. package/lib/core/store/projectFile.js +14 -2
  52. package/lib/core/store/workspace.js +102 -41
  53. package/lib/server/api/manifest.js +29 -2
  54. package/lib/server/api/milestoneReviewRoutes.js +69 -0
  55. package/lib/server/api/routes.js +37 -8
  56. package/lib/server/server.js +5 -3
  57. package/lib/shared/directTask.js +2 -2
  58. package/lib/shared/milestoneGoals.js +57 -0
  59. package/lib/shared/milestoneReview.js +26 -0
  60. package/lib/shared/preflightRunner.js +18 -0
  61. package/package.json +2 -2
  62. package/skills/p3/SKILL.md +29 -17
  63. package/dist/web/assets/_requestId-C8WYk2kC.js +0 -30
  64. package/dist/web/assets/index-BF1xMdJo.css +0 -2
  65. package/dist/web/assets/release-notes-C3FdiM36.js +0 -3
@@ -15,7 +15,7 @@ Docker と ChatGPT の接続が要るのは Preflight(Codex)・リリース
15
15
 
16
16
  | # | すること | 終わったと分かる目安 |
17
17
  | --- | --- | --- |
18
- | 1 | 必要なものをそろえる | `node -v` が 22 以上、`git --version`、`docker version` が通る |
18
+ | 1 | 必要なものをそろえる | `node -v` が 24 以上(推奨 26)、`git --version`、`docker version` が通る |
19
19
  | 2 | どこで P3 を動かすか決める(ホスト / DevContainer) | 下の「動かす場所」のどちらかに当てはまる |
20
20
  | 3 | Docker に繋がるか確かめる | `docker version` に **Client と Server の両方** が出る |
21
21
  | 4 | プロジェクトを作る(か参加する) | `p3 whoami` にプロジェクトとデータのフォルダが出る |
@@ -30,14 +30,19 @@ P3 を Docker のコンテナで動かす(プロジェクトを跨ぐ serve
30
30
 
31
31
  | もの | 何に使う | 確かめ方 |
32
32
  | --- | --- | --- |
33
- | Node.js 22 以上 | P3 本体(CLI と `p3 serve`) | `node -v` |
33
+ | Node.js 24 以上(推奨 26) | P3 本体(CLI と `p3 serve`) | `node -v` |
34
34
  | pnpm(`pnpx`)か npm(`npx`) | P3 を入れずに動かす。`pnpm add -g @infodb/p3` / `npm i -g @infodb/p3` で `p3` コマンドにしてもよい | `pnpm -v` / `npm -v` |
35
35
  | Git | 管理したいリポジトリと、要望ごとのブランチ。Preflight の Codex も履歴を読む | `git --version` |
36
36
  | Docker(CLI とデーモン) | Preflight の Codex を、リポジトリとデータのフォルダだけを見せたコンテナの中で動かす。画面イメージの描画にも使う | `docker version`(下の 3.) |
37
37
  | ChatGPT のアカウント(プラン) | Preflight の Codex をその人のアカウントで動かす | 6. で接続する |
38
38
 
39
39
  - Codex をこのマシンに入れる必要はない(コンテナのイメージに入れる)。画面はビルド済みのものが入っているので、ビルドも要らない
40
- - P3 そのものを開発するときは Node 24 を使う([開発ガイド](development.md))。使うだけなら 22 以上でよい
40
+ - P3 そのものを開発するときと、Docker のイメージ(`tamuto/p3`・描画のイメージ)は Node 26 を使う([開発ガイド](development.md))。
41
+ 使うだけなら 24 以上でよい
42
+ - **Node 22 から上げるとき**: Node 22 はサポートの終わり(2027-04-30)が近いので、この版から P3 は Node 24 以上で動かす(`engines` は
43
+ `>=24`)。Node 22 のままでも止められるとは限らない: npm は入れるときに警告(`EBADENGINE`)を出して入れ、`engine-strict=true`
44
+ なら断る。pnpm(12.10 で確かめた)と `pnpx` は警告を出さずに入れて動かす。`node -v` を確かめ、24 以上(推奨 26)に上げてから入れ直す。Docker で動かしているなら、新しいイメージを `docker pull` してコンテナを作り直す
45
+ (起動し直すだけでは前のイメージの Node のまま)
41
46
  - 以下の例では `p3` と書く。入れていなければ `pnpx @infodb/p3`(または `npx @infodb/p3`)に読み替える
42
47
  - 同じデータを使う人と AI は、なるべく同じ版で動かす(`pnpx @infodb/p3@<版>` のように版を付けられる。`pnpx` は取った版をしばらく
43
48
  使い続ける)。古い版で更新すると、新しい版で足した項目が消えることがある([データの形](architecture.md#データの形))
@@ -95,12 +100,16 @@ p3 init --agents
95
100
  # 何を作っているプロジェクトか(Preflight の前提になります): 社内向けの経費精算アプリ
96
101
  # 最初に読むドキュメント(カンマ区切り。Preflight が評価の前に読みます) [docs, README.md]:
97
102
  # Preflight で重視する観点・制約(任意): 個人情報を扱う変更は必ずリスクに挙げる
103
+ # Preflight を実行するのは(codex: 人が p3 から Codex で実行 / agent: 頼まれた手元の AI エージェントが評価) [codex]:
98
104
 
99
105
  # AI やスクリプトからは引数で(--yes で質問しない。--dir を付けなければリポジトリのルートの .p3)
100
106
  p3 init --yes --agents --project myapp --description "社内向けの経費精算アプリ"
101
107
 
102
108
  # リポジトリの外に置くなら --dir で指定する
103
109
  p3 init --yes --agents --project myapp --dir ~/p3-data/myapp --description "社内向けの経費精算アプリ"
110
+
111
+ # Codex(ChatGPT のプラン)を使わず、Claude Code などの手元のエージェントに Preflight を頼むなら
112
+ p3 init --yes --agents claude --project myapp --preflight-runner agent --description "社内向けの経費精算アプリ"
104
113
  ```
105
114
 
106
115
  - データのフォルダには `project.yaml` と空の `requests/` ができる。このリポジトリは **本体の参照先**(Preflight が読むリポジトリ。
@@ -113,6 +122,11 @@ p3 init --yes --agents --project myapp --dir ~/p3-data/myapp --description "社
113
122
  (値を省くと both。付けなければ置かない。対話では聞き、Enter は置かない)。置いたファイルはリポジトリに入れて共有する。
114
123
  作った後から置く・最新にするのは `p3 agents`([使い方ガイド](how-to-use.md) の「AI エージェントから使う」。`init --agents` を
115
124
  既にあるプロジェクトで実行し直しても置かない)
125
+ - **Preflight の担当**(`preflight.runner`。共有の設定)を決める。`codex`(既定。Enter と `--yes` もこれ)は人が `p3 preflight` や
126
+ 画面から実行し、Codex が評価する(6. と 7. が要る)。`agent` は Codex を使えない環境(Codex を準備していない・ChatGPT のプランが
127
+ 無い)向けで、人がチャットで「Preflight して」と頼むと手元の AI エージェントが評価する(6. と 7. は要らない。画面イメージの描画
128
+ だけ Docker を使う)。後から `p3 config set preflight.runner=agent|codex` で変えられる([使い方ガイド](how-to-use.md) の
129
+ 「プロジェクトの設定」)
116
130
  - 登録はこのマシンの **個人設定**(`~/.config/infodb-p3/config.yaml`。`XDG_CONFIG_HOME` があればその下。共有しない)に入る
117
131
 
118
132
  ### 参加する(ほかの人が作ったプロジェクト)
@@ -133,7 +147,7 @@ p3 join --project myapp --dir ~/p3-data/myapp # リポジトリの外の
133
147
  決まらなければ登録せず、`p3 repo ls` と `p3 repo path <名前> <パス>` を案内する
134
148
  - データのフォルダが無い・`project.yaml` が無い・壊れている・読めないときは、理由を出して止まり、何も登録しない(作りもしない。
135
149
  新しく作るなら `init`)。同じ名前で別のフォルダは断る。同じ参加をもう一度しても何も変えない
136
- - `--agents` と、作るときだけの項目(`--name`・`--description`・`--instructions`)は使えない(共有の定義を変えるなら `p3 config set`)
150
+ - `--agents` と、作るときだけの項目(`--name`・`--description`・`--instructions`・`--preflight-runner`)は使えない(共有の定義を変えるなら `p3 config set`)
137
151
 
138
152
  確かめる:
139
153
 
@@ -144,6 +158,7 @@ p3 whoami
144
158
  # 今いる参照先 myapp ブランチ main
145
159
  # 変更者 human:<git の user.name>
146
160
  # 要望 (なし)
161
+ # Preflight codex(人が p3 から実行する(Codex))
147
162
  ```
148
163
 
149
164
  プロジェクトが決まらないと、登録済みの一覧と選び方(`--project <名前>`)が出る。リポジトリの外で使うときや、複数のプロジェクトに
@@ -272,6 +287,7 @@ CLI の出力に、Preflight を通さずにタスクを作る道も出る。直
272
287
  | 〃 | `permission denied ... docker.sock` | `ls -l /var/run/docker.sock` | `docker` グループなど、ソケットの権限を直す |
273
288
  | Preflight | `bind source path does not exist: <参照先 …>` / `<データ>` | ログの「パスの対応」、`p3 user-config` の `codex.pathMap`、5-1. の `docker inspect` | `p3 user-config set codex.pathMap+=<このマシンのパス>=<ホストのパス>`。「対応あり」なのに無いなら、右側(ホストのパス)の誤り。serve はそのままで次の Preflight から効く |
274
289
  | Preflight | 「Codex のイメージを用意できません(app-server を起こす前)」 | `p3 codex update` の出力 | ネットワーク(プロキシ)を確かめて `p3 codex update` をやり直す。`Unable to find image` も同じ |
290
+ | Preflight | 「〜が 60 秒で終わらないので止めました」(イメージの確認 15 秒・版の確認 60 秒・ビルド 10 分) | `docker ps -a --filter label=infodb.p3`(P3 が起こしたコンテナ) | P3 はそのコンテナを消してから終わる。Docker が重い・止まっていないかを確かめてやり直す。「コンテナ p3-… を消せませんでした(残っているかもしれません)」と出たら、出ている `docker rm -f <名前>` で消す |
275
291
  | Preflight・画面 | 「ChatGPT にサインインしてください」「ChatGPT の接続が切れています」「プランの利用が許可されていません」 | `p3 chatgpt status` | `p3 chatgpt login`(届かなければ `--paste`)。プランの利用に同意する |
276
292
  | Preflight | 「Usage limit reached」 | ChatGPT の Manage usage(https://chatgpt.com/settings/usage) | 上限が戻るのを待つ |
277
293
  | Preflight・画面 | 個人設定を読めない(YAML の行と直すファイル) | `~/.config/infodb-p3/config.yaml` | 書き間違いを直す。serve はそのままで次の Preflight から効く |
@@ -305,13 +321,13 @@ P3 をイメージにして、コンテナで動かすこともできる。イ
305
321
  --host 0.0.0.0`)で、個人設定に登録したプロジェクトを画面で選んで扱う([使い方ガイド](how-to-use.md#画面))。閲覧専用ではなく、
306
322
  要望・タスクの作成と編集・添付・Preflight もいつもどおり使える。
307
323
 
308
- イメージは Docker Hub の **`tamuto/p3`**。中に p3 本体(npm の `@infodb/p3` と同じ版・同じ中身)と、Node 22・git・Docker の CLI が
309
- 入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.9.0` など)と
324
+ イメージは Docker Hub の **`tamuto/p3`**。中に p3 本体(npm の `@infodb/p3` と同じ版・同じ中身)と、Node 26・git・Docker の CLI が
325
+ 入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.11.0` など)と
310
326
  `latest` がある。決まった版で使うなら版のタグを指す。対応する platform は `linux/amd64` だけ(arm64 は確かめるマシンが無いので
311
327
  作っていない)。
312
328
 
313
329
  ```bash
314
- docker pull tamuto/p3:0.9.0
330
+ docker pull tamuto/p3:0.11.0
315
331
  ```
316
332
 
317
333
  リポジトリから作るときは `docker build --pull -t tamuto/p3:dev .`(`--pull` で今の Node のベースを取る。[開発ガイド](development.md#docker-のイメージ))。
@@ -332,7 +348,7 @@ root で動く開発コンテナ(DevContainer など)で p3 の CLI を使
332
348
  # 開発コンテナの compose に足す例(パスは開発コンテナのマウントに合わせる)
333
349
  services:
334
350
  p3:
335
- image: tamuto/p3:0.9.0
351
+ image: tamuto/p3:0.11.0
336
352
  restart: unless-stopped
337
353
  ports:
338
354
  - "127.0.0.1:4310:4310"
@@ -356,7 +372,7 @@ docker run -d --name p3 --restart unless-stopped \
356
372
  -v ~/.config/infodb-p3:/root/.config/infodb-p3 \
357
373
  -v /home/me/work:/home/me/work \
358
374
  -v /var/run/docker.sock:/var/run/docker.sock \
359
- tamuto/p3:0.9.0
375
+ tamuto/p3:0.11.0
360
376
 
361
377
  # 登録が無ければ、コンテナの中で登録する(既にあるデータに参加する。新しく作るなら p3 init)
362
378
  docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
@@ -369,7 +385,7 @@ docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
369
385
  ### どちらでも
370
386
 
371
387
  - 待ち受けは `127.0.0.1` に公開する。ブラウザで http://localhost:4310 を開く。登録が1つならそのプロジェクトが開き、複数なら一覧から選ぶ
372
- - **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.9.0 serve --project myapp --host 0.0.0.0`。compose なら
388
+ - **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.11.0 serve --project myapp --host 0.0.0.0`。compose なら
373
389
  `command:`)。明示しない限り、コンテナの中かどうかで自動では切り替えない
374
390
  - **止める**: `docker stop p3`(SIGTERM。実行中の Preflight・生成を取り消して記録してから止まる。10 秒まで待つ)
375
391
  - **新しい版にする**: 版のタグを変えて作り直す(個人設定と接続はマウントした ~/.config、データはホストに残る)。
@@ -30,7 +30,11 @@ node scripts/verify-pack.mjs --docker # npm pack → 実行時の依存だ
30
30
  - [ ] 全段が `ok`。確かめる段: Node の版と engines / tarball の中身 / `npm install`(開発用の依存が入らない)/
31
31
  別のリポジトリで `init --agents`・`init --agents codex` と `p3 agents`(後から足す・`--force`)・`whoami`・要望の作成・Mock の Preflight・メモを足した再評価・`serve`(画面・資産・API)/
32
32
  `codex update`(`--docker`。未登録・未認証のまま本物の Docker でイメージを作り直し、版を読む)
33
- - [ ] 下限の Node でも通す: `PATH=$(dirname $(npx -y node@22.0.0 -e "console.log(process.execPath)")):$PATH node scripts/verify-pack.mjs`
33
+ - [ ] 下限の Node(24.0.0)でも、作った tarball で通す(開発用の依存のインストールとビルドは下限の版で要らない):
34
+ `PATH=$(dirname $(npx -y node@24.0.0 -e "console.log(process.execPath)")):$PATH node scripts/verify-pack.mjs --tgz <作った tarball>`
35
+ - [ ] Node の下限を上げた版を出すときは、リリースノートに知らせる: 前の下限の Node では、npm は警告を出して入れ(`engine-strict` なら断る)、
36
+ pnpm・`pnpx` は警告を出さずに入れる(止められない)ので、利用者が `node -v` を確かめること、
37
+ Node を上げて入れ直すこと、Docker のイメージは pull してコンテナを作り直すこと(Node 22 → 24 以上は [導入ガイド](installation.md) の「Node 22 から上げるとき」)
34
38
  - [ ] Docker が無い環境で確かめたときは、`codex update` の段が「実行していない」と出る。その場合は Docker のある環境で
35
39
  `--docker` を付けて通すまで、公開に進まない
36
40
 
package/lib/cli/args.js CHANGED
@@ -46,11 +46,13 @@ const OPTIONS = {
46
46
  repo: { type: "string" },
47
47
  description: { type: "string" },
48
48
  instructions: { type: "string" },
49
+ "preflight-runner": { type: "string" },
49
50
  // 値なしの --agents は both(joinValues が --agents=both にする)
50
51
  agents: { type: "string" },
51
52
  force: { type: "boolean" },
52
53
  "note-only": { type: "boolean" },
53
54
  prepare: { type: "boolean" },
55
+ "acknowledge-stopped": { type: "boolean" },
54
56
  complete: { type: "boolean" },
55
57
  cancel: { type: "boolean" },
56
58
  "archive-superseded": { type: "boolean" },
package/lib/cli/help.js CHANGED
@@ -9,13 +9,15 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
9
9
  このリポジトリを本体の参照先として登録する。データの既定はリポジトリのルートの .p3(既にあれば作らずに断る → join)
10
10
  --project 名前 --dir フォルダ(外に置くとき。相対は今いる場所から)--repo-name 参照先の名前(既定はフォルダ名)--description
11
11
  --instructions 観点 --yes
12
+ --preflight-runner codex|agent Preflight の担当(既定 codex: 人が p3 から Codex で実行 / agent: 頼まれた手元の AI エージェントが評価)
12
13
  --agents claude|codex|both AI 向けの使い方(スキルと AGENTS.md / CLAUDE.md の節)を置く先(値を省くと both。付けなければ置かない)
13
14
  agents claude|codex|both [--force] AI 向けの使い方を、今いるリポジトリに後から置く・最新にする(選んだ先だけ。データ・個人設定は変えない)
14
15
  違うものは上書きせず知らせる。--force で選んだ先のスキルと p3 の節だけを同梱の版にする(ほかの文は残す)
15
16
  join 既にあるプロジェクト(共有されたデータのフォルダ)に参加する。個人設定に登録するだけで、データ・リポジトリのファイルは変えない
16
17
  --project 名前 --dir フォルダ(既定はリポジトリのルートの .p3)--repo-name 参照先の名前(共有の定義にあるもの)--yes
17
18
  project [ls | add <名前> <フォルダ> | rm <名前>] 個人設定のプロジェクト
18
- config [set キー=値 ...] 設定の表示・変更(name description branchPattern instructions)
19
+ config [set キー=値 ...] 設定の表示・変更(name description branchPattern instructions preflight.runner)
20
+ preflight.runner=codex|agent Preflight の担当(共有。未設定は codex。p3 preflight の動きは変えず、AI 向けの手順が whoami で読む)
19
21
  repo [ls | add | set | path | rm] Preflight が読む参照先(リポジトリ・フォルダ。数と名前は自由)
20
22
  add <名前> [<パス>] [role=… readFirst=true writable=true] 共有の定義を足す
21
23
  set <名前> キー=値 … 共有の定義を変える / path <名前> <パス> このマシンのパスだけ登録
@@ -27,6 +29,13 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
27
29
  set codex.pathMap-=<このマシンのパス> 外す(codex.pathMap= で全部外す)
28
30
  progress 要望ごとの進捗(マイルストーンごと。--all で完了・見送りも。既定でも対応済を出す)
29
31
  milestone [ls | add <id> | set <id> | rm <id>] マイルストーン(リリース) --title 名前 --due YYYY-MM-DD --done
32
+ milestone show <id> 目的・予定している機能と版(--json の milestonesVersion)
33
+ milestone purpose <id> 目的を保存する --body 本文|- / --file 目的.md / --off(外す)
34
+ milestone goal add <id> <文> 予定機能を足す(ID は G1, G2, ... を振り、振り直さない)。goal set <id> <G番号> <文> / goal rm <id> <G番号>
35
+ マイルストーンの変更はどれも --version <版> を付けると、その版から変わっていれば競合(終了コード 3)
36
+ milestone review <id> 目的・予定機能に対して参照先のコードと履歴を確かめるレビューを Codex で実行して待つ(記録する。--engine codex|mock。Ctrl-C で取消)
37
+ milestone reviews <id> レビューの履歴 / review-show <id> <run> 1回分 / review-cancel <id> <run> 取消
38
+ (所有者を確かめられない run は --acknowledge-stopped で中断。無い → 2、実行中・終わっている → 3)
30
39
  release-notes [ls] マイルストーンごとのリリースノートの有無と要望の数
31
40
  release-notes show <id> 保存したノート(本文・版)と、対象の要望(収録 / 対象外)・警告(未完了・記録なし など)
32
41
  release-notes generate <id> 変更の記録から機能の要約を Codex で生成し、本文の案を stdout に出す(保存しない。進み具合と出典は stderr。
@@ -88,7 +97,10 @@ Preflight
88
97
  preflight [<要望>] --prepare 手元の対話エージェント(Claude Code など)で評価する準備。モデルは呼ばない。評価対象を固定し、
89
98
  指示のファイル(instructions.md)と成果物のパス・run の ID を返して終わる(--note も使える)
90
99
  preflight [<要望>] --complete --run PF-... エージェントが書いた成果物を確かめて取り込む(問題があれば何も確定せず、直してやり直せる)
91
- preflight [<要望>] --cancel --run PF-... 評価を待つ run をやめる(待っている間は同じ要望の Preflight を始められない)
100
+ preflight [<要望>] --cancel --run PF-... run を中断する(最新でなくてもよい。手元のエージェントの run は評価を待つのをやめる。
101
+ Codex / Mock の run は、動いているプロセスに中断を頼み、止まるまで少し待つ。止まらなければ requested)
102
+ --acknowledge-stopped 動いているか確かめられない run(以前の版・別の環境)を、止まっていることを確かめて中断にする
103
+ (記録だけ。プロセスやコンテナは止めない)
92
104
  notes [<要望>] メモの一覧(次の Preflight に渡すもの・渡し済み)
93
105
  attach [ls] 要望の添付(PNG / JPEG / xlsx)の一覧。要望は --req(要望の作業ツリーの中なら省略可)
94
106
  attach add <ファイル> 添付を足す --description 説明 --source 出典。次の Preflight を始めるときに run に固定して渡す
package/lib/cli/main.js CHANGED
@@ -4,6 +4,9 @@ import { openProject } from "../core/context.js";
4
4
  import { machineSettingsSource, resolveMachineSettings, SettingsError } from "../core/machineSettings.js";
5
5
  import { progress, resolveRef, resolveRequestId, titleOf } from "../core/ops.js";
6
6
  import { OpRuleError } from "../core/requestOps.js";
7
+ import { MilestonesConflictError, ProjectInputError } from "../core/store/workspace.js";
8
+ import { ReviewCancelRefused, ReviewRejected } from "../core/milestoneReview/service.js";
9
+ import { ReviewStoreError } from "../core/milestoneReview/store.js";
7
10
  import { HierarchyError } from "../core/hierarchy.js";
8
11
  import { startServer } from "../server/server.js";
9
12
  import { ConflictError, NotFoundError } from "../core/store/collection.js";
@@ -13,7 +16,7 @@ import { codexCommand } from "./codex.js";
13
16
  import { userConfigCommand } from "./userConfig.js";
14
17
  import { chatgptCommand } from "./chatgpt.js";
15
18
  import { table } from "./format.js";
16
- import { config, currentRequest, init, isAgentChoice, joinProject, locateHere, placeAgents, projectCommand, repoCommand, repoRoot, resolveActor, UsageError } from "./project.js";
19
+ import { config, currentRequest, init, isAgentChoice, joinProject, locateHere, placeAgents, projectCommand, repoCommand, repoRoot, resolveActor, runnerText, UsageError } from "./project.js";
17
20
  import { HELP } from "./help.js";
18
21
  import { readsOnly } from "./readOnly.js";
19
22
  import { parse } from "./args.js";
@@ -24,6 +27,7 @@ import { preflightCommand } from "./preflightCommands.js";
24
27
  import { releaseNotesCommand } from "./releaseNotesCommands.js";
25
28
  import { ReleaseNoteError } from "../core/releaseNotes/store.js";
26
29
  import { sortMilestones } from "../shared/milestoneOrder.js";
30
+ import { isPreflightRunner, PREFLIGHT_RUNNERS, runnerView } from "../shared/preflightRunner.js";
27
31
  import { GenerationRejected } from "../core/releaseNotes/generate.js";
28
32
  /**
29
33
  * p3 CLI。人も AI エージェントも使う。
@@ -109,7 +113,7 @@ async function main(argv) {
109
113
  // 参加は個人設定に登録するだけ。AI 向けのファイルと、作るときだけの項目は受け付けない(黙って無視しない)
110
114
  if (o.agents !== undefined)
111
115
  throw new UsageError("join は AI 向けのファイルを置きません(--agents は使えません)。置く・最新にするなら p3 agents claude|codex|both");
112
- const createOnly = ["name", "description", "instructions"].filter((k) => o[k] !== undefined);
116
+ const createOnly = ["name", "description", "instructions", "preflight-runner"].filter((k) => o[k] !== undefined);
113
117
  if (createOnly.length)
114
118
  throw new UsageError(`join では ${createOnly.map((k) => `--${k}`).join("・")} は使えません(共有の定義は変えません。変えるなら p3 config set)`);
115
119
  if (args.length)
@@ -122,6 +126,9 @@ async function main(argv) {
122
126
  throw new UsageError(`--agents は claude / codex / both のどれか(値を省くと both): ${o.agents || "(空)"}`);
123
127
  if (args.length)
124
128
  throw new UsageError(`init は位置引数を取りません: ${args.join(" ")}`);
129
+ const runner = o["preflight-runner"];
130
+ if (runner !== undefined && !isPreflightRunner(runner))
131
+ throw new UsageError(`--preflight-runner は ${PREFLIGHT_RUNNERS.join(" / ")} のどれか: ${runner || "(空)"}`);
125
132
  console.log(await init({
126
133
  cwd,
127
134
  project: o.project,
@@ -129,6 +136,7 @@ async function main(argv) {
129
136
  name: o.name,
130
137
  description: o.description,
131
138
  instructions: o.instructions,
139
+ runner,
132
140
  agents: o.agents,
133
141
  yes: o.yes,
134
142
  repoName: o["repo-name"],
@@ -231,12 +239,16 @@ async function main(argv) {
231
239
  }
232
240
  case "whoami": {
233
241
  const here = locateHere(ctx, cwd);
234
- return out.result({ project: target.name ?? null, dataDir: target.dataDir, via: target.via, here: here.repos, branch: here.branch ?? null, actor, request: current ?? null }, () => [
242
+ // Preflight の担当(AI 向けの手順が読む。読めなければ runner: null と problem。agent と推測しない)
243
+ const pf = runnerView(ctx.ws.project.preflight);
244
+ const preflight = { runner: pf.runner, source: pf.source, ...(pf.problem ? { problem: pf.problem } : {}) };
245
+ return out.result({ project: target.name ?? null, dataDir: target.dataDir, via: target.via, here: here.repos, branch: here.branch ?? null, actor, request: current ?? null, preflight }, () => [
235
246
  `プロジェクト ${target.name ?? "(未登録)"} ${target.dataDir}`,
236
247
  `決まり方 ${target.via}(${VIA_LABEL[target.via]})`,
237
248
  `今いる参照先 ${here.repos.length ? here.repos.join(", ") : "(どの参照先の中でもない。p3 repo ls)"}${here.branch ? ` ブランチ ${here.branch}` : ""}`,
238
249
  `変更者 ${actor}`,
239
250
  `要望 ${current ? `${current} ${titleOf(ctx, current)}` : "(なし)"}`,
251
+ `Preflight ${runnerText(pf)}`,
240
252
  ].join("\n"));
241
253
  }
242
254
  case "progress": {
@@ -273,7 +285,7 @@ async function main(argv) {
273
285
  }
274
286
  case "milestone":
275
287
  case "milestones":
276
- return milestoneCommand(ctx, out, args, o);
288
+ return milestoneCommand(ctx, out, args, o, actor);
277
289
  case "release-notes":
278
290
  case "release-note":
279
291
  return releaseNotesCommand(env);
@@ -318,10 +330,21 @@ main(process.argv.slice(2)).then((code) => process.exit(code), (e) => {
318
330
  const changedSet = e.code === "child_order_invalid" && (e.detail.reason === "not_child" || e.detail.reason === "missing");
319
331
  process.exit(e.code === "hierarchy_busy" || changedSet ? 3 : 1);
320
332
  }
333
+ // マイルストーンレビュー: 無い → 2、実行中・終わっている・動いている所有者がいる → 3、ほか(目的が無い・上限・ID・読めない)→ 1
334
+ if (e instanceof ReviewRejected || e instanceof ReviewStoreError || e instanceof ReviewCancelRefused) {
335
+ process.stderr.write(`${e.message}\n`);
336
+ const code = e.code;
337
+ process.exit(code === "not_found" || code === "unknown_milestone" ? 2 : code === "running" || code === "finished" || code === "owner_alive" || code === "exists" ? 3 : 1);
338
+ }
339
+ // マイルストーンの版が違う(読んだ後に他で変わった)→ 3。何も書いていない
340
+ if (e instanceof MilestonesConflictError) {
341
+ process.stderr.write(`競合: ${e.message}\n`);
342
+ process.exit(3);
343
+ }
321
344
  if (e instanceof NotFoundError) {
322
345
  process.stderr.write(`見つかりません: ${e.id}\n`);
323
346
  process.exit(2);
324
347
  }
325
- process.stderr.write(`${e instanceof UsageError || e instanceof OpRuleError ? "" : "エラー: "}${e.message}\n`);
348
+ process.stderr.write(`${e instanceof UsageError || e instanceof OpRuleError || e instanceof ProjectInputError ? "" : "エラー: "}${e.message}\n`);
326
349
  process.exit(1);
327
350
  });
@@ -127,7 +127,8 @@ export async function preflightCommand(cmd, env) {
127
127
  // タスク化の前なら、置き換えられる既存タスクも見せる(分割の run には無い)
128
128
  const supersedes = run.materialized?.length || run.children ? [] : (await ctx.preflight.previewMaterialize(rid, run.id)).candidates;
129
129
  const inputMatch = await ctx.preflight.inputMatch(rid, run);
130
- return out.result({ ...run, inputMatch, supersedes }, () => [
130
+ const next = runNext(rid, run);
131
+ return out.result({ ...run, inputMatch, supersedes, ...(next ? { next } : {}) }, () => [
131
132
  formatRun(ctx, rid, run),
132
133
  inputMatchLine(rid, run, inputMatch),
133
134
  supersedes.length
@@ -176,6 +177,8 @@ export async function preflightCommand(cmd, env) {
176
177
  /** 手元のエージェントの Preflight の操作(--prepare / --complete / --cancel)。どれでもなければ undefined。曖昧な組み合わせは何も書かずに断る */
177
178
  function localMode(o) {
178
179
  const modes = ["prepare", "complete", "cancel"].filter((m) => o[m]);
180
+ if (o["acknowledge-stopped"] && !o.cancel)
181
+ throw new UsageError("--acknowledge-stopped は --cancel --run <PF-...> と一緒に使います(止まっていることを確かめた run を中断にする)");
179
182
  if (!modes.length) {
180
183
  if (o.run !== undefined)
181
184
  throw new UsageError("p3 preflight の --run は --complete / --cancel と一緒に使います(結果を見るなら p3 drafts <要望> --run <PF-...>)");
@@ -185,13 +188,14 @@ function localMode(o) {
185
188
  throw new UsageError(`--${modes.join(" と --")} は一緒に使えません`);
186
189
  const mode = modes[0];
187
190
  if (o.engine !== undefined)
188
- throw new UsageError(`--${mode} は手元のエージェントの評価なので --engine は使えません`);
191
+ throw new UsageError(mode === "cancel" ? "--cancel に --engine は使えません(指定した run を中断します)" : `--${mode} は手元のエージェントの評価なので --engine は使えません`);
189
192
  if (o["note-only"])
190
193
  throw new UsageError(`--${mode} と --note-only は一緒に使えません`);
191
194
  if (mode === "prepare" && o.run !== undefined)
192
195
  throw new UsageError("--prepare は新しい run を作るので --run は使えません");
193
- if (mode !== "prepare" && o.run === undefined)
194
- throw new UsageError(`--${mode} には --run <PF-...> で run を指定してください(--prepare が返した ID)`);
196
+ if (mode !== "prepare" && o.run === undefined) {
197
+ throw new UsageError(`--${mode} には --run <PF-...> で run を指定してください(${mode === "cancel" ? "p3 drafts <要望> の最新の run か、--prepare が返した ID" : "--prepare が返した ID"})`);
198
+ }
195
199
  if (mode !== "prepare" && o.note !== undefined)
196
200
  throw new UsageError(`--${mode} に --note は使えません(メモは次の Preflight に渡すものです)`);
197
201
  return mode;
@@ -200,7 +204,7 @@ function localMode(o) {
200
204
  * 手元の対話エージェント(Claude Code など)での Preflight。P3 はモデルを呼ばない:
201
205
  * --prepare 評価対象などを固定し、指示のファイルと成果物のパスを返して終わる(エージェントが指示を読んで成果物を書く)
202
206
  * --complete 指定した run の成果物を確かめて取り込む(問題があれば何も確定せず、直してやり直せる)
203
- * --cancel 評価を待つ run をやめる
207
+ * --cancel 指定した run を中断する(手元のエージェントの run も Codex / Mock の run も。cancelRun)
204
208
  */
205
209
  async function localPreflight(env, rid, mode) {
206
210
  const { ctx, out, o, actor } = env;
@@ -224,8 +228,9 @@ async function localPreflight(env, rid, mode) {
224
228
  }
225
229
  const runId = o.run;
226
230
  if (mode === "cancel") {
227
- const r = await ctx.preflight.cancelLocal(rid, runId);
228
- out.result({ ...r.run, already: r.already }, () => (r.already ? `${runId} は取り消し済みです` : `${runId} を取り消しました(成果物のファイルは run のフォルダに残します)`));
231
+ // state: cancelled(中断した)/ requested(中断を頼んだ。まだ running。止まったら p3 drafts に出る)/ already(既に終わっている)
232
+ const r = await ctx.preflight.cancelRun(rid, runId, { acknowledgeStopped: o["acknowledge-stopped"], actor });
233
+ out.result({ ...r.run, state: r.state, message: r.message, already: r.state === "already" }, () => r.message);
229
234
  return 0;
230
235
  }
231
236
  try {
@@ -279,6 +284,16 @@ async function adoptChildren(ctx, out, rid, run, only, skip, actor, json) {
279
284
  .join("\n"));
280
285
  return r.failed.length ? 1 : 0;
281
286
  }
287
+ const NEXT_LABEL = { rerun: "始め直す", cancel: "中断する", acknowledge: "止まっていると確かめたら" };
288
+ /** run の状態から次に使うコマンド(drafts の表示と --json の next)。完了した run は無し */
289
+ function runNext(rid, run) {
290
+ if (run.status === "failed")
291
+ return { rerun: `p3 preflight ${rid}` };
292
+ if (run.status !== "running" || run.engine === "local")
293
+ return undefined;
294
+ const cancel = `p3 preflight ${rid} --cancel --run ${run.id}`;
295
+ return run.cancelRequested ? { acknowledge: `${cancel} --acknowledge-stopped` } : { cancel };
296
+ }
282
297
  /** 評価対象と今の要望の比較(drafts の表示) */
283
298
  function inputMatchLine(rid, run, m) {
284
299
  if (m.status === "same")
@@ -302,6 +317,14 @@ function formatRun(ctx, rid, run) {
302
317
  }
303
318
  if (run.error)
304
319
  lines.push(`エラー: ${run.error}`);
320
+ if (run.interrupted) {
321
+ lines.push(`中断: ${run.interrupted.at} ${run.interrupted.acknowledgedBy ? `止まっていることを ${run.interrupted.acknowledgedBy} が確かめた` : "実行していたプロセスが終わっていた"}(${run.interrupted.reason})`);
322
+ }
323
+ if (run.cancelRequested)
324
+ lines.push(`中断を頼んでいます: ${run.cancelRequested.at}${run.cancelRequested.by ? `(${run.cancelRequested.by})` : ""}。実行しているプロセスが止めるまで running のままです`);
325
+ const next = runNext(rid, run);
326
+ if (next)
327
+ lines.push(...Object.entries(next).map(([k, v]) => `${NEXT_LABEL[k]}: ${v}`));
305
328
  const a = run.assessment;
306
329
  if (a) {
307
330
  lines.push("", `判定: ${a.verdict} 妥当性 ${a.validity.score} / 実現可能性 ${a.feasibility.score}`, indent(a.summary));
@@ -13,6 +13,7 @@ import { repoNameProblem } from "../shared/repos.js";
13
13
  import { addRepo, checkFolder, RepoAdminError, removeRepo, setLocalRepoPath, updateRepo } from "../core/repoAdmin.js";
14
14
  import { normalizeProject } from "../core/store/normalize.js";
15
15
  import { requestWorkstreams } from "../shared/workTarget.js";
16
+ import { DEFAULT_PREFLIGHT_RUNNER, isPreflightRunner, PREFLIGHT_RUNNERS, RUNNER_LABEL, runnerView } from "../shared/preflightRunner.js";
16
17
  import { DATA_DIR_NAME } from "../core/store/locate.js";
17
18
  import { sortMilestones } from "../shared/milestoneOrder.js";
18
19
  import { loadUserConfig, PROJECT_NAME, setProjectNode, updateUserConfig, userConfigPath } from "../core/userConfig.js";
@@ -130,17 +131,18 @@ export function agentsSnippet(kinds) {
130
131
  - 作業の単位は要望。タスクは \`p3\` CLI(入っていなければ \`pnpx @infodb/p3\`)で操作し、\`--json\` で結果を読むこと(データのフォルダを直接編集しない)。
131
132
  詳しい手順はスキル ${skills}
132
133
  - 変更するときは環境変数 \`P3_ACTOR=ai:<エージェント名>\` を付ける
133
- - 操作する要望は \`--req <要望ID>\` で指定する(要望の作業ツリーの中なら省ける)。まず \`p3 whoami --json\` で確かめる
134
+ - 操作する要望は \`--req <要望ID>\` で指定する(要望の作業ツリーの中なら省ける)。まず \`p3 whoami --json\` で確かめる(Preflight の担当 \`preflight.runner\` も出る)
134
135
  - \`whoami\` の \`via\`(プロジェクトの決まり方)が \`cwd\` でなければ(\`dir\` / \`project\` / \`legacy\` / \`only\`)、それ以上 p3 を操作せず、対象のプロジェクトでよいか人に確かめる(推測した \`--project\` / \`--dir\` で避けない。人が指定・確認した後はその対象のまま続ける)
135
136
  - プロジェクトが無い・未登録のときは \`p3 init\` / \`p3 join\` を自分から実行せず、新しく作る(\`init\`)のか共有されたものに参加する(\`join\`)のかを人に確かめる
136
137
  - 新しい作業を頼まれたら \`p3 request new "<タイトル>" --body "..."\` で要望を登録し、ID を伝えて終える。
137
- Preflight(\`preflight\`)とタスク化(\`accept\`)は人が行う(AI は実行しない。結果を \`p3 drafts\` で読むのと、頼まれたメモの保存 \`--note-only\` はよい)
138
- - 例外: 人がチャットで対象の要望の Preflight を明示的に頼んだときだけ、手元で評価してよい: \`p3 preflight <要望ID> --prepare --json\` → 返った指示のファイル(\`instructions\`)を最後まで読み、書くのは返った run の成果物(\`outputs\`)だけ → \`p3 preflight <要望ID> --complete --run <run> --json\` → \`p3 drafts\` の結果を伝えて終える(自分から始めない。タスク化 \`accept\` と着手はしない)
138
+ Preflight(\`preflight\`)は自分から始めない(勧めない・尋ねない)。タスク化(\`accept\`)は人が行う(結果を \`p3 drafts\` で読むのと、頼まれたメモの保存 \`--note-only\` はよい)
139
+ - Preflight を頼まれたら、担当(\`whoami --json\` の \`preflight.runner\`)で分ける。\`codex\`: 人が \`p3 preflight\` か画面で実行する(AI は \`--prepare\` の無い \`p3 preflight\` をしない)。人がチャットで対象の要望の手元の評価を明示的に頼んだときだけ手元で評価し、「Preflight して」とだけなら、人が実行するのか手元で評価するのかを確かめる。\`agent\`: 人に「Preflight して」と頼まれたら手元で評価する(「このチャットで」は求めない)。\`null\`(読めない): \`agent\` と推測せず \`problem\` を伝え、\`codex\` と同じ扱い。子の要望も同じ。対象の要望が分からなければ確かめる
140
+ - 手元の評価: \`p3 preflight <要望ID> --prepare --json\` → 返った指示のファイル(\`instructions\`)を最後まで読み、書くのは返った run の成果物(\`outputs\`)だけ → \`p3 preflight <要望ID> --complete --run <run> --json\` → \`p3 drafts\` の結果を伝えて終える(自分から始めない。タスク化 \`accept\` と着手はしない)
139
141
  - 着手する前に \`p3 show T003 --brief --json\` で本文・依存とその状態(\`dependencies\`)・置き換えの注意(\`warnings\`)を読む
140
142
  - 着手する前に、\`--brief --json\` の \`work\`(作業先のリポジトリとブランチ)を見て、そのリポジトリでブランチに入る(作業先なしなら移動しない)
141
143
  - 着手するときは \`p3 move T003 doing\`。テストを通したら、コミットする前に \`p3 move T003 done --output <今ある成果物(変えたファイルや説明)> --record -\` で完了にする(変更の記録は必須: 何を変えたか・なぜ・入れた決まり・やめたもの を標準入力から Markdown で。まだ無い URL は書かない)
142
144
  - 要望のタスクを全部終えたら、コミットする前に \`p3 request set <要望ID> status=resolved\`(対応済)にする。完了済(done)・見送り(rejected)とタスクの済み(check)は人が決める
143
- - 子の要望(\`parent\` のある要望)は、親とは別の要望として子ごとのタスクとブランチで作業する(親のタスクにしない)。分割の案の採用(\`accept\`)と子の Preflight は人が行う。親を対応済にするのは、親のタスクと見送り以外の子(\`request show <親> --brief --json\` の \`children\`)が全部終わってから
145
+ - 子の要望(\`parent\` のある要望)は、親とは別の要望として子ごとのタスクとブランチで作業する(親のタスクにしない)。分割の案の採用(\`accept\`)は人が行う。子の Preflight は親と同じ担当で、頼まれたときだけ(分割の採用・子の作成から自分で評価へ進まない)。親を対応済にするのは、親のタスクと見送り以外の子(\`request show <親> --brief --json\` の \`children\`)が全部終わってから
144
146
  - データのフォルダがこの作業ツリーの中で git 管理されているなら、要望のフォルダ(\`requests/<要望ID>/\`)の変更も実装と同じコミットに入れる(後のレビューで要望とやったことを精査するため。子なら祖先の要望のフォルダ、親を対応済にするときは子孫の要望のフォルダ(見送りの子など)のまだ入っていない変更も入れ、ほかの要望・関係ない変更は入れない。外・無視・worktree のときは入らないので、移動や \`git add -f\` はしない)。push に失敗したら完了の記録は残し、公開できていないことを伝える。要望のフォルダは、マージするまで要望のブランチにしか無い。既定のブランチに切り替えると、その要望(子なら親の子の一覧からも)が消えたように見えるが、データはブランチにある(作り直したり、別のブランチから写したりしない)
145
147
  - コミットや PR の URL は後から \`p3 move T003 done --output <URL>\` で足す(完了・記録はそのまま。データをコミットしているなら追記もコミットして push)。複数のリポジトリにまたがるときは最後のタスクに \`--repo-output <参照先>=<PR の URL>\` で全部の PR を残す
146
148
  - 置き換えられたタスク(\`p3 ls\` の \`※置換\`、\`--json\` の \`superseded\`)からは始めない。\`move\` が \`warnings\` を返したら止めて人に確かめる
@@ -315,6 +317,11 @@ export async function init(o) {
315
317
  return { path: d, role: "ドキュメント", ...(entry ? { entry } : {}) };
316
318
  });
317
319
  const instructions = await ask("Preflight で重視する観点・制約(任意)", o.instructions ?? "");
320
+ // 担当: codex は人が p3 から実行する(Codex と ChatGPT のプランが要る)。agent は Codex を使えない環境で、手元の AI エージェントに頼む
321
+ const runnerAnswer = o.runner ?? (await ask("Preflight を実行するのは(codex: 人が p3 から Codex で実行 / agent: 頼まれた手元の AI エージェントが評価)", DEFAULT_PREFLIGHT_RUNNER));
322
+ if (!isPreflightRunner(runnerAnswer))
323
+ throw new UsageError(`Preflight の担当は ${PREFLIGHT_RUNNERS.join(" / ")} のどれか: ${runnerAnswer}`);
324
+ const runner = runnerAnswer;
318
325
  // 既にある AGENTS.md / CLAUDE.md からは推測しない(Enter は置かない)
319
326
  let agents = o.agents;
320
327
  if (agents === undefined && interactive) {
@@ -332,7 +339,7 @@ export async function init(o) {
332
339
  repos: [{ name: refName, role: "本体", readFirst: true, writable: true, map }],
333
340
  milestones: [],
334
341
  branchPattern: "req/{id}-{slug}",
335
- preflight: { instructions },
342
+ preflight: { instructions, runner },
336
343
  };
337
344
  await mkdir(join(dir, "requests"), { recursive: true });
338
345
  await writeProjectFile(join(dir, "project.yaml"), cfg);
@@ -344,9 +351,12 @@ export async function init(o) {
344
351
  ` 参照先 ${refName}(本体) → ${root}`,
345
352
  ` 主なフォルダ ${map.map((m) => m.path).join(", ") || "(なし。設定画面で足せます)"}`,
346
353
  ` 個人設定 ${userConfigPath()} に登録しました`,
354
+ ` Preflight ${runner}(${RUNNER_LABEL[runner]}。変える: p3 config set preflight.runner=${runner === "codex" ? "agent" : "codex"})`,
347
355
  ...agentLines,
348
356
  "",
349
- "次に: p3 request new \"<やりたいこと>\" --body \"...\" → p3 preflight <要望ID> → p3 serve",
357
+ runner === "agent"
358
+ ? "次に: p3 request new \"<やりたいこと>\" --body \"...\" → 手元の AI エージェントに「要望 <要望ID> の Preflight をして」と頼む → p3 serve"
359
+ : "次に: p3 request new \"<やりたいこと>\" --body \"...\" → p3 preflight <要望ID> → p3 serve",
350
360
  cfg.description ? "" : "※ description が空です。p3 config set description=\"...\" で設定してください(Preflight の精度に効きます)",
351
361
  ]
352
362
  .filter((l, i, a) => l !== "" || (i > 0 && a[i - 1] !== ""))
@@ -499,7 +509,7 @@ export async function projectCommand(cwd, args, o, current) {
499
509
  /** 入力されたパス。対話式の入力ではシェルが ~ を展開しないので、ここで展開する */
500
510
  export const resolvePath = (cwd, p) => resolve(cwd, p === "~" ? homedir() : p.startsWith("~/") ? join(homedir(), p.slice(2)) : p);
501
511
  const slugifyName = (s) => s.toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^[-._]+|-+$/g, "") || undefined;
502
- const CONFIG_KEYS = ["name", "description", "branchPattern", "instructions"];
512
+ const CONFIG_KEYS = ["name", "description", "branchPattern", "instructions", "preflight.runner"];
503
513
  /** p3 config [set key=value ...] */
504
514
  export async function config(ws, args) {
505
515
  if (args[0] === "set") {
@@ -511,7 +521,12 @@ export async function config(ws, args) {
511
521
  if (eq < 1 || !CONFIG_KEYS.includes(key))
512
522
  throw new UsageError(`設定できるキー: ${CONFIG_KEYS.join(", ")}`);
513
523
  if (key === "instructions")
514
- patch.preflight = { instructions: value };
524
+ patch.preflight = { ...patch.preflight, instructions: value };
525
+ else if (key === "preflight.runner") {
526
+ if (!isPreflightRunner(value))
527
+ throw new UsageError(`preflight.runner は ${PREFLIGHT_RUNNERS.join(" / ")} のどれか: ${value || "(空)"}`);
528
+ patch.preflight = { ...patch.preflight, runner: value };
529
+ }
515
530
  else if (key === "branchPattern" && !value.includes("{id}"))
516
531
  throw new UsageError("branchPattern には {id} を含めてください");
517
532
  else if (key === "name" && !value)
@@ -533,10 +548,17 @@ export async function config(ws, args) {
533
548
  `milestones ${sortMilestones(p.milestones).map((m) => `${m.id}${m.due ? `(${m.due})` : ""}${m.done ? "[済]" : ""}`).join(", ") || "(なし)"}`,
534
549
  `branchPattern ${p.branchPattern}`,
535
550
  `instructions ${p.preflight.instructions || "(なし)"}`,
551
+ `preflight.runner ${runnerText(runnerView(p.preflight))}`,
536
552
  "",
537
553
  `ファイル: ${join(ws.dataDir, "project.yaml")}`,
538
554
  ].join("\n");
539
- return { data: p, text };
555
+ return { data: { ...p, preflightRunner: runnerView(p.preflight) }, text };
556
+ }
557
+ /** 担当の表示(config・whoami)。読めない値は理由を出す */
558
+ export function runnerText(v) {
559
+ if (!v.runner)
560
+ return `(読めません)${v.problem}`;
561
+ return `${v.runner}(${RUNNER_LABEL[v.runner]}${v.source === "default" ? "。未設定なので既定" : ""})`;
540
562
  }
541
563
  function splitList(s) {
542
564
  return s.split(",").map((x) => x.trim()).filter(Boolean);