@infodb/p3 0.11.0 → 0.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (101) hide show
  1. package/README.md +4 -1
  2. package/dist/web/assets/ImprovementDialog-kQaVBGWH.js +1 -0
  3. package/dist/web/assets/Outputs-_nU_p3nu.js +1 -0
  4. package/dist/web/assets/{RequestStatus-Bg1OLbRc.js → RequestStatus-RG-OVQYY.js} +1 -1
  5. package/dist/web/assets/{Tabs-DTmggzgg.js → Tabs-ew9i5SKX.js} +1 -1
  6. package/dist/web/assets/TagInput-BtlJTF7i.js +1 -0
  7. package/dist/web/assets/TaskDrawer-DW8GyJqI.js +6 -0
  8. package/dist/web/assets/_requestId-6Nb727dD.js +1 -0
  9. package/dist/web/assets/_requestId-BykTgPax.js +1 -0
  10. package/dist/web/assets/appCtx-CxDdXABS.js +1 -0
  11. package/dist/web/assets/archive-Ckh295Xe.js +1 -0
  12. package/dist/web/assets/board-BVAIjK-Y.js +1 -0
  13. package/dist/web/assets/done-BGfA-3MA.js +1 -0
  14. package/dist/web/assets/index-CgRU744I.css +2 -0
  15. package/dist/web/assets/index-DacQ0yl4.js +12 -0
  16. package/dist/web/assets/{new-9TKiNT4O.js → new-DVygWvVc.js} +1 -1
  17. package/dist/web/assets/outputs-B6xDsLZf.js +1 -0
  18. package/dist/web/assets/preload-helper-DyCqp21K.js +1 -0
  19. package/dist/web/assets/quality-Pu6EISAM.js +1 -0
  20. package/dist/web/assets/release-notes-CCpzyiNf.js +5 -0
  21. package/dist/web/assets/requestData-D5vBnuMh.js +1 -0
  22. package/dist/web/assets/routes-Q91zvNc0.js +4 -0
  23. package/dist/web/assets/settings-BzRgcmUm.js +1 -0
  24. package/dist/web/assets/taskReview-_WCgnQit.js +1 -0
  25. package/dist/web/assets/workTarget-C9c57JAO.js +30 -0
  26. package/dist/web/index.html +4 -4
  27. package/docs/architecture.md +315 -2
  28. package/docs/development.md +1 -1
  29. package/docs/how-to-use.md +184 -0
  30. package/docs/installation.md +5 -5
  31. package/lib/cli/args.js +45 -0
  32. package/lib/cli/help.js +36 -1
  33. package/lib/cli/main.js +27 -3
  34. package/lib/cli/output.js +9 -1
  35. package/lib/cli/preflightCommands.js +7 -1
  36. package/lib/cli/project.js +3 -0
  37. package/lib/cli/qualityCommands.js +163 -0
  38. package/lib/cli/readOnly.js +2 -0
  39. package/lib/cli/requestCommands.js +12 -0
  40. package/lib/cli/showView.js +69 -3
  41. package/lib/cli/taskCommands.js +312 -17
  42. package/lib/cli/taskReviewCommands.js +178 -0
  43. package/lib/core/context.js +4 -1
  44. package/lib/core/milestoneReview/material.js +11 -1
  45. package/lib/core/milestoneReview/mockReviewer.js +1 -0
  46. package/lib/core/milestoneReview/review.js +70 -6
  47. package/lib/core/milestoneReview/service.js +29 -93
  48. package/lib/core/milestoneReview/store.js +12 -62
  49. package/lib/core/ops.js +9 -2
  50. package/lib/core/preflight/carryover.js +1 -1
  51. package/lib/core/preflight/engine.js +6 -0
  52. package/lib/core/preflight/instructions.js +18 -1
  53. package/lib/core/preflight/mockEngine.js +4 -0
  54. package/lib/core/preflight/service.js +45 -4
  55. package/lib/core/projectRegistry.js +3 -3
  56. package/lib/core/quality.js +21 -0
  57. package/lib/core/qualityImprovement.js +221 -0
  58. package/lib/core/requestOps.js +97 -6
  59. package/lib/core/reviewRuns.js +205 -0
  60. package/lib/core/store/archivedTasks.js +74 -0
  61. package/lib/core/store/collection.js +12 -2
  62. package/lib/core/store/normalize.js +16 -1
  63. package/lib/core/store/preflightStore.js +9 -1
  64. package/lib/core/store/projectFile.js +10 -0
  65. package/lib/core/store/workspace.js +33 -3
  66. package/lib/core/taskReview/material.js +452 -0
  67. package/lib/core/taskReview/mockReviewer.js +30 -0
  68. package/lib/core/taskReview/paths.js +15 -0
  69. package/lib/core/taskReview/review.js +305 -0
  70. package/lib/core/taskReview/service.js +187 -0
  71. package/lib/core/taskReview/store.js +214 -0
  72. package/lib/server/api/manifest.js +55 -4
  73. package/lib/server/api/milestoneReviewRoutes.js +4 -3
  74. package/lib/server/api/routes.js +145 -17
  75. package/lib/server/api/taskReviewRoutes.js +66 -0
  76. package/lib/server/server.js +2 -2
  77. package/lib/shared/acceptance.js +378 -0
  78. package/lib/shared/milestoneReview.js +2 -1
  79. package/lib/shared/quality.js +391 -0
  80. package/lib/shared/qualityImprovement.js +1 -0
  81. package/lib/shared/qualityTemplates.js +31 -0
  82. package/lib/shared/taskBlock.js +142 -0
  83. package/lib/shared/taskReview.js +56 -0
  84. package/package.json +1 -1
  85. package/skills/p3/SKILL.md +31 -2
  86. package/dist/web/assets/Outputs-ddwte0jj.js +0 -1
  87. package/dist/web/assets/TagInput-BHAgjLP7.js +0 -1
  88. package/dist/web/assets/TaskDrawer-Dz_5c2NH.js +0 -3
  89. package/dist/web/assets/_requestId-D9-gtIcG.js +0 -1
  90. package/dist/web/assets/_requestId-DzCNYvqf.js +0 -30
  91. package/dist/web/assets/appCtx-Cm24VpAf.js +0 -1
  92. package/dist/web/assets/board-MCHcZ-PU.js +0 -1
  93. package/dist/web/assets/done-zq10Bt08.js +0 -1
  94. package/dist/web/assets/index-Ce0ndpne.js +0 -12
  95. package/dist/web/assets/index-D68mkSnw.css +0 -2
  96. package/dist/web/assets/preload-helper-FBLw7u7x.js +0 -1
  97. package/dist/web/assets/release-notes-hK5XezLW.js +0 -5
  98. package/dist/web/assets/requestData-BnN7mctX.js +0 -1
  99. package/dist/web/assets/routes-usHwrrA0.js +0 -3
  100. package/dist/web/assets/settings-BVZDnL6O.js +0 -1
  101. package/dist/web/assets/workTarget-Cijqq4yH.js +0 -1
@@ -93,6 +93,10 @@ p3 drafts k7m3x # 評価(判定・妥当性・実現可能性・
93
93
  (`preflight/<run>/drafts/D1.md`)を直接直してもよい。画面でも題・作業先・採否を直せる。本文(作業内容・完了条件・
94
94
  判断の根拠・未確認)は、カードの「内容を見る」で開く詳細に、整形した Markdown で全文出る(読むだけ。見出し・箇条書き・
95
95
  コード・表・チェックリスト)。Escape か「閉じる」で一覧に戻る。不採用の案・タスク化した後・前の run の案も読める
96
+ - **受け入れ基準**: 案ごとに、完了したと確かめられる条件(`acceptanceCriteria`。A1, A2, ...)が付く。タスク化の前に
97
+ `p3 criteria D1 --req k7m3x [--run <run>]`(`add` / `edit` / `rm` / `order`)か、案のファイルで直せる。タスク化すると
98
+ 採用した案の基準が ID ごとタスクに写る([受け入れ基準と証拠](#受け入れ基準と証拠))。基準が読めない案(空の文・重複した
99
+ ID など)は理由が出て、直すまでタスク化できない。基準の無い前の run の案は、基準なしのタスクになる
96
100
  - **題の直し方(画面)**: カードの題は、欄から離れると保存する(変えていなければ送らない)。ファイルや CLI など外で題が
97
101
  変わったら、再読み込み・タブに戻ったときに取り込む。直していない欄はそのまま最新になり、直している途中なら入力は残して
98
102
  「編集中に題が他で変わりました」と外の最新の題を出す。そのあいだは欄から離れても保存せず、「入力を捨てて最新にする」で
@@ -457,6 +461,28 @@ Preflight は始めたときの内容を固定して評価する。**評価の
457
461
  不要ならアーカイブする(`p3 archive T001`)。過去の経緯や別の要望とのつながりは、関係ではなく git の履歴と過去の要望・タスクの
458
462
  ファイルから調べる。
459
463
 
464
+ ### アーカイブしたタスクを見る
465
+
466
+ タスクの題・本文は `p3 set` や画面で直せるが、要らなくなった・やり方を変えるときは、アーカイブして新しいタスクを作る。
467
+ アーカイブしたタスクは、明示したときだけ読める(読むだけ。戻す・直すことはできない)。
468
+
469
+ 画面では、要望の「アーカイブ」タブに一覧(ID・タイトル・アーカイブ前の状態・最終更新)が出る。行を押すと閲覧専用の詳細
470
+ (本文・変更の記録・成果物・作業先・日時・保存された関係)が開き、URL は `?archived=T003`(通常のタスクの詳細は `?task=T003`)。
471
+ 詳細には保存・状態の変更・済み・作業先の変更・復元の操作は無い。通常のタスクの関係の相手(旧案など)がアーカイブされていれば、
472
+ 関係の欄に「アーカイブ」と出て、そこから詳細を開ける(表示だけで、依存の完了扱いは変わらない)。読めないアーカイブのファイルは
473
+ 一覧の上に件数と理由が出る。
474
+
475
+ CLI では:
476
+
477
+ ```bash
478
+ p3 ls --archived --req <要望> # 一覧(ID の順。読めないファイルは「読めない」に出る)
479
+ p3 show T003 --archived --req <要望> # 本文・変更の記録・成果物・保存された関係
480
+ ```
481
+
482
+ アーカイブしたタスクは、通常の一覧・タスクボード・進捗・対応済の判定・新しく作るレビューとリリースノートの材料には入らない
483
+ (どこで見えて、どこで見えないかは [設計](architecture.md#アーカイブしたタスク))。表示される状態・最終更新はアーカイブする前の
484
+ 最後の値で、アーカイブした日時ではない。
485
+
460
486
  ### 成果物と変更の記録
461
487
 
462
488
  - **成果物**(`outputs`): 1項目ずつ、PR / MR の URL・文章・ドキュメントのパスのどれでもよい。完了にするときは今あるもの
@@ -467,6 +493,138 @@ Preflight は始めたときの内容を固定して評価する。**評価の
467
493
  - **変更の記録**(`record`): 何を変えたか・なぜ・入れた決まり・やめたもの(Markdown)。`move <T> done --record 本文|-`、後から直すなら
468
494
  `set <T> --record ...`、画面のタスク詳細。`P3_ACTOR=ai:...` で完了にするときは必須(人は無くてもよい)
469
495
 
496
+ ### 品質基準
497
+
498
+ プロジェクトとして守る最低限の水準(規約・構成・検証・文書・lint など)を、ID の付いた項目として project.yaml に書いておける。
499
+ 未設定でも作業は続けられる。
500
+
501
+ ```bash
502
+ p3 quality # 今の設定(未設定・設定済み・読めない)
503
+ p3 quality templates # 同梱のテンプレート(basic@1 共通の基本 / typescript@1 TypeScript の例)
504
+ p3 quality template typescript # 中身を見る
505
+ p3 quality adopt basic # 写して採用する(編集できる実体になる)。空のまま設定するなら p3 quality init
506
+ p3 quality add --text "lint が警告なしで通る" --repo app --command "pnpm lint" --success "終了コード 0" # 機械の検査
507
+ p3 quality add --text "画面の文言は用語集に従う" --reference "docs/glossary.md と照らす" # 人の確認
508
+ p3 quality exempt Q2 --reason "小さい CLI なので層が無い" # 適用の除外(理由は必須)。unexempt で戻す
509
+ p3 quality set Q5 --repo all # 対象を全部の参照先に戻す / rm Q4 で消す(ID は使い直さない)
510
+ ```
511
+
512
+ - 画面では設定の「品質基準」のタブで、テンプレートの中身を確かめて編集中の一覧へ足し、対象・確認の方法・除外の理由を直して
513
+ 「品質基準を保存」。編集中に他で変わったら入力は残し、保存はさせない(「元に戻す」で最新を読む)
514
+ - P3 はコマンドを実行しない。確認は作業する側(人・AI・CI)が行う。テンプレートは例で、業界の標準への認証ではない
515
+ - テンプレートに新しい版が出ても採用済みの内容は変わらない。差分は `p3 quality` に出て、`p3 quality upgrade <テンプレート>` で当てる
516
+ - **タスクへの取り込み**: Preflight のタスク化と `p3 new`・「+ タスクを追加」で、作業先に当てはまる品質基準が `[Q1] …` の受け入れ基準として
517
+ 入る(`p3 new --quality none` で入れない、`--quality Q1,Q2` で明示。作業先なしのタスクには明示したときだけ)。Preflight は始めた
518
+ ときの品質基準を資料に固定する
519
+ - **設定を変えたとき**: 既存のタスクは自動では変わらない。`p3 criteria T003 quality` で差分を見て、`p3 criteria T003 quality import change:Q1`
520
+ (省くと全部)で取り込む。画面ではタスク詳細の「品質基準との差分」で選んで「選んだ差分を取り込む」。変わった条件の証拠は再確認が必要になる
521
+ - **改善要望**: 品質基準が未設定・読めない、レビューで違反・判断できないと出たときは、改善要望の案を確かめて登録できる。
522
+ `p3 quality improve`(設定から)・`p3 quality improve task <要望>/<T> <run>`・`p3 quality improve milestone <ID> <run>` で不足と原稿を見て
523
+ (何も変えない)、`--register --hash <診断の版> [--title …] [--key …]` で登録する。画面では設定の「品質基準」・レビューの品質の欄の
524
+ 「改善要望の案を確認」から、不足を選んで原稿を直し「要望を登録」。同じ不足に開いている要望があれば案内して作らない。
525
+ 閉じた要望で扱った不足から作り直すなら明示する(`--reopen`)。未設定のまま続けるなら、閉じるだけでよい
526
+ - 規則の詳細: [architecture.md の品質基準](architecture.md#品質基準)
527
+
528
+ ### 止まっている理由
529
+
530
+ 作業中のタスクが進められなくなったら(人の判断・権限が要る、前提が崩れた、テストが通らず先に進めない)、止まっている理由を付ける。
531
+ 状態は作業中のまま(止まっていることは状態ではなく属性)。人は一覧・進捗で止まっているタスクを見つけ、答えて解除する。
532
+
533
+ ```bash
534
+ p3 block T003 --reason "テストが通らず先に進めない" --decision "API の形を変えてよいか" # 付ける(作業中だけ)
535
+ p3 block T003 --reason - < reason.md # 内容を直す(止まった時刻は変えない)。- は標準入力(どれか1つ)
536
+ p3 ls --blocked --all # 止まっているタスクだけ(--status などと AND)
537
+ p3 progress # 要望ごとに「⏸停止 n」。子のある要望は配下の停止も
538
+ p3 unblock T003 --resolution "形を変えてよい。互換の層は不要" # 解除(回答・解決の内容は必須)
539
+ ```
540
+
541
+ - 止まったままは未着手・完了へ動かせない(先に解除する)。解除しても状態は作業中のままで、自動では再開しない
542
+ - 付けた・直した・解除したことは履歴に残る(`p3 show T003` の「停止の履歴」)。同じ内容の付け直し・付いていない解除は何も変えない
543
+ - 理由・決めてほしいことは 2000 文字、回答・解決の内容は 4000 文字まで
544
+ - **画面**: タスク詳細の上部に停止の今の値(理由・いつから・付けた人・決めてほしいこと)と操作を出す。作業中なら「停止理由を付ける」、
545
+ 止まっていれば「停止内容を編集」「停止を解除」(回答・解決の内容を書いて「記録して停止を解除」)。履歴は「停止の履歴」で開く。
546
+ タスクボードの作業中カードに「⏸ 停止中」・理由・決めてほしいことが出て、「停止中のみ」で止まっているカードだけにできる(列は増えない。
547
+ 「依存待ち」は依存先が未完了の別の印)。進捗は「停止中のみ」で止まっているタスクのある要望だけにし(親は文脈として残り、配下の停止の
548
+ 数が出る)、スケジュールの作業中の印は一時停止の形になる。条件は URL に残る。止まったまま未着手・完了へ動かすと断られ、解除を案内する
549
+ - **AI エージェント**(同梱のスキルと AGENTS.md / CLAUDE.md の節)は、続けられなくなったときだけ理由と決めてほしいことを付け、保存できた
550
+ ことを確かめて人に伝えて作業を終える(止まったまま完了・済み・対応済に進めない)。回答を受けたら解除して再開する(人が先に解除して
551
+ いれば履歴の回答を読む)。前に置いたスキル・節は自動では変わらないので、`p3 agents <claude|codex|both>` で違いを確かめ `--force` で更新する
552
+ - 規則の詳細・保存の形: [architecture.md の止まっている理由](architecture.md#止まっている理由停止)
553
+
554
+ ### 受け入れ基準と証拠
555
+
556
+ タスクに **受け入れ基準**(何を満たせば完了か)を付けると、作業した側は完了するときに基準ごとの **証拠** を残し、人は「済み」に
557
+ する前に基準と証拠を並べて確かめられる。基準は任意で、無いタスクは今までどおり(「受け入れ基準なし」と出る)。
558
+
559
+ ```bash
560
+ p3 new "通知設定画面" --criterion "設定を保存して再読み込みしても残る" --criterion "幅 375 で横にはみ出さない"
561
+ p3 criteria T004 # 基準と証拠・不足
562
+ p3 criteria T004 add "キーボードだけで保存できる" # ID は A1, A2, ... を振る(消した ID は使い直さない)
563
+ p3 criteria T004 edit A2 "幅 375 / 1280 で横にはみ出さない"
564
+ p3 criteria T004 rm A3 # 証拠は「対応する基準のない証拠」として残る
565
+ p3 criteria T004 order A2 A1 # 今の ID を全部
566
+
567
+ # 完了と同時に証拠を残す(--record と標準入力を取り合わないよう、証拠はファイルか --evidence で)
568
+ p3 move T004 done --record - --evidence-file evidence.md < record.md
569
+ p3 move T004 done --evidence "A1=met:test/settings.test.ts" --evidence "A2=unverified:375 の端末が無い" --record ...
570
+ p3 evidence T004 A2 met --file a2.md # 1項目ずつ(再記録は置き換え)。evidence T004 rm A2 で消す
571
+ ```
572
+
573
+ 証拠のファイルは、見出し `## <基準の ID> <結果>` ごとに次の見出しまでを本文として読む:
574
+
575
+ ```markdown
576
+ ## A1 met
577
+ - `pnpm -s check` が通った(test/settings.test.ts の「再読み込みしても残る」)
578
+
579
+ ## A2 unverified
580
+ 幅 1280 は確かめた。375 は端末が無く確かめていない
581
+ ```
582
+
583
+ - 結果は `met`(満たした。本文が要る)/ `unmet`(満たせなかった)/ `unverified`(確かめていない)。証拠は作業した側の申告で、
584
+ レビューの判定ではない
585
+ - 基準の文を変えると、その基準の証拠は「再確認が必要」になり、満たした数に入らない(記録し直す)
586
+ - 証拠なし・未達・未検証があっても完了・済み・対応済は拒まない。不足は `show` / `criteria` の「不足」、`--json` の
587
+ `acceptance.shortfalls`、`move ... done` の stderr に出る
588
+ - 済みのタスクの基準・証拠の中身を変えると、済みが外れる(同じ値の再保存・成果物の URL の追加では外れない)
589
+ - ファイルを直接編集して読めない値になったら、`show` に「読めない」と出て、直すまで基準・証拠の操作はできない(ほかの更新では元の値が残る)
590
+ - 証拠は作業した側の申告で、レビューの判定ではない。変更の記録(`--record`)は何を変えたか・なぜ、証拠は基準ごとの確かめた材料
591
+ - AI エージェントは、着手する前に基準を読み、完了と同時に基準ごとの証拠を残し、未達・未検証を残して完了したら人に伝える
592
+ (同梱のスキルと AGENTS.md / CLAUDE.md の節)。前に置いたスキル・節は自動では変わらないので、置いたプロジェクトで
593
+ `p3 agents <claude|codex|both>` で違いを確かめ、`--force` で同梱の版にする
594
+ - 規則の詳細: [architecture.md の受け入れ基準と証拠](architecture.md#受け入れ基準と証拠)
595
+
596
+ ### タスクの AI レビュー
597
+
598
+ 完了したタスクについて、本文・受け入れ基準が成果物(コミットの差分)で満たされているかを、作業したのとは別の Codex のスレッドに
599
+ 確かめさせる。人が「済み」にする前の材料で、作業した AI の能力・成績の評価ではない。結果はタスクの状態・済み・基準・証拠を変えず、
600
+ レビューだけでは済みにならない(不足があっても人は済みにできる)。
601
+
602
+ ```bash
603
+ p3 review T004 --preview # 今の材料(比較項目・比較対象・観点・注意・hash)を見るだけ
604
+ p3 review T004 # 成果物のコミットと比べる(終わるまで待つ。Ctrl-C で取り消す)
605
+ p3 review T004 --target app:1a2b3c4d # 比較対象を指定(カンマで複数。範囲は app:main..req/261009-k7m3x)
606
+ p3 review T004 --viewpoint app@1a2b3c4d:docs/REVIEW.md # 観点を固定した SHA のファイルから(project で project.yaml の taskReview.viewpoints)
607
+ p3 reviews T004 # 履歴(アーカイブしたタスクも読める)
608
+ p3 review-show T004 TR-20261112-101500-ab12 # 1回分(項目ごとの判定・理由・根拠・不足・意図しない変更の候補・確かめる点・読めた範囲)
609
+ p3 review-cancel T004 TR-20261112-101500-ab12 # 取り消す(所有者を確かめられない run は --acknowledge-stopped)
610
+ ```
611
+
612
+ - 判定は 満たしている / 不足 / 判断できない。「満たしている」はコード・差分の根拠があるときだけ(記録だけでは付かない)
613
+ - Codex には、固定した材料(差分と前後のコード)だけを読むだけで渡す。リポジトリやデータのフォルダはマウントしない。テストや
614
+ アプリは動かさない。毎回新しいスレッドで、作業したスレッドは再開しない
615
+ - Preflight の担当が `agent` のプロジェクトでは、Codex で実行するなら `--engine codex`(画面では「Codex で実行する」)の明示が要る
616
+ - 材料が変わった(本文・基準・証拠・比較対象・観点)ら、新しい run としてレビューし直す。結果を直す操作は無い
617
+ - **画面**: タスク詳細の「タスクの AI レビュー」(作業した側の証拠とは別の欄)で、比較する対象・観点を選んで「材料を確かめる」と、
618
+ 比較項目・固定した SHA・観点の出典・注意と材料の hash が出る。「新しい Codex のスレッドでレビューを始める」はその hash で始め、
619
+ 確かめた後で材料が変わっていれば断られる(確かめ直す)。保存していない入力がある間は始められない。履歴は run ごとに選んで読み、
620
+ 実行中は取消(所有者を確かめられなければ明示の中断)、失敗・取消は理由が出る。今の本文・基準・証拠・比較対象・観点が実行したときと
621
+ 違えば「材料が変わりました」と出て、同じ指定で確かめ直せる(再レビューは新しい run)。未完了のタスクは始められず、アーカイブした
622
+ タスクは履歴を読むだけ
623
+ - **品質**: 品質基準が設定してあれば、タスクの比較項目とは別に、レビューを始めたときの最新の品質基準ごとに「満たす・違反・判断
624
+ できない・対象外(理由つき)」を出す。タスクに取り込んだ版と最新の差も材料と結果に出る(基準の改定による不足とコードの逸脱を
625
+ 分ける)。違反は「品質の指摘」として出る。検査のコマンドは実行しない。品質基準が未設定・古い記録では品質は評価しない
626
+ - 規則の詳細(比較対象・観点・上限・保存先): [architecture.md のタスクの AI レビュー](architecture.md#タスクの-ai-レビュー材料)
627
+
470
628
  ### タグ・期限・マイルストーン
471
629
 
472
630
  - **期限**(`due`): 要望の期限(`--due YYYY-MM-DD`)。進捗のスケジュールに ⚑ で出る
@@ -650,6 +808,9 @@ p3 milestone review-cancel v0.2 <run> # 取り消す(ほかのプロセス
650
808
  「達成」にはコードの根拠が要る(記録だけで達成とした結果や、参照先に無いパス・コミットを挙げた結果は使わず、失敗にする)。
651
809
  予定機能が無く目的だけなら、目的そのものを判定する。目的も予定機能も無ければ実行できない(先に書く案内が出る)。要望が 0 件でも
652
810
  実行でき、材料が無いことを記録する。タスクの完了数で達成を決めず、数値の達成率は出さない
811
+ - **品質**: 品質基準が設定してあれば、目的・予定機能の判定とは別に、品質基準ごとに「満たす・違反・判断できない・対象外(理由つき)」を
812
+ 出す(違反は「品質の指摘」)。過去に満たしていたものを崩したと履歴のコミットで裏付けたときだけ「品質の低下」と出す。評価した版と
813
+ 今の品質基準の版が違えばそう出る。未設定なら評価せず、設定の「品質基準」へ案内する。品質の材料が無い古い記録は評価していないと出る
653
814
  - **確かめないこと**: テストやアプリを実際に動かすこと・公開されたか。結果の「範囲」にも書く
654
815
  - **頼む先**: Preflight と同じ Codex の接続(ChatGPT プラン)。参照先は読むだけでマウントし、データのフォルダは渡さない。コードを読むので
655
816
  Preflight と同じくらい時間がかかる(上限 20 分)。失敗(認証なし・使用量の上限・時間切れ・形の違う結果)は失敗として記録し、
@@ -736,6 +897,13 @@ p3 render 画面.html --width 1280 # 画面.png ができる(幅 32
736
897
  (本文を下へ送っても見出しは残るので、上まで戻らずにコピーできる)。コピーできない(拒まれた・http で別のマシンから開いて
737
898
  Clipboard API が無い)ときはそう出るので、ID をクリックして全体を選び、手でコピーする。
738
899
 
900
+ **受け入れ基準(画面)**: タスク詳細の「受け入れ基準と作業した側の証拠」に、基準ごとの結果(満たした・満たせなかった・未検証・
901
+ 証拠なし・再確認が必要)と証拠が並ぶ。「済みにする」の近くに不足の数が出る(不足があっても済みにできる)。「証拠を登録 / 編集」で
902
+ 1項目ずつ残し、「基準を編集 / 足す」で並び全体を直す(どちらも保存・取消)。保存していない入力がある間は済みを変えられない。
903
+ 保存は編集を始めたときの rev で送り、他で変わっていれば入力を残して知らせる(「最新に合わせる」で保存し直す)。済みのタスクの
904
+ 基準・証拠を変えると済みが外れ、理由が出る。タスク案の詳細(「内容を見る」)でもタスク化の前に基準を直せ、保存していない基準が
905
+ ある間はタスク化できない。「+ タスクを追加」でも基準を入れられる。アーカイブの詳細では読むだけ
906
+
739
907
  進捗のスケジュールの記号:
740
908
 
741
909
  | 記号 | 意味 |
@@ -828,8 +996,10 @@ DB は無く、1タスク = 1 Markdown ファイル。人・AI・Codex が直接
828
996
  notes/N-....md Preflight へのメモ
829
997
  attachments/A-.../ 添付
830
998
  preflight/PF-.../ Preflight の記録(評価対象・評価・タスク案・画面資料・ログ)
999
+ task-reviews/T003/TR-.../ タスクの AI レビューの履歴(「タスクの AI レビュー」)
831
1000
  .archive/ アーカイブした要望
832
1001
  release-notes/v0.2.md リリースノート(マイルストーンごとに1件)
1002
+ milestone-reviews/v0.2/<run>/ マイルストーンレビューの履歴(「マイルストーンレビュー」)
833
1003
  ```
834
1004
 
835
1005
  タスクファイルの例(`requests/261009-k7m3x/tasks/T003.md`):
@@ -848,6 +1018,16 @@ checkedAt: 2026-10-10T09:00:00.000Z # 人が確認して「済み」に
848
1018
  record: | # 変更の記録
849
1019
  - 外部の編集をファイル監視で取り込むようにした
850
1020
  - 理由: CLI で直したタスクが画面に出なかった
1021
+ acceptanceCriteria: # 受け入れ基準(任意。ID は P3 が振る)
1022
+ - { id: A1, text: CLI で直したタスクが画面に出る }
1023
+ acceptanceEvidence: # 基準ごとの証拠(作業した側の申告)
1024
+ - criterionId: A1
1025
+ criterionText: CLI で直したタスクが画面に出る
1026
+ result: met
1027
+ evidence: test/watch.test.ts の「外部の編集を取り込む」
1028
+ recordedAt: 2026-10-09T15:39:00.000Z
1029
+ recordedBy: ai:claude
1030
+ acceptanceSeq: 1 # 振った最後の番号(消した ID を使い直さない)
851
1031
  relations:
852
1032
  - { type: depends_on, target: T002, origin: preflight }
853
1033
  rev: 3
@@ -915,6 +1095,10 @@ AI にも CLI を使わせる(認証を持たせずに済む)。`p3 init --a
915
1095
  | `p3 request new\|ls\|show\|set\|archive` | 要望 |
916
1096
  | `p3 ls` / `p3 show` / `p3 find` | タスクの一覧(`--all` で全要望)/ 詳細(`--brief`)/ 参照・タイトルで探す |
917
1097
  | `p3 new` / `p3 set` / `p3 move` / `p3 check` / `p3 archive` | タスクを足す / 直す / 状態を変える / 済みにする / アーカイブ |
1098
+ | `p3 review <T>` / `p3 reviews <T>` / `p3 review-show <T> <run>` / `p3 review-cancel <T> <run>` | 完了したタスクの AI レビュー([タスクの AI レビュー](#タスクの-ai-レビュー)) |
1099
+ | `p3 quality` | 品質基準(テンプレート・採用・追加・変更・除外。[品質基準](#品質基準)) |
1100
+ | `p3 block <T>` / `p3 unblock <T>` | 作業中のタスクに止まっている理由を付ける・直す / 解除する([止まっている理由](#止まっている理由)) |
1101
+ | `p3 criteria <T>` / `p3 evidence <T>` | 受け入れ基準を見る・足す・直す・消す・並べ替える / 基準ごとの証拠を残す・消す([受け入れ基準と証拠](#受け入れ基準と証拠)) |
918
1102
  | `p3 preflight` / `p3 notes` / `p3 drafts` / `p3 accept` | Preflight の実行(`--note`。手元のエージェントなら `--prepare` / `--complete`。中断は `--cancel --run`)/ メモ / 評価とタスク案 / タスク化 |
919
1103
  | `p3 attach` / `p3 render` | 添付 / 画面イメージの描画 |
920
1104
  | `p3 chatgpt` / `p3 codex update` / `p3 serve` | ChatGPT の接続 / Codex のイメージ / 画面(`--all-projects` で登録したプロジェクトを跨ぐ) |
@@ -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.11.0` など)と
325
+ 入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.12.0` など)と
326
326
  `latest` がある。決まった版で使うなら版のタグを指す。対応する platform は `linux/amd64` だけ(arm64 は確かめるマシンが無いので
327
327
  作っていない)。
328
328
 
329
329
  ```bash
330
- docker pull tamuto/p3:0.11.0
330
+ docker pull tamuto/p3:0.12.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.11.0
351
+ image: tamuto/p3:0.12.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.11.0
375
+ tamuto/p3:0.12.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.11.0 serve --project myapp --host 0.0.0.0`。compose なら
388
+ - **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.12.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/args.js CHANGED
@@ -3,6 +3,7 @@ import { readFile } from "node:fs/promises";
3
3
  import { basename, resolve as resolvePath } from "node:path";
4
4
  import { parseArgs } from "node:util";
5
5
  import { ATTACHMENT_LIMITS, AttachmentError, inspectAttachment } from "../core/store/attachments.js";
6
+ import { parseEvidenceArg, parseEvidenceFile } from "../shared/acceptance.js";
6
7
  import { TASK_STATUSES, isTaskStatus } from "../shared/types.js";
7
8
  import {} from "../core/context.js";
8
9
  import { repoArg } from "../core/workTargets.js";
@@ -37,6 +38,25 @@ const OPTIONS = {
37
38
  off: { type: "boolean" },
38
39
  body: { type: "string" },
39
40
  record: { type: "string" },
41
+ criterion: { type: "string", multiple: true },
42
+ evidence: { type: "string", multiple: true },
43
+ "evidence-file": { type: "string" },
44
+ target: { type: "string", multiple: true },
45
+ reason: { type: "string" },
46
+ text: { type: "string" },
47
+ command: { type: "string" },
48
+ success: { type: "string" },
49
+ reference: { type: "string" },
50
+ quality: { type: "string" },
51
+ key: { type: "string", multiple: true },
52
+ hash: { type: "string" },
53
+ register: { type: "boolean" },
54
+ reopen: { type: "boolean" },
55
+ decision: { type: "string" },
56
+ resolution: { type: "string" },
57
+ blocked: { type: "boolean" },
58
+ viewpoint: { type: "string" },
59
+ preview: { type: "boolean" },
40
60
  note: { type: "string" },
41
61
  engine: { type: "string" },
42
62
  run: { type: "string" },
@@ -56,6 +76,7 @@ const OPTIONS = {
56
76
  complete: { type: "boolean" },
57
77
  cancel: { type: "boolean" },
58
78
  "archive-superseded": { type: "boolean" },
79
+ archived: { type: "boolean" },
59
80
  paste: { type: "boolean" },
60
81
  "no-browser": { type: "boolean" },
61
82
  forget: { type: "boolean" },
@@ -148,6 +169,30 @@ export function date(v) {
148
169
  throw new UsageError(`日付は YYYY-MM-DD: ${v}`);
149
170
  return v;
150
171
  }
172
+ /**
173
+ * set / move の証拠の入力(--evidence <ID>=<結果>[:本文] を繰り返す / --evidence-file <Markdown>|-)を操作にする。
174
+ * --evidence-file - と --record - は同じ標準入力を取り合うので一緒には使えない
175
+ */
176
+ export function evidenceOps(o) {
177
+ const ops = (o.evidence ?? []).map(parseEvidenceArg);
178
+ const file = o["evidence-file"];
179
+ if (file !== undefined) {
180
+ if (file === "-" && (o.record === "-" || o.body === "-"))
181
+ throw new UsageError("標準入力(-)は --evidence-file と --record / --body のどちらか一方だけに使えます(もう一方はファイルか文字で渡してください)");
182
+ let src;
183
+ try {
184
+ src = file === "-" ? readFileSync(0, "utf8") : readFileSync(resolvePath(process.cwd(), file), "utf8");
185
+ }
186
+ catch {
187
+ throw new UsageError(`証拠のファイルが読めません: ${file}`);
188
+ }
189
+ ops.push(...parseEvidenceFile(src));
190
+ }
191
+ const dup = ops.map((x) => (x.op === "record" ? x.id : "")).find((id, i, a) => id && a.indexOf(id) !== i);
192
+ if (dup)
193
+ throw new UsageError(`${dup} の証拠が2回指定されています`);
194
+ return ops;
195
+ }
151
196
  export function readBody(v) {
152
197
  if (v === undefined)
153
198
  return "";
package/lib/cli/help.js CHANGED
@@ -27,6 +27,14 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
27
27
  codex.effort / codex.ensureImage / preflight.engine / serve.host / serve.port(キー= で消す)
28
28
  set codex.pathMap+=<このマシンのパス>=<Docker デーモンから見たパス> パスの対応を足す
29
29
  set codex.pathMap-=<このマシンのパス> 外す(codex.pathMap= で全部外す)
30
+ quality 品質基準(project.yaml の quality。未設定・設定済み・読めない)とテンプレートの改版の差分
31
+ templates / template <id> 同梱のテンプレート(版つきの例。業界の標準への認証ではない)
32
+ init 空で設定する / adopt <テンプレート> 写して採用する / upgrade <テンプレート> 改版の差分を当てる
33
+ add --text 文 [--repo 名前] (--command コマンド --success 成功の条件 | --reference 確かめ方)
34
+ set <Q1> [--text] [--repo 名前|all] [...] / rm <Q1> / exempt <Q1> --reason 理由 / unexempt <Q1>
35
+ --version <版> で、他で変わっていれば競合(終了コード 3)。P3 はコマンドを実行しない
36
+ improve [task <要望>/<T> <run> | milestone <ID> <run>] 品質の不足の診断と改善要望の原稿(読むだけ)
37
+ --key <不足の鍵>... で選ぶ / --register --hash <診断の版> [--title] [--body] [--reopen] で明示して登録する
30
38
  progress 要望ごとの進捗(マイルストーンごと。--all で完了・見送りも。既定でも対応済を出す)
31
39
  milestone [ls | add <id> | set <id> | rm <id>] マイルストーン(リリース) --title 名前 --due YYYY-MM-DD --done
32
40
  milestone show <id> 目的・予定している機能と版(--json の milestonesVersion)
@@ -77,17 +85,44 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
77
85
 
78
86
  タスク(今の要望の中。--req <要望> で指定、要望の作業ツリーの中なら省略可)
79
87
  ls 一覧 --status s1,s2 --area パス -q 語句 --repo <参照先>|none(作業先) --all(全要望)
88
+ --blocked 止まっているタスクだけ(ほかの条件と AND。--archived とは一緒に使えない)
80
89
  show <T003|要望|語句> 詳細と関係(依存・置き換え)
81
90
  --brief 作業に要る項目だけ(本文・状態・依存とその状態・置き換えの注意・成果物・rev)
82
91
  new <タイトル> --body 本文|- --area a --label l --status --output 成果物(繰り返し可)
83
92
  --repo <参照先>|none 作業先(作業先にできる参照先だけ。足りないブランチは割り当てる)
93
+ --criterion 文 受け入れ基準(繰り返し可。ID は A1, A2, ... を振る)
84
94
  set <T003> キー=値 ... title status labels areas outputs repo(空で消す。outputs= はカンマ区切りで置き換える。repo=none は作業先なし)
85
95
  --repo-output <参照先>=<成果物> リポジトリごとの成果物を足す(repoOutputs= で全部外す)
96
+ --criterion 文 受け入れ基準を足す / --evidence・--evidence-file 証拠を残す(move と同じ)
86
97
  move <T003> <ステータス> --output URL・文章・パス(成果物を足す。繰り返し可。カンマで分けない)
87
98
  --repo-output <参照先>=<URL> リポジトリごとの成果物(最後のタスクに全リポジトリの PR を残す)
88
99
  --record 本文|- 変更の記録(何を変えたか・なぜ・入れた決まり・やめたもの。AI が完了にするときは必須。set でも直せる)
100
+ --evidence <ID>=met|unmet|unverified[:本文] 受け入れ基準ごとの証拠(繰り返し可。met は本文が要る)
101
+ --evidence-file 証拠.md|- 見出し「## A1 met」ごとの証拠をまとめて(- は --record - と一緒に使えない)
102
+ 不足(証拠なし・未達・未検証・基準を変えた後)があっても完了は拒まず、stderr に出す
89
103
  check <T003> [--off] 完了したタスクを人が確認して「済み」にする(--off で外す)
90
- archive <T003> .archive/ へ移す
104
+ block <T003> --reason 理由|- [--decision 決めてほしいこと|-]
105
+ 作業中のタスクに止まっている理由を付ける・内容を直す(状態は作業中のまま。止まった時刻は直しても変えない)
106
+ 理由 2000・決めてほしいこと 2000 文字まで。- は標準入力(どれか1つ)
107
+ unblock <T003> --resolution 回答・解決の内容|-
108
+ 停止を解除する(回答・解決の内容は必須・4000 文字まで。状態は変えず、自動では再開しない)
109
+ 止まったままは未着手・完了へ動かせない(先に解除する)。付けた・直した・解除したことは履歴に残る
110
+ criteria <T003> 受け入れ基準と証拠・不足(作業した側の申告。人が済みにする前に読む)
111
+ add <文>... 足す / edit <ID> <文> 文を変える(記録済みの証拠は再確認が必要になる)
112
+ rm <ID>... 消す(証拠は残る。ID は使い直さない) / order <ID>... 並べ替える(今の ID を全部)
113
+ evidence <T003> <ID> <結果> 証拠を残す(再記録は置き換え)。本文は続けて書くか --body 本文|- / --file 本文.md
114
+ evidence <T003> --file 証拠.md|- まとめて / evidence <T003> rm <ID>... 消す
115
+ 済みのタスクの基準・証拠の中身を変えると済みが外れる(同じ値の再保存・成果物の追加では外れない)
116
+ review <T003> 完了したタスクの AI レビュー(別の Codex のスレッドが、固定した差分と前後のコードを読むだけで基準と比べる。
117
+ 終わるまで待つ。Ctrl-C で取り消す。結果はタスクの状態・済み・基準・証拠を変えない)
118
+ --target <参照先>:<コミット>[,<コミット>] | <参照先>:<base>..<head> 比較対象(繰り返し可。省くと成果物のコミット)
119
+ --viewpoint builtin|project|<参照先>@<SHA>:<パス> 観点(省くと既定。project は project.yaml の taskReview.viewpoints)
120
+ --engine codex|mock(Preflight の担当が agent なら Codex には --engine codex の明示が要る)--preview 材料を見るだけ
121
+ reviews <T003> レビューの履歴 / review-show <T003> <run> 1回分 / review-cancel <T003> <run> 取消
122
+ (所有者を確かめられない run は --acknowledge-stopped で中断。無い → 2、実行中・終わっている・材料が変わった → 3)
123
+ archive <T003> .archive/ へ移す(消さない。ID は再利用しない)
124
+ ls --archived アーカイブしたタスクの一覧(今の要望。読むだけ。壊れたファイルは「読めない」に出す)
125
+ show <T003> --archived アーカイブしたタスクの詳細(本文・変更の記録・成果物)。通常の ls / show / 進捗には出ない
91
126
  find <語句> 参照・タイトルで探す
92
127
 
93
128
  Preflight
package/lib/cli/main.js CHANGED
@@ -4,6 +4,13 @@ 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 { AcceptanceInputError } from "../shared/acceptance.js";
8
+ import { BlockInputError } from "../shared/taskBlock.js";
9
+ import { taskReviewCommand } from "./taskReviewCommands.js";
10
+ import { qualityCommand } from "./qualityCommands.js";
11
+ import { QualityInputError } from "../shared/quality.js";
12
+ import { ImprovementError } from "../core/qualityImprovement.js";
13
+ import { TaskReviewRejected } from "../core/taskReview/material.js";
7
14
  import { MilestonesConflictError, ProjectInputError } from "../core/store/workspace.js";
8
15
  import { ReviewCancelRefused, ReviewRejected } from "../core/milestoneReview/service.js";
9
16
  import { ReviewStoreError } from "../core/milestoneReview/store.js";
@@ -225,7 +232,7 @@ async function main(argv) {
225
232
  return { col: ctx.ws.tasksOf(rid), rid, tid };
226
233
  };
227
234
  const env = { ctx, out, args, o, actor, current, expectedRev, requestArg, taskArg, split, cwd, target };
228
- const handled = (await taskCommand(cmd, env)) ?? (await preflightCommand(cmd, env));
235
+ const handled = (await taskCommand(cmd, env)) ?? (await taskReviewCommand(cmd, env)) ?? (await preflightCommand(cmd, env));
229
236
  if (handled !== undefined)
230
237
  return handled;
231
238
  switch (cmd) {
@@ -276,13 +283,15 @@ async function main(argv) {
276
283
  : "",
277
284
  p.request.tags.map((t) => `#${t}`).join(" "),
278
285
  // 子のある要望は配下の集計(自分の値とは別)、子は親を添える
279
- `${p.request.title}${p.children.length ? ` [配下 ${p.subtree.done}/${p.subtree.total}・子 ${p.children.length}]` : ""}${p.request.parent ? ` ↑${p.request.parent}` : ""}${p.hierarchyIssues.length ? " ※親子の問題" : ""}`,
286
+ `${p.request.title}${p.blocked ? ` ⏸停止 ${p.blocked}` : ""}${p.children.length ? ` [配下 ${p.subtree.done}/${p.subtree.total}・子 ${p.children.length}${p.subtree.blocked > p.blocked ? `・配下の停止 ${p.subtree.blocked - p.blocked}` : ""}]` : ""}${p.request.parent ? ` ↑${p.request.parent}` : ""}${p.hierarchyIssues.length ? " ※親子の問題" : ""}`,
280
287
  ]);
281
288
  return `${head}\n${table(rows)}`;
282
289
  })
283
290
  .join("\n\n") || "要望はありません");
284
291
  });
285
292
  }
293
+ case "quality":
294
+ return qualityCommand(env);
286
295
  case "milestone":
287
296
  case "milestones":
288
297
  return milestoneCommand(ctx, out, args, o, actor);
@@ -336,6 +345,21 @@ main(process.argv.slice(2)).then((code) => process.exit(code), (e) => {
336
345
  const code = e.code;
337
346
  process.exit(code === "not_found" || code === "unknown_milestone" ? 2 : code === "running" || code === "finished" || code === "owner_alive" || code === "exists" ? 3 : 1);
338
347
  }
348
+ // タスクのレビュー: 実行中・材料が変わった → 3、ほか(未完了・比較対象・観点・上限・担当)→ 1
349
+ if (e instanceof TaskReviewRejected) {
350
+ process.stderr.write(`${e.message}\n`);
351
+ process.exit(e.code === "running" || e.code === "material_changed" ? 3 : 1);
352
+ }
353
+ // 改善要望: 診断が変わった・登録先がある → 3、無い → 2、ほか → 1
354
+ if (e instanceof ImprovementError) {
355
+ process.stderr.write(`${e.message}\n`);
356
+ process.exit(e.code === "not_found" ? 2 : e.code === "diagnosis_changed" || e.code === "existing" || e.code === "closed_existing" ? 3 : 1);
357
+ }
358
+ // 品質基準: 版が違う → 3、規則に合わない・読めない → 1
359
+ if (e instanceof QualityInputError) {
360
+ process.stderr.write(`${e.message}\n`);
361
+ process.exit(e.code === "quality_conflict" ? 3 : 1);
362
+ }
339
363
  // マイルストーンの版が違う(読んだ後に他で変わった)→ 3。何も書いていない
340
364
  if (e instanceof MilestonesConflictError) {
341
365
  process.stderr.write(`競合: ${e.message}\n`);
@@ -345,6 +369,6 @@ main(process.argv.slice(2)).then((code) => process.exit(code), (e) => {
345
369
  process.stderr.write(`見つかりません: ${e.id}\n`);
346
370
  process.exit(2);
347
371
  }
348
- process.stderr.write(`${e instanceof UsageError || e instanceof OpRuleError || e instanceof ProjectInputError ? "" : "エラー: "}${e.message}\n`);
372
+ process.stderr.write(`${e instanceof UsageError || e instanceof OpRuleError || e instanceof ProjectInputError || e instanceof AcceptanceInputError || e instanceof BlockInputError ? "" : "エラー: "}${e.message}\n`);
349
373
  process.exit(1);
350
374
  });
package/lib/cli/output.js CHANGED
@@ -4,6 +4,7 @@ import {} from "../core/context.js";
4
4
  import { resolve, titleOf } from "../core/ops.js";
5
5
  import {} from "../core/supersede.js";
6
6
  import { table } from "./format.js";
7
+ import { formatAcceptance, formatBlock } from "./showView.js";
7
8
  import { taskWork } from "../core/workTargets.js";
8
9
  import { DIRECT_TASK_NOTE, LATER_PREFLIGHT_NOTE } from "../shared/directTask.js";
9
10
  /** CLI の出力(人向けの表と --json)と、表示の部品 */
@@ -26,7 +27,7 @@ export function formatEntity(ctx, item, file) {
26
27
  const lines = [`${head} ${item.title}`, ""];
27
28
  if ("ref" in item)
28
29
  lines.push(` ${"作業先".padEnd(11)} ${workHint(ctx, item).replace(/^作業先: /, "")}`);
29
- const skip = new Set(["id", "ref", "request", "title", "body", "relations", "repo", "record"]);
30
+ const skip = new Set(["id", "ref", "request", "title", "body", "relations", "repo", "record", "acceptanceCriteria", "acceptanceEvidence", "acceptanceSeq", "acceptanceProblems", "block", "blockHistory", "blockProblems"]);
30
31
  for (const [k, v] of Object.entries(item)) {
31
32
  if (skip.has(k) || v === undefined || (Array.isArray(v) && !v.length))
32
33
  continue;
@@ -36,6 +37,13 @@ export function formatEntity(ctx, item, file) {
36
37
  lines.push("", indent(item.body.trim()));
37
38
  if ("record" in item && item.record)
38
39
  lines.push("", "変更の記録:", indent(item.record));
40
+ if ("ref" in item) {
41
+ const blk = formatBlock(item, { history: true });
42
+ if (blk.length)
43
+ lines.push("", ...blk);
44
+ }
45
+ if ("ref" in item)
46
+ lines.push("", ...formatAcceptance(item));
39
47
  if ("ref" in item) {
40
48
  const out = item.relations.map((r) => ` → ${pad(relationRole(r.type, "out"))} ${r.target} ${titleOf(ctx, `${home}/${r.target}`)}`);
41
49
  const inc = [
@@ -303,7 +303,7 @@ function inputMatchLine(rid, run, m) {
303
303
  }
304
304
  return `\n※ ${staleMessage(rid, run.id, m)}`;
305
305
  }
306
- async function pickRun(ctx, rid, runId) {
306
+ export async function pickRun(ctx, rid, runId) {
307
307
  const runs = await ctx.preflight.list(rid);
308
308
  const run = runId ? runs.find((r) => r.id === runId) : runs[0];
309
309
  if (!run)
@@ -348,6 +348,12 @@ function formatRun(ctx, rid, run) {
348
348
  d.title,
349
349
  d.dependsOn.length ? `← ${d.dependsOn.join(",")}` : "",
350
350
  ])));
351
+ // 受け入れ基準(タスク化の前に p3 criteria <D> で直せる)
352
+ for (const d of run.drafts) {
353
+ if (!d.acceptanceCriteria?.length && !d.acceptanceProblems?.length)
354
+ continue;
355
+ lines.push(` ${d.key} の受け入れ基準:`, ...(d.acceptanceCriteria ?? []).map((c) => ` ${c.id} ${c.text}`), ...(d.acceptanceProblems ?? []).map((p) => ` ※読めない: ${p}`));
356
+ }
351
357
  lines.push("", `ファイル: ${relative(process.cwd(), join(ctx.ws.preflight.runDir(rid, run.id), "drafts"))}/`);
352
358
  }
353
359
  if (a?.split) {
@@ -141,11 +141,14 @@ export function agentsSnippet(kinds) {
141
141
  - 着手する前に \`p3 show T003 --brief --json\` で本文・依存とその状態(\`dependencies\`)・置き換えの注意(\`warnings\`)を読む
142
142
  - 着手する前に、\`--brief --json\` の \`work\`(作業先のリポジトリとブランチ)を見て、そのリポジトリでブランチに入る(作業先なしなら移動しない)
143
143
  - 着手するときは \`p3 move T003 doing\`。テストを通したら、コミットする前に \`p3 move T003 done --output <今ある成果物(変えたファイルや説明)> --record -\` で完了にする(変更の記録は必須: 何を変えたか・なぜ・入れた決まり・やめたもの を標準入力から Markdown で。まだ無い URL は書かない)
144
+ - 受け入れ基準(\`--brief --json\` の \`item.acceptanceCriteria\`)があれば着手する前に読み、完了するときに基準ごとの証拠を \`--evidence-file evidence.md\`(見出し \`## A1 met\` ごとに通したテスト・コマンドと結果・確かめたこと)で残す。\`[Q1]\` で始まる基準はプロジェクトの品質基準で、その検査は自分で実行してコマンド・参照先とコミット(未コミットならそう書く)・結果・範囲を証拠に書く(P3 が実行したとは書かない)。満たせなかった・確かめていない項目は \`unmet\` / \`unverified\` と理由を正直に書き(推測で \`met\` にしない)、未達・未検証を残して完了にしたら人に伝える。証拠は自分の申告で、済みにするかは人が決める。基準を自分で消す・書き換えて満たしたことにしない
144
145
  - 要望のタスクを全部終えたら、コミットする前に \`p3 request set <要望ID> status=resolved\`(対応済)にする。完了済(done)・見送り(rejected)とタスクの済み(check)は人が決める
145
146
  - 子の要望(\`parent\` のある要望)は、親とは別の要望として子ごとのタスクとブランチで作業する(親のタスクにしない)。分割の案の採用(\`accept\`)は人が行う。子の Preflight は親と同じ担当で、頼まれたときだけ(分割の採用・子の作成から自分で評価へ進まない)。親を対応済にするのは、親のタスクと見送り以外の子(\`request show <親> --brief --json\` の \`children\`)が全部終わってから
146
147
  - データのフォルダがこの作業ツリーの中で git 管理されているなら、要望のフォルダ(\`requests/<要望ID>/\`)の変更も実装と同じコミットに入れる(後のレビューで要望とやったことを精査するため。子なら祖先の要望のフォルダ、親を対応済にするときは子孫の要望のフォルダ(見送りの子など)のまだ入っていない変更も入れ、ほかの要望・関係ない変更は入れない。外・無視・worktree のときは入らないので、移動や \`git add -f\` はしない)。push に失敗したら完了の記録は残し、公開できていないことを伝える。要望のフォルダは、マージするまで要望のブランチにしか無い。既定のブランチに切り替えると、その要望(子なら親の子の一覧からも)が消えたように見えるが、データはブランチにある(作り直したり、別のブランチから写したりしない)
147
148
  - コミットや PR の URL は後から \`p3 move T003 done --output <URL>\` で足す(完了・記録はそのまま。データをコミットしているなら追記もコミットして push)。複数のリポジトリにまたがるときは最後のタスクに \`--repo-output <参照先>=<PR の URL>\` で全部の PR を残す
149
+ - タスクの AI レビュー(\`p3 review\`)は頼まれずに始めない(Codex を使う)。結果を理由に済みにしたり基準・証拠を書き換えたりしない
148
150
  - 置き換えられたタスク(\`p3 ls\` の \`※置換\`、\`--json\` の \`superseded\`)からは始めない。\`move\` が \`warnings\` を返したら止めて人に確かめる
151
+ - 人の判断・権限が要る・前提が崩れた・テストが通らず先に進めないなどでタスクを続けられなくなったら、\`p3 block T003 --reason "<具体的な理由>" --decision "<人に決めてほしいこと>" --json\` で止まっている理由を付け(通常の修正・調査の途中では使わない)、JSON の \`block\` で保存できたことを確かめてから、理由・いつから・答えてほしいこと・再開のしかたを人に伝えて作業を終える(止まったまま完了・済み・対応済に進めない。基準や証拠を書き換えない)。回答を受けたら \`p3 unblock T003 --resolution "<回答>"\` で解除して再開する(解除だけでは再開しない。人が先に解除していたら履歴の回答を読んで確かめる)
149
152
  - 作業中に新しく必要になった作業は \`p3 new "<タイトル>" --body "..."\` でタスクにする(人への質問はタスクにしない)
150
153
  `;
151
154
  }