@infodb/p3 0.4.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 (208) 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-DdOGYj9z.js → appCtx-B-VRVOyv.js} +1 -1
  10. package/dist/web/assets/board-DAaVR04x.js +1 -0
  11. package/dist/web/assets/done-CaqB_qTH.js +1 -0
  12. package/dist/web/assets/index-BF1xMdJo.css +2 -0
  13. package/dist/web/assets/index-BQYvKpjF.js +12 -0
  14. package/dist/web/assets/new-DLVnRvrB.js +1 -0
  15. package/dist/web/assets/{preflightInput-DMxqnvF8.js → preflightInput-BAeEJYUK.js} +1 -1
  16. package/dist/web/assets/preload-helper-B74h5i3O.js +1 -0
  17. package/dist/web/assets/progressTree-wp9mH4VF.js +1 -0
  18. package/dist/web/assets/release-notes-MTLcOcvZ.js +3 -0
  19. package/dist/web/assets/requestData-D-HXu-cy.js +1 -0
  20. package/dist/web/assets/routes-CI4Qfkjs.js +3 -0
  21. package/dist/web/assets/settings-CJMNgzi6.js +1 -0
  22. package/dist/web/index.html +4 -4
  23. package/docs/architecture.md +220 -3
  24. package/docs/development.md +16 -9
  25. package/docs/how-to-use.md +72 -7
  26. package/docs/installation.md +8 -6
  27. package/docs/publishing.md +4 -2
  28. package/lib/cli/args.js +172 -0
  29. package/lib/cli/chatgpt.js +70 -0
  30. package/lib/cli/codex.js +30 -0
  31. package/lib/cli/format.js +9 -0
  32. package/{src/cli/help.ts → lib/cli/help.js} +8 -8
  33. package/lib/cli/main.js +326 -0
  34. package/lib/cli/output.js +110 -0
  35. package/lib/cli/preflightCommands.js +301 -0
  36. package/lib/cli/project.js +649 -0
  37. package/lib/cli/readOnly.js +36 -0
  38. package/lib/cli/releaseNotesCommands.js +197 -0
  39. package/lib/cli/render.js +58 -0
  40. package/lib/cli/requestCommands.js +180 -0
  41. package/lib/cli/showView.js +100 -0
  42. package/lib/cli/taskCommands.js +152 -0
  43. package/lib/cli/userConfig.js +64 -0
  44. package/{src/core/chatgpt.ts → lib/core/chatgpt.js} +10 -16
  45. package/lib/core/context.js +41 -0
  46. package/lib/core/hierarchy.js +128 -0
  47. package/lib/core/machineSettings.js +146 -0
  48. package/lib/core/machineSettingsEdit.js +148 -0
  49. package/lib/core/ops.js +120 -0
  50. package/lib/core/preflight/carryover.js +105 -0
  51. package/lib/core/preflight/codexEngine.js +687 -0
  52. package/lib/core/preflight/codexImage.js +61 -0
  53. package/lib/core/preflight/diagnose.js +95 -0
  54. package/lib/core/preflight/engine.js +58 -0
  55. package/lib/core/preflight/input.js +83 -0
  56. package/lib/core/preflight/launch.js +68 -0
  57. package/lib/core/preflight/mockEngine.js +175 -0
  58. package/lib/core/preflight/render.js +304 -0
  59. package/lib/core/preflight/service.js +868 -0
  60. package/lib/core/preflight/split.js +83 -0
  61. package/lib/core/preflight/uiMaterials.js +281 -0
  62. package/lib/core/preflight/uiRender.js +89 -0
  63. package/lib/core/preflight/wireframe.js +63 -0
  64. package/lib/core/preflight/xlsx.js +324 -0
  65. package/lib/core/projectRegistry.js +207 -0
  66. package/lib/core/redact.js +28 -0
  67. package/lib/core/releaseNotes/completeRequests.js +106 -0
  68. package/lib/core/releaseNotes/generate.js +266 -0
  69. package/lib/core/releaseNotes/material.js +141 -0
  70. package/lib/core/releaseNotes/mockSummarizer.js +26 -0
  71. package/lib/core/releaseNotes/service.js +83 -0
  72. package/lib/core/releaseNotes/store.js +209 -0
  73. package/lib/core/repoAdmin.js +82 -0
  74. package/lib/core/repoRefs.js +72 -0
  75. package/lib/core/requestOps.js +154 -0
  76. package/lib/core/requestStatus.js +171 -0
  77. package/lib/core/store/attachments.js +242 -0
  78. package/lib/core/store/collection.js +254 -0
  79. package/lib/core/store/frontmatter.js +18 -0
  80. package/lib/core/store/fsutil.js +84 -0
  81. package/lib/core/store/locate.js +162 -0
  82. package/lib/core/store/normalize.js +150 -0
  83. package/lib/core/store/noteStore.js +59 -0
  84. package/lib/core/store/preflightStore.js +161 -0
  85. package/lib/core/store/projectFile.js +99 -0
  86. package/lib/core/store/workspace.js +320 -0
  87. package/lib/core/supersede.js +69 -0
  88. package/lib/core/userConfig.js +158 -0
  89. package/{src/core/userTheme.ts → lib/core/userTheme.js} +11 -13
  90. package/lib/core/workTargets.js +106 -0
  91. package/lib/server/api/chatgptRoutes.js +46 -0
  92. package/{src/server/api/local.ts → lib/server/api/local.js} +23 -22
  93. package/lib/server/api/manifest.js +140 -0
  94. package/lib/server/api/projectsRoutes.js +82 -0
  95. package/lib/server/api/releaseNoteRoutes.js +88 -0
  96. package/lib/server/api/repoRoutes.js +67 -0
  97. package/lib/server/api/routes.js +404 -0
  98. package/lib/server/api/userThemeRoutes.js +60 -0
  99. package/lib/server/server.js +85 -0
  100. package/lib/shared/dates.js +10 -0
  101. package/{src/shared/directTask.ts → lib/shared/directTask.js} +3 -11
  102. package/lib/shared/hierarchy.js +120 -0
  103. package/lib/shared/milestoneOrder.js +45 -0
  104. package/lib/shared/preflightInput.js +19 -0
  105. package/lib/shared/refs.js +44 -0
  106. package/lib/shared/repos.js +69 -0
  107. package/lib/shared/scopeView.js +39 -0
  108. package/{src/shared/tags.ts → lib/shared/tags.js} +9 -14
  109. package/lib/shared/types.js +74 -0
  110. package/lib/shared/workTarget.js +31 -0
  111. package/package.json +4 -7
  112. package/skills/p3/SKILL.md +10 -0
  113. package/dist/web/assets/Outputs-5Hby-S5Q.js +0 -1
  114. package/dist/web/assets/RequestStatus-CTkGjT02.js +0 -1
  115. package/dist/web/assets/TagInput-Rj3PNOAF.js +0 -1
  116. package/dist/web/assets/TaskDrawer-DtPhiYxP.js +0 -3
  117. package/dist/web/assets/_requestId-CGvAfIkB.js +0 -30
  118. package/dist/web/assets/_requestId-DxfYhgAq.js +0 -1
  119. package/dist/web/assets/board-wt47lfrE.js +0 -1
  120. package/dist/web/assets/done-C9Ct7ssb.js +0 -1
  121. package/dist/web/assets/index-BTFL2rpp.js +0 -12
  122. package/dist/web/assets/index-DAyBsvua.css +0 -2
  123. package/dist/web/assets/new-e4ID2vQV.js +0 -1
  124. package/dist/web/assets/preload-helper-DhIyFaOW.js +0 -1
  125. package/dist/web/assets/release-notes-CQ0d2r0k.js +0 -3
  126. package/dist/web/assets/requestData-BDZqyl35.js +0 -1
  127. package/dist/web/assets/routes-Bipv3lwJ.js +0 -2
  128. package/dist/web/assets/settings-Dwh8fj6p.js +0 -1
  129. package/src/cli/args.ts +0 -186
  130. package/src/cli/chatgpt.ts +0 -74
  131. package/src/cli/codex.ts +0 -28
  132. package/src/cli/format.ts +0 -9
  133. package/src/cli/main.ts +0 -337
  134. package/src/cli/output.ts +0 -117
  135. package/src/cli/preflightCommands.ts +0 -245
  136. package/src/cli/project.ts +0 -675
  137. package/src/cli/readOnly.ts +0 -36
  138. package/src/cli/releaseNotesCommands.ts +0 -198
  139. package/src/cli/render.ts +0 -60
  140. package/src/cli/requestCommands.ts +0 -172
  141. package/src/cli/showView.ts +0 -110
  142. package/src/cli/taskCommands.ts +0 -167
  143. package/src/cli/userConfig.ts +0 -58
  144. package/src/core/context.ts +0 -58
  145. package/src/core/machineSettings.ts +0 -207
  146. package/src/core/machineSettingsEdit.ts +0 -156
  147. package/src/core/ops.ts +0 -114
  148. package/src/core/preflight/carryover.ts +0 -133
  149. package/src/core/preflight/codexEngine.ts +0 -703
  150. package/src/core/preflight/codexImage.ts +0 -98
  151. package/src/core/preflight/diagnose.ts +0 -124
  152. package/src/core/preflight/engine.ts +0 -92
  153. package/src/core/preflight/input.ts +0 -65
  154. package/src/core/preflight/launch.ts +0 -86
  155. package/src/core/preflight/mockEngine.ts +0 -145
  156. package/src/core/preflight/render.ts +0 -339
  157. package/src/core/preflight/service.ts +0 -707
  158. package/src/core/preflight/uiMaterials.ts +0 -272
  159. package/src/core/preflight/uiRender.ts +0 -84
  160. package/src/core/preflight/wireframe.ts +0 -69
  161. package/src/core/preflight/xlsx.ts +0 -328
  162. package/src/core/projectRegistry.ts +0 -264
  163. package/src/core/redact.ts +0 -31
  164. package/src/core/releaseNotes/completeRequests.ts +0 -102
  165. package/src/core/releaseNotes/generate.ts +0 -283
  166. package/src/core/releaseNotes/material.ts +0 -114
  167. package/src/core/releaseNotes/mockSummarizer.ts +0 -28
  168. package/src/core/releaseNotes/service.ts +0 -110
  169. package/src/core/releaseNotes/store.ts +0 -216
  170. package/src/core/repoAdmin.ts +0 -81
  171. package/src/core/repoRefs.ts +0 -90
  172. package/src/core/requestOps.ts +0 -140
  173. package/src/core/requestStatus.ts +0 -58
  174. package/src/core/store/attachments.ts +0 -228
  175. package/src/core/store/collection.ts +0 -282
  176. package/src/core/store/frontmatter.ts +0 -22
  177. package/src/core/store/fsutil.ts +0 -90
  178. package/src/core/store/locate.ts +0 -181
  179. package/src/core/store/normalize.ts +0 -155
  180. package/src/core/store/noteStore.ts +0 -56
  181. package/src/core/store/preflightStore.ts +0 -136
  182. package/src/core/store/projectFile.ts +0 -101
  183. package/src/core/store/workspace.ts +0 -328
  184. package/src/core/supersede.ts +0 -74
  185. package/src/core/userConfig.ts +0 -205
  186. package/src/core/workTargets.ts +0 -120
  187. package/src/server/api/chatgptRoutes.ts +0 -49
  188. package/src/server/api/manifest.ts +0 -135
  189. package/src/server/api/projectsRoutes.ts +0 -89
  190. package/src/server/api/releaseNoteRoutes.ts +0 -89
  191. package/src/server/api/repoRoutes.ts +0 -67
  192. package/src/server/api/routes.ts +0 -382
  193. package/src/server/api/userThemeRoutes.ts +0 -62
  194. package/src/server/server.ts +0 -108
  195. package/src/shared/dates.ts +0 -12
  196. package/src/shared/milestoneOrder.ts +0 -44
  197. package/src/shared/preflightInput.ts +0 -27
  198. package/src/shared/refs.ts +0 -55
  199. package/src/shared/repos.ts +0 -113
  200. package/src/shared/scopeView.ts +0 -48
  201. package/src/shared/types.ts +0 -730
  202. package/src/shared/workTarget.ts +0 -44
  203. /package/{src → lib}/core/preflight/launcher.mjs +0 -0
  204. /package/{src → lib}/core/preflight/mock-ui.html +0 -0
  205. /package/{src → lib}/core/preflight/mock-ui.png +0 -0
  206. /package/{src → lib}/core/preflight/render-image/Dockerfile +0 -0
  207. /package/{src → lib}/core/preflight/render-image/fonts-ja.conf +0 -0
  208. /package/{src → lib}/core/preflight/render-image/render.mjs +0 -0
@@ -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,53 @@ 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 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
+
382
432
  ### リリースノート
383
433
 
384
434
  マイルストーンごとに1件、そのマイルストーンに属する要望のタスクの **変更の記録** から機能の要約をまとめる。
@@ -508,12 +558,12 @@ p3 render 画面.html --width 1280 # 画面.png ができる(幅 32
508
558
 
509
559
  | URL | 画面 |
510
560
  | --- | --- |
511
- | `/` | 進捗。左に要望、右にスケジュール。`?show=` で 未完了(既定)/ `resolved`(確認待ち)/ `closed`(完了済・見送り)/ `all`。`?tags=` |
561
+ | `/` | 進捗。左に要望、右にスケジュール。`?show=` で 未完了(既定)/ `resolved`(確認待ち)/ `closed`(完了済・見送り)/ `all`。`?tags=`。子の要望は親の下に字下げして並べ(▾ で畳む)、絞り込みに子だけが合うと親を「文脈」として出す(件数に数えない)。子のある親には `配下 完了/全部` |
512
562
  | `/requests/new` | 新しい要望(添付も) |
513
- | `/requests/<要望>` | 要望の概要(タイトル・本文・期限・マイルストーン・タグ・添付)と Preflight(`?run=PF-...` で過去の評価) |
563
+ | `/requests/<要望>` | 要望の概要(タイトル・本文・期限・マイルストーン・タグ・親子・添付)と Preflight(`?run=PF-...` で過去の評価)。子の要望は見出しの上に祖先へのリンク |
514
564
  | `/requests/<要望>/board` | タスクボード(V 字。ドラッグで列を移動。完了のカードの「✓ 済み」でボードから外す。「+ タスクを追加」で直接作る) |
515
565
  | `/requests/<要望>/done` | 対応済み(済みにしたタスクと成果物の一覧。要望の「対応済」とは別) |
516
- | `/release-notes` | リリースノート(`?m=<マイルストーン>`)。下の「リリースノートの画面」 |
566
+ | `/release-notes` | リリースノート(`?m=<マイルストーン>`)とマイルストーンの管理(`?tab=milestones`)。下の「リリースノートの画面」 |
517
567
  | `/settings` | 個人(ChatGPT の接続・テーマ)/ プロジェクトの基本 / 参照先(`?tab=personal|project|repos`) |
518
568
 
519
569
  要望の中のページでは `?task=T003` でタスク詳細を重ねて開く。どのタブでも、見出しのタイトルの上に要望 ID と「コピー」が出る
@@ -533,7 +583,22 @@ Clipboard API が無い)ときはそう出るので、ID をクリックして
533
583
 
534
584
  印をクリックするとタスクの詳細が開く。ズーム(日 / 週 / 月)と「今日」ボタンで動かす。
535
585
 
536
- **リリースノートの画面**(ヘッダーの「リリースノート」): 左でマイルストーンを選ぶ(ノートの有無と要望の数)。右に:
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
+ **リリースノートのタブ**: 左でマイルストーンを選ぶ(ノートの有無と要望の数)。右に:
537
602
 
538
603
  - **このマイルストーンの要望**: 状態・収録 / 対象外(理由)・変更の記録の数・警告(未完了・記録なし・状態の食い違い)。
539
604
  タイトルで要望を開き、「変更の記録を見る」で要約の出典になるタスクの記録を確かめる(タスク名でタスクの詳細を開く)
@@ -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.5.0` など)と
306
306
  `latest` がある。決まった版で使うなら版のタグを指す。
307
307
 
308
308
  ```bash
309
- docker pull tamuto/p3:0.4.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.4.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.4.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.4.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
+ }
@@ -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,16 @@ 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 archive <要望> 子のある要望・親のある要望はできない(先に親を外す)
67
66
 
68
67
  タスク(今の要望の中。--req <要望> で指定、要望の作業ツリーの中なら省略可)
69
68
  ls 一覧 --status s1,s2 --area パス -q 語句 --repo <参照先>|none(作業先) --all(全要望)
@@ -92,6 +91,8 @@ Preflight
92
91
  accept [<要望>] タスク案をタスク化 --run PF-... --only D1,D2 --skip D3
93
92
  評価のあとでタイトル・本文が変わった run からはしない(code: stale_input。再評価する)
94
93
  置き換えられる既存タスクを表示して残す。--archive-superseded でアーカイブ
94
+ 分割の run(子の要望の案 C1, C2 ...)は、選んだ案から下書きの子の要望を作る(親は残す。子の Preflight はまだ)。
95
+ 途中で失敗したら同じ accept で続ける(作った子は作り直さない)
95
96
 
96
97
  共通オプション
97
98
  --project 名前 操作するプロジェクト(既定: 今いるリポジトリに登録したもの → 登録が1つならそれ。
@@ -105,4 +106,3 @@ Preflight
105
106
  タスクの関係(同じ要望の中だけ。Preflight のタスク化が張り、手では張らない。A → B のとき A には「相手の役割 B」、B には「相手の役割 A」と出る):
106
107
  ${relationTypes.map((t) => ` ${t.padEnd(13)} ${RELATION_TYPES[t].verb} →「${RELATION_TYPES[t].label}」/ 逆「${RELATION_TYPES[t].inverse}」`).join("\n")}
107
108
  `;
108
-