@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/chatgpt-sign-in.md
CHANGED
|
@@ -5,7 +5,7 @@ P3 が自分でサインインした ChatGPT アカウント(Sign in with Chat
|
|
|
5
5
|
P3 自体の本人認証は足さない(ローカルの個人用ツールのまま)。
|
|
6
6
|
|
|
7
7
|
サインイン・保存・更新・解除の実装は、llmcs の chatgpt-plan-ts(npm の `@infodb/chatgpt-plan`)にある(P3 の実装を
|
|
8
|
-
アプリ名と保存先を引数にして切り出したもの)。P3 は `src/core/chatgpt.ts` で、アプリ名(`infodb_p3`)・保存先・
|
|
8
|
+
アプリ名と保存先を引数にして切り出したもの)。P3 は `packages/tasks/src/core/chatgpt.ts` で、アプリ名(`infodb_p3`)・保存先・
|
|
9
9
|
Codex に渡すトークンの長さ・CLI の案内だけを決めて使う。以下は部品と P3 の約束(部品を上げるときに確かめること)。
|
|
10
10
|
|
|
11
11
|
公式資料(2026-10-10 に確認。以下の契約はこれに合わせる):
|
|
@@ -75,7 +75,7 @@ Preflight
|
|
|
75
75
|
```
|
|
76
76
|
|
|
77
77
|
- `config.yaml` とは別のファイルにするので、プロジェクトや画面の設定を保存しても接続は消えず、その逆も起きない。
|
|
78
|
-
- Preflight のログとエラー(`run.json`)に残す前に、トークンらしいものを伏せる(`src/core/redact.ts`)。Codex は API の認証エラーで
|
|
78
|
+
- Preflight のログとエラー(`run.json`)に残す前に、トークンらしいものを伏せる(`packages/tasks/src/core/redact.ts`)。Codex は API の認証エラーで
|
|
79
79
|
キーの一部(先頭 8 文字と末尾 3 文字。例 `Incorrect API key provided: eyJhbGci***xyz`)を見せるので、それと JWT・Bearer の値・
|
|
80
80
|
渡したトークンそのものを `[伏せました]` にする
|
|
81
81
|
- CLI の `--json`、API、ログ、エラーには、トークンを出さない(状態として出すのはアカウントの email、プラン利用の可否、期限、ホスト ID・client ID の有無)。
|
package/docs/development.md
CHANGED
|
@@ -9,8 +9,8 @@ P3 そのものを開発するときの手順と、ソースの構成。使い
|
|
|
9
9
|
|
|
10
10
|
```bash
|
|
11
11
|
pnpm install
|
|
12
|
-
pnpm build # 画面(p3 serve で配信する dist/web)
|
|
13
|
-
pnpm link --global
|
|
12
|
+
pnpm build # 画面(p3 serve で配信する packages/p3/dist/web)と配布物(dist/package)
|
|
13
|
+
pnpm --dir packages/p3 link --global # `p3` コマンドをこのチェックアウトで使う(任意)
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
グローバルに入れずに、P3 の場所を指定して pnpm で直接動かしてもよい。管理したいリポジトリ(やその作業ツリー)の中で:
|
|
@@ -20,7 +20,10 @@ pnpm -s --dir /path/to/p3 p3 whoami # -s で pnpm 自身の出力を抑え
|
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
pnpm はスクリプトをパッケージの場所で動かすが、P3 は呼び出し元の場所(pnpm が渡す `INIT_CWD`)に戻ってから
|
|
23
|
-
対象のプロジェクト・今の要望(作業ツリーのブランチ)・git
|
|
23
|
+
対象のプロジェクト・今の要望(作業ツリーのブランチ)・git のユーザーを判定する(ルートの `p3-workspace` と入口の `@infodb/p3` の `p3` スクリプトのとき)。
|
|
24
|
+
|
|
25
|
+
このリポジトリは pnpm workspace で、入口(`packages/p3`)・tasks(`packages/tasks`)・kit(`packages/kit`)の3つのパッケージに分けている
|
|
26
|
+
(下の「構成」と [docs/architecture.md](architecture.md#パッケージの構成))。コマンドはどれもルートで動かす。
|
|
24
27
|
|
|
25
28
|
## よく使うコマンド
|
|
26
29
|
|
|
@@ -74,13 +77,23 @@ pnpm video # 使い方の動画を録り直す(.p3-video/p3-
|
|
|
74
77
|
- 手元の対話エージェントの Preflight(`--prepare` / `--complete`)は、CLI と取り込みを別プロセスのテストで確かめる
|
|
75
78
|
(`test/localPreflight.test.ts`。PATH を空にして Codex・Docker・claude を呼べない状態で通す)。Claude Code が入口のスキルから手順(`p3 guide`)を読んで
|
|
76
79
|
担当(`preflight.runner`)どおりに依頼を解釈するか、指示のファイルを読み切るかはテストでは確かめられない。担当で分けた手順の書き方の
|
|
77
|
-
契約は `test/agents.test.ts`、agent の親子の prepare → complete → drafts は `test/localPreflight.test.ts` が確かめる。手順(`src/cli/guide.md`)の Preflight の
|
|
80
|
+
契約は `test/agents.test.ts`、agent の親子の prepare → complete → drafts は `test/localPreflight.test.ts` が確かめる。手順(`packages/p3/src/cli/guide.md`)の Preflight の
|
|
78
81
|
節や指示の形を変えたときは、一時フォルダのプロジェクト(`init --agents claude --preflight-runner agent`)を Claude Code で開き、
|
|
79
82
|
親と子の要望を作って「要望 <ID> の Preflight をして」と頼み、prepare → 成果物 → complete → drafts まで進んで accept しないこと、
|
|
80
83
|
依頼の無い登録では始めないことを確かめる。`p3 config set preflight.runner=codex` に変えて、「Preflight して」とだけ頼むと聞き返すこと、
|
|
81
84
|
「このチャットで実行して」と明示すると手元で評価することも確かめる(版と結果はタスクの変更の記録に残す。確かめられなければ未検証と書く)。Claude Code がスキルを読む場所は公式の文書(<https://code.claude.com/docs/en/skills>)
|
|
82
|
-
- CLI のテストは別プロセスで `bin/p3.mjs` を動かし、個人設定を一時フォルダに分け、このマシンの `P3_*`
|
|
83
|
-
|
|
85
|
+
- CLI のテストは別プロセスで `bin/p3.mjs` を動かし、個人設定を一時フォルダに分け、このマシンの `P3_*` の環境変数は効かないようにしている。
|
|
86
|
+
コマンドのまとまりごとに `test/cli*.test.ts`(init・join・agents・タスク・要望・Preflight・設定・プロジェクトの決まり方・作業先と添付)に分け、
|
|
87
|
+
共通の準備(CLI の呼び出し `p3()`・テストごとの個人設定 `CONFIG_HOME`・初期化済みのプロジェクト `initialized()` など)は `test/cliHelpers.ts` に置く
|
|
88
|
+
- 開発中の CLI は起動のたびに tsx で TypeScript を変換するので、1回に約 0.5 秒かかる。1つのファイルの中のケースは順に動くので、ケースを
|
|
89
|
+
1つのファイルに積むと、そのファイルが `pnpm test` 全体の終わりを決める。CLI のケースを足すときは近いまとまりのファイルに入れ、
|
|
90
|
+
1つのファイルが長くなったら分ける(ファイルの間は Vitest が並べて動かす。ケースどうしで場所や状態を共有しない)
|
|
91
|
+
- 並べて動かすと CPU を取り合うので、CLI のテストファイルだけ1件の待ち時間を 60 秒にしている(`cliHelpers.ts`。ほかは `vitest.config.ts` の 20 秒)
|
|
92
|
+
- 子のプロセスには親の `P3_*` を渡さないので、`vitest.config.ts` の `P3_HOST_PATHS=direct` も CLI の子には届かない。要る値はケースで
|
|
93
|
+
`p3()` の `env` に明示する
|
|
94
|
+
- 所要時間を比べるときは、同じマシンで `pnpm test` を数回流し、全体の時間の中央値とファイルごとの時間を見る
|
|
95
|
+
(`pnpm vitest run --reporter=json --outputFile=<ファイル>` の各ファイルの `startTime`・`endTime`)
|
|
96
|
+
- データのフォルダの監視(`packages/tasks/src/core/store/dataWatcher.ts`)は `test/dataWatcher.test.ts` が確かめる。監視の失敗(入れ子の消失・
|
|
84
97
|
読めないエラー・開始の失敗・読み込みの失敗)は監視を差し替えて確実に起こし、ログ・立て直し・続けての失敗でやめること・close の後に
|
|
85
98
|
何も残らないことを見る。実際の監視は、通常の serve を別のプロセスで動かし(`test/fixtures/watchChild.ts`)、`drafts/` を作っては
|
|
86
99
|
消し続けても落ちず、API が答え、close の後に自分で終わることを見る。`--all-projects` で一方の監視が壊れても両方の API と
|
|
@@ -147,9 +160,9 @@ pnpm video # 使い方の動画を録り直す(.p3-video/p3-
|
|
|
147
160
|
TypeScript 7 の型検査器で tsconfig.json を読む)も動かす。設定は `.oxlintrc.json`。ESLint・Biome・整形の道具は入れていない
|
|
148
161
|
(書式はそろえて書く)。指摘は全部エラーで、警告も使われていない無効化コメントも `pnpm check` を落とす。
|
|
149
162
|
|
|
150
|
-
- **対象**: package.json の `lint`
|
|
151
|
-
|
|
152
|
-
- **除外**: 生成したルート一覧 `src/web/routeTree.gen.ts`。`dist/`・`node_modules/`・`.p3-demo/` は対象のフォルダの外
|
|
163
|
+
- **対象**: package.json の `lint` に並べた各パッケージの `src`(入口・tasks・kit)と入口の `bin`・`scripts`・`test`・`vite.config.ts`・`vitest.config.ts`・
|
|
164
|
+
`vitest.ui.config.ts`。この中の `.mjs`(起動の補助・偽の app-server など)も、TypeScript の対象ではないが型情報なしの規則で検査する
|
|
165
|
+
- **除外**: 生成したルート一覧 `packages/p3/src/web/routeTree.gen.ts`。`dist/`・`node_modules/`・`.p3-demo/` は対象のフォルダの外
|
|
153
166
|
- **規則**: plugin は typescript・unicorn・oxc・react・import・promise・vitest。それぞれの correctness(誤りか無意味なコード)を全部
|
|
154
167
|
使い、ほかのカテゴリは一括では入れず、次を選んで足す
|
|
155
168
|
|
|
@@ -183,7 +196,7 @@ suspicious カテゴリの一括(JSX で要らない `react-in-jsx-scope` な
|
|
|
183
196
|
|
|
184
197
|
- 中で try / catch して画面に知らせる関数(保存・Preflight の開始など)は `onClick={() => void save()}`。`void` は
|
|
185
198
|
「待たない」の印で、失敗を隠すためには使わない
|
|
186
|
-
- 失敗を受け止めない処理は `runAction(処理, (文言) => …)`(`src/web/lib/action.ts`)で、失敗を画面に渡す
|
|
199
|
+
- 失敗を受け止めない処理は `runAction(処理, (文言) => …)`(`packages/tasks/src/web/lib/action.ts`)で、失敗を画面に渡す
|
|
187
200
|
- 読み直し(`reload`)のように失敗を状態に入れて投げない関数は、子には `() => void reload()` を渡す
|
|
188
201
|
|
|
189
202
|
`test/lint.test.ts` が、採用した規則の代表的な違反(Hooks・待たない Promise・Promise の渡し方)で lint が失敗することと、
|
|
@@ -191,39 +204,54 @@ suspicious カテゴリの一括(JSX で要らない `react-in-jsx-scope` な
|
|
|
191
204
|
|
|
192
205
|
## 構成
|
|
193
206
|
|
|
207
|
+
pnpm workspace の3つのパッケージ。依存の向きは 入口 → tasks → kit の一方向(`test/packageBoundary.test.ts`)。パッケージの間はパッケージ名
|
|
208
|
+
(`@infodb/p3-tasks/core/context.ts` のように、パッケージの `src` からのパス)で読み、相対パスで別のパッケージのファイルを指さない。
|
|
209
|
+
入口と tasks の `src` は同じ層に分ける(依存の向き: shared ← core ← server / cli、web → shared。`test/layers.test.ts`)。設計と、機能ごとの
|
|
210
|
+
置き場所は [docs/architecture.md](architecture.md#パッケージの構成)。
|
|
211
|
+
|
|
194
212
|
```
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
guide.
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
routes/
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
213
|
+
packages/
|
|
214
|
+
p3/ 入口 @infodb/p3(npm・Docker で配るのはこれ。kit・tasks はビルドして同梱する)
|
|
215
|
+
bin/p3.mjs CLI の起動口(チェックアウトでは tsx でソースを、配布物ではビルドした lib/ を動かす)
|
|
216
|
+
src/cli/ main.ts(引数の解釈・プロジェクトの決定・serve・help・guide・init・join・agents)・project.ts(init / join / agents)・
|
|
217
|
+
guide.ts と guide.md(AI 向けの作業の手順の原本。p3 guide が返す)・agentsStatus.ts・help.ts
|
|
218
|
+
src/server/ server.ts(待ち受けと画面の配信)・api/projectsRoutes.ts(プロジェクトを跨ぐ serve)
|
|
219
|
+
src/core/ projectRegistry.ts(プロジェクトを跨ぐ serve の登録の一覧)
|
|
220
|
+
src/web/ 画面の外枠(main.tsx・Boot・App・router・routes/__root.tsx・プロジェクトの選択)と index.html・index.css。
|
|
221
|
+
routeTree.gen.ts はルート一覧(自動生成。tasks のページも入る)
|
|
222
|
+
tasks/ @infodb/p3-tasks(今の p3 の機能。公開しない)。共通の土台(層ごと)と機能のまとまり(features/)に分ける
|
|
223
|
+
src/shared/ 型定義・参照の解き方・日付・判定(core と画面の共通。I/O と node: は使わない)
|
|
224
|
+
src/cli/ tasksCli.ts(プロジェクトを開いた後の振り分け)・コマンドの種類ごと(taskCommands.ts など。変更は core/requestOps.ts を通す)・
|
|
225
|
+
readOnly.ts・args.ts・output.ts
|
|
226
|
+
src/core/ CLI と serve の共通の中核(HTTP は使わない)。requestOps.ts(変更の手順)・ops.ts(読み取り)・store/(保存・監視・項目の
|
|
227
|
+
まとまり fieldGroups.ts・JSON の記録 jsonRecord.ts)・preflight/(Preflight と AI の実行: エンジン・Codex と ChatGPT・Docker・
|
|
228
|
+
画面資料)・reviewRuns.ts(レビューの実行の骨組み)・errorOutcome.ts(エラーから終了コードと HTTP の状態への表)・
|
|
229
|
+
context.ts(プロジェクトを開く)・userConfig.ts・machineSettings.ts
|
|
230
|
+
src/server/api/ API の組み立て(routes.ts が機能の API をつなぐ)と共通の API
|
|
231
|
+
src/web/ 画面の共通の部品(components/)・処理(lib/)・ルートの宣言(routes/。ページの中身は機能の web/ から読む)
|
|
232
|
+
src/features/ 機能のまとまり。<機能>/{shared,core,cli,server,web} に層で分ける: metrics・records(完了の記録・手戻り・見直し候補・前提)・
|
|
233
|
+
quality・retro・requirements(要求の根拠・回答・受け入れ基準)・settings・taskReview・milestoneReview・releaseNotes。
|
|
234
|
+
読んでよいものは docs/refactoring.md「モジュール構成」(test/featureBoundary.test.ts)
|
|
235
|
+
kit/ @infodb/p3-kit(入口と製品が使う最小限の共通処理。公開しない): fsutil.ts・frontmatter.ts・usage.ts・appInfo.ts
|
|
217
236
|
skills/p3/SKILL.md AI 向けの入口のスキルの原本(p3 init --agents / p3 agents で .claude/skills・.agents/skills の選んだ先に写す。本文は p3 guide から読ませる)
|
|
218
|
-
scripts/
|
|
219
|
-
docs/
|
|
220
|
-
test/
|
|
237
|
+
scripts/ 配布物のビルド(build-cli.mjs)・デモデータ・配布物の確認・使い方の動画(video/)
|
|
238
|
+
docs/ 導入・使い方・開発・設計・公開の文書(利用者向けの入口。配布物にも入れる)
|
|
239
|
+
test/ ユニットテスト(パッケージをまたいで確かめるのでルートに置く)
|
|
221
240
|
```
|
|
222
241
|
|
|
223
|
-
|
|
242
|
+
- 外の依存は使うパッケージの manifest に書く(入口は実行時の依存をまとめて持つ。kit・tasks の実行時の依存は入口の `dependencies` にも同じ範囲で書く。
|
|
243
|
+
`test/package.test.ts`)。テストだけが直接使う外の部品はルートの `devDependencies`
|
|
244
|
+
- 将来の製品(p3-observer)は名前だけを決めている。パッケージを足すときは `packages/` に置き、入口から明示して組み込む
|
|
245
|
+
- tasks に機能を足すときは `features/<機能>/` に層で分けて置き、CLI は `cli/tasksCli.ts`、API は `server/api/routes.ts`、画面は `web/routes/` からつなぐ。
|
|
246
|
+
ほかの機能の中身は読まず、契約は `shared/` に置く(`test/featureBoundary.test.ts`)。コード量は `node scripts/measure-code.mjs` で数える
|
|
247
|
+
|
|
248
|
+
画面のページは TanStack Router のファイルベースのルーティングで、`packages/tasks/src/web/routes/` にファイルを置けば足りる
|
|
249
|
+
(入口の `__root.tsx` の下に、このフォルダをそのまま付ける。`tsr.config.json` の `virtualRouteConfig`)。機能のページは、ルートのファイルに
|
|
250
|
+
URL と検索の値の宣言だけを置き、中身を機能の `web/` に書く(例: `routes/metrics.tsx` と `features/metrics/web/MetricsPage.tsx`)。
|
|
224
251
|
小さいページは中身もそのファイルに書く。大きいページは、ルートのファイルを組み立て(状態と並び)だけにし、部品を
|
|
225
|
-
`src/web/components/<ページ>/` に分ける(要望の画面は `components/request/`)。ルート一覧 `src/web/routeTree.gen.ts` は
|
|
226
|
-
`pnpm dev` / `pnpm build` / `pnpm typecheck`
|
|
252
|
+
`packages/tasks/src/web/components/<ページ>/` に分ける(要望の画面は `components/request/`)。ルート一覧 `packages/p3/src/web/routeTree.gen.ts` は
|
|
253
|
+
`pnpm dev` / `pnpm build` / `pnpm typecheck` のたびに生成される(型検査のためにコミットしておく)。画面のビルド(Vite の root)は入口の
|
|
254
|
+
`packages/p3/src/web` で、Tailwind は tasks の `src/web` のクラスも拾う(`index.css` の `@source`)。
|
|
227
255
|
|
|
228
256
|
規則を足すときに直す場所は [docs/architecture.md](architecture.md) の「規則の置き場所」。
|
|
229
257
|
|
|
@@ -248,30 +276,33 @@ test/ ユニットテスト
|
|
|
248
276
|
|
|
249
277
|
## npm で配る中身
|
|
250
278
|
|
|
251
|
-
`@infodb/p3
|
|
252
|
-
|
|
253
|
-
|
|
279
|
+
`@infodb/p3`(入口のパッケージ)として npm に公開する(公開そのものは人が行う。手順は [docs/publishing.md](publishing.md))。kit・tasks は
|
|
280
|
+
公開せず、ビルドして同梱する。画面と CLI・serve をビルドして同梱し、利用者の環境では TypeScript を変換しない(`tsx` とそれが使う esbuild を
|
|
281
|
+
入れないので、pnpm がビルドのスクリプトの許可を聞かない)。このリポジトリの開発(`pnpm p3`・テスト)は、今までどおりソースを `tsx` でそのまま動かす。
|
|
254
282
|
|
|
255
283
|
| 何を | どうする |
|
|
256
284
|
| --- | --- |
|
|
257
|
-
|
|
|
258
|
-
|
|
|
259
|
-
|
|
|
260
|
-
|
|
|
285
|
+
| 公開する中身 | `pnpm build` が `dist/package/` に組み立てる(`npm pack ./dist/package`・`npm publish ./dist/package`): 入口の `bin/`、`lib/`(ビルド済みの CLI・serve。入口は `lib/{cli,core,server}`、同梱した tasks は `lib/tasks/`、kit は `lib/kit/`。描画のイメージの資材 `lib/tasks/core/preflight/render-image/` などの .ts 以外の資材を含む)、`dist/web`(ビルド済みの画面)と、ルートの `skills/`(AI 向けスキルの原本)・`docs/`(README から辿る文書)・README・LICENSE |
|
|
286
|
+
| 公開する manifest | `packages/p3/package.json` から開発だけの項目(`devDependencies` の workspace の参照・`scripts`)を外したもの。workspace のパッケージ(`@infodb/p3-tasks`・`@infodb/p3-kit`)の名前は manifest にも実行時の import にも残らない(`test/pack.test.ts`) |
|
|
287
|
+
| 同梱しないもの | `.env`・個人設定・デモデータ(`.p3-demo/`)・テスト・`scripts/`・TypeScript のソース(`packages/`・`src/`)・開発用のスキル(`.claude/`) |
|
|
288
|
+
| 実行時の依存 | `hono`・`@hono/node-server`・`yaml`・`zod`・`@infodb/codex-workspace`・`@infodb/chatgpt-plan`(入口の `dependencies`)。`tsx`(esbuild)と React などの画面の部品は開発用 |
|
|
289
|
+
| CLI・serve のビルド | `scripts/build-cli.mjs`(`pnpm build` の後半)。一時のフォルダ `packages/p3/build-src/` に配布物と同じ並び(入口の src/{cli,core,server}・`tasks/`・`kit/`)でソースを集め、パッケージ名の import を集めた先への相対パスに書き換えてから、`tsc` で `packages/p3/lib/` に 1:1 で出す(相対の import の `.ts` は `.js` に書き換わる)。.ts 以外の資材は同じ場所に写す。入口の `lib/{cli,server}` は `src` と同じ深さなので、`import.meta.url` からの相対の参照(`../../package.json`・`dist/web`)はそのまま効く。スキルの原本は上へ探す(配布物は同梱した `skills/`、チェックアウトはルートの `skills/`)。tasks の資材はそのファイルと同じフォルダだけを参照する。資材を足すときは、その層のフォルダに置けば写る。`packages/p3/lib/`・`dist/` は git で追跡しない |
|
|
261
290
|
| Node | `>=24`(`@infodb/codex-workspace`・`@infodb/chatgpt-plan` の `>=22` を満たす)。開発と Docker のイメージは Node 26 |
|
|
262
|
-
| 公開前のビルド | `
|
|
263
|
-
| bin | `p3`(`bin/p3.mjs`)。`src/cli/main.ts` があるチェックアウトでは tsx でソースを、無ければ(配布物)`lib/cli/main.js` を動かす。ソースを動かすときは今いる場所の `tsconfig.json` を読まない。`INIT_CWD` に戻るのは P3 自身の `pnpm p3`
|
|
291
|
+
| 公開前のビルド | ルートの `pnpm build`(`vite build` と `scripts/build-cli.mjs --require-web`)。入口の manifest にはスクリプトを書かない。利用者が入れるときにはビルドも Docker の操作もしない |
|
|
292
|
+
| bin | `p3`(`packages/p3/bin/p3.mjs`)。`packages/p3/src/cli/main.ts` があるチェックアウトでは tsx でソースを、無ければ(配布物)`lib/cli/main.js` を動かす。ソースを動かすときは今いる場所の `tsconfig.json` を読まない。`INIT_CWD` に戻るのは P3 自身の `pnpm p3` スクリプト(ルートの `p3-workspace` か入口の `@infodb/p3`)のときだけ |
|
|
293
|
+
| 動いている版 | 入口が起動のときに自分の package.json の版を kit の `appInfo.ts` に渡し、tasks(Codex に名乗る版など)はそこを読む |
|
|
264
294
|
|
|
265
295
|
```bash
|
|
266
296
|
pnpm -s check # 型検査・lint・テスト・画面のビルド・UI テスト
|
|
267
|
-
pnpm verify:pack --docker # npm pack → 実行時の依存だけで別の場所に入れて動かす(scripts/verify-pack.mjs)
|
|
297
|
+
pnpm verify:pack --docker # pnpm build → npm pack ./dist/package → 実行時の依存だけで別の場所に入れて動かす(scripts/verify-pack.mjs)
|
|
268
298
|
# DevContainer の中では、描画の出力先を Docker のホストから見えるところにする
|
|
269
299
|
P3_CODEX_PATH_MAP=/workspaces=/home/me/workspaces pnpm verify:pack --docker --render-dir /workspaces/tmp
|
|
270
300
|
```
|
|
271
301
|
|
|
272
302
|
## Docker のイメージ
|
|
273
303
|
|
|
274
|
-
`Dockerfile`(Docker Hub の `tamuto/p3`。ビルドは Node 26 と packageManager の pnpm でロックファイルどおりに入れ、`pnpm pack`
|
|
304
|
+
`Dockerfile`(Docker Hub の `tamuto/p3`。ビルドは Node 26 と packageManager の pnpm でロックファイルどおりに入れ、`pnpm build` の後に `npm pack ./dist/package` で
|
|
305
|
+
公開と同じ tarball を作って展開し、実行時の依存は `pnpm --filter @infodb/p3 deploy --prod` で workspace の lockfile のまま入口の分だけを
|
|
275
306
|
入れる。実行も Node 26・git・Docker の CLI と buildx。既定は `serve --all-projects --host 0.0.0.0`)と `.dockerignore`
|
|
276
307
|
(git・依存・ビルドの出力・データ・個人設定・認証・テストを入れない)。約束は `test/docker.test.ts` が確かめる。
|
|
277
308
|
ベースの Node はメジャー版(ビルドも実行も `node:26-bookworm-slim`。描画のイメージも同じ)だけを指定し、同じメジャーの中の更新(セキュリティ
|
|
@@ -295,7 +326,7 @@ P3_CODEX_PATH_MAP=/workspaces=/home/me/workspaces node scripts/verify-docker.mjs
|
|
|
295
326
|
serve になること。本物の Codex(ソケット・pathMap・ChatGPT の接続)での Preflight・画面資料・要約の生成は、このスクリプトでは
|
|
296
327
|
確かめない(接続できる環境で手で確かめ、結果を PR に残す。Mock の成功で代わりにしない)。
|
|
297
328
|
|
|
298
|
-
マウントするパスの自動の決め方(`src/core/preflight/hostPaths.ts`)は `node scripts/verify-host-paths.mjs` で本物の Docker で
|
|
329
|
+
マウントするパスの自動の決め方(`packages/tasks/src/core/preflight/hostPaths.ts`)は `node scripts/verify-host-paths.mjs` で本物の Docker で
|
|
299
330
|
確かめる。このマシン(DevContainer など)と、Dockerfile から作ったイメージ(中と外で違うパスの bind 2つ・名前付きボリューム・
|
|
300
331
|
ソケット・コンテナの名前と違うホスト名)の両方で、`codex.pathMap` の無い使い捨ての個人設定の p3 が、`p3 user-config paths` で
|
|
301
332
|
自分のコンテナを確かめてパスを決めること、bind の下の原稿を `p3 render` で PNG にすること、volume の下・コンテナの中だけの原稿・
|
|
@@ -334,10 +365,12 @@ serve になること。本物の Codex(ソケット・pathMap・ChatGPT の
|
|
|
334
365
|
| [docs/architecture.md](architecture.md) | 設計と規則(なぜそうするか・どこで守っているか) |
|
|
335
366
|
| [docs/chatgpt-sign-in.md](chatgpt-sign-in.md) | ChatGPT のサインインの設計 |
|
|
336
367
|
| [docs/publishing.md](publishing.md) | npm への公開のチェックリスト |
|
|
368
|
+
| [docs/refactoring.md](refactoring.md) | 重複の整理とモジュール構成の組み直し(計測の定義と基準・重複の棚卸し・契約とテストの対応・段階ごとにまとめたもの) |
|
|
369
|
+
| [docs/feature-inventory.md](feature-inventory.md) | 機能の棚卸し(機能ごとの維持・統合・簡素化・分離・廃止・保留の判断と、複数パッケージの構成での所属の候補)。機能を足す・分けるときと、パッケージの構成を変えるときに見直す |
|
|
337
370
|
| docs/development.md(この文書) | 開発の手順と構成 |
|
|
338
371
|
|
|
339
372
|
同じ説明を複数の文書に書かない(片方からリンクする)。確認作業の記録(どの幅・どのブラウザで確かめたか)は文書に書かず、
|
|
340
|
-
PR とタスクの変更の記録に残す。CLI のヘルプ(`src/cli/help.ts`)・API の説明(`src/server/api/manifest.ts`)は入口が変わったとき、
|
|
341
|
-
AI の手順が変わったときは手順の原本 `src/cli/guide.md`(`p3 guide` が返す)の1か所を直す。置く入口(`skills/p3/SKILL.md` と
|
|
342
|
-
`src/cli/project.ts` の `agentsSnippet`(`AGENTS_SNIPPET`))は、入口に書くこと(呼び方・読み込みの約束)を変えたときだけ両方を直し、
|
|
343
|
-
`src/cli/guide.ts` の `ENTRY_VERSION` を上げる(手順の本文だけの改訂では上げない。`test/agents.test.ts` が確かめる)。
|
|
373
|
+
PR とタスクの変更の記録に残す。CLI のヘルプ(`packages/p3/src/cli/help.ts`)・API の説明(`packages/tasks/src/server/api/manifest.ts`)は入口が変わったとき、
|
|
374
|
+
AI の手順が変わったときは手順の原本 `packages/p3/src/cli/guide.md`(`p3 guide` が返す)の1か所を直す。置く入口(`skills/p3/SKILL.md` と
|
|
375
|
+
`packages/p3/src/cli/project.ts` の `agentsSnippet`(`AGENTS_SNIPPET`))は、入口に書くこと(呼び方・読み込みの約束)を変えたときだけ両方を直し、
|
|
376
|
+
`packages/p3/src/cli/guide.ts` の `ENTRY_VERSION` を上げる(手順の本文だけの改訂では上げない。`test/agents.test.ts` が確かめる)。
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
# 機能の棚卸し(判断表)
|
|
2
|
+
|
|
3
|
+
今の p3 の機能を一覧にし、それぞれを残すか(維持・統合・簡素化・分離・廃止・保留)と、複数パッケージの構成(B 案)にしたときにどこへ置くか(入口・kit・tasks・未定)の候補をまとめる。
|
|
4
|
+
将来、p3 を複数の製品(今の機能の p3-tasks、観測の基盤の p3-observer など)を選んで組み合わせる形にすることを背景にした評価で、
|
|
5
|
+
リポジトリを複数パッケージに移す後続の要望 261119-9d1zk は、この表を置き場所の根拠に使う。
|
|
6
|
+
|
|
7
|
+
- **基準のコミット**: `a881b68`(main。0.13.0 のリリースの後、261119-3d256 のマージまで)。表の根拠のパスはこの時点のもの
|
|
8
|
+
- **この文書で決めないこと**: 機能の削除・統合・作り直し、パッケージの分割と公開の方式、p3-observer の責務と実装。表の「統合」「簡素化」「分離」は
|
|
9
|
+
将来の候補で、どれも別の要望で利用実態と影響を確かめてから行う。変えないという判断も含む
|
|
10
|
+
- 判断は、コードと文書を読んで行った(静的な調査)。実際の利用の頻度・外部のスクリプトの依存は確かめていない([追加の調査が要る事項](#追加の調査が要る事項))
|
|
11
|
+
|
|
12
|
+
## 読み方
|
|
13
|
+
|
|
14
|
+
**判断**
|
|
15
|
+
|
|
16
|
+
| 判断 | 意味 |
|
|
17
|
+
| --- | --- |
|
|
18
|
+
| 維持 | 今の責務のまま残す |
|
|
19
|
+
| 統合 | 重なっている部分を1つにまとめる候補(まとめる範囲を表に書く) |
|
|
20
|
+
| 簡素化 | 残すが、入口・手順・持ち物を減らす候補 |
|
|
21
|
+
| 分離 | 1つの機能の中に、入口・共通(kit)に属する部分と tasks に属する部分が混ざっている。B 案で分けて置く候補 |
|
|
22
|
+
| 廃止 | なくす候補(今回は該当なし) |
|
|
23
|
+
| 保留 | 今は判断しない。判断する条件を書く |
|
|
24
|
+
|
|
25
|
+
**所属の候補**(B 案。依存の向きは 入口 → 製品(tasks・将来の observer) → kit の一方向)
|
|
26
|
+
|
|
27
|
+
| 所属 | 意味 |
|
|
28
|
+
| --- | --- |
|
|
29
|
+
| 入口 | 配布(npm の `@infodb/p3`・Docker)・起動・CLI の振り分け・serve・画面の外枠。入っている製品をコマンドと画面に組み込む |
|
|
30
|
+
| kit | 2 つ以上の製品が使う最小限の共通処理(保存の土台・個人設定の読み書きなど)。今 1 つの製品しか使わないものは入れない |
|
|
31
|
+
| tasks | 今の p3 の機能(要望から人の確認までの記録) |
|
|
32
|
+
| 未定 | 今は決めない。B 案での暫定の置き場所と、決め直す条件を書く |
|
|
33
|
+
|
|
34
|
+
**判断の優先順**: 要望から人の判断までの根拠を追えること(p3 の目的)→ 段階を踏んで導入できること → 既存の契約(データ・CLI・API・画面)への影響 → 製品の間の結合の少なさ。
|
|
35
|
+
|
|
36
|
+
## 判断表
|
|
37
|
+
|
|
38
|
+
ID(F01…)は後続の要望から参照するための番号。
|
|
39
|
+
|
|
40
|
+
| ID | 今の機能 | 判断 | 所属の候補 | 根拠と、変えるときに守る契約 |
|
|
41
|
+
| --- | --- | --- | --- | --- |
|
|
42
|
+
| F01 | npm の bin・Docker の起動、CLI の最上位の振り分けと help、画面の静的配信 | 維持 | 入口 | `package.json`・`bin/p3.mjs`・`src/cli/main.ts`・`src/cli/help.ts`・`src/server/server.ts`・`Dockerfile`。コマンド名・引数・終了コード・標準出力と標準エラー・ビルドした成果物(`lib/`・`dist/web`)の見つけ方を変えない |
|
|
43
|
+
| F02 | 配布物の確認(`verify-pack`・`verify-docker`・`verify-host-paths`・`check-browser`)と公開の手順 | 維持 | 入口 | `scripts/verify-*.mjs`・`scripts/check-browser.ts`・`docs/publishing.md`。B 案でも利用者の入れ方(`pnpx @infodb/p3`・`tamuto/p3`)が同じであることをここで確かめる |
|
|
44
|
+
| F03 | AI 向けの入口(スキル・AGENTS.md の節)、`p3 guide`、入口の版の診断(`agents`) | 分離 | 入口 | `skills/p3/SKILL.md`・`src/cli/{project,guide,agentsStatus}.ts`。入口の置き方・更新・診断は入口、`guide.md` の要望の運用の手順は tasks の責務。今の入口から同じ guide に辿り着けることを守る |
|
|
45
|
+
| F04 | 初期化・参加・プロジェクトと参照先の登録、今いる場所からのプロジェクトの決定、読むだけの操作の判定 | 分離 | 入口 | `src/cli/{main,project,readOnly}.ts`・`src/core/store/{locate,projectFile}.ts`・`src/core/repoAdmin.ts`。登録・選択は入口。`init` の project.yaml の中身・作業先の規則・コマンドごとの読む/書くの分類は tasks。登録が1つだけで決まったときの書き込みの抑止(`readsOnly`)を守る |
|
|
46
|
+
| F05 | 個人設定の読み書き(`user-config`)、マシンごとの設定、変更者の識別 | 分離 | kit | `src/core/{userConfig,machineSettings,machineSettingsEdit}.ts`・`src/cli/userConfig.ts`。ファイルの入出力と出どころ(環境変数/個人設定/既定)の決め方だけを kit の候補にする。tasks 固有の項目・Codex の設定・パスの対応は持ち込まない |
|
|
47
|
+
| F06 | 置き換え書き込み・ファイルのロック・frontmatter | 分離 | kit | `src/core/store/{fsutil,frontmatter}.ts`。既に複数の用途(要望・タスク・run・指標・設定)が使う最小単位。要望 ID の採番・知らない項目の保存の規則・アーカイブ・読み込みの正規化(`normalize.ts`)は tasks に残す |
|
|
48
|
+
| F07 | serve の待ち受け・プロジェクトの切り替え(`--all-projects` を含む)、ナビゲーション、テーマ、汎用の表示部品 | 分離 | 入口 | `src/server/{server.ts,api/projectsRoutes.ts,api/local.ts}`・`src/core/{projectRegistry,userTheme}.ts`・`src/web/{Boot,App,router}.tsx`・`src/web/routes/__root.tsx`・`src/web/components/{ProjectSwitcher,ThemePanel,ui}.tsx`。外枠だけを入口にし、製品のページと状態は製品側。1 つ/複数プロジェクトの URL、未保存の入力の扱い、テーマの個人設定、待ち受けの既定値(`0.0.0.0`)と個別の API のローカル制限を引き継ぐ。共通部品を kit に移すのは 2 つ目の製品の具体的な利用が出てから |
|
|
49
|
+
| F08 | データのフォルダの変更の監視・画面への変更通知(SSE)・読み直し | 分離 | 入口 | `src/core/store/dataWatcher.ts`・`src/server/api/routes.ts` の `/events`・`/reload`・`src/web/lib/appData.tsx`。監視と通知の仕組みは入口(全製品が使う)、何を読み直すか(要望・タスクのコレクション)は tasks。監視の失敗で serve を落とさない守りを引き継ぐ |
|
|
50
|
+
| F09 | AI 向けの API の説明(`/api/ai/manifest`) | 分離 | 入口 | `src/server/api/manifest.ts`。説明の集め方は入口、各 API の説明の中身は製品が持つ。今の URL と形を守る |
|
|
51
|
+
| F10 | 要望の登録と本文の編集、タグ・検索と ID の解決(`find`・`resolve`)・期限、親子・子の順・進捗の表示 | 維持 | tasks | `src/core/{requestOps,hierarchy,ops,requestStatus}.ts`・`src/cli/requestCommands.ts`・`src/web/routes/index.tsx`・`src/web/routes/requests/`。親子の完了の判定・集計・表示の順・既存の ID を守る |
|
|
52
|
+
| F11 | 要求の出典と確認・確認事項への回答・前提の変化・メモ | 維持 | tasks | `src/shared/requirementSource.ts`・`src/core/requestOps.ts`・`src/core/store/noteStore.ts`・`src/cli/{requirementCommands,revisitCommands}.ts`。要望・基準を変えると確認が効かなくなり、評価対象の固定と採用の判定に効く |
|
|
53
|
+
| F12 | 添付の保存と参照、xlsx から Preflight の資料を作る経路 | 維持 | tasks | `src/core/store/attachments.ts`・`src/core/preflight/{xlsx,input}.ts`。元の添付と run に固定した資料の関係を守る |
|
|
54
|
+
| F13 | Preflight の評価・評価対象の固定・履歴・再評価・取り消し・取り込み(Codex と手元のエージェント) | 維持 | tasks | `src/core/preflight/service.ts`・`src/cli/preflightCommands.ts`。Codex と手元のエージェントを選べること、古い run と評価対象の照合、Mock での確かめる経路が要る |
|
|
55
|
+
| F14 | タスク案の編集・タスク化・子の要望への分割と採用 | 維持 | tasks | `src/core/preflight/{service,split,carryover}.ts`。案は人が選ぶ。タスクの直接作成の経路と、採用で引き継ぐ ID・基準・出典・依存・置き換えを守る |
|
|
56
|
+
| F15 | 画面資料の原稿・描画・表示と `render` コマンド | 維持 | tasks | `src/core/preflight/{uiMaterials,uiRender,wireframe,render}.ts`・`src/cli/render.ts`。描画の環境は任意。原稿と描いた画像の対応、描けないときの表示、既存のコマンドを守る |
|
|
57
|
+
| F16 | タスクの直接作成・作業先とブランチ・状態・停止・依存・置き換え・アーカイブ | 維持 | tasks | `src/core/{workTargets,requestOps,supersede}.ts`・`src/core/store/archivedTasks.ts`・`src/cli/taskCommands.ts`。要望を単位にした作業、タスクの状態と人の「済み」を分けること、古い ID と履歴を守る |
|
|
58
|
+
| F17 | 受け入れ基準・証拠と根拠の種類・成果物・変更の記録・人の「済み」、完了の記録と参照先のコミットの取得 | 維持 | tasks | `src/shared/{acceptance,completionRecord}.ts`・`src/core/{requestOps,completionRefs,repoRefs}.ts`。証拠は申告と根拠の記録。中身が変わると済みを外す規則、古い形の読み込み、申告と未確認の区別を守る |
|
|
59
|
+
| F18 | 品質基準とテンプレート、Preflight での固定と基準への取り込み | 維持 | tasks | `src/core/quality.ts`・`src/shared/qualityTemplates.ts`・`src/cli/qualityCommands.ts`。未設定でも使えること、版と作業先に応じた当てはめ、レビューの材料への影響を守る |
|
|
60
|
+
| F19 | タスクの AI レビュー、マイルストーンレビューと run の管理 | 統合 | tasks | `src/core/{taskReview/,milestoneReview/,reviewRuns.ts}`。統合は既に共用している保存・取り消し・回復の範囲に限る。材料・結果・実行の対象の契約はそれぞれ残す。Preflight・リリースノートの生成も含めた run の管理の統合は、回復と取り消しの違いを照らしてから判断する |
|
|
61
|
+
| F20 | 見直し候補・品質の改善要望 | 維持 | tasks | `src/core/{reviewCandidates,qualityImprovement}.ts`・`src/cli/revisitCommands.ts`。前者は完了の記録と今の条件の照合、後者は診断から原稿を作って明示の操作で登録する |
|
|
62
|
+
| F21 | マイルストーンの目的・予定機能・並び・リリース済み・要望の一括完了 | 維持 | tasks | `src/shared/{milestoneGoals,milestoneOrder}.ts`・`src/core/releaseNotes/completeRequests.ts`。項目の削除と一括完了は、親子の判定と参照の保護(記録のあるマイルストーンは消さない)に効く |
|
|
63
|
+
| F22 | リリースノートの手での編集・保存・出力 | 維持 | tasks | `src/core/releaseNotes/service.ts`・`src/cli/releaseNotesCommands.ts`・`src/web/routes/release-notes.tsx`。マイルストーンと変更の記録に依存する。保存と出力の契約を守る |
|
|
64
|
+
| F23 | リリースノートの AI 要約 | 簡素化 | tasks | `src/core/releaseNotes/generate.ts`。任意の生成として扱い、手で書いて保存する導線を先にする候補。生成と保存は既に分かれている。削除や CLI・API の変更の判断には利用実態が要る |
|
|
65
|
+
| F24 | Preflight のリスクの振り返り、完了と手戻りの履歴 | 維持 | tasks | `src/core/retrospective.ts`・`src/shared/{completionRecord,reworkHistory}.ts`・`src/cli/retroCommands.ts`。採用した run が固定したリスク、人の判定と根拠、訂正の履歴は要望に属する |
|
|
66
|
+
| F25 | 開発の指標の集計、費用・リリース後の不具合の人による記録 | 維持 | tasks | `src/core/metrics/`・`src/cli/metricsCommands.ts`・`src/web/routes/metrics.tsx`。定義・0 と欠損と記録なしの区別・通貨と期間とマイルストーンの境界を守る。人の記録は CLI、集計は CLI・API・画面。独立した観測(F28)の利用が具体化したら、人が記録する指標の責務を見直す |
|
|
67
|
+
| F26 | Codex の準備・起動・診断、ChatGPT の接続、Docker とホストのパス、ログの秘密の除去 | 保留 | 未定 | `src/cli/{codex,chatgpt}.ts`・`src/core/{chatgpt,redact}.ts`・`src/core/preflight/{codexEngine,docker,hostPaths}.ts`・`src/server/api/chatgptRoutes.ts`。**B 案では暫定で tasks**。2 つの製品に共通する認証・実行環境と、設定・秘密の情報の境界が具体化したら決め直す。接続の保存先と各機能が渡す入力の範囲を守る |
|
|
68
|
+
| F27 | デモデータと使い方の動画 | 維持 | tasks | `scripts/{demo,demoData}.ts`・`scripts/video/`。tasks の画面と CLI を使う開発用の道具(配布物には入らない)。B 案では tasks のパッケージに付ける |
|
|
69
|
+
| F28 | 独立した観測・再現・実験の結果の収集 | 保留 | 未定 | 将来の構想(p3-observer)。今の機能には無く、今の証拠・レビュー・指標は上の tasks の行の責務。観測の入力・確かめる主体・保存の契約・利用者が具体化したら判断する。**B 案では置くものが無い**(パッケージの名前だけ決める) |
|
|
70
|
+
|
|
71
|
+
### まとめ
|
|
72
|
+
|
|
73
|
+
- **廃止**: 現時点で確定できる機能は無い。利用の頻度が分からない機能は、利用実態と代わりの経路を別の要望で評価する
|
|
74
|
+
- **簡素化の候補**: F23(リリースノートの AI 要約)
|
|
75
|
+
- **統合の候補**: F19(AI レビューの run の管理。共用済みの範囲に限る)
|
|
76
|
+
- **分離(B 案で分けて置く)**: F03〜F09。入口と kit に切り出すのは起動・登録・外枠・保存の土台・個人設定・監視で、中身(要望の運用)は tasks に残る
|
|
77
|
+
- **保留**: F26(AI 接続・実行環境。暫定 tasks)、F28(独立した観測。置くものなし)
|
|
78
|
+
- 残りは **tasks に維持**。要望から人の確認までの記録・振り返り・指標は tasks の責務
|
|
79
|
+
|
|
80
|
+
## B 案(261119-9d1zk)への引き継ぎ
|
|
81
|
+
|
|
82
|
+
**依存の向き**
|
|
83
|
+
|
|
84
|
+
- 入口 → 製品(tasks) → kit の一方向。製品どうしは直接 import しない
|
|
85
|
+
- 入口は、今の `P3Context`(`src/core/context.ts`)が組み立てている製品固有のサービス(Preflight・レビュー・要約など)を kit に持ち込まず、製品の側で組み立てる
|
|
86
|
+
- 今の `src/shared` は「画面と Node の両方から読める」という層の規則で、tasks 固有の型(要望・タスク・基準・根拠など)を多く含む。B 案では
|
|
87
|
+
tasks の共有の型と kit の処理を分けて扱い、`shared` をまるごと kit に移さない
|
|
88
|
+
- 依存の向きは `test/layers.test.ts` と同じ仕組みで、パッケージの間についても確かめる
|
|
89
|
+
|
|
90
|
+
**守る契約(移す前と後で照らす)**
|
|
91
|
+
|
|
92
|
+
- 外から使う入口と出力: CLI のコマンド・別名・`--json` の形・終了コード・標準エラーの知らせ、HTTP の URL と形、1 つ/複数プロジェクトの画面の
|
|
93
|
+
URL と使い方、スキルと `p3 guide`、npm(`@infodb/p3`・`p3`・`pnpx @infodb/p3`)と Docker(`tamuto/p3`)
|
|
94
|
+
- データ: データのフォルダの場所と形(`project.yaml`・`requests/`・`metrics/`・`task-reviews/`・`milestone-reviews/`・`release-notes/` など)、
|
|
95
|
+
古い run・古い記録、知らない frontmatter の項目の保存、ロックと版(`rev`)。データの移行は要らない形にする
|
|
96
|
+
- 開発: `pnpm -s check` が型検査から UI テストまで通ること
|
|
97
|
+
|
|
98
|
+
**回帰の確認に使う既存のテスト**
|
|
99
|
+
|
|
100
|
+
| 確かめること | テスト |
|
|
101
|
+
| --- | --- |
|
|
102
|
+
| 層・パッケージの依存の向き | `test/layers.test.ts` |
|
|
103
|
+
| 配布物の中身と文書のリンク | `test/package.test.ts`・`test/docs.test.ts`・`scripts/verify-pack.mjs`(`--docker`) |
|
|
104
|
+
| CLI の入口・プロジェクトの決まり方・読むだけの判定 | `test/cli*.test.ts`(特に `test/cliResolve.test.ts`) |
|
|
105
|
+
| 手元のエージェントの Preflight(Codex・Docker なし) | `test/localPreflight.test.ts` |
|
|
106
|
+
| 複数プロジェクトの serve | `test/allProjects.test.ts` |
|
|
107
|
+
| 画面の流れ | `test/ui/flow.ui.test.ts` ほか `test/ui/` |
|
|
108
|
+
| AI の入口と手順 | `test/agents.test.ts`・`test/guide.test.ts` |
|
|
109
|
+
|
|
110
|
+
## 文書と今のコードの違い
|
|
111
|
+
|
|
112
|
+
後続の要望で文書かコードを直す。この文書では直さない。
|
|
113
|
+
|
|
114
|
+
- 要望の概要(Preflight に渡すプロジェクトの説明)では、ブラウザの画面を「ビューア」と呼んでいる。今の画面は要望の編集・案の採用・タスクの更新もできる
|
|
115
|
+
- `docs/architecture.md` の「開発の工程と P3 の受け持ち」の表は、確認事項への回答をメモ中心に書いている。今は ID の付いた回答を要望に保存し、
|
|
116
|
+
評価対象の固定と採用の判定に反映する。同じ表に、リスクの振り返り・開発の指標・証拠の根拠の種類が無い
|
|
117
|
+
- `src/cli/metricsCommands.ts` の冒頭のコメントは「読むだけ」としているが、今の `metrics record` と `metrics rm` は記録を変える(API と画面は読むだけ)
|
|
118
|
+
- 画面を開く例は `http://localhost:4310` だが、serve の待ち受けの既定は `0.0.0.0`。個別の API のローカル制限(`src/server/api/local.ts`)と serve 全体の
|
|
119
|
+
制限を取り違えない
|
|
120
|
+
- 見送りにした要望 261119-vgxsq で互換を崩してよいとした回答は、その要望についてのもの。B 案は 261119-9d1zk の互換の条件(入口・データ・CLI・API・画面を変えない)に従う
|
|
121
|
+
|
|
122
|
+
## 追加の調査が要る事項
|
|
123
|
+
|
|
124
|
+
- 機能ごとの実際の利用の頻度と、外部のスクリプト・自動化が使っている CLI・API(簡素化・廃止の判断の前に要る。特に F23)
|
|
125
|
+
- AI 接続・実行環境を製品の間で共通にするか(F26): 2 つ目の製品が要る認証・実行環境・秘密の情報の範囲
|
|
126
|
+
- p3-observer の責務と契約(F28): 観測の入力・確かめる主体・保存の形・利用者
|
|
127
|
+
- B 案の配布の方式: kit・tasks を別のパッケージとして npm に出すか、`@infodb/p3` に同梱するか(261119-9d1zk の Preflight で比べる)
|
|
128
|
+
- AI レビュー以外の run(Preflight・リリースノートの生成)の管理を統合できるか(F19): 回復と取り消しの違い
|
|
129
|
+
|
|
130
|
+
## 照らした範囲
|
|
131
|
+
|
|
132
|
+
表の漏れを、基準のコミットの次の一覧と照らした。
|
|
133
|
+
|
|
134
|
+
| 一覧 | 対応する行 |
|
|
135
|
+
| --- | --- |
|
|
136
|
+
| CLI のコマンド(`src/cli/main.ts` と各 `*Commands.ts` の振り分け) | `init`・`join`・`project`・`whoami` → F04、`user-config` → F05、`agents`・`guide`・`help` → F01・F03、`serve` → F07、`request`・`req`・`find`・`resolve`・`progress`・`ls`・`show` → F10、`source`・`clarify`・`answer`・`premise`・`revisit`・`notes`(メモは `preflight --note`)→ F11・F20、`attach` → F12、`preflight`・`drafts`・`accept` → F13・F14、`render` → F15、`new`・`add`・`set`・`move`・`block`・`unblock`・`archive`・`repo` → F04・F16、`criteria`・`evidence`・`check` → F17、`quality` → F18・F20、`review`・`reviews`・`review-show`・`review-cancel` → F19、`milestone` → F19・F21、`release-notes` → F21〜F23、`retro` → F24、`metrics` → F25、`codex`・`chatgpt` → F26、`config` → F04・F10 |
|
|
137
|
+
| HTTP API(`src/server/api/*.ts`) | `/mode`・`/projects`・`/project` → F04・F07、`/events`・`/reload` → F08、`/ai/manifest` → F09、`/requests`・`/tasks`・`/resolve`・`child-order` → F10・F16、`sources`・`answers`・`premises`・`notes`・`/revisit` → F11・F20、`attachments` → F12、`preflight`・`drafts`・`children`・`materialize`・`/engine` → F13〜F15、`quality`・`quality-diff`・`quality-import`・`quality/improvements` → F18・F20、`reviews`・`review-preview`・`milestone-reviews` → F19、`release-notes`・`release-generations`・`complete-requests` → F21〜F23、`retrospective` → F24、`/metrics` → F25、ChatGPT(`login`・`logout`・`paste`)→ F26 |
|
|
138
|
+
| 画面のルート(`src/web/routes/`) | `__root.tsx` → F07、`index.tsx`・`requests/` → F10〜F17・F19、`release-notes.tsx` → F21〜F23、`metrics.tsx` → F25、`settings.tsx` → F04・F05・F07・F18・F26 |
|
|
139
|
+
| データ(データのフォルダと個人設定) | `project.yaml` → F04、`requests/<ID>/`(`request.md`・`tasks/`・`notes/`・`attachments/`・`preflight/<run>/`・`retrospective.json`)→ F10〜F17・F24、`requests/.locks/`・`.archive/` → F06・F16、`task-reviews/`・`milestone-reviews/` → F19、`release-notes/` → F22・F23、`metrics/manual.json` → F25、`quality-improvements.json` → F20、個人設定 `~/.config/infodb-p3/config.yaml`・`chatgpt.json` → F05・F26 |
|
package/docs/how-to-use.md
CHANGED
|
@@ -235,10 +235,10 @@ p3 request set k7m3x status=done # 要望を完了済にする(
|
|
|
235
235
|
|
|
236
236
|
| 登録が1つだけで決まったとき | コマンド |
|
|
237
237
|
| --- | --- |
|
|
238
|
-
| 警告して続ける | `whoami`・`progress`・`ls`・`show`・`find`・`notes`・`drafts`、`request ls / show`、`milestone`(一覧)、`config`(表示)、`repo`(一覧)、`attach`(一覧)、`release-notes ls / show / export` |
|
|
239
|
-
| 止まる | 上のほか全部。要望・タスク・マイルストーン・設定・参照先の変更、`preflight`(`--note-only` も)、`accept`、`attach add / get / rm`(`get` はファイルを書く)、`release-notes generate / save`(`generate` は保存しなくても生成を始める)、`serve`(画面から変えられる) |
|
|
238
|
+
| 警告して続ける | `whoami`・`progress`・`ls`・`show`・`find`・`resolve`・`notes`・`drafts`・`clarify`・`revisit`、`request ls / show`、`milestone`(一覧)、`config`(表示)、`repo`(一覧)、`attach`(一覧)、`quality`(表示・`templates`・`template`)、`release-notes ls / show / export`、`metrics`(集計)・`metrics records`、`retro`(表示)、`premise`(一覧)、`source`(根拠の一覧: 要望・タスク・案とその基準。`ls` / `show` / 操作なし) |
|
|
239
|
+
| 止まる | 上のほか全部。要望・タスク・マイルストーン・設定・参照先の変更、`preflight`(`--note-only` も)、`accept`、`answer`、`attach add / get / rm`(`get` はファイルを書く)、`release-notes generate / save`(`generate` は保存しなくても生成を始める)、`metrics record / rm`、`retro confirm / judge`、`premise add / ack`、`source` の操作(`add`・`edit`・`confirm`・`rm` と、操作の語が無くても `--sources-json` でまとめて当てるとき。ファイル・標準入力を読む前に止まる)、`serve`(画面から変えられる) |
|
|
240
240
|
|
|
241
|
-
`init`・`project`・`user-config`・`chatgpt`・`codex`・`render` はプロジェクトを選ばないので対象外。
|
|
241
|
+
`init`・`project`・`user-config`・`chatgpt`・`codex`・`render`・`guide` はプロジェクトを選ばないので対象外。
|
|
242
242
|
|
|
243
243
|
決まったプロジェクトの **データのフォルダと `project.yaml` が無い** と、CLI のどのコマンドも `serve` も、空のプロジェクトとして
|
|
244
244
|
開かずに終了コード 1 で止まる(何も作らない。`--json` でも空の結果は返さず、案内は標準エラーに出る)。フォルダの移動・共有ドライブの
|
|
@@ -719,7 +719,9 @@ p3 show T003 --json # item.completionRecords に全部
|
|
|
719
719
|
- 記録は P3 が作る。CLI・API から記録の値を渡しても受け付けない
|
|
720
720
|
- この機能より前に完了したもの・ファイルの直接編集で完了にしたものは「記録なし」のまま(後から補わない)。記録を直接編集で
|
|
721
721
|
読めない値にすると「読めない」と出て、直すまで新しい記録を足さない(完了・済みは拒まず、足せなかったことを知らせる。
|
|
722
|
-
|
|
722
|
+
ほかの更新では元の値が残る)。手戻りの履歴(`reworkHistory`)も同じ。知らせは標準エラーに出し、`move`・`set` の `--json` では
|
|
723
|
+
結果のトップレベルの `completionSkipped`(完了の記録)・`reworkSkipped`(手戻りの履歴)にも入れる(API のタスクの PATCH と同じ項目名と文。
|
|
724
|
+
残せたときは項目ごと無い)
|
|
723
725
|
- 規則の詳細: [architecture.md の完了の記録](architecture.md#完了の記録)
|
|
724
726
|
|
|
725
727
|
### 振り返り(Preflight のリスクは起きたか)
|
|
@@ -808,7 +810,7 @@ p3 metrics rm M3 --rev 1 # 消す
|
|
|
808
810
|
- 値 0 の記録は 0、記録の無い指標は「記録なし」。記録は `<データのフォルダ>/metrics/manual.json` に残り、プロジェクトのデータと一緒に共有される
|
|
809
811
|
- 値を記録したマイルストーンは消せない(先に `p3 metrics rm`)。`project.yaml` の直接編集で消えたら、指標に注意が出る
|
|
810
812
|
|
|
811
|
-
- 指標を足すときは `src/
|
|
813
|
+
- 指標を足すときは `packages/tasks/src/features/metrics/core/definitions.ts` の `METRIC_DEFINITIONS` に1件(ID・名前・単位・何から・対象・算出・欠損の扱いと集計)を足す。
|
|
812
814
|
CLI・API・画面はその並びをそのまま出す
|
|
813
815
|
|
|
814
816
|
### 見直しが必要(候補)
|
|
@@ -838,6 +840,9 @@ p3 premise k7m3x ack P1 --target T003 --condition "2026 版で確かめた" #
|
|
|
838
840
|
- 比べる基点は最新の完了の記録。確かめた結果を残すには、もう一度 **済み** にする(済みを外して付け直す)と新しい記録が基点になる。
|
|
839
841
|
前提の変更だけを確かめたなら `premise ack` で残す。単に候補を消す操作は無く、差が解消されれば(品質基準を戻したなど)候補も消える
|
|
840
842
|
- 要望の候補は要望自身(対応済・完了済のとき)の差。配下のタスク・子の要望の候補は件数として親に出すが、完了していない親自身を候補とはしない
|
|
843
|
+
- 品質基準を後から初めて設定した(未設定のうちに完了した)とき、要望自身は候補にしない(要望は品質の状態だけを比べ、見るのは設定済から
|
|
844
|
+
未設定・読めないへの変化)。完了したタスクは、作業先に当てはまる基準(作業先の無いタスクは全体に当てはまる基準)が新たに当てはまる
|
|
845
|
+
として候補になり、その件数で要望が進捗の「見直し候補のみ」・`p3 revisit` に出る。候補のタスクの無い要望は出ない
|
|
841
846
|
- 証拠の「再確認が必要」(基準の文を変えた後の証拠)・基準や証拠の編集で済みが外れることとは別のもの。品質基準の差分の取り込み
|
|
842
847
|
(`p3 criteria T003 quality`)は今までどおり明示した操作で、取り込むと基準が変わって済みが外れる
|
|
843
848
|
- 前提の変更の記録は P3 が URL を取りに行ったり、外部の規則を監視したりはしない。人が気づいた変更を記録する
|
package/docs/installation.md
CHANGED
|
@@ -267,6 +267,7 @@ p3 user-config paths . ~/p3-data/myapp # リポジトリとデータの
|
|
|
267
267
|
| --- | --- |
|
|
268
268
|
| ホストのフォルダではないマウント(volume・tmpfs)の下・コンテナの中だけにある | フォルダを、ホストのフォルダをマウント(bind)した場所の下へ移す |
|
|
269
269
|
| 自分のコンテナを確かめられない(リモートの Docker・別のデーモン・ID が分からない) | 下の「自動で決まらないとき」で手で書く |
|
|
270
|
+
| 見つけたコンテナのマウントの元が、このマシンのマウントと合わない(ネットワークを共有するコンテナ・シンボリックリンクを通した bind) | 下の「ネットワークを共有するコンテナで動かすとき」の手順で手で書く |
|
|
270
271
|
| 手で書いた対応と、コンテナのマウントから決めたものが違う | 手で書いた対応を直すか外す(`p3 user-config set codex.pathMap-=<このマシンのパス>`。外せば自動で決まる) |
|
|
271
272
|
|
|
272
273
|
##### 自動で決まらないとき(手で書く)
|
|
@@ -284,6 +285,28 @@ p3 user-config set codex.pathMap-=/workspaces # 1件外す
|
|
|
284
285
|
- 書き間違い(`=` が無い、相対パスなど)は、何を直すかを出して何も書かない
|
|
285
286
|
- 直したら、serve を起動し直さなくても **次の Preflight から** 効く。`p3 user-config paths` で結果を確かめる
|
|
286
287
|
|
|
288
|
+
##### ネットワークを共有するコンテナで動かすとき
|
|
289
|
+
|
|
290
|
+
Compose の `network_mode: service:<別のサービス>`(`docker run --network container:<別のコンテナ>`)で、ネットワークを別のコンテナ
|
|
291
|
+
(共有元)と共有するコンテナの中で p3 を動かすと、パスは **自動では決まらない**。コンテナの中から見える自分のコンテナの手がかり
|
|
292
|
+
(`/etc/hostname` などの元・ホスト名)が共有元のものになり、自分のコンテナを確かめられないため。共有元を自分と取り違えると
|
|
293
|
+
共有元のフォルダをマウントしてしまうので、p3 は見つけたコンテナのマウントの元がこのマシンのマウントと合わなければ止まる
|
|
294
|
+
(「マウントの元が、このマシンのマウントと合いません」)。ホストでシンボリックリンクを通して bind したフォルダも、Docker が答える
|
|
295
|
+
元(リンク)とこのマシンから見える元(実体)が違うので同じく止まる。どちらも次の手順で手で書けば進む:
|
|
296
|
+
|
|
297
|
+
1. **ホストで** `docker inspect <p3 を動かしているコンテナ>` の `Mounts` を見る(共有元ではなく、p3 を動かしている側。Compose なら
|
|
298
|
+
`docker compose ps -q <p3 を動かしているサービス>` で ID が分かる)。リポジトリとデータのフォルダを含む `Type: bind` ごとに、
|
|
299
|
+
`Destination`(このマシンのパス)と `Source`(ホストのパス)を控える
|
|
300
|
+
2. 控えたものを1件ずつ書く: `p3 user-config set codex.pathMap+=<Destination>=<Source>`
|
|
301
|
+
3. `p3 user-config paths <リポジトリ> <データのフォルダ>` で、全部の対象が「codex.pathMap の対応あり」で、行き先が手順 1 の
|
|
302
|
+
`Source` の下になり「全部決まりました」と出るのを確かめる(決まらない対象が残れば、その対象を含む bind を足す)
|
|
303
|
+
|
|
304
|
+
- 共有元のマウントや `Source` を書き換えて合わせない(共有元のフォルダを使うことになる)。対応を書かない対象をそのまま渡すことも
|
|
305
|
+
しない(このマシンのパスはホストのパスとは限らない)
|
|
306
|
+
- 以前の版の p3 は、共有元にも同じ `Destination` があると、共有元の `Source` を自動で選んでいた。正しい対応を書くと
|
|
307
|
+
「手で書いた対応と、コンテナのマウントから決めたものが違う」(conflict)で止まった。この表示が出ても対応を外さない(外すと共有元のフォルダを
|
|
308
|
+
使う)。p3 を上げるか、ネットワークを共有しないコンテナ・ホストから動かす
|
|
309
|
+
|
|
287
310
|
#### 4. ChatGPT に接続する
|
|
288
311
|
|
|
289
312
|
Preflight の Codex は、各自の ChatGPT アカウント(プラン)で動く。サインインは P3 が行う(Codex の初期設定は要らない)。
|
|
@@ -402,12 +425,12 @@ P3 をイメージにして、コンテナで動かすこともできる。イ
|
|
|
402
425
|
要望・タスクの作成と編集・添付・Preflight もいつもどおり使える。
|
|
403
426
|
|
|
404
427
|
イメージは Docker Hub の **`tamuto/p3`**。中に p3 本体(npm の `@infodb/p3` と同じ版・同じ中身)と、Node 26・git・Docker の CLI が
|
|
405
|
-
入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.
|
|
428
|
+
入っている(Codex は入れない。Preflight のたびにホストの Docker で Codex のイメージを使う)。版のタグ(`tamuto/p3:0.14.0` など)と
|
|
406
429
|
`latest` がある。決まった版で使うなら版のタグを指す。対応する platform は `linux/amd64` だけ(arm64 は確かめるマシンが無いので
|
|
407
430
|
作っていない)。
|
|
408
431
|
|
|
409
432
|
```bash
|
|
410
|
-
docker pull tamuto/p3:0.
|
|
433
|
+
docker pull tamuto/p3:0.14.0
|
|
411
434
|
```
|
|
412
435
|
|
|
413
436
|
リポジトリから作るときは `docker build --pull -t tamuto/p3:dev .`(`--pull` で今の Node のベースを取る。[開発ガイド](development.md#docker-のイメージ))。
|
|
@@ -428,16 +451,16 @@ root で動く開発コンテナ(DevContainer など)で p3 の CLI を使
|
|
|
428
451
|
# 開発コンテナの compose に足す例(パスは開発コンテナのマウントに合わせる)
|
|
429
452
|
services:
|
|
430
453
|
p3:
|
|
431
|
-
image: tamuto/p3:0.
|
|
454
|
+
image: tamuto/p3:0.14.0
|
|
432
455
|
restart: unless-stopped
|
|
433
456
|
ports:
|
|
434
457
|
- "127.0.0.1:4310:4310"
|
|
435
458
|
environment:
|
|
436
459
|
- TZ=Asia/Tokyo
|
|
437
460
|
volumes:
|
|
438
|
-
- /
|
|
439
|
-
-
|
|
440
|
-
- /
|
|
461
|
+
- /home/me/workspaces:/workspaces # 開発コンテナと同じ(リポジトリ・データ)
|
|
462
|
+
- ./.devcontainer/.config:/root/.config # 開発コンテナと同じ ~/.config(個人設定・ChatGPT の接続)
|
|
463
|
+
- /home/me/p3-data:/p3-data # データを別の場所に置いているなら、それも同じに
|
|
441
464
|
- /var/run/docker.sock:/var/run/docker.sock # Preflight(Codex)と画面イメージの描画
|
|
442
465
|
```
|
|
443
466
|
|
|
@@ -452,7 +475,7 @@ docker run -d --name p3 --restart unless-stopped \
|
|
|
452
475
|
-v ~/.config/infodb-p3:/root/.config/infodb-p3 \
|
|
453
476
|
-v /home/me/work:/home/me/work \
|
|
454
477
|
-v /var/run/docker.sock:/var/run/docker.sock \
|
|
455
|
-
tamuto/p3:0.
|
|
478
|
+
tamuto/p3:0.14.0
|
|
456
479
|
|
|
457
480
|
# 登録が無ければ、コンテナの中で登録する(既にあるデータに参加する。新しく作るなら p3 init)
|
|
458
481
|
docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
|
|
@@ -465,7 +488,7 @@ docker exec -w /home/me/work/myapp p3 p3 join --project myapp --yes
|
|
|
465
488
|
### どちらでも
|
|
466
489
|
|
|
467
490
|
- 待ち受けは `127.0.0.1` に公開する。ブラウザで http://localhost:4310 を開く。登録が1つならそのプロジェクトが開き、複数なら一覧から選ぶ
|
|
468
|
-
- **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.
|
|
491
|
+
- **通常の serve に戻す**: コマンドを明示する(例: `docker run ... tamuto/p3:0.14.0 serve --project myapp --host 0.0.0.0`。compose なら
|
|
469
492
|
`command:`)。明示しない限り、コンテナの中かどうかで自動では切り替えない
|
|
470
493
|
- **止める**: `docker stop p3`(SIGTERM。実行中の Preflight・生成を取り消して記録してから止まる。10 秒まで待つ)
|
|
471
494
|
- **新しい版にする**: 版のタグを変えて作り直す(個人設定と接続はマウントした ~/.config、データはホストに残る)。
|