@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.
- package/README.md +32 -35
- package/dist/web/assets/CompletionReview-gZKZrDu_.js +1 -0
- package/dist/web/assets/ImprovementDialog-Dno6dPnG.js +1 -0
- package/dist/web/assets/Outputs-BgHalMGb.js +1 -0
- package/dist/web/assets/RequestStatus-hZcBUUIu.js +1 -0
- package/dist/web/assets/Tabs-C3NmwCc3.js +1 -0
- package/dist/web/assets/TagInput-B2b862qn.js +1 -0
- package/dist/web/assets/TaskDrawer-4BQBELXa.js +6 -0
- package/dist/web/assets/_requestId-BMAG1t3o.js +1 -0
- package/dist/web/assets/_requestId-tbg2pA2S.js +1 -0
- package/dist/web/assets/archive-DMl6WyOe.js +1 -0
- package/dist/web/assets/board-BMTcHKyt.js +1 -0
- package/dist/web/assets/done-CL6Nlsua.js +1 -0
- package/dist/web/assets/draft-BvGxfD7v.js +2 -0
- package/dist/web/assets/index-Dp7Fc4VI.css +2 -0
- package/dist/web/assets/index-KdlgMitg.js +12 -0
- package/dist/web/assets/metrics-Cu7gJ7Rk.js +1 -0
- package/dist/web/assets/new-DTXWHuFO.js +1 -0
- package/dist/web/assets/outputs-CXqnjSqV.js +1 -0
- package/dist/web/assets/preflightInput-ClKwkp8R.js +2 -0
- package/dist/web/assets/preload-helper-oLCrNCwz.js +1 -0
- package/dist/web/assets/{quality-Pu6EISAM.js → quality-RFd-7k3r.js} +1 -1
- package/dist/web/assets/release-notes-Bpdi6RdY.js +5 -0
- package/dist/web/assets/requestData-CbFxwW5w.js +1 -0
- package/dist/web/assets/routes-BIt8bExF.js +6 -0
- package/dist/web/assets/settings-CsCqF_1B.js +1 -0
- package/dist/web/assets/ui-BGK72r3u.js +1 -0
- package/dist/web/assets/workTarget-CySfKyfB.js +30 -0
- package/dist/web/index.html +4 -4
- package/docs/architecture.md +300 -36
- package/docs/development.md +60 -16
- package/docs/how-to-use.md +381 -28
- package/docs/installation.md +235 -144
- package/docs/publishing.md +1 -1
- package/lib/cli/agentsStatus.js +197 -0
- package/lib/cli/args.js +72 -8
- package/lib/cli/guide.js +27 -0
- package/lib/cli/guide.md +214 -0
- package/lib/cli/help.js +44 -6
- package/lib/cli/main.js +76 -20
- package/lib/cli/metricsCommands.js +77 -0
- package/lib/cli/output.js +12 -2
- package/lib/cli/project.js +13 -27
- package/lib/cli/qualityCommands.js +33 -8
- package/lib/cli/readOnly.js +15 -0
- package/lib/cli/requestCommands.js +21 -4
- package/lib/cli/requirementCommands.js +288 -0
- package/lib/cli/retroCommands.js +106 -0
- package/lib/cli/revisitCommands.js +73 -0
- package/lib/cli/showView.js +119 -6
- package/lib/cli/taskCommands.js +42 -16
- package/lib/cli/userConfig.js +47 -0
- package/lib/core/completionRefs.js +46 -0
- package/lib/core/metrics/definitions.js +434 -0
- package/lib/core/metrics/index.js +88 -0
- package/lib/core/metrics/manual.js +180 -0
- package/lib/core/ops.js +15 -2
- package/lib/core/preflight/carryover.js +5 -1
- package/lib/core/preflight/codexEngine.js +34 -17
- package/lib/core/preflight/diagnose.js +4 -9
- package/lib/core/preflight/engine.js +9 -0
- package/lib/core/preflight/hostPaths.js +260 -0
- package/lib/core/preflight/input.js +33 -5
- package/lib/core/preflight/instructions.js +18 -1
- package/lib/core/preflight/mockEngine.js +20 -2
- package/lib/core/preflight/render.js +22 -3
- package/lib/core/preflight/service.js +59 -9
- package/lib/core/preflight/uiRender.js +3 -0
- package/lib/core/requestOps.js +206 -14
- package/lib/core/retrospective.js +208 -0
- package/lib/core/reviewCandidates.js +56 -0
- package/lib/core/store/collection.js +20 -1
- package/lib/core/store/normalize.js +22 -4
- package/lib/core/store/preflightStore.js +19 -5
- package/lib/core/store/workspace.js +17 -1
- package/lib/core/taskReview/material.js +7 -0
- package/lib/core/taskReview/review.js +9 -2
- package/lib/server/api/manifest.js +51 -3
- package/lib/server/api/routes.js +131 -11
- package/lib/shared/acceptance.js +258 -18
- package/lib/shared/completionRecord.js +327 -0
- package/lib/shared/metrics.js +42 -0
- package/lib/shared/preflightInput.js +1 -1
- package/lib/shared/requirementSource.js +635 -0
- package/lib/shared/retrospective.js +286 -0
- package/lib/shared/reviewCandidate.js +308 -0
- package/lib/shared/reworkHistory.js +81 -0
- package/package.json +3 -2
- package/skills/p3/SKILL.md +9 -181
- package/dist/web/assets/ImprovementDialog-kQaVBGWH.js +0 -1
- package/dist/web/assets/Outputs-_nU_p3nu.js +0 -1
- package/dist/web/assets/RequestStatus-RG-OVQYY.js +0 -1
- package/dist/web/assets/Tabs-ew9i5SKX.js +0 -1
- package/dist/web/assets/TagInput-BtlJTF7i.js +0 -1
- package/dist/web/assets/TaskDrawer-DW8GyJqI.js +0 -6
- package/dist/web/assets/_requestId-6Nb727dD.js +0 -1
- package/dist/web/assets/_requestId-BykTgPax.js +0 -1
- package/dist/web/assets/appCtx-CxDdXABS.js +0 -1
- package/dist/web/assets/archive-Ckh295Xe.js +0 -1
- package/dist/web/assets/board-BVAIjK-Y.js +0 -1
- package/dist/web/assets/done-BGfA-3MA.js +0 -1
- package/dist/web/assets/draft-CfJeyLOl.js +0 -1
- package/dist/web/assets/index-CgRU744I.css +0 -2
- package/dist/web/assets/index-DacQ0yl4.js +0 -12
- package/dist/web/assets/new-DVygWvVc.js +0 -1
- package/dist/web/assets/outputs-B6xDsLZf.js +0 -1
- package/dist/web/assets/preflightInput-BAeEJYUK.js +0 -2
- package/dist/web/assets/preload-helper-DyCqp21K.js +0 -1
- package/dist/web/assets/release-notes-CCpzyiNf.js +0 -5
- package/dist/web/assets/requestData-D5vBnuMh.js +0 -1
- package/dist/web/assets/routes-Q91zvNc0.js +0 -4
- package/dist/web/assets/settings-BzRgcmUm.js +0 -1
- 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
|
|
33
|
-
|
|
34
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
358
|
+
return exit(3);
|
|
313
359
|
}
|
|
314
360
|
if (e instanceof UserConfigError) {
|
|
315
361
|
process.stderr.write(`${e.message}\n`);
|
|
316
|
-
|
|
362
|
+
return exit(1);
|
|
317
363
|
}
|
|
318
364
|
if (e instanceof SettingsError) {
|
|
319
365
|
process.stderr.write(`設定: ${e.message}\n`);
|
|
320
|
-
|
|
366
|
+
return exit(1);
|
|
321
367
|
}
|
|
322
368
|
if (e instanceof ProjectNotResolvedError || e instanceof DataDirError) {
|
|
323
369
|
process.stderr.write(`${e.message}\n`);
|
|
324
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
422
|
+
return exit(3);
|
|
367
423
|
}
|
|
368
424
|
if (e instanceof NotFoundError) {
|
|
369
425
|
process.stderr.write(`見つかりません: ${e.id}\n`);
|
|
370
|
-
|
|
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
|
-
|
|
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 = [
|
package/lib/cli/project.js
CHANGED
|
@@ -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
|
-
*
|
|
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
|
-
|
|
132
|
-
|
|
133
|
-
-
|
|
134
|
-
-
|
|
135
|
-
-
|
|
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;
|