@infodb/p3 0.12.0 → 0.13.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 (113) hide show
  1. package/README.md +32 -35
  2. package/dist/web/assets/CompletionReview-gZKZrDu_.js +1 -0
  3. package/dist/web/assets/ImprovementDialog-Dno6dPnG.js +1 -0
  4. package/dist/web/assets/Outputs-BgHalMGb.js +1 -0
  5. package/dist/web/assets/RequestStatus-hZcBUUIu.js +1 -0
  6. package/dist/web/assets/Tabs-C3NmwCc3.js +1 -0
  7. package/dist/web/assets/TagInput-B2b862qn.js +1 -0
  8. package/dist/web/assets/TaskDrawer-4BQBELXa.js +6 -0
  9. package/dist/web/assets/_requestId-BMAG1t3o.js +1 -0
  10. package/dist/web/assets/_requestId-tbg2pA2S.js +1 -0
  11. package/dist/web/assets/archive-DMl6WyOe.js +1 -0
  12. package/dist/web/assets/board-BMTcHKyt.js +1 -0
  13. package/dist/web/assets/done-CL6Nlsua.js +1 -0
  14. package/dist/web/assets/draft-BvGxfD7v.js +2 -0
  15. package/dist/web/assets/index-Dp7Fc4VI.css +2 -0
  16. package/dist/web/assets/index-KdlgMitg.js +12 -0
  17. package/dist/web/assets/metrics-Cu7gJ7Rk.js +1 -0
  18. package/dist/web/assets/new-DTXWHuFO.js +1 -0
  19. package/dist/web/assets/outputs-CXqnjSqV.js +1 -0
  20. package/dist/web/assets/preflightInput-ClKwkp8R.js +2 -0
  21. package/dist/web/assets/preload-helper-oLCrNCwz.js +1 -0
  22. package/dist/web/assets/{quality-Pu6EISAM.js → quality-RFd-7k3r.js} +1 -1
  23. package/dist/web/assets/release-notes-Bpdi6RdY.js +5 -0
  24. package/dist/web/assets/requestData-CbFxwW5w.js +1 -0
  25. package/dist/web/assets/routes-BIt8bExF.js +6 -0
  26. package/dist/web/assets/settings-CsCqF_1B.js +1 -0
  27. package/dist/web/assets/ui-BGK72r3u.js +1 -0
  28. package/dist/web/assets/workTarget-CySfKyfB.js +30 -0
  29. package/dist/web/index.html +4 -4
  30. package/docs/architecture.md +300 -36
  31. package/docs/development.md +60 -16
  32. package/docs/how-to-use.md +381 -28
  33. package/docs/installation.md +235 -144
  34. package/docs/publishing.md +1 -1
  35. package/lib/cli/agentsStatus.js +197 -0
  36. package/lib/cli/args.js +72 -8
  37. package/lib/cli/guide.js +27 -0
  38. package/lib/cli/guide.md +214 -0
  39. package/lib/cli/help.js +44 -6
  40. package/lib/cli/main.js +76 -20
  41. package/lib/cli/metricsCommands.js +77 -0
  42. package/lib/cli/output.js +12 -2
  43. package/lib/cli/project.js +13 -27
  44. package/lib/cli/qualityCommands.js +33 -8
  45. package/lib/cli/readOnly.js +15 -0
  46. package/lib/cli/requestCommands.js +21 -4
  47. package/lib/cli/requirementCommands.js +288 -0
  48. package/lib/cli/retroCommands.js +106 -0
  49. package/lib/cli/revisitCommands.js +73 -0
  50. package/lib/cli/showView.js +119 -6
  51. package/lib/cli/taskCommands.js +42 -16
  52. package/lib/cli/userConfig.js +47 -0
  53. package/lib/core/completionRefs.js +46 -0
  54. package/lib/core/metrics/definitions.js +434 -0
  55. package/lib/core/metrics/index.js +88 -0
  56. package/lib/core/metrics/manual.js +180 -0
  57. package/lib/core/ops.js +15 -2
  58. package/lib/core/preflight/carryover.js +5 -1
  59. package/lib/core/preflight/codexEngine.js +34 -17
  60. package/lib/core/preflight/diagnose.js +4 -9
  61. package/lib/core/preflight/engine.js +9 -0
  62. package/lib/core/preflight/hostPaths.js +260 -0
  63. package/lib/core/preflight/input.js +33 -5
  64. package/lib/core/preflight/instructions.js +18 -1
  65. package/lib/core/preflight/mockEngine.js +20 -2
  66. package/lib/core/preflight/render.js +22 -3
  67. package/lib/core/preflight/service.js +59 -9
  68. package/lib/core/preflight/uiRender.js +3 -0
  69. package/lib/core/requestOps.js +206 -14
  70. package/lib/core/retrospective.js +208 -0
  71. package/lib/core/reviewCandidates.js +56 -0
  72. package/lib/core/store/collection.js +20 -1
  73. package/lib/core/store/normalize.js +22 -4
  74. package/lib/core/store/preflightStore.js +19 -5
  75. package/lib/core/store/workspace.js +17 -1
  76. package/lib/core/taskReview/material.js +7 -0
  77. package/lib/core/taskReview/review.js +9 -2
  78. package/lib/server/api/manifest.js +51 -3
  79. package/lib/server/api/routes.js +131 -11
  80. package/lib/shared/acceptance.js +258 -18
  81. package/lib/shared/completionRecord.js +327 -0
  82. package/lib/shared/metrics.js +42 -0
  83. package/lib/shared/preflightInput.js +1 -1
  84. package/lib/shared/requirementSource.js +635 -0
  85. package/lib/shared/retrospective.js +286 -0
  86. package/lib/shared/reviewCandidate.js +308 -0
  87. package/lib/shared/reworkHistory.js +81 -0
  88. package/package.json +3 -2
  89. package/skills/p3/SKILL.md +9 -181
  90. package/dist/web/assets/ImprovementDialog-kQaVBGWH.js +0 -1
  91. package/dist/web/assets/Outputs-_nU_p3nu.js +0 -1
  92. package/dist/web/assets/RequestStatus-RG-OVQYY.js +0 -1
  93. package/dist/web/assets/Tabs-ew9i5SKX.js +0 -1
  94. package/dist/web/assets/TagInput-BtlJTF7i.js +0 -1
  95. package/dist/web/assets/TaskDrawer-DW8GyJqI.js +0 -6
  96. package/dist/web/assets/_requestId-6Nb727dD.js +0 -1
  97. package/dist/web/assets/_requestId-BykTgPax.js +0 -1
  98. package/dist/web/assets/appCtx-CxDdXABS.js +0 -1
  99. package/dist/web/assets/archive-Ckh295Xe.js +0 -1
  100. package/dist/web/assets/board-BVAIjK-Y.js +0 -1
  101. package/dist/web/assets/done-BGfA-3MA.js +0 -1
  102. package/dist/web/assets/draft-CfJeyLOl.js +0 -1
  103. package/dist/web/assets/index-CgRU744I.css +0 -2
  104. package/dist/web/assets/index-DacQ0yl4.js +0 -12
  105. package/dist/web/assets/new-DVygWvVc.js +0 -1
  106. package/dist/web/assets/outputs-B6xDsLZf.js +0 -1
  107. package/dist/web/assets/preflightInput-BAeEJYUK.js +0 -2
  108. package/dist/web/assets/preload-helper-DyCqp21K.js +0 -1
  109. package/dist/web/assets/release-notes-CCpzyiNf.js +0 -5
  110. package/dist/web/assets/requestData-D5vBnuMh.js +0 -1
  111. package/dist/web/assets/routes-Q91zvNc0.js +0 -4
  112. package/dist/web/assets/settings-BzRgcmUm.js +0 -1
  113. package/dist/web/assets/workTarget-C9c57JAO.js +0 -30
package/lib/cli/help.js CHANGED
@@ -13,6 +13,8 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
13
13
  --agents claude|codex|both AI 向けの使い方(スキルと AGENTS.md / CLAUDE.md の節)を置く先(値を省くと both。付けなければ置かない)
14
14
  agents claude|codex|both [--force] AI 向けの使い方を、今いるリポジトリに後から置く・最新にする(選んだ先だけ。データ・個人設定は変えない)
15
15
  違うものは上書きせず知らせる。--force で選んだ先のスキルと p3 の節だけを同梱の版にする(ほかの文は残す)
16
+ guide AI エージェント向けの作業の手順(この CLI に同梱した版)を出す。プロジェクトを決めず、何も変えない
17
+ --json で schemaVersion・cliVersion(実行中の版)・entryVersion(入口の決まりの版)・guide(手順の全文)
16
18
  join 既にあるプロジェクト(共有されたデータのフォルダ)に参加する。個人設定に登録するだけで、データ・リポジトリのファイルは変えない
17
19
  --project 名前 --dir フォルダ(既定はリポジトリのルートの .p3)--repo-name 参照先の名前(共有の定義にあるもの)--yes
18
20
  project [ls | add <名前> <フォルダ> | rm <名前>] 個人設定のプロジェクト
@@ -27,11 +29,15 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
27
29
  codex.effort / codex.ensureImage / preflight.engine / serve.host / serve.port(キー= で消す)
28
30
  set codex.pathMap+=<このマシンのパス>=<Docker デーモンから見たパス> パスの対応を足す
29
31
  set codex.pathMap-=<このマシンのパス> 外す(codex.pathMap= で全部外す)
32
+ paths <このマシンのパス> ... Docker にマウントするときのホストのパスと決め方(DevContainer では自動。変えない)
30
33
  quality 品質基準(project.yaml の quality。未設定・設定済み・読めない)とテンプレートの改版の差分
31
34
  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
+ 未設定のままでも作業は続けられる(init は必須ではない)。未設定から add / adopt をそのまま使える
36
+ init 意図して空にする(設定済みなら何も変えない)/ adopt <テンプレート> 写して採用する / upgrade <テンプレート> 改版の差分を当てる
37
+ add --text 文 [--repo 名前 ...] (--command コマンド --success 成功の条件 | --reference 確かめ方)
38
+ set <Q1> [--text] [--repo 名前 ...|all] [...] / rm <Q1> / exempt <Q1> --reason 理由 / unexempt <Q1>
39
+ --repo は繰り返して複数の参照先(例: --repo app --repo infra)。add で省くと全参照先、set で省くと対象を変えない。
40
+ all は全参照先で、個別の名前とは一緒に使えない。--repo を繰り返せるのは quality add / set だけ
35
41
  --version <版> で、他で変わっていれば競合(終了コード 3)。P3 はコマンドを実行しない
36
42
  improve [task <要望>/<T> <run> | milestone <ID> <run>] 品質の不足の診断と改善要望の原稿(読むだけ)
37
43
  --key <不足の鍵>... で選ぶ / --register --hash <診断の版> [--title] [--body] [--reopen] で明示して登録する
@@ -56,6 +62,13 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
56
62
  できるか・対象・hash は show で見る。材料が変わっていれば何も変えずに終了コード 3、途中で止まったら非ゼロ
57
63
  例: p3 release-notes generate v0.2 > draft.md → 直す → p3 release-notes save v0.2 --file draft.md
58
64
  p3 release-notes export v0.2 > RELEASE.md
65
+ metrics [--milestone <ID>] 開発の指標(要望の作成から対応済・完了済までの時間、受け入れ基準の未達・未検証・証拠なし・再確認、
66
+ 手戻り、AI レビューの未達判定・意図しない変更の候補)。
67
+ 値・単位・対象・欠損・算出の方法を出す(読むだけ。記録の欠けは 0 にせず欠損と出す。成績の評価には使わない)
68
+ metrics record <指標> <値> 人が記録する値: cost(--unit JPY など通貨ごと)/ post_release_defects(0 以上の整数)
69
+ --from YYYY-MM-DD --to YYYY-MM-DD --source 出典 [--milestone ID(省くと全体)] [--note メモ]
70
+ 同じ指標・範囲・期間・単位の再送は何もしない。値を変える訂正は --rev 版(無い・違えば競合で終了コード 3)
71
+ metrics records / rm <M1> 人の記録の全部 / 消す(--rev 版)
59
72
  whoami 操作するプロジェクト・変更者・今の要望
60
73
  serve [--port] [--host] ブラウザ用のビューアを起動(既定は個人設定の serve.port / serve.host か $P3_PORT / $P3_HOST)
61
74
  --all-projects 個人設定に登録したプロジェクトを跨いで扱う(画面で選ぶ。--project / --dir とは一緒に使えない)
@@ -86,6 +99,7 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
86
99
  タスク(今の要望の中。--req <要望> で指定、要望の作業ツリーの中なら省略可)
87
100
  ls 一覧 --status s1,s2 --area パス -q 語句 --repo <参照先>|none(作業先) --all(全要望)
88
101
  --blocked 止まっているタスクだけ(ほかの条件と AND。--archived とは一緒に使えない)
102
+ --review 見直しが必要(候補)の完了したタスクだけ(ほかの条件と AND)
89
103
  show <T003|要望|語句> 詳細と関係(依存・置き換え)
90
104
  --brief 作業に要る項目だけ(本文・状態・依存とその状態・置き換えの注意・成果物・rev)
91
105
  new <タイトル> --body 本文|- --area a --label l --status --output 成果物(繰り返し可)
@@ -93,13 +107,15 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
93
107
  --criterion 文 受け入れ基準(繰り返し可。ID は A1, A2, ... を振る)
94
108
  set <T003> キー=値 ... title status labels areas outputs repo(空で消す。outputs= はカンマ区切りで置き換える。repo=none は作業先なし)
95
109
  --repo-output <参照先>=<成果物> リポジトリごとの成果物を足す(repoOutputs= で全部外す)
96
- --criterion 文 受け入れ基準を足す / --evidence・--evidence-file 証拠を残す(move と同じ)
110
+ --criterion 文 受け入れ基準を足す / --evidence・--evidence-file・--evidence-json 証拠を残す(move と同じ)
97
111
  move <T003> <ステータス> --output URL・文章・パス(成果物を足す。繰り返し可。カンマで分けない)
98
112
  --repo-output <参照先>=<URL> リポジトリごとの成果物(最後のタスクに全リポジトリの PR を残す)
99
113
  --record 本文|- 変更の記録(何を変えたか・なぜ・入れた決まり・やめたもの。AI が完了にするときは必須。set でも直せる)
100
114
  --evidence <ID>=met|unmet|unverified[:本文] 受け入れ基準ごとの証拠(繰り返し可。met は本文が要る)
101
115
  --evidence-file 証拠.md|- 見出し「## A1 met」ごとの証拠をまとめて(- は --record - と一緒に使えない)
102
- 不足(証拠なし・未達・未検証・基準を変えた後)があっても完了は拒まず、stderr に出す
116
+ --evidence-json 証拠.json|- 根拠つきでまとめて [{"id":"A1","result":"met","evidence":"…","basis":{"kind":"machine",…}}]
117
+ (--evidence と --evidence-file は根拠を書けない: 前の同じ結果の根拠を引き継ぎ、無ければ申告のみ・unverified は未確認)
118
+ 不足(証拠なし・未達・未検証・基準を変えた後・申告のみの met)があっても完了は拒まず、stderr に出す
103
119
  check <T003> [--off] 完了したタスクを人が確認して「済み」にする(--off で外す)
104
120
  block <T003> --reason 理由|- [--decision 決めてほしいこと|-]
105
121
  作業中のタスクに止まっている理由を付ける・内容を直す(状態は作業中のまま。止まった時刻は直しても変えない)
@@ -111,7 +127,10 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
111
127
  add <文>... 足す / edit <ID> <文> 文を変える(記録済みの証拠は再確認が必要になる)
112
128
  rm <ID>... 消す(証拠は残る。ID は使い直さない) / order <ID>... 並べ替える(今の ID を全部)
113
129
  evidence <T003> <ID> <結果> 証拠を残す(再記録は置き換え)。本文は続けて書くか --body 本文|- / --file 本文.md
114
- evidence <T003> --file 証拠.md|- まとめて / evidence <T003> rm <ID>... 消す
130
+ --basis unverified|declaration|read|machine 根拠の種類(作業した側の申告。P3 は検査を実行しない)
131
+ read: --reference 読んだもの / machine: --command コマンド --check-result 結果 --target <参照先>:<コミット>
132
+ evidence <T003> --file 証拠.md|- まとめて / --evidence-json 証拠.json|- 根拠つきでまとめて
133
+ evidence <T003> rm <ID>... 消す
115
134
  済みのタスクの基準・証拠の中身を変えると済みが外れる(同じ値の再保存・成果物の追加では外れない)
116
135
  review <T003> 完了したタスクの AI レビュー(別の Codex のスレッドが、固定した差分と前後のコードを読むだけで基準と比べる。
117
136
  終わるまで待つ。Ctrl-C で取り消す。結果はタスクの状態・済み・基準・証拠を変えない)
@@ -124,7 +143,22 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
124
143
  ls --archived アーカイブしたタスクの一覧(今の要望。読むだけ。壊れたファイルは「読めない」に出す)
125
144
  show <T003> --archived アーカイブしたタスクの詳細(本文・変更の記録・成果物)。通常の ls / show / 進捗には出ない
126
145
  find <語句> 参照・タイトルで探す
146
+ source [<要望>] 要求の出典と確認(任意): 根拠の記録と状態(未記録・未確認・確認記録あり・再確認が必要・対応先不明)・回答
147
+ add --target 対象の要求・前提 --source 出典(役割・資料名・版・節)--grounds 根拠|-(承認された計算例など)
148
+ edit <S1> [同じ項目] / confirm <S1> --by 確かめた役割・アクター --on YYYY-MM-DD / rm <S1>
149
+ (確認には出典・根拠・人・日が要る。題・本文・記録を変えると再確認が必要。記録は申告で P3 の保証ではない)
150
+ source <T003|D1> [<A1> 操作] 受け入れ基準ごとの記録(D1 はタスク案。--run PF-...)。add --from S1 で要望の記録を写す(確認は引き継がない)
151
+ --sources-json 操作.json|- まとめて([{"criterion":"A1","op":"add","source":"…","basis":"…"}])
127
152
 
153
+ retro [<要望>] 振り返り: 対象(確定した採用済みの Preflight とリスクの原文)と候補(採用を終えた run と作ったタスク・子の根拠)
154
+ confirm <run> [--reason 訂正の理由] 対象を確定する(最新の実行・採用では変わらない。訂正は理由が要る。--rev で版)
155
+ judge <番号> --state occurred|not_occurred|unchecked リスクの確認(人の判断)。起きた → --facts 事実、
156
+ 起きなかった → --scope 確認した範囲、どちらも根拠が要る。判断を変える・戻すには --reason
157
+ --evidence review:T001:<run>:<項目>[:<位置>] | milestone:<ID>:<run>:<項目>[:<位置>][:<理由>] | rework:T001:R1 | manual:<参照>
158
+ revisit [<要望>] [--all] 見直しが必要(候補): 完了の記録(完了・済みにしたときの条件)と今の条件の差(品質基準・受け入れ基準・
159
+ 要求の根拠・前提の変更)。完了済みも含む。候補を出すだけで状態・済みは変えない。確かめたら済みにし直す
160
+ premise [<要望>] 前提の変更の一覧 / add --target <要望 ID|T001|S1>(繰り返し可)--reason 理由 --condition 新しい条件・版
161
+ ack <P1> --target <ID> --condition 確かめた条件 変更を確かめたことを残す(過去の記録・状態は変えない)
128
162
  Preflight
129
163
  preflight [<要望>] 評価・細分化を実行し、完了まで待つ --engine codex|mock
130
164
  前回の結果とまだ渡していないメモを引き継ぐ
@@ -136,6 +170,10 @@ Preflight
136
170
  Codex / Mock の run は、動いているプロセスに中断を頼み、止まるまで少し待つ。止まらなければ requested)
137
171
  --acknowledge-stopped 動いているか確かめられない run(以前の版・別の環境)を、止まっていることを確かめて中断にする
138
172
  (記録だけ。プロセスやコンテナは止めない)
173
+ clarify [<要望>] 確認事項(ID・確認先・質問・必要な根拠・判断への影響)と回答の状態 --run PF-...
174
+ answer [<要望>] <Q1> 確認事項に回答する(要望に残す。過去の run は書き換えない。再評価は preflight で明示して始める)
175
+ --body 回答|- --by 回答した役割 --on YYYY-MM-DD --source 出典 --grounds 根拠|- --link S1(対応する根拠の記録)
176
+ --answer-json 回答.json|- まとめて / answer [<要望>] <Q1> rm 消す
139
177
  notes [<要望>] メモの一覧(次の Preflight に渡すもの・渡し済み)
140
178
  attach [ls] 要望の添付(PNG / JPEG / xlsx)の一覧。要望は --req(要望の作業ツリーの中なら省略可)
141
179
  attach add <ファイル> 添付を足す --description 説明 --source 出典。次の Preflight を始めるときに run に固定して渡す
package/lib/cli/main.js CHANGED
@@ -5,6 +5,22 @@ import { machineSettingsSource, resolveMachineSettings, SettingsError } from "..
5
5
  import { progress, resolveRef, resolveRequestId, titleOf } from "../core/ops.js";
6
6
  import { OpRuleError } from "../core/requestOps.js";
7
7
  import { AcceptanceInputError } from "../shared/acceptance.js";
8
+ import { RequirementInputError } from "../shared/requirementSource.js";
9
+ import { requirementCommand } from "./requirementCommands.js";
10
+ import { revisitCommand } from "./revisitCommands.js";
11
+ import { retroCommand } from "./retroCommands.js";
12
+ import { metricsCommand } from "./metricsCommands.js";
13
+ import { MetricsError } from "../shared/metrics.js";
14
+ import { RetrospectiveError } from "../shared/retrospective.js";
15
+ /** 進捗の行の見直し候補の印(要望自身・自分のタスク・配下を分ける。無ければ空) */
16
+ function reviewMark(p) {
17
+ const r = p.review;
18
+ if (!r)
19
+ return "";
20
+ const parts = [r.self?.state === "candidate" ? "要望" : "", r.tasks ? `タスク ${r.tasks}` : "", r.below ? `配下 ${r.below}` : ""].filter(Boolean);
21
+ return parts.length ? ` ※見直し候補(${parts.join("・")})` : "";
22
+ }
23
+ import { PremiseInputError } from "../shared/reviewCandidate.js";
8
24
  import { BlockInputError } from "../shared/taskBlock.js";
9
25
  import { taskReviewCommand } from "./taskReviewCommands.js";
10
26
  import { qualityCommand } from "./qualityCommands.js";
@@ -25,8 +41,10 @@ import { chatgptCommand } from "./chatgpt.js";
25
41
  import { table } from "./format.js";
26
42
  import { config, currentRequest, init, isAgentChoice, joinProject, locateHere, placeAgents, projectCommand, repoCommand, repoRoot, resolveActor, runnerText, UsageError } from "./project.js";
27
43
  import { HELP } from "./help.js";
44
+ import { guide } from "./guide.js";
45
+ import { agentsText, diagnoseAgents } from "./agentsStatus.js";
28
46
  import { readsOnly } from "./readOnly.js";
29
- import { parse } from "./args.js";
47
+ import { checkRepeatedRepo, parse } from "./args.js";
30
48
  import { Output, bar } from "./output.js";
31
49
  import { requestCommand, milestoneCommand } from "./requestCommands.js";
32
50
  import { taskCommand } from "./taskCommands.js";
@@ -85,6 +103,7 @@ async function main(argv) {
85
103
  }
86
104
  const cwd = process.cwd();
87
105
  const out = new Output(o.json ?? false);
106
+ checkRepeatedRepo(cmd, o);
88
107
  // --force は p3 agents だけ(ほかのコマンドで黙って無視しない)
89
108
  if (o.force && cmd !== "agents")
90
109
  throw new UsageError("--force は p3 agents でだけ使えます");
@@ -104,6 +123,17 @@ async function main(argv) {
104
123
  const source = machineSettingsSource({ cli: { port: o.port, host: o.host } });
105
124
  return serveUntilSignal(await startServer({ allProjects: true, port: settings.serve.port, host: settings.serve.host, static: true, settings: source }));
106
125
  }
126
+ // AI 向けの作業の手順。この CLI に同梱した原本を返すだけで、プロジェクトは決めない(未登録・壊れた定義でも読める)
127
+ if (cmd === "guide") {
128
+ if (args.length)
129
+ throw new UsageError(`guide は位置引数を取りません: ${args.join(" ")}(p3 guide [--json])`);
130
+ const g = { ...guide(), agents: diagnoseAgents(cwd) };
131
+ // 通常の出力は手順の本文だけ(JSON の guide と同じ)。入口に対応が要るときだけ、その要点を標準エラーに出す
132
+ if (!o.json && !g.agents.ok)
133
+ process.stderr.write(`p3: 置いた AI 向けの入口: ${agentsText(g.agents).join("\n")}\n`);
134
+ out.result(g, () => g.guide.trimEnd());
135
+ return 0;
136
+ }
107
137
  // AI 向けの使い方を置く・最新にする。今いるリポジトリのルートに置くだけで、プロジェクトは決めない(データ・個人設定は変えない)
108
138
  if (cmd === "agents") {
109
139
  const [choice, ...rest] = args;
@@ -232,7 +262,7 @@ async function main(argv) {
232
262
  return { col: ctx.ws.tasksOf(rid), rid, tid };
233
263
  };
234
264
  const env = { ctx, out, args, o, actor, current, expectedRev, requestArg, taskArg, split, cwd, target };
235
- const handled = (await taskCommand(cmd, env)) ?? (await taskReviewCommand(cmd, env)) ?? (await preflightCommand(cmd, env));
265
+ const handled = (await taskCommand(cmd, env)) ?? (await taskReviewCommand(cmd, env)) ?? (await preflightCommand(cmd, env)) ?? (await requirementCommand(cmd, env)) ?? (await revisitCommand(cmd, env)) ?? (await retroCommand(cmd, env)) ?? (await metricsCommand(cmd, env));
236
266
  if (handled !== undefined)
237
267
  return handled;
238
268
  switch (cmd) {
@@ -249,13 +279,16 @@ async function main(argv) {
249
279
  // Preflight の担当(AI 向けの手順が読む。読めなければ runner: null と problem。agent と推測しない)
250
280
  const pf = runnerView(ctx.ws.project.preflight);
251
281
  const preflight = { runner: pf.runner, source: pf.source, ...(pf.problem ? { problem: pf.problem } : {}) };
252
- return out.result({ project: target.name ?? null, dataDir: target.dataDir, via: target.via, here: here.repos, branch: here.branch ?? null, actor, request: current ?? null, preflight }, () => [
282
+ // 置いた AI 向けの入口の状態(読むだけ。古くても操作は断らない)
283
+ const agents = diagnoseAgents(cwd);
284
+ return out.result({ project: target.name ?? null, dataDir: target.dataDir, via: target.via, here: here.repos, branch: here.branch ?? null, actor, request: current ?? null, preflight, agents }, () => [
253
285
  `プロジェクト ${target.name ?? "(未登録)"} ${target.dataDir}`,
254
286
  `決まり方 ${target.via}(${VIA_LABEL[target.via]})`,
255
287
  `今いる参照先 ${here.repos.length ? here.repos.join(", ") : "(どの参照先の中でもない。p3 repo ls)"}${here.branch ? ` ブランチ ${here.branch}` : ""}`,
256
288
  `変更者 ${actor}`,
257
289
  `要望 ${current ? `${current} ${titleOf(ctx, current)}` : "(なし)"}`,
258
290
  `Preflight ${runnerText(pf)}`,
291
+ ...agentsText(agents).map((l, i) => (i ? ` ${l}` : `AI の入口 ${l}`)),
259
292
  ].join("\n"));
260
293
  }
261
294
  case "progress": {
@@ -283,7 +316,7 @@ async function main(argv) {
283
316
  : "",
284
317
  p.request.tags.map((t) => `#${t}`).join(" "),
285
318
  // 子のある要望は配下の集計(自分の値とは別)、子は親を添える
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 ? " ※親子の問題" : ""}`,
319
+ `${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 ? " ※親子の問題" : ""}${reviewMark(p)}`,
287
320
  ]);
288
321
  return `${head}\n${table(rows)}`;
289
322
  })
@@ -306,69 +339,92 @@ async function main(argv) {
306
339
  throw new UsageError(`不明なコマンド: ${cmd}(p3 help)`);
307
340
  }
308
341
  }
309
- main(process.argv.slice(2)).then((code) => process.exit(code), (e) => {
342
+ /**
343
+ * 標準出力・標準エラーを書き終えてから終わる。process.exit はパイプへの書き込みを待たないので、大きな出力(--json)を
344
+ * パイプで渡すと途中で切れることがある
345
+ */
346
+ function exit(code) {
347
+ let pending = 2;
348
+ const done = () => {
349
+ if (--pending === 0)
350
+ process.exit(code);
351
+ };
352
+ process.stdout.write("", done);
353
+ process.stderr.write("", done);
354
+ }
355
+ main(process.argv.slice(2)).then((code) => exit(code), (e) => {
310
356
  if (e instanceof ConflictError) {
311
357
  process.stderr.write(`競合: ${e.message}。最新を取得してやり直してください\n`);
312
- process.exit(3);
358
+ return exit(3);
313
359
  }
314
360
  if (e instanceof UserConfigError) {
315
361
  process.stderr.write(`${e.message}\n`);
316
- process.exit(1);
362
+ return exit(1);
317
363
  }
318
364
  if (e instanceof SettingsError) {
319
365
  process.stderr.write(`設定: ${e.message}\n`);
320
- process.exit(1);
366
+ return exit(1);
321
367
  }
322
368
  if (e instanceof ProjectNotResolvedError || e instanceof DataDirError) {
323
369
  process.stderr.write(`${e.message}\n`);
324
- process.exit(1);
370
+ return exit(1);
325
371
  }
326
372
  // リリースノート: 無い → 2、版の競合・既にある → 3、読めない・ID が使えない → 1
327
373
  if (e instanceof ReleaseNoteError) {
328
374
  process.stderr.write(`${e.code === "conflict" ? "競合: " : ""}${e.message}\n`);
329
- process.exit(e.code === "not_found" ? 2 : e.code === "conflict" || e.code === "exists" ? 3 : 1);
375
+ return exit(e.code === "not_found" ? 2 : e.code === "conflict" || e.code === "exists" ? 3 : 1);
376
+ }
377
+ // 指標: 版の競合 → 3、規則に合わない・読めない → 1(何も書いていない)
378
+ if (e instanceof MetricsError) {
379
+ process.stderr.write(`${e.code === "metrics_conflict" ? "競合: " : ""}${e.message}\n`);
380
+ return exit(e.code === "metrics_conflict" ? 3 : 1);
381
+ }
382
+ // 振り返り: 版の競合 → 3、規則に合わない・読めない → 1(何も書いていない)
383
+ if (e instanceof RetrospectiveError) {
384
+ process.stderr.write(`${e.code === "retro_conflict" ? "競合: " : ""}${e.message}\n`);
385
+ return exit(e.code === "retro_conflict" ? 3 : 1);
330
386
  }
331
387
  // 生成を始められない(材料が無い・上限・実行中)。Codex は呼んでいない
332
388
  if (e instanceof GenerationRejected) {
333
389
  process.stderr.write(`${e.message}\n`);
334
- process.exit(1);
390
+ return exit(1);
335
391
  }
336
392
  // 要望の親子: ロックを取れない・子の表示順を読んだ後に子の集合が変わった → 3(読み直してやり直す)、規則に合わない → 1
337
393
  if (e instanceof HierarchyError) {
338
394
  process.stderr.write(`${e.message}\n`);
339
395
  const changedSet = e.code === "child_order_invalid" && (e.detail.reason === "not_child" || e.detail.reason === "missing");
340
- process.exit(e.code === "hierarchy_busy" || changedSet ? 3 : 1);
396
+ return exit(e.code === "hierarchy_busy" || changedSet ? 3 : 1);
341
397
  }
342
398
  // マイルストーンレビュー: 無い → 2、実行中・終わっている・動いている所有者がいる → 3、ほか(目的が無い・上限・ID・読めない)→ 1
343
399
  if (e instanceof ReviewRejected || e instanceof ReviewStoreError || e instanceof ReviewCancelRefused) {
344
400
  process.stderr.write(`${e.message}\n`);
345
401
  const code = e.code;
346
- process.exit(code === "not_found" || code === "unknown_milestone" ? 2 : code === "running" || code === "finished" || code === "owner_alive" || code === "exists" ? 3 : 1);
402
+ return exit(code === "not_found" || code === "unknown_milestone" ? 2 : code === "running" || code === "finished" || code === "owner_alive" || code === "exists" ? 3 : 1);
347
403
  }
348
404
  // タスクのレビュー: 実行中・材料が変わった → 3、ほか(未完了・比較対象・観点・上限・担当)→ 1
349
405
  if (e instanceof TaskReviewRejected) {
350
406
  process.stderr.write(`${e.message}\n`);
351
- process.exit(e.code === "running" || e.code === "material_changed" ? 3 : 1);
407
+ return exit(e.code === "running" || e.code === "material_changed" ? 3 : 1);
352
408
  }
353
409
  // 改善要望: 診断が変わった・登録先がある → 3、無い → 2、ほか → 1
354
410
  if (e instanceof ImprovementError) {
355
411
  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);
412
+ return exit(e.code === "not_found" ? 2 : e.code === "diagnosis_changed" || e.code === "existing" || e.code === "closed_existing" ? 3 : 1);
357
413
  }
358
414
  // 品質基準: 版が違う → 3、規則に合わない・読めない → 1
359
415
  if (e instanceof QualityInputError) {
360
416
  process.stderr.write(`${e.message}\n`);
361
- process.exit(e.code === "quality_conflict" ? 3 : 1);
417
+ return exit(e.code === "quality_conflict" ? 3 : 1);
362
418
  }
363
419
  // マイルストーンの版が違う(読んだ後に他で変わった)→ 3。何も書いていない
364
420
  if (e instanceof MilestonesConflictError) {
365
421
  process.stderr.write(`競合: ${e.message}\n`);
366
- process.exit(3);
422
+ return exit(3);
367
423
  }
368
424
  if (e instanceof NotFoundError) {
369
425
  process.stderr.write(`見つかりません: ${e.id}\n`);
370
- process.exit(2);
426
+ return exit(2);
371
427
  }
372
- process.stderr.write(`${e instanceof UsageError || e instanceof OpRuleError || e instanceof ProjectInputError || e instanceof AcceptanceInputError || e instanceof BlockInputError ? "" : "エラー: "}${e.message}\n`);
373
- process.exit(1);
428
+ process.stderr.write(`${e instanceof UsageError || e instanceof OpRuleError || e instanceof ProjectInputError || e instanceof AcceptanceInputError || e instanceof RequirementInputError || e instanceof PremiseInputError || e instanceof BlockInputError ? "" : "エラー: "}${e.message}\n`);
429
+ return exit(1);
374
430
  });
@@ -0,0 +1,77 @@
1
+ import { metricScopeOf, metricsReport } from "../core/metrics/index.js";
2
+ import { readManual, recordManual, removeManual } from "../core/metrics/manual.js";
3
+ import { MetricsError, METRIC_STATE_LABEL, METRIC_UNIT_LABEL } from "../shared/metrics.js";
4
+ import { UsageError } from "./project.js";
5
+ /**
6
+ * 開発の指標(定義は core/metrics/definitions.ts)。読むだけ。
7
+ *
8
+ * metrics [--milestone <ID>] プロジェクト全体(既定)か、登録済みのマイルストーンの指標(値・単位・対象・欠損・算出の方法)
9
+ * metrics record <指標> <値> --from YYYY-MM-DD --to YYYY-MM-DD --source 出典 [--unit 通貨] [--milestone ID] [--note メモ] [--rev 版]
10
+ * 人が記録する値(費用・リリース後の不具合)。同じ内容の再送は何もしない。訂正は --rev
11
+ * metrics records 人の記録の全部(範囲を問わない)
12
+ * metrics rm <M1> [--rev 版] 人の記録を消す
13
+ */
14
+ const rowText = (r) => `${r.id} ${r.from}〜${r.to} ${r.value} ${r.unit} 出典: ${r.source}${r.note ? ` メモ: ${r.note}` : ""} (版 ${r.rev}・${r.updatedAt}${r.updatedBy ? `・${r.updatedBy}` : ""})`;
15
+ const recordText = (r) => `${r.metric} ${r.scope === "project" ? "プロジェクト全体" : r.scope} ${rowText(r)}`;
16
+ const valueText = (m) => {
17
+ if (m.rows?.length)
18
+ return m.rows.length === 1 ? `${m.rows[0].value} ${m.rows[0].unit}` : `${m.rows.length} 行(期間・単位ごと。合算しない)`;
19
+ if (m.value === null)
20
+ return METRIC_STATE_LABEL[m.state];
21
+ const v = `${m.value} ${METRIC_UNIT_LABEL[m.unit]}`;
22
+ return m.denominator !== undefined ? `${v} / 基準 ${m.denominator} 件` : v;
23
+ };
24
+ export function formatMetrics(r) {
25
+ const lines = [`開発の指標 範囲: ${r.scopeLabel}`, ` ${r.scopeRule}`, " (改善の材料です。人や AI の成績の評価には使いません)", ""];
26
+ for (const m of r.metrics) {
27
+ lines.push(`${m.label} [${m.id}] ${valueText(m)}${m.kind === "manual" ? " (人の記録)" : ""}`);
28
+ if (m.kind === "manual") {
29
+ for (const r of m.rows ?? [])
30
+ lines.push(` ${rowText(r)}`);
31
+ if (m.recordHint)
32
+ lines.push(` 記録: ${m.recordHint}`);
33
+ }
34
+ else {
35
+ lines.push(` 対象 ${m.targets}・値に入れた ${m.observed}・欠損 ${m.missing}`);
36
+ lines.push(` 内訳: ${m.breakdown.map((b) => `${b.label} ${b.count}`).join("・")}`);
37
+ }
38
+ lines.push(` 算出: ${m.method}`);
39
+ for (const x of m.missingItems.slice(0, 5))
40
+ lines.push(` 欠損: ${x.target} ${x.reason}`);
41
+ if (m.missingItems.length > 5)
42
+ lines.push(` 欠損: ほか ${m.missingItems.length - 5} 件(--json で全部)`);
43
+ }
44
+ if (r.notices.length)
45
+ lines.push("", "知らせ:", ...r.notices.map((n) => ` ${n.target} ${n.message}`));
46
+ lines.push("", `範囲: ${r.scopes.map((s) => (s.scope.kind === "project" ? "(省略)プロジェクト全体" : `--milestone ${s.scope.id}`)).join(" / ")}`);
47
+ return lines.join("\n");
48
+ }
49
+ export async function metricsCommand(cmd, env) {
50
+ if (cmd !== "metrics")
51
+ return undefined;
52
+ const { ctx, out, args, o, actor, expectedRev } = env;
53
+ const sub = args[0];
54
+ if (sub === "record") {
55
+ const [, metric, value] = args;
56
+ if (!metric || value === undefined || args.length > 3)
57
+ throw new UsageError("p3 metrics record <指標> <値> --from YYYY-MM-DD --to YYYY-MM-DD --source 出典 [--unit 通貨] [--milestone ID] [--note メモ] [--rev 版]");
58
+ const r = await recordManual(ctx, { metric, value, scope: o.milestone, from: o.from ?? "", to: o.to ?? "", unit: o.unit, source: o.source ?? "", note: o.note }, { expectedRev, actor });
59
+ return out.result(r, () => `${r.created ? "記録しました" : r.changed ? "訂正しました" : "同じ内容の記録があります(変えていません)"}\n ${recordText(r.record)}`);
60
+ }
61
+ if (sub === "records") {
62
+ const m = await readManual(ctx.ws.dataDir);
63
+ if (m.problem)
64
+ throw new MetricsError(m.problem, "metrics_unreadable");
65
+ return out.result({ records: m.records }, () => (m.records.length ? m.records.map(recordText).join("\n") : "人の記録はありません(p3 metrics record で記録します)"));
66
+ }
67
+ if (sub === "rm" || sub === "remove") {
68
+ if (!args[1] || args.length > 2)
69
+ throw new UsageError("p3 metrics rm <M1> [--rev 版]");
70
+ const r = await removeManual(ctx, args[1], { expectedRev });
71
+ return out.result({ removed: r }, () => `消しました: ${recordText(r)}`);
72
+ }
73
+ if (args.length)
74
+ throw new UsageError(`p3 metrics [--milestone <ID>] | record <指標> <値> ... | records | rm <M1>(知らない引数: ${args.join(" ")})`);
75
+ const r = await metricsReport(ctx, metricScopeOf(ctx, o.milestone));
76
+ return out.result(r, () => formatMetrics(r));
77
+ }
package/lib/cli/output.js CHANGED
@@ -1,10 +1,11 @@
1
+ import { requestRequirementView } from "../shared/requirementSource.js";
1
2
  import { absRef } from "../shared/refs.js";
2
3
  import { relationRole } from "../shared/types.js";
3
4
  import {} from "../core/context.js";
4
5
  import { resolve, titleOf } from "../core/ops.js";
5
6
  import {} from "../core/supersede.js";
6
7
  import { table } from "./format.js";
7
- import { formatAcceptance, formatBlock } from "./showView.js";
8
+ import { formatAcceptance, formatBlock, formatCompletionDetail, formatRequirement, formatRework } from "./showView.js";
8
9
  import { taskWork } from "../core/workTargets.js";
9
10
  import { DIRECT_TASK_NOTE, LATER_PREFLIGHT_NOTE } from "../shared/directTask.js";
10
11
  /** CLI の出力(人向けの表と --json)と、表示の部品 */
@@ -27,7 +28,7 @@ export function formatEntity(ctx, item, file) {
27
28
  const lines = [`${head} ${item.title}`, ""];
28
29
  if ("ref" in item)
29
30
  lines.push(` ${"作業先".padEnd(11)} ${workHint(ctx, item).replace(/^作業先: /, "")}`);
30
- const skip = new Set(["id", "ref", "request", "title", "body", "relations", "repo", "record", "acceptanceCriteria", "acceptanceEvidence", "acceptanceSeq", "acceptanceProblems", "block", "blockHistory", "blockProblems"]);
31
+ const skip = new Set(["id", "ref", "request", "title", "body", "relations", "repo", "record", "acceptanceCriteria", "acceptanceEvidence", "acceptanceSeq", "acceptanceSources", "acceptanceProblems", "block", "blockHistory", "blockProblems", "requirementSources", "requirementSeq", "clarifyAnswers", "requirementProblems", "completionRecords", "completionProblems", "reworkHistory", "reworkProblems"]);
31
32
  for (const [k, v] of Object.entries(item)) {
32
33
  if (skip.has(k) || v === undefined || (Array.isArray(v) && !v.length))
33
34
  continue;
@@ -44,6 +45,15 @@ export function formatEntity(ctx, item, file) {
44
45
  }
45
46
  if ("ref" in item)
46
47
  lines.push("", ...formatAcceptance(item));
48
+ if (!("ref" in item)) {
49
+ const req = requestRequirementView(item);
50
+ if (req.sources.length || req.answers.length || req.problems.length)
51
+ lines.push("", ...formatRequirement(req));
52
+ }
53
+ if ("ref" in item && (item.reworkHistory?.length || item.reworkProblems?.length))
54
+ lines.push("", ...formatRework(item));
55
+ if (item.completionRecords?.length || item.completionProblems?.length)
56
+ lines.push("", ...formatCompletionDetail(item));
47
57
  if ("ref" in item) {
48
58
  const out = item.relations.map((r) => ` → ${pad(relationRole(r.type, "out"))} ${r.target} ${titleOf(ctx, `${home}/${r.target}`)}`);
49
59
  const inc = [
@@ -15,6 +15,7 @@ import { normalizeProject } from "../core/store/normalize.js";
15
15
  import { requestWorkstreams } from "../shared/workTarget.js";
16
16
  import { DEFAULT_PREFLIGHT_RUNNER, isPreflightRunner, PREFLIGHT_RUNNERS, RUNNER_LABEL, runnerView } from "../shared/preflightRunner.js";
17
17
  import { DATA_DIR_NAME } from "../core/store/locate.js";
18
+ import { ENTRY_VERSION } from "./guide.js";
18
19
  import { sortMilestones } from "../shared/milestoneOrder.js";
19
20
  import { loadUserConfig, PROJECT_NAME, setProjectNode, updateUserConfig, userConfigPath } from "../core/userConfig.js";
20
21
  /** プロジェクトの初期設定・設定変更、変更者と「今の要望」の判定(CLI) */
@@ -108,7 +109,7 @@ export function currentRequest(ctx, explicit, cwd) {
108
109
  /** init で本体の主なフォルダ(最初に読むもの)の候補にするドキュメントと、フォルダの入口の候補 */
109
110
  const DOC_CANDIDATES = ["docs", "doc", "README.md", "ARCHITECTURE.md", "DESIGN.md", "AGENTS.md", "CLAUDE.md", "CONTRIBUTING.md"];
110
111
  const DOC_ENTRIES = ["README.md", "index.md"];
111
- const AGENTS_MARK = "タスク管理(infodb p3)";
112
+ export const AGENTS_MARK = "タスク管理(infodb p3)";
112
113
  /** AI 向けの使い方を置く先(リポジトリのルートからの相対パス。どれも同じ原本 skills/p3/SKILL.md を写す) */
113
114
  export const AGENT_TARGETS = {
114
115
  claude: { path: ".claude/skills/p3/SKILL.md", agent: "Claude Code" },
@@ -117,10 +118,12 @@ export const AGENT_TARGETS = {
117
118
  /** --agents / p3 agents の選び方(値なしの --agents は both) */
118
119
  export const AGENT_CHOICES = { claude: ["claude"], codex: ["codex"], both: ["claude", "codex"] };
119
120
  export const isAgentChoice = (v) => typeof v === "string" && Object.hasOwn(AGENT_CHOICES, v);
120
- const KINDS = Object.keys(AGENT_TARGETS);
121
+ export const KINDS = Object.keys(AGENT_TARGETS);
122
+ /** 節の入口の版を書く機械可読のコメント(ENTRY_VERSION。見出しの次の行) */
123
+ export const ENTRY_COMMENT = (v) => `<!-- p3-entry-version: ${v} -->`;
121
124
  /**
122
- * AGENTS.md / CLAUDE.md に書く指示(節)。スキルの参照は、置いた先(と既にある先)だけを書く。手順の詳しい版は同梱のスキル
123
- * (skills/p3/SKILL.md)で、役割と終わり方はそちらとそろえる(test/agents.test.ts が確かめる)
125
+ * AGENTS.md / CLAUDE.md に書く指示(節)。入口だけで、手順の本文は CLI(p3 guide)から読ませる。
126
+ * スキルの参照は、置いた先(と既にある先)だけを書く。入口の決まりを変えたら ENTRY_VERSION を上げる(test/agents.test.ts が確かめる)
124
127
  */
125
128
  export function agentsSnippet(kinds) {
126
129
  const list = KINDS.filter((k) => kinds.includes(k));
@@ -128,28 +131,11 @@ export function agentsSnippet(kinds) {
128
131
  return `
129
132
  ## ${AGENTS_MARK}
130
133
 
131
- - 作業の単位は要望。タスクは \`p3\` CLI(入っていなければ \`pnpx @infodb/p3\`)で操作し、\`--json\` で結果を読むこと(データのフォルダを直接編集しない)。
132
- 詳しい手順はスキル ${skills}
133
- - 変更するときは環境変数 \`P3_ACTOR=ai:<エージェント名>\` を付ける
134
- - 操作する要望は \`--req <要望ID>\` で指定する(要望の作業ツリーの中なら省ける)。まず \`p3 whoami --json\` で確かめる(Preflight の担当 \`preflight.runner\` も出る)
135
- - \`whoami\` の \`via\`(プロジェクトの決まり方)が \`cwd\` でなければ(\`dir\` / \`project\` / \`legacy\` / \`only\`)、それ以上 p3 を操作せず、対象のプロジェクトでよいか人に確かめる(推測した \`--project\` / \`--dir\` で避けない。人が指定・確認した後はその対象のまま続ける)
136
- - プロジェクトが無い・未登録のときは \`p3 init\` / \`p3 join\` を自分から実行せず、新しく作る(\`init\`)のか共有されたものに参加する(\`join\`)のかを人に確かめる
137
- - 新しい作業を頼まれたら \`p3 request new "<タイトル>" --body "..."\` で要望を登録し、ID を伝えて終える。
138
- Preflight(\`preflight\`)は自分から始めない(勧めない・尋ねない)。タスク化(\`accept\`)は人が行う(結果を \`p3 drafts\` で読むのと、頼まれたメモの保存 \`--note-only\` はよい)
139
- - Preflight を頼まれたら、担当(\`whoami --json\` の \`preflight.runner\`)で分ける。\`codex\`: 人が \`p3 preflight\` か画面で実行する(AI は \`--prepare\` の無い \`p3 preflight\` をしない)。人がチャットで対象の要望の手元の評価を明示的に頼んだときだけ手元で評価し、「Preflight して」とだけなら、人が実行するのか手元で評価するのかを確かめる。\`agent\`: 人に「Preflight して」と頼まれたら手元で評価する(「このチャットで」は求めない)。\`null\`(読めない): \`agent\` と推測せず \`problem\` を伝え、\`codex\` と同じ扱い。子の要望も同じ。対象の要望が分からなければ確かめる
140
- - 手元の評価: \`p3 preflight <要望ID> --prepare --json\` → 返った指示のファイル(\`instructions\`)を最後まで読み、書くのは返った run の成果物(\`outputs\`)だけ → \`p3 preflight <要望ID> --complete --run <run> --json\` → \`p3 drafts\` の結果を伝えて終える(自分から始めない。タスク化 \`accept\` と着手はしない)
141
- - 着手する前に \`p3 show T003 --brief --json\` で本文・依存とその状態(\`dependencies\`)・置き換えの注意(\`warnings\`)を読む
142
- - 着手する前に、\`--brief --json\` の \`work\`(作業先のリポジトリとブランチ)を見て、そのリポジトリでブランチに入る(作業先なしなら移動しない)
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\` にしない)、未達・未検証を残して完了にしたら人に伝える。証拠は自分の申告で、済みにするかは人が決める。基準を自分で消す・書き換えて満たしたことにしない
145
- - 要望のタスクを全部終えたら、コミットする前に \`p3 request set <要望ID> status=resolved\`(対応済)にする。完了済(done)・見送り(rejected)とタスクの済み(check)は人が決める
146
- - 子の要望(\`parent\` のある要望)は、親とは別の要望として子ごとのタスクとブランチで作業する(親のタスクにしない)。分割の案の採用(\`accept\`)は人が行う。子の Preflight は親と同じ担当で、頼まれたときだけ(分割の採用・子の作成から自分で評価へ進まない)。親を対応済にするのは、親のタスクと見送り以外の子(\`request show <親> --brief --json\` の \`children\`)が全部終わってから
147
- - データのフォルダがこの作業ツリーの中で git 管理されているなら、要望のフォルダ(\`requests/<要望ID>/\`)の変更も実装と同じコミットに入れる(後のレビューで要望とやったことを精査するため。子なら祖先の要望のフォルダ、親を対応済にするときは子孫の要望のフォルダ(見送りの子など)のまだ入っていない変更も入れ、ほかの要望・関係ない変更は入れない。外・無視・worktree のときは入らないので、移動や \`git add -f\` はしない)。push に失敗したら完了の記録は残し、公開できていないことを伝える。要望のフォルダは、マージするまで要望のブランチにしか無い。既定のブランチに切り替えると、その要望(子なら親の子の一覧からも)が消えたように見えるが、データはブランチにある(作り直したり、別のブランチから写したりしない)
148
- - コミットや PR の URL は後から \`p3 move T003 done --output <URL>\` で足す(完了・記録はそのまま。データをコミットしているなら追記もコミットして push)。複数のリポジトリにまたがるときは最後のタスクに \`--repo-output <参照先>=<PR の URL>\` で全部の PR を残す
149
- - タスクの AI レビュー(\`p3 review\`)は頼まれずに始めない(Codex を使う)。結果を理由に済みにしたり基準・証拠を書き換えたりしない
150
- - 置き換えられたタスク(\`p3 ls\` の \`※置換\`、\`--json\` の \`superseded\`)からは始めない。\`move\` が \`warnings\` を返したら止めて人に確かめる
151
- - 人の判断・権限が要る・前提が崩れた・テストが通らず先に進めないなどでタスクを続けられなくなったら、\`p3 block T003 --reason "<具体的な理由>" --decision "<人に決めてほしいこと>" --json\` で止まっている理由を付け(通常の修正・調査の途中では使わない)、JSON の \`block\` で保存できたことを確かめてから、理由・いつから・答えてほしいこと・再開のしかたを人に伝えて作業を終える(止まったまま完了・済み・対応済に進めない。基準や証拠を書き換えない)。回答を受けたら \`p3 unblock T003 --resolution "<回答>"\` で解除して再開する(解除だけでは再開しない。人が先に解除していたら履歴の回答を読んで確かめる)
152
- - 作業中に新しく必要になった作業は \`p3 new "<タイトル>" --body "..."\` でタスクにする(人への質問はタスクにしない)
134
+ ${ENTRY_COMMENT(ENTRY_VERSION)}
135
+
136
+ - このリポジトリの作業は infodb p3 の要望とタスクで管理する。p3 を操作する前に \`pnpx @infodb/p3 guide --json\` を実行し、返った \`guide\`(作業の手順)を最後まで読んで従う(手順は動いている CLI の版のものが返る。ここには写さない)
137
+ - \`guide\` を取得できなければ(コマンドが無い・エラーになる・JSON が読めない)、p3 を操作しない。出たエラーと呼び方(\`pnpx @infodb/p3 guide --json\`)を人に伝えて終える
138
+ - 同じ入口のスキル: ${skills}
153
139
  `;
154
140
  }
155
141
  /** 両方に置いたときの節(docs/architecture.md に載せる例。test/agents.test.ts が同じことを確かめる) */
@@ -168,7 +154,7 @@ function firstDiffLine(a, b) {
168
154
  return i + 1;
169
155
  }
170
156
  /** 指示の節(見出し「タスク管理(infodb p3)」からその見出しと同じか上の段の次の見出しの前まで。コードの囲みの中は見出しに数えない) */
171
- function findSections(text) {
157
+ export function findSections(text) {
172
158
  const lines = text.split("\n");
173
159
  const heads = [];
174
160
  let fence = false;