@infodb/p3 0.3.0 → 0.5.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 (209) hide show
  1. package/bin/p3.mjs +11 -5
  2. package/dist/web/assets/Outputs-C83ZDXvs.js +1 -0
  3. package/dist/web/assets/RequestStatus-GmiWYEcL.js +1 -0
  4. package/dist/web/assets/Tabs-CJn0Qy7W.js +1 -0
  5. package/dist/web/assets/TagInput-CtM8HM8Z.js +1 -0
  6. package/dist/web/assets/TaskDrawer-D5v36QoF.js +3 -0
  7. package/dist/web/assets/_requestId-BHUqLO-j.js +1 -0
  8. package/dist/web/assets/_requestId-DxwxbXY2.js +30 -0
  9. package/dist/web/assets/{ui-Sz7y5_TS.js → appCtx-B-VRVOyv.js} +1 -1
  10. package/dist/web/assets/board-DAaVR04x.js +1 -0
  11. package/dist/web/assets/copy-CKsXEjMi.js +1 -0
  12. package/dist/web/assets/done-CaqB_qTH.js +1 -0
  13. package/dist/web/assets/index-BF1xMdJo.css +2 -0
  14. package/dist/web/assets/index-BQYvKpjF.js +12 -0
  15. package/dist/web/assets/milestoneOrder-N7b5XFJP.js +1 -0
  16. package/dist/web/assets/new-DLVnRvrB.js +1 -0
  17. package/dist/web/assets/preflightInput-BAeEJYUK.js +2 -0
  18. package/dist/web/assets/preload-helper-B74h5i3O.js +1 -0
  19. package/dist/web/assets/progressTree-wp9mH4VF.js +1 -0
  20. package/dist/web/assets/release-notes-MTLcOcvZ.js +3 -0
  21. package/dist/web/assets/requestData-D-HXu-cy.js +1 -0
  22. package/dist/web/assets/routes-CI4Qfkjs.js +3 -0
  23. package/dist/web/assets/settings-CJMNgzi6.js +1 -0
  24. package/dist/web/index.html +4 -4
  25. package/docs/architecture.md +238 -9
  26. package/docs/development.md +16 -9
  27. package/docs/how-to-use.md +128 -12
  28. package/docs/installation.md +8 -6
  29. package/docs/publishing.md +4 -2
  30. package/lib/cli/args.js +172 -0
  31. package/lib/cli/chatgpt.js +70 -0
  32. package/lib/cli/codex.js +30 -0
  33. package/lib/cli/format.js +9 -0
  34. package/{src/cli/help.ts → lib/cli/help.js} +11 -8
  35. package/lib/cli/main.js +326 -0
  36. package/lib/cli/output.js +110 -0
  37. package/lib/cli/preflightCommands.js +301 -0
  38. package/lib/cli/project.js +649 -0
  39. package/lib/cli/readOnly.js +36 -0
  40. package/lib/cli/releaseNotesCommands.js +197 -0
  41. package/lib/cli/render.js +58 -0
  42. package/lib/cli/requestCommands.js +180 -0
  43. package/lib/cli/showView.js +100 -0
  44. package/lib/cli/taskCommands.js +152 -0
  45. package/lib/cli/userConfig.js +64 -0
  46. package/{src/core/chatgpt.ts → lib/core/chatgpt.js} +10 -16
  47. package/lib/core/context.js +41 -0
  48. package/lib/core/hierarchy.js +128 -0
  49. package/lib/core/machineSettings.js +146 -0
  50. package/lib/core/machineSettingsEdit.js +148 -0
  51. package/lib/core/ops.js +120 -0
  52. package/lib/core/preflight/carryover.js +105 -0
  53. package/lib/core/preflight/codexEngine.js +687 -0
  54. package/lib/core/preflight/codexImage.js +61 -0
  55. package/lib/core/preflight/diagnose.js +95 -0
  56. package/lib/core/preflight/engine.js +58 -0
  57. package/lib/core/preflight/input.js +83 -0
  58. package/lib/core/preflight/launch.js +68 -0
  59. package/lib/core/preflight/mockEngine.js +175 -0
  60. package/lib/core/preflight/render.js +304 -0
  61. package/lib/core/preflight/service.js +868 -0
  62. package/lib/core/preflight/split.js +83 -0
  63. package/lib/core/preflight/uiMaterials.js +281 -0
  64. package/lib/core/preflight/uiRender.js +89 -0
  65. package/lib/core/preflight/wireframe.js +63 -0
  66. package/lib/core/preflight/xlsx.js +324 -0
  67. package/lib/core/projectRegistry.js +207 -0
  68. package/lib/core/redact.js +28 -0
  69. package/lib/core/releaseNotes/completeRequests.js +106 -0
  70. package/lib/core/releaseNotes/generate.js +266 -0
  71. package/lib/core/releaseNotes/material.js +141 -0
  72. package/lib/core/releaseNotes/mockSummarizer.js +26 -0
  73. package/lib/core/releaseNotes/service.js +83 -0
  74. package/lib/core/releaseNotes/store.js +209 -0
  75. package/lib/core/repoAdmin.js +82 -0
  76. package/lib/core/repoRefs.js +72 -0
  77. package/lib/core/requestOps.js +154 -0
  78. package/lib/core/requestStatus.js +171 -0
  79. package/lib/core/store/attachments.js +242 -0
  80. package/lib/core/store/collection.js +254 -0
  81. package/lib/core/store/frontmatter.js +18 -0
  82. package/lib/core/store/fsutil.js +84 -0
  83. package/lib/core/store/locate.js +162 -0
  84. package/lib/core/store/normalize.js +150 -0
  85. package/lib/core/store/noteStore.js +59 -0
  86. package/lib/core/store/preflightStore.js +161 -0
  87. package/lib/core/store/projectFile.js +99 -0
  88. package/lib/core/store/workspace.js +320 -0
  89. package/lib/core/supersede.js +69 -0
  90. package/lib/core/userConfig.js +158 -0
  91. package/{src/core/userTheme.ts → lib/core/userTheme.js} +11 -13
  92. package/lib/core/workTargets.js +106 -0
  93. package/lib/server/api/chatgptRoutes.js +46 -0
  94. package/{src/server/api/local.ts → lib/server/api/local.js} +23 -22
  95. package/lib/server/api/manifest.js +140 -0
  96. package/lib/server/api/projectsRoutes.js +82 -0
  97. package/lib/server/api/releaseNoteRoutes.js +88 -0
  98. package/lib/server/api/repoRoutes.js +67 -0
  99. package/lib/server/api/routes.js +404 -0
  100. package/lib/server/api/userThemeRoutes.js +60 -0
  101. package/lib/server/server.js +85 -0
  102. package/lib/shared/dates.js +10 -0
  103. package/{src/shared/directTask.ts → lib/shared/directTask.js} +3 -11
  104. package/lib/shared/hierarchy.js +120 -0
  105. package/lib/shared/milestoneOrder.js +45 -0
  106. package/lib/shared/preflightInput.js +19 -0
  107. package/lib/shared/refs.js +44 -0
  108. package/lib/shared/repos.js +69 -0
  109. package/lib/shared/scopeView.js +39 -0
  110. package/{src/shared/tags.ts → lib/shared/tags.js} +9 -14
  111. package/lib/shared/types.js +74 -0
  112. package/lib/shared/workTarget.js +31 -0
  113. package/package.json +4 -7
  114. package/skills/p3/SKILL.md +29 -8
  115. package/dist/web/assets/Outputs-DqJdybkd.js +0 -1
  116. package/dist/web/assets/RequestStatus-DN-2iAM0.js +0 -1
  117. package/dist/web/assets/TagInput-D-1ILLDX.js +0 -1
  118. package/dist/web/assets/TaskDrawer-CHD7T-Su.js +0 -3
  119. package/dist/web/assets/_requestId-BzSepQIV.js +0 -30
  120. package/dist/web/assets/_requestId-pIds2tFU.js +0 -1
  121. package/dist/web/assets/board-BIkOpuC4.js +0 -1
  122. package/dist/web/assets/copy-B1ZbihKL.js +0 -2
  123. package/dist/web/assets/done-BUAUhIRr.js +0 -1
  124. package/dist/web/assets/index-Byv9j77D.js +0 -12
  125. package/dist/web/assets/index-DTfUhuQw.css +0 -2
  126. package/dist/web/assets/new-6kly4-PX.js +0 -1
  127. package/dist/web/assets/preload-helper-DlN0ouRj.js +0 -1
  128. package/dist/web/assets/release-notes-iwQWmfX6.js +0 -3
  129. package/dist/web/assets/requestData-DJ1Rlx-u.js +0 -1
  130. package/dist/web/assets/routes-Ciot9p4x.js +0 -2
  131. package/dist/web/assets/settings-DBCi6lAY.js +0 -1
  132. package/src/cli/args.ts +0 -186
  133. package/src/cli/chatgpt.ts +0 -74
  134. package/src/cli/codex.ts +0 -28
  135. package/src/cli/format.ts +0 -9
  136. package/src/cli/main.ts +0 -336
  137. package/src/cli/output.ts +0 -117
  138. package/src/cli/preflightCommands.ts +0 -245
  139. package/src/cli/project.ts +0 -672
  140. package/src/cli/readOnly.ts +0 -36
  141. package/src/cli/releaseNotesCommands.ts +0 -159
  142. package/src/cli/render.ts +0 -60
  143. package/src/cli/requestCommands.ts +0 -170
  144. package/src/cli/showView.ts +0 -110
  145. package/src/cli/taskCommands.ts +0 -167
  146. package/src/cli/userConfig.ts +0 -58
  147. package/src/core/context.ts +0 -58
  148. package/src/core/machineSettings.ts +0 -207
  149. package/src/core/machineSettingsEdit.ts +0 -156
  150. package/src/core/ops.ts +0 -114
  151. package/src/core/preflight/carryover.ts +0 -133
  152. package/src/core/preflight/codexEngine.ts +0 -703
  153. package/src/core/preflight/codexImage.ts +0 -98
  154. package/src/core/preflight/diagnose.ts +0 -124
  155. package/src/core/preflight/engine.ts +0 -92
  156. package/src/core/preflight/input.ts +0 -65
  157. package/src/core/preflight/launch.ts +0 -86
  158. package/src/core/preflight/mockEngine.ts +0 -145
  159. package/src/core/preflight/render.ts +0 -339
  160. package/src/core/preflight/service.ts +0 -707
  161. package/src/core/preflight/uiMaterials.ts +0 -272
  162. package/src/core/preflight/uiRender.ts +0 -84
  163. package/src/core/preflight/wireframe.ts +0 -69
  164. package/src/core/preflight/xlsx.ts +0 -328
  165. package/src/core/projectRegistry.ts +0 -264
  166. package/src/core/redact.ts +0 -31
  167. package/src/core/releaseNotes/generate.ts +0 -283
  168. package/src/core/releaseNotes/material.ts +0 -114
  169. package/src/core/releaseNotes/mockSummarizer.ts +0 -28
  170. package/src/core/releaseNotes/service.ts +0 -106
  171. package/src/core/releaseNotes/store.ts +0 -216
  172. package/src/core/repoAdmin.ts +0 -81
  173. package/src/core/repoRefs.ts +0 -90
  174. package/src/core/requestOps.ts +0 -140
  175. package/src/core/requestStatus.ts +0 -58
  176. package/src/core/store/attachments.ts +0 -228
  177. package/src/core/store/collection.ts +0 -282
  178. package/src/core/store/frontmatter.ts +0 -22
  179. package/src/core/store/fsutil.ts +0 -90
  180. package/src/core/store/locate.ts +0 -181
  181. package/src/core/store/normalize.ts +0 -155
  182. package/src/core/store/noteStore.ts +0 -56
  183. package/src/core/store/preflightStore.ts +0 -136
  184. package/src/core/store/projectFile.ts +0 -101
  185. package/src/core/store/workspace.ts +0 -328
  186. package/src/core/supersede.ts +0 -74
  187. package/src/core/userConfig.ts +0 -205
  188. package/src/core/workTargets.ts +0 -120
  189. package/src/server/api/chatgptRoutes.ts +0 -49
  190. package/src/server/api/manifest.ts +0 -128
  191. package/src/server/api/projectsRoutes.ts +0 -89
  192. package/src/server/api/releaseNoteRoutes.ts +0 -78
  193. package/src/server/api/repoRoutes.ts +0 -67
  194. package/src/server/api/routes.ts +0 -382
  195. package/src/server/api/userThemeRoutes.ts +0 -62
  196. package/src/server/server.ts +0 -108
  197. package/src/shared/dates.ts +0 -12
  198. package/src/shared/preflightInput.ts +0 -27
  199. package/src/shared/refs.ts +0 -55
  200. package/src/shared/repos.ts +0 -113
  201. package/src/shared/scopeView.ts +0 -48
  202. package/src/shared/types.ts +0 -700
  203. package/src/shared/workTarget.ts +0 -44
  204. /package/{src → lib}/core/preflight/launcher.mjs +0 -0
  205. /package/{src → lib}/core/preflight/mock-ui.html +0 -0
  206. /package/{src → lib}/core/preflight/mock-ui.png +0 -0
  207. /package/{src → lib}/core/preflight/render-image/Dockerfile +0 -0
  208. /package/{src → lib}/core/preflight/render-image/fonts-ja.conf +0 -0
  209. /package/{src → lib}/core/preflight/render-image/render.mjs +0 -0
@@ -176,7 +176,7 @@ src/ 依存の向き: shared ← core ← server / cli、web →
176
176
  routes/ ページ(1ファイル1ページ。__root.tsx が共通の枠)
177
177
  routeTree.gen.ts ルート一覧(自動生成)
178
178
  components/ 部品(複数のページで使うもの。大きいページの部品は components/<ページ>/)
179
- bin/p3.mjs CLI の起動口(tsx でソースをそのまま動かす)
179
+ bin/p3.mjs CLI の起動口(チェックアウトでは tsx でソースを、配布物ではビルドした lib/ を動かす)
180
180
  skills/p3/SKILL.md AI 向けスキルの原本(p3 init --agents / p3 agents で各プロジェクトの .claude/skills・.agents/skills の選んだ先に写す)
181
181
  scripts/ デモデータ・配布物の確認・使い方の動画(video/)
182
182
  docs/ 導入・使い方・開発・設計・公開の文書
@@ -192,17 +192,19 @@ test/ ユニットテスト
192
192
 
193
193
  ## npm で配る中身
194
194
 
195
- `@infodb/p3` として npm に公開する(公開そのものは人が行う。手順は [docs/publishing.md](publishing.md))。TypeScript のソースを
196
- `tsx` でそのまま動かし、画面だけをビルドして同梱する。
195
+ `@infodb/p3` として npm に公開する(公開そのものは人が行う。手順は [docs/publishing.md](publishing.md))。画面と CLI・serve を
196
+ ビルドして同梱し、利用者の環境では TypeScript を変換しない(`tsx` とそれが使う esbuild を入れないので、pnpm がビルドのスクリプトの
197
+ 許可を聞かない)。このリポジトリの開発(`pnpm p3`・テスト)は、今までどおりソースを `tsx` でそのまま動かす。
197
198
 
198
199
  | 何を | どうする |
199
200
  | --- | --- |
200
- | 同梱するもの(`files`) | `bin/`・`src/cli`・`src/core`・`src/server`・`src/shared`(実行するソース。描画のイメージの資材 `src/core/preflight/render-image/` を含む)、`dist/web`(ビルド済みの画面)、`skills/`(AI 向けスキルの原本)、`docs/`(README から辿る文書)、README・LICENSE |
201
- | 同梱しないもの | `.env`・個人設定・デモデータ(`.p3-demo/`)・テスト・`scripts/`・画面のソース(`src/web`)・開発用のスキル(`.claude/`) |
202
- | 実行時の依存 | `tsx`・`hono`・`@hono/node-server`・`yaml`・`zod`・`@infodb/codex-workspace`・`@infodb/chatgpt-plan`。React などの画面の部品はビルドに使うだけなので開発用 |
201
+ | 同梱するもの(`files`) | `bin/`、`lib/`(ビルド済みの CLI・serve。描画のイメージの資材 `lib/core/preflight/render-image/` などの .ts 以外の資材を含む)、`dist/web`(ビルド済みの画面)、`skills/`(AI 向けスキルの原本)、`docs/`(README から辿る文書)、README・LICENSE |
202
+ | 同梱しないもの | `.env`・個人設定・デモデータ(`.p3-demo/`)・テスト・`scripts/`・TypeScript のソース(`src/`)・開発用のスキル(`.claude/`) |
203
+ | 実行時の依存 | `hono`・`@hono/node-server`・`yaml`・`zod`・`@infodb/codex-workspace`・`@infodb/chatgpt-plan`。`tsx`(esbuild)と React などの画面の部品は開発用 |
204
+ | CLI・serve のビルド | `scripts/build-cli.mjs`(`pnpm build` の後半)。`tsc -p tsconfig.build.json` で `src/{cli,core,server,shared}` を同じ深さの `lib/` に 1:1 で出し(相対の import の `.ts` は `.js` に書き換わる)、.ts 以外の資材を同じ場所に写す。`src/` と同じ深さなので、`import.meta.url` からの相対の参照(`../../skills`・`dist/web`・`./mock-ui.html` など)はそのまま効く。資材を足すときは、その層のフォルダに置けば写る。`lib/` は git で追跡しない |
203
205
  | Node | `>=22`(`@infodb/codex-workspace` と同じ)。開発(Vite 8)は Node 24 |
204
206
  | 公開前のビルド | `prepack` で `pnpm build`。利用者が入れるときにはビルドも Docker の操作もしない |
205
- | bin | `p3`。起動口は今いる場所の `tsconfig.json` を読まない。`INIT_CWD` に戻るのは P3 自身の `pnpm p3` スクリプトのときだけ |
207
+ | bin | `p3`(`bin/p3.mjs`)。`src/cli/main.ts` があるチェックアウトでは tsx でソースを、無ければ(配布物)`lib/cli/main.js` を動かす。ソースを動かすときは今いる場所の `tsconfig.json` を読まない。`INIT_CWD` に戻るのは P3 自身の `pnpm p3` スクリプトのときだけ |
206
208
 
207
209
  ```bash
208
210
  pnpm -s check # 型検査・lint・テスト・画面のビルド・UI テスト
@@ -216,11 +218,16 @@ P3_CODEX_PATH_MAP=/workspaces=/home/me/workspaces pnpm verify:pack --docker --re
216
218
  `Dockerfile`(Docker Hub の `tamuto/p3`。ビルドは Node 24 と packageManager の pnpm でロックファイルどおりに入れ、`pnpm pack` と同じ中身に実行時の依存だけを
217
219
  入れる。実行は Node 22・git・Docker の CLI と buildx。既定は `serve --all-projects --host 0.0.0.0`)と `.dockerignore`
218
220
  (git・依存・ビルドの出力・データ・個人設定・認証・テストを入れない)。約束は `test/docker.test.ts` が確かめる。
221
+ ベースの Node はメジャー版(`node:24-bookworm-slim` / `node:22-bookworm-slim`)だけを指定し、同じメジャーの中の更新(セキュリティ
222
+ リリースなど)は作り直すと入るようにしている。ただし Docker は手元にあるベースをそのまま使う(キャッシュ)ので、作るときは
223
+ `--pull` を付けて今のベースを取る(`scripts/verify-docker.mjs` も付ける。`--no-build` は作らずに既にあるイメージを確かめる)。
224
+ Docker の CLI と pnpm は版を固定し、メジャー版を上げるのは別の変更として行う。作り直しても、公開済みのイメージと起動中の
225
+ コンテナは変わらない(push し、使う側が pull して起動し直す)。
219
226
  公開(人が行う)は [publishing.md](publishing.md#6-docker-hubtamutop3) の手順で、CI は使わない。使い方は [導入ガイド](installation.md#docker-で動かすプロジェクトを跨ぐ-serve)。
220
227
 
221
228
  ```bash
222
- docker build -t tamuto/p3:dev .
223
- node scripts/verify-docker.mjs # ビルドして、使い捨ての2つのプロジェクトで動かす(スモーク)
229
+ docker build --pull -t tamuto/p3:dev .
230
+ node scripts/verify-docker.mjs # ビルド(--pull)して、使い捨ての2つのプロジェクトで動かす(スモーク)
224
231
  # DevContainer の中では、Docker のホストから見えるフォルダと、そのホストのパスを渡す。公開したポートはホストにしか開かないので、
225
232
  # このコンテナのネットワークに入れる
226
233
  P3_CODEX_PATH_MAP=/workspaces=/home/me/workspaces node scripts/verify-docker.mjs --work /workspaces/tmp --network-of auto
@@ -115,6 +115,7 @@ p3 accept k7m3x --skip D3 # D3 以外をタスクにする(--only D1,
115
115
  P3 は名前を決めるだけで、git のブランチや作業ツリーは作業する人・AI が作る。名前は `p3 request show k7m3x --brief` で見る
116
116
  - 再評価で古いタスクを置き換える案があれば、置き換えられるタスクが出る。アーカイブするかは選べる(既定は残す。
117
117
  `--archive-superseded` か画面のチェック)
118
+ - 大きい要望は、タスク案ではなく **子の要望の案**(C1, C2, ...)が出ることがある([親と子の要望](#親と子の要望)の「分割の案」)
118
119
 
119
120
  ### 6. 作業する(主に AI)
120
121
 
@@ -126,10 +127,26 @@ git switch -c req/261009-k7m3x-notify # request show で見た実際の
126
127
  export P3_ACTOR=ai:claude # 変更者の記録(AI は ai:<名前>)
127
128
  p3 show T001 --brief --json # 本文・依存とその状態・作業先とブランチ・置き換えの注意
128
129
  p3 move T001 doing # 着手
129
- # ... 作業し、テストを通し、コミットして push する ...
130
- p3 move T001 done --output https://github.com/me/myapp/pull/42 --record - < record.md
130
+ # ... 作業し、テストを通す ...
131
+ p3 move T001 done --output "src/notify.ts(送信)" --record - < record.md # コミットする前に完了にする
132
+ p3 request set k7m3x status=resolved # 最後のタスクなら、これもコミットの前に(7.)
133
+ git add src/notify.ts .p3/requests/261009-k7m3x # データを git で管理していれば、要望のフォルダも同じコミットに
134
+ git commit -m "通知の送信" && git push
135
+ p3 move T001 done --output https://github.com/me/myapp/commit/<sha> # URL は後から足す(完了・記録はそのまま)
136
+ git add .p3/requests/261009-k7m3x && git commit -m "成果物の URL" && git push
131
137
  ```
132
138
 
139
+ - **完了を記録してからコミットする**: テストを通したら、コミットの前に完了(と最後なら対応済)を保存する。データのフォルダが
140
+ リポジトリの中にあって git で管理していれば、要望とタスク・変更の記録が実装と同じコミットに入り、PR / MR を見る人は
141
+ 「何を頼まれ、何をしたか」をコードと一緒に読める。入れるのはその要望のフォルダだけ(ほかの要望の変更は入れない)
142
+ - 成果物は、完了にする時点で今あるもの(変えたファイル・ドキュメントのパス・短い説明)。まだ無い URL や仮の SHA は書かない。
143
+ コミット・PR / MR の URL は push してから `move … done --output <URL>` で足す(完了・記録・前の成果物・完了の日時は変わらず、
144
+ 要望も進行中に戻らない)。この追記は次のコミットに入れる(追記のコミット自身の URL は要らない)
145
+ - データのフォルダがリポジトリの外・別のリポジトリ・git で無視されているときは、同じコミットには入らない。git の作業ツリー
146
+ (worktree)で作業していても、データは登録したフォルダ(既定はメインの作業ツリーの `.p3`)に書かれ、その作業ツリーのコミットには
147
+ 入らない。どちらもデータを移したり写したり `git add -f` したりせず、コードとは成果物の URL で結ぶ
148
+ - push に失敗しても、完了の記録はそのまま。公開できていないだけなので、直して push し直す
149
+
133
150
  - 依存の相手が終わっていないタスクや、置き換えられたタスク(`※置換`)からは始めない
134
151
  - **変更の記録**(`--record`)は、何を変えたか・なぜ・入れた決まり・やめたものを Markdown で短く書く。AI が完了にするときは必須。
135
152
  後の Preflight が経緯を調べるとき、タスクの解析・リリースノートの材料になる
@@ -137,7 +154,8 @@ p3 move T001 done --output https://github.com/me/myapp/pull/42 --record - < reco
137
154
 
138
155
  ### 7. 要望を対応済にする
139
156
 
140
- 全タスクを完了にしたら、作業した側が要望を **対応済** にする(人に確認を頼む印)。
157
+ 全タスクを完了にしたら、作業した側が要望を **対応済** にする(人に確認を頼む印)。最後のタスクのコミットの前にしておけば、
158
+ 対応済も同じコミットに入る(6.)。
141
159
 
142
160
  ```bash
143
161
  p3 request set k7m3x status=resolved
@@ -206,7 +224,7 @@ p3 request set k7m3x status=done # 要望を完了済にする(
206
224
  | `instructions`(`preflight.instructions`) | プロジェクト固有の評価の観点・制約。Codex への指示に加わる |
207
225
  | `branchPattern` | 要望のブランチ名(既定 `req/{id}-{slug}`。作業先のリポジトリごとに同じ名前で割り当てる) |
208
226
 
209
- マイルストーンは `p3 milestone add|set|rm`、参照先は下の「参照先と作業先」。
227
+ マイルストーンは `p3 milestone add|set|rm` か画面のリリースノートの「マイルストーン」タブ(下の「リリースノートの画面」)、参照先は下の「参照先と作業先」。
210
228
 
211
229
  ### 参照先と作業先
212
230
 
@@ -318,6 +336,8 @@ Preflight は始めたときの内容を固定して評価する。**評価の
318
336
 
319
337
  - 対応済にできるのは、タスクが1件以上あり全部が完了のときだけ(人の「済み」や PR のマージは条件にしない)
320
338
  - 対応済の要望にタスクを足した・完了から戻した・再評価をタスク化したときは、進行中に戻る
339
+ - 子のある要望は、自分のタスクと、見送り以外の子(その下も)が全部終わっているときだけ対応済・完了済にできる。自分のタスクが
340
+ 無く子だけでもよい(見送りの子は対象外)。子に未完了ができると対応済の親は進行中に戻り、完了済の親は変わらず警告が出る([親と子の要望](#親と子の要望))
321
341
  - Preflight で状態が動くのはタスク化の前の要望だけ。進行中・完了の要望を再評価しても状態は変わらない
322
342
 
323
343
  ### タスクの関係と置き換え
@@ -335,7 +355,8 @@ Preflight は始めたときの内容を固定して評価する。**評価の
335
355
 
336
356
  ### 成果物と変更の記録
337
357
 
338
- - **成果物**(`outputs`): 1項目ずつ、PR / MR の URL・文章・ドキュメントのパスのどれでもよい。項目全体が `http(s)://` の URL なら
358
+ - **成果物**(`outputs`): 1項目ずつ、PR / MR の URL・文章・ドキュメントのパスのどれでもよい。完了にするときは今あるもの
359
+ (変えたファイルや説明)を書き、URL は push してから `move <T> done --output <URL>` で足す(完了のまま追記する)。項目全体が `http(s)://` の URL なら
339
360
  画面でリンクになる(文章の中の URL は拾わない)。足すのは `move <T> done --output 値`(繰り返し可。カンマで分けない)か画面の
340
361
  「成果物を編集」。`set <T> outputs=a,b` はカンマで分けて置き換える
341
362
  - **リポジトリごとの成果物**(`repoOutputs`): `--repo-output <参照先>=<URL>`。複数のリポジトリにまたがるときに最後のタスクに残す
@@ -347,6 +368,13 @@ Preflight は始めたときの内容を固定して評価する。**評価の
347
368
  - **期限**(`due`): 要望の期限(`--due YYYY-MM-DD`)。進捗のスケジュールに ⚑ で出る
348
369
  - **マイルストーン**: まとめてリリースする単位(`p3 milestone add v0.2 --title "通知まわり" --due 2026-11-30`、要望に `--milestone v0.2`)。
349
370
  リリースノートはマイルストーンごとに作る([リリースノート](#リリースノート))
371
+ - **並び**: 選ぶ欄(新しい要望・要望の概要)・進捗のまとまり・リリースノートの一覧・マイルストーンのタブ・`p3 milestone` / `progress` / `config` の
372
+ 一覧は、**ID のバージョンの降順**(新しいものが上)。比べるのは ID だけで(タイトル・期限・リリース済みかは見ない)、先頭の
373
+ `v` / `V` は比べるときだけ外し、数字は数として比べる(`0.10.0` > `0.9.0`、`v2.0` > `v1.10` > `v1.9`)。バージョンでない ID も
374
+ 同じ規則で並べる(SemVer のプレリリースの順は持たない)。選ぶ欄の「(なし)」は先頭、進捗の「マイルストーンなし」と
375
+ project.yaml に無いリリースノートは最後。リリースノートの画面は、指定(`?m=`)が無ければ先頭を開く
376
+ - project.yaml の順は表示のために変えない(足した順のまま)。マイルストーンのタブは開いたときに降順に並べ、編集の間は行を動かさない
377
+ (ID を書き換えても、足した行は最後のまま)。保存すると並べ直す
350
378
  - **タグ**(`tags`): 外部 ID や分類の自由な文字列(例 `jira:PROJ-123`、`group:顧客A`)。同じ値を複数の要望に付けてグループにできる。
351
379
  要望・タスクの参照の代わりにはせず、外部のシステムとは同期しない
352
380
  - CLI: `request new --tag 値`(繰り返し可。カンマで分けない)、`request set <要望> --tag 値 ...`(この並びに置き換える)、
@@ -354,6 +382,53 @@ Preflight は始めたときの内容を固定して評価する。**評価の
354
382
  - 画面: 値ごとに Enter で足し、× で外す(すぐ保存)。前後の空白は除き、同じ値は1つにまとめる。カンマ・空白・記号・日本語はそのまま
355
383
  - 進捗の絞り込み: 「タグ」から複数選ぶと、どれかが付いている要望(状態の絞り込みとは「かつ」)。URL は `?tags=`(JSON の配列)
356
384
 
385
+ ### 親と子の要望
386
+
387
+ 大きい要望は、子の要望に分けて、子ごとに Preflight・タスク・ブランチを持たせられる(分け方の基準と規則は
388
+ [architecture](architecture.md#大きい要望の分割親と子の要望))。
389
+
390
+ ```bash
391
+ p3 request new "通知の Lambda を作る" --parent k7m3x # 子を作る。省いた期限・マイルストーン・タグは親から写す(後は別々)
392
+ p3 request ls --parent k7m3x # 直下の子
393
+ p3 request show k7m3x --brief --json # parent・ancestors(根から順)・children(タスクの数つき)・hierarchyIssues
394
+ p3 request set q2w8e parent=a1b2c # 付け替え。parent= で外す
395
+ ```
396
+
397
+ - 親にできないもの: 無い要望・自分・自分の子孫・アーカイブした要望・形の違う ID(終了コード 1、API は 409 `hierarchy_invalid`)。
398
+ ほかの操作と重なったときは終了コード 3(API は 409 `hierarchy_busy`)で、そのままやり直してよい
399
+ - 子のある要望・親のある要望はアーカイブできない。子の親を外してから(`parent=`)アーカイブする
400
+ - `request.md` を直接編集して循環・無い親になったときは、`show` と画面の詳細に知らせ(`hierarchyIssues`)が出る。`parent` を直す
401
+ - **分割の案**: 想定のタスクが 6 件以上か、独立したインフラ・運用・リリースの境界があると、Preflight は分けるか・分けないかと
402
+ その理由を評価に書き(`p3 drafts` の「分割」)、分けるならタスク案の代わりに子の要望の案(`children/C1.md`。目的・範囲・範囲外・
403
+ 完了条件・分割の理由・他の子との前提・出典、想定のタスクの数、親の既存のタスクとの重なり)を出す。分けさせたくない・分けたいときは
404
+ メモでそう書いて再評価する
405
+
406
+ ```bash
407
+ p3 drafts k7m3x # 分割の判断と子の案([x] 採用 / [ ] 不採用、前提・重なり)
408
+ p3 accept k7m3x --skip C3 # 選んだ案から下書きの子を作る(親は残す。子のタスク化・Preflight はしない)
409
+ p3 preflight <子> # 子ごとに Preflight → accept でタスクにする
410
+ ```
411
+
412
+ - 子の本文には、親の目的(採用のときの親の題と本文)と案の範囲・前提が入る。期限・マイルストーン・タグは親から写す
413
+ - 親の題・本文が変わった、別の run から採用した・子を足したなどで子の集合が変わった run からは採用しない(`stale_input`)。
414
+ 子の Preflight も、親の題・本文が変わったら子のタスク化を断る。どちらも再評価する
415
+ - 途中で失敗したら、作った子・失敗・まだの案が出る。直して同じ `accept` を実行すると続きから作る(作った子は作り直さず、消さない)
416
+ - 画面: 要望の概要の Preflight に「子の要望への分割案」として、分割の判断(理由・想定のタスク数)と各案(想定のタスク数・前提・
417
+ 重なり。「目的・範囲・完了条件・前提を見る」で開閉)を出す。採否のチェック、「題・本文を直す」→「変更を保存」で直せる。
418
+ 「採用内容を確認」で作る子と親の扱い(親は残す・子は下書き・子の Preflight はまだ)を確かめてから「子の要望を n 件作成」
419
+ (Escape・取消では何も作らない)。保存していない編集・本文や題・古い評価・案の問題・選んだ案が0件の間は押せない。作った子は
420
+ リンクで開ける。途中で失敗したら、作った子と止まった案を出し、「続きを作る」で続ける
421
+ - 完了: 親は、自分のタスクが全部完了で、見送り以外の子(孫も)が全部 対応済か完了済のときだけ対応済(子のある要望は完了済も)に
422
+ できる。自分のタスクが無く子だけの親もよい。子が全部見送りで自分のタスクも無い親はできない。自動では対応済・完了済にしない
423
+ - 子にタスクを足した・完了から戻した・子を進行中に戻した・対応済の親に未完了の子を足したときは、対応済の祖先が進行中に戻る
424
+ (`reopenedAncestors`)。完了済の祖先は変えずに警告(`ancestor_done`)が出るので、再開するなら `request set <親> status=active`
425
+ - 画面: 要望の概要の「親子」で親を選ぶ・付け替える・外す(「親を保存」。失敗しても選んだ親は残る)。子の一覧(状態・自分のタスクの数・
426
+ ボードへ)、この要望自身と配下全体のタスクの数、対応済にできない理由、見送りで対象外の子、完了済の祖先・親子の問題の知らせを出す。
427
+ 新しい要望の画面でも親を選べる。子の画面の見出しには祖先へのリンク(根から順)
428
+ - `p3 progress` は子のある要望に配下の集計(`[配下 完了/全部・子 n]`)を添える。マイルストーンの合計は各要望の自分のタスクだけを足す
429
+ - リリースノート: 子だけの親は「構造の要望」として収録の判定に入り(材料は無い)、材料は各要望の自分の変更の記録だけ。子が別の
430
+ マイルストーンなら子の記録はそちらに入り、親はその子が終わるまで収録されない(一括完了もできない)
431
+
357
432
  ### リリースノート
358
433
 
359
434
  マイルストーンごとに1件、そのマイルストーンに属する要望のタスクの **変更の記録** から機能の要約をまとめる。
@@ -395,6 +470,27 @@ p3 release-notes export v0.2 > RELEASE.md # 公開する本文だけ(出
395
470
  必要なら生成し直して、確かめてから保存する
396
471
  - **競合**: 保存したノートを直すときは、読んだときの版(`--version`)が要る。画面・エディタなど別のところで先に変わっていれば
397
472
  終了コード 3 で何も書かない。`show` で読み直してからやり直す
473
+ - **要望を一括で完了済にする**: リリースが終わったら、人がマイルストーンの要望の状態をまとめて閉じられる(対応済 → 完了済)。
474
+ できるのは、見送りを除く全要望が収録の条件(対応済か完了済・タスクが全部完了・読めないタスクなし)を満たすときだけ。
475
+ 変えるのは対応済の要望だけで、完了済・見送り、タスク(済みを含む)、ノート、マイルストーン(リリース済み)は変えない。
476
+ 変更の記録が無い・ノートを保存していない・済みを付けていないことは条件にしない。ノートの保存・生成とは別の、明示の操作
477
+
478
+ ```bash
479
+ p3 release-notes show v0.2 # 「要望の一括完了」に、できるか・できない理由・完了済にする要望と実行のコマンド
480
+ p3 release-notes complete-requests v0.2 --based-on <材料の hash> # show に出た hash で実行する
481
+ ```
482
+
483
+ - 確かめたあとで要望・タスクが変わっていれば(hash が違う)何も変えずに終了コード 3。できない(未完了がある)ときも何も
484
+ 変えずに終了コード 1。`show` で読み直してからやり直す
485
+ - 1件ずつ書くので、途中で別の変更とぶつかる(要望が変わった・タスクが戻った)・書けないと、その要望で止まる。完了済にした
486
+ もの・止まった要望と理由・まだ変えていないものを出す(戻さない)。直して `show` から読み直し、もう一度実行すれば残りを
487
+ 完了済にする(完了済にしたものは書き直さない)
488
+ - 完了済にすると材料が変わるので、保存したノートには「材料が変わった」と出る(本文はそのまま)
489
+ - 画面では、マイルストーンの「このマイルストーンの要望」の下の「要望の一括完了」。できないときは理由(要望ごと)と要望を開く
490
+ 導線を出し、ボタンは押せない。対象が無ければ「完了済にする要望はありません」。「要望を一括で完了済にする(N件)」で対象の
491
+ 要望と「タスクの済みは変えない」ことを確かめる欄を開き、キャンセルできる。実行の結果(完了済にした件数・途中で止まったときの
492
+ 完了済にした / 止まった / まだ変えていない)を出し、表示と進捗を取り直す。表示したあとで変わっていれば何も変えずに知らせる
493
+ (自動では頼み直さない。内容を確かめてもう一度押す)。本文の入力は消えない
398
494
  - **ファイル**: `<データのフォルダ>/release-notes/<マイルストーン>.md`(本文と、出典を書いた frontmatter)。エディタで直してもよい。
399
495
  壊すと「読めない」と出て、直すまで新しく保存しない。ノートのあるマイルストーンは消せない。保存の形と直し方は
400
496
  [docs/architecture.md](architecture.md#リリースノートのデータ)
@@ -446,12 +542,13 @@ p3 render 画面.html --width 1280 # 画面.png ができる(幅 32
446
542
  - **選ぶ**: 入口(`/`)は登録したプロジェクトの一覧(行のどこを押しても開く)。登録が1つだけで開けるときは、一覧を飛ばして
447
543
  そのプロジェクトを開く(使えない登録や個人設定の読めない理由があるときは一覧に出す)。選ぶと `/projects/<名前>/...` になり、
448
544
  ほかの URL(要望・ボード・リリースノート・設定、`?task=` など)はこの下に今までどおり続く。URL を直接開く・再読み込み・戻るも効く
449
- - **今のプロジェクト**: どの画面でも、ヘッダーの下の「プロジェクト」に出る。ここで切り替える(選ぶ欄を開くと一覧を読み直す)。
545
+ - **今のプロジェクト**: どの画面でも、ヘッダーのロゴの横(通常の serve でプロジェクト名を出す場所)の選ぶ欄に出る。ここで切り替える
546
+ (選ぶ欄を開くと一覧を読み直す。狭い画面でも隠さず、長い名前は欄の幅で切る)。
450
547
  「プロジェクトの一覧…」では、登録が1つでも一覧を出す(`/?list`)。一覧は、戻ったとき・そのタブに戻ったときにも読み直すので、
451
548
  途中で足した・外した登録が出る
452
549
  作成・保存・Preflight は、ここに出ているプロジェクトにだけ届く。タブごとに別のプロジェクトを開いてもよい
453
550
  - **切り替え**: ページごと移る。保存していない入力があれば「このプロジェクトに残る / 入力を破棄して切り替える」を選ぶ(破棄した
454
- 入力はどこにも送らない)。送っている保存は、結果が決まるまで待ってから移る。実行中の Preflight・生成は元のプロジェクトで続き、
551
+ 入力はどこにも送らない)。送っている保存は、結果が決まるまで待ってから移る(待っている間はヘッダーの下に出し、選ぶ欄は押せない)。実行中の Preflight・生成は元のプロジェクトで続き、
455
552
  戻れば状態を読み直す(取消は表示中のプロジェクトの実行にだけ届く)
456
553
  - **登録が変わったとき**: 開いている間にデータのフォルダを変えた・外した(CLI の `p3 project rm` / `add`)プロジェクトの画面からは
457
554
  保存しない。「登録が変わりました」と出るので、一覧から選び直す(入力は残すが、新しい登録先へ自動では送らない)
@@ -461,15 +558,17 @@ p3 render 画面.html --width 1280 # 画面.png ができる(幅 32
461
558
 
462
559
  | URL | 画面 |
463
560
  | --- | --- |
464
- | `/` | 進捗。左に要望、右にスケジュール。`?show=` で 未完了(既定)/ `resolved`(確認待ち)/ `closed`(完了済・見送り)/ `all`。`?tags=` |
561
+ | `/` | 進捗。左に要望、右にスケジュール。`?show=` で 未完了(既定)/ `resolved`(確認待ち)/ `closed`(完了済・見送り)/ `all`。`?tags=`。子の要望は親の下に字下げして並べ(▾ で畳む)、絞り込みに子だけが合うと親を「文脈」として出す(件数に数えない)。子のある親には `配下 完了/全部` |
465
562
  | `/requests/new` | 新しい要望(添付も) |
466
- | `/requests/<要望>` | 要望の概要(タイトル・本文・期限・マイルストーン・タグ・添付)と Preflight(`?run=PF-...` で過去の評価) |
563
+ | `/requests/<要望>` | 要望の概要(タイトル・本文・期限・マイルストーン・タグ・親子・添付)と Preflight(`?run=PF-...` で過去の評価)。子の要望は見出しの上に祖先へのリンク |
467
564
  | `/requests/<要望>/board` | タスクボード(V 字。ドラッグで列を移動。完了のカードの「✓ 済み」でボードから外す。「+ タスクを追加」で直接作る) |
468
565
  | `/requests/<要望>/done` | 対応済み(済みにしたタスクと成果物の一覧。要望の「対応済」とは別) |
469
- | `/release-notes` | リリースノート(`?m=<マイルストーン>`)。下の「リリースノートの画面」 |
566
+ | `/release-notes` | リリースノート(`?m=<マイルストーン>`)とマイルストーンの管理(`?tab=milestones`)。下の「リリースノートの画面」 |
470
567
  | `/settings` | 個人(ChatGPT の接続・テーマ)/ プロジェクトの基本 / 参照先(`?tab=personal|project|repos`) |
471
568
 
472
- 要望の中のページでは `?task=T003` でタスク詳細を重ねて開く。
569
+ 要望の中のページでは `?task=T003` でタスク詳細を重ねて開く。どのタブでも、見出しのタイトルの上に要望 ID と「コピー」が出る
570
+ (本文を下へ送っても見出しは残るので、上まで戻らずにコピーできる)。コピーできない(拒まれた・http で別のマシンから開いて
571
+ Clipboard API が無い)ときはそう出るので、ID をクリックして全体を選び、手でコピーする。
473
572
 
474
573
  進捗のスケジュールの記号:
475
574
 
@@ -484,7 +583,22 @@ p3 render 画面.html --width 1280 # 画面.png ができる(幅 32
484
583
 
485
584
  印をクリックするとタスクの詳細が開く。ズーム(日 / 週 / 月)と「今日」ボタンで動かす。
486
585
 
487
- **リリースノートの画面**(ヘッダーの「リリースノート」): 左でマイルストーンを選ぶ(ノートの有無と要望の数)。右に:
586
+ **リリースノートの画面**(ヘッダーの「リリースノート」): タブで「リリースノート」と「マイルストーン」を切り替える
587
+ (`?tab=milestones` が管理のタブ。無い・ほかの値はノートのタブ。タブを移っても `?m=` の選択と、どちらの書きかけの入力も残る。
588
+ 保存していない変更があるタブには ● が付く)。
589
+
590
+ **マイルストーンのタブ**: ID・名前・期限・リリース済み・属する要望の数を一覧で直し、「+ マイルストーンを追加」で足す(0 件から作れる)。
591
+ 「保存」でまとめて project.yaml に書き、「元に戻す」で保存した内容に戻す。
592
+
593
+ - **リリース済み**: リリースが終わったらチェックを付けて保存する(外すのも同じ)。ノートの本文・要望・タスクは変わらない。
594
+ ノートの保存や要望の一括完了でもリリース済みは変わらない(どれも別の操作)
595
+ - 要望が使っている・ノートのあるマイルストーンは、ID を変えられず消せない(理由が行に出る。CLI の `milestone rm` と同じ規則で、
596
+ 画面が古くても保存のときに止まり、理由が出る)。保存できなかったときは入力が残るので、直して保存し直す
597
+ - 編集中にほかで変わったら、入力を残して知らせる(「入力を捨てて最新を読み直す」)。保存するのはマイルストーンだけで、
598
+ 設定の「プロジェクトの基本」(名前・説明など)とは互いに巻き戻さない
599
+ - project.yaml に無いマイルストーンのノートは、管理のタブでは定義として出さずに知らせる(ノートのタブで読める)
600
+
601
+ **リリースノートのタブ**: 左でマイルストーンを選ぶ(ノートの有無と要望の数)。右に:
488
602
 
489
603
  - **このマイルストーンの要望**: 状態・収録 / 対象外(理由)・変更の記録の数・警告(未完了・記録なし・状態の食い違い)。
490
604
  タイトルで要望を開き、「変更の記録を見る」で要約の出典になるタスクの記録を確かめる(タスク名でタスクの詳細を開く)
@@ -593,6 +707,8 @@ AI にも CLI を使わせる(認証を持たせずに済む)。`p3 init --a
593
707
  - 後から片方を足したときは、スキルは置き、節(前の参照のまま)は「保護」になる。両方を指す節にするなら `--force`
594
708
  - チームで使うとき: 置いた・最新にした変更(`git diff`)をレビューしてコミットし、push して共有する。ほかの人は pull するだけで
595
709
  よい(参加の `p3 join` は AI 向けのファイルを書かない)
710
+ - 新しい版の P3 で手順が変わっても、置いたスキルと節は自動では変わらない(例: 完了をコミットの前にする順番)。`p3 agents <先>` で
711
+ 違いを確かめ、手で直していなければ `--force` で最新にする
596
712
  - 以前の版との違い: 以前は `init --agents` で両方に置き、参加(init)のときも置き、登録済みのリポジトリで実行し直すと足りない方を
597
713
  置いていた。今は、置く先を選び、参加では置かず、後から置く・最新にするのは `p3 agents` だけ
598
714
 
@@ -302,14 +302,16 @@ P3 をイメージにして、コンテナで動かすこともできる。イ
302
302
  要望・タスクの作成と編集・添付・Preflight もいつもどおり使える。
303
303
 
304
304
  イメージは Docker Hub の **`tamuto/p3`**。中に p3 本体(npm の `@infodb/p3` と同じ版・同じ中身)と、Node 22・git・Docker の CLI が
305
- 入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.3.0` など)と
305
+ 入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.5.0` など)と
306
306
  `latest` がある。決まった版で使うなら版のタグを指す。
307
307
 
308
308
  ```bash
309
- docker pull tamuto/p3:0.3.0
309
+ docker pull tamuto/p3:0.5.0
310
310
  ```
311
311
 
312
- リポジトリから作るときは `docker build -t tamuto/p3:dev .`([開発ガイド](development.md#docker-のイメージ))。
312
+ リポジトリから作るときは `docker build --pull -t tamuto/p3:dev .`(`--pull` で今の Node のベースを取る。[開発ガイド](development.md#docker-のイメージ))。
313
+ イメージの Node は同じメジャーの中で更新を追う(作り直した版に入る)。起動中のコンテナは自動では変わらないので、新しいイメージを
314
+ pull して起動し直す。
313
315
 
314
316
  コンテナは **root** で動く。個人設定と ChatGPT の接続は root の既定の場所(`/root/.config/infodb-p3`)のままで、イメージでは
315
317
  変えない。データのフォルダと参照先(リポジトリ)はホストのフォルダをマウントする(データは書く、参照先は Preflight が読むだけ)。
@@ -325,7 +327,7 @@ root で動く開発コンテナ(DevContainer など)で p3 の CLI を使
325
327
  # 開発コンテナの compose に足す例(パスは開発コンテナのマウントに合わせる)
326
328
  services:
327
329
  p3:
328
- image: tamuto/p3:0.3.0
330
+ image: tamuto/p3:0.5.0
329
331
  restart: unless-stopped
330
332
  ports:
331
333
  - "127.0.0.1:4310:4310"
@@ -349,7 +351,7 @@ docker run -d --name p3 --restart unless-stopped \
349
351
  -v ~/.config/infodb-p3:/root/.config/infodb-p3 \
350
352
  -v /home/me/work:/home/me/work \
351
353
  -v /var/run/docker.sock:/var/run/docker.sock \
352
- tamuto/p3:0.3.0
354
+ tamuto/p3:0.5.0
353
355
 
354
356
  # 登録が無ければ、コンテナの中で登録する(既にあるデータに参加する。新しく作るなら p3 init)
355
357
  docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
@@ -362,7 +364,7 @@ docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
362
364
  ### どちらでも
363
365
 
364
366
  - 待ち受けは `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 なら
367
+ - **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.5.0 serve --project myapp --host 0.0.0.0`。compose なら
366
368
  `command:`)。明示しない限り、コンテナの中かどうかで自動では切り替えない
367
369
  - **止める**: `docker stop p3`(SIGTERM。実行中の Preflight・生成を取り消して記録してから止まる。10 秒まで待つ)
368
370
  - **新しい版にする**: 版のタグを変えて作り直す(個人設定と接続はマウントした ~/.config、データはホストに残る)。
@@ -58,7 +58,9 @@ npm publish # prepack で画面をビルドする。publishConfig.
58
58
  ## 6. Docker Hub(tamuto/p3)
59
59
 
60
60
  イメージの中の p3 は、そのときのチェックアウトから `pnpm pack` と同じ中身で作る(npm から取らない)。npm に公開した版と同じ
61
- コミット(版のタグ `v<版>`)から作り、タグも同じ版にする。
61
+ コミット(版のタグ `v<版>`)から作り、タグも同じ版にする。ベースの Node はメジャー版だけを指定しているので、`--pull` を付けて
62
+ その時点の最新(同じメジャーのセキュリティリリースなど)を取って作る。Node の更新だけを取り込むときも、同じコミットから作り直して
63
+ push する(公開済みのイメージ・起動中のコンテナは自動では変わらない)。
62
64
 
63
65
  - [ ] npm の公開(5.)と同じコミットにいる(`git describe --tags` が `v<版>`、作業ツリーに変更が無い)
64
66
  - [ ] スモークが全段 ok: `node scripts/verify-docker.mjs --image tamuto/p3:<版>`(DevContainer の中では `--work`・`--network-of auto`・
@@ -71,7 +73,7 @@ npm publish # prepack で画面をビルドする。publishConfig.
71
73
  ```bash
72
74
  V=$(node -p "require('./package.json').version")
73
75
  docker login # tamuto に push できるアカウント
74
- docker buildx build --platform linux/amd64,linux/arm64 --build-arg P3_VERSION=$V \
76
+ docker buildx build --pull --platform linux/amd64,linux/arm64 --build-arg P3_VERSION=$V \
75
77
  -t tamuto/p3:$V -t tamuto/p3:latest --push .
76
78
  docker buildx imagetools inspect tamuto/p3:$V # 両方の platform があるか
77
79
  ```
@@ -0,0 +1,172 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { readFile } from "node:fs/promises";
3
+ import { basename, resolve as resolvePath } from "node:path";
4
+ import { parseArgs } from "node:util";
5
+ import { ATTACHMENT_LIMITS, AttachmentError, inspectAttachment } from "../core/store/attachments.js";
6
+ import { TASK_STATUSES, isTaskStatus } from "../shared/types.js";
7
+ import {} from "../core/context.js";
8
+ import { repoArg } from "../core/workTargets.js";
9
+ import { UsageError } from "./project.js";
10
+ import { Output } from "./output.js";
11
+ /** CLI の入力の解釈(オプション・キー=値・本文・添付のファイル)と、コマンドに渡すもの(CommandEnv) */
12
+ const OPTIONS = {
13
+ dir: { type: "string" },
14
+ project: { type: "string" },
15
+ "all-projects": { type: "boolean" },
16
+ req: { type: "string" },
17
+ request: { type: "string" },
18
+ json: { type: "boolean" },
19
+ brief: { type: "boolean" },
20
+ actor: { type: "string" },
21
+ rev: { type: "string" },
22
+ help: { type: "boolean", short: "h" },
23
+ all: { type: "boolean" },
24
+ status: { type: "string" },
25
+ area: { type: "string", multiple: true },
26
+ label: { type: "string", multiple: true },
27
+ output: { type: "string", multiple: true },
28
+ "repo-output": { type: "string", multiple: true },
29
+ q: { type: "string", short: "q" },
30
+ due: { type: "string" },
31
+ milestone: { type: "string" },
32
+ parent: { type: "string" },
33
+ tag: { type: "string", multiple: true },
34
+ attach: { type: "string", multiple: true },
35
+ title: { type: "string" },
36
+ done: { type: "boolean" },
37
+ off: { type: "boolean" },
38
+ body: { type: "string" },
39
+ record: { type: "string" },
40
+ note: { type: "string" },
41
+ engine: { type: "string" },
42
+ run: { type: "string" },
43
+ only: { type: "string" },
44
+ skip: { type: "string" },
45
+ name: { type: "string" },
46
+ repo: { type: "string" },
47
+ description: { type: "string" },
48
+ instructions: { type: "string" },
49
+ // 値なしの --agents は both(joinValues が --agents=both にする)
50
+ agents: { type: "string" },
51
+ force: { type: "boolean" },
52
+ "note-only": { type: "boolean" },
53
+ "archive-superseded": { type: "boolean" },
54
+ paste: { type: "boolean" },
55
+ "no-browser": { type: "boolean" },
56
+ forget: { type: "boolean" },
57
+ yes: { type: "boolean", short: "y" },
58
+ local: { type: "boolean" },
59
+ "repo-name": { type: "string" },
60
+ port: { type: "string" },
61
+ host: { type: "string" },
62
+ out: { type: "string" },
63
+ source: { type: "string" },
64
+ width: { type: "string" },
65
+ version: { type: "string" },
66
+ file: { type: "string" },
67
+ "based-on": { type: "string" },
68
+ };
69
+ export const parse = (argv) => parseArgs({ args: joinValues(argv), options: OPTIONS, allowPositionals: true });
70
+ /** `--body "- 箇条書き"` のように値が - で始まっても受け取れるよう、`--body=...` の形にまとめる */
71
+ function joinValues(argv) {
72
+ const out = [];
73
+ for (let i = 0; i < argv.length; i++) {
74
+ const name = /^--([a-z]+)$/.exec(argv[i])?.[1];
75
+ const opt = name ? OPTIONS[name] : undefined;
76
+ if (name === "agents") {
77
+ // 値は省ける(both)。次がオプション(- で始まる)か無ければ値なし。値は確かめる側(init)で断る
78
+ const next = argv[i + 1];
79
+ out.push(next !== undefined && !next.startsWith("-") ? `--agents=${argv[++i]}` : "--agents=both");
80
+ }
81
+ else if (opt?.type === "string" && i + 1 < argv.length && !argv[i + 1].startsWith("--")) {
82
+ out.push(`${argv[i]}=${argv[++i]}`);
83
+ }
84
+ else {
85
+ out.push(argv[i]);
86
+ }
87
+ }
88
+ return out;
89
+ }
90
+ // --- 入力 -----------------------------------------------------------------
91
+ const TASK_KEYS = ["title", "status", "labels", "areas", "outputs", "repo", "repoOutputs"];
92
+ export function parseTaskAssignments(pairs) {
93
+ const patch = {};
94
+ for (const pair of pairs) {
95
+ const [key, raw] = splitPair(pair);
96
+ if (!TASK_KEYS.includes(key))
97
+ throw new UsageError(`変更できるキー: ${TASK_KEYS.join(", ")}`);
98
+ if (key === "repo") {
99
+ // repo=<名前> / repo=none・repo= は作業先なし
100
+ patch.repo = repoArg(raw);
101
+ continue;
102
+ }
103
+ if (key === "repoOutputs") {
104
+ if (raw !== "")
105
+ throw new UsageError("repoOutputs= は空で全部外すだけ。足すときは --repo-output <名前>=<成果物>");
106
+ patch.repoOutputs = [];
107
+ continue;
108
+ }
109
+ if (raw === "") {
110
+ patch[key] = key === "labels" || key === "areas" || key === "outputs" ? [] : undefined;
111
+ continue;
112
+ }
113
+ if (key === "labels" || key === "areas" || key === "outputs")
114
+ patch[key] = list(raw);
115
+ else if (key === "status") {
116
+ checkStatus(raw);
117
+ patch[key] = raw;
118
+ }
119
+ else
120
+ patch[key] = raw;
121
+ }
122
+ return patch;
123
+ }
124
+ export function splitPair(pair) {
125
+ const eq = pair.indexOf("=");
126
+ if (eq < 1)
127
+ throw new UsageError(`キー=値 の形で指定してください: ${pair}`);
128
+ return [pair.slice(0, eq), pair.slice(eq + 1).trim()];
129
+ }
130
+ export function checkStatus(status) {
131
+ if (!isTaskStatus(status))
132
+ throw new UsageError(`ステータスは ${TASK_STATUSES.join(", ")} のいずれか`);
133
+ }
134
+ export const list = (s) => s.split(",").map((x) => x.trim()).filter(Boolean);
135
+ export function num(v, name) {
136
+ const n = Number(v);
137
+ if (!Number.isFinite(n))
138
+ throw new UsageError(`${name} は数値で指定してください`);
139
+ return n;
140
+ }
141
+ export function date(v) {
142
+ if (!/^\d{4}-\d{2}-\d{2}$/.test(v))
143
+ throw new UsageError(`日付は YYYY-MM-DD: ${v}`);
144
+ return v;
145
+ }
146
+ export function readBody(v) {
147
+ if (v === undefined)
148
+ return "";
149
+ return v === "-" ? readFileSync(0, "utf8") : v;
150
+ }
151
+ /** request new --attach のファイルを読み、要望を作る前に全部確かめる(1つでもだめなら作らない) */
152
+ export async function readAttachFiles(paths) {
153
+ if (paths.length > ATTACHMENT_LIMITS.count)
154
+ throw new UsageError(`添付は1つの要望に ${ATTACHMENT_LIMITS.count} 件までです`);
155
+ const files = [];
156
+ for (const path of paths) {
157
+ const data = await readFile(resolvePath(process.cwd(), path)).catch(() => {
158
+ throw new UsageError(`ファイルが読めません: ${path}`);
159
+ });
160
+ try {
161
+ inspectAttachment(data, basename(path));
162
+ }
163
+ catch (e) {
164
+ throw e instanceof AttachmentError ? new UsageError(`${path}: ${e.message}(要望は作っていません)`) : e;
165
+ }
166
+ files.push({ path, data });
167
+ }
168
+ const total = files.reduce((n, f) => n + f.data.length, 0);
169
+ if (total > ATTACHMENT_LIMITS.totalBytes)
170
+ throw new UsageError(`添付の合計が上限(${ATTACHMENT_LIMITS.totalBytes} バイト)を超えます(要望は作っていません)`);
171
+ return files;
172
+ }
@@ -0,0 +1,70 @@
1
+ import { spawn } from "node:child_process";
2
+ import { createInterface } from "node:readline";
3
+ import { chatgptAccount, signInFailure } from "../core/chatgpt.js";
4
+ import { UsageError } from "./project.js";
5
+ /**
6
+ * p3 chatgpt login | status | logout。プロジェクトを決める前に動く(どのプロジェクトにも属さない、このマシンの接続)。
7
+ * 設計: docs/chatgpt-sign-in.md
8
+ */
9
+ export async function chatgptCommand(args, o, account = chatgptAccount()) {
10
+ const [sub = "status"] = args;
11
+ switch (sub) {
12
+ case "status": {
13
+ const s = await account.status();
14
+ return { data: s, text: describe(s) };
15
+ }
16
+ case "login": {
17
+ const attempt = await account.startLogin({ port: o.port ? Number(o.port) : undefined });
18
+ process.stderr.write([
19
+ "ブラウザで ChatGPT にサインインし、プランの利用に同意してください:",
20
+ ` ${attempt.url}`,
21
+ `(${attempt.redirectUri} で待っています。5分で取り消します)`,
22
+ o.paste
23
+ ? "ブラウザが「接続できません」になったら、そのときのアドレスバーの URL をここに貼って Enter:"
24
+ : "DevContainer などでブラウザがコールバックに届かないときは、--paste を付けてやり直してください",
25
+ "",
26
+ ].join("\n"));
27
+ if (!o["no-browser"] && !o.paste)
28
+ openBrowser(attempt.url);
29
+ let s;
30
+ try {
31
+ if (o.paste) {
32
+ const rl = createInterface({ input: process.stdin });
33
+ const line = new Promise((res) => rl.once("line", res));
34
+ s = await Promise.race([attempt.done, line.then((url) => attempt.submit(url))]).finally(() => rl.close());
35
+ }
36
+ else {
37
+ s = await attempt.done;
38
+ }
39
+ }
40
+ catch (e) {
41
+ throw signInFailure(e);
42
+ }
43
+ return { data: s, text: `サインインしました: ${describe(s)}`, code: s.planAllowed ? 0 : 1 };
44
+ }
45
+ case "logout": {
46
+ const r = await account.logout({ forget: o.forget });
47
+ return { data: { ...r, status: await account.status() }, text: r.message };
48
+ }
49
+ default:
50
+ throw new UsageError("p3 chatgpt login | status | logout");
51
+ }
52
+ }
53
+ function describe(s) {
54
+ if (!s.connected)
55
+ return s.registered ? "接続していません(このマシンは登録済み。p3 chatgpt login でサインイン)" : "接続していません(p3 chatgpt login でサインイン)";
56
+ const plan = s.planAllowed ? "ChatGPT プランを使います" : "プランの利用が許可されていません(もう一度サインインして同意してください)";
57
+ return `${s.email ?? "(アカウント不明)"} ${plan} トークンの期限 ${s.expiresAt?.slice(0, 16).replace("T", " ")}(使うときに更新)`;
58
+ }
59
+ /** ブラウザを開く(DevContainer では VS Code が BROWSER にホストで開く仕組みを入れる)。開けなくても URL は表示済み */
60
+ function openBrowser(url) {
61
+ const cmd = process.env.BROWSER || (process.platform === "darwin" ? "open" : process.platform === "win32" ? "explorer" : "xdg-open");
62
+ try {
63
+ const p = spawn(cmd, [url], { stdio: "ignore", detached: true });
64
+ p.on("error", () => { });
65
+ p.unref();
66
+ }
67
+ catch {
68
+ // URL は表示してある
69
+ }
70
+ }