@infodb/p3 0.9.0 → 0.11.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 +5 -2
- package/dist/web/assets/{Outputs-CQi0oba1.js → Outputs-ddwte0jj.js} +1 -1
- package/dist/web/assets/{RequestStatus-grC0F_SQ.js → RequestStatus-Bg1OLbRc.js} +1 -1
- package/dist/web/assets/{Tabs-BJRGzidj.js → Tabs-DTmggzgg.js} +1 -1
- package/dist/web/assets/{TagInput-cIIwXAHA.js → TagInput-BHAgjLP7.js} +1 -1
- package/dist/web/assets/{TaskDrawer-CSZ7Z0JC.js → TaskDrawer-Dz_5c2NH.js} +1 -1
- package/dist/web/assets/{_requestId-Z3CBhTIL.js → _requestId-D9-gtIcG.js} +1 -1
- package/dist/web/assets/_requestId-DzCNYvqf.js +30 -0
- package/dist/web/assets/{appCtx-DCiGJFAe.js → appCtx-Cm24VpAf.js} +1 -1
- package/dist/web/assets/{board-DyfGX5h0.js → board-MCHcZ-PU.js} +1 -1
- package/dist/web/assets/{directTask-Dk3H5Q2B.js → directTask-C1NWDkZp.js} +1 -1
- package/dist/web/assets/{done-Bhxqy7bH.js → done-zq10Bt08.js} +1 -1
- package/dist/web/assets/{index-Bt13tvIX.js → index-Ce0ndpne.js} +3 -3
- package/dist/web/assets/index-D68mkSnw.css +2 -0
- package/dist/web/assets/{new-BRsIUNIb.js → new-9TKiNT4O.js} +1 -1
- package/dist/web/assets/{preload-helper-B40dBmwL.js → preload-helper-FBLw7u7x.js} +1 -1
- package/dist/web/assets/release-notes-hK5XezLW.js +5 -0
- package/dist/web/assets/{requestData-w6fhCYmh.js → requestData-BnN7mctX.js} +1 -1
- package/dist/web/assets/{routes-QNgQHe48.js → routes-usHwrrA0.js} +1 -1
- package/dist/web/assets/{settings-CoKJahEe.js → settings-BVZDnL6O.js} +1 -1
- package/dist/web/index.html +4 -4
- package/docs/architecture.md +151 -8
- package/docs/development.md +19 -9
- package/docs/how-to-use.md +128 -7
- package/docs/installation.md +26 -10
- package/docs/publishing.md +5 -1
- package/lib/cli/args.js +2 -0
- package/lib/cli/help.js +14 -2
- package/lib/cli/main.js +28 -5
- package/lib/cli/preflightCommands.js +30 -7
- package/lib/cli/project.js +31 -9
- package/lib/cli/requestCommands.js +207 -14
- package/lib/core/context.js +4 -1
- package/lib/core/milestoneReview/code.js +129 -0
- package/lib/core/milestoneReview/material.js +138 -0
- package/lib/core/milestoneReview/mockReviewer.js +27 -0
- package/lib/core/milestoneReview/review.js +261 -0
- package/lib/core/milestoneReview/service.js +278 -0
- package/lib/core/milestoneReview/store.js +226 -0
- package/lib/core/preflight/codexEngine.js +75 -17
- package/lib/core/preflight/codexImage.js +49 -19
- package/lib/core/preflight/docker.js +149 -0
- package/lib/core/preflight/owner.js +118 -0
- package/lib/core/preflight/render-image/Dockerfile +1 -1
- package/lib/core/preflight/service.js +235 -16
- package/lib/core/projectRegistry.js +5 -4
- package/lib/core/requestOps.js +4 -0
- package/lib/core/store/dataWatcher.js +122 -0
- package/lib/core/store/normalize.js +36 -2
- package/lib/core/store/preflightStore.js +20 -2
- package/lib/core/store/projectFile.js +14 -2
- package/lib/core/store/workspace.js +102 -41
- package/lib/server/api/manifest.js +29 -2
- package/lib/server/api/milestoneReviewRoutes.js +69 -0
- package/lib/server/api/routes.js +37 -8
- package/lib/server/server.js +5 -3
- package/lib/shared/directTask.js +2 -2
- package/lib/shared/milestoneGoals.js +57 -0
- package/lib/shared/milestoneReview.js +26 -0
- package/lib/shared/preflightRunner.js +18 -0
- package/package.json +2 -2
- package/skills/p3/SKILL.md +29 -17
- package/dist/web/assets/_requestId-C8WYk2kC.js +0 -30
- package/dist/web/assets/index-BF1xMdJo.css +0 -2
- package/dist/web/assets/release-notes-C3FdiM36.js +0 -3
package/docs/architecture.md
CHANGED
|
@@ -333,7 +333,7 @@ include: true
|
|
|
333
333
|
`ui.theme`)だけを変えて書く(`updateUserConfig`)。init・project add / rm・テーマの保存が同じ経路を通るので、
|
|
334
334
|
CLI と serve が同時に書いても消し合わない。壊れた YAML・読めないファイルは書かずにエラーにする(無いのとは区別する)。
|
|
335
335
|
ChatGPT の接続(`chatgpt.json`)は別のファイル・別のロックのまま
|
|
336
|
-
- 1人1
|
|
336
|
+
- 1人1つのサーバで画面からプロジェクトを切り替える形は `p3 serve --all-projects` で入れた(下の「プロジェクトを跨ぐ serve」)
|
|
337
337
|
|
|
338
338
|
### 要望・タスクのデータ
|
|
339
339
|
|
|
@@ -358,6 +358,80 @@ include: true
|
|
|
358
358
|
ディスクを読むので扱わない。応答は読み直しを終えた後(画面はその後に取り直す)。ほかの serve・CLI が同時に書いている
|
|
359
359
|
最中のファイルは、読んだ時点の内容になる(次の読み直しで追いつく)
|
|
360
360
|
|
|
361
|
+
### マイルストーンの目的と予定機能
|
|
362
|
+
|
|
363
|
+
- project.yaml の `milestones` の各項目に、任意の `purpose`(複数行の文字列)と `goals`(`{ id, text }` の並び)を書く
|
|
364
|
+
(型は `shared/types.ts` の `Milestone`、規則は `shared/milestoneGoals.ts`)。無い古いファイルは空として読み、空は書かない。
|
|
365
|
+
予定機能の ID は足したときに `G<最大の番号 + 1>` を振り、並べ替え・文言の変更では変えない(後のレビューの比較単位の名前になる)
|
|
366
|
+
- 保存はどの道(画面・API・CLI・`p3 config`)も `Workspace.saveProject` / `updateMilestones` を通す。プロセスの間はロックのファイル
|
|
367
|
+
(`<データのフォルダ>/.project.yaml.lock`。`fsutil.ts` の `withFileLock`)で1つずつにし、ロックの中で最新の project.yaml を読み、
|
|
368
|
+
渡された項目だけを重ねて書く。件数・文字数・空・重複はここで確かめる(`ProjectInputError`。何も書かない)
|
|
369
|
+
- 版: `milestonesVersion` はマイルストーンの中身(ID・名前・期限・リリース済み・目的・予定機能と並び)のハッシュ(ファイルの書き方や
|
|
370
|
+
ほかの設定の項目は入れない)。`GET /api/project` が返し、画面は編集を始めたときの版を保存に付ける。版を付けた保存はロックの中で
|
|
371
|
+
最新と照らし、違えば `MilestonesConflictError`(API は 409 `milestones_conflict`、CLI は終了コード 3)で何も書かない。CLI の
|
|
372
|
+
`milestone` の操作はロックの中で読んだ最新の並びの対象の項目だけを変え(指定した項目のほかを巻き戻さない)、`--version` を
|
|
373
|
+
付けたときだけ照らす
|
|
374
|
+
- 版の無い古い道(目的を知らない画面・API の呼び出し)が `purpose` / `goals` のキーの無い項目を送ったら、同じ ID の今の値を残す
|
|
375
|
+
(消すには空か null を送る)。ID を変えた項目は引き継がない
|
|
376
|
+
- 限界: ロックと版は p3 を通した保存どうしの競合を防ぐだけで、エディタで project.yaml を直接書き換えるのは防げない(画面は外の変更を
|
|
377
|
+
知らせ、次の保存で版が合わずに断る)。目的・予定機能を知らない古い p3 で保存すると、どちらも project.yaml から消える。データを
|
|
378
|
+
共有する人は p3 の版をそろえる
|
|
379
|
+
|
|
380
|
+
### マイルストーンレビューのデータ
|
|
381
|
+
|
|
382
|
+
レビューは、保存してあるマイルストーンの目的・予定機能に対して、Codex が参照先のリポジトリのコードと git の履歴を読み、実装が目的を
|
|
383
|
+
果たしているか・目的に無い変更が無いかを確かめる参考の記録(操作は [使い方ガイド](how-to-use.md#マイルストーンレビュー))。所属する
|
|
384
|
+
要望・タスクの記録は実装した人の自己申告として、どこを見るかの手がかりにする(記録の要約で終わらせない)。比較材料の抽出は
|
|
385
|
+
`core/milestoneReview/material.ts`(コードの材料は `code.ts`)、履歴は `core/milestoneReview/store.ts`、形は `shared/milestoneReview.ts`。
|
|
386
|
+
リリースノートの材料(`releaseNotes/material.ts`)の収録の条件は変えない。
|
|
387
|
+
|
|
388
|
+
- **範囲**: マイルストーンに直接属する要望の全部の状態(見送り・未完了も)。要望の本文、各タスクの本文・状態・変更の記録・成果物の
|
|
389
|
+
参照の文字列(URL や添付の中身は読まない)。親・子が別のマイルストーンなら文脈(`context`。ID・題・状態だけ)として持ち、
|
|
390
|
+
直接の材料に数えない。アーカイブした要望は通常の一覧と同じく含めない。比較単位は予定機能で、予定機能が無く目的だけなら
|
|
391
|
+
目的そのもの(`purpose`)
|
|
392
|
+
- **コードの材料**(`code.ts`): 参照先(`Workspace.refs()`。Preflight と同じ解決)ごとに、状態・git の履歴の有無・HEAD・ブランチ・
|
|
393
|
+
未コミットの変更の数と中身の識別子(差分と追跡していないファイルの中身の hash。参照先の中のデータのフォルダは数えない)と、タスクの成果物に残したコミット(`…/commit/<sha>` か sha。
|
|
394
|
+
`<参照先>: ` の付いた成果物はその参照先)が履歴にあるかを `input.json` の `code` に固定する。コードの中身は保存しない
|
|
395
|
+
(そのときの作業ツリーを読んだことが HEAD と未コミットの変更の識別子で分かる)。git は読むだけの操作だけ。読めない参照先は `code_unavailable`、
|
|
396
|
+
未コミットの変更は `dirty_worktree`、見つからないコミットは `commit_missing`、読める参照先が無ければ `no_code` の警告にし、
|
|
397
|
+
範囲を「記録だけ」(`REVIEW_SCOPE_RECORDS_ONLY`)にする
|
|
398
|
+
- **欠落**: 読めない要望は所属が分からないので全体の警告(`broken_request`)、読めないタスクはその要望の欠落(`broken_task`)。
|
|
399
|
+
完了して記録の無いタスク・要望 0 件・目的も予定機能も無いことも警告に残す(材料から省かない)
|
|
400
|
+
- **ファイル**: `<data>/milestone-reviews/<マイルストーン>/<run>/` に `input.json`(固定した材料。抽出の始めと終わり・範囲・警告・
|
|
401
|
+
hash・コードの材料)、`run.json`(状態・実行者・エンジン・開始と終了・所有者・失敗の理由・取消の要求・ログ)、`review.json`(全体の
|
|
402
|
+
所見と、比較単位ごとの判定・理由・根拠・不足、意図しない変更の候補 `unplanned`)。run の ID は `MR-YYYYMMDD-HHMMSS-xxxx`。
|
|
403
|
+
`code`・`unplanned` の無い古い記録もそのまま読める
|
|
404
|
+
- **整合**: 状態は `running` → `completed` / `failed` / `cancelled` の一方向。状態を変えるのはマイルストーンごとのロック
|
|
405
|
+
(`milestone-reviews/.locks/<ID>.lock`)の中だけで、終わった run は変えない。`completed` は `review.json` を書き終えてから
|
|
406
|
+
`run.json` を書く。ファイルは tmp に書いて rename する。ID は形を確かめ(`.`・`..`・保存先の外は不可)、同じ run は作り直さない。
|
|
407
|
+
読めない記録は「無い」と分け(`broken` / `not_found`)、一覧から隠さない
|
|
408
|
+
- **hash**: 目的・予定機能・所属・本文・状態・記録・関係・欠落と、参照先の HEAD・ブランチ・未コミットの変更の中身・コミットから作り、抽出の日時は入れない。今の材料と比べて変わっていても、
|
|
409
|
+
過去の `input.json`・`review.json` は変えない。複数のファイルを同じ時点で読んだとは保証しない(抽出の始めと終わりを残す)
|
|
410
|
+
- **保護**: 履歴のあるマイルストーンは消せず、ID も変えられない(`requestOps.ts` の `checkMilestoneRemoval`)。project.yaml を直接
|
|
411
|
+
編集して定義が消えても、履歴は孤立として一覧・閲覧できる
|
|
412
|
+
- 抽出と履歴の保存は、要望の状態・リリースノート・リリース済みを変えない
|
|
413
|
+
- **実行**(`core/milestoneReview/service.ts`・依頼文と確かめ方は `review.ts`): Preflight と同じ Codex の接続の `ask` に、材料を
|
|
414
|
+
取り出したときに読めた参照先を渡し、Preflight と同じく `/workspace/<名前>` に読むだけでマウントする(データのフォルダは渡さない。
|
|
415
|
+
認証・診断・パスの対応・使用量の上限・取消を共有)。Mock は明示したときだけで、失敗しても切り替えない。依頼文では、記録を自己申告
|
|
416
|
+
として手がかりにとどめ、予定機能ごとに実装を読んで判断する・コミットの差分から目的に無い変更を挙げる・書き込みやテストとアプリの
|
|
417
|
+
実行をしない・タスクの完了数を達成の証明にしない・数値の達成率を出さないことを指示する。結果は JSON で受け、取り込む前に形・
|
|
418
|
+
全部の比較単位がちょうど1回ずつ・区分・件数・文字数と根拠を確かめる: 記録の根拠は資料の参照にあるか、コードの根拠
|
|
419
|
+
(`<参照先>:<パス>[:行]`・`<参照先>@<コミット>`)は読めた参照先の中の相対パスで実在するか・履歴にあるコミットか。読める参照先が
|
|
420
|
+
あるのに「達成」の根拠にコードが無い結果、読める参照先が無いのに「達成」とした結果も使わない(どれも `invalid_output` で失敗)。
|
|
421
|
+
入力が上限(`REVIEW_INPUT_LIMIT`)を超えたら切り詰めずに断る
|
|
422
|
+
- **1つずつ**: 同じデータ・同じマイルストーンで実行中の run は1つだけ(開始はマイルストーンのロックの中で、実行中の run が無いことを
|
|
423
|
+
確かめてから作る。CLI の別プロセスと serve の同時の開始でも片方だけ)。別のマイルストーンは独立
|
|
424
|
+
- **所有者と回復**: run.json に実行しているプロセス(`preflight/owner.ts`)を書き、死んだと確かめられた run(`dead`)だけ失敗
|
|
425
|
+
(`crashed`)にする。分からない・ほかの環境の run(`unknown`)は自動で終わりにせず、人が `--acknowledge-stopped`(画面では
|
|
426
|
+
明示の中断)で記録の上で中断にできる(動いていると確かめられる所有者がいれば断る。ほかの環境のプロセスを止めたとは限らない)
|
|
427
|
+
- **取消**: このプロセスの run は止める。ほかのプロセスの run は `cancelRequested` を書き、所有者が見つけて止める(所有者は1秒ごとに
|
|
428
|
+
run.json を読み、ログも書き足す)。終わりの状態はロックの中でまだ実行中かを確かめて書くので、中断の後に届いた結果は取り込まない
|
|
429
|
+
- **組み込み**: `P3Context.milestoneReview`。通常の serve と、プロジェクトを跨ぐ serve の停止・登録の解除は、Preflight・要約の生成と
|
|
430
|
+
同じく実行中のレビューを取り消して(解除は待って)から閉じる。変更通知は `milestone-review`(ほかのプロセスが書いた履歴の変化も
|
|
431
|
+
ファイルの監視で知らせる)
|
|
432
|
+
- レビューの実施の有無・結果は、要望の完了・リリースの条件にしない。人の承認の状態・タスクの自動作成・複数のマイルストーンを
|
|
433
|
+
まとめたレポートは持たない
|
|
434
|
+
|
|
361
435
|
### リリースノートのデータ
|
|
362
436
|
|
|
363
437
|
マイルストーンごとに1件、`<data>/release-notes/<マイルストーンID>.md` に置く(`core/releaseNotes/`)。要望のフォルダの外に
|
|
@@ -590,6 +664,25 @@ serve の中で起きたこと(画面からの保存、Preflight の進み具
|
|
|
590
664
|
タブ・ウィンドウに戻ったときの読み直し(POST /api/reload)で取り込む。ファイル監視は補助で、届かないことがある
|
|
591
665
|
(NFS や、Node の再帰的な監視が置き換えて保存したファイルの2回目以降の変更を通知しないことがある)。
|
|
592
666
|
|
|
667
|
+
**データのフォルダの監視**(`src/core/store/dataWatcher.ts`。`Workspace.watch` が1つだけ持ち、通常の serve と `--all-projects` の
|
|
668
|
+
プロジェクトごとに同じものを使う): 補助なので、壊れても serve と実行中の Preflight は止めない。
|
|
669
|
+
|
|
670
|
+
- `fs.promises.watch` は使わない。Node 22 の Linux の再帰監視(JS の実装)は、見ている途中でフォルダが消えると(Preflight が
|
|
671
|
+
`drafts/` を作り直すときなど)ウォッチャーに `'error'` を出し、`promises.watch` の非同期イテレータはそれを聞かないので、未処理の
|
|
672
|
+
`'error'` イベントとしてプロセスごと落ちていた(for await の try/catch には届かない。2026-11-03 に `--all-projects` の serve が
|
|
673
|
+
`ENOENT: scandir '.../preflight/PF-.../drafts'` で落ち、別のプロジェクトの Preflight も止まった)。コールバック式の `fs.watch` を
|
|
674
|
+
持ち、`'error'` を必ず聞く。プロセス全体の `uncaughtException` で握り潰すことはしない
|
|
675
|
+
- 入れ子のフォルダ・ファイルが消えた `ENOENT`(データのフォルダ自体はある): 一時的なものとして監視を続ける。ログは 60 秒に1行に間引く
|
|
676
|
+
- それ以外のエラー・監視の開始の失敗: 監視を閉じ、1 秒後に立て直す(失敗が続くと倍にして 30 秒まで)。続けて 6 回失敗したら
|
|
677
|
+
(立て直しを 5 回)やめて、その旨をログに残す。60 秒より長く動いた後の失敗は、続けての失敗に数えない。やめた後も API と
|
|
678
|
+
画面の「再読み込み」はそのまま使える(serve を起動し直すと、また監視を始める)
|
|
679
|
+
- 変更を読み込む処理の失敗はログに残すだけ(次の変更か「再読み込み」で反映)
|
|
680
|
+
- ログは標準エラーに `[watch] <データのフォルダ>: <何が起きたか>。<続ける / 立て直す / やめる>: <原因>` の形で出す
|
|
681
|
+
- `close` で監視・遅らせた通知・立て直しの予定を全部やめ、その後は通知も立て直しも起こさない(close の後に watch しても始めない)
|
|
682
|
+
- 限界: 監視をやめた・立て直している間の外での変更は画面に自動では出ない(「再読み込み」で取り込む)。Node 24.22.2・26.13.0 では、同じ操作で
|
|
683
|
+
元の例外は起きなかった(2026-11-03 の記録)。今の対象(`engines` の `>=24`、イメージの 26)では起きないが、`'error'` を聞く守りは残す。
|
|
684
|
+
`test/dataWatcher.test.ts` の実際の監視は元の例外を起こせないので、退行は差し替えた監視のテストが見る
|
|
685
|
+
|
|
593
686
|
画面は定期的には問い合わせない、の例外を1つだけ置く: 要望の「概要・Preflight」を開いている間だけ、その要望の最新の Preflight を
|
|
594
687
|
軽く確かめる(`GET /api/requests/:rid/preflight-status`、`PreflightService.pulse`)。CLI など外で始めた run とその進み・終わりは
|
|
595
688
|
serve の SSE に乗らず、監視も届かないことがあるため。返すのは要望の `lastPreflight` と、指定した run の `run.json` の状態・日時と
|
|
@@ -638,6 +731,8 @@ src は5つの層に分け、依存の向きを `test/layers.test.ts` で確か
|
|
|
638
731
|
| プロジェクトを跨ぐ serve(登録の一覧・登録世代・文脈の開閉) | `core/projectRegistry.ts`(API は `server/api/projectsRoutes.ts`) |
|
|
639
732
|
| Preflight を通さずにタスクを作る道の案内(付かないものの言い方・失敗と取消の見分け。取消は `PREFLIGHT_CANCELLED` で残す) | `shared/directTask.ts`(CLI の案内文は `cli/output.ts` の `directTaskHint`) |
|
|
640
733
|
| マイルストーンの表示の順(ID のバージョンの降順。CLI・API・画面の一覧と選ぶ欄。project.yaml の順は変えない) | `shared/milestoneOrder.ts` |
|
|
734
|
+
| マイルストーンレビュー(材料の範囲・履歴の保存・依頼文と結果の確かめ方・実行の排他と回復) | `core/milestoneReview/`(`material.ts`・`store.ts`・`review.ts`・`service.ts`) |
|
|
735
|
+
| マイルストーンの目的・予定機能(件数・文字数・空・重複・ID の振り方) | `shared/milestoneGoals.ts`(保存の排他と版の照合は `core/store/workspace.ts` の `saveProject`) |
|
|
641
736
|
|
|
642
737
|
CLI は `cli/main.ts`(振り分け・プロジェクトと変更者の決定・終了コード)と、種類ごとのコマンド(`taskCommands.ts`・
|
|
643
738
|
`requestCommands.ts`・`preflightCommands.ts`)に分ける。大きい画面は、ルートのファイルを組み立てだけにして部品を
|
|
@@ -719,10 +814,34 @@ CLI は `cli/main.ts`(振り分け・プロジェクトと変更者の決定
|
|
|
719
814
|
- 準備は通常の開始と同じ固定(`fix`・`open`)をし、`run.json` に `engine: local`・`status: running`・`local.before`(準備したときの
|
|
720
815
|
要望のステータス)を残す。待っている状態は `run.json` だけで表し、プロセスのメモリ(`active`)には置かない
|
|
721
816
|
- 同じ要望の開始・準備・取り込み・取消は、要望ごとのロックのファイル(`requests/.preflight-<要望ID>.lock`)で1つずつにする。最新の
|
|
722
|
-
run(`lastPreflight`)が local
|
|
723
|
-
|
|
817
|
+
run(`lastPreflight`)が local で待っている、またはほかのプロセスで実行中なら始めない(`PreflightBusyError`。下の「実行している
|
|
818
|
+
プロセスと、落ちたプロセスが残した run」)
|
|
724
819
|
- 取り込みは成果物を先に確かめ(`localProblems`)、問題があれば run を変えずに断る(`local.rejected` を数えるだけ)。通ったら画面の
|
|
725
820
|
原稿を描き、通常と同じ `ingest`・`finish` で完了にする。取り込みも取消も `lastPreflight` は変えない
|
|
821
|
+
- **実行しているプロセスと、落ちたプロセスが残した run**(`src/core/preflight/owner.ts`、`service.ts` の `busy`・`recoverRequest`・
|
|
822
|
+
`recover`・`finishLocked`): serve・CLI が途中で落ちると、codex / mock の run は `running` のまま残る。以前は開始から 35 分たったら
|
|
823
|
+
落ちたものとみなして始め直せたが、生きている長い実行と重なりうるうえ、画面からは何分たっても始め直せなかったのでやめた
|
|
824
|
+
- 記録: 始めるとき(`open`)に `run.json` の `owner` と `before`(始める前の要望のステータス)を残す。`owner` は `instance`(ローカルの
|
|
825
|
+
状態のフォルダ `XDG_STATE_HOME/infodb-p3/instance-id` のランダムな値とホスト名のハッシュ。データ・個人設定とは別の場所。個人設定は
|
|
826
|
+
コンテナどうしでマウントして共有することがあるため)・`boot`(Linux の `boot_id`)・`pidNs`(PID の名前空間)・`pid`・`start`
|
|
827
|
+
(`/proc/<pid>/stat` の起動の時刻)。共有するデータに置くので、パス・認証情報・ホスト名そのものは残さない。local の run には残さない
|
|
828
|
+
(プロセスを跨いで待つ契約のまま)
|
|
829
|
+
- 判定(`ownerState`): 同じ環境・同じ起動・同じ名前空間で同じ番号・同じ起動の時刻のプロセスがあれば動いている(`alive`)。
|
|
830
|
+
同じ環境で、OS が起動し直した・その番号のプロセスが無い・番号が使い回されている(起動の時刻が違う)なら終わっている(`dead`)。
|
|
831
|
+
記録が無い(以前の run)・別の環境(別のマシン・作り直したコンテナ)・別の名前空間(起動し直したコンテナ・サンドボックス)・
|
|
832
|
+
Linux 以外で起動の時刻を確かめられないときは分からない(`unknown`)。確かめられないものを終わっているとはしない
|
|
833
|
+
- 回復: `dead` の run(最新でなくても)を、要望ごとのロックの中で読み直してから `failed` にする(`error` は「中断しました: <理由>」、
|
|
834
|
+
`interrupted` に理由と日時、`finishedAt` とログ)。serve が開いたとき(通常の serve の起動、`--all-projects` で開いたとき)に
|
|
835
|
+
全部の要望を確かめ(`recover`。1件の失敗はログに残してほかを続ける。起動は待たない)、開始・準備の前(`busy`)にもその要望を確かめる。
|
|
836
|
+
読むだけの `pulse` は書かない
|
|
837
|
+
- 始めるかどうか(`busy`)は時間を見ない: このプロセスで実行中・local が待っている・`alive`・`unknown` なら断り、理由を出す
|
|
838
|
+
- 終わり方(`finishLocked`): ファイルの run が既に終わっていれば(別のプロセスが中断にした・取り消した)上書きしない。要望の
|
|
839
|
+
ステータスは、その run が最新(`lastPreflight`)で、要望がまだ評価中のときだけ `before` から戻す(古い run の終わりで新しい run と
|
|
840
|
+
要望の状態を巻き戻さない)。`before` の無い以前の run では要望のステータスを変えない。実行(`execute`)の終わりもロックの中で行う
|
|
841
|
+
(ロックを取れなければ、同じ規則でロックなしに記録だけ残す)
|
|
842
|
+
- 限界: `unknown` の run は自動では中断にしない(コンテナの起動し直しで残った run もこちら。名前空間が変わるので、前のプロセスが
|
|
843
|
+
終わったと確かめられない)。動いていないことを人が確かめて中断にする操作が要る。Linux 以外は起動の時刻を見られないので、
|
|
844
|
+
プロセスが無いときだけ `dead` になる
|
|
726
845
|
- ファイル契約なので、Mock エンジンでも人手で書いても同じ取り込み処理になる。案の `supersedes` のうち同じ要望に無いタスクはタスク化のときに捨てる
|
|
727
846
|
- テストは偽の app-server で、マウントの引数・指示文・記録・根拠の扱いを確かめる。本物の Codex が実際にどこまで読むか、
|
|
728
847
|
読むだけのマウントへの書き込みが拒まれることは、偽の app-server では確かめられない
|
|
@@ -830,6 +949,24 @@ package.json では公開版の版の範囲(`^0.2.0` など)で指定し、
|
|
|
830
949
|
失敗した段(docker が無い / デーモン / 作成 / 版の取得)ごとに次にすることを出す(`src/core/preflight/codexImage.ts`)
|
|
831
950
|
- テストは偽の docker(`test/fixtures/fake-docker.mjs`)で行い、本物の Docker では次で確かめる:
|
|
832
951
|
`XDG_CONFIG_HOME=$(mktemp -d) p3 codex update --json`(未登録・未認証のままでよい)
|
|
952
|
+
- P3 は `ensureImage` そのものは呼ばない(inspect・build・版の確認のどれにも待つ時間の上限が無く、取消も受けないため)。同じ判定と
|
|
953
|
+
ビルドを、同梱の `DOCKER_CONTEXT` と `parseCreated` を使って `codexImage.ts` で行う(Dockerfile は写さない)
|
|
954
|
+
- **Docker の待ち時間の上限と後片付け**(`src/core/preflight/docker.ts`): 以前は版の確認のコンテナ(`codex --version`)が版を出した後も
|
|
955
|
+
終わらず、Preflight がそれを待って止まったことがある(2026-11-03)。P3 が動かす docker の操作には上限があり、時間切れ・中止では
|
|
956
|
+
docker の CLI を止め、P3 が名前を付けて起こしたコンテナはそのコンテナだけを `docker rm -f <名前>` で消す(`docker ps` の全部や
|
|
957
|
+
イメージ名では消さない)
|
|
958
|
+
- 上限(`DOCKER_LIMITS`): デーモンに聞くだけの操作(version・image inspect)15 秒、版の確認 60 秒、ビルド 10 分、コンテナを消す 10 秒。
|
|
959
|
+
評価の1ターンは codex-workspace の既定の 30 分、初期化・使用量などターンの外の要求は同じく 120 秒(`requestTimeoutMs` の既定)
|
|
960
|
+
- イメージの確認の時間切れは「イメージが無い」とみなさない(作り直しに進まない)
|
|
961
|
+
- 名前とラベル: 版の確認は `p3-codex-version-<ランダム>`、評価は `p3-preflight-<ランダム>`、Preflight 以外の頼みごと(リリースノート
|
|
962
|
+
の要約)は `p3-ask-<ランダム>`。ラベルは `infodb.p3=<種類>`(人が `docker ps -a --filter label=infodb.p3` で見分けるため)
|
|
963
|
+
- 片付け: 版の確認は、時間切れ・中止・失敗のときにそのコンテナを消す(正常に終われば `--rm` が消す)。評価のコンテナは、正常・失敗・
|
|
964
|
+
中止・時間切れのどの終わり方でも、終わった後に消す(正常に終わったときは `--rm` の削除の途中のことがあるので、消せなかったときだけ
|
|
965
|
+
記録に出す)。消せない・時間切れなら「残っているかもしれない」と、確かめ方と消し方を run のログに出す(消えたとは断定しない)
|
|
966
|
+
- 中止: 中止すると `turn/interrupt` を送る。app-server が答えなければ 15 秒(`abortGraceMs`)で打ち切り、app-server を閉じ
|
|
967
|
+
(codex-workspace が最長 30 秒待って止める)、コンテナを消す。中止から終わるまで最長でおよそ 1 分。イメージの用意の途中の中止も戻る
|
|
968
|
+
- 限界: Docker のデーモンが止まっている・応答しないときは消せない(記録に残す)。起動の途中で中止して、まだコンテナができていなければ
|
|
969
|
+
消すものは無い。描画のコンテナ(下の「画面イメージの描画のイメージ」)は対象外
|
|
833
970
|
|
|
834
971
|
手元の llmcs の変更を P3 で試すときは、一時的にリンクに替え、試し終えたら公開版に戻す(リンクはコミットしない):
|
|
835
972
|
|
|
@@ -849,7 +986,7 @@ Dockerfile(`src/core/preflight/render-image/`)で作る。llmcs の Dockerfi
|
|
|
849
986
|
Playwright が入っても、それだけでは描画の安全の条件(ネットワークなし・認証情報なし・リポジトリなし・原稿は読むだけ)を
|
|
850
987
|
満たさないので、描画は別のコンテナで行う。
|
|
851
988
|
|
|
852
|
-
- 版: Playwright 1.63.0(Chromium の headless shell)、Node
|
|
989
|
+
- 版: Playwright 1.63.0(Chromium の headless shell)、Node 26(`node:26-bookworm-slim`)、`fonts-noto-cjk`。
|
|
853
990
|
Playwright はイメージの中で npm から入れる(P3 の依存には足さない)。版は公開から1日を過ぎたものに固定する
|
|
854
991
|
- イメージの名前は資材(`Dockerfile`・`fonts-ja.conf`・`render.mjs`。`render.ts` の `RENDER_IMAGE_FILES`)の中身の hash
|
|
855
992
|
(`infodb-p3-render:<12桁>`)。どれかが変われば(フォントの設定だけでも)次の描画で作り直す。
|
|
@@ -897,6 +1034,11 @@ Playwright が入っても、それだけでは描画の安全の条件(ネッ
|
|
|
897
1034
|
ドキュメントは古いまま残ることがあるので、今のコードと食い違えば今のコードを正として評価・タスク案を作らせ、見つけた食い違いは
|
|
898
1035
|
黙って片方に合わせず、すべてリスクか確認事項に書かせる(`instructions.ts` の「やること」。過去の記録と今のコードの食い違いも同じ扱い)。
|
|
899
1036
|
`preflight.instructions` にはプロジェクト固有の評価の観点・制約を書く。どちらも Codex への指示に加わる。
|
|
1037
|
+
`preflight.runner`(`codex` / `agent`。`src/shared/preflightRunner.ts`)は Preflight の担当で、AI 向けの手順が `whoami --json` の
|
|
1038
|
+
`preflight` から読む方針(評価のエンジン・run の `engine` とは別。P3 の実行の仕方は変えない)。未設定は `codex`、読めない値は
|
|
1039
|
+
`invalidRunner` に残して担当を決めない(保存しても消さない。`config set preflight.runner=` で直す)。保存(`saveProject`)は
|
|
1040
|
+
`preflight` を項目ごとに重ねるので、観点だけ・担当だけの更新(以前の API の形 `{ instructions }` も)で、もう片方は消えない。
|
|
1041
|
+
個人(マシン)の設定での上書きは設けない。
|
|
900
1042
|
|
|
901
1043
|
## 共有(同期)の方法
|
|
902
1044
|
|
|
@@ -936,17 +1078,18 @@ Playwright が入っても、それだけでは描画の安全の条件(ネッ
|
|
|
936
1078
|
- 作業の単位は要望。タスクは `p3` CLI(入っていなければ `pnpx @infodb/p3`)で操作し、`--json` で結果を読むこと(データのフォルダを直接編集しない)。
|
|
937
1079
|
詳しい手順はスキル `.claude/skills/p3/SKILL.md`(Claude Code)・`.agents/skills/p3/SKILL.md`(Codex)。中身は同じ
|
|
938
1080
|
- 変更するときは環境変数 `P3_ACTOR=ai:<エージェント名>` を付ける
|
|
939
|
-
- 操作する要望は `--req <要望ID>` で指定する(要望の作業ツリーの中なら省ける)。まず `p3 whoami --json`
|
|
1081
|
+
- 操作する要望は `--req <要望ID>` で指定する(要望の作業ツリーの中なら省ける)。まず `p3 whoami --json` で確かめる(Preflight の担当 `preflight.runner` も出る)
|
|
940
1082
|
- `whoami` の `via`(プロジェクトの決まり方)が `cwd` でなければ(`dir` / `project` / `legacy` / `only`)、それ以上 p3 を操作せず、対象のプロジェクトでよいか人に確かめる(推測した `--project` / `--dir` で避けない。人が指定・確認した後はその対象のまま続ける)
|
|
941
1083
|
- プロジェクトが無い・未登録のときは `p3 init` / `p3 join` を自分から実行せず、新しく作る(`init`)のか共有されたものに参加する(`join`)のかを人に確かめる
|
|
942
1084
|
- 新しい作業を頼まれたら `p3 request new "<タイトル>" --body "..."` で要望を登録し、ID を伝えて終える。
|
|
943
|
-
Preflight(`preflight
|
|
944
|
-
-
|
|
1085
|
+
Preflight(`preflight`)は自分から始めない(勧めない・尋ねない)。タスク化(`accept`)は人が行う(結果を `p3 drafts` で読むのと、頼まれたメモの保存 `--note-only` はよい)
|
|
1086
|
+
- Preflight を頼まれたら、担当(`whoami --json` の `preflight.runner`)で分ける。`codex`: 人が `p3 preflight` か画面で実行する(AI は `--prepare` の無い `p3 preflight` をしない)。人がチャットで対象の要望の手元の評価を明示的に頼んだときだけ手元で評価し、「Preflight して」とだけなら、人が実行するのか手元で評価するのかを確かめる。`agent`: 人に「Preflight して」と頼まれたら手元で評価する(「このチャットで」は求めない)。`null`(読めない): `agent` と推測せず `problem` を伝え、`codex` と同じ扱い。子の要望も同じ。対象の要望が分からなければ確かめる
|
|
1087
|
+
- 手元の評価: `p3 preflight <要望ID> --prepare --json` → 返った指示のファイル(`instructions`)を最後まで読み、書くのは返った run の成果物(`outputs`)だけ → `p3 preflight <要望ID> --complete --run <run> --json` → `p3 drafts` の結果を伝えて終える(自分から始めない。タスク化 `accept` と着手はしない)
|
|
945
1088
|
- 着手する前に `p3 show T003 --brief --json` で本文・依存とその状態(`dependencies`)・置き換えの注意(`warnings`)を読む
|
|
946
1089
|
- 着手する前に、`--brief --json` の `work`(作業先のリポジトリとブランチ)を見て、そのリポジトリでブランチに入る(作業先なしなら移動しない)
|
|
947
1090
|
- 着手するときは `p3 move T003 doing`。テストを通したら、コミットする前に `p3 move T003 done --output <今ある成果物(変えたファイルや説明)> --record -` で完了にする(変更の記録は必須: 何を変えたか・なぜ・入れた決まり・やめたもの を標準入力から Markdown で。まだ無い URL は書かない)
|
|
948
1091
|
- 要望のタスクを全部終えたら、コミットする前に `p3 request set <要望ID> status=resolved`(対応済)にする。完了済(done)・見送り(rejected)とタスクの済み(check)は人が決める
|
|
949
|
-
- 子の要望(`parent` のある要望)は、親とは別の要望として子ごとのタスクとブランチで作業する(親のタスクにしない)。分割の案の採用(`accept
|
|
1092
|
+
- 子の要望(`parent` のある要望)は、親とは別の要望として子ごとのタスクとブランチで作業する(親のタスクにしない)。分割の案の採用(`accept`)は人が行う。子の Preflight は親と同じ担当で、頼まれたときだけ(分割の採用・子の作成から自分で評価へ進まない)。親を対応済にするのは、親のタスクと見送り以外の子(`request show <親> --brief --json` の `children`)が全部終わってから
|
|
950
1093
|
- データのフォルダがこの作業ツリーの中で git 管理されているなら、要望のフォルダ(`requests/<要望ID>/`)の変更も実装と同じコミットに入れる(後のレビューで要望とやったことを精査するため。子なら祖先の要望のフォルダ、親を対応済にするときは子孫の要望のフォルダ(見送りの子など)のまだ入っていない変更も入れ、ほかの要望・関係ない変更は入れない。外・無視・worktree のときは入らないので、移動や `git add -f` はしない)。push に失敗したら完了の記録は残し、公開できていないことを伝える。要望のフォルダは、マージするまで要望のブランチにしか無い。既定のブランチに切り替えると、その要望(子なら親の子の一覧からも)が消えたように見えるが、データはブランチにある(作り直したり、別のブランチから写したりしない)
|
|
951
1094
|
- コミットや PR の URL は後から `p3 move T003 done --output <URL>` で足す(完了・記録はそのまま。データをコミットしているなら追記もコミットして push)。複数のリポジトリにまたがるときは最後のタスクに `--repo-output <参照先>=<PR の URL>` で全部の PR を残す
|
|
952
1095
|
- 置き換えられたタスク(`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
|
|
@@ -66,11 +66,21 @@ pnpm video # 使い方の動画を録り直す(.p3-video/p3-
|
|
|
66
66
|
Codex がスキルを探す場所は公式の文書(<https://developers.openai.com/codex/skills/> の「Where Codex loads local skills」)
|
|
67
67
|
- 手元の対話エージェントの Preflight(`--prepare` / `--complete`)は、CLI と取り込みを別プロセスのテストで確かめる
|
|
68
68
|
(`test/localPreflight.test.ts`。PATH を空にして Codex・Docker・claude を呼べない状態で通す)。Claude Code が同梱のスキルを見つけて
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
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>)
|
|
73
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 を落とさないため)。退行は差し替えた監視のテストが見る
|
|
74
84
|
- `test/layers.test.ts` が src の層の依存の向き、`test/package.test.ts` が配布物の中身と文書のリンクを確かめる
|
|
75
85
|
- 短い出力の量を測るときは:
|
|
76
86
|
|
|
@@ -214,7 +224,7 @@ test/ ユニットテスト
|
|
|
214
224
|
| 同梱しないもの | `.env`・個人設定・デモデータ(`.p3-demo/`)・テスト・`scripts/`・TypeScript のソース(`src/`)・開発用のスキル(`.claude/`) |
|
|
215
225
|
| 実行時の依存 | `hono`・`@hono/node-server`・`yaml`・`zod`・`@infodb/codex-workspace`・`@infodb/chatgpt-plan`。`tsx`(esbuild)と React などの画面の部品は開発用 |
|
|
216
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 で追跡しない |
|
|
217
|
-
| Node | `>=
|
|
227
|
+
| Node | `>=24`(`@infodb/codex-workspace`・`@infodb/chatgpt-plan` の `>=22` を満たす)。開発と Docker のイメージは Node 26 |
|
|
218
228
|
| 公開前のビルド | `prepack` で `pnpm build`。利用者が入れるときにはビルドも Docker の操作もしない |
|
|
219
229
|
| bin | `p3`(`bin/p3.mjs`)。`src/cli/main.ts` があるチェックアウトでは tsx でソースを、無ければ(配布物)`lib/cli/main.js` を動かす。ソースを動かすときは今いる場所の `tsconfig.json` を読まない。`INIT_CWD` に戻るのは P3 自身の `pnpm p3` スクリプトのときだけ |
|
|
220
230
|
|
|
@@ -227,10 +237,10 @@ P3_CODEX_PATH_MAP=/workspaces=/home/me/workspaces pnpm verify:pack --docker --re
|
|
|
227
237
|
|
|
228
238
|
## Docker のイメージ
|
|
229
239
|
|
|
230
|
-
`Dockerfile`(Docker Hub の `tamuto/p3`。ビルドは Node
|
|
231
|
-
|
|
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`
|
|
232
242
|
(git・依存・ビルドの出力・データ・個人設定・認証・テストを入れない)。約束は `test/docker.test.ts` が確かめる。
|
|
233
|
-
ベースの Node
|
|
243
|
+
ベースの Node はメジャー版(ビルドも実行も `node:26-bookworm-slim`。描画のイメージも同じ)だけを指定し、同じメジャーの中の更新(セキュリティ
|
|
234
244
|
リリースなど)は作り直すと入るようにしている。ただし Docker は手元にあるベースをそのまま使う(キャッシュ)ので、作るときは
|
|
235
245
|
`--pull` を付けて今のベースを取る(`scripts/verify-docker.mjs` も付ける。`--no-build` は作らずに既にあるイメージを確かめる)。
|
|
236
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
|
### 参照先と作業先
|
|
@@ -337,18 +375,29 @@ p3 accept k7m3x # 人がタスク化
|
|
|
337
375
|
- 画面イメージの原稿(`ui/src/*.html`)があるときだけ、取り込みのときに P3 が描画のコンテナ(Docker)で PNG にする。Docker が
|
|
338
376
|
使えなくても評価は残し、必要な画面イメージが足りなければ go を clarify にする(Codex のときと同じ)。原稿が無ければ Docker は使わない
|
|
339
377
|
- やめるとき・放置した run は `p3 preflight <要望> --cancel --run PF-...`(取り消し。成果物のファイルは残る)。要望の状態は元に戻る。
|
|
378
|
+
手元のエージェントの run は、P3 がプロセスの終わりを見て中断にすることはない(プロセスを跨いで評価を待つため)
|
|
340
379
|
どの run が待っているかは `p3 drafts <要望>`(最新の run)か、始められなかったときのメッセージに出る
|
|
341
380
|
- 評価のあとで要望を変えたら、通常の Preflight と同じくその評価からはタスク化できない(後の「要望の本文を変えたとき」)
|
|
342
381
|
- 手元のエージェントにはコンテナの囲いが無い。参照先を読むだけにすること・書き込みを run の成果物に限ることは指示で伝えるだけで、
|
|
343
382
|
P3 は止められない(エージェントの権限の設定で守る)。どの程度の利用枠を使うかはエージェント側の契約による
|
|
344
383
|
|
|
345
384
|
**Claude Code のチャットで頼む**: 上の手順は、同梱のスキル(`.claude/skills/p3/SKILL.md`。後の「AI エージェントから使う」)に書いてある。
|
|
346
|
-
|
|
385
|
+
頼み方はプロジェクトの Preflight の担当(上の「Preflight の担当」)で変わる。エージェントは `p3 whoami --json` で担当を読む。
|
|
347
386
|
|
|
348
387
|
```text
|
|
388
|
+
# 担当が agent のとき(Codex を使えない環境): 対象の要望を挙げて頼めばよい
|
|
389
|
+
要望 261009-k7m3x の Preflight をして
|
|
390
|
+
|
|
391
|
+
# 担当が codex のとき: 手元で評価してほしいことをはっきり頼む(「Preflight して」とだけ頼むと、p3 で実行するのか手元で評価するのかを聞き返す)
|
|
349
392
|
要望 261009-k7m3x の Preflight を Claude Code のこのチャットで実行して
|
|
350
393
|
```
|
|
351
394
|
|
|
395
|
+
- どちらの担当でも、エージェントは評価を取り込んで `p3 drafts` の要約を伝えたところで止まる。タスク化(`accept`)と着手は人が案を
|
|
396
|
+
確かめてから。要望の登録やタスクの作業のついでに、エージェントから Preflight を始めたり勧めたりはしない。子の要望も同じ
|
|
397
|
+
- 担当を変えても、置いたスキルと AGENTS.md の節は置き直さなくてよい(実行のたびに `whoami` で読む)。以前の版のスキルを置いている
|
|
398
|
+
リポジトリは、`p3 agents claude|codex|both` で同梱の版との違いを確かめ、最新にするなら選んだ先だけ `--force` で置き換える
|
|
399
|
+
(ほかの文は残す。後の「AI エージェントから使う」)
|
|
400
|
+
|
|
352
401
|
- Claude Code はスキルに従って `--prepare` → 指示のファイルを読んで評価し、成果物を書く → `--complete` → `p3 drafts` の要約を返す、
|
|
353
402
|
までを同じチャットで行う。タスク化(`accept`)とタスクの着手はしない(人が `p3 drafts` か画面で案を確かめてから `p3 accept`)。
|
|
354
403
|
明示の依頼が無ければ(要望の登録だけなど)Preflight は始めない
|
|
@@ -430,6 +479,20 @@ Preflight は始めたときの内容を固定して評価する。**評価の
|
|
|
430
479
|
project.yaml に無いリリースノートは最後。リリースノートの画面は、指定(`?m=`)が無ければ先頭を開く
|
|
431
480
|
- project.yaml の順は表示のために変えない(足した順のまま)。マイルストーンのタブは開いたときに降順に並べ、編集の間は行を動かさない
|
|
432
481
|
(ID を書き換えても、足した行は最後のまま)。保存すると並べ直す
|
|
482
|
+
- **目的と予定している機能・目標**: マイルストーンごとに、目指すこと(目的。複数行)と予定している機能・目標の一覧を書ける。
|
|
483
|
+
どちらも任意で、片方だけでもよい。リリース済みにした後も、いつでも書き足し・直しができる。マイルストーンのレビューは、
|
|
484
|
+
その時点で保存してある目的・予定機能を所属する要望と比べる(画面で書きかけの内容は使わない)
|
|
485
|
+
|
|
486
|
+
```bash
|
|
487
|
+
p3 milestone purpose v0.2 --file 目的.md # 目的を保存する(--body 本文|- でも。--off で外す)
|
|
488
|
+
p3 milestone goal add v0.2 "通知の再送" # 予定機能を足す(G1, G2, ... の ID が付く)
|
|
489
|
+
p3 milestone goal set v0.2 G1 "通知の再送と失敗の記録"
|
|
490
|
+
p3 milestone goal rm v0.2 G2
|
|
491
|
+
p3 milestone show v0.2 # 目的・予定機能を読む(--json は版 milestonesVersion も)
|
|
492
|
+
```
|
|
493
|
+
|
|
494
|
+
予定機能の ID は足したときに振り、並べ替えや文言の変更で振り直さない(消した番号も、残っている最大の番号より小さければ
|
|
495
|
+
使わない)。目的は 4000 文字、予定機能は 50 件・1件 500 文字まで。空の予定機能・重複した ID は保存を断る
|
|
433
496
|
- **タグ**(`tags`): 外部 ID や分類の自由な文字列(例 `jira:PROJ-123`、`group:顧客A`)。同じ値を複数の要望に付けてグループにできる。
|
|
434
497
|
要望・タスクの参照の代わりにはせず、外部のシステムとは同期しない
|
|
435
498
|
- CLI: `request new --tag 値`(繰り返し可。カンマで分けない)、`request set <要望> --tag 値 ...`(この並びに置き換える)、
|
|
@@ -561,6 +624,43 @@ p3 release-notes export v0.2 > RELEASE.md # 公開する本文だけ(出
|
|
|
561
624
|
壊すと「読めない」と出て、直すまで新しく保存しない。ノートのあるマイルストーンは消せない。保存の形と直し方は
|
|
562
625
|
[docs/architecture.md](architecture.md#リリースノートのデータ)
|
|
563
626
|
|
|
627
|
+
### マイルストーンレビュー
|
|
628
|
+
|
|
629
|
+
マイルストーンの目的・予定している機能([タグ・期限・マイルストーン](#タグ期限マイルストーン))に対して、Preflight と同じく Codex が
|
|
630
|
+
参照先のリポジトリのコードと git の履歴を読み、実際にできあがったものが目的を果たしているか・何が足りないか・目的に無い変更
|
|
631
|
+
(意図しない変更)が入っていないかを確かめる。コードの品質の審査ではなく、機能の意図と目的に照らした確認。任意のときに何度でも
|
|
632
|
+
実行でき、実行しなくても要望の完了やリリースノートの操作には影響しない。結果は参考の記録で、リリースするかは人が読んで決める。
|
|
633
|
+
|
|
634
|
+
```bash
|
|
635
|
+
p3 milestone review v0.2 # 実行して終わるまで待つ(進み具合は stderr。Ctrl-C で取り消す)。--engine mock は評価しない試し用
|
|
636
|
+
p3 milestone reviews v0.2 # 履歴(新しい順。状態・日時・判定の数)
|
|
637
|
+
p3 milestone review-show v0.2 <run> # 1回分(評価したときの目的・材料・全体の所見・予定機能ごとの判定)
|
|
638
|
+
p3 milestone review-cancel v0.2 <run> # 取り消す(ほかのプロセスの実行なら取消を頼む)
|
|
639
|
+
```
|
|
640
|
+
|
|
641
|
+
- **確かめる対象**: 参照先のリポジトリ(`p3 repo path` で登録したこのマシンのパス。Preflight と同じ)を、そのときの作業ツリーのまま
|
|
642
|
+
読むだけで渡す。実行したときの HEAD・ブランチ・未コミットの変更の数と、タスクの成果物に残したコミット(`…/commit/<sha>`)が
|
|
643
|
+
履歴にあるかを記録する。読める参照先が無ければ警告し、記録だけの点検になる(そのときは「達成」と判定しない)
|
|
644
|
+
- **手がかり**: 保存してある目的・予定機能(画面の書きかけは使わない)と、マイルストーンに直接属する要望の全部(見送り・未完了も)の
|
|
645
|
+
本文、各タスクの本文・状態・変更の記録・成果物の参照。タスクの記録は実装した人(AI を含む)の自己申告なので、どこを見るかの
|
|
646
|
+
手がかりにし、書いてあることはコードと履歴で確かめる。別のマイルストーンの親・子は文脈として渡すだけで成果に数えない。
|
|
647
|
+
アーカイブした要望は含めない。成果物の URL や添付の中身は読まない
|
|
648
|
+
- **結果**: 全体の所見と、予定機能ごとの判定(達成・一部達成・未達成・判断材料不足)・理由・根拠・不足していること、目的・予定機能に
|
|
649
|
+
無い変更(意図しない変更の候補)。根拠はコードの場所(`<参照先>:<パス>`・`<参照先>@<コミット>`)と要望・タスクの ID で、
|
|
650
|
+
「達成」にはコードの根拠が要る(記録だけで達成とした結果や、参照先に無いパス・コミットを挙げた結果は使わず、失敗にする)。
|
|
651
|
+
予定機能が無く目的だけなら、目的そのものを判定する。目的も予定機能も無ければ実行できない(先に書く案内が出る)。要望が 0 件でも
|
|
652
|
+
実行でき、材料が無いことを記録する。タスクの完了数で達成を決めず、数値の達成率は出さない
|
|
653
|
+
- **確かめないこと**: テストやアプリを実際に動かすこと・公開されたか。結果の「範囲」にも書く
|
|
654
|
+
- **頼む先**: Preflight と同じ Codex の接続(ChatGPT プラン)。参照先は読むだけでマウントし、データのフォルダは渡さない。コードを読むので
|
|
655
|
+
Preflight と同じくらい時間がかかる(上限 20 分)。失敗(認証なし・使用量の上限・時間切れ・形の違う結果)は失敗として記録し、
|
|
656
|
+
前の成功結果はそのまま読める
|
|
657
|
+
- **同時に**: 同じマイルストーンで実行できるのは1つだけ(別の serve・CLI からも)。別のマイルストーンは同時に実行できる
|
|
658
|
+
- **止まった実行**: 実行していたプロセスが落ちたと確かめられれば自動で失敗にする。別のマシン・コンテナで始めたなどで確かめられない
|
|
659
|
+
ときは実行中のまま残るので、止まっていると確かめてから `p3 milestone review-cancel <id> <run> --acknowledge-stopped`(画面では
|
|
660
|
+
「止まっていることを確かめて中断」)で中断にする(記録を終えるだけで、ほかの環境のプロセスを止めたとは限らない)
|
|
661
|
+
- **履歴**: `<データのフォルダ>/milestone-reviews/<マイルストーン>/<run>/` に、比べた材料と結果をそのまま残す。後で目的や要望を
|
|
662
|
+
直しても過去の記録は変わらない。履歴のあるマイルストーンは消せず、ID も変えられない
|
|
663
|
+
|
|
564
664
|
### 添付と画面資料
|
|
565
665
|
|
|
566
666
|
**添付**: 要望に PNG / JPEG / xlsx を付けて Preflight に渡す(今の画面のスクリーンショット・仕様書の Excel)。P3 は対象のアプリを
|
|
@@ -629,7 +729,7 @@ p3 render 画面.html --width 1280 # 画面.png ができる(幅 32
|
|
|
629
729
|
| `/requests/<要望>` | 要望の概要(タイトル・本文・期限・マイルストーン・タグ・親子・添付)と Preflight(`?run=PF-...` で過去の評価)。子の要望は見出しの上に祖先へのリンク |
|
|
630
730
|
| `/requests/<要望>/board` | タスクボード(V 字。ドラッグで列を移動。完了のカードの「✓ 済み」でボードから外す。「+ タスクを追加」で直接作る) |
|
|
631
731
|
| `/requests/<要望>/done` | 対応済み(済みにしたタスクと成果物の一覧。要望の「対応済」とは別) |
|
|
632
|
-
| `/release-notes` |
|
|
732
|
+
| `/release-notes` | マイルストーンの管理(既定)・リリースノート(`?tab=notes&m=<マイルストーン>`)・マイルストーンレビュー(`?tab=review`、記録は `&run=<run>`)。下の「リリースノートの画面」 |
|
|
633
733
|
| `/settings` | 個人(ChatGPT の接続・テーマ)/ プロジェクトの基本 / 参照先(`?tab=personal|project|repos`) |
|
|
634
734
|
|
|
635
735
|
要望の中のページでは `?task=T003` でタスク詳細を重ねて開く。どのタブでも、見出しのタイトルの上に要望 ID と「コピー」が出る
|
|
@@ -649,8 +749,8 @@ Clipboard API が無い)ときはそう出るので、ID をクリックして
|
|
|
649
749
|
|
|
650
750
|
印をクリックするとタスクの詳細が開く。ズーム(日 / 週 / 月)と「今日」ボタンで動かす。
|
|
651
751
|
|
|
652
|
-
**リリースノートの画面**(ヘッダーの「リリースノート」):
|
|
653
|
-
(`?tab=
|
|
752
|
+
**リリースノートの画面**(ヘッダーの「リリースノート」): タブで「レビュー」「リリースノート」「マイルストーン」を切り替える
|
|
753
|
+
(`?tab=review` がレビューのタブ、`?tab=notes` がノートのタブ。無い・ほかの値はマイルストーン(管理)のタブ。タブを移っても `?m=` の選択と、書きかけの入力は残る。
|
|
654
754
|
保存していない変更があるタブには ● が付く)。
|
|
655
755
|
|
|
656
756
|
**マイルストーンのタブ**: ID・名前・期限・リリース済み・属する要望の数を一覧で直し、「+ マイルストーンを追加」で足す(0 件から作れる)。
|
|
@@ -660,10 +760,30 @@ Clipboard API が無い)ときはそう出るので、ID をクリックして
|
|
|
660
760
|
ノートの保存や要望の一括完了でもリリース済みは変わらない(どれも別の操作)
|
|
661
761
|
- 要望が使っている・ノートのあるマイルストーンは、ID を変えられず消せない(理由が行に出る。CLI の `milestone rm` と同じ規則で、
|
|
662
762
|
画面が古くても保存のときに止まり、理由が出る)。保存できなかったときは入力が残るので、直して保存し直す
|
|
663
|
-
-
|
|
763
|
+
- レビューの履歴のあるマイルストーンも、ID を変えられず消せない(理由が行に出る)
|
|
764
|
+
- 行の「目的・予定機能」を開くと、目的と予定している機能・目標を直せる(「+ 予定機能を追加」・行ごとの「削除」。保存は
|
|
765
|
+
ほかの項目と同じ「保存」)。閉じた行には目的・予定機能の有無と件数が出る
|
|
766
|
+
- 編集中にほかで変わったら、入力を残して知らせる(「入力を捨てて最新を読み直す」)。そのまま保存すると、編集を始めた後に
|
|
767
|
+
変わったとして断られ(入力は残る)、ほかの変更を上書きしない。保存するのはマイルストーンだけで、
|
|
664
768
|
設定の「プロジェクトの基本」(名前・説明など)とは互いに巻き戻さない
|
|
665
769
|
- project.yaml に無いマイルストーンのノートは、管理のタブでは定義として出さずに知らせる(ノートのタブで読める)
|
|
666
770
|
|
|
771
|
+
**レビューのタブ**: 左でマイルストーンを選ぶ(レビューの履歴だけが残る、project.yaml に無いマイルストーンも出る)。右に:
|
|
772
|
+
|
|
773
|
+
- **評価する内容**: 保存してある目的・予定している機能、所属する要望の件数と状態、別のマイルストーンの親子の数、確かめるコード
|
|
774
|
+
(参照先ごとのブランチと HEAD・未コミットの変更・タスクに残したコミットの数。読めない参照先はその理由)、範囲と警告。
|
|
775
|
+
「目的・予定機能を書く・直す」で「マイルストーン」タブへ移る。そのタブに保存していない変更があれば、レビューは保存した内容で
|
|
776
|
+
行うと知らせる。目的も予定機能も無ければ書き方を案内し、「レビューを実行」は押せない
|
|
777
|
+
- 「レビューを実行」(履歴があれば「もう一度実行」)で始め、実行中は進み具合と「取消」が出る。実行しているプロセスを確かめられない
|
|
778
|
+
実行には「止まっていることを確かめて中断」が出る(記録を終えるだけで、ほかの環境のプロセスを止めるとは限らない)
|
|
779
|
+
- **最新の実行**(実行中・失敗・取消のとき)と **最後の成功結果** を分けて出すので、実行中や失敗の後も前の結果を読める。結果は全体の所見と、
|
|
780
|
+
予定機能ごとの判定(達成・一部達成・未達成・判断材料不足)・理由・根拠(コードの場所とコミット、今の要望・タスクへのリンク)・
|
|
781
|
+
不足していること、目的・予定機能に無い変更(意図しない変更の候補)・範囲。「評価したときの材料」を開くと、そのときの目的・予定機能・
|
|
782
|
+
参照先のコード(HEAD とタスクのコミット1件ずつ)・要望とタスクの文面(本文・変更の記録・成果物)を読める(後で直したり消したりしても残る)。評価した後に目的や要望、参照先の
|
|
783
|
+
HEAD・未コミットの変更が変わっていれば知らせ、「今の内容でもう一度実行」できる
|
|
784
|
+
- **履歴**: 日時・状態・判定の数・評価した目的と予定機能を選んで読める(URL の `?run=` で開ける)。読めない記録も「読めない記録」として出す
|
|
785
|
+
- どの結果でも、要望の完了・リリースノートの保存・リリース済みの操作は今までどおりできる(レビューは参考の記録)
|
|
786
|
+
|
|
667
787
|
**リリースノートのタブ**: 左でマイルストーンを選ぶ(ノートの有無と要望の数)。右に:
|
|
668
788
|
|
|
669
789
|
- **このマイルストーンの要望**: 状態・収録 / 対象外(理由)・変更の記録の数・警告(未完了・記録なし・状態の食い違い)。
|
|
@@ -789,11 +909,12 @@ AI にも CLI を使わせる(認証を持たせずに済む)。`p3 init --a
|
|
|
789
909
|
| `p3 init` / `p3 join` / `p3 project` / `p3 whoami` | 新しく作る / 共有されたものに参加する / 個人設定のプロジェクト / 今の判定 |
|
|
790
910
|
| `p3 config` / `p3 repo` / `p3 user-config` | プロジェクトの設定 / 参照先 / 個人設定(テーマ・マシンごとの設定) |
|
|
791
911
|
| `p3 progress` | 要望ごとの進捗(マイルストーンごと。`--all` で完了・見送りも) |
|
|
792
|
-
| `p3 milestone ls\|add\|set\|rm` |
|
|
912
|
+
| `p3 milestone ls\|show\|add\|set\|rm\|purpose\|goal` | マイルストーン(目的・予定している機能も) |
|
|
913
|
+
| `p3 milestone review\|reviews\|review-show\|review-cancel` | マイルストーンレビュー |
|
|
793
914
|
| `p3 release-notes ls\|show\|generate\|save\|export` | マイルストーンのリリースノート(要約の生成・保存・本文の出力) |
|
|
794
915
|
| `p3 request new\|ls\|show\|set\|archive` | 要望 |
|
|
795
916
|
| `p3 ls` / `p3 show` / `p3 find` | タスクの一覧(`--all` で全要望)/ 詳細(`--brief`)/ 参照・タイトルで探す |
|
|
796
917
|
| `p3 new` / `p3 set` / `p3 move` / `p3 check` / `p3 archive` | タスクを足す / 直す / 状態を変える / 済みにする / アーカイブ |
|
|
797
|
-
| `p3 preflight` / `p3 notes` / `p3 drafts` / `p3 accept` | Preflight の実行(`--note`。手元のエージェントなら `--prepare` / `--complete
|
|
918
|
+
| `p3 preflight` / `p3 notes` / `p3 drafts` / `p3 accept` | Preflight の実行(`--note`。手元のエージェントなら `--prepare` / `--complete`。中断は `--cancel --run`)/ メモ / 評価とタスク案 / タスク化 |
|
|
798
919
|
| `p3 attach` / `p3 render` | 添付 / 画面イメージの描画 |
|
|
799
920
|
| `p3 chatgpt` / `p3 codex update` / `p3 serve` | ChatGPT の接続 / Codex のイメージ / 画面(`--all-projects` で登録したプロジェクトを跨ぐ) |
|