@infodb/p3 0.5.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.
- package/README.md +1 -0
- package/dist/web/assets/{Outputs-C83ZDXvs.js → Outputs-CQi0oba1.js} +1 -1
- package/dist/web/assets/{RequestStatus-GmiWYEcL.js → RequestStatus-grC0F_SQ.js} +1 -1
- package/dist/web/assets/Tabs-BJRGzidj.js +1 -0
- package/dist/web/assets/{TagInput-CtM8HM8Z.js → TagInput-DkuISbfK.js} +1 -1
- package/dist/web/assets/{TaskDrawer-D5v36QoF.js → TaskDrawer-CysOMAjG.js} +1 -1
- package/dist/web/assets/{_requestId-DxwxbXY2.js → _requestId-BQCwOAbs.js} +2 -2
- package/dist/web/assets/{_requestId-BHUqLO-j.js → _requestId-DgSOUH78.js} +1 -1
- package/dist/web/assets/{appCtx-B-VRVOyv.js → appCtx-DCiGJFAe.js} +1 -1
- package/dist/web/assets/{board-DAaVR04x.js → board-BsntpZXP.js} +1 -1
- package/dist/web/assets/{done-CaqB_qTH.js → done-Bhxqy7bH.js} +1 -1
- package/dist/web/assets/{index-BQYvKpjF.js → index-BTuEPzgc.js} +3 -3
- package/dist/web/assets/{new-DLVnRvrB.js → new-BwknRX3V.js} +1 -1
- package/dist/web/assets/{preload-helper-B74h5i3O.js → preload-helper-B40dBmwL.js} +1 -1
- package/dist/web/assets/progressTree-DgrdDFih.js +1 -0
- package/dist/web/assets/{release-notes-MTLcOcvZ.js → release-notes-AgwbykyG.js} +1 -1
- package/dist/web/assets/{requestData-D-HXu-cy.js → requestData-w6fhCYmh.js} +1 -1
- package/dist/web/assets/{routes-CI4Qfkjs.js → routes-Bu3bhOaC.js} +1 -1
- package/dist/web/assets/{settings-CJMNgzi6.js → settings-BkV8KeQk.js} +1 -1
- package/dist/web/index.html +3 -3
- package/docs/architecture.md +56 -5
- package/docs/development.md +6 -0
- package/docs/how-to-use.md +16 -5
- package/docs/installation.md +5 -5
- package/lib/cli/help.js +3 -1
- package/lib/cli/main.js +3 -2
- package/lib/cli/requestCommands.js +19 -8
- package/lib/cli/showView.js +1 -1
- package/lib/core/hierarchy.js +30 -0
- package/lib/core/preflight/service.js +16 -1
- package/lib/core/requestOps.js +11 -1
- package/lib/core/store/normalize.js +3 -1
- package/lib/server/api/manifest.js +8 -1
- package/lib/server/api/routes.js +15 -3
- package/lib/shared/hierarchy.js +19 -4
- package/package.json +1 -1
- package/dist/web/assets/Tabs-CJn0Qy7W.js +0 -1
- package/dist/web/assets/progressTree-wp9mH4VF.js +0 -1
package/docs/development.md
CHANGED
|
@@ -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
|
日本語のフォントで測る(無い環境では既定のフォントのまま測り、そのことを出す。飛ばしはしない)
|
package/docs/how-to-use.md
CHANGED
|
@@ -389,8 +389,9 @@ Preflight は始めたときの内容を固定して評価する。**評価の
|
|
|
389
389
|
|
|
390
390
|
```bash
|
|
391
391
|
p3 request new "通知の Lambda を作る" --parent k7m3x # 子を作る。省いた期限・マイルストーン・タグは親から写す(後は別々)
|
|
392
|
-
p3 request ls --parent k7m3x #
|
|
393
|
-
p3 request show k7m3x --brief --json # parent・ancestors(根から順)・children
|
|
392
|
+
p3 request ls --parent k7m3x # 直下の子(表示順)
|
|
393
|
+
p3 request show k7m3x --brief --json # parent・ancestors(根から順)・children(表示順・タスクの数つき)・hierarchyIssues
|
|
394
|
+
p3 request order k7m3x q2w8e a1b2c # 子の表示順を保存する(直下の子を全部、上から順に)。子を省くと今の並び
|
|
394
395
|
p3 request set q2w8e parent=a1b2c # 付け替え。parent= で外す
|
|
395
396
|
```
|
|
396
397
|
|
|
@@ -398,6 +399,15 @@ p3 request set q2w8e parent=a1b2c # 付け替え。parent=
|
|
|
398
399
|
ほかの操作と重なったときは終了コード 3(API は 409 `hierarchy_busy`)で、そのままやり直してよい
|
|
399
400
|
- 子のある要望・親のある要望はアーカイブできない。子の親を外してから(`parent=`)アーカイブする
|
|
400
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
|
+
着手の前に子の本文で確かめる(並びが前でも前提が済んでいるとは限らない)
|
|
401
411
|
- **分割の案**: 想定のタスクが 6 件以上か、独立したインフラ・運用・リリースの境界があると、Preflight は分けるか・分けないかと
|
|
402
412
|
その理由を評価に書き(`p3 drafts` の「分割」)、分けるならタスク案の代わりに子の要望の案(`children/C1.md`。目的・範囲・範囲外・
|
|
403
413
|
完了条件・分割の理由・他の子との前提・出典、想定のタスクの数、親の既存のタスクとの重なり)を出す。分けさせたくない・分けたいときは
|
|
@@ -422,8 +432,9 @@ p3 request set q2w8e parent=a1b2c # 付け替え。parent=
|
|
|
422
432
|
できる。自分のタスクが無く子だけの親もよい。子が全部見送りで自分のタスクも無い親はできない。自動では対応済・完了済にしない
|
|
423
433
|
- 子にタスクを足した・完了から戻した・子を進行中に戻した・対応済の親に未完了の子を足したときは、対応済の祖先が進行中に戻る
|
|
424
434
|
(`reopenedAncestors`)。完了済の祖先は変えずに警告(`ancestor_done`)が出るので、再開するなら `request set <親> status=active`
|
|
425
|
-
- 画面:
|
|
426
|
-
|
|
435
|
+
- 画面: 要望の概要の「親子」で親を選ぶ・付け替える・外す(「親を保存」。失敗しても選んだ親は残る)。子の一覧(表示順・状態・
|
|
436
|
+
自分のタスクの数・ボードへ)と、各子の「上へ」「下へ」で並べて「順序を保存」(保存するまでは下書きで、「取消」で戻す。保存に失敗しても
|
|
437
|
+
並べた順は残る。キーボードでも操作できる)、この要望自身と配下全体のタスクの数、対応済にできない理由、見送りで対象外の子、完了済の祖先・親子の問題の知らせを出す。
|
|
427
438
|
新しい要望の画面でも親を選べる。子の画面の見出しには祖先へのリンク(根から順)
|
|
428
439
|
- `p3 progress` は子のある要望に配下の集計(`[配下 完了/全部・子 n]`)を添える。マイルストーンの合計は各要望の自分のタスクだけを足す
|
|
429
440
|
- リリースノート: 子だけの親は「構造の要望」として収録の判定に入り(材料は無い)、材料は各要望の自分の変更の記録だけ。子が別の
|
|
@@ -558,7 +569,7 @@ p3 render 画面.html --width 1280 # 画面.png ができる(幅 32
|
|
|
558
569
|
|
|
559
570
|
| URL | 画面 |
|
|
560
571
|
| --- | --- |
|
|
561
|
-
| `/` | 進捗。左に要望、右にスケジュール。`?show=` で 未完了(既定)/ `resolved`(確認待ち)/ `closed`(完了済・見送り)/ `all`。`?tags
|
|
572
|
+
| `/` | 進捗。左に要望、右にスケジュール。`?show=` で 未完了(既定)/ `resolved`(確認待ち)/ `closed`(完了済・見送り)/ `all`。`?tags=`。子の要望は親の下に字下げして、親の保存した表示順に並べ(▾ で畳む。根は更新の新しい順)、絞り込みに子だけが合うと親を「文脈」として出す(件数に数えない)。子のある親には `配下 完了/全部` |
|
|
562
573
|
| `/requests/new` | 新しい要望(添付も) |
|
|
563
574
|
| `/requests/<要望>` | 要望の概要(タイトル・本文・期限・マイルストーン・タグ・親子・添付)と Preflight(`?run=PF-...` で過去の評価)。子の要望は見出しの上に祖先へのリンク |
|
|
564
575
|
| `/requests/<要望>/board` | タスクボード(V 字。ドラッグで列を移動。完了のカードの「✓ 済み」でボードから外す。「+ タスクを追加」で直接作る) |
|
package/docs/installation.md
CHANGED
|
@@ -302,11 +302,11 @@ 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.
|
|
305
|
+
入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.6.0` など)と
|
|
306
306
|
`latest` がある。決まった版で使うなら版のタグを指す。
|
|
307
307
|
|
|
308
308
|
```bash
|
|
309
|
-
docker pull tamuto/p3:0.
|
|
309
|
+
docker pull tamuto/p3:0.6.0
|
|
310
310
|
```
|
|
311
311
|
|
|
312
312
|
リポジトリから作るときは `docker build --pull -t tamuto/p3:dev .`(`--pull` で今の Node のベースを取る。[開発ガイド](development.md#docker-のイメージ))。
|
|
@@ -327,7 +327,7 @@ root で動く開発コンテナ(DevContainer など)で p3 の CLI を使
|
|
|
327
327
|
# 開発コンテナの compose に足す例(パスは開発コンテナのマウントに合わせる)
|
|
328
328
|
services:
|
|
329
329
|
p3:
|
|
330
|
-
image: tamuto/p3:0.
|
|
330
|
+
image: tamuto/p3:0.6.0
|
|
331
331
|
restart: unless-stopped
|
|
332
332
|
ports:
|
|
333
333
|
- "127.0.0.1:4310:4310"
|
|
@@ -351,7 +351,7 @@ docker run -d --name p3 --restart unless-stopped \
|
|
|
351
351
|
-v ~/.config/infodb-p3:/root/.config/infodb-p3 \
|
|
352
352
|
-v /home/me/work:/home/me/work \
|
|
353
353
|
-v /var/run/docker.sock:/var/run/docker.sock \
|
|
354
|
-
tamuto/p3:0.
|
|
354
|
+
tamuto/p3:0.6.0
|
|
355
355
|
|
|
356
356
|
# 登録が無ければ、コンテナの中で登録する(既にあるデータに参加する。新しく作るなら p3 init)
|
|
357
357
|
docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
|
|
@@ -364,7 +364,7 @@ docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
|
|
|
364
364
|
### どちらでも
|
|
365
365
|
|
|
366
366
|
- 待ち受けは `127.0.0.1` に公開する。ブラウザで http://localhost:4310 を開く。登録が1つならそのプロジェクトが開き、複数なら一覧から選ぶ
|
|
367
|
-
- **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.
|
|
367
|
+
- **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.6.0 serve --project myapp --host 0.0.0.0`。compose なら
|
|
368
368
|
`command:`)。明示しない限り、コンテナの中かどうかで自動では切り替えない
|
|
369
369
|
- **止める**: `docker stop p3`(SIGTERM。実行中の Preflight・生成を取り消して記録してから止まる。10 秒まで待つ)
|
|
370
370
|
- **新しい版にする**: 版のタグを変えて作り直す(個人設定と接続はマウントした ~/.config、データはホストに残る)。
|
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
|
-
// 要望の親子:
|
|
315
|
+
// 要望の親子: ロックを取れない・子の表示順を読んだ後に子の集合が変わった → 3(読み直してやり直す)、規則に合わない → 1
|
|
316
316
|
if (e instanceof HierarchyError) {
|
|
317
317
|
process.stderr.write(`${e.message}\n`);
|
|
318
|
-
|
|
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`);
|
|
@@ -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
|
-
|
|
59
|
-
|
|
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
|
// --- マイルストーン -----------------------------------------------------------
|
package/lib/cli/showView.js
CHANGED
|
@@ -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
|
}
|
package/lib/core/hierarchy.js
CHANGED
|
@@ -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 () => {
|
|
@@ -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
|
-
|
|
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)
|
package/lib/core/requestOps.js
CHANGED
|
@@ -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));
|
|
@@ -56,6 +56,8 @@ export function normalizeRequest(d, body, id) {
|
|
|
56
56
|
status: REQUEST_STATUSES.includes(status) ? status : "draft",
|
|
57
57
|
// 形の違う親もそのまま読む(直そうとせず、親子の問題として知らせる)
|
|
58
58
|
...(str(d.parent) ? { parent: str(d.parent) } : {}),
|
|
59
|
+
// 子の表示順は文字の並びとしてそのまま読む(重複・今は子でない ID は並べるときに除く。ファイルは書き換えない)
|
|
60
|
+
...(Array.isArray(d.childOrder) ? { childOrder: d.childOrder.filter((x) => typeof x === "string") } : {}),
|
|
59
61
|
...(str(d.splitFrom) ? { splitFrom: str(d.splitFrom) } : {}),
|
|
60
62
|
areas: strs(d.areas),
|
|
61
63
|
due: date(d.due),
|
|
@@ -71,7 +73,7 @@ export function normalizeRequest(d, body, id) {
|
|
|
71
73
|
};
|
|
72
74
|
}
|
|
73
75
|
export const REQUEST_KEY_ORDER = [
|
|
74
|
-
"id", "title", "status", "parent", "splitFrom", "due", "milestone", "tags", "areas", "workstreams", "lastPreflight",
|
|
76
|
+
"id", "title", "status", "parent", "childOrder", "splitFrom", "due", "milestone", "tags", "areas", "workstreams", "lastPreflight",
|
|
75
77
|
"rev", "createdAt", "updatedAt", "updatedBy",
|
|
76
78
|
];
|
|
77
79
|
export function normalizeProject(d) {
|
|
@@ -35,7 +35,7 @@ export const AI_MANIFEST = {
|
|
|
35
35
|
desc: "参照先(共有の定義)。GET は読めたかの状態と、ローカルの画面にだけこのマシンのパス。POST {name, role?, readFirst?, writable?, map?, path?}",
|
|
36
36
|
},
|
|
37
37
|
{ method: "PUT|DELETE", path: "/api/repos/:name/path", desc: "参照先のこのマシンのパス(個人設定)。このマシンのローカルの画面(Origin)からだけ" },
|
|
38
|
-
{ method: "GET", path: "/api/requests[?parent=<要望ID>]", desc: "
|
|
38
|
+
{ method: "GET", path: "/api/requests[?parent=<要望ID>]", desc: "要望の一覧と進捗(更新の新しい順。parent で直下の子だけを親の表示順に)" },
|
|
39
39
|
{ method: "POST", path: "/api/requests", desc: "要望の作成(parent で子の要望にする。省いた期限・マイルストーン・タグは親から写す)" },
|
|
40
40
|
{
|
|
41
41
|
method: "GET",
|
|
@@ -49,6 +49,13 @@ export const AI_MANIFEST = {
|
|
|
49
49
|
"status=resolved(対応済)は全タスクが完了のときだけ。done / rejected は人が決める。" +
|
|
50
50
|
"parent で親を付け替える(null で外す)。無い・自分・子孫・アーカイブ済みの親は 409 code: hierarchy_invalid(reason)、ほかの操作と重なれば 409 code: hierarchy_busy(やり直してよい)",
|
|
51
51
|
},
|
|
52
|
+
{
|
|
53
|
+
method: "PUT",
|
|
54
|
+
path: "/api/requests/:rid/child-order",
|
|
55
|
+
desc: "子の表示順の保存 {children: [直下の子の ID を全部、上から順に], rev?}(親の childOrder だけを書く。結果は {request, children})。" +
|
|
56
|
+
"重複・無い要望・直下の子でない・足りないは 409 code: child_order_invalid(reason・ids・今の並び children。子が変わっていれば読み直す)、rev が違えば 409 code: rev_conflict。" +
|
|
57
|
+
"表示の順で、実行の順・着手できるかは表さない",
|
|
58
|
+
},
|
|
52
59
|
{ method: "GET|POST", path: "/api/requests/:rid/tasks", desc: "要望のタスク(対応済の要望に未完了のタスクを足すと進行中に戻し reopened を返す。対応済の祖先も戻して reopenedAncestors、完了済の祖先は warnings の ancestor_done)" },
|
|
53
60
|
{ method: "GET|PATCH|DELETE", path: "/api/requests/:rid/tasks/:tid", desc: "タスク(GET は置き換えの印 superseded も返す。PATCH は rev で楽観ロック、null で項目を消す。置き換えられたタスクを作業中にすると warnings を添える)" },
|
|
54
61
|
{ method: "POST", path: "/api/requests/:rid/preflight", desc: "Preflight の実行 {engine?: codex|mock, note?: メモ}。前回の結果とまだ渡していないメモを引き継ぐ" },
|
package/lib/server/api/routes.js
CHANGED
|
@@ -17,7 +17,7 @@ import { UserConfigError } from "../../core/userConfig.js";
|
|
|
17
17
|
import { AI_MANIFEST } from "./manifest.js";
|
|
18
18
|
import { repoRoutes } from "./repoRoutes.js";
|
|
19
19
|
import { releaseNoteRoutes } from "./releaseNoteRoutes.js";
|
|
20
|
-
import { archiveTask, checkMilestoneRemoval, createRequest, createTask, updateRequest, updateTask } from "../../core/requestOps.js";
|
|
20
|
+
import { archiveTask, checkMilestoneRemoval, createRequest, createTask, orderChildren, updateRequest, updateTask } from "../../core/requestOps.js";
|
|
21
21
|
import { StaleInputError } from "../../core/preflight/input.js";
|
|
22
22
|
import { ChildConflictError, ChildDraftsChangedError, DraftConflictError, PulseInputError } from "../../core/preflight/service.js";
|
|
23
23
|
/**
|
|
@@ -59,6 +59,8 @@ const requestInput = z.object({
|
|
|
59
59
|
const requestPatch = requestInput
|
|
60
60
|
.partial()
|
|
61
61
|
.extend({ status: z.enum(REQUEST_STATUSES).optional(), rev: z.number().int().optional() });
|
|
62
|
+
/** 子の表示順: 直下の子の ID を全部、上から順に */
|
|
63
|
+
const childOrderInput = z.object({ children: z.array(z.string().min(1)), rev: z.number().int().optional() });
|
|
62
64
|
const projectPatch = z
|
|
63
65
|
.object({
|
|
64
66
|
name: z.string().min(1),
|
|
@@ -169,10 +171,13 @@ export function apiRoutes(ctx, opts = {}) {
|
|
|
169
171
|
app.route("/", releaseNoteRoutes(ctx));
|
|
170
172
|
// --- requests -------------------------------------------------------------
|
|
171
173
|
app.get("/requests", (c) => {
|
|
172
|
-
// ?parent=<ID>:
|
|
174
|
+
// ?parent=<ID>: 直下の子だけを、親の表示順(子の一覧・詳細と同じ)で。省くと更新の新しい順
|
|
173
175
|
const parent = c.req.query("parent");
|
|
174
176
|
const all = progress(ctx);
|
|
175
|
-
|
|
177
|
+
if (parent === undefined)
|
|
178
|
+
return c.json(all);
|
|
179
|
+
const rows = new Map(all.map((p) => [p.request.id, p]));
|
|
180
|
+
return c.json(hierarchyNow(ws).children(parent).flatMap((r) => rows.get(r.id) ?? []));
|
|
176
181
|
});
|
|
177
182
|
app.post("/requests", async (c) => {
|
|
178
183
|
const b = unnull(requestInput.parse(await c.req.json()));
|
|
@@ -197,6 +202,13 @@ export function apiRoutes(ctx, opts = {}) {
|
|
|
197
202
|
const { rev, ...patch } = requestPatch.parse(await c.req.json());
|
|
198
203
|
return c.json(await updateRequest(ctx, rid(c), unnull(patch), { expectedRev: expectedRev(c, { rev }), actor: actorOf(c) }));
|
|
199
204
|
});
|
|
205
|
+
/** 子の表示順(直下の子を全部、上から順に。CLI の request order と同じ操作) */
|
|
206
|
+
app.put("/requests/:rid/child-order", async (c) => {
|
|
207
|
+
const { children, rev } = childOrderInput.parse(await c.req.json());
|
|
208
|
+
const id = rid(c);
|
|
209
|
+
const r = await orderChildren(ctx, id, children, { expectedRev: expectedRev(c, { rev }), actor: actorOf(c) });
|
|
210
|
+
return c.json({ request: r, children: hierarchyNow(ws).children(id).map((k) => k.id) });
|
|
211
|
+
});
|
|
200
212
|
// --- tasks(要望の中) --------------------------------------------------------
|
|
201
213
|
app.get("/requests/:rid/tasks", (c) => {
|
|
202
214
|
const { status, area, q } = c.req.query();
|
package/lib/shared/hierarchy.js
CHANGED
|
@@ -6,8 +6,23 @@ import { REQUEST_ID } from "./refs.js";
|
|
|
6
6
|
/** 分割を検討する目安の想定タスク数(Preflight の評価で、これ以上なら分割する・しないの説明を必須にする) */
|
|
7
7
|
export const SPLIT_HINT_TASKS = 6;
|
|
8
8
|
const link = (r) => ({ id: r.id, title: r.title, status: r.status });
|
|
9
|
-
/** 作成日時の古い順 → ID
|
|
9
|
+
/** 作成日時の古い順 → ID(数を含む部分は数として比べる)。保存した順に無い子の並び */
|
|
10
10
|
export const byCreated = (a, b) => a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id, undefined, { numeric: true });
|
|
11
|
+
/**
|
|
12
|
+
* 兄弟の並び(子の一覧・詳細・親で絞った一覧・進捗の木で共通)。order は親の childOrder。
|
|
13
|
+
* order にある今の子を order の順に先に並べ(重複は最初の1回)、order に無い子は作成日時の古い順 → ID で後ろに置く。
|
|
14
|
+
* order に残っている今は子でない ID(外した・付け替えた・アーカイブした・形の違う値)は無視する(ファイルは書き換えない)。
|
|
15
|
+
* 表示の順で、実行の順・着手できるかは表さない
|
|
16
|
+
*/
|
|
17
|
+
export function orderSiblings(kids, order) {
|
|
18
|
+
const pos = new Map();
|
|
19
|
+
for (const [i, id] of (order ?? []).entries())
|
|
20
|
+
if (!pos.has(id))
|
|
21
|
+
pos.set(id, i);
|
|
22
|
+
const listed = kids.filter((k) => pos.has(k.id)).sort((a, b) => pos.get(a.id) - pos.get(b.id));
|
|
23
|
+
const rest = kids.filter((k) => !pos.has(k.id)).sort(byCreated);
|
|
24
|
+
return [...listed, ...rest];
|
|
25
|
+
}
|
|
11
26
|
export class Hierarchy {
|
|
12
27
|
byId = new Map();
|
|
13
28
|
kids = new Map();
|
|
@@ -23,15 +38,15 @@ export class Hierarchy {
|
|
|
23
38
|
list.push(r);
|
|
24
39
|
this.kids.set(r.parent, list);
|
|
25
40
|
}
|
|
26
|
-
for (const list of this.kids
|
|
27
|
-
list.
|
|
41
|
+
for (const [pid, list] of this.kids)
|
|
42
|
+
this.kids.set(pid, orderSiblings(list, this.byId.get(pid)?.childOrder));
|
|
28
43
|
this.unreadable = new Set(src.unreadable ?? []);
|
|
29
44
|
this.archived = new Set(src.archived ?? []);
|
|
30
45
|
}
|
|
31
46
|
get(id) {
|
|
32
47
|
return this.byId.get(id);
|
|
33
48
|
}
|
|
34
|
-
/**
|
|
49
|
+
/** 直下の子(親の childOrder の順。無い子は作成日時の古い順 → ID。orderSiblings) */
|
|
35
50
|
children(id) {
|
|
36
51
|
return this.kids.get(id) ?? [];
|
|
37
52
|
}
|
package/package.json
CHANGED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
import{r as e}from"./rolldown-runtime-hePW80VL.js";import{G as t,d as n,lt as r}from"./appCtx-B-VRVOyv.js";var i=e(r(),1),a=t();function o({tabs:e,tab:t,unsaved:r,onSelect:o,label:s,prefix:c}){let l=(0,i.useRef)({});return(0,a.jsx)(`div`,{role:`tablist`,"aria-label":s,className:`flex gap-1 overflow-x-auto border-b border-slate-200 dark:border-slate-800`,onKeyDown:n=>{let r=e.findIndex(e=>e.id===t),i=n.key===`ArrowRight`?(r+1)%e.length:n.key===`ArrowLeft`?(r-1+e.length)%e.length:n.key===`Home`?0:n.key===`End`?e.length-1:-1;if(i<0)return;n.preventDefault();let a=e[i].id;o(a),l.current[a]?.focus()},children:e.map(e=>{let i=e.id===t;return(0,a.jsxs)(`button`,{ref:t=>{l.current[e.id]=t},type:`button`,role:`tab`,id:`${c}-tab-${e.id}`,"aria-selected":i,"aria-controls":`${c}-panel-${e.id}`,tabIndex:i?0:-1,title:e.hint,onClick:()=>o(e.id),className:n(`-mb-px flex shrink-0 items-center gap-1.5 border-b-2 px-3 py-2 font-medium whitespace-nowrap transition`,i?`border-indigo-600 text-indigo-700 dark:border-indigo-400 dark:text-indigo-300`:`border-transparent text-slate-500 hover:text-slate-800 dark:text-slate-400 dark:hover:text-slate-200`),children:[e.label,r?.[e.id]&&(0,a.jsxs)(`span`,{className:`text-xs text-amber-600 dark:text-amber-400`,title:`保存していない変更があります`,children:[`●`,(0,a.jsx)(`span`,{className:`sr-only`,children:`(未保存)`})]})]},e.id)})})}function s({id:e,tab:t,prefix:n,className:r,children:i}){return(0,a.jsx)(`div`,{role:`tabpanel`,id:`${n}-panel-${e}`,"aria-labelledby":`${n}-tab-${e}`,hidden:e!==t,className:r,children:i})}export{o as n,s as t};
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
function e(e,n,r){let i=new Map(e.map(e=>[e.request.id,e])),a=new Set(n.map(e=>e.request.id)),o=new Map;for(let e of n){o.set(e.request.id,e);let t=new Set([e.request.id]);for(let n=e.request.parent;n&&!t.has(n);n=i.get(n)?.request.parent){t.add(n);let e=i.get(n);if(!e)break;o.set(n,e)}}let s=new Map;n.forEach((e,t)=>s.set(e.request.id,t));let c=e=>{if(s.has(e))return s.get(e);s.set(e,2**53-1);let t=[...o.values()].filter(t=>t.request.parent===e).map(e=>c(e.request.id)),n=t.length?Math.min(...t):2**53-1;return s.set(e,n),n};for(let e of o.keys())c(e);let l=[...o.values()].sort((e,t)=>s.get(e.request.id)-s.get(t.request.id)),u=new Map,d=[];for(let e of l){let n=e.request.parent;n&&o.has(n)&&!t(i,e.request.id)?(u.get(n)??u.set(n,[]).get(n)).push(e):d.push(e)}let f=[],p=new Set,m=(e,t)=>{if(p.has(e.request.id))return;p.add(e.request.id);let n=u.get(e.request.id)??[],i=r.has(e.request.id);if(f.push({p:e,depth:t,context:!a.has(e.request.id),hasChildren:n.length>0,collapsed:i}),!i)for(let e of n)m(e,t+1)};for(let e of d)m(e,0);return f}function t(e,t){let n=new Set;for(let r=e.get(t)?.request.parent;r&&!n.has(r);r=e.get(r)?.request.parent){if(r===t)return!0;n.add(r)}return!1}function n(e,t){if(!t)return[...e];let n=new Set([t]);for(let t=!0;t;){t=!1;for(let r of e)r.parent&&n.has(r.parent)&&!n.has(r.id)&&(n.add(r.id),t=!0)}return e.filter(e=>!n.has(e.id))}export{e as n,n as t};
|