@infodb/p3 0.8.0 → 0.10.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 +4 -2
- package/dist/web/assets/{Outputs-CQi0oba1.js → Outputs-B4Tr7JzU.js} +1 -1
- package/dist/web/assets/{RequestStatus-grC0F_SQ.js → RequestStatus-DGaoQoIa.js} +1 -1
- package/dist/web/assets/{Tabs-BJRGzidj.js → Tabs-D16MqQxu.js} +1 -1
- package/dist/web/assets/{TagInput-cIIwXAHA.js → TagInput-pSYxm4bz.js} +1 -1
- package/dist/web/assets/{TaskDrawer-CSZ7Z0JC.js → TaskDrawer-1Ev3RpRV.js} +1 -1
- package/dist/web/assets/{_requestId-Z3CBhTIL.js → _requestId-BKhn019m.js} +1 -1
- package/dist/web/assets/_requestId-Btpvuu7-.js +30 -0
- package/dist/web/assets/{appCtx-DCiGJFAe.js → appCtx-D_Iaoh2e.js} +1 -1
- package/dist/web/assets/{board-DyfGX5h0.js → board-DeHdxbN4.js} +1 -1
- package/dist/web/assets/{directTask-Dk3H5Q2B.js → directTask-C1NWDkZp.js} +1 -1
- package/dist/web/assets/{done-Bhxqy7bH.js → done-BFaHGt03.js} +1 -1
- package/dist/web/assets/{index-Bt13tvIX.js → index-CDWcKy1L.js} +3 -3
- package/dist/web/assets/{new-BRsIUNIb.js → new-ChFzBoL2.js} +1 -1
- package/dist/web/assets/{preload-helper-B40dBmwL.js → preload-helper-hSId95YD.js} +1 -1
- package/dist/web/assets/{release-notes-C3FdiM36.js → release-notes-BWNDFDkH.js} +1 -1
- package/dist/web/assets/{requestData-w6fhCYmh.js → requestData-B_320uxL.js} +1 -1
- package/dist/web/assets/{routes-QNgQHe48.js → routes-BBD464IS.js} +1 -1
- package/dist/web/assets/{settings-CoKJahEe.js → settings-D7PPrGjT.js} +1 -1
- package/dist/web/index.html +3 -3
- package/docs/architecture.md +95 -6
- package/docs/development.md +21 -5
- package/docs/how-to-use.md +99 -1
- package/docs/installation.md +30 -12
- package/docs/publishing.md +5 -1
- package/lib/cli/args.js +5 -0
- package/lib/cli/help.js +10 -1
- package/lib/cli/main.js +12 -3
- package/lib/cli/preflightCommands.js +98 -3
- package/lib/cli/project.js +31 -8
- package/lib/core/context.js +1 -1
- package/lib/core/preflight/codexEngine.js +63 -220
- package/lib/core/preflight/codexImage.js +49 -19
- package/lib/core/preflight/docker.js +149 -0
- package/lib/core/preflight/instructions.js +263 -0
- package/lib/core/preflight/owner.js +118 -0
- package/lib/core/preflight/render-image/Dockerfile +1 -1
- package/lib/core/preflight/service.js +516 -84
- package/lib/core/preflight/uiRender.js +1 -1
- package/lib/core/projectRegistry.js +2 -1
- package/lib/core/store/dataWatcher.js +122 -0
- package/lib/core/store/normalize.js +9 -1
- package/lib/core/store/preflightStore.js +20 -2
- package/lib/core/store/projectFile.js +6 -1
- package/lib/core/store/workspace.js +20 -37
- package/lib/server/api/manifest.js +10 -1
- package/lib/server/api/routes.js +18 -5
- package/lib/server/server.js +3 -1
- package/lib/shared/directTask.js +2 -2
- package/lib/shared/preflightRunner.js +18 -0
- package/lib/shared/scopeView.js +3 -2
- package/package.json +2 -2
- package/skills/p3/SKILL.md +45 -7
- package/dist/web/assets/_requestId-C8WYk2kC.js +0 -30
package/docs/architecture.md
CHANGED
|
@@ -590,6 +590,25 @@ serve の中で起きたこと(画面からの保存、Preflight の進み具
|
|
|
590
590
|
タブ・ウィンドウに戻ったときの読み直し(POST /api/reload)で取り込む。ファイル監視は補助で、届かないことがある
|
|
591
591
|
(NFS や、Node の再帰的な監視が置き換えて保存したファイルの2回目以降の変更を通知しないことがある)。
|
|
592
592
|
|
|
593
|
+
**データのフォルダの監視**(`src/core/store/dataWatcher.ts`。`Workspace.watch` が1つだけ持ち、通常の serve と `--all-projects` の
|
|
594
|
+
プロジェクトごとに同じものを使う): 補助なので、壊れても serve と実行中の Preflight は止めない。
|
|
595
|
+
|
|
596
|
+
- `fs.promises.watch` は使わない。Node 22 の Linux の再帰監視(JS の実装)は、見ている途中でフォルダが消えると(Preflight が
|
|
597
|
+
`drafts/` を作り直すときなど)ウォッチャーに `'error'` を出し、`promises.watch` の非同期イテレータはそれを聞かないので、未処理の
|
|
598
|
+
`'error'` イベントとしてプロセスごと落ちていた(for await の try/catch には届かない。2026-11-03 に `--all-projects` の serve が
|
|
599
|
+
`ENOENT: scandir '.../preflight/PF-.../drafts'` で落ち、別のプロジェクトの Preflight も止まった)。コールバック式の `fs.watch` を
|
|
600
|
+
持ち、`'error'` を必ず聞く。プロセス全体の `uncaughtException` で握り潰すことはしない
|
|
601
|
+
- 入れ子のフォルダ・ファイルが消えた `ENOENT`(データのフォルダ自体はある): 一時的なものとして監視を続ける。ログは 60 秒に1行に間引く
|
|
602
|
+
- それ以外のエラー・監視の開始の失敗: 監視を閉じ、1 秒後に立て直す(失敗が続くと倍にして 30 秒まで)。続けて 6 回失敗したら
|
|
603
|
+
(立て直しを 5 回)やめて、その旨をログに残す。60 秒より長く動いた後の失敗は、続けての失敗に数えない。やめた後も API と
|
|
604
|
+
画面の「再読み込み」はそのまま使える(serve を起動し直すと、また監視を始める)
|
|
605
|
+
- 変更を読み込む処理の失敗はログに残すだけ(次の変更か「再読み込み」で反映)
|
|
606
|
+
- ログは標準エラーに `[watch] <データのフォルダ>: <何が起きたか>。<続ける / 立て直す / やめる>: <原因>` の形で出す
|
|
607
|
+
- `close` で監視・遅らせた通知・立て直しの予定を全部やめ、その後は通知も立て直しも起こさない(close の後に watch しても始めない)
|
|
608
|
+
- 限界: 監視をやめた・立て直している間の外での変更は画面に自動では出ない(「再読み込み」で取り込む)。Node 24.22.2・26.13.0 では、同じ操作で
|
|
609
|
+
元の例外は起きなかった(2026-11-03 の記録)。今の対象(`engines` の `>=24`、イメージの 26)では起きないが、`'error'` を聞く守りは残す。
|
|
610
|
+
`test/dataWatcher.test.ts` の実際の監視は元の例外を起こせないので、退行は差し替えた監視のテストが見る
|
|
611
|
+
|
|
593
612
|
画面は定期的には問い合わせない、の例外を1つだけ置く: 要望の「概要・Preflight」を開いている間だけ、その要望の最新の Preflight を
|
|
594
613
|
軽く確かめる(`GET /api/requests/:rid/preflight-status`、`PreflightService.pulse`)。CLI など外で始めた run とその進み・終わりは
|
|
595
614
|
serve の SSE に乗らず、監視も届かないことがあるため。返すのは要望の `lastPreflight` と、指定した run の `run.json` の状態・日時と
|
|
@@ -689,7 +708,7 @@ CLI は `cli/main.ts`(振り分け・プロジェクトと変更者の決定
|
|
|
689
708
|
- 実行中も「メモだけ保存」はでき、実行中の評価ではなく次の Preflight に渡る。保存してから始められなかったときは、保存済みと
|
|
690
709
|
伝え、書き直さずに再実行できる。過去の run を表示していても、引き継ぎ元は直近の run なので、何を引き継ぐかを入力欄の上に出す。
|
|
691
710
|
run ごとに、引き継いだ前回の run(クリックで移る)と渡したメモを表示する
|
|
692
|
-
- 過去の経緯は p3 が選ばず、Codex が調べる(`
|
|
711
|
+
- 過去の経緯は p3 が選ばず、Codex が調べる(`instructions.ts` の `historySection`)。以前は TF-IDF と areas(パス)の
|
|
693
712
|
重なりで選んだ10件を渡していたが、リファクタリングでパスが変わる・ファイルを分割すると外れ、読み替えの表では分割や
|
|
694
713
|
移動の繰り返しを扱えない。git は行ごとに履歴を追え(`blame -C -M`)、マージのコミットのブランチ名に要望 ID があるので、
|
|
695
714
|
コード → コミット → 要望 → `/data` の記録と辿れる。p3 を入れる前の経緯も分かる。全件はプロンプトに入れず、Codex が
|
|
@@ -702,6 +721,51 @@ CLI は `cli/main.ts`(振り分け・プロジェクトと変更者の決定
|
|
|
702
721
|
追加で許す保証ではない。コマンドの実行は禁止していない。参照先は読むだけのマウントで書けない。データのフォルダ(`/data`)は
|
|
703
722
|
書けるマウントなので、「run の中だけ」は指示と事後の警告で守っている(書き込みを run に閉じ込める囲いは今は無い)。
|
|
704
723
|
画面イメージの描画は、この Codex のコンテナではなく別のコンテナで行う
|
|
724
|
+
- 指示(制約 = Codex の `developerInstructions` と、依頼文)は `src/core/preflight/instructions.ts` の1か所で作る。評価の観点・
|
|
725
|
+
履歴の調べ方・分割・出力の形・画面の原稿の書き方の原本はここだけに置き、エンジンごとに複製しない。実行環境ごとに違うのは
|
|
726
|
+
パスと「何が強制されているか」だけで、`InstructionEnv` として注入する:
|
|
727
|
+
- `containerEnv`(Codex): 参照先は `/workspace/<mount>`、データは `/data`。書き込みは run の配下だけ、と指示する
|
|
728
|
+
- `localEnv`(手元の対話エージェント。Claude Code など): 参照先・データ・run はこのマシンの実パス。コマンドに埋めるパスは
|
|
729
|
+
空白などを含むときだけ引用符で囲む。制約と依頼文は run のフォルダの `instructions.md`(`localInstructions`。制約を先に置き、
|
|
730
|
+
資料の中の指示より優先すると書く)として渡し、チャットに長い指示を貼らない。書き込めるのは run の成果物
|
|
731
|
+
(`assessment.json`・`drafts/`・`children/`・`ui/index.json`・`ui/src/`)だけで、`run.json` などの管理情報・
|
|
732
|
+
`instructions.md`・固定した資料(`request.md`・`carryover.md`・添付)・参照先は変えさせない
|
|
733
|
+
- 手元の経路には **コンテナと同等の囲いが無い**。参照先を読むだけにする・書き込みを成果物に限ることは、エージェントの権限の
|
|
734
|
+
中で指示として守らせるだけで、P3 は強制できない(取り込みでは成果物を確かめるが、ほかのファイルへの書き込みは止められない)。
|
|
735
|
+
git の履歴の有無(`gitHistory`)はコンテナの見え方で決めるので、手元では作業ツリー・サブフォルダの履歴も「なし」と出る(控えめに出るだけ)
|
|
736
|
+
- 手元のエージェントの Preflight(`p3 preflight --prepare` / `--complete` / `--cancel`。`service.ts` の `prepare`・`complete`・
|
|
737
|
+
`cancelLocal`)はエンジンではない(P3 はモデルを呼ばない)。開始と終了を別のプロセスに分ける:
|
|
738
|
+
- 準備は通常の開始と同じ固定(`fix`・`open`)をし、`run.json` に `engine: local`・`status: running`・`local.before`(準備したときの
|
|
739
|
+
要望のステータス)を残す。待っている状態は `run.json` だけで表し、プロセスのメモリ(`active`)には置かない
|
|
740
|
+
- 同じ要望の開始・準備・取り込み・取消は、要望ごとのロックのファイル(`requests/.preflight-<要望ID>.lock`)で1つずつにする。最新の
|
|
741
|
+
run(`lastPreflight`)が local で待っている、またはほかのプロセスで実行中なら始めない(`PreflightBusyError`。下の「実行している
|
|
742
|
+
プロセスと、落ちたプロセスが残した run」)
|
|
743
|
+
- 取り込みは成果物を先に確かめ(`localProblems`)、問題があれば run を変えずに断る(`local.rejected` を数えるだけ)。通ったら画面の
|
|
744
|
+
原稿を描き、通常と同じ `ingest`・`finish` で完了にする。取り込みも取消も `lastPreflight` は変えない
|
|
745
|
+
- **実行しているプロセスと、落ちたプロセスが残した run**(`src/core/preflight/owner.ts`、`service.ts` の `busy`・`recoverRequest`・
|
|
746
|
+
`recover`・`finishLocked`): serve・CLI が途中で落ちると、codex / mock の run は `running` のまま残る。以前は開始から 35 分たったら
|
|
747
|
+
落ちたものとみなして始め直せたが、生きている長い実行と重なりうるうえ、画面からは何分たっても始め直せなかったのでやめた
|
|
748
|
+
- 記録: 始めるとき(`open`)に `run.json` の `owner` と `before`(始める前の要望のステータス)を残す。`owner` は `instance`(ローカルの
|
|
749
|
+
状態のフォルダ `XDG_STATE_HOME/infodb-p3/instance-id` のランダムな値とホスト名のハッシュ。データ・個人設定とは別の場所。個人設定は
|
|
750
|
+
コンテナどうしでマウントして共有することがあるため)・`boot`(Linux の `boot_id`)・`pidNs`(PID の名前空間)・`pid`・`start`
|
|
751
|
+
(`/proc/<pid>/stat` の起動の時刻)。共有するデータに置くので、パス・認証情報・ホスト名そのものは残さない。local の run には残さない
|
|
752
|
+
(プロセスを跨いで待つ契約のまま)
|
|
753
|
+
- 判定(`ownerState`): 同じ環境・同じ起動・同じ名前空間で同じ番号・同じ起動の時刻のプロセスがあれば動いている(`alive`)。
|
|
754
|
+
同じ環境で、OS が起動し直した・その番号のプロセスが無い・番号が使い回されている(起動の時刻が違う)なら終わっている(`dead`)。
|
|
755
|
+
記録が無い(以前の run)・別の環境(別のマシン・作り直したコンテナ)・別の名前空間(起動し直したコンテナ・サンドボックス)・
|
|
756
|
+
Linux 以外で起動の時刻を確かめられないときは分からない(`unknown`)。確かめられないものを終わっているとはしない
|
|
757
|
+
- 回復: `dead` の run(最新でなくても)を、要望ごとのロックの中で読み直してから `failed` にする(`error` は「中断しました: <理由>」、
|
|
758
|
+
`interrupted` に理由と日時、`finishedAt` とログ)。serve が開いたとき(通常の serve の起動、`--all-projects` で開いたとき)に
|
|
759
|
+
全部の要望を確かめ(`recover`。1件の失敗はログに残してほかを続ける。起動は待たない)、開始・準備の前(`busy`)にもその要望を確かめる。
|
|
760
|
+
読むだけの `pulse` は書かない
|
|
761
|
+
- 始めるかどうか(`busy`)は時間を見ない: このプロセスで実行中・local が待っている・`alive`・`unknown` なら断り、理由を出す
|
|
762
|
+
- 終わり方(`finishLocked`): ファイルの run が既に終わっていれば(別のプロセスが中断にした・取り消した)上書きしない。要望の
|
|
763
|
+
ステータスは、その run が最新(`lastPreflight`)で、要望がまだ評価中のときだけ `before` から戻す(古い run の終わりで新しい run と
|
|
764
|
+
要望の状態を巻き戻さない)。`before` の無い以前の run では要望のステータスを変えない。実行(`execute`)の終わりもロックの中で行う
|
|
765
|
+
(ロックを取れなければ、同じ規則でロックなしに記録だけ残す)
|
|
766
|
+
- 限界: `unknown` の run は自動では中断にしない(コンテナの起動し直しで残った run もこちら。名前空間が変わるので、前のプロセスが
|
|
767
|
+
終わったと確かめられない)。動いていないことを人が確かめて中断にする操作が要る。Linux 以外は起動の時刻を見られないので、
|
|
768
|
+
プロセスが無いときだけ `dead` になる
|
|
705
769
|
- ファイル契約なので、Mock エンジンでも人手で書いても同じ取り込み処理になる。案の `supersedes` のうち同じ要望に無いタスクはタスク化のときに捨てる
|
|
706
770
|
- テストは偽の app-server で、マウントの引数・指示文・記録・根拠の扱いを確かめる。本物の Codex が実際にどこまで読むか、
|
|
707
771
|
読むだけのマウントへの書き込みが拒まれることは、偽の app-server では確かめられない
|
|
@@ -809,6 +873,24 @@ package.json では公開版の版の範囲(`^0.2.0` など)で指定し、
|
|
|
809
873
|
失敗した段(docker が無い / デーモン / 作成 / 版の取得)ごとに次にすることを出す(`src/core/preflight/codexImage.ts`)
|
|
810
874
|
- テストは偽の docker(`test/fixtures/fake-docker.mjs`)で行い、本物の Docker では次で確かめる:
|
|
811
875
|
`XDG_CONFIG_HOME=$(mktemp -d) p3 codex update --json`(未登録・未認証のままでよい)
|
|
876
|
+
- P3 は `ensureImage` そのものは呼ばない(inspect・build・版の確認のどれにも待つ時間の上限が無く、取消も受けないため)。同じ判定と
|
|
877
|
+
ビルドを、同梱の `DOCKER_CONTEXT` と `parseCreated` を使って `codexImage.ts` で行う(Dockerfile は写さない)
|
|
878
|
+
- **Docker の待ち時間の上限と後片付け**(`src/core/preflight/docker.ts`): 以前は版の確認のコンテナ(`codex --version`)が版を出した後も
|
|
879
|
+
終わらず、Preflight がそれを待って止まったことがある(2026-11-03)。P3 が動かす docker の操作には上限があり、時間切れ・中止では
|
|
880
|
+
docker の CLI を止め、P3 が名前を付けて起こしたコンテナはそのコンテナだけを `docker rm -f <名前>` で消す(`docker ps` の全部や
|
|
881
|
+
イメージ名では消さない)
|
|
882
|
+
- 上限(`DOCKER_LIMITS`): デーモンに聞くだけの操作(version・image inspect)15 秒、版の確認 60 秒、ビルド 10 分、コンテナを消す 10 秒。
|
|
883
|
+
評価の1ターンは codex-workspace の既定の 30 分、初期化・使用量などターンの外の要求は同じく 120 秒(`requestTimeoutMs` の既定)
|
|
884
|
+
- イメージの確認の時間切れは「イメージが無い」とみなさない(作り直しに進まない)
|
|
885
|
+
- 名前とラベル: 版の確認は `p3-codex-version-<ランダム>`、評価は `p3-preflight-<ランダム>`、Preflight 以外の頼みごと(リリースノート
|
|
886
|
+
の要約)は `p3-ask-<ランダム>`。ラベルは `infodb.p3=<種類>`(人が `docker ps -a --filter label=infodb.p3` で見分けるため)
|
|
887
|
+
- 片付け: 版の確認は、時間切れ・中止・失敗のときにそのコンテナを消す(正常に終われば `--rm` が消す)。評価のコンテナは、正常・失敗・
|
|
888
|
+
中止・時間切れのどの終わり方でも、終わった後に消す(正常に終わったときは `--rm` の削除の途中のことがあるので、消せなかったときだけ
|
|
889
|
+
記録に出す)。消せない・時間切れなら「残っているかもしれない」と、確かめ方と消し方を run のログに出す(消えたとは断定しない)
|
|
890
|
+
- 中止: 中止すると `turn/interrupt` を送る。app-server が答えなければ 15 秒(`abortGraceMs`)で打ち切り、app-server を閉じ
|
|
891
|
+
(codex-workspace が最長 30 秒待って止める)、コンテナを消す。中止から終わるまで最長でおよそ 1 分。イメージの用意の途中の中止も戻る
|
|
892
|
+
- 限界: Docker のデーモンが止まっている・応答しないときは消せない(記録に残す)。起動の途中で中止して、まだコンテナができていなければ
|
|
893
|
+
消すものは無い。描画のコンテナ(下の「画面イメージの描画のイメージ」)は対象外
|
|
812
894
|
|
|
813
895
|
手元の llmcs の変更を P3 で試すときは、一時的にリンクに替え、試し終えたら公開版に戻す(リンクはコミットしない):
|
|
814
896
|
|
|
@@ -828,7 +910,7 @@ Dockerfile(`src/core/preflight/render-image/`)で作る。llmcs の Dockerfi
|
|
|
828
910
|
Playwright が入っても、それだけでは描画の安全の条件(ネットワークなし・認証情報なし・リポジトリなし・原稿は読むだけ)を
|
|
829
911
|
満たさないので、描画は別のコンテナで行う。
|
|
830
912
|
|
|
831
|
-
- 版: Playwright 1.63.0(Chromium の headless shell)、Node
|
|
913
|
+
- 版: Playwright 1.63.0(Chromium の headless shell)、Node 26(`node:26-bookworm-slim`)、`fonts-noto-cjk`。
|
|
832
914
|
Playwright はイメージの中で npm から入れる(P3 の依存には足さない)。版は公開から1日を過ぎたものに固定する
|
|
833
915
|
- イメージの名前は資材(`Dockerfile`・`fonts-ja.conf`・`render.mjs`。`render.ts` の `RENDER_IMAGE_FILES`)の中身の hash
|
|
834
916
|
(`infodb-p3-render:<12桁>`)。どれかが変われば(フォントの設定だけでも)次の描画で作り直す。
|
|
@@ -874,8 +956,13 @@ Playwright が入っても、それだけでは描画の安全の条件(ネッ
|
|
|
874
956
|
(以前のプロジェクトの `docs` は、名前を付けないと先頭の参照先のパスになり分かりにくかったので外した。構成の説明の
|
|
875
957
|
Markdown `mapFile` も入口と重なるので外した。どちらも保存のときに project.yaml から消す)。
|
|
876
958
|
ドキュメントは古いまま残ることがあるので、今のコードと食い違えば今のコードを正として評価・タスク案を作らせ、見つけた食い違いは
|
|
877
|
-
黙って片方に合わせず、すべてリスクか確認事項に書かせる(`
|
|
959
|
+
黙って片方に合わせず、すべてリスクか確認事項に書かせる(`instructions.ts` の「やること」。過去の記録と今のコードの食い違いも同じ扱い)。
|
|
878
960
|
`preflight.instructions` にはプロジェクト固有の評価の観点・制約を書く。どちらも Codex への指示に加わる。
|
|
961
|
+
`preflight.runner`(`codex` / `agent`。`src/shared/preflightRunner.ts`)は Preflight の担当で、AI 向けの手順が `whoami --json` の
|
|
962
|
+
`preflight` から読む方針(評価のエンジン・run の `engine` とは別。P3 の実行の仕方は変えない)。未設定は `codex`、読めない値は
|
|
963
|
+
`invalidRunner` に残して担当を決めない(保存しても消さない。`config set preflight.runner=` で直す)。保存(`saveProject`)は
|
|
964
|
+
`preflight` を項目ごとに重ねるので、観点だけ・担当だけの更新(以前の API の形 `{ instructions }` も)で、もう片方は消えない。
|
|
965
|
+
個人(マシン)の設定での上書きは設けない。
|
|
879
966
|
|
|
880
967
|
## 共有(同期)の方法
|
|
881
968
|
|
|
@@ -915,16 +1002,18 @@ Playwright が入っても、それだけでは描画の安全の条件(ネッ
|
|
|
915
1002
|
- 作業の単位は要望。タスクは `p3` CLI(入っていなければ `pnpx @infodb/p3`)で操作し、`--json` で結果を読むこと(データのフォルダを直接編集しない)。
|
|
916
1003
|
詳しい手順はスキル `.claude/skills/p3/SKILL.md`(Claude Code)・`.agents/skills/p3/SKILL.md`(Codex)。中身は同じ
|
|
917
1004
|
- 変更するときは環境変数 `P3_ACTOR=ai:<エージェント名>` を付ける
|
|
918
|
-
- 操作する要望は `--req <要望ID>` で指定する(要望の作業ツリーの中なら省ける)。まず `p3 whoami --json`
|
|
1005
|
+
- 操作する要望は `--req <要望ID>` で指定する(要望の作業ツリーの中なら省ける)。まず `p3 whoami --json` で確かめる(Preflight の担当 `preflight.runner` も出る)
|
|
919
1006
|
- `whoami` の `via`(プロジェクトの決まり方)が `cwd` でなければ(`dir` / `project` / `legacy` / `only`)、それ以上 p3 を操作せず、対象のプロジェクトでよいか人に確かめる(推測した `--project` / `--dir` で避けない。人が指定・確認した後はその対象のまま続ける)
|
|
920
1007
|
- プロジェクトが無い・未登録のときは `p3 init` / `p3 join` を自分から実行せず、新しく作る(`init`)のか共有されたものに参加する(`join`)のかを人に確かめる
|
|
921
1008
|
- 新しい作業を頼まれたら `p3 request new "<タイトル>" --body "..."` で要望を登録し、ID を伝えて終える。
|
|
922
|
-
Preflight(`preflight
|
|
1009
|
+
Preflight(`preflight`)は自分から始めない(勧めない・尋ねない)。タスク化(`accept`)は人が行う(結果を `p3 drafts` で読むのと、頼まれたメモの保存 `--note-only` はよい)
|
|
1010
|
+
- Preflight を頼まれたら、担当(`whoami --json` の `preflight.runner`)で分ける。`codex`: 人が `p3 preflight` か画面で実行する(AI は `--prepare` の無い `p3 preflight` をしない)。人がチャットで対象の要望の手元の評価を明示的に頼んだときだけ手元で評価し、「Preflight して」とだけなら、人が実行するのか手元で評価するのかを確かめる。`agent`: 人に「Preflight して」と頼まれたら手元で評価する(「このチャットで」は求めない)。`null`(読めない): `agent` と推測せず `problem` を伝え、`codex` と同じ扱い。子の要望も同じ。対象の要望が分からなければ確かめる
|
|
1011
|
+
- 手元の評価: `p3 preflight <要望ID> --prepare --json` → 返った指示のファイル(`instructions`)を最後まで読み、書くのは返った run の成果物(`outputs`)だけ → `p3 preflight <要望ID> --complete --run <run> --json` → `p3 drafts` の結果を伝えて終える(自分から始めない。タスク化 `accept` と着手はしない)
|
|
923
1012
|
- 着手する前に `p3 show T003 --brief --json` で本文・依存とその状態(`dependencies`)・置き換えの注意(`warnings`)を読む
|
|
924
1013
|
- 着手する前に、`--brief --json` の `work`(作業先のリポジトリとブランチ)を見て、そのリポジトリでブランチに入る(作業先なしなら移動しない)
|
|
925
1014
|
- 着手するときは `p3 move T003 doing`。テストを通したら、コミットする前に `p3 move T003 done --output <今ある成果物(変えたファイルや説明)> --record -` で完了にする(変更の記録は必須: 何を変えたか・なぜ・入れた決まり・やめたもの を標準入力から Markdown で。まだ無い URL は書かない)
|
|
926
1015
|
- 要望のタスクを全部終えたら、コミットする前に `p3 request set <要望ID> status=resolved`(対応済)にする。完了済(done)・見送り(rejected)とタスクの済み(check)は人が決める
|
|
927
|
-
- 子の要望(`parent` のある要望)は、親とは別の要望として子ごとのタスクとブランチで作業する(親のタスクにしない)。分割の案の採用(`accept
|
|
1016
|
+
- 子の要望(`parent` のある要望)は、親とは別の要望として子ごとのタスクとブランチで作業する(親のタスクにしない)。分割の案の採用(`accept`)は人が行う。子の Preflight は親と同じ担当で、頼まれたときだけ(分割の採用・子の作成から自分で評価へ進まない)。親を対応済にするのは、親のタスクと見送り以外の子(`request show <親> --brief --json` の `children`)が全部終わってから
|
|
928
1017
|
- データのフォルダがこの作業ツリーの中で git 管理されているなら、要望のフォルダ(`requests/<要望ID>/`)の変更も実装と同じコミットに入れる(後のレビューで要望とやったことを精査するため。子なら祖先の要望のフォルダ、親を対応済にするときは子孫の要望のフォルダ(見送りの子など)のまだ入っていない変更も入れ、ほかの要望・関係ない変更は入れない。外・無視・worktree のときは入らないので、移動や `git add -f` はしない)。push に失敗したら完了の記録は残し、公開できていないことを伝える。要望のフォルダは、マージするまで要望のブランチにしか無い。既定のブランチに切り替えると、その要望(子なら親の子の一覧からも)が消えたように見えるが、データはブランチにある(作り直したり、別のブランチから写したりしない)
|
|
929
1018
|
- コミットや PR の URL は後から `p3 move T003 done --output <URL>` で足す(完了・記録はそのまま。データをコミットしているなら追記もコミットして push)。複数のリポジトリにまたがるときは最後のタスクに `--repo-output <参照先>=<PR の URL>` で全部の PR を残す
|
|
930
1019
|
- 置き換えられたタスク(`p3 ls` の `※置換`、`--json` の `superseded`)からは始めない。`move` が `warnings` を返したら止めて人に確かめる
|
package/docs/development.md
CHANGED
|
@@ -5,7 +5,7 @@ P3 そのものを開発するときの手順と、ソースの構成。使い
|
|
|
5
5
|
|
|
6
6
|
## このリポジトリから動かす
|
|
7
7
|
|
|
8
|
-
開発には Node
|
|
8
|
+
開発には Node 26 を使う(Docker のイメージと同じ)。使うだけなら Node 24 以上でよい(`engines` は `>=24`)。
|
|
9
9
|
|
|
10
10
|
```bash
|
|
11
11
|
pnpm install
|
|
@@ -64,7 +64,23 @@ pnpm video # 使い方の動画を録り直す(.p3-video/p3-
|
|
|
64
64
|
|
|
65
65
|
個人のスキル(`~/.agents/skills`・`/etc/codex/skills`)と `~/.codex/config.toml` の `[[skills.config]]` に p3 が無いことを先に確かめる。
|
|
66
66
|
Codex がスキルを探す場所は公式の文書(<https://developers.openai.com/codex/skills/> の「Where Codex loads local skills」)
|
|
67
|
+
- 手元の対話エージェントの Preflight(`--prepare` / `--complete`)は、CLI と取り込みを別プロセスのテストで確かめる
|
|
68
|
+
(`test/localPreflight.test.ts`。PATH を空にして Codex・Docker・claude を呼べない状態で通す)。Claude Code が同梱のスキルを見つけて
|
|
69
|
+
担当(`preflight.runner`)どおりに依頼を解釈するか、指示のファイルを読み切るかはテストでは確かめられない。担当で分けた節の書き方の
|
|
70
|
+
契約は `test/agents.test.ts`、agent の親子の prepare → complete → drafts は `test/localPreflight.test.ts` が確かめる。スキルの Preflight の
|
|
71
|
+
節や指示の形を変えたときは、一時フォルダのプロジェクト(`init --agents claude --preflight-runner agent`)を Claude Code で開き、
|
|
72
|
+
親と子の要望を作って「要望 <ID> の Preflight をして」と頼み、prepare → 成果物 → complete → drafts まで進んで accept しないこと、
|
|
73
|
+
依頼の無い登録では始めないことを確かめる。`p3 config set preflight.runner=codex` に変えて、「Preflight して」とだけ頼むと聞き返すこと、
|
|
74
|
+
「このチャットで実行して」と明示すると手元で評価することも確かめる(版と結果はタスクの変更の記録に残す。確かめられなければ未検証と書く)。Claude Code がスキルを読む場所は公式の文書(<https://code.claude.com/docs/en/skills>)
|
|
67
75
|
- CLI のテストは別プロセスで `bin/p3.mjs` を動かし、個人設定を一時フォルダに分け、このマシンの `P3_*` の環境変数は効かないようにしている
|
|
76
|
+
- データのフォルダの監視(`src/core/store/dataWatcher.ts`)は `test/dataWatcher.test.ts` が確かめる。監視の失敗(入れ子の消失・
|
|
77
|
+
読めないエラー・開始の失敗・読み込みの失敗)は監視を差し替えて確実に起こし、ログ・立て直し・続けての失敗でやめること・close の後に
|
|
78
|
+
何も残らないことを見る。実際の監視は、通常の serve を別のプロセスで動かし(`test/fixtures/watchChild.ts`)、`drafts/` を作っては
|
|
79
|
+
消し続けても落ちず、API が答え、close の後に自分で終わることを見る。`--all-projects` で一方の監視が壊れても両方の API と
|
|
80
|
+
Preflight が続くことは `test/allProjects.test.ts`。元の例外(Node 22 の再帰監視の未処理の `'error'`。2026-11-03 に `--all-projects` の
|
|
81
|
+
serve が落ちた)は、Node 22.23.4 では別のプロセスに `drafts/` を作っては消させると再現し、Node 24.22.2・26.13.0 では同じ操作で
|
|
82
|
+
起きなかった(2026-11-03 の記録。261103-fb5z1 / 261103-fx63g)。今の対象の Node(24 以上)では起きないので、毎回の手での確かめは
|
|
83
|
+
しない。`'error'` を必ず聞く守りは残す(Node のほかの監視の失敗でも serve を落とさないため)。退行は差し替えた監視のテストが見る
|
|
68
84
|
- `test/layers.test.ts` が src の層の依存の向き、`test/package.test.ts` が配布物の中身と文書のリンクを確かめる
|
|
69
85
|
- 短い出力の量を測るときは:
|
|
70
86
|
|
|
@@ -208,7 +224,7 @@ test/ ユニットテスト
|
|
|
208
224
|
| 同梱しないもの | `.env`・個人設定・デモデータ(`.p3-demo/`)・テスト・`scripts/`・TypeScript のソース(`src/`)・開発用のスキル(`.claude/`) |
|
|
209
225
|
| 実行時の依存 | `hono`・`@hono/node-server`・`yaml`・`zod`・`@infodb/codex-workspace`・`@infodb/chatgpt-plan`。`tsx`(esbuild)と React などの画面の部品は開発用 |
|
|
210
226
|
| CLI・serve のビルド | `scripts/build-cli.mjs`(`pnpm build` の後半)。`tsc -p tsconfig.build.json` で `src/{cli,core,server,shared}` を同じ深さの `lib/` に 1:1 で出し(相対の import の `.ts` は `.js` に書き換わる)、.ts 以外の資材を同じ場所に写す。`src/` と同じ深さなので、`import.meta.url` からの相対の参照(`../../skills`・`dist/web`・`./mock-ui.html` など)はそのまま効く。資材を足すときは、その層のフォルダに置けば写る。`lib/` は git で追跡しない |
|
|
211
|
-
| Node | `>=
|
|
227
|
+
| Node | `>=24`(`@infodb/codex-workspace`・`@infodb/chatgpt-plan` の `>=22` を満たす)。開発と Docker のイメージは Node 26 |
|
|
212
228
|
| 公開前のビルド | `prepack` で `pnpm build`。利用者が入れるときにはビルドも Docker の操作もしない |
|
|
213
229
|
| bin | `p3`(`bin/p3.mjs`)。`src/cli/main.ts` があるチェックアウトでは tsx でソースを、無ければ(配布物)`lib/cli/main.js` を動かす。ソースを動かすときは今いる場所の `tsconfig.json` を読まない。`INIT_CWD` に戻るのは P3 自身の `pnpm p3` スクリプトのときだけ |
|
|
214
230
|
|
|
@@ -221,10 +237,10 @@ P3_CODEX_PATH_MAP=/workspaces=/home/me/workspaces pnpm verify:pack --docker --re
|
|
|
221
237
|
|
|
222
238
|
## Docker のイメージ
|
|
223
239
|
|
|
224
|
-
`Dockerfile`(Docker Hub の `tamuto/p3`。ビルドは Node
|
|
225
|
-
|
|
240
|
+
`Dockerfile`(Docker Hub の `tamuto/p3`。ビルドは Node 26 と packageManager の pnpm でロックファイルどおりに入れ、`pnpm pack` と同じ中身に実行時の依存だけを
|
|
241
|
+
入れる。実行も Node 26・git・Docker の CLI と buildx。既定は `serve --all-projects --host 0.0.0.0`)と `.dockerignore`
|
|
226
242
|
(git・依存・ビルドの出力・データ・個人設定・認証・テストを入れない)。約束は `test/docker.test.ts` が確かめる。
|
|
227
|
-
ベースの Node
|
|
243
|
+
ベースの Node はメジャー版(ビルドも実行も `node:26-bookworm-slim`。描画のイメージも同じ)だけを指定し、同じメジャーの中の更新(セキュリティ
|
|
228
244
|
リリースなど)は作り直すと入るようにしている。ただし Docker は手元にあるベースをそのまま使う(キャッシュ)ので、作るときは
|
|
229
245
|
`--pull` を付けて今のベースを取る(`scripts/verify-docker.mjs` も付ける。`--no-build` は作らずに既にあるイメージを確かめる)。
|
|
230
246
|
Docker の CLI と pnpm は版を固定し、メジャー版を上げるのは別の変更として行う。作り直しても、公開済みのイメージと起動中の
|
package/docs/how-to-use.md
CHANGED
|
@@ -64,6 +64,20 @@ CLI など画面の外で Preflight を実行したときは、開いている
|
|
|
64
64
|
確かめるのはこの画面を開いて、タブが見えている間だけ。確かめられなかったときは知らせと「もう一度確かめる」が出る
|
|
65
65
|
数分かかることがある。要望は「評価中」→「開始前」になる。
|
|
66
66
|
|
|
67
|
+
**止める・途中で止まった run**: 実行中の run は、画面の「中止」か `p3 preflight <要望> --cancel --run PF-...` で止める(最新でなくても、
|
|
68
|
+
履歴で選んだ run を止められる。成果物・ログは残る)。
|
|
69
|
+
|
|
70
|
+
- この serve で動いている run はすぐ止まる。別の serve・CLI で動いている run には中断を頼み、そのプロセスが止める(数秒待って、
|
|
71
|
+
止まらなければ「中断を頼みました」のまま。`p3 drafts` と画面に「中断を頼んでいます」と出る)
|
|
72
|
+
- serve・CLI が途中で落ちると、run は実行中のまま残る。実行していたプロセスが終わったと確かめられれば、P3 が中断にする(serve を
|
|
73
|
+
開いたとき・次に Preflight を始めるとき・`--cancel` のとき)。要望は評価中から元に戻り、すぐもう一度実行できる(画面には
|
|
74
|
+
「中断した run」と理由が出る)
|
|
75
|
+
- 確かめられない run(以前の版で始めた run、別のマシン・コンテナで始めた run、Docker のコンテナを起動し直す前の run)は、動いて
|
|
76
|
+
いないことを確かめてから、画面の「止まっていることを確かめて中断にする」か `--cancel --run PF-... --acknowledge-stopped` で中断に
|
|
77
|
+
する。記録を残すだけで、プロセスやコンテナは止めない(動いているなら先にそちらを止める)。動いていると分かる run には使えない
|
|
78
|
+
- 完了した run は中断にしない。新しい run があるときに古い run を中断にしても、最新の run と要望の状態は変わらない
|
|
79
|
+
- 再実行のボタンは、表示している run ではなく要望の最新の run で決まる(古い run を見ていても、最新が実行中なら始めない)
|
|
80
|
+
|
|
67
81
|
### 3. 評価とタスク案を読む
|
|
68
82
|
|
|
69
83
|
```bash
|
|
@@ -228,8 +242,32 @@ p3 request set k7m3x status=done # 要望を完了済にする(
|
|
|
228
242
|
| --- | --- |
|
|
229
243
|
| `name` / `description` | 画面の表示と、Preflight の前提(説明が空だと画面に警告を出す) |
|
|
230
244
|
| `instructions`(`preflight.instructions`) | プロジェクト固有の評価の観点・制約。Codex への指示に加わる |
|
|
245
|
+
| `preflight.runner` | Preflight の担当: `codex`(既定。未設定もこれ)か `agent`。下の「Preflight の担当」 |
|
|
231
246
|
| `branchPattern` | 要望のブランチ名(既定 `req/{id}-{slug}`。作業先のリポジトリごとに同じ名前で割り当てる) |
|
|
232
247
|
|
|
248
|
+
#### Preflight の担当
|
|
249
|
+
|
|
250
|
+
誰が Preflight を実行するかを、プロジェクトで1つ決める(`project.yaml` の `preflight.runner`。`p3 init` で尋ね、Enter・`--yes` は
|
|
251
|
+
`codex`)。AI エージェント向けの使い方(スキルと AGENTS.md の節)は `p3 whoami --json` の `preflight.runner` を読んで手順を選ぶ。
|
|
252
|
+
|
|
253
|
+
| 担当 | 向いている環境 | Preflight の実行 |
|
|
254
|
+
| --- | --- | --- |
|
|
255
|
+
| `codex` | Codex(ChatGPT のプランと Docker)を使える | 人が `p3 preflight` か画面から実行し、Codex が評価する。AI は、人が対象の要望の手元の評価をはっきり頼んだときだけ評価する |
|
|
256
|
+
| `agent` | Codex を使えない(準備していない・ChatGPT のプランが無い) | 人がチャットで「Preflight して」と頼むと、手元の AI エージェントが評価する(下の「手元の対話エージェントで Preflight する」) |
|
|
257
|
+
|
|
258
|
+
```bash
|
|
259
|
+
p3 config set preflight.runner=agent # codex に戻すなら preflight.runner=codex
|
|
260
|
+
p3 whoami # Preflight agent(手元の AI エージェントが評価する(頼まれたとき))
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
- どちらでも、AI が自分から Preflight を始めたり勧めたりはしない。タスク化(`accept`)は人が行う。Preflight を通さずにタスクを作る
|
|
264
|
+
道も今までどおり使える
|
|
265
|
+
- 担当は AI 向けの手順を選ぶための方針で、`p3 preflight` のエンジン(このマシンの `preflight.engine`)や `--prepare` / `--complete`
|
|
266
|
+
の動きは変えない。`codex` でも手元の評価はでき、`agent` でも人が `p3 preflight` を実行すれば Codex で評価する
|
|
267
|
+
- 個人(マシン)の設定での上書きは設けない(担当を共有の方針として1つに読めるようにする)。Codex を使えない人が `codex` の
|
|
268
|
+
プロジェクトに参加しているときは、手元の評価をはっきり頼めば同じように評価できる
|
|
269
|
+
- `project.yaml` に読めない値が書いてあると、`whoami` は担当を決めずに(`runner: null`)直し方を出す。AI は `agent` と推測しない
|
|
270
|
+
|
|
233
271
|
マイルストーンは `p3 milestone add|set|rm` か画面のリリースノートの「マイルストーン」タブ(下の「リリースノートの画面」)、参照先は下の「参照先と作業先」。
|
|
234
272
|
|
|
235
273
|
### 参照先と作業先
|
|
@@ -312,6 +350,66 @@ Codex の失敗のどれでも、止まった理由と直し方に並べて、
|
|
|
312
350
|
(5. で採否を選ぶ)。案が既にあるタスクを置き換えるとき(`supersedes`)は、同じ要望の中で人が採否とアーカイブを選ぶ
|
|
313
351
|
(後の「タスクの関係と置き換え」)。自動で置き換えたりまとめたりはしない
|
|
314
352
|
|
|
353
|
+
### 手元の対話エージェントで Preflight する
|
|
354
|
+
|
|
355
|
+
Codex(ChatGPT の接続と Docker)を使えないときは、手元の対話エージェント(Claude Code など)に評価させられる。P3 はモデルを
|
|
356
|
+
呼ばない(`claude -p` や API も使わない)。評価の指示は Codex と同じ原本から P3 が作り、エージェントはそれを読んで run のフォルダに
|
|
357
|
+
成果物を書き、P3 が通常と同じ取り込みをする。タスク化(accept)は今までどおり人が行う。
|
|
358
|
+
|
|
359
|
+
```bash
|
|
360
|
+
p3 preflight k7m3x --prepare --json
|
|
361
|
+
# → run(PF-...)・指示のファイル instructions・成果物のパス outputs・次のコマンド next
|
|
362
|
+
# エージェントが instructions を読み、参照先を調べ、outputs(assessment.json・drafts/ など)を書く
|
|
363
|
+
p3 preflight k7m3x --complete --run PF-... --json # 確かめて取り込む
|
|
364
|
+
p3 drafts k7m3x # 評価とタスク案(人が読む)
|
|
365
|
+
p3 accept k7m3x # 人がタスク化
|
|
366
|
+
```
|
|
367
|
+
|
|
368
|
+
- 準備(`--prepare`)は、評価対象・参照先・親子・添付・メモ・前回の結果を通常の Preflight と同じに固定し、要望を「評価中」にする。
|
|
369
|
+
run は「実行中」(エンジン `local`)のまま、エージェントの評価を待つ。CLI を終えても残り、別のプロセス(画面・別の端末)から
|
|
370
|
+
見える。待っている間は、同じ要望の Preflight(`--prepare`・通常の実行・画面の実行)を始められない
|
|
371
|
+
- 取り込み(`--complete`)は、その run の成果物だけを確かめる: 評価が JSON として読めるか、タスク案・子の案の形(キー・題・依存・
|
|
372
|
+
作業先・混在)、成果物がシンボリックリンクでないか。問題があれば何も確定せず理由を出し(`--json` では `code: invalid_result` と
|
|
373
|
+
`problems`、終了コード 1)、run は待ったまま。直して同じ `--complete` をやり直す。取り込み済みの run にもう一度 `--complete` しても
|
|
374
|
+
何も変えない(`already: true`)
|
|
375
|
+
- 画面イメージの原稿(`ui/src/*.html`)があるときだけ、取り込みのときに P3 が描画のコンテナ(Docker)で PNG にする。Docker が
|
|
376
|
+
使えなくても評価は残し、必要な画面イメージが足りなければ go を clarify にする(Codex のときと同じ)。原稿が無ければ Docker は使わない
|
|
377
|
+
- やめるとき・放置した run は `p3 preflight <要望> --cancel --run PF-...`(取り消し。成果物のファイルは残る)。要望の状態は元に戻る。
|
|
378
|
+
手元のエージェントの run は、P3 がプロセスの終わりを見て中断にすることはない(プロセスを跨いで評価を待つため)
|
|
379
|
+
どの run が待っているかは `p3 drafts <要望>`(最新の run)か、始められなかったときのメッセージに出る
|
|
380
|
+
- 評価のあとで要望を変えたら、通常の Preflight と同じくその評価からはタスク化できない(後の「要望の本文を変えたとき」)
|
|
381
|
+
- 手元のエージェントにはコンテナの囲いが無い。参照先を読むだけにすること・書き込みを run の成果物に限ることは指示で伝えるだけで、
|
|
382
|
+
P3 は止められない(エージェントの権限の設定で守る)。どの程度の利用枠を使うかはエージェント側の契約による
|
|
383
|
+
|
|
384
|
+
**Claude Code のチャットで頼む**: 上の手順は、同梱のスキル(`.claude/skills/p3/SKILL.md`。後の「AI エージェントから使う」)に書いてある。
|
|
385
|
+
頼み方はプロジェクトの Preflight の担当(上の「Preflight の担当」)で変わる。エージェントは `p3 whoami --json` で担当を読む。
|
|
386
|
+
|
|
387
|
+
```text
|
|
388
|
+
# 担当が agent のとき(Codex を使えない環境): 対象の要望を挙げて頼めばよい
|
|
389
|
+
要望 261009-k7m3x の Preflight をして
|
|
390
|
+
|
|
391
|
+
# 担当が codex のとき: 手元で評価してほしいことをはっきり頼む(「Preflight して」とだけ頼むと、p3 で実行するのか手元で評価するのかを聞き返す)
|
|
392
|
+
要望 261009-k7m3x の Preflight を Claude Code のこのチャットで実行して
|
|
393
|
+
```
|
|
394
|
+
|
|
395
|
+
- どちらの担当でも、エージェントは評価を取り込んで `p3 drafts` の要約を伝えたところで止まる。タスク化(`accept`)と着手は人が案を
|
|
396
|
+
確かめてから。要望の登録やタスクの作業のついでに、エージェントから Preflight を始めたり勧めたりはしない。子の要望も同じ
|
|
397
|
+
- 担当を変えても、置いたスキルと AGENTS.md の節は置き直さなくてよい(実行のたびに `whoami` で読む)。以前の版のスキルを置いている
|
|
398
|
+
リポジトリは、`p3 agents claude|codex|both` で同梱の版との違いを確かめ、最新にするなら選んだ先だけ `--force` で置き換える
|
|
399
|
+
(ほかの文は残す。後の「AI エージェントから使う」)
|
|
400
|
+
|
|
401
|
+
- Claude Code はスキルに従って `--prepare` → 指示のファイルを読んで評価し、成果物を書く → `--complete` → `p3 drafts` の要約を返す、
|
|
402
|
+
までを同じチャットで行う。タスク化(`accept`)とタスクの着手はしない(人が `p3 drafts` か画面で案を確かめてから `p3 accept`)。
|
|
403
|
+
明示の依頼が無ければ(要望の登録だけなど)Preflight は始めない
|
|
404
|
+
- 要るもの: `p3` の CLI を実行できること(Bash)、データのフォルダと参照先を読めること、run のフォルダに書けること。データのフォルダや
|
|
405
|
+
参照先がリポジトリの外にあるなら、Claude Code に読む場所として足す(`/add-dir <フォルダ>`・起動時の `--add-dir`・設定の
|
|
406
|
+
`permissions.additionalDirectories`)。足さなければ、外のファイルを読む・書くたびに許可を求められる。参照先に書かせない設定
|
|
407
|
+
(`permissions.deny` の `Edit(...)` など)にしておくと、指示だけに頼らずに済む
|
|
408
|
+
- スキルは、置いた後なら会話の途中でも読み直される。既に古いスキルを置いたプロジェクトは `p3 agents claude` で違いを確かめ、手で
|
|
409
|
+
直していなければ `p3 agents claude --force` で最新にする(後の「AI エージェントから使う」)
|
|
410
|
+
- P3 は `claude -p` も API キーも使わない。今の対話セッションでエージェントが調べて書くので、Claude Code の契約の利用枠を使う
|
|
411
|
+
(無料になるわけではない)。いつもの Codex の Preflight(Docker・ChatGPT)とは別の経路で、どちらで評価した run も同じに読める(エンジンは `local`)
|
|
412
|
+
|
|
315
413
|
### 要望の本文を変えたとき
|
|
316
414
|
|
|
317
415
|
要望のタイトル・本文は、いつでも書き換えられる(画面の「本文を編集」→「本文を保存」、CLI の `request set`)。
|
|
@@ -745,6 +843,6 @@ AI にも CLI を使わせる(認証を持たせずに済む)。`p3 init --a
|
|
|
745
843
|
| `p3 request new\|ls\|show\|set\|archive` | 要望 |
|
|
746
844
|
| `p3 ls` / `p3 show` / `p3 find` | タスクの一覧(`--all` で全要望)/ 詳細(`--brief`)/ 参照・タイトルで探す |
|
|
747
845
|
| `p3 new` / `p3 set` / `p3 move` / `p3 check` / `p3 archive` | タスクを足す / 直す / 状態を変える / 済みにする / アーカイブ |
|
|
748
|
-
| `p3 preflight` / `p3 notes` / `p3 drafts` / `p3 accept` | Preflight の実行(`--note`)/ メモ / 評価とタスク案 / タスク化 |
|
|
846
|
+
| `p3 preflight` / `p3 notes` / `p3 drafts` / `p3 accept` | Preflight の実行(`--note`。手元のエージェントなら `--prepare` / `--complete`。中断は `--cancel --run`)/ メモ / 評価とタスク案 / タスク化 |
|
|
749
847
|
| `p3 attach` / `p3 render` | 添付 / 画面イメージの描画 |
|
|
750
848
|
| `p3 chatgpt` / `p3 codex update` / `p3 serve` | ChatGPT の接続 / Codex のイメージ / 画面(`--all-projects` で登録したプロジェクトを跨ぐ) |
|
package/docs/installation.md
CHANGED
|
@@ -8,13 +8,14 @@ P3 の Preflight は、Codex を **Docker のコンテナの中で** 動かす
|
|
|
8
8
|
|
|
9
9
|
Docker と ChatGPT の接続が要るのは Preflight(Codex)・リリースノートの要約の生成・画面イメージの描画だけで、要望・タスク・
|
|
10
10
|
変更の記録・マイルストーンの管理と、リリースノートを手で書いて保存することは無くても動く。Docker を用意できない・Preflight が止まる間も、Preflight を通さずにタスクを作って進められる
|
|
11
|
-
([使い方ガイド: Preflight を通さずにタスクを作る](how-to-use.md#preflight-を通さずにタスクを作る))。
|
|
11
|
+
([使い方ガイド: Preflight を通さずにタスクを作る](how-to-use.md#preflight-を通さずにタスクを作る))。Preflight を Claude Code などの手元の対話エージェントに
|
|
12
|
+
頼むなら Docker と ChatGPT は要らない(画面イメージの描画だけ Docker を使う。[使い方ガイド: 手元の対話エージェントで Preflight する](how-to-use.md#手元の対話エージェントで-preflight-する))。
|
|
12
13
|
|
|
13
14
|
## 全体の流れ
|
|
14
15
|
|
|
15
16
|
| # | すること | 終わったと分かる目安 |
|
|
16
17
|
| --- | --- | --- |
|
|
17
|
-
| 1 | 必要なものをそろえる | `node -v` が
|
|
18
|
+
| 1 | 必要なものをそろえる | `node -v` が 24 以上(推奨 26)、`git --version`、`docker version` が通る |
|
|
18
19
|
| 2 | どこで P3 を動かすか決める(ホスト / DevContainer) | 下の「動かす場所」のどちらかに当てはまる |
|
|
19
20
|
| 3 | Docker に繋がるか確かめる | `docker version` に **Client と Server の両方** が出る |
|
|
20
21
|
| 4 | プロジェクトを作る(か参加する) | `p3 whoami` にプロジェクトとデータのフォルダが出る |
|
|
@@ -29,14 +30,19 @@ P3 を Docker のコンテナで動かす(プロジェクトを跨ぐ serve
|
|
|
29
30
|
|
|
30
31
|
| もの | 何に使う | 確かめ方 |
|
|
31
32
|
| --- | --- | --- |
|
|
32
|
-
| Node.js
|
|
33
|
+
| Node.js 24 以上(推奨 26) | P3 本体(CLI と `p3 serve`) | `node -v` |
|
|
33
34
|
| pnpm(`pnpx`)か npm(`npx`) | P3 を入れずに動かす。`pnpm add -g @infodb/p3` / `npm i -g @infodb/p3` で `p3` コマンドにしてもよい | `pnpm -v` / `npm -v` |
|
|
34
35
|
| Git | 管理したいリポジトリと、要望ごとのブランチ。Preflight の Codex も履歴を読む | `git --version` |
|
|
35
36
|
| Docker(CLI とデーモン) | Preflight の Codex を、リポジトリとデータのフォルダだけを見せたコンテナの中で動かす。画面イメージの描画にも使う | `docker version`(下の 3.) |
|
|
36
37
|
| ChatGPT のアカウント(プラン) | Preflight の Codex をその人のアカウントで動かす | 6. で接続する |
|
|
37
38
|
|
|
38
39
|
- Codex をこのマシンに入れる必要はない(コンテナのイメージに入れる)。画面はビルド済みのものが入っているので、ビルドも要らない
|
|
39
|
-
- P3
|
|
40
|
+
- P3 そのものを開発するときと、Docker のイメージ(`tamuto/p3`・描画のイメージ)は Node 26 を使う([開発ガイド](development.md))。
|
|
41
|
+
使うだけなら 24 以上でよい
|
|
42
|
+
- **Node 22 から上げるとき**: Node 22 はサポートの終わり(2027-04-30)が近いので、この版から P3 は Node 24 以上で動かす(`engines` は
|
|
43
|
+
`>=24`)。Node 22 のままでも止められるとは限らない: npm は入れるときに警告(`EBADENGINE`)を出して入れ、`engine-strict=true`
|
|
44
|
+
なら断る。pnpm(12.10 で確かめた)と `pnpx` は警告を出さずに入れて動かす。`node -v` を確かめ、24 以上(推奨 26)に上げてから入れ直す。Docker で動かしているなら、新しいイメージを `docker pull` してコンテナを作り直す
|
|
45
|
+
(起動し直すだけでは前のイメージの Node のまま)
|
|
40
46
|
- 以下の例では `p3` と書く。入れていなければ `pnpx @infodb/p3`(または `npx @infodb/p3`)に読み替える
|
|
41
47
|
- 同じデータを使う人と AI は、なるべく同じ版で動かす(`pnpx @infodb/p3@<版>` のように版を付けられる。`pnpx` は取った版をしばらく
|
|
42
48
|
使い続ける)。古い版で更新すると、新しい版で足した項目が消えることがある([データの形](architecture.md#データの形))
|
|
@@ -94,12 +100,16 @@ p3 init --agents
|
|
|
94
100
|
# 何を作っているプロジェクトか(Preflight の前提になります): 社内向けの経費精算アプリ
|
|
95
101
|
# 最初に読むドキュメント(カンマ区切り。Preflight が評価の前に読みます) [docs, README.md]:
|
|
96
102
|
# Preflight で重視する観点・制約(任意): 個人情報を扱う変更は必ずリスクに挙げる
|
|
103
|
+
# Preflight を実行するのは(codex: 人が p3 から Codex で実行 / agent: 頼まれた手元の AI エージェントが評価) [codex]:
|
|
97
104
|
|
|
98
105
|
# AI やスクリプトからは引数で(--yes で質問しない。--dir を付けなければリポジトリのルートの .p3)
|
|
99
106
|
p3 init --yes --agents --project myapp --description "社内向けの経費精算アプリ"
|
|
100
107
|
|
|
101
108
|
# リポジトリの外に置くなら --dir で指定する
|
|
102
109
|
p3 init --yes --agents --project myapp --dir ~/p3-data/myapp --description "社内向けの経費精算アプリ"
|
|
110
|
+
|
|
111
|
+
# Codex(ChatGPT のプラン)を使わず、Claude Code などの手元のエージェントに Preflight を頼むなら
|
|
112
|
+
p3 init --yes --agents claude --project myapp --preflight-runner agent --description "社内向けの経費精算アプリ"
|
|
103
113
|
```
|
|
104
114
|
|
|
105
115
|
- データのフォルダには `project.yaml` と空の `requests/` ができる。このリポジトリは **本体の参照先**(Preflight が読むリポジトリ。
|
|
@@ -112,6 +122,11 @@ p3 init --yes --agents --project myapp --dir ~/p3-data/myapp --description "社
|
|
|
112
122
|
(値を省くと both。付けなければ置かない。対話では聞き、Enter は置かない)。置いたファイルはリポジトリに入れて共有する。
|
|
113
123
|
作った後から置く・最新にするのは `p3 agents`([使い方ガイド](how-to-use.md) の「AI エージェントから使う」。`init --agents` を
|
|
114
124
|
既にあるプロジェクトで実行し直しても置かない)
|
|
125
|
+
- **Preflight の担当**(`preflight.runner`。共有の設定)を決める。`codex`(既定。Enter と `--yes` もこれ)は人が `p3 preflight` や
|
|
126
|
+
画面から実行し、Codex が評価する(6. と 7. が要る)。`agent` は Codex を使えない環境(Codex を準備していない・ChatGPT のプランが
|
|
127
|
+
無い)向けで、人がチャットで「Preflight して」と頼むと手元の AI エージェントが評価する(6. と 7. は要らない。画面イメージの描画
|
|
128
|
+
だけ Docker を使う)。後から `p3 config set preflight.runner=agent|codex` で変えられる([使い方ガイド](how-to-use.md) の
|
|
129
|
+
「プロジェクトの設定」)
|
|
115
130
|
- 登録はこのマシンの **個人設定**(`~/.config/infodb-p3/config.yaml`。`XDG_CONFIG_HOME` があればその下。共有しない)に入る
|
|
116
131
|
|
|
117
132
|
### 参加する(ほかの人が作ったプロジェクト)
|
|
@@ -132,7 +147,7 @@ p3 join --project myapp --dir ~/p3-data/myapp # リポジトリの外の
|
|
|
132
147
|
決まらなければ登録せず、`p3 repo ls` と `p3 repo path <名前> <パス>` を案内する
|
|
133
148
|
- データのフォルダが無い・`project.yaml` が無い・壊れている・読めないときは、理由を出して止まり、何も登録しない(作りもしない。
|
|
134
149
|
新しく作るなら `init`)。同じ名前で別のフォルダは断る。同じ参加をもう一度しても何も変えない
|
|
135
|
-
- `--agents` と、作るときだけの項目(`--name`・`--description`・`--instructions`)は使えない(共有の定義を変えるなら `p3 config set`)
|
|
150
|
+
- `--agents` と、作るときだけの項目(`--name`・`--description`・`--instructions`・`--preflight-runner`)は使えない(共有の定義を変えるなら `p3 config set`)
|
|
136
151
|
|
|
137
152
|
確かめる:
|
|
138
153
|
|
|
@@ -143,6 +158,7 @@ p3 whoami
|
|
|
143
158
|
# 今いる参照先 myapp ブランチ main
|
|
144
159
|
# 変更者 human:<git の user.name>
|
|
145
160
|
# 要望 (なし)
|
|
161
|
+
# Preflight codex(人が p3 から実行する(Codex))
|
|
146
162
|
```
|
|
147
163
|
|
|
148
164
|
プロジェクトが決まらないと、登録済みの一覧と選び方(`--project <名前>`)が出る。リポジトリの外で使うときや、複数のプロジェクトに
|
|
@@ -261,7 +277,8 @@ DevContainer で「対応あり」にならなければ 5. を見直す。評価
|
|
|
261
277
|
失敗はログとエラーに **次にすること** を添えて出す。直して、もう一度同じ操作をする。
|
|
262
278
|
|
|
263
279
|
Preflight を使えない・失敗したとき(Docker・ChatGPT の接続・使用量の上限など、理由によらない)は、概要ページ・失敗した run・
|
|
264
|
-
CLI の出力に、Preflight を通さずにタスクを作る道も出る。直すまでの間はそれで進めてよい([使い方ガイド: Preflight を通さずにタスクを作る](how-to-use.md#preflight-を通さずにタスクを作る))。
|
|
280
|
+
CLI の出力に、Preflight を通さずにタスクを作る道も出る。直すまでの間はそれで進めてよい([使い方ガイド: Preflight を通さずにタスクを作る](how-to-use.md#preflight-を通さずにタスクを作る))。Preflight を Claude Code などの手元の対話エージェントに
|
|
281
|
+
頼むなら Docker と ChatGPT は要らない(画面イメージの描画だけ Docker を使う。[使い方ガイド: 手元の対話エージェントで Preflight する](how-to-use.md#手元の対話エージェントで-preflight-する))。
|
|
265
282
|
|
|
266
283
|
| どこで | 出るもの | 確かめる | 直す |
|
|
267
284
|
| --- | --- | --- | --- |
|
|
@@ -270,6 +287,7 @@ CLI の出力に、Preflight を通さずにタスクを作る道も出る。直
|
|
|
270
287
|
| 〃 | `permission denied ... docker.sock` | `ls -l /var/run/docker.sock` | `docker` グループなど、ソケットの権限を直す |
|
|
271
288
|
| Preflight | `bind source path does not exist: <参照先 …>` / `<データ>` | ログの「パスの対応」、`p3 user-config` の `codex.pathMap`、5-1. の `docker inspect` | `p3 user-config set codex.pathMap+=<このマシンのパス>=<ホストのパス>`。「対応あり」なのに無いなら、右側(ホストのパス)の誤り。serve はそのままで次の Preflight から効く |
|
|
272
289
|
| Preflight | 「Codex のイメージを用意できません(app-server を起こす前)」 | `p3 codex update` の出力 | ネットワーク(プロキシ)を確かめて `p3 codex update` をやり直す。`Unable to find image` も同じ |
|
|
290
|
+
| Preflight | 「〜が 60 秒で終わらないので止めました」(イメージの確認 15 秒・版の確認 60 秒・ビルド 10 分) | `docker ps -a --filter label=infodb.p3`(P3 が起こしたコンテナ) | P3 はそのコンテナを消してから終わる。Docker が重い・止まっていないかを確かめてやり直す。「コンテナ p3-… を消せませんでした(残っているかもしれません)」と出たら、出ている `docker rm -f <名前>` で消す |
|
|
273
291
|
| Preflight・画面 | 「ChatGPT にサインインしてください」「ChatGPT の接続が切れています」「プランの利用が許可されていません」 | `p3 chatgpt status` | `p3 chatgpt login`(届かなければ `--paste`)。プランの利用に同意する |
|
|
274
292
|
| Preflight | 「Usage limit reached」 | ChatGPT の Manage usage(https://chatgpt.com/settings/usage) | 上限が戻るのを待つ |
|
|
275
293
|
| Preflight・画面 | 個人設定を読めない(YAML の行と直すファイル) | `~/.config/infodb-p3/config.yaml` | 書き間違いを直す。serve はそのままで次の Preflight から効く |
|
|
@@ -303,13 +321,13 @@ P3 をイメージにして、コンテナで動かすこともできる。イ
|
|
|
303
321
|
--host 0.0.0.0`)で、個人設定に登録したプロジェクトを画面で選んで扱う([使い方ガイド](how-to-use.md#画面))。閲覧専用ではなく、
|
|
304
322
|
要望・タスクの作成と編集・添付・Preflight もいつもどおり使える。
|
|
305
323
|
|
|
306
|
-
イメージは Docker Hub の **`tamuto/p3`**。中に p3 本体(npm の `@infodb/p3` と同じ版・同じ中身)と、Node
|
|
307
|
-
入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.
|
|
324
|
+
イメージは Docker Hub の **`tamuto/p3`**。中に p3 本体(npm の `@infodb/p3` と同じ版・同じ中身)と、Node 26・git・Docker の CLI が
|
|
325
|
+
入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.10.0` など)と
|
|
308
326
|
`latest` がある。決まった版で使うなら版のタグを指す。対応する platform は `linux/amd64` だけ(arm64 は確かめるマシンが無いので
|
|
309
327
|
作っていない)。
|
|
310
328
|
|
|
311
329
|
```bash
|
|
312
|
-
docker pull tamuto/p3:0.
|
|
330
|
+
docker pull tamuto/p3:0.10.0
|
|
313
331
|
```
|
|
314
332
|
|
|
315
333
|
リポジトリから作るときは `docker build --pull -t tamuto/p3:dev .`(`--pull` で今の Node のベースを取る。[開発ガイド](development.md#docker-のイメージ))。
|
|
@@ -330,7 +348,7 @@ root で動く開発コンテナ(DevContainer など)で p3 の CLI を使
|
|
|
330
348
|
# 開発コンテナの compose に足す例(パスは開発コンテナのマウントに合わせる)
|
|
331
349
|
services:
|
|
332
350
|
p3:
|
|
333
|
-
image: tamuto/p3:0.
|
|
351
|
+
image: tamuto/p3:0.10.0
|
|
334
352
|
restart: unless-stopped
|
|
335
353
|
ports:
|
|
336
354
|
- "127.0.0.1:4310:4310"
|
|
@@ -354,7 +372,7 @@ docker run -d --name p3 --restart unless-stopped \
|
|
|
354
372
|
-v ~/.config/infodb-p3:/root/.config/infodb-p3 \
|
|
355
373
|
-v /home/me/work:/home/me/work \
|
|
356
374
|
-v /var/run/docker.sock:/var/run/docker.sock \
|
|
357
|
-
tamuto/p3:0.
|
|
375
|
+
tamuto/p3:0.10.0
|
|
358
376
|
|
|
359
377
|
# 登録が無ければ、コンテナの中で登録する(既にあるデータに参加する。新しく作るなら p3 init)
|
|
360
378
|
docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
|
|
@@ -367,7 +385,7 @@ docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
|
|
|
367
385
|
### どちらでも
|
|
368
386
|
|
|
369
387
|
- 待ち受けは `127.0.0.1` に公開する。ブラウザで http://localhost:4310 を開く。登録が1つならそのプロジェクトが開き、複数なら一覧から選ぶ
|
|
370
|
-
- **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.
|
|
388
|
+
- **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.10.0 serve --project myapp --host 0.0.0.0`。compose なら
|
|
371
389
|
`command:`)。明示しない限り、コンテナの中かどうかで自動では切り替えない
|
|
372
390
|
- **止める**: `docker stop p3`(SIGTERM。実行中の Preflight・生成を取り消して記録してから止まる。10 秒まで待つ)
|
|
373
391
|
- **新しい版にする**: 版のタグを変えて作り直す(個人設定と接続はマウントした ~/.config、データはホストに残る)。
|
package/docs/publishing.md
CHANGED
|
@@ -30,7 +30,11 @@ node scripts/verify-pack.mjs --docker # npm pack → 実行時の依存だ
|
|
|
30
30
|
- [ ] 全段が `ok`。確かめる段: Node の版と engines / tarball の中身 / `npm install`(開発用の依存が入らない)/
|
|
31
31
|
別のリポジトリで `init --agents`・`init --agents codex` と `p3 agents`(後から足す・`--force`)・`whoami`・要望の作成・Mock の Preflight・メモを足した再評価・`serve`(画面・資産・API)/
|
|
32
32
|
`codex update`(`--docker`。未登録・未認証のまま本物の Docker でイメージを作り直し、版を読む)
|
|
33
|
-
- [ ] 下限の Node
|
|
33
|
+
- [ ] 下限の Node(24.0.0)でも、作った tarball で通す(開発用の依存のインストールとビルドは下限の版で要らない):
|
|
34
|
+
`PATH=$(dirname $(npx -y node@24.0.0 -e "console.log(process.execPath)")):$PATH node scripts/verify-pack.mjs --tgz <作った tarball>`
|
|
35
|
+
- [ ] Node の下限を上げた版を出すときは、リリースノートに知らせる: 前の下限の Node では、npm は警告を出して入れ(`engine-strict` なら断る)、
|
|
36
|
+
pnpm・`pnpx` は警告を出さずに入れる(止められない)ので、利用者が `node -v` を確かめること、
|
|
37
|
+
Node を上げて入れ直すこと、Docker のイメージは pull してコンテナを作り直すこと(Node 22 → 24 以上は [導入ガイド](installation.md) の「Node 22 から上げるとき」)
|
|
34
38
|
- [ ] Docker が無い環境で確かめたときは、`codex update` の段が「実行していない」と出る。その場合は Docker のある環境で
|
|
35
39
|
`--docker` を付けて通すまで、公開に進まない
|
|
36
40
|
|
package/lib/cli/args.js
CHANGED
|
@@ -46,10 +46,15 @@ const OPTIONS = {
|
|
|
46
46
|
repo: { type: "string" },
|
|
47
47
|
description: { type: "string" },
|
|
48
48
|
instructions: { type: "string" },
|
|
49
|
+
"preflight-runner": { type: "string" },
|
|
49
50
|
// 値なしの --agents は both(joinValues が --agents=both にする)
|
|
50
51
|
agents: { type: "string" },
|
|
51
52
|
force: { type: "boolean" },
|
|
52
53
|
"note-only": { type: "boolean" },
|
|
54
|
+
prepare: { type: "boolean" },
|
|
55
|
+
"acknowledge-stopped": { type: "boolean" },
|
|
56
|
+
complete: { type: "boolean" },
|
|
57
|
+
cancel: { type: "boolean" },
|
|
53
58
|
"archive-superseded": { type: "boolean" },
|
|
54
59
|
paste: { type: "boolean" },
|
|
55
60
|
"no-browser": { type: "boolean" },
|
package/lib/cli/help.js
CHANGED
|
@@ -9,13 +9,15 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
|
|
|
9
9
|
このリポジトリを本体の参照先として登録する。データの既定はリポジトリのルートの .p3(既にあれば作らずに断る → join)
|
|
10
10
|
--project 名前 --dir フォルダ(外に置くとき。相対は今いる場所から)--repo-name 参照先の名前(既定はフォルダ名)--description
|
|
11
11
|
--instructions 観点 --yes
|
|
12
|
+
--preflight-runner codex|agent Preflight の担当(既定 codex: 人が p3 から Codex で実行 / agent: 頼まれた手元の AI エージェントが評価)
|
|
12
13
|
--agents claude|codex|both AI 向けの使い方(スキルと AGENTS.md / CLAUDE.md の節)を置く先(値を省くと both。付けなければ置かない)
|
|
13
14
|
agents claude|codex|both [--force] AI 向けの使い方を、今いるリポジトリに後から置く・最新にする(選んだ先だけ。データ・個人設定は変えない)
|
|
14
15
|
違うものは上書きせず知らせる。--force で選んだ先のスキルと p3 の節だけを同梱の版にする(ほかの文は残す)
|
|
15
16
|
join 既にあるプロジェクト(共有されたデータのフォルダ)に参加する。個人設定に登録するだけで、データ・リポジトリのファイルは変えない
|
|
16
17
|
--project 名前 --dir フォルダ(既定はリポジトリのルートの .p3)--repo-name 参照先の名前(共有の定義にあるもの)--yes
|
|
17
18
|
project [ls | add <名前> <フォルダ> | rm <名前>] 個人設定のプロジェクト
|
|
18
|
-
config [set キー=値 ...] 設定の表示・変更(name description branchPattern instructions)
|
|
19
|
+
config [set キー=値 ...] 設定の表示・変更(name description branchPattern instructions preflight.runner)
|
|
20
|
+
preflight.runner=codex|agent Preflight の担当(共有。未設定は codex。p3 preflight の動きは変えず、AI 向けの手順が whoami で読む)
|
|
19
21
|
repo [ls | add | set | path | rm] Preflight が読む参照先(リポジトリ・フォルダ。数と名前は自由)
|
|
20
22
|
add <名前> [<パス>] [role=… readFirst=true writable=true] 共有の定義を足す
|
|
21
23
|
set <名前> キー=値 … 共有の定義を変える / path <名前> <パス> このマシンのパスだけ登録
|
|
@@ -85,6 +87,13 @@ Preflight
|
|
|
85
87
|
preflight [<要望>] 評価・細分化を実行し、完了まで待つ --engine codex|mock
|
|
86
88
|
前回の結果とまだ渡していないメモを引き継ぐ
|
|
87
89
|
--note 本文|- メモ(確認事項への回答・方針の変更)を書き足してから実行 --note-only 書くだけ
|
|
90
|
+
preflight [<要望>] --prepare 手元の対話エージェント(Claude Code など)で評価する準備。モデルは呼ばない。評価対象を固定し、
|
|
91
|
+
指示のファイル(instructions.md)と成果物のパス・run の ID を返して終わる(--note も使える)
|
|
92
|
+
preflight [<要望>] --complete --run PF-... エージェントが書いた成果物を確かめて取り込む(問題があれば何も確定せず、直してやり直せる)
|
|
93
|
+
preflight [<要望>] --cancel --run PF-... run を中断する(最新でなくてもよい。手元のエージェントの run は評価を待つのをやめる。
|
|
94
|
+
Codex / Mock の run は、動いているプロセスに中断を頼み、止まるまで少し待つ。止まらなければ requested)
|
|
95
|
+
--acknowledge-stopped 動いているか確かめられない run(以前の版・別の環境)を、止まっていることを確かめて中断にする
|
|
96
|
+
(記録だけ。プロセスやコンテナは止めない)
|
|
88
97
|
notes [<要望>] メモの一覧(次の Preflight に渡すもの・渡し済み)
|
|
89
98
|
attach [ls] 要望の添付(PNG / JPEG / xlsx)の一覧。要望は --req(要望の作業ツリーの中なら省略可)
|
|
90
99
|
attach add <ファイル> 添付を足す --description 説明 --source 出典。次の Preflight を始めるときに run に固定して渡す
|