@infodb/p3 0.7.0 → 0.9.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 +1 -0
- package/docs/architecture.md +25 -1
- package/docs/development.md +6 -0
- package/docs/how-to-use.md +50 -1
- package/docs/installation.md +9 -7
- package/lib/cli/args.js +3 -0
- package/lib/cli/help.js +4 -0
- package/lib/cli/preflightCommands.js +74 -2
- package/lib/cli/project.js +1 -0
- package/lib/core/context.js +1 -1
- package/lib/core/preflight/codexEngine.js +8 -207
- package/lib/core/preflight/instructions.js +263 -0
- package/lib/core/preflight/service.js +297 -84
- package/lib/core/preflight/uiRender.js +1 -1
- package/lib/shared/scopeView.js +3 -2
- package/package.json +1 -1
- package/skills/p3/SKILL.md +29 -3
package/README.md
CHANGED
|
@@ -27,6 +27,7 @@
|
|
|
27
27
|
| ChatGPT のアカウント(プラン) | Preflight の Codex をその人のアカウントで動かす |
|
|
28
28
|
|
|
29
29
|
Docker と ChatGPT が無くても、要望・タスクの管理は使える(Preflight を通さずにタスクを作る。[使い方ガイド](docs/how-to-use.md#preflight-を通さずにタスクを作る))。
|
|
30
|
+
Preflight も、Claude Code などの手元の対話エージェントのチャットで頼んで代わりに評価させられる([使い方ガイド](docs/how-to-use.md#手元の対話エージェントで-preflight-する))。
|
|
30
31
|
|
|
31
32
|
## 最短の手順
|
|
32
33
|
|
package/docs/architecture.md
CHANGED
|
@@ -689,7 +689,7 @@ CLI は `cli/main.ts`(振り分け・プロジェクトと変更者の決定
|
|
|
689
689
|
- 実行中も「メモだけ保存」はでき、実行中の評価ではなく次の Preflight に渡る。保存してから始められなかったときは、保存済みと
|
|
690
690
|
伝え、書き直さずに再実行できる。過去の run を表示していても、引き継ぎ元は直近の run なので、何を引き継ぐかを入力欄の上に出す。
|
|
691
691
|
run ごとに、引き継いだ前回の run(クリックで移る)と渡したメモを表示する
|
|
692
|
-
- 過去の経緯は p3 が選ばず、Codex が調べる(`
|
|
692
|
+
- 過去の経緯は p3 が選ばず、Codex が調べる(`instructions.ts` の `historySection`)。以前は TF-IDF と areas(パス)の
|
|
693
693
|
重なりで選んだ10件を渡していたが、リファクタリングでパスが変わる・ファイルを分割すると外れ、読み替えの表では分割や
|
|
694
694
|
移動の繰り返しを扱えない。git は行ごとに履歴を追え(`blame -C -M`)、マージのコミットのブランチ名に要望 ID があるので、
|
|
695
695
|
コード → コミット → 要望 → `/data` の記録と辿れる。p3 を入れる前の経緯も分かる。全件はプロンプトに入れず、Codex が
|
|
@@ -702,6 +702,27 @@ CLI は `cli/main.ts`(振り分け・プロジェクトと変更者の決定
|
|
|
702
702
|
追加で許す保証ではない。コマンドの実行は禁止していない。参照先は読むだけのマウントで書けない。データのフォルダ(`/data`)は
|
|
703
703
|
書けるマウントなので、「run の中だけ」は指示と事後の警告で守っている(書き込みを run に閉じ込める囲いは今は無い)。
|
|
704
704
|
画面イメージの描画は、この Codex のコンテナではなく別のコンテナで行う
|
|
705
|
+
- 指示(制約 = Codex の `developerInstructions` と、依頼文)は `src/core/preflight/instructions.ts` の1か所で作る。評価の観点・
|
|
706
|
+
履歴の調べ方・分割・出力の形・画面の原稿の書き方の原本はここだけに置き、エンジンごとに複製しない。実行環境ごとに違うのは
|
|
707
|
+
パスと「何が強制されているか」だけで、`InstructionEnv` として注入する:
|
|
708
|
+
- `containerEnv`(Codex): 参照先は `/workspace/<mount>`、データは `/data`。書き込みは run の配下だけ、と指示する
|
|
709
|
+
- `localEnv`(手元の対話エージェント。Claude Code など): 参照先・データ・run はこのマシンの実パス。コマンドに埋めるパスは
|
|
710
|
+
空白などを含むときだけ引用符で囲む。制約と依頼文は run のフォルダの `instructions.md`(`localInstructions`。制約を先に置き、
|
|
711
|
+
資料の中の指示より優先すると書く)として渡し、チャットに長い指示を貼らない。書き込めるのは run の成果物
|
|
712
|
+
(`assessment.json`・`drafts/`・`children/`・`ui/index.json`・`ui/src/`)だけで、`run.json` などの管理情報・
|
|
713
|
+
`instructions.md`・固定した資料(`request.md`・`carryover.md`・添付)・参照先は変えさせない
|
|
714
|
+
- 手元の経路には **コンテナと同等の囲いが無い**。参照先を読むだけにする・書き込みを成果物に限ることは、エージェントの権限の
|
|
715
|
+
中で指示として守らせるだけで、P3 は強制できない(取り込みでは成果物を確かめるが、ほかのファイルへの書き込みは止められない)。
|
|
716
|
+
git の履歴の有無(`gitHistory`)はコンテナの見え方で決めるので、手元では作業ツリー・サブフォルダの履歴も「なし」と出る(控えめに出るだけ)
|
|
717
|
+
- 手元のエージェントの Preflight(`p3 preflight --prepare` / `--complete` / `--cancel`。`service.ts` の `prepare`・`complete`・
|
|
718
|
+
`cancelLocal`)はエンジンではない(P3 はモデルを呼ばない)。開始と終了を別のプロセスに分ける:
|
|
719
|
+
- 準備は通常の開始と同じ固定(`fix`・`open`)をし、`run.json` に `engine: local`・`status: running`・`local.before`(準備したときの
|
|
720
|
+
要望のステータス)を残す。待っている状態は `run.json` だけで表し、プロセスのメモリ(`active`)には置かない
|
|
721
|
+
- 同じ要望の開始・準備・取り込み・取消は、要望ごとのロックのファイル(`requests/.preflight-<要望ID>.lock`)で1つずつにする。最新の
|
|
722
|
+
run(`lastPreflight`)が local で待っている、またはほかのプロセスで実行中(開始から 35 分まで。それより古いものは落ちたプロセスの
|
|
723
|
+
ものとみなす)なら始めない(`PreflightBusyError`)
|
|
724
|
+
- 取り込みは成果物を先に確かめ(`localProblems`)、問題があれば run を変えずに断る(`local.rejected` を数えるだけ)。通ったら画面の
|
|
725
|
+
原稿を描き、通常と同じ `ingest`・`finish` で完了にする。取り込みも取消も `lastPreflight` は変えない
|
|
705
726
|
- ファイル契約なので、Mock エンジンでも人手で書いても同じ取り込み処理になる。案の `supersedes` のうち同じ要望に無いタスクはタスク化のときに捨てる
|
|
706
727
|
- テストは偽の app-server で、マウントの引数・指示文・記録・根拠の扱いを確かめる。本物の Codex が実際にどこまで読むか、
|
|
707
728
|
読むだけのマウントへの書き込みが拒まれることは、偽の app-server では確かめられない
|
|
@@ -873,6 +894,8 @@ Playwright が入っても、それだけでは描画の安全の条件(ネッ
|
|
|
873
894
|
分けて渡す(docs を外したときに、指示が案内だけに弱まっていたのを戻した。入口 `entry` は任意で、あればそこから読ませる)。参照先ごとに書くので、どの参照先のファイルかが曖昧にならない
|
|
874
895
|
(以前のプロジェクトの `docs` は、名前を付けないと先頭の参照先のパスになり分かりにくかったので外した。構成の説明の
|
|
875
896
|
Markdown `mapFile` も入口と重なるので外した。どちらも保存のときに project.yaml から消す)。
|
|
897
|
+
ドキュメントは古いまま残ることがあるので、今のコードと食い違えば今のコードを正として評価・タスク案を作らせ、見つけた食い違いは
|
|
898
|
+
黙って片方に合わせず、すべてリスクか確認事項に書かせる(`instructions.ts` の「やること」。過去の記録と今のコードの食い違いも同じ扱い)。
|
|
876
899
|
`preflight.instructions` にはプロジェクト固有の評価の観点・制約を書く。どちらも Codex への指示に加わる。
|
|
877
900
|
|
|
878
901
|
## 共有(同期)の方法
|
|
@@ -918,6 +941,7 @@ Playwright が入っても、それだけでは描画の安全の条件(ネッ
|
|
|
918
941
|
- プロジェクトが無い・未登録のときは `p3 init` / `p3 join` を自分から実行せず、新しく作る(`init`)のか共有されたものに参加する(`join`)のかを人に確かめる
|
|
919
942
|
- 新しい作業を頼まれたら `p3 request new "<タイトル>" --body "..."` で要望を登録し、ID を伝えて終える。
|
|
920
943
|
Preflight(`preflight`)とタスク化(`accept`)は人が行う(AI は実行しない。結果を `p3 drafts` で読むのと、頼まれたメモの保存 `--note-only` はよい)
|
|
944
|
+
- 例外: 人がチャットで対象の要望の Preflight を明示的に頼んだときだけ、手元で評価してよい: `p3 preflight <要望ID> --prepare --json` → 返った指示のファイル(`instructions`)を最後まで読み、書くのは返った run の成果物(`outputs`)だけ → `p3 preflight <要望ID> --complete --run <run> --json` → `p3 drafts` の結果を伝えて終える(自分から始めない。タスク化 `accept` と着手はしない)
|
|
921
945
|
- 着手する前に `p3 show T003 --brief --json` で本文・依存とその状態(`dependencies`)・置き換えの注意(`warnings`)を読む
|
|
922
946
|
- 着手する前に、`--brief --json` の `work`(作業先のリポジトリとブランチ)を見て、そのリポジトリでブランチに入る(作業先なしなら移動しない)
|
|
923
947
|
- 着手するときは `p3 move T003 doing`。テストを通したら、コミットする前に `p3 move T003 done --output <今ある成果物(変えたファイルや説明)> --record -` で完了にする(変更の記録は必須: 何を変えたか・なぜ・入れた決まり・やめたもの を標準入力から Markdown で。まだ無い URL は書かない)
|
package/docs/development.md
CHANGED
|
@@ -64,6 +64,12 @@ 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 の節や指示の形を変えたときは、
|
|
70
|
+
一時フォルダのプロジェクト(`init --agents claude`)を Claude Code で開き、要望を作って「要望 <ID> の Preflight を Claude Code の
|
|
71
|
+
このチャットで実行して」と頼み、prepare → 成果物 → complete → drafts まで進んで accept しないこと、依頼の無い登録では始めないことを
|
|
72
|
+
手で確かめる(結果はタスクの変更の記録に残す)。Claude Code がスキルを読む場所は公式の文書(<https://code.claude.com/docs/en/skills>)
|
|
67
73
|
- CLI のテストは別プロセスで `bin/p3.mjs` を動かし、個人設定を一時フォルダに分け、このマシンの `P3_*` の環境変数は効かないようにしている
|
|
68
74
|
- `test/layers.test.ts` が src の層の依存の向き、`test/package.test.ts` が配布物の中身と文書のリンクを確かめる
|
|
69
75
|
- 短い出力の量を測るときは:
|
package/docs/how-to-use.md
CHANGED
|
@@ -312,6 +312,55 @@ Codex の失敗のどれでも、止まった理由と直し方に並べて、
|
|
|
312
312
|
(5. で採否を選ぶ)。案が既にあるタスクを置き換えるとき(`supersedes`)は、同じ要望の中で人が採否とアーカイブを選ぶ
|
|
313
313
|
(後の「タスクの関係と置き換え」)。自動で置き換えたりまとめたりはしない
|
|
314
314
|
|
|
315
|
+
### 手元の対話エージェントで Preflight する
|
|
316
|
+
|
|
317
|
+
Codex(ChatGPT の接続と Docker)を使えないときは、手元の対話エージェント(Claude Code など)に評価させられる。P3 はモデルを
|
|
318
|
+
呼ばない(`claude -p` や API も使わない)。評価の指示は Codex と同じ原本から P3 が作り、エージェントはそれを読んで run のフォルダに
|
|
319
|
+
成果物を書き、P3 が通常と同じ取り込みをする。タスク化(accept)は今までどおり人が行う。
|
|
320
|
+
|
|
321
|
+
```bash
|
|
322
|
+
p3 preflight k7m3x --prepare --json
|
|
323
|
+
# → run(PF-...)・指示のファイル instructions・成果物のパス outputs・次のコマンド next
|
|
324
|
+
# エージェントが instructions を読み、参照先を調べ、outputs(assessment.json・drafts/ など)を書く
|
|
325
|
+
p3 preflight k7m3x --complete --run PF-... --json # 確かめて取り込む
|
|
326
|
+
p3 drafts k7m3x # 評価とタスク案(人が読む)
|
|
327
|
+
p3 accept k7m3x # 人がタスク化
|
|
328
|
+
```
|
|
329
|
+
|
|
330
|
+
- 準備(`--prepare`)は、評価対象・参照先・親子・添付・メモ・前回の結果を通常の Preflight と同じに固定し、要望を「評価中」にする。
|
|
331
|
+
run は「実行中」(エンジン `local`)のまま、エージェントの評価を待つ。CLI を終えても残り、別のプロセス(画面・別の端末)から
|
|
332
|
+
見える。待っている間は、同じ要望の Preflight(`--prepare`・通常の実行・画面の実行)を始められない
|
|
333
|
+
- 取り込み(`--complete`)は、その run の成果物だけを確かめる: 評価が JSON として読めるか、タスク案・子の案の形(キー・題・依存・
|
|
334
|
+
作業先・混在)、成果物がシンボリックリンクでないか。問題があれば何も確定せず理由を出し(`--json` では `code: invalid_result` と
|
|
335
|
+
`problems`、終了コード 1)、run は待ったまま。直して同じ `--complete` をやり直す。取り込み済みの run にもう一度 `--complete` しても
|
|
336
|
+
何も変えない(`already: true`)
|
|
337
|
+
- 画面イメージの原稿(`ui/src/*.html`)があるときだけ、取り込みのときに P3 が描画のコンテナ(Docker)で PNG にする。Docker が
|
|
338
|
+
使えなくても評価は残し、必要な画面イメージが足りなければ go を clarify にする(Codex のときと同じ)。原稿が無ければ Docker は使わない
|
|
339
|
+
- やめるとき・放置した run は `p3 preflight <要望> --cancel --run PF-...`(取り消し。成果物のファイルは残る)。要望の状態は元に戻る。
|
|
340
|
+
どの run が待っているかは `p3 drafts <要望>`(最新の run)か、始められなかったときのメッセージに出る
|
|
341
|
+
- 評価のあとで要望を変えたら、通常の Preflight と同じくその評価からはタスク化できない(後の「要望の本文を変えたとき」)
|
|
342
|
+
- 手元のエージェントにはコンテナの囲いが無い。参照先を読むだけにすること・書き込みを run の成果物に限ることは指示で伝えるだけで、
|
|
343
|
+
P3 は止められない(エージェントの権限の設定で守る)。どの程度の利用枠を使うかはエージェント側の契約による
|
|
344
|
+
|
|
345
|
+
**Claude Code のチャットで頼む**: 上の手順は、同梱のスキル(`.claude/skills/p3/SKILL.md`。後の「AI エージェントから使う」)に書いてある。
|
|
346
|
+
Claude Code のチャットで、対象の要望を挙げて明示的に頼む:
|
|
347
|
+
|
|
348
|
+
```text
|
|
349
|
+
要望 261009-k7m3x の Preflight を Claude Code のこのチャットで実行して
|
|
350
|
+
```
|
|
351
|
+
|
|
352
|
+
- Claude Code はスキルに従って `--prepare` → 指示のファイルを読んで評価し、成果物を書く → `--complete` → `p3 drafts` の要約を返す、
|
|
353
|
+
までを同じチャットで行う。タスク化(`accept`)とタスクの着手はしない(人が `p3 drafts` か画面で案を確かめてから `p3 accept`)。
|
|
354
|
+
明示の依頼が無ければ(要望の登録だけなど)Preflight は始めない
|
|
355
|
+
- 要るもの: `p3` の CLI を実行できること(Bash)、データのフォルダと参照先を読めること、run のフォルダに書けること。データのフォルダや
|
|
356
|
+
参照先がリポジトリの外にあるなら、Claude Code に読む場所として足す(`/add-dir <フォルダ>`・起動時の `--add-dir`・設定の
|
|
357
|
+
`permissions.additionalDirectories`)。足さなければ、外のファイルを読む・書くたびに許可を求められる。参照先に書かせない設定
|
|
358
|
+
(`permissions.deny` の `Edit(...)` など)にしておくと、指示だけに頼らずに済む
|
|
359
|
+
- スキルは、置いた後なら会話の途中でも読み直される。既に古いスキルを置いたプロジェクトは `p3 agents claude` で違いを確かめ、手で
|
|
360
|
+
直していなければ `p3 agents claude --force` で最新にする(後の「AI エージェントから使う」)
|
|
361
|
+
- P3 は `claude -p` も API キーも使わない。今の対話セッションでエージェントが調べて書くので、Claude Code の契約の利用枠を使う
|
|
362
|
+
(無料になるわけではない)。いつもの Codex の Preflight(Docker・ChatGPT)とは別の経路で、どちらで評価した run も同じに読める(エンジンは `local`)
|
|
363
|
+
|
|
315
364
|
### 要望の本文を変えたとき
|
|
316
365
|
|
|
317
366
|
要望のタイトル・本文は、いつでも書き換えられる(画面の「本文を編集」→「本文を保存」、CLI の `request set`)。
|
|
@@ -745,6 +794,6 @@ AI にも CLI を使わせる(認証を持たせずに済む)。`p3 init --a
|
|
|
745
794
|
| `p3 request new\|ls\|show\|set\|archive` | 要望 |
|
|
746
795
|
| `p3 ls` / `p3 show` / `p3 find` | タスクの一覧(`--all` で全要望)/ 詳細(`--brief`)/ 参照・タイトルで探す |
|
|
747
796
|
| `p3 new` / `p3 set` / `p3 move` / `p3 check` / `p3 archive` | タスクを足す / 直す / 状態を変える / 済みにする / アーカイブ |
|
|
748
|
-
| `p3 preflight` / `p3 notes` / `p3 drafts` / `p3 accept` | Preflight の実行(`--note`)/ メモ / 評価とタスク案 / タスク化 |
|
|
797
|
+
| `p3 preflight` / `p3 notes` / `p3 drafts` / `p3 accept` | Preflight の実行(`--note`。手元のエージェントなら `--prepare` / `--complete` / `--cancel`)/ メモ / 評価とタスク案 / タスク化 |
|
|
749
798
|
| `p3 attach` / `p3 render` | 添付 / 画面イメージの描画 |
|
|
750
799
|
| `p3 chatgpt` / `p3 codex update` / `p3 serve` | ChatGPT の接続 / Codex のイメージ / 画面(`--all-projects` で登録したプロジェクトを跨ぐ) |
|
package/docs/installation.md
CHANGED
|
@@ -8,7 +8,8 @@ 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
|
|
|
@@ -261,7 +262,8 @@ DevContainer で「対応あり」にならなければ 5. を見直す。評価
|
|
|
261
262
|
失敗はログとエラーに **次にすること** を添えて出す。直して、もう一度同じ操作をする。
|
|
262
263
|
|
|
263
264
|
Preflight を使えない・失敗したとき(Docker・ChatGPT の接続・使用量の上限など、理由によらない)は、概要ページ・失敗した run・
|
|
264
|
-
CLI の出力に、Preflight を通さずにタスクを作る道も出る。直すまでの間はそれで進めてよい([使い方ガイド: Preflight を通さずにタスクを作る](how-to-use.md#preflight-を通さずにタスクを作る))。
|
|
265
|
+
CLI の出力に、Preflight を通さずにタスクを作る道も出る。直すまでの間はそれで進めてよい([使い方ガイド: Preflight を通さずにタスクを作る](how-to-use.md#preflight-を通さずにタスクを作る))。Preflight を Claude Code などの手元の対話エージェントに
|
|
266
|
+
頼むなら Docker と ChatGPT は要らない(画面イメージの描画だけ Docker を使う。[使い方ガイド: 手元の対話エージェントで Preflight する](how-to-use.md#手元の対話エージェントで-preflight-する))。
|
|
265
267
|
|
|
266
268
|
| どこで | 出るもの | 確かめる | 直す |
|
|
267
269
|
| --- | --- | --- | --- |
|
|
@@ -304,12 +306,12 @@ P3 をイメージにして、コンテナで動かすこともできる。イ
|
|
|
304
306
|
要望・タスクの作成と編集・添付・Preflight もいつもどおり使える。
|
|
305
307
|
|
|
306
308
|
イメージは Docker Hub の **`tamuto/p3`**。中に p3 本体(npm の `@infodb/p3` と同じ版・同じ中身)と、Node 22・git・Docker の CLI が
|
|
307
|
-
入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.
|
|
309
|
+
入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.9.0` など)と
|
|
308
310
|
`latest` がある。決まった版で使うなら版のタグを指す。対応する platform は `linux/amd64` だけ(arm64 は確かめるマシンが無いので
|
|
309
311
|
作っていない)。
|
|
310
312
|
|
|
311
313
|
```bash
|
|
312
|
-
docker pull tamuto/p3:0.
|
|
314
|
+
docker pull tamuto/p3:0.9.0
|
|
313
315
|
```
|
|
314
316
|
|
|
315
317
|
リポジトリから作るときは `docker build --pull -t tamuto/p3:dev .`(`--pull` で今の Node のベースを取る。[開発ガイド](development.md#docker-のイメージ))。
|
|
@@ -330,7 +332,7 @@ root で動く開発コンテナ(DevContainer など)で p3 の CLI を使
|
|
|
330
332
|
# 開発コンテナの compose に足す例(パスは開発コンテナのマウントに合わせる)
|
|
331
333
|
services:
|
|
332
334
|
p3:
|
|
333
|
-
image: tamuto/p3:0.
|
|
335
|
+
image: tamuto/p3:0.9.0
|
|
334
336
|
restart: unless-stopped
|
|
335
337
|
ports:
|
|
336
338
|
- "127.0.0.1:4310:4310"
|
|
@@ -354,7 +356,7 @@ docker run -d --name p3 --restart unless-stopped \
|
|
|
354
356
|
-v ~/.config/infodb-p3:/root/.config/infodb-p3 \
|
|
355
357
|
-v /home/me/work:/home/me/work \
|
|
356
358
|
-v /var/run/docker.sock:/var/run/docker.sock \
|
|
357
|
-
tamuto/p3:0.
|
|
359
|
+
tamuto/p3:0.9.0
|
|
358
360
|
|
|
359
361
|
# 登録が無ければ、コンテナの中で登録する(既にあるデータに参加する。新しく作るなら p3 init)
|
|
360
362
|
docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
|
|
@@ -367,7 +369,7 @@ docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
|
|
|
367
369
|
### どちらでも
|
|
368
370
|
|
|
369
371
|
- 待ち受けは `127.0.0.1` に公開する。ブラウザで http://localhost:4310 を開く。登録が1つならそのプロジェクトが開き、複数なら一覧から選ぶ
|
|
370
|
-
- **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.
|
|
372
|
+
- **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.9.0 serve --project myapp --host 0.0.0.0`。compose なら
|
|
371
373
|
`command:`)。明示しない限り、コンテナの中かどうかで自動では切り替えない
|
|
372
374
|
- **止める**: `docker stop p3`(SIGTERM。実行中の Preflight・生成を取り消して記録してから止まる。10 秒まで待つ)
|
|
373
375
|
- **新しい版にする**: 版のタグを変えて作り直す(個人設定と接続はマウントした ~/.config、データはホストに残る)。
|
package/lib/cli/args.js
CHANGED
|
@@ -50,6 +50,9 @@ const OPTIONS = {
|
|
|
50
50
|
agents: { type: "string" },
|
|
51
51
|
force: { type: "boolean" },
|
|
52
52
|
"note-only": { type: "boolean" },
|
|
53
|
+
prepare: { type: "boolean" },
|
|
54
|
+
complete: { type: "boolean" },
|
|
55
|
+
cancel: { type: "boolean" },
|
|
53
56
|
"archive-superseded": { type: "boolean" },
|
|
54
57
|
paste: { type: "boolean" },
|
|
55
58
|
"no-browser": { type: "boolean" },
|
package/lib/cli/help.js
CHANGED
|
@@ -85,6 +85,10 @@ Preflight
|
|
|
85
85
|
preflight [<要望>] 評価・細分化を実行し、完了まで待つ --engine codex|mock
|
|
86
86
|
前回の結果とまだ渡していないメモを引き継ぐ
|
|
87
87
|
--note 本文|- メモ(確認事項への回答・方針の変更)を書き足してから実行 --note-only 書くだけ
|
|
88
|
+
preflight [<要望>] --prepare 手元の対話エージェント(Claude Code など)で評価する準備。モデルは呼ばない。評価対象を固定し、
|
|
89
|
+
指示のファイル(instructions.md)と成果物のパス・run の ID を返して終わる(--note も使える)
|
|
90
|
+
preflight [<要望>] --complete --run PF-... エージェントが書いた成果物を確かめて取り込む(問題があれば何も確定せず、直してやり直せる)
|
|
91
|
+
preflight [<要望>] --cancel --run PF-... 評価を待つ run をやめる(待っている間は同じ要望の Preflight を始められない)
|
|
88
92
|
notes [<要望>] メモの一覧(次の Preflight に渡すもの・渡し済み)
|
|
89
93
|
attach [ls] 要望の添付(PNG / JPEG / xlsx)の一覧。要望は --req(要望の作業ツリーの中なら省略可)
|
|
90
94
|
attach add <ファイル> 添付を足す --description 説明 --source 出典。次の Preflight を始めるときに run に固定して渡す
|
|
@@ -11,7 +11,7 @@ import { StaleInputError, staleMessage } from "../core/preflight/input.js";
|
|
|
11
11
|
import { changedLabel, isMaterialized } from "../shared/preflightInput.js";
|
|
12
12
|
import { readBody } from "./args.js";
|
|
13
13
|
import { deps, directTaskHint, indent } from "./output.js";
|
|
14
|
-
import { PreflightBusyError } from "../core/preflight/service.js";
|
|
14
|
+
import { LocalResultError, PreflightBusyError } from "../core/preflight/service.js";
|
|
15
15
|
import { preflightFailed } from "../shared/directTask.js";
|
|
16
16
|
/** Preflight のコマンド(preflight / attach / notes / drafts / accept)。扱わないコマンドは undefined */
|
|
17
17
|
export async function preflightCommand(cmd, env) {
|
|
@@ -25,6 +25,9 @@ export async function preflightCommand(cmd, env) {
|
|
|
25
25
|
throw new UsageError("--note-only には --note でメモを渡してください");
|
|
26
26
|
if (o["note-only"] && engine)
|
|
27
27
|
throw new UsageError("--note-only は実行しないので --engine は使えません");
|
|
28
|
+
const local = localMode(o);
|
|
29
|
+
if (local)
|
|
30
|
+
return localPreflight(env, rid, local);
|
|
28
31
|
const note = o.note === undefined ? undefined : await ctx.preflight.addNote(rid, readBody(o.note), actor);
|
|
29
32
|
if (o["note-only"])
|
|
30
33
|
return out.result(note, () => `メモ ${note.id} を書き足しました(次の Preflight に渡します)`);
|
|
@@ -170,6 +173,75 @@ export async function preflightCommand(cmd, env) {
|
|
|
170
173
|
}
|
|
171
174
|
return undefined;
|
|
172
175
|
}
|
|
176
|
+
/** 手元のエージェントの Preflight の操作(--prepare / --complete / --cancel)。どれでもなければ undefined。曖昧な組み合わせは何も書かずに断る */
|
|
177
|
+
function localMode(o) {
|
|
178
|
+
const modes = ["prepare", "complete", "cancel"].filter((m) => o[m]);
|
|
179
|
+
if (!modes.length) {
|
|
180
|
+
if (o.run !== undefined)
|
|
181
|
+
throw new UsageError("p3 preflight の --run は --complete / --cancel と一緒に使います(結果を見るなら p3 drafts <要望> --run <PF-...>)");
|
|
182
|
+
return undefined;
|
|
183
|
+
}
|
|
184
|
+
if (modes.length > 1)
|
|
185
|
+
throw new UsageError(`--${modes.join(" と --")} は一緒に使えません`);
|
|
186
|
+
const mode = modes[0];
|
|
187
|
+
if (o.engine !== undefined)
|
|
188
|
+
throw new UsageError(`--${mode} は手元のエージェントの評価なので --engine は使えません`);
|
|
189
|
+
if (o["note-only"])
|
|
190
|
+
throw new UsageError(`--${mode} と --note-only は一緒に使えません`);
|
|
191
|
+
if (mode === "prepare" && o.run !== undefined)
|
|
192
|
+
throw new UsageError("--prepare は新しい run を作るので --run は使えません");
|
|
193
|
+
if (mode !== "prepare" && o.run === undefined)
|
|
194
|
+
throw new UsageError(`--${mode} には --run <PF-...> で run を指定してください(--prepare が返した ID)`);
|
|
195
|
+
if (mode !== "prepare" && o.note !== undefined)
|
|
196
|
+
throw new UsageError(`--${mode} に --note は使えません(メモは次の Preflight に渡すものです)`);
|
|
197
|
+
return mode;
|
|
198
|
+
}
|
|
199
|
+
/**
|
|
200
|
+
* 手元の対話エージェント(Claude Code など)での Preflight。P3 はモデルを呼ばない:
|
|
201
|
+
* --prepare 評価対象などを固定し、指示のファイルと成果物のパスを返して終わる(エージェントが指示を読んで成果物を書く)
|
|
202
|
+
* --complete 指定した run の成果物を確かめて取り込む(問題があれば何も確定せず、直してやり直せる)
|
|
203
|
+
* --cancel 評価を待つ run をやめる
|
|
204
|
+
*/
|
|
205
|
+
async function localPreflight(env, rid, mode) {
|
|
206
|
+
const { ctx, out, o, actor } = env;
|
|
207
|
+
if (mode === "prepare") {
|
|
208
|
+
const note = o.note === undefined ? undefined : await ctx.preflight.addNote(rid, readBody(o.note), actor);
|
|
209
|
+
const p = await ctx.preflight.prepare(rid, { actor }).catch((e) => {
|
|
210
|
+
if (note)
|
|
211
|
+
e.message += `(メモ ${note.id} は保存済みです。書き直さずに p3 preflight ${rid} --prepare でやり直せます)`;
|
|
212
|
+
throw e;
|
|
213
|
+
});
|
|
214
|
+
const next = { complete: `p3 preflight ${rid} --complete --run ${p.run.id}`, cancel: `p3 preflight ${rid} --cancel --run ${p.run.id}` };
|
|
215
|
+
out.result({ request: rid, run: p.run.id, status: p.run.status, engine: p.run.engine, runDir: p.runDir, instructions: p.instructions, outputs: p.outputs, ...(note ? { note: note.id } : {}), next }, () => [
|
|
216
|
+
`preflight ${p.run.id} を準備しました(手元のエージェントの評価を待っています)`,
|
|
217
|
+
`指示: ${p.instructions}`,
|
|
218
|
+
`書く成果物(run のフォルダ ${p.runDir}/ の中だけ):`,
|
|
219
|
+
...p.outputs.map((x) => ` ${x}`),
|
|
220
|
+
`書き終えたら: ${next.complete}`,
|
|
221
|
+
`やめるなら: ${next.cancel}`,
|
|
222
|
+
].join("\n"));
|
|
223
|
+
return 0;
|
|
224
|
+
}
|
|
225
|
+
const runId = o.run;
|
|
226
|
+
if (mode === "cancel") {
|
|
227
|
+
const r = await ctx.preflight.cancelLocal(rid, runId);
|
|
228
|
+
out.result({ ...r.run, already: r.already }, () => (r.already ? `${runId} は取り消し済みです` : `${runId} を取り消しました(成果物のファイルは run のフォルダに残します)`));
|
|
229
|
+
return 0;
|
|
230
|
+
}
|
|
231
|
+
try {
|
|
232
|
+
const r = await ctx.preflight.complete(rid, runId);
|
|
233
|
+
const inputMatch = await ctx.preflight.inputMatch(rid, r.run);
|
|
234
|
+
out.result({ ...r.run, already: r.already, inputMatch }, () => [r.already ? `${runId} は取り込み済みです(何も変えていません)` : `${runId} を取り込みました`, formatRun(ctx, rid, r.run), inputMatchLine(rid, r.run, inputMatch)].join("\n"));
|
|
235
|
+
return 0;
|
|
236
|
+
}
|
|
237
|
+
catch (e) {
|
|
238
|
+
if (!(e instanceof LocalResultError) || !o.json)
|
|
239
|
+
throw e;
|
|
240
|
+
// --json では問題を機械可読で返す(終了コードは 1。run は評価を待ったまま)
|
|
241
|
+
out.result({ error: e.message, code: "invalid_result", request: rid, run: runId, problems: e.problems }, () => "");
|
|
242
|
+
return 1;
|
|
243
|
+
}
|
|
244
|
+
}
|
|
173
245
|
/**
|
|
174
246
|
* 分割の run の採用: 選んだ子の案から子の要望を作る(子のタスク化・Preflight はしない)。途中で失敗したら作った・失敗・未実行を出し、
|
|
175
247
|
* 同じ accept でやり直せる(作った子は作り直さない)。終了コード: 全部作れたら 0、失敗があれば 1
|
|
@@ -238,7 +310,7 @@ function formatRun(ctx, rid, run) {
|
|
|
238
310
|
if (a.questions.length)
|
|
239
311
|
lines.push("", "確認事項:", ...a.questions.map((x) => ` - ${x}`));
|
|
240
312
|
}
|
|
241
|
-
lines.push("", ...scopeLines(run.scope));
|
|
313
|
+
lines.push("", ...scopeLines(run.scope, { local: run.engine === "local" }));
|
|
242
314
|
if (a)
|
|
243
315
|
lines.push("", ...evidenceLines(a.evidence));
|
|
244
316
|
if (run.scope?.some((s) => s.status === "unregistered"))
|
package/lib/cli/project.js
CHANGED
|
@@ -135,6 +135,7 @@ export function agentsSnippet(kinds) {
|
|
|
135
135
|
- プロジェクトが無い・未登録のときは \`p3 init\` / \`p3 join\` を自分から実行せず、新しく作る(\`init\`)のか共有されたものに参加する(\`join\`)のかを人に確かめる
|
|
136
136
|
- 新しい作業を頼まれたら \`p3 request new "<タイトル>" --body "..."\` で要望を登録し、ID を伝えて終える。
|
|
137
137
|
Preflight(\`preflight\`)とタスク化(\`accept\`)は人が行う(AI は実行しない。結果を \`p3 drafts\` で読むのと、頼まれたメモの保存 \`--note-only\` はよい)
|
|
138
|
+
- 例外: 人がチャットで対象の要望の Preflight を明示的に頼んだときだけ、手元で評価してよい: \`p3 preflight <要望ID> --prepare --json\` → 返った指示のファイル(\`instructions\`)を最後まで読み、書くのは返った run の成果物(\`outputs\`)だけ → \`p3 preflight <要望ID> --complete --run <run> --json\` → \`p3 drafts\` の結果を伝えて終える(自分から始めない。タスク化 \`accept\` と着手はしない)
|
|
138
139
|
- 着手する前に \`p3 show T003 --brief --json\` で本文・依存とその状態(\`dependencies\`)・置き換えの注意(\`warnings\`)を読む
|
|
139
140
|
- 着手する前に、\`--brief --json\` の \`work\`(作業先のリポジトリとブランチ)を見て、そのリポジトリでブランチに入る(作業先なしなら移動しない)
|
|
140
141
|
- 着手するときは \`p3 move T003 doing\`。テストを通したら、コミットする前に \`p3 move T003 done --output <今ある成果物(変えたファイルや説明)> --record -\` で完了にする(変更の記録は必須: 何を変えたか・なぜ・入れた決まり・やめたもの を標準入力から Markdown で。まだ無い URL は書かない)
|
package/lib/core/context.js
CHANGED
|
@@ -34,7 +34,7 @@ export async function openProject(dataDir, opts = {}) {
|
|
|
34
34
|
const preflight = new PreflightService(ws, engines, {
|
|
35
35
|
initial: initial?.preflight.engine ?? "codex",
|
|
36
36
|
load: async () => (await source.get()).preflight.engine,
|
|
37
|
-
});
|
|
37
|
+
}, { pathMap: async () => (await source.get()).codex.pathMap });
|
|
38
38
|
// 要約の生成も Preflight と同じ接続と既定のエンジン(preflight.engine)を使う
|
|
39
39
|
const releaseGenerator = new ReleaseGenerator(ws, { codex, mock: new MockSummarizer() }, { engine: async () => (await source.get()).preflight.engine });
|
|
40
40
|
return { ws, preflight, releaseGenerator, chatgpt, projectName: opts.projectName };
|