@infodb/p3 0.2.0 → 0.3.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 (72) hide show
  1. package/README.md +6 -1
  2. package/dist/web/assets/{Outputs-Ni3pNuGU.js → Outputs-DqJdybkd.js} +1 -1
  3. package/dist/web/assets/{RequestStatus-K8TZwpur.js → RequestStatus-DN-2iAM0.js} +1 -1
  4. package/dist/web/assets/TagInput-D-1ILLDX.js +1 -0
  5. package/dist/web/assets/TaskDrawer-CHD7T-Su.js +3 -0
  6. package/dist/web/assets/_requestId-BzSepQIV.js +30 -0
  7. package/dist/web/assets/_requestId-pIds2tFU.js +1 -0
  8. package/dist/web/assets/board-BIkOpuC4.js +1 -0
  9. package/dist/web/assets/directTask-Dk3H5Q2B.js +1 -0
  10. package/dist/web/assets/done-BUAUhIRr.js +1 -0
  11. package/dist/web/assets/draft-CfJeyLOl.js +1 -0
  12. package/dist/web/assets/index-Byv9j77D.js +12 -0
  13. package/dist/web/assets/index-DTfUhuQw.css +2 -0
  14. package/dist/web/assets/new-6kly4-PX.js +1 -0
  15. package/dist/web/assets/preload-helper-DlN0ouRj.js +1 -0
  16. package/dist/web/assets/release-notes-iwQWmfX6.js +3 -0
  17. package/dist/web/assets/requestData-DJ1Rlx-u.js +1 -0
  18. package/dist/web/assets/routes-Ciot9p4x.js +2 -0
  19. package/dist/web/assets/settings-DBCi6lAY.js +1 -0
  20. package/dist/web/assets/ui-Sz7y5_TS.js +1 -0
  21. package/dist/web/assets/workTarget-Cijqq4yH.js +1 -0
  22. package/dist/web/index.html +4 -5
  23. package/docs/architecture.md +62 -9
  24. package/docs/development.md +83 -7
  25. package/docs/how-to-use.md +103 -10
  26. package/docs/installation.md +142 -5
  27. package/docs/publishing.md +27 -3
  28. package/package.json +8 -5
  29. package/skills/p3/SKILL.md +2 -0
  30. package/src/cli/args.ts +9 -2
  31. package/src/cli/help.ts +9 -3
  32. package/src/cli/main.ts +73 -4
  33. package/src/cli/output.ts +18 -0
  34. package/src/cli/preflightCommands.ts +10 -2
  35. package/src/cli/project.ts +262 -98
  36. package/src/cli/releaseNotesCommands.ts +21 -1
  37. package/src/core/context.ts +3 -2
  38. package/src/core/preflight/codexEngine.ts +2 -1
  39. package/src/core/preflight/render-image/Dockerfile +3 -0
  40. package/src/core/preflight/render-image/fonts-ja.conf +28 -0
  41. package/src/core/preflight/render-image/render.mjs +10 -1
  42. package/src/core/preflight/render.ts +5 -2
  43. package/src/core/preflight/service.ts +19 -2
  44. package/src/core/projectRegistry.ts +264 -0
  45. package/src/core/releaseNotes/generate.ts +12 -0
  46. package/src/core/store/locate.ts +3 -3
  47. package/src/core/userConfig.ts +25 -0
  48. package/src/server/api/chatgptRoutes.ts +6 -5
  49. package/src/server/api/manifest.ts +9 -0
  50. package/src/server/api/projectsRoutes.ts +89 -0
  51. package/src/server/api/routes.ts +33 -25
  52. package/src/server/server.ts +74 -15
  53. package/src/shared/directTask.ts +20 -0
  54. package/src/shared/types.ts +1 -1
  55. package/dist/web/assets/TagInput-BICKVH2x.js +0 -1
  56. package/dist/web/assets/TaskDrawer-BkDIstIN.js +0 -3
  57. package/dist/web/assets/_requestId-B5O_ytaq.js +0 -1
  58. package/dist/web/assets/_requestId-C66puEMO.js +0 -30
  59. package/dist/web/assets/board-CbfDjkls.js +0 -1
  60. package/dist/web/assets/done-CPQbCFHg.js +0 -1
  61. package/dist/web/assets/draft-dT3gLDIt.js +0 -1
  62. package/dist/web/assets/index-BUcs2J6N.js +0 -12
  63. package/dist/web/assets/index-C3DkqwJ9.css +0 -2
  64. package/dist/web/assets/link-_s8ndNKS.js +0 -1
  65. package/dist/web/assets/new-T60RB7de.js +0 -1
  66. package/dist/web/assets/preload-helper-dXqN7N-I.js +0 -1
  67. package/dist/web/assets/release-notes-DxrPhDbt.js +0 -3
  68. package/dist/web/assets/requestData-D8ZiSZss.js +0 -1
  69. package/dist/web/assets/routes-D9ZxXoLk.js +0 -2
  70. package/dist/web/assets/settings-DsHVyqzJ.js +0 -1
  71. package/dist/web/assets/supersede-CLXlhCq0.js +0 -1
  72. package/dist/web/assets/ui-Cvke4y4X.js +0 -1
@@ -30,9 +30,11 @@ pnpm build && pnpm start # ビルドした画面を p3 serve から配信 h
30
30
  pnpm typecheck
31
31
  pnpm lint # oxlint(型情報も使う。下の「lint」)
32
32
  pnpm test # ユニットテスト(vitest)。pnpm test:watch で監視
33
- pnpm check # 型検査 + lint + テスト + ビルド
33
+ pnpm test:ui # ブラウザで画面を操作する UI テスト(ビルドした画面が要る。下の「UI テスト」)
34
+ pnpm check # 型検査 + lint + テスト + ビルド + UI テスト
34
35
  pnpm demo:reset # デモデータ(.p3-demo/)を作り直す
35
36
  pnpm verify:pack # 配布物を別の場所に入れて動かす(--docker で codex update と render も)
37
+ pnpm video # 使い方の動画を録り直す(.p3-video/p3-demo.mp4。下の「使い方の動画」)
36
38
  ```
37
39
 
38
40
  - `pnpm dev` / `pnpm start` は P3 自身の開発を題材にしたデモデータ(`.p3-demo/`、git 管理外)を開く。無ければ自動で作る
@@ -48,8 +50,8 @@ pnpm verify:pack # 配布物を別の場所に入れて動かす(-
48
50
  - テストは一時ディレクトリに git リポジトリと `.p3/` を作って動かす(`test/helpers.ts`)
49
51
  - Codex の経路は、JSON-RPC を話す偽の app-server(`test/fixtures/fake-codex.mjs`)に差し替えて確かめる。本物の Codex が実際に
50
52
  どこまで読むか、読むだけのマウントへの書き込みが拒まれることは、偽の app-server では確かめられない
51
- - `init --agents` で置いたスキルを本物の Codex が見つけて読むかは、偽の app-server では確かめられない。置き場所
52
- (`SKILL_TARGETS`)や Codex の版を変えたときは、手で確かめる(結果はタスクの変更の記録に残す):
53
+ - `init --agents` / `p3 agents` で置いたスキルを本物の Codex が見つけて読むかは、偽の app-server では確かめられない。置き場所
54
+ (`AGENT_TARGETS`)や Codex の版を変えたときは、手で確かめる(結果はタスクの変更の記録に残す):
53
55
 
54
56
  ```bash
55
57
  # 一時フォルダに git リポジトリを作り、個人設定も分けて置く(p3 を使わない別のリポジトリ other/ も作っておく)
@@ -71,6 +73,38 @@ pnpm verify:pack # 配布物を別の場所に入れて動かす(-
71
73
  pnpm vitest run test/showBrief.test.ts --reporter=verbose
72
74
  ```
73
75
 
76
+ ### UI テスト
77
+
78
+ `test/ui/*.ui.test.ts` は、ブラウザ(Playwright の Chromium headless shell)で `p3 serve` のビルドした画面を開いて操作する。
79
+ 設定は `vitest.ui.config.ts` で、通常の `pnpm test` には入らない。型検査・lint の対象には入る。
80
+
81
+ - `pnpm check` は、型検査・lint・テスト・ビルドの後に `pnpm test:ui` を流す。単独で流すときは先に `pnpm build` する
82
+ (ビルドが無ければ、Chromium の有無によらず失敗にする)
83
+ - Chromium は `pnpm exec playwright-core install chromium-headless-shell` で入れる(自動では入れない)。Playwright が起動する
84
+ 実行ファイル(既定のキャッシュか `PLAYWRIGHT_BROWSERS_PATH`)が無いときだけ、理由と入れ方を出して UI テストを飛ばす(件数は
85
+ vitest の skipped に出る)。実行ファイルがあるのに起動できない(共有ライブラリが無いなど)・サーバが起きない・操作の対象が
86
+ 見つからないときは失敗にする(判定は `test/ui/chromium.ts`、本物の Chromium を使わない確認は `test/uiHarness.test.ts`)
87
+ - シナリオごとに一時のフォルダを作り、その中に HOME・個人設定(`XDG_CONFIG_HOME`)・git リポジトリ・データを置いて、本物の CLI
88
+ (`bin/p3.mjs init`・`serve`)で動かす(`test/ui/env.ts`)。子の p3 には親の `P3_*`・`INIT_CWD`・`GIT_*`・`XDG_*` を渡さず、
89
+ Mock のエンジン・変更者・cwd を明示する。手元の個人設定・プロジェクト・`.p3-demo/` には触れない。`p3 serve` は 127.0.0.1 の
90
+ 空いたポートで起こす(取られていたら別のポートで試し直す)。ブラウザは親の環境で起こす(一時の HOME をブラウザの探索に使わない)
91
+ - 主な流れ(`test/ui/flow.ui.test.ts`): 要望の登録 → Mock の Preflight → 評価と案 → タスク化 → ボード → タスクの着手・完了
92
+ (成果物・変更の記録)→ 済み → 要望の完了済を、すべて画面の操作で進め、再読み込みと CLI でも残っていることを確かめる
93
+ - 表示(`test/ui/layout.ui.test.ts`): 進捗・新しい要望・概要と Preflight の案・タスクボード・タスクの詳細を幅 1280 と 375 で、
94
+ 案の詳細(Markdown の本文)を幅 375 / 768 / 1280 の明暗のテーマで開き、長い題・長いパス・複数の案・依存・表とコードのある本文で確かめる:
95
+ ページ全体の横のはみ出し、枠(カード・行・詳細)からのはみ出し、ボードの並び(広い幅は未着手と完了が横、狭い幅は縦に積む)、
96
+ 詳細の枠と閉じるボタンが画面に収まること、局所スクロール(進捗の表・案の段階の列・本文・表・コード)の先へ届くこと、主な操作に届くこと、
97
+ 閉じる / Escape の後に開いたボタンへフォーカスが戻ること。状態(要望・Preflight・タスク化・案の本文)は CLI とデータのファイルで用意し、
98
+ 開く・閉じるなどの確かめる操作はブラウザで行う。測り方(`test/ui/layout.ts`)は DOM の寸法で、意図した局所スクロール(overflow が
99
+ visible 以外の要素の中)とページ全体のはみ出しを分ける。測り方が崩れを見逃さないことも、わざと崩した要素で確かめる
100
+ - 限界: 画像の比較はしないので、色・重なり方・文字の欠けなど、測っていない見た目の乱れは保証しない。測るのは上の画面・幅・テーマだけ
101
+ - 日本語のフォント: Noto Sans CJK JP があれば、ブラウザを使い方の動画と同じ fontconfig(`scripts/fonts-ja.conf`)で起こし、寸法を
102
+ 日本語のフォントで測る(無い環境では既定のフォントのまま測り、そのことを出す。飛ばしはしない)
103
+ - 操作の対象は画面の文言・role・label で探し、固定の sleep はせず状態を待つ(上限は `UI_TIMEOUT`。`test/ui/scenario.ts`)。
104
+ 失敗すると、シナリオと手順・対象・その時の URL・画面の画像(`/tmp/p3-ui-failed-*/page.png`。中身は一時のデータだけ)・
105
+ `p3 serve` のログの末尾を出す。画面の文言を変えたら、そのテストの対象の名前を直す
106
+ - 成功・失敗・時間切れのどれでも、ブラウザとサーバを止めて終わるのを待ってから一時のフォルダを消す(診断用の画像だけ残る)
107
+
74
108
  ## lint
75
109
 
76
110
  `pnpm lint` は [oxlint](https://oxc.rs/docs/guide/usage/linter) で、型情報を使う規則(`--type-aware`。`oxlint-tsgolint` が
@@ -143,8 +177,8 @@ src/ 依存の向き: shared ← core ← server / cli、web →
143
177
  routeTree.gen.ts ルート一覧(自動生成)
144
178
  components/ 部品(複数のページで使うもの。大きいページの部品は components/<ページ>/)
145
179
  bin/p3.mjs CLI の起動口(tsx でソースをそのまま動かす)
146
- skills/p3/SKILL.md AI 向けスキルの原本(p3 init --agents で各プロジェクトの .claude/skills と .agents/skills に写す)
147
- scripts/ デモデータ・配布物の確認
180
+ skills/p3/SKILL.md AI 向けスキルの原本(p3 init --agents / p3 agents で各プロジェクトの .claude/skills・.agents/skills の選んだ先に写す)
181
+ scripts/ デモデータ・配布物の確認・使い方の動画(video/)
148
182
  docs/ 導入・使い方・開発・設計・公開の文書
149
183
  test/ ユニットテスト
150
184
  ```
@@ -171,12 +205,54 @@ test/ ユニットテスト
171
205
  | bin | `p3`。起動口は今いる場所の `tsconfig.json` を読まない。`INIT_CWD` に戻るのは P3 自身の `pnpm p3` スクリプトのときだけ |
172
206
 
173
207
  ```bash
174
- pnpm -s check # 型検査・lint・テスト・画面のビルド
208
+ pnpm -s check # 型検査・lint・テスト・画面のビルド・UI テスト
175
209
  pnpm verify:pack --docker # npm pack → 実行時の依存だけで別の場所に入れて動かす(scripts/verify-pack.mjs)
176
210
  # DevContainer の中では、描画の出力先を Docker のホストから見えるところにする
177
211
  P3_CODEX_PATH_MAP=/workspaces=/home/me/workspaces pnpm verify:pack --docker --render-dir /workspaces/tmp
178
212
  ```
179
213
 
214
+ ## Docker のイメージ
215
+
216
+ `Dockerfile`(Docker Hub の `tamuto/p3`。ビルドは Node 24 と packageManager の pnpm でロックファイルどおりに入れ、`pnpm pack` と同じ中身に実行時の依存だけを
217
+ 入れる。実行は Node 22・git・Docker の CLI と buildx。既定は `serve --all-projects --host 0.0.0.0`)と `.dockerignore`
218
+ (git・依存・ビルドの出力・データ・個人設定・認証・テストを入れない)。約束は `test/docker.test.ts` が確かめる。
219
+ 公開(人が行う)は [publishing.md](publishing.md#6-docker-hubtamutop3) の手順で、CI は使わない。使い方は [導入ガイド](installation.md#docker-で動かすプロジェクトを跨ぐ-serve)。
220
+
221
+ ```bash
222
+ docker build -t tamuto/p3:dev .
223
+ node scripts/verify-docker.mjs # ビルドして、使い捨ての2つのプロジェクトで動かす(スモーク)
224
+ # DevContainer の中では、Docker のホストから見えるフォルダと、そのホストのパスを渡す。公開したポートはホストにしか開かないので、
225
+ # このコンテナのネットワークに入れる
226
+ P3_CODEX_PATH_MAP=/workspaces=/home/me/workspaces node scripts/verify-docker.mjs --work /workspaces/tmp --network-of auto
227
+ ```
228
+
229
+ スモークで確かめること: 起動の約束(ENTRYPOINT・既定の CMD・入れた道具)・2つのプロジェクトの一覧・登録世代つきの作成と手元の
230
+ ファイル・同じ ID の分離・添付・ソケットが無いときのエンジンの状態・Mock の Preflight の同時実行と片方の取消・再起動のあとに残る
231
+ こと・データのフォルダの欠落と復旧・`docker stop`(SIGTERM)で実行中の Preflight を取り消して止まること・コマンドの明示で通常の
232
+ serve になること。本物の Codex(ソケット・pathMap・ChatGPT の接続)での Preflight・画面資料・要約の生成は、このスクリプトでは
233
+ 確かめない(接続できる環境で手で確かめ、結果を PR に残す。Mock の成功で代わりにしない)。
234
+
235
+ ## 使い方の動画
236
+
237
+ 一般公開する使い方の動画(日本語の字幕、約3分)は `pnpm video` で録り直す(`scripts/video/record.mjs`)。機能や画面を
238
+ 変えて動画と合わなくなったら、台本(同じファイルの `scenes`。場面ごとの操作と字幕)を直して録り直す。出来上がりは
239
+ `.p3-video/p3-demo.mp4`(git 管理外。`--out <mp4>` で変える)で、リポジトリには入れない(公開先は人が決める)。
240
+
241
+ - 架空の経費精算アプリのリポジトリを使い捨ての HOME(`/home/me`)に作り、① 導入(`p3 init`)→ ② 要望の登録(AI の CLI と
242
+ `p3 serve`)→ ③ Preflight → ④ 作業(AI の CLI と再読み込み)→ ⑤ 確認とリリース の順に、実際に p3 を動かしながら録る。
243
+ ② の前に過去の要望と v1.0 のリリースを入れる(`scripts/video/seed.sh`。その間は録らない)。Preflight とリリースノートの
244
+ 要約は Mock(字幕とタイトルでそう断る)
245
+ - 映るのは汎用のパスと名前だけにする(`/home/me/src/expense`・`human:demo`・`github.com/example`)。P3 自身のデータは映さない
246
+ - 前提: Chromium(`pnpm exec playwright-core install chromium-headless-shell`)、ffmpeg(libx264)、日本語のフォント
247
+ Noto Sans CJK JP(Debian / Ubuntu なら `fonts-noto-cjk`)、`/home/me` を作れること(DevContainer の root なら作れる)、
248
+ ポート 4310 が空いていること。足りなければ録り始める前に止める。日本語は録画のときだけの fontconfig(`scripts/fonts-ja.conf`。UI テストと共用)で
249
+ Noto Sans CJK JP に寄せる(中国語の字形のフォントで描かれないように)
250
+ - `/home/me` は印(`.p3-video-demo`)のあるときだけ消して作り直す。終わったら消す
251
+ - 画面の文言や操作が変わって操作の対象が見つからないと、15 秒で「場面「③ Preflight」で止まりました(対象: ボタンの名前)」と
252
+ その時の画面の画像の場所を出して止まる(作業のフォルダは残す)。台本の対象の名前を今の画面に合わせて直す
253
+ - 録画は Chrome DevTools Protocol の screencast(変わったときだけ届く JPEG)で、届いた時刻から各フレームの長さを決めて
254
+ ffmpeg で 30fps の mp4 にする(字幕・カーソル・CLI のパネルはページに重ねる `scripts/video/overlay.js`)
255
+
180
256
  ## 文書を直すとき
181
257
 
182
258
  | 文書 | 書くこと |
@@ -191,4 +267,4 @@ P3_CODEX_PATH_MAP=/workspaces=/home/me/workspaces pnpm verify:pack --docker --re
191
267
 
192
268
  同じ説明を複数の文書に書かない(片方からリンクする)。確認作業の記録(どの幅・どのブラウザで確かめたか)は文書に書かず、
193
269
  PR とタスクの変更の記録に残す。CLI のヘルプ(`src/cli/help.ts`)・API の説明(`src/server/api/manifest.ts`)は入口が変わったとき、
194
- AI の手順が変わったときは `skills/p3/SKILL.md` と `src/cli/project.ts` の `AGENTS_SNIPPET` の両方を直す。
270
+ AI の手順が変わったときは `skills/p3/SKILL.md` と `src/cli/project.ts` の `agentsSnippet`(`AGENTS_SNIPPET`)の両方を直す。
@@ -255,6 +255,39 @@ p3 move T005 done --repo-output app=https://…/pull/1 --repo-output infra=https
255
255
 
256
256
  `areas` と根拠の参照は `<参照先>:<パス>`(例 `docs:guide/`)で書ける。名前なしは先頭の参照先の中のパス。
257
257
 
258
+ ### Preflight を通さずにタスクを作る
259
+
260
+ 小さく内容のはっきりした要望なら、Preflight を通さずにタスクを直接作ってよい。Docker や ChatGPT の接続が無い・Preflight が
261
+ 止まる間も、同じ道で進められる(要望・タスク・変更の記録・マイルストーンは Docker も ChatGPT も使わない)。直接作ったタスクには、
262
+ Preflight の評価・細分化・根拠の調査・画面イメージは付かない。必要な調査と完了条件は、作る人が整理して本文に書く。
263
+
264
+ 流れ: 要望を書く(1.)→ タスクを直接作る(下)→ 作業を始めるなら要望を進行中にする → いつもどおり作業・変更の記録・確認(6.〜8.)。
265
+
266
+ - **画面**: 要望のタスクボードの「+ タスクを追加」(タスクが無くても出る)。題(必須。空白だけは不可)・本文(作業内容・
267
+ 完了条件)・作業先を書いて「作成」で、未着手のタスクになる。作業先は作業先にできる参照先か「作業先なし」から選び、
268
+ 既定は CLI と同じ(作業先にできる参照先が1つならそれ)。Enter で作成、Escape か「取消」で保存せずに閉じる。
269
+ 保存に失敗したときは入力が残り、タスクの一覧を読み直す(保存できたあとで失敗したこともあるので、同じタスクが未着手に
270
+ できていないか確かめてから、もう一度作成する)
271
+ - **CLI**: `p3 new "<題>" --req <要望> --body "<作業内容と完了条件>"`(作業先は `--repo`。後の「参照先と作業先」)
272
+ - 関係(依存・置き換え)は張らない。順序が要るなら本文に書く
273
+ - 要望の状態は、下書き・評価中・開始前のときは変わらない。作業を始めるときは、概要のステータスを「進行中」にする
274
+ (CLI は `p3 request set <要望> status=active`)。対応済の要望に足したときは進行中に戻る(後の「状態」)
275
+
276
+ **Preflight を使えないときの案内**: Docker が無い・デーモンに繋がらない・権限が無い、ChatGPT に未接続、使用量の上限、そのほかの
277
+ Codex の失敗のどれでも、止まった理由と直し方に並べて、この道を案内する。
278
+
279
+ - 画面: 概要のエンジンの状態が ✕ のとき・失敗した run に「Preflight を通さずにタスクを作成」(タスクボードのフォームが開く)。
280
+ 個人設定の ChatGPT の欄には、要望を開いてタスクボードで作る手順。エンジンの状態を確かめられなかった(通信の失敗)ときは、
281
+ 使えるとも使えないとも言えないので案内しない
282
+ - CLI: `p3 preflight` が始められなかった・失敗したときに、実際の要望 ID で `p3 new "タスクの題" --req <要望> --body "作業内容と完了条件"`
283
+ を stderr に出す(`--project` / `--dir` を付けていればそのまま付ける)。終了コードと `--json` の stdout は変えない
284
+ - 取り消しただけの run(「中止しました」)・実行中は失敗と扱わず、案内しない
285
+
286
+ **後から Preflight を使えるようになったら**: その要望にも `p3 preflight <要望>`(画面は概要の「▶ Preflight を実行」)で評価できる。
287
+ 実行しても既にあるタスクは変わらない。案をタスク化すると新しいタスクが増えるので、直接作ったタスクと重なる案は採らない
288
+ (5. で採否を選ぶ)。案が既にあるタスクを置き換えるとき(`supersedes`)は、同じ要望の中で人が採否とアーカイブを選ぶ
289
+ (後の「タスクの関係と置き換え」)。自動で置き換えたりまとめたりはしない
290
+
258
291
  ### 要望の本文を変えたとき
259
292
 
260
293
  要望のタイトル・本文は、いつでも書き換えられる(画面の「本文を編集」→「本文を保存」、CLI の `request set`)。
@@ -344,6 +377,20 @@ p3 release-notes export v0.2 > RELEASE.md # 公開する本文だけ(出
344
377
  - **生成**: Preflight と同じ Codex の接続(ChatGPT プラン)で頼む。渡すのはマイルストーンのタイトルと、要望・タスクの ID・タイトル・
345
378
  変更の記録だけ。結果の出典(要望・タスク)は P3 が確かめ、内部のパスらしいものは警告する。Ctrl-C で取り消せる。
346
379
  `--engine mock` は要約しない試し用(記録の1行目を並べる)
380
+ - **生成せずに手で書く**: 本文の保存は生成によらず、Docker も ChatGPT の接続も要らない。生成できない(Codex を使えない・
381
+ 使用量の上限・材料が無いなど)ときも、この手順で進める。画面では生成の欄の案内と、失敗したときの「本文を手で書く」から
382
+ 本文の欄へ進む(失敗・再生成しても入力は消えない)
383
+
384
+ ```bash
385
+ p3 release-notes show v0.2 # 材料(収録する要望と変更の記録)を確かめる
386
+ # 変更の記録を読んで、本文(Markdown)を notes.md に書く
387
+ p3 release-notes save v0.2 --file notes.md # 新しく保存する
388
+ p3 release-notes show v0.2 --json # 既にあるノートを更新するなら、版(note.version)を読む
389
+ p3 release-notes save v0.2 --file notes.md --version <版>
390
+ p3 release-notes export v0.2 > RELEASE.md
391
+ ```
392
+
393
+ `p3 release-notes generate` が始められない・失敗したときも、このコマンドを stderr に出す(取り消しただけなら出さない)
347
394
  - **古い材料**: 生成や保存のあとで要望・タスクが変わると「材料が変わった」と知らせる(本文は自動では直さない)。
348
395
  必要なら生成し直して、確かめてから保存する
349
396
  - **競合**: 保存したノートを直すときは、読んだときの版(`--version`)が要る。画面・エディタなど別のところで先に変わっていれば
@@ -377,16 +424,47 @@ p3 attach rm <A-ID>
377
424
  p3 render 画面.html --width 1280 # 画面.png ができる(幅 320〜2560 px・原稿 2MB まで。スクリプト・外部の参照は使えない。data: の画像はよい)
378
425
  ```
379
426
 
427
+ 日本語は Noto CJK JP で描く(描画のイメージに入っているのは Noto CJK と欧文のフォントだけ):
428
+
429
+ - ゴシック体の `sans-serif`・`system-ui` と、無いフォントの名前 `Noto Sans JP`・`Hiragino Sans`・`Hiragino Kaku Gothic ProN`・
430
+ `ヒラギノ角ゴ ProN`・`Yu Gothic`・`游ゴシック` は Noto Sans CJK JP
431
+ - 明朝体の名前 `Noto Serif JP`・`Hiragino Mincho ProN`・`Yu Mincho`・`游明朝` は Noto Serif CJK JP、`monospace` は Noto Sans Mono CJK JP
432
+ - フォントを指定していない原稿は `sans-serif`(欧文は Liberation Sans、かな・漢字は Noto Sans CJK JP)。原稿の指定はどれもこれより優先する
433
+ - `serif` だけを指定すると、欧文は Liberation Serif、かな・漢字は Noto Sans CJK JP(ゴシック体)。明朝体にするなら上の名前を指定する
434
+ - ほかに明示したフォント(`Noto Sans CJK SC` など)と、`data:` で埋め込んだフォントはそのまま使う
435
+ - 描き方の決まりが変わると、次の描画で描画のイメージを作り直す。保存済みの PNG は描き直さない(新しく描くには Preflight をかけ直す)
436
+
380
437
  ### 画面
381
438
 
382
439
  `p3 serve` で開く(既定 http://localhost:4310)。画面の状態は URL に載る。
383
440
 
441
+ `p3 serve --all-projects` で開くと、今いる場所のプロジェクトではなく、個人設定に登録したプロジェクト(`p3 project ls`)を跨いで
442
+ 扱う。どのプロジェクトでも通常の serve と同じ操作ができる(閲覧専用ではない)。`--project` / `--dir` とは一緒に使えない。
443
+ 登録を足した・外したら、画面で一覧を読み直せば反映する(serve の起動し直しは要らない)。同じデータのフォルダを複数の名前で
444
+ 登録していると、どれも開かない(`p3 project rm <名前>` で1つにする)。決まりは [architecture](architecture.md#プロジェクトを跨ぐ-servep3-serve---all-projects)
445
+
446
+ - **選ぶ**: 入口(`/`)は登録したプロジェクトの一覧(行のどこを押しても開く)。登録が1つだけで開けるときは、一覧を飛ばして
447
+ そのプロジェクトを開く(使えない登録や個人設定の読めない理由があるときは一覧に出す)。選ぶと `/projects/<名前>/...` になり、
448
+ ほかの URL(要望・ボード・リリースノート・設定、`?task=` など)はこの下に今までどおり続く。URL を直接開く・再読み込み・戻るも効く
449
+ - **今のプロジェクト**: どの画面でも、ヘッダーの下の「プロジェクト」に出る。ここで切り替える(選ぶ欄を開くと一覧を読み直す)。
450
+ 「プロジェクトの一覧…」では、登録が1つでも一覧を出す(`/?list`)。一覧は、戻ったとき・そのタブに戻ったときにも読み直すので、
451
+ 途中で足した・外した登録が出る
452
+ 作成・保存・Preflight は、ここに出ているプロジェクトにだけ届く。タブごとに別のプロジェクトを開いてもよい
453
+ - **切り替え**: ページごと移る。保存していない入力があれば「このプロジェクトに残る / 入力を破棄して切り替える」を選ぶ(破棄した
454
+ 入力はどこにも送らない)。送っている保存は、結果が決まるまで待ってから移る。実行中の Preflight・生成は元のプロジェクトで続き、
455
+ 戻れば状態を読み直す(取消は表示中のプロジェクトの実行にだけ届く)
456
+ - **登録が変わったとき**: 開いている間にデータのフォルダを変えた・外した(CLI の `p3 project rm` / `add`)プロジェクトの画面からは
457
+ 保存しない。「登録が変わりました」と出るので、一覧から選び直す(入力は残すが、新しい登録先へ自動では送らない)
458
+ - **開けないとき**: 登録に無い・データのフォルダが無い・同じデータの重複などは、一覧に名前と理由を出す(ほかは選べる)。
459
+ CLI で直して(`p3 project ls` / `add` / `rm`)、「一覧を読み直す」
460
+ - ChatGPT の接続とテーマはプロジェクトによらず共通(どのプロジェクトの設定画面からでも同じ)
461
+
384
462
  | URL | 画面 |
385
463
  | --- | --- |
386
464
  | `/` | 進捗。左に要望、右にスケジュール。`?show=` で 未完了(既定)/ `resolved`(確認待ち)/ `closed`(完了済・見送り)/ `all`。`?tags=` |
387
465
  | `/requests/new` | 新しい要望(添付も) |
388
466
  | `/requests/<要望>` | 要望の概要(タイトル・本文・期限・マイルストーン・タグ・添付)と Preflight(`?run=PF-...` で過去の評価) |
389
- | `/requests/<要望>/board` | タスクボード(V 字。ドラッグで列を移動。完了のカードの「✓ 済み」でボードから外す) |
467
+ | `/requests/<要望>/board` | タスクボード(V 字。ドラッグで列を移動。完了のカードの「✓ 済み」でボードから外す。「+ タスクを追加」で直接作る) |
390
468
  | `/requests/<要望>/done` | 対応済み(済みにしたタスクと成果物の一覧。要望の「対応済」とは別) |
391
469
  | `/release-notes` | リリースノート(`?m=<マイルストーン>`)。下の「リリースノートの画面」 |
392
470
  | `/settings` | 個人(ChatGPT の接続・テーマ)/ プロジェクトの基本 / 参照先(`?tab=personal|project|repos`) |
@@ -485,8 +563,9 @@ updatedBy: ai:claude
485
563
 
486
564
  ### AI エージェントから使う
487
565
 
488
- AI にも CLI を使わせる(認証を持たせずに済む)。`p3 init --agents` で、`AGENTS.md`(無ければ `CLAUDE.md`)に短い使い方を追記し、
489
- 詳しい手順のスキルを置く。どちらにも上の「役割と言葉」の役割が書いてある。置いたファイルはリポジトリに入れて共有する。
566
+ AI にも CLI を使わせる(認証を持たせずに済む)。`p3 init --agents claude|codex|both`(値を省くと both)か、作った後なら
567
+ `p3 agents claude|codex|both` で、`AGENTS.md`(無ければ `CLAUDE.md`、どちらも無ければ `AGENTS.md` を作る)に短い使い方の節を足し、
568
+ 詳しい手順のスキルを選んだ先に置く。どちらにも上の「役割と言葉」の役割が書いてある。置いたファイルはリポジトリに入れて共有する。
490
569
 
491
570
  | 置く場所(リポジトリのルート) | 読む AI |
492
571
  | --- | --- |
@@ -497,11 +576,25 @@ AI にも CLI を使わせる(認証を持たせずに済む)。`p3 init --a
497
576
  置くのはプロジェクトの中だけにする。個人のスキルの場所(`~/.claude/skills`・`~/.agents/skills`)に置くと、p3 を使わない
498
577
  プロジェクトでも読まれ、関係ない作業で p3 を操作しかねない。
499
578
 
500
- **P3 を新しくしたとき**: 置いたスキルと追記は、手で直した分を消さないよう上書きしない。登録済みのリポジトリで
501
- `p3 init --agents --project <名前> --dir <データのフォルダ>`(ルートの `.p3` なら `--dir` は省ける)をもう一度実行すると、登録とデータはそのままで、スキルの場所ごとに
502
- 無ければ置き、「最新です」か「同梱の版と違う」かを出す。片方(以前の版で置いた `.claude/skills` だけなど)しか無ければ、
503
- 足りない方が置かれる。違うものは同梱の原本と見比べて手で直す(追記は見出しがあれば足さないので、最新の内容は
504
- [docs/architecture.md](architecture.md) の「AI エージェントへの指示」と見比べる)。
579
+ 節のスキルの参照は、選んだ先と、リポジトリに既にある先だけを書く(無い先は書かない)。
580
+
581
+ **後から置く・最新にする(`p3 agents`)**: 今いるリポジトリのルート(サブフォルダからでも)に、選んだ先だけを扱う。プロジェクトは
582
+ 決めず、データ・個人設定は変えない。選ばなかった先は作らず・変えず・消さない(チームで消した先は戻らない)。置く先は省けない。
583
+
584
+ | 今の状態 | `p3 agents <先>` | `p3 agents <先> --force` |
585
+ | --- | --- | --- |
586
+ | 無い | 作成(置く・節を足す) | 同じ |
587
+ | 同梱の版と同じ | 同一(何もしない) | 同じ |
588
+ | 違う(手で直した・古い版) | 保護(変えずに知らせる。スキルは違う行も出す) | 更新(スキルは同梱の版に、節は p3 の節だけを置き換え、前後の文は残す) |
589
+ | 節が複数・見出しになっていない | 保護(手で1つの節に整理するよう知らせる) | 同じ(変えない) |
590
+
591
+ - `--force` が上書きするのは、選んだ先のスキル(`SKILL.md`)と、`AGENTS.md` / `CLAUDE.md` の「タスク管理(infodb p3)」の節
592
+ (その見出しから、同じか上の段の次の見出しの前まで。見出しの段はそのまま)だけ。手で直した分は消えるので、先に差分を見る
593
+ - 後から片方を足したときは、スキルは置き、節(前の参照のまま)は「保護」になる。両方を指す節にするなら `--force`
594
+ - チームで使うとき: 置いた・最新にした変更(`git diff`)をレビューしてコミットし、push して共有する。ほかの人は pull するだけで
595
+ よい(参加の `p3 join` は AI 向けのファイルを書かない)
596
+ - 以前の版との違い: 以前は `init --agents` で両方に置き、参加(init)のときも置き、登録済みのリポジトリで実行し直すと足りない方を
597
+ 置いていた。今は、置く先を選び、参加では置かず、後から置く・最新にするのは `p3 agents` だけ
505
598
 
506
599
  ブラウザ用の REST API(`/api/...`、自己記述は `GET /api/ai/manifest`)もあるが、ローカルの画面のためのもの。
507
600
 
@@ -511,7 +604,7 @@ AI にも CLI を使わせる(認証を持たせずに済む)。`p3 init --a
511
604
 
512
605
  | コマンド | 内容 |
513
606
  | --- | --- |
514
- | `p3 init` / `p3 project` / `p3 whoami` | 初期設定・参加 / 個人設定のプロジェクト / 今の判定 |
607
+ | `p3 init` / `p3 join` / `p3 project` / `p3 whoami` | 新しく作る / 共有されたものに参加する / 個人設定のプロジェクト / 今の判定 |
515
608
  | `p3 config` / `p3 repo` / `p3 user-config` | プロジェクトの設定 / 参照先 / 個人設定(テーマ・マシンごとの設定) |
516
609
  | `p3 progress` | 要望ごとの進捗(マイルストーンごと。`--all` で完了・見送りも) |
517
610
  | `p3 milestone ls\|add\|set\|rm` | マイルストーン |
@@ -521,4 +614,4 @@ AI にも CLI を使わせる(認証を持たせずに済む)。`p3 init --a
521
614
  | `p3 new` / `p3 set` / `p3 move` / `p3 check` / `p3 archive` | タスクを足す / 直す / 状態を変える / 済みにする / アーカイブ |
522
615
  | `p3 preflight` / `p3 notes` / `p3 drafts` / `p3 accept` | Preflight の実行(`--note`)/ メモ / 評価とタスク案 / タスク化 |
523
616
  | `p3 attach` / `p3 render` | 添付 / 画面イメージの描画 |
524
- | `p3 chatgpt` / `p3 codex update` / `p3 serve` | ChatGPT の接続 / Codex のイメージ / 画面 |
617
+ | `p3 chatgpt` / `p3 codex update` / `p3 serve` | ChatGPT の接続 / Codex のイメージ / 画面(`--all-projects` で登録したプロジェクトを跨ぐ) |
@@ -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
- リポジトリの `.p3` に入れて共有しているなら `p3 init` だけで、リポジトリの外のフォルダなら `--dir <そのフォルダ>` を付ける
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)と `.agents/skills/p3/SKILL.md`(Codex)に置く。置いたファイルはリポジトリに入れて共有する。
104
- 登録済みのリポジトリでも `p3 init --agents --project <名前> --dir <データのフォルダ>`(ルートの `.p3` なら `--dir` は省ける)をもう一度実行すれば、登録はそのままで足りない方だけを置く
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.3.0` など)と
306
+ `latest` がある。決まった版で使うなら版のタグを指す。
307
+
308
+ ```bash
309
+ docker pull tamuto/p3:0.3.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.3.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.3.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.3.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
  ふだんは使わない。
@@ -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.2.0",
3
+ "version": "0.3.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.0",
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
- "check": "pnpm typecheck && pnpm lint && pnpm test && pnpm build",
87
- "verify:pack": "node scripts/verify-pack.mjs"
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
  }
@@ -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` で読み直してやり直す)