@infodb/p3 0.3.0 → 0.4.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/dist/web/assets/{Outputs-DqJdybkd.js → Outputs-5Hby-S5Q.js} +1 -1
- package/dist/web/assets/{RequestStatus-DN-2iAM0.js → RequestStatus-CTkGjT02.js} +1 -1
- package/dist/web/assets/{TagInput-D-1ILLDX.js → TagInput-Rj3PNOAF.js} +1 -1
- package/dist/web/assets/{TaskDrawer-CHD7T-Su.js → TaskDrawer-DtPhiYxP.js} +1 -1
- package/dist/web/assets/_requestId-CGvAfIkB.js +30 -0
- package/dist/web/assets/_requestId-DxfYhgAq.js +1 -0
- package/dist/web/assets/{board-BIkOpuC4.js → board-wt47lfrE.js} +1 -1
- package/dist/web/assets/copy-CKsXEjMi.js +1 -0
- package/dist/web/assets/{done-BUAUhIRr.js → done-C9Ct7ssb.js} +1 -1
- package/dist/web/assets/{index-Byv9j77D.js → index-BTFL2rpp.js} +4 -4
- package/dist/web/assets/index-DAyBsvua.css +2 -0
- package/dist/web/assets/milestoneOrder-N7b5XFJP.js +1 -0
- package/dist/web/assets/new-e4ID2vQV.js +1 -0
- package/dist/web/assets/preflightInput-DMxqnvF8.js +2 -0
- package/dist/web/assets/{preload-helper-DlN0ouRj.js → preload-helper-DhIyFaOW.js} +1 -1
- package/dist/web/assets/release-notes-CQ0d2r0k.js +3 -0
- package/dist/web/assets/{requestData-DJ1Rlx-u.js → requestData-BDZqyl35.js} +1 -1
- package/dist/web/assets/routes-Bipv3lwJ.js +2 -0
- package/dist/web/assets/settings-Dwh8fj6p.js +1 -0
- package/dist/web/assets/{ui-Sz7y5_TS.js → ui-DdOGYj9z.js} +1 -1
- package/dist/web/index.html +4 -4
- package/docs/architecture.md +18 -6
- package/docs/how-to-use.md +58 -7
- package/docs/installation.md +5 -5
- package/package.json +1 -1
- package/skills/p3/SKILL.md +19 -8
- package/src/cli/help.ts +3 -0
- package/src/cli/main.ts +2 -1
- package/src/cli/project.ts +6 -3
- package/src/cli/releaseNotesCommands.ts +42 -3
- package/src/cli/requestCommands.ts +4 -2
- package/src/cli/taskCommands.ts +1 -1
- package/src/core/releaseNotes/completeRequests.ts +102 -0
- package/src/core/releaseNotes/service.ts +9 -5
- package/src/server/api/manifest.ts +8 -1
- package/src/server/api/releaseNoteRoutes.ts +11 -0
- package/src/shared/milestoneOrder.ts +44 -0
- package/src/shared/types.ts +30 -0
- package/dist/web/assets/_requestId-BzSepQIV.js +0 -30
- package/dist/web/assets/_requestId-pIds2tFU.js +0 -1
- package/dist/web/assets/copy-B1ZbihKL.js +0 -2
- package/dist/web/assets/index-DTfUhuQw.css +0 -2
- package/dist/web/assets/new-6kly4-PX.js +0 -1
- package/dist/web/assets/release-notes-iwQWmfX6.js +0 -3
- package/dist/web/assets/routes-Ciot9p4x.js +0 -2
- package/dist/web/assets/settings-DBCi6lAY.js +0 -1
package/docs/how-to-use.md
CHANGED
|
@@ -126,10 +126,26 @@ git switch -c req/261009-k7m3x-notify # request show で見た実際の
|
|
|
126
126
|
export P3_ACTOR=ai:claude # 変更者の記録(AI は ai:<名前>)
|
|
127
127
|
p3 show T001 --brief --json # 本文・依存とその状態・作業先とブランチ・置き換えの注意
|
|
128
128
|
p3 move T001 doing # 着手
|
|
129
|
-
# ...
|
|
130
|
-
p3 move T001 done --output
|
|
129
|
+
# ... 作業し、テストを通す ...
|
|
130
|
+
p3 move T001 done --output "src/notify.ts(送信)" --record - < record.md # コミットする前に完了にする
|
|
131
|
+
p3 request set k7m3x status=resolved # 最後のタスクなら、これもコミットの前に(7.)
|
|
132
|
+
git add src/notify.ts .p3/requests/261009-k7m3x # データを git で管理していれば、要望のフォルダも同じコミットに
|
|
133
|
+
git commit -m "通知の送信" && git push
|
|
134
|
+
p3 move T001 done --output https://github.com/me/myapp/commit/<sha> # URL は後から足す(完了・記録はそのまま)
|
|
135
|
+
git add .p3/requests/261009-k7m3x && git commit -m "成果物の URL" && git push
|
|
131
136
|
```
|
|
132
137
|
|
|
138
|
+
- **完了を記録してからコミットする**: テストを通したら、コミットの前に完了(と最後なら対応済)を保存する。データのフォルダが
|
|
139
|
+
リポジトリの中にあって git で管理していれば、要望とタスク・変更の記録が実装と同じコミットに入り、PR / MR を見る人は
|
|
140
|
+
「何を頼まれ、何をしたか」をコードと一緒に読める。入れるのはその要望のフォルダだけ(ほかの要望の変更は入れない)
|
|
141
|
+
- 成果物は、完了にする時点で今あるもの(変えたファイル・ドキュメントのパス・短い説明)。まだ無い URL や仮の SHA は書かない。
|
|
142
|
+
コミット・PR / MR の URL は push してから `move … done --output <URL>` で足す(完了・記録・前の成果物・完了の日時は変わらず、
|
|
143
|
+
要望も進行中に戻らない)。この追記は次のコミットに入れる(追記のコミット自身の URL は要らない)
|
|
144
|
+
- データのフォルダがリポジトリの外・別のリポジトリ・git で無視されているときは、同じコミットには入らない。git の作業ツリー
|
|
145
|
+
(worktree)で作業していても、データは登録したフォルダ(既定はメインの作業ツリーの `.p3`)に書かれ、その作業ツリーのコミットには
|
|
146
|
+
入らない。どちらもデータを移したり写したり `git add -f` したりせず、コードとは成果物の URL で結ぶ
|
|
147
|
+
- push に失敗しても、完了の記録はそのまま。公開できていないだけなので、直して push し直す
|
|
148
|
+
|
|
133
149
|
- 依存の相手が終わっていないタスクや、置き換えられたタスク(`※置換`)からは始めない
|
|
134
150
|
- **変更の記録**(`--record`)は、何を変えたか・なぜ・入れた決まり・やめたものを Markdown で短く書く。AI が完了にするときは必須。
|
|
135
151
|
後の Preflight が経緯を調べるとき、タスクの解析・リリースノートの材料になる
|
|
@@ -137,7 +153,8 @@ p3 move T001 done --output https://github.com/me/myapp/pull/42 --record - < reco
|
|
|
137
153
|
|
|
138
154
|
### 7. 要望を対応済にする
|
|
139
155
|
|
|
140
|
-
全タスクを完了にしたら、作業した側が要望を **対応済**
|
|
156
|
+
全タスクを完了にしたら、作業した側が要望を **対応済** にする(人に確認を頼む印)。最後のタスクのコミットの前にしておけば、
|
|
157
|
+
対応済も同じコミットに入る(6.)。
|
|
141
158
|
|
|
142
159
|
```bash
|
|
143
160
|
p3 request set k7m3x status=resolved
|
|
@@ -335,7 +352,8 @@ Preflight は始めたときの内容を固定して評価する。**評価の
|
|
|
335
352
|
|
|
336
353
|
### 成果物と変更の記録
|
|
337
354
|
|
|
338
|
-
- **成果物**(`outputs`): 1項目ずつ、PR / MR の URL
|
|
355
|
+
- **成果物**(`outputs`): 1項目ずつ、PR / MR の URL・文章・ドキュメントのパスのどれでもよい。完了にするときは今あるもの
|
|
356
|
+
(変えたファイルや説明)を書き、URL は push してから `move <T> done --output <URL>` で足す(完了のまま追記する)。項目全体が `http(s)://` の URL なら
|
|
339
357
|
画面でリンクになる(文章の中の URL は拾わない)。足すのは `move <T> done --output 値`(繰り返し可。カンマで分けない)か画面の
|
|
340
358
|
「成果物を編集」。`set <T> outputs=a,b` はカンマで分けて置き換える
|
|
341
359
|
- **リポジトリごとの成果物**(`repoOutputs`): `--repo-output <参照先>=<URL>`。複数のリポジトリにまたがるときに最後のタスクに残す
|
|
@@ -347,6 +365,13 @@ Preflight は始めたときの内容を固定して評価する。**評価の
|
|
|
347
365
|
- **期限**(`due`): 要望の期限(`--due YYYY-MM-DD`)。進捗のスケジュールに ⚑ で出る
|
|
348
366
|
- **マイルストーン**: まとめてリリースする単位(`p3 milestone add v0.2 --title "通知まわり" --due 2026-11-30`、要望に `--milestone v0.2`)。
|
|
349
367
|
リリースノートはマイルストーンごとに作る([リリースノート](#リリースノート))
|
|
368
|
+
- **並び**: 選ぶ欄(新しい要望・要望の概要)・進捗のまとまり・リリースノートの一覧・設定・`p3 milestone` / `progress` / `config` の
|
|
369
|
+
一覧は、**ID のバージョンの降順**(新しいものが上)。比べるのは ID だけで(タイトル・期限・リリース済みかは見ない)、先頭の
|
|
370
|
+
`v` / `V` は比べるときだけ外し、数字は数として比べる(`0.10.0` > `0.9.0`、`v2.0` > `v1.10` > `v1.9`)。バージョンでない ID も
|
|
371
|
+
同じ規則で並べる(SemVer のプレリリースの順は持たない)。選ぶ欄の「(なし)」は先頭、進捗の「マイルストーンなし」と
|
|
372
|
+
project.yaml に無いリリースノートは最後。リリースノートの画面は、指定(`?m=`)が無ければ先頭を開く
|
|
373
|
+
- project.yaml の順は表示のために変えない(足した順のまま)。設定の画面は開いたときに降順に並べ、編集の間は行を動かさない
|
|
374
|
+
(ID を書き換えても、足した行は最後のまま)。保存すると並べ直す
|
|
350
375
|
- **タグ**(`tags`): 外部 ID や分類の自由な文字列(例 `jira:PROJ-123`、`group:顧客A`)。同じ値を複数の要望に付けてグループにできる。
|
|
351
376
|
要望・タスクの参照の代わりにはせず、外部のシステムとは同期しない
|
|
352
377
|
- CLI: `request new --tag 値`(繰り返し可。カンマで分けない)、`request set <要望> --tag 値 ...`(この並びに置き換える)、
|
|
@@ -395,6 +420,27 @@ p3 release-notes export v0.2 > RELEASE.md # 公開する本文だけ(出
|
|
|
395
420
|
必要なら生成し直して、確かめてから保存する
|
|
396
421
|
- **競合**: 保存したノートを直すときは、読んだときの版(`--version`)が要る。画面・エディタなど別のところで先に変わっていれば
|
|
397
422
|
終了コード 3 で何も書かない。`show` で読み直してからやり直す
|
|
423
|
+
- **要望を一括で完了済にする**: リリースが終わったら、人がマイルストーンの要望の状態をまとめて閉じられる(対応済 → 完了済)。
|
|
424
|
+
できるのは、見送りを除く全要望が収録の条件(対応済か完了済・タスクが全部完了・読めないタスクなし)を満たすときだけ。
|
|
425
|
+
変えるのは対応済の要望だけで、完了済・見送り、タスク(済みを含む)、ノート、マイルストーン(リリース済み)は変えない。
|
|
426
|
+
変更の記録が無い・ノートを保存していない・済みを付けていないことは条件にしない。ノートの保存・生成とは別の、明示の操作
|
|
427
|
+
|
|
428
|
+
```bash
|
|
429
|
+
p3 release-notes show v0.2 # 「要望の一括完了」に、できるか・できない理由・完了済にする要望と実行のコマンド
|
|
430
|
+
p3 release-notes complete-requests v0.2 --based-on <材料の hash> # show に出た hash で実行する
|
|
431
|
+
```
|
|
432
|
+
|
|
433
|
+
- 確かめたあとで要望・タスクが変わっていれば(hash が違う)何も変えずに終了コード 3。できない(未完了がある)ときも何も
|
|
434
|
+
変えずに終了コード 1。`show` で読み直してからやり直す
|
|
435
|
+
- 1件ずつ書くので、途中で別の変更とぶつかる(要望が変わった・タスクが戻った)・書けないと、その要望で止まる。完了済にした
|
|
436
|
+
もの・止まった要望と理由・まだ変えていないものを出す(戻さない)。直して `show` から読み直し、もう一度実行すれば残りを
|
|
437
|
+
完了済にする(完了済にしたものは書き直さない)
|
|
438
|
+
- 完了済にすると材料が変わるので、保存したノートには「材料が変わった」と出る(本文はそのまま)
|
|
439
|
+
- 画面では、マイルストーンの「このマイルストーンの要望」の下の「要望の一括完了」。できないときは理由(要望ごと)と要望を開く
|
|
440
|
+
導線を出し、ボタンは押せない。対象が無ければ「完了済にする要望はありません」。「要望を一括で完了済にする(N件)」で対象の
|
|
441
|
+
要望と「タスクの済みは変えない」ことを確かめる欄を開き、キャンセルできる。実行の結果(完了済にした件数・途中で止まったときの
|
|
442
|
+
完了済にした / 止まった / まだ変えていない)を出し、表示と進捗を取り直す。表示したあとで変わっていれば何も変えずに知らせる
|
|
443
|
+
(自動では頼み直さない。内容を確かめてもう一度押す)。本文の入力は消えない
|
|
398
444
|
- **ファイル**: `<データのフォルダ>/release-notes/<マイルストーン>.md`(本文と、出典を書いた frontmatter)。エディタで直してもよい。
|
|
399
445
|
壊すと「読めない」と出て、直すまで新しく保存しない。ノートのあるマイルストーンは消せない。保存の形と直し方は
|
|
400
446
|
[docs/architecture.md](architecture.md#リリースノートのデータ)
|
|
@@ -446,12 +492,13 @@ p3 render 画面.html --width 1280 # 画面.png ができる(幅 32
|
|
|
446
492
|
- **選ぶ**: 入口(`/`)は登録したプロジェクトの一覧(行のどこを押しても開く)。登録が1つだけで開けるときは、一覧を飛ばして
|
|
447
493
|
そのプロジェクトを開く(使えない登録や個人設定の読めない理由があるときは一覧に出す)。選ぶと `/projects/<名前>/...` になり、
|
|
448
494
|
ほかの URL(要望・ボード・リリースノート・設定、`?task=` など)はこの下に今までどおり続く。URL を直接開く・再読み込み・戻るも効く
|
|
449
|
-
- **今のプロジェクト**:
|
|
495
|
+
- **今のプロジェクト**: どの画面でも、ヘッダーのロゴの横(通常の serve でプロジェクト名を出す場所)の選ぶ欄に出る。ここで切り替える
|
|
496
|
+
(選ぶ欄を開くと一覧を読み直す。狭い画面でも隠さず、長い名前は欄の幅で切る)。
|
|
450
497
|
「プロジェクトの一覧…」では、登録が1つでも一覧を出す(`/?list`)。一覧は、戻ったとき・そのタブに戻ったときにも読み直すので、
|
|
451
498
|
途中で足した・外した登録が出る
|
|
452
499
|
作成・保存・Preflight は、ここに出ているプロジェクトにだけ届く。タブごとに別のプロジェクトを開いてもよい
|
|
453
500
|
- **切り替え**: ページごと移る。保存していない入力があれば「このプロジェクトに残る / 入力を破棄して切り替える」を選ぶ(破棄した
|
|
454
|
-
|
|
501
|
+
入力はどこにも送らない)。送っている保存は、結果が決まるまで待ってから移る(待っている間はヘッダーの下に出し、選ぶ欄は押せない)。実行中の Preflight・生成は元のプロジェクトで続き、
|
|
455
502
|
戻れば状態を読み直す(取消は表示中のプロジェクトの実行にだけ届く)
|
|
456
503
|
- **登録が変わったとき**: 開いている間にデータのフォルダを変えた・外した(CLI の `p3 project rm` / `add`)プロジェクトの画面からは
|
|
457
504
|
保存しない。「登録が変わりました」と出るので、一覧から選び直す(入力は残すが、新しい登録先へ自動では送らない)
|
|
@@ -469,7 +516,9 @@ p3 render 画面.html --width 1280 # 画面.png ができる(幅 32
|
|
|
469
516
|
| `/release-notes` | リリースノート(`?m=<マイルストーン>`)。下の「リリースノートの画面」 |
|
|
470
517
|
| `/settings` | 個人(ChatGPT の接続・テーマ)/ プロジェクトの基本 / 参照先(`?tab=personal|project|repos`) |
|
|
471
518
|
|
|
472
|
-
要望の中のページでは `?task=T003`
|
|
519
|
+
要望の中のページでは `?task=T003` でタスク詳細を重ねて開く。どのタブでも、見出しのタイトルの上に要望 ID と「コピー」が出る
|
|
520
|
+
(本文を下へ送っても見出しは残るので、上まで戻らずにコピーできる)。コピーできない(拒まれた・http で別のマシンから開いて
|
|
521
|
+
Clipboard API が無い)ときはそう出るので、ID をクリックして全体を選び、手でコピーする。
|
|
473
522
|
|
|
474
523
|
進捗のスケジュールの記号:
|
|
475
524
|
|
|
@@ -593,6 +642,8 @@ AI にも CLI を使わせる(認証を持たせずに済む)。`p3 init --a
|
|
|
593
642
|
- 後から片方を足したときは、スキルは置き、節(前の参照のまま)は「保護」になる。両方を指す節にするなら `--force`
|
|
594
643
|
- チームで使うとき: 置いた・最新にした変更(`git diff`)をレビューしてコミットし、push して共有する。ほかの人は pull するだけで
|
|
595
644
|
よい(参加の `p3 join` は AI 向けのファイルを書かない)
|
|
645
|
+
- 新しい版の P3 で手順が変わっても、置いたスキルと節は自動では変わらない(例: 完了をコミットの前にする順番)。`p3 agents <先>` で
|
|
646
|
+
違いを確かめ、手で直していなければ `--force` で最新にする
|
|
596
647
|
- 以前の版との違い: 以前は `init --agents` で両方に置き、参加(init)のときも置き、登録済みのリポジトリで実行し直すと足りない方を
|
|
597
648
|
置いていた。今は、置く先を選び、参加では置かず、後から置く・最新にするのは `p3 agents` だけ
|
|
598
649
|
|
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.4.0` など)と
|
|
306
306
|
`latest` がある。決まった版で使うなら版のタグを指す。
|
|
307
307
|
|
|
308
308
|
```bash
|
|
309
|
-
docker pull tamuto/p3:0.
|
|
309
|
+
docker pull tamuto/p3:0.4.0
|
|
310
310
|
```
|
|
311
311
|
|
|
312
312
|
リポジトリから作るときは `docker build -t tamuto/p3:dev .`([開発ガイド](development.md#docker-のイメージ))。
|
|
@@ -325,7 +325,7 @@ root で動く開発コンテナ(DevContainer など)で p3 の CLI を使
|
|
|
325
325
|
# 開発コンテナの compose に足す例(パスは開発コンテナのマウントに合わせる)
|
|
326
326
|
services:
|
|
327
327
|
p3:
|
|
328
|
-
image: tamuto/p3:0.
|
|
328
|
+
image: tamuto/p3:0.4.0
|
|
329
329
|
restart: unless-stopped
|
|
330
330
|
ports:
|
|
331
331
|
- "127.0.0.1:4310:4310"
|
|
@@ -349,7 +349,7 @@ docker run -d --name p3 --restart unless-stopped \
|
|
|
349
349
|
-v ~/.config/infodb-p3:/root/.config/infodb-p3 \
|
|
350
350
|
-v /home/me/work:/home/me/work \
|
|
351
351
|
-v /var/run/docker.sock:/var/run/docker.sock \
|
|
352
|
-
tamuto/p3:0.
|
|
352
|
+
tamuto/p3:0.4.0
|
|
353
353
|
|
|
354
354
|
# 登録が無ければ、コンテナの中で登録する(既にあるデータに参加する。新しく作るなら p3 init)
|
|
355
355
|
docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
|
|
@@ -362,7 +362,7 @@ docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
|
|
|
362
362
|
### どちらでも
|
|
363
363
|
|
|
364
364
|
- 待ち受けは `127.0.0.1` に公開する。ブラウザで http://localhost:4310 を開く。登録が1つならそのプロジェクトが開き、複数なら一覧から選ぶ
|
|
365
|
-
- **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.
|
|
365
|
+
- **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.4.0 serve --project myapp --host 0.0.0.0`。compose なら
|
|
366
366
|
`command:`)。明示しない限り、コンテナの中かどうかで自動では切り替えない
|
|
367
367
|
- **止める**: `docker stop p3`(SIGTERM。実行中の Preflight・生成を取り消して記録してから止まる。10 秒まで待つ)
|
|
368
368
|
- **新しい版にする**: 版のタグを変えて作り直す(個人設定と接続はマウントした ~/.config、データはホストに残る)。
|
package/package.json
CHANGED
package/skills/p3/SKILL.md
CHANGED
|
@@ -66,19 +66,30 @@ P3_ACTOR=ai:<エージェント名> p3 <コマンド> [引数] --json
|
|
|
66
66
|
**置き換えられたタスク**(`ls` の `※置換`、`--json` の `superseded` と `warnings`)からは始めない。残っていれば扱いをユーザーに確かめる
|
|
67
67
|
(不要ならユーザーの了承を得て `archive`)。`move` が警告(`warnings`)を返したら、作業を止めてユーザーに伝える
|
|
68
68
|
3. 着手: `move T003 doing --req <要望ID>`
|
|
69
|
-
4.
|
|
70
|
-
`move T003 done --req <要望ID> --output
|
|
69
|
+
4. 作業し、プロジェクトのテストを通したら、**コミットする前に** 完了にする:
|
|
70
|
+
`move T003 done --req <要望ID> --output <成果物> --record - < record.md`(成果物が複数あれば `--output` を繰り返す)。
|
|
71
|
+
成果物は今あるもの(変えたファイル・ドキュメントのパスや短い説明)。まだ無い URL や仮のコミットの SHA は書かない(URL は 8 で足す)。
|
|
71
72
|
**変更の記録(`--record`)は必須**: 何を変えたか(振る舞いの言葉で)・なぜ・入れた決まり・やめたもの を Markdown で短く書く。
|
|
72
|
-
後の Preflight
|
|
73
|
+
後の Preflight が経緯を調べるとき、タスクの解析・リリースノートの材料として読む(パスの羅列ではなく、目的と決まりを書く)。
|
|
74
|
+
テストが通っていない・作業が途中のうちは完了にしない
|
|
73
75
|
5. 作業中に見つけた追加の作業は `new "<タイトル>" --req <要望ID> --body "..."` でタスクにする(タスクの関係は Preflight のタスク化が張るもので、手では張らない。順序は本文に書く)
|
|
74
|
-
6. 要望のタスクが全部完了したら(`ls --req <要望ID>` が全部 done
|
|
76
|
+
6. 要望のタスクが全部完了したら(`ls --req <要望ID>` が全部 done、成果物と検証も済み)、コミットする前に要望を **対応済** にする:
|
|
75
77
|
`request set <要望ID> status=resolved --json`。未完了のタスクがあると拒否される(終わらせるか、不要ならユーザーの了承を得て
|
|
76
78
|
`archive`)。拒否をタスクを偽って完了にする・ファイルを直接書き換えるなどで回避しない
|
|
77
|
-
7.
|
|
78
|
-
|
|
79
|
-
|
|
79
|
+
7. コミットして push する。データのフォルダ(`whoami` の場所)がこの作業ツリーの中にあって git で管理されている(無視されていない)なら、
|
|
80
|
+
**要望のフォルダ(`<データのフォルダ>/requests/<要望ID>/`)の変更も実装と同じコミットに入れる**。要望とタスク・変更の記録が
|
|
81
|
+
コードと一緒に残り、レビューで「何を頼まれ、何をしたか」を読める。入れるのはその要望のフォルダだけ(ほかの要望や関係ない変更を
|
|
82
|
+
まとめて add しない)。データのフォルダが外・別のリポジトリ・git で無視されている、または git の作業ツリー(worktree)で作業して
|
|
83
|
+
いてデータがメインの作業ツリーにあるときは、同じコミットには入らない(データの移動・写し・`git add -f` はしない。記録は p3 に
|
|
84
|
+
残り、コードとは成果物の URL で結ぶ)。commit・push に失敗したら、完了の記録はそのまま残し、公開できていないことをユーザーに
|
|
85
|
+
伝えてやり直す(完了を push できたことのように伝えない)
|
|
86
|
+
8. コミットや PR の URL を残すなら、後から `move T003 done --req <要望ID> --output <URL>` で足す(完了・記録・前の成果物はそのまま。
|
|
87
|
+
完了から戻さない)。要望のフォルダを同じコミットに入れているなら、この追記もコミットして同じブランチに push する(追記のコミット
|
|
88
|
+
自身の URL は残さなくてよい)。PR はユーザーに確認してから作る(本文に要望 ID とタスクの一覧)。作った PR の URL は最後のタスクに
|
|
89
|
+
足す。複数のリポジトリにまたがる要望は、関係するリポジトリの PR を全部 `--repo-output <参照先の名前>=<PR の URL>` で最後のタスクに
|
|
90
|
+
残す(例: `move T005 done --repo-output app=<URL> --repo-output infra=<URL>`。1つのリポジトリなら今までどおり `--output` でよい)。
|
|
80
91
|
マージ・要望の完了済(`done`)は人が行う
|
|
81
|
-
|
|
92
|
+
9. 対応済の後にタスクを足した・完了から戻したときは、要望は自動で進行中に戻る(`--json` の `reopened`)。
|
|
82
93
|
終えたらもう一度 6 で対応済にする
|
|
83
94
|
|
|
84
95
|
## してはいけないこと
|
package/src/cli/help.ts
CHANGED
|
@@ -36,6 +36,9 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
|
|
|
36
36
|
release-notes save <id> 本文を保存する --body 本文|- / --file 本文.md --based-on <材料の hash>(生成の案を元にしたとき)
|
|
37
37
|
既にあるノートの更新は --version <版>(show で見る。違えば競合で終了コード 3)
|
|
38
38
|
release-notes export <id> 保存した本文だけを stdout に出す(出典・frontmatter は出さない)
|
|
39
|
+
release-notes complete-requests <id> --based-on <hash>
|
|
40
|
+
対応済の要望を一括で完了済にする(見送り以外の全要望が全タスク完了のときだけ。タスクの済みは変えない)。
|
|
41
|
+
できるか・対象・hash は show で見る。材料が変わっていれば何も変えずに終了コード 3、途中で止まったら非ゼロ
|
|
39
42
|
例: p3 release-notes generate v0.2 > draft.md → 直す → p3 release-notes save v0.2 --file draft.md
|
|
40
43
|
p3 release-notes export v0.2 > RELEASE.md
|
|
41
44
|
whoami 操作するプロジェクト・変更者・今の要望
|
package/src/cli/main.ts
CHANGED
|
@@ -22,6 +22,7 @@ import { taskCommand } from "./taskCommands.ts";
|
|
|
22
22
|
import { preflightCommand } from "./preflightCommands.ts";
|
|
23
23
|
import { releaseNotesCommand } from "./releaseNotesCommands.ts";
|
|
24
24
|
import { ReleaseNoteError } from "../core/releaseNotes/store.ts";
|
|
25
|
+
import { sortMilestones } from "../shared/milestoneOrder.ts";
|
|
25
26
|
import { GenerationRejected } from "../core/releaseNotes/generate.ts";
|
|
26
27
|
|
|
27
28
|
/**
|
|
@@ -249,7 +250,7 @@ async function main(argv: string[]): Promise<number> {
|
|
|
249
250
|
const today = localToday();
|
|
250
251
|
return out.result(ps, () => {
|
|
251
252
|
const groups = [
|
|
252
|
-
...ctx.ws.project.milestones.map((m) => ({ m, ps: ps.filter((p) => p.request.milestone === m.id) })),
|
|
253
|
+
...sortMilestones(ctx.ws.project.milestones).map((m) => ({ m, ps: ps.filter((p) => p.request.milestone === m.id) })),
|
|
253
254
|
{ m: undefined, ps: ps.filter((p) => !p.request.milestone) },
|
|
254
255
|
];
|
|
255
256
|
return (
|
package/src/cli/project.ts
CHANGED
|
@@ -17,6 +17,7 @@ import { normalizeProject } from "../core/store/normalize.ts";
|
|
|
17
17
|
import { requestWorkstreams } from "../shared/workTarget.ts";
|
|
18
18
|
import type { Workspace } from "../core/store/workspace.ts";
|
|
19
19
|
import { DATA_DIR_NAME } from "../core/store/locate.ts";
|
|
20
|
+
import { sortMilestones } from "../shared/milestoneOrder.ts";
|
|
20
21
|
import { loadUserConfig, PROJECT_NAME, setProjectNode, updateUserConfig, userConfigPath } from "../core/userConfig.ts";
|
|
21
22
|
|
|
22
23
|
/** プロジェクトの初期設定・設定変更、変更者と「今の要望」の判定(CLI) */
|
|
@@ -142,8 +143,10 @@ export function agentsSnippet(kinds: readonly AgentKind[]): string {
|
|
|
142
143
|
Preflight(\`preflight\`)とタスク化(\`accept\`)は人が行う(AI は実行しない。結果を \`p3 drafts\` で読むのと、頼まれたメモの保存 \`--note-only\` はよい)
|
|
143
144
|
- 着手する前に \`p3 show T003 --brief --json\` で本文・依存とその状態(\`dependencies\`)・置き換えの注意(\`warnings\`)を読む
|
|
144
145
|
- 着手する前に、\`--brief --json\` の \`work\`(作業先のリポジトリとブランチ)を見て、そのリポジトリでブランチに入る(作業先なしなら移動しない)
|
|
145
|
-
- 着手するときは \`p3 move T003 doing
|
|
146
|
-
-
|
|
146
|
+
- 着手するときは \`p3 move T003 doing\`。テストを通したら、コミットする前に \`p3 move T003 done --output <今ある成果物(変えたファイルや説明)> --record -\` で完了にする(変更の記録は必須: 何を変えたか・なぜ・入れた決まり・やめたもの を標準入力から Markdown で。まだ無い URL は書かない)
|
|
147
|
+
- 要望のタスクを全部終えたら、コミットする前に \`p3 request set <要望ID> status=resolved\`(対応済)にする。完了済(done)・見送り(rejected)とタスクの済み(check)は人が決める
|
|
148
|
+
- データのフォルダがこの作業ツリーの中で git 管理されているなら、要望のフォルダ(\`requests/<要望ID>/\`)の変更も実装と同じコミットに入れる(ほかの要望・関係ない変更は入れない。外・無視・worktree のときは入らないので、移動や \`git add -f\` はしない)。push に失敗したら完了の記録は残し、公開できていないことを伝える
|
|
149
|
+
- コミットや PR の URL は後から \`p3 move T003 done --output <URL>\` で足す(完了・記録はそのまま。データをコミットしているなら追記もコミットして push)。複数のリポジトリにまたがるときは最後のタスクに \`--repo-output <参照先>=<PR の URL>\` で全部の PR を残す
|
|
147
150
|
- 置き換えられたタスク(\`p3 ls\` の \`※置換\`、\`--json\` の \`superseded\`)からは始めない。\`move\` が \`warnings\` を返したら止めて人に確かめる
|
|
148
151
|
- 作業中に新しく必要になった作業は \`p3 new "<タイトル>" --body "..."\` でタスクにする(人への質問はタスクにしない)
|
|
149
152
|
`;
|
|
@@ -554,7 +557,7 @@ export async function config(ws: Workspace, args: string[]): Promise<{ data: unk
|
|
|
554
557
|
`name ${p.name}`,
|
|
555
558
|
`description ${p.description || "(なし)"}`,
|
|
556
559
|
`repos ${p.repos.map((r) => r.name).join(", ") || "(なし)"} (p3 repo ls)`,
|
|
557
|
-
`milestones ${p.milestones.map((m) => `${m.id}${m.due ? `(${m.due})` : ""}${m.done ? "[済]" : ""}`).join(", ") || "(なし)"}`,
|
|
560
|
+
`milestones ${sortMilestones(p.milestones).map((m) => `${m.id}${m.due ? `(${m.due})` : ""}${m.done ? "[済]" : ""}`).join(", ") || "(なし)"}`,
|
|
558
561
|
`branchPattern ${p.branchPattern}`,
|
|
559
562
|
`instructions ${p.preflight.instructions || "(なし)"}`,
|
|
560
563
|
"",
|
|
@@ -1,12 +1,13 @@
|
|
|
1
1
|
import { readFile } from "node:fs/promises";
|
|
2
2
|
import { resolve as resolvePath } from "node:path";
|
|
3
|
-
import type { ReleaseGeneration, ReleaseMaterial, ReleaseWarning } from "../shared/types.ts";
|
|
3
|
+
import type { ReleaseGeneration, ReleaseMaterial, ReleaseWarning, RequestCompletionPlan } from "../shared/types.ts";
|
|
4
4
|
import { exportReleaseNote, releaseNoteDetail, releaseOverview, saveReleaseNote, startGeneration } from "../core/releaseNotes/service.ts";
|
|
5
5
|
import { readBody, type CommandEnv } from "./args.ts";
|
|
6
6
|
import { table } from "./format.ts";
|
|
7
7
|
import { UsageError } from "./project.ts";
|
|
8
8
|
import { shellArg } from "./output.ts";
|
|
9
9
|
import { GenerationRejected } from "../core/releaseNotes/generate.ts";
|
|
10
|
+
import { completeMilestoneRequests, CompletionRejected } from "../core/releaseNotes/completeRequests.ts";
|
|
10
11
|
|
|
11
12
|
/**
|
|
12
13
|
* p3 release-notes ... マイルストーンごとのリリースノート(規則と保存は core/releaseNotes)
|
|
@@ -16,6 +17,7 @@ import { GenerationRejected } from "../core/releaseNotes/generate.ts";
|
|
|
16
17
|
* generate <id> 機能の要約を生成して案を出す(保存しない。進み具合は stderr)
|
|
17
18
|
* save <id> 本文を保存する(--body 本文|- か --file。更新は --version 必須)
|
|
18
19
|
* export <id> 保存した本文だけを stdout に出す
|
|
20
|
+
* complete-requests <id> --based-on <hash> 対応済の要望を一括で完了済にする(判定と hash は show。頼めない・途中で止まったら非ゼロ)
|
|
19
21
|
*/
|
|
20
22
|
export async function releaseNotesCommand(env: CommandEnv): Promise<number> {
|
|
21
23
|
const { ctx, out, args, o, actor } = env;
|
|
@@ -44,7 +46,7 @@ export async function releaseNotesCommand(env: CommandEnv): Promise<number> {
|
|
|
44
46
|
const d = await releaseNoteDetail(ctx, need());
|
|
45
47
|
return out.result(d, () => {
|
|
46
48
|
const lines = [`${d.material.milestone.id} ${d.material.milestone.title}${d.material.milestone.done ? "(リリース済み)" : ""}`, ""];
|
|
47
|
-
lines.push(...materialLines(d.material), "");
|
|
49
|
+
lines.push(...materialLines(d.material), "", ...completionLines(d.completion), "");
|
|
48
50
|
if (d.noteError) lines.push(`ノート: 読めません(${d.noteError})`, " 直すまで新しく保存できません。frontmatter を直すか、本文を退避してファイルを消してください");
|
|
49
51
|
else if (!d.note) lines.push("ノート: まだありません(p3 release-notes generate → save)");
|
|
50
52
|
else {
|
|
@@ -104,8 +106,30 @@ export async function releaseNotesCommand(env: CommandEnv): Promise<number> {
|
|
|
104
106
|
return 0;
|
|
105
107
|
}
|
|
106
108
|
|
|
109
|
+
case "complete-requests": {
|
|
110
|
+
const id = need();
|
|
111
|
+
const basedOn = o["based-on"];
|
|
112
|
+
if (!basedOn) throw new UsageError(`判定を確かめた材料の hash を --based-on で指定してください(p3 release-notes show ${shellArg(id)} --json の completion.basedOn)`);
|
|
113
|
+
try {
|
|
114
|
+
const r = await completeMilestoneRequests(ctx, id, basedOn, actor);
|
|
115
|
+
out.result(r, () =>
|
|
116
|
+
[
|
|
117
|
+
r.completed.length ? `完了済にしました(${r.completed.length} 件):` : r.failed ? "完了済にした要望はありません" : "完了済にする要望はありません(変えていません)",
|
|
118
|
+
...r.completed.map((t) => ` ${t.id} ${t.title}`),
|
|
119
|
+
...(r.failed ? [`止まりました: ${r.failed.id}(${r.failed.reason})`, ...(r.notRun.length ? [`まだ変えていません: ${r.notRun.join(", ")}`] : []), `やり直すには show で読み直してから、表示された --based-on で実行してください`] : []),
|
|
120
|
+
].join("\n"),
|
|
121
|
+
);
|
|
122
|
+
return r.failed ? (r.failed.code === "error" ? 1 : 3) : 0;
|
|
123
|
+
} catch (e) {
|
|
124
|
+
if (!(e instanceof CompletionRejected)) throw e;
|
|
125
|
+
if (out.json) out.result({ error: e.message, code: e.code, plan: e.plan }, () => "");
|
|
126
|
+
else process.stderr.write(`${[e.message, ...completionLines(e.plan)].join("\n")}\n`);
|
|
127
|
+
return e.code === "material_changed" ? 3 : 1;
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
|
|
107
131
|
default:
|
|
108
|
-
throw new UsageError("p3 release-notes [ls | show <id> | generate <id> | save <id> | export <id>]");
|
|
132
|
+
throw new UsageError("p3 release-notes [ls | show <id> | generate <id> | save <id> | export <id> | complete-requests <id> --based-on <hash>]");
|
|
109
133
|
}
|
|
110
134
|
}
|
|
111
135
|
|
|
@@ -127,6 +151,21 @@ function materialLines(m: ReleaseMaterial): string[] {
|
|
|
127
151
|
];
|
|
128
152
|
}
|
|
129
153
|
|
|
154
|
+
/** 要望を一括で完了済にできるか(show と、頼めなかったとき) */
|
|
155
|
+
function completionLines(p: RequestCompletionPlan): string[] {
|
|
156
|
+
const head = !p.ready
|
|
157
|
+
? "要望の一括完了: できません(見送り以外の全要望が、全タスク完了の対応済か完了済になってから)"
|
|
158
|
+
: p.targets.length
|
|
159
|
+
? `要望の一括完了: 対応済 ${p.targets.length} 件を完了済にできます(タスクの済みは変えません)`
|
|
160
|
+
: "要望の一括完了: 完了済にする要望はありません";
|
|
161
|
+
return [
|
|
162
|
+
head,
|
|
163
|
+
...p.blockers.map((b) => ` ✕ ${b.target}: ${b.reason}`),
|
|
164
|
+
...p.targets.map((t) => ` → ${t.id} ${t.title}`),
|
|
165
|
+
...(p.ready && p.targets.length ? [` 実行: p3 release-notes complete-requests ${shellArg(p.milestone)} --based-on ${p.basedOn}`] : []),
|
|
166
|
+
];
|
|
167
|
+
}
|
|
168
|
+
|
|
130
169
|
function flushLog(g: ReleaseGeneration, from: number): number {
|
|
131
170
|
for (const e of g.log.slice(from)) process.stderr.write(`[${e.kind}] ${e.text}\n`);
|
|
132
171
|
return g.log.length;
|
|
@@ -8,6 +8,7 @@ import { requestWorkstreams, taskRepo } from "../shared/workTarget.ts";
|
|
|
8
8
|
import { briefRequest, formatBriefRequest } from "./showView.ts";
|
|
9
9
|
import { UsageError } from "./project.ts";
|
|
10
10
|
import { tagsFrom } from "../shared/tags.ts";
|
|
11
|
+
import { sortMilestones } from "../shared/milestoneOrder.ts";
|
|
11
12
|
import { parse, splitPair, list, date, readBody, readAttachFiles } from "./args.ts";
|
|
12
13
|
import { Output, formatEntity, deps } from "./output.ts";
|
|
13
14
|
|
|
@@ -160,10 +161,11 @@ export async function milestoneCommand(ctx: P3Context, out: Output, args: string
|
|
|
160
161
|
return out.result({ removed: id }, () => `外しました: ${id}`);
|
|
161
162
|
}
|
|
162
163
|
if (sub && sub !== "ls" && sub !== "list") throw new UsageError("p3 milestone [ls | add <id> | set <id> | rm <id>]");
|
|
164
|
+
const shown = sortMilestones(ms);
|
|
163
165
|
return out.result(
|
|
164
|
-
|
|
166
|
+
shown,
|
|
165
167
|
() =>
|
|
166
|
-
table(
|
|
168
|
+
table(shown.map((m) => [m.id, m.title, m.due ?? "", m.done ? "済" : "", `要望 ${count(m.id)}`])) ||
|
|
167
169
|
"マイルストーンはありません(p3 milestone add v0.1 --title 最初のリリース --due 2026-11-30)",
|
|
168
170
|
);
|
|
169
171
|
}
|
package/src/cli/taskCommands.ts
CHANGED
|
@@ -16,7 +16,7 @@ import { requestCommand } from "./requestCommands.ts";
|
|
|
16
16
|
|
|
17
17
|
const RECORD_REQUIRED =
|
|
18
18
|
"AI が完了にするときは --record で変更の記録を残してください(何を変えたか・なぜ・入れた決まり・やめたもの。Markdown。- で標準入力)\n" +
|
|
19
|
-
" 例: p3 move T003 done --output
|
|
19
|
+
" 例: p3 move T003 done --output <成果物(変えたファイルや説明。URL は後から足せます)> --record - < record.md";
|
|
20
20
|
|
|
21
21
|
export async function taskCommand(cmd: string, env: CommandEnv): Promise<number | undefined> {
|
|
22
22
|
const { ctx, out, args, o, actor, current, expectedRev, requestArg, taskArg, split, cwd } = env;
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
import type { ReleaseMaterial, RequestCompletionPlan, RequestCompletionResult } from "../../shared/types.ts";
|
|
2
|
+
import type { P3Context } from "../context.ts";
|
|
3
|
+
import { updateRequest } from "../requestOps.ts";
|
|
4
|
+
import { resolveBlocker } from "../requestStatus.ts";
|
|
5
|
+
import { ConflictError } from "../store/collection.ts";
|
|
6
|
+
import { Workspace } from "../store/workspace.ts";
|
|
7
|
+
import { materialOf } from "./material.ts";
|
|
8
|
+
import { checkMilestoneId, ReleaseNoteError } from "./store.ts";
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* マイルストーンの要望を一括で完了済にする。規則はここだけに置く(CLI・API・画面は判定を見せて、表示したときの材料の hash で頼むだけ)。
|
|
12
|
+
*
|
|
13
|
+
* - 判定は材料(material.ts の収録の条件)と同じ: 見送りを除く全要望が収録できる(対応済か完了済・タスクが1件以上で全部完了・
|
|
14
|
+
* 読めないタスクなし)ときだけできる。マイルストーンが project.yaml に無い・所属の分からない読めない要望があればできない
|
|
15
|
+
* - 変えるのは対応済(resolved)の要望のステータスだけ(→ done)。完了済・見送り・アーカイブした要望、タスク(状態・済み)、
|
|
16
|
+
* マイルストーン、ノートは変えない。変更の記録が無い・ノートを保存していない・済みが無いことは条件にしない
|
|
17
|
+
* - 実行はディスクから読み直した材料で判定し直し、表示したときの hash と違えば何も書かない(material_changed)。できなければ
|
|
18
|
+
* 何も書かない(blocked)
|
|
19
|
+
* - 複数のファイルをまとめて書く仕組みは無いので、1件ずつ書く。書く直前に、タスクを読み直して確かめ、要望は判定したときの rev で
|
|
20
|
+
* 書く(違えば競合)。途中で失敗したら止め、完了済にしたもの・失敗した1件・まだ変えていないものを返す(戻さない。外の変更を
|
|
21
|
+
* 上書きしないため)。やり直しは、取り直した判定でもう一度頼む(完了済にしたものは対象から外れ、書き直さない)
|
|
22
|
+
*/
|
|
23
|
+
|
|
24
|
+
/** 材料から判定する(書かない) */
|
|
25
|
+
export function completionPlanOf(material: ReleaseMaterial): RequestCompletionPlan {
|
|
26
|
+
const plan: RequestCompletionPlan = { milestone: material.milestone.id, basedOn: material.hash, ready: false, targets: [], alreadyDone: [], skipped: [], blockers: [] };
|
|
27
|
+
if (!material.milestone.known) plan.blockers.push({ target: material.milestone.id, reason: `マイルストーン ${material.milestone.id} は project.yaml にありません` });
|
|
28
|
+
for (const w of material.warnings.filter((x) => x.code === "broken_request")) plan.blockers.push({ target: w.target, reason: w.message });
|
|
29
|
+
for (const r of material.requests) {
|
|
30
|
+
if (r.status === "rejected") plan.skipped.push(r.id);
|
|
31
|
+
else if (!r.included) {
|
|
32
|
+
const open = r.tasks.filter((t) => t.status !== "done").map((t) => `${t.id}(${t.status})`);
|
|
33
|
+
const detail = r.reason === "完了していないタスクがある" && open.length ? `: ${open.join(", ")}` : "";
|
|
34
|
+
plan.blockers.push({ target: r.id, reason: `${r.title}(${r.id}): ${r.reason ?? "収録できません"}${detail}` });
|
|
35
|
+
}
|
|
36
|
+
else if (r.status === "resolved") plan.targets.push({ id: r.id, title: r.title });
|
|
37
|
+
else plan.alreadyDone.push(r.id);
|
|
38
|
+
}
|
|
39
|
+
plan.ready = plan.blockers.length === 0;
|
|
40
|
+
return plan;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/** 頼めない(何も書いていない)。material_changed: 表示したときの材料と違う / blocked: 未完了などがある。plan は今の判定 */
|
|
44
|
+
export class CompletionRejected extends Error {
|
|
45
|
+
constructor(
|
|
46
|
+
readonly code: "material_changed" | "blocked",
|
|
47
|
+
message: string,
|
|
48
|
+
readonly plan: RequestCompletionPlan,
|
|
49
|
+
) {
|
|
50
|
+
super(message);
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/** 今の判定(ディスクから読み直す) */
|
|
55
|
+
export async function completionPlan(ctx: P3Context, mid: string): Promise<RequestCompletionPlan> {
|
|
56
|
+
return (await snapshot(ctx, mid)).plan;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/** 一括で完了済にする。basedOn は判定を見せたときの材料の hash(必須) */
|
|
60
|
+
export async function completeMilestoneRequests(ctx: P3Context, mid: string, basedOn: string, actor?: string): Promise<RequestCompletionResult> {
|
|
61
|
+
const { snap, plan } = await snapshot(ctx, mid);
|
|
62
|
+
if (plan.basedOn !== basedOn) {
|
|
63
|
+
throw new CompletionRejected("material_changed", "表示したあとで、このマイルストーンの要望・タスクが変わりました。何も変えていません。読み直して確かめてから、もう一度実行してください", plan);
|
|
64
|
+
}
|
|
65
|
+
if (!plan.ready) {
|
|
66
|
+
throw new CompletionRejected("blocked", `完了済にできません(何も変えていません): ${plan.blockers.map((b) => b.reason).join(" / ")}`, plan);
|
|
67
|
+
}
|
|
68
|
+
const result: RequestCompletionResult = { milestone: mid, completed: [], notRun: [], alreadyDone: plan.alreadyDone };
|
|
69
|
+
for (const [i, t] of plan.targets.entries()) {
|
|
70
|
+
try {
|
|
71
|
+
// タスクの変更は要望の rev に出ないので、書く直前に読み直して確かめる。要望(所属・状態)は判定したときの rev で確かめる
|
|
72
|
+
const why = await resolveBlocker(ctx.ws, t.id);
|
|
73
|
+
if (why) {
|
|
74
|
+
result.failed = { id: t.id, reason: why, code: "changed" };
|
|
75
|
+
} else {
|
|
76
|
+
await updateRequest(ctx, t.id, { status: "done" }, { expectedRev: snap.requests.require(t.id).rev, actor });
|
|
77
|
+
result.completed.push(t);
|
|
78
|
+
continue;
|
|
79
|
+
}
|
|
80
|
+
} catch (e) {
|
|
81
|
+
result.failed =
|
|
82
|
+
e instanceof ConflictError
|
|
83
|
+
? { id: t.id, reason: `判定したあとで要望が変わりました(${(e as Error).message})`, code: "conflict" }
|
|
84
|
+
: { id: t.id, reason: (e as Error).message, code: "error" };
|
|
85
|
+
}
|
|
86
|
+
result.notRun = plan.targets.slice(i + 1).map((x) => x.id);
|
|
87
|
+
break;
|
|
88
|
+
}
|
|
89
|
+
return result;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/** ディスクから読み直した状態で、材料と判定を作る。project.yaml に無く、ノートも無いマイルストーンは not_found */
|
|
93
|
+
async function snapshot(ctx: P3Context, mid: string) {
|
|
94
|
+
checkMilestoneId(mid);
|
|
95
|
+
const snap = new Workspace(ctx.ws.dataDir);
|
|
96
|
+
await snap.load();
|
|
97
|
+
const material = materialOf(snap, mid);
|
|
98
|
+
if (!material.milestone.known && !(await ctx.ws.releaseNotes.ids()).includes(mid)) {
|
|
99
|
+
throw new ReleaseNoteError("not_found", mid, `マイルストーンがありません: ${mid}`);
|
|
100
|
+
}
|
|
101
|
+
return { snap, material, plan: completionPlanOf(material) };
|
|
102
|
+
}
|
|
@@ -1,8 +1,10 @@
|
|
|
1
|
-
import type { ReleaseGeneration, ReleaseMaterial, ReleaseNote, ReleaseNoteSummary, ReleaseWarning } from "../../shared/types.ts";
|
|
1
|
+
import type { ReleaseGeneration, ReleaseMaterial, ReleaseNote, ReleaseNoteSummary, ReleaseWarning, RequestCompletionPlan } from "../../shared/types.ts";
|
|
2
2
|
import type { P3Context } from "../context.ts";
|
|
3
3
|
import { extractMaterial } from "./material.ts";
|
|
4
4
|
import type { SummaryEngine } from "./generate.ts";
|
|
5
5
|
import { checkMilestoneId, ReleaseNoteError } from "./store.ts";
|
|
6
|
+
import { compareMilestoneIds, sortMilestones } from "../../shared/milestoneOrder.ts";
|
|
7
|
+
import { completionPlanOf } from "./completeRequests.ts";
|
|
6
8
|
|
|
7
9
|
/**
|
|
8
10
|
* リリースノートの操作(CLI と API はここを呼ぶ)。材料の規則は material.ts、保存の形は store.ts。
|
|
@@ -11,7 +13,7 @@ import { checkMilestoneId, ReleaseNoteError } from "./store.ts";
|
|
|
11
13
|
* 保存では、そのときディスクにある材料を出典として固定する(本文の元にした材料が古ければ material_changed で知らせる)。
|
|
12
14
|
*/
|
|
13
15
|
|
|
14
|
-
/**
|
|
16
|
+
/** マイルストーンごとのノートの有無。並びは登録したマイルストーンを ID のバージョンの降順(shared/milestoneOrder.ts)、その後ろに project.yaml に無いノート(同じ降順) */
|
|
15
17
|
export async function releaseOverview(ctx: P3Context): Promise<{ milestones: ReleaseNoteSummary[]; warnings: ReleaseWarning[] }> {
|
|
16
18
|
const { ws } = ctx;
|
|
17
19
|
const count = (mid: string) => ws.requests.list().filter((r) => r.milestone === mid).length;
|
|
@@ -26,8 +28,8 @@ export async function releaseOverview(ctx: P3Context): Promise<{ milestones: Rel
|
|
|
26
28
|
return { state: "invalid", error: (e as Error).message };
|
|
27
29
|
}
|
|
28
30
|
};
|
|
29
|
-
const known = ws.project.milestones;
|
|
30
|
-
const orphans = ids.filter((id) => !known.some((m) => m.id === id));
|
|
31
|
+
const known = sortMilestones(ws.project.milestones);
|
|
32
|
+
const orphans = ids.filter((id) => !known.some((m) => m.id === id)).sort(compareMilestoneIds);
|
|
31
33
|
const milestones: ReleaseNoteSummary[] = [
|
|
32
34
|
...(await Promise.all(known.map(async (m) => ({ milestone: m.id, title: m.title, due: m.due, done: m.done, known: true, requests: count(m.id), note: await noteState(m.id) })))),
|
|
33
35
|
...(await Promise.all(orphans.map(async (id) => ({ milestone: id, title: id, known: false, requests: count(id), note: await noteState(id) })))),
|
|
@@ -58,6 +60,8 @@ export interface ReleaseNoteDetail {
|
|
|
58
60
|
material: ReleaseMaterial;
|
|
59
61
|
/** 保存のあとで材料が変わった(ノートが無ければ false) */
|
|
60
62
|
materialChanged: boolean;
|
|
63
|
+
/** 要望を一括で完了済にできるか(この材料で判定。実行は completion.basedOn を添えて頼む) */
|
|
64
|
+
completion: RequestCompletionPlan;
|
|
61
65
|
}
|
|
62
66
|
|
|
63
67
|
export async function releaseNoteDetail(ctx: P3Context, mid: string): Promise<ReleaseNoteDetail> {
|
|
@@ -69,7 +73,7 @@ export async function releaseNoteDetail(ctx: P3Context, mid: string): Promise<Re
|
|
|
69
73
|
} catch (e) {
|
|
70
74
|
if (!(e instanceof ReleaseNoteError && e.code === "not_found")) noteError = (e as Error).message;
|
|
71
75
|
}
|
|
72
|
-
return { note, noteError, material, materialChanged: !!note && note.materialHash !== material.hash };
|
|
76
|
+
return { note, noteError, material, materialChanged: !!note && note.materialHash !== material.hash, completion: completionPlanOf(material) };
|
|
73
77
|
}
|
|
74
78
|
|
|
75
79
|
export interface SaveInput {
|
|
@@ -98,7 +98,14 @@ export const AI_MANIFEST = {
|
|
|
98
98
|
{
|
|
99
99
|
method: "GET",
|
|
100
100
|
path: "/api/release-notes/:mid",
|
|
101
|
-
desc: "保存したノート {note(本文・出典・版 version), noteError(読めない理由), material(対象の要望・収録の可否・警告・材料の hash), materialChanged
|
|
101
|
+
desc: "保存したノート {note(本文・出典・版 version), noteError(読めない理由), material(対象の要望・収録の可否・警告・材料の hash), materialChanged(保存のあとで材料が変わった), completion(要望を一括で完了済にできるか {ready, targets, alreadyDone, skipped, blockers, basedOn})}",
|
|
102
|
+
},
|
|
103
|
+
{
|
|
104
|
+
method: "POST",
|
|
105
|
+
path: "/api/release-notes/:mid/complete-requests",
|
|
106
|
+
desc:
|
|
107
|
+
"対応済の要望を一括で完了済にする {basedOn: completion.basedOn}。見送り以外の全要望が全タスク完了のときだけ。タスク(済み)・ノート・マイルストーンは変えない。" +
|
|
108
|
+
"材料が変わった・できないときは何も書かずに 409 code: material_changed / blocked {plan}。途中で止まったら 409 code: partial {result: completed, failed, notRun}",
|
|
102
109
|
},
|
|
103
110
|
{
|
|
104
111
|
method: "PUT",
|