@infodb/p3 0.13.0 → 0.14.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/bin/p3.mjs +3 -2
- package/dist/web/assets/{CompletionReview-gZKZrDu_.js → CompletionReview-BD7d6Yzt.js} +1 -1
- package/dist/web/assets/ImprovementDialog-BoAZN1KR.js +1 -0
- package/dist/web/assets/{Outputs-BgHalMGb.js → Outputs-D-ZouoxF.js} +1 -1
- package/dist/web/assets/{RequestStatus-hZcBUUIu.js → RequestStatus-Bl3fdSbM.js} +1 -1
- package/dist/web/assets/{Tabs-C3NmwCc3.js → Tabs-CxeceOL-.js} +1 -1
- package/dist/web/assets/{TagInput-B2b862qn.js → TagInput-CeAbmGRR.js} +1 -1
- package/dist/web/assets/TaskDrawer-BCriSnhe.js +6 -0
- package/dist/web/assets/_requestId-CZKMe_mC.js +1 -0
- package/dist/web/assets/_requestId-Fx4lLkFo.js +1 -0
- package/dist/web/assets/appCtx-BdxbkSZa.js +1 -0
- package/dist/web/assets/archive-D5IIxcSV.js +1 -0
- package/dist/web/assets/board-p6R9KMqd.js +1 -0
- package/dist/web/assets/done-BTOF188x.js +1 -0
- package/dist/web/assets/{draft-BvGxfD7v.js → draft-BWYpm3PD.js} +2 -2
- package/dist/web/assets/index-DFbY8NAR.css +2 -0
- package/dist/web/assets/index-Dpqi2dcC.js +12 -0
- package/dist/web/assets/link-D481whDt.js +1 -0
- package/dist/web/assets/metrics-CAzP6V8I.js +1 -0
- package/dist/web/assets/new-C65IJJg3.js +1 -0
- package/dist/web/assets/preload-helper-_dAYMct_.js +1 -0
- package/dist/web/assets/{release-notes-Bpdi6RdY.js → release-notes-Dtif8xsQ.js} +4 -4
- package/dist/web/assets/{requestData-CbFxwW5w.js → requestData-SPc36t8Q.js} +1 -1
- package/dist/web/assets/routes-DJj8CWuk.js +6 -0
- package/dist/web/assets/settings-DKJd7CLe.js +1 -0
- package/dist/web/assets/ui-CbEOnPnF.js +1 -0
- package/dist/web/assets/{workTarget-CySfKyfB.js → workTarget-DavxMs-c.js} +3 -3
- package/dist/web/index.html +6 -4
- package/docs/architecture.md +165 -71
- package/docs/chatgpt-sign-in.md +2 -2
- package/docs/development.md +87 -54
- package/docs/feature-inventory.md +139 -0
- package/docs/how-to-use.md +10 -5
- package/docs/installation.md +31 -8
- package/docs/publishing.md +32 -13
- package/docs/refactoring.md +332 -0
- package/lib/cli/agentsStatus.js +2 -1
- package/lib/cli/guide.md +4 -1
- package/lib/cli/help.js +1 -1
- package/lib/cli/main.js +33 -238
- package/lib/cli/project.js +21 -267
- package/lib/core/projectRegistry.js +2 -2
- package/lib/kit/appInfo.js +13 -0
- package/lib/kit/usage.js +27 -0
- package/lib/server/api/projectsRoutes.js +5 -5
- package/lib/server/server.js +7 -4
- package/lib/{cli → tasks/cli}/args.js +2 -2
- package/lib/{cli → tasks/cli}/chatgpt.js +1 -1
- package/lib/{cli → tasks/cli}/codex.js +1 -1
- package/lib/{cli → tasks/cli}/output.js +2 -2
- package/lib/{cli → tasks/cli}/preflightCommands.js +1 -1
- package/lib/tasks/cli/readOnly.js +75 -0
- package/lib/{cli → tasks/cli}/render.js +1 -1
- package/lib/{cli → tasks/cli}/requestCommands.js +6 -6
- package/lib/{cli → tasks/cli}/showView.js +4 -4
- package/lib/{cli → tasks/cli}/taskCommands.js +16 -8
- package/lib/tasks/cli/tasksCli.js +149 -0
- package/lib/{core → tasks/core}/context.js +6 -9
- package/lib/tasks/core/errorOutcome.js +125 -0
- package/lib/{core → tasks/core}/hierarchy.js +1 -1
- package/lib/{core → tasks/core}/ops.js +6 -4
- package/lib/{core → tasks/core}/preflight/codexEngine.js +2 -11
- package/lib/{core → tasks/core}/preflight/hostPaths.js +39 -0
- package/lib/{core → tasks/core}/preflight/input.js +1 -1
- package/lib/{core → tasks/core}/preflight/instructions.js +2 -2
- package/lib/{core → tasks/core}/preflight/mockEngine.js +8 -7
- package/lib/{core → tasks/core}/preflight/service.js +38 -13
- package/lib/{core → tasks/core}/preflight/uiRender.js +2 -2
- package/lib/{core → tasks/core}/requestOps.js +19 -14
- package/lib/{core → tasks/core}/reviewRuns.js +127 -22
- package/lib/{core → tasks/core}/store/attachments.js +3 -2
- package/lib/{core → tasks/core}/store/collection.js +2 -2
- package/lib/tasks/core/store/fieldGroups.js +30 -0
- package/lib/tasks/core/store/jsonRecord.js +30 -0
- package/lib/{core → tasks/core}/store/normalize.js +13 -26
- package/lib/{core → tasks/core}/store/noteStore.js +2 -2
- package/lib/{core → tasks/core}/store/preflightStore.js +44 -21
- package/lib/{core → tasks/core}/store/projectFile.js +1 -1
- package/lib/{core → tasks/core}/store/workspace.js +11 -5
- package/lib/{core → tasks/core}/userConfig.js +1 -1
- package/lib/{core → tasks/core}/workTargets.js +1 -1
- package/lib/{cli → tasks/features/metrics/cli}/metricsCommands.js +3 -3
- package/lib/{core/metrics → tasks/features/metrics/core}/definitions.js +19 -8
- package/lib/{core/metrics → tasks/features/metrics/core}/index.js +41 -17
- package/lib/{core/metrics → tasks/features/metrics/core}/manual.js +27 -28
- package/lib/tasks/features/metrics/server/metricsRoutes.js +8 -0
- package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/code.js +2 -11
- package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/material.js +5 -6
- package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/review.js +2 -2
- package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/service.js +38 -100
- package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/store.js +3 -3
- package/lib/{server/api → tasks/features/milestoneReview/server}/milestoneReviewRoutes.js +7 -13
- package/lib/{cli → tasks/features/quality/cli}/qualityCommands.js +3 -3
- package/lib/{core → tasks/features/quality/core}/qualityImprovement.js +16 -15
- package/lib/{cli → tasks/features/records/cli}/revisitCommands.js +2 -2
- package/lib/{core → tasks/features/records/core}/reviewCandidates.js +26 -6
- package/lib/{shared → tasks/features/records/shared}/completionRecord.js +5 -3
- package/lib/{shared → tasks/features/records/shared}/reviewCandidate.js +13 -8
- package/lib/{shared → tasks/features/records/shared}/reworkHistory.js +5 -0
- package/lib/{cli → tasks/features/releaseNotes/cli}/releaseNotesCommands.js +7 -7
- package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/completeRequests.js +5 -6
- package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/generate.js +3 -14
- package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/material.js +3 -4
- package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/service.js +1 -1
- package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/store.js +2 -2
- package/lib/{server/api → tasks/features/releaseNotes/server}/releaseNoteRoutes.js +11 -20
- package/lib/{cli → tasks/features/requirements/cli}/requirementCommands.js +8 -7
- package/lib/{shared → tasks/features/requirements/shared}/acceptance.js +41 -7
- package/lib/{cli → tasks/features/retro/cli}/retroCommands.js +1 -1
- package/lib/{core → tasks/features/retro/core}/retrospective.js +42 -53
- package/lib/tasks/features/settings/cli/projectSettings.js +245 -0
- package/lib/{cli → tasks/features/settings/cli}/userConfig.js +5 -5
- package/lib/{core → tasks/features/settings/core}/machineSettingsEdit.js +2 -2
- package/lib/{core → tasks/features/settings/core}/repoAdmin.js +3 -3
- package/lib/{core → tasks/features/settings/core}/userTheme.js +2 -2
- package/lib/{server/api → tasks/features/settings/server}/repoRoutes.js +2 -2
- package/lib/{server/api → tasks/features/settings/server}/userThemeRoutes.js +3 -3
- package/lib/{cli → tasks/features/taskReview/cli}/taskReviewCommands.js +5 -5
- package/lib/{core/taskReview → tasks/features/taskReview/core}/material.js +7 -8
- package/lib/{core/taskReview → tasks/features/taskReview/core}/review.js +2 -2
- package/lib/{core/taskReview → tasks/features/taskReview/core}/service.js +24 -85
- package/lib/{core/taskReview → tasks/features/taskReview/core}/store.js +4 -4
- package/lib/{server/api → tasks/features/taskReview/server}/taskReviewRoutes.js +7 -14
- package/lib/{server → tasks/server}/api/routes.js +24 -75
- package/lib/tasks/shared/commitRefs.js +10 -0
- package/package.json +1 -44
- package/dist/web/assets/ImprovementDialog-Dno6dPnG.js +0 -1
- package/dist/web/assets/TaskDrawer-4BQBELXa.js +0 -6
- package/dist/web/assets/_requestId-BMAG1t3o.js +0 -1
- package/dist/web/assets/_requestId-tbg2pA2S.js +0 -1
- package/dist/web/assets/archive-DMl6WyOe.js +0 -1
- package/dist/web/assets/board-BMTcHKyt.js +0 -1
- package/dist/web/assets/done-CL6Nlsua.js +0 -1
- package/dist/web/assets/index-Dp7Fc4VI.css +0 -2
- package/dist/web/assets/index-KdlgMitg.js +0 -12
- package/dist/web/assets/metrics-Cu7gJ7Rk.js +0 -1
- package/dist/web/assets/new-DTXWHuFO.js +0 -1
- package/dist/web/assets/preload-helper-oLCrNCwz.js +0 -1
- package/dist/web/assets/routes-BIt8bExF.js +0 -6
- package/dist/web/assets/settings-CsCqF_1B.js +0 -1
- package/dist/web/assets/ui-BGK72r3u.js +0 -1
- package/lib/cli/readOnly.js +0 -53
- /package/lib/{core/store → kit}/frontmatter.js +0 -0
- /package/lib/{core/store → kit}/fsutil.js +0 -0
- /package/lib/{cli → tasks/cli}/format.js +0 -0
- /package/lib/{core → tasks/core}/chatgpt.js +0 -0
- /package/lib/{core → tasks/core}/machineSettings.js +0 -0
- /package/lib/{core → tasks/core}/preflight/carryover.js +0 -0
- /package/lib/{core → tasks/core}/preflight/codexImage.js +0 -0
- /package/lib/{core → tasks/core}/preflight/diagnose.js +0 -0
- /package/lib/{core → tasks/core}/preflight/docker.js +0 -0
- /package/lib/{core → tasks/core}/preflight/engine.js +0 -0
- /package/lib/{core → tasks/core}/preflight/launch.js +0 -0
- /package/lib/{core → tasks/core}/preflight/launcher.mjs +0 -0
- /package/lib/{core → tasks/core}/preflight/mock-ui.html +0 -0
- /package/lib/{core → tasks/core}/preflight/mock-ui.png +0 -0
- /package/lib/{core → tasks/core}/preflight/owner.js +0 -0
- /package/lib/{core → tasks/core}/preflight/render-image/Dockerfile +0 -0
- /package/lib/{core → tasks/core}/preflight/render-image/fonts-ja.conf +0 -0
- /package/lib/{core → tasks/core}/preflight/render-image/render.mjs +0 -0
- /package/lib/{core → tasks/core}/preflight/render.js +0 -0
- /package/lib/{core → tasks/core}/preflight/split.js +0 -0
- /package/lib/{core → tasks/core}/preflight/uiMaterials.js +0 -0
- /package/lib/{core → tasks/core}/preflight/wireframe.js +0 -0
- /package/lib/{core → tasks/core}/preflight/xlsx.js +0 -0
- /package/lib/{core → tasks/core}/redact.js +0 -0
- /package/lib/{core → tasks/core}/repoRefs.js +0 -0
- /package/lib/{core → tasks/core}/requestStatus.js +0 -0
- /package/lib/{core → tasks/core}/store/archivedTasks.js +0 -0
- /package/lib/{core → tasks/core}/store/dataWatcher.js +0 -0
- /package/lib/{core → tasks/core}/store/locate.js +0 -0
- /package/lib/{core → tasks/core}/supersede.js +0 -0
- /package/lib/{shared → tasks/features/metrics/shared}/metrics.js +0 -0
- /package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/mockReviewer.js +0 -0
- /package/lib/{shared → tasks/features/milestoneReview/shared}/milestoneReview.js +0 -0
- /package/lib/{core → tasks/features/quality/core}/quality.js +0 -0
- /package/lib/{shared → tasks/features/quality/shared}/quality.js +0 -0
- /package/lib/{shared → tasks/features/quality/shared}/qualityImprovement.js +0 -0
- /package/lib/{shared → tasks/features/quality/shared}/qualityTemplates.js +0 -0
- /package/lib/{core → tasks/features/records/core}/completionRefs.js +0 -0
- /package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/mockSummarizer.js +0 -0
- /package/lib/{shared → tasks/features/requirements/shared}/requirementSource.js +0 -0
- /package/lib/{shared → tasks/features/retro/shared}/retrospective.js +0 -0
- /package/lib/{core/taskReview → tasks/features/taskReview/core}/mockReviewer.js +0 -0
- /package/lib/{core/taskReview → tasks/features/taskReview/core}/paths.js +0 -0
- /package/lib/{shared → tasks/features/taskReview/shared}/taskReview.js +0 -0
- /package/lib/{server → tasks/server}/api/chatgptRoutes.js +0 -0
- /package/lib/{server → tasks/server}/api/local.js +0 -0
- /package/lib/{server → tasks/server}/api/manifest.js +0 -0
- /package/lib/{shared → tasks/shared}/dates.js +0 -0
- /package/lib/{shared → tasks/shared}/directTask.js +0 -0
- /package/lib/{shared → tasks/shared}/hierarchy.js +0 -0
- /package/lib/{shared → tasks/shared}/milestoneGoals.js +0 -0
- /package/lib/{shared → tasks/shared}/milestoneOrder.js +0 -0
- /package/lib/{shared → tasks/shared}/preflightInput.js +0 -0
- /package/lib/{shared → tasks/shared}/preflightRunner.js +0 -0
- /package/lib/{shared → tasks/shared}/refs.js +0 -0
- /package/lib/{shared → tasks/shared}/repos.js +0 -0
- /package/lib/{shared → tasks/shared}/scopeView.js +0 -0
- /package/lib/{shared → tasks/shared}/tags.js +0 -0
- /package/lib/{shared → tasks/shared}/taskBlock.js +0 -0
- /package/lib/{shared → tasks/shared}/types.js +0 -0
- /package/lib/{shared → tasks/shared}/workTarget.js +0 -0
package/docs/architecture.md
CHANGED
|
@@ -318,13 +318,14 @@ include: true
|
|
|
318
318
|
- 手元のリポジトリの場所はマシンごとに違うので、プロジェクトのデータではなく個人設定に持たせる
|
|
319
319
|
- **操作するプロジェクトは環境変数では決めない**(同じ人が複数のプロジェクトを行き来するため)。
|
|
320
320
|
`--project <名前>` → 今いる場所(登録したリポジトリ・作業ツリー・データのフォルダの中)→ 登録が1つならそれ、の順で決め、
|
|
321
|
-
決まらなければ登録済みの一覧と選び方を出す(`src/core/store/locate.ts`)
|
|
321
|
+
決まらなければ登録済みの一覧と選び方を出す(`packages/tasks/src/core/store/locate.ts`)
|
|
322
322
|
- プロジェクトを開く共通の入口(`core/context.ts` の `openProject`。CLI も `serve` の `startServer` もここを通る)で、
|
|
323
323
|
データのフォルダと `project.yaml` があるかを確かめる(`locate.ts` の `checkDataDir`)。無ければ空のプロジェクトとして続けず
|
|
324
324
|
`DataDirError`(終了コード 1)。何も作らない。無い(ENOENT)と読めない(権限・入出力)は分けて伝える。`init`(作成)・`join`(参加)と
|
|
325
325
|
`project` は開かないので妨げない。起動した後の切断は、画面の「再読み込み」の `ReloadError`(状態は変えない)が受け持つ
|
|
326
326
|
- 登録が1つだけで決まった(`via: only`)ときは、今いる場所と関係なく当たるので読むだけにする。CLI の入口(`cli/main.ts`)で、
|
|
327
|
-
プロジェクトを開く前に、読むだけの操作(`cli/readOnly.ts` の `readsOnly
|
|
327
|
+
プロジェクトを開く前に、読むだけの操作(`cli/readOnly.ts` の `readsOnly`。載っていない操作・知らないサブコマンドは変える操作として扱う。対象の ID とサブコマンドの見分けは
|
|
328
|
+
各コマンドのハンドラと同じにし、`--sources-json` のように操作の語が無くても書き込みに変わるオプションも見る)以外を止める。
|
|
328
329
|
案内の文は `locate.ts` の `onlyRegistrationNotice`(明示の方法と移る先を示す)
|
|
329
330
|
- 使う人はフォルダや実行パスを意識しない前提で、セットアップは2段階まで・エラーは次にすることを示す、を守る
|
|
330
331
|
- 個人設定に登録していないリポジトリの中の `.p3/` も、今いる場所から上へ辿って読める(`via: legacy`。デモ・テスト・登録前の clone)。
|
|
@@ -382,7 +383,7 @@ include: true
|
|
|
382
383
|
レビューは、保存してあるマイルストーンの目的・予定機能に対して、Codex が参照先のリポジトリのコードと git の履歴を読み、実装が目的を
|
|
383
384
|
果たしているか・目的に無い変更が無いかを確かめる参考の記録(操作は [使い方ガイド](how-to-use.md#マイルストーンレビュー))。所属する
|
|
384
385
|
要望・タスクの記録は実装した人の自己申告として、どこを見るかの手がかりにする(記録の要約で終わらせない)。比較材料の抽出は
|
|
385
|
-
`
|
|
386
|
+
`features/milestoneReview/core/material.ts`(コードの材料は `code.ts`)、履歴は `features/milestoneReview/core/store.ts`、形は `features/milestoneReview/shared/milestoneReview.ts`。
|
|
386
387
|
リリースノートの材料(`releaseNotes/material.ts`)の収録の条件は変えない。
|
|
387
388
|
|
|
388
389
|
- **範囲**: マイルストーンに直接属する要望の全部の状態(見送り・未完了も)。要望の本文、各タスクの本文・状態・変更の記録・成果物の
|
|
@@ -410,7 +411,7 @@ include: true
|
|
|
410
411
|
- **保護**: 履歴のあるマイルストーンは消せず、ID も変えられない(`requestOps.ts` の `checkMilestoneRemoval`)。project.yaml を直接
|
|
411
412
|
編集して定義が消えても、履歴は孤立として一覧・閲覧できる
|
|
412
413
|
- 抽出と履歴の保存は、要望の状態・リリースノート・リリース済みを変えない
|
|
413
|
-
- **実行**(`
|
|
414
|
+
- **実行**(`features/milestoneReview/core/service.ts`・依頼文と確かめ方は `review.ts`): Preflight と同じ Codex の接続の `ask` に、材料を
|
|
414
415
|
取り出したときに読めた参照先を渡し、Preflight と同じく `/workspace/<名前>` に読むだけでマウントする(データのフォルダは渡さない。
|
|
415
416
|
認証・診断・パスの対応・使用量の上限・取消を共有)。Mock は明示したときだけで、失敗しても切り替えない。依頼文では、記録を自己申告
|
|
416
417
|
として手がかりにとどめ、予定機能ごとに実装を読んで判断する・コミットの差分から目的に無い変更を挙げる・書き込みやテストとアプリの
|
|
@@ -434,7 +435,7 @@ include: true
|
|
|
434
435
|
|
|
435
436
|
### リリースノートのデータ
|
|
436
437
|
|
|
437
|
-
マイルストーンごとに1件、`<data>/release-notes/<マイルストーンID>.md` に置く(`
|
|
438
|
+
マイルストーンごとに1件、`<data>/release-notes/<マイルストーンID>.md` に置く(`features/releaseNotes/core/`)。要望のフォルダの外に
|
|
438
439
|
置くのは、複数の要望をまとめるものだから。
|
|
439
440
|
|
|
440
441
|
- **材料**(`releaseNotes/material.ts`): マイルストーンに属する要望(アーカイブしたものは除く)を全部返し、収録するかを決める。
|
|
@@ -488,7 +489,7 @@ include: true
|
|
|
488
489
|
materialization に残してやり直しでも同じにする。今の要望(`cli/project.ts` の `currentRequest`)は、今いる参照先
|
|
489
490
|
(`locateHere`)の割当のブランチ → ブランチ名の要望 ID の順で、パスの中の要望 ID だけでは決めない(detached HEAD では決めない)。
|
|
490
491
|
git のブランチ・作業ツリーは作らない
|
|
491
|
-
- 参照先の登録・変更・削除は `core/repoAdmin.ts` に集め、CLI(`p3 repo`)と設定画面(`/api/repos`・`components/ReposPanel.tsx`)が
|
|
492
|
+
- 参照先の登録・変更・削除は `features/settings/core/repoAdmin.ts` に集め、CLI(`p3 repo`)と設定画面(`/api/repos`・`components/ReposPanel.tsx`)が
|
|
492
493
|
同じものを使う。このマシンのパスは `localOnly` でローカルの画面にだけ返し、変えられるのもローカルの画面(Origin)からだけ。
|
|
493
494
|
パスつきで足すときは、共有の定義を書く前にフォルダかを確かめる
|
|
494
495
|
- 設定画面はほかの画面と同じく画面の横幅いっぱいに使う。入力欄のラベルは短くし、補足は `Field` の `hint` で入力欄の下に出すので、
|
|
@@ -508,17 +509,17 @@ include: true
|
|
|
508
509
|
|
|
509
510
|
### マシンごとの設定と Codex の起動
|
|
510
511
|
|
|
511
|
-
- マシンごとの設定は、項目ごとに CLI の明示 → 環境変数(`P3_*`)→ 個人設定 → 既定値 で決める(`src/core/machineSettings.ts`)。
|
|
512
|
+
- マシンごとの設定は、項目ごとに CLI の明示 → 環境変数(`P3_*`)→ 個人設定 → 既定値 で決める(`packages/tasks/src/core/machineSettings.ts`)。
|
|
512
513
|
CLI と serve・Codex エンジンが同じ解決を使い、`process.env` を個人設定の値で書き換えない。`.env` はどこからも読まない
|
|
513
514
|
(P3 は pnpx などで入れるので、パッケージの場所は利用者が触らない)。項目と環境変数の対照は [導入ガイド](installation.md#設定の決まり) の「設定の決まり」
|
|
514
|
-
- マシンごとの設定の書き換え(`p3 user-config set`。`src/core/machineSettingsEdit.ts`): `キー=値` で書き、`キー=` で消し、
|
|
515
|
+
- マシンごとの設定の書き換え(`p3 user-config set`。`packages/tasks/src/features/settings/core/machineSettingsEdit.ts`): `キー=値` で書き、`キー=` で消し、
|
|
515
516
|
パスの対応は `codex.pathMap+=A=B` / `codex.pathMap-=A` で1件ずつ足し・外す(全部の置き換えは受けない。書き間違いで全部を
|
|
516
517
|
失わないように)。`updateUserConfig` の中で変更を当ててから、環境変数を見ずに `resolveMachineSettings` で確かめ、読めなければ
|
|
517
518
|
何も書かない(テーマを含めて一括)。表示(`describeSettings`)は項目ごとの効いている値と出どころ(環境変数 / 個人設定 / 既定)。
|
|
518
519
|
空の環境変数は既定に戻すので出どころも既定。プロジェクトの登録(projects)は表示しない(`p3 project ls`)
|
|
519
520
|
- パスの対応のエラー(`bind source path does not exist`)には、直し方(`pathMapHowTo`)として設定するコマンド・例・ホストの
|
|
520
521
|
パスの調べ方を添える。共有の記録に残るので、このマシンのパスは例のパスで示す。対応が当たっていたなら行き先の誤りとして案内する
|
|
521
|
-
- **マウントするパスの決め方**(`src/core/preflight/hostPaths.ts` の `resolveHostPaths`。261115-d0n30): Docker のコンテナに
|
|
522
|
+
- **マウントするパスの決め方**(`packages/tasks/src/core/preflight/hostPaths.ts` の `resolveHostPaths`。261115-d0n30): Docker のコンテナに
|
|
522
523
|
マウントするこのマシンのパスを、Docker のデーモンから見たパスに決める。求めた結果は個人設定に書かず、毎回求める。
|
|
523
524
|
ここで Docker に出すのは `docker inspect` だけ(`dockerExec` の時間の上限と取消。引数は配列)で、全部の対象が決まる前にマウントする
|
|
524
525
|
コマンドは出さない。1つでも決まらなければ `ok: false` で、呼ぶ側はコンテナを起こさない
|
|
@@ -536,9 +537,20 @@ include: true
|
|
|
536
537
|
ホスト名だけ・候補の先頭だけでは決めない。見つからない(`self-not-found`。リモート・別のデーモン)、複数(`self-ambiguous`)、
|
|
537
538
|
inspect のホスト名がこのマシンと違う(`self-mismatch`)、問い合わせの失敗・時間切れ(`inspect-failed`)、ID が分からない
|
|
538
539
|
(`self-unknown`)は自動では決めない
|
|
540
|
+
- マウントの元の照合(261120-ezdk4): 見つけたコンテナの `Type: bind` ごとに、その `Destination`(リンクを辿った先)の mountinfo の
|
|
541
|
+
root が `Source` の末尾と一致しなければ自分と扱わない(`self-mismatch`)。ネットワークを共有する構成(Compose の
|
|
542
|
+
`network_mode: service:X`・`--network container:X`)では、`/etc/hostname` などの元・ホスト名・実行側の inspect の `HostnamePath` が
|
|
543
|
+
共有元 X のものになり、候補もホスト名の照合も X を指す。実機(Linux の Docker Engine 29、cgroup v2、containerd snapshotter)では、
|
|
544
|
+
同じ `Destination` に共有元が別の `Source` を付けていると X の `Source` を黙って選び、正しい手の対応は `conflict` で止まった。
|
|
545
|
+
中からは実行側の ID を得る手がかりが無い(cgroup は `0::/`、inspect に rootfs の snapshot が出ない。得るには接続先のコンテナを一覧する
|
|
546
|
+
しかなく、問い合わせを広げない)ので、自動で実行側を選ぶことはせず、照合で取り違えを見つけて止め、手の対応に任せる。
|
|
547
|
+
root が `/`(ファイルシステムの丸ごとの bind。NFS など)と、mountinfo に無いマウント先は比べない。ホストでシンボリックリンクを
|
|
548
|
+
通した bind(`Source` はリンク、root は実体)も止まる(取り違えより安全な側に倒す。導入ガイドの手順で手で書く)
|
|
549
|
+
- 1つのパスで、一番深いマウントが bind の形(root が `/` でない)なのに見つけたコンテナの `Mounts` に無いときも `self-mismatch`
|
|
550
|
+
(共有元にその `Destination` が無い構成。マウントの種類の問題ではないので、フォルダを移す案内にしない)
|
|
539
551
|
- 1つのパス: 対象の実体(シンボリックリンクを辿った先。無いところは在るところまで辿って残りを足す)を含む **一番深い** マウントを
|
|
540
552
|
mountinfo から選び、そこが inspect の `Mounts` の `Type: bind` の `Destination` のときだけ、その `Source` に残りを足す。
|
|
541
|
-
volume・tmpfs・Docker
|
|
553
|
+
volume・tmpfs・Docker の知らないマウント(root が `/`)の下(`not-bind`)や、どのマウントの下でもない(コンテナの層。`container-layer`)は、
|
|
542
554
|
親の bind に逃げずに止める。`Source` が `/` で始まらない形(`unsupported-source`)も止める。`Source` は同じデーモンが返した
|
|
543
555
|
もので、同じデーモンにそのまま渡せる(Docker Desktop の中の DevContainer でも、Desktop を見分けて止めることはしない)
|
|
544
556
|
- 手で書いた対応は今までどおり前から順の境界一致(`mapPath`)で、元のパス(実体ではない)に当てる。自動で求めたものと食い違えば
|
|
@@ -624,7 +636,7 @@ include: true
|
|
|
624
636
|
`web/lib/theme.ts` が持ち、`system` の間だけ `prefers-color-scheme` の変化を購読する。保存先は個人設定だけで、
|
|
625
637
|
localStorage は使わない。ほかのプロセスでの変更は読み直しで反映する
|
|
626
638
|
- 設定画面のテーマの選択は、選んだらすぐ `PUT /api/user-theme` で保存し、保存できてから画面に反映する
|
|
627
|
-
(`web/lib/themeSave.ts`。保存中に続けて選んだら、終わってから最後の選択だけを保存する。失敗したら保存済みの表示に戻す)。
|
|
639
|
+
(`features/settings/web/lib/themeSave.ts`。保存中に続けて選んだら、終わってから最後の選択だけを保存する。失敗したら保存済みの表示に戻す)。
|
|
628
640
|
- 進捗のスケジュールの狭い画面: 左の一覧の幅を枠の幅から決める(`web/lib/timeline.ts` の `leftWidth`。640px 未満で
|
|
629
641
|
枠の 36%・112〜380px、640px 以上は 380px)。スケジュールの見える幅(`scheduleSpan`)・描く期間の右端・見える範囲の判定・
|
|
630
642
|
今日への移動・ズームの中央の日付は、すべてこの幅から計算する(測る前は幅 0 で、見える幅は負にならない)。行の高さと
|
|
@@ -706,7 +718,7 @@ serve の中で起きたこと(画面からの保存、Preflight の進み具
|
|
|
706
718
|
タブ・ウィンドウに戻ったときの読み直し(POST /api/reload)で取り込む。ファイル監視は補助で、届かないことがある
|
|
707
719
|
(NFS や、Node の再帰的な監視が置き換えて保存したファイルの2回目以降の変更を通知しないことがある)。
|
|
708
720
|
|
|
709
|
-
**データのフォルダの監視**(`src/core/store/dataWatcher.ts`。`Workspace.watch` が1つだけ持ち、通常の serve と `--all-projects` の
|
|
721
|
+
**データのフォルダの監視**(`packages/tasks/src/core/store/dataWatcher.ts`。`Workspace.watch` が1つだけ持ち、通常の serve と `--all-projects` の
|
|
710
722
|
プロジェクトごとに同じものを使う): 補助なので、壊れても serve と実行中の Preflight は止めない。
|
|
711
723
|
|
|
712
724
|
- `fs.promises.watch` は使わない。Node 22 の Linux の再帰監視(JS の実装)は、見ている途中でフォルダが消えると(Preflight が
|
|
@@ -830,34 +842,91 @@ src は5つの層に分け、依存の向きを `test/layers.test.ts` で確か
|
|
|
830
842
|
| Preflight の分割(子の案の検証・子の本文・案の版・採用) | `core/preflight/split.ts`・`core/preflight/service.ts` の `adopt` |
|
|
831
843
|
| 個々の規則(対応済・置き換え・作業先とブランチ・評価対象の比べ方) | `core/requestStatus.ts`・`core/supersede.ts`・`core/workTargets.ts`・`shared/preflightInput.ts` |
|
|
832
844
|
| サーバと画面の両方で使う判定・表示名 | `shared/` |
|
|
845
|
+
| エラーから CLI の終了コード・標準エラーと API の状態・code への対応 | `core/errorOutcome.ts` の `errorOutcome`(CLI は `cliExit`、API の各アプリは `apiError` で写す。契約は `test/errorContract.test.ts`) |
|
|
833
846
|
| 画面の API の失敗の扱い(rev の競合・評価対象の変更・無い) | `web/lib/api.ts` の `failureOf` |
|
|
834
|
-
| リリースノートの本文の下書き(外の変更・削除・読めないときに入力を残す・編集を始めた版で保存) | `web/lib/releaseNoteDraft.ts` |
|
|
847
|
+
| リリースノートの本文の下書き(外の変更・削除・読めないときに入力を残す・編集を始めた版で保存) | `features/releaseNotes/web/lib/releaseNoteDraft.ts` |
|
|
835
848
|
| 読み取り(一覧・参照の解き方・進捗) | `core/ops.ts` |
|
|
836
849
|
| アーカイブしたタスクの読み取り(通常の一覧・集計に混ぜない) | `core/store/archivedTasks.ts` |
|
|
837
850
|
| レビューの実行の記録の共通部分(保存・終わり・回復・取消・遅れた結果の拒否) | `core/reviewRuns.ts` |
|
|
838
|
-
| タスクの AI レビュー(材料・履歴) | `
|
|
839
|
-
| プロジェクトの品質基準(状態・ID の振り方・操作・テンプレートと改版の差分・版) | `shared/quality.ts`・`shared/qualityTemplates.ts`(保存は `core/quality.ts` と `Workspace.writeQuality`) |
|
|
851
|
+
| タスクの AI レビュー(材料・履歴) | `features/taskReview/core/`(`material.ts`・`store.ts`) |
|
|
852
|
+
| プロジェクトの品質基準(状態・ID の振り方・操作・テンプレートと改版の差分・版) | `features/quality/shared/quality.ts`・`features/quality/shared/qualityTemplates.ts`(保存は `features/quality/core/quality.ts` と `Workspace.writeQuality`) |
|
|
840
853
|
| 作業中のタスクの止まっている理由(停止。付ける・直す・解除・履歴・止まったままの移動の拒否・壊れた値の読み方) | `shared/taskBlock.ts`(保存と状態との突き合わせは `core/requestOps.ts` の `updateTask`、集計は `core/ops.ts`) |
|
|
841
|
-
| タスクの受け入れ基準と証拠(ID の振り方・操作・失効・根拠の種類・不足・壊れた値の読み方)と済みの解除 | `shared/acceptance.ts`(済みの解除と保存は `core/requestOps.ts` の `updateTask`) |
|
|
842
|
-
| 要求の出典と確認(根拠の記録・確認の要件と状態・変更での失効・回答・確認事項の読み方・評価の資料)と、壊れた値の読み方 | `shared/requirementSource.ts`(要望の保存は `core/requestOps.ts` の `updateRequirement`・`saveClarifyAnswer`、基準の記録は `shared/acceptance.ts` の `source` 操作、評価対象の固定と比較は `core/preflight/input.ts`) |
|
|
843
|
-
| タスクの手戻りの履歴(済みの解除・完了からの再開の契機・1操作1件・壊れた値) | `shared/reworkHistory.ts`(保存は `core/requestOps.ts` の `updateTask`) |
|
|
844
|
-
| 要望の振り返り(対象の候補・確定と訂正・記録の読み方) | `shared/retrospective.ts`(保存は `core/retrospective.ts`) |
|
|
845
|
-
| 開発の指標(定義・対象・算出・欠損の扱い・範囲)と人が記録する値 | `
|
|
854
|
+
| タスクの受け入れ基準と証拠(ID の振り方・操作・失効・根拠の種類・不足・壊れた値の読み方)と済みの解除 | `features/requirements/shared/acceptance.ts`(済みの解除と保存は `core/requestOps.ts` の `updateTask`) |
|
|
855
|
+
| 要求の出典と確認(根拠の記録・確認の要件と状態・変更での失効・回答・確認事項の読み方・評価の資料)と、壊れた値の読み方 | `features/requirements/shared/requirementSource.ts`(要望の保存は `core/requestOps.ts` の `updateRequirement`・`saveClarifyAnswer`、基準の記録は `features/requirements/shared/acceptance.ts` の `source` 操作、評価対象の固定と比較は `core/preflight/input.ts`) |
|
|
856
|
+
| タスクの手戻りの履歴(済みの解除・完了からの再開の契機・1操作1件・壊れた値) | `features/records/shared/reworkHistory.ts`(保存は `core/requestOps.ts` の `updateTask`) |
|
|
857
|
+
| 要望の振り返り(対象の候補・確定と訂正・記録の読み方) | `features/retro/shared/retrospective.ts`(保存は `features/retro/core/retrospective.ts`) |
|
|
858
|
+
| 開発の指標(定義・対象・算出・欠損の扱い・範囲)と人が記録する値 | `features/metrics/core/definitions.ts` の `METRIC_DEFINITIONS`(範囲と材料は `features/metrics/core/index.ts`、人の記録の保存は `features/metrics/core/manual.ts`、型は `features/metrics/shared/metrics.ts`) |
|
|
859
|
+
| JSON の記録のファイルの読み書き(読むときの扱いを記録ごとに渡す・置き換えで書く) | `core/store/jsonRecord.ts` の `readJsonRecord`・`writeJsonRecord`(記録ごとの扱いの違いは [docs/refactoring.md](refactoring.md) の表) |
|
|
860
|
+
| 要望・タスクの p3 が管理する frontmatter の項目のまとまり(読む・壊れた値の書き戻し・書かない項目・入力から外す項目) | `core/store/fieldGroups.ts` の `TASK_FIELD_GROUPS`・`REQUEST_FIELD_GROUPS`(まとまりごとの検査は各 `shared/*.ts`、書き戻しの仕組みは `core/store/collection.ts` の `keepRaw`) |
|
|
846
861
|
| 要望とそのタスクの保存のロック(別のプロセスとの読み直し・書く・移すの排他) | `core/store/collection.ts` の `lock`・`core/store/workspace.ts` の `requestLock` |
|
|
847
|
-
| 完了の記録(契機・写す条件・ID の振り方・読み方・壊れた値)と参照先の取得 | `shared/completionRecord.ts`(保存は `core/requestOps.ts` の `createTask`・`updateTask`・`updateRequest`、参照先のコミットの取得は `core/completionRefs.ts`) |
|
|
848
|
-
| 見直しが必要(候補)の診断(基点・理由の種類・関係の範囲)と前提の変更の記録 | `shared/reviewCandidate.ts`(読み取り・集計は `core/reviewCandidates.ts`、前提の変更の保存は `core/requestOps.ts` の `recordPremise`) |
|
|
849
|
-
| リリースノート(材料の規則・保存・出力・要約の生成・要望の一括完了) | `
|
|
862
|
+
| 完了の記録(契機・写す条件・ID の振り方・読み方・壊れた値)と参照先の取得 | `features/records/shared/completionRecord.ts`(保存は `core/requestOps.ts` の `createTask`・`updateTask`・`updateRequest`、参照先のコミットの取得は `features/records/core/completionRefs.ts`) |
|
|
863
|
+
| 見直しが必要(候補)の診断(基点・理由の種類・関係の範囲)と前提の変更の記録 | `features/records/shared/reviewCandidate.ts`(読み取り・集計は `features/records/core/reviewCandidates.ts`、前提の変更の保存は `core/requestOps.ts` の `recordPremise`) |
|
|
864
|
+
| リリースノート(材料の規則・保存・出力・要約の生成・要望の一括完了) | `features/releaseNotes/core/`(`material.ts`・`store.ts`・`service.ts`・`generate.ts`・`completeRequests.ts`) |
|
|
850
865
|
| タスクの関係(`depends_on`・`supersedes` だけ。同じ要望の中。Preflight のタスク化だけが張る) | `shared/types.ts` の `RELATION_TYPES`・`core/preflight/service.ts` の `materialize` |
|
|
851
866
|
| プロジェクトを跨ぐ serve(登録の一覧・登録世代・文脈の開閉) | `core/projectRegistry.ts`(API は `server/api/projectsRoutes.ts`) |
|
|
852
867
|
| Preflight を通さずにタスクを作る道の案内(付かないものの言い方・失敗と取消の見分け。取消は `PREFLIGHT_CANCELLED` で残す) | `shared/directTask.ts`(CLI の案内文は `cli/output.ts` の `directTaskHint`) |
|
|
853
868
|
| マイルストーンの表示の順(ID のバージョンの降順。CLI・API・画面の一覧と選ぶ欄。project.yaml の順は変えない) | `shared/milestoneOrder.ts` |
|
|
854
|
-
| マイルストーンレビュー(材料の範囲・履歴の保存・依頼文と結果の確かめ方・実行の排他と回復) | `
|
|
869
|
+
| マイルストーンレビュー(材料の範囲・履歴の保存・依頼文と結果の確かめ方・実行の排他と回復) | `features/milestoneReview/core/`(`material.ts`・`store.ts`・`review.ts`・`service.ts`) |
|
|
855
870
|
| マイルストーンの目的・予定機能(件数・文字数・空・重複・ID の振り方) | `shared/milestoneGoals.ts`(保存の排他と版の照合は `core/store/workspace.ts` の `saveProject`) |
|
|
856
871
|
|
|
857
|
-
CLI は `cli/main.ts
|
|
872
|
+
CLI は `cli/main.ts`(入口: 引数の解釈・プロジェクトの決定・登録が1つだけのときの抑止・serve・help・guide・init・join・agents)、
|
|
873
|
+
`cli/tasksCli.ts`(tasks: プロジェクトを開いた後の振り分けとエラーから終了コードへの対応)と、種類ごとのコマンド(`taskCommands.ts`・
|
|
858
874
|
`requestCommands.ts`・`preflightCommands.ts`)に分ける。大きい画面は、ルートのファイルを組み立てだけにして部品を
|
|
859
875
|
`web/components/<ページ>/` に分ける。
|
|
860
876
|
|
|
877
|
+
## パッケージの構成
|
|
878
|
+
|
|
879
|
+
p3 をいくつかの製品(今の機能の p3-tasks、将来の p3-observer など)を選んで組み合わせる形にするため、リポジトリを pnpm workspace にし、
|
|
880
|
+
コードを 3 つのパッケージに分ける(要望 261119-9d1zk。どの機能をどこに置くかの根拠は [機能の棚卸し](feature-inventory.md) の判断表)。
|
|
881
|
+
|
|
882
|
+
| パッケージ | 中身 | 読み込んでよいもの |
|
|
883
|
+
| --- | --- | --- |
|
|
884
|
+
| 入口 `@infodb/p3`(`packages/p3`) | 配布(`bin/p3.mjs`・npm の `@infodb/p3`・Docker)・CLI の振り分け・help・guide とスキル(置く・診断)・init / join / project・serve の組み立て・画面の外枠(`__root`・プロジェクトの選択) | tasks・kit |
|
|
885
|
+
| `@infodb/p3-tasks`(`packages/tasks`) | 今の p3 の機能(要望・タスク・Preflight・レビュー・振り返り・指標・リリースノート・品質・設定・参照先・保存・画面のページ・API) | kit |
|
|
886
|
+
| `@infodb/p3-kit`(`packages/kit`) | 入口と製品が使う最小限の共通処理 | なし |
|
|
887
|
+
|
|
888
|
+
- 入口は、知っている製品(今は tasks だけ)をはっきり呼んで組み込む。製品を探して読み込む仕組み(プラグインの基盤)は作らない
|
|
889
|
+
- tasks は入口を読み込まない。入口のもの(置いた AI 向けの入口の診断など)が要るときは、入口から値や関数で渡す(`cli/tasksCli.ts` の `TasksRun`)
|
|
890
|
+
- 将来の製品どうしは直接読み込まない。連携が要るなら kit の小さな約束事を通す。p3-observer は名前だけを決め、データは自分のサブフォルダ
|
|
891
|
+
(`.p3/observer/` の想定)だけを持つ(tasks のデータに触れない)
|
|
892
|
+
- 今の `shared` は「画面と Node の両方から読める」という層の規則で、tasks 固有の型が多い。まるごと kit にはしない
|
|
893
|
+
- パッケージの間はパッケージ名(`@infodb/p3-tasks/core/context.ts` のように、そのパッケージの `src` からのパス)で読み、相対パスで別の
|
|
894
|
+
パッケージのファイルを指さない。読むパッケージは manifest に workspace の参照で書く。境界は `test/packageBoundary.test.ts` が確かめる
|
|
895
|
+
(入口 → tasks → kit の一方向・相対パスでの迂回・manifest の宣言・kit の処理に使い手がいること・observer のパッケージがまだ無いこと)。
|
|
896
|
+
層の向き(shared ← core ← server / cli、web → shared)は入口と tasks の `src` の中で同じに分け、パッケージ名で読んだ先も
|
|
897
|
+
`test/layers.test.ts` が照らす
|
|
898
|
+
- 配るのは入口の `@infodb/p3` の1つで、kit・tasks は公開せずにビルドして同梱する(`lib/tasks/`・`lib/kit/`。パッケージ名の import は同梱した先への
|
|
899
|
+
相対パスに書き換える。`scripts/build-cli.mjs`)。利用者から見える名前・コマンド・データの場所・CLI・API・画面は変えない。Docker も同じ中身を使う
|
|
900
|
+
([開発ガイド](development.md#npm-で配る中身))
|
|
901
|
+
- 画面は入口でビルドする。ルート一覧は入口の `__root.tsx` の下に tasks のページのフォルダをそのまま付け(`tsr.config.json` の
|
|
902
|
+
`virtualRouteConfig`)、入口が知っている製品のページだけが入る
|
|
903
|
+
- tasks の中は、層ごとの共通の土台と機能のまとまり(`features/<機能>/{shared,core,cli,server,web}`)に分ける。機能の中身はその機能・組み立ての場所・
|
|
904
|
+
入口の層と画面の組み合わせだけが読み、機能の core どうしと循環は禁止(`test/featureBoundary.test.ts`)。配置・規則・まとめた仕組みと残した理由・前後の
|
|
905
|
+
計測は [docs/refactoring.md](refactoring.md)
|
|
906
|
+
- 製品ごとの設計: tasks の設計と規則はこの文書の残りの節(作業の単位・Preflight・受け入れ基準など)。kit は下の「kit の中身と使い手」。
|
|
907
|
+
p3-observer は名前を予約しただけで、パッケージも設計もまだ無い(作るときは `packages/observer` に置き、データは `.p3/observer/` だけを持つ)
|
|
908
|
+
|
|
909
|
+
**機能(棚卸しの ID)ごとの置き場所**(パスは各パッケージの `src` からの相対。入口なら `packages/p3/src/`、tasks なら `packages/tasks/src/`)
|
|
910
|
+
|
|
911
|
+
| 棚卸し | 置き場所 | 分け方・今の置き方 |
|
|
912
|
+
| --- | --- | --- |
|
|
913
|
+
| F01 起動・振り分け・help・静的配信 | 入口 | `bin/p3.mjs`・`cli/main.ts`・`cli/help.ts`・`server/server.ts`。tasks のコマンドは `cli/tasksCli.ts` の `runTasksCommand`、終了コードは `reportError` を呼ぶ |
|
|
914
|
+
| F02 配布物の確認 | 入口 | `scripts/verify-*.mjs`・`scripts/check-browser.ts`・`docs/publishing.md` |
|
|
915
|
+
| F03 AI 向けの入口・guide・診断 | 入口 | `cli/project.ts`(置く)・`cli/guide.ts`・`cli/agentsStatus.ts`・`skills/`。手順の本文 `cli/guide.md` は tasks の運用の手順だが、`p3 guide` が同梱の原本を返すので当面は入口と一緒に置く |
|
|
916
|
+
| F04 登録・参加・プロジェクトの決定・読む/書くの判定 | 分ける | 入口: `cli/project.ts`(init・join・project)。tasks: `features/settings/cli/projectSettings.ts`(`config`・`repo`・変更者・今いる参照先・今の要望)・`cli/readOnly.ts`(コマンドごとの読む/書く。入口が呼ぶ)・`core/store/locate.ts`(決め方とデータの検査。入口が呼ぶ) |
|
|
917
|
+
| F05 個人設定・マシンごとの設定・変更者 | tasks(kit の候補) | `core/userConfig.ts`・`core/machineSettings*.ts`・`features/settings/cli/userConfig.ts`。Codex の設定・テーマ・パスの対応と同じファイルで扱っているので、今の既定値・出どころ・保存を変えないために当面は tasks。2 つ目の製品が個人設定を使うときに、入出力だけを kit に分ける |
|
|
918
|
+
| F06 置き換え書き込み・ロック・frontmatter | kit | `fsutil.ts`・`frontmatter.ts`(`packages/kit/src/`)。今は tasks(要望・タスク・run・指標・設定の保存)が使い、将来の製品の保存も使う見込み。採番・正規化・アーカイブは tasks |
|
|
919
|
+
| F07 serve・プロジェクトの切り替え・ナビゲーション・テーマ・表示部品 | 分ける | 入口: `server/server.ts`・`server/api/projectsRoutes.ts`・`core/projectRegistry.ts`・`web/{main,Boot,App,router}.tsx`・`web/routes/__root.tsx`・`web/components/{ProjectSwitcher,ProjectChooser}.tsx`。tasks: API(`server/api/routes.ts` ほか)・ページ・`server/api/local.ts`。表示部品 `web/components/ui.tsx` とテーマ(`ThemePanel`・`features/settings/core/userTheme.ts`・`features/settings/server/userThemeRoutes.ts`)は、設定画面(tasks のページ)が使うので当面は tasks に置き、入口が読み込む。2 つ目の製品が使うときに kit に移す |
|
|
920
|
+
| F08 変更の監視・通知・読み直し | tasks | `core/store/dataWatcher.ts`(`Workspace` が使う)・`server/api/routes.ts` の `/events`・`/reload`。プロジェクトを跨ぐ通知は入口の `projectsRoutes.ts`。監視の仕組みを製品で共有するのは 2 つ目の製品が出てから |
|
|
921
|
+
| F09 AI 向けの API の説明 | tasks | `server/api/manifest.ts`。入口の `projectsRoutes.ts` も同じ説明を返す |
|
|
922
|
+
| F10〜F25・F27 | tasks | 判断表の根拠のパスのまま |
|
|
923
|
+
| F26 AI 接続・実行環境 | tasks(暫定) | `cli/{codex,chatgpt}.ts`・`core/chatgpt.ts`・`core/preflight/{codexEngine,docker,hostPaths}.ts`。入口は `codex`・`chatgpt`・`render` のコマンドをプロジェクトを決める前に tasks の関数で動かす |
|
|
924
|
+
| F28 独立した観測 | なし | パッケージの名前(observer)だけを予約する |
|
|
925
|
+
|
|
926
|
+
**kit の中身と使い手**(`packages/kit/src/`): `usage.ts`(使い方の誤り `UsageError`・パスの展開・git の小物。入口と tasks が使う)、
|
|
927
|
+
`appInfo.ts`(動いている p3 の版。入口が起動のときに渡し、tasks が Codex に名乗る版として読む)、`fsutil.ts`・`frontmatter.ts`(置き換え書き込み・
|
|
928
|
+
ロック・frontmatter。tasks が使う。将来の製品の保存も使う見込み)。使い手のいない処理を先回りして kit に置かない。
|
|
929
|
+
|
|
861
930
|
## サーバに置かない理由
|
|
862
931
|
|
|
863
932
|
1. **Codex の置き場所が決まらない。** サーバ側で Codex を動かすと共有アカウントになる(OpenAI の規約上も避けたい)。
|
|
@@ -875,7 +944,7 @@ CLI は `cli/main.ts`(振り分け・プロジェクトと変更者の決定
|
|
|
875
944
|
認証情報は各自の ChatGPT の接続か `auth.json`(個人の場所に置き、プロジェクトには置かない)。
|
|
876
945
|
- 結果は戻り値ではなく **ファイル**(要望のフォルダの `preflight/<RUN>/assessment.json`, `drafts/*.md`)。
|
|
877
946
|
同期すればチームの全員が同じ評価とタスク案を見られる。誰が実行したかは `run.json` とタスクの `updatedBy` に残る。
|
|
878
|
-
- 画面資料(`preflight/<RUN>/ui/`)もファイル契約にする(`src/core/preflight/uiMaterials.ts`)。AI(Codex・手元の
|
|
947
|
+
- 画面資料(`preflight/<RUN>/ui/`)もファイル契約にする(`packages/tasks/src/core/preflight/uiMaterials.ts`)。AI(Codex・手元の
|
|
879
948
|
エージェント)は画面の原稿(`ui/src/U1.html` …)と `ui/index.json` を書き、P3 が原稿を描画のコンテナで PNG にして `ui/index.json` に
|
|
880
949
|
書き足す([画面イメージの描画のイメージ](#画面イメージの描画のイメージ)。AI は画像を作らない)。P3 は取り込む前に確かめて `run.json` の `ui` に記録する。画像の形式と大きさは拡張子ではなく
|
|
881
950
|
中身から読み、配信のときも同じ確かめ方をもう一度する(取り込んだ後に差し替えられた画像は返さない)。画像は
|
|
@@ -918,7 +987,7 @@ CLI は `cli/main.ts`(振り分け・プロジェクトと変更者の決定
|
|
|
918
987
|
追加で許す保証ではない。コマンドの実行は禁止していない。参照先は読むだけのマウントで書けない。データのフォルダ(`/data`)は
|
|
919
988
|
書けるマウントなので、「run の中だけ」は指示と事後の警告で守っている(書き込みを run に閉じ込める囲いは今は無い)。
|
|
920
989
|
画面イメージの描画は、この Codex のコンテナではなく別のコンテナで行う
|
|
921
|
-
- 指示(制約 = Codex の `developerInstructions` と、依頼文)は `src/core/preflight/instructions.ts` の1か所で作る。評価の観点・
|
|
990
|
+
- 指示(制約 = Codex の `developerInstructions` と、依頼文)は `packages/tasks/src/core/preflight/instructions.ts` の1か所で作る。評価の観点・
|
|
922
991
|
履歴の調べ方・分割・出力の形・画面の原稿の書き方の原本はここだけに置き、エンジンごとに複製しない。実行環境ごとに違うのは
|
|
923
992
|
パスと「何が強制されているか」だけで、`InstructionEnv` として注入する:
|
|
924
993
|
- `containerEnv`(Codex): 参照先は `/workspace/<mount>`、データは `/data`。書き込みは run の配下だけ、と指示する
|
|
@@ -939,7 +1008,7 @@ CLI は `cli/main.ts`(振り分け・プロジェクトと変更者の決定
|
|
|
939
1008
|
プロセスと、落ちたプロセスが残した run」)
|
|
940
1009
|
- 取り込みは成果物を先に確かめ(`localProblems`)、問題があれば run を変えずに断る(`local.rejected` を数えるだけ)。通ったら画面の
|
|
941
1010
|
原稿を描き、通常と同じ `ingest`・`finish` で完了にする。取り込みも取消も `lastPreflight` は変えない
|
|
942
|
-
- **実行しているプロセスと、落ちたプロセスが残した run**(`src/core/preflight/owner.ts`、`service.ts` の `busy`・`recoverRequest`・
|
|
1011
|
+
- **実行しているプロセスと、落ちたプロセスが残した run**(`packages/tasks/src/core/preflight/owner.ts`、`service.ts` の `busy`・`recoverRequest`・
|
|
943
1012
|
`recover`・`finishLocked`): serve・CLI が途中で落ちると、codex / mock の run は `running` のまま残る。以前は開始から 35 分たったら
|
|
944
1013
|
落ちたものとみなして始め直せたが、生きている長い実行と重なりうるうえ、画面からは何分たっても始め直せなかったのでやめた
|
|
945
1014
|
- 記録: 始めるとき(`open`)に `run.json` の `owner` と `before`(始める前の要望のステータス)を残す。`owner` は `instance`(ローカルの
|
|
@@ -971,7 +1040,7 @@ CLI は `cli/main.ts`(振り分け・プロジェクトと変更者の決定
|
|
|
971
1040
|
|
|
972
1041
|
要望のタイトルと本文は、Preflight の前後・実行中・完了済を含め、いつでも書き換えられる(`p3 request set --body` / `title=`、
|
|
973
1042
|
API の PATCH。`rev` で楽観ロック)。書き換えても状態・既存のタスク・過去の run は変えない。そのかわり、古い評価からはタスク化しない
|
|
974
|
-
(`src/core/preflight/input.ts`)。
|
|
1043
|
+
(`packages/tasks/src/core/preflight/input.ts`)。
|
|
975
1044
|
|
|
976
1045
|
- **固定**: Preflight を始めるとき、要望をディスクから読み直し(監視していない外部の編集も取り込む)、タイトルと本文を
|
|
977
1046
|
`run.json` の `input` に固定する。人が読む `request.md` とエンジンに渡す要望も同じ内容にする。実行中に要望が書き換えられても、
|
|
@@ -1007,7 +1076,7 @@ API の PATCH。`rev` で楽観ロック)。書き換えても状態・既存
|
|
|
1007
1076
|
### 要求の出典と確認
|
|
1008
1077
|
|
|
1009
1078
|
外部の評価(課題 B)への対応: 要求そのものが間違っている場合、リポジトリと履歴を読んでも正解は分からない。Preflight には無理に正解を
|
|
1010
|
-
出させず、根拠が足りないことと誰に何を確かめるかを示させ、実装から独立した正解の根拠を人が残せるようにする(`shared/requirementSource.ts`)。
|
|
1079
|
+
出させず、根拠が足りないことと誰に何を確かめるかを示させ、実装から独立した正解の根拠を人が残せるようにする(`features/requirements/shared/requirementSource.ts`)。
|
|
1011
1080
|
|
|
1012
1081
|
- **持ち物**: 要望の `requirementSources`(`[{id: S1, target?, source?, basis?, confirmed?, history?, recordedAt, recordedBy}]`)・`requirementSeq`・
|
|
1013
1082
|
`clarifyAnswers`。タスクとタスク案の `acceptanceSources`(同じ記録に `criterionId`。基準の中ではなく別に持つので、id と text で基準を組み直す
|
|
@@ -1019,11 +1088,22 @@ API の PATCH。`rev` で楽観ロック)。書き換えても状態・既存
|
|
|
1019
1088
|
- **状態**(共通関数 `sourceState`・`overallState`): 未記録 / 未確認 / 確認記録あり / 再確認が必要 / 対応先不明。保存するたび(要望の題・本文、
|
|
1020
1089
|
記録、基準の文の変更)に、確認したときと違う確認を `history` へ移す(`settleSources`)。だから文を元に戻しても確認記録ありに戻らない。
|
|
1021
1090
|
直接編集で中身だけ変えた場合も、比べると違うので再確認が必要と出る。基準を消した記録・写した元の無い記録は対応先不明として残す
|
|
1091
|
+
- **ID**: 記録の ID(`S1, S2, ...`)は消した ID を使い直さない。要望は振った最後の番号を `requirementSeq`、タスクとタスク案は
|
|
1092
|
+
`acceptanceSourceSeq`(基準をまたいでタスク・案で1つ)に残し、p3 が書く(PATCH・操作の入力からは上書きしない)。同じ操作の中で足して
|
|
1093
|
+
消したなど中身が同じでも番号が進めば番号だけを書き、済み・完了の記録・手戻りは中身の変化として扱わない。タスク化は案の番号を引き継ぐ
|
|
1094
|
+
(写さなかった記録の番号も使わない)。案の更新は読み直し・競合の確認・採番・保存を同じロック(案ごと)の中で行う。壊れた番号は
|
|
1095
|
+
`acceptanceProblems` に理由を出し、根拠の操作を断り、関係のない更新ではファイルの元の値のまま書き戻す(壊れた根拠と、置き換えない
|
|
1096
|
+
壊れた基準も同じ)。案の更新の応答は、保存したファイルを再読込と同じ規則(`PreflightStore.loadDraft`。中は `loadDrafts` と同じ
|
|
1097
|
+
`draftOf`)で読み直したもので、更新した直後と再読込で、読めた基準・根拠・採番と理由(各1回)が同じになる。基準を置き換えれば古い
|
|
1098
|
+
基準の理由は消え、根拠・採番の理由は直すまで残る(タスク化は理由を添えて断る)。261120-0pys5
|
|
1099
|
+
番号を残す前の旧データは、今ある記録と完了の記録の写し(`acceptance.sources`)に残る番号の続きを振る。消して写しにも残っていない番号と、
|
|
1100
|
+
以前の版で使い直した ID の前後の同一性は分からない(推定せず、過去の写しも書き換えない。見直し候補は同じ ID の記録として比べる)
|
|
1022
1101
|
- **写し**: 基準の記録は要望の記録を `from` で写せる(内容だけ。確認は引き継がない)。タスク化(`criteriaForTask`)では `from` の記録を
|
|
1023
1102
|
採用するときの要望の記録の内容に写し直す。要望全体の確認を全部の基準へ自動で引き継がない
|
|
1024
1103
|
- **確認事項と回答**: 評価は以前の `questions`(文の並び)に加えて `clarifications`(`[{id: Q1, target, ask, question, needed, impact}]`)を
|
|
1025
|
-
出せる。確認先が分からなければ `ask` は「要望者に確認先を特定してもらう」。壊れた項目は捨てずに `clarificationProblems`
|
|
1026
|
-
|
|
1104
|
+
出せる。確認先が分からなければ `ask` は「要望者に確認先を特定してもらう」。壊れた項目は捨てずに `clarificationProblems` に残す。読み取り
|
|
1105
|
+
(`clarificationsOf`)は Codex・手元のエージェントで共通で、確定の規則はエンジンで違う: Codex の取り込み(`ingest`)は理由をログにも
|
|
1106
|
+
出して取り込み、手元のエージェントの取り込み(`localProblems`)は直すまで確定しない(`--complete` が `invalid_result` を返す)。回答は要望の `clarifyAnswers` に、元の run と確認事項の ID・
|
|
1027
1107
|
質問の写し・回答・回答した人・日・出典・根拠・対応する記録(`links`: ID と内容の hash)で残す。過去の run と評価は書き換えない。
|
|
1028
1108
|
状態は回答済み / 未回答 / 再確認が必要(対応する記録の内容が変わった)/ 参照元不明。次の run の同じ質問へ文字の一致で移さない
|
|
1029
1109
|
- **責任の境界**: 記録・確認・回答はどれも人(と人に頼まれた AI)の申告で、P3 は業務の契約・承認者の権限・本人性を確かめない。
|
|
@@ -1039,7 +1119,7 @@ API の PATCH。`rev` で楽観ロック)。書き換えても状態・既存
|
|
|
1039
1119
|
### 置き換えられたタスク
|
|
1040
1120
|
|
|
1041
1121
|
再評価でタスク化すると、新しい案が同じ要望の古いタスクを置き換える(`supersedes`)ことがある。
|
|
1042
|
-
タスクの状態は 未着手 / 作業中 / 完了 の3つのままにし、置き換えは関係として扱う(`src/core/supersede.ts`)。
|
|
1122
|
+
タスクの状態は 未着手 / 作業中 / 完了 の3つのままにし、置き換えは関係として扱う(`packages/tasks/src/core/supersede.ts`)。
|
|
1043
1123
|
|
|
1044
1124
|
- **タスク化で知らせる候補**: **採用した** 案の `supersedes` のうち、同じ要望にある未完了(未着手・作業中)のタスク。
|
|
1045
1125
|
不採用の案だけにあるもの・完了したタスク・無いタスクは候補にしない。
|
|
@@ -1084,13 +1164,14 @@ API の PATCH。`rev` で楽観ロック)。書き換えても状態・既存
|
|
|
1084
1164
|
### 手戻りの履歴と保存のロック
|
|
1085
1165
|
|
|
1086
1166
|
タスクの済みの解除と完了からの再開を `reworkHistory`(`[{id: R1, at, by, rev, cause, unchecked, reopened, from, to}]`。追記だけ)に残す
|
|
1087
|
-
(`shared/reworkHistory.ts`)。後で「Preflight で心配したことが手戻りになったか」を追うときの材料にする。
|
|
1167
|
+
(`features/records/shared/reworkHistory.ts`)。後で「Preflight で心配したことが手戻りになったか」を追うときの材料にする。
|
|
1088
1168
|
|
|
1089
1169
|
- `updateTask` が、書く直前に読み直した値と保存する値(状態・済み。完了から戻すと済みも外れる)を比べて決め、状態と同じ1回の書き込みに入れる。
|
|
1090
1170
|
`cause` は `reopen`(完了から戻した)・`explicit`(済みを外すと明示した)・`acceptance`(基準・証拠・基準の根拠の中身が変わって済みが外れた)。
|
|
1091
1171
|
済みの完了を戻した1操作は `unchecked` と `reopened` の両方を持つ1件
|
|
1092
1172
|
- 同じ値の再保存・済みを保ったままの変更・成果物の追記では足さない。履歴の値は CLI・API から受け付けない。直接編集からは作らず、過去の分は補わない
|
|
1093
|
-
- 壊れた履歴は `reworkProblems` と `keepRaw` で元の値を残し、新しい履歴は足さずに `reworkSkipped`
|
|
1173
|
+
- 壊れた履歴は `reworkProblems` と `keepRaw` で元の値を残し、新しい履歴は足さずに `reworkSkipped` で知らせる(状態の変更は拒まない。
|
|
1174
|
+
CLI の `move`・`set` は標準エラーと `--json` の結果の両方、API の PATCH は結果)
|
|
1094
1175
|
|
|
1095
1176
|
**保存のロック**: 要望とそのタスクの更新・作成・アーカイブは、要望ごとのロック(`requests/.locks/<要望ID>.lock`。要望のフォルダの外なので、
|
|
1096
1177
|
アーカイブで一緒に動かない)の中で、読み直してから書く・移す。別のプロセスのタスクの更新と、タスク・要望のアーカイブが重なっても、
|
|
@@ -1100,7 +1181,7 @@ API の PATCH。`rev` で楽観ロック)。書き換えても状態・既存
|
|
|
1100
1181
|
|
|
1101
1182
|
### 振り返り
|
|
1102
1183
|
|
|
1103
|
-
外部の評価への対応: 蓄積した記録で開発を振り返る一例として、Preflight で心配したリスクが実装の後に起きたかを追う(`shared/retrospective.ts`)。
|
|
1184
|
+
外部の評価への対応: 蓄積した記録で開発を振り返る一例として、Preflight で心配したリスクが実装の後に起きたかを追う(`features/retro/shared/retrospective.ts`)。
|
|
1104
1185
|
P3 は AI の実装を動かさず、成績も測らない。
|
|
1105
1186
|
|
|
1106
1187
|
- **記録**: 要望のフォルダの `retrospective.json`(`{version, targets: [...]}`)。要望と一緒にアーカイブ・共有する。保存は要望のロック
|
|
@@ -1116,7 +1197,7 @@ P3 は AI の実装を動かさず、成績も測らない。
|
|
|
1116
1197
|
- **リスクの確認**(`addJudgment`): `judgments` に `J<n>`(対象 ID・リスクの位置・原文の写し・状態・事実・範囲・根拠・理由・日時・主体)を追記する。
|
|
1117
1198
|
リスクは対象 ID と位置で見分ける(同文のリスクも別)。今の確認は対象とリスクの最後の1件。`occurred` は事実と根拠、`not_occurred` は範囲と根拠が要り、
|
|
1118
1199
|
`unchecked` は根拠を結び付けるだけ。決めた確認(`unchecked` 以外)を変えるには理由が要る。今の対象のリスクだけに足せ、件数(`riskCounts`)も今の対象だけ
|
|
1119
|
-
- **根拠**(`core/retrospective.ts` の `resolveEvidence`): 保存するときに今の記録と照らし、参照先と抜粋(1000 文字まで)と結果の版を写す。
|
|
1200
|
+
- **根拠**(`features/retro/core/retrospective.ts` の `resolveEvidence`): 保存するときに今の記録と照らし、参照先と抜粋(1000 文字まで)と結果の版を写す。
|
|
1120
1201
|
タスクレビューはこの要望のタスク(今の・アーカイブ)の完了した run の `overall`・`items`・`quality`・`unplanned`・`checks` の位置。
|
|
1121
1202
|
マイルストーンレビューは固定した材料(`input.requests`)にこの要望が直接あるものだけで、所見の `evidence` に要望 ID か `<要望ID>/T…` が無ければ
|
|
1122
1203
|
結び付く理由が要る(実行中の材料の変更 `inputChanged` も写す)。手戻りはタスクの `reworkHistory` の ID。人の参照は確かめない
|
|
@@ -1128,8 +1209,8 @@ P3 は AI の実装を動かさず、成績も測らない。
|
|
|
1128
1209
|
外部の評価への対応: AI 開発の成果をコードの量ではなく、到達の時間・品質(手戻り・基準の未達)などで振り返る材料として、記録から指標を出す。
|
|
1129
1210
|
P3 は AI の実装を動かして測らない。成績の評価・順位には使わない。
|
|
1130
1211
|
|
|
1131
|
-
- **定義**: `
|
|
1132
|
-
CLI の `metrics`・API の `GET /api/metrics` は `
|
|
1212
|
+
- **定義**: `features/metrics/core/definitions.ts` の `METRIC_DEFINITIONS` の1か所。各定義は ID・名前・単位・出典・対象・算出・欠損の扱いと `compute(input)`。
|
|
1213
|
+
CLI の `metrics`・API の `GET /api/metrics` は `features/metrics/core/index.ts` の `metricsReport` を通り、同じ値を返す
|
|
1133
1214
|
- **範囲**: プロジェクト全体(所属なし・登録に無いマイルストーンの要望を含む)か、`project.yaml` に登録したマイルストーンに今直接属する要望。
|
|
1134
1215
|
見送り・アーカイブの要望は除く。タスクは要望の直下だけ。読めない要望は `notices`
|
|
1135
1216
|
- **値の状態**: `ok`・`no_targets`(対象なし)・`no_data`(欠損だけ)・`not_reached`(まだ到達していない)・`unrecorded`(記録なし)。値は `ok` のときだけで、ほかは `null`(0 にしない)
|
|
@@ -1137,22 +1218,27 @@ P3 は AI の実装を動かして測らない。成績の評価・順位には
|
|
|
1137
1218
|
今の状態から到達済みと分かるのに記録が無いものは欠損。完了済の記録だけで対応済の記録が無いものは直接の遷移(対応済に未到達)、
|
|
1138
1219
|
記録の1つも無い完了済は「到達したか分からない」(欠損)。`updatedAt`・`doneAt` で推し量らない
|
|
1139
1220
|
- **受け入れ基準**: 今完了しているタスクの今の基準を `acceptanceStatus` で照らす。分母は数えた基準の合計。基準なしは対象なし、`acceptanceProblems` と
|
|
1140
|
-
|
|
1221
|
+
読めないタスクのファイルは欠損、対応する基準の無い証拠は分母の外。5つの基準の指標は、1回のレポートの材料(`MetricsInput`)ごとに1回だけ
|
|
1222
|
+
集計した結果を使う(`sharedCriteria`。材料に結んだ `WeakMap` で、レポートの外へは持ち越さない)
|
|
1141
1223
|
- **手戻り**: タスクの `reworkHistory` の件数(同じタスクの同じ `rev` は1件)。`reworkProblems` と読めないタスクのファイルは欠損、履歴の無いタスクは内訳の
|
|
1142
1224
|
「記録が無い」。履歴より前は分からない(観測の始まりを保存していないので、全期間の完全さは保証しない)
|
|
1143
1225
|
- **タスクレビュー**: 今完了しているタスクごとに、`selectTaskReview` で完了した run を1件選ぶ(`finishedAt` の新しい順、同時刻は run ID の大きい方。
|
|
1144
1226
|
読めない記録・`finishedAt` の無い完了の run があれば欠損)。選んだ結果の `items` の `missing` と `unplanned` を別の指標に数える。`undetermined`・`checks` は
|
|
1145
|
-
内訳だけ。レビューの無いタスクばかりなら `unrecorded`。読むのは `taskReviews.list`・`get` だけで、run
|
|
1146
|
-
|
|
1227
|
+
内訳だけ。レビューの無いタスクばかりなら `unrecorded`。読むのは `taskReviews.list`・`get` だけで、run を作らない。マイルストーンレビューの所見は今後の候補。
|
|
1228
|
+
読み取りはタスクごと(一覧・選択・結果の取得)に並行に行い、同時に読む数は1回のレポートの全部の要望で1つの上限(`REVIEW_READ_CONCURRENCY`)に
|
|
1229
|
+
収める。結果は要望 ID とタスク ID に結び、集計は読み終わった順ではなく要望・タスクの順で行う(欠損の明細の並びも同じ)
|
|
1230
|
+
- **人が記録する値**(`kind: manual`。定義の `manual` に値の規則): `features/metrics/core/manual.ts`。`<data>/metrics/manual.json`(`{version: 1, seq, records}`)に持ち、
|
|
1147
1231
|
`metrics/.manual.lock` のロックの中で読み直してから置き換えで書く。識別は指標・範囲(`project` かマイルストーン ID)・期間・単位で、同じ内容は書かない。
|
|
1148
|
-
値・出典・メモの訂正は記録の `rev` を照らす(渡さない・違えば `metrics_conflict
|
|
1232
|
+
値・出典・メモの訂正は記録の `rev` を照らす(渡さない・違えば `metrics_conflict`)。訂正の `updatedBy` はその訂正の主体で、主体を記録できない
|
|
1233
|
+
訂正では省く(前の更新者を残すと、その人が訂正したように読めるため)。`createdBy`・`createdAt` は作ったときのまま。同じ内容の再送と競合は
|
|
1234
|
+
更新者・更新日時・版を変えない。壊れたファイルは空とみなさず `metrics_unreadable`(読む側は欠損と `notices`)。
|
|
1149
1235
|
表示は範囲が一致する記録だけを期間・単位ごとの `rows` に出し、範囲の間・通貨・期間をまたいで合算しない(`value` は1行のときだけ)。書くのは CLI だけ。
|
|
1150
1236
|
記録のあるマイルストーンは `checkMilestoneRemoval` で消さず、登録に無いマイルストーンへの記録は `manual_orphan`
|
|
1151
1237
|
|
|
1152
1238
|
### 完了の記録
|
|
1153
1239
|
|
|
1154
1240
|
タスクの完了(`task_done`)・人の済み(`task_checked`)・要望の対応済(`request_resolved`)・完了済(`request_done`)のとき、
|
|
1155
|
-
そのときの条件の写しを `completionRecords` に追記する(`shared/completionRecord.ts`)。今の値(`doneAt`・`checkedAt` は再開で消える)とは別に持ち、
|
|
1241
|
+
そのときの条件の写しを `completionRecords` に追記する(`features/records/shared/completionRecord.ts`)。今の値(`doneAt`・`checkedAt` は再開で消える)とは別に持ち、
|
|
1156
1242
|
後から「当時どの条件で完了・確認したか」を比べる材料にする。
|
|
1157
1243
|
|
|
1158
1244
|
- 状態と同じ更新(同じ rev)で同じファイルに書く。片方だけが保存されることはない。`expectedRev` の競合では何も書かない
|
|
@@ -1162,28 +1248,36 @@ P3 は AI の実装を動かして測らない。成績の評価・順位には
|
|
|
1162
1248
|
- 写す値は、同じ操作で変えた基準・証拠を当てた後のもの。品質は完了したときの最新の値(設定全体の版・作業先に当てはまる項目と除外)で、
|
|
1163
1249
|
取り込んだときの版は基準の `quality.version` に残る。要望の記録は題と `requestSubject`(題と本文の hash)を持ち、本文は写さない
|
|
1164
1250
|
- 要望の記録の `tasks`・`children` は判定に使った直下のタスクと子の要望(ID・rev・状態・その時点の最新の記録 ID)。子だけの親も子の記録から辿れる
|
|
1165
|
-
- 参照先は書く前(ロックの外)に `core/completionRefs.ts` が取る: `git rev-parse HEAD` と、参照先のフォルダに限った `git status --porcelain`。
|
|
1251
|
+
- 参照先は書く前(ロックの外)に `features/records/core/completionRefs.ts` が取る: `git rev-parse HEAD` と、参照先のフォルダに限った `git status --porcelain`。
|
|
1166
1252
|
状態は `ok`・`not_git`・`unregistered`・`missing`・`notdir`・`failed` で、理由にはこのマシンのパスを入れない。完了になりうる更新
|
|
1167
1253
|
(状態を完了にする・済みを付ける・対応済・完了済にする)のときだけ取る。Preflight の評価対象にはコミットの固定が無いので、run から補わない
|
|
1168
1254
|
- 入口: `createTask`(完了で作る)・`updateTask`(CLI の move・set・check、API の PATCH、品質の取り込み)・`updateRequest`(CLI の request set、
|
|
1169
1255
|
API の PATCH、マイルストーンの一括完了)。どれも記録の値を受け付けず(`completionRecords` は捨てる)、P3 が作る
|
|
1170
1256
|
- 記録の無い古いデータは補わない。読めない記録は `completionProblems` にして `keepRaw` で元の値を書き戻し、新しい記録は足さない
|
|
1171
|
-
(状態は変え、`completionSkipped`
|
|
1257
|
+
(状態は変え、`completionSkipped` で知らせる。CLI の `move`・`set` は標準エラーと `--json` の結果の両方、API の PATCH は結果)。読めない品質・基準・根拠は `problems` として写し、完了は拒まない
|
|
1172
1258
|
- ファイルの並びでは最後(`updatedBy` の後)に書く。人が読む項目を上に残すため
|
|
1173
1259
|
- 一覧(進捗・タスクの一覧)にも今は全部が載る(要望・タスクの値をそのまま返すため)。進捗のタスクの印は記録を載せず、見直しの状態だけを持つ
|
|
1174
1260
|
|
|
1175
1261
|
### 見直し候補
|
|
1176
1262
|
|
|
1177
1263
|
外部の評価(課題 C)への対応: 過去に正しいと判断したものが、仕様や環境の変化で正しくなくなることがある。判断を間違いと決めつけず、
|
|
1178
|
-
当時の条件(完了の記録)と今の条件の差を「見直しが必要(候補)」として示す(`shared/reviewCandidate.ts`)。状態は増やさない。
|
|
1264
|
+
当時の条件(完了の記録)と今の条件の差を「見直しが必要(候補)」として示す(`features/records/shared/reviewCandidate.ts`)。状態は増やさない。
|
|
1179
1265
|
|
|
1180
1266
|
- **基点**: タスク・要望の最新の完了の記録。人がもう一度済み・完了にすれば新しい記録が基点になる。記録が無い・読めないときは
|
|
1181
1267
|
`no_record`・`unreadable` で、差分なし(`none`)とも候補(`candidate`)とも分ける
|
|
1182
1268
|
- **対象**: 完了したタスク(済みの有無を問わない)と、対応済・完了済の要望自身。要望の詳細・進捗には配下の候補の件数(`tasks`・`below`)を
|
|
1183
|
-
添えるが、親自身を候補にはしない。`below` は子孫の要望自身とそのタスクを1
|
|
1269
|
+
添えるが、親自身を候補にはしない。`below` は子孫の要望自身とそのタスクを1回ずつ数える。アーカイブは見ない。件数の内訳は
|
|
1270
|
+
`self`(要望自身の概要。対応済・完了済のときだけ)・`tasks`(自分の候補のタスク)・`below`(子孫の要望自身の候補と子孫の候補のタスク)
|
|
1271
|
+
- **進捗での共有**: 進捗(`progress`)は1回の呼び出しの中で診断を使い回す(`reviewMemo`。タスクは要望 ID を含む `ref`、要望自身は要望 ID で引き、
|
|
1272
|
+
診断が無いことも覚える)。タスク行の状態と、全部の要望の `self`・`tasks`・`below` が同じ結果を使い、各タスクと各要望自身の診断は1回だけになる。
|
|
1273
|
+
呼び出しをまたいでは持たない(次の進捗ではその時点の条件で診断し直す)。261120-89k52
|
|
1184
1274
|
- **品質**: `standardsFor` で作業先に当てはまる項目を当時(記録の `quality.standards`)と今で比べる(`quality_added`・`quality_changed`
|
|
1185
1275
|
(`standardHash`)・`quality_removed`・`quality_exempted`)。設定全体の版(`qualityVersion`)の違いだけでは候補にしない。
|
|
1186
|
-
今が未設定・読めないなら `quality_state
|
|
1276
|
+
今が未設定・読めないなら `quality_state`、当時が読めないなら比べない。要望の記録は項目を写さないので、要望自身は状態だけを比べる:
|
|
1277
|
+
設定済 → 未設定、または今が読めない(当時が設定済・未設定のどちらでも。比べられない部分も返す)だけを `quality_state` にし、
|
|
1278
|
+
未設定 → 設定(品質基準の初回設定)は理由にしない。後から品質基準を導入しただけで、対応済・完了済の要望が一括して候補になるのを避けるため。
|
|
1279
|
+
完了したタスクは未設定で完了していても(記録に項目が無い)、今の作業先に当てはまる項目を `quality_added` にする(作業先なしのタスクは
|
|
1280
|
+
全体適用の項目)。そのため初回設定の後は、候補のタスクを持つ要望が配下の件数(`tasks`)で進捗の「見直し候補のみ」に残る
|
|
1187
1281
|
- **基準と根拠**: 基準は ID で比べる(`criterion_added`・`criterion_changed`・`criterion_removed`)。基準ごとの根拠は (基準 ID, 記録 ID)、
|
|
1188
1282
|
基準が写した要望の根拠(`from`)は当時の元と今の元を比べる(`source_changed`・`source_removed`・`source_unconfirmed`)。要望自身は要望の根拠の全部
|
|
1189
1283
|
- **前提の変更**: 要望の `premiseChanges`(`[{id: P1, targets, reason, condition, at, by, acks?}]`。追記だけ)。対象は要望 ID・この要望の
|
|
@@ -1200,7 +1294,7 @@ P3 は AI の実装を動かして測らない。成績の評価・順位には
|
|
|
1200
1294
|
|
|
1201
1295
|
タスクは任意で **受け入れ基準**(`acceptanceCriteria: [{id, text}]`。何を満たせば完了か)を持ち、作業した側は基準ごとに
|
|
1202
1296
|
**証拠**(`acceptanceEvidence: [{criterionId, criterionText, result, evidence, recordedAt, recordedBy}]`)を残す。規則は
|
|
1203
|
-
`shared/acceptance.ts` の1か所で、CLI(`new --criterion`・`criteria`・`evidence`・`set` / `move` の `--evidence`)と API
|
|
1297
|
+
`features/requirements/shared/acceptance.ts` の1か所で、CLI(`new --criterion`・`criteria`・`evidence`・`set` / `move` の `--evidence`)と API
|
|
1204
1298
|
(POST の `criteria`、PATCH の `acceptance` の操作)は同じ操作を `core/requestOps.ts` に渡すだけ。
|
|
1205
1299
|
|
|
1206
1300
|
- **ID**: 足すときに `A1, A2, ...` を振る。並べ替え・文言の変更で振り直さず、消した ID も使い直さない(振った最後の番号を
|
|
@@ -1210,7 +1304,7 @@ P3 は AI の実装を動かして測らない。成績の評価・順位には
|
|
|
1210
1304
|
- **根拠の種類**: 証拠は任意の `basis` を持つ(`{kind: unverified}` 未確認 / `{kind: declaration}` 申告のみ / `{kind: read, reference}`
|
|
1211
1305
|
読んで確認 / `{kind: machine, command, result, target}` 検査結果あり)。結果と別の軸で、どれも作業した側の申告(P3 は実行しない。
|
|
1212
1306
|
read と machine に正しさの上下は付けない。人の済みはタスクの `checkedAt` で、basis に human は作らない。AI レビューの判定は写さない)。
|
|
1213
|
-
型・ラベル・組み合わせ(met / unmet に未確認は不可、unverified は未確認だけ)・古い値の解釈・内訳・変更の比較は `shared/acceptance.ts`。
|
|
1307
|
+
型・ラベル・組み合わせ(met / unmet に未確認は不可、unverified は未確認だけ)・古い値の解釈・内訳・変更の比較は `features/requirements/shared/acceptance.ts`。
|
|
1214
1308
|
根拠を省いた record は、同じ結果の前の証拠の根拠を引き継ぎ、無ければ unverified は未確認・ほかは申告のみ(古い CLI・画面の更新を
|
|
1215
1309
|
妨げず、古い証拠を同じ値で保存し直しても根拠を足さない)。保存した値に basis が無い古い証拠は書き換えず、読むときだけ
|
|
1216
1310
|
unverified は未確認、ほかは「申告のみ(種類未記録)」と解釈する(本文から推し量って格上げしない)。`acceptanceStatus` の `met` は
|
|
@@ -1228,7 +1322,7 @@ P3 は AI の実装を動かして測らない。成績の評価・順位には
|
|
|
1228
1322
|
同じ値の再保存・成果物の追加・同じ操作で済みを付け直すときは外さない。未完了へ戻すと外れるのは今までどおり
|
|
1229
1323
|
- **今の値に当てる**: 操作は書く直前に読み直したファイルの値に当て、1つでも規則に合わなければ何も書かない(`rev` を渡せば競合も分かる)
|
|
1230
1324
|
- **Preflight のタスク案**: 案(`drafts/D*.md`)も `acceptanceCriteria` を持つ。Codex・手元のエージェントは文の並びで書き、
|
|
1231
|
-
P3 が読むときに A1, A2, ... を振る(`shared/acceptance.ts` の `readDraftCriteria`)。読めない基準は案の `acceptanceProblems`
|
|
1325
|
+
P3 が読むときに A1, A2, ... を振る(`features/requirements/shared/acceptance.ts` の `readDraftCriteria`)。読めない基準は案の `acceptanceProblems`
|
|
1232
1326
|
(案のファイルには書かない)に出し、手元の結果の取り込み(`--complete`)では直せる問題として断る。Codex の run では案に残して
|
|
1233
1327
|
ログに出し、その案はタスク化を断る(直せば消える)。人の編集は並び全体の置き換えで、編集を始めたときの基準
|
|
1234
1328
|
(`expectedCriteria`)と今の基準が違えば題と同じく 409 で書かない(同じ題のまま他で基準が変わっても上書きしない)。
|
|
@@ -1263,18 +1357,18 @@ quality:
|
|
|
1263
1357
|
- **状態**: `quality` が無ければ未設定、あれば設定済み(意図して空でもよい)、読めない値(重複した ID・理由の無い除外・確認の方法の
|
|
1264
1358
|
欠け)があれば invalid。invalid は未設定として扱い、ファイルの値は消さず、操作は断って直し方を示す。知らない参照先は警告だけ
|
|
1265
1359
|
- **上限**: 100 件、文 1000・コマンド 500・成功の条件 500・確かめ方 1000・除外の理由 500 文字
|
|
1266
|
-
- **書き方**: `core/quality.ts` の操作(init・adopt・upgrade・add・replace・edit・remove・exempt・unexempt)を `Workspace.writeQuality` が
|
|
1360
|
+
- **書き方**: `features/quality/core/quality.ts` の操作(init・adopt・upgrade・add・replace・edit・remove・exempt・unexempt)を `Workspace.writeQuality` が
|
|
1267
1361
|
project.yaml のロックの中で、読み直した最新の値に当て、`quality` の項目だけを書く(コメント・ほかの項目は残す)。設定の保存
|
|
1268
1362
|
(PUT /api/project・`p3 config`)・参照先の保存・マイルストーンの保存は `quality` を書かないので、無関係な保存で品質基準は消えない
|
|
1269
1363
|
- **版**: 品質だけの中身の hash(`qualityVersion`)。操作に版を渡すと、違えば `quality_conflict`(API 409・CLI 終了コード 3)で何も書かない
|
|
1270
|
-
- **テンプレート**(`shared/qualityTemplates.ts`): 版つきの例(共通の基本・TypeScript の例)で、業界の標準への認証ではない。採用すると
|
|
1364
|
+
- **テンプレート**(`features/quality/shared/qualityTemplates.ts`): 版つきの例(共通の基本・TypeScript の例)で、業界の標準への認証ではない。採用すると
|
|
1271
1365
|
編集できる実体として写し、出典(`source`)を残す。テンプレートが改版しても採用済みの内容は変わらず、差分(足す・変わる・消える)
|
|
1272
1366
|
を見て `upgrade` で明示して当てる
|
|
1273
1367
|
- P3 はコマンドを実行しない・依存を入れない。確認の方法は CI・手元の作業・外の自動化のどれでもよく、特定の製品・フォルダを必須にしない
|
|
1274
1368
|
|
|
1275
1369
|
### 品質の改善要望
|
|
1276
1370
|
|
|
1277
|
-
品質の不足から改善要望を作る(`core/qualityImprovement.ts`。形は `shared/qualityImprovement.ts`)。
|
|
1371
|
+
品質の不足から改善要望を作る(`features/quality/core/qualityImprovement.ts`。形は `features/quality/shared/qualityImprovement.ts`)。
|
|
1278
1372
|
|
|
1279
1373
|
- **診断**(読むだけ): 出典は品質基準の設定(`project`)・タスクのレビューの1回分・マイルストーンレビューの1回分。不足を
|
|
1280
1374
|
unset(未設定)/ invalid(読めない設定)/ violated(レビューで確かめた違反)/ undetermined(判断できない)/ exempt(理由つきの除外)に
|
|
@@ -1345,8 +1439,8 @@ blockHistory: # 履歴(追記だけ。before / after はその
|
|
|
1345
1439
|
### タスクの AI レビュー(材料)
|
|
1346
1440
|
|
|
1347
1441
|
完了したタスクの本文・受け入れ基準に対して、比較対象の変更が基準を満たしているかを、作業したのとは別の Codex のスレッドに
|
|
1348
|
-
読むだけで確かめさせる参考の記録。作業した AI の能力・成績の評価ではない。材料は `
|
|
1349
|
-
(何も書かない。保存は別)。形は `shared/taskReview.ts`。
|
|
1442
|
+
読むだけで確かめさせる参考の記録。作業した AI の能力・成績の評価ではない。材料は `features/taskReview/core/material.ts` が固定する
|
|
1443
|
+
(何も書かない。保存は別)。形は `features/taskReview/shared/taskReview.ts`。
|
|
1350
1444
|
|
|
1351
1445
|
- **対象**: 保存してある完了したタスク(済みも再実行できる)。無い(404)・未完了(`not_done`)・アーカイブ(`archived`)は断る
|
|
1352
1446
|
- **タスクの材料**: 本文・受け入れ基準・作業した側の証拠(基準ごとの今の状態 `evidenceStates`、読めない値)・変更の記録・成果物・
|
|
@@ -1402,7 +1496,7 @@ blockHistory: # 履歴(追記だけ。before / after はその
|
|
|
1402
1496
|
|
|
1403
1497
|
### タスクの AI レビュー(履歴と実行)
|
|
1404
1498
|
|
|
1405
|
-
履歴は要望のフォルダの中に置く(`
|
|
1499
|
+
履歴は要望のフォルダの中に置く(`features/taskReview/core/store.ts`)。要望をアーカイブすれば一緒に動き、タスクをアーカイブしても残って読める。
|
|
1406
1500
|
|
|
1407
1501
|
```text
|
|
1408
1502
|
requests/<要望ID>/task-reviews/<タスクID>/<run>/input.json 固定した材料(作ったら変えない)
|
|
@@ -1423,7 +1517,7 @@ requests/<要望ID>/task-reviews/.locks/<タスクID>.lock 状態を変
|
|
|
1423
1517
|
|
|
1424
1518
|
### タスクの AI レビュー(実行)
|
|
1425
1519
|
|
|
1426
|
-
`
|
|
1520
|
+
`features/taskReview/core/service.ts`(CLI の `p3 review`・API の `/requests/:rid/tasks/:tid/reviews` が呼ぶ)。依頼文と結果の確かめ方は `review.ts`。
|
|
1427
1521
|
|
|
1428
1522
|
- **頼む先**: Preflight と同じ Codex の接続(`CodexWorkspaceEngine.ask`。認証・パスの対応・診断・時間と使用量の上限・取消を共有)。
|
|
1429
1523
|
毎回新しいスレッドで、作業したスレッドは再開しない。マウントするのは run の材料のフォルダ(`/workspace/material`)だけで、
|
|
@@ -1447,7 +1541,7 @@ requests/<要望ID>/task-reviews/.locks/<タスクID>.lock 状態を変
|
|
|
1447
1541
|
### リリースノートの要約(生成の境界)
|
|
1448
1542
|
|
|
1449
1543
|
マイルストーンのリリースノートの機能の要約は、Preflight と同じ Codex の接続(個人設定・認証・イメージの確かめ・起動の診断)で頼む
|
|
1450
|
-
(`CodexWorkspaceEngine.ask`、`
|
|
1544
|
+
(`CodexWorkspaceEngine.ask`、`features/releaseNotes/core/generate.ts`)。Preflight の評価・タスク化は行わない。
|
|
1451
1545
|
|
|
1452
1546
|
- **渡すもの**: 始めるときに固定した材料([リリースノートのデータ](#リリースノートのデータ))のうち、マイルストーンのタイトルと、
|
|
1453
1547
|
収録する要望とタスクの ID・タイトル・変更の記録だけを依頼文に入れる。要望やタスクの本文・成果物・参照先・データのフォルダは
|
|
@@ -1490,12 +1584,12 @@ package.json では公開版の版の範囲(`^0.2.0` など)で指定し、
|
|
|
1490
1584
|
- いつもの Preflight: 既定の1日より古ければ作り直す(個人設定 `codex.ensureImage: false` か `P3_CODEX_ENSURE_IMAGE=0` で止める)
|
|
1491
1585
|
- 強制更新(`p3 codex update`): `maxAgeMs` を -∞ にして、作った日時によらず作り直す。プロジェクト・認証を決める前に動き、
|
|
1492
1586
|
個人設定の自動更新の停止(`codex.ensureImage: false`)とも関係しない。前に `docker version` でデーモンを確かめ、
|
|
1493
|
-
失敗した段(docker が無い / デーモン / 作成 / 版の取得)ごとに次にすることを出す(`src/core/preflight/codexImage.ts`)
|
|
1587
|
+
失敗した段(docker が無い / デーモン / 作成 / 版の取得)ごとに次にすることを出す(`packages/tasks/src/core/preflight/codexImage.ts`)
|
|
1494
1588
|
- テストは偽の docker(`test/fixtures/fake-docker.mjs`)で行い、本物の Docker では次で確かめる:
|
|
1495
1589
|
`XDG_CONFIG_HOME=$(mktemp -d) p3 codex update --json`(未登録・未認証のままでよい)
|
|
1496
1590
|
- P3 は `ensureImage` そのものは呼ばない(inspect・build・版の確認のどれにも待つ時間の上限が無く、取消も受けないため)。同じ判定と
|
|
1497
1591
|
ビルドを、同梱の `DOCKER_CONTEXT` と `parseCreated` を使って `codexImage.ts` で行う(Dockerfile は写さない)
|
|
1498
|
-
- **Docker の待ち時間の上限と後片付け**(`src/core/preflight/docker.ts`): 以前は版の確認のコンテナ(`codex --version`)が版を出した後も
|
|
1592
|
+
- **Docker の待ち時間の上限と後片付け**(`packages/tasks/src/core/preflight/docker.ts`): 以前は版の確認のコンテナ(`codex --version`)が版を出した後も
|
|
1499
1593
|
終わらず、Preflight がそれを待って止まったことがある(2026-11-03)。P3 が動かす docker の操作には上限があり、時間切れ・中止では
|
|
1500
1594
|
docker の CLI を止め、P3 が名前を付けて起こしたコンテナはそのコンテナだけを `docker rm -f <名前>` で消す(`docker ps` の全部や
|
|
1501
1595
|
イメージ名では消さない)
|
|
@@ -1525,8 +1619,8 @@ llmcs の変更を P3 で使うには、llmcs 側で新しい版を公開し、P
|
|
|
1525
1619
|
|
|
1526
1620
|
### 画面イメージの描画のイメージ
|
|
1527
1621
|
|
|
1528
|
-
画面イメージの描画(`src/core/preflight/render.ts`)は、Codex のイメージ(llmcs の Dockerfile)とは別に、P3 が持つ
|
|
1529
|
-
Dockerfile(`src/core/preflight/render-image/`)で作る。llmcs の Dockerfile は変えない。将来 llmcs のイメージに
|
|
1622
|
+
画面イメージの描画(`packages/tasks/src/core/preflight/render.ts`)は、Codex のイメージ(llmcs の Dockerfile)とは別に、P3 が持つ
|
|
1623
|
+
Dockerfile(`packages/tasks/src/core/preflight/render-image/`)で作る。llmcs の Dockerfile は変えない。将来 llmcs のイメージに
|
|
1530
1624
|
Playwright が入っても、それだけでは描画の安全の条件(ネットワークなし・認証情報なし・リポジトリなし・原稿は読むだけ)を
|
|
1531
1625
|
満たさないので、描画は別のコンテナで行う。
|
|
1532
1626
|
|
|
@@ -1578,7 +1672,7 @@ Playwright が入っても、それだけでは描画の安全の条件(ネッ
|
|
|
1578
1672
|
ドキュメントは古いまま残ることがあるので、今のコードと食い違えば今のコードを正として評価・タスク案を作らせ、見つけた食い違いは
|
|
1579
1673
|
黙って片方に合わせず、すべてリスクか確認事項に書かせる(`instructions.ts` の「やること」。過去の記録と今のコードの食い違いも同じ扱い)。
|
|
1580
1674
|
`preflight.instructions` にはプロジェクト固有の評価の観点・制約を書く。どちらも Codex への指示に加わる。
|
|
1581
|
-
`preflight.runner`(`codex` / `agent`。`src/shared/preflightRunner.ts`)は Preflight の担当で、AI 向けの手順が `whoami --json` の
|
|
1675
|
+
`preflight.runner`(`codex` / `agent`。`packages/tasks/src/shared/preflightRunner.ts`)は Preflight の担当で、AI 向けの手順が `whoami --json` の
|
|
1582
1676
|
`preflight` から読む方針(評価のエンジン・run の `engine` とは別。P3 の実行の仕方は変えない)。未設定は `codex`、読めない値は
|
|
1583
1677
|
`invalidRunner` に残して担当を決めない(保存しても消さない。`config set preflight.runner=` で直す)。保存(`saveProject`)は
|
|
1584
1678
|
`preflight` を項目ごとに重ねるので、観点だけ・担当だけの更新(以前の API の形 `{ instructions }` も)で、もう片方は消えない。
|
|
@@ -1610,13 +1704,13 @@ Playwright が入っても、それだけでは描画の安全の条件(ネッ
|
|
|
1610
1704
|
古いまま残る(原本を変えても届かない)が、CLI は `pnpx @infodb/p3` で新しいものが使われるので、手順は CLI の版に合ったものになる。
|
|
1611
1705
|
|
|
1612
1706
|
- 入口は2つ。同梱のスキル(原本は `skills/p3/SKILL.md` の1つ。選んだ先(`claude` は `.claude/skills/p3/SKILL.md`(Claude Code)、
|
|
1613
|
-
`codex` は `.agents/skills/p3/SKILL.md`(Codex))に同じものを写す。置き先の一覧は `src/cli/project.ts` の `AGENT_TARGETS`、
|
|
1707
|
+
`codex` は `.agents/skills/p3/SKILL.md`(Codex))に同じものを写す。置き先の一覧は `packages/p3/src/cli/project.ts` の `AGENT_TARGETS`、
|
|
1614
1708
|
選び方は `AGENT_CHOICES`。個人のスキルの場所には置かない)と、AGENTS.md(無ければ CLAUDE.md)の「タスク管理(infodb p3)」の節
|
|
1615
|
-
(`src/cli/project.ts` の `agentsSnippet`。スキルの参照は、選んだ先と既にある先だけを書く。下は両方のときの `AGENTS_SNIPPET`)
|
|
1709
|
+
(`packages/p3/src/cli/project.ts` の `agentsSnippet`。スキルの参照は、選んだ先と既にある先だけを書く。下は両方のときの `AGENTS_SNIPPET`)
|
|
1616
1710
|
- 入口に書くのは、いつ使うか(スキルの `description`)・`pnpx @infodb/p3 guide --json` の `guide` を最後まで読んで従うこと・取得
|
|
1617
1711
|
できなければ p3 を操作せずエラーと呼び方を人に伝えて終えることだけ。入口の古さの伝え方・`whoami` での対象の確かめ方・更新の
|
|
1618
1712
|
しかたは手順(guide)の側に書く
|
|
1619
|
-
- 入口の版(`ENTRY_VERSION`。`src/cli/guide.ts`。正の整数)を、スキルは frontmatter の `metadata.p3-entry-version`(Agent Skills の
|
|
1713
|
+
- 入口の版(`ENTRY_VERSION`。`packages/p3/src/cli/guide.ts`。正の整数)を、スキルは frontmatter の `metadata.p3-entry-version`(Agent Skills の
|
|
1620
1714
|
`metadata` は文字列の対応なので `"1"`)、節は見出しの次の行のコメント `<!-- p3-entry-version: 1 -->` に持たせる。入口に書くこと
|
|
1621
1715
|
(呼び方・読み込みの約束)を変えたときだけ上げ、手順の本文の改訂では上げない。JSON の `schemaVersion`・CLI の `cliVersion` とは別
|
|
1622
1716
|
- 置き先を覚えておく共有の設定は持たない(参加の `join` は置かず、置く・最新にするのは人が明示する `p3 agents` だけなので、消した先が
|
|
@@ -1637,7 +1731,7 @@ Playwright が入っても、それだけでは描画の安全の条件(ネッ
|
|
|
1637
1731
|
|
|
1638
1732
|
### 置いた入口の診断(`agents`)
|
|
1639
1733
|
|
|
1640
|
-
`whoami --json` と `guide --json` は、同じ診断(`src/cli/agentsStatus.ts` の `diagnoseAgents`)を `agents` に返す。読むだけで、
|
|
1734
|
+
`whoami --json` と `guide --json` は、同じ診断(`packages/p3/src/cli/agentsStatus.ts` の `diagnoseAgents`)を `agents` に返す。読むだけで、
|
|
1641
1735
|
古くても操作を断らず、書き換えもしない(更新は人が `p3 agents` で行う。AI は伝えるだけ。手順の「置いた入口の状態」)。
|
|
1642
1736
|
|
|
1643
1737
|
- 調べるのは今いる git の作業ツリーのルート(git 管理外は今いる場所)の、両方のスキルと AGENTS.md / CLAUDE.md の両方の節だけ
|
|
@@ -1657,9 +1751,9 @@ Playwright が入っても、それだけでは描画の安全の条件(ネッ
|
|
|
1657
1751
|
|
|
1658
1752
|
### 作業の手順(`p3 guide`)
|
|
1659
1753
|
|
|
1660
|
-
置いたスキル・節は人が更新しないと古いまま残るので、手順の本文は実行中の CLI から読めるようにする(`src/cli/guide.ts`)。
|
|
1754
|
+
置いたスキル・節は人が更新しないと古いまま残るので、手順の本文は実行中の CLI から読めるようにする(`packages/p3/src/cli/guide.ts`)。
|
|
1661
1755
|
|
|
1662
|
-
- 原本は CLI と一緒に配る `src/cli/guide.md` の1つ(配布物では `scripts/build-cli.mjs` が写した `lib/cli/guide.md`)。毎回この原本を
|
|
1756
|
+
- 原本は CLI と一緒に配る `packages/p3/src/cli/guide.md` の1つ(配布物では `scripts/build-cli.mjs` が写した `lib/cli/guide.md`)。毎回この原本を
|
|
1663
1757
|
読んで返し、写しを持たない。オプションなしは本文、`--json` は `{ schemaVersion, cliVersion, entryVersion, guide, agents }`(`agents` は上の診断)
|
|
1664
1758
|
- `schemaVersion` は JSON の形の版(`GUIDE_SCHEMA_VERSION`)。`cliVersion` は同梱の `package.json` の版で、最新かどうかの判断には
|
|
1665
1759
|
使わない(npm に問い合わせない)。`entryVersion`(`ENTRY_VERSION`。正の整数)は入口(置いたスキル・節)の決まりの版で、起動の
|