@infodb/p3 0.0.0-stage → 0.1.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 (120) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +56 -2
  3. package/bin/p3.mjs +18 -0
  4. package/dist/web/apple-touch-icon.png +0 -0
  5. package/dist/web/assets/Outputs-Ni3pNuGU.js +1 -0
  6. package/dist/web/assets/RequestStatus-K8TZwpur.js +1 -0
  7. package/dist/web/assets/TagInput-BICKVH2x.js +1 -0
  8. package/dist/web/assets/TaskDrawer-BkDIstIN.js +3 -0
  9. package/dist/web/assets/_requestId-B5O_ytaq.js +1 -0
  10. package/dist/web/assets/_requestId-C66puEMO.js +30 -0
  11. package/dist/web/assets/action-CMjATXqv.js +1 -0
  12. package/dist/web/assets/board-CbfDjkls.js +1 -0
  13. package/dist/web/assets/copy-B1ZbihKL.js +2 -0
  14. package/dist/web/assets/done-CPQbCFHg.js +1 -0
  15. package/dist/web/assets/draft-dT3gLDIt.js +1 -0
  16. package/dist/web/assets/format-DuK6P1hb.js +1 -0
  17. package/dist/web/assets/index-BUcs2J6N.js +12 -0
  18. package/dist/web/assets/index-C3DkqwJ9.css +2 -0
  19. package/dist/web/assets/link-_s8ndNKS.js +1 -0
  20. package/dist/web/assets/new-T60RB7de.js +1 -0
  21. package/dist/web/assets/preload-helper-dXqN7N-I.js +1 -0
  22. package/dist/web/assets/release-notes-DxrPhDbt.js +3 -0
  23. package/dist/web/assets/requestData-D8ZiSZss.js +1 -0
  24. package/dist/web/assets/rolldown-runtime-hePW80VL.js +1 -0
  25. package/dist/web/assets/routes-D9ZxXoLk.js +2 -0
  26. package/dist/web/assets/search-CJ8MBKTz.js +1 -0
  27. package/dist/web/assets/settings-DsHVyqzJ.js +1 -0
  28. package/dist/web/assets/supersede-CLXlhCq0.js +1 -0
  29. package/dist/web/assets/ui-Cvke4y4X.js +1 -0
  30. package/dist/web/favicon.ico +0 -0
  31. package/dist/web/favicon.svg +12 -0
  32. package/dist/web/index.html +23 -0
  33. package/docs/architecture.md +588 -0
  34. package/docs/chatgpt-sign-in.md +163 -0
  35. package/docs/development.md +194 -0
  36. package/docs/how-to-use.md +524 -0
  37. package/docs/installation.md +275 -0
  38. package/docs/publishing.md +65 -0
  39. package/package.json +86 -3
  40. package/skills/p3/SKILL.md +95 -0
  41. package/src/cli/args.ts +179 -0
  42. package/src/cli/chatgpt.ts +74 -0
  43. package/src/cli/codex.ts +28 -0
  44. package/src/cli/format.ts +9 -0
  45. package/src/cli/help.ts +99 -0
  46. package/src/cli/main.ts +267 -0
  47. package/src/cli/output.ts +99 -0
  48. package/src/cli/preflightCommands.ts +237 -0
  49. package/src/cli/project.ts +501 -0
  50. package/src/cli/readOnly.ts +36 -0
  51. package/src/cli/releaseNotesCommands.ts +139 -0
  52. package/src/cli/render.ts +60 -0
  53. package/src/cli/requestCommands.ts +170 -0
  54. package/src/cli/showView.ts +110 -0
  55. package/src/cli/taskCommands.ts +167 -0
  56. package/src/cli/userConfig.ts +58 -0
  57. package/src/core/chatgpt.ts +33 -0
  58. package/src/core/context.ts +57 -0
  59. package/src/core/machineSettings.ts +207 -0
  60. package/src/core/machineSettingsEdit.ts +156 -0
  61. package/src/core/ops.ts +114 -0
  62. package/src/core/preflight/carryover.ts +133 -0
  63. package/src/core/preflight/codexEngine.ts +702 -0
  64. package/src/core/preflight/codexImage.ts +98 -0
  65. package/src/core/preflight/diagnose.ts +124 -0
  66. package/src/core/preflight/engine.ts +92 -0
  67. package/src/core/preflight/input.ts +65 -0
  68. package/src/core/preflight/launch.ts +86 -0
  69. package/src/core/preflight/launcher.mjs +75 -0
  70. package/src/core/preflight/mock-ui.html +24 -0
  71. package/src/core/preflight/mock-ui.png +0 -0
  72. package/src/core/preflight/mockEngine.ts +145 -0
  73. package/src/core/preflight/render-image/Dockerfile +23 -0
  74. package/src/core/preflight/render-image/render.mjs +53 -0
  75. package/src/core/preflight/render.ts +336 -0
  76. package/src/core/preflight/service.ts +690 -0
  77. package/src/core/preflight/uiMaterials.ts +272 -0
  78. package/src/core/preflight/uiRender.ts +84 -0
  79. package/src/core/preflight/wireframe.ts +69 -0
  80. package/src/core/preflight/xlsx.ts +328 -0
  81. package/src/core/redact.ts +31 -0
  82. package/src/core/releaseNotes/generate.ts +271 -0
  83. package/src/core/releaseNotes/material.ts +114 -0
  84. package/src/core/releaseNotes/mockSummarizer.ts +28 -0
  85. package/src/core/releaseNotes/service.ts +106 -0
  86. package/src/core/releaseNotes/store.ts +216 -0
  87. package/src/core/repoAdmin.ts +81 -0
  88. package/src/core/repoRefs.ts +90 -0
  89. package/src/core/requestOps.ts +140 -0
  90. package/src/core/requestStatus.ts +58 -0
  91. package/src/core/store/attachments.ts +228 -0
  92. package/src/core/store/collection.ts +282 -0
  93. package/src/core/store/frontmatter.ts +22 -0
  94. package/src/core/store/fsutil.ts +90 -0
  95. package/src/core/store/locate.ts +181 -0
  96. package/src/core/store/normalize.ts +155 -0
  97. package/src/core/store/noteStore.ts +56 -0
  98. package/src/core/store/preflightStore.ts +136 -0
  99. package/src/core/store/projectFile.ts +101 -0
  100. package/src/core/store/workspace.ts +328 -0
  101. package/src/core/supersede.ts +74 -0
  102. package/src/core/userConfig.ts +180 -0
  103. package/src/core/userTheme.ts +22 -0
  104. package/src/core/workTargets.ts +120 -0
  105. package/src/server/api/chatgptRoutes.ts +48 -0
  106. package/src/server/api/local.ts +33 -0
  107. package/src/server/api/manifest.ts +119 -0
  108. package/src/server/api/releaseNoteRoutes.ts +78 -0
  109. package/src/server/api/repoRoutes.ts +67 -0
  110. package/src/server/api/routes.ts +374 -0
  111. package/src/server/api/userThemeRoutes.ts +62 -0
  112. package/src/server/server.ts +49 -0
  113. package/src/shared/dates.ts +12 -0
  114. package/src/shared/preflightInput.ts +27 -0
  115. package/src/shared/refs.ts +55 -0
  116. package/src/shared/repos.ts +113 -0
  117. package/src/shared/scopeView.ts +48 -0
  118. package/src/shared/tags.ts +27 -0
  119. package/src/shared/types.ts +700 -0
  120. package/src/shared/workTarget.ts +44 -0
@@ -0,0 +1,275 @@
1
+ # 導入ガイド
2
+
3
+ infodb p3(以下 P3)を入れて、最初の Preflight を動かせる状態にするまでの手順。要望を作ってからの使い方は
4
+ [使い方ガイド](how-to-use.md) へ続く。
5
+
6
+ P3 の Preflight は、Codex を **Docker のコンテナの中で** 動かす。導入でつまずくのはほとんどが Docker とパスの対応なので、
7
+ この文書はそこを詳しく書く。
8
+
9
+ ## 全体の流れ
10
+
11
+ | # | すること | 終わったと分かる目安 |
12
+ | --- | --- | --- |
13
+ | 1 | 必要なものをそろえる | `node -v` が 22 以上、`git --version`、`docker version` が通る |
14
+ | 2 | どこで P3 を動かすか決める(ホスト / DevContainer) | 下の「動かす場所」のどちらかに当てはまる |
15
+ | 3 | Docker に繋がるか確かめる | `docker version` に **Client と Server の両方** が出る |
16
+ | 4 | プロジェクトを作る(か参加する) | `p3 whoami` にプロジェクトとデータのフォルダが出る |
17
+ | 5 | (DevContainer のときだけ)パスの対応を書く | `p3 user-config` の `codex.pathMap` に、リポジトリとデータの両方の対応がある |
18
+ | 6 | ChatGPT に接続する | `p3 chatgpt status` が「ChatGPT プランを使います」 |
19
+ | 7 | Codex のイメージを作る | `p3 codex update` が「Codex を更新しました: codex-cli …」 |
20
+ | 8 | 画面を開いて、試しに Preflight を動かす | 評価とタスク案が出る |
21
+
22
+ ## 1. 必要なもの
23
+
24
+ | もの | 何に使う | 確かめ方 |
25
+ | --- | --- | --- |
26
+ | Node.js 22 以上 | P3 本体(CLI と `p3 serve`) | `node -v` |
27
+ | pnpm(`pnpx`)か npm(`npx`) | P3 を入れずに動かす。`pnpm add -g @infodb/p3` / `npm i -g @infodb/p3` で `p3` コマンドにしてもよい | `pnpm -v` / `npm -v` |
28
+ | Git | 管理したいリポジトリと、要望ごとのブランチ。Preflight の Codex も履歴を読む | `git --version` |
29
+ | Docker(CLI とデーモン) | Preflight の Codex を、リポジトリとデータのフォルダだけを見せたコンテナの中で動かす。画面イメージの描画にも使う | `docker version`(下の 3.) |
30
+ | ChatGPT のアカウント(プラン) | Preflight の Codex をその人のアカウントで動かす | 6. で接続する |
31
+
32
+ - Codex をこのマシンに入れる必要はない(コンテナのイメージに入れる)。画面はビルド済みのものが入っているので、ビルドも要らない
33
+ - P3 そのものを開発するときは Node 24 を使う([開発ガイド](development.md))。使うだけなら 22 以上でよい
34
+ - 以下の例では `p3` と書く。入れていなければ `pnpx @infodb/p3`(または `npx @infodb/p3`)に読み替える
35
+
36
+ ## 2. 動かす場所
37
+
38
+ P3 が Codex のコンテナを作るとき、リポジトリとデータのフォルダを **Docker のデーモンから見たパス** でマウントする。
39
+ そのため、次の3つのパスを区別する。
40
+
41
+ | パス | 例 | 説明 |
42
+ | --- | --- | --- |
43
+ | P3 から見たパス(このマシンのパス) | `/workspaces/myapp` | `p3` を動かしている場所でのパス。個人設定に登録する |
44
+ | Docker のデーモン(ホスト)から見たパス | `/home/me/workspaces/myapp` | コンテナを作るのはデーモンなので、マウントはこのパスで指定する |
45
+ | Codex のコンテナの中のパス | `/workspace/myapp`、`/data` | 参照先は `/workspace/<名前>`(読むだけ)、データのフォルダは `/data` |
46
+
47
+ 動かし方は2通りある。
48
+
49
+ - **A. ホストで直接動かす**(Mac・Linux・WSL の中で `p3` を実行し、Docker も同じ環境のもの): 1つ目と2つ目のパスが同じなので、
50
+ パスの対応は要らない
51
+ - **B. VS Code の DevContainer の中で動かし、Docker はホストのデーモンを使う**(docker-outside-of-docker): 1つ目と2つ目の
52
+ パスが違うので、5. でその対応(`codex.pathMap`)を書く。データのフォルダも、ホストから見える(バインドマウントされた)場所に置く
53
+
54
+ > Docker Desktop・WSL・リモートの Docker(`DOCKER_HOST` で別のマシンを指す)では、パスの見え方がさらに違うことがある。
55
+ > この文書の手順は A と B(VS Code の DevContainer と、そのホストの Docker)で書いている。ほかの形では、「Docker のデーモンから
56
+ > 見たパス」を自分の環境で確かめてから 5. の対応を書く。
57
+
58
+ ## 3. Docker に繋がるか確かめる
59
+
60
+ ```bash
61
+ docker version --format 'Client {{.Client.Version}} / Server {{.Server.Version}}'
62
+ # Client 29.8.2 / Server 29.3.0 ← 両方出れば繋がっている
63
+ ```
64
+
65
+ | 出たもの | 意味と次にすること |
66
+ | --- | --- |
67
+ | `docker: command not found` | Docker の CLI が無い。Docker Desktop か Docker Engine を入れ、`PATH` を確かめる。DevContainer なら、CLI を入れる設定(docker-outside-of-docker の feature など)を足す |
68
+ | Server の行が無い・`Cannot connect to the Docker daemon` | デーモンに繋がらない。Docker を起動する。繋ぎ先は `docker context ls`(`*` が今のもの)と環境変数 `DOCKER_HOST` で確かめる。DevContainer なら、ホストのソケット(`/var/run/docker.sock`)が渡っているか |
69
+ | `permission denied ... docker.sock` | ソケットを使う権限が無い。Linux なら利用者を `docker` グループに入れ直してログインし直す(または管理者に相談する) |
70
+
71
+ ## 4. プロジェクトを作る(か参加する)
72
+
73
+ 管理したいリポジトリの中で `p3 init` を実行し、プロジェクト名と **データを置くフォルダ** を決める。データのフォルダの場所は自由で、
74
+ リポジトリの外を勧める(例: `~/p3-data/myapp`。チームで共有するなら同期するフォルダ)。DevContainer のときは、ホストから見える
75
+ (バインドマウントされた)場所にする。
76
+
77
+ ```bash
78
+ cd ~/src/myapp
79
+ p3 init --agents
80
+ # プロジェクト名(切り替えに使う短い名前) [myapp]:
81
+ # データを置くフォルダ(リポジトリの外を勧めます): ~/p3-data/myapp
82
+ # 何を作っているプロジェクトか(Preflight の前提になります): 社内向けの経費精算アプリ
83
+ # 最初に読むドキュメント(カンマ区切り。Preflight が評価の前に読みます) [docs, README.md]:
84
+ # Preflight で重視する観点・制約(任意): 個人情報を扱う変更は必ずリスクに挙げる
85
+
86
+ # AI やスクリプトからは引数で(--yes で質問しない)
87
+ p3 init --yes --agents --project myapp --dir ~/p3-data/myapp --description "社内向けの経費精算アプリ"
88
+ ```
89
+
90
+ - データのフォルダには `project.yaml` と空の `requests/` ができる。このリポジトリは **本体の参照先**(Preflight が読むリポジトリ。
91
+ 最初に読む・作業先にできる)として登録される
92
+ - 既にあるデータのフォルダ(ほかの人が作って共有したもの)を指したときは、作らずに **参加** だけする
93
+ - `--agents` を付けると、AI エージェント向けの使い方を `AGENTS.md`(無ければ `CLAUDE.md`)に追記し、同じスキルを
94
+ `.claude/skills/p3/SKILL.md`(Claude Code)と `.agents/skills/p3/SKILL.md`(Codex)に置く。置いたファイルはリポジトリに入れて共有する。
95
+ 登録済みのリポジトリでも `p3 init --agents --project <名前> --dir <データのフォルダ>` をもう一度実行すれば、登録はそのままで足りない方だけを置く
96
+ - 登録はこのマシンの **個人設定**(`~/.config/infodb-p3/config.yaml`。`XDG_CONFIG_HOME` があればその下。共有しない)に入る
97
+
98
+ 確かめる:
99
+
100
+ ```bash
101
+ p3 whoami
102
+ # プロジェクト myapp /home/me/p3-data/myapp
103
+ # 決まり方 cwd(今いる場所)
104
+ # 今いる参照先 myapp ブランチ main
105
+ # 変更者 human:<git の user.name>
106
+ # 要望 (なし)
107
+ ```
108
+
109
+ プロジェクトが決まらないと、登録済みの一覧と選び方(`--project <名前>`)が出る。リポジトリの外で使うときや、複数のプロジェクトに
110
+ 参加しているときに起きる。
111
+
112
+ 登録が1つだけのうちは、関係ないフォルダでも `whoami` が成功する(決まり方が `only`)。これは書き込み先が決まったという意味ではない。
113
+ そのとき読むだけのコマンドは警告を出して動き、要望の登録などの変える操作は止まる。変えるときは、リポジトリかデータのフォルダの中に
114
+ 移るか、プロジェクトを明示する:
115
+
116
+ ```bash
117
+ cd ~/src/myapp && p3 request new "通知" # リポジトリの中で
118
+ p3 --project myapp request new "通知" # どこからでも、明示して
119
+ ```
120
+
121
+ ほかのリポジトリ(ドキュメント・基盤など)も Preflight に読ませたいときは
122
+ [使い方ガイド](how-to-use.md#参照先と作業先) の「参照先と作業先」。
123
+
124
+ ## 5. パスの対応を書く(DevContainer のときだけ)
125
+
126
+ ホストで直接動かす(2. の A)なら飛ばしてよい。
127
+
128
+ ### 5-1. ホストから見たパスを調べる
129
+
130
+ DevContainer の中の `docker` はホストのデーモンに繋がっているので、中から自分のコンテナのマウントを調べられる。
131
+
132
+ ```bash
133
+ docker ps --format '{{.ID}} {{.Names}}' # 自分のコンテナを探す(VS Code が付けた名前・compose のサービス名など)
134
+ docker inspect <コンテナの名前> --format '{{range .Mounts}}{{.Type}} {{.Source}} → {{.Destination}}{{"\n"}}{{end}}'
135
+ # bind /home/me/workspaces → /workspaces ← Source がホスト、Destination がコンテナの中
136
+ # bind /mnt/usb/assets → /mnt/assets
137
+ # volume /var/lib/docker/volumes/xxx/_data → /home/me/.cache ← 名前付きボリューム(下の注意)
138
+ ```
139
+
140
+ - コンテナの名前は、ホスト名(`hostname`)と同じとは限らない。分からなければ `docker ps` の一覧から探す
141
+ - **リポジトリ** と **データのフォルダ** の両方について、それを含む `Destination` を探す
142
+ - `volume` は名前付きボリューム。`Source` はデーモンの中の場所で、ふつうのパスとして別のコンテナにマウントできるとは限らない。
143
+ リポジトリとデータのフォルダは、`bind`(ホストのフォルダ)の下に置く
144
+
145
+ ### 5-2. 対応を書く
146
+
147
+ 左がコンテナの中(P3 から見たパス)、右がホスト(Docker のデーモンから見たパス)。`Destination` ごとに1件。
148
+
149
+ ```bash
150
+ p3 user-config set codex.pathMap+=/workspaces=/home/me/workspaces
151
+ p3 user-config set codex.pathMap+=/mnt/assets=/mnt/usb/assets # データのフォルダが別のマウントにあるとき
152
+ p3 user-config # 今の値と出どころ(環境変数 / 個人設定 / 既定)
153
+ # codex.pathMap /workspaces → /home/me/workspaces, /mnt/assets → /mnt/usb/assets
154
+ p3 user-config set codex.pathMap-=/mnt/assets # 1件外す(codex.pathMap= で全部外す)
155
+ ```
156
+
157
+ - 前から順に、境界(`/`)が合う最初の対応を使う。同じ左側をもう一度足すと置き換える
158
+ - 書き間違い(`=` が無い、相対パスなど)は、何を直すかを出して何も書かない
159
+ - 直したら、serve を起動し直さなくても **次の Preflight から** 効く
160
+
161
+ ## 6. ChatGPT に接続する
162
+
163
+ Preflight の Codex は、各自の ChatGPT アカウント(プラン)で動く。サインインは P3 が行う(Codex の初期設定は要らない)。
164
+
165
+ ```bash
166
+ p3 chatgpt login # ブラウザが開き、ChatGPT にサインインしてプランの利用に同意する(127.0.0.1:1455 で待つ)
167
+ p3 chatgpt status
168
+ # me@example.com ChatGPT プランを使います トークンの期限 2026-10-12 20:57(使うときに更新)
169
+ ```
170
+
171
+ - **DevContainer:** VS Code が待ち受けのポート(1455)をホストへ転送するので、ホストのブラウザから戻ってこられる
172
+ - **ブラウザが「接続できません」になる**(1455 が使えずに別のポートで待った・転送されない環境(SSH・別のコンテナ)など):
173
+ `p3 chatgpt login --paste` で、その「接続できません」の画面のアドレスバーの URL をそのまま貼る
174
+ - 画面の「設定」→「個人」の「Continue with ChatGPT」でも同じことができる。ただし **P3 を動かしているマシンのローカルの画面からだけ**
175
+ (LAN の別のマシンや、`docker run -p` で公開した画面からは断る。そのときは CLI を使う)
176
+ - 接続はこのマシン・この人のもので、どのプロジェクトにも属さない。トークンは `~/.config/infodb-p3/chatgpt.json`(所有者だけが
177
+ 読める)に置き、CLI の出力・画面・ログには出さない。個人設定(`config.yaml`)とは別のファイル
178
+ - 解除は `p3 chatgpt logout`(ChatGPT 側の取り消しも行う)。`--forget` でこのマシンの登録ごと消す
179
+
180
+ ## 7. Codex のイメージを作る
181
+
182
+ ```bash
183
+ p3 codex update
184
+ # Codex のイメージ llmcs-codex-workspace:local を作り直しています(最新の Codex を入れます。数分かかることがあります)
185
+ # Codex を更新しました: codex-cli 0.162.1(変わらず。これが最新)
186
+ # イメージ llmcs-codex-workspace:local(2026-10-13 05:08:07 作成)
187
+ ```
188
+
189
+ - 初回は数分かかる(ネットワークから Codex を入れる)。プロジェクトの登録やサインインは要らない
190
+ - しなくても、最初の Preflight の前に自動で作る。その後も、作ってから1日より古ければ Preflight の前に作り直す
191
+ (止めるなら `p3 user-config set codex.ensureImage=false`)
192
+ - 画面イメージの描画のイメージ(`infodb-p3-render`)は、最初に画面イメージを描くときに作る(`p3 render update` で今すぐ)
193
+
194
+ ## 8. 画面を開いて、試しに Preflight を動かす
195
+
196
+ ```bash
197
+ p3 serve
198
+ # http://localhost:4310 をブラウザで開く
199
+ ```
200
+
201
+ - **DevContainer:** 4310 もホストへ転送して、ホストのブラウザで開く
202
+ - 既定では `0.0.0.0:4310` で待つ(DevContainer の外から見るため)。画面には認証が無いので、信頼できないネットワークでは
203
+ `p3 user-config set serve.host=127.0.0.1` で絞る。待ち受け(`serve.host` / `serve.port`)を変えたら serve を起動し直す
204
+
205
+ 概要ページの上にエンジンの状態が出る(Codex なら Docker・認証・イメージを確かめ、使えなければ理由を出して実行のボタンを止める)。
206
+ ここで問題が無ければ、試しに要望を1件作って Preflight を実行する([使い方ガイド](how-to-use.md) の 1.〜2.)。
207
+
208
+ Preflight の実行ログの最初の方に、参照先とデータのフォルダが **コンテナの中のどこに当たったか** が出る:
209
+
210
+ ```text
211
+ パスの対応(個人設定の codex.pathMap):
212
+ 参照先 myapp → コンテナ /workspace/myapp(codex.pathMap の対応あり)
213
+ データ → コンテナ /data(codex.pathMap の対応あり)
214
+ ```
215
+
216
+ DevContainer で「対応あり」にならなければ 5. を見直す。評価とタスク案が出れば導入は終わり。
217
+
218
+ ## うまくいかないとき
219
+
220
+ 失敗はログとエラーに **次にすること** を添えて出す。直して、もう一度同じ操作をする。
221
+
222
+ | どこで | 出るもの | 確かめる | 直す |
223
+ | --- | --- | --- | --- |
224
+ | Preflight・`codex update` | `docker` が無い(ENOENT) | `docker version` | Docker を入れ、`PATH` を確かめる |
225
+ | 〃 | `Cannot connect to the Docker daemon` | `docker version` の Server、`docker context ls`、`DOCKER_HOST` | Docker を起動する。繋ぎ先と権限(3.)を直す |
226
+ | 〃 | `permission denied ... docker.sock` | `ls -l /var/run/docker.sock` | `docker` グループなど、ソケットの権限を直す |
227
+ | Preflight | `bind source path does not exist: <参照先 …>` / `<データ>` | ログの「パスの対応」、`p3 user-config` の `codex.pathMap`、5-1. の `docker inspect` | `p3 user-config set codex.pathMap+=<このマシンのパス>=<ホストのパス>`。「対応あり」なのに無いなら、右側(ホストのパス)の誤り。serve はそのままで次の Preflight から効く |
228
+ | Preflight | 「Codex のイメージを用意できません(app-server を起こす前)」 | `p3 codex update` の出力 | ネットワーク(プロキシ)を確かめて `p3 codex update` をやり直す。`Unable to find image` も同じ |
229
+ | Preflight・画面 | 「ChatGPT にサインインしてください」「ChatGPT の接続が切れています」「プランの利用が許可されていません」 | `p3 chatgpt status` | `p3 chatgpt login`(届かなければ `--paste`)。プランの利用に同意する |
230
+ | Preflight | 「Usage limit reached」 | ChatGPT の Manage usage(https://chatgpt.com/settings/usage) | 上限が戻るのを待つ |
231
+ | Preflight・画面 | 個人設定を読めない(YAML の行と直すファイル) | `~/.config/infodb-p3/config.yaml` | 書き間違いを直す。serve はそのままで次の Preflight から効く |
232
+ | CLI | プロジェクトが決まらない | `p3 whoami`、`p3 project` | `--project <名前>`、または `p3 project add <名前> <フォルダ>` |
233
+ | CLI・serve | 「データのフォルダがありません」「データのフォルダに project.yaml がありません」 | `p3 project ls` の登録先、フォルダを移していないか、共有ドライブ(同期するフォルダ)がつながっているか | つながっていなければつないでやり直す。移したなら `p3 project rm <名前>` → `p3 project add <名前> <正しいフォルダ>`(rm はデータを消さない。そのあと `p3 repo path` で手元のリポジトリを登録し直す)。新しく作るなら管理したいリポジトリの中で `p3 init --project <名前> --dir <フォルダ>` |
234
+ | 画面 | 開けない | serve のログ、ポートの転送 | 4310 を転送する。`serve.port` を変えたら転送先も変える |
235
+
236
+ ## 設定の決まり
237
+
238
+ マシン(と人)ごとの設定は、プロジェクトのデータではなく個人設定に置くか、環境変数で渡す。`.env` は読まない。
239
+ 値は項目ごとに **CLI の明示(`--port` / `--host` / `--engine`)→ 環境変数 → 個人設定 → 既定値** の順で決まる
240
+ (環境変数を空にすると既定値に戻す)。
241
+
242
+ | 個人設定 | 環境変数 | 内容 | 効くとき |
243
+ | --- | --- | --- | --- |
244
+ | `codex.pathMap` | `P3_CODEX_PATH_MAP`(`a=b,c=d`) | このマシンのパス → Docker のデーモンから見たパス | 次の Preflight |
245
+ | `codex.auth` | `P3_CODEX_AUTH` | `auto`(既定。ChatGPT に接続していればそれ)/ `legacy`(下の旧来の認証) | 次の Preflight |
246
+ | `codex.authVolume` / `codex.authFile` | `P3_CODEX_AUTH_VOLUME` / `P3_CODEX_AUTH_FILE` | 旧来の認証の `auth.json` の置き場所 | 次の Preflight |
247
+ | `codex.model` / `codex.effort` | `P3_CODEX_MODEL` / `P3_CODEX_EFFORT` | モデル・推論の深さ(省けば Codex の既定) | 次の Preflight |
248
+ | `codex.ensureImage` | `P3_CODEX_ENSURE_IMAGE`(`0` / `1`) | Preflight の前のイメージの作り直し(1日ごと) | 次の Preflight |
249
+ | `preflight.engine` | `P3_PREFLIGHT_ENGINE` | `mock` にすると Mock で評価する(下の補足) | 次の Preflight |
250
+ | `serve.host` / `serve.port` | `P3_HOST` / `P3_PORT` | `p3 serve` の待ち受け(既定 `0.0.0.0` / `4310`) | serve を起動し直したとき |
251
+ | `ui.theme` | — | 画面のテーマ(`system` / `light` / `dark`) | 画面を読み直したとき |
252
+
253
+ `p3 user-config` で全部の値と出どころを見て、`p3 user-config set キー=値` で変える(`キー=` で消す)。コメントとほかの項目は残る。
254
+ 環境変数は serve を起動したときのものが使われる。
255
+
256
+ ## 補足: 旧来の認証と Mock
257
+
258
+ ふだんは使わない。
259
+
260
+ - **旧来の認証**(ChatGPT に接続せず、Codex でサインインした `auth.json` を使う): P3 のイメージの中の Codex でサインインして
261
+ Docker のボリュームに置く(`codex.authVolume`)か、ホストの `~/.codex/auth.json` を Docker のホストから見たパスで書く
262
+ (`codex.authFile`。`codex.pathMap` は効かない)。ChatGPT に接続していればそちらが優先され、接続したまま使うなら `codex.auth=legacy`
263
+
264
+ ```bash
265
+ docker volume create codex-state
266
+ docker run --rm -it --entrypoint codex -v codex-state:/codex llmcs-codex-workspace:local login --device-auth
267
+ p3 user-config set codex.authVolume=codex-state
268
+ ```
269
+
270
+ - **Mock**: 要望本文の箇条書きをそのままタスク案にするだけの簡易評価。Codex を使えない環境で、画面とファイルの流れを
271
+ 確かめるためのもの(評価の質は確かめられない)。`--engine mock` か `preflight.engine=mock` を明示したときだけ使い、
272
+ 認証が無いときに自動で Mock に切り替えることはない
273
+
274
+ 設計の背景(なぜコンテナで動かすか・サインインの仕組み)は [docs/architecture.md](architecture.md) と
275
+ [docs/chatgpt-sign-in.md](chatgpt-sign-in.md)。
@@ -0,0 +1,65 @@
1
+ # 公開の手順(@infodb/p3)
2
+
3
+ P3 を npm に `@infodb/p3` として公開するときのチェックリスト。npm への公開とタグ付けは人が行う。
4
+ CI は使わず、手元で確かめてから公開する。
5
+
6
+ ## 1. 外部のパッケージ
7
+
8
+ - [ ] P3 が使う llmcs の部品(`@infodb/codex-workspace`・`@infodb/chatgpt-plan`)の必要な版が npm に公開されている
9
+ (`npm view @infodb/codex-workspace versions`)。llmcs を変えたら、llmcs 側で先に公開し、P3 の版の範囲を上げる
10
+ - [ ] 依存の版が公開から1日を過ぎている。pnpm の `minimumReleaseAge`(既定 1日)より新しい版は、新しいチェックアウトで
11
+ `pnpm install` が `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` で止まる。待たずに入れる例外(`minimumReleaseAgeExclude`)は
12
+ 自分たちの `@infodb/*` の部品を版で固定したものだけ([docs/architecture.md](architecture.md) の「llmcs の部品の依存」。
13
+ `test/package.test.ts` が確かめる)。1日を過ぎた版の例外は、公開の前に外す
14
+ - [ ] `package.json` と `pnpm-lock.yaml` に手元のフォルダへのリンク(`link:` / `file:`)が無い(`test/package.test.ts`)
15
+
16
+ ## 2. クリーンな依存の解決と検査
17
+
18
+ ```bash
19
+ git clone <このリポジトリ> /tmp/p3-release && cd /tmp/p3-release # 隣に llmcs が無い場所で
20
+ pnpm install --frozen-lockfile
21
+ pnpm -s check # 型検査・lint・テスト・画面のビルド
22
+ ```
23
+
24
+ ## 3. 配布物の確認
25
+
26
+ ```bash
27
+ node scripts/verify-pack.mjs --docker # npm pack → 実行時の依存だけで別の場所に入れて動かす(pnpm verify:pack でも同じ)
28
+ ```
29
+
30
+ - [ ] 全段が `ok`。確かめる段: Node の版と engines / tarball の中身 / `npm install`(開発用の依存が入らない)/
31
+ 別のリポジトリで `init --agents`・`whoami`・要望の作成・Mock の Preflight・メモを足した再評価・`serve`(画面・資産・API)/
32
+ `codex update`(`--docker`。未登録・未認証のまま本物の Docker でイメージを作り直し、版を読む)
33
+ - [ ] 下限の Node でも通す: `PATH=$(dirname $(npx -y node@22.0.0 -e "console.log(process.execPath)")):$PATH node scripts/verify-pack.mjs`
34
+ - [ ] Docker が無い環境で確かめたときは、`codex update` の段が「実行していない」と出る。その場合は Docker のある環境で
35
+ `--docker` を付けて通すまで、公開に進まない
36
+
37
+ ## 4. 公開する中身
38
+
39
+ - [ ] `npm pack --dry-run` の一覧に `.env`・個人設定・デモデータ・テスト・開発用のスキル(`.claude/`)が無い
40
+ - [ ] `npm pack --dry-run` の一覧に README から辿る文書(`docs/`)とそのリンクの先がある(`test/package.test.ts`)。README と docs/ の
41
+ 相対リンクと節のアンカーが解決する(`test/docs.test.ts`)
42
+ - [ ] 公開するリポジトリと tarball に、環境に固有のパス・個人の情報が無い。例は `~/p3-data/myapp`・`/home/me/...`・
43
+ `/workspaces`(DevContainer の慣例)のような汎用のものにする。コンテナの中の `/workspace`(リポジトリ)と `/data`
44
+ (データのフォルダ)は Codex のコンテナとの約束なので残す
45
+ - [ ] `package.json` の `repository` / `homepage` / `bugs` が実際の公開先を指している(リポジトリを公開してから確かめる)
46
+ - [ ] 版を上げた(`package.json` の `version`)
47
+
48
+ ## 5. 公開(人が行う)
49
+
50
+ ```bash
51
+ npm login # @infodb のスコープに公開できるアカウント
52
+ npm publish # prepack で画面をビルドする。publishConfig.access は public
53
+ ```
54
+
55
+ 公開した後に、別の環境で `pnpx @infodb/p3 --help` が動くことを確かめる(その版も公開から1日は pnpm の既定では入らない。
56
+ `npx @infodb/p3` か、`pnpm dlx --config.minimum-release-age=0 @infodb/p3` で確かめる)。
57
+
58
+ ## 履歴の確認(2026-10-11、0.1.0 の準備のとき)
59
+
60
+ 公開の前に Git の履歴(全ブランチ・63 コミット)を確かめた。
61
+
62
+ - 秘密の値(API キー・トークン・JWT・秘密鍵・npm / GitHub のトークン・`refresh_token`): 見つからなかった
63
+ - 秘密のファイル(`.env`・`auth.json`・`chatgpt.json`・鍵): 追跡されたことは無い(以前は値の無い例の `.env.example` だけを追跡していたが、P3 は `.env` を読まないので消した)
64
+ - 個人の情報: コミットの作成者のメールアドレス(全コミット。Git の通常の記録)と、初期のコミットの README・デモの例に
65
+ 同じメールアドレスがあった(今のファイルには無い)。履歴は書き換えていない。公開してよいかは持ち主が判断する
package/package.json CHANGED
@@ -1,6 +1,89 @@
1
1
  {
2
2
  "name": "@infodb/p3",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "0.1.0",
4
+ "description": "File-based project management with AI-powered preflight (Codex App Server)",
5
+ "keywords": [
6
+ "project-management",
7
+ "task",
8
+ "codex",
9
+ "preflight",
10
+ "cli"
11
+ ],
12
+ "license": "MIT",
13
+ "author": "tamuto",
14
+ "homepage": "https://github.com/tamuto/p3#readme",
15
+ "repository": {
16
+ "type": "git",
17
+ "url": "git+https://github.com/tamuto/p3.git"
18
+ },
19
+ "bugs": {
20
+ "url": "https://github.com/tamuto/p3/issues"
21
+ },
22
+ "type": "module",
23
+ "engines": {
24
+ "node": ">=22"
25
+ },
26
+ "bin": {
27
+ "p3": "bin/p3.mjs"
28
+ },
29
+ "files": [
30
+ "bin",
31
+ "src/cli",
32
+ "src/core",
33
+ "src/server",
34
+ "src/shared",
35
+ "dist/web",
36
+ "skills",
37
+ "docs"
38
+ ],
39
+ "publishConfig": {
40
+ "access": "public"
41
+ },
42
+ "dependencies": {
43
+ "@hono/node-server": "~2.1.3",
44
+ "@infodb/chatgpt-plan": "^0.1.1",
45
+ "@infodb/codex-workspace": "^0.2.0",
46
+ "hono": "^4.13.13",
47
+ "tsx": "^4.23.15",
48
+ "yaml": "^2.9.1",
49
+ "zod": "^4.6.5"
50
+ },
51
+ "devDependencies": {
52
+ "@tailwindcss/vite": "^4.3.3",
53
+ "@tanstack/react-router": "^1.170.41",
54
+ "@tanstack/router-cli": "^1.167.40",
55
+ "@tanstack/router-plugin": "^1.168.42",
56
+ "@types/node": "^24.0.0",
57
+ "@types/react": "^19.3.0",
58
+ "@types/react-dom": "^19.3.0",
59
+ "@vitejs/plugin-react": "^6.1.2",
60
+ "concurrently": "^10.0.5",
61
+ "oxlint": "1.87.0",
62
+ "oxlint-tsgolint": "7.0.2004",
63
+ "react": "^19.3.0",
64
+ "react-dom": "^19.3.0",
65
+ "react-markdown": "^10.1.0",
66
+ "remark-gfm": "^4.0.1",
67
+ "tailwindcss": "^4.3.3",
68
+ "typescript": "^7.0.2",
69
+ "vite": "^8.3.3",
70
+ "vitest": "^4.1.11"
71
+ },
72
+ "scripts": {
73
+ "dev": "pnpm demo && concurrently -n server,web -c blue,magenta \"pnpm:dev:server\" \"pnpm:dev:web\"",
74
+ "dev:server": "tsx watch --clear-screen=false src/cli/main.ts serve --dir .p3-demo",
75
+ "dev:web": "vite",
76
+ "build": "vite build",
77
+ "start": "pnpm demo && node bin/p3.mjs serve --dir .p3-demo",
78
+ "p3": "node bin/p3.mjs",
79
+ "demo": "tsx scripts/demo.ts",
80
+ "demo:reset": "tsx scripts/demo.ts --force",
81
+ "routes": "tsr generate",
82
+ "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
+ "test": "vitest run",
85
+ "test:watch": "vitest",
86
+ "check": "pnpm typecheck && pnpm lint && pnpm test && pnpm build",
87
+ "verify:pack": "node scripts/verify-pack.mjs"
88
+ }
6
89
  }
@@ -0,0 +1,95 @@
1
+ ---
2
+ name: p3
3
+ description: infodb p3(P³)で、このリポジトリの要望とタスクを管理する。ユーザーが要望の登録・Preflight の結果の確認・タスクの着手や完了・進捗の確認を頼んだとき、または要望 ID(261009-k7m3x の形)やタスク(T003)に触れたときに使う。
4
+ ---
5
+
6
+ # p3 でこのプロジェクトの作業を管理する
7
+
8
+ このリポジトリの作業は、infodb p3 の **要望** と、要望から生まれた **タスク** で管理する。
9
+ 要望・タスク・Preflight の記録は「データのフォルダ」にファイルで置かれ、人と AI が同じ CLI で操作する。
10
+ データのフォルダのファイルは直接編集しない。必ず CLI を通す。
11
+
12
+ ## CLI の呼び方
13
+
14
+ ```bash
15
+ P3_ACTOR=ai:<エージェント名> p3 <コマンド> [引数] --json
16
+ ```
17
+
18
+ - `p3` が入っていなければ `pnpx @infodb/p3 <コマンド>` で同じように動く(`npx @infodb/p3` でもよい)
19
+ - 最初に `p3 whoami --json` で、操作するプロジェクト・データのフォルダ・決まり方(`via`)・変更者・今の要望を確かめる。
20
+ 対象のプロジェクトは今いる場所(リポジトリ・作業ツリー)と個人設定から決まる。決まらなければ、出てきた一覧と案内に従って
21
+ `--project <名前>` を付ける(名前を推測で決めない)
22
+ - `via` が `cwd`(今いる場所で決まった)でなければ(`dir` / `project` / `legacy` / `only`)、それ以上 p3 を操作せず、
23
+ 対象のプロジェクトでよいかユーザーに確かめる。特に `only` は登録が1つだけというだけで、p3 を使わないフォルダでも決まる。
24
+ 推測した `--project` や `--dir` を付けて確認を避けない。ユーザーが対象を指定した・確かめた後は、その対象のまま続ける
25
+ - `P3_ACTOR=ai:<名前>` は変更者の記録。変更するコマンドには必ず付ける
26
+ - 結果は `--json` で読む。人に見せる表はオプションなしの出力でよい
27
+ - 終了コード: 0 成功 / 1 使い方の誤り(メッセージに次にすることが出る)/ 2 見つからない / 3 競合(`show --brief` で読み直してやり直す)
28
+ - 詳細は、作業に使うときは短い出力 `show <要望ID>/T003 --brief --json` / `request show <要望ID> --brief --json` で読む
29
+ (本文・状態・rev・依存とその状態・置き換えの注意・成果物・ブランチだけが出る)
30
+ - 迷ったら `p3 help`
31
+
32
+ ## 人と AI の役割
33
+
34
+ | 操作 | するのは |
35
+ | --- | --- |
36
+ | 要望の登録(`request new`) | AI も人も |
37
+ | Preflight(評価・細分化。`preflight`)とタスク化(`accept`) | **人だけ** |
38
+ | タスクの着手・完了(`move ... doing` / `done`)と成果物の登録、作業中に見つけたタスクの追加 | AI も人も |
39
+ | 要望を対応済にする(`request set <要望ID> status=resolved`) | 作業を終えた AI(か人) |
40
+ | 要望の完了済(`done`)・見送り(`rejected`)、タスクの済み(`check`) | **人だけ** |
41
+
42
+ ## 要望を登録する(ユーザーから新しい作業を頼まれたとき)
43
+
44
+ 1. `request new "<タイトル>" --body "<背景・やりたいこと・完了条件を箇条書きで>"`(任意で `--area src/web --tag ui --due YYYY-MM-DD --milestone <id>`)
45
+ 2. 登録したら要望 ID をユーザーに伝えて終える。**Preflight(評価・細分化)とタスク化(`accept`)は人が行う。**
46
+ AI からは実行しない(勧めたり、実行してよいか尋ねたりもしない)。人がタスク化を終えたら、タスクを進める
47
+
48
+ 人が行った Preflight の内容を聞かれたら、`drafts <要望ID>` で評価とタスク案を読んで答えてよい(読むだけ)。
49
+ `drafts` には「調べた範囲」(参照先ごとに読んだか)と「判断の根拠」(確かめた / 推測)も出る。答えるときは、見ていない参照先や
50
+ 推測の根拠に基づく判断であることを伝える。参照先の登録(`repo add` / `repo path`)はユーザーに頼まれたときだけ行う。
51
+ 評価の確認事項(questions)への回答を頼まれたら、`preflight <要望ID> --note "..." --note-only` でメモとして残す(実行はしない)。
52
+
53
+ ## タスクを進める
54
+
55
+ 作業は **作業先のリポジトリの、要望のブランチ** で行う。タスクごとの作業先とブランチは
56
+ `show <要望ID>/T003 --brief --json` の `work`(`repo`・`branch`)に出る(要望全体は `request show <要望ID> --brief --json` の `branches`)。
57
+
58
+ 1. 作業先に入る: `work.repo` のリポジトリ(場所は `repo ls`)で、`work.branch` に切り替える(無ければ最新の既定のブランチから作る。
59
+ 作業ツリーを使うかどうかと置き場所は任せる)。`work.repo` が `null`(作業先なし: 調査・人の判断など)なら移動は要らない。ブランチの無い
60
+ 作業先(git でないフォルダ)はそのフォルダで作業する。このマシンのパスが未登録(`work.registered` が false)なら、場所をユーザーに
61
+ 聞いて登録してもらい(`repo path <名前> <パス>`)、`whoami` で今の要望と今いる参照先を確かめてから始める
62
+ 2. `ls --req <要望ID>` で一覧、`show <要望ID>/T003 --brief --json` で中身と依存を読む。`dependencies` の `status` が
63
+ `done` でない依存があるタスクから始めない(`null` は相手が見つからない。完了とは扱わず、ユーザーに確かめる)。
64
+ **置き換えられたタスク**(`ls` の `※置換`、`--json` の `superseded` と `warnings`)からは始めない。残っていれば扱いをユーザーに確かめる
65
+ (不要ならユーザーの了承を得て `archive`)。`move` が警告(`warnings`)を返したら、作業を止めてユーザーに伝える
66
+ 3. 着手: `move T003 doing --req <要望ID>`
67
+ 4. 作業し、プロジェクトのテストを通してブランチにコミット・push したら、完了:
68
+ `move T003 done --req <要望ID> --output <コミットか PR の URL> --record - < record.md`(成果物が複数あれば `--output` を繰り返す)。
69
+ **変更の記録(`--record`)は必須**: 何を変えたか(振る舞いの言葉で)・なぜ・入れた決まり・やめたもの を Markdown で短く書く。
70
+ 後の Preflight が経緯を調べるとき、タスクの解析・リリースノートの材料として読む(パスの羅列ではなく、目的と決まりを書く)
71
+ 5. 作業中に見つけた追加の作業は `new "<タイトル>" --req <要望ID> --body "..."` でタスクにする(タスクの関係は Preflight のタスク化が張るもので、手では張らない。順序は本文に書く)
72
+ 6. 要望のタスクが全部完了したら(`ls --req <要望ID>` が全部 done、成果物と検証も済み)、要望を **対応済** にする:
73
+ `request set <要望ID> status=resolved --json`。未完了のタスクがあると拒否される(終わらせるか、不要ならユーザーの了承を得て
74
+ `archive`)。拒否をタスクを偽って完了にする・ファイルを直接書き換えるなどで回避しない
75
+ 7. PR はユーザーに確認してから作る(本文に要望 ID とタスクの一覧)。作った PR の URL は最後のタスクに足す。複数のリポジトリに
76
+ またがる要望は、関係するリポジトリの PR を全部 `--repo-output <参照先の名前>=<PR の URL>` で最後のタスクに残す
77
+ (例: `move T005 done --repo-output app=<URL> --repo-output infra=<URL>`。1つのリポジトリなら今までどおり `--output` でよい)。
78
+ マージ・要望の完了済(`done`)は人が行う
79
+ 8. 対応済の後にタスクを足した・完了から戻したときは、要望は自動で進行中に戻る(`--json` の `reopened`)。
80
+ 終えたらもう一度 6 で対応済にする
81
+
82
+ ## してはいけないこと
83
+
84
+ - Preflight の実行(`preflight`)とタスク化(`accept`)をしない。どちらも人が行う
85
+ - `check`(済み)を付けない。済みは人が成果物を確認して付ける
86
+ - 要望のステータスを `done`(完了済)/ `rejected`(見送り)にしない(人が決める)。AI がするのは作業を終えたときの `resolved`(対応済)まで。
87
+ タスク化で `active` になるのは自動
88
+ - タスクを要望をまたいで動かさない。別の要望の作業なら、その要望にタスクを足すか、新しい要望を提案する
89
+ - データのフォルダ(`p3 whoami` に出る場所)や個人設定(`~/.config/infodb-p3/`)のファイルを直接書き換えない
90
+ - 人への質問をタスクにしない
91
+
92
+ ## 状況を報告する
93
+
94
+ - 全体: `progress`(マイルストーンごと)。要望の中: `ls --req <要望ID>`
95
+ - 画面はユーザーが `p3 serve` で開く(既定 http://localhost:4310)。CLI の変更はそのまま画面に反映される