@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/publishing.md
CHANGED
|
@@ -3,6 +3,16 @@
|
|
|
3
3
|
P3 を npm に `@infodb/p3` として公開するときのチェックリスト。npm への公開とタグ付けは人が行う。
|
|
4
4
|
CI は使わず、手元で確かめてから公開する。Docker のイメージ(Docker Hub の `tamuto/p3`)も同じ版で出す(6.)。
|
|
5
5
|
|
|
6
|
+
リポジトリは pnpm workspace で、公開するのは入口のパッケージ `@infodb/p3`(`packages/p3`)の1つだけ。kit・tasks
|
|
7
|
+
(`@infodb/p3-kit`・`@infodb/p3-tasks`)は公開せず、ビルドして同梱する。ルートの `package.json`(`p3-workspace`)は開発用で公開しない。
|
|
8
|
+
|
|
9
|
+
| | 開発(チェックアウト) | 公開する中身(`dist/package`) |
|
|
10
|
+
| --- | --- | --- |
|
|
11
|
+
| manifest | ルートの `package.json`(scripts・開発用の依存)と `packages/*/package.json`(入口は workspace の `@infodb/p3-kit`・`@infodb/p3-tasks` を devDependencies に持つ) | `packages/p3/package.json` から devDependencies(workspace の参照)と scripts を外したもの(`scripts/build-cli.mjs` が作る) |
|
|
12
|
+
| 版 | 4 つの manifest(ルート・入口・tasks・kit)を同じ版にする(`test/package.test.ts`) | 入口の版 |
|
|
13
|
+
| 中身 | ソース(`packages/*/src`)を tsx で動かす | 入口の `bin/`・`lib/`(tasks は `lib/tasks/`、kit は `lib/kit/` に同梱)・`dist/web`、ルートの `skills/`・`docs/`・README・LICENSE |
|
|
14
|
+
| 作り方 | `pnpm install` | `pnpm build`(`vite build` と `scripts/build-cli.mjs --require-web`)→ `npm pack ./dist/package` / `npm publish ./dist/package` |
|
|
15
|
+
|
|
6
16
|
## 1. 外部のパッケージ
|
|
7
17
|
|
|
8
18
|
- [ ] P3 が使う llmcs の部品(`@infodb/codex-workspace`・`@infodb/chatgpt-plan`)の必要な版が npm に公開されている
|
|
@@ -11,49 +21,56 @@ CI は使わず、手元で確かめてから公開する。Docker のイメー
|
|
|
11
21
|
`pnpm install` が `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` で止まる。待たずに入れる例外(`minimumReleaseAgeExclude`)は
|
|
12
22
|
自分たちの `@infodb/*` の部品を版で固定したものだけ([docs/architecture.md](architecture.md) の「llmcs の部品の依存」。
|
|
13
23
|
`test/package.test.ts` が確かめる)。1日を過ぎた版の例外は、公開の前に外す
|
|
14
|
-
- [ ] `package.json
|
|
24
|
+
- [ ] どの `package.json`(ルート・`packages/*`)にも手元のフォルダへのリンク(`link:` / `file:`)が無く、`pnpm-lock.yaml` のリンクは workspace の
|
|
25
|
+
自分たちのパッケージ(`../kit`・`../tasks`)だけ。workspace の参照は `@infodb/p3-kit`・`@infodb/p3-tasks` だけ(`test/package.test.ts`)
|
|
15
26
|
|
|
16
27
|
## 2. クリーンな依存の解決と検査
|
|
17
28
|
|
|
18
29
|
```bash
|
|
19
30
|
git clone <このリポジトリ> /tmp/p3-release && cd /tmp/p3-release # 隣に llmcs が無い場所で
|
|
20
31
|
pnpm install --frozen-lockfile
|
|
21
|
-
pnpm -s check #
|
|
32
|
+
pnpm -s check # 境界と層・型検査・lint・テスト・画面のビルド・UI テスト
|
|
22
33
|
```
|
|
23
34
|
|
|
24
35
|
## 3. 配布物の確認
|
|
25
36
|
|
|
26
37
|
```bash
|
|
27
|
-
node scripts/verify-pack.mjs --docker # npm pack → 実行時の依存だけで別の場所に入れて動かす(pnpm verify:pack でも同じ)
|
|
38
|
+
node scripts/verify-pack.mjs --docker # pnpm build → npm pack ./dist/package → 実行時の依存だけで別の場所に入れて動かす(pnpm verify:pack でも同じ)
|
|
28
39
|
```
|
|
29
40
|
|
|
30
|
-
- [ ] 全段が `ok`。確かめる段: Node の版と engines / tarball
|
|
41
|
+
- [ ] 全段が `ok`。確かめる段: Node の版と engines / tarball の中身(入口・同梱した tasks と kit・画面・skills・docs。ソースは入らない)/
|
|
42
|
+
`npm install`(開発用の依存・tsx・esbuild・公開しない `@infodb/p3-tasks`・`@infodb/p3-kit` が入らず、入れた manifest と実行時の import に
|
|
43
|
+
workspace のパッケージ・チェックアウトの参照が残らない)/ pnpm で入れてもビルドのスクリプトの許可を聞かない /
|
|
31
44
|
別のリポジトリで `init --agents`・`init --agents codex` と `p3 agents`(後から足す・`--force`)・`whoami`・要望の作成・Mock の Preflight・メモを足した再評価・`serve`(画面・資産・API)/
|
|
32
45
|
`codex update`(`--docker`。未登録・未認証のまま本物の Docker でイメージを作り直し、版を読む)
|
|
46
|
+
- [ ] 公開の前に、作った tarball をチェックアウトの外で npm と pnpm の一時実行でも動かす(入れずに動かす経路。登録の前の guide が版を返す):
|
|
47
|
+
`npm exec --yes --package <作った tarball> -- p3 guide --json`・`pnpm dlx --config.minimum-release-age=0 --package <作った tarball> p3 guide --json`
|
|
33
48
|
- [ ] 下限の Node(24.0.0)でも、作った tarball で通す(開発用の依存のインストールとビルドは下限の版で要らない):
|
|
34
49
|
`PATH=$(dirname $(npx -y node@24.0.0 -e "console.log(process.execPath)")):$PATH node scripts/verify-pack.mjs --tgz <作った tarball>`
|
|
35
50
|
- [ ] Node の下限を上げた版を出すときは、リリースノートに知らせる: 前の下限の Node では、npm は警告を出して入れ(`engine-strict` なら断る)、
|
|
36
51
|
pnpm・`pnpx` は警告を出さずに入れる(止められない)ので、利用者が `node -v` を確かめること、
|
|
37
|
-
Node を上げて入れ直すこと、Docker のイメージは pull してコンテナを作り直すこと(Node 22 → 24 以上は [導入ガイド](installation.md) の「Node 22 から上げるとき」)
|
|
52
|
+
Node を上げて入れ直すこと、Docker のイメージは pull してコンテナを作り直すこと(Node 22 → 24 以上は [導入ガイド](installation.md#補足-nodejs-の版と同じ版で動かすこと) の「Node 22 から上げるとき」)
|
|
38
53
|
- [ ] Docker が無い環境で確かめたときは、`codex update` の段が「実行していない」と出る。その場合は Docker のある環境で
|
|
39
54
|
`--docker` を付けて通すまで、公開に進まない
|
|
40
55
|
|
|
41
56
|
## 4. 公開する中身
|
|
42
57
|
|
|
43
|
-
- [ ] `npm pack --dry-run` の一覧に `.env
|
|
44
|
-
|
|
45
|
-
|
|
58
|
+
- [ ] `pnpm build` の後の `npm pack ./dist/package --dry-run` の一覧に `.env`・個人設定・デモデータ・テスト・ソース(`packages/`・`src/`)・
|
|
59
|
+
開発用のスキル(`.claude/`)が無い(`test/pack.test.ts`)
|
|
60
|
+
- [ ] その一覧に README から辿る文書(`docs/`)とそのリンクの先がある(`test/pack.test.ts`)。README と docs/ の相対リンクと節のアンカーが
|
|
61
|
+
解決する(`test/docs.test.ts`)
|
|
46
62
|
- [ ] 公開するリポジトリと tarball に、環境に固有のパス・個人の情報が無い。例は `~/p3-data/myapp`・`/home/me/...`・
|
|
47
63
|
`/workspaces`(DevContainer の慣例)のような汎用のものにする。コンテナの中の `/workspace`(リポジトリ)と `/data`
|
|
48
64
|
(データのフォルダ)は Codex のコンテナとの約束なので残す
|
|
49
|
-
- [ ] `package.json` の `repository` / `homepage` / `bugs` が実際の公開先を指している(リポジトリを公開してから確かめる)
|
|
50
|
-
- [ ]
|
|
65
|
+
- [ ] `packages/p3/package.json` の `repository` / `homepage` / `bugs` が実際の公開先を指している(リポジトリを公開してから確かめる)
|
|
66
|
+
- [ ] 版を上げた(ルート・`packages/p3`・`packages/tasks`・`packages/kit` の `package.json` の `version` を同じ版に)
|
|
51
67
|
|
|
52
68
|
## 5. 公開(人が行う)
|
|
53
69
|
|
|
54
70
|
```bash
|
|
55
|
-
npm login
|
|
56
|
-
|
|
71
|
+
npm login # @infodb のスコープに公開できるアカウント
|
|
72
|
+
pnpm build # 画面と CLI・serve をビルドし、公開する中身を dist/package に組み立てる
|
|
73
|
+
npm publish ./dist/package # 入口の @infodb/p3 だけを出す。publishConfig.access は public(kit・tasks は同梱済みで出さない)
|
|
57
74
|
```
|
|
58
75
|
|
|
59
76
|
公開した後に、別の環境で `pnpx @infodb/p3 --help` が動くことを確かめる(その版も公開から1日は pnpm の既定では入らない。
|
|
@@ -61,7 +78,9 @@ npm publish # prepack で画面をビルドする。publishConfig.
|
|
|
61
78
|
|
|
62
79
|
## 6. Docker Hub(tamuto/p3)
|
|
63
80
|
|
|
64
|
-
イメージの中の p3 は、そのときのチェックアウトから
|
|
81
|
+
イメージの中の p3 は、そのときのチェックアウトから npm に出すのと同じ中身(`pnpm build` の後の `npm pack ./dist/package` の tarball)で作る
|
|
82
|
+
(npm から取らない)。実行時の依存は、workspace の lockfile のまま入口の分だけを `pnpm --filter @infodb/p3 deploy --prod` で入れる(入口用の
|
|
83
|
+
lockfile で固定する)。npm に公開した版と同じ
|
|
65
84
|
コミット(版のタグ `v<版>`)から作り、タグも同じ版にする。ベースの Node はメジャー版だけを指定しているので、`--pull` を付けて
|
|
66
85
|
その時点の最新(同じメジャーのセキュリティリリースなど)を取って作る。Node の更新だけを取り込むときも、同じコミットから作り直して
|
|
67
86
|
push する(公開済みのイメージ・起動中のコンテナは自動では変わらない)。
|
|
@@ -74,7 +93,7 @@ push する(公開済みのイメージ・起動中のコンテナは自動で
|
|
|
74
93
|
- [ ] 作るのは `linux/amd64` だけ。arm64 は確かめるマシンが無いので作らない(対応していない)
|
|
75
94
|
|
|
76
95
|
```bash
|
|
77
|
-
V=$(node -p "require('./package.json').version")
|
|
96
|
+
V=$(node -p "require('./packages/p3/package.json').version")
|
|
78
97
|
docker login # tamuto に push できるアカウント
|
|
79
98
|
docker buildx build --pull --platform linux/amd64 --build-arg P3_VERSION=$V \
|
|
80
99
|
-t tamuto/p3:$V -t tamuto/p3:latest --push .
|
|
@@ -0,0 +1,332 @@
|
|
|
1
|
+
# 重複の整理とモジュール構成の組み直し
|
|
2
|
+
|
|
3
|
+
要望 261119-vwgf8 の記録。機能の取捨(削除・廃止)ではなく、同じ仕組みをまとめるリファクタリングと、複数パッケージの構成
|
|
4
|
+
([設計: パッケージの構成](architecture.md#パッケージの構成))に合わせた tasks のモジュール構成の組み直しを、段階に分けて行う。
|
|
5
|
+
機能と振る舞い(CLI・API・画面)、データの場所と形、配布、パッケージの間の依存の向き(入口 → tasks → kit)は変えない。
|
|
6
|
+
|
|
7
|
+
この文書は、始める前の基準(計測・重複の棚卸し・契約とテストの対応)と、各段階でまとめたもの・まとめなかったもの(理由)を残す。
|
|
8
|
+
|
|
9
|
+
## 計測の定義
|
|
10
|
+
|
|
11
|
+
コード量は `node scripts/measure-code.mjs`(`--json` で全部の値、`--root <チェックアウト>` で別の場所)で数える。
|
|
12
|
+
|
|
13
|
+
- **基準のコミット**: `f1eddda`(main。261119-9d1zk の後。0.13.0 のリリースの後)
|
|
14
|
+
- **製品のコード**: `packages/*/src` と `packages/p3/bin` の `.ts`・`.tsx`・`.mjs`
|
|
15
|
+
- **テスト**: `test/` の同じ拡張子。ユニットテスト・UI テスト(`test/ui`)・テストの資材(`test/fixtures`)に分ける
|
|
16
|
+
- **除くもの**: 生成したルート一覧(`*.gen.ts`)、`node_modules`、ビルドの出力(`lib`・`dist`・`build-src`。どれも src の外)、.ts 以外の資材
|
|
17
|
+
(`.md`・`.html`・`.png`・Dockerfile など)、コンテナの中で動く描画のスクリプト(`core/preflight/render-image/`)
|
|
18
|
+
- **行**: 改行の数(空行・コメントを含む。コメントの行は別に数える)
|
|
19
|
+
- **機能別**: `scripts/measure-code.mjs` の `FEATURES` の順に、パスの語で決める(入口と kit はパッケージで、tasks は `src` の中のパスで照らす)。
|
|
20
|
+
語で決めるので、ファイルを機能ごとのフォルダに移しても同じ機能として数える。移した後に当たらなくなったら、名前を変えずに語を足す。
|
|
21
|
+
テストはファイル名で分ける(画面ごとの UI テストなど、名前が機能を表さないものは「未分類」)
|
|
22
|
+
- **再計測**: 基準を数え直すときは、別の作業ツリーに基準のコミットを取り出し、今のスクリプトでその場所を数える
|
|
23
|
+
(`git worktree add /tmp/p3-base f1eddda && node scripts/measure-code.mjs --root /tmp/p3-base`)。スクリプトの定義を変えたら基準も数え直して並べる
|
|
24
|
+
|
|
25
|
+
### 基準(f1eddda)
|
|
26
|
+
|
|
27
|
+
製品のコード 42,450 行(242 ファイル、コメント 5,269 行)。テスト 27,421 行(173 ファイル)。
|
|
28
|
+
|
|
29
|
+
| パッケージ | 行 | ファイル |
|
|
30
|
+
| --- | --- | --- |
|
|
31
|
+
| tasks | 40,110 | 222 |
|
|
32
|
+
| 入口(p3) | 2,184 | 16 |
|
|
33
|
+
| kit | 156 | 4 |
|
|
34
|
+
|
|
35
|
+
| パッケージと層 | 行 | ファイル |
|
|
36
|
+
| --- | --- | --- |
|
|
37
|
+
| tasks/web | 14,552 | 94 |
|
|
38
|
+
| tasks/core | 14,359 | 72 |
|
|
39
|
+
| tasks/shared | 5,835 | 26 |
|
|
40
|
+
| tasks/cli | 3,930 | 21 |
|
|
41
|
+
| tasks/server | 1,434 | 9 |
|
|
42
|
+
| p3/cli | 1,158 | 5 |
|
|
43
|
+
| p3/web | 533 | 7 |
|
|
44
|
+
| p3/core | 265 | 1 |
|
|
45
|
+
| p3/server | 203 | 2 |
|
|
46
|
+
| kit | 156 | 4 |
|
|
47
|
+
| p3/bin | 25 | 1 |
|
|
48
|
+
|
|
49
|
+
| 機能 | 行 | ファイル |
|
|
50
|
+
| --- | --- | --- |
|
|
51
|
+
| Preflight(評価・案・分割・画面資料) | 6,178 | 32 |
|
|
52
|
+
| 要望(親子・進捗・検索・メモ・添付) | 5,238 | 37 |
|
|
53
|
+
| リリースノート | 2,468 | 14 |
|
|
54
|
+
| タスク(状態・停止・作業先・アーカイブ) | 2,386 | 14 |
|
|
55
|
+
| AI 接続・実行環境(Codex・ChatGPT・Docker) | 2,327 | 16 |
|
|
56
|
+
| タスクの AI レビュー | 2,302 | 10 |
|
|
57
|
+
| 設定・プロジェクト・個人設定 | 2,150 | 19 |
|
|
58
|
+
| 画面の共通(部品・処理) | 2,036 | 22 |
|
|
59
|
+
| マイルストーンレビュー | 1,989 | 9 |
|
|
60
|
+
| 品質基準・改善要望 | 1,718 | 9 |
|
|
61
|
+
| 保存(ファイル・コレクション・監視) | 1,507 | 6 |
|
|
62
|
+
| 要求の根拠・確認・回答 | 1,456 | 4 |
|
|
63
|
+
| 振り返り | 1,390 | 4 |
|
|
64
|
+
| 受け入れ基準・証拠 | 1,291 | 2 |
|
|
65
|
+
| 完了の記録・手戻り・見直し候補・前提 | 1,289 | 7 |
|
|
66
|
+
| 開発の指標 | 1,227 | 6 |
|
|
67
|
+
| 入口(起動・振り分け・AI 向けの入口) | 1,183 | 6 |
|
|
68
|
+
| 型と判定の共通(shared) | 1,041 | 3 |
|
|
69
|
+
| API の組み立て | 1,021 | 3 |
|
|
70
|
+
| 入口(serve・画面の外枠) | 1,001 | 10 |
|
|
71
|
+
| CLI の共通(引数・出力) | 862 | 4 |
|
|
72
|
+
| AI の実行の共通(run) | 234 | 1 |
|
|
73
|
+
| kit | 156 | 4 |
|
|
74
|
+
|
|
75
|
+
| テストの区分 | 行 | ファイル |
|
|
76
|
+
| --- | --- | --- |
|
|
77
|
+
| ユニットテスト | 21,464 | 127 |
|
|
78
|
+
| UI テスト(test/ui) | 5,357 | 36 |
|
|
79
|
+
| テストの資材(test/fixtures) | 600 | 10 |
|
|
80
|
+
|
|
81
|
+
## 重複の棚卸し(基準の時点)
|
|
82
|
+
|
|
83
|
+
パスは `packages/tasks/src/` からの相対(入口・kit はパッケージから書く)。「差」は機能ごとに違う今の契約で、まとめるときも変えない
|
|
84
|
+
(揃えると仕様の変更になる。直すかどうかは別の判断)。
|
|
85
|
+
|
|
86
|
+
### 1. 壊れた値を消さずに残す(要望・タスク・案の frontmatter の項目)
|
|
87
|
+
|
|
88
|
+
| 項目のまとまり | 読む関数と項目 | 問題の置き場所 |
|
|
89
|
+
| --- | --- | --- |
|
|
90
|
+
| 受け入れ基準・証拠・基準の根拠・採番 | `shared/acceptance.ts` の `readAcceptance`・`ACCEPTANCE_KEYS` | `acceptanceProblems` |
|
|
91
|
+
| 停止と履歴 | `shared/taskBlock.ts`・`BLOCK_KEYS` | `blockProblems` |
|
|
92
|
+
| 完了の記録 | `shared/completionRecord.ts` の `readCompletion`・`COMPLETION_KEYS` | `completionProblems` |
|
|
93
|
+
| 手戻りの履歴 | `shared/reworkHistory.ts` の `readRework`・`REWORK_KEYS` | `reworkProblems` |
|
|
94
|
+
| 要望の要求の根拠・回答 | `shared/requirementSource.ts` の `readRequirement`・`REQUIREMENT_KEYS` | `requirementProblems` |
|
|
95
|
+
| 前提の変更 | `shared/reviewCandidate.ts` の `readPremises`・`PREMISE_KEYS` | `premiseProblems` |
|
|
96
|
+
| 案の基準・根拠・採番 | `core/store/preflightStore.ts` の `draftCriteriaOf`、`core/preflight/service.ts` の `updateDraft`(`rawDraftField`・`saveDraftRaw`) | 案の `acceptanceProblems` |
|
|
97
|
+
|
|
98
|
+
- **既に共用しているもの**: 書き戻しの仕組みは `core/store/collection.ts` の `keepRaw`(汎用)。要望とタスクは `core/store/normalize.ts` の
|
|
99
|
+
`requestKeepRaw`・`taskKeepRaw`(問題がある項目のまとまりを列挙)と `TASK_DERIVED`(書かない項目)で、まとまりごとに手で並べている
|
|
100
|
+
- **まとめる候補**: 「項目・読む関数・問題の名前」を 1 つの定義の表にし、`keepRaw` と書かない項目をそこから作る。案の元の値の書き戻しも
|
|
101
|
+
同じ仕組みにする
|
|
102
|
+
- **差(残す)**: 壊れたときにどの操作を断るか(基準・根拠・停止は操作を断る、完了の記録と手戻りは状態の変更は通して新しい記録だけを足さず
|
|
103
|
+
`completionSkipped`・`reworkSkipped` で知らせる)と、その文言
|
|
104
|
+
- **まとめたもの(T002)**: `core/store/fieldGroups.ts` に要望・タスクのまとまり(`TASK_FIELD_GROUPS`・`REQUEST_FIELD_GROUPS`。項目・問題の名前・読む関数)を
|
|
105
|
+
1 か所で定義し、読む(`readFieldGroups`)・書き戻す(`keepRawOf`)・書かない項目(`problemKeysOf`)・CLI と API の入力から外す項目(`withoutManaged`)を
|
|
106
|
+
そこから作るようにした。`normalize.ts` の手で並べた `taskKeepRaw`・`requestKeepRaw`・`TASK_DERIVED`・`REQUEST_DERIVED` と、`requestOps.ts` の
|
|
107
|
+
3 か所の項目の列挙(作る・タスクの更新・要望の更新)を置き換えた。書き戻しと競合の仕組みは今までどおり `collection.ts` の `keepRaw` と版
|
|
108
|
+
- **まとめなかったもの**: 案の元の値の書き戻し(`preflightStore.ts`・`updateDraft`)は、案のファイルが `MarkdownCollection` でなく run の中の
|
|
109
|
+
ファイルで、書き戻す項目が根拠と採番の 2 つだけなので、今の形のまま(JSON の記録をまとめる T003 で、記録のファイルと一緒に見直す)。
|
|
110
|
+
各まとまりの検査・欠けたときの意味・断る操作と文言は各機能のまま(`test/fieldGroups.test.ts` が全部のまとまりを一緒に確かめる)
|
|
111
|
+
|
|
112
|
+
### 2. JSON・Markdown の記録のファイル(読み方・検査・ロック・置き換え・版)
|
|
113
|
+
|
|
114
|
+
| ファイル | 置き場所 | ロック | 壊れたとき(今) |
|
|
115
|
+
| --- | --- | --- | --- |
|
|
116
|
+
| `metrics/manual.json` | `core/metrics/manual.ts` | `metrics/.manual.lock` | 読むときは問題として知らせ、書くのは断る(`metrics_unreadable`) |
|
|
117
|
+
| `requests/<ID>/retrospective.json` | `core/retrospective.ts` | あり | JSON として読めなければ断る(`retro_unreadable`)。無ければ空 |
|
|
118
|
+
| `quality-improvements.json` | `core/qualityImprovement.ts` | `.quality-improvements.lock` | 読めない(`readFile` の失敗)なら空とみなす。JSON として読めなければ診断・登録とも断る(`invalid`) |
|
|
119
|
+
| `release-notes/<ID>.md` | `core/releaseNotes/store.ts` | あり | 読めない・形が違えば `invalid` |
|
|
120
|
+
| レビューの run(`run.json`・`input.json`・`review.json`) | `core/reviewRuns.ts` の `readJson`・`writeJson`(タスク・マイルストーンの各 `store.ts`) | run ごと | `broken` |
|
|
121
|
+
| Preflight の run・案・子の案 | `core/store/preflightStore.ts` | 案ごと(`drafts/.<key>.lock`) | 項目ごとに問題として知らせる |
|
|
122
|
+
| 添付の一覧(`attachments.json`) | `core/store/attachments.ts` | なし | 読めない添付を `invalid` に分ける |
|
|
123
|
+
| 画面資料の描画の記録 | `core/preflight/uiRender.ts` | なし | — |
|
|
124
|
+
| 個人設定(`config.yaml`) | `core/userConfig.ts` | あり | `UserConfigError` |
|
|
125
|
+
|
|
126
|
+
- **既に共用しているもの**: kit の `fsutil.ts`(`withFileLock`・`writeFileAtomic`)だけ。レビューの run は `reviewRuns.ts` の `readJson`・`writeJson` を共用
|
|
127
|
+
- **まとめる候補**: 「版つきの JSON の記録」の読み書き(無ければ空・壊れていれば問題・ロックの中で読み直す・版を照らす・置き換えで書く)を
|
|
128
|
+
tasks の共通の部品にする(2 つ目の製品が使うまで kit には置かない)
|
|
129
|
+
- **差(残す)**: 上の表の「壊れたとき」。まとめた後もこの差を各テストで確かめる
|
|
130
|
+
- **まとめたもの(T003)**: `core/store/jsonRecord.ts` に `readJsonRecord`(読むときの扱い — 無い・読めない・空・JSON として読めない・形 — を記録ごとに渡す)と
|
|
131
|
+
`writeJsonRecord`(整形した JSON を置き換えで書く)を置き、指標の人の記録(`metrics/manual.ts`)・振り返り(`retrospective.ts`)・品質の改善要望の登録
|
|
132
|
+
(`qualityImprovement.ts`)・レビューの run(`reviewRuns.ts` の `readJson`・`writeJson`)の読み書きと、Preflight の run・Mock の評価・画面資料の記録・
|
|
133
|
+
固定した添付の一覧の書き込みをこれに替えた。振り返りの確定とリスクの確認は、要望のロック・要望があることの確認(アーカイブの後に書き戻さない)・
|
|
134
|
+
版の照合・書き込みを `changeRetrospective` の 1 か所にした。ファイルの場所・形・ロックの粒度(記録ごとのロックか要望のロック)・各記録の版
|
|
135
|
+
(ファイルの `version`、記録の `rev`、診断の hash)と、品質の改善要望の予約 → 作成 → 確定の順は変えていない
|
|
136
|
+
- **まとめなかったもの**: Markdown の記録(リリースノート・案・子の案)は frontmatter で別の形なので今のまま。ロックは kit の `withFileLock` を各記録が
|
|
137
|
+
呼ぶ形のまま(ロックのファイルと、その中で何を確かめるかが記録ごとに違う)。品質の改善要望の「読めない(readFile の失敗)なら空とみなす」は今の扱いとして
|
|
138
|
+
残した(直すなら別の判断)
|
|
139
|
+
|
|
140
|
+
### 3. AI の実行(run)
|
|
141
|
+
|
|
142
|
+
| 実行 | 置き場所 | 履歴 | 回復・取り消し |
|
|
143
|
+
| --- | --- | --- | --- |
|
|
144
|
+
| Preflight | `core/preflight/service.ts`・`owner.ts`・`core/store/preflightStore.ts` | 要望の `preflight/<run>/` に永続 | 独自(所有者の識別子・落ちたプロセスの run の回復・取り消し) |
|
|
145
|
+
| タスクの AI レビュー | `core/taskReview/`(`service.ts`・`store.ts`) | `task-reviews/` に永続 | `core/reviewRuns.ts` の `RunControl`(共用) |
|
|
146
|
+
| マイルストーンレビュー | `core/milestoneReview/`(`service.ts`・`store.ts`) | `milestone-reviews/` に永続 | `RunControl`(共用) |
|
|
147
|
+
| リリースノートの要約 | `core/releaseNotes/generate.ts` | メモリ(保存は人が明示) | 取り消しのみ。材料の変化は警告 |
|
|
148
|
+
|
|
149
|
+
- **既に共用しているもの**: `RunControl`(保存・終わり・回復・取り消し・遅れた結果の拒否)はレビューの 2 つだけ
|
|
150
|
+
- **まとめる候補**: エンジンの選び方(codex / mock、`preflight.engine` の読み直し)、実行中の排他、取り消しの受け付け、進み具合の知らせ
|
|
151
|
+
- **差(残す)**: 履歴と回復の有無(Preflight の独自の永続の run、要約はメモリ)。揃えると仕様の変更になる
|
|
152
|
+
|
|
153
|
+
| 実行 | 開始と材料の固定 | 進み具合 | 取り消し | 回復 | 終わり |
|
|
154
|
+
| --- | --- | --- | --- | --- | --- |
|
|
155
|
+
| Preflight | 評価対象(要望・回答・根拠・添付)を run に固定。手元のエージェントは prepare → complete の明示 | ログと進み具合(pulse) | 自分のプロセスは止め、ほかは要求のファイル | 所有者の識別子で落ちた run を失敗に | 評価・案・子の案を run に書く |
|
|
156
|
+
| タスクの AI レビュー | 材料(基準・証拠・比較対象のファイル)を run に固定。agent の担当なら engine の明示 | ログを run.json に書き足す | `RunControl`(自分は止め、ほかは要求) | `RunControl`(死んだ所有者だけ crashed) | 遅れた結果は取り込まない |
|
|
157
|
+
| マイルストーンレビュー | 材料(目的・要望・タスク・コード・品質基準)を run に固定 | 同上 | 同上 | 同上 | 同上。完了の後に材料が変わっていれば `inputChanged` |
|
|
158
|
+
| リリースノートの要約 | 材料をメモリに持つ | メモリのログ | このプロセスだけ | なし(メモリ) | 結果は保存しない(人が保存する)。材料の変化は警告 |
|
|
159
|
+
|
|
160
|
+
- **まとめたもの(T004)**: `core/reviewRuns.ts` に `ReviewRunner` を置き、タスクの AI レビューとマイルストーンレビューの「このプロセスの実行の一覧・
|
|
161
|
+
二重の開始の確かめ(`begin`)・実行(`launch`。ログ・時間切れ・取り消し・ほかのプロセスの取消の要求の監視・失敗の分類・終わる前の確かめ・遅れた
|
|
162
|
+
結果の拒否)・回復・記録の取得(所有者の状態を添える)・取り消し・待つ・終わるまで待つ」を 1 か所にした(それぞれの service.ts は材料・依頼文・
|
|
163
|
+
結果の読み方・断る理由と文言だけを持つ)。頼む先の選び方(`pickReviewer`。明示 → `preflight.engine` → codex)と失敗の分類(`classifyAiFailure`。
|
|
164
|
+
接続できない・使用量の上限・結果を読めない・ほか)は、リリースノートの要約も含めた 3 つで共用した
|
|
165
|
+
- **まとめなかったもの**: Preflight の実行(`preflight/service.ts`・`owner.ts`)は、手元のエージェントの待機と明示の確認・評価対象の固定と採用の照合・
|
|
166
|
+
子の案・画面資料の描画を持ち、run の形も違うので、今の形のまま。リリースノートの要約の実行は、履歴を持たないメモリの実行で、取り消しはこのプロセスだけ
|
|
167
|
+
なので `ReviewRunner` は使わない(頼む先の選び方と失敗の分類だけを共用)
|
|
168
|
+
|
|
169
|
+
### 4. CLI と API の入口(エラーの対応・検査・出力)
|
|
170
|
+
|
|
171
|
+
| 入口 | 置き場所 | エラーの分岐 |
|
|
172
|
+
| --- | --- | --- |
|
|
173
|
+
| CLI の終了コード | `cli/tasksCli.ts` の `reportError` | 16 |
|
|
174
|
+
| 要望・タスク・Preflight・設定の API | `server/api/routes.ts` の `onError` | 25 |
|
|
175
|
+
| タスクの AI レビューの API | `server/api/taskReviewRoutes.ts` の `onError` | 5 |
|
|
176
|
+
| マイルストーンレビューの API | `server/api/milestoneReviewRoutes.ts` の `onError` | 4 |
|
|
177
|
+
| リリースノートの API | `server/api/releaseNoteRoutes.ts` の `onError` | 4 |
|
|
178
|
+
|
|
179
|
+
- 同じエラーの分類(規則に合わない・見つからない・競合・読めない)を、CLI は終了コード(1・2・3)、API は状態(400・404・409・422・500・503)で
|
|
180
|
+
別々に書いている。入力の検査も CLI(`cli/args.ts` と各コマンド)と API(zod)で別
|
|
181
|
+
- **まとめる候補**: エラーが自分の分類(と code)を持ち、CLI・API はそれを写すだけにする
|
|
182
|
+
- **差(残す)**: API が応答に添えるもの(競合の今の値 `current`・`plan`・`existing`・`inputMatch`)、`ConflictError` の今の値の取り方、標準エラーの前置き
|
|
183
|
+
(`競合: `・`設定: `・`見つかりません: `・`エラー: ` の有無)
|
|
184
|
+
- **まとめたもの(T006)**: `core/errorOutcome.ts` の 1 つの表(`errorOutcome`)に、エラーごとの CLI の終了コードと標準エラーの文、API の状態と
|
|
185
|
+
code・添える項目を並べ、CLI の `reportError`(`cliExit`)と API の 4 つのアプリの `onError`(`apiError`)はそれを写すだけにした。CLI と API で値が
|
|
186
|
+
違うもの(例: 親子の規則は CLI 1・API 409、振り返りの記録が読めないのは CLI 1・API 409、リリースノートが読めないのは CLI 1・API 422)は、表の同じ行に
|
|
187
|
+
両方を書いて違いが見えるようにした
|
|
188
|
+
- **各入口に残したもの**: 入力の解釈(CLI の引数と `cli/args.ts`、API の zod と `invalid input`)、テキストの表示、版の競合で今の値を読む処理(要望・タスクは
|
|
189
|
+
`routes.ts`、リリースノートは `releaseNoteRoutes.ts`。その場で読む必要がある)、タスクの AI レビューの API だけが見つからないにも code を付けること、
|
|
190
|
+
CLI のリリースノートの一括完了の断り(`releaseNotesCommands.ts` が計画を出す)、画面の失敗の表示と読み直し(`web/lib/api.ts` の `failureOf`)
|
|
191
|
+
- **振る舞いの差**: 表に載ったエラーは、どの API のアプリで起きても同じ状態になる(以前はそのアプリが扱わないエラーは 400 だった。各アプリの範囲の
|
|
192
|
+
エラーの応答は同じ)
|
|
193
|
+
|
|
194
|
+
### 5. 完了の時点と今の記録の参照
|
|
195
|
+
|
|
196
|
+
| 読み手 | 置き場所 | 読むもの |
|
|
197
|
+
| --- | --- | --- |
|
|
198
|
+
| 見直し候補 | `shared/reviewCandidate.ts`(`diagnoseTask`・`diagnoseRequest`)・`core/reviewCandidates.ts` | 最新の完了の記録と今の条件 |
|
|
199
|
+
| 開発の指標 | `core/metrics/definitions.ts` | 最初の対応済・完了済の記録 |
|
|
200
|
+
| 作る | `core/requestOps.ts`(`taskCompletionPatch` など) | 完了・済みの契機 |
|
|
201
|
+
| 表示 | `cli/showView.ts`・`cli/output.ts`・`web/components/CompletionReview.tsx`・`TaskDrawer.tsx`・`request/RequestReviewNotice.tsx` | 記録の一覧・最新 |
|
|
202
|
+
|
|
203
|
+
- **まとめる候補**: 「最新の記録」「契機ごとの最初の記録」などの取り出しを `shared/completionRecord.ts` の関数にし、読み手はそれを使う
|
|
204
|
+
- **差(残す)**: 見直し候補の判断と各レビューの材料はそれぞれのまま(入力が同じと確かめたところだけ共用する)
|
|
205
|
+
- **まとめたもの(T005)**: 同じ値・同じ時点を読む取り出しだけを共用にした。契機ごとの最初の完了の記録(`shared/completionRecord.ts` の `firstCompletion`。
|
|
206
|
+
指標の到達の時点と、対応済を経ずに完了済にしたかの判定)、1 つの更新(rev)に 1 件として数える手戻り(`shared/reworkHistory.ts` の `reworkPerRev`。
|
|
207
|
+
指標)、振り返りの根拠の手戻りの 1 件の引き方(`retrospective.ts` の `reworkEntry`。保存するときと照らすときで同じ)、ディスクから読み直した別の
|
|
208
|
+
`Workspace`(`Workspace.snapshot`。タスクの AI レビュー・マイルストーンレビュー・リリースノートの材料と、要望の一括完了の判定)。最新の記録の取り出しは
|
|
209
|
+
基準の時点で既に `latestCompletion` を共用していた
|
|
210
|
+
- **まとめなかったもの**:
|
|
211
|
+
|
|
212
|
+
| 経路 | 取得元と時点 | 残した理由 |
|
|
213
|
+
| --- | --- | --- |
|
|
214
|
+
| 見直し候補 | 最新の完了の記録(その時点の写し)と、今の品質基準・要望・基準の根拠・前提 | 候補の判断の規則そのもの |
|
|
215
|
+
| タスクの AI レビューの材料 | 読み直した要望・タスクと、参照先の git(比較対象のコミット・差分。`core.quotepath=off`・30 秒・64 MB) | 材料の固定と hash は run に残す契約 |
|
|
216
|
+
| マイルストーンレビューの材料 | 読み直したマイルストーンの要望・タスクと、参照先の HEAD・未コミットの変更の識別子(10 秒・4 MB、差分は 30 秒・256 MB) | 同上。git の呼び方(時間・大きさ・標準入力)が違う |
|
|
217
|
+
| リリースノートの材料 | 読み直したマイルストーンの要望・タスク・変更の記録 | 収録の条件がレビューと別 |
|
|
218
|
+
| 指標 | 今の要望・タスクの完了の記録と手戻りの履歴、レビューの最新の完了した run | 欠損と未到達の扱いが指標の定義 |
|
|
219
|
+
| 振り返り | 採用した run のリスクと、保存した根拠(レビューの結果の版・手戻りの ID) | 根拠の版を照らす規則 |
|
|
220
|
+
|
|
221
|
+
git の呼び出しはタスクの AI レビュー(`taskReview/material.ts`)とマイルストーンレビュー(`milestoneReview/code.ts`・`review.ts`)にそれぞれあるが、
|
|
222
|
+
時間切れ・出力の上限・パスの書き方・標準入力が違い、揃えると材料(と hash)が変わりうるので、まとめていない
|
|
223
|
+
|
|
224
|
+
## モジュール構成
|
|
225
|
+
|
|
226
|
+
tasks の中は、移す前と同じ技術の層(`shared` / `core` / `cli` / `server` / `web`)の共通の土台と、機能のまとまり
|
|
227
|
+
(`features/<機能>/{shared,core,cli,server,web}`)に分ける。1 つの機能のコードは、その機能のフォルダの中で層に分かれる。
|
|
228
|
+
|
|
229
|
+
- **読んでよいもの**(`test/featureBoundary.test.ts`): 機能の `shared/`(型と判定の純粋な契約)はどこからでも読める。共通の土台の `core`・`shared` は
|
|
230
|
+
機能の中身を読まない(組み立ての場所 `ASSEMBLY` だけが例外で、理由と一緒に列挙: プロジェクトを開く `context.ts`・保存の入口 `workspace.ts`・
|
|
231
|
+
エラーの表 `errorOutcome.ts`・変更の手順 `requestOps.ts`・進捗の集計 `ops.ts`)。入口の役の層(`cli`・`server`)は機能の `core` と同じ層を呼んで
|
|
232
|
+
組み立ててよく、画面(`web`)は機能の `web` の部品を組み合わせてよい。機能の `core` が別の機能の `core` を読むのは禁止(契約は `shared/` に置く)。
|
|
233
|
+
機能どうしの読み込みは循環しない。層の向き(shared ← core ← server / cli、web → shared)は機能の中でも同じ(`test/layers.test.ts`)
|
|
234
|
+
- **組み立ての場所(入口と製品の接点)**: CLI はコマンドの振り分け(`cli/tasksCli.ts`)が機能の `cli/` を呼ぶ。API は `server/api/routes.ts` が機能の
|
|
235
|
+
`server/` のアプリ(Hono)を `app.route` でつなぐ。画面は `web/routes/` のファイルがルートの宣言(URL と検索の値)だけを持ち、ページの中身は機能の
|
|
236
|
+
`web/` から読む(物理のルートのフォルダは入口の `__root.tsx` の下にそのまま付く)。プロジェクトを開くとき(`core/context.ts`)に各機能の
|
|
237
|
+
サービスを作り、保存の入口(`core/store/workspace.ts`)が各機能の記録のストアを持つ
|
|
238
|
+
- **配布**: `scripts/build-cli.mjs` は tasks の `features/` も Node の JavaScript に入れる(`web/` を除く)。画面は入口で vite がビルドし、Tailwind は
|
|
239
|
+
tasks の `src` 全体のクラスを拾う
|
|
240
|
+
|
|
241
|
+
共通の土台に残したもの: Preflight と AI の実行(`core/preflight/`。評価・案・子の案・評価対象の固定・画面資料の描画と添付・Codex と ChatGPT の接続・Docker と
|
|
242
|
+
ホストのパス・run の所有者・エンジンの型。`shared/types.ts`・保存・添付・2 つのエンジンが互いに読み合う p3-tasks の中心の流れで、機能に分けると多くの依存を
|
|
243
|
+
逆向きにする必要があるため。レビューの run の骨組み `core/reviewRuns.ts` も、複数の機能が使う共通として残した)、要望とタスクの本体(`shared/types.ts`・保存 `core/store/`・変更の手順 `core/requestOps.ts`・読み取り `core/ops.ts`・親子 `core/hierarchy.ts`・
|
|
244
|
+
状態 `core/requestStatus.ts`・停止・作業先・置き換え)と、入口も使う基盤(個人設定 `core/userConfig.ts`・マシンごとの設定 `core/machineSettings.ts`・
|
|
245
|
+
プロジェクトの決め方 `core/store/locate.ts`)、CLI の振り分けと共通の出力、API の組み立て、画面の共通の部品と処理。
|
|
246
|
+
|
|
247
|
+
| 段階 | 移した機能 |
|
|
248
|
+
| --- | --- |
|
|
249
|
+
| T007 | 開発の指標(`features/metrics`: `shared/metrics.ts`・`core/{definitions,index,manual}.ts`・`cli/metricsCommands.ts`・`server/metricsRoutes.ts`(API から切り出した)・`web/MetricsPage.tsx`(ルートの宣言は `web/routes/metrics.tsx`)) |
|
|
250
|
+
| T008 | 完了の記録・手戻り・見直し候補・前提(`features/records`)、品質基準・テンプレート・改善要望(`features/quality`)、振り返り(`features/retro`)、要求の根拠・確認事項と回答・受け入れ基準と証拠(`features/requirements`。基準の根拠が要求の根拠と同じ記録なので、受け入れ基準と 1 つのまとまりにした)、参照先・テーマ・マシンごとの設定の書き換え(`features/settings`) |
|
|
251
|
+
| T009 | タスクの AI レビュー(`features/taskReview`)、マイルストーンレビュー(`features/milestoneReview`)、リリースノートと要約・要望の一括完了(`features/releaseNotes`)。2 つのレビューがリリースノートの要約の型(`Summarizer`)を読んでいたのを、AI の実行の共通(`core/preflight/engine.ts`)に移し、タスクの AI レビューがマイルストーンレビューのコードの材料から読んでいた成果物のコミットの取り出しを `shared/commitRefs.ts` に移した(機能の core どうしを読まないため) |
|
|
252
|
+
|
|
253
|
+
## 前後の計測
|
|
254
|
+
|
|
255
|
+
同じ手順(`scripts/measure-code.mjs` の最後の定義で、基準 `f1eddda` を別の作業ツリーに取り出して数え直したものと、T010 の時点)で比べる。
|
|
256
|
+
|
|
257
|
+
| | 基準 | 後 | 差 |
|
|
258
|
+
| --- | --- | --- | --- |
|
|
259
|
+
| 製品のコード | 42,450 | 42,538 | +88 |
|
|
260
|
+
| tasks | 40,110 | 40,198 | +88 |
|
|
261
|
+
| p3 | 2,184 | 2,184 | 0 |
|
|
262
|
+
| kit | 156 | 156 | 0 |
|
|
263
|
+
|
|
264
|
+
| 機能 | 基準 | 後 | 差 |
|
|
265
|
+
| --- | --- | --- | --- |
|
|
266
|
+
| Preflight(評価・案・分割・画面資料) | 6,178 | 6,190 | +12 |
|
|
267
|
+
| 要望(親子・進捗・検索・メモ・添付) | 5,238 | 5,240 | +2 |
|
|
268
|
+
| リリースノート | 2,468 | 2,445 | -23 |
|
|
269
|
+
| タスク(状態・停止・作業先・アーカイブ) | 2,386 | 2,386 | 0 |
|
|
270
|
+
| AI 接続・実行環境(Codex・ChatGPT・Docker) | 2,327 | 2,327 | 0 |
|
|
271
|
+
| タスクの AI レビュー | 2,302 | 2,236 | -66 |
|
|
272
|
+
| 設定・プロジェクト・個人設定 | 2,150 | 2,150 | 0 |
|
|
273
|
+
| 画面の共通(部品・処理) | 2,036 | 2,036 | 0 |
|
|
274
|
+
| マイルストーンレビュー | 1,989 | 1,913 | -76 |
|
|
275
|
+
| 品質基準・改善要望 | 1,718 | 1,721 | +3 |
|
|
276
|
+
| 保存(ファイル・コレクション・監視) | 1,507 | 1,610 | +103 |
|
|
277
|
+
| 要求の根拠・確認・回答 | 1,456 | 1,456 | 0 |
|
|
278
|
+
| 振り返り | 1,390 | 1,386 | -4 |
|
|
279
|
+
| 完了の記録・手戻り・見直し候補・前提 | 1,289 | 1,298 | +9 |
|
|
280
|
+
| 受け入れ基準・証拠 | 1,291 | 1,291 | 0 |
|
|
281
|
+
| 開発の指標 | 1,227 | 1,240 | +13 |
|
|
282
|
+
| 入口(起動・振り分け・AI 向けの入口) | 1,183 | 1,183 | 0 |
|
|
283
|
+
| 型と判定の共通(shared) | 1,041 | 1,049 | +8 |
|
|
284
|
+
| 入口(serve・画面の外枠) | 1,001 | 1,001 | 0 |
|
|
285
|
+
| API の組み立て | 1,021 | 985 | -36 |
|
|
286
|
+
| CLI の共通(引数・出力) | 862 | 770 | -92 |
|
|
287
|
+
| AI の実行の共通(run) | 234 | 348 | +114 |
|
|
288
|
+
| kit | 156 | 156 | 0 |
|
|
289
|
+
| エラーの対応の表(CLI・API) | 0 | 121 | +121 |
|
|
290
|
+
|
|
291
|
+
| テスト | 基準 | 後 | 差 |
|
|
292
|
+
| --- | --- | --- | --- |
|
|
293
|
+
| テスト | 27,421 | 27,922 | +501 |
|
|
294
|
+
| ユニットテスト | 21,464 | 21,965 | +501 |
|
|
295
|
+
| テストの資材(test/fixtures) | 600 | 600 | 0 |
|
|
296
|
+
| UI テスト(test/ui) | 5,357 | 5,357 | 0 |
|
|
297
|
+
|
|
298
|
+
**読み方**: 製品のコードの合計はほぼ変わっていない(+88 行、+0.2%)。行数を減らすことは目的にしておらず、重複していた責務を 1 か所に移したことが
|
|
299
|
+
次の差に表れている。
|
|
300
|
+
|
|
301
|
+
- CLI の共通(-92)と API の組み立て(-36)の、エラーごとの分岐が、エラーの対応の表(+121。CLI と API の値を同じ行に並べた)に移った
|
|
302
|
+
- タスクの AI レビュー(-66)・マイルストーンレビュー(-76)・リリースノート(-23)の、実行の骨組み・頼む先の選び方・失敗の分類が、AI の実行の共通(+114)に移った
|
|
303
|
+
- 保存(+103)は、要望・タスクの項目のまとまりの定義(`fieldGroups.ts`)と JSON の記録の読み書き(`jsonRecord.ts`)を足した分。normalize・requestOps・各記録の
|
|
304
|
+
読み書きの重複を置き換えたが、置き換えた側の行は機能ごとに少しずつなので、機能の行の差は小さい
|
|
305
|
+
- 機能のまとまりへの移動(tasks の層の `features/` が 15,903 行)は、行数を変えない(層ごとの行は `node scripts/measure-code.mjs` の「パッケージと層」)
|
|
306
|
+
- テストの +501 行は、契約を確かめるテスト(エラーの対応・項目のまとまり・JSON の記録・採番・境界)を足した分で、既存のテストは減らしていない
|
|
307
|
+
|
|
308
|
+
重複の責務ごとに、どこへまとめたか: 壊れた値の保持 → `core/store/fieldGroups.ts`、記録のファイルの読み書き → `core/store/jsonRecord.ts`、AI の実行の骨組みと
|
|
309
|
+
頼む先・失敗の分類 → `core/reviewRuns.ts`(`ReviewRunner`・`pickReviewer`・`classifyAiFailure`)、同じ時点の記録の取り出し → `firstCompletion`・`reworkPerRev`・
|
|
310
|
+
`Workspace.snapshot`、エラーの対応 → `core/errorOutcome.ts`。まとめなかったものと理由は上の各節。
|
|
311
|
+
|
|
312
|
+
## 契約と既存のテストの対応
|
|
313
|
+
|
|
314
|
+
まとめるときに変えない契約と、それを確かめるテスト。基準の時点で足りなかったものは、この要望で足した(下の「足したもの」)。各段階は、
|
|
315
|
+
変えた範囲のテストと `pnpm -s check` を通し、境界・ルート一覧・配布に触れた段階は `test/packageBoundary.test.ts`・`test/layers.test.ts`・
|
|
316
|
+
`test/pack.test.ts`(必要なら `scripts/verify-pack.mjs`)も通す。
|
|
317
|
+
|
|
318
|
+
| 契約 | 確かめるテスト |
|
|
319
|
+
| --- | --- |
|
|
320
|
+
| CLI のコマンド・オプション・出力・読む/書くの判定 | `test/cli*.test.ts`(9 ファイル。特に `cliResolve.test.ts`)・`test/recordSkipJson.test.ts`・各機能の CLI のテスト |
|
|
321
|
+
| CLI の終了コードと標準エラー(エラーの種類ごと) | `test/errorContract.test.ts`(足したもの) |
|
|
322
|
+
| API の成功の応答 | `test/api.test.ts`・`test/allProjects.test.ts`・各機能の API のテスト(`completionRecord`・`requirementSource`・`workTarget` など) |
|
|
323
|
+
| API の失敗の状態と code(エラーの種類ごと) | `test/errorContract.test.ts`(足したもの)・各機能の API のテスト |
|
|
324
|
+
| 画面の URL と主な操作 | `test/ui/*.ui.test.ts`(31 ファイル。流れは `flow.ui.test.ts`) |
|
|
325
|
+
| 旧データ・壊れた値・知らない項目・ロックと版 | `test/store.test.ts`・`archivedTasks`・`completionRecord`・`reworkHistory`・`sourceSeq`・`taskBlock`・`requirementSource`・`metricsManual`・`retrospective`・`qualityImprovement`・`milestoneReviewStore` |
|
|
326
|
+
| パッケージの境界・層・配布物 | `test/packageBoundary.test.ts`・`test/layers.test.ts`・`test/pack.test.ts`・`test/package.test.ts` |
|
|
327
|
+
|
|
328
|
+
**足したもの**(基準の時点で確かめていなかった契約):
|
|
329
|
+
|
|
330
|
+
- `test/errorContract.test.ts`: エラーの種類ごとの CLI の終了コードと標準エラー(44 件)と、API の状態と code(routes・タスクの AI レビュー・
|
|
331
|
+
マイルストーンレビュー・リリースノートのアプリ)
|
|
332
|
+
- `test/qualityImprovement.test.ts`: `quality-improvements.json` が JSON として読めないときの今の扱い(診断の時点で断り、ファイルを変えない)
|