@infodb/p3 0.5.0 → 0.7.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 (42) hide show
  1. package/README.md +1 -0
  2. package/dist/web/assets/{Outputs-C83ZDXvs.js → Outputs-CQi0oba1.js} +1 -1
  3. package/dist/web/assets/{RequestStatus-GmiWYEcL.js → RequestStatus-grC0F_SQ.js} +1 -1
  4. package/dist/web/assets/Tabs-BJRGzidj.js +1 -0
  5. package/dist/web/assets/{TagInput-CtM8HM8Z.js → TagInput-cIIwXAHA.js} +1 -1
  6. package/dist/web/assets/{TaskDrawer-D5v36QoF.js → TaskDrawer-CSZ7Z0JC.js} +1 -1
  7. package/dist/web/assets/{_requestId-DxwxbXY2.js → _requestId-C8WYk2kC.js} +2 -2
  8. package/dist/web/assets/{_requestId-BHUqLO-j.js → _requestId-Z3CBhTIL.js} +1 -1
  9. package/dist/web/assets/{appCtx-B-VRVOyv.js → appCtx-DCiGJFAe.js} +1 -1
  10. package/dist/web/assets/{board-DAaVR04x.js → board-DyfGX5h0.js} +1 -1
  11. package/dist/web/assets/{done-CaqB_qTH.js → done-Bhxqy7bH.js} +1 -1
  12. package/dist/web/assets/{index-BQYvKpjF.js → index-Bt13tvIX.js} +3 -3
  13. package/dist/web/assets/{new-DLVnRvrB.js → new-BRsIUNIb.js} +1 -1
  14. package/dist/web/assets/{preload-helper-B74h5i3O.js → preload-helper-B40dBmwL.js} +1 -1
  15. package/dist/web/assets/progressTree-DgrdDFih.js +1 -0
  16. package/dist/web/assets/{release-notes-MTLcOcvZ.js → release-notes-C3FdiM36.js} +1 -1
  17. package/dist/web/assets/{requestData-D-HXu-cy.js → requestData-w6fhCYmh.js} +1 -1
  18. package/dist/web/assets/{routes-CI4Qfkjs.js → routes-QNgQHe48.js} +1 -1
  19. package/dist/web/assets/{settings-CJMNgzi6.js → settings-CoKJahEe.js} +1 -1
  20. package/dist/web/index.html +3 -3
  21. package/docs/architecture.md +63 -6
  22. package/docs/development.md +7 -1
  23. package/docs/how-to-use.md +23 -6
  24. package/docs/installation.md +9 -6
  25. package/docs/publishing.md +3 -4
  26. package/lib/cli/help.js +3 -1
  27. package/lib/cli/main.js +3 -2
  28. package/lib/cli/project.js +1 -1
  29. package/lib/cli/requestCommands.js +19 -8
  30. package/lib/cli/showView.js +1 -1
  31. package/lib/core/hierarchy.js +50 -0
  32. package/lib/core/preflight/service.js +16 -1
  33. package/lib/core/requestOps.js +11 -1
  34. package/lib/core/store/collection.js +17 -6
  35. package/lib/core/store/normalize.js +3 -1
  36. package/lib/server/api/manifest.js +8 -1
  37. package/lib/server/api/routes.js +15 -3
  38. package/lib/shared/hierarchy.js +19 -4
  39. package/package.json +1 -1
  40. package/skills/p3/SKILL.md +7 -3
  41. package/dist/web/assets/Tabs-CJn0Qy7W.js +0 -1
  42. package/dist/web/assets/progressTree-wp9mH4VF.js +0 -1
@@ -72,7 +72,8 @@ Preflight で扱う要望が、プロジェクトで行う作業の粒度にな
72
72
  ### データの形
73
73
 
74
74
  子は親のフォルダの下ではなく、ほかの要望と同じ `requests/<作成日-乱数>/` に置き、`request.md` の frontmatter に親を1つだけ書く。
75
- 子の一覧は保存せず、親を指す要望を引いて作る(両側に書くと食い違うため)。
75
+ 子の一覧(親子の所属)は保存せず、親を指す要望を引いて作る(両側に書くと食い違うため)。親に書くのは子の表示順だけ
76
+ ([子の表示順](#子の表示順)。所属は決めない)。
76
77
 
77
78
  ```yaml
78
79
  ---
@@ -89,12 +90,18 @@ tags: [feature]
89
90
  - 親子は多段にしてよい(孫まで・それ以上も)。自分自身・自分の子孫・無い要望・アーカイブした要望・形の違う ID は親にできない。
90
91
  別のプロジェクトの要望は ID の形で指せない(プロジェクト名を含む参照は受け付けない)
91
92
  - `parent` の無い今のファイルはそのまま読め、書き換えない。保存のキーの順は `status` の後
93
+ - frontmatter のうち、その版が知らない項目(新しい版が足した項目)は、更新しても消さずに書き戻す(既知の項目の後ろ。要望とタスク。
94
+ 読んだ結果・API・CLI には出さない)。0.4.x 以前は知らない項目を書き戻さなかったので、その版で更新すると `parent`・`splitFrom`・
95
+ `childOrder` が消える。データを共有する人と AI は、0.5.0 以降の版で操作する
92
96
  - 既存のタスク・履歴・添付・Preflight の run は親から子へ動かさない。タスクの ID も振り直さない
93
97
  - 子の `due`・`milestone`・`tags` は作るときだけ親から写し、後で親を変えても子は変えない(逆も)。`areas`・`workstreams` は写さない
94
98
  (子のブランチは子のタスク化で、子の ID から `branchPattern` どおりに割り当てる)。添付は写さず、子の本文に出典(親の ID)を書く
95
99
  - 直接編集で循環・無い親(孤児)・アーカイブした親・読めない親になったら、読み込みでは止めずに **関係の問題**
96
100
  (`hierarchyIssues`。`code` は `parent_missing`・`parent_archived`・`parent_cycle`・`parent_invalid`・`parent_unreadable`)として
97
101
  一覧・詳細・進捗に出す。祖先を辿るときは訪れた ID を覚え、循環でも止まる。問題のある要望とその祖先は完了の判定で通さない
102
+ - 分割の採用(run.json の `adoption`)で作った子が、要望にもアーカイブにも無いときは、親の詳細と `show` だけに `child_missing` を出す
103
+ (run ごとに読むので、一覧・進捗では読まない)。データのフォルダを git で管理していて、子のフォルダが要望のブランチにだけあるときに
104
+ 起きる。知らせだけで、完了の判定は止めず、`parent` も戻さない
98
105
  - 親の付け替え・外す・子の作成は、プロジェクトの中の関係の操作の排他(`requests/.hierarchy.lock`。リリースノートの保存と同じ
99
106
  プロセス間のロック)の中で、ディスクから読み直して循環を確かめ、`rev` で書く。2人が同時に逆向きに付け替えても循環にならない。
100
107
  ロックを使わない直接編集までは防げない(読み込みの関係の問題で見つける)
@@ -107,7 +114,8 @@ tags: [feature]
107
114
  | --- | --- | --- |
108
115
  | 子を作る | `request new "<題>" --parent <ID>`(`--due`・`--milestone`・`--tag` を省くと親から写す) | `POST /api/requests` に `parent` |
109
116
  | 付け替え・外す | `request set <ID> parent=<ID>` / `parent=`(`--rev` で楽観ロック) | `PATCH /api/requests/:rid` に `parent`(外すのは `null`) |
110
- | 子の一覧 | `request ls --parent <ID>`(直下の子) | `GET /api/requests?parent=<ID>` |
117
+ | 子の一覧 | `request ls --parent <ID>`(直下の子を表示順に) | `GET /api/requests?parent=<ID>`(同じ) |
118
+ | 子の表示順 | `request order <親> <子>...`(子を省くと今の並び。`--rev` で楽観ロック) | `PUT /api/requests/:rid/child-order` に `{children, rev?}` |
111
119
  | 親子を読む | `request show <ID> --brief --json` | `GET /api/requests/:rid` |
112
120
 
113
121
  `show --brief --json` と要望の詳細には、今の項目に次を足す:
@@ -123,7 +131,7 @@ tags: [feature]
123
131
  }
124
132
  ```
125
133
 
126
- `ancestors` は根から順、`children` は直下だけ(作成日時の古い順 → ID)。
134
+ `ancestors` は根から順、`children` は直下だけ([子の表示順](#子の表示順))。
127
135
 
128
136
  失敗の返し方(CLI は終了コード、API は HTTP の状態と `code`):
129
137
 
@@ -134,9 +142,48 @@ tags: [feature]
134
142
  | ほかの操作が関係のロックを持っている | 3 | 409 `hierarchy_busy` | そのままやり直してよい(何も書いていない) |
135
143
  | 子のある要望のアーカイブ | 1 | 409 `has_children`(子の ID) | 子の親を外すか、子を先に片付ける |
136
144
  | 親のある要望のアーカイブ | 1 | 409 `has_parent` | `request set <ID> parent=` で外してからアーカイブ |
145
+ | 子の表示順に同じ子が2回・無い要望 | 1 | 409 `child_order_invalid`(`reason`: `duplicate`・`not_found`。`ids`・今の並び `children`) | 並びを直す |
146
+ | 子の表示順に直下でない子がある・子が足りない(読んだ後に子が変わった) | 3 | 409 `child_order_invalid`(`reason`: `not_child`・`missing`) | 読み直して並べ直す |
137
147
 
138
148
  アーカイブで未完了の子を暗黙に外さない(外すのは人の明示の操作だけ)。
139
149
 
150
+ ### 子の表示順
151
+
152
+ 一覧・詳細・進捗の更新の新しい順を兄弟にも使うと、後ろの子を更新しただけで子の並びが入れ替わり、段階的に進めたい子の順を人が保てない。
153
+ そこで親の `request.md` に任意の `childOrder`(直下の子の ID の並び)を書き、兄弟は共通の規則(`shared/hierarchy.ts` の `orderSiblings`)
154
+ で並べる。親子の所属は今までどおり子の `parent` が正で、`childOrder` は並びだけを決める。
155
+
156
+ ```yaml
157
+ ---
158
+ id: 261022-8s1k5
159
+ title: 大きい要望をサブ要望に分割する
160
+ status: active
161
+ childOrder: # 上から順。任意(無ければ作成順)
162
+ - 261023-q2w8e
163
+ - 261023-a1b2c
164
+ ---
165
+ ```
166
+
167
+ - 並べ方: `childOrder` にある今の直下の子を、その順に先に並べる(重複は最初の1回)。無い子(新しい子・付け替えて来た子・`childOrder`
168
+ の無い今までの親の子)は作成日時の古い順、同じ日時は数を考えた ID の順(`261023-b2` < `261023-b10`)で後ろに置く。
169
+ 今は子でない ID(外した・付け替えた・アーカイブした子、形の違う値・文字でない値)は読むときに無視し、ファイルは書き換えない。
170
+ 例: `childOrder: [B, A]` の親に子 A・B・C(作成順)なら B, A, C。B の親を外すと A, C。B を同じ親に戻すと、配列に残っているので
171
+ 前の位置(B, A, C)に戻る。末尾にしたいときは並べ直して保存する(保存すると今の子だけの並びになる)
172
+ - 同じ並びを、詳細と `show` の `children`・`request ls --parent`・`GET /api/requests?parent=`・進捗の木の兄弟(`web/lib/progressTree.ts`)・
173
+ 子孫を辿る順(`Hierarchy.descendants`)に使う。孫以下も各親の `childOrder` で並べる。全体の平らな進捗の一覧と木の根は今までどおり
174
+ 更新の新しい順。絞り込みで出す子が減っても、残った子の前後は変えない。循環・孤児は今までどおり根に出して止まる
175
+ - 保存(`core/requestOps.ts` の `orderChildren`。CLI の `request order` と API の `PUT /api/requests/:rid/child-order` が同じ操作を呼ぶ):
176
+ 直下の子の完全な ID の並びを受け、関係のロックの中で親と子の集合をディスクから読み直してから、重複・無い要望・直下でない子
177
+ (ほかの親の子・親なし)・足りない子を断る(`child_order_invalid`。今の並びを `children` で返す)。親の `rev` は楽観ロックで比べ
178
+ (`rev_conflict`)、通れば親の1ファイルの `childOrder` だけを書く。子・タスク・親子の所属は変えない。読んだ後に子が増えた・
179
+ 付け替えられたなら足りない・直下でないで断るので、集合の変化と `rev` の両方で競合を見つける。断るときは何も書かない
180
+ - 分割の採用(`core/preflight/service.ts` の `adopt`): 同じ run の子を案のキーの数の順(C1, C2, …, C10)に作り、1件作るごとに、
181
+ 作ったことを run.json に残す前に親の `childOrder` の末尾に足す。足すときは今の並び(保存した順と、そこに無い子の作成順)を前に
182
+ そのまま残すので、既存の兄弟と人が保存した順は変わらない。途中で落ちてやり直しても、並んでいる子は足さないので重ならず、逆にならない。
183
+ 前に採用した子は移さない(作成順のまま。本文や過去の run から順を推測しない)。案のキーの順は実行の依存を表さない
184
+ - 表示順は実行の順・着手できるかを表さない(自動の並べ替え・着手の禁止・前提の完了による制御はしない)。子の案の `requires` は
185
+ 子の本文の「他の子との前提と契約」に残る前提で、並びが前でも満たされているとは限らない。画面の「親子」と進捗にもそう書く
186
+
140
187
  ### Preflight の分割の案
141
188
 
142
189
  1つの run は **タスク案(`drafts/D*.md`)か子の案(`children/C*.md`)のどちらか** を出す。両方があれば読み込みで run の問題にし、
@@ -244,7 +291,9 @@ include: true
244
291
  既存のタスクとの重なりを出す。子の案の題・本文・採否を直せ、未保存や競合の間と、選んだ案が0件・実行中は採用しない。採用の確認で
245
292
  「親は残す・子だけ作る・子の Preflight はまだ」と示し、途中で失敗したら作った子へのリンクと残りの再開を出す
246
293
  - **親子の移動と進捗**: 詳細の見出しに祖先へのリンク(`routes/requests/$requestId.tsx`)、概要の「親子」(`components/request/Family.tsx`)に
247
- 親の指定・付け替え・外す、子の一覧(状態・自分のタスクの数)、自分と配下の集計、完了できない理由(サーバの `completion`)・見送りの除外・
294
+ 親の指定・付け替え・外す、子の一覧(状態・自分のタスクの数。表示順の「上へ」「下へ」「順序を保存」「取消」。保存するまでは下書きで、
295
+ 失敗・競合でも並べた順を残し、読み直した子に合わせて下書きに無い子を後ろに足す。動かした子の操作にフォーカスを戻し、移した位置を
296
+ role="status" で知らせる)、自分と配下の集計、完了できない理由(サーバの `completion`)・見送りの除外・
248
297
  完了済の祖先・親子の問題。進捗は親子の木(`web/lib/progressTree.ts`)で、親を畳める。絞り込みで条件に合う子の祖先は文脈として出すが、
249
298
  件数には数えない。循環・孤児は根に出して止まる。完了を断られたら、サーバの理由(対象の子と次の操作)をそのまま出す。要望の画面には
250
299
  アーカイブの操作は無い(CLI の `request archive` が親子を断る)
@@ -481,6 +530,14 @@ include: true
481
530
  `web/lib/copy.ts` の `copyText`(ボタンは枠つきでコピーのアイコンと文字。成功したらアイコンをチェックにする): Clipboard API が無ければ unavailable、拒まれたら denied(例外は外へ出さない)、書き込みが
482
531
  終わってから copied。知らせは role="status" で、どの ID の結果かを持ち、別の要望の結果は出さない。ボタンは mousedown で
483
532
  フォーカスを奪わないので、入力中のタイトルを保存させない。ID は select-all で、コピーできないときは手で選ぶ
533
+ - 縦のスクロールの担当: 画面全体は `h-screen` で、文書(ページ全体)は縦に送らない。送るのは共通の `main`(`routes/__root.tsx`)で、
534
+ 要望の画面では `main` も送らず、見出し(祖先へのリンク・要望 ID とコピー・タイトル)とタブの下の本文(RequestFrame の
535
+ `request-content`)だけが送る。スクロールする枠は `relative` にする: 基準の無い絶対配置(`sr-only` の入力・legend など)は画面の左上を
536
+ 基準にして枠の中の位置まで文書を伸ばし、本文とページの2つの縦スクロールを出す(ファイルを選ぶボタン `FilePicker` は隠した入力の
537
+ 基準をラベルにする)。局所スクロールの例外は、実行ログ・入力欄・タスクの詳細・案の詳細・新しいタスクの欄・タスクボードの列・
538
+ 進捗のスケジュールで、それぞれ自分の高さの中で送る。横に送るナビゲーション(要望のタブ・設定と
539
+ リリースノートのタブ `components/Tabs.tsx`・上のナビゲーション)は `overflow-x-auto` で縦も auto になるので、中身を縦にはみ出させない
540
+ (タブの下線を境界線に重ねる `-mb-px` はタブではなく横に送る枠に付け、境界線はその外の枠に付ける)
484
541
  - 進捗の画面の絞り込み(`web/lib/requestFilter.ts`): 未完了(既定)は下書き・Preflight・レビュー済・進行中で、対応済は
485
542
  含めない(リリース前のものは対応済のまましばらく残るため)。確認待ちは対応済だけ、完了・見送りは完了済・見送りだけ、
486
543
  すべては7つとも。左の一覧とスケジュールは同じ行(`filterRequests`)から描く。CLI の `progress` は今までどおり既定でも
@@ -569,7 +626,7 @@ src は5つの層に分け、依存の向きを `test/layers.test.ts` で確か
569
626
  | --- | --- |
570
627
  | 要望・タスクの変更の手順(確かめる → 保存 → ブランチの割り当て・進行中に戻す → 変更通知) | `core/requestOps.ts`(CLI の各コマンドと API はここを呼ぶだけ) |
571
628
  | Preflight(開始・評価対象の固定・タスク化) | `core/preflight/service.ts`(`PreflightService`) |
572
- | 要望の親子(親にできるもの・関係の操作のロック・アーカイブの拒否・親子の問題) | `core/hierarchy.ts`(判定は `shared/hierarchy.ts`) |
629
+ | 要望の親子(親にできるもの・関係の操作のロック・アーカイブの拒否・親子の問題・子の表示順の保存の検証) | `core/hierarchy.ts`(判定と兄弟の並び `orderSiblings` は `shared/hierarchy.ts`) |
573
630
  | Preflight の分割(子の案の検証・子の本文・案の版・採用) | `core/preflight/split.ts`・`core/preflight/service.ts` の `adopt` |
574
631
  | 個々の規則(対応済・置き換え・作業先とブランチ・評価対象の比べ方) | `core/requestStatus.ts`・`core/supersede.ts`・`core/workTargets.ts`・`shared/preflightInput.ts` |
575
632
  | サーバと画面の両方で使う判定・表示名 | `shared/` |
@@ -866,7 +923,7 @@ Playwright が入っても、それだけでは描画の安全の条件(ネッ
866
923
  - 着手するときは `p3 move T003 doing`。テストを通したら、コミットする前に `p3 move T003 done --output <今ある成果物(変えたファイルや説明)> --record -` で完了にする(変更の記録は必須: 何を変えたか・なぜ・入れた決まり・やめたもの を標準入力から Markdown で。まだ無い URL は書かない)
867
924
  - 要望のタスクを全部終えたら、コミットする前に `p3 request set <要望ID> status=resolved`(対応済)にする。完了済(done)・見送り(rejected)とタスクの済み(check)は人が決める
868
925
  - 子の要望(`parent` のある要望)は、親とは別の要望として子ごとのタスクとブランチで作業する(親のタスクにしない)。分割の案の採用(`accept`)と子の Preflight は人が行う。親を対応済にするのは、親のタスクと見送り以外の子(`request show <親> --brief --json` の `children`)が全部終わってから
869
- - データのフォルダがこの作業ツリーの中で git 管理されているなら、要望のフォルダ(`requests/<要望ID>/`)の変更も実装と同じコミットに入れる(ほかの要望・関係ない変更は入れない。外・無視・worktree のときは入らないので、移動や `git add -f` はしない)。push に失敗したら完了の記録は残し、公開できていないことを伝える
926
+ - データのフォルダがこの作業ツリーの中で git 管理されているなら、要望のフォルダ(`requests/<要望ID>/`)の変更も実装と同じコミットに入れる(後のレビューで要望とやったことを精査するため。子なら祖先の要望のフォルダ、親を対応済にするときは子孫の要望のフォルダ(見送りの子など)のまだ入っていない変更も入れ、ほかの要望・関係ない変更は入れない。外・無視・worktree のときは入らないので、移動や `git add -f` はしない)。push に失敗したら完了の記録は残し、公開できていないことを伝える。要望のフォルダは、マージするまで要望のブランチにしか無い。既定のブランチに切り替えると、その要望(子なら親の子の一覧からも)が消えたように見えるが、データはブランチにある(作り直したり、別のブランチから写したりしない)
870
927
  - コミットや PR の URL は後から `p3 move T003 done --output <URL>` で足す(完了・記録はそのまま。データをコミットしているなら追記もコミットして push)。複数のリポジトリにまたがるときは最後のタスクに `--repo-output <参照先>=<PR の URL>` で全部の PR を残す
871
928
  - 置き換えられたタスク(`p3 ls` の `※置換`、`--json` の `superseded`)からは始めない。`move` が `warnings` を返したら止めて人に確かめる
872
929
  - 作業中に新しく必要になった作業は `p3 new "<タイトル>" --body "..."` でタスクにする(人への質問はタスクにしない)
@@ -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
  日本語のフォントで測る(無い環境では既定のフォントのまま測り、そのことを出す。飛ばしはしない)
@@ -223,7 +229,7 @@ P3_CODEX_PATH_MAP=/workspaces=/home/me/workspaces pnpm verify:pack --docker --re
223
229
  `--pull` を付けて今のベースを取る(`scripts/verify-docker.mjs` も付ける。`--no-build` は作らずに既にあるイメージを確かめる)。
224
230
  Docker の CLI と pnpm は版を固定し、メジャー版を上げるのは別の変更として行う。作り直しても、公開済みのイメージと起動中の
225
231
  コンテナは変わらない(push し、使う側が pull して起動し直す)。
226
- 公開(人が行う)は [publishing.md](publishing.md#6-docker-hubtamutop3) の手順で、CI は使わない。使い方は [導入ガイド](installation.md#docker-で動かすプロジェクトを跨ぐ-serve)。
232
+ 公開(人が行う)は [publishing.md](publishing.md#6-docker-hubtamutop3) の手順で、`linux/amd64` だけを作り、CI は使わない。使い方は [導入ガイド](installation.md#docker-で動かすプロジェクトを跨ぐ-serve)。
227
233
 
228
234
  ```bash
229
235
  docker build --pull -t tamuto/p3:dev .
@@ -138,7 +138,13 @@ git add .p3/requests/261009-k7m3x && git commit -m "成果物の URL" && git pus
138
138
 
139
139
  - **完了を記録してからコミットする**: テストを通したら、コミットの前に完了(と最後なら対応済)を保存する。データのフォルダが
140
140
  リポジトリの中にあって git で管理していれば、要望とタスク・変更の記録が実装と同じコミットに入り、PR / MR を見る人は
141
- 「何を頼まれ、何をしたか」をコードと一緒に読める。入れるのはその要望のフォルダだけ(ほかの要望の変更は入れない)
141
+ 「何を頼まれ、何をしたか」をコードと一緒に読める(後の AI のレビューでも、コードだけでなく目的とやったことを精査できる)
142
+ - 親子でつながる要望のフォルダも、まだ入っていない変更があれば入れる。子の要望のコミットには祖先の要望のフォルダ(分割の採用・
143
+ 子の順・状態は親に残る)、親を対応済にするコミットには子孫の要望のフォルダ(見送りにした子など、実装の無い要望)。
144
+ それ以外の要望の変更は入れない
145
+ - 要望のフォルダは、マージするまで要望のブランチにしか無い。既定のブランチに切り替えると、その要望は一覧・進捗・親の子の一覧の
146
+ どこにも出なくなる(作業ツリーから消える。データはブランチにある)。分割で作った子なら、親の詳細と `show` に「分割で作った子が
147
+ 見つかりません」(`hierarchyIssues` の `child_missing`)が出る。マージするか、そのブランチに切り替えれば戻る
142
148
  - 成果物は、完了にする時点で今あるもの(変えたファイル・ドキュメントのパス・短い説明)。まだ無い URL や仮の SHA は書かない。
143
149
  コミット・PR / MR の URL は push してから `move … done --output <URL>` で足す(完了・記録・前の成果物・完了の日時は変わらず、
144
150
  要望も進行中に戻らない)。この追記は次のコミットに入れる(追記のコミット自身の URL は要らない)
@@ -389,8 +395,9 @@ Preflight は始めたときの内容を固定して評価する。**評価の
389
395
 
390
396
  ```bash
391
397
  p3 request new "通知の Lambda を作る" --parent k7m3x # 子を作る。省いた期限・マイルストーン・タグは親から写す(後は別々)
392
- p3 request ls --parent k7m3x # 直下の子
393
- p3 request show k7m3x --brief --json # parent・ancestors(根から順)・children(タスクの数つき)・hierarchyIssues
398
+ p3 request ls --parent k7m3x # 直下の子(表示順)
399
+ p3 request show k7m3x --brief --json # parent・ancestors(根から順)・children(表示順・タスクの数つき)・hierarchyIssues
400
+ p3 request order k7m3x q2w8e a1b2c # 子の表示順を保存する(直下の子を全部、上から順に)。子を省くと今の並び
394
401
  p3 request set q2w8e parent=a1b2c # 付け替え。parent= で外す
395
402
  ```
396
403
 
@@ -398,6 +405,15 @@ p3 request set q2w8e parent=a1b2c # 付け替え。parent=
398
405
  ほかの操作と重なったときは終了コード 3(API は 409 `hierarchy_busy`)で、そのままやり直してよい
399
406
  - 子のある要望・親のある要望はアーカイブできない。子の親を外してから(`parent=`)アーカイブする
400
407
  - `request.md` を直接編集して循環・無い親になったときは、`show` と画面の詳細に知らせ(`hierarchyIssues`)が出る。`parent` を直す
408
+ - **子の表示順**: 子は親の保存した表示順(親の `request.md` の `childOrder`)で並び、後ろの子を更新しても兄弟の位置は変わらない。
409
+ 保存した順に無い子(新しい子・付け替えて来た子・今までの親の子)は作成順で後ろに付く。概要・進捗・`show`・`request ls --parent`・
410
+ API で同じ順(規則と例は [architecture](architecture.md#子の表示順))
411
+ - 保存は直下の子を全部並べる。同じ子が2回・無い要望は終了コード 1、直下でない子・足りない子(読んだ後に子が増えた・付け替えられた)
412
+ と `--rev` の違いは終了コード 3(API は 409 `child_order_invalid`・`rev_conflict`)で、何も書かない。読み直して並べ直す
413
+ - 外した子・付け替えた子は並びから消える(親のファイルは書き換えない)。同じ親に戻すと前の位置に戻るので、末尾にしたいなら
414
+ 並べ直して保存する。分割の採用で作った子は、既存の子の後ろに C1, C2, … の順で足される
415
+ - 表示順は実行の順・着手できるかを表さない。子の前提(子の案の `requires`)は子の本文の「他の子との前提と契約」に残るので、
416
+ 着手の前に子の本文で確かめる(並びが前でも前提が済んでいるとは限らない)
401
417
  - **分割の案**: 想定のタスクが 6 件以上か、独立したインフラ・運用・リリースの境界があると、Preflight は分けるか・分けないかと
402
418
  その理由を評価に書き(`p3 drafts` の「分割」)、分けるならタスク案の代わりに子の要望の案(`children/C1.md`。目的・範囲・範囲外・
403
419
  完了条件・分割の理由・他の子との前提・出典、想定のタスクの数、親の既存のタスクとの重なり)を出す。分けさせたくない・分けたいときは
@@ -422,8 +438,9 @@ p3 request set q2w8e parent=a1b2c # 付け替え。parent=
422
438
  できる。自分のタスクが無く子だけの親もよい。子が全部見送りで自分のタスクも無い親はできない。自動では対応済・完了済にしない
423
439
  - 子にタスクを足した・完了から戻した・子を進行中に戻した・対応済の親に未完了の子を足したときは、対応済の祖先が進行中に戻る
424
440
  (`reopenedAncestors`)。完了済の祖先は変えずに警告(`ancestor_done`)が出るので、再開するなら `request set <親> status=active`
425
- - 画面: 要望の概要の「親子」で親を選ぶ・付け替える・外す(「親を保存」。失敗しても選んだ親は残る)。子の一覧(状態・自分のタスクの数・
426
- ボードへ)、この要望自身と配下全体のタスクの数、対応済にできない理由、見送りで対象外の子、完了済の祖先・親子の問題の知らせを出す。
441
+ - 画面: 要望の概要の「親子」で親を選ぶ・付け替える・外す(「親を保存」。失敗しても選んだ親は残る)。子の一覧(表示順・状態・
442
+ 自分のタスクの数・ボードへ)と、各子の「上へ」「下へ」で並べて「順序を保存」(保存するまでは下書きで、「取消」で戻す。保存に失敗しても
443
+ 並べた順は残る。キーボードでも操作できる)、この要望自身と配下全体のタスクの数、対応済にできない理由、見送りで対象外の子、完了済の祖先・親子の問題の知らせを出す。
427
444
  新しい要望の画面でも親を選べる。子の画面の見出しには祖先へのリンク(根から順)
428
445
  - `p3 progress` は子のある要望に配下の集計(`[配下 完了/全部・子 n]`)を添える。マイルストーンの合計は各要望の自分のタスクだけを足す
429
446
  - リリースノート: 子だけの親は「構造の要望」として収録の判定に入り(材料は無い)、材料は各要望の自分の変更の記録だけ。子が別の
@@ -558,7 +575,7 @@ p3 render 画面.html --width 1280 # 画面.png ができる(幅 32
558
575
 
559
576
  | URL | 画面 |
560
577
  | --- | --- |
561
- | `/` | 進捗。左に要望、右にスケジュール。`?show=` で 未完了(既定)/ `resolved`(確認待ち)/ `closed`(完了済・見送り)/ `all`。`?tags=`。子の要望は親の下に字下げして並べ(▾ で畳む)、絞り込みに子だけが合うと親を「文脈」として出す(件数に数えない)。子のある親には `配下 完了/全部` |
578
+ | `/` | 進捗。左に要望、右にスケジュール。`?show=` で 未完了(既定)/ `resolved`(確認待ち)/ `closed`(完了済・見送り)/ `all`。`?tags=`。子の要望は親の下に字下げして、親の保存した表示順に並べ(▾ で畳む。根は更新の新しい順)、絞り込みに子だけが合うと親を「文脈」として出す。見出しの件数は絞り込みに合う要望の数で、文脈の親は数えない。子のある親には `配下 完了/全部` |
562
579
  | `/requests/new` | 新しい要望(添付も) |
563
580
  | `/requests/<要望>` | 要望の概要(タイトル・本文・期限・マイルストーン・タグ・親子・添付)と Preflight(`?run=PF-...` で過去の評価)。子の要望は見出しの上に祖先へのリンク |
564
581
  | `/requests/<要望>/board` | タスクボード(V 字。ドラッグで列を移動。完了のカードの「✓ 済み」でボードから外す。「+ タスクを追加」で直接作る) |
@@ -38,6 +38,8 @@ P3 を Docker のコンテナで動かす(プロジェクトを跨ぐ serve
38
38
  - Codex をこのマシンに入れる必要はない(コンテナのイメージに入れる)。画面はビルド済みのものが入っているので、ビルドも要らない
39
39
  - P3 そのものを開発するときは Node 24 を使う([開発ガイド](development.md))。使うだけなら 22 以上でよい
40
40
  - 以下の例では `p3` と書く。入れていなければ `pnpx @infodb/p3`(または `npx @infodb/p3`)に読み替える
41
+ - 同じデータを使う人と AI は、なるべく同じ版で動かす(`pnpx @infodb/p3@<版>` のように版を付けられる。`pnpx` は取った版をしばらく
42
+ 使い続ける)。古い版で更新すると、新しい版で足した項目が消えることがある([データの形](architecture.md#データの形))
41
43
 
42
44
  ## 2. 動かす場所
43
45
 
@@ -302,11 +304,12 @@ P3 をイメージにして、コンテナで動かすこともできる。イ
302
304
  要望・タスクの作成と編集・添付・Preflight もいつもどおり使える。
303
305
 
304
306
  イメージは Docker Hub の **`tamuto/p3`**。中に p3 本体(npm の `@infodb/p3` と同じ版・同じ中身)と、Node 22・git・Docker の CLI が
305
- 入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.5.0` など)と
306
- `latest` がある。決まった版で使うなら版のタグを指す。
307
+ 入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.7.0` など)と
308
+ `latest` がある。決まった版で使うなら版のタグを指す。対応する platform は `linux/amd64` だけ(arm64 は確かめるマシンが無いので
309
+ 作っていない)。
307
310
 
308
311
  ```bash
309
- docker pull tamuto/p3:0.5.0
312
+ docker pull tamuto/p3:0.7.0
310
313
  ```
311
314
 
312
315
  リポジトリから作るときは `docker build --pull -t tamuto/p3:dev .`(`--pull` で今の Node のベースを取る。[開発ガイド](development.md#docker-のイメージ))。
@@ -327,7 +330,7 @@ root で動く開発コンテナ(DevContainer など)で p3 の CLI を使
327
330
  # 開発コンテナの compose に足す例(パスは開発コンテナのマウントに合わせる)
328
331
  services:
329
332
  p3:
330
- image: tamuto/p3:0.5.0
333
+ image: tamuto/p3:0.7.0
331
334
  restart: unless-stopped
332
335
  ports:
333
336
  - "127.0.0.1:4310:4310"
@@ -351,7 +354,7 @@ docker run -d --name p3 --restart unless-stopped \
351
354
  -v ~/.config/infodb-p3:/root/.config/infodb-p3 \
352
355
  -v /home/me/work:/home/me/work \
353
356
  -v /var/run/docker.sock:/var/run/docker.sock \
354
- tamuto/p3:0.5.0
357
+ tamuto/p3:0.7.0
355
358
 
356
359
  # 登録が無ければ、コンテナの中で登録する(既にあるデータに参加する。新しく作るなら p3 init)
357
360
  docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
@@ -364,7 +367,7 @@ docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
364
367
  ### どちらでも
365
368
 
366
369
  - 待ち受けは `127.0.0.1` に公開する。ブラウザで http://localhost:4310 を開く。登録が1つならそのプロジェクトが開き、複数なら一覧から選ぶ
367
- - **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.5.0 serve --project myapp --host 0.0.0.0`。compose なら
370
+ - **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.7.0 serve --project myapp --host 0.0.0.0`。compose なら
368
371
  `command:`)。明示しない限り、コンテナの中かどうかで自動では切り替えない
369
372
  - **止める**: `docker stop p3`(SIGTERM。実行中の Preflight・生成を取り消して記録してから止まる。10 秒まで待つ)
370
373
  - **新しい版にする**: 版のタグを変えて作り直す(個人設定と接続はマウントした ~/.config、データはホストに残る)。
@@ -67,15 +67,14 @@ push する(公開済みのイメージ・起動中のコンテナは自動で
67
67
  `P3_CODEX_PATH_MAP`。[development.md](development.md#docker-のイメージ))
68
68
  - [ ] ソケットを渡したコンテナ(root)で Codex のイメージを作れる: `docker run --rm -v /var/run/docker.sock:/var/run/docker.sock tamuto/p3:<版> codex update`
69
69
  - [ ] 本物の Codex(ChatGPT の接続・ソケット)で、コンテナから Preflight が終わる(接続できる環境で手で確かめる)
70
- - [ ] amd64 と arm64 の両方を作る(Mac の Apple シリコンなど)。arm64 を作れない環境では、QEMU(binfmt)を入れたマシンか
71
- arm64 のマシンで作る
70
+ - [ ] 作るのは `linux/amd64` だけ。arm64 は確かめるマシンが無いので作らない(対応していない)
72
71
 
73
72
  ```bash
74
73
  V=$(node -p "require('./package.json').version")
75
74
  docker login # tamuto に push できるアカウント
76
- docker buildx build --pull --platform linux/amd64,linux/arm64 --build-arg P3_VERSION=$V \
75
+ docker buildx build --pull --platform linux/amd64 --build-arg P3_VERSION=$V \
77
76
  -t tamuto/p3:$V -t tamuto/p3:latest --push .
78
- docker buildx imagetools inspect tamuto/p3:$V # 両方の platform があるか
77
+ docker buildx imagetools inspect tamuto/p3:$V # 動かす platform が linux/amd64 だけか(unknown/unknown は来歴の記録で、動かす対象ではない)
79
78
  ```
80
79
 
81
80
  公開した後に、別の環境で `docker run --rm tamuto/p3:<版> --help` と、[導入ガイド](installation.md#docker-で動かすプロジェクトを跨ぐ-serve)
package/lib/cli/help.js CHANGED
@@ -54,7 +54,7 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
54
54
  request new <タイトル> --body 本文|- --area パス --due YYYY-MM-DD --milestone id --tag 値(外部 ID・分類。繰り返し可)
55
55
  --attach ファイル(PNG / JPEG / xlsx。繰り返し可。作る前に全部確かめ、だめなら要望を作らない)
56
56
  --parent <要望> 子の要望にする(省いた期限・マイルストーン・タグは親から写す)
57
- request ls 一覧(--status draft,active ... --milestone id --tag 値。繰り返すとどれか。--parent <要望> で直下の子)
57
+ request ls 一覧(--status draft,active ... --milestone id --tag 値。繰り返すとどれか。--parent <要望> で直下の子を表示順に)
58
58
  request show [<要望>] --brief 作業に要る項目だけ(本文・状態・ブランチ・タスクの一覧・親子)
59
59
  request set [<要望>] キー=値 title status due milestone tags areas parent(status: ${REQUEST_STATUSES.join(" ")}。parent= で親を外す)
60
60
  --body 本文|- 本文を書き換える(- は標準入力。どの状態でも書き換えられる。--rev で楽観ロック)
@@ -62,6 +62,8 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
62
62
  p3 request set <要望> --body - --rev 3 < body.md
63
63
  評価のあとでタイトル・本文を変えると、その評価からはタスク化できない(もう一度 preflight)
64
64
  --tag 値 ... タグをこの値の並びに置き換える(カンマで分けない。tags=a,b はカンマで分ける)
65
+ request order <親> [<子>...] 直下の子の表示順を保存する(子を全部、上から順に。--rev で楽観ロック)。子を省くと今の並びを出す
66
+ 表示の順だけで、実行の順・着手できるかは表さない(前提は子の本文で確かめる)
65
67
  request archive <要望> 子のある要望・親のある要望はできない(先に親を外す)
66
68
 
67
69
  タスク(今の要望の中。--req <要望> で指定、要望の作業ツリーの中なら省略可)
package/lib/cli/main.js CHANGED
@@ -312,10 +312,11 @@ main(process.argv.slice(2)).then((code) => process.exit(code), (e) => {
312
312
  process.stderr.write(`${e.message}\n`);
313
313
  process.exit(1);
314
314
  }
315
- // 要望の親子: ロックを取れない → 3(そのままやり直せる)、規則に合わない → 1
315
+ // 要望の親子: ロックを取れない・子の表示順を読んだ後に子の集合が変わった → 3(読み直してやり直す)、規則に合わない → 1
316
316
  if (e instanceof HierarchyError) {
317
317
  process.stderr.write(`${e.message}\n`);
318
- process.exit(e.code === "hierarchy_busy" ? 3 : 1);
318
+ const changedSet = e.code === "child_order_invalid" && (e.detail.reason === "not_child" || e.detail.reason === "missing");
319
+ process.exit(e.code === "hierarchy_busy" || changedSet ? 3 : 1);
319
320
  }
320
321
  if (e instanceof NotFoundError) {
321
322
  process.stderr.write(`見つかりません: ${e.id}\n`);
@@ -140,7 +140,7 @@ export function agentsSnippet(kinds) {
140
140
  - 着手するときは \`p3 move T003 doing\`。テストを通したら、コミットする前に \`p3 move T003 done --output <今ある成果物(変えたファイルや説明)> --record -\` で完了にする(変更の記録は必須: 何を変えたか・なぜ・入れた決まり・やめたもの を標準入力から Markdown で。まだ無い URL は書かない)
141
141
  - 要望のタスクを全部終えたら、コミットする前に \`p3 request set <要望ID> status=resolved\`(対応済)にする。完了済(done)・見送り(rejected)とタスクの済み(check)は人が決める
142
142
  - 子の要望(\`parent\` のある要望)は、親とは別の要望として子ごとのタスクとブランチで作業する(親のタスクにしない)。分割の案の採用(\`accept\`)と子の Preflight は人が行う。親を対応済にするのは、親のタスクと見送り以外の子(\`request show <親> --brief --json\` の \`children\`)が全部終わってから
143
- - データのフォルダがこの作業ツリーの中で git 管理されているなら、要望のフォルダ(\`requests/<要望ID>/\`)の変更も実装と同じコミットに入れる(ほかの要望・関係ない変更は入れない。外・無視・worktree のときは入らないので、移動や \`git add -f\` はしない)。push に失敗したら完了の記録は残し、公開できていないことを伝える
143
+ - データのフォルダがこの作業ツリーの中で git 管理されているなら、要望のフォルダ(\`requests/<要望ID>/\`)の変更も実装と同じコミットに入れる(後のレビューで要望とやったことを精査するため。子なら祖先の要望のフォルダ、親を対応済にするときは子孫の要望のフォルダ(見送りの子など)のまだ入っていない変更も入れ、ほかの要望・関係ない変更は入れない。外・無視・worktree のときは入らないので、移動や \`git add -f\` はしない)。push に失敗したら完了の記録は残し、公開できていないことを伝える。要望のフォルダは、マージするまで要望のブランチにしか無い。既定のブランチに切り替えると、その要望(子なら親の子の一覧からも)が消えたように見えるが、データはブランチにある(作り直したり、別のブランチから写したりしない)
144
144
  - コミットや PR の URL は後から \`p3 move T003 done --output <URL>\` で足す(完了・記録はそのまま。データをコミットしているなら追記もコミットして push)。複数のリポジトリにまたがるときは最後のタスクに \`--repo-output <参照先>=<PR の URL>\` で全部の PR を残す
145
145
  - 置き換えられたタスク(\`p3 ls\` の \`※置換\`、\`--json\` の \`superseded\`)からは始めない。\`move\` が \`warnings\` を返したら止めて人に確かめる
146
146
  - 作業中に新しく必要になった作業は \`p3 new "<タイトル>" --body "..."\` でタスクにする(人への質問はタスクにしない)
@@ -1,8 +1,8 @@
1
1
  import { basename, relative } from "node:path";
2
2
  import { REQUEST_STATUSES } from "../shared/types.js";
3
3
  import {} from "../core/context.js";
4
- import { archiveRequest, checkMilestone, checkMilestoneRemoval, createRequest, updateRequest } from "../core/requestOps.js";
5
- import { resolvedIssue } from "../core/requestStatus.js";
4
+ import { archiveRequest, checkMilestone, checkMilestoneRemoval, createRequest, orderChildren, updateRequest } from "../core/requestOps.js";
5
+ import { hierarchyNow, resolvedIssue } from "../core/requestStatus.js";
6
6
  import { hierarchyView } from "../core/hierarchy.js";
7
7
  import { resolveRequestId } from "../core/ops.js";
8
8
  import { table } from "./format.js";
@@ -55,13 +55,12 @@ export async function requestCommand(ctx, out, args, o, actor, requestArg, expec
55
55
  case "ls":
56
56
  case "list": {
57
57
  const status = o.status?.split(",");
58
- const reqs = ctx.ws.requests
59
- .list()
58
+ // --parent: 直下の子だけを、親の表示順(子の一覧・詳細・画面と同じ)で
59
+ const parent = o.parent === undefined ? undefined : parentArg(o.parent);
60
+ const reqs = (parent === undefined ? ctx.ws.requests.list() : hierarchyNow(ctx.ws).children(parent))
60
61
  .filter((r) => !status || status.includes(r.status))
61
62
  .filter((r) => !o.milestone || r.milestone === o.milestone)
62
- .filter((r) => !o.tag?.length || o.tag.some((t) => r.tags.includes(t)))
63
- // --parent: 直下の子だけ
64
- .filter((r) => o.parent === undefined || r.parent === parentArg(o.parent));
63
+ .filter((r) => !o.tag?.length || o.tag.some((t) => r.tags.includes(t)));
65
64
  return out.result(reqs, () => table(reqs.map((r) => [r.id, r.status, r.title, r.milestone ?? "", r.due ?? "", r.tags.map((t) => `#${t}`).join(" "), r.parent ? `↑${r.parent}` : ""])) || "要望はありません");
66
65
  }
67
66
  case "show": {
@@ -133,13 +132,25 @@ export async function requestCommand(ctx, out, args, o, actor, requestArg, expec
133
132
  reopenedNote(undefined, next.reopenedAncestors);
134
133
  return out.result(next, () => `更新: ${next.id} (rev ${next.rev}) ${Object.keys(patch).join(", ")}`);
135
134
  }
135
+ case "order": {
136
+ // p3 request order <親> <子...>: 直下の子の表示順を保存する(全部の子を並べる)。子を省くと今の並びを出す
137
+ const [head, ...kids] = rest;
138
+ const rid = requestArg(head);
139
+ if (!kids.length) {
140
+ const now = hierarchyNow(ctx.ws).children(rid);
141
+ return out.result({ id: rid, children: now.map((c) => c.id) }, () => (now.length ? now.map((c, i) => `${i + 1}. ${c.id} ${c.title}`).join("\n") : `${rid} には子の要望がありません`));
142
+ }
143
+ const r = await orderChildren(ctx, rid, kids.map((k) => resolveRequestId(ctx, k) ?? k), { expectedRev, actor });
144
+ const now = hierarchyNow(ctx.ws).children(rid);
145
+ return out.result({ id: r.id, rev: r.rev, children: now.map((c) => c.id) }, () => [`子の表示順を保存しました: ${r.id} (rev ${r.rev})`, ...now.map((c, i) => ` ${i + 1}. ${c.id} ${c.title}`)].join("\n"));
146
+ }
136
147
  case "archive": {
137
148
  const rid = requestArg(rest[0]);
138
149
  await archiveRequest(ctx, rid);
139
150
  return out.result({ archived: rid }, () => `アーカイブ: ${rid}(requests/.archive/ へ)`);
140
151
  }
141
152
  default:
142
- throw new UsageError("p3 request [new | ls | show | set | archive]");
153
+ throw new UsageError("p3 request [new | ls | show | set | order | archive]");
143
154
  }
144
155
  }
145
156
  // --- マイルストーン -----------------------------------------------------------
@@ -73,7 +73,7 @@ export function formatFamily(f) {
73
73
  return [
74
74
  ...(f.ancestors.length ? [` 親 ${f.ancestors.map((a) => `${a.id} ${a.title}`).join(" > ")}`] : []),
75
75
  ...(f.children.length
76
- ? ["", `子の要望 (${f.children.length}):`, table(f.children.map((c) => [` ${c.id}`, c.status, `${c.tasks.done}/${c.tasks.total}`, c.title]))]
76
+ ? ["", `子の要望 (${f.children.length}、表示順。実行の順ではない):`, table(f.children.map((c) => [` ${c.id}`, c.status, `${c.tasks.done}/${c.tasks.total}`, c.title]))]
77
77
  : []),
78
78
  ];
79
79
  }
@@ -100,6 +100,36 @@ export async function withParentChange(ws, rid, parent, fn) {
100
100
  return { result: await fn(), previous: cur.parent };
101
101
  });
102
102
  }
103
+ /**
104
+ * 子の表示順を保存する前に: ロックの中で要望を読み直し、ids が今の直下の子の完全な並び(重複・過不足なし)かを確かめてから
105
+ * fn(親の保存。rev の楽観ロックは fn の側)を呼ぶ。合わなければ HierarchyError(child_order_invalid。detail.children に今の子の並び)
106
+ */
107
+ export async function withChildOrder(ws, parent, ids, fn) {
108
+ return withHierarchyLock(ws, async () => {
109
+ const h = await fresh(ws);
110
+ ws.requests.require(parent);
111
+ const now = h.children(parent).map((c) => c.id);
112
+ const invalid = (reason, message, bad = []) => new HierarchyError("child_order_invalid", `${message}(何も変えていません)`, { reason, ids: bad, children: now });
113
+ if (!now.length)
114
+ throw invalid("no_children", `${parent} には子の要望がありません`);
115
+ const dup = ids.filter((id, i) => ids.indexOf(id) !== i);
116
+ if (dup.length)
117
+ throw invalid("duplicate", `同じ子が2回あります: ${[...new Set(dup)].join(", ")}`, [...new Set(dup)]);
118
+ const unknown = ids.filter((id) => !h.get(id));
119
+ if (unknown.length)
120
+ throw invalid("not_found", `要望がありません: ${unknown.join(", ")}`, unknown);
121
+ const others = ids.filter((id) => !now.includes(id));
122
+ if (others.length) {
123
+ const where = others.map((id) => `${id}(${h.get(id).parent ? `${h.get(id).parent} の子` : "親なし"})`).join(", ");
124
+ throw invalid("not_child", `${parent} の直下の子ではありません: ${where}。子が変わっていれば読み直してやり直してください`, others);
125
+ }
126
+ const missing = now.filter((id) => !ids.includes(id));
127
+ if (missing.length) {
128
+ throw invalid("missing", `直下の子を全部並べてください。足りない子: ${missing.join(", ")}(子が増えていれば読み直してやり直してください)`, missing);
129
+ }
130
+ return fn();
131
+ });
132
+ }
103
133
  /** アーカイブの前に: 子のある要望・親のある要望は断る(未完了の子を暗黙に外さない)。ロックの中で fn を呼ぶ */
104
134
  export async function withArchiveCheck(ws, rid, fn) {
105
135
  return withHierarchyLock(ws, async () => {
@@ -115,11 +145,31 @@ export async function withArchiveCheck(ws, rid, fn) {
115
145
  return fn();
116
146
  });
117
147
  }
148
+ /**
149
+ * 分割の採用(run.json の adoption)で作った子のうち、今の要望にもアーカイブにも無いもの。ファイルは変えず、parent も戻さない。
150
+ * 子のフォルダが要望のブランチにだけあって、既定のブランチに切り替えると作業ツリーから消えたときなど
151
+ */
152
+ async function missingSplitChildren(ws, rid, archived) {
153
+ const out = [];
154
+ for (const run of await ws.preflight.list(rid)) {
155
+ const a = run.adoption;
156
+ if (!a)
157
+ continue;
158
+ for (const key of a.created) {
159
+ const id = a.reserved[key];
160
+ if (!id || ws.requests.get(id) || ws.requests.errors.has(id) || archived.has(id))
161
+ continue;
162
+ out.push({ request: id, code: "child_missing", parent: rid, message: `分割で作った子 ${id}(${run.id} / ${key})が見つかりません(git のブランチを切り替えると、要望のブランチにだけある要望は作業ツリーから消えます)` });
163
+ }
164
+ }
165
+ return out;
166
+ }
118
167
  /** 詳細・show --brief に添える親子(子にはタスクの数を付ける) */
119
168
  export async function hierarchyView(ws, rid) {
120
169
  const v = (await hierarchyOf(ws)).view(rid);
121
170
  return {
122
171
  ...v,
172
+ hierarchyIssues: [...v.hierarchyIssues, ...(await missingSplitChildren(ws, rid, new Set(await archivedRequestIds(ws))))],
123
173
  children: v.children.map((c) => {
124
174
  const tasks = ws.tasksOf(c.id).list();
125
175
  return { ...c, tasks: { total: tasks.length, done: tasks.filter((t) => t.status === "done").length } };
@@ -562,7 +562,8 @@ export class PreflightService {
562
562
  const resuming = !!run.adoption;
563
563
  if (!resuming && opts.version !== undefined && opts.version !== childrenVersion(run.children))
564
564
  throw new ChildDraftsChangedError(runId);
565
- const keys = run.adoption?.keys ?? run.children.filter((c) => c.include).map((c) => c.key);
565
+ // 新しい採用は案のキーの数の順(C1, C2, C10)に作り、その順で親の表示順に足す。キーの順は実行の順を表さない
566
+ const keys = run.adoption?.keys ?? run.children.filter((c) => c.include).map((c) => c.key).sort((a, b) => a.localeCompare(b, undefined, { numeric: true }));
566
567
  if (!keys.length)
567
568
  throw new Error("採用した子の案がありません");
568
569
  // ID の予約(書く前に run.json に残す)
@@ -610,6 +611,8 @@ export class PreflightService {
610
611
  if (!made)
611
612
  throw new Error(`${id} を作れませんでした(既にあります)`);
612
613
  }
614
+ // 作ったことを残す前に親の表示順に足す(落ちてやり直しても、足してあれば重ねない)
615
+ await this.appendChildOrder(requestId, id, actor);
613
616
  state.created.push(key);
614
617
  await this.ws.preflight.save(run);
615
618
  this.ws.emit({ type: "changed", kind: "request", request: id });
@@ -638,6 +641,18 @@ export class PreflightService {
638
641
  return result;
639
642
  });
640
643
  }
644
+ /**
645
+ * 採用で作った子を親の表示順(childOrder)の末尾に足す。関係のロックの中で呼ぶ。今の並び(保存した順と、そこに無い子の作成順)を
646
+ * そのまま前に残すので、既存の兄弟・人が保存した順は変わらない。既に並んでいれば何もしない
647
+ */
648
+ async appendChildOrder(parentId, childId, actor) {
649
+ await this.ws.requests.reload(parentId);
650
+ const parent = this.ws.requests.require(parentId);
651
+ if (parent.childOrder?.includes(childId))
652
+ return;
653
+ const now = hierarchyNow(this.ws).children(parentId).map((c) => c.id).filter((id) => id !== childId);
654
+ await this.ws.requests.update(parentId, { childOrder: [...now, childId] }, { actor });
655
+ }
641
656
  /**
642
657
  * タスク化: 採用されたタスク案を、要望のフォルダの tasks/T00x.md として書き出し、関係を張る。
643
658
  * - 同じ run 内の dependsOn → depends_on(要望の中なので相対参照 T00x)
@@ -1,5 +1,5 @@
1
1
  import { defaultRepo } from "../shared/workTarget.js";
2
- import { withArchiveCheck, withNewChild, withParentChange } from "./hierarchy.js";
2
+ import { withArchiveCheck, withChildOrder, withNewChild, withParentChange } from "./hierarchy.js";
3
3
  import { checkStatusChange, reopenAncestors, reopenIfNeeded } from "./requestStatus.js";
4
4
  import { startWarnings } from "./supersede.js";
5
5
  import { checkRepoTarget, ensureWorkstreams } from "./workTargets.js";
@@ -147,6 +147,16 @@ export async function updateRequest(ctx, rid, patch, opts = {}) {
147
147
  changed(ctx, "request", p);
148
148
  return after(r);
149
149
  }
150
+ /**
151
+ * 子の表示順を保存する(親の request.md の childOrder だけを書く。子・タスク・親子の所属は変えない)。ids は今の直下の子の完全な並び。
152
+ * 子の集合が違えば child_order_invalid(hierarchy.ts)、expectedRev が親の rev と違えば ConflictError で、どちらも何も書かない。
153
+ * 表示の順で、実行の順・着手できるかは表さない
154
+ */
155
+ export async function orderChildren(ctx, rid, ids, opts = {}) {
156
+ const r = await withChildOrder(ctx.ws, rid, ids, () => ctx.ws.requests.update(rid, { childOrder: [...ids] }, opts));
157
+ changed(ctx, "request", r.id);
158
+ return r;
159
+ }
150
160
  /** 要望をアーカイブする(フォルダごと .archive/ へ)。子のある要望・親のある要望は断る(hierarchy.ts) */
151
161
  export async function archiveRequest(ctx, rid) {
152
162
  await withArchiveCheck(ctx.ws, rid, () => ctx.ws.requests.archive(rid));