@infodb/p3 0.4.0 → 0.6.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/README.md +1 -0
  2. package/bin/p3.mjs +11 -5
  3. package/dist/web/assets/Outputs-CQi0oba1.js +1 -0
  4. package/dist/web/assets/RequestStatus-grC0F_SQ.js +1 -0
  5. package/dist/web/assets/Tabs-BJRGzidj.js +1 -0
  6. package/dist/web/assets/TagInput-DkuISbfK.js +1 -0
  7. package/dist/web/assets/TaskDrawer-CysOMAjG.js +3 -0
  8. package/dist/web/assets/_requestId-BQCwOAbs.js +30 -0
  9. package/dist/web/assets/_requestId-DgSOUH78.js +1 -0
  10. package/dist/web/assets/{ui-DdOGYj9z.js → appCtx-DCiGJFAe.js} +1 -1
  11. package/dist/web/assets/board-BsntpZXP.js +1 -0
  12. package/dist/web/assets/done-Bhxqy7bH.js +1 -0
  13. package/dist/web/assets/index-BF1xMdJo.css +2 -0
  14. package/dist/web/assets/index-BTuEPzgc.js +12 -0
  15. package/dist/web/assets/new-BwknRX3V.js +1 -0
  16. package/dist/web/assets/{preflightInput-DMxqnvF8.js → preflightInput-BAeEJYUK.js} +1 -1
  17. package/dist/web/assets/preload-helper-B40dBmwL.js +1 -0
  18. package/dist/web/assets/progressTree-DgrdDFih.js +1 -0
  19. package/dist/web/assets/release-notes-AgwbykyG.js +3 -0
  20. package/dist/web/assets/requestData-w6fhCYmh.js +1 -0
  21. package/dist/web/assets/routes-Bu3bhOaC.js +3 -0
  22. package/dist/web/assets/settings-BkV8KeQk.js +1 -0
  23. package/dist/web/index.html +4 -4
  24. package/docs/architecture.md +271 -3
  25. package/docs/development.md +22 -9
  26. package/docs/how-to-use.md +83 -7
  27. package/docs/installation.md +8 -6
  28. package/docs/publishing.md +4 -2
  29. package/lib/cli/args.js +172 -0
  30. package/lib/cli/chatgpt.js +70 -0
  31. package/lib/cli/codex.js +30 -0
  32. package/lib/cli/format.js +9 -0
  33. package/{src/cli/help.ts → lib/cli/help.js} +10 -8
  34. package/lib/cli/main.js +327 -0
  35. package/lib/cli/output.js +110 -0
  36. package/lib/cli/preflightCommands.js +301 -0
  37. package/lib/cli/project.js +649 -0
  38. package/lib/cli/readOnly.js +36 -0
  39. package/lib/cli/releaseNotesCommands.js +197 -0
  40. package/lib/cli/render.js +58 -0
  41. package/lib/cli/requestCommands.js +191 -0
  42. package/lib/cli/showView.js +100 -0
  43. package/lib/cli/taskCommands.js +152 -0
  44. package/lib/cli/userConfig.js +64 -0
  45. package/{src/core/chatgpt.ts → lib/core/chatgpt.js} +10 -16
  46. package/lib/core/context.js +41 -0
  47. package/lib/core/hierarchy.js +158 -0
  48. package/lib/core/machineSettings.js +146 -0
  49. package/lib/core/machineSettingsEdit.js +148 -0
  50. package/lib/core/ops.js +120 -0
  51. package/lib/core/preflight/carryover.js +105 -0
  52. package/lib/core/preflight/codexEngine.js +687 -0
  53. package/lib/core/preflight/codexImage.js +61 -0
  54. package/lib/core/preflight/diagnose.js +95 -0
  55. package/lib/core/preflight/engine.js +58 -0
  56. package/lib/core/preflight/input.js +83 -0
  57. package/lib/core/preflight/launch.js +68 -0
  58. package/lib/core/preflight/mockEngine.js +175 -0
  59. package/lib/core/preflight/render.js +304 -0
  60. package/lib/core/preflight/service.js +883 -0
  61. package/lib/core/preflight/split.js +83 -0
  62. package/lib/core/preflight/uiMaterials.js +281 -0
  63. package/lib/core/preflight/uiRender.js +89 -0
  64. package/lib/core/preflight/wireframe.js +63 -0
  65. package/lib/core/preflight/xlsx.js +324 -0
  66. package/lib/core/projectRegistry.js +207 -0
  67. package/lib/core/redact.js +28 -0
  68. package/lib/core/releaseNotes/completeRequests.js +106 -0
  69. package/lib/core/releaseNotes/generate.js +266 -0
  70. package/lib/core/releaseNotes/material.js +141 -0
  71. package/lib/core/releaseNotes/mockSummarizer.js +26 -0
  72. package/lib/core/releaseNotes/service.js +83 -0
  73. package/lib/core/releaseNotes/store.js +209 -0
  74. package/lib/core/repoAdmin.js +82 -0
  75. package/lib/core/repoRefs.js +72 -0
  76. package/lib/core/requestOps.js +164 -0
  77. package/lib/core/requestStatus.js +171 -0
  78. package/lib/core/store/attachments.js +242 -0
  79. package/lib/core/store/collection.js +254 -0
  80. package/lib/core/store/frontmatter.js +18 -0
  81. package/lib/core/store/fsutil.js +84 -0
  82. package/lib/core/store/locate.js +162 -0
  83. package/lib/core/store/normalize.js +152 -0
  84. package/lib/core/store/noteStore.js +59 -0
  85. package/lib/core/store/preflightStore.js +161 -0
  86. package/lib/core/store/projectFile.js +99 -0
  87. package/lib/core/store/workspace.js +320 -0
  88. package/lib/core/supersede.js +69 -0
  89. package/lib/core/userConfig.js +158 -0
  90. package/{src/core/userTheme.ts → lib/core/userTheme.js} +11 -13
  91. package/lib/core/workTargets.js +106 -0
  92. package/lib/server/api/chatgptRoutes.js +46 -0
  93. package/{src/server/api/local.ts → lib/server/api/local.js} +23 -22
  94. package/lib/server/api/manifest.js +147 -0
  95. package/lib/server/api/projectsRoutes.js +82 -0
  96. package/lib/server/api/releaseNoteRoutes.js +88 -0
  97. package/lib/server/api/repoRoutes.js +67 -0
  98. package/lib/server/api/routes.js +416 -0
  99. package/lib/server/api/userThemeRoutes.js +60 -0
  100. package/lib/server/server.js +85 -0
  101. package/lib/shared/dates.js +10 -0
  102. package/{src/shared/directTask.ts → lib/shared/directTask.js} +3 -11
  103. package/lib/shared/hierarchy.js +135 -0
  104. package/lib/shared/milestoneOrder.js +45 -0
  105. package/lib/shared/preflightInput.js +19 -0
  106. package/lib/shared/refs.js +44 -0
  107. package/lib/shared/repos.js +69 -0
  108. package/lib/shared/scopeView.js +39 -0
  109. package/{src/shared/tags.ts → lib/shared/tags.js} +9 -14
  110. package/lib/shared/types.js +74 -0
  111. package/lib/shared/workTarget.js +31 -0
  112. package/package.json +4 -7
  113. package/skills/p3/SKILL.md +10 -0
  114. package/dist/web/assets/Outputs-5Hby-S5Q.js +0 -1
  115. package/dist/web/assets/RequestStatus-CTkGjT02.js +0 -1
  116. package/dist/web/assets/TagInput-Rj3PNOAF.js +0 -1
  117. package/dist/web/assets/TaskDrawer-DtPhiYxP.js +0 -3
  118. package/dist/web/assets/_requestId-CGvAfIkB.js +0 -30
  119. package/dist/web/assets/_requestId-DxfYhgAq.js +0 -1
  120. package/dist/web/assets/board-wt47lfrE.js +0 -1
  121. package/dist/web/assets/done-C9Ct7ssb.js +0 -1
  122. package/dist/web/assets/index-BTFL2rpp.js +0 -12
  123. package/dist/web/assets/index-DAyBsvua.css +0 -2
  124. package/dist/web/assets/new-e4ID2vQV.js +0 -1
  125. package/dist/web/assets/preload-helper-DhIyFaOW.js +0 -1
  126. package/dist/web/assets/release-notes-CQ0d2r0k.js +0 -3
  127. package/dist/web/assets/requestData-BDZqyl35.js +0 -1
  128. package/dist/web/assets/routes-Bipv3lwJ.js +0 -2
  129. package/dist/web/assets/settings-Dwh8fj6p.js +0 -1
  130. package/src/cli/args.ts +0 -186
  131. package/src/cli/chatgpt.ts +0 -74
  132. package/src/cli/codex.ts +0 -28
  133. package/src/cli/format.ts +0 -9
  134. package/src/cli/main.ts +0 -337
  135. package/src/cli/output.ts +0 -117
  136. package/src/cli/preflightCommands.ts +0 -245
  137. package/src/cli/project.ts +0 -675
  138. package/src/cli/readOnly.ts +0 -36
  139. package/src/cli/releaseNotesCommands.ts +0 -198
  140. package/src/cli/render.ts +0 -60
  141. package/src/cli/requestCommands.ts +0 -172
  142. package/src/cli/showView.ts +0 -110
  143. package/src/cli/taskCommands.ts +0 -167
  144. package/src/cli/userConfig.ts +0 -58
  145. package/src/core/context.ts +0 -58
  146. package/src/core/machineSettings.ts +0 -207
  147. package/src/core/machineSettingsEdit.ts +0 -156
  148. package/src/core/ops.ts +0 -114
  149. package/src/core/preflight/carryover.ts +0 -133
  150. package/src/core/preflight/codexEngine.ts +0 -703
  151. package/src/core/preflight/codexImage.ts +0 -98
  152. package/src/core/preflight/diagnose.ts +0 -124
  153. package/src/core/preflight/engine.ts +0 -92
  154. package/src/core/preflight/input.ts +0 -65
  155. package/src/core/preflight/launch.ts +0 -86
  156. package/src/core/preflight/mockEngine.ts +0 -145
  157. package/src/core/preflight/render.ts +0 -339
  158. package/src/core/preflight/service.ts +0 -707
  159. package/src/core/preflight/uiMaterials.ts +0 -272
  160. package/src/core/preflight/uiRender.ts +0 -84
  161. package/src/core/preflight/wireframe.ts +0 -69
  162. package/src/core/preflight/xlsx.ts +0 -328
  163. package/src/core/projectRegistry.ts +0 -264
  164. package/src/core/redact.ts +0 -31
  165. package/src/core/releaseNotes/completeRequests.ts +0 -102
  166. package/src/core/releaseNotes/generate.ts +0 -283
  167. package/src/core/releaseNotes/material.ts +0 -114
  168. package/src/core/releaseNotes/mockSummarizer.ts +0 -28
  169. package/src/core/releaseNotes/service.ts +0 -110
  170. package/src/core/releaseNotes/store.ts +0 -216
  171. package/src/core/repoAdmin.ts +0 -81
  172. package/src/core/repoRefs.ts +0 -90
  173. package/src/core/requestOps.ts +0 -140
  174. package/src/core/requestStatus.ts +0 -58
  175. package/src/core/store/attachments.ts +0 -228
  176. package/src/core/store/collection.ts +0 -282
  177. package/src/core/store/frontmatter.ts +0 -22
  178. package/src/core/store/fsutil.ts +0 -90
  179. package/src/core/store/locate.ts +0 -181
  180. package/src/core/store/normalize.ts +0 -155
  181. package/src/core/store/noteStore.ts +0 -56
  182. package/src/core/store/preflightStore.ts +0 -136
  183. package/src/core/store/projectFile.ts +0 -101
  184. package/src/core/store/workspace.ts +0 -328
  185. package/src/core/supersede.ts +0 -74
  186. package/src/core/userConfig.ts +0 -205
  187. package/src/core/workTargets.ts +0 -120
  188. package/src/server/api/chatgptRoutes.ts +0 -49
  189. package/src/server/api/manifest.ts +0 -135
  190. package/src/server/api/projectsRoutes.ts +0 -89
  191. package/src/server/api/releaseNoteRoutes.ts +0 -89
  192. package/src/server/api/repoRoutes.ts +0 -67
  193. package/src/server/api/routes.ts +0 -382
  194. package/src/server/api/userThemeRoutes.ts +0 -62
  195. package/src/server/server.ts +0 -108
  196. package/src/shared/dates.ts +0 -12
  197. package/src/shared/milestoneOrder.ts +0 -44
  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 -730
  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
@@ -97,6 +97,12 @@ pnpm video # 使い方の動画を録り直す(.p3-video/p3-
97
97
  閉じる / Escape の後に開いたボタンへフォーカスが戻ること。状態(要望・Preflight・タスク化・案の本文)は CLI とデータのファイルで用意し、
98
98
  開く・閉じるなどの確かめる操作はブラウザで行う。測り方(`test/ui/layout.ts`)は DOM の寸法で、意図した局所スクロール(overflow が
99
99
  visible 以外の要素の中)とページ全体のはみ出しを分ける。測り方が崩れを見逃さないことも、わざと崩した要素で確かめる
100
+ - 縦スクロール(`test/ui/verticalScroll.ui.test.ts`): 幅 1280 / 375・高さ 900 / 600・明暗で、通常のタスク案・子の分割案・
101
+ 親を持つ子(長い題の祖先が2段)・Preflight 未実行の要望を開き、文書と `main` が縦に送れず本文(`request-content`)だけが送れること、
102
+ 本文を下端まで送ると最後の要素まで届くこと、送ったあともコピーとタブが画面内にあること、横に送るタブと上のナビゲーションが縦に送れないこと、子の分割案の「採用内容を確認」と実行ログの
103
+ 末尾に届くことを測る。進捗・新しい要望・設定の3つのタブ・リリースノート・タスクボード・対応済みは、文書と上のナビゲーションとタブ(設定・リリースノートの tablist)が縦に
104
+ 送れないことだけを測る。測るのは名指しした要素(文書・`main`・本文・タブ・上のナビゲーション・実行ログ)の送れる量で、すべての要素を数えはしない。ほかの局所スクロールの
105
+ 中身や、通知(再読み込みの失敗・外での削除)が出ているときの高さは測らない
100
106
  - 限界: 画像の比較はしないので、色・重なり方・文字の欠けなど、測っていない見た目の乱れは保証しない。測るのは上の画面・幅・テーマだけ
101
107
  - 日本語のフォント: Noto Sans CJK JP があれば、ブラウザを使い方の動画と同じ fontconfig(`scripts/fonts-ja.conf`)で起こし、寸法を
102
108
  日本語のフォントで測る(無い環境では既定のフォントのまま測り、そのことを出す。飛ばしはしない)
@@ -176,7 +182,7 @@ src/ 依存の向き: shared ← core ← server / cli、web →
176
182
  routes/ ページ(1ファイル1ページ。__root.tsx が共通の枠)
177
183
  routeTree.gen.ts ルート一覧(自動生成)
178
184
  components/ 部品(複数のページで使うもの。大きいページの部品は components/<ページ>/)
179
- bin/p3.mjs CLI の起動口(tsx でソースをそのまま動かす)
185
+ bin/p3.mjs CLI の起動口(チェックアウトでは tsx でソースを、配布物ではビルドした lib/ を動かす)
180
186
  skills/p3/SKILL.md AI 向けスキルの原本(p3 init --agents / p3 agents で各プロジェクトの .claude/skills・.agents/skills の選んだ先に写す)
181
187
  scripts/ デモデータ・配布物の確認・使い方の動画(video/)
182
188
  docs/ 導入・使い方・開発・設計・公開の文書
@@ -192,17 +198,19 @@ test/ ユニットテスト
192
198
 
193
199
  ## npm で配る中身
194
200
 
195
- `@infodb/p3` として npm に公開する(公開そのものは人が行う。手順は [docs/publishing.md](publishing.md))。TypeScript のソースを
196
- `tsx` でそのまま動かし、画面だけをビルドして同梱する。
201
+ `@infodb/p3` として npm に公開する(公開そのものは人が行う。手順は [docs/publishing.md](publishing.md))。画面と CLI・serve を
202
+ ビルドして同梱し、利用者の環境では TypeScript を変換しない(`tsx` とそれが使う esbuild を入れないので、pnpm がビルドのスクリプトの
203
+ 許可を聞かない)。このリポジトリの開発(`pnpm p3`・テスト)は、今までどおりソースを `tsx` でそのまま動かす。
197
204
 
198
205
  | 何を | どうする |
199
206
  | --- | --- |
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 などの画面の部品はビルドに使うだけなので開発用 |
207
+ | 同梱するもの(`files`) | `bin/`、`lib/`(ビルド済みの CLI・serve。描画のイメージの資材 `lib/core/preflight/render-image/` などの .ts 以外の資材を含む)、`dist/web`(ビルド済みの画面)、`skills/`(AI 向けスキルの原本)、`docs/`(README から辿る文書)、README・LICENSE |
208
+ | 同梱しないもの | `.env`・個人設定・デモデータ(`.p3-demo/`)・テスト・`scripts/`・TypeScript のソース(`src/`)・開発用のスキル(`.claude/`) |
209
+ | 実行時の依存 | `hono`・`@hono/node-server`・`yaml`・`zod`・`@infodb/codex-workspace`・`@infodb/chatgpt-plan`。`tsx`(esbuild)と React などの画面の部品は開発用 |
210
+ | 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
211
  | Node | `>=22`(`@infodb/codex-workspace` と同じ)。開発(Vite 8)は Node 24 |
204
212
  | 公開前のビルド | `prepack` で `pnpm build`。利用者が入れるときにはビルドも Docker の操作もしない |
205
- | bin | `p3`。起動口は今いる場所の `tsconfig.json` を読まない。`INIT_CWD` に戻るのは P3 自身の `pnpm p3` スクリプトのときだけ |
213
+ | bin | `p3`(`bin/p3.mjs`)。`src/cli/main.ts` があるチェックアウトでは tsx でソースを、無ければ(配布物)`lib/cli/main.js` を動かす。ソースを動かすときは今いる場所の `tsconfig.json` を読まない。`INIT_CWD` に戻るのは P3 自身の `pnpm p3` スクリプトのときだけ |
206
214
 
207
215
  ```bash
208
216
  pnpm -s check # 型検査・lint・テスト・画面のビルド・UI テスト
@@ -216,11 +224,16 @@ P3_CODEX_PATH_MAP=/workspaces=/home/me/workspaces pnpm verify:pack --docker --re
216
224
  `Dockerfile`(Docker Hub の `tamuto/p3`。ビルドは Node 24 と packageManager の pnpm でロックファイルどおりに入れ、`pnpm pack` と同じ中身に実行時の依存だけを
217
225
  入れる。実行は Node 22・git・Docker の CLI と buildx。既定は `serve --all-projects --host 0.0.0.0`)と `.dockerignore`
218
226
  (git・依存・ビルドの出力・データ・個人設定・認証・テストを入れない)。約束は `test/docker.test.ts` が確かめる。
227
+ ベースの Node はメジャー版(`node:24-bookworm-slim` / `node:22-bookworm-slim`)だけを指定し、同じメジャーの中の更新(セキュリティ
228
+ リリースなど)は作り直すと入るようにしている。ただし Docker は手元にあるベースをそのまま使う(キャッシュ)ので、作るときは
229
+ `--pull` を付けて今のベースを取る(`scripts/verify-docker.mjs` も付ける。`--no-build` は作らずに既にあるイメージを確かめる)。
230
+ Docker の CLI と pnpm は版を固定し、メジャー版を上げるのは別の変更として行う。作り直しても、公開済みのイメージと起動中の
231
+ コンテナは変わらない(push し、使う側が pull して起動し直す)。
219
232
  公開(人が行う)は [publishing.md](publishing.md#6-docker-hubtamutop3) の手順で、CI は使わない。使い方は [導入ガイド](installation.md#docker-で動かすプロジェクトを跨ぐ-serve)。
220
233
 
221
234
  ```bash
222
- docker build -t tamuto/p3:dev .
223
- node scripts/verify-docker.mjs # ビルドして、使い捨ての2つのプロジェクトで動かす(スモーク)
235
+ docker build --pull -t tamuto/p3:dev .
236
+ node scripts/verify-docker.mjs # ビルド(--pull)して、使い捨ての2つのプロジェクトで動かす(スモーク)
224
237
  # DevContainer の中では、Docker のホストから見えるフォルダと、そのホストのパスを渡す。公開したポートはホストにしか開かないので、
225
238
  # このコンテナのネットワークに入れる
226
239
  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
 
@@ -223,7 +224,7 @@ p3 request set k7m3x status=done # 要望を完了済にする(
223
224
  | `instructions`(`preflight.instructions`) | プロジェクト固有の評価の観点・制約。Codex への指示に加わる |
224
225
  | `branchPattern` | 要望のブランチ名(既定 `req/{id}-{slug}`。作業先のリポジトリごとに同じ名前で割り当てる) |
225
226
 
226
- マイルストーンは `p3 milestone add|set|rm`、参照先は下の「参照先と作業先」。
227
+ マイルストーンは `p3 milestone add|set|rm` か画面のリリースノートの「マイルストーン」タブ(下の「リリースノートの画面」)、参照先は下の「参照先と作業先」。
227
228
 
228
229
  ### 参照先と作業先
229
230
 
@@ -335,6 +336,8 @@ Preflight は始めたときの内容を固定して評価する。**評価の
335
336
 
336
337
  - 対応済にできるのは、タスクが1件以上あり全部が完了のときだけ(人の「済み」や PR のマージは条件にしない)
337
338
  - 対応済の要望にタスクを足した・完了から戻した・再評価をタスク化したときは、進行中に戻る
339
+ - 子のある要望は、自分のタスクと、見送り以外の子(その下も)が全部終わっているときだけ対応済・完了済にできる。自分のタスクが
340
+ 無く子だけでもよい(見送りの子は対象外)。子に未完了ができると対応済の親は進行中に戻り、完了済の親は変わらず警告が出る([親と子の要望](#親と子の要望))
338
341
  - Preflight で状態が動くのはタスク化の前の要望だけ。進行中・完了の要望を再評価しても状態は変わらない
339
342
 
340
343
  ### タスクの関係と置き換え
@@ -365,12 +368,12 @@ Preflight は始めたときの内容を固定して評価する。**評価の
365
368
  - **期限**(`due`): 要望の期限(`--due YYYY-MM-DD`)。進捗のスケジュールに ⚑ で出る
366
369
  - **マイルストーン**: まとめてリリースする単位(`p3 milestone add v0.2 --title "通知まわり" --due 2026-11-30`、要望に `--milestone v0.2`)。
367
370
  リリースノートはマイルストーンごとに作る([リリースノート](#リリースノート))
368
- - **並び**: 選ぶ欄(新しい要望・要望の概要)・進捗のまとまり・リリースノートの一覧・設定・`p3 milestone` / `progress` / `config` の
371
+ - **並び**: 選ぶ欄(新しい要望・要望の概要)・進捗のまとまり・リリースノートの一覧・マイルストーンのタブ・`p3 milestone` / `progress` / `config` の
369
372
  一覧は、**ID のバージョンの降順**(新しいものが上)。比べるのは ID だけで(タイトル・期限・リリース済みかは見ない)、先頭の
370
373
  `v` / `V` は比べるときだけ外し、数字は数として比べる(`0.10.0` > `0.9.0`、`v2.0` > `v1.10` > `v1.9`)。バージョンでない ID も
371
374
  同じ規則で並べる(SemVer のプレリリースの順は持たない)。選ぶ欄の「(なし)」は先頭、進捗の「マイルストーンなし」と
372
375
  project.yaml に無いリリースノートは最後。リリースノートの画面は、指定(`?m=`)が無ければ先頭を開く
373
- - project.yaml の順は表示のために変えない(足した順のまま)。設定の画面は開いたときに降順に並べ、編集の間は行を動かさない
376
+ - project.yaml の順は表示のために変えない(足した順のまま)。マイルストーンのタブは開いたときに降順に並べ、編集の間は行を動かさない
374
377
  (ID を書き換えても、足した行は最後のまま)。保存すると並べ直す
375
378
  - **タグ**(`tags`): 外部 ID や分類の自由な文字列(例 `jira:PROJ-123`、`group:顧客A`)。同じ値を複数の要望に付けてグループにできる。
376
379
  要望・タスクの参照の代わりにはせず、外部のシステムとは同期しない
@@ -379,6 +382,64 @@ Preflight は始めたときの内容を固定して評価する。**評価の
379
382
  - 画面: 値ごとに Enter で足し、× で外す(すぐ保存)。前後の空白は除き、同じ値は1つにまとめる。カンマ・空白・記号・日本語はそのまま
380
383
  - 進捗の絞り込み: 「タグ」から複数選ぶと、どれかが付いている要望(状態の絞り込みとは「かつ」)。URL は `?tags=`(JSON の配列)
381
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 order k7m3x q2w8e a1b2c # 子の表示順を保存する(直下の子を全部、上から順に)。子を省くと今の並び
395
+ p3 request set q2w8e parent=a1b2c # 付け替え。parent= で外す
396
+ ```
397
+
398
+ - 親にできないもの: 無い要望・自分・自分の子孫・アーカイブした要望・形の違う ID(終了コード 1、API は 409 `hierarchy_invalid`)。
399
+ ほかの操作と重なったときは終了コード 3(API は 409 `hierarchy_busy`)で、そのままやり直してよい
400
+ - 子のある要望・親のある要望はアーカイブできない。子の親を外してから(`parent=`)アーカイブする
401
+ - `request.md` を直接編集して循環・無い親になったときは、`show` と画面の詳細に知らせ(`hierarchyIssues`)が出る。`parent` を直す
402
+ - **子の表示順**: 子は親の保存した表示順(親の `request.md` の `childOrder`)で並び、後ろの子を更新しても兄弟の位置は変わらない。
403
+ 保存した順に無い子(新しい子・付け替えて来た子・今までの親の子)は作成順で後ろに付く。概要・進捗・`show`・`request ls --parent`・
404
+ API で同じ順(規則と例は [architecture](architecture.md#子の表示順))
405
+ - 保存は直下の子を全部並べる。同じ子が2回・無い要望は終了コード 1、直下でない子・足りない子(読んだ後に子が増えた・付け替えられた)
406
+ と `--rev` の違いは終了コード 3(API は 409 `child_order_invalid`・`rev_conflict`)で、何も書かない。読み直して並べ直す
407
+ - 外した子・付け替えた子は並びから消える(親のファイルは書き換えない)。同じ親に戻すと前の位置に戻るので、末尾にしたいなら
408
+ 並べ直して保存する。分割の採用で作った子は、既存の子の後ろに C1, C2, … の順で足される
409
+ - 表示順は実行の順・着手できるかを表さない。子の前提(子の案の `requires`)は子の本文の「他の子との前提と契約」に残るので、
410
+ 着手の前に子の本文で確かめる(並びが前でも前提が済んでいるとは限らない)
411
+ - **分割の案**: 想定のタスクが 6 件以上か、独立したインフラ・運用・リリースの境界があると、Preflight は分けるか・分けないかと
412
+ その理由を評価に書き(`p3 drafts` の「分割」)、分けるならタスク案の代わりに子の要望の案(`children/C1.md`。目的・範囲・範囲外・
413
+ 完了条件・分割の理由・他の子との前提・出典、想定のタスクの数、親の既存のタスクとの重なり)を出す。分けさせたくない・分けたいときは
414
+ メモでそう書いて再評価する
415
+
416
+ ```bash
417
+ p3 drafts k7m3x # 分割の判断と子の案([x] 採用 / [ ] 不採用、前提・重なり)
418
+ p3 accept k7m3x --skip C3 # 選んだ案から下書きの子を作る(親は残す。子のタスク化・Preflight はしない)
419
+ p3 preflight <子> # 子ごとに Preflight → accept でタスクにする
420
+ ```
421
+
422
+ - 子の本文には、親の目的(採用のときの親の題と本文)と案の範囲・前提が入る。期限・マイルストーン・タグは親から写す
423
+ - 親の題・本文が変わった、別の run から採用した・子を足したなどで子の集合が変わった run からは採用しない(`stale_input`)。
424
+ 子の Preflight も、親の題・本文が変わったら子のタスク化を断る。どちらも再評価する
425
+ - 途中で失敗したら、作った子・失敗・まだの案が出る。直して同じ `accept` を実行すると続きから作る(作った子は作り直さず、消さない)
426
+ - 画面: 要望の概要の Preflight に「子の要望への分割案」として、分割の判断(理由・想定のタスク数)と各案(想定のタスク数・前提・
427
+ 重なり。「目的・範囲・完了条件・前提を見る」で開閉)を出す。採否のチェック、「題・本文を直す」→「変更を保存」で直せる。
428
+ 「採用内容を確認」で作る子と親の扱い(親は残す・子は下書き・子の Preflight はまだ)を確かめてから「子の要望を n 件作成」
429
+ (Escape・取消では何も作らない)。保存していない編集・本文や題・古い評価・案の問題・選んだ案が0件の間は押せない。作った子は
430
+ リンクで開ける。途中で失敗したら、作った子と止まった案を出し、「続きを作る」で続ける
431
+ - 完了: 親は、自分のタスクが全部完了で、見送り以外の子(孫も)が全部 対応済か完了済のときだけ対応済(子のある要望は完了済も)に
432
+ できる。自分のタスクが無く子だけの親もよい。子が全部見送りで自分のタスクも無い親はできない。自動では対応済・完了済にしない
433
+ - 子にタスクを足した・完了から戻した・子を進行中に戻した・対応済の親に未完了の子を足したときは、対応済の祖先が進行中に戻る
434
+ (`reopenedAncestors`)。完了済の祖先は変えずに警告(`ancestor_done`)が出るので、再開するなら `request set <親> status=active`
435
+ - 画面: 要望の概要の「親子」で親を選ぶ・付け替える・外す(「親を保存」。失敗しても選んだ親は残る)。子の一覧(表示順・状態・
436
+ 自分のタスクの数・ボードへ)と、各子の「上へ」「下へ」で並べて「順序を保存」(保存するまでは下書きで、「取消」で戻す。保存に失敗しても
437
+ 並べた順は残る。キーボードでも操作できる)、この要望自身と配下全体のタスクの数、対応済にできない理由、見送りで対象外の子、完了済の祖先・親子の問題の知らせを出す。
438
+ 新しい要望の画面でも親を選べる。子の画面の見出しには祖先へのリンク(根から順)
439
+ - `p3 progress` は子のある要望に配下の集計(`[配下 完了/全部・子 n]`)を添える。マイルストーンの合計は各要望の自分のタスクだけを足す
440
+ - リリースノート: 子だけの親は「構造の要望」として収録の判定に入り(材料は無い)、材料は各要望の自分の変更の記録だけ。子が別の
441
+ マイルストーンなら子の記録はそちらに入り、親はその子が終わるまで収録されない(一括完了もできない)
442
+
382
443
  ### リリースノート
383
444
 
384
445
  マイルストーンごとに1件、そのマイルストーンに属する要望のタスクの **変更の記録** から機能の要約をまとめる。
@@ -508,12 +569,12 @@ p3 render 画面.html --width 1280 # 画面.png ができる(幅 32
508
569
 
509
570
  | URL | 画面 |
510
571
  | --- | --- |
511
- | `/` | 進捗。左に要望、右にスケジュール。`?show=` で 未完了(既定)/ `resolved`(確認待ち)/ `closed`(完了済・見送り)/ `all`。`?tags=` |
572
+ | `/` | 進捗。左に要望、右にスケジュール。`?show=` で 未完了(既定)/ `resolved`(確認待ち)/ `closed`(完了済・見送り)/ `all`。`?tags=`。子の要望は親の下に字下げして、親の保存した表示順に並べ(▾ で畳む。根は更新の新しい順)、絞り込みに子だけが合うと親を「文脈」として出す(件数に数えない)。子のある親には `配下 完了/全部` |
512
573
  | `/requests/new` | 新しい要望(添付も) |
513
- | `/requests/<要望>` | 要望の概要(タイトル・本文・期限・マイルストーン・タグ・添付)と Preflight(`?run=PF-...` で過去の評価) |
574
+ | `/requests/<要望>` | 要望の概要(タイトル・本文・期限・マイルストーン・タグ・親子・添付)と Preflight(`?run=PF-...` で過去の評価)。子の要望は見出しの上に祖先へのリンク |
514
575
  | `/requests/<要望>/board` | タスクボード(V 字。ドラッグで列を移動。完了のカードの「✓ 済み」でボードから外す。「+ タスクを追加」で直接作る) |
515
576
  | `/requests/<要望>/done` | 対応済み(済みにしたタスクと成果物の一覧。要望の「対応済」とは別) |
516
- | `/release-notes` | リリースノート(`?m=<マイルストーン>`)。下の「リリースノートの画面」 |
577
+ | `/release-notes` | リリースノート(`?m=<マイルストーン>`)とマイルストーンの管理(`?tab=milestones`)。下の「リリースノートの画面」 |
517
578
  | `/settings` | 個人(ChatGPT の接続・テーマ)/ プロジェクトの基本 / 参照先(`?tab=personal|project|repos`) |
518
579
 
519
580
  要望の中のページでは `?task=T003` でタスク詳細を重ねて開く。どのタブでも、見出しのタイトルの上に要望 ID と「コピー」が出る
@@ -533,7 +594,22 @@ Clipboard API が無い)ときはそう出るので、ID をクリックして
533
594
 
534
595
  印をクリックするとタスクの詳細が開く。ズーム(日 / 週 / 月)と「今日」ボタンで動かす。
535
596
 
536
- **リリースノートの画面**(ヘッダーの「リリースノート」): 左でマイルストーンを選ぶ(ノートの有無と要望の数)。右に:
597
+ **リリースノートの画面**(ヘッダーの「リリースノート」): タブで「リリースノート」と「マイルストーン」を切り替える
598
+ (`?tab=milestones` が管理のタブ。無い・ほかの値はノートのタブ。タブを移っても `?m=` の選択と、どちらの書きかけの入力も残る。
599
+ 保存していない変更があるタブには ● が付く)。
600
+
601
+ **マイルストーンのタブ**: ID・名前・期限・リリース済み・属する要望の数を一覧で直し、「+ マイルストーンを追加」で足す(0 件から作れる)。
602
+ 「保存」でまとめて project.yaml に書き、「元に戻す」で保存した内容に戻す。
603
+
604
+ - **リリース済み**: リリースが終わったらチェックを付けて保存する(外すのも同じ)。ノートの本文・要望・タスクは変わらない。
605
+ ノートの保存や要望の一括完了でもリリース済みは変わらない(どれも別の操作)
606
+ - 要望が使っている・ノートのあるマイルストーンは、ID を変えられず消せない(理由が行に出る。CLI の `milestone rm` と同じ規則で、
607
+ 画面が古くても保存のときに止まり、理由が出る)。保存できなかったときは入力が残るので、直して保存し直す
608
+ - 編集中にほかで変わったら、入力を残して知らせる(「入力を捨てて最新を読み直す」)。保存するのはマイルストーンだけで、
609
+ 設定の「プロジェクトの基本」(名前・説明など)とは互いに巻き戻さない
610
+ - project.yaml に無いマイルストーンのノートは、管理のタブでは定義として出さずに知らせる(ノートのタブで読める)
611
+
612
+ **リリースノートのタブ**: 左でマイルストーンを選ぶ(ノートの有無と要望の数)。右に:
537
613
 
538
614
  - **このマイルストーンの要望**: 状態・収録 / 対象外(理由)・変更の記録の数・警告(未完了・記録なし・状態の食い違い)。
539
615
  タイトルで要望を開き、「変更の記録を見る」で要約の出典になるタスクの記録を確かめる(タスク名でタスクの詳細を開く)
@@ -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.4.0` など)と
305
+ 入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.6.0` など)と
306
306
  `latest` がある。決まった版で使うなら版のタグを指す。
307
307
 
308
308
  ```bash
309
- docker pull tamuto/p3:0.4.0
309
+ docker pull tamuto/p3:0.6.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.4.0
330
+ image: tamuto/p3:0.6.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.4.0
354
+ tamuto/p3:0.6.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.4.0 serve --project myapp --host 0.0.0.0`。compose なら
367
+ - **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.6.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
+ }
@@ -0,0 +1,30 @@
1
+ import { CodexImageError, updateCodexImage } from "../core/preflight/codexImage.js";
2
+ import { UsageError } from "./project.js";
3
+ /**
4
+ * p3 codex update。Codex を動かすイメージを今すぐ作り直し、入った Codex の版を表示する。
5
+ * プロジェクトを決める前に動く(このマシンの Docker のもの。プロジェクト・認証・個人設定の自動更新の停止に関係しない)。
6
+ * 進み具合は stderr に出し、--json の stdout は結果だけにする。
7
+ */
8
+ export async function codexCommand(args, docker = "docker") {
9
+ const [sub] = args;
10
+ if (sub !== "update")
11
+ throw new UsageError("p3 codex update(Codex のイメージを今すぐ作り直して、最新の Codex を入れる)");
12
+ let r;
13
+ try {
14
+ r = await updateCodexImage({ docker, onProgress: (t) => process.stderr.write(`${t}\n`) });
15
+ }
16
+ catch (e) {
17
+ if (!(e instanceof CodexImageError))
18
+ throw e;
19
+ return {
20
+ data: { ok: false, step: e.step, error: e.message, detail: e.detail ?? null },
21
+ text: `更新できませんでした: ${e.message}${e.detail ? `\n ${e.detail}` : ""}`,
22
+ code: 1,
23
+ };
24
+ }
25
+ const change = r.previous && r.previous !== r.version ? `(${r.previous} から)` : r.previous ? "(変わらず。これが最新)" : "";
26
+ return {
27
+ data: { ok: true, ...r },
28
+ text: `Codex を更新しました: ${r.version}${change}\n イメージ ${r.image}${r.createdAt ? `(${r.createdAt.slice(0, 19).replace("T", " ")} 作成)` : ""}`,
29
+ };
30
+ }
@@ -0,0 +1,9 @@
1
+ /** 表示幅(全角は2)を考慮して列を揃える */
2
+ export function table(rows) {
3
+ const width = (s) => Array.from(s).reduce((w, ch) => w + (/[ᄀ-ᅟ⺀-꓏가-힣豈-﫿︰-﹏＀-⦆¢-₩]/.test(ch) ? 2 : 1), 0);
4
+ const cols = Math.max(0, ...rows.map((r) => r.length));
5
+ const max = Array.from({ length: cols - 1 }, (_, i) => Math.min(48, Math.max(...rows.map((r) => width(r[i] ?? "")))));
6
+ return rows
7
+ .map((r) => r.map((c, i) => (i < cols - 1 ? c + " ".repeat(Math.max(0, max[i] - width(c))) : c)).join(" ").trimEnd())
8
+ .join("\n");
9
+ }
@@ -1,7 +1,5 @@
1
- import { RELATION_TYPES, REQUEST_STATUSES, relationTypes } from "../shared/types.ts";
2
-
1
+ import { RELATION_TYPES, REQUEST_STATUSES, relationTypes } from "../shared/types.js";
3
2
  /** p3 help */
4
-
5
3
  export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分けて管理するファイルベースのタスク管理
6
4
 
7
5
  使い方: p3 <コマンド> [引数] [オプション]
@@ -55,15 +53,18 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
55
53
  要望
56
54
  request new <タイトル> --body 本文|- --area パス --due YYYY-MM-DD --milestone id --tag 値(外部 ID・分類。繰り返し可)
57
55
  --attach ファイル(PNG / JPEG / xlsx。繰り返し可。作る前に全部確かめ、だめなら要望を作らない)
58
- request ls 一覧(--status draft,active ... --milestone id --tag 値。繰り返すとどれか)
59
- request show [<要望>] --brief 作業に要る項目だけ(本文・状態・ブランチ・タスクの一覧)
60
- request set [<要望>] キー=値 title status due milestone tags areas(status: ${REQUEST_STATUSES.join(" ")})
56
+ --parent <要望> 子の要望にする(省いた期限・マイルストーン・タグは親から写す)
57
+ request ls 一覧(--status draft,active ... --milestone id --tag 値。繰り返すとどれか。--parent <要望> で直下の子を表示順に)
58
+ request show [<要望>] --brief 作業に要る項目だけ(本文・状態・ブランチ・タスクの一覧・親子)
59
+ request set [<要望>] キー=値 title status due milestone tags areas parent(status: ${REQUEST_STATUSES.join(" ")}。parent= で親を外す)
61
60
  --body 本文|- 本文を書き換える(- は標準入力。どの状態でも書き換えられる。--rev で楽観ロック)
62
61
  例: p3 request show <要望> --brief --json で rev を見て
63
62
  p3 request set <要望> --body - --rev 3 < body.md
64
63
  評価のあとでタイトル・本文を変えると、その評価からはタスク化できない(もう一度 preflight)
65
64
  --tag 値 ... タグをこの値の並びに置き換える(カンマで分けない。tags=a,b はカンマで分ける)
66
- request archive <要望>
65
+ request order <親> [<子>...] 直下の子の表示順を保存する(子を全部、上から順に。--rev で楽観ロック)。子を省くと今の並びを出す
66
+ 表示の順だけで、実行の順・着手できるかは表さない(前提は子の本文で確かめる)
67
+ request archive <要望> 子のある要望・親のある要望はできない(先に親を外す)
67
68
 
68
69
  タスク(今の要望の中。--req <要望> で指定、要望の作業ツリーの中なら省略可)
69
70
  ls 一覧 --status s1,s2 --area パス -q 語句 --repo <参照先>|none(作業先) --all(全要望)
@@ -92,6 +93,8 @@ Preflight
92
93
  accept [<要望>] タスク案をタスク化 --run PF-... --only D1,D2 --skip D3
93
94
  評価のあとでタイトル・本文が変わった run からはしない(code: stale_input。再評価する)
94
95
  置き換えられる既存タスクを表示して残す。--archive-superseded でアーカイブ
96
+ 分割の run(子の要望の案 C1, C2 ...)は、選んだ案から下書きの子の要望を作る(親は残す。子の Preflight はまだ)。
97
+ 途中で失敗したら同じ accept で続ける(作った子は作り直さない)
95
98
 
96
99
  共通オプション
97
100
  --project 名前 操作するプロジェクト(既定: 今いるリポジトリに登録したもの → 登録が1つならそれ。
@@ -105,4 +108,3 @@ Preflight
105
108
  タスクの関係(同じ要望の中だけ。Preflight のタスク化が張り、手では張らない。A → B のとき A には「相手の役割 B」、B には「相手の役割 A」と出る):
106
109
  ${relationTypes.map((t) => ` ${t.padEnd(13)} ${RELATION_TYPES[t].verb} →「${RELATION_TYPES[t].label}」/ 逆「${RELATION_TYPES[t].inverse}」`).join("\n")}
107
110
  `;
108
-