@infodb/p3 0.12.0 → 0.13.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 +32 -35
- package/dist/web/assets/CompletionReview-gZKZrDu_.js +1 -0
- package/dist/web/assets/ImprovementDialog-Dno6dPnG.js +1 -0
- package/dist/web/assets/Outputs-BgHalMGb.js +1 -0
- package/dist/web/assets/RequestStatus-hZcBUUIu.js +1 -0
- package/dist/web/assets/Tabs-C3NmwCc3.js +1 -0
- package/dist/web/assets/TagInput-B2b862qn.js +1 -0
- package/dist/web/assets/TaskDrawer-4BQBELXa.js +6 -0
- package/dist/web/assets/_requestId-BMAG1t3o.js +1 -0
- package/dist/web/assets/_requestId-tbg2pA2S.js +1 -0
- package/dist/web/assets/archive-DMl6WyOe.js +1 -0
- package/dist/web/assets/board-BMTcHKyt.js +1 -0
- package/dist/web/assets/done-CL6Nlsua.js +1 -0
- package/dist/web/assets/draft-BvGxfD7v.js +2 -0
- package/dist/web/assets/index-Dp7Fc4VI.css +2 -0
- package/dist/web/assets/index-KdlgMitg.js +12 -0
- package/dist/web/assets/metrics-Cu7gJ7Rk.js +1 -0
- package/dist/web/assets/new-DTXWHuFO.js +1 -0
- package/dist/web/assets/outputs-CXqnjSqV.js +1 -0
- package/dist/web/assets/preflightInput-ClKwkp8R.js +2 -0
- package/dist/web/assets/preload-helper-oLCrNCwz.js +1 -0
- package/dist/web/assets/{quality-Pu6EISAM.js → quality-RFd-7k3r.js} +1 -1
- package/dist/web/assets/release-notes-Bpdi6RdY.js +5 -0
- package/dist/web/assets/requestData-CbFxwW5w.js +1 -0
- package/dist/web/assets/routes-BIt8bExF.js +6 -0
- package/dist/web/assets/settings-CsCqF_1B.js +1 -0
- package/dist/web/assets/ui-BGK72r3u.js +1 -0
- package/dist/web/assets/workTarget-CySfKyfB.js +30 -0
- package/dist/web/index.html +4 -4
- package/docs/architecture.md +300 -36
- package/docs/development.md +60 -16
- package/docs/how-to-use.md +381 -28
- package/docs/installation.md +235 -144
- package/docs/publishing.md +1 -1
- package/lib/cli/agentsStatus.js +197 -0
- package/lib/cli/args.js +72 -8
- package/lib/cli/guide.js +27 -0
- package/lib/cli/guide.md +214 -0
- package/lib/cli/help.js +44 -6
- package/lib/cli/main.js +76 -20
- package/lib/cli/metricsCommands.js +77 -0
- package/lib/cli/output.js +12 -2
- package/lib/cli/project.js +13 -27
- package/lib/cli/qualityCommands.js +33 -8
- package/lib/cli/readOnly.js +15 -0
- package/lib/cli/requestCommands.js +21 -4
- package/lib/cli/requirementCommands.js +288 -0
- package/lib/cli/retroCommands.js +106 -0
- package/lib/cli/revisitCommands.js +73 -0
- package/lib/cli/showView.js +119 -6
- package/lib/cli/taskCommands.js +42 -16
- package/lib/cli/userConfig.js +47 -0
- package/lib/core/completionRefs.js +46 -0
- package/lib/core/metrics/definitions.js +434 -0
- package/lib/core/metrics/index.js +88 -0
- package/lib/core/metrics/manual.js +180 -0
- package/lib/core/ops.js +15 -2
- package/lib/core/preflight/carryover.js +5 -1
- package/lib/core/preflight/codexEngine.js +34 -17
- package/lib/core/preflight/diagnose.js +4 -9
- package/lib/core/preflight/engine.js +9 -0
- package/lib/core/preflight/hostPaths.js +260 -0
- package/lib/core/preflight/input.js +33 -5
- package/lib/core/preflight/instructions.js +18 -1
- package/lib/core/preflight/mockEngine.js +20 -2
- package/lib/core/preflight/render.js +22 -3
- package/lib/core/preflight/service.js +59 -9
- package/lib/core/preflight/uiRender.js +3 -0
- package/lib/core/requestOps.js +206 -14
- package/lib/core/retrospective.js +208 -0
- package/lib/core/reviewCandidates.js +56 -0
- package/lib/core/store/collection.js +20 -1
- package/lib/core/store/normalize.js +22 -4
- package/lib/core/store/preflightStore.js +19 -5
- package/lib/core/store/workspace.js +17 -1
- package/lib/core/taskReview/material.js +7 -0
- package/lib/core/taskReview/review.js +9 -2
- package/lib/server/api/manifest.js +51 -3
- package/lib/server/api/routes.js +131 -11
- package/lib/shared/acceptance.js +258 -18
- package/lib/shared/completionRecord.js +327 -0
- package/lib/shared/metrics.js +42 -0
- package/lib/shared/preflightInput.js +1 -1
- package/lib/shared/requirementSource.js +635 -0
- package/lib/shared/retrospective.js +286 -0
- package/lib/shared/reviewCandidate.js +308 -0
- package/lib/shared/reworkHistory.js +81 -0
- package/package.json +3 -2
- package/skills/p3/SKILL.md +9 -181
- package/dist/web/assets/ImprovementDialog-kQaVBGWH.js +0 -1
- package/dist/web/assets/Outputs-_nU_p3nu.js +0 -1
- package/dist/web/assets/RequestStatus-RG-OVQYY.js +0 -1
- package/dist/web/assets/Tabs-ew9i5SKX.js +0 -1
- package/dist/web/assets/TagInput-BtlJTF7i.js +0 -1
- package/dist/web/assets/TaskDrawer-DW8GyJqI.js +0 -6
- package/dist/web/assets/_requestId-6Nb727dD.js +0 -1
- package/dist/web/assets/_requestId-BykTgPax.js +0 -1
- package/dist/web/assets/appCtx-CxDdXABS.js +0 -1
- package/dist/web/assets/archive-Ckh295Xe.js +0 -1
- package/dist/web/assets/board-BVAIjK-Y.js +0 -1
- package/dist/web/assets/done-BGfA-3MA.js +0 -1
- package/dist/web/assets/draft-CfJeyLOl.js +0 -1
- package/dist/web/assets/index-CgRU744I.css +0 -2
- package/dist/web/assets/index-DacQ0yl4.js +0 -12
- package/dist/web/assets/new-DVygWvVc.js +0 -1
- package/dist/web/assets/outputs-B6xDsLZf.js +0 -1
- package/dist/web/assets/preflightInput-BAeEJYUK.js +0 -2
- package/dist/web/assets/preload-helper-DyCqp21K.js +0 -1
- package/dist/web/assets/release-notes-CCpzyiNf.js +0 -5
- package/dist/web/assets/requestData-D5vBnuMh.js +0 -1
- package/dist/web/assets/routes-Q91zvNc0.js +0 -4
- package/dist/web/assets/settings-BzRgcmUm.js +0 -1
- package/dist/web/assets/workTarget-C9c57JAO.js +0 -30
package/docs/installation.md
CHANGED
|
@@ -1,92 +1,67 @@
|
|
|
1
1
|
# 導入ガイド
|
|
2
2
|
|
|
3
|
-
infodb p3(以下 P3
|
|
4
|
-
[使い方ガイド](how-to-use.md) へ続く。
|
|
3
|
+
infodb p3(以下 P3)を使い始めるまでの手順。全部を一度にそろえなくてよい。段階 0 だけで要望とタスクを使い始められ、
|
|
4
|
+
段階 1・2 は必要になってから足す。要望を作ってからの使い方は [使い方ガイド](how-to-use.md) へ続く。
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
6
|
+
| 段階 | すること | できるようになること | 要るもの |
|
|
7
|
+
| --- | --- | --- | --- |
|
|
8
|
+
| [0](#段階-0-要望とタスクを使う) | プロジェクトに参加する(か新しく作る)・画面を開く | 要望とタスクを書いて進める | Node.js と Git |
|
|
9
|
+
| [1](#段階-1-preflight-を足す) | Preflight の評価のしかたを選んで準備する | 要望をタスクにする前に、リポジトリを読んだ評価とタスク案を受け取る | Codex で評価するなら Docker と ChatGPT。手元の AI エージェントで評価するなら足すものは無い |
|
|
10
|
+
| [2](#段階-2-必要になったら足す) | 品質基準・レビューなどを、要るものだけ足す | 守る水準の確認・完了したタスクやマイルストーンの確かめ | 機能による(段階 2 の表) |
|
|
8
11
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
([使い方ガイド: Preflight を通さずにタスクを作る](how-to-use.md#preflight-を通さずにタスクを作る))。Preflight を Claude Code などの手元の対話エージェントに
|
|
12
|
-
頼むなら Docker と ChatGPT は要らない(画面イメージの描画だけ Docker を使う。[使い方ガイド: 手元の対話エージェントで Preflight する](how-to-use.md#手元の対話エージェントで-preflight-する))。
|
|
12
|
+
この文書の例では `npx @infodb/p3` と書く(Node.js に付いてくる npm の `npx`。pnpm があれば `pnpx @infodb/p3` でも同じ)。
|
|
13
|
+
`pnpm add -g @infodb/p3` / `npm i -g @infodb/p3` で入れたなら `p3` に読み替える。
|
|
13
14
|
|
|
14
|
-
##
|
|
15
|
+
## 段階 0: 要望とタスクを使う
|
|
15
16
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
| 1 | 必要なものをそろえる | `node -v` が 24 以上(推奨 26)、`git --version`、`docker version` が通る |
|
|
19
|
-
| 2 | どこで P3 を動かすか決める(ホスト / DevContainer) | 下の「動かす場所」のどちらかに当てはまる |
|
|
20
|
-
| 3 | Docker に繋がるか確かめる | `docker version` に **Client と Server の両方** が出る |
|
|
21
|
-
| 4 | プロジェクトを作る(か参加する) | `p3 whoami` にプロジェクトとデータのフォルダが出る |
|
|
22
|
-
| 5 | (DevContainer のときだけ)パスの対応を書く | `p3 user-config` の `codex.pathMap` に、リポジトリとデータの両方の対応がある |
|
|
23
|
-
| 6 | ChatGPT に接続する | `p3 chatgpt status` が「ChatGPT プランを使います」 |
|
|
24
|
-
| 7 | Codex のイメージを作る | `p3 codex update` が「Codex を更新しました: codex-cli …」 |
|
|
25
|
-
| 8 | 画面を開いて、試しに Preflight を動かす | 評価とタスク案が出る |
|
|
17
|
+
**すること**: プロジェクトに参加する(か新しく作る)・画面を開く。**できるようになること**: 要望とタスクを書いて進める。
|
|
18
|
+
Docker・ChatGPT・パスの設定は要らない。
|
|
26
19
|
|
|
27
|
-
|
|
20
|
+
要るのは **Node.js 24 以上(推奨 26)** と **Git**(`node -v` と `git --version` で確かめる)。版の補足は後の「[Node.js の版](#補足-nodejs-の版と同じ版で動かすこと)」。
|
|
28
21
|
|
|
29
|
-
|
|
22
|
+
### 参加する(ほかの人が作ったプロジェクト)
|
|
30
23
|
|
|
31
|
-
|
|
32
|
-
| --- | --- | --- |
|
|
33
|
-
| Node.js 24 以上(推奨 26) | P3 本体(CLI と `p3 serve`) | `node -v` |
|
|
34
|
-
| pnpm(`pnpx`)か npm(`npx`) | P3 を入れずに動かす。`pnpm add -g @infodb/p3` / `npm i -g @infodb/p3` で `p3` コマンドにしてもよい | `pnpm -v` / `npm -v` |
|
|
35
|
-
| Git | 管理したいリポジトリと、要望ごとのブランチ。Preflight の Codex も履歴を読む | `git --version` |
|
|
36
|
-
| Docker(CLI とデーモン) | Preflight の Codex を、リポジトリとデータのフォルダだけを見せたコンテナの中で動かす。画面イメージの描画にも使う | `docker version`(下の 3.) |
|
|
37
|
-
| ChatGPT のアカウント(プラン) | Preflight の Codex をその人のアカウントで動かす | 6. で接続する |
|
|
24
|
+
共有されたリポジトリを取得してある(`git clone` 済み)なら、3つで始められる。
|
|
38
25
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
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 のまま)
|
|
46
|
-
- 以下の例では `p3` と書く。入れていなければ `pnpx @infodb/p3`(または `npx @infodb/p3`)に読み替える
|
|
47
|
-
- 同じデータを使う人と AI は、なるべく同じ版で動かす(`pnpx @infodb/p3@<版>` のように版を付けられる。`pnpx` は取った版をしばらく
|
|
48
|
-
使い続ける)。古い版で更新すると、新しい版で足した項目が消えることがある([データの形](architecture.md#データの形))
|
|
26
|
+
1. そのリポジトリのフォルダに移る: `cd ~/src/myapp`
|
|
27
|
+
2. 参加する: `npx @infodb/p3 join --yes`
|
|
28
|
+
3. 画面を開く: `npx @infodb/p3 serve` を実行したまま、ブラウザで http://localhost:4310 を開く
|
|
49
29
|
|
|
50
|
-
|
|
30
|
+
**できたと分かる目安**: ブラウザに、そのプロジェクトの「進捗」(要望の一覧)が出る。
|
|
51
31
|
|
|
52
|
-
|
|
53
|
-
|
|
32
|
+
- `join` は、このマシンの個人設定にプロジェクトを登録するだけ。データ(要望・タスク)とリポジトリのファイルは書かない。
|
|
33
|
+
データを取ってくることも、同期することもしない(データはリポジトリの `.p3` なら `git pull` で、共有ドライブなら同期で届く)
|
|
34
|
+
- データがリポジトリの外(共有ドライブなど)にあるプロジェクトでは、その場所を指定する: `npx @infodb/p3 join --yes --dir ~/p3-data/myapp`。
|
|
35
|
+
どこにあるかはプロジェクトを作った人に聞く
|
|
36
|
+
- 詳しい決まりは後の「[参加の決まり](#参加の決まり)」
|
|
54
37
|
|
|
55
|
-
|
|
56
|
-
| --- | --- | --- |
|
|
57
|
-
| P3 から見たパス(このマシンのパス) | `/workspaces/myapp` | `p3` を動かしている場所でのパス。個人設定に登録する |
|
|
58
|
-
| Docker のデーモン(ホスト)から見たパス | `/home/me/workspaces/myapp` | コンテナを作るのはデーモンなので、マウントはこのパスで指定する |
|
|
59
|
-
| Codex のコンテナの中のパス | `/workspace/myapp`、`/data` | 参照先は `/workspace/<名前>`(読むだけ)、データのフォルダは `/data` |
|
|
38
|
+
### 新しく作る
|
|
60
39
|
|
|
61
|
-
|
|
40
|
+
管理したいリポジトリの中で:
|
|
62
41
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
パスが違うので、5. でその対応(`codex.pathMap`)を書く。データのフォルダも、ホストから見える(バインドマウントされた)場所に置く
|
|
42
|
+
1. `cd ~/src/myapp`
|
|
43
|
+
2. 作る: `npx @infodb/p3 init --yes`(リポジトリの `.p3` にデータのフォルダを作り、個人設定に登録する)
|
|
44
|
+
3. 画面を開く: `npx @infodb/p3 serve` を実行したまま、ブラウザで http://localhost:4310 を開く
|
|
67
45
|
|
|
68
|
-
|
|
69
|
-
> この文書の手順は A と B(VS Code の DevContainer と、そのホストの Docker)で書いている。ほかの形では、「Docker のデーモンから
|
|
70
|
-
> 見たパス」を自分の環境で確かめてから 5. の対応を書く。
|
|
46
|
+
**できたと分かる目安**: ブラウザに「進捗」(まだ要望が無い一覧)と「新しい要望」のボタンが出る。
|
|
71
47
|
|
|
72
|
-
|
|
48
|
+
- できた `.p3` をリポジトリに入れて共有すれば、ほかの人は上の「参加する」で加われる。git に入れるか(`.gitignore` に書くか)は
|
|
49
|
+
自分で決める(p3 は `.gitignore` を書き換えず、データをコミットもしない)
|
|
50
|
+
- 作るときの細かい選び方(データをリポジトリの外に置く・何のプロジェクトかを書く・AI 向けの入口を置く)は後の「[作るときに選べること](#作るときに選べること)」。
|
|
51
|
+
後から変えられるので、最初は `--yes` のままでよい
|
|
73
52
|
|
|
74
|
-
|
|
75
|
-
docker version --format 'Client {{.Client.Version}} / Server {{.Server.Version}}'
|
|
76
|
-
# Client 29.8.2 / Server 29.3.0 ← 両方出れば繋がっている
|
|
77
|
-
```
|
|
53
|
+
### 画面について
|
|
78
54
|
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
| `permission denied ... docker.sock` | ソケットを使う権限が無い。Linux なら利用者を `docker` グループに入れ直してログインし直す(または管理者に相談する) |
|
|
55
|
+
- 既定では `0.0.0.0:4310` で待つ(DevContainer の外から見るため)。画面には認証が無いので、信頼できないネットワークでは
|
|
56
|
+
`npx @infodb/p3 user-config set serve.host=127.0.0.1` で絞る。待ち受け(`serve.host` / `serve.port`)を変えたら serve を起動し直す
|
|
57
|
+
- **DevContainer:** 4310 をホストへ転送して、ホストのブラウザで開く
|
|
58
|
+
- 開けないときは「[うまくいかないとき](#うまくいかないとき)」
|
|
84
59
|
|
|
85
|
-
|
|
60
|
+
### 作るときに選べること
|
|
86
61
|
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
62
|
+
`init` は対話でも使える(`--yes` を付けなければ聞く)。データのフォルダの既定は **リポジトリのルートの `.p3`**
|
|
63
|
+
(git のメインの作業ツリーの直下。サブフォルダや要望の作業ツリーから実行してもそこ。git 管理外なら実行した場所の `.p3`)で、
|
|
64
|
+
ふつうはこのまま Enter で決める。
|
|
90
65
|
|
|
91
66
|
公開できない要望を含むときや、複数のリポジトリにまたがるプロジェクトをどのリポジトリとも別に管理したいときは、リポジトリの外の
|
|
92
67
|
フォルダを指定する(例: `~/p3-data/myapp`。チームで共有するなら同期するフォルダ)。相対パスは実行した場所から、`~` はホームから。
|
|
@@ -94,7 +69,7 @@ DevContainer で外に置くときは、ホストから見える(バインド
|
|
|
94
69
|
|
|
95
70
|
```bash
|
|
96
71
|
cd ~/src/myapp
|
|
97
|
-
p3 init
|
|
72
|
+
npx @infodb/p3 init
|
|
98
73
|
# プロジェクト名(切り替えに使う短い名前) [myapp]:
|
|
99
74
|
# データを置くフォルダ(相対パスは今いる場所から。リポジトリの外も指定できます) [/home/me/src/myapp/.p3]:
|
|
100
75
|
# 何を作っているプロジェクトか(Preflight の前提になります): 社内向けの経費精算アプリ
|
|
@@ -103,42 +78,40 @@ p3 init --agents
|
|
|
103
78
|
# Preflight を実行するのは(codex: 人が p3 から Codex で実行 / agent: 頼まれた手元の AI エージェントが評価) [codex]:
|
|
104
79
|
|
|
105
80
|
# AI やスクリプトからは引数で(--yes で質問しない。--dir を付けなければリポジトリのルートの .p3)
|
|
106
|
-
p3 init --yes --agents --project myapp --description "社内向けの経費精算アプリ"
|
|
81
|
+
npx @infodb/p3 init --yes --agents --project myapp --description "社内向けの経費精算アプリ"
|
|
107
82
|
|
|
108
83
|
# リポジトリの外に置くなら --dir で指定する
|
|
109
|
-
p3 init --yes --agents --project myapp --dir ~/p3-data/myapp --description "社内向けの経費精算アプリ"
|
|
84
|
+
npx @infodb/p3 init --yes --agents --project myapp --dir ~/p3-data/myapp --description "社内向けの経費精算アプリ"
|
|
110
85
|
|
|
111
86
|
# Codex(ChatGPT のプラン)を使わず、Claude Code などの手元のエージェントに Preflight を頼むなら
|
|
112
|
-
p3 init --yes --agents claude --project myapp --preflight-runner agent --description "社内向けの経費精算アプリ"
|
|
87
|
+
npx @infodb/p3 init --yes --agents claude --project myapp --preflight-runner agent --description "社内向けの経費精算アプリ"
|
|
113
88
|
```
|
|
114
89
|
|
|
115
90
|
- データのフォルダには `project.yaml` と空の `requests/` ができる。このリポジトリは **本体の参照先**(Preflight が読むリポジトリ。
|
|
116
91
|
最初に読む・作業先にできる)として登録される
|
|
117
92
|
- `init` は新しく作るだけ。そのフォルダに既にプロジェクト(`project.yaml`)があれば、何も変えずに断って `p3 join` を案内する
|
|
118
|
-
-
|
|
119
|
-
|
|
120
|
-
- `--agents claude|codex|both` を付けると、AI エージェント向けの使い方を `AGENTS.md`(無ければ `CLAUDE.md`)に追記し、スキルを
|
|
121
|
-
選んだ先に置く: `claude` は `.claude/skills/p3/SKILL.md`(Claude Code)、`codex` は `.agents/skills/p3/SKILL.md`(Codex)、`both` は両方
|
|
93
|
+
- `--agents claude|codex|both` を付けると、AI エージェント向けの入口(手順は CLI の `p3 guide` から読ませる短い指示)を `AGENTS.md`
|
|
94
|
+
(無ければ `CLAUDE.md`)に追記し、スキルを選んだ先に置く: `claude` は `.claude/skills/p3/SKILL.md`(Claude Code)、`codex` は `.agents/skills/p3/SKILL.md`(Codex)、`both` は両方
|
|
122
95
|
(値を省くと both。付けなければ置かない。対話では聞き、Enter は置かない)。置いたファイルはリポジトリに入れて共有する。
|
|
123
|
-
作った後から置く・最新にするのは `p3 agents`([使い方ガイド](how-to-use.md) の「AI エージェントから使う」。`init --agents` を
|
|
96
|
+
作った後から置く・最新にするのは `p3 agents`([使い方ガイド](how-to-use.md#ai-エージェントから使う) の「AI エージェントから使う」。`init --agents` を
|
|
124
97
|
既にあるプロジェクトで実行し直しても置かない)
|
|
125
|
-
- **Preflight の担当**(`preflight.runner
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
「プロジェクトの設定」)
|
|
98
|
+
- **Preflight の担当**(`preflight.runner`。共有の設定)は段階 1 で選ぶ。`--yes` と Enter は `codex`。後から
|
|
99
|
+
`p3 config set preflight.runner=agent|codex` で変えられる([段階 1](#段階-1-preflight-を足す))
|
|
100
|
+
- 何のプロジェクトか(`description`)を `--yes` で省いたら、後から `p3 config set description="..."` で書ける(Preflight の精度に効く。
|
|
101
|
+
[使い方ガイド: プロジェクトの設定](how-to-use.md#プロジェクトの設定))
|
|
130
102
|
- 登録はこのマシンの **個人設定**(`~/.config/infodb-p3/config.yaml`。`XDG_CONFIG_HOME` があればその下。共有しない)に入る
|
|
131
103
|
|
|
132
|
-
###
|
|
104
|
+
### 参加の決まり
|
|
133
105
|
|
|
134
|
-
|
|
135
|
-
|
|
106
|
+
`p3 join` は、個人設定に「プロジェクト名 → データのフォルダ・このリポジトリのこのマシンのパス」を登録するだけで、
|
|
107
|
+
データ(`project.yaml`・要望)とリポジトリのファイル(スキル・`AGENTS.md` / `CLAUDE.md`)は書かない。
|
|
136
108
|
チームで消した AI 向けのファイルが、参加した人の操作で戻ることはない。
|
|
137
109
|
|
|
138
110
|
```bash
|
|
139
111
|
cd ~/src/myapp
|
|
140
|
-
p3 join --
|
|
141
|
-
p3 join --
|
|
112
|
+
npx @infodb/p3 join --yes # リポジトリの .p3 に入れて共有しているとき(既定はルートの .p3)
|
|
113
|
+
npx @infodb/p3 join --yes --dir ~/p3-data/myapp # リポジトリの外のフォルダ(共有ドライブなど)のとき
|
|
114
|
+
npx @infodb/p3 join --yes --project myapp # このマシンで使う名前を決める(省くとフォルダ名)
|
|
142
115
|
```
|
|
143
116
|
|
|
144
117
|
- データのフォルダの決め方(既定・相対・`~`・絶対、サブフォルダや作業ツリーから実行してもルートの `.p3`)は `init` と同じ。
|
|
@@ -149,10 +122,10 @@ p3 join --project myapp --dir ~/p3-data/myapp # リポジトリの外の
|
|
|
149
122
|
新しく作るなら `init`)。同じ名前で別のフォルダは断る。同じ参加をもう一度しても何も変えない
|
|
150
123
|
- `--agents` と、作るときだけの項目(`--name`・`--description`・`--instructions`・`--preflight-runner`)は使えない(共有の定義を変えるなら `p3 config set`)
|
|
151
124
|
|
|
152
|
-
|
|
125
|
+
### 登録を確かめる
|
|
153
126
|
|
|
154
127
|
```bash
|
|
155
|
-
p3 whoami
|
|
128
|
+
npx @infodb/p3 whoami
|
|
156
129
|
# プロジェクト myapp /home/me/src/myapp/.p3
|
|
157
130
|
# 決まり方 cwd(今いる場所)
|
|
158
131
|
# 今いる参照先 myapp ブランチ main
|
|
@@ -176,44 +149,142 @@ p3 --project myapp request new "通知" # どこからでも、明示
|
|
|
176
149
|
ほかのリポジトリ(ドキュメント・基盤など)も Preflight に読ませたいときは
|
|
177
150
|
[使い方ガイド](how-to-use.md#参照先と作業先) の「参照先と作業先」。
|
|
178
151
|
|
|
179
|
-
|
|
152
|
+
段階 0 のままでも、Preflight を通さずにタスクを作って進められる([使い方ガイド: Preflight を通さずにタスクを作る](how-to-use.md#preflight-を通さずにタスクを作る))。
|
|
180
153
|
|
|
181
|
-
|
|
154
|
+
## 段階 1: Preflight を足す
|
|
182
155
|
|
|
183
|
-
|
|
156
|
+
**すること**: Preflight の評価のしかたを選んで準備する。**できるようになること**: 要望をタスクにする前に、リポジトリと過去の経緯を
|
|
157
|
+
読んだ評価と、着手できる粒度のタスク案を受け取る。
|
|
184
158
|
|
|
185
|
-
|
|
159
|
+
### どちらで評価するか選ぶ
|
|
160
|
+
|
|
161
|
+
評価のしかたは、プロジェクトで1つ決める(**Preflight の担当**。`project.yaml` の `preflight.runner`。共有の設定)。
|
|
162
|
+
|
|
163
|
+
| 担当 | 評価するもの | 要る準備 |
|
|
164
|
+
| --- | --- | --- |
|
|
165
|
+
| `codex`(既定) | 人が `p3 preflight` か画面から実行し、Codex が評価する | Docker と ChatGPT のアカウント(プラン)。下の「[Codex で評価する](#codex-で評価する)」 |
|
|
166
|
+
| `agent` | 人がチャットで「Preflight して」と頼むと、Claude Code などの手元の AI エージェントが評価する | 足すものは無い(エージェントに入口を置く)。下の「[手元の AI エージェントで評価する](#手元の-ai-エージェントで評価する)」 |
|
|
186
167
|
|
|
187
168
|
```bash
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
# bind /home/me/workspaces → /workspaces ← Source がホスト、Destination がコンテナの中
|
|
191
|
-
# bind /mnt/usb/assets → /mnt/assets
|
|
192
|
-
# volume /var/lib/docker/volumes/xxx/_data → /home/me/.cache ← 名前付きボリューム(下の注意)
|
|
169
|
+
npx @infodb/p3 config set preflight.runner=agent # codex に戻すなら preflight.runner=codex
|
|
170
|
+
npx @infodb/p3 whoami # Preflight の行に今の担当が出る
|
|
193
171
|
```
|
|
194
172
|
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
173
|
+
担当の細かい決まりは [使い方ガイド: Preflight の担当](how-to-use.md#preflight-の担当)。作るときに `description`(何のプロジェクトか)を
|
|
174
|
+
省いたなら、ここで書いておくと評価の精度が上がる: `npx @infodb/p3 config set description="社内向けの経費精算アプリ"`。
|
|
175
|
+
|
|
176
|
+
### 手元の AI エージェントで評価する
|
|
177
|
+
|
|
178
|
+
Docker と ChatGPT は要らない。
|
|
179
|
+
|
|
180
|
+
1. AI エージェント向けの入口を置く(プロジェクトで1回。置いたファイルはリポジトリに入れて共有する):
|
|
181
|
+
`npx @infodb/p3 agents claude`(Codex なら `codex`、両方なら `both`。[使い方ガイド: AI エージェントから使う](how-to-use.md#ai-エージェントから使う))
|
|
182
|
+
2. 担当を `agent` にする: `npx @infodb/p3 config set preflight.runner=agent`
|
|
183
|
+
3. エージェントのチャットで頼む: 「要望 261009-k7m3x の Preflight をして」
|
|
184
|
+
|
|
185
|
+
- 評価とタスク案を書くのに Docker は使わない。ただし、画面イメージ(評価に付く画面の絵)を PNG に描くときだけ Docker を使う
|
|
186
|
+
(Docker が無くても評価は残る。[使い方ガイド: 手元の対話エージェントで Preflight する](how-to-use.md#手元の対話エージェントで-preflight-する))
|
|
187
|
+
- 担当が `codex` のプロジェクトでも、手元で評価してほしいことをはっきり頼めば同じように評価できる(同じ節)
|
|
199
188
|
|
|
200
|
-
|
|
189
|
+
**できたと分かる目安**: `npx @infodb/p3 drafts <要望ID>`(か画面の要望)で、評価とタスク案が読める。
|
|
201
190
|
|
|
202
|
-
|
|
191
|
+
### Codex で評価する
|
|
192
|
+
|
|
193
|
+
Codex を **Docker のコンテナの中で** 動かし、各自の ChatGPT アカウント(プラン)で評価させる。つまずくのはほとんどが Docker と
|
|
194
|
+
パスの見え方なので、そこを詳しく書く。
|
|
195
|
+
|
|
196
|
+
| # | すること | 終わったと分かる目安 |
|
|
197
|
+
| --- | --- | --- |
|
|
198
|
+
| 1 | Docker に繋がるか確かめる | `docker version` に **Client と Server の両方** が出る |
|
|
199
|
+
| 2 | どこで P3 を動かすか決める(ホスト / DevContainer) | 下の「動かす場所」のどちらかに当てはまる |
|
|
200
|
+
| 3 | (DevContainer のときだけ)パスを確かめる | `p3 user-config paths <リポジトリ> <データのフォルダ>` が「全部決まりました」 |
|
|
201
|
+
| 4 | ChatGPT に接続する | `p3 chatgpt status` が「ChatGPT プランを使います」 |
|
|
202
|
+
| 5 | Codex のイメージを作る | `p3 codex update` が「Codex を更新しました: codex-cli …」 |
|
|
203
|
+
| 6 | 画面で試しに Preflight を動かす | 評価とタスク案が出る |
|
|
204
|
+
|
|
205
|
+
- Codex をこのマシンに入れる必要はない(コンテナのイメージに入れる)。画面はビルド済みのものが入っているので、ビルドも要らない
|
|
206
|
+
- Docker と ChatGPT の接続を使うのは、Preflight(Codex)・リリースノートの要約の生成・タスクとマイルストーンの AI レビュー・
|
|
207
|
+
画面イメージの描画(Docker だけ)。準備が済むまでの間も、Preflight を通さずにタスクを作って進められる
|
|
208
|
+
([使い方ガイド: Preflight を通さずにタスクを作る](how-to-use.md#preflight-を通さずにタスクを作る))
|
|
209
|
+
|
|
210
|
+
#### 1. Docker に繋がるか確かめる
|
|
211
|
+
|
|
212
|
+
Docker(CLI とデーモン)は、Preflight の Codex を、リポジトリとデータのフォルダだけを見せたコンテナの中で動かすのに使う。
|
|
213
|
+
画面イメージの描画にも使う。
|
|
214
|
+
|
|
215
|
+
```bash
|
|
216
|
+
docker version --format 'Client {{.Client.Version}} / Server {{.Server.Version}}'
|
|
217
|
+
# Client 29.8.2 / Server 29.3.0 ← 両方出れば繋がっている
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
| 出たもの | 意味と次にすること |
|
|
221
|
+
| --- | --- |
|
|
222
|
+
| `docker: command not found` | Docker の CLI が無い。Docker Desktop か Docker Engine を入れ、`PATH` を確かめる。DevContainer なら、CLI を入れる設定(docker-outside-of-docker の feature など)を足す |
|
|
223
|
+
| Server の行が無い・`Cannot connect to the Docker daemon` | デーモンに繋がらない。Docker を起動する。繋ぎ先は `docker context ls`(`*` が今のもの)と環境変数 `DOCKER_HOST` で確かめる。DevContainer なら、ホストのソケット(`/var/run/docker.sock`)が渡っているか |
|
|
224
|
+
| `permission denied ... docker.sock` | ソケットを使う権限が無い。Linux なら利用者を `docker` グループに入れ直してログインし直す(または管理者に相談する) |
|
|
225
|
+
|
|
226
|
+
#### 2. 動かす場所
|
|
227
|
+
|
|
228
|
+
P3 が Codex のコンテナを作るとき、リポジトリとデータのフォルダを **Docker のデーモンから見たパス** でマウントする。
|
|
229
|
+
そのため、次の3つのパスを区別する。
|
|
230
|
+
|
|
231
|
+
| パス | 例 | 説明 |
|
|
232
|
+
| --- | --- | --- |
|
|
233
|
+
| P3 から見たパス(このマシンのパス) | `/workspaces/myapp` | `p3` を動かしている場所でのパス。個人設定に登録する |
|
|
234
|
+
| Docker のデーモン(ホスト)から見たパス | `/home/me/workspaces/myapp` | コンテナを作るのはデーモンなので、マウントはこのパスで指定する |
|
|
235
|
+
| Codex のコンテナの中のパス | `/workspace/myapp`、`/data` | 参照先は `/workspace/<名前>`(読むだけ)、データのフォルダは `/data` |
|
|
236
|
+
|
|
237
|
+
動かし方は2通りある。
|
|
238
|
+
|
|
239
|
+
- **A. ホストで直接動かす**(Mac・Linux・WSL の中で `p3` を実行し、Docker も同じ環境のもの): 1つ目と2つ目のパスが同じなので、
|
|
240
|
+
パスについてすることは無い(P3 はそのまま渡す。Docker Desktop・WSL でも同じ)
|
|
241
|
+
- **B. VS Code の DevContainer の中で動かし、Docker はホストのデーモンを使う**(docker-outside-of-docker): 1つ目と2つ目の
|
|
242
|
+
パスが違う。P3 が自分のコンテナのマウントから2つ目のパスを自動で決めるので、3. で確かめるだけでよい。リポジトリとデータの
|
|
243
|
+
フォルダは、ホストのフォルダをマウント(bind)した場所の下に置く
|
|
244
|
+
|
|
245
|
+
> リモートの Docker(`DOCKER_HOST` で別のマシンを指す)や、P3 のコンテナが接続先のデーモンに無い形では、自動では決まらない。
|
|
246
|
+
> そのときは 3. の確かめで理由が出るので、「自動で決まらないとき」の手順で手で書く。
|
|
247
|
+
|
|
248
|
+
#### 3. パスを確かめる(DevContainer のときだけ)
|
|
249
|
+
|
|
250
|
+
ホストで直接動かす(2. の A)なら飛ばしてよい。
|
|
251
|
+
|
|
252
|
+
P3 は Preflight と描画のたびに、自分が動いているコンテナを Docker に確かめ、そのマウントからリポジトリとデータのフォルダの
|
|
253
|
+
ホストのパスを決める(ホスト名がコンテナの名前と違ってもよい。結果は保存しない)。決まるかは、このマシンで確かめられる:
|
|
254
|
+
|
|
255
|
+
```bash
|
|
256
|
+
p3 user-config paths . ~/p3-data/myapp # リポジトリとデータのフォルダ(リポジトリの .p3 ならリポジトリだけでよい)
|
|
257
|
+
# p3 が動いている場所: コンテナの中(自分のコンテナ 3f2a… を Docker で確かめました。マウントから決めます)
|
|
258
|
+
# /workspaces/myapp
|
|
259
|
+
# → /home/me/workspaces/myapp 自動(p3 が動いているコンテナのマウントから)(マウント /workspaces)
|
|
260
|
+
# 全部決まりました(Preflight と描画でこのとおりにマウントします)
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
決まらないものがあると、理由と次にすること(1つ)が出る。Preflight と描画も、そのフォルダを使うときはコンテナを起こさずに
|
|
264
|
+
同じ理由で止まる(間違ったパスでは動かない)。
|
|
265
|
+
|
|
266
|
+
| 理由 | 次にすること |
|
|
267
|
+
| --- | --- |
|
|
268
|
+
| ホストのフォルダではないマウント(volume・tmpfs)の下・コンテナの中だけにある | フォルダを、ホストのフォルダをマウント(bind)した場所の下へ移す |
|
|
269
|
+
| 自分のコンテナを確かめられない(リモートの Docker・別のデーモン・ID が分からない) | 下の「自動で決まらないとき」で手で書く |
|
|
270
|
+
| 手で書いた対応と、コンテナのマウントから決めたものが違う | 手で書いた対応を直すか外す(`p3 user-config set codex.pathMap-=<このマシンのパス>`。外せば自動で決まる) |
|
|
271
|
+
|
|
272
|
+
##### 自動で決まらないとき(手で書く)
|
|
273
|
+
|
|
274
|
+
ホストから見たパスを調べ(ホストで `docker inspect <この開発コンテナ>` の `Mounts`。`Source` がホスト、`Destination` がこのマシン)、
|
|
275
|
+
`Destination` ごとに1件書く。左がこのマシンのパス、右がホストのパス。
|
|
203
276
|
|
|
204
277
|
```bash
|
|
205
278
|
p3 user-config set codex.pathMap+=/workspaces=/home/me/workspaces
|
|
206
|
-
p3 user-config set codex.pathMap
|
|
207
|
-
p3 user-config # 今の値と出どころ(環境変数 / 個人設定 / 既定)
|
|
208
|
-
# codex.pathMap /workspaces → /home/me/workspaces, /mnt/assets → /mnt/usb/assets
|
|
209
|
-
p3 user-config set codex.pathMap-=/mnt/assets # 1件外す(codex.pathMap= で全部外す)
|
|
279
|
+
p3 user-config set codex.pathMap-=/workspaces # 1件外す(codex.pathMap= で全部外す)
|
|
210
280
|
```
|
|
211
281
|
|
|
212
|
-
-
|
|
282
|
+
- 手で書いた対応は自動より先に使う(前から順に、境界(`/`)が合う最初の対応。同じ左側をもう一度足すと置き換える)。当たらない
|
|
283
|
+
フォルダだけ自動で決める
|
|
213
284
|
- 書き間違い(`=` が無い、相対パスなど)は、何を直すかを出して何も書かない
|
|
214
|
-
- 直したら、serve を起動し直さなくても **次の Preflight から**
|
|
285
|
+
- 直したら、serve を起動し直さなくても **次の Preflight から** 効く。`p3 user-config paths` で結果を確かめる
|
|
215
286
|
|
|
216
|
-
|
|
287
|
+
#### 4. ChatGPT に接続する
|
|
217
288
|
|
|
218
289
|
Preflight の Codex は、各自の ChatGPT アカウント(プラン)で動く。サインインは P3 が行う(Codex の初期設定は要らない)。
|
|
219
290
|
|
|
@@ -232,7 +303,7 @@ p3 chatgpt status
|
|
|
232
303
|
読める)に置き、CLI の出力・画面・ログには出さない。個人設定(`config.yaml`)とは別のファイル
|
|
233
304
|
- 解除は `p3 chatgpt logout`(ChatGPT 側の取り消しも行う)。`--forget` でこのマシンの登録ごと消す
|
|
234
305
|
|
|
235
|
-
|
|
306
|
+
#### 5. Codex のイメージを作る
|
|
236
307
|
|
|
237
308
|
```bash
|
|
238
309
|
p3 codex update
|
|
@@ -248,29 +319,36 @@ p3 codex update
|
|
|
248
319
|
今すぐ作り直す(しなくても1日以内に作り直される)
|
|
249
320
|
- 画面イメージの描画のイメージ(`infodb-p3-render`)は、最初に画面イメージを描くときに作る(`p3 render update` で今すぐ)
|
|
250
321
|
|
|
251
|
-
|
|
322
|
+
#### 6. 画面で試しに Preflight を動かす
|
|
252
323
|
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
# http://localhost:4310 をブラウザで開く
|
|
256
|
-
```
|
|
257
|
-
|
|
258
|
-
- **DevContainer:** 4310 もホストへ転送して、ホストのブラウザで開く
|
|
259
|
-
- 既定では `0.0.0.0:4310` で待つ(DevContainer の外から見るため)。画面には認証が無いので、信頼できないネットワークでは
|
|
260
|
-
`p3 user-config set serve.host=127.0.0.1` で絞る。待ち受け(`serve.host` / `serve.port`)を変えたら serve を起動し直す
|
|
261
|
-
|
|
262
|
-
概要ページの上にエンジンの状態が出る(Codex なら Docker・認証・イメージを確かめ、使えなければ理由を出して実行のボタンを止める)。
|
|
263
|
-
ここで問題が無ければ、試しに要望を1件作って Preflight を実行する([使い方ガイド](how-to-use.md) の 1.〜2.)。
|
|
324
|
+
`p3 serve` で開いた画面(段階 0)の概要ページの上にエンジンの状態が出る(Codex なら Docker・認証・イメージを確かめ、使えなければ
|
|
325
|
+
理由を出して実行のボタンを止める)。ここで問題が無ければ、試しに要望を1件作って Preflight を実行する([使い方ガイド](how-to-use.md) の 1.〜2.)。
|
|
264
326
|
|
|
265
327
|
Preflight の実行ログの最初の方に、参照先とデータのフォルダが **コンテナの中のどこに当たったか** が出る:
|
|
266
328
|
|
|
267
329
|
```text
|
|
268
|
-
|
|
269
|
-
参照先 myapp → コンテナ /workspace/myapp
|
|
270
|
-
データ → コンテナ /data
|
|
330
|
+
パスの対応(Docker のホストから見たパス):
|
|
331
|
+
参照先 myapp → コンテナ /workspace/myapp(自動(p3 が動いているコンテナのマウントから))
|
|
332
|
+
データ → コンテナ /data(自動(p3 が動いているコンテナのマウントから))
|
|
271
333
|
```
|
|
272
334
|
|
|
273
|
-
|
|
335
|
+
ログには決め方だけが出る(実際のパスは共有の記録に残さない)。パスそのものは、このマシンで 3. の `p3 user-config paths` で見る。
|
|
336
|
+
|
|
337
|
+
**できたと分かる目安**: 評価とタスク案が画面(か `p3 drafts <要望ID>`)に出る。
|
|
338
|
+
|
|
339
|
+
## 段階 2: 必要になったら足す
|
|
340
|
+
|
|
341
|
+
**すること**: 要る機能だけを足す(全部を設定しなくてよい)。**できるようになること**: プロジェクトとして守る水準を確かめる・完了した
|
|
342
|
+
タスクやマイルストーンを別の目で確かめる。
|
|
343
|
+
|
|
344
|
+
| 機能 | 何ができるか | 要るもの | 操作 |
|
|
345
|
+
| --- | --- | --- | --- |
|
|
346
|
+
| 品質基準 | 守る最低限の水準(lint・検証・文書など)を項目にし、タスクの受け入れ基準に取り込む | 足すものは無い(Codex の準備も要らない) | [使い方ガイド: 品質基準](how-to-use.md#品質基準) |
|
|
347
|
+
| タスクの AI レビュー | 完了したタスクが本文・受け入れ基準を満たしているかを、別の Codex に確かめさせる | 段階 1 の Codex の接続(Docker と ChatGPT) | [使い方ガイド: タスクの AI レビュー](how-to-use.md#タスクの-ai-レビュー) |
|
|
348
|
+
| マイルストーンレビュー | マイルストーンの目的に対して、できあがったものが足りているかを確かめる | 段階 1 の Codex の接続 | [使い方ガイド: マイルストーンレビュー](how-to-use.md#マイルストーンレビュー) |
|
|
349
|
+
| リリースノートの要約 | タスクの変更の記録から機能の要約の案を作る(手で書いて保存するだけなら要るものは無い) | 段階 1 の Codex の接続 | [使い方ガイド: リリースノート](how-to-use.md#リリースノート) |
|
|
350
|
+
|
|
351
|
+
**できたと分かる目安**: 足した機能の結果(選んだ品質基準・レビューの結果など)を、画面か CLI で読める。
|
|
274
352
|
|
|
275
353
|
## うまくいかないとき
|
|
276
354
|
|
|
@@ -278,14 +356,15 @@ DevContainer で「対応あり」にならなければ 5. を見直す。評価
|
|
|
278
356
|
|
|
279
357
|
Preflight を使えない・失敗したとき(Docker・ChatGPT の接続・使用量の上限など、理由によらない)は、概要ページ・失敗した run・
|
|
280
358
|
CLI の出力に、Preflight を通さずにタスクを作る道も出る。直すまでの間はそれで進めてよい([使い方ガイド: Preflight を通さずにタスクを作る](how-to-use.md#preflight-を通さずにタスクを作る))。Preflight を Claude Code などの手元の対話エージェントに
|
|
281
|
-
頼むなら Docker と ChatGPT
|
|
359
|
+
頼むなら Docker と ChatGPT は要らない([手元の AI エージェントで評価する](#手元の-ai-エージェントで評価する))。
|
|
282
360
|
|
|
283
361
|
| どこで | 出るもの | 確かめる | 直す |
|
|
284
362
|
| --- | --- | --- | --- |
|
|
285
363
|
| Preflight・`codex update` | `docker` が無い(ENOENT) | `docker version` | Docker を入れ、`PATH` を確かめる |
|
|
286
|
-
| 〃 | `Cannot connect to the Docker daemon` | `docker version` の Server、`docker context ls`、`DOCKER_HOST` | Docker を起動する。繋ぎ先と権限(
|
|
364
|
+
| 〃 | `Cannot connect to the Docker daemon` | `docker version` の Server、`docker context ls`、`DOCKER_HOST` | Docker を起動する。繋ぎ先と権限([段階 1 の 1.](#1-docker-に繋がるか確かめる))を直す |
|
|
287
365
|
| 〃 | `permission denied ... docker.sock` | `ls -l /var/run/docker.sock` | `docker` グループなど、ソケットの権限を直す |
|
|
288
|
-
| Preflight |
|
|
366
|
+
| Preflight・描画 | 「マウントするフォルダが Docker のホストのどこにあるか決められないので、コンテナを起こしません」 | 出ている理由と次にすること、`p3 user-config paths <フォルダ>` | [段階 1 の 3.](#3-パスを確かめるdevcontainer-のときだけ) の表のとおり |
|
|
367
|
+
| Preflight | `bind source path does not exist: <参照先 …>` / `<データ>` | ログの「パスの対応」、`p3 user-config paths <フォルダ>` | 手で書いた対応(`codex.pathMap`)の右側(ホストのパス)の誤り。直すか外す([自動で決まらないとき](#自動で決まらないとき手で書く))。serve はそのままで次の Preflight から効く |
|
|
289
368
|
| Preflight | 「Codex のイメージを用意できません(app-server を起こす前)」 | `p3 codex update` の出力 | ネットワーク(プロキシ)を確かめて `p3 codex update` をやり直す。`Unable to find image` も同じ |
|
|
290
369
|
| Preflight | 「〜が 60 秒で終わらないので止めました」(イメージの確認 15 秒・版の確認 60 秒・ビルド 10 分) | `docker ps -a --filter label=infodb.p3`(P3 が起こしたコンテナ) | P3 はそのコンテナを消してから終わる。Docker が重い・止まっていないかを確かめてやり直す。「コンテナ p3-… を消せませんでした(残っているかもしれません)」と出たら、出ている `docker rm -f <名前>` で消す |
|
|
291
370
|
| Preflight・画面 | 「ChatGPT にサインインしてください」「ChatGPT の接続が切れています」「プランの利用が許可されていません」 | `p3 chatgpt status` | `p3 chatgpt login`(届かなければ `--paste`)。プランの利用に同意する |
|
|
@@ -293,6 +372,7 @@ CLI の出力に、Preflight を通さずにタスクを作る道も出る。直
|
|
|
293
372
|
| Preflight・画面 | 個人設定を読めない(YAML の行と直すファイル) | `~/.config/infodb-p3/config.yaml` | 書き間違いを直す。serve はそのままで次の Preflight から効く |
|
|
294
373
|
| CLI | プロジェクトが決まらない | `p3 whoami`、`p3 project` | `--project <名前>`、または `p3 project add <名前> <フォルダ>` |
|
|
295
374
|
| CLI・serve | 「データのフォルダがありません」「データのフォルダに project.yaml がありません」 | `p3 project ls` の登録先、フォルダを移していないか、共有ドライブ(同期するフォルダ)がつながっているか | つながっていなければつないでやり直す。移したなら `p3 project rm <名前>` → `p3 project add <名前> <正しいフォルダ>`(rm はデータを消さない。そのあと `p3 repo path` で手元のリポジトリを登録し直す)。新しく作るなら管理したいリポジトリの中で `p3 init --project <名前>`(外に置くなら `--dir <フォルダ>`) |
|
|
375
|
+
| `join` | データのフォルダ・`project.yaml` が無い | リポジトリを `git pull` したか、データの場所(共有ドライブ)を聞いたか | `.p3` が届いていなければ取得する。外にあるなら `--dir <フォルダ>` で指定する |
|
|
296
376
|
| 画面 | 開けない | serve のログ、ポートの転送 | 4310 を転送する。`serve.port` を変えたら転送先も変える |
|
|
297
377
|
|
|
298
378
|
## 設定の決まり
|
|
@@ -303,7 +383,7 @@ CLI の出力に、Preflight を通さずにタスクを作る道も出る。直
|
|
|
303
383
|
|
|
304
384
|
| 個人設定 | 環境変数 | 内容 | 効くとき |
|
|
305
385
|
| --- | --- | --- | --- |
|
|
306
|
-
| `codex.pathMap` | `P3_CODEX_PATH_MAP`(`a=b,c=d`) | このマシンのパス → Docker
|
|
386
|
+
| `codex.pathMap` | `P3_CODEX_PATH_MAP`(`a=b,c=d`) | このマシンのパス → Docker のデーモンから見たパス(自動で決まらないときだけ書く) | 次の Preflight |
|
|
307
387
|
| `codex.auth` | `P3_CODEX_AUTH` | `auto`(既定。ChatGPT に接続していればそれ)/ `legacy`(下の旧来の認証) | 次の Preflight |
|
|
308
388
|
| `codex.authVolume` / `codex.authFile` | `P3_CODEX_AUTH_VOLUME` / `P3_CODEX_AUTH_FILE` | 旧来の認証の `auth.json` の置き場所 | 次の Preflight |
|
|
309
389
|
| `codex.model` / `codex.effort` | `P3_CODEX_MODEL` / `P3_CODEX_EFFORT` | モデル・推論の深さ(省けば Codex の既定) | 次の Preflight |
|
|
@@ -322,12 +402,12 @@ P3 をイメージにして、コンテナで動かすこともできる。イ
|
|
|
322
402
|
要望・タスクの作成と編集・添付・Preflight もいつもどおり使える。
|
|
323
403
|
|
|
324
404
|
イメージは Docker Hub の **`tamuto/p3`**。中に p3 本体(npm の `@infodb/p3` と同じ版・同じ中身)と、Node 26・git・Docker の CLI が
|
|
325
|
-
入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.
|
|
405
|
+
入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.13.0` など)と
|
|
326
406
|
`latest` がある。決まった版で使うなら版のタグを指す。対応する platform は `linux/amd64` だけ(arm64 は確かめるマシンが無いので
|
|
327
407
|
作っていない)。
|
|
328
408
|
|
|
329
409
|
```bash
|
|
330
|
-
docker pull tamuto/p3:0.
|
|
410
|
+
docker pull tamuto/p3:0.13.0
|
|
331
411
|
```
|
|
332
412
|
|
|
333
413
|
リポジトリから作るときは `docker build --pull -t tamuto/p3:dev .`(`--pull` で今の Node のベースを取る。[開発ガイド](development.md#docker-のイメージ))。
|
|
@@ -341,14 +421,14 @@ pull して起動し直す。
|
|
|
341
421
|
### 開発コンテナのサイドカーとして動かす
|
|
342
422
|
|
|
343
423
|
root で動く開発コンテナ(DevContainer など)で p3 の CLI を使っているなら、その横に p3 のコンテナを置き、**開発コンテナと同じ
|
|
344
|
-
|
|
424
|
+
マウント**を付ける。個人設定(登録など)と ChatGPT の接続を開発コンテナと共有するので、コンテナの中で登録し直す・
|
|
345
425
|
接続し直す必要はない。登録・接続・テーマの変更は、開発コンテナの中の CLI でいつもどおり行い、画面の「一覧を読み直す」で反映する。
|
|
346
426
|
|
|
347
427
|
```yaml
|
|
348
428
|
# 開発コンテナの compose に足す例(パスは開発コンテナのマウントに合わせる)
|
|
349
429
|
services:
|
|
350
430
|
p3:
|
|
351
|
-
image: tamuto/p3:0.
|
|
431
|
+
image: tamuto/p3:0.13.0
|
|
352
432
|
restart: unless-stopped
|
|
353
433
|
ports:
|
|
354
434
|
- "127.0.0.1:4310:4310"
|
|
@@ -361,7 +441,7 @@ services:
|
|
|
361
441
|
- /var/run/docker.sock:/var/run/docker.sock # Preflight(Codex)と画面イメージの描画
|
|
362
442
|
```
|
|
363
443
|
|
|
364
|
-
-
|
|
444
|
+
- p3 のコンテナも、自分のマウントからホストのパスを自動で決める(開発コンテナで手で書いた `codex.pathMap` があれば、同じパスで見えるのでそのまま効く)
|
|
365
445
|
- 個人設定は開発コンテナと p3 のコンテナの両方から書かれることがあるが、書くときはファイルのロックで順に行う
|
|
366
446
|
|
|
367
447
|
### 単独で動かす
|
|
@@ -372,20 +452,20 @@ docker run -d --name p3 --restart unless-stopped \
|
|
|
372
452
|
-v ~/.config/infodb-p3:/root/.config/infodb-p3 \
|
|
373
453
|
-v /home/me/work:/home/me/work \
|
|
374
454
|
-v /var/run/docker.sock:/var/run/docker.sock \
|
|
375
|
-
tamuto/p3:0.
|
|
455
|
+
tamuto/p3:0.13.0
|
|
376
456
|
|
|
377
457
|
# 登録が無ければ、コンテナの中で登録する(既にあるデータに参加する。新しく作るなら p3 init)
|
|
378
458
|
docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
|
|
379
459
|
```
|
|
380
460
|
|
|
381
|
-
- データと参照先はホストと **同じパスで**
|
|
382
|
-
|
|
461
|
+
- データと参照先はホストと **同じパスで** マウントするのが分かりやすい(違うパスでも、p3 が自分のマウントからホストのパスを自動で
|
|
462
|
+
決める)。ホストの個人設定を使うなら、その登録のパスとマウントのパスをそろえる
|
|
383
463
|
- root で動くので、コンテナが作るファイル(要望・タスクなど)の持ち主は root になる
|
|
384
464
|
|
|
385
465
|
### どちらでも
|
|
386
466
|
|
|
387
467
|
- 待ち受けは `127.0.0.1` に公開する。ブラウザで http://localhost:4310 を開く。登録が1つならそのプロジェクトが開き、複数なら一覧から選ぶ
|
|
388
|
-
- **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.
|
|
468
|
+
- **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.13.0 serve --project myapp --host 0.0.0.0`。compose なら
|
|
389
469
|
`command:`)。明示しない限り、コンテナの中かどうかで自動では切り替えない
|
|
390
470
|
- **止める**: `docker stop p3`(SIGTERM。実行中の Preflight・生成を取り消して記録してから止まる。10 秒まで待つ)
|
|
391
471
|
- **新しい版にする**: 版のタグを変えて作り直す(個人設定と接続はマウントした ~/.config、データはホストに残る)。
|
|
@@ -413,15 +493,26 @@ docker exec p3 p3 codex update # Codex のイメージを作る(ホスト
|
|
|
413
493
|
```
|
|
414
494
|
|
|
415
495
|
- ソケットを渡すと、コンテナの中から **ホストの Docker を何でも操作できる**(ホストの管理者と同じ強さ)。信頼できるマシンでだけ渡す
|
|
416
|
-
- Codex・描画のコンテナはホストのデーモンが作り、データのフォルダと参照先を **ホストのパスで**
|
|
417
|
-
|
|
418
|
-
`docker exec p3 p3 user-config
|
|
496
|
+
- Codex・描画のコンテナはホストのデーモンが作り、データのフォルダと参照先を **ホストのパスで** マウントする。p3 のコンテナの
|
|
497
|
+
マウント(bind)から自動で決まる。名前付きボリュームの下に置いたフォルダは決まらないので、ホストのフォルダを bind する。
|
|
498
|
+
決まるかは `docker exec p3 p3 user-config paths <コンテナの中のパス>` で確かめる([段階 1 の 3.](#3-パスを確かめるdevcontainer-のときだけ))
|
|
419
499
|
- ChatGPT の接続はマウントした ~/.config に残るので、コンテナを作り直しても接続し直さなくてよい
|
|
420
500
|
- ソケットを渡していない・繋がらないときも、要望・タスクの作成と編集・プロジェクトの選択は使える。Preflight は
|
|
421
501
|
使えない理由と直し方を出して止まる(Mock には落とさない)。その間は Preflight を通さずにタスクを作ってよい
|
|
422
502
|
([使い方ガイド](how-to-use.md#preflight-を通さずにタスクを作る))
|
|
423
503
|
- P3 を作り直してイメージの中身(入れる道具)が変わったら `docker exec p3 p3 codex update`
|
|
424
504
|
|
|
505
|
+
## 補足: Node.js の版と、同じ版で動かすこと
|
|
506
|
+
|
|
507
|
+
- P3 そのものを開発するときと、Docker のイメージ(`tamuto/p3`・描画のイメージ)は Node 26 を使う([開発ガイド](development.md))。
|
|
508
|
+
使うだけなら 24 以上でよい
|
|
509
|
+
- **Node 22 から上げるとき**: Node 22 はサポートの終わり(2027-04-30)が近いので、この版から P3 は Node 24 以上で動かす(`engines` は
|
|
510
|
+
`>=24`)。Node 22 のままでも止められるとは限らない: npm は入れるときに警告(`EBADENGINE`)を出して入れ、`engine-strict=true`
|
|
511
|
+
なら断る。pnpm(12.10 で確かめた)と `pnpx` は警告を出さずに入れて動かす。`node -v` を確かめ、24 以上(推奨 26)に上げてから入れ直す。Docker で動かしているなら、新しいイメージを `docker pull` してコンテナを作り直す
|
|
512
|
+
(起動し直すだけでは前のイメージの Node のまま)
|
|
513
|
+
- 同じデータを使う人と AI は、なるべく同じ版で動かす(`npx @infodb/p3@<版>` / `pnpx @infodb/p3@<版>` のように版を付けられる。
|
|
514
|
+
`npx`・`pnpx` は取った版をしばらく使い続ける)。古い版で更新すると、新しい版で足した項目が消えることがある([データの形](architecture.md#データの形))
|
|
515
|
+
|
|
425
516
|
## 補足: 旧来の認証と Mock
|
|
426
517
|
|
|
427
518
|
ふだんは使わない。
|
package/docs/publishing.md
CHANGED
|
@@ -34,7 +34,7 @@ node scripts/verify-pack.mjs --docker # npm pack → 実行時の依存だ
|
|
|
34
34
|
`PATH=$(dirname $(npx -y node@24.0.0 -e "console.log(process.execPath)")):$PATH node scripts/verify-pack.mjs --tgz <作った tarball>`
|
|
35
35
|
- [ ] Node の下限を上げた版を出すときは、リリースノートに知らせる: 前の下限の Node では、npm は警告を出して入れ(`engine-strict` なら断る)、
|
|
36
36
|
pnpm・`pnpx` は警告を出さずに入れる(止められない)ので、利用者が `node -v` を確かめること、
|
|
37
|
-
Node を上げて入れ直すこと、Docker のイメージは pull してコンテナを作り直すこと(Node 22 → 24 以上は [導入ガイド](installation.md) の「Node 22 から上げるとき」)
|
|
37
|
+
Node を上げて入れ直すこと、Docker のイメージは pull してコンテナを作り直すこと(Node 22 → 24 以上は [導入ガイド](installation.md#補足-nodejs-の版と同じ版で動かすこと) の「Node 22 から上げるとき」)
|
|
38
38
|
- [ ] Docker が無い環境で確かめたときは、`codex update` の段が「実行していない」と出る。その場合は Docker のある環境で
|
|
39
39
|
`--docker` を付けて通すまで、公開に進まない
|
|
40
40
|
|