@infodb/p3 0.12.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 +33 -35
- package/bin/p3.mjs +3 -2
- package/dist/web/assets/CompletionReview-BD7d6Yzt.js +1 -0
- package/dist/web/assets/ImprovementDialog-BoAZN1KR.js +1 -0
- package/dist/web/assets/Outputs-D-ZouoxF.js +1 -0
- package/dist/web/assets/RequestStatus-Bl3fdSbM.js +1 -0
- package/dist/web/assets/Tabs-CxeceOL-.js +1 -0
- package/dist/web/assets/TagInput-CeAbmGRR.js +1 -0
- 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-BWYpm3PD.js +2 -0
- 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/outputs-CXqnjSqV.js +1 -0
- package/dist/web/assets/preflightInput-ClKwkp8R.js +2 -0
- package/dist/web/assets/preload-helper-_dAYMct_.js +1 -0
- package/dist/web/assets/{quality-Pu6EISAM.js → quality-RFd-7k3r.js} +1 -1
- package/dist/web/assets/release-notes-Dtif8xsQ.js +5 -0
- package/dist/web/assets/requestData-SPc36t8Q.js +1 -0
- 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-DavxMs-c.js +30 -0
- package/dist/web/index.html +6 -4
- package/docs/architecture.md +430 -72
- package/docs/chatgpt-sign-in.md +2 -2
- package/docs/development.md +141 -64
- package/docs/feature-inventory.md +139 -0
- package/docs/how-to-use.md +389 -31
- package/docs/installation.md +261 -147
- package/docs/publishing.md +33 -14
- package/docs/refactoring.md +332 -0
- package/lib/cli/agentsStatus.js +198 -0
- package/lib/cli/guide.js +27 -0
- package/lib/cli/guide.md +217 -0
- package/lib/cli/help.js +45 -7
- package/lib/cli/main.js +58 -207
- package/lib/cli/project.js +34 -294
- 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 +73 -9
- 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 +12 -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 +24 -7
- package/lib/tasks/cli/showView.js +279 -0
- package/lib/{cli → tasks/cli}/taskCommands.js +55 -21
- 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 +17 -2
- package/lib/{core → tasks/core}/preflight/carryover.js +5 -1
- package/lib/{core → tasks/core}/preflight/codexEngine.js +36 -28
- package/lib/{core → tasks/core}/preflight/diagnose.js +4 -9
- package/lib/{core → tasks/core}/preflight/engine.js +9 -0
- package/lib/tasks/core/preflight/hostPaths.js +299 -0
- package/lib/{core → tasks/core}/preflight/input.js +33 -5
- package/lib/{core → tasks/core}/preflight/instructions.js +19 -2
- package/lib/{core → tasks/core}/preflight/mockEngine.js +27 -8
- package/lib/{core → tasks/core}/preflight/render.js +22 -3
- package/lib/{core → tasks/core}/preflight/service.js +86 -11
- package/lib/{core → tasks/core}/preflight/uiRender.js +5 -2
- package/lib/{core → tasks/core}/requestOps.js +214 -17
- 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 +21 -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 +15 -10
- package/lib/{core → tasks/core}/store/noteStore.js +2 -2
- package/lib/{core → tasks/core}/store/preflightStore.js +59 -22
- package/lib/{core → tasks/core}/store/projectFile.js +1 -1
- package/lib/{core → tasks/core}/store/workspace.js +28 -6
- package/lib/{core → tasks/core}/userConfig.js +1 -1
- package/lib/{core → tasks/core}/workTargets.js +1 -1
- package/lib/tasks/features/metrics/cli/metricsCommands.js +77 -0
- package/lib/tasks/features/metrics/core/definitions.js +445 -0
- package/lib/tasks/features/metrics/core/index.js +112 -0
- package/lib/tasks/features/metrics/core/manual.js +179 -0
- package/lib/tasks/features/metrics/server/metricsRoutes.js +8 -0
- package/lib/tasks/features/metrics/shared/metrics.js +42 -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 +36 -11
- package/lib/{core → tasks/features/quality/core}/qualityImprovement.js +16 -15
- package/lib/tasks/features/records/cli/revisitCommands.js +73 -0
- package/lib/tasks/features/records/core/completionRefs.js +46 -0
- package/lib/tasks/features/records/core/reviewCandidates.js +76 -0
- package/lib/tasks/features/records/shared/completionRecord.js +329 -0
- package/lib/tasks/features/records/shared/reviewCandidate.js +313 -0
- package/lib/tasks/features/records/shared/reworkHistory.js +86 -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/tasks/features/requirements/cli/requirementCommands.js +289 -0
- package/lib/{shared → tasks/features/requirements/shared}/acceptance.js +292 -18
- package/lib/tasks/features/requirements/shared/requirementSource.js +635 -0
- package/lib/tasks/features/retro/cli/retroCommands.js +106 -0
- package/lib/tasks/features/retro/core/retrospective.js +197 -0
- package/lib/tasks/features/retro/shared/retrospective.js +286 -0
- package/lib/tasks/features/settings/cli/projectSettings.js +245 -0
- package/lib/{cli → tasks/features/settings/cli}/userConfig.js +50 -3
- 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 +13 -7
- package/lib/{core/taskReview → tasks/features/taskReview/core}/review.js +10 -3
- 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/manifest.js +51 -3
- package/lib/{server → tasks/server}/api/routes.js +134 -65
- package/lib/tasks/shared/commitRefs.js +10 -0
- package/lib/{shared → tasks/shared}/preflightInput.js +1 -1
- package/package.json +1 -43
- package/skills/p3/SKILL.md +9 -181
- package/dist/web/assets/ImprovementDialog-kQaVBGWH.js +0 -1
- package/dist/web/assets/Outputs-_nU_p3nu.js +0 -1
- package/dist/web/assets/RequestStatus-RG-OVQYY.js +0 -1
- package/dist/web/assets/Tabs-ew9i5SKX.js +0 -1
- package/dist/web/assets/TagInput-BtlJTF7i.js +0 -1
- package/dist/web/assets/TaskDrawer-DW8GyJqI.js +0 -6
- package/dist/web/assets/_requestId-6Nb727dD.js +0 -1
- package/dist/web/assets/_requestId-BykTgPax.js +0 -1
- package/dist/web/assets/appCtx-CxDdXABS.js +0 -1
- package/dist/web/assets/archive-Ckh295Xe.js +0 -1
- package/dist/web/assets/board-BVAIjK-Y.js +0 -1
- package/dist/web/assets/done-BGfA-3MA.js +0 -1
- package/dist/web/assets/draft-CfJeyLOl.js +0 -1
- package/dist/web/assets/index-CgRU744I.css +0 -2
- package/dist/web/assets/index-DacQ0yl4.js +0 -12
- package/dist/web/assets/new-DVygWvVc.js +0 -1
- package/dist/web/assets/outputs-B6xDsLZf.js +0 -1
- package/dist/web/assets/preflightInput-BAeEJYUK.js +0 -2
- package/dist/web/assets/preload-helper-DyCqp21K.js +0 -1
- package/dist/web/assets/release-notes-CCpzyiNf.js +0 -5
- package/dist/web/assets/requestData-D5vBnuMh.js +0 -1
- package/dist/web/assets/routes-Q91zvNc0.js +0 -4
- package/dist/web/assets/settings-BzRgcmUm.js +0 -1
- package/dist/web/assets/workTarget-C9c57JAO.js +0 -30
- package/lib/cli/readOnly.js +0 -38
- package/lib/cli/showView.js +0 -166
- /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/codexImage.js +0 -0
- /package/lib/{core → tasks/core}/preflight/docker.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/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/{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/releaseNotes → tasks/features/releaseNotes/core}/mockSummarizer.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/{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}/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
|
|
|
@@ -31,7 +34,7 @@ pnpm typecheck
|
|
|
31
34
|
pnpm lint # oxlint(型情報も使う。下の「lint」)
|
|
32
35
|
pnpm test # ユニットテスト(vitest)。pnpm test:watch で監視
|
|
33
36
|
pnpm test:ui # ブラウザで画面を操作する UI テスト(ビルドした画面が要る。下の「UI テスト」)
|
|
34
|
-
pnpm check # 型検査 + lint + テスト + ビルド + UI テスト
|
|
37
|
+
pnpm check # ブラウザの確認 + 型検査 + lint + テスト + ビルド + UI テスト
|
|
35
38
|
pnpm demo:reset # デモデータ(.p3-demo/)を作り直す
|
|
36
39
|
pnpm verify:pack # 配布物を別の場所に入れて動かす(--docker で codex update と render も)
|
|
37
40
|
pnpm video # 使い方の動画を録り直す(.p3-video/p3-demo.mp4。下の「使い方の動画」)
|
|
@@ -58,22 +61,39 @@ pnpm video # 使い方の動画を録り直す(.p3-video/p3-
|
|
|
58
61
|
XDG_CONFIG_HOME=$TMP/cfg node <このチェックアウト>/bin/p3.mjs init --yes --agents --project sample --dir $TMP/data
|
|
59
62
|
# ルート・サブフォルダ・other/ のそれぞれで、スキルの一覧と場所を聞く(p3 は .agents/skills/p3/SKILL.md、other/ では出ない)
|
|
60
63
|
codex exec --ephemeral --ignore-user-config -s read-only "List every skill available to you with its SKILL.md path. Also quote what each skill root alias (r0, r1) maps to."
|
|
61
|
-
# $p3
|
|
62
|
-
codex exec --ephemeral --ignore-user-config -s read-only '$p3 Do not run
|
|
64
|
+
# $p3 を明示して、入口が最初に実行させるもの(pnpx @infodb/p3 guide --json)と、取れないときに止まることを引用させる
|
|
65
|
+
codex exec --ephemeral --ignore-user-config -s read-only '$p3 Do not run anything. Quote what the skill says to run first and what to do if that fails.'
|
|
63
66
|
```
|
|
64
67
|
|
|
68
|
+
スキルの frontmatter の `metadata`(入口の版 `p3-entry-version`)があっても一覧に出ることも、ここで確かめる。
|
|
65
69
|
個人のスキル(`~/.agents/skills`・`/etc/codex/skills`)と `~/.codex/config.toml` の `[[skills.config]]` に p3 が無いことを先に確かめる。
|
|
66
70
|
Codex がスキルを探す場所は公式の文書(<https://developers.openai.com/codex/skills/> の「Where Codex loads local skills」)
|
|
71
|
+
- 入口から手順を読む流れ(入口 → `pnpx @infodb/p3 guide --json` → `whoami --json`)を本物のエージェントが辿るかは、テストでは確かめ
|
|
72
|
+
られない。入口(`skills/p3/SKILL.md`・`agentsSnippet`)か `ENTRY_VERSION` を変えたときは、一時フォルダのプロジェクトに入口を置いて
|
|
73
|
+
Claude Code・Codex に p3 の作業(「進捗を見せて」など)を頼み、guide を読んでから whoami に進むこと、古い入口(前の全文のスキル)に
|
|
74
|
+
したときは `agents` の状態を人に伝えて自分で `p3 agents` を実行しないことを確かめる。入口は公開版(`pnpx @infodb/p3`)を呼ぶので、
|
|
75
|
+
`guide` を含む版を公開する前は guide が取れない(前の版にはコマンドが無い)。その間は「取れなければ p3 を操作せず、エラーと呼び方を
|
|
76
|
+
伝えて終える」ことだけを確かめ、取れたときの流れは公開した後に確かめる(版と結果はタスクの変更の記録に残す。確かめられなければ未検証と書く)
|
|
67
77
|
- 手元の対話エージェントの Preflight(`--prepare` / `--complete`)は、CLI と取り込みを別プロセスのテストで確かめる
|
|
68
|
-
(`test/localPreflight.test.ts`。PATH を空にして Codex・Docker・claude を呼べない状態で通す)。Claude Code
|
|
69
|
-
担当(`preflight.runner
|
|
70
|
-
契約は `test/agents.test.ts`、agent の親子の prepare → complete → drafts は `test/localPreflight.test.ts`
|
|
78
|
+
(`test/localPreflight.test.ts`。PATH を空にして Codex・Docker・claude を呼べない状態で通す)。Claude Code が入口のスキルから手順(`p3 guide`)を読んで
|
|
79
|
+
担当(`preflight.runner`)どおりに依頼を解釈するか、指示のファイルを読み切るかはテストでは確かめられない。担当で分けた手順の書き方の
|
|
80
|
+
契約は `test/agents.test.ts`、agent の親子の prepare → complete → drafts は `test/localPreflight.test.ts` が確かめる。手順(`packages/p3/src/cli/guide.md`)の Preflight の
|
|
71
81
|
節や指示の形を変えたときは、一時フォルダのプロジェクト(`init --agents claude --preflight-runner agent`)を Claude Code で開き、
|
|
72
82
|
親と子の要望を作って「要望 <ID> の Preflight をして」と頼み、prepare → 成果物 → complete → drafts まで進んで accept しないこと、
|
|
73
83
|
依頼の無い登録では始めないことを確かめる。`p3 config set preflight.runner=codex` に変えて、「Preflight して」とだけ頼むと聞き返すこと、
|
|
74
84
|
「このチャットで実行して」と明示すると手元で評価することも確かめる(版と結果はタスクの変更の記録に残す。確かめられなければ未検証と書く)。Claude Code がスキルを読む場所は公式の文書(<https://code.claude.com/docs/en/skills>)
|
|
75
|
-
- CLI のテストは別プロセスで `bin/p3.mjs` を動かし、個人設定を一時フォルダに分け、このマシンの `P3_*`
|
|
76
|
-
|
|
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` が確かめる。監視の失敗(入れ子の消失・
|
|
77
97
|
読めないエラー・開始の失敗・読み込みの失敗)は監視を差し替えて確実に起こし、ログ・立て直し・続けての失敗でやめること・close の後に
|
|
78
98
|
何も残らないことを見る。実際の監視は、通常の serve を別のプロセスで動かし(`test/fixtures/watchChild.ts`)、`drafts/` を作っては
|
|
79
99
|
消し続けても落ちず、API が答え、close の後に自分で終わることを見る。`--all-projects` で一方の監視が壊れても両方の API と
|
|
@@ -94,12 +114,15 @@ pnpm video # 使い方の動画を録り直す(.p3-video/p3-
|
|
|
94
114
|
`test/ui/*.ui.test.ts` は、ブラウザ(Playwright の Chromium headless shell)で `p3 serve` のビルドした画面を開いて操作する。
|
|
95
115
|
設定は `vitest.ui.config.ts` で、通常の `pnpm test` には入らない。型検査・lint の対象には入る。
|
|
96
116
|
|
|
97
|
-
- `pnpm check`
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
117
|
+
- `pnpm check` は、最初(型検査の前)に `pnpm check:browser`(`scripts/check-browser.ts`)で Chromium を起動してみる。実行ファイルが
|
|
118
|
+
無い・起動できないなら、理由と入れ方を出してそこで止める(コンテナを作り直して消えたことに、単体テストとビルドを待たずに気づくため。
|
|
119
|
+
`pnpm check` では UI テストを飛ばさない)。続けて型検査・lint・テスト・ビルドの後に `pnpm test:ui` を流す。単独で流すときは先に
|
|
120
|
+
`pnpm build` する(ビルドが無ければ、Chromium の有無によらず失敗にする)
|
|
121
|
+
- Chromium は `pnpm exec playwright-core install chromium-headless-shell` で入れる(自動では入れない)。`pnpm test:ui` を単独で流した
|
|
122
|
+
ときは、Playwright が起動する実行ファイル(既定のキャッシュか `PLAYWRIGHT_BROWSERS_PATH`)が無いときだけ、理由と入れ方を出して
|
|
123
|
+
UI テストを飛ばす(件数は vitest の skipped に出る)。実行ファイルがあるのに起動できない(共有ライブラリが無いなど)・サーバが起きない・操作の対象が
|
|
124
|
+
見つからないときは失敗にする(判定は `test/ui/chromium.ts`、本物の Chromium を使わない確認は `test/uiHarness.test.ts`)。
|
|
125
|
+
共有ライブラリが無いと出たら `pnpm exec playwright-core install-deps chromium-headless-shell` で入れる
|
|
103
126
|
- シナリオごとに一時のフォルダを作り、その中に HOME・個人設定(`XDG_CONFIG_HOME`)・git リポジトリ・データを置いて、本物の CLI
|
|
104
127
|
(`bin/p3.mjs init`・`serve`)で動かす(`test/ui/env.ts`)。子の p3 には親の `P3_*`・`INIT_CWD`・`GIT_*`・`XDG_*` を渡さず、
|
|
105
128
|
Mock のエンジン・変更者・cwd を明示する。手元の個人設定・プロジェクト・`.p3-demo/` には触れない。`p3 serve` は 127.0.0.1 の
|
|
@@ -119,6 +142,10 @@ pnpm video # 使い方の動画を録り直す(.p3-video/p3-
|
|
|
119
142
|
末尾に届くことを測る。進捗・新しい要望・設定の3つのタブ・リリースノート・タスクボード・対応済みは、文書と上のナビゲーションとタブ(設定・リリースノートの tablist)が縦に
|
|
120
143
|
送れないことだけを測る。測るのは名指しした要素(文書・`main`・本文・タブ・上のナビゲーション・実行ログ)の送れる量で、すべての要素を数えはしない。ほかの局所スクロールの
|
|
121
144
|
中身や、通知(再読み込みの失敗・外での削除)が出ているときの高さは測らない
|
|
145
|
+
- 文字の大きさと拡大(`test/ui/readability.ui.test.ts`): 下の「画面の文字と余白」の確認する画面を、幅 1280(明るい)と 375(暗い)で開き、
|
|
146
|
+
見えている文字の計算済みの大きさ(本文・見出し・操作は 16px 以上、補助の情報は 14px 以上。`test/ui/layout.ts` の `fontProblems`)と
|
|
147
|
+
横のはみ出しを測る。200% の拡大は CSS の幅 640×450 で同じ画面を開いてはみ出しを測り、新しい要望(タイトル → 作成)・設定(プロジェクト名 →
|
|
148
|
+
保存 → 元に戻す)・タスクの詳細(入力 → 保存)にキーボード(Tab)で届き、届いた操作が画面内に見えることを確かめる
|
|
122
149
|
- 限界: 画像の比較はしないので、色・重なり方・文字の欠けなど、測っていない見た目の乱れは保証しない。測るのは上の画面・幅・テーマだけ
|
|
123
150
|
- 日本語のフォント: Noto Sans CJK JP があれば、ブラウザを使い方の動画と同じ fontconfig(`scripts/fonts-ja.conf`)で起こし、寸法を
|
|
124
151
|
日本語のフォントで測る(無い環境では既定のフォントのまま測り、そのことを出す。飛ばしはしない)
|
|
@@ -133,9 +160,9 @@ pnpm video # 使い方の動画を録り直す(.p3-video/p3-
|
|
|
133
160
|
TypeScript 7 の型検査器で tsconfig.json を読む)も動かす。設定は `.oxlintrc.json`。ESLint・Biome・整形の道具は入れていない
|
|
134
161
|
(書式はそろえて書く)。指摘は全部エラーで、警告も使われていない無効化コメントも `pnpm check` を落とす。
|
|
135
162
|
|
|
136
|
-
- **対象**: package.json の `lint`
|
|
137
|
-
|
|
138
|
-
- **除外**: 生成したルート一覧 `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/` は対象のフォルダの外
|
|
139
166
|
- **規則**: plugin は typescript・unicorn・oxc・react・import・promise・vitest。それぞれの correctness(誤りか無意味なコード)を全部
|
|
140
167
|
使い、ほかのカテゴリは一括では入れず、次を選んで足す
|
|
141
168
|
|
|
@@ -169,7 +196,7 @@ suspicious カテゴリの一括(JSX で要らない `react-in-jsx-scope` な
|
|
|
169
196
|
|
|
170
197
|
- 中で try / catch して画面に知らせる関数(保存・Preflight の開始など)は `onClick={() => void save()}`。`void` は
|
|
171
198
|
「待たない」の印で、失敗を隠すためには使わない
|
|
172
|
-
- 失敗を受け止めない処理は `runAction(処理, (文言) => …)`(`src/web/lib/action.ts`)で、失敗を画面に渡す
|
|
199
|
+
- 失敗を受け止めない処理は `runAction(処理, (文言) => …)`(`packages/tasks/src/web/lib/action.ts`)で、失敗を画面に渡す
|
|
173
200
|
- 読み直し(`reload`)のように失敗を状態に入れて投げない関数は、子には `() => void reload()` を渡す
|
|
174
201
|
|
|
175
202
|
`test/lint.test.ts` が、採用した規則の代表的な違反(Hooks・待たない Promise・Promise の渡し方)で lint が失敗することと、
|
|
@@ -177,67 +204,105 @@ suspicious カテゴリの一括(JSX で要らない `react-in-jsx-scope` な
|
|
|
177
204
|
|
|
178
205
|
## 構成
|
|
179
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
|
+
|
|
180
212
|
```
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
main.ts
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
routes
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
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
|
|
236
|
+
skills/p3/SKILL.md AI 向けの入口のスキルの原本(p3 init --agents / p3 agents で .claude/skills・.agents/skills の選んだ先に写す。本文は p3 guide から読ませる)
|
|
237
|
+
scripts/ 配布物のビルド(build-cli.mjs)・デモデータ・配布物の確認・使い方の動画(video/)
|
|
238
|
+
docs/ 導入・使い方・開発・設計・公開の文書(利用者向けの入口。配布物にも入れる)
|
|
239
|
+
test/ ユニットテスト(パッケージをまたいで確かめるのでルートに置く)
|
|
206
240
|
```
|
|
207
241
|
|
|
208
|
-
|
|
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`)。
|
|
209
251
|
小さいページは中身もそのファイルに書く。大きいページは、ルートのファイルを組み立て(状態と並び)だけにし、部品を
|
|
210
|
-
`src/web/components/<ページ>/` に分ける(要望の画面は `components/request/`)。ルート一覧 `src/web/routeTree.gen.ts` は
|
|
211
|
-
`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`)。
|
|
212
255
|
|
|
213
256
|
規則を足すときに直す場所は [docs/architecture.md](architecture.md) の「規則の置き場所」。
|
|
214
257
|
|
|
258
|
+
## 画面の文字と余白
|
|
259
|
+
|
|
260
|
+
文字を小さくして詰め込まない。狭い幅でも文字は縮めず、折り返す・行を高くする・局所スクロールにする。
|
|
261
|
+
|
|
262
|
+
| 用途 | 大きさ | 例 |
|
|
263
|
+
| --- | --- | --- |
|
|
264
|
+
| 本文・フォームの見出し・主な操作 | 16px 以上(`text-base`。基底の大きさ) | 説明の文、一覧の題、表のセル、ボタン・リンク・入力、`Field` の見出し |
|
|
265
|
+
| 見出し | 本文より大きく(`Section` は `text-lg`、ページは `text-xl` / `text-2xl`) | 区切りの見出し、詳細・ダイアログの題 |
|
|
266
|
+
| 補助の情報 | 14px 以上(`text-sm`)。要素に `data-aux` を付けるか等幅(`font-mono`) | ID・日時・件数・バッジ(`Badge`・ステータスの札)・パス・入力の下の補足(`Field` の hint) |
|
|
267
|
+
|
|
268
|
+
- 12px 以下(`text-xs`・`text-[10px]` など)は文字に使わない。記号だけの印(✓ など、文字を持たない装飾)は例外
|
|
269
|
+
- 主な説明に淡い色を使わない。明るいテーマの説明・補足は `text-slate-500` 以上の濃さ(`text-slate-400` は暗いテーマ用)。フォームの見出しは
|
|
270
|
+
`text-slate-700`(暗いテーマは `text-slate-300`)
|
|
271
|
+
- 補助の情報を本文の要素(p・li・label・button など)の中で 14px にするときは `data-aux` を付ける(UI テストが本文と区別する)
|
|
272
|
+
- 狭い進捗の要望名も本文として 16px で、2行まで折り返す(行の高さは2行とステータスの段が入るように決める。`routes/index.tsx` の `ROW_H`)
|
|
273
|
+
- 全体の CSS で大きさを強制的に上書きせず、部品ごと・用途ごとに上の大きさを選ぶ
|
|
274
|
+
- 確認する画面: 進捗・新しい要望・要望の概要と Preflight の案・タスクボードとタスクの詳細・設定(プロジェクト・品質基準)・リリースノート
|
|
275
|
+
(マイルストーン・レビュー)。幅 375 / 1280・明暗のテーマ・200% の拡大で、はみ出しと操作への到達を確かめる(上の「UI テスト」)
|
|
276
|
+
|
|
215
277
|
## npm で配る中身
|
|
216
278
|
|
|
217
|
-
`@infodb/p3
|
|
218
|
-
|
|
219
|
-
|
|
279
|
+
`@infodb/p3`(入口のパッケージ)として npm に公開する(公開そのものは人が行う。手順は [docs/publishing.md](publishing.md))。kit・tasks は
|
|
280
|
+
公開せず、ビルドして同梱する。画面と CLI・serve をビルドして同梱し、利用者の環境では TypeScript を変換しない(`tsx` とそれが使う esbuild を
|
|
281
|
+
入れないので、pnpm がビルドのスクリプトの許可を聞かない)。このリポジトリの開発(`pnpm p3`・テスト)は、今までどおりソースを `tsx` でそのまま動かす。
|
|
220
282
|
|
|
221
283
|
| 何を | どうする |
|
|
222
284
|
| --- | --- |
|
|
223
|
-
|
|
|
224
|
-
|
|
|
225
|
-
|
|
|
226
|
-
|
|
|
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 で追跡しない |
|
|
227
290
|
| Node | `>=24`(`@infodb/codex-workspace`・`@infodb/chatgpt-plan` の `>=22` を満たす)。開発と Docker のイメージは Node 26 |
|
|
228
|
-
| 公開前のビルド | `
|
|
229
|
-
| 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 に名乗る版など)はそこを読む |
|
|
230
294
|
|
|
231
295
|
```bash
|
|
232
296
|
pnpm -s check # 型検査・lint・テスト・画面のビルド・UI テスト
|
|
233
|
-
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)
|
|
234
298
|
# DevContainer の中では、描画の出力先を Docker のホストから見えるところにする
|
|
235
299
|
P3_CODEX_PATH_MAP=/workspaces=/home/me/workspaces pnpm verify:pack --docker --render-dir /workspaces/tmp
|
|
236
300
|
```
|
|
237
301
|
|
|
238
302
|
## Docker のイメージ
|
|
239
303
|
|
|
240
|
-
`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 のまま入口の分だけを
|
|
241
306
|
入れる。実行も Node 26・git・Docker の CLI と buildx。既定は `serve --all-projects --host 0.0.0.0`)と `.dockerignore`
|
|
242
307
|
(git・依存・ビルドの出力・データ・個人設定・認証・テストを入れない)。約束は `test/docker.test.ts` が確かめる。
|
|
243
308
|
ベースの Node はメジャー版(ビルドも実行も `node:26-bookworm-slim`。描画のイメージも同じ)だけを指定し、同じメジャーの中の更新(セキュリティ
|
|
@@ -261,6 +326,14 @@ P3_CODEX_PATH_MAP=/workspaces=/home/me/workspaces node scripts/verify-docker.mjs
|
|
|
261
326
|
serve になること。本物の Codex(ソケット・pathMap・ChatGPT の接続)での Preflight・画面資料・要約の生成は、このスクリプトでは
|
|
262
327
|
確かめない(接続できる環境で手で確かめ、結果を PR に残す。Mock の成功で代わりにしない)。
|
|
263
328
|
|
|
329
|
+
マウントするパスの自動の決め方(`packages/tasks/src/core/preflight/hostPaths.ts`)は `node scripts/verify-host-paths.mjs` で本物の Docker で
|
|
330
|
+
確かめる。このマシン(DevContainer など)と、Dockerfile から作ったイメージ(中と外で違うパスの bind 2つ・名前付きボリューム・
|
|
331
|
+
ソケット・コンテナの名前と違うホスト名)の両方で、`codex.pathMap` の無い使い捨ての個人設定の p3 が、`p3 user-config paths` で
|
|
332
|
+
自分のコンテナを確かめてパスを決めること、bind の下の原稿を `p3 render` で PNG にすること、volume の下・コンテナの中だけの原稿・
|
|
333
|
+
繋がらない `DOCKER_HOST` では描画のコンテナを起こさずに止まること(`docker events` で数える)を確かめる。`--work` は Docker の
|
|
334
|
+
ホストから見える(bind の下の)フォルダ(既定はこのリポジトリの親)。本物の Codex の Preflight は ChatGPT のプランを使うので
|
|
335
|
+
このスクリプトでは動かさず、人が `codex.pathMap` を外した状態で `p3 preflight` を実行して確かめる。
|
|
336
|
+
|
|
264
337
|
## 使い方の動画
|
|
265
338
|
|
|
266
339
|
一般公開する使い方の動画(日本語の字幕、約3分)は `pnpm video` で録り直す(`scripts/video/record.mjs`)。機能や画面を
|
|
@@ -286,14 +359,18 @@ serve になること。本物の Codex(ソケット・pathMap・ChatGPT の
|
|
|
286
359
|
|
|
287
360
|
| 文書 | 書くこと |
|
|
288
361
|
| --- | --- |
|
|
289
|
-
| [README](../README.md) |
|
|
290
|
-
| [docs/installation.md](installation.md) |
|
|
362
|
+
| [README](../README.md) | 何をするツールか・必要なもの・最短の手順(参加して画面を開くまで)・次にできること・文書の案内だけ |
|
|
363
|
+
| [docs/installation.md](installation.md) | 導入を段階の順に(段階 0: 参加・作成と画面、段階 1: Preflight の準備(Docker・パスの対応・ChatGPT・Codex のイメージ)、段階 2: 任意の機能への入口)。つまずいたとき・マシンごとの設定・Docker で動かす。段階 0 に段階 1 以降の準備を混ぜない(`test/docs.test.ts`)。段階 2 の機能の操作は使い方ガイドに書き、ここからはリンクする |
|
|
291
364
|
| [docs/how-to-use.md](how-to-use.md) | 使い方の手順とリファレンス(操作・状態・データ・画面・CLI) |
|
|
292
365
|
| [docs/architecture.md](architecture.md) | 設計と規則(なぜそうするか・どこで守っているか) |
|
|
293
366
|
| [docs/chatgpt-sign-in.md](chatgpt-sign-in.md) | ChatGPT のサインインの設計 |
|
|
294
367
|
| [docs/publishing.md](publishing.md) | npm への公開のチェックリスト |
|
|
368
|
+
| [docs/refactoring.md](refactoring.md) | 重複の整理とモジュール構成の組み直し(計測の定義と基準・重複の棚卸し・契約とテストの対応・段階ごとにまとめたもの) |
|
|
369
|
+
| [docs/feature-inventory.md](feature-inventory.md) | 機能の棚卸し(機能ごとの維持・統合・簡素化・分離・廃止・保留の判断と、複数パッケージの構成での所属の候補)。機能を足す・分けるときと、パッケージの構成を変えるときに見直す |
|
|
295
370
|
| docs/development.md(この文書) | 開発の手順と構成 |
|
|
296
371
|
|
|
297
372
|
同じ説明を複数の文書に書かない(片方からリンクする)。確認作業の記録(どの幅・どのブラウザで確かめたか)は文書に書かず、
|
|
298
|
-
PR とタスクの変更の記録に残す。CLI のヘルプ(`src/cli/help.ts`)・API の説明(`src/server/api/manifest.ts`)は入口が変わったとき、
|
|
299
|
-
AI
|
|
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 |
|