@infodb/p3 0.2.0 → 0.4.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.
- package/README.md +6 -1
- package/dist/web/assets/{Outputs-Ni3pNuGU.js → Outputs-5Hby-S5Q.js} +1 -1
- package/dist/web/assets/{RequestStatus-K8TZwpur.js → RequestStatus-CTkGjT02.js} +1 -1
- package/dist/web/assets/TagInput-Rj3PNOAF.js +1 -0
- package/dist/web/assets/TaskDrawer-DtPhiYxP.js +3 -0
- package/dist/web/assets/_requestId-CGvAfIkB.js +30 -0
- package/dist/web/assets/_requestId-DxfYhgAq.js +1 -0
- package/dist/web/assets/board-wt47lfrE.js +1 -0
- package/dist/web/assets/copy-CKsXEjMi.js +1 -0
- package/dist/web/assets/directTask-Dk3H5Q2B.js +1 -0
- package/dist/web/assets/done-C9Ct7ssb.js +1 -0
- package/dist/web/assets/draft-CfJeyLOl.js +1 -0
- package/dist/web/assets/index-BTFL2rpp.js +12 -0
- package/dist/web/assets/index-DAyBsvua.css +2 -0
- package/dist/web/assets/milestoneOrder-N7b5XFJP.js +1 -0
- package/dist/web/assets/new-e4ID2vQV.js +1 -0
- package/dist/web/assets/preflightInput-DMxqnvF8.js +2 -0
- package/dist/web/assets/preload-helper-DhIyFaOW.js +1 -0
- package/dist/web/assets/release-notes-CQ0d2r0k.js +3 -0
- package/dist/web/assets/requestData-BDZqyl35.js +1 -0
- package/dist/web/assets/routes-Bipv3lwJ.js +2 -0
- package/dist/web/assets/settings-Dwh8fj6p.js +1 -0
- package/dist/web/assets/ui-DdOGYj9z.js +1 -0
- package/dist/web/assets/workTarget-Cijqq4yH.js +1 -0
- package/dist/web/index.html +4 -5
- package/docs/architecture.md +80 -15
- package/docs/development.md +83 -7
- package/docs/how-to-use.md +159 -15
- package/docs/installation.md +142 -5
- package/docs/publishing.md +27 -3
- package/package.json +8 -5
- package/skills/p3/SKILL.md +21 -8
- package/src/cli/args.ts +9 -2
- package/src/cli/help.ts +12 -3
- package/src/cli/main.ts +75 -5
- package/src/cli/output.ts +18 -0
- package/src/cli/preflightCommands.ts +10 -2
- package/src/cli/project.ts +268 -101
- package/src/cli/releaseNotesCommands.ts +63 -4
- package/src/cli/requestCommands.ts +4 -2
- package/src/cli/taskCommands.ts +1 -1
- package/src/core/context.ts +3 -2
- package/src/core/preflight/codexEngine.ts +2 -1
- package/src/core/preflight/render-image/Dockerfile +3 -0
- package/src/core/preflight/render-image/fonts-ja.conf +28 -0
- package/src/core/preflight/render-image/render.mjs +10 -1
- package/src/core/preflight/render.ts +5 -2
- package/src/core/preflight/service.ts +19 -2
- package/src/core/projectRegistry.ts +264 -0
- package/src/core/releaseNotes/completeRequests.ts +102 -0
- package/src/core/releaseNotes/generate.ts +12 -0
- package/src/core/releaseNotes/service.ts +9 -5
- package/src/core/store/locate.ts +3 -3
- package/src/core/userConfig.ts +25 -0
- package/src/server/api/chatgptRoutes.ts +6 -5
- package/src/server/api/manifest.ts +17 -1
- package/src/server/api/projectsRoutes.ts +89 -0
- package/src/server/api/releaseNoteRoutes.ts +11 -0
- package/src/server/api/routes.ts +33 -25
- package/src/server/server.ts +74 -15
- package/src/shared/directTask.ts +20 -0
- package/src/shared/milestoneOrder.ts +44 -0
- package/src/shared/types.ts +31 -1
- package/dist/web/assets/TagInput-BICKVH2x.js +0 -1
- package/dist/web/assets/TaskDrawer-BkDIstIN.js +0 -3
- package/dist/web/assets/_requestId-B5O_ytaq.js +0 -1
- package/dist/web/assets/_requestId-C66puEMO.js +0 -30
- package/dist/web/assets/board-CbfDjkls.js +0 -1
- package/dist/web/assets/copy-B1ZbihKL.js +0 -2
- package/dist/web/assets/done-CPQbCFHg.js +0 -1
- package/dist/web/assets/draft-dT3gLDIt.js +0 -1
- package/dist/web/assets/index-BUcs2J6N.js +0 -12
- package/dist/web/assets/index-C3DkqwJ9.css +0 -2
- package/dist/web/assets/link-_s8ndNKS.js +0 -1
- package/dist/web/assets/new-T60RB7de.js +0 -1
- package/dist/web/assets/preload-helper-dXqN7N-I.js +0 -1
- package/dist/web/assets/release-notes-DxrPhDbt.js +0 -3
- package/dist/web/assets/requestData-D8ZiSZss.js +0 -1
- package/dist/web/assets/routes-D9ZxXoLk.js +0 -2
- package/dist/web/assets/settings-DsHVyqzJ.js +0 -1
- package/dist/web/assets/supersede-CLXlhCq0.js +0 -1
- package/dist/web/assets/ui-Cvke4y4X.js +0 -1
package/docs/installation.md
CHANGED
|
@@ -6,6 +6,10 @@ infodb p3(以下 P3)を入れて、最初の Preflight を動かせる状態
|
|
|
6
6
|
P3 の Preflight は、Codex を **Docker のコンテナの中で** 動かす。導入でつまずくのはほとんどが Docker とパスの対応なので、
|
|
7
7
|
この文書はそこを詳しく書く。
|
|
8
8
|
|
|
9
|
+
Docker と ChatGPT の接続が要るのは Preflight(Codex)・リリースノートの要約の生成・画面イメージの描画だけで、要望・タスク・
|
|
10
|
+
変更の記録・マイルストーンの管理と、リリースノートを手で書いて保存することは無くても動く。Docker を用意できない・Preflight が止まる間も、Preflight を通さずにタスクを作って進められる
|
|
11
|
+
([使い方ガイド: Preflight を通さずにタスクを作る](how-to-use.md#preflight-を通さずにタスクを作る))。
|
|
12
|
+
|
|
9
13
|
## 全体の流れ
|
|
10
14
|
|
|
11
15
|
| # | すること | 終わったと分かる目安 |
|
|
@@ -19,6 +23,8 @@ P3 の Preflight は、Codex を **Docker のコンテナの中で** 動かす
|
|
|
19
23
|
| 7 | Codex のイメージを作る | `p3 codex update` が「Codex を更新しました: codex-cli …」 |
|
|
20
24
|
| 8 | 画面を開いて、試しに Preflight を動かす | 評価とタスク案が出る |
|
|
21
25
|
|
|
26
|
+
P3 を Docker のコンテナで動かす(プロジェクトを跨ぐ serve を既定にする)ときは、後の「[Docker で動かす](#docker-で動かすプロジェクトを跨ぐ-serve)」。
|
|
27
|
+
|
|
22
28
|
## 1. 必要なもの
|
|
23
29
|
|
|
24
30
|
| もの | 何に使う | 確かめ方 |
|
|
@@ -96,14 +102,36 @@ p3 init --yes --agents --project myapp --dir ~/p3-data/myapp --description "社
|
|
|
96
102
|
|
|
97
103
|
- データのフォルダには `project.yaml` と空の `requests/` ができる。このリポジトリは **本体の参照先**(Preflight が読むリポジトリ。
|
|
98
104
|
最初に読む・作業先にできる)として登録される
|
|
99
|
-
-
|
|
100
|
-
|
|
105
|
+
- `init` は新しく作るだけ。そのフォルダに既にプロジェクト(`project.yaml`)があれば、何も変えずに断って `p3 join` を案内する
|
|
106
|
+
- ほかの人が作って共有したプロジェクトには **`p3 join`** で参加する(下の「参加する」)
|
|
101
107
|
- 既定の `.p3` を git に入れるか(`.gitignore` に書くか)は自分で決める。p3 は `.gitignore` を書き換えず、データをコミットもしない
|
|
102
|
-
- `--agents` を付けると、AI エージェント向けの使い方を `AGENTS.md`(無ければ `CLAUDE.md
|
|
103
|
-
`.claude/skills/p3/SKILL.md`(Claude Code
|
|
104
|
-
|
|
108
|
+
- `--agents claude|codex|both` を付けると、AI エージェント向けの使い方を `AGENTS.md`(無ければ `CLAUDE.md`)に追記し、スキルを
|
|
109
|
+
選んだ先に置く: `claude` は `.claude/skills/p3/SKILL.md`(Claude Code)、`codex` は `.agents/skills/p3/SKILL.md`(Codex)、`both` は両方
|
|
110
|
+
(値を省くと both。付けなければ置かない。対話では聞き、Enter は置かない)。置いたファイルはリポジトリに入れて共有する。
|
|
111
|
+
作った後から置く・最新にするのは `p3 agents`([使い方ガイド](how-to-use.md) の「AI エージェントから使う」。`init --agents` を
|
|
112
|
+
既にあるプロジェクトで実行し直しても置かない)
|
|
105
113
|
- 登録はこのマシンの **個人設定**(`~/.config/infodb-p3/config.yaml`。`XDG_CONFIG_HOME` があればその下。共有しない)に入る
|
|
106
114
|
|
|
115
|
+
### 参加する(ほかの人が作ったプロジェクト)
|
|
116
|
+
|
|
117
|
+
clone したリポジトリの中で `p3 join` を実行する。個人設定に「プロジェクト名 → データのフォルダ・このリポジトリのこのマシンのパス」を
|
|
118
|
+
登録するだけで、データ(`project.yaml`・要望)とリポジトリのファイル(スキル・`AGENTS.md` / `CLAUDE.md`)は書かない。
|
|
119
|
+
チームで消した AI 向けのファイルが、参加した人の操作で戻ることはない。
|
|
120
|
+
|
|
121
|
+
```bash
|
|
122
|
+
cd ~/src/myapp
|
|
123
|
+
p3 join --project myapp # リポジトリの .p3 に入れて共有しているとき(既定はルートの .p3)
|
|
124
|
+
p3 join --project myapp --dir ~/p3-data/myapp # リポジトリの外のフォルダ(共有ドライブなど)のとき
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
- データのフォルダの決め方(既定・相対・`~`・絶対、サブフォルダや作業ツリーから実行してもルートの `.p3`)は `init` と同じ。
|
|
128
|
+
端末では聞き、`--yes` か非対話なら引数と既定値で進める
|
|
129
|
+
- このリポジトリは、共有の定義にある参照先として登録する: `--repo-name` の名前 → フォルダ名と同じ名前 → 参照先が1つならそれ。
|
|
130
|
+
決まらなければ登録せず、`p3 repo ls` と `p3 repo path <名前> <パス>` を案内する
|
|
131
|
+
- データのフォルダが無い・`project.yaml` が無い・壊れている・読めないときは、理由を出して止まり、何も登録しない(作りもしない。
|
|
132
|
+
新しく作るなら `init`)。同じ名前で別のフォルダは断る。同じ参加をもう一度しても何も変えない
|
|
133
|
+
- `--agents` と、作るときだけの項目(`--name`・`--description`・`--instructions`)は使えない(共有の定義を変えるなら `p3 config set`)
|
|
134
|
+
|
|
107
135
|
確かめる:
|
|
108
136
|
|
|
109
137
|
```bash
|
|
@@ -198,6 +226,8 @@ p3 codex update
|
|
|
198
226
|
- 初回は数分かかる(ネットワークから Codex を入れる)。プロジェクトの登録やサインインは要らない
|
|
199
227
|
- しなくても、最初の Preflight の前に自動で作る。その後も、作ってから1日より古ければ Preflight の前に作り直す
|
|
200
228
|
(止めるなら `p3 user-config set codex.ensureImage=false`)
|
|
229
|
+
- 作り直すかどうかは作った日時だけで決まる。P3 を上げてイメージの中身(入れる道具)が変わったときは、`p3 codex update` で
|
|
230
|
+
今すぐ作り直す(しなくても1日以内に作り直される)
|
|
201
231
|
- 画面イメージの描画のイメージ(`infodb-p3-render`)は、最初に画面イメージを描くときに作る(`p3 render update` で今すぐ)
|
|
202
232
|
|
|
203
233
|
## 8. 画面を開いて、試しに Preflight を動かす
|
|
@@ -228,6 +258,9 @@ DevContainer で「対応あり」にならなければ 5. を見直す。評価
|
|
|
228
258
|
|
|
229
259
|
失敗はログとエラーに **次にすること** を添えて出す。直して、もう一度同じ操作をする。
|
|
230
260
|
|
|
261
|
+
Preflight を使えない・失敗したとき(Docker・ChatGPT の接続・使用量の上限など、理由によらない)は、概要ページ・失敗した run・
|
|
262
|
+
CLI の出力に、Preflight を通さずにタスクを作る道も出る。直すまでの間はそれで進めてよい([使い方ガイド: Preflight を通さずにタスクを作る](how-to-use.md#preflight-を通さずにタスクを作る))。
|
|
263
|
+
|
|
231
264
|
| どこで | 出るもの | 確かめる | 直す |
|
|
232
265
|
| --- | --- | --- | --- |
|
|
233
266
|
| Preflight・`codex update` | `docker` が無い(ENOENT) | `docker version` | Docker を入れ、`PATH` を確かめる |
|
|
@@ -262,6 +295,110 @@ DevContainer で「対応あり」にならなければ 5. を見直す。評価
|
|
|
262
295
|
`p3 user-config` で全部の値と出どころを見て、`p3 user-config set キー=値` で変える(`キー=` で消す)。コメントとほかの項目は残る。
|
|
263
296
|
環境変数は serve を起動したときのものが使われる。
|
|
264
297
|
|
|
298
|
+
## Docker で動かす(プロジェクトを跨ぐ serve)
|
|
299
|
+
|
|
300
|
+
P3 をイメージにして、コンテナで動かすこともできる。イメージの既定は **プロジェクトを跨ぐ serve**(`p3 serve --all-projects
|
|
301
|
+
--host 0.0.0.0`)で、個人設定に登録したプロジェクトを画面で選んで扱う([使い方ガイド](how-to-use.md#画面))。閲覧専用ではなく、
|
|
302
|
+
要望・タスクの作成と編集・添付・Preflight もいつもどおり使える。
|
|
303
|
+
|
|
304
|
+
イメージは Docker Hub の **`tamuto/p3`**。中に p3 本体(npm の `@infodb/p3` と同じ版・同じ中身)と、Node 22・git・Docker の CLI が
|
|
305
|
+
入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.4.0` など)と
|
|
306
|
+
`latest` がある。決まった版で使うなら版のタグを指す。
|
|
307
|
+
|
|
308
|
+
```bash
|
|
309
|
+
docker pull tamuto/p3:0.4.0
|
|
310
|
+
```
|
|
311
|
+
|
|
312
|
+
リポジトリから作るときは `docker build -t tamuto/p3:dev .`([開発ガイド](development.md#docker-のイメージ))。
|
|
313
|
+
|
|
314
|
+
コンテナは **root** で動く。個人設定と ChatGPT の接続は root の既定の場所(`/root/.config/infodb-p3`)のままで、イメージでは
|
|
315
|
+
変えない。データのフォルダと参照先(リポジトリ)はホストのフォルダをマウントする(データは書く、参照先は Preflight が読むだけ)。
|
|
316
|
+
マウントしたリポジトリは持ち主が違っても読めるよう、イメージの git は `safe.directory` を `*` にしている。
|
|
317
|
+
|
|
318
|
+
### 開発コンテナのサイドカーとして動かす
|
|
319
|
+
|
|
320
|
+
root で動く開発コンテナ(DevContainer など)で p3 の CLI を使っているなら、その横に p3 のコンテナを置き、**開発コンテナと同じ
|
|
321
|
+
マウント**を付ける。個人設定(登録・`codex.pathMap`)と ChatGPT の接続を開発コンテナと共有するので、コンテナの中で登録し直す・
|
|
322
|
+
接続し直す必要はない。登録・接続・テーマの変更は、開発コンテナの中の CLI でいつもどおり行い、画面の「一覧を読み直す」で反映する。
|
|
323
|
+
|
|
324
|
+
```yaml
|
|
325
|
+
# 開発コンテナの compose に足す例(パスは開発コンテナのマウントに合わせる)
|
|
326
|
+
services:
|
|
327
|
+
p3:
|
|
328
|
+
image: tamuto/p3:0.4.0
|
|
329
|
+
restart: unless-stopped
|
|
330
|
+
ports:
|
|
331
|
+
- "127.0.0.1:4310:4310"
|
|
332
|
+
environment:
|
|
333
|
+
- TZ=Asia/Tokyo
|
|
334
|
+
volumes:
|
|
335
|
+
- /root/workspaces:/workspaces # 開発コンテナと同じ(リポジトリ・データ)
|
|
336
|
+
- ./denv/.config:/root/.config # 開発コンテナと同じ ~/.config(個人設定・ChatGPT の接続)
|
|
337
|
+
- /mnt/usb/assets:/mnt/assets # データを別の場所に置いているなら、それも同じに
|
|
338
|
+
- /var/run/docker.sock:/var/run/docker.sock # Preflight(Codex)と画面イメージの描画
|
|
339
|
+
```
|
|
340
|
+
|
|
341
|
+
- 開発コンテナと同じパスで見えるので、開発コンテナ用に書いた `codex.pathMap`(コンテナの中のパス → ホストのパス)がそのまま効く
|
|
342
|
+
- 個人設定は開発コンテナと p3 のコンテナの両方から書かれることがあるが、書くときはファイルのロックで順に行う
|
|
343
|
+
|
|
344
|
+
### 単独で動かす
|
|
345
|
+
|
|
346
|
+
```bash
|
|
347
|
+
docker run -d --name p3 --restart unless-stopped \
|
|
348
|
+
-p 127.0.0.1:4310:4310 \
|
|
349
|
+
-v ~/.config/infodb-p3:/root/.config/infodb-p3 \
|
|
350
|
+
-v /home/me/work:/home/me/work \
|
|
351
|
+
-v /var/run/docker.sock:/var/run/docker.sock \
|
|
352
|
+
tamuto/p3:0.4.0
|
|
353
|
+
|
|
354
|
+
# 登録が無ければ、コンテナの中で登録する(既にあるデータに参加する。新しく作るなら p3 init)
|
|
355
|
+
docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
|
|
356
|
+
```
|
|
357
|
+
|
|
358
|
+
- データと参照先はホストと **同じパスで** マウントする(Codex・描画のコンテナはホストのデーモンが作るので、パスが同じなら
|
|
359
|
+
`codex.pathMap` は要らない)。ホストの個人設定を使うなら、その登録のパスとマウントのパスをそろえる
|
|
360
|
+
- root で動くので、コンテナが作るファイル(要望・タスクなど)の持ち主は root になる
|
|
361
|
+
|
|
362
|
+
### どちらでも
|
|
363
|
+
|
|
364
|
+
- 待ち受けは `127.0.0.1` に公開する。ブラウザで http://localhost:4310 を開く。登録が1つならそのプロジェクトが開き、複数なら一覧から選ぶ
|
|
365
|
+
- **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.4.0 serve --project myapp --host 0.0.0.0`。compose なら
|
|
366
|
+
`command:`)。明示しない限り、コンテナの中かどうかで自動では切り替えない
|
|
367
|
+
- **止める**: `docker stop p3`(SIGTERM。実行中の Preflight・生成を取り消して記録してから止まる。10 秒まで待つ)
|
|
368
|
+
- **新しい版にする**: 版のタグを変えて作り直す(個人設定と接続はマウントした ~/.config、データはホストに残る)。
|
|
369
|
+
中の P3 が変わると Codex のイメージの中身も変わることがあるので、`docker exec p3 p3 codex update`
|
|
370
|
+
- 状態はヘルスチェック(`/api/mode` に答えるか)で `docker ps` に出る
|
|
371
|
+
|
|
372
|
+
**ブラウザから変えられない操作**: コンテナに公開したポートからの接続は「このマシン」からではないので、ローカルだけの操作
|
|
373
|
+
(ChatGPT の接続・テーマ・参照先のこのマシンのパス)は画面からは断られる。サイドカーなら開発コンテナの中の CLI で、単独なら
|
|
374
|
+
コンテナの中の CLI で行う:
|
|
375
|
+
|
|
376
|
+
```bash
|
|
377
|
+
docker exec -it p3 p3 chatgpt login --paste # 表示された URL をホストのブラウザで開き、「接続できません」の URL を貼る
|
|
378
|
+
docker exec p3 p3 user-config set ui.theme=dark
|
|
379
|
+
docker exec p3 p3 --project myapp repo path main /home/me/work/myapp
|
|
380
|
+
```
|
|
381
|
+
|
|
382
|
+
要望・タスクの作成と編集、Preflight の実行など、ほかの操作は画面からできる。
|
|
383
|
+
|
|
384
|
+
**Preflight(Codex)と画面イメージの描画**: コンテナの中に Docker のデーモンは無い。ホストのデーモンのソケットを渡すと使える
|
|
385
|
+
|
|
386
|
+
(上の例の `-v /var/run/docker.sock:/var/run/docker.sock`)。root で動くので、ソケットの権限の設定は要らない。
|
|
387
|
+
|
|
388
|
+
```bash
|
|
389
|
+
docker exec p3 p3 codex update # Codex のイメージを作る(ホストのデーモンに作る)
|
|
390
|
+
```
|
|
391
|
+
|
|
392
|
+
- ソケットを渡すと、コンテナの中から **ホストの Docker を何でも操作できる**(ホストの管理者と同じ強さ)。信頼できるマシンでだけ渡す
|
|
393
|
+
- Codex・描画のコンテナはホストのデーモンが作り、データのフォルダと参照先を **ホストのパスで** マウントする。上のように同じパスで
|
|
394
|
+
マウントしていれば対応は要らない。違うパスでマウントしたときは、コンテナの中のパスとホストのパスの対応を
|
|
395
|
+
`docker exec p3 p3 user-config set codex.pathMap+=<コンテナの中のパス>=<ホストのパス>` で全部のプロジェクトの分を足す(5.)
|
|
396
|
+
- ChatGPT の接続はマウントした ~/.config に残るので、コンテナを作り直しても接続し直さなくてよい
|
|
397
|
+
- ソケットを渡していない・繋がらないときも、要望・タスクの作成と編集・プロジェクトの選択は使える。Preflight は
|
|
398
|
+
使えない理由と直し方を出して止まる(Mock には落とさない)。その間は Preflight を通さずにタスクを作ってよい
|
|
399
|
+
([使い方ガイド](how-to-use.md#preflight-を通さずにタスクを作る))
|
|
400
|
+
- P3 を作り直してイメージの中身(入れる道具)が変わったら `docker exec p3 p3 codex update`
|
|
401
|
+
|
|
265
402
|
## 補足: 旧来の認証と Mock
|
|
266
403
|
|
|
267
404
|
ふだんは使わない。
|
package/docs/publishing.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# 公開の手順(@infodb/p3)
|
|
2
2
|
|
|
3
3
|
P3 を npm に `@infodb/p3` として公開するときのチェックリスト。npm への公開とタグ付けは人が行う。
|
|
4
|
-
CI は使わず、手元で確かめてから公開する。
|
|
4
|
+
CI は使わず、手元で確かめてから公開する。Docker のイメージ(Docker Hub の `tamuto/p3`)も同じ版で出す(6.)。
|
|
5
5
|
|
|
6
6
|
## 1. 外部のパッケージ
|
|
7
7
|
|
|
@@ -18,7 +18,7 @@ CI は使わず、手元で確かめてから公開する。
|
|
|
18
18
|
```bash
|
|
19
19
|
git clone <このリポジトリ> /tmp/p3-release && cd /tmp/p3-release # 隣に llmcs が無い場所で
|
|
20
20
|
pnpm install --frozen-lockfile
|
|
21
|
-
pnpm -s check # 型検査・lint
|
|
21
|
+
pnpm -s check # 型検査・lint・テスト・画面のビルド・UI テスト
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
## 3. 配布物の確認
|
|
@@ -28,7 +28,7 @@ node scripts/verify-pack.mjs --docker # npm pack → 実行時の依存だ
|
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
- [ ] 全段が `ok`。確かめる段: Node の版と engines / tarball の中身 / `npm install`(開発用の依存が入らない)/
|
|
31
|
-
別のリポジトリで `init --agents`・`whoami`・要望の作成・Mock の Preflight・メモを足した再評価・`serve`(画面・資産・API)/
|
|
31
|
+
別のリポジトリで `init --agents`・`init --agents codex` と `p3 agents`(後から足す・`--force`)・`whoami`・要望の作成・Mock の Preflight・メモを足した再評価・`serve`(画面・資産・API)/
|
|
32
32
|
`codex update`(`--docker`。未登録・未認証のまま本物の Docker でイメージを作り直し、版を読む)
|
|
33
33
|
- [ ] 下限の Node でも通す: `PATH=$(dirname $(npx -y node@22.0.0 -e "console.log(process.execPath)")):$PATH node scripts/verify-pack.mjs`
|
|
34
34
|
- [ ] Docker が無い環境で確かめたときは、`codex update` の段が「実行していない」と出る。その場合は Docker のある環境で
|
|
@@ -55,6 +55,30 @@ npm publish # prepack で画面をビルドする。publishConfig.
|
|
|
55
55
|
公開した後に、別の環境で `pnpx @infodb/p3 --help` が動くことを確かめる(その版も公開から1日は pnpm の既定では入らない。
|
|
56
56
|
`npx @infodb/p3` か、`pnpm dlx --config.minimum-release-age=0 @infodb/p3` で確かめる)。
|
|
57
57
|
|
|
58
|
+
## 6. Docker Hub(tamuto/p3)
|
|
59
|
+
|
|
60
|
+
イメージの中の p3 は、そのときのチェックアウトから `pnpm pack` と同じ中身で作る(npm から取らない)。npm に公開した版と同じ
|
|
61
|
+
コミット(版のタグ `v<版>`)から作り、タグも同じ版にする。
|
|
62
|
+
|
|
63
|
+
- [ ] npm の公開(5.)と同じコミットにいる(`git describe --tags` が `v<版>`、作業ツリーに変更が無い)
|
|
64
|
+
- [ ] スモークが全段 ok: `node scripts/verify-docker.mjs --image tamuto/p3:<版>`(DevContainer の中では `--work`・`--network-of auto`・
|
|
65
|
+
`P3_CODEX_PATH_MAP`。[development.md](development.md#docker-のイメージ))
|
|
66
|
+
- [ ] ソケットを渡したコンテナ(root)で Codex のイメージを作れる: `docker run --rm -v /var/run/docker.sock:/var/run/docker.sock tamuto/p3:<版> codex update`
|
|
67
|
+
- [ ] 本物の Codex(ChatGPT の接続・ソケット)で、コンテナから Preflight が終わる(接続できる環境で手で確かめる)
|
|
68
|
+
- [ ] amd64 と arm64 の両方を作る(Mac の Apple シリコンなど)。arm64 を作れない環境では、QEMU(binfmt)を入れたマシンか
|
|
69
|
+
arm64 のマシンで作る
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
V=$(node -p "require('./package.json').version")
|
|
73
|
+
docker login # tamuto に push できるアカウント
|
|
74
|
+
docker buildx build --platform linux/amd64,linux/arm64 --build-arg P3_VERSION=$V \
|
|
75
|
+
-t tamuto/p3:$V -t tamuto/p3:latest --push .
|
|
76
|
+
docker buildx imagetools inspect tamuto/p3:$V # 両方の platform があるか
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
公開した後に、別の環境で `docker run --rm tamuto/p3:<版> --help` と、[導入ガイド](installation.md#docker-で動かすプロジェクトを跨ぐ-serve)
|
|
80
|
+
の手順で起動して一覧が出ることを確かめる。Docker Hub の説明(Overview)は導入ガイドの「Docker で動かす」へのリンクにする。
|
|
81
|
+
|
|
58
82
|
## 履歴の確認(2026-10-11、0.1.0 の準備のとき)
|
|
59
83
|
|
|
60
84
|
公開の前に Git の履歴(全ブランチ・63 コミット)を確かめた。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@infodb/p3",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "File-based project management with AI-powered preflight (Codex App Server)",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"project-management",
|
|
@@ -42,7 +42,7 @@
|
|
|
42
42
|
"dependencies": {
|
|
43
43
|
"@hono/node-server": "~2.1.3",
|
|
44
44
|
"@infodb/chatgpt-plan": "^0.1.1",
|
|
45
|
-
"@infodb/codex-workspace": "^0.2.
|
|
45
|
+
"@infodb/codex-workspace": "^0.2.1",
|
|
46
46
|
"hono": "^4.13.13",
|
|
47
47
|
"tsx": "^4.23.15",
|
|
48
48
|
"yaml": "^2.9.1",
|
|
@@ -60,6 +60,7 @@
|
|
|
60
60
|
"concurrently": "^10.0.5",
|
|
61
61
|
"oxlint": "1.87.0",
|
|
62
62
|
"oxlint-tsgolint": "7.0.2004",
|
|
63
|
+
"playwright-core": "^1.64.1",
|
|
63
64
|
"react": "^19.3.0",
|
|
64
65
|
"react-dom": "^19.3.0",
|
|
65
66
|
"react-markdown": "^10.1.0",
|
|
@@ -80,10 +81,12 @@
|
|
|
80
81
|
"demo:reset": "tsx scripts/demo.ts --force",
|
|
81
82
|
"routes": "tsr generate",
|
|
82
83
|
"typecheck": "tsr generate && tsc --noEmit -p .",
|
|
83
|
-
"lint": "oxlint --type-aware --deny-warnings --report-unused-disable-directives-severity=error src scripts test vite.config.ts vitest.config.ts",
|
|
84
|
+
"lint": "oxlint --type-aware --deny-warnings --report-unused-disable-directives-severity=error src scripts test vite.config.ts vitest.config.ts vitest.ui.config.ts",
|
|
84
85
|
"test": "vitest run",
|
|
85
86
|
"test:watch": "vitest",
|
|
86
|
-
"
|
|
87
|
-
"
|
|
87
|
+
"test:ui": "vitest run -c vitest.ui.config.ts",
|
|
88
|
+
"check": "pnpm typecheck && pnpm lint && pnpm test && pnpm build && pnpm test:ui",
|
|
89
|
+
"verify:pack": "node scripts/verify-pack.mjs",
|
|
90
|
+
"video": "node scripts/video/record.mjs"
|
|
88
91
|
}
|
|
89
92
|
}
|
package/skills/p3/SKILL.md
CHANGED
|
@@ -22,6 +22,8 @@ P3_ACTOR=ai:<エージェント名> p3 <コマンド> [引数] --json
|
|
|
22
22
|
- `via` が `cwd`(今いる場所で決まった)でなければ(`dir` / `project` / `legacy` / `only`)、それ以上 p3 を操作せず、
|
|
23
23
|
対象のプロジェクトでよいかユーザーに確かめる。特に `only` は登録が1つだけというだけで、p3 を使わないフォルダでも決まる。
|
|
24
24
|
推測した `--project` や `--dir` を付けて確認を避けない。ユーザーが対象を指定した・確かめた後は、その対象のまま続ける
|
|
25
|
+
- プロジェクトが無い・登録されていない(未登録)ときは、`p3 init`・`p3 join` を自分から実行しない。新しく作る(`init`)のか、
|
|
26
|
+
共有されたものに参加する(`join`)のかをユーザーに確かめる
|
|
25
27
|
- `P3_ACTOR=ai:<名前>` は変更者の記録。変更するコマンドには必ず付ける
|
|
26
28
|
- 結果は `--json` で読む。人に見せる表はオプションなしの出力でよい
|
|
27
29
|
- 終了コード: 0 成功 / 1 使い方の誤り(メッセージに次にすることが出る)/ 2 見つからない / 3 競合(`show --brief` で読み直してやり直す)
|
|
@@ -64,19 +66,30 @@ P3_ACTOR=ai:<エージェント名> p3 <コマンド> [引数] --json
|
|
|
64
66
|
**置き換えられたタスク**(`ls` の `※置換`、`--json` の `superseded` と `warnings`)からは始めない。残っていれば扱いをユーザーに確かめる
|
|
65
67
|
(不要ならユーザーの了承を得て `archive`)。`move` が警告(`warnings`)を返したら、作業を止めてユーザーに伝える
|
|
66
68
|
3. 着手: `move T003 doing --req <要望ID>`
|
|
67
|
-
4.
|
|
68
|
-
`move T003 done --req <要望ID> --output
|
|
69
|
+
4. 作業し、プロジェクトのテストを通したら、**コミットする前に** 完了にする:
|
|
70
|
+
`move T003 done --req <要望ID> --output <成果物> --record - < record.md`(成果物が複数あれば `--output` を繰り返す)。
|
|
71
|
+
成果物は今あるもの(変えたファイル・ドキュメントのパスや短い説明)。まだ無い URL や仮のコミットの SHA は書かない(URL は 8 で足す)。
|
|
69
72
|
**変更の記録(`--record`)は必須**: 何を変えたか(振る舞いの言葉で)・なぜ・入れた決まり・やめたもの を Markdown で短く書く。
|
|
70
|
-
後の Preflight
|
|
73
|
+
後の Preflight が経緯を調べるとき、タスクの解析・リリースノートの材料として読む(パスの羅列ではなく、目的と決まりを書く)。
|
|
74
|
+
テストが通っていない・作業が途中のうちは完了にしない
|
|
71
75
|
5. 作業中に見つけた追加の作業は `new "<タイトル>" --req <要望ID> --body "..."` でタスクにする(タスクの関係は Preflight のタスク化が張るもので、手では張らない。順序は本文に書く)
|
|
72
|
-
6. 要望のタスクが全部完了したら(`ls --req <要望ID>` が全部 done
|
|
76
|
+
6. 要望のタスクが全部完了したら(`ls --req <要望ID>` が全部 done、成果物と検証も済み)、コミットする前に要望を **対応済** にする:
|
|
73
77
|
`request set <要望ID> status=resolved --json`。未完了のタスクがあると拒否される(終わらせるか、不要ならユーザーの了承を得て
|
|
74
78
|
`archive`)。拒否をタスクを偽って完了にする・ファイルを直接書き換えるなどで回避しない
|
|
75
|
-
7.
|
|
76
|
-
|
|
77
|
-
|
|
79
|
+
7. コミットして push する。データのフォルダ(`whoami` の場所)がこの作業ツリーの中にあって git で管理されている(無視されていない)なら、
|
|
80
|
+
**要望のフォルダ(`<データのフォルダ>/requests/<要望ID>/`)の変更も実装と同じコミットに入れる**。要望とタスク・変更の記録が
|
|
81
|
+
コードと一緒に残り、レビューで「何を頼まれ、何をしたか」を読める。入れるのはその要望のフォルダだけ(ほかの要望や関係ない変更を
|
|
82
|
+
まとめて add しない)。データのフォルダが外・別のリポジトリ・git で無視されている、または git の作業ツリー(worktree)で作業して
|
|
83
|
+
いてデータがメインの作業ツリーにあるときは、同じコミットには入らない(データの移動・写し・`git add -f` はしない。記録は p3 に
|
|
84
|
+
残り、コードとは成果物の URL で結ぶ)。commit・push に失敗したら、完了の記録はそのまま残し、公開できていないことをユーザーに
|
|
85
|
+
伝えてやり直す(完了を push できたことのように伝えない)
|
|
86
|
+
8. コミットや PR の URL を残すなら、後から `move T003 done --req <要望ID> --output <URL>` で足す(完了・記録・前の成果物はそのまま。
|
|
87
|
+
完了から戻さない)。要望のフォルダを同じコミットに入れているなら、この追記もコミットして同じブランチに push する(追記のコミット
|
|
88
|
+
自身の URL は残さなくてよい)。PR はユーザーに確認してから作る(本文に要望 ID とタスクの一覧)。作った PR の URL は最後のタスクに
|
|
89
|
+
足す。複数のリポジトリにまたがる要望は、関係するリポジトリの PR を全部 `--repo-output <参照先の名前>=<PR の URL>` で最後のタスクに
|
|
90
|
+
残す(例: `move T005 done --repo-output app=<URL> --repo-output infra=<URL>`。1つのリポジトリなら今までどおり `--output` でよい)。
|
|
78
91
|
マージ・要望の完了済(`done`)は人が行う
|
|
79
|
-
|
|
92
|
+
9. 対応済の後にタスクを足した・完了から戻したときは、要望は自動で進行中に戻る(`--json` の `reopened`)。
|
|
80
93
|
終えたらもう一度 6 で対応済にする
|
|
81
94
|
|
|
82
95
|
## してはいけないこと
|
package/src/cli/args.ts
CHANGED
|
@@ -14,6 +14,7 @@ import { Output } from "./output.ts";
|
|
|
14
14
|
const OPTIONS = {
|
|
15
15
|
dir: { type: "string" },
|
|
16
16
|
project: { type: "string" },
|
|
17
|
+
"all-projects": { type: "boolean" },
|
|
17
18
|
req: { type: "string" },
|
|
18
19
|
request: { type: "string" },
|
|
19
20
|
json: { type: "boolean" },
|
|
@@ -46,7 +47,9 @@ const OPTIONS = {
|
|
|
46
47
|
repo: { type: "string" },
|
|
47
48
|
description: { type: "string" },
|
|
48
49
|
instructions: { type: "string" },
|
|
49
|
-
agents
|
|
50
|
+
// 値なしの --agents は both(joinValues が --agents=both にする)
|
|
51
|
+
agents: { type: "string" },
|
|
52
|
+
force: { type: "boolean" },
|
|
50
53
|
"note-only": { type: "boolean" },
|
|
51
54
|
"archive-superseded": { type: "boolean" },
|
|
52
55
|
paste: { type: "boolean" },
|
|
@@ -73,7 +76,11 @@ function joinValues(argv: string[]): string[] {
|
|
|
73
76
|
for (let i = 0; i < argv.length; i++) {
|
|
74
77
|
const name = /^--([a-z]+)$/.exec(argv[i])?.[1];
|
|
75
78
|
const opt = name ? (OPTIONS as Record<string, { type: string }>)[name] : undefined;
|
|
76
|
-
if (
|
|
79
|
+
if (name === "agents") {
|
|
80
|
+
// 値は省ける(both)。次がオプション(- で始まる)か無ければ値なし。値は確かめる側(init)で断る
|
|
81
|
+
const next = argv[i + 1];
|
|
82
|
+
out.push(next !== undefined && !next.startsWith("-") ? `--agents=${argv[++i]}` : "--agents=both");
|
|
83
|
+
} else if (opt?.type === "string" && i + 1 < argv.length && !argv[i + 1].startsWith("--")) {
|
|
77
84
|
out.push(`${argv[i]}=${argv[++i]}`);
|
|
78
85
|
} else {
|
|
79
86
|
out.push(argv[i]);
|
package/src/cli/help.ts
CHANGED
|
@@ -7,10 +7,15 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
|
|
|
7
7
|
使い方: p3 <コマンド> [引数] [オプション]
|
|
8
8
|
|
|
9
9
|
プロジェクト
|
|
10
|
-
init
|
|
11
|
-
このリポジトリを本体の参照先として登録する。データの既定はリポジトリのルートの .p3
|
|
10
|
+
init 新しくプロジェクトを作る。管理したいリポジトリの中で実行し、データのフォルダを作って個人設定に登録する。
|
|
11
|
+
このリポジトリを本体の参照先として登録する。データの既定はリポジトリのルートの .p3(既にあれば作らずに断る → join)
|
|
12
12
|
--project 名前 --dir フォルダ(外に置くとき。相対は今いる場所から)--repo-name 参照先の名前(既定はフォルダ名)--description
|
|
13
|
-
--instructions 観点 --
|
|
13
|
+
--instructions 観点 --yes
|
|
14
|
+
--agents claude|codex|both AI 向けの使い方(スキルと AGENTS.md / CLAUDE.md の節)を置く先(値を省くと both。付けなければ置かない)
|
|
15
|
+
agents claude|codex|both [--force] AI 向けの使い方を、今いるリポジトリに後から置く・最新にする(選んだ先だけ。データ・個人設定は変えない)
|
|
16
|
+
違うものは上書きせず知らせる。--force で選んだ先のスキルと p3 の節だけを同梱の版にする(ほかの文は残す)
|
|
17
|
+
join 既にあるプロジェクト(共有されたデータのフォルダ)に参加する。個人設定に登録するだけで、データ・リポジトリのファイルは変えない
|
|
18
|
+
--project 名前 --dir フォルダ(既定はリポジトリのルートの .p3)--repo-name 参照先の名前(共有の定義にあるもの)--yes
|
|
14
19
|
project [ls | add <名前> <フォルダ> | rm <名前>] 個人設定のプロジェクト
|
|
15
20
|
config [set キー=値 ...] 設定の表示・変更(name description branchPattern instructions)
|
|
16
21
|
repo [ls | add | set | path | rm] Preflight が読む参照先(リポジトリ・フォルダ。数と名前は自由)
|
|
@@ -31,10 +36,14 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
|
|
|
31
36
|
release-notes save <id> 本文を保存する --body 本文|- / --file 本文.md --based-on <材料の hash>(生成の案を元にしたとき)
|
|
32
37
|
既にあるノートの更新は --version <版>(show で見る。違えば競合で終了コード 3)
|
|
33
38
|
release-notes export <id> 保存した本文だけを stdout に出す(出典・frontmatter は出さない)
|
|
39
|
+
release-notes complete-requests <id> --based-on <hash>
|
|
40
|
+
対応済の要望を一括で完了済にする(見送り以外の全要望が全タスク完了のときだけ。タスクの済みは変えない)。
|
|
41
|
+
できるか・対象・hash は show で見る。材料が変わっていれば何も変えずに終了コード 3、途中で止まったら非ゼロ
|
|
34
42
|
例: p3 release-notes generate v0.2 > draft.md → 直す → p3 release-notes save v0.2 --file draft.md
|
|
35
43
|
p3 release-notes export v0.2 > RELEASE.md
|
|
36
44
|
whoami 操作するプロジェクト・変更者・今の要望
|
|
37
45
|
serve [--port] [--host] ブラウザ用のビューアを起動(既定は個人設定の serve.port / serve.host か $P3_PORT / $P3_HOST)
|
|
46
|
+
--all-projects 個人設定に登録したプロジェクトを跨いで扱う(画面で選ぶ。--project / --dir とは一緒に使えない)
|
|
38
47
|
chatgpt login | status | logout Preflight に使う ChatGPT プランの接続(このマシン。プロジェクトに属さない)
|
|
39
48
|
login: --paste(コールバックに届かないとき URL を貼る)--no-browser --port 1455
|
|
40
49
|
logout: --forget(このマシンの登録ごと消す)
|
package/src/cli/main.ts
CHANGED
|
@@ -4,7 +4,7 @@ import { openProject } from "../core/context.ts";
|
|
|
4
4
|
import { machineSettingsSource, resolveMachineSettings, SettingsError } from "../core/machineSettings.ts";
|
|
5
5
|
import { progress, resolveRef, resolveRequestId, titleOf } from "../core/ops.ts";
|
|
6
6
|
import { OpRuleError } from "../core/requestOps.ts";
|
|
7
|
-
import { startServer } from "../server/server.ts";
|
|
7
|
+
import { startServer, type RunningServer } from "../server/server.ts";
|
|
8
8
|
import { ConflictError, NotFoundError } from "../core/store/collection.ts";
|
|
9
9
|
import { DataDirError, onlyRegistrationNotice, ProjectNotResolvedError, resolveProject, VIA_LABEL } from "../core/store/locate.ts";
|
|
10
10
|
import { loadUserConfig, UserConfigError } from "../core/userConfig.ts";
|
|
@@ -12,7 +12,7 @@ import { codexCommand } from "./codex.ts";
|
|
|
12
12
|
import { userConfigCommand } from "./userConfig.ts";
|
|
13
13
|
import { chatgptCommand } from "./chatgpt.ts";
|
|
14
14
|
import { table } from "./format.ts";
|
|
15
|
-
import { config, currentRequest, init, locateHere, projectCommand, repoCommand, resolveActor, UsageError } from "./project.ts";
|
|
15
|
+
import { config, currentRequest, init, isAgentChoice, joinProject, locateHere, placeAgents, projectCommand, repoCommand, repoRoot, resolveActor, UsageError } from "./project.ts";
|
|
16
16
|
import { HELP } from "./help.ts";
|
|
17
17
|
import { readsOnly } from "./readOnly.ts";
|
|
18
18
|
import { parse, type CommandEnv } from "./args.ts";
|
|
@@ -22,6 +22,7 @@ import { taskCommand } from "./taskCommands.ts";
|
|
|
22
22
|
import { preflightCommand } from "./preflightCommands.ts";
|
|
23
23
|
import { releaseNotesCommand } from "./releaseNotesCommands.ts";
|
|
24
24
|
import { ReleaseNoteError } from "../core/releaseNotes/store.ts";
|
|
25
|
+
import { sortMilestones } from "../shared/milestoneOrder.ts";
|
|
25
26
|
import { GenerationRejected } from "../core/releaseNotes/generate.ts";
|
|
26
27
|
|
|
27
28
|
/**
|
|
@@ -36,6 +37,33 @@ import { GenerationRejected } from "../core/releaseNotes/generate.ts";
|
|
|
36
37
|
* または要望の作業ツリー(ブランチ req/<要望ID>-...)から決まる。
|
|
37
38
|
*/
|
|
38
39
|
|
|
40
|
+
/**
|
|
41
|
+
* SIGTERM(docker stop)・SIGINT(Ctrl-C)で止める。新しい要求を断り、実行中の Preflight・生成を取り消して終わるまで待ってから終わる。
|
|
42
|
+
* 2回目の信号ではすぐ終わる
|
|
43
|
+
*/
|
|
44
|
+
function serveUntilSignal(server: RunningServer): Promise<number> {
|
|
45
|
+
return new Promise<number>((done) => {
|
|
46
|
+
let stopping = false;
|
|
47
|
+
const stop = (signal: string) => {
|
|
48
|
+
if (stopping) return done(1);
|
|
49
|
+
stopping = true;
|
|
50
|
+
process.stderr.write(`p3: ${signal} を受けたので止めます(実行中の Preflight・生成は取り消して記録します)\n`);
|
|
51
|
+
void (async () => {
|
|
52
|
+
try {
|
|
53
|
+
const { pending } = await server.close();
|
|
54
|
+
if (pending) process.stderr.write(`p3: 待ちきれずに止めました(終わっていない実行 ${pending} 件)\n`);
|
|
55
|
+
done(pending ? 1 : 0);
|
|
56
|
+
} catch (e) {
|
|
57
|
+
process.stderr.write(`p3: 止める途中で失敗しました: ${(e as Error).message}\n`);
|
|
58
|
+
done(1);
|
|
59
|
+
}
|
|
60
|
+
})();
|
|
61
|
+
};
|
|
62
|
+
process.on("SIGTERM", () => stop("SIGTERM"));
|
|
63
|
+
process.on("SIGINT", () => stop("SIGINT"));
|
|
64
|
+
});
|
|
65
|
+
}
|
|
66
|
+
|
|
39
67
|
async function main(argv: string[]): Promise<number> {
|
|
40
68
|
const { values: o, positionals } = parse(argv);
|
|
41
69
|
const [cmd, ...args] = positionals;
|
|
@@ -46,7 +74,48 @@ async function main(argv: string[]): Promise<number> {
|
|
|
46
74
|
const cwd = process.cwd();
|
|
47
75
|
const out = new Output(o.json ?? false);
|
|
48
76
|
|
|
77
|
+
// --force は p3 agents だけ(ほかのコマンドで黙って無視しない)
|
|
78
|
+
if (o.force && cmd !== "agents") throw new UsageError("--force は p3 agents でだけ使えます");
|
|
79
|
+
// --all-projects は serve だけ。1つのプロジェクトを決める指定とは一緒に使えない(どちらかに黙って決めない)
|
|
80
|
+
if (o["all-projects"]) {
|
|
81
|
+
if (cmd !== "serve") throw new UsageError("--all-projects は p3 serve でだけ使えます");
|
|
82
|
+
if (o.project !== undefined || o.dir !== undefined) {
|
|
83
|
+
throw new UsageError("--all-projects と --project / --dir は一緒に使えません(1つのプロジェクトだけを開くなら --all-projects を外す)");
|
|
84
|
+
}
|
|
85
|
+
// プロジェクトを決めずに起動する(個人設定が壊れていても、画面で理由を見せて直せるように起動する)
|
|
86
|
+
const user = await loadUserConfig().catch((e: Error) => {
|
|
87
|
+
process.stderr.write(`⚠ ${e.message}(待ち受けは既定の値で起動します)\n`);
|
|
88
|
+
return { settings: {} };
|
|
89
|
+
});
|
|
90
|
+
const settings = resolveMachineSettings(user, process.env, { port: o.port, host: o.host });
|
|
91
|
+
const source = machineSettingsSource({ cli: { port: o.port, host: o.host } });
|
|
92
|
+
return serveUntilSignal(await startServer({ allProjects: true, port: settings.serve.port, host: settings.serve.host, static: true, settings: source }));
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
// AI 向けの使い方を置く・最新にする。今いるリポジトリのルートに置くだけで、プロジェクトは決めない(データ・個人設定は変えない)
|
|
96
|
+
if (cmd === "agents") {
|
|
97
|
+
const [choice, ...rest] = args;
|
|
98
|
+
const usage = "p3 agents claude|codex|both [--force](置く先を選ぶ。省けません)";
|
|
99
|
+
if (!isAgentChoice(choice) || rest.length) throw new UsageError(choice === undefined ? `置く先を指定してください: ${usage}` : `置く先は claude / codex / both のどれか: ${[choice, ...rest].join(" ")}(${usage})`);
|
|
100
|
+
if (o.agents !== undefined) throw new UsageError(`p3 agents に --agents は要りません(${usage})`);
|
|
101
|
+
const root = repoRoot(cwd);
|
|
102
|
+
console.log([`AI 向けの使い方(${root})`, ...(await placeAgents(root, cwd, choice, o.force))].join("\n"));
|
|
103
|
+
return 0;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
if (cmd === "join") {
|
|
107
|
+
// 参加は個人設定に登録するだけ。AI 向けのファイルと、作るときだけの項目は受け付けない(黙って無視しない)
|
|
108
|
+
if (o.agents !== undefined) throw new UsageError("join は AI 向けのファイルを置きません(--agents は使えません)。置く・最新にするなら p3 agents claude|codex|both");
|
|
109
|
+
const createOnly = (["name", "description", "instructions"] as const).filter((k) => o[k] !== undefined);
|
|
110
|
+
if (createOnly.length) throw new UsageError(`join では ${createOnly.map((k) => `--${k}`).join("・")} は使えません(共有の定義は変えません。変えるなら p3 config set)`);
|
|
111
|
+
if (args.length) throw new UsageError(`join は位置引数を取りません: ${args.join(" ")}(p3 join [--project <名前>] [--dir <フォルダ>] [--repo-name <名前>])`);
|
|
112
|
+
console.log(await joinProject({ cwd, project: o.project, dir: o.dir, repoName: o["repo-name"], yes: o.yes }));
|
|
113
|
+
return 0;
|
|
114
|
+
}
|
|
115
|
+
|
|
49
116
|
if (cmd === "init") {
|
|
117
|
+
if (o.agents !== undefined && !isAgentChoice(o.agents)) throw new UsageError(`--agents は claude / codex / both のどれか(値を省くと both): ${o.agents || "(空)"}`);
|
|
118
|
+
if (args.length) throw new UsageError(`init は位置引数を取りません: ${args.join(" ")}`);
|
|
50
119
|
console.log(
|
|
51
120
|
await init({
|
|
52
121
|
cwd,
|
|
@@ -115,8 +184,9 @@ async function main(argv: string[]): Promise<number> {
|
|
|
115
184
|
if (cmd === "serve") {
|
|
116
185
|
// 待ち受け(host / port)は起動のときに決める。Codex と Preflight の設定は Preflight を始めるたびに個人設定から読み直す
|
|
117
186
|
const source = machineSettingsSource({ cli: { port: o.port, host: o.host } });
|
|
118
|
-
|
|
119
|
-
|
|
187
|
+
return serveUntilSignal(
|
|
188
|
+
await startServer({ dataDir: target.dataDir, repos: target.repos, projectName: target.name, port: settings.serve.port, host: settings.serve.host, static: true, settings: source }),
|
|
189
|
+
);
|
|
120
190
|
}
|
|
121
191
|
|
|
122
192
|
const ctx = await openProject(target.dataDir, { repos: target.repos, settings, projectName: target.name });
|
|
@@ -180,7 +250,7 @@ async function main(argv: string[]): Promise<number> {
|
|
|
180
250
|
const today = localToday();
|
|
181
251
|
return out.result(ps, () => {
|
|
182
252
|
const groups = [
|
|
183
|
-
...ctx.ws.project.milestones.map((m) => ({ m, ps: ps.filter((p) => p.request.milestone === m.id) })),
|
|
253
|
+
...sortMilestones(ctx.ws.project.milestones).map((m) => ({ m, ps: ps.filter((p) => p.request.milestone === m.id) })),
|
|
184
254
|
{ m: undefined, ps: ps.filter((p) => !p.request.milestone) },
|
|
185
255
|
];
|
|
186
256
|
return (
|
package/src/cli/output.ts
CHANGED
|
@@ -5,6 +5,7 @@ import { resolve, titleOf } from "../core/ops.ts";
|
|
|
5
5
|
import { type Warning } from "../core/supersede.ts";
|
|
6
6
|
import { table } from "./format.ts";
|
|
7
7
|
import { taskWork } from "../core/workTargets.ts";
|
|
8
|
+
import { DIRECT_TASK_NOTE, LATER_PREFLIGHT_NOTE } from "../shared/directTask.ts";
|
|
8
9
|
|
|
9
10
|
/** CLI の出力(人向けの表と --json)と、表示の部品 */
|
|
10
11
|
|
|
@@ -67,6 +68,23 @@ export function reopenedNote(rid: string | undefined): string | undefined {
|
|
|
67
68
|
return rid;
|
|
68
69
|
}
|
|
69
70
|
|
|
71
|
+
/** シェルにそのまま貼れる引数(記号や空白を含むものは単引用符で囲む) */
|
|
72
|
+
export const shellArg = (s: string) => (/^[\w./:=@%+-]+$/.test(s) ? s : `'${s.replace(/'/g, `'\\''`)}'`);
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* Preflight を始められなかった・失敗したときの、直接タスクを作る道の案内(人向け。stderr か、エラーの文に付けて出す)。
|
|
76
|
+
* --project / --dir を付けて呼ばれたら、同じ対象で動くようにそのまま付ける
|
|
77
|
+
*/
|
|
78
|
+
export function directTaskHint(rid: string, scope: { project?: string; dir?: string } = {}): string {
|
|
79
|
+
const target = [scope.project && `--project ${shellArg(scope.project)}`, scope.dir && `--dir ${shellArg(scope.dir)}`].filter(Boolean).join(" ");
|
|
80
|
+
return [
|
|
81
|
+
"Preflight を通さずに、この要望へタスクを直接作ることもできます(Docker や ChatGPT の接続は要りません):",
|
|
82
|
+
` p3 new "タスクの題" --req ${shellArg(rid)}${target ? ` ${target}` : ""} --body "作業内容と完了条件"`,
|
|
83
|
+
` ${DIRECT_TASK_NOTE}`,
|
|
84
|
+
` ${LATER_PREFLIGHT_NOTE}(p3 preflight ${shellArg(rid)})`,
|
|
85
|
+
].join("\n");
|
|
86
|
+
}
|
|
87
|
+
|
|
70
88
|
/** 警告は stderr に出す(--json の stdout を汚さない。JSON では warnings フィールドで返す) */
|
|
71
89
|
export const warn = (warnings: Warning[]) => {
|
|
72
90
|
for (const w of warnings) process.stderr.write(`警告: ${w.message}\n`);
|
|
@@ -10,7 +10,9 @@ import { UsageError } from "./project.ts";
|
|
|
10
10
|
import { StaleInputError, staleMessage } from "../core/preflight/input.ts";
|
|
11
11
|
import { changedLabel, isMaterialized } from "../shared/preflightInput.ts";
|
|
12
12
|
import { readBody, type CommandEnv } from "./args.ts";
|
|
13
|
-
import { deps, indent } from "./output.ts";
|
|
13
|
+
import { deps, directTaskHint, indent } from "./output.ts";
|
|
14
|
+
import { PreflightBusyError } from "../core/preflight/service.ts";
|
|
15
|
+
import { preflightFailed } from "../shared/directTask.ts";
|
|
14
16
|
|
|
15
17
|
/** Preflight のコマンド(preflight / attach / notes / drafts / accept)。扱わないコマンドは undefined */
|
|
16
18
|
|
|
@@ -29,16 +31,22 @@ export async function preflightCommand(cmd: string, env: CommandEnv): Promise<nu
|
|
|
29
31
|
const off = ctx.ws.on((e) => {
|
|
30
32
|
if (e.type === "preflight-log" && !out.json) process.stderr.write(`${e.entry.at.slice(11, 19)} ${e.entry.text}\n`);
|
|
31
33
|
});
|
|
34
|
+
const hint = () => directTaskHint(rid, { project: o.project, dir: o.dir });
|
|
32
35
|
const started = await ctx.preflight.start(rid, { engine, actor }).catch((e: Error) => {
|
|
33
36
|
off();
|
|
34
37
|
// メモは残っているので、書き直さずに p3 preflight だけで再実行できる
|
|
35
|
-
|
|
38
|
+
const err = note ? new Error(`${e.message}(メモ ${note.id} は保存済みです。p3 preflight ${rid} で再実行できます)`) : e;
|
|
39
|
+
// 始められなかったら直接作る道を添える(実行中・要望が無いときは別の理由なので添えない。終了コードは変えない)
|
|
40
|
+
if (!(e instanceof PreflightBusyError) && !(e instanceof NotFoundError)) err.message += `\n${hint()}`;
|
|
41
|
+
throw err;
|
|
36
42
|
});
|
|
37
43
|
if (!out.json) process.stderr.write(`preflight ${started.id} (${started.engine})\n`);
|
|
38
44
|
const run = await ctx.preflight.wait(rid, started.id);
|
|
39
45
|
off();
|
|
40
46
|
if (!run) throw new Error("preflight の結果が読めません");
|
|
41
47
|
out.result(run, () => formatRun(ctx, rid, run));
|
|
48
|
+
// 失敗したら直接作る道を stderr に出す(--json の stdout は変えない。取消は失敗と扱わない)
|
|
49
|
+
if (preflightFailed(run)) process.stderr.write(`${hint()}\n`);
|
|
42
50
|
return run.status === "completed" ? 0 : 1;
|
|
43
51
|
}
|
|
44
52
|
|