@infodb/p3 0.10.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.
- package/README.md +6 -1
- package/dist/web/assets/ImprovementDialog-kQaVBGWH.js +1 -0
- package/dist/web/assets/Outputs-_nU_p3nu.js +1 -0
- package/dist/web/assets/{RequestStatus-DGaoQoIa.js → RequestStatus-RG-OVQYY.js} +1 -1
- package/dist/web/assets/{Tabs-D16MqQxu.js → Tabs-ew9i5SKX.js} +1 -1
- package/dist/web/assets/TagInput-BtlJTF7i.js +1 -0
- package/dist/web/assets/TaskDrawer-DW8GyJqI.js +6 -0
- package/dist/web/assets/_requestId-6Nb727dD.js +1 -0
- package/dist/web/assets/_requestId-BykTgPax.js +1 -0
- package/dist/web/assets/appCtx-CxDdXABS.js +1 -0
- package/dist/web/assets/archive-Ckh295Xe.js +1 -0
- package/dist/web/assets/board-BVAIjK-Y.js +1 -0
- package/dist/web/assets/done-BGfA-3MA.js +1 -0
- package/dist/web/assets/index-CgRU744I.css +2 -0
- package/dist/web/assets/index-DacQ0yl4.js +12 -0
- package/dist/web/assets/{new-ChFzBoL2.js → new-DVygWvVc.js} +1 -1
- package/dist/web/assets/outputs-B6xDsLZf.js +1 -0
- package/dist/web/assets/preload-helper-DyCqp21K.js +1 -0
- package/dist/web/assets/quality-Pu6EISAM.js +1 -0
- package/dist/web/assets/release-notes-CCpzyiNf.js +5 -0
- package/dist/web/assets/requestData-D5vBnuMh.js +1 -0
- package/dist/web/assets/routes-Q91zvNc0.js +4 -0
- package/dist/web/assets/settings-BzRgcmUm.js +1 -0
- package/dist/web/assets/taskReview-_WCgnQit.js +1 -0
- package/dist/web/assets/workTarget-C9c57JAO.js +30 -0
- package/dist/web/index.html +4 -4
- package/docs/architecture.md +392 -3
- package/docs/development.md +1 -1
- package/docs/how-to-use.md +261 -5
- package/docs/installation.md +5 -5
- package/lib/cli/args.js +45 -0
- package/lib/cli/help.js +43 -1
- package/lib/cli/main.js +42 -4
- package/lib/cli/output.js +9 -1
- package/lib/cli/preflightCommands.js +7 -1
- package/lib/cli/project.js +3 -0
- package/lib/cli/qualityCommands.js +163 -0
- package/lib/cli/readOnly.js +2 -0
- package/lib/cli/requestCommands.js +219 -14
- package/lib/cli/showView.js +69 -3
- package/lib/cli/taskCommands.js +312 -17
- package/lib/cli/taskReviewCommands.js +178 -0
- package/lib/core/context.js +7 -1
- package/lib/core/milestoneReview/code.js +129 -0
- package/lib/core/milestoneReview/material.js +148 -0
- package/lib/core/milestoneReview/mockReviewer.js +28 -0
- package/lib/core/milestoneReview/review.js +325 -0
- package/lib/core/milestoneReview/service.js +214 -0
- package/lib/core/milestoneReview/store.js +176 -0
- package/lib/core/ops.js +9 -2
- package/lib/core/preflight/carryover.js +1 -1
- package/lib/core/preflight/codexEngine.js +20 -6
- package/lib/core/preflight/engine.js +6 -0
- package/lib/core/preflight/instructions.js +18 -1
- package/lib/core/preflight/mockEngine.js +4 -0
- package/lib/core/preflight/service.js +45 -4
- package/lib/core/projectRegistry.js +3 -3
- package/lib/core/quality.js +21 -0
- package/lib/core/qualityImprovement.js +221 -0
- package/lib/core/requestOps.js +101 -6
- package/lib/core/reviewRuns.js +205 -0
- package/lib/core/store/archivedTasks.js +74 -0
- package/lib/core/store/collection.js +12 -2
- package/lib/core/store/normalize.js +43 -2
- package/lib/core/store/preflightStore.js +9 -1
- package/lib/core/store/projectFile.js +18 -1
- package/lib/core/store/workspace.js +122 -14
- package/lib/core/taskReview/material.js +452 -0
- package/lib/core/taskReview/mockReviewer.js +30 -0
- package/lib/core/taskReview/paths.js +15 -0
- package/lib/core/taskReview/review.js +305 -0
- package/lib/core/taskReview/service.js +187 -0
- package/lib/core/taskReview/store.js +214 -0
- package/lib/server/api/manifest.js +74 -5
- package/lib/server/api/milestoneReviewRoutes.js +70 -0
- package/lib/server/api/routes.js +164 -20
- package/lib/server/api/taskReviewRoutes.js +66 -0
- package/lib/server/server.js +2 -2
- package/lib/shared/acceptance.js +378 -0
- package/lib/shared/milestoneGoals.js +57 -0
- package/lib/shared/milestoneReview.js +27 -0
- package/lib/shared/quality.js +391 -0
- package/lib/shared/qualityImprovement.js +1 -0
- package/lib/shared/qualityTemplates.js +31 -0
- package/lib/shared/taskBlock.js +142 -0
- package/lib/shared/taskReview.js +56 -0
- package/package.json +1 -1
- package/skills/p3/SKILL.md +31 -2
- package/dist/web/assets/Outputs-B4Tr7JzU.js +0 -1
- package/dist/web/assets/TagInput-pSYxm4bz.js +0 -1
- package/dist/web/assets/TaskDrawer-1Ev3RpRV.js +0 -3
- package/dist/web/assets/_requestId-BKhn019m.js +0 -1
- package/dist/web/assets/_requestId-Btpvuu7-.js +0 -30
- package/dist/web/assets/appCtx-D_Iaoh2e.js +0 -1
- package/dist/web/assets/board-DeHdxbN4.js +0 -1
- package/dist/web/assets/done-BFaHGt03.js +0 -1
- package/dist/web/assets/index-BF1xMdJo.css +0 -2
- package/dist/web/assets/index-CDWcKy1L.js +0 -12
- package/dist/web/assets/preload-helper-hSId95YD.js +0 -1
- package/dist/web/assets/release-notes-BWNDFDkH.js +0 -3
- package/dist/web/assets/requestData-B_320uxL.js +0 -1
- package/dist/web/assets/routes-BBD464IS.js +0 -3
- package/dist/web/assets/settings-D7PPrGjT.js +0 -1
- package/dist/web/assets/workTarget-Cijqq4yH.js +0 -1
package/docs/how-to-use.md
CHANGED
|
@@ -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`)。進捗のスケジュールに ⚑ で出る
|
|
@@ -479,6 +637,20 @@ Preflight は始めたときの内容を固定して評価する。**評価の
|
|
|
479
637
|
project.yaml に無いリリースノートは最後。リリースノートの画面は、指定(`?m=`)が無ければ先頭を開く
|
|
480
638
|
- project.yaml の順は表示のために変えない(足した順のまま)。マイルストーンのタブは開いたときに降順に並べ、編集の間は行を動かさない
|
|
481
639
|
(ID を書き換えても、足した行は最後のまま)。保存すると並べ直す
|
|
640
|
+
- **目的と予定している機能・目標**: マイルストーンごとに、目指すこと(目的。複数行)と予定している機能・目標の一覧を書ける。
|
|
641
|
+
どちらも任意で、片方だけでもよい。リリース済みにした後も、いつでも書き足し・直しができる。マイルストーンのレビューは、
|
|
642
|
+
その時点で保存してある目的・予定機能を所属する要望と比べる(画面で書きかけの内容は使わない)
|
|
643
|
+
|
|
644
|
+
```bash
|
|
645
|
+
p3 milestone purpose v0.2 --file 目的.md # 目的を保存する(--body 本文|- でも。--off で外す)
|
|
646
|
+
p3 milestone goal add v0.2 "通知の再送" # 予定機能を足す(G1, G2, ... の ID が付く)
|
|
647
|
+
p3 milestone goal set v0.2 G1 "通知の再送と失敗の記録"
|
|
648
|
+
p3 milestone goal rm v0.2 G2
|
|
649
|
+
p3 milestone show v0.2 # 目的・予定機能を読む(--json は版 milestonesVersion も)
|
|
650
|
+
```
|
|
651
|
+
|
|
652
|
+
予定機能の ID は足したときに振り、並べ替えや文言の変更で振り直さない(消した番号も、残っている最大の番号より小さければ
|
|
653
|
+
使わない)。目的は 4000 文字、予定機能は 50 件・1件 500 文字まで。空の予定機能・重複した ID は保存を断る
|
|
482
654
|
- **タグ**(`tags`): 外部 ID や分類の自由な文字列(例 `jira:PROJ-123`、`group:顧客A`)。同じ値を複数の要望に付けてグループにできる。
|
|
483
655
|
要望・タスクの参照の代わりにはせず、外部のシステムとは同期しない
|
|
484
656
|
- CLI: `request new --tag 値`(繰り返し可。カンマで分けない)、`request set <要望> --tag 値 ...`(この並びに置き換える)、
|
|
@@ -610,6 +782,46 @@ p3 release-notes export v0.2 > RELEASE.md # 公開する本文だけ(出
|
|
|
610
782
|
壊すと「読めない」と出て、直すまで新しく保存しない。ノートのあるマイルストーンは消せない。保存の形と直し方は
|
|
611
783
|
[docs/architecture.md](architecture.md#リリースノートのデータ)
|
|
612
784
|
|
|
785
|
+
### マイルストーンレビュー
|
|
786
|
+
|
|
787
|
+
マイルストーンの目的・予定している機能([タグ・期限・マイルストーン](#タグ期限マイルストーン))に対して、Preflight と同じく Codex が
|
|
788
|
+
参照先のリポジトリのコードと git の履歴を読み、実際にできあがったものが目的を果たしているか・何が足りないか・目的に無い変更
|
|
789
|
+
(意図しない変更)が入っていないかを確かめる。コードの品質の審査ではなく、機能の意図と目的に照らした確認。任意のときに何度でも
|
|
790
|
+
実行でき、実行しなくても要望の完了やリリースノートの操作には影響しない。結果は参考の記録で、リリースするかは人が読んで決める。
|
|
791
|
+
|
|
792
|
+
```bash
|
|
793
|
+
p3 milestone review v0.2 # 実行して終わるまで待つ(進み具合は stderr。Ctrl-C で取り消す)。--engine mock は評価しない試し用
|
|
794
|
+
p3 milestone reviews v0.2 # 履歴(新しい順。状態・日時・判定の数)
|
|
795
|
+
p3 milestone review-show v0.2 <run> # 1回分(評価したときの目的・材料・全体の所見・予定機能ごとの判定)
|
|
796
|
+
p3 milestone review-cancel v0.2 <run> # 取り消す(ほかのプロセスの実行なら取消を頼む)
|
|
797
|
+
```
|
|
798
|
+
|
|
799
|
+
- **確かめる対象**: 参照先のリポジトリ(`p3 repo path` で登録したこのマシンのパス。Preflight と同じ)を、そのときの作業ツリーのまま
|
|
800
|
+
読むだけで渡す。実行したときの HEAD・ブランチ・未コミットの変更の数と、タスクの成果物に残したコミット(`…/commit/<sha>`)が
|
|
801
|
+
履歴にあるかを記録する。読める参照先が無ければ警告し、記録だけの点検になる(そのときは「達成」と判定しない)
|
|
802
|
+
- **手がかり**: 保存してある目的・予定機能(画面の書きかけは使わない)と、マイルストーンに直接属する要望の全部(見送り・未完了も)の
|
|
803
|
+
本文、各タスクの本文・状態・変更の記録・成果物の参照。タスクの記録は実装した人(AI を含む)の自己申告なので、どこを見るかの
|
|
804
|
+
手がかりにし、書いてあることはコードと履歴で確かめる。別のマイルストーンの親・子は文脈として渡すだけで成果に数えない。
|
|
805
|
+
アーカイブした要望は含めない。成果物の URL や添付の中身は読まない
|
|
806
|
+
- **結果**: 全体の所見と、予定機能ごとの判定(達成・一部達成・未達成・判断材料不足)・理由・根拠・不足していること、目的・予定機能に
|
|
807
|
+
無い変更(意図しない変更の候補)。根拠はコードの場所(`<参照先>:<パス>`・`<参照先>@<コミット>`)と要望・タスクの ID で、
|
|
808
|
+
「達成」にはコードの根拠が要る(記録だけで達成とした結果や、参照先に無いパス・コミットを挙げた結果は使わず、失敗にする)。
|
|
809
|
+
予定機能が無く目的だけなら、目的そのものを判定する。目的も予定機能も無ければ実行できない(先に書く案内が出る)。要望が 0 件でも
|
|
810
|
+
実行でき、材料が無いことを記録する。タスクの完了数で達成を決めず、数値の達成率は出さない
|
|
811
|
+
- **品質**: 品質基準が設定してあれば、目的・予定機能の判定とは別に、品質基準ごとに「満たす・違反・判断できない・対象外(理由つき)」を
|
|
812
|
+
出す(違反は「品質の指摘」)。過去に満たしていたものを崩したと履歴のコミットで裏付けたときだけ「品質の低下」と出す。評価した版と
|
|
813
|
+
今の品質基準の版が違えばそう出る。未設定なら評価せず、設定の「品質基準」へ案内する。品質の材料が無い古い記録は評価していないと出る
|
|
814
|
+
- **確かめないこと**: テストやアプリを実際に動かすこと・公開されたか。結果の「範囲」にも書く
|
|
815
|
+
- **頼む先**: Preflight と同じ Codex の接続(ChatGPT プラン)。参照先は読むだけでマウントし、データのフォルダは渡さない。コードを読むので
|
|
816
|
+
Preflight と同じくらい時間がかかる(上限 20 分)。失敗(認証なし・使用量の上限・時間切れ・形の違う結果)は失敗として記録し、
|
|
817
|
+
前の成功結果はそのまま読める
|
|
818
|
+
- **同時に**: 同じマイルストーンで実行できるのは1つだけ(別の serve・CLI からも)。別のマイルストーンは同時に実行できる
|
|
819
|
+
- **止まった実行**: 実行していたプロセスが落ちたと確かめられれば自動で失敗にする。別のマシン・コンテナで始めたなどで確かめられない
|
|
820
|
+
ときは実行中のまま残るので、止まっていると確かめてから `p3 milestone review-cancel <id> <run> --acknowledge-stopped`(画面では
|
|
821
|
+
「止まっていることを確かめて中断」)で中断にする(記録を終えるだけで、ほかの環境のプロセスを止めたとは限らない)
|
|
822
|
+
- **履歴**: `<データのフォルダ>/milestone-reviews/<マイルストーン>/<run>/` に、比べた材料と結果をそのまま残す。後で目的や要望を
|
|
823
|
+
直しても過去の記録は変わらない。履歴のあるマイルストーンは消せず、ID も変えられない
|
|
824
|
+
|
|
613
825
|
### 添付と画面資料
|
|
614
826
|
|
|
615
827
|
**添付**: 要望に PNG / JPEG / xlsx を付けて Preflight に渡す(今の画面のスクリーンショット・仕様書の Excel)。P3 は対象のアプリを
|
|
@@ -678,13 +890,20 @@ p3 render 画面.html --width 1280 # 画面.png ができる(幅 32
|
|
|
678
890
|
| `/requests/<要望>` | 要望の概要(タイトル・本文・期限・マイルストーン・タグ・親子・添付)と Preflight(`?run=PF-...` で過去の評価)。子の要望は見出しの上に祖先へのリンク |
|
|
679
891
|
| `/requests/<要望>/board` | タスクボード(V 字。ドラッグで列を移動。完了のカードの「✓ 済み」でボードから外す。「+ タスクを追加」で直接作る) |
|
|
680
892
|
| `/requests/<要望>/done` | 対応済み(済みにしたタスクと成果物の一覧。要望の「対応済」とは別) |
|
|
681
|
-
| `/release-notes` |
|
|
893
|
+
| `/release-notes` | マイルストーンの管理(既定)・リリースノート(`?tab=notes&m=<マイルストーン>`)・マイルストーンレビュー(`?tab=review`、記録は `&run=<run>`)。下の「リリースノートの画面」 |
|
|
682
894
|
| `/settings` | 個人(ChatGPT の接続・テーマ)/ プロジェクトの基本 / 参照先(`?tab=personal|project|repos`) |
|
|
683
895
|
|
|
684
896
|
要望の中のページでは `?task=T003` でタスク詳細を重ねて開く。どのタブでも、見出しのタイトルの上に要望 ID と「コピー」が出る
|
|
685
897
|
(本文を下へ送っても見出しは残るので、上まで戻らずにコピーできる)。コピーできない(拒まれた・http で別のマシンから開いて
|
|
686
898
|
Clipboard API が無い)ときはそう出るので、ID をクリックして全体を選び、手でコピーする。
|
|
687
899
|
|
|
900
|
+
**受け入れ基準(画面)**: タスク詳細の「受け入れ基準と作業した側の証拠」に、基準ごとの結果(満たした・満たせなかった・未検証・
|
|
901
|
+
証拠なし・再確認が必要)と証拠が並ぶ。「済みにする」の近くに不足の数が出る(不足があっても済みにできる)。「証拠を登録 / 編集」で
|
|
902
|
+
1項目ずつ残し、「基準を編集 / 足す」で並び全体を直す(どちらも保存・取消)。保存していない入力がある間は済みを変えられない。
|
|
903
|
+
保存は編集を始めたときの rev で送り、他で変わっていれば入力を残して知らせる(「最新に合わせる」で保存し直す)。済みのタスクの
|
|
904
|
+
基準・証拠を変えると済みが外れ、理由が出る。タスク案の詳細(「内容を見る」)でもタスク化の前に基準を直せ、保存していない基準が
|
|
905
|
+
ある間はタスク化できない。「+ タスクを追加」でも基準を入れられる。アーカイブの詳細では読むだけ
|
|
906
|
+
|
|
688
907
|
進捗のスケジュールの記号:
|
|
689
908
|
|
|
690
909
|
| 記号 | 意味 |
|
|
@@ -698,8 +917,8 @@ Clipboard API が無い)ときはそう出るので、ID をクリックして
|
|
|
698
917
|
|
|
699
918
|
印をクリックするとタスクの詳細が開く。ズーム(日 / 週 / 月)と「今日」ボタンで動かす。
|
|
700
919
|
|
|
701
|
-
**リリースノートの画面**(ヘッダーの「リリースノート」):
|
|
702
|
-
(`?tab=
|
|
920
|
+
**リリースノートの画面**(ヘッダーの「リリースノート」): タブで「レビュー」「リリースノート」「マイルストーン」を切り替える
|
|
921
|
+
(`?tab=review` がレビューのタブ、`?tab=notes` がノートのタブ。無い・ほかの値はマイルストーン(管理)のタブ。タブを移っても `?m=` の選択と、書きかけの入力は残る。
|
|
703
922
|
保存していない変更があるタブには ● が付く)。
|
|
704
923
|
|
|
705
924
|
**マイルストーンのタブ**: ID・名前・期限・リリース済み・属する要望の数を一覧で直し、「+ マイルストーンを追加」で足す(0 件から作れる)。
|
|
@@ -709,10 +928,30 @@ Clipboard API が無い)ときはそう出るので、ID をクリックして
|
|
|
709
928
|
ノートの保存や要望の一括完了でもリリース済みは変わらない(どれも別の操作)
|
|
710
929
|
- 要望が使っている・ノートのあるマイルストーンは、ID を変えられず消せない(理由が行に出る。CLI の `milestone rm` と同じ規則で、
|
|
711
930
|
画面が古くても保存のときに止まり、理由が出る)。保存できなかったときは入力が残るので、直して保存し直す
|
|
712
|
-
-
|
|
931
|
+
- レビューの履歴のあるマイルストーンも、ID を変えられず消せない(理由が行に出る)
|
|
932
|
+
- 行の「目的・予定機能」を開くと、目的と予定している機能・目標を直せる(「+ 予定機能を追加」・行ごとの「削除」。保存は
|
|
933
|
+
ほかの項目と同じ「保存」)。閉じた行には目的・予定機能の有無と件数が出る
|
|
934
|
+
- 編集中にほかで変わったら、入力を残して知らせる(「入力を捨てて最新を読み直す」)。そのまま保存すると、編集を始めた後に
|
|
935
|
+
変わったとして断られ(入力は残る)、ほかの変更を上書きしない。保存するのはマイルストーンだけで、
|
|
713
936
|
設定の「プロジェクトの基本」(名前・説明など)とは互いに巻き戻さない
|
|
714
937
|
- project.yaml に無いマイルストーンのノートは、管理のタブでは定義として出さずに知らせる(ノートのタブで読める)
|
|
715
938
|
|
|
939
|
+
**レビューのタブ**: 左でマイルストーンを選ぶ(レビューの履歴だけが残る、project.yaml に無いマイルストーンも出る)。右に:
|
|
940
|
+
|
|
941
|
+
- **評価する内容**: 保存してある目的・予定している機能、所属する要望の件数と状態、別のマイルストーンの親子の数、確かめるコード
|
|
942
|
+
(参照先ごとのブランチと HEAD・未コミットの変更・タスクに残したコミットの数。読めない参照先はその理由)、範囲と警告。
|
|
943
|
+
「目的・予定機能を書く・直す」で「マイルストーン」タブへ移る。そのタブに保存していない変更があれば、レビューは保存した内容で
|
|
944
|
+
行うと知らせる。目的も予定機能も無ければ書き方を案内し、「レビューを実行」は押せない
|
|
945
|
+
- 「レビューを実行」(履歴があれば「もう一度実行」)で始め、実行中は進み具合と「取消」が出る。実行しているプロセスを確かめられない
|
|
946
|
+
実行には「止まっていることを確かめて中断」が出る(記録を終えるだけで、ほかの環境のプロセスを止めるとは限らない)
|
|
947
|
+
- **最新の実行**(実行中・失敗・取消のとき)と **最後の成功結果** を分けて出すので、実行中や失敗の後も前の結果を読める。結果は全体の所見と、
|
|
948
|
+
予定機能ごとの判定(達成・一部達成・未達成・判断材料不足)・理由・根拠(コードの場所とコミット、今の要望・タスクへのリンク)・
|
|
949
|
+
不足していること、目的・予定機能に無い変更(意図しない変更の候補)・範囲。「評価したときの材料」を開くと、そのときの目的・予定機能・
|
|
950
|
+
参照先のコード(HEAD とタスクのコミット1件ずつ)・要望とタスクの文面(本文・変更の記録・成果物)を読める(後で直したり消したりしても残る)。評価した後に目的や要望、参照先の
|
|
951
|
+
HEAD・未コミットの変更が変わっていれば知らせ、「今の内容でもう一度実行」できる
|
|
952
|
+
- **履歴**: 日時・状態・判定の数・評価した目的と予定機能を選んで読める(URL の `?run=` で開ける)。読めない記録も「読めない記録」として出す
|
|
953
|
+
- どの結果でも、要望の完了・リリースノートの保存・リリース済みの操作は今までどおりできる(レビューは参考の記録)
|
|
954
|
+
|
|
716
955
|
**リリースノートのタブ**: 左でマイルストーンを選ぶ(ノートの有無と要望の数)。右に:
|
|
717
956
|
|
|
718
957
|
- **このマイルストーンの要望**: 状態・収録 / 対象外(理由)・変更の記録の数・警告(未完了・記録なし・状態の食い違い)。
|
|
@@ -757,8 +996,10 @@ DB は無く、1タスク = 1 Markdown ファイル。人・AI・Codex が直接
|
|
|
757
996
|
notes/N-....md Preflight へのメモ
|
|
758
997
|
attachments/A-.../ 添付
|
|
759
998
|
preflight/PF-.../ Preflight の記録(評価対象・評価・タスク案・画面資料・ログ)
|
|
999
|
+
task-reviews/T003/TR-.../ タスクの AI レビューの履歴(「タスクの AI レビュー」)
|
|
760
1000
|
.archive/ アーカイブした要望
|
|
761
1001
|
release-notes/v0.2.md リリースノート(マイルストーンごとに1件)
|
|
1002
|
+
milestone-reviews/v0.2/<run>/ マイルストーンレビューの履歴(「マイルストーンレビュー」)
|
|
762
1003
|
```
|
|
763
1004
|
|
|
764
1005
|
タスクファイルの例(`requests/261009-k7m3x/tasks/T003.md`):
|
|
@@ -777,6 +1018,16 @@ checkedAt: 2026-10-10T09:00:00.000Z # 人が確認して「済み」に
|
|
|
777
1018
|
record: | # 変更の記録
|
|
778
1019
|
- 外部の編集をファイル監視で取り込むようにした
|
|
779
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 を使い直さない)
|
|
780
1031
|
relations:
|
|
781
1032
|
- { type: depends_on, target: T002, origin: preflight }
|
|
782
1033
|
rev: 3
|
|
@@ -838,11 +1089,16 @@ AI にも CLI を使わせる(認証を持たせずに済む)。`p3 init --a
|
|
|
838
1089
|
| `p3 init` / `p3 join` / `p3 project` / `p3 whoami` | 新しく作る / 共有されたものに参加する / 個人設定のプロジェクト / 今の判定 |
|
|
839
1090
|
| `p3 config` / `p3 repo` / `p3 user-config` | プロジェクトの設定 / 参照先 / 個人設定(テーマ・マシンごとの設定) |
|
|
840
1091
|
| `p3 progress` | 要望ごとの進捗(マイルストーンごと。`--all` で完了・見送りも) |
|
|
841
|
-
| `p3 milestone ls\|add\|set\|rm` |
|
|
1092
|
+
| `p3 milestone ls\|show\|add\|set\|rm\|purpose\|goal` | マイルストーン(目的・予定している機能も) |
|
|
1093
|
+
| `p3 milestone review\|reviews\|review-show\|review-cancel` | マイルストーンレビュー |
|
|
842
1094
|
| `p3 release-notes ls\|show\|generate\|save\|export` | マイルストーンのリリースノート(要約の生成・保存・本文の出力) |
|
|
843
1095
|
| `p3 request new\|ls\|show\|set\|archive` | 要望 |
|
|
844
1096
|
| `p3 ls` / `p3 show` / `p3 find` | タスクの一覧(`--all` で全要望)/ 詳細(`--brief`)/ 参照・タイトルで探す |
|
|
845
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>` | 受け入れ基準を見る・足す・直す・消す・並べ替える / 基準ごとの証拠を残す・消す([受け入れ基準と証拠](#受け入れ基準と証拠)) |
|
|
846
1102
|
| `p3 preflight` / `p3 notes` / `p3 drafts` / `p3 accept` | Preflight の実行(`--note`。手元のエージェントなら `--prepare` / `--complete`。中断は `--cancel --run`)/ メモ / 評価とタスク案 / タスク化 |
|
|
847
1103
|
| `p3 attach` / `p3 render` | 添付 / 画面イメージの描画 |
|
|
848
1104
|
| `p3 chatgpt` / `p3 codex update` / `p3 serve` | ChatGPT の接続 / Codex のイメージ / 画面(`--all-projects` で登録したプロジェクトを跨ぐ) |
|
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.12.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.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.
|
|
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.
|
|
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.
|
|
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,8 +27,23 @@ 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
|
|
40
|
+
milestone show <id> 目的・予定している機能と版(--json の milestonesVersion)
|
|
41
|
+
milestone purpose <id> 目的を保存する --body 本文|- / --file 目的.md / --off(外す)
|
|
42
|
+
milestone goal add <id> <文> 予定機能を足す(ID は G1, G2, ... を振り、振り直さない)。goal set <id> <G番号> <文> / goal rm <id> <G番号>
|
|
43
|
+
マイルストーンの変更はどれも --version <版> を付けると、その版から変わっていれば競合(終了コード 3)
|
|
44
|
+
milestone review <id> 目的・予定機能に対して参照先のコードと履歴を確かめるレビューを Codex で実行して待つ(記録する。--engine codex|mock。Ctrl-C で取消)
|
|
45
|
+
milestone reviews <id> レビューの履歴 / review-show <id> <run> 1回分 / review-cancel <id> <run> 取消
|
|
46
|
+
(所有者を確かめられない run は --acknowledge-stopped で中断。無い → 2、実行中・終わっている → 3)
|
|
32
47
|
release-notes [ls] マイルストーンごとのリリースノートの有無と要望の数
|
|
33
48
|
release-notes show <id> 保存したノート(本文・版)と、対象の要望(収録 / 対象外)・警告(未完了・記録なし など)
|
|
34
49
|
release-notes generate <id> 変更の記録から機能の要約を Codex で生成し、本文の案を stdout に出す(保存しない。進み具合と出典は stderr。
|
|
@@ -70,17 +85,44 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
|
|
|
70
85
|
|
|
71
86
|
タスク(今の要望の中。--req <要望> で指定、要望の作業ツリーの中なら省略可)
|
|
72
87
|
ls 一覧 --status s1,s2 --area パス -q 語句 --repo <参照先>|none(作業先) --all(全要望)
|
|
88
|
+
--blocked 止まっているタスクだけ(ほかの条件と AND。--archived とは一緒に使えない)
|
|
73
89
|
show <T003|要望|語句> 詳細と関係(依存・置き換え)
|
|
74
90
|
--brief 作業に要る項目だけ(本文・状態・依存とその状態・置き換えの注意・成果物・rev)
|
|
75
91
|
new <タイトル> --body 本文|- --area a --label l --status --output 成果物(繰り返し可)
|
|
76
92
|
--repo <参照先>|none 作業先(作業先にできる参照先だけ。足りないブランチは割り当てる)
|
|
93
|
+
--criterion 文 受け入れ基準(繰り返し可。ID は A1, A2, ... を振る)
|
|
77
94
|
set <T003> キー=値 ... title status labels areas outputs repo(空で消す。outputs= はカンマ区切りで置き換える。repo=none は作業先なし)
|
|
78
95
|
--repo-output <参照先>=<成果物> リポジトリごとの成果物を足す(repoOutputs= で全部外す)
|
|
96
|
+
--criterion 文 受け入れ基準を足す / --evidence・--evidence-file 証拠を残す(move と同じ)
|
|
79
97
|
move <T003> <ステータス> --output URL・文章・パス(成果物を足す。繰り返し可。カンマで分けない)
|
|
80
98
|
--repo-output <参照先>=<URL> リポジトリごとの成果物(最後のタスクに全リポジトリの PR を残す)
|
|
81
99
|
--record 本文|- 変更の記録(何を変えたか・なぜ・入れた決まり・やめたもの。AI が完了にするときは必須。set でも直せる)
|
|
100
|
+
--evidence <ID>=met|unmet|unverified[:本文] 受け入れ基準ごとの証拠(繰り返し可。met は本文が要る)
|
|
101
|
+
--evidence-file 証拠.md|- 見出し「## A1 met」ごとの証拠をまとめて(- は --record - と一緒に使えない)
|
|
102
|
+
不足(証拠なし・未達・未検証・基準を変えた後)があっても完了は拒まず、stderr に出す
|
|
82
103
|
check <T003> [--off] 完了したタスクを人が確認して「済み」にする(--off で外す)
|
|
83
|
-
|
|
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 / 進捗には出ない
|
|
84
126
|
find <語句> 参照・タイトルで探す
|
|
85
127
|
|
|
86
128
|
Preflight
|