@infodb/p3 0.10.0 → 0.11.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 +2 -0
- package/dist/web/assets/{Outputs-B4Tr7JzU.js → Outputs-ddwte0jj.js} +1 -1
- package/dist/web/assets/{RequestStatus-DGaoQoIa.js → RequestStatus-Bg1OLbRc.js} +1 -1
- package/dist/web/assets/{Tabs-D16MqQxu.js → Tabs-DTmggzgg.js} +1 -1
- package/dist/web/assets/{TagInput-pSYxm4bz.js → TagInput-BHAgjLP7.js} +1 -1
- package/dist/web/assets/{TaskDrawer-1Ev3RpRV.js → TaskDrawer-Dz_5c2NH.js} +1 -1
- package/dist/web/assets/{_requestId-BKhn019m.js → _requestId-D9-gtIcG.js} +1 -1
- package/dist/web/assets/{_requestId-Btpvuu7-.js → _requestId-DzCNYvqf.js} +1 -1
- package/dist/web/assets/{appCtx-D_Iaoh2e.js → appCtx-Cm24VpAf.js} +1 -1
- package/dist/web/assets/{board-DeHdxbN4.js → board-MCHcZ-PU.js} +1 -1
- package/dist/web/assets/{done-BFaHGt03.js → done-zq10Bt08.js} +1 -1
- package/dist/web/assets/{index-CDWcKy1L.js → index-Ce0ndpne.js} +3 -3
- package/dist/web/assets/index-D68mkSnw.css +2 -0
- package/dist/web/assets/{new-ChFzBoL2.js → new-9TKiNT4O.js} +1 -1
- package/dist/web/assets/{preload-helper-hSId95YD.js → preload-helper-FBLw7u7x.js} +1 -1
- package/dist/web/assets/release-notes-hK5XezLW.js +5 -0
- package/dist/web/assets/{requestData-B_320uxL.js → requestData-BnN7mctX.js} +1 -1
- package/dist/web/assets/{routes-BBD464IS.js → routes-usHwrrA0.js} +1 -1
- package/dist/web/assets/{settings-D7PPrGjT.js → settings-BVZDnL6O.js} +1 -1
- package/dist/web/index.html +4 -4
- package/docs/architecture.md +77 -1
- package/docs/how-to-use.md +77 -5
- package/docs/installation.md +5 -5
- package/lib/cli/help.js +7 -0
- package/lib/cli/main.js +16 -2
- package/lib/cli/requestCommands.js +207 -14
- package/lib/core/context.js +4 -1
- package/lib/core/milestoneReview/code.js +129 -0
- package/lib/core/milestoneReview/material.js +138 -0
- package/lib/core/milestoneReview/mockReviewer.js +27 -0
- package/lib/core/milestoneReview/review.js +261 -0
- package/lib/core/milestoneReview/service.js +278 -0
- package/lib/core/milestoneReview/store.js +226 -0
- package/lib/core/preflight/codexEngine.js +20 -6
- package/lib/core/projectRegistry.js +3 -3
- package/lib/core/requestOps.js +4 -0
- package/lib/core/store/normalize.js +27 -1
- package/lib/core/store/projectFile.js +8 -1
- package/lib/core/store/workspace.js +89 -11
- package/lib/server/api/manifest.js +19 -1
- package/lib/server/api/milestoneReviewRoutes.js +69 -0
- package/lib/server/api/routes.js +19 -3
- package/lib/server/server.js +2 -2
- package/lib/shared/milestoneGoals.js +57 -0
- package/lib/shared/milestoneReview.js +26 -0
- package/package.json +1 -1
- package/dist/web/assets/index-BF1xMdJo.css +0 -2
- package/dist/web/assets/release-notes-BWNDFDkH.js +0 -3
package/docs/architecture.md
CHANGED
|
@@ -333,7 +333,7 @@ include: true
|
|
|
333
333
|
`ui.theme`)だけを変えて書く(`updateUserConfig`)。init・project add / rm・テーマの保存が同じ経路を通るので、
|
|
334
334
|
CLI と serve が同時に書いても消し合わない。壊れた YAML・読めないファイルは書かずにエラーにする(無いのとは区別する)。
|
|
335
335
|
ChatGPT の接続(`chatgpt.json`)は別のファイル・別のロックのまま
|
|
336
|
-
- 1人1
|
|
336
|
+
- 1人1つのサーバで画面からプロジェクトを切り替える形は `p3 serve --all-projects` で入れた(下の「プロジェクトを跨ぐ serve」)
|
|
337
337
|
|
|
338
338
|
### 要望・タスクのデータ
|
|
339
339
|
|
|
@@ -358,6 +358,80 @@ include: true
|
|
|
358
358
|
ディスクを読むので扱わない。応答は読み直しを終えた後(画面はその後に取り直す)。ほかの serve・CLI が同時に書いている
|
|
359
359
|
最中のファイルは、読んだ時点の内容になる(次の読み直しで追いつく)
|
|
360
360
|
|
|
361
|
+
### マイルストーンの目的と予定機能
|
|
362
|
+
|
|
363
|
+
- project.yaml の `milestones` の各項目に、任意の `purpose`(複数行の文字列)と `goals`(`{ id, text }` の並び)を書く
|
|
364
|
+
(型は `shared/types.ts` の `Milestone`、規則は `shared/milestoneGoals.ts`)。無い古いファイルは空として読み、空は書かない。
|
|
365
|
+
予定機能の ID は足したときに `G<最大の番号 + 1>` を振り、並べ替え・文言の変更では変えない(後のレビューの比較単位の名前になる)
|
|
366
|
+
- 保存はどの道(画面・API・CLI・`p3 config`)も `Workspace.saveProject` / `updateMilestones` を通す。プロセスの間はロックのファイル
|
|
367
|
+
(`<データのフォルダ>/.project.yaml.lock`。`fsutil.ts` の `withFileLock`)で1つずつにし、ロックの中で最新の project.yaml を読み、
|
|
368
|
+
渡された項目だけを重ねて書く。件数・文字数・空・重複はここで確かめる(`ProjectInputError`。何も書かない)
|
|
369
|
+
- 版: `milestonesVersion` はマイルストーンの中身(ID・名前・期限・リリース済み・目的・予定機能と並び)のハッシュ(ファイルの書き方や
|
|
370
|
+
ほかの設定の項目は入れない)。`GET /api/project` が返し、画面は編集を始めたときの版を保存に付ける。版を付けた保存はロックの中で
|
|
371
|
+
最新と照らし、違えば `MilestonesConflictError`(API は 409 `milestones_conflict`、CLI は終了コード 3)で何も書かない。CLI の
|
|
372
|
+
`milestone` の操作はロックの中で読んだ最新の並びの対象の項目だけを変え(指定した項目のほかを巻き戻さない)、`--version` を
|
|
373
|
+
付けたときだけ照らす
|
|
374
|
+
- 版の無い古い道(目的を知らない画面・API の呼び出し)が `purpose` / `goals` のキーの無い項目を送ったら、同じ ID の今の値を残す
|
|
375
|
+
(消すには空か null を送る)。ID を変えた項目は引き継がない
|
|
376
|
+
- 限界: ロックと版は p3 を通した保存どうしの競合を防ぐだけで、エディタで project.yaml を直接書き換えるのは防げない(画面は外の変更を
|
|
377
|
+
知らせ、次の保存で版が合わずに断る)。目的・予定機能を知らない古い p3 で保存すると、どちらも project.yaml から消える。データを
|
|
378
|
+
共有する人は p3 の版をそろえる
|
|
379
|
+
|
|
380
|
+
### マイルストーンレビューのデータ
|
|
381
|
+
|
|
382
|
+
レビューは、保存してあるマイルストーンの目的・予定機能に対して、Codex が参照先のリポジトリのコードと git の履歴を読み、実装が目的を
|
|
383
|
+
果たしているか・目的に無い変更が無いかを確かめる参考の記録(操作は [使い方ガイド](how-to-use.md#マイルストーンレビュー))。所属する
|
|
384
|
+
要望・タスクの記録は実装した人の自己申告として、どこを見るかの手がかりにする(記録の要約で終わらせない)。比較材料の抽出は
|
|
385
|
+
`core/milestoneReview/material.ts`(コードの材料は `code.ts`)、履歴は `core/milestoneReview/store.ts`、形は `shared/milestoneReview.ts`。
|
|
386
|
+
リリースノートの材料(`releaseNotes/material.ts`)の収録の条件は変えない。
|
|
387
|
+
|
|
388
|
+
- **範囲**: マイルストーンに直接属する要望の全部の状態(見送り・未完了も)。要望の本文、各タスクの本文・状態・変更の記録・成果物の
|
|
389
|
+
参照の文字列(URL や添付の中身は読まない)。親・子が別のマイルストーンなら文脈(`context`。ID・題・状態だけ)として持ち、
|
|
390
|
+
直接の材料に数えない。アーカイブした要望は通常の一覧と同じく含めない。比較単位は予定機能で、予定機能が無く目的だけなら
|
|
391
|
+
目的そのもの(`purpose`)
|
|
392
|
+
- **コードの材料**(`code.ts`): 参照先(`Workspace.refs()`。Preflight と同じ解決)ごとに、状態・git の履歴の有無・HEAD・ブランチ・
|
|
393
|
+
未コミットの変更の数と中身の識別子(差分と追跡していないファイルの中身の hash。参照先の中のデータのフォルダは数えない)と、タスクの成果物に残したコミット(`…/commit/<sha>` か sha。
|
|
394
|
+
`<参照先>: ` の付いた成果物はその参照先)が履歴にあるかを `input.json` の `code` に固定する。コードの中身は保存しない
|
|
395
|
+
(そのときの作業ツリーを読んだことが HEAD と未コミットの変更の識別子で分かる)。git は読むだけの操作だけ。読めない参照先は `code_unavailable`、
|
|
396
|
+
未コミットの変更は `dirty_worktree`、見つからないコミットは `commit_missing`、読める参照先が無ければ `no_code` の警告にし、
|
|
397
|
+
範囲を「記録だけ」(`REVIEW_SCOPE_RECORDS_ONLY`)にする
|
|
398
|
+
- **欠落**: 読めない要望は所属が分からないので全体の警告(`broken_request`)、読めないタスクはその要望の欠落(`broken_task`)。
|
|
399
|
+
完了して記録の無いタスク・要望 0 件・目的も予定機能も無いことも警告に残す(材料から省かない)
|
|
400
|
+
- **ファイル**: `<data>/milestone-reviews/<マイルストーン>/<run>/` に `input.json`(固定した材料。抽出の始めと終わり・範囲・警告・
|
|
401
|
+
hash・コードの材料)、`run.json`(状態・実行者・エンジン・開始と終了・所有者・失敗の理由・取消の要求・ログ)、`review.json`(全体の
|
|
402
|
+
所見と、比較単位ごとの判定・理由・根拠・不足、意図しない変更の候補 `unplanned`)。run の ID は `MR-YYYYMMDD-HHMMSS-xxxx`。
|
|
403
|
+
`code`・`unplanned` の無い古い記録もそのまま読める
|
|
404
|
+
- **整合**: 状態は `running` → `completed` / `failed` / `cancelled` の一方向。状態を変えるのはマイルストーンごとのロック
|
|
405
|
+
(`milestone-reviews/.locks/<ID>.lock`)の中だけで、終わった run は変えない。`completed` は `review.json` を書き終えてから
|
|
406
|
+
`run.json` を書く。ファイルは tmp に書いて rename する。ID は形を確かめ(`.`・`..`・保存先の外は不可)、同じ run は作り直さない。
|
|
407
|
+
読めない記録は「無い」と分け(`broken` / `not_found`)、一覧から隠さない
|
|
408
|
+
- **hash**: 目的・予定機能・所属・本文・状態・記録・関係・欠落と、参照先の HEAD・ブランチ・未コミットの変更の中身・コミットから作り、抽出の日時は入れない。今の材料と比べて変わっていても、
|
|
409
|
+
過去の `input.json`・`review.json` は変えない。複数のファイルを同じ時点で読んだとは保証しない(抽出の始めと終わりを残す)
|
|
410
|
+
- **保護**: 履歴のあるマイルストーンは消せず、ID も変えられない(`requestOps.ts` の `checkMilestoneRemoval`)。project.yaml を直接
|
|
411
|
+
編集して定義が消えても、履歴は孤立として一覧・閲覧できる
|
|
412
|
+
- 抽出と履歴の保存は、要望の状態・リリースノート・リリース済みを変えない
|
|
413
|
+
- **実行**(`core/milestoneReview/service.ts`・依頼文と確かめ方は `review.ts`): Preflight と同じ Codex の接続の `ask` に、材料を
|
|
414
|
+
取り出したときに読めた参照先を渡し、Preflight と同じく `/workspace/<名前>` に読むだけでマウントする(データのフォルダは渡さない。
|
|
415
|
+
認証・診断・パスの対応・使用量の上限・取消を共有)。Mock は明示したときだけで、失敗しても切り替えない。依頼文では、記録を自己申告
|
|
416
|
+
として手がかりにとどめ、予定機能ごとに実装を読んで判断する・コミットの差分から目的に無い変更を挙げる・書き込みやテストとアプリの
|
|
417
|
+
実行をしない・タスクの完了数を達成の証明にしない・数値の達成率を出さないことを指示する。結果は JSON で受け、取り込む前に形・
|
|
418
|
+
全部の比較単位がちょうど1回ずつ・区分・件数・文字数と根拠を確かめる: 記録の根拠は資料の参照にあるか、コードの根拠
|
|
419
|
+
(`<参照先>:<パス>[:行]`・`<参照先>@<コミット>`)は読めた参照先の中の相対パスで実在するか・履歴にあるコミットか。読める参照先が
|
|
420
|
+
あるのに「達成」の根拠にコードが無い結果、読める参照先が無いのに「達成」とした結果も使わない(どれも `invalid_output` で失敗)。
|
|
421
|
+
入力が上限(`REVIEW_INPUT_LIMIT`)を超えたら切り詰めずに断る
|
|
422
|
+
- **1つずつ**: 同じデータ・同じマイルストーンで実行中の run は1つだけ(開始はマイルストーンのロックの中で、実行中の run が無いことを
|
|
423
|
+
確かめてから作る。CLI の別プロセスと serve の同時の開始でも片方だけ)。別のマイルストーンは独立
|
|
424
|
+
- **所有者と回復**: run.json に実行しているプロセス(`preflight/owner.ts`)を書き、死んだと確かめられた run(`dead`)だけ失敗
|
|
425
|
+
(`crashed`)にする。分からない・ほかの環境の run(`unknown`)は自動で終わりにせず、人が `--acknowledge-stopped`(画面では
|
|
426
|
+
明示の中断)で記録の上で中断にできる(動いていると確かめられる所有者がいれば断る。ほかの環境のプロセスを止めたとは限らない)
|
|
427
|
+
- **取消**: このプロセスの run は止める。ほかのプロセスの run は `cancelRequested` を書き、所有者が見つけて止める(所有者は1秒ごとに
|
|
428
|
+
run.json を読み、ログも書き足す)。終わりの状態はロックの中でまだ実行中かを確かめて書くので、中断の後に届いた結果は取り込まない
|
|
429
|
+
- **組み込み**: `P3Context.milestoneReview`。通常の serve と、プロジェクトを跨ぐ serve の停止・登録の解除は、Preflight・要約の生成と
|
|
430
|
+
同じく実行中のレビューを取り消して(解除は待って)から閉じる。変更通知は `milestone-review`(ほかのプロセスが書いた履歴の変化も
|
|
431
|
+
ファイルの監視で知らせる)
|
|
432
|
+
- レビューの実施の有無・結果は、要望の完了・リリースの条件にしない。人の承認の状態・タスクの自動作成・複数のマイルストーンを
|
|
433
|
+
まとめたレポートは持たない
|
|
434
|
+
|
|
361
435
|
### リリースノートのデータ
|
|
362
436
|
|
|
363
437
|
マイルストーンごとに1件、`<data>/release-notes/<マイルストーンID>.md` に置く(`core/releaseNotes/`)。要望のフォルダの外に
|
|
@@ -657,6 +731,8 @@ src は5つの層に分け、依存の向きを `test/layers.test.ts` で確か
|
|
|
657
731
|
| プロジェクトを跨ぐ serve(登録の一覧・登録世代・文脈の開閉) | `core/projectRegistry.ts`(API は `server/api/projectsRoutes.ts`) |
|
|
658
732
|
| Preflight を通さずにタスクを作る道の案内(付かないものの言い方・失敗と取消の見分け。取消は `PREFLIGHT_CANCELLED` で残す) | `shared/directTask.ts`(CLI の案内文は `cli/output.ts` の `directTaskHint`) |
|
|
659
733
|
| マイルストーンの表示の順(ID のバージョンの降順。CLI・API・画面の一覧と選ぶ欄。project.yaml の順は変えない) | `shared/milestoneOrder.ts` |
|
|
734
|
+
| マイルストーンレビュー(材料の範囲・履歴の保存・依頼文と結果の確かめ方・実行の排他と回復) | `core/milestoneReview/`(`material.ts`・`store.ts`・`review.ts`・`service.ts`) |
|
|
735
|
+
| マイルストーンの目的・予定機能(件数・文字数・空・重複・ID の振り方) | `shared/milestoneGoals.ts`(保存の排他と版の照合は `core/store/workspace.ts` の `saveProject`) |
|
|
660
736
|
|
|
661
737
|
CLI は `cli/main.ts`(振り分け・プロジェクトと変更者の決定・終了コード)と、種類ごとのコマンド(`taskCommands.ts`・
|
|
662
738
|
`requestCommands.ts`・`preflightCommands.ts`)に分ける。大きい画面は、ルートのファイルを組み立てだけにして部品を
|
package/docs/how-to-use.md
CHANGED
|
@@ -479,6 +479,20 @@ Preflight は始めたときの内容を固定して評価する。**評価の
|
|
|
479
479
|
project.yaml に無いリリースノートは最後。リリースノートの画面は、指定(`?m=`)が無ければ先頭を開く
|
|
480
480
|
- project.yaml の順は表示のために変えない(足した順のまま)。マイルストーンのタブは開いたときに降順に並べ、編集の間は行を動かさない
|
|
481
481
|
(ID を書き換えても、足した行は最後のまま)。保存すると並べ直す
|
|
482
|
+
- **目的と予定している機能・目標**: マイルストーンごとに、目指すこと(目的。複数行)と予定している機能・目標の一覧を書ける。
|
|
483
|
+
どちらも任意で、片方だけでもよい。リリース済みにした後も、いつでも書き足し・直しができる。マイルストーンのレビューは、
|
|
484
|
+
その時点で保存してある目的・予定機能を所属する要望と比べる(画面で書きかけの内容は使わない)
|
|
485
|
+
|
|
486
|
+
```bash
|
|
487
|
+
p3 milestone purpose v0.2 --file 目的.md # 目的を保存する(--body 本文|- でも。--off で外す)
|
|
488
|
+
p3 milestone goal add v0.2 "通知の再送" # 予定機能を足す(G1, G2, ... の ID が付く)
|
|
489
|
+
p3 milestone goal set v0.2 G1 "通知の再送と失敗の記録"
|
|
490
|
+
p3 milestone goal rm v0.2 G2
|
|
491
|
+
p3 milestone show v0.2 # 目的・予定機能を読む(--json は版 milestonesVersion も)
|
|
492
|
+
```
|
|
493
|
+
|
|
494
|
+
予定機能の ID は足したときに振り、並べ替えや文言の変更で振り直さない(消した番号も、残っている最大の番号より小さければ
|
|
495
|
+
使わない)。目的は 4000 文字、予定機能は 50 件・1件 500 文字まで。空の予定機能・重複した ID は保存を断る
|
|
482
496
|
- **タグ**(`tags`): 外部 ID や分類の自由な文字列(例 `jira:PROJ-123`、`group:顧客A`)。同じ値を複数の要望に付けてグループにできる。
|
|
483
497
|
要望・タスクの参照の代わりにはせず、外部のシステムとは同期しない
|
|
484
498
|
- CLI: `request new --tag 値`(繰り返し可。カンマで分けない)、`request set <要望> --tag 値 ...`(この並びに置き換える)、
|
|
@@ -610,6 +624,43 @@ p3 release-notes export v0.2 > RELEASE.md # 公開する本文だけ(出
|
|
|
610
624
|
壊すと「読めない」と出て、直すまで新しく保存しない。ノートのあるマイルストーンは消せない。保存の形と直し方は
|
|
611
625
|
[docs/architecture.md](architecture.md#リリースノートのデータ)
|
|
612
626
|
|
|
627
|
+
### マイルストーンレビュー
|
|
628
|
+
|
|
629
|
+
マイルストーンの目的・予定している機能([タグ・期限・マイルストーン](#タグ期限マイルストーン))に対して、Preflight と同じく Codex が
|
|
630
|
+
参照先のリポジトリのコードと git の履歴を読み、実際にできあがったものが目的を果たしているか・何が足りないか・目的に無い変更
|
|
631
|
+
(意図しない変更)が入っていないかを確かめる。コードの品質の審査ではなく、機能の意図と目的に照らした確認。任意のときに何度でも
|
|
632
|
+
実行でき、実行しなくても要望の完了やリリースノートの操作には影響しない。結果は参考の記録で、リリースするかは人が読んで決める。
|
|
633
|
+
|
|
634
|
+
```bash
|
|
635
|
+
p3 milestone review v0.2 # 実行して終わるまで待つ(進み具合は stderr。Ctrl-C で取り消す)。--engine mock は評価しない試し用
|
|
636
|
+
p3 milestone reviews v0.2 # 履歴(新しい順。状態・日時・判定の数)
|
|
637
|
+
p3 milestone review-show v0.2 <run> # 1回分(評価したときの目的・材料・全体の所見・予定機能ごとの判定)
|
|
638
|
+
p3 milestone review-cancel v0.2 <run> # 取り消す(ほかのプロセスの実行なら取消を頼む)
|
|
639
|
+
```
|
|
640
|
+
|
|
641
|
+
- **確かめる対象**: 参照先のリポジトリ(`p3 repo path` で登録したこのマシンのパス。Preflight と同じ)を、そのときの作業ツリーのまま
|
|
642
|
+
読むだけで渡す。実行したときの HEAD・ブランチ・未コミットの変更の数と、タスクの成果物に残したコミット(`…/commit/<sha>`)が
|
|
643
|
+
履歴にあるかを記録する。読める参照先が無ければ警告し、記録だけの点検になる(そのときは「達成」と判定しない)
|
|
644
|
+
- **手がかり**: 保存してある目的・予定機能(画面の書きかけは使わない)と、マイルストーンに直接属する要望の全部(見送り・未完了も)の
|
|
645
|
+
本文、各タスクの本文・状態・変更の記録・成果物の参照。タスクの記録は実装した人(AI を含む)の自己申告なので、どこを見るかの
|
|
646
|
+
手がかりにし、書いてあることはコードと履歴で確かめる。別のマイルストーンの親・子は文脈として渡すだけで成果に数えない。
|
|
647
|
+
アーカイブした要望は含めない。成果物の URL や添付の中身は読まない
|
|
648
|
+
- **結果**: 全体の所見と、予定機能ごとの判定(達成・一部達成・未達成・判断材料不足)・理由・根拠・不足していること、目的・予定機能に
|
|
649
|
+
無い変更(意図しない変更の候補)。根拠はコードの場所(`<参照先>:<パス>`・`<参照先>@<コミット>`)と要望・タスクの ID で、
|
|
650
|
+
「達成」にはコードの根拠が要る(記録だけで達成とした結果や、参照先に無いパス・コミットを挙げた結果は使わず、失敗にする)。
|
|
651
|
+
予定機能が無く目的だけなら、目的そのものを判定する。目的も予定機能も無ければ実行できない(先に書く案内が出る)。要望が 0 件でも
|
|
652
|
+
実行でき、材料が無いことを記録する。タスクの完了数で達成を決めず、数値の達成率は出さない
|
|
653
|
+
- **確かめないこと**: テストやアプリを実際に動かすこと・公開されたか。結果の「範囲」にも書く
|
|
654
|
+
- **頼む先**: Preflight と同じ Codex の接続(ChatGPT プラン)。参照先は読むだけでマウントし、データのフォルダは渡さない。コードを読むので
|
|
655
|
+
Preflight と同じくらい時間がかかる(上限 20 分)。失敗(認証なし・使用量の上限・時間切れ・形の違う結果)は失敗として記録し、
|
|
656
|
+
前の成功結果はそのまま読める
|
|
657
|
+
- **同時に**: 同じマイルストーンで実行できるのは1つだけ(別の serve・CLI からも)。別のマイルストーンは同時に実行できる
|
|
658
|
+
- **止まった実行**: 実行していたプロセスが落ちたと確かめられれば自動で失敗にする。別のマシン・コンテナで始めたなどで確かめられない
|
|
659
|
+
ときは実行中のまま残るので、止まっていると確かめてから `p3 milestone review-cancel <id> <run> --acknowledge-stopped`(画面では
|
|
660
|
+
「止まっていることを確かめて中断」)で中断にする(記録を終えるだけで、ほかの環境のプロセスを止めたとは限らない)
|
|
661
|
+
- **履歴**: `<データのフォルダ>/milestone-reviews/<マイルストーン>/<run>/` に、比べた材料と結果をそのまま残す。後で目的や要望を
|
|
662
|
+
直しても過去の記録は変わらない。履歴のあるマイルストーンは消せず、ID も変えられない
|
|
663
|
+
|
|
613
664
|
### 添付と画面資料
|
|
614
665
|
|
|
615
666
|
**添付**: 要望に PNG / JPEG / xlsx を付けて Preflight に渡す(今の画面のスクリーンショット・仕様書の Excel)。P3 は対象のアプリを
|
|
@@ -678,7 +729,7 @@ p3 render 画面.html --width 1280 # 画面.png ができる(幅 32
|
|
|
678
729
|
| `/requests/<要望>` | 要望の概要(タイトル・本文・期限・マイルストーン・タグ・親子・添付)と Preflight(`?run=PF-...` で過去の評価)。子の要望は見出しの上に祖先へのリンク |
|
|
679
730
|
| `/requests/<要望>/board` | タスクボード(V 字。ドラッグで列を移動。完了のカードの「✓ 済み」でボードから外す。「+ タスクを追加」で直接作る) |
|
|
680
731
|
| `/requests/<要望>/done` | 対応済み(済みにしたタスクと成果物の一覧。要望の「対応済」とは別) |
|
|
681
|
-
| `/release-notes` |
|
|
732
|
+
| `/release-notes` | マイルストーンの管理(既定)・リリースノート(`?tab=notes&m=<マイルストーン>`)・マイルストーンレビュー(`?tab=review`、記録は `&run=<run>`)。下の「リリースノートの画面」 |
|
|
682
733
|
| `/settings` | 個人(ChatGPT の接続・テーマ)/ プロジェクトの基本 / 参照先(`?tab=personal|project|repos`) |
|
|
683
734
|
|
|
684
735
|
要望の中のページでは `?task=T003` でタスク詳細を重ねて開く。どのタブでも、見出しのタイトルの上に要望 ID と「コピー」が出る
|
|
@@ -698,8 +749,8 @@ Clipboard API が無い)ときはそう出るので、ID をクリックして
|
|
|
698
749
|
|
|
699
750
|
印をクリックするとタスクの詳細が開く。ズーム(日 / 週 / 月)と「今日」ボタンで動かす。
|
|
700
751
|
|
|
701
|
-
**リリースノートの画面**(ヘッダーの「リリースノート」):
|
|
702
|
-
(`?tab=
|
|
752
|
+
**リリースノートの画面**(ヘッダーの「リリースノート」): タブで「レビュー」「リリースノート」「マイルストーン」を切り替える
|
|
753
|
+
(`?tab=review` がレビューのタブ、`?tab=notes` がノートのタブ。無い・ほかの値はマイルストーン(管理)のタブ。タブを移っても `?m=` の選択と、書きかけの入力は残る。
|
|
703
754
|
保存していない変更があるタブには ● が付く)。
|
|
704
755
|
|
|
705
756
|
**マイルストーンのタブ**: ID・名前・期限・リリース済み・属する要望の数を一覧で直し、「+ マイルストーンを追加」で足す(0 件から作れる)。
|
|
@@ -709,10 +760,30 @@ Clipboard API が無い)ときはそう出るので、ID をクリックして
|
|
|
709
760
|
ノートの保存や要望の一括完了でもリリース済みは変わらない(どれも別の操作)
|
|
710
761
|
- 要望が使っている・ノートのあるマイルストーンは、ID を変えられず消せない(理由が行に出る。CLI の `milestone rm` と同じ規則で、
|
|
711
762
|
画面が古くても保存のときに止まり、理由が出る)。保存できなかったときは入力が残るので、直して保存し直す
|
|
712
|
-
-
|
|
763
|
+
- レビューの履歴のあるマイルストーンも、ID を変えられず消せない(理由が行に出る)
|
|
764
|
+
- 行の「目的・予定機能」を開くと、目的と予定している機能・目標を直せる(「+ 予定機能を追加」・行ごとの「削除」。保存は
|
|
765
|
+
ほかの項目と同じ「保存」)。閉じた行には目的・予定機能の有無と件数が出る
|
|
766
|
+
- 編集中にほかで変わったら、入力を残して知らせる(「入力を捨てて最新を読み直す」)。そのまま保存すると、編集を始めた後に
|
|
767
|
+
変わったとして断られ(入力は残る)、ほかの変更を上書きしない。保存するのはマイルストーンだけで、
|
|
713
768
|
設定の「プロジェクトの基本」(名前・説明など)とは互いに巻き戻さない
|
|
714
769
|
- project.yaml に無いマイルストーンのノートは、管理のタブでは定義として出さずに知らせる(ノートのタブで読める)
|
|
715
770
|
|
|
771
|
+
**レビューのタブ**: 左でマイルストーンを選ぶ(レビューの履歴だけが残る、project.yaml に無いマイルストーンも出る)。右に:
|
|
772
|
+
|
|
773
|
+
- **評価する内容**: 保存してある目的・予定している機能、所属する要望の件数と状態、別のマイルストーンの親子の数、確かめるコード
|
|
774
|
+
(参照先ごとのブランチと HEAD・未コミットの変更・タスクに残したコミットの数。読めない参照先はその理由)、範囲と警告。
|
|
775
|
+
「目的・予定機能を書く・直す」で「マイルストーン」タブへ移る。そのタブに保存していない変更があれば、レビューは保存した内容で
|
|
776
|
+
行うと知らせる。目的も予定機能も無ければ書き方を案内し、「レビューを実行」は押せない
|
|
777
|
+
- 「レビューを実行」(履歴があれば「もう一度実行」)で始め、実行中は進み具合と「取消」が出る。実行しているプロセスを確かめられない
|
|
778
|
+
実行には「止まっていることを確かめて中断」が出る(記録を終えるだけで、ほかの環境のプロセスを止めるとは限らない)
|
|
779
|
+
- **最新の実行**(実行中・失敗・取消のとき)と **最後の成功結果** を分けて出すので、実行中や失敗の後も前の結果を読める。結果は全体の所見と、
|
|
780
|
+
予定機能ごとの判定(達成・一部達成・未達成・判断材料不足)・理由・根拠(コードの場所とコミット、今の要望・タスクへのリンク)・
|
|
781
|
+
不足していること、目的・予定機能に無い変更(意図しない変更の候補)・範囲。「評価したときの材料」を開くと、そのときの目的・予定機能・
|
|
782
|
+
参照先のコード(HEAD とタスクのコミット1件ずつ)・要望とタスクの文面(本文・変更の記録・成果物)を読める(後で直したり消したりしても残る)。評価した後に目的や要望、参照先の
|
|
783
|
+
HEAD・未コミットの変更が変わっていれば知らせ、「今の内容でもう一度実行」できる
|
|
784
|
+
- **履歴**: 日時・状態・判定の数・評価した目的と予定機能を選んで読める(URL の `?run=` で開ける)。読めない記録も「読めない記録」として出す
|
|
785
|
+
- どの結果でも、要望の完了・リリースノートの保存・リリース済みの操作は今までどおりできる(レビューは参考の記録)
|
|
786
|
+
|
|
716
787
|
**リリースノートのタブ**: 左でマイルストーンを選ぶ(ノートの有無と要望の数)。右に:
|
|
717
788
|
|
|
718
789
|
- **このマイルストーンの要望**: 状態・収録 / 対象外(理由)・変更の記録の数・警告(未完了・記録なし・状態の食い違い)。
|
|
@@ -838,7 +909,8 @@ AI にも CLI を使わせる(認証を持たせずに済む)。`p3 init --a
|
|
|
838
909
|
| `p3 init` / `p3 join` / `p3 project` / `p3 whoami` | 新しく作る / 共有されたものに参加する / 個人設定のプロジェクト / 今の判定 |
|
|
839
910
|
| `p3 config` / `p3 repo` / `p3 user-config` | プロジェクトの設定 / 参照先 / 個人設定(テーマ・マシンごとの設定) |
|
|
840
911
|
| `p3 progress` | 要望ごとの進捗(マイルストーンごと。`--all` で完了・見送りも) |
|
|
841
|
-
| `p3 milestone ls\|add\|set\|rm` |
|
|
912
|
+
| `p3 milestone ls\|show\|add\|set\|rm\|purpose\|goal` | マイルストーン(目的・予定している機能も) |
|
|
913
|
+
| `p3 milestone review\|reviews\|review-show\|review-cancel` | マイルストーンレビュー |
|
|
842
914
|
| `p3 release-notes ls\|show\|generate\|save\|export` | マイルストーンのリリースノート(要約の生成・保存・本文の出力) |
|
|
843
915
|
| `p3 request new\|ls\|show\|set\|archive` | 要望 |
|
|
844
916
|
| `p3 ls` / `p3 show` / `p3 find` | タスクの一覧(`--all` で全要望)/ 詳細(`--brief`)/ 参照・タイトルで探す |
|
package/docs/installation.md
CHANGED
|
@@ -322,12 +322,12 @@ P3 をイメージにして、コンテナで動かすこともできる。イ
|
|
|
322
322
|
要望・タスクの作成と編集・添付・Preflight もいつもどおり使える。
|
|
323
323
|
|
|
324
324
|
イメージは Docker Hub の **`tamuto/p3`**。中に p3 本体(npm の `@infodb/p3` と同じ版・同じ中身)と、Node 26・git・Docker の CLI が
|
|
325
|
-
入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.
|
|
325
|
+
入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.11.0` など)と
|
|
326
326
|
`latest` がある。決まった版で使うなら版のタグを指す。対応する platform は `linux/amd64` だけ(arm64 は確かめるマシンが無いので
|
|
327
327
|
作っていない)。
|
|
328
328
|
|
|
329
329
|
```bash
|
|
330
|
-
docker pull tamuto/p3:0.
|
|
330
|
+
docker pull tamuto/p3:0.11.0
|
|
331
331
|
```
|
|
332
332
|
|
|
333
333
|
リポジトリから作るときは `docker build --pull -t tamuto/p3:dev .`(`--pull` で今の Node のベースを取る。[開発ガイド](development.md#docker-のイメージ))。
|
|
@@ -348,7 +348,7 @@ root で動く開発コンテナ(DevContainer など)で p3 の CLI を使
|
|
|
348
348
|
# 開発コンテナの compose に足す例(パスは開発コンテナのマウントに合わせる)
|
|
349
349
|
services:
|
|
350
350
|
p3:
|
|
351
|
-
image: tamuto/p3:0.
|
|
351
|
+
image: tamuto/p3:0.11.0
|
|
352
352
|
restart: unless-stopped
|
|
353
353
|
ports:
|
|
354
354
|
- "127.0.0.1:4310:4310"
|
|
@@ -372,7 +372,7 @@ docker run -d --name p3 --restart unless-stopped \
|
|
|
372
372
|
-v ~/.config/infodb-p3:/root/.config/infodb-p3 \
|
|
373
373
|
-v /home/me/work:/home/me/work \
|
|
374
374
|
-v /var/run/docker.sock:/var/run/docker.sock \
|
|
375
|
-
tamuto/p3:0.
|
|
375
|
+
tamuto/p3:0.11.0
|
|
376
376
|
|
|
377
377
|
# 登録が無ければ、コンテナの中で登録する(既にあるデータに参加する。新しく作るなら p3 init)
|
|
378
378
|
docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
|
|
@@ -385,7 +385,7 @@ docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
|
|
|
385
385
|
### どちらでも
|
|
386
386
|
|
|
387
387
|
- 待ち受けは `127.0.0.1` に公開する。ブラウザで http://localhost:4310 を開く。登録が1つならそのプロジェクトが開き、複数なら一覧から選ぶ
|
|
388
|
-
- **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.
|
|
388
|
+
- **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.11.0 serve --project myapp --host 0.0.0.0`。compose なら
|
|
389
389
|
`command:`)。明示しない限り、コンテナの中かどうかで自動では切り替えない
|
|
390
390
|
- **止める**: `docker stop p3`(SIGTERM。実行中の Preflight・生成を取り消して記録してから止まる。10 秒まで待つ)
|
|
391
391
|
- **新しい版にする**: 版のタグを変えて作り直す(個人設定と接続はマウントした ~/.config、データはホストに残る)。
|
package/lib/cli/help.js
CHANGED
|
@@ -29,6 +29,13 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
|
|
|
29
29
|
set codex.pathMap-=<このマシンのパス> 外す(codex.pathMap= で全部外す)
|
|
30
30
|
progress 要望ごとの進捗(マイルストーンごと。--all で完了・見送りも。既定でも対応済を出す)
|
|
31
31
|
milestone [ls | add <id> | set <id> | rm <id>] マイルストーン(リリース) --title 名前 --due YYYY-MM-DD --done
|
|
32
|
+
milestone show <id> 目的・予定している機能と版(--json の milestonesVersion)
|
|
33
|
+
milestone purpose <id> 目的を保存する --body 本文|- / --file 目的.md / --off(外す)
|
|
34
|
+
milestone goal add <id> <文> 予定機能を足す(ID は G1, G2, ... を振り、振り直さない)。goal set <id> <G番号> <文> / goal rm <id> <G番号>
|
|
35
|
+
マイルストーンの変更はどれも --version <版> を付けると、その版から変わっていれば競合(終了コード 3)
|
|
36
|
+
milestone review <id> 目的・予定機能に対して参照先のコードと履歴を確かめるレビューを Codex で実行して待つ(記録する。--engine codex|mock。Ctrl-C で取消)
|
|
37
|
+
milestone reviews <id> レビューの履歴 / review-show <id> <run> 1回分 / review-cancel <id> <run> 取消
|
|
38
|
+
(所有者を確かめられない run は --acknowledge-stopped で中断。無い → 2、実行中・終わっている → 3)
|
|
32
39
|
release-notes [ls] マイルストーンごとのリリースノートの有無と要望の数
|
|
33
40
|
release-notes show <id> 保存したノート(本文・版)と、対象の要望(収録 / 対象外)・警告(未完了・記録なし など)
|
|
34
41
|
release-notes generate <id> 変更の記録から機能の要約を Codex で生成し、本文の案を stdout に出す(保存しない。進み具合と出典は stderr。
|
package/lib/cli/main.js
CHANGED
|
@@ -4,6 +4,9 @@ import { openProject } from "../core/context.js";
|
|
|
4
4
|
import { machineSettingsSource, resolveMachineSettings, SettingsError } from "../core/machineSettings.js";
|
|
5
5
|
import { progress, resolveRef, resolveRequestId, titleOf } from "../core/ops.js";
|
|
6
6
|
import { OpRuleError } from "../core/requestOps.js";
|
|
7
|
+
import { MilestonesConflictError, ProjectInputError } from "../core/store/workspace.js";
|
|
8
|
+
import { ReviewCancelRefused, ReviewRejected } from "../core/milestoneReview/service.js";
|
|
9
|
+
import { ReviewStoreError } from "../core/milestoneReview/store.js";
|
|
7
10
|
import { HierarchyError } from "../core/hierarchy.js";
|
|
8
11
|
import { startServer } from "../server/server.js";
|
|
9
12
|
import { ConflictError, NotFoundError } from "../core/store/collection.js";
|
|
@@ -282,7 +285,7 @@ async function main(argv) {
|
|
|
282
285
|
}
|
|
283
286
|
case "milestone":
|
|
284
287
|
case "milestones":
|
|
285
|
-
return milestoneCommand(ctx, out, args, o);
|
|
288
|
+
return milestoneCommand(ctx, out, args, o, actor);
|
|
286
289
|
case "release-notes":
|
|
287
290
|
case "release-note":
|
|
288
291
|
return releaseNotesCommand(env);
|
|
@@ -327,10 +330,21 @@ main(process.argv.slice(2)).then((code) => process.exit(code), (e) => {
|
|
|
327
330
|
const changedSet = e.code === "child_order_invalid" && (e.detail.reason === "not_child" || e.detail.reason === "missing");
|
|
328
331
|
process.exit(e.code === "hierarchy_busy" || changedSet ? 3 : 1);
|
|
329
332
|
}
|
|
333
|
+
// マイルストーンレビュー: 無い → 2、実行中・終わっている・動いている所有者がいる → 3、ほか(目的が無い・上限・ID・読めない)→ 1
|
|
334
|
+
if (e instanceof ReviewRejected || e instanceof ReviewStoreError || e instanceof ReviewCancelRefused) {
|
|
335
|
+
process.stderr.write(`${e.message}\n`);
|
|
336
|
+
const code = e.code;
|
|
337
|
+
process.exit(code === "not_found" || code === "unknown_milestone" ? 2 : code === "running" || code === "finished" || code === "owner_alive" || code === "exists" ? 3 : 1);
|
|
338
|
+
}
|
|
339
|
+
// マイルストーンの版が違う(読んだ後に他で変わった)→ 3。何も書いていない
|
|
340
|
+
if (e instanceof MilestonesConflictError) {
|
|
341
|
+
process.stderr.write(`競合: ${e.message}\n`);
|
|
342
|
+
process.exit(3);
|
|
343
|
+
}
|
|
330
344
|
if (e instanceof NotFoundError) {
|
|
331
345
|
process.stderr.write(`見つかりません: ${e.id}\n`);
|
|
332
346
|
process.exit(2);
|
|
333
347
|
}
|
|
334
|
-
process.stderr.write(`${e instanceof UsageError || e instanceof OpRuleError ? "" : "エラー: "}${e.message}\n`);
|
|
348
|
+
process.stderr.write(`${e instanceof UsageError || e instanceof OpRuleError || e instanceof ProjectInputError ? "" : "エラー: "}${e.message}\n`);
|
|
335
349
|
process.exit(1);
|
|
336
350
|
});
|
|
@@ -1,5 +1,8 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { readFile } from "node:fs/promises";
|
|
2
|
+
import { basename, relative, resolve as resolvePath } from "node:path";
|
|
2
3
|
import { REQUEST_STATUSES } from "../shared/types.js";
|
|
4
|
+
import { nextGoalId } from "../shared/milestoneGoals.js";
|
|
5
|
+
import { REVIEW_STATUS_LABELS, REVIEW_VERDICT_LABELS, REVIEW_VERDICTS } from "../shared/milestoneReview.js";
|
|
3
6
|
import {} from "../core/context.js";
|
|
4
7
|
import { archiveRequest, checkMilestone, checkMilestoneRemoval, createRequest, orderChildren, updateRequest } from "../core/requestOps.js";
|
|
5
8
|
import { hierarchyNow, resolvedIssue } from "../core/requestStatus.js";
|
|
@@ -155,37 +158,227 @@ export async function requestCommand(ctx, out, args, o, actor, requestArg, expec
|
|
|
155
158
|
}
|
|
156
159
|
// --- マイルストーン -----------------------------------------------------------
|
|
157
160
|
/** マイルストーン(リリース)。複数の要望をまとめる単位で、project.yaml に書く */
|
|
158
|
-
|
|
161
|
+
const MILESTONE_USAGE = "p3 milestone [ls | show <id> | add <id> | set <id> | rm <id> | purpose <id> (--body 本文|- | --file ファイル | --off) | goal add <id> <文> | goal set <id> <G番号> <文> | goal rm <id> <G番号> | review <id> | reviews <id> | review-show <id> <run> | review-cancel <id> <run>]";
|
|
162
|
+
/**
|
|
163
|
+
* マイルストーンの操作。保存はロックの中で読んだ最新の並びから作り直す(Workspace.updateMilestones。指定した項目のほかを巻き戻さない)。
|
|
164
|
+
* --version(show --json の milestonesVersion)を付けると、その版から変わっていれば競合(終了コード 3)で何も書かない
|
|
165
|
+
*/
|
|
166
|
+
export async function milestoneCommand(ctx, out, args, o, actor) {
|
|
159
167
|
const [sub, id] = args;
|
|
168
|
+
if (sub === "review" || sub === "reviews" || sub === "review-show" || sub === "review-cancel")
|
|
169
|
+
return reviewCommand(ctx, out, args, o, actor);
|
|
160
170
|
const ms = ctx.ws.project.milestones;
|
|
161
171
|
const count = (mid) => ctx.ws.requests.list().filter((r) => r.milestone === mid).length;
|
|
172
|
+
const save = { milestonesVersion: o.version };
|
|
173
|
+
/** 最新の並びの中で id のマイルストーンを変える(無ければ使い方の誤り) */
|
|
174
|
+
const change = async (mid, fn) => {
|
|
175
|
+
const p = await ctx.ws.updateMilestones((cur) => {
|
|
176
|
+
if (!cur.some((m) => m.id === mid))
|
|
177
|
+
throw new UsageError(`マイルストーンがありません: ${mid}`);
|
|
178
|
+
return cur.map((m) => (m.id === mid ? fn(m) : m));
|
|
179
|
+
}, save);
|
|
180
|
+
return p.milestones.find((m) => m.id === mid);
|
|
181
|
+
};
|
|
182
|
+
const needId = (cmd) => {
|
|
183
|
+
if (!id)
|
|
184
|
+
throw new UsageError(`p3 milestone ${cmd} <id>`);
|
|
185
|
+
return id;
|
|
186
|
+
};
|
|
162
187
|
if (sub === "add" || sub === "set") {
|
|
163
188
|
if (!id || !/^[A-Za-z0-9._-]+$/.test(id))
|
|
164
189
|
throw new UsageError(`p3 milestone ${sub} <id>(英数字と . _ -)`);
|
|
165
|
-
const
|
|
166
|
-
|
|
167
|
-
throw new UsageError(`既にあります: ${id}(変えるなら p3 milestone set)`);
|
|
168
|
-
if (sub === "set" && !cur)
|
|
169
|
-
throw new UsageError(`マイルストーンがありません: ${id}`);
|
|
170
|
-
const next = {
|
|
190
|
+
const make = (cur) => ({
|
|
191
|
+
...cur,
|
|
171
192
|
id,
|
|
172
193
|
title: o.title ?? cur?.title ?? id,
|
|
173
194
|
due: o.due !== undefined ? (o.due ? date(o.due) : undefined) : cur?.due,
|
|
174
195
|
done: o.done ?? cur?.done,
|
|
175
|
-
};
|
|
176
|
-
|
|
177
|
-
|
|
196
|
+
});
|
|
197
|
+
let existed = false;
|
|
198
|
+
const p = await ctx.ws.updateMilestones((cur) => {
|
|
199
|
+
const was = cur.find((m) => m.id === id);
|
|
200
|
+
existed = !!was;
|
|
201
|
+
if (sub === "add" && was)
|
|
202
|
+
throw new UsageError(`既にあります: ${id}(変えるなら p3 milestone set)`);
|
|
203
|
+
if (sub === "set" && !was)
|
|
204
|
+
throw new UsageError(`マイルストーンがありません: ${id}`);
|
|
205
|
+
return was ? cur.map((m) => (m.id === id ? make(m) : m)) : [...cur, make(undefined)];
|
|
206
|
+
}, save);
|
|
207
|
+
const next = p.milestones.find((m) => m.id === id);
|
|
208
|
+
return out.result(next, () => `${existed ? "更新" : "追加"}しました: ${next.title}(${id}${next.due ? ` · ${next.due}` : ""})`);
|
|
178
209
|
}
|
|
179
210
|
if (sub === "rm" || sub === "remove") {
|
|
180
211
|
if (!id || !ms.some((m) => m.id === id))
|
|
181
212
|
throw new UsageError(`マイルストーンがありません: ${id ?? ""}`);
|
|
182
213
|
await checkMilestoneRemoval(ctx, ms.filter((m) => m.id !== id).map((m) => m.id));
|
|
183
|
-
await ctx.ws.
|
|
214
|
+
await ctx.ws.updateMilestones((cur) => cur.filter((m) => m.id !== id), save);
|
|
184
215
|
return out.result({ removed: id }, () => `外しました: ${id}`);
|
|
185
216
|
}
|
|
217
|
+
if (sub === "show") {
|
|
218
|
+
const mid = needId("show");
|
|
219
|
+
const m = ms.find((x) => x.id === mid);
|
|
220
|
+
if (!m)
|
|
221
|
+
throw new UsageError(`マイルストーンがありません: ${mid}`);
|
|
222
|
+
return out.result({ ...m, requests: count(mid), milestonesVersion: ctx.ws.milestonesVersion }, () => formatMilestone(m, count(mid)));
|
|
223
|
+
}
|
|
224
|
+
if (sub === "purpose") {
|
|
225
|
+
const mid = needId("purpose");
|
|
226
|
+
const given = [o.off, o.body !== undefined, o.file !== undefined].filter(Boolean).length;
|
|
227
|
+
if (given !== 1)
|
|
228
|
+
throw new UsageError(`p3 milestone purpose ${mid} --body 本文|- か --file ファイル か --off(どれか1つ)`);
|
|
229
|
+
const text = o.off ? "" : o.file !== undefined ? await readFile(resolvePath(process.cwd(), o.file), "utf8") : readBody(o.body);
|
|
230
|
+
const m = await change(mid, (x) => ({ ...x, purpose: text }));
|
|
231
|
+
return out.result(m, () => (m.purpose ? `目的を保存しました: ${mid}` : `目的を外しました: ${mid}`));
|
|
232
|
+
}
|
|
233
|
+
if (sub === "goal") {
|
|
234
|
+
const [, op, mid, a, b] = args;
|
|
235
|
+
if (!mid || !["add", "set", "rm", "remove"].includes(op ?? ""))
|
|
236
|
+
throw new UsageError("p3 milestone goal add <id> <文> | goal set <id> <G番号> <文> | goal rm <id> <G番号>");
|
|
237
|
+
if (op === "add") {
|
|
238
|
+
if (a === undefined)
|
|
239
|
+
throw new UsageError(`p3 milestone goal add ${mid} <文>`);
|
|
240
|
+
let gid = "";
|
|
241
|
+
const m = await change(mid, (x) => {
|
|
242
|
+
gid = nextGoalId(x.goals ?? []);
|
|
243
|
+
return { ...x, goals: [...(x.goals ?? []), { id: gid, text: a }] };
|
|
244
|
+
});
|
|
245
|
+
return out.result({ ...m, added: gid }, () => `予定機能を追加しました: ${mid} ${gid}`);
|
|
246
|
+
}
|
|
247
|
+
if (!a)
|
|
248
|
+
throw new UsageError(`p3 milestone goal ${op} ${mid} <G番号>`);
|
|
249
|
+
const exists = (x) => {
|
|
250
|
+
if (!(x.goals ?? []).some((g) => g.id === a))
|
|
251
|
+
throw new UsageError(`予定機能がありません: ${mid} ${a}`);
|
|
252
|
+
};
|
|
253
|
+
if (op === "set") {
|
|
254
|
+
if (b === undefined)
|
|
255
|
+
throw new UsageError(`p3 milestone goal set ${mid} ${a} <文>`);
|
|
256
|
+
const m = await change(mid, (x) => (exists(x), { ...x, goals: (x.goals ?? []).map((g) => (g.id === a ? { ...g, text: b } : g)) }));
|
|
257
|
+
return out.result(m, () => `予定機能を更新しました: ${mid} ${a}`);
|
|
258
|
+
}
|
|
259
|
+
const m = await change(mid, (x) => (exists(x), { ...x, goals: (x.goals ?? []).filter((g) => g.id !== a) }));
|
|
260
|
+
return out.result({ ...m, removed: a }, () => `予定機能を外しました: ${mid} ${a}`);
|
|
261
|
+
}
|
|
186
262
|
if (sub && sub !== "ls" && sub !== "list")
|
|
187
|
-
throw new UsageError(
|
|
263
|
+
throw new UsageError(MILESTONE_USAGE);
|
|
188
264
|
const shown = sortMilestones(ms);
|
|
189
|
-
return out.result(shown, () => table(shown.map((m) => [m.id, m.title, m.due ?? "", m.done ? "済" : "", `要望 ${count(m.id)}`])) ||
|
|
265
|
+
return out.result(shown, () => table(shown.map((m) => [m.id, m.title, m.due ?? "", m.done ? "済" : "", `要望 ${count(m.id)}`, m.purpose ? "目的あり" : "", m.goals?.length ? `予定機能 ${m.goals.length}` : ""])) ||
|
|
190
266
|
"マイルストーンはありません(p3 milestone add v0.1 --title 最初のリリース --due 2026-11-30)");
|
|
191
267
|
}
|
|
268
|
+
/** milestone show の人向けの表示 */
|
|
269
|
+
function formatMilestone(m, requests) {
|
|
270
|
+
const lines = [`${m.id} ${m.title}${m.due ? ` 期限 ${m.due}` : ""}${m.done ? " リリース済み" : ""} 要望 ${requests}`, "", "目的:"];
|
|
271
|
+
lines.push(m.purpose ? m.purpose.split("\n").map((l) => ` ${l}`).join("\n") : ` (なし。p3 milestone purpose ${m.id} --file 目的.md)`);
|
|
272
|
+
lines.push("", "予定している機能・目標:");
|
|
273
|
+
lines.push(m.goals?.length ? m.goals.map((g) => ` ${g.id} ${g.text}`).join("\n") : ` (なし。p3 milestone goal add ${m.id} "文")`);
|
|
274
|
+
return lines.join("\n");
|
|
275
|
+
}
|
|
276
|
+
// --- マイルストーンレビュー ----------------------------------------------------
|
|
277
|
+
/**
|
|
278
|
+
* マイルストーンレビュー(core/milestoneReview。画面と同じ規則)。review は終わるまで待ち、進み具合は stderr に出す(Ctrl-C で取り消す)。
|
|
279
|
+
* 結果は参考の記録で、要望の状態・リリースノート・リリース済みは変えない
|
|
280
|
+
*/
|
|
281
|
+
async function reviewCommand(ctx, out, args, o, actor) {
|
|
282
|
+
const [sub, mid, run] = args;
|
|
283
|
+
if (!mid)
|
|
284
|
+
throw new UsageError(`p3 milestone ${sub} <id>${sub === "review-show" || sub === "review-cancel" ? " <run>" : ""}`);
|
|
285
|
+
const svc = ctx.milestoneReview;
|
|
286
|
+
if (sub === "reviews") {
|
|
287
|
+
const items = await svc.list(mid);
|
|
288
|
+
return out.result(items, () => items.length
|
|
289
|
+
? table(items.map((x) => x.state === "broken"
|
|
290
|
+
? [x.id, "読めない", x.error]
|
|
291
|
+
: [x.run.id, REVIEW_STATUS_LABELS[x.run.status], x.run.startedAt.slice(0, 16).replace("T", " "), verdictSummary(x.verdicts), x.run.error ?? ""]))
|
|
292
|
+
: `レビューの履歴はありません(p3 milestone review ${mid})`);
|
|
293
|
+
}
|
|
294
|
+
if (sub === "review-show" || sub === "review-cancel") {
|
|
295
|
+
if (!run)
|
|
296
|
+
throw new UsageError(`p3 milestone ${sub} ${mid} <run>`);
|
|
297
|
+
if (sub === "review-show") {
|
|
298
|
+
const d = await svc.get(mid, run);
|
|
299
|
+
return out.result(d, () => formatReview(d));
|
|
300
|
+
}
|
|
301
|
+
const r = await svc.cancel(mid, run, actor, { acknowledgeStopped: o["acknowledge-stopped"] });
|
|
302
|
+
return out.result(r, () => r.requested
|
|
303
|
+
? `取消を頼みました: ${mid}/${run}(実行しているプロセスが見つけて止めます)`
|
|
304
|
+
: r.run.abandoned
|
|
305
|
+
? `中断にしました: ${mid}/${run}(記録の上で終わりにしました。ほかの環境で動いているプロセスを止めたとは限りません)`
|
|
306
|
+
: `終わりにしました: ${mid}/${run}(${REVIEW_STATUS_LABELS[r.run.status]}${r.run.error ? `: ${r.run.error}` : ""})`);
|
|
307
|
+
}
|
|
308
|
+
if (o.engine !== undefined && o.engine !== "codex" && o.engine !== "mock")
|
|
309
|
+
throw new UsageError("--engine は codex か mock");
|
|
310
|
+
const started = await svc.start(mid, actor, o.engine);
|
|
311
|
+
process.stderr.write(`レビューを始めました: ${mid}/${started.id}(Ctrl-C で取り消す)\n`);
|
|
312
|
+
let shown = 0;
|
|
313
|
+
const tick = setInterval(() => {
|
|
314
|
+
void svc.get(mid, started.id).then((d) => {
|
|
315
|
+
for (const e of d.run.log.slice(shown))
|
|
316
|
+
process.stderr.write(` ${e.text}\n`);
|
|
317
|
+
shown = Math.max(shown, d.run.log.length);
|
|
318
|
+
}, () => undefined);
|
|
319
|
+
}, 500);
|
|
320
|
+
const onInt = () => void svc.cancel(mid, started.id, actor).catch(() => undefined);
|
|
321
|
+
process.on("SIGINT", onInt);
|
|
322
|
+
const d = await svc.wait(mid, started.id);
|
|
323
|
+
clearInterval(tick);
|
|
324
|
+
process.removeListener("SIGINT", onInt);
|
|
325
|
+
for (const e of d.run.log.slice(shown))
|
|
326
|
+
process.stderr.write(` ${e.text}\n`);
|
|
327
|
+
if (d.run.status !== "completed") {
|
|
328
|
+
if (out.json)
|
|
329
|
+
out.result(d, () => "");
|
|
330
|
+
else
|
|
331
|
+
process.stderr.write(`${REVIEW_STATUS_LABELS[d.run.status]}: ${d.run.error ?? ""}\n`);
|
|
332
|
+
return 1;
|
|
333
|
+
}
|
|
334
|
+
return out.result(d, () => formatReview(d));
|
|
335
|
+
}
|
|
336
|
+
function verdictSummary(v) {
|
|
337
|
+
if (!v)
|
|
338
|
+
return "";
|
|
339
|
+
return REVIEW_VERDICTS.filter((k) => v[k]).map((k) => `${REVIEW_VERDICT_LABELS[k]} ${v[k]}`).join(" · ");
|
|
340
|
+
}
|
|
341
|
+
/** review-show の人向けの表示 */
|
|
342
|
+
function formatReview(d) {
|
|
343
|
+
const { run, input, result } = d;
|
|
344
|
+
const lines = [`${run.milestone}/${run.id} ${REVIEW_STATUS_LABELS[run.status]} ${run.startedAt}${run.startedBy ? ` ${run.startedBy}` : ""} (${run.engine})`];
|
|
345
|
+
if (run.error)
|
|
346
|
+
lines.push(` ${run.error}`);
|
|
347
|
+
if (d.owner && d.owner.state !== "local" && d.owner.state !== "alive") {
|
|
348
|
+
lines.push(` 実行しているプロセスを確かめられません(${"reason" in d.owner ? d.owner.reason : ""})。止まっていると確かめたら p3 milestone review-cancel ${run.milestone} ${run.id} --acknowledge-stopped`);
|
|
349
|
+
}
|
|
350
|
+
if (input) {
|
|
351
|
+
lines.push("", "評価したときの目的:", input.milestone.purpose ? input.milestone.purpose.split("\n").map((l) => ` ${l}`).join("\n") : " (なし)");
|
|
352
|
+
lines.push(`材料: 要望 ${input.requests.length} 件・文脈 ${input.context.length} 件(${input.extractedAt})`);
|
|
353
|
+
for (const c of input.code ?? []) {
|
|
354
|
+
lines.push(c.status === "ok"
|
|
355
|
+
? ` 参照先 ${c.name}: ${c.head ? `${c.branch ? `${c.branch} ` : ""}${c.head.slice(0, 7)}` : "HEAD なし"}${c.dirty ? `・未コミットの変更 ${c.dirty} 件` : ""}・タスクのコミット ${c.commits.filter((x) => x.found).length} 件`
|
|
356
|
+
: ` 参照先 ${c.name}: 読めません(${c.reason ?? c.status})`);
|
|
357
|
+
for (const x of c.commits)
|
|
358
|
+
lines.push(` ${x.sha.slice(0, 12)} ${x.from}${x.found ? "" : " (履歴に無い)"}`);
|
|
359
|
+
}
|
|
360
|
+
for (const w of input.warnings)
|
|
361
|
+
lines.push(` ⚠ ${w.message}`);
|
|
362
|
+
}
|
|
363
|
+
if (result) {
|
|
364
|
+
const text = new Map(input?.units.map((u) => [u.id, u.text]));
|
|
365
|
+
lines.push("", "全体の所見:", ...result.overall.split("\n").map((l) => ` ${l}`), "");
|
|
366
|
+
for (const u of result.units) {
|
|
367
|
+
lines.push(`■ ${u.unit} ${REVIEW_VERDICT_LABELS[u.verdict]} ${(text.get(u.unit) ?? "").split("\n")[0]}`);
|
|
368
|
+
lines.push(` 理由: ${u.reason}`);
|
|
369
|
+
if (u.evidence.length)
|
|
370
|
+
lines.push(` 根拠: ${u.evidence.join(", ")}`);
|
|
371
|
+
for (const g of u.gaps)
|
|
372
|
+
lines.push(` 不足: ${g}`);
|
|
373
|
+
}
|
|
374
|
+
if (result.unplanned) {
|
|
375
|
+
lines.push("", "目的・予定機能に無い変更(意図しない変更の候補):");
|
|
376
|
+
if (!result.unplanned.length)
|
|
377
|
+
lines.push(" (見つかっていません)");
|
|
378
|
+
for (const u of result.unplanned)
|
|
379
|
+
lines.push(` - ${u.text}${u.evidence.length ? `(根拠: ${u.evidence.join(", ")})` : ""}`);
|
|
380
|
+
}
|
|
381
|
+
lines.push("", `範囲: ${result.scope}`);
|
|
382
|
+
}
|
|
383
|
+
return lines.join("\n");
|
|
384
|
+
}
|
package/lib/core/context.js
CHANGED
|
@@ -8,6 +8,8 @@ import { checkDataDir } from "./store/locate.js";
|
|
|
8
8
|
import { Workspace } from "./store/workspace.js";
|
|
9
9
|
import { ReleaseGenerator } from "./releaseNotes/generate.js";
|
|
10
10
|
import { MockSummarizer } from "./releaseNotes/mockSummarizer.js";
|
|
11
|
+
import { MilestoneReviewService } from "./milestoneReview/service.js";
|
|
12
|
+
import { MockReviewer } from "./milestoneReview/mockReviewer.js";
|
|
11
13
|
/** p3 本体(パッケージ)のルート */
|
|
12
14
|
export const P3_ROOT = fileURLToPath(new URL("../../", import.meta.url));
|
|
13
15
|
/**
|
|
@@ -37,5 +39,6 @@ export async function openProject(dataDir, opts = {}) {
|
|
|
37
39
|
}, { pathMap: async () => (await source.get()).codex.pathMap });
|
|
38
40
|
// 要約の生成も Preflight と同じ接続と既定のエンジン(preflight.engine)を使う
|
|
39
41
|
const releaseGenerator = new ReleaseGenerator(ws, { codex, mock: new MockSummarizer() }, { engine: async () => (await source.get()).preflight.engine });
|
|
40
|
-
|
|
42
|
+
const milestoneReview = new MilestoneReviewService(ws, { codex, mock: new MockReviewer() }, { engine: async () => (await source.get()).preflight.engine });
|
|
43
|
+
return { ws, preflight, releaseGenerator, milestoneReview, chatgpt, projectName: opts.projectName };
|
|
41
44
|
}
|