@infodb/p3 0.12.0 → 0.14.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 (219) hide show
  1. package/README.md +33 -35
  2. package/bin/p3.mjs +3 -2
  3. package/dist/web/assets/CompletionReview-BD7d6Yzt.js +1 -0
  4. package/dist/web/assets/ImprovementDialog-BoAZN1KR.js +1 -0
  5. package/dist/web/assets/Outputs-D-ZouoxF.js +1 -0
  6. package/dist/web/assets/RequestStatus-Bl3fdSbM.js +1 -0
  7. package/dist/web/assets/Tabs-CxeceOL-.js +1 -0
  8. package/dist/web/assets/TagInput-CeAbmGRR.js +1 -0
  9. package/dist/web/assets/TaskDrawer-BCriSnhe.js +6 -0
  10. package/dist/web/assets/_requestId-CZKMe_mC.js +1 -0
  11. package/dist/web/assets/_requestId-Fx4lLkFo.js +1 -0
  12. package/dist/web/assets/appCtx-BdxbkSZa.js +1 -0
  13. package/dist/web/assets/archive-D5IIxcSV.js +1 -0
  14. package/dist/web/assets/board-p6R9KMqd.js +1 -0
  15. package/dist/web/assets/done-BTOF188x.js +1 -0
  16. package/dist/web/assets/draft-BWYpm3PD.js +2 -0
  17. package/dist/web/assets/index-DFbY8NAR.css +2 -0
  18. package/dist/web/assets/index-Dpqi2dcC.js +12 -0
  19. package/dist/web/assets/link-D481whDt.js +1 -0
  20. package/dist/web/assets/metrics-CAzP6V8I.js +1 -0
  21. package/dist/web/assets/new-C65IJJg3.js +1 -0
  22. package/dist/web/assets/outputs-CXqnjSqV.js +1 -0
  23. package/dist/web/assets/preflightInput-ClKwkp8R.js +2 -0
  24. package/dist/web/assets/preload-helper-_dAYMct_.js +1 -0
  25. package/dist/web/assets/{quality-Pu6EISAM.js → quality-RFd-7k3r.js} +1 -1
  26. package/dist/web/assets/release-notes-Dtif8xsQ.js +5 -0
  27. package/dist/web/assets/requestData-SPc36t8Q.js +1 -0
  28. package/dist/web/assets/routes-DJj8CWuk.js +6 -0
  29. package/dist/web/assets/settings-DKJd7CLe.js +1 -0
  30. package/dist/web/assets/ui-CbEOnPnF.js +1 -0
  31. package/dist/web/assets/workTarget-DavxMs-c.js +30 -0
  32. package/dist/web/index.html +6 -4
  33. package/docs/architecture.md +430 -72
  34. package/docs/chatgpt-sign-in.md +2 -2
  35. package/docs/development.md +141 -64
  36. package/docs/feature-inventory.md +139 -0
  37. package/docs/how-to-use.md +389 -31
  38. package/docs/installation.md +261 -147
  39. package/docs/publishing.md +33 -14
  40. package/docs/refactoring.md +332 -0
  41. package/lib/cli/agentsStatus.js +198 -0
  42. package/lib/cli/guide.js +27 -0
  43. package/lib/cli/guide.md +217 -0
  44. package/lib/cli/help.js +45 -7
  45. package/lib/cli/main.js +58 -207
  46. package/lib/cli/project.js +34 -294
  47. package/lib/core/projectRegistry.js +2 -2
  48. package/lib/kit/appInfo.js +13 -0
  49. package/lib/kit/usage.js +27 -0
  50. package/lib/server/api/projectsRoutes.js +5 -5
  51. package/lib/server/server.js +7 -4
  52. package/lib/{cli → tasks/cli}/args.js +73 -9
  53. package/lib/{cli → tasks/cli}/chatgpt.js +1 -1
  54. package/lib/{cli → tasks/cli}/codex.js +1 -1
  55. package/lib/{cli → tasks/cli}/output.js +12 -2
  56. package/lib/{cli → tasks/cli}/preflightCommands.js +1 -1
  57. package/lib/tasks/cli/readOnly.js +75 -0
  58. package/lib/{cli → tasks/cli}/render.js +1 -1
  59. package/lib/{cli → tasks/cli}/requestCommands.js +24 -7
  60. package/lib/tasks/cli/showView.js +279 -0
  61. package/lib/{cli → tasks/cli}/taskCommands.js +55 -21
  62. package/lib/tasks/cli/tasksCli.js +149 -0
  63. package/lib/{core → tasks/core}/context.js +6 -9
  64. package/lib/tasks/core/errorOutcome.js +125 -0
  65. package/lib/{core → tasks/core}/hierarchy.js +1 -1
  66. package/lib/{core → tasks/core}/ops.js +17 -2
  67. package/lib/{core → tasks/core}/preflight/carryover.js +5 -1
  68. package/lib/{core → tasks/core}/preflight/codexEngine.js +36 -28
  69. package/lib/{core → tasks/core}/preflight/diagnose.js +4 -9
  70. package/lib/{core → tasks/core}/preflight/engine.js +9 -0
  71. package/lib/tasks/core/preflight/hostPaths.js +299 -0
  72. package/lib/{core → tasks/core}/preflight/input.js +33 -5
  73. package/lib/{core → tasks/core}/preflight/instructions.js +19 -2
  74. package/lib/{core → tasks/core}/preflight/mockEngine.js +27 -8
  75. package/lib/{core → tasks/core}/preflight/render.js +22 -3
  76. package/lib/{core → tasks/core}/preflight/service.js +86 -11
  77. package/lib/{core → tasks/core}/preflight/uiRender.js +5 -2
  78. package/lib/{core → tasks/core}/requestOps.js +214 -17
  79. package/lib/{core → tasks/core}/reviewRuns.js +127 -22
  80. package/lib/{core → tasks/core}/store/attachments.js +3 -2
  81. package/lib/{core → tasks/core}/store/collection.js +21 -2
  82. package/lib/tasks/core/store/fieldGroups.js +30 -0
  83. package/lib/tasks/core/store/jsonRecord.js +30 -0
  84. package/lib/{core → tasks/core}/store/normalize.js +15 -10
  85. package/lib/{core → tasks/core}/store/noteStore.js +2 -2
  86. package/lib/{core → tasks/core}/store/preflightStore.js +59 -22
  87. package/lib/{core → tasks/core}/store/projectFile.js +1 -1
  88. package/lib/{core → tasks/core}/store/workspace.js +28 -6
  89. package/lib/{core → tasks/core}/userConfig.js +1 -1
  90. package/lib/{core → tasks/core}/workTargets.js +1 -1
  91. package/lib/tasks/features/metrics/cli/metricsCommands.js +77 -0
  92. package/lib/tasks/features/metrics/core/definitions.js +445 -0
  93. package/lib/tasks/features/metrics/core/index.js +112 -0
  94. package/lib/tasks/features/metrics/core/manual.js +179 -0
  95. package/lib/tasks/features/metrics/server/metricsRoutes.js +8 -0
  96. package/lib/tasks/features/metrics/shared/metrics.js +42 -0
  97. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/code.js +2 -11
  98. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/material.js +5 -6
  99. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/review.js +2 -2
  100. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/service.js +38 -100
  101. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/store.js +3 -3
  102. package/lib/{server/api → tasks/features/milestoneReview/server}/milestoneReviewRoutes.js +7 -13
  103. package/lib/{cli → tasks/features/quality/cli}/qualityCommands.js +36 -11
  104. package/lib/{core → tasks/features/quality/core}/qualityImprovement.js +16 -15
  105. package/lib/tasks/features/records/cli/revisitCommands.js +73 -0
  106. package/lib/tasks/features/records/core/completionRefs.js +46 -0
  107. package/lib/tasks/features/records/core/reviewCandidates.js +76 -0
  108. package/lib/tasks/features/records/shared/completionRecord.js +329 -0
  109. package/lib/tasks/features/records/shared/reviewCandidate.js +313 -0
  110. package/lib/tasks/features/records/shared/reworkHistory.js +86 -0
  111. package/lib/{cli → tasks/features/releaseNotes/cli}/releaseNotesCommands.js +7 -7
  112. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/completeRequests.js +5 -6
  113. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/generate.js +3 -14
  114. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/material.js +3 -4
  115. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/service.js +1 -1
  116. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/store.js +2 -2
  117. package/lib/{server/api → tasks/features/releaseNotes/server}/releaseNoteRoutes.js +11 -20
  118. package/lib/tasks/features/requirements/cli/requirementCommands.js +289 -0
  119. package/lib/{shared → tasks/features/requirements/shared}/acceptance.js +292 -18
  120. package/lib/tasks/features/requirements/shared/requirementSource.js +635 -0
  121. package/lib/tasks/features/retro/cli/retroCommands.js +106 -0
  122. package/lib/tasks/features/retro/core/retrospective.js +197 -0
  123. package/lib/tasks/features/retro/shared/retrospective.js +286 -0
  124. package/lib/tasks/features/settings/cli/projectSettings.js +245 -0
  125. package/lib/{cli → tasks/features/settings/cli}/userConfig.js +50 -3
  126. package/lib/{core → tasks/features/settings/core}/machineSettingsEdit.js +2 -2
  127. package/lib/{core → tasks/features/settings/core}/repoAdmin.js +3 -3
  128. package/lib/{core → tasks/features/settings/core}/userTheme.js +2 -2
  129. package/lib/{server/api → tasks/features/settings/server}/repoRoutes.js +2 -2
  130. package/lib/{server/api → tasks/features/settings/server}/userThemeRoutes.js +3 -3
  131. package/lib/{cli → tasks/features/taskReview/cli}/taskReviewCommands.js +5 -5
  132. package/lib/{core/taskReview → tasks/features/taskReview/core}/material.js +13 -7
  133. package/lib/{core/taskReview → tasks/features/taskReview/core}/review.js +10 -3
  134. package/lib/{core/taskReview → tasks/features/taskReview/core}/service.js +24 -85
  135. package/lib/{core/taskReview → tasks/features/taskReview/core}/store.js +4 -4
  136. package/lib/{server/api → tasks/features/taskReview/server}/taskReviewRoutes.js +7 -14
  137. package/lib/{server → tasks/server}/api/manifest.js +51 -3
  138. package/lib/{server → tasks/server}/api/routes.js +134 -65
  139. package/lib/tasks/shared/commitRefs.js +10 -0
  140. package/lib/{shared → tasks/shared}/preflightInput.js +1 -1
  141. package/package.json +1 -43
  142. package/skills/p3/SKILL.md +9 -181
  143. package/dist/web/assets/ImprovementDialog-kQaVBGWH.js +0 -1
  144. package/dist/web/assets/Outputs-_nU_p3nu.js +0 -1
  145. package/dist/web/assets/RequestStatus-RG-OVQYY.js +0 -1
  146. package/dist/web/assets/Tabs-ew9i5SKX.js +0 -1
  147. package/dist/web/assets/TagInput-BtlJTF7i.js +0 -1
  148. package/dist/web/assets/TaskDrawer-DW8GyJqI.js +0 -6
  149. package/dist/web/assets/_requestId-6Nb727dD.js +0 -1
  150. package/dist/web/assets/_requestId-BykTgPax.js +0 -1
  151. package/dist/web/assets/appCtx-CxDdXABS.js +0 -1
  152. package/dist/web/assets/archive-Ckh295Xe.js +0 -1
  153. package/dist/web/assets/board-BVAIjK-Y.js +0 -1
  154. package/dist/web/assets/done-BGfA-3MA.js +0 -1
  155. package/dist/web/assets/draft-CfJeyLOl.js +0 -1
  156. package/dist/web/assets/index-CgRU744I.css +0 -2
  157. package/dist/web/assets/index-DacQ0yl4.js +0 -12
  158. package/dist/web/assets/new-DVygWvVc.js +0 -1
  159. package/dist/web/assets/outputs-B6xDsLZf.js +0 -1
  160. package/dist/web/assets/preflightInput-BAeEJYUK.js +0 -2
  161. package/dist/web/assets/preload-helper-DyCqp21K.js +0 -1
  162. package/dist/web/assets/release-notes-CCpzyiNf.js +0 -5
  163. package/dist/web/assets/requestData-D5vBnuMh.js +0 -1
  164. package/dist/web/assets/routes-Q91zvNc0.js +0 -4
  165. package/dist/web/assets/settings-BzRgcmUm.js +0 -1
  166. package/dist/web/assets/workTarget-C9c57JAO.js +0 -30
  167. package/lib/cli/readOnly.js +0 -38
  168. package/lib/cli/showView.js +0 -166
  169. /package/lib/{core/store → kit}/frontmatter.js +0 -0
  170. /package/lib/{core/store → kit}/fsutil.js +0 -0
  171. /package/lib/{cli → tasks/cli}/format.js +0 -0
  172. /package/lib/{core → tasks/core}/chatgpt.js +0 -0
  173. /package/lib/{core → tasks/core}/machineSettings.js +0 -0
  174. /package/lib/{core → tasks/core}/preflight/codexImage.js +0 -0
  175. /package/lib/{core → tasks/core}/preflight/docker.js +0 -0
  176. /package/lib/{core → tasks/core}/preflight/launch.js +0 -0
  177. /package/lib/{core → tasks/core}/preflight/launcher.mjs +0 -0
  178. /package/lib/{core → tasks/core}/preflight/mock-ui.html +0 -0
  179. /package/lib/{core → tasks/core}/preflight/mock-ui.png +0 -0
  180. /package/lib/{core → tasks/core}/preflight/owner.js +0 -0
  181. /package/lib/{core → tasks/core}/preflight/render-image/Dockerfile +0 -0
  182. /package/lib/{core → tasks/core}/preflight/render-image/fonts-ja.conf +0 -0
  183. /package/lib/{core → tasks/core}/preflight/render-image/render.mjs +0 -0
  184. /package/lib/{core → tasks/core}/preflight/split.js +0 -0
  185. /package/lib/{core → tasks/core}/preflight/uiMaterials.js +0 -0
  186. /package/lib/{core → tasks/core}/preflight/wireframe.js +0 -0
  187. /package/lib/{core → tasks/core}/preflight/xlsx.js +0 -0
  188. /package/lib/{core → tasks/core}/redact.js +0 -0
  189. /package/lib/{core → tasks/core}/repoRefs.js +0 -0
  190. /package/lib/{core → tasks/core}/requestStatus.js +0 -0
  191. /package/lib/{core → tasks/core}/store/archivedTasks.js +0 -0
  192. /package/lib/{core → tasks/core}/store/dataWatcher.js +0 -0
  193. /package/lib/{core → tasks/core}/store/locate.js +0 -0
  194. /package/lib/{core → tasks/core}/supersede.js +0 -0
  195. /package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/mockReviewer.js +0 -0
  196. /package/lib/{shared → tasks/features/milestoneReview/shared}/milestoneReview.js +0 -0
  197. /package/lib/{core → tasks/features/quality/core}/quality.js +0 -0
  198. /package/lib/{shared → tasks/features/quality/shared}/quality.js +0 -0
  199. /package/lib/{shared → tasks/features/quality/shared}/qualityImprovement.js +0 -0
  200. /package/lib/{shared → tasks/features/quality/shared}/qualityTemplates.js +0 -0
  201. /package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/mockSummarizer.js +0 -0
  202. /package/lib/{core/taskReview → tasks/features/taskReview/core}/mockReviewer.js +0 -0
  203. /package/lib/{core/taskReview → tasks/features/taskReview/core}/paths.js +0 -0
  204. /package/lib/{shared → tasks/features/taskReview/shared}/taskReview.js +0 -0
  205. /package/lib/{server → tasks/server}/api/chatgptRoutes.js +0 -0
  206. /package/lib/{server → tasks/server}/api/local.js +0 -0
  207. /package/lib/{shared → tasks/shared}/dates.js +0 -0
  208. /package/lib/{shared → tasks/shared}/directTask.js +0 -0
  209. /package/lib/{shared → tasks/shared}/hierarchy.js +0 -0
  210. /package/lib/{shared → tasks/shared}/milestoneGoals.js +0 -0
  211. /package/lib/{shared → tasks/shared}/milestoneOrder.js +0 -0
  212. /package/lib/{shared → tasks/shared}/preflightRunner.js +0 -0
  213. /package/lib/{shared → tasks/shared}/refs.js +0 -0
  214. /package/lib/{shared → tasks/shared}/repos.js +0 -0
  215. /package/lib/{shared → tasks/shared}/scopeView.js +0 -0
  216. /package/lib/{shared → tasks/shared}/tags.js +0 -0
  217. /package/lib/{shared → tasks/shared}/taskBlock.js +0 -0
  218. /package/lib/{shared → tasks/shared}/types.js +0 -0
  219. /package/lib/{shared → tasks/shared}/workTarget.js +0 -0
@@ -1,92 +1,67 @@
1
1
  # 導入ガイド
2
2
 
3
- infodb p3(以下 P3)を入れて、最初の Preflight を動かせる状態にするまでの手順。要望を作ってからの使い方は
4
- [使い方ガイド](how-to-use.md) へ続く。
3
+ infodb p3(以下 P3)を使い始めるまでの手順。全部を一度にそろえなくてよい。段階 0 だけで要望とタスクを使い始められ、
4
+ 段階 1・2 は必要になってから足す。要望を作ってからの使い方は [使い方ガイド](how-to-use.md) へ続く。
5
5
 
6
- P3 の Preflight は、Codex を **Docker のコンテナの中で** 動かす。導入でつまずくのはほとんどが Docker とパスの対応なので、
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
- Docker と ChatGPT の接続が要るのは Preflight(Codex)・リリースノートの要約の生成・画面イメージの描画だけで、要望・タスク・
10
- 変更の記録・マイルストーンの管理と、リリースノートを手で書いて保存することは無くても動く。Docker を用意できない・Preflight が止まる間も、Preflight を通さずにタスクを作って進められる
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
- P3 を Docker のコンテナで動かす(プロジェクトを跨ぐ serve を既定にする)ときは、後の「[Docker で動かす](#docker-で動かすプロジェクトを跨ぐ-serve)」。
20
+ 要るのは **Node.js 24 以上(推奨 26)** と **Git**(`node -v` と `git --version` で確かめる)。版の補足は後の「[Node.js の版](#補足-nodejs-の版と同じ版で動かすこと)」。
28
21
 
29
- ## 1. 必要なもの
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
- - Codex をこのマシンに入れる必要はない(コンテナのイメージに入れる)。画面はビルド済みのものが入っているので、ビルドも要らない
40
- - P3 そのものを開発するときと、Docker のイメージ(`tamuto/p3`・描画のイメージ)は Node 26 を使う([開発ガイド](development.md))。
41
- 使うだけなら 24 以上でよい
42
- - **Node 22 から上げるとき**: Node 22 はサポートの終わり(2027-04-30)が近いので、この版から P3 は Node 24 以上で動かす(`engines` は
43
- `>=24`)。Node 22 のままでも止められるとは限らない: npm は入れるときに警告(`EBADENGINE`)を出して入れ、`engine-strict=true`
44
- なら断る。pnpm(12.10 で確かめた)と `pnpx` は警告を出さずに入れて動かす。`node -v` を確かめ、24 以上(推奨 26)に上げてから入れ直す。Docker で動かしているなら、新しいイメージを `docker pull` してコンテナを作り直す
45
- (起動し直すだけでは前のイメージの Node のまま)
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
- ## 2. 動かす場所
30
+ **できたと分かる目安**: ブラウザに、そのプロジェクトの「進捗」(要望の一覧)が出る。
51
31
 
52
- P3 が Codex のコンテナを作るとき、リポジトリとデータのフォルダを **Docker のデーモンから見たパス** でマウントする。
53
- そのため、次の3つのパスを区別する。
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
- 動かし方は2通りある。
40
+ 管理したいリポジトリの中で:
62
41
 
63
- - **A. ホストで直接動かす**(Mac・Linux・WSL の中で `p3` を実行し、Docker も同じ環境のもの): 1つ目と2つ目のパスが同じなので、
64
- パスの対応は要らない
65
- - **B. VS Code の DevContainer の中で動かし、Docker はホストのデーモンを使う**(docker-outside-of-docker): 1つ目と2つ目の
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
- > Docker Desktop・WSL・リモートの Docker(`DOCKER_HOST` で別のマシンを指す)では、パスの見え方がさらに違うことがある。
69
- > この文書の手順は A と B(VS Code の DevContainer と、そのホストの Docker)で書いている。ほかの形では、「Docker のデーモンから
70
- > 見たパス」を自分の環境で確かめてから 5. の対応を書く。
46
+ **できたと分かる目安**: ブラウザに「進捗」(まだ要望が無い一覧)と「新しい要望」のボタンが出る。
71
47
 
72
- ## 3. Docker に繋がるか確かめる
48
+ - できた `.p3` をリポジトリに入れて共有すれば、ほかの人は上の「参加する」で加われる。git に入れるか(`.gitignore` に書くか)は
49
+ 自分で決める(p3 は `.gitignore` を書き換えず、データをコミットもしない)
50
+ - 作るときの細かい選び方(データをリポジトリの外に置く・何のプロジェクトかを書く・AI 向けの入口を置く)は後の「[作るときに選べること](#作るときに選べること)」。
51
+ 後から変えられるので、最初は `--yes` のままでよい
73
52
 
74
- ```bash
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
- | `docker: command not found` | Docker の CLI が無い。Docker Desktop か Docker Engine を入れ、`PATH` を確かめる。DevContainer なら、CLI を入れる設定(docker-outside-of-docker の feature など)を足す |
82
- | Server の行が無い・`Cannot connect to the Docker daemon` | デーモンに繋がらない。Docker を起動する。繋ぎ先は `docker context ls`(`*` が今のもの)と環境変数 `DOCKER_HOST` で確かめる。DevContainer なら、ホストのソケット(`/var/run/docker.sock`)が渡っているか |
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
- ## 4. プロジェクトを作る(か参加する)
60
+ ### 作るときに選べること
86
61
 
87
- 管理したいリポジトリの中で `p3 init` を実行し、プロジェクト名と **データを置くフォルダ** を決める。データのフォルダの既定は
88
- **リポジトリのルートの `.p3`**(git のメインの作業ツリーの直下。サブフォルダや要望の作業ツリーから実行してもそこ。git 管理外なら
89
- 実行した場所の `.p3`)で、ふつうはこのまま Enter で決める。
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 --agents
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
- - ほかの人が作って共有したプロジェクトには **`p3 join`** で参加する(下の「参加する」)
119
- - 既定の `.p3` を git に入れるか(`.gitignore` に書くか)は自分で決める。p3 は `.gitignore` を書き換えず、データをコミットもしない
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`。共有の設定)を決める。`codex`(既定。Enter と `--yes` もこれ)は人が `p3 preflight` や
126
- 画面から実行し、Codex が評価する(6. と 7. が要る)。`agent` は Codex を使えない環境(Codex を準備していない・ChatGPT のプランが
127
- 無い)向けで、人がチャットで「Preflight して」と頼むと手元の AI エージェントが評価する(6. と 7. は要らない。画面イメージの描画
128
- だけ Docker を使う)。後から `p3 config set preflight.runner=agent|codex` で変えられる([使い方ガイド](how-to-use.md) の
129
- 「プロジェクトの設定」)
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
- clone したリポジトリの中で `p3 join` を実行する。個人設定に「プロジェクト名 → データのフォルダ・このリポジトリのこのマシンのパス」を
135
- 登録するだけで、データ(`project.yaml`・要望)とリポジトリのファイル(スキル・`AGENTS.md` / `CLAUDE.md`)は書かない。
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 --project myapp # リポジトリの .p3 に入れて共有しているとき(既定はルートの .p3)
141
- p3 join --project myapp --dir ~/p3-data/myapp # リポジトリの外のフォルダ(共有ドライブなど)のとき
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,165 @@ p3 --project myapp request new "通知" # どこからでも、明示
176
149
  ほかのリポジトリ(ドキュメント・基盤など)も Preflight に読ませたいときは
177
150
  [使い方ガイド](how-to-use.md#参照先と作業先) の「参照先と作業先」。
178
151
 
179
- ## 5. パスの対応を書く(DevContainer のときだけ)
152
+ 段階 0 のままでも、Preflight を通さずにタスクを作って進められる([使い方ガイド: Preflight を通さずにタスクを作る](how-to-use.md#preflight-を通さずにタスクを作る))。
180
153
 
181
- ホストで直接動かす(2. の A)なら飛ばしてよい。
154
+ ## 段階 1: Preflight を足す
155
+
156
+ **すること**: Preflight の評価のしかたを選んで準備する。**できるようになること**: 要望をタスクにする前に、リポジトリと過去の経緯を
157
+ 読んだ評価と、着手できる粒度のタスク案を受け取る。
182
158
 
183
- ### 5-1. ホストから見たパスを調べる
159
+ ### どちらで評価するか選ぶ
184
160
 
185
- DevContainer の中の `docker` はホストのデーモンに繋がっているので、中から自分のコンテナのマウントを調べられる。
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
- docker ps --format '{{.ID}} {{.Names}}' # 自分のコンテナを探す(VS Code が付けた名前・compose のサービス名など)
189
- docker inspect <コンテナの名前> --format '{{range .Mounts}}{{.Type}} {{.Source}} → {{.Destination}}{{"\n"}}{{end}}'
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
- - コンテナの名前は、ホスト名(`hostname`)と同じとは限らない。分からなければ `docker ps` の一覧から探す
196
- - **リポジトリ** と **データのフォルダ** の両方について、それを含む `Destination` を探す
197
- - `volume` は名前付きボリューム。`Source` はデーモンの中の場所で、ふつうのパスとして別のコンテナにマウントできるとは限らない。
198
- リポジトリとデータのフォルダは、`bind`(ホストのフォルダ)の下に置く
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` のプロジェクトでも、手元で評価してほしいことをはっきり頼めば同じように評価できる(同じ節)
188
+
189
+ **できたと分かる目安**: `npx @infodb/p3 drafts <要望ID>`(か画面の要望)で、評価とタスク案が読める。
199
190
 
200
- ### 5-2. 対応を書く
191
+ ### Codex で評価する
201
192
 
202
- 左がコンテナの中(P3 から見たパス)、右がホスト(Docker のデーモンから見たパス)。`Destination` ごとに1件。
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
+ | 見つけたコンテナのマウントの元が、このマシンのマウントと合わない(ネットワークを共有するコンテナ・シンボリックリンクを通した bind) | 下の「ネットワークを共有するコンテナで動かすとき」の手順で手で書く |
271
+ | 手で書いた対応と、コンテナのマウントから決めたものが違う | 手で書いた対応を直すか外す(`p3 user-config set codex.pathMap-=<このマシンのパス>`。外せば自動で決まる) |
272
+
273
+ ##### 自動で決まらないとき(手で書く)
274
+
275
+ ホストから見たパスを調べ(ホストで `docker inspect <この開発コンテナ>` の `Mounts`。`Source` がホスト、`Destination` がこのマシン)、
276
+ `Destination` ごとに1件書く。左がこのマシンのパス、右がホストのパス。
203
277
 
204
278
  ```bash
205
279
  p3 user-config set codex.pathMap+=/workspaces=/home/me/workspaces
206
- p3 user-config set codex.pathMap+=/mnt/assets=/mnt/usb/assets # データのフォルダが別のマウントにあるとき
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= で全部外す)
280
+ p3 user-config set codex.pathMap-=/workspaces # 1件外す(codex.pathMap= で全部外す)
210
281
  ```
211
282
 
212
- - 前から順に、境界(`/`)が合う最初の対応を使う。同じ左側をもう一度足すと置き換える
283
+ - 手で書いた対応は自動より先に使う(前から順に、境界(`/`)が合う最初の対応。同じ左側をもう一度足すと置き換える)。当たらない
284
+ フォルダだけ自動で決める
213
285
  - 書き間違い(`=` が無い、相対パスなど)は、何を直すかを出して何も書かない
214
- - 直したら、serve を起動し直さなくても **次の Preflight から** 効く
286
+ - 直したら、serve を起動し直さなくても **次の Preflight から** 効く。`p3 user-config paths` で結果を確かめる
287
+
288
+ ##### ネットワークを共有するコンテナで動かすとき
289
+
290
+ Compose の `network_mode: service:<別のサービス>`(`docker run --network container:<別のコンテナ>`)で、ネットワークを別のコンテナ
291
+ (共有元)と共有するコンテナの中で p3 を動かすと、パスは **自動では決まらない**。コンテナの中から見える自分のコンテナの手がかり
292
+ (`/etc/hostname` などの元・ホスト名)が共有元のものになり、自分のコンテナを確かめられないため。共有元を自分と取り違えると
293
+ 共有元のフォルダをマウントしてしまうので、p3 は見つけたコンテナのマウントの元がこのマシンのマウントと合わなければ止まる
294
+ (「マウントの元が、このマシンのマウントと合いません」)。ホストでシンボリックリンクを通して bind したフォルダも、Docker が答える
295
+ 元(リンク)とこのマシンから見える元(実体)が違うので同じく止まる。どちらも次の手順で手で書けば進む:
215
296
 
216
- ## 6. ChatGPT に接続する
297
+ 1. **ホストで** `docker inspect <p3 を動かしているコンテナ>` の `Mounts` を見る(共有元ではなく、p3 を動かしている側。Compose なら
298
+ `docker compose ps -q <p3 を動かしているサービス>` で ID が分かる)。リポジトリとデータのフォルダを含む `Type: bind` ごとに、
299
+ `Destination`(このマシンのパス)と `Source`(ホストのパス)を控える
300
+ 2. 控えたものを1件ずつ書く: `p3 user-config set codex.pathMap+=<Destination>=<Source>`
301
+ 3. `p3 user-config paths <リポジトリ> <データのフォルダ>` で、全部の対象が「codex.pathMap の対応あり」で、行き先が手順 1 の
302
+ `Source` の下になり「全部決まりました」と出るのを確かめる(決まらない対象が残れば、その対象を含む bind を足す)
303
+
304
+ - 共有元のマウントや `Source` を書き換えて合わせない(共有元のフォルダを使うことになる)。対応を書かない対象をそのまま渡すことも
305
+ しない(このマシンのパスはホストのパスとは限らない)
306
+ - 以前の版の p3 は、共有元にも同じ `Destination` があると、共有元の `Source` を自動で選んでいた。正しい対応を書くと
307
+ 「手で書いた対応と、コンテナのマウントから決めたものが違う」(conflict)で止まった。この表示が出ても対応を外さない(外すと共有元のフォルダを
308
+ 使う)。p3 を上げるか、ネットワークを共有しないコンテナ・ホストから動かす
309
+
310
+ #### 4. ChatGPT に接続する
217
311
 
218
312
  Preflight の Codex は、各自の ChatGPT アカウント(プラン)で動く。サインインは P3 が行う(Codex の初期設定は要らない)。
219
313
 
@@ -232,7 +326,7 @@ p3 chatgpt status
232
326
  読める)に置き、CLI の出力・画面・ログには出さない。個人設定(`config.yaml`)とは別のファイル
233
327
  - 解除は `p3 chatgpt logout`(ChatGPT 側の取り消しも行う)。`--forget` でこのマシンの登録ごと消す
234
328
 
235
- ## 7. Codex のイメージを作る
329
+ #### 5. Codex のイメージを作る
236
330
 
237
331
  ```bash
238
332
  p3 codex update
@@ -248,29 +342,36 @@ p3 codex update
248
342
  今すぐ作り直す(しなくても1日以内に作り直される)
249
343
  - 画面イメージの描画のイメージ(`infodb-p3-render`)は、最初に画面イメージを描くときに作る(`p3 render update` で今すぐ)
250
344
 
251
- ## 8. 画面を開いて、試しに Preflight を動かす
252
-
253
- ```bash
254
- p3 serve
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 を起動し直す
345
+ #### 6. 画面で試しに Preflight を動かす
261
346
 
262
- 概要ページの上にエンジンの状態が出る(Codex なら Docker・認証・イメージを確かめ、使えなければ理由を出して実行のボタンを止める)。
263
- ここで問題が無ければ、試しに要望を1件作って Preflight を実行する([使い方ガイド](how-to-use.md) の 1.〜2.)。
347
+ `p3 serve` で開いた画面(段階 0)の概要ページの上にエンジンの状態が出る(Codex なら Docker・認証・イメージを確かめ、使えなければ
348
+ 理由を出して実行のボタンを止める)。ここで問題が無ければ、試しに要望を1件作って Preflight を実行する([使い方ガイド](how-to-use.md) の 1.〜2.)。
264
349
 
265
350
  Preflight の実行ログの最初の方に、参照先とデータのフォルダが **コンテナの中のどこに当たったか** が出る:
266
351
 
267
352
  ```text
268
- パスの対応(個人設定の codex.pathMap):
269
- 参照先 myapp → コンテナ /workspace/myapp(codex.pathMap の対応あり)
270
- データ → コンテナ /data(codex.pathMap の対応あり)
353
+ パスの対応(Docker のホストから見たパス):
354
+ 参照先 myapp → コンテナ /workspace/myapp(自動(p3 が動いているコンテナのマウントから))
355
+ データ → コンテナ /data(自動(p3 が動いているコンテナのマウントから))
271
356
  ```
272
357
 
273
- DevContainer で「対応あり」にならなければ 5. を見直す。評価とタスク案が出れば導入は終わり。
358
+ ログには決め方だけが出る(実際のパスは共有の記録に残さない)。パスそのものは、このマシンで 3. の `p3 user-config paths` で見る。
359
+
360
+ **できたと分かる目安**: 評価とタスク案が画面(か `p3 drafts <要望ID>`)に出る。
361
+
362
+ ## 段階 2: 必要になったら足す
363
+
364
+ **すること**: 要る機能だけを足す(全部を設定しなくてよい)。**できるようになること**: プロジェクトとして守る水準を確かめる・完了した
365
+ タスクやマイルストーンを別の目で確かめる。
366
+
367
+ | 機能 | 何ができるか | 要るもの | 操作 |
368
+ | --- | --- | --- | --- |
369
+ | 品質基準 | 守る最低限の水準(lint・検証・文書など)を項目にし、タスクの受け入れ基準に取り込む | 足すものは無い(Codex の準備も要らない) | [使い方ガイド: 品質基準](how-to-use.md#品質基準) |
370
+ | タスクの AI レビュー | 完了したタスクが本文・受け入れ基準を満たしているかを、別の Codex に確かめさせる | 段階 1 の Codex の接続(Docker と ChatGPT) | [使い方ガイド: タスクの AI レビュー](how-to-use.md#タスクの-ai-レビュー) |
371
+ | マイルストーンレビュー | マイルストーンの目的に対して、できあがったものが足りているかを確かめる | 段階 1 の Codex の接続 | [使い方ガイド: マイルストーンレビュー](how-to-use.md#マイルストーンレビュー) |
372
+ | リリースノートの要約 | タスクの変更の記録から機能の要約の案を作る(手で書いて保存するだけなら要るものは無い) | 段階 1 の Codex の接続 | [使い方ガイド: リリースノート](how-to-use.md#リリースノート) |
373
+
374
+ **できたと分かる目安**: 足した機能の結果(選んだ品質基準・レビューの結果など)を、画面か CLI で読める。
274
375
 
275
376
  ## うまくいかないとき
276
377
 
@@ -278,14 +379,15 @@ DevContainer で「対応あり」にならなければ 5. を見直す。評価
278
379
 
279
380
  Preflight を使えない・失敗したとき(Docker・ChatGPT の接続・使用量の上限など、理由によらない)は、概要ページ・失敗した run・
280
381
  CLI の出力に、Preflight を通さずにタスクを作る道も出る。直すまでの間はそれで進めてよい([使い方ガイド: Preflight を通さずにタスクを作る](how-to-use.md#preflight-を通さずにタスクを作る))。Preflight を Claude Code などの手元の対話エージェントに
281
- 頼むなら Docker と ChatGPT は要らない(画面イメージの描画だけ Docker を使う。[使い方ガイド: 手元の対話エージェントで Preflight する](how-to-use.md#手元の対話エージェントで-preflight-する))。
382
+ 頼むなら Docker と ChatGPT は要らない([手元の AI エージェントで評価する](#手元の-ai-エージェントで評価する))。
282
383
 
283
384
  | どこで | 出るもの | 確かめる | 直す |
284
385
  | --- | --- | --- | --- |
285
386
  | 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 を起動する。繋ぎ先と権限(3.)を直す |
387
+ | 〃 | `Cannot connect to the Docker daemon` | `docker version` の Server、`docker context ls`、`DOCKER_HOST` | Docker を起動する。繋ぎ先と権限([段階 1 の 1.](#1-docker-に繋がるか確かめる))を直す |
287
388
  | 〃 | `permission denied ... docker.sock` | `ls -l /var/run/docker.sock` | `docker` グループなど、ソケットの権限を直す |
288
- | Preflight | `bind source path does not exist: <参照先 …>` / `<データ>` | ログの「パスの対応」、`p3 user-config` の `codex.pathMap`、5-1. の `docker inspect` | `p3 user-config set codex.pathMap+=<このマシンのパス>=<ホストのパス>`。「対応あり」なのに無いなら、右側(ホストのパス)の誤り。serve はそのままで次の Preflight から効く |
389
+ | Preflight・描画 | 「マウントするフォルダが Docker のホストのどこにあるか決められないので、コンテナを起こしません」 | 出ている理由と次にすること、`p3 user-config paths <フォルダ>` | [段階 1 の 3.](#3-パスを確かめるdevcontainer-のときだけ) の表のとおり |
390
+ | Preflight | `bind source path does not exist: <参照先 …>` / `<データ>` | ログの「パスの対応」、`p3 user-config paths <フォルダ>` | 手で書いた対応(`codex.pathMap`)の右側(ホストのパス)の誤り。直すか外す([自動で決まらないとき](#自動で決まらないとき手で書く))。serve はそのままで次の Preflight から効く |
289
391
  | Preflight | 「Codex のイメージを用意できません(app-server を起こす前)」 | `p3 codex update` の出力 | ネットワーク(プロキシ)を確かめて `p3 codex update` をやり直す。`Unable to find image` も同じ |
290
392
  | Preflight | 「〜が 60 秒で終わらないので止めました」(イメージの確認 15 秒・版の確認 60 秒・ビルド 10 分) | `docker ps -a --filter label=infodb.p3`(P3 が起こしたコンテナ) | P3 はそのコンテナを消してから終わる。Docker が重い・止まっていないかを確かめてやり直す。「コンテナ p3-… を消せませんでした(残っているかもしれません)」と出たら、出ている `docker rm -f <名前>` で消す |
291
393
  | Preflight・画面 | 「ChatGPT にサインインしてください」「ChatGPT の接続が切れています」「プランの利用が許可されていません」 | `p3 chatgpt status` | `p3 chatgpt login`(届かなければ `--paste`)。プランの利用に同意する |
@@ -293,6 +395,7 @@ CLI の出力に、Preflight を通さずにタスクを作る道も出る。直
293
395
  | Preflight・画面 | 個人設定を読めない(YAML の行と直すファイル) | `~/.config/infodb-p3/config.yaml` | 書き間違いを直す。serve はそのままで次の Preflight から効く |
294
396
  | CLI | プロジェクトが決まらない | `p3 whoami`、`p3 project` | `--project <名前>`、または `p3 project add <名前> <フォルダ>` |
295
397
  | CLI・serve | 「データのフォルダがありません」「データのフォルダに project.yaml がありません」 | `p3 project ls` の登録先、フォルダを移していないか、共有ドライブ(同期するフォルダ)がつながっているか | つながっていなければつないでやり直す。移したなら `p3 project rm <名前>` → `p3 project add <名前> <正しいフォルダ>`(rm はデータを消さない。そのあと `p3 repo path` で手元のリポジトリを登録し直す)。新しく作るなら管理したいリポジトリの中で `p3 init --project <名前>`(外に置くなら `--dir <フォルダ>`) |
398
+ | `join` | データのフォルダ・`project.yaml` が無い | リポジトリを `git pull` したか、データの場所(共有ドライブ)を聞いたか | `.p3` が届いていなければ取得する。外にあるなら `--dir <フォルダ>` で指定する |
296
399
  | 画面 | 開けない | serve のログ、ポートの転送 | 4310 を転送する。`serve.port` を変えたら転送先も変える |
297
400
 
298
401
  ## 設定の決まり
@@ -303,7 +406,7 @@ CLI の出力に、Preflight を通さずにタスクを作る道も出る。直
303
406
 
304
407
  | 個人設定 | 環境変数 | 内容 | 効くとき |
305
408
  | --- | --- | --- | --- |
306
- | `codex.pathMap` | `P3_CODEX_PATH_MAP`(`a=b,c=d`) | このマシンのパス → Docker のデーモンから見たパス | 次の Preflight |
409
+ | `codex.pathMap` | `P3_CODEX_PATH_MAP`(`a=b,c=d`) | このマシンのパス → Docker のデーモンから見たパス(自動で決まらないときだけ書く) | 次の Preflight |
307
410
  | `codex.auth` | `P3_CODEX_AUTH` | `auto`(既定。ChatGPT に接続していればそれ)/ `legacy`(下の旧来の認証) | 次の Preflight |
308
411
  | `codex.authVolume` / `codex.authFile` | `P3_CODEX_AUTH_VOLUME` / `P3_CODEX_AUTH_FILE` | 旧来の認証の `auth.json` の置き場所 | 次の Preflight |
309
412
  | `codex.model` / `codex.effort` | `P3_CODEX_MODEL` / `P3_CODEX_EFFORT` | モデル・推論の深さ(省けば Codex の既定) | 次の Preflight |
@@ -322,12 +425,12 @@ P3 をイメージにして、コンテナで動かすこともできる。イ
322
425
  要望・タスクの作成と編集・添付・Preflight もいつもどおり使える。
323
426
 
324
427
  イメージは Docker Hub の **`tamuto/p3`**。中に p3 本体(npm の `@infodb/p3` と同じ版・同じ中身)と、Node 26・git・Docker の CLI が
325
- 入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.12.0` など)と
428
+ 入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.14.0` など)と
326
429
  `latest` がある。決まった版で使うなら版のタグを指す。対応する platform は `linux/amd64` だけ(arm64 は確かめるマシンが無いので
327
430
  作っていない)。
328
431
 
329
432
  ```bash
330
- docker pull tamuto/p3:0.12.0
433
+ docker pull tamuto/p3:0.14.0
331
434
  ```
332
435
 
333
436
  リポジトリから作るときは `docker build --pull -t tamuto/p3:dev .`(`--pull` で今の Node のベースを取る。[開発ガイド](development.md#docker-のイメージ))。
@@ -341,27 +444,27 @@ pull して起動し直す。
341
444
  ### 開発コンテナのサイドカーとして動かす
342
445
 
343
446
  root で動く開発コンテナ(DevContainer など)で p3 の CLI を使っているなら、その横に p3 のコンテナを置き、**開発コンテナと同じ
344
- マウント**を付ける。個人設定(登録・`codex.pathMap`)と ChatGPT の接続を開発コンテナと共有するので、コンテナの中で登録し直す・
447
+ マウント**を付ける。個人設定(登録など)と ChatGPT の接続を開発コンテナと共有するので、コンテナの中で登録し直す・
345
448
  接続し直す必要はない。登録・接続・テーマの変更は、開発コンテナの中の CLI でいつもどおり行い、画面の「一覧を読み直す」で反映する。
346
449
 
347
450
  ```yaml
348
451
  # 開発コンテナの compose に足す例(パスは開発コンテナのマウントに合わせる)
349
452
  services:
350
453
  p3:
351
- image: tamuto/p3:0.12.0
454
+ image: tamuto/p3:0.14.0
352
455
  restart: unless-stopped
353
456
  ports:
354
457
  - "127.0.0.1:4310:4310"
355
458
  environment:
356
459
  - TZ=Asia/Tokyo
357
460
  volumes:
358
- - /root/workspaces:/workspaces # 開発コンテナと同じ(リポジトリ・データ)
359
- - ./denv/.config:/root/.config # 開発コンテナと同じ ~/.config(個人設定・ChatGPT の接続)
360
- - /mnt/usb/assets:/mnt/assets # データを別の場所に置いているなら、それも同じに
461
+ - /home/me/workspaces:/workspaces # 開発コンテナと同じ(リポジトリ・データ)
462
+ - ./.devcontainer/.config:/root/.config # 開発コンテナと同じ ~/.config(個人設定・ChatGPT の接続)
463
+ - /home/me/p3-data:/p3-data # データを別の場所に置いているなら、それも同じに
361
464
  - /var/run/docker.sock:/var/run/docker.sock # Preflight(Codex)と画面イメージの描画
362
465
  ```
363
466
 
364
- - 開発コンテナと同じパスで見えるので、開発コンテナ用に書いた `codex.pathMap`(コンテナの中のパス → ホストのパス)がそのまま効く
467
+ - p3 のコンテナも、自分のマウントからホストのパスを自動で決める(開発コンテナで手で書いた `codex.pathMap` があれば、同じパスで見えるのでそのまま効く)
365
468
  - 個人設定は開発コンテナと p3 のコンテナの両方から書かれることがあるが、書くときはファイルのロックで順に行う
366
469
 
367
470
  ### 単独で動かす
@@ -372,20 +475,20 @@ docker run -d --name p3 --restart unless-stopped \
372
475
  -v ~/.config/infodb-p3:/root/.config/infodb-p3 \
373
476
  -v /home/me/work:/home/me/work \
374
477
  -v /var/run/docker.sock:/var/run/docker.sock \
375
- tamuto/p3:0.12.0
478
+ tamuto/p3:0.14.0
376
479
 
377
480
  # 登録が無ければ、コンテナの中で登録する(既にあるデータに参加する。新しく作るなら p3 init)
378
481
  docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
379
482
  ```
380
483
 
381
- - データと参照先はホストと **同じパスで** マウントする(Codex・描画のコンテナはホストのデーモンが作るので、パスが同じなら
382
- `codex.pathMap` は要らない)。ホストの個人設定を使うなら、その登録のパスとマウントのパスをそろえる
484
+ - データと参照先はホストと **同じパスで** マウントするのが分かりやすい(違うパスでも、p3 が自分のマウントからホストのパスを自動で
485
+ 決める)。ホストの個人設定を使うなら、その登録のパスとマウントのパスをそろえる
383
486
  - root で動くので、コンテナが作るファイル(要望・タスクなど)の持ち主は root になる
384
487
 
385
488
  ### どちらでも
386
489
 
387
490
  - 待ち受けは `127.0.0.1` に公開する。ブラウザで http://localhost:4310 を開く。登録が1つならそのプロジェクトが開き、複数なら一覧から選ぶ
388
- - **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.12.0 serve --project myapp --host 0.0.0.0`。compose なら
491
+ - **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.14.0 serve --project myapp --host 0.0.0.0`。compose なら
389
492
  `command:`)。明示しない限り、コンテナの中かどうかで自動では切り替えない
390
493
  - **止める**: `docker stop p3`(SIGTERM。実行中の Preflight・生成を取り消して記録してから止まる。10 秒まで待つ)
391
494
  - **新しい版にする**: 版のタグを変えて作り直す(個人設定と接続はマウントした ~/.config、データはホストに残る)。
@@ -413,15 +516,26 @@ docker exec p3 p3 codex update # Codex のイメージを作る(ホスト
413
516
  ```
414
517
 
415
518
  - ソケットを渡すと、コンテナの中から **ホストの Docker を何でも操作できる**(ホストの管理者と同じ強さ)。信頼できるマシンでだけ渡す
416
- - Codex・描画のコンテナはホストのデーモンが作り、データのフォルダと参照先を **ホストのパスで** マウントする。上のように同じパスで
417
- マウントしていれば対応は要らない。違うパスでマウントしたときは、コンテナの中のパスとホストのパスの対応を
418
- `docker exec p3 p3 user-config set codex.pathMap+=<コンテナの中のパス>=<ホストのパス>` で全部のプロジェクトの分を足す(5.)
519
+ - Codex・描画のコンテナはホストのデーモンが作り、データのフォルダと参照先を **ホストのパスで** マウントする。p3 のコンテナの
520
+ マウント(bind)から自動で決まる。名前付きボリュームの下に置いたフォルダは決まらないので、ホストのフォルダを bind する。
521
+ 決まるかは `docker exec p3 p3 user-config paths <コンテナの中のパス>` で確かめる([段階 1 の 3.](#3-パスを確かめるdevcontainer-のときだけ))
419
522
  - ChatGPT の接続はマウントした ~/.config に残るので、コンテナを作り直しても接続し直さなくてよい
420
523
  - ソケットを渡していない・繋がらないときも、要望・タスクの作成と編集・プロジェクトの選択は使える。Preflight は
421
524
  使えない理由と直し方を出して止まる(Mock には落とさない)。その間は Preflight を通さずにタスクを作ってよい
422
525
  ([使い方ガイド](how-to-use.md#preflight-を通さずにタスクを作る))
423
526
  - P3 を作り直してイメージの中身(入れる道具)が変わったら `docker exec p3 p3 codex update`
424
527
 
528
+ ## 補足: Node.js の版と、同じ版で動かすこと
529
+
530
+ - P3 そのものを開発するときと、Docker のイメージ(`tamuto/p3`・描画のイメージ)は Node 26 を使う([開発ガイド](development.md))。
531
+ 使うだけなら 24 以上でよい
532
+ - **Node 22 から上げるとき**: Node 22 はサポートの終わり(2027-04-30)が近いので、この版から P3 は Node 24 以上で動かす(`engines` は
533
+ `>=24`)。Node 22 のままでも止められるとは限らない: npm は入れるときに警告(`EBADENGINE`)を出して入れ、`engine-strict=true`
534
+ なら断る。pnpm(12.10 で確かめた)と `pnpx` は警告を出さずに入れて動かす。`node -v` を確かめ、24 以上(推奨 26)に上げてから入れ直す。Docker で動かしているなら、新しいイメージを `docker pull` してコンテナを作り直す
535
+ (起動し直すだけでは前のイメージの Node のまま)
536
+ - 同じデータを使う人と AI は、なるべく同じ版で動かす(`npx @infodb/p3@<版>` / `pnpx @infodb/p3@<版>` のように版を付けられる。
537
+ `npx`・`pnpx` は取った版をしばらく使い続ける)。古い版で更新すると、新しい版で足した項目が消えることがある([データの形](architecture.md#データの形))
538
+
425
539
  ## 補足: 旧来の認証と Mock
426
540
 
427
541
  ふだんは使わない。