@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.
Files changed (219) hide show
  1. package/README.md +33 -35
  2. package/bin/p3.mjs +3 -2
  3. package/dist/web/assets/CompletionReview-BD7d6Yzt.js +1 -0
  4. package/dist/web/assets/ImprovementDialog-BoAZN1KR.js +1 -0
  5. package/dist/web/assets/Outputs-D-ZouoxF.js +1 -0
  6. package/dist/web/assets/RequestStatus-Bl3fdSbM.js +1 -0
  7. package/dist/web/assets/Tabs-CxeceOL-.js +1 -0
  8. package/dist/web/assets/TagInput-CeAbmGRR.js +1 -0
  9. package/dist/web/assets/TaskDrawer-BCriSnhe.js +6 -0
  10. package/dist/web/assets/_requestId-CZKMe_mC.js +1 -0
  11. package/dist/web/assets/_requestId-Fx4lLkFo.js +1 -0
  12. package/dist/web/assets/appCtx-BdxbkSZa.js +1 -0
  13. package/dist/web/assets/archive-D5IIxcSV.js +1 -0
  14. package/dist/web/assets/board-p6R9KMqd.js +1 -0
  15. package/dist/web/assets/done-BTOF188x.js +1 -0
  16. package/dist/web/assets/draft-BWYpm3PD.js +2 -0
  17. package/dist/web/assets/index-DFbY8NAR.css +2 -0
  18. package/dist/web/assets/index-Dpqi2dcC.js +12 -0
  19. package/dist/web/assets/link-D481whDt.js +1 -0
  20. package/dist/web/assets/metrics-CAzP6V8I.js +1 -0
  21. package/dist/web/assets/new-C65IJJg3.js +1 -0
  22. package/dist/web/assets/outputs-CXqnjSqV.js +1 -0
  23. package/dist/web/assets/preflightInput-ClKwkp8R.js +2 -0
  24. package/dist/web/assets/preload-helper-_dAYMct_.js +1 -0
  25. package/dist/web/assets/{quality-Pu6EISAM.js → quality-RFd-7k3r.js} +1 -1
  26. package/dist/web/assets/release-notes-Dtif8xsQ.js +5 -0
  27. package/dist/web/assets/requestData-SPc36t8Q.js +1 -0
  28. package/dist/web/assets/routes-DJj8CWuk.js +6 -0
  29. package/dist/web/assets/settings-DKJd7CLe.js +1 -0
  30. package/dist/web/assets/ui-CbEOnPnF.js +1 -0
  31. package/dist/web/assets/workTarget-DavxMs-c.js +30 -0
  32. package/dist/web/index.html +6 -4
  33. package/docs/architecture.md +430 -72
  34. package/docs/chatgpt-sign-in.md +2 -2
  35. package/docs/development.md +141 -64
  36. package/docs/feature-inventory.md +139 -0
  37. package/docs/how-to-use.md +389 -31
  38. package/docs/installation.md +261 -147
  39. package/docs/publishing.md +33 -14
  40. package/docs/refactoring.md +332 -0
  41. package/lib/cli/agentsStatus.js +198 -0
  42. package/lib/cli/guide.js +27 -0
  43. package/lib/cli/guide.md +217 -0
  44. package/lib/cli/help.js +45 -7
  45. package/lib/cli/main.js +58 -207
  46. package/lib/cli/project.js +34 -294
  47. package/lib/core/projectRegistry.js +2 -2
  48. package/lib/kit/appInfo.js +13 -0
  49. package/lib/kit/usage.js +27 -0
  50. package/lib/server/api/projectsRoutes.js +5 -5
  51. package/lib/server/server.js +7 -4
  52. package/lib/{cli → tasks/cli}/args.js +73 -9
  53. package/lib/{cli → tasks/cli}/chatgpt.js +1 -1
  54. package/lib/{cli → tasks/cli}/codex.js +1 -1
  55. package/lib/{cli → tasks/cli}/output.js +12 -2
  56. package/lib/{cli → tasks/cli}/preflightCommands.js +1 -1
  57. package/lib/tasks/cli/readOnly.js +75 -0
  58. package/lib/{cli → tasks/cli}/render.js +1 -1
  59. package/lib/{cli → tasks/cli}/requestCommands.js +24 -7
  60. package/lib/tasks/cli/showView.js +279 -0
  61. package/lib/{cli → tasks/cli}/taskCommands.js +55 -21
  62. package/lib/tasks/cli/tasksCli.js +149 -0
  63. package/lib/{core → tasks/core}/context.js +6 -9
  64. package/lib/tasks/core/errorOutcome.js +125 -0
  65. package/lib/{core → tasks/core}/hierarchy.js +1 -1
  66. package/lib/{core → tasks/core}/ops.js +17 -2
  67. package/lib/{core → tasks/core}/preflight/carryover.js +5 -1
  68. package/lib/{core → tasks/core}/preflight/codexEngine.js +36 -28
  69. package/lib/{core → tasks/core}/preflight/diagnose.js +4 -9
  70. package/lib/{core → tasks/core}/preflight/engine.js +9 -0
  71. package/lib/tasks/core/preflight/hostPaths.js +299 -0
  72. package/lib/{core → tasks/core}/preflight/input.js +33 -5
  73. package/lib/{core → tasks/core}/preflight/instructions.js +19 -2
  74. package/lib/{core → tasks/core}/preflight/mockEngine.js +27 -8
  75. package/lib/{core → tasks/core}/preflight/render.js +22 -3
  76. package/lib/{core → tasks/core}/preflight/service.js +86 -11
  77. package/lib/{core → tasks/core}/preflight/uiRender.js +5 -2
  78. package/lib/{core → tasks/core}/requestOps.js +214 -17
  79. package/lib/{core → tasks/core}/reviewRuns.js +127 -22
  80. package/lib/{core → tasks/core}/store/attachments.js +3 -2
  81. package/lib/{core → tasks/core}/store/collection.js +21 -2
  82. package/lib/tasks/core/store/fieldGroups.js +30 -0
  83. package/lib/tasks/core/store/jsonRecord.js +30 -0
  84. package/lib/{core → tasks/core}/store/normalize.js +15 -10
  85. package/lib/{core → tasks/core}/store/noteStore.js +2 -2
  86. package/lib/{core → tasks/core}/store/preflightStore.js +59 -22
  87. package/lib/{core → tasks/core}/store/projectFile.js +1 -1
  88. package/lib/{core → tasks/core}/store/workspace.js +28 -6
  89. package/lib/{core → tasks/core}/userConfig.js +1 -1
  90. package/lib/{core → tasks/core}/workTargets.js +1 -1
  91. package/lib/tasks/features/metrics/cli/metricsCommands.js +77 -0
  92. package/lib/tasks/features/metrics/core/definitions.js +445 -0
  93. package/lib/tasks/features/metrics/core/index.js +112 -0
  94. package/lib/tasks/features/metrics/core/manual.js +179 -0
  95. package/lib/tasks/features/metrics/server/metricsRoutes.js +8 -0
  96. package/lib/tasks/features/metrics/shared/metrics.js +42 -0
  97. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/code.js +2 -11
  98. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/material.js +5 -6
  99. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/review.js +2 -2
  100. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/service.js +38 -100
  101. package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/store.js +3 -3
  102. package/lib/{server/api → tasks/features/milestoneReview/server}/milestoneReviewRoutes.js +7 -13
  103. package/lib/{cli → tasks/features/quality/cli}/qualityCommands.js +36 -11
  104. package/lib/{core → tasks/features/quality/core}/qualityImprovement.js +16 -15
  105. package/lib/tasks/features/records/cli/revisitCommands.js +73 -0
  106. package/lib/tasks/features/records/core/completionRefs.js +46 -0
  107. package/lib/tasks/features/records/core/reviewCandidates.js +76 -0
  108. package/lib/tasks/features/records/shared/completionRecord.js +329 -0
  109. package/lib/tasks/features/records/shared/reviewCandidate.js +313 -0
  110. package/lib/tasks/features/records/shared/reworkHistory.js +86 -0
  111. package/lib/{cli → tasks/features/releaseNotes/cli}/releaseNotesCommands.js +7 -7
  112. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/completeRequests.js +5 -6
  113. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/generate.js +3 -14
  114. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/material.js +3 -4
  115. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/service.js +1 -1
  116. package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/store.js +2 -2
  117. package/lib/{server/api → tasks/features/releaseNotes/server}/releaseNoteRoutes.js +11 -20
  118. package/lib/tasks/features/requirements/cli/requirementCommands.js +289 -0
  119. package/lib/{shared → tasks/features/requirements/shared}/acceptance.js +292 -18
  120. package/lib/tasks/features/requirements/shared/requirementSource.js +635 -0
  121. package/lib/tasks/features/retro/cli/retroCommands.js +106 -0
  122. package/lib/tasks/features/retro/core/retrospective.js +197 -0
  123. package/lib/tasks/features/retro/shared/retrospective.js +286 -0
  124. package/lib/tasks/features/settings/cli/projectSettings.js +245 -0
  125. package/lib/{cli → tasks/features/settings/cli}/userConfig.js +50 -3
  126. package/lib/{core → tasks/features/settings/core}/machineSettingsEdit.js +2 -2
  127. package/lib/{core → tasks/features/settings/core}/repoAdmin.js +3 -3
  128. package/lib/{core → tasks/features/settings/core}/userTheme.js +2 -2
  129. package/lib/{server/api → tasks/features/settings/server}/repoRoutes.js +2 -2
  130. package/lib/{server/api → tasks/features/settings/server}/userThemeRoutes.js +3 -3
  131. package/lib/{cli → tasks/features/taskReview/cli}/taskReviewCommands.js +5 -5
  132. package/lib/{core/taskReview → tasks/features/taskReview/core}/material.js +13 -7
  133. package/lib/{core/taskReview → tasks/features/taskReview/core}/review.js +10 -3
  134. package/lib/{core/taskReview → tasks/features/taskReview/core}/service.js +24 -85
  135. package/lib/{core/taskReview → tasks/features/taskReview/core}/store.js +4 -4
  136. package/lib/{server/api → tasks/features/taskReview/server}/taskReviewRoutes.js +7 -14
  137. package/lib/{server → tasks/server}/api/manifest.js +51 -3
  138. package/lib/{server → tasks/server}/api/routes.js +134 -65
  139. package/lib/tasks/shared/commitRefs.js +10 -0
  140. package/lib/{shared → tasks/shared}/preflightInput.js +1 -1
  141. package/package.json +1 -43
  142. package/skills/p3/SKILL.md +9 -181
  143. package/dist/web/assets/ImprovementDialog-kQaVBGWH.js +0 -1
  144. package/dist/web/assets/Outputs-_nU_p3nu.js +0 -1
  145. package/dist/web/assets/RequestStatus-RG-OVQYY.js +0 -1
  146. package/dist/web/assets/Tabs-ew9i5SKX.js +0 -1
  147. package/dist/web/assets/TagInput-BtlJTF7i.js +0 -1
  148. package/dist/web/assets/TaskDrawer-DW8GyJqI.js +0 -6
  149. package/dist/web/assets/_requestId-6Nb727dD.js +0 -1
  150. package/dist/web/assets/_requestId-BykTgPax.js +0 -1
  151. package/dist/web/assets/appCtx-CxDdXABS.js +0 -1
  152. package/dist/web/assets/archive-Ckh295Xe.js +0 -1
  153. package/dist/web/assets/board-BVAIjK-Y.js +0 -1
  154. package/dist/web/assets/done-BGfA-3MA.js +0 -1
  155. package/dist/web/assets/draft-CfJeyLOl.js +0 -1
  156. package/dist/web/assets/index-CgRU744I.css +0 -2
  157. package/dist/web/assets/index-DacQ0yl4.js +0 -12
  158. package/dist/web/assets/new-DVygWvVc.js +0 -1
  159. package/dist/web/assets/outputs-B6xDsLZf.js +0 -1
  160. package/dist/web/assets/preflightInput-BAeEJYUK.js +0 -2
  161. package/dist/web/assets/preload-helper-DyCqp21K.js +0 -1
  162. package/dist/web/assets/release-notes-CCpzyiNf.js +0 -5
  163. package/dist/web/assets/requestData-D5vBnuMh.js +0 -1
  164. package/dist/web/assets/routes-Q91zvNc0.js +0 -4
  165. package/dist/web/assets/settings-BzRgcmUm.js +0 -1
  166. package/dist/web/assets/workTarget-C9c57JAO.js +0 -30
  167. package/lib/cli/readOnly.js +0 -38
  168. package/lib/cli/showView.js +0 -166
  169. /package/lib/{core/store → kit}/frontmatter.js +0 -0
  170. /package/lib/{core/store → kit}/fsutil.js +0 -0
  171. /package/lib/{cli → tasks/cli}/format.js +0 -0
  172. /package/lib/{core → tasks/core}/chatgpt.js +0 -0
  173. /package/lib/{core → tasks/core}/machineSettings.js +0 -0
  174. /package/lib/{core → tasks/core}/preflight/codexImage.js +0 -0
  175. /package/lib/{core → tasks/core}/preflight/docker.js +0 -0
  176. /package/lib/{core → tasks/core}/preflight/launch.js +0 -0
  177. /package/lib/{core → tasks/core}/preflight/launcher.mjs +0 -0
  178. /package/lib/{core → tasks/core}/preflight/mock-ui.html +0 -0
  179. /package/lib/{core → tasks/core}/preflight/mock-ui.png +0 -0
  180. /package/lib/{core → tasks/core}/preflight/owner.js +0 -0
  181. /package/lib/{core → tasks/core}/preflight/render-image/Dockerfile +0 -0
  182. /package/lib/{core → tasks/core}/preflight/render-image/fonts-ja.conf +0 -0
  183. /package/lib/{core → tasks/core}/preflight/render-image/render.mjs +0 -0
  184. /package/lib/{core → tasks/core}/preflight/split.js +0 -0
  185. /package/lib/{core → tasks/core}/preflight/uiMaterials.js +0 -0
  186. /package/lib/{core → tasks/core}/preflight/wireframe.js +0 -0
  187. /package/lib/{core → tasks/core}/preflight/xlsx.js +0 -0
  188. /package/lib/{core → tasks/core}/redact.js +0 -0
  189. /package/lib/{core → tasks/core}/repoRefs.js +0 -0
  190. /package/lib/{core → tasks/core}/requestStatus.js +0 -0
  191. /package/lib/{core → tasks/core}/store/archivedTasks.js +0 -0
  192. /package/lib/{core → tasks/core}/store/dataWatcher.js +0 -0
  193. /package/lib/{core → tasks/core}/store/locate.js +0 -0
  194. /package/lib/{core → tasks/core}/supersede.js +0 -0
  195. /package/lib/{core/milestoneReview → tasks/features/milestoneReview/core}/mockReviewer.js +0 -0
  196. /package/lib/{shared → tasks/features/milestoneReview/shared}/milestoneReview.js +0 -0
  197. /package/lib/{core → tasks/features/quality/core}/quality.js +0 -0
  198. /package/lib/{shared → tasks/features/quality/shared}/quality.js +0 -0
  199. /package/lib/{shared → tasks/features/quality/shared}/qualityImprovement.js +0 -0
  200. /package/lib/{shared → tasks/features/quality/shared}/qualityTemplates.js +0 -0
  201. /package/lib/{core/releaseNotes → tasks/features/releaseNotes/core}/mockSummarizer.js +0 -0
  202. /package/lib/{core/taskReview → tasks/features/taskReview/core}/mockReviewer.js +0 -0
  203. /package/lib/{core/taskReview → tasks/features/taskReview/core}/paths.js +0 -0
  204. /package/lib/{shared → tasks/features/taskReview/shared}/taskReview.js +0 -0
  205. /package/lib/{server → tasks/server}/api/chatgptRoutes.js +0 -0
  206. /package/lib/{server → tasks/server}/api/local.js +0 -0
  207. /package/lib/{shared → tasks/shared}/dates.js +0 -0
  208. /package/lib/{shared → tasks/shared}/directTask.js +0 -0
  209. /package/lib/{shared → tasks/shared}/hierarchy.js +0 -0
  210. /package/lib/{shared → tasks/shared}/milestoneGoals.js +0 -0
  211. /package/lib/{shared → tasks/shared}/milestoneOrder.js +0 -0
  212. /package/lib/{shared → tasks/shared}/preflightRunner.js +0 -0
  213. /package/lib/{shared → tasks/shared}/refs.js +0 -0
  214. /package/lib/{shared → tasks/shared}/repos.js +0 -0
  215. /package/lib/{shared → tasks/shared}/scopeView.js +0 -0
  216. /package/lib/{shared → tasks/shared}/tags.js +0 -0
  217. /package/lib/{shared → tasks/shared}/taskBlock.js +0 -0
  218. /package/lib/{shared → tasks/shared}/types.js +0 -0
  219. /package/lib/{shared → tasks/shared}/workTarget.js +0 -0
@@ -0,0 +1,445 @@
1
+ import { acceptanceStatus, evidenceBasisOf, EVIDENCE_BASIS_LABEL, EVIDENCE_BASIS_KINDS } from "../../requirements/shared/acceptance.js";
2
+ import { firstCompletion } from "../../records/shared/completionRecord.js";
3
+ import { median } from "../shared/metrics.js";
4
+ import { REWORK_CAUSE_LABEL, REWORK_CAUSES, reworkPerRev } from "../../records/shared/reworkHistory.js";
5
+ /**
6
+ * タスクの完了したレビューから集計に使う1件を選ぶ(一覧は core/taskReview/store.ts の list)。完了時刻(finishedAt)の新しいもの、
7
+ * 同時刻なら run ID の大きいもの。読めない run(どれが最新か分からない)・完了時刻の無い完了の run があれば欠損にする
8
+ */
9
+ export function selectTaskReview(list) {
10
+ const broken = list.filter((x) => x.state === "broken");
11
+ if (broken.length)
12
+ return { state: "missing", reason: `読めないレビューの記録があります(${broken.map((b) => b.id).join(", ")})` };
13
+ const done = list.flatMap((x) => (x.state === "ok" && x.run.status === "completed" ? [x.run] : []));
14
+ if (!done.length)
15
+ return { state: "none" };
16
+ const noTime = done.filter((r) => !time(r.finishedAt));
17
+ if (noTime.length)
18
+ return { state: "missing", reason: `完了時刻の無い完了したレビューがあります(${noTime.map((r) => r.id).join(", ")})` };
19
+ const pick = [...done].sort((a, b) => time(b.finishedAt) - time(a.finishedAt) || (a.id < b.id ? 1 : a.id > b.id ? -1 : 0))[0];
20
+ return { state: "ok", run: pick.id };
21
+ }
22
+ // --- 要望の所要時間 ---------------------------------------------------------------
23
+ const HOUR = 3_600_000;
24
+ const time = (v) => {
25
+ if (!v)
26
+ return undefined;
27
+ const t = Date.parse(v);
28
+ // 読めない日時と、作成日時が無いときに読み込みが入れる 1970-01-01 は記録なし
29
+ return Number.isNaN(t) || t <= 0 ? undefined : t;
30
+ };
31
+ const round = (n, digits = 2) => Math.round(n * 10 ** digits) / 10 ** digits;
32
+ /**
33
+ * 要望が対応済・完了済に最初に到達するまでの時間。完了の記録(completionRecords)の最初の該当する記録の日時から作成日時を引く。
34
+ * - 記録が読めない・日時が読めない・作成日時より前(逆転) → 欠損
35
+ * - 今の状態から到達済みと分かる(対応済なのに対応済の記録が無い・完了済なのに完了済の記録が無い) → 欠損(記録を始める前のデータ)
36
+ * - 対応済: 完了済の記録はあるが対応済の記録が無い → 対応済を経ずに完了済にした(未到達。0 時間ではない)
37
+ * - 対応済: 完了済で記録が1つも無い → 到達したか分からない(欠損)
38
+ */
39
+ function reachOf(r, trigger) {
40
+ if (r.completionProblems?.length)
41
+ return { kind: "missing", reason: `完了の記録が読めません(${r.completionProblems.join(" / ")})` };
42
+ const records = r.completionRecords ?? [];
43
+ const first = firstCompletion(records, trigger);
44
+ if (first) {
45
+ const at = time(first.at);
46
+ const created = time(r.createdAt);
47
+ if (at === undefined)
48
+ return { kind: "missing", reason: `${first.id} の日時が読めません` };
49
+ if (created === undefined)
50
+ return { kind: "missing", reason: "要望の作成日時が無い・読めません" };
51
+ if (at < created)
52
+ return { kind: "missing", reason: `${first.id} の日時が作成日時より前です(日時の逆転)` };
53
+ return { kind: "reached", hours: (at - created) / HOUR };
54
+ }
55
+ if (trigger === "request_resolved") {
56
+ if (r.status === "resolved")
57
+ return { kind: "missing", reason: "対応済ですが対応済の記録がありません(記録を始める前のデータ)" };
58
+ if (r.status === "done") {
59
+ if (firstCompletion(records, "request_done"))
60
+ return { kind: "not_reached" };
61
+ return { kind: "missing", reason: "完了済ですが記録が無く、対応済を経たか分かりません", unknown: true };
62
+ }
63
+ return { kind: "not_reached" };
64
+ }
65
+ if (r.status === "done")
66
+ return { kind: "missing", reason: "完了済ですが完了済の記録がありません(記録を始める前のデータ)" };
67
+ return { kind: "not_reached" };
68
+ }
69
+ function durationMetric(trigger) {
70
+ return (input) => {
71
+ const hours = [];
72
+ const missingItems = [];
73
+ let notReached = 0;
74
+ let unknown = 0;
75
+ for (const { request: r } of input.requests) {
76
+ const reach = reachOf(r, trigger);
77
+ if (reach.kind === "reached")
78
+ hours.push(reach.hours);
79
+ else if (reach.kind === "not_reached")
80
+ notReached += 1;
81
+ else {
82
+ missingItems.push({ target: r.id, reason: reach.reason });
83
+ if (reach.unknown)
84
+ unknown += 1;
85
+ }
86
+ }
87
+ const m = median(hours);
88
+ const targets = input.requests.length;
89
+ const state = m !== undefined ? "ok" : !targets ? "no_targets" : missingItems.length ? "no_data" : "not_reached";
90
+ const breakdown = [
91
+ { key: "reached", label: "到達した", count: hours.length },
92
+ { key: "not_reached", label: trigger === "request_resolved" ? "未到達(対応済を経ずに完了済を含む)" : "未到達", count: notReached },
93
+ { key: "missing", label: "記録の欠損", count: missingItems.length - unknown },
94
+ ...(trigger === "request_resolved" ? [{ key: "unknown", label: "履歴が無く到達したか分からない", count: unknown }] : []),
95
+ ];
96
+ return { state, value: m === undefined ? null : round(m), targets, observed: hours.length, missing: missingItems.length, breakdown, missingItems };
97
+ };
98
+ }
99
+ /**
100
+ * 基準の集計を材料ごとに1回だけ行う(5つの基準の指標が同じ結果を使う)。材料(MetricsInput)はレポートごとに作るので、
101
+ * 集計もそのレポートの中だけで使われ、材料が要らなくなれば一緒に消える(WeakMap)
102
+ */
103
+ const criteriaCounts = new WeakMap();
104
+ function sharedCriteria(input) {
105
+ let c = criteriaCounts.get(input);
106
+ if (!c)
107
+ criteriaCounts.set(input, (c = countCriteria(input)));
108
+ return c;
109
+ }
110
+ /** 今完了しているタスクの、今の基準と保存された証拠の照合(shared/acceptance.ts の acceptanceStatus) */
111
+ function countCriteria(input) {
112
+ const c = {
113
+ tasks: 0,
114
+ counted: 0,
115
+ noCriteria: 0,
116
+ total: 0,
117
+ byState: { met: 0, unmet: 0, unverified: 0, missing: 0, stale: 0 },
118
+ metByBasis: Object.fromEntries(EVIDENCE_BASIS_KINDS.map((k) => [k, 0])),
119
+ missingItems: [],
120
+ };
121
+ for (const { request, tasks, brokenTasks } of input.requests) {
122
+ // 読めないタスクは完了しているか分からないので、対象の外の欠損として知らせる
123
+ for (const id of brokenTasks)
124
+ c.missingItems.push({ target: `${request.id}/${id}`, reason: "タスクのファイルが読めません(完了しているか分かりません)" });
125
+ for (const t of tasks) {
126
+ if (t.status !== "done")
127
+ continue;
128
+ c.tasks += 1;
129
+ if (t.acceptanceProblems?.length) {
130
+ c.missingItems.push({ target: t.ref, reason: `受け入れ基準・証拠が読めません(${t.acceptanceProblems.join(" / ")})` });
131
+ continue;
132
+ }
133
+ const s = acceptanceStatus(t);
134
+ if (!s?.total) {
135
+ c.noCriteria += 1;
136
+ continue;
137
+ }
138
+ c.counted += 1;
139
+ c.total += s.total;
140
+ for (const i of s.items) {
141
+ c.byState[i.state] += 1;
142
+ if (i.state === "met" && i.evidence)
143
+ c.metByBasis[evidenceBasisOf(i.evidence).basis.kind] += 1;
144
+ }
145
+ }
146
+ }
147
+ return c;
148
+ }
149
+ const CRITERION_LABEL = {
150
+ met: "満たした(申告)",
151
+ unmet: "満たせなかった(未達)",
152
+ unverified: "未検証",
153
+ missing: "証拠なし",
154
+ stale: "基準を変えた後の再確認が必要",
155
+ };
156
+ function criteriaMetric(state) {
157
+ return (input) => {
158
+ const c = sharedCriteria(input);
159
+ const brokenTasks = c.missingItems.length;
160
+ const value = c.byState[state];
161
+ // 数えた基準が無いとき、欠損があれば「欠損で出せない」、無ければ「対象なし」(0 件とは言わない)
162
+ const st = c.total ? "ok" : brokenTasks ? "no_data" : "no_targets";
163
+ const breakdown = [
164
+ ...(state === "met"
165
+ ? EVIDENCE_BASIS_KINDS.filter((k) => k !== "unverified").map((k) => ({ key: `basis_${k}`, label: `根拠: ${EVIDENCE_BASIS_LABEL[k]}`, count: c.metByBasis[k] }))
166
+ : Object.keys(CRITERION_LABEL).map((k) => ({ key: k, label: CRITERION_LABEL[k], count: c.byState[k] }))),
167
+ { key: "tasks_counted", label: "基準を数えた完了タスク", count: c.counted },
168
+ { key: "tasks_no_criteria", label: "基準なしの完了タスク(対象なし)", count: c.noCriteria },
169
+ { key: "tasks_missing", label: "基準が読めない・読めないタスク(欠損)", count: brokenTasks },
170
+ ];
171
+ return { state: st, value: st === "ok" ? value : null, targets: c.tasks, observed: c.counted, missing: brokenTasks, denominator: c.total, breakdown, missingItems: c.missingItems };
172
+ };
173
+ }
174
+ // --- 手戻り -------------------------------------------------------------------
175
+ /**
176
+ * タスクの手戻りの履歴(reworkHistory)。履歴1件が1操作(済みの完了から戻した操作は、再開と済みの解除を示す1件)。同じタスクで同じ rev の
177
+ * 履歴が重なっていても同じ書き込みなので1件に数える。履歴の無いタスクは「手戻りの記録なし」で、履歴を始める前の手戻りは分からない
178
+ */
179
+ function reworkMetric(input) {
180
+ let targets = 0;
181
+ let entries = 0;
182
+ let withRework = 0;
183
+ let without = 0;
184
+ const byCause = Object.fromEntries(REWORK_CAUSES.map((c) => [c, 0]));
185
+ const missingItems = [];
186
+ for (const { request, tasks, brokenTasks } of input.requests) {
187
+ targets += brokenTasks.length;
188
+ for (const id of brokenTasks)
189
+ missingItems.push({ target: `${request.id}/${id}`, reason: "タスクのファイルが読めません" });
190
+ for (const t of tasks) {
191
+ targets += 1;
192
+ if (t.reworkProblems?.length) {
193
+ missingItems.push({ target: t.ref, reason: `手戻りの履歴が読めません(${t.reworkProblems.join(" / ")})` });
194
+ continue;
195
+ }
196
+ const list = reworkPerRev(t.reworkHistory);
197
+ if (!list.length)
198
+ without += 1;
199
+ else
200
+ withRework += 1;
201
+ entries += list.length;
202
+ for (const e of list)
203
+ byCause[e.cause] += 1;
204
+ }
205
+ }
206
+ const observed = withRework + without;
207
+ const state = observed ? "ok" : missingItems.length ? "no_data" : "no_targets";
208
+ return {
209
+ state,
210
+ value: state === "ok" ? entries : null,
211
+ targets,
212
+ observed,
213
+ missing: missingItems.length,
214
+ breakdown: [
215
+ ...REWORK_CAUSES.map((c) => ({ key: `cause_${c}`, label: `契機: ${REWORK_CAUSE_LABEL[c]}`, count: byCause[c] })),
216
+ { key: "tasks_with_rework", label: "手戻りのあったタスク", count: withRework },
217
+ { key: "tasks_without_history", label: "手戻りの記録が無いタスク", count: without },
218
+ { key: "tasks_missing", label: "履歴・ファイルが読めないタスク(欠損)", count: missingItems.length },
219
+ ],
220
+ missingItems,
221
+ };
222
+ }
223
+ // --- タスクの AI レビュー -----------------------------------------------------------
224
+ /** 今完了しているタスクの、選んだレビューの結果からの件数。レビュー時点の所見(今のコードの状態ではない) */
225
+ function reviewMetric(pick) {
226
+ return (input) => {
227
+ let targets = 0;
228
+ let reviewed = 0;
229
+ let none = 0;
230
+ let zero = 0;
231
+ let value = 0;
232
+ let undetermined = 0;
233
+ let checks = 0;
234
+ const missingItems = [];
235
+ for (const { request, tasks, reviews } of input.requests) {
236
+ for (const t of tasks) {
237
+ if (t.status !== "done")
238
+ continue;
239
+ targets += 1;
240
+ const o = reviews[t.id] ?? { state: "none" };
241
+ if (o.state === "none")
242
+ none += 1;
243
+ else if (o.state === "missing")
244
+ missingItems.push({ target: `${request.id}/${t.id}`, reason: o.reason });
245
+ else {
246
+ reviewed += 1;
247
+ const n = pick(o.result);
248
+ value += n;
249
+ if (!n)
250
+ zero += 1;
251
+ undetermined += o.result.items.filter((i) => i.verdict === "undetermined").length;
252
+ checks += o.result.checks.length;
253
+ }
254
+ }
255
+ }
256
+ const state = reviewed ? "ok" : !targets ? "no_targets" : missingItems.length ? "no_data" : "unrecorded";
257
+ return {
258
+ state,
259
+ value: state === "ok" ? value : null,
260
+ targets,
261
+ observed: reviewed,
262
+ missing: missingItems.length,
263
+ breakdown: [
264
+ { key: "tasks_reviewed", label: "レビュー済みの完了タスク", count: reviewed },
265
+ { key: "tasks_zero", label: "うち所見が 0 件", count: zero },
266
+ { key: "tasks_not_reviewed", label: "レビューの無い完了タスク", count: none },
267
+ { key: "tasks_missing", label: "レビューの記録が読めない・選べない(欠損)", count: missingItems.length },
268
+ { key: "undetermined", label: "判断できない基準(数に入れない)", count: undetermined },
269
+ { key: "checks", label: "人が確かめる点(数に入れない)", count: checks },
270
+ ],
271
+ missingItems,
272
+ };
273
+ };
274
+ }
275
+ const REVIEW_SOURCE = "今完了しているタスクの AI レビュー(requests/<要望>/task-reviews/)の、完了した最新の1回の結果";
276
+ const REVIEW_TARGET = "範囲の要望の直下で今完了しているタスク(レビューの無いタスクも対象に数える)";
277
+ const REVIEW_MISSING = "読めないレビューの記録・完了時刻の無い完了の run があるタスクは、どれを使うか決められないので欠損。レビューの無いタスクは「記録なし」で 0 件にしない";
278
+ // --- 人が記録した値 ---------------------------------------------------------------
279
+ /** 範囲と一致する人の記録を、期間・単位ごとに1行ずつ出す(合算しない)。値は1行のときだけ value にも入れる */
280
+ function manualMetric(id) {
281
+ return (input) => {
282
+ if (input.manual.problem) {
283
+ return { state: "no_data", value: null, targets: 0, observed: 0, missing: 1, breakdown: [], missingItems: [{ target: "metrics/manual.json", reason: input.manual.problem }], rows: [] };
284
+ }
285
+ const rows = input.manual.records
286
+ .filter((r) => r.metric === id)
287
+ .sort((a, b) => a.from.localeCompare(b.from) || a.to.localeCompare(b.to) || a.unit.localeCompare(b.unit))
288
+ .map(({ metric: _m, scope: _s, ...row }) => row);
289
+ const units = [...new Set(rows.map((r) => r.unit))];
290
+ return {
291
+ state: rows.length ? "ok" : "unrecorded",
292
+ value: rows.length === 1 ? rows[0].value : null,
293
+ targets: rows.length,
294
+ observed: rows.length,
295
+ missing: 0,
296
+ breakdown: units.map((u) => ({ key: `unit_${u}`, label: `単位 ${u} の記録`, count: rows.filter((r) => r.unit === u).length })),
297
+ missingItems: [],
298
+ rows,
299
+ };
300
+ };
301
+ }
302
+ const MANUAL_TARGET = "この範囲(プロジェクト全体・マイルストーン)に記録した値だけ。範囲の間は合算しない(マイルストーンの記録は全体に足さない)";
303
+ const MANUAL_MISSING = "記録が無ければ「記録なし」で 0 にしない。値 0 の記録は 0。記録のファイルが読めなければ欠損";
304
+ const CRITERIA_SOURCE = "完了しているタスクの受け入れ基準(acceptanceCriteria)と証拠(acceptanceEvidence)";
305
+ const CRITERIA_TARGET = "範囲の要望の直下で今完了しているタスク。基準なしのタスクは対象なし";
306
+ const CRITERIA_MISSING = "基準・証拠が読めないタスクと読めないタスクのファイルは欠損(分母に入れない)。対応する基準の無い証拠は分母の外";
307
+ /** 指標の定義(この順に出す) */
308
+ export const METRIC_DEFINITIONS = [
309
+ {
310
+ id: "request_to_resolved",
311
+ label: "要望の作成から対応済まで",
312
+ unit: "hours",
313
+ kind: "record",
314
+ source: "要望の作成日時(createdAt)と完了の記録(completionRecords)の最初の対応済(request_resolved)",
315
+ target: "範囲の要望(見送り・アーカイブを除く。親子の要望もそれぞれ1件)",
316
+ method: "到達した要望の経過時間の中央値(時間)。到達していない要望は数えない",
317
+ missingRule: "記録・日時が読めない、日時の逆転、対応済なのに記録が無い要望は欠損。完了済への直接の遷移は未到達で、0 時間にしない",
318
+ compute: durationMetric("request_resolved"),
319
+ },
320
+ {
321
+ id: "request_to_done",
322
+ label: "要望の作成から完了済まで",
323
+ unit: "hours",
324
+ kind: "record",
325
+ source: "要望の作成日時(createdAt)と完了の記録(completionRecords)の最初の完了済(request_done)",
326
+ target: "範囲の要望(見送り・アーカイブを除く。親子の要望もそれぞれ1件)",
327
+ method: "到達した要望の経過時間の中央値(時間)。到達していない要望は数えない",
328
+ missingRule: "記録・日時が読めない、日時の逆転、完了済なのに記録が無い要望は欠損(updatedAt で推し量らない)",
329
+ compute: durationMetric("request_done"),
330
+ },
331
+ {
332
+ id: "acceptance_unmet",
333
+ label: "未達の受け入れ基準",
334
+ unit: "count",
335
+ kind: "record",
336
+ source: CRITERIA_SOURCE,
337
+ target: CRITERIA_TARGET,
338
+ method: "今の基準のうち、今の文言で「満たせなかった」と記録した基準の数。分母は数えた基準の合計",
339
+ missingRule: CRITERIA_MISSING,
340
+ compute: criteriaMetric("unmet"),
341
+ },
342
+ {
343
+ id: "acceptance_unverified",
344
+ label: "未検証の受け入れ基準",
345
+ unit: "count",
346
+ kind: "record",
347
+ source: CRITERIA_SOURCE,
348
+ target: CRITERIA_TARGET,
349
+ method: "今の基準のうち、今の文言で「未検証」と記録した基準の数。分母は数えた基準の合計",
350
+ missingRule: CRITERIA_MISSING,
351
+ compute: criteriaMetric("unverified"),
352
+ },
353
+ {
354
+ id: "acceptance_no_evidence",
355
+ label: "証拠なしの受け入れ基準",
356
+ unit: "count",
357
+ kind: "record",
358
+ source: CRITERIA_SOURCE,
359
+ target: CRITERIA_TARGET,
360
+ method: "今の基準のうち、証拠の無い基準の数。分母は数えた基準の合計",
361
+ missingRule: CRITERIA_MISSING,
362
+ compute: criteriaMetric("missing"),
363
+ },
364
+ {
365
+ id: "acceptance_stale",
366
+ label: "再確認が必要な受け入れ基準",
367
+ unit: "count",
368
+ kind: "record",
369
+ source: CRITERIA_SOURCE,
370
+ target: CRITERIA_TARGET,
371
+ method: "証拠を記録した後に基準の文言を変えた基準の数。分母は数えた基準の合計",
372
+ missingRule: CRITERIA_MISSING,
373
+ compute: criteriaMetric("stale"),
374
+ },
375
+ {
376
+ id: "acceptance_met",
377
+ label: "満たしたと申告した受け入れ基準",
378
+ unit: "count",
379
+ kind: "record",
380
+ source: CRITERIA_SOURCE,
381
+ target: CRITERIA_TARGET,
382
+ method: "今の基準のうち、今の文言で「満たした」と記録した基準の数(作業した側の申告で、確かめた数ではない)。内訳に根拠の種類(申告のみを含む)。分母は数えた基準の合計",
383
+ missingRule: CRITERIA_MISSING,
384
+ compute: criteriaMetric("met"),
385
+ },
386
+ {
387
+ id: "rework",
388
+ label: "手戻り",
389
+ unit: "count",
390
+ kind: "record",
391
+ source: "タスクの手戻りの履歴(reworkHistory。済みの解除・完了からの再開)",
392
+ target: "範囲の要望の直下のタスク(状態を問わない)",
393
+ method: "観測できた手戻りの件数(タスクと履歴 ID の組。1操作1件)。内訳に契機と、手戻りのあったタスク・記録の無いタスク。履歴を始める前の手戻りは含まれず、全期間の完全さは保証しない",
394
+ missingRule: "手戻りの履歴が読めないタスクと読めないタスクのファイルは欠損。履歴の無いタスクは記録なしとして内訳に出す",
395
+ compute: reworkMetric,
396
+ },
397
+ {
398
+ id: "review_missing",
399
+ label: "AI レビューの未達判定",
400
+ unit: "count",
401
+ kind: "record",
402
+ source: REVIEW_SOURCE,
403
+ target: REVIEW_TARGET,
404
+ method: "選んだ結果の基準ごとの判定のうち「不足」(missing)の件数の合計。判断できない・人が確かめる点は数に入れない。レビュー時点の所見",
405
+ missingRule: REVIEW_MISSING,
406
+ compute: reviewMetric((r) => r.items.filter((i) => i.verdict === "missing").length),
407
+ },
408
+ {
409
+ id: "review_unplanned",
410
+ label: "AI レビューの意図しない変更の候補",
411
+ unit: "count",
412
+ kind: "record",
413
+ source: REVIEW_SOURCE,
414
+ target: REVIEW_TARGET,
415
+ method: "選んだ結果の意図しない変更の候補(unplanned)の件数の合計。レビュー時点の所見",
416
+ missingRule: REVIEW_MISSING,
417
+ compute: reviewMetric((r) => r.unplanned.length),
418
+ },
419
+ {
420
+ id: "cost",
421
+ label: "費用",
422
+ unit: "amount",
423
+ kind: "manual",
424
+ manual: { value: "amount", unit: "currency" },
425
+ source: "人が記録した値(人の工数・AI の利用料・インフラの費用など。出典つき)",
426
+ target: MANUAL_TARGET,
427
+ method: "観測期間と通貨ごとに記録した金額をそのまま出す。通貨・期間の違う値は別の行で、1つに合算しない",
428
+ missingRule: MANUAL_MISSING,
429
+ recordHint: "p3 metrics record cost <金額> --unit JPY --from YYYY-MM-DD --to YYYY-MM-DD --source 出典 [--milestone ID] [--note メモ](訂正は --rev 版)",
430
+ compute: manualMetric("cost"),
431
+ },
432
+ {
433
+ id: "post_release_defects",
434
+ label: "リリース後の不具合",
435
+ unit: "count",
436
+ kind: "manual",
437
+ manual: { value: "integer", unit: "件" },
438
+ source: "人が記録した値(リリース後に見つかった不具合の件数。出典つき)",
439
+ target: MANUAL_TARGET,
440
+ method: "観測期間ごとに記録した件数(0 以上の整数)をそのまま出す。期間の違う値は別の行で、合算しない",
441
+ missingRule: MANUAL_MISSING,
442
+ recordHint: "p3 metrics record post_release_defects <件数> --from YYYY-MM-DD --to YYYY-MM-DD --source 出典 [--milestone ID] [--note メモ](訂正は --rev 版)",
443
+ compute: manualMetric("post_release_defects"),
444
+ },
445
+ ];
@@ -0,0 +1,112 @@
1
+ import { MetricsError } from "../shared/metrics.js";
2
+ import { METRIC_DEFINITIONS, selectTaskReview } from "./definitions.js";
3
+ import { readManual } from "./manual.js";
4
+ /**
5
+ * 開発の指標の集計(定義は definitions.ts)。CLI の p3 metrics と API の GET /api/metrics が同じこれを使う。
6
+ *
7
+ * - 範囲: プロジェクト全体はマイルストーンなし・登録に無いマイルストーンの要望も含む。マイルストーンは project.yaml に登録済みのものだけで、
8
+ * 要望の今の milestone が一致する要望(直接の所属)。どちらも見送り・アーカイブの要望は除く
9
+ * - 読めない要望のファイルは所属が分からないので、全体の知らせ(notices)にする
10
+ * - 読むだけで何も書かない
11
+ */
12
+ export function metricScopes(ctx) {
13
+ return [{ scope: { kind: "project" }, label: "プロジェクト全体" }, ...ctx.ws.project.milestones.map((m) => ({ scope: { kind: "milestone", id: m.id }, label: `${m.id} ${m.title}`.trim() }))];
14
+ }
15
+ /** CLI・API の入力(マイルストーン ID。省けばプロジェクト全体)から範囲を決める */
16
+ export function metricScopeOf(ctx, milestone) {
17
+ if (milestone === undefined || milestone === "")
18
+ return { kind: "project" };
19
+ if (!ctx.ws.project.milestones.some((m) => m.id === milestone)) {
20
+ throw new MetricsError(`マイルストーン ${milestone} は登録されていません(p3 milestone ls で確かめてください)`);
21
+ }
22
+ return { kind: "milestone", id: milestone };
23
+ }
24
+ /** 1回のレポートで同時に読む完了タスクのレビューの数の上限(要望をまたいでレポート全体で数える) */
25
+ export const REVIEW_READ_CONCURRENCY = 8;
26
+ /** 同時に動かす数を n までにする(待っているものは来た順に始める。終わったものの枠をそのまま次に渡す) */
27
+ function limiter(n) {
28
+ let running = 0;
29
+ const waiting = [];
30
+ return async (fn) => {
31
+ if (running < n)
32
+ running += 1;
33
+ else
34
+ await new Promise((go) => waiting.push(go));
35
+ try {
36
+ return await fn();
37
+ }
38
+ finally {
39
+ const next = waiting.shift();
40
+ if (next)
41
+ next();
42
+ else
43
+ running -= 1;
44
+ }
45
+ };
46
+ }
47
+ /**
48
+ * 今完了しているタスクのレビューを、selectTaskReview の規則で1件選んで読む(読むだけ)。タスクごとに一覧・選択・結果の取得を
49
+ * limit の中で並行に行い、結果はタスク ID に結ぶ(読み終わった順に関係なく、集計は要望・タスクの順で読む)
50
+ */
51
+ async function reviewsOf(ctx, rid, tasks, limit) {
52
+ const one = async (key) => {
53
+ try {
54
+ const sel = selectTaskReview(await ctx.ws.taskReviews.list(key));
55
+ if (sel.state !== "ok")
56
+ return sel;
57
+ const rec = await ctx.ws.taskReviews.get(key, sel.run);
58
+ return rec.result ? { state: "ok", run: sel.run, result: rec.result } : { state: "missing", reason: `${sel.run} の結果がありません` };
59
+ }
60
+ catch (e) {
61
+ return { state: "missing", reason: `レビューの記録が読めません: ${e.message}` };
62
+ }
63
+ };
64
+ const done = tasks.filter((t) => t.status === "done");
65
+ const results = await Promise.all(done.map((t) => limit(() => one(`${rid}/${t.id}`))));
66
+ return Object.fromEntries(done.map((t, i) => [t.id, results[i]]));
67
+ }
68
+ export async function metricsInput(ctx, scope, manual) {
69
+ const m = manual ?? (await readManual(ctx.ws.dataDir));
70
+ const scopeKey = scope.kind === "project" ? "project" : scope.id;
71
+ const requests = ctx.ws.requests
72
+ .list()
73
+ .filter((r) => r.status !== "rejected" && (scope.kind === "project" || r.milestone === scope.id))
74
+ .sort((a, b) => a.id.localeCompare(b.id));
75
+ // レビューの読み取りの上限は、このレポートの全部の要望で1つ
76
+ const limit = limiter(REVIEW_READ_CONCURRENCY);
77
+ return {
78
+ requests: await Promise.all(requests.map(async (request) => {
79
+ const col = ctx.ws.tasksOf(request.id);
80
+ const tasks = col.list();
81
+ return { request, tasks, brokenTasks: [...col.errors.keys()].sort(), reviews: await reviewsOf(ctx, request.id, tasks, limit) };
82
+ })),
83
+ manual: { records: m.records.filter((r) => r.scope === scopeKey), ...(m.problem ? { problem: m.problem } : {}) },
84
+ };
85
+ }
86
+ export async function metricsReport(ctx, scope = { kind: "project" }) {
87
+ const manual = await readManual(ctx.ws.dataDir);
88
+ const input = await metricsInput(ctx, scope, manual);
89
+ const notices = [...ctx.ws.requests.errors.entries()].map(([id, e]) => ({
90
+ code: "broken_request",
91
+ target: `requests/${id}/request.md`,
92
+ message: `要望のファイルが読めないため、範囲に入るか分からず数えていません: ${e}`,
93
+ }));
94
+ if (manual.problem)
95
+ notices.push({ code: "manual_unreadable", target: "metrics/manual.json", message: manual.problem });
96
+ const known = new Set(ctx.ws.project.milestones.map((x) => x.id));
97
+ for (const r of manual.records.filter((x) => x.scope !== "project" && !known.has(x.scope))) {
98
+ notices.push({ code: "manual_orphan", target: r.id, message: `${r.id}(${r.metric}・${r.from}〜${r.to})のマイルストーン ${r.scope} が登録にありません(project.yaml を直接直して消えた? マイルストーンを戻すか p3 metrics rm ${r.id})` });
99
+ }
100
+ const m = scope.kind === "milestone" ? ctx.ws.project.milestones.find((x) => x.id === scope.id) : undefined;
101
+ return {
102
+ scope,
103
+ scopeLabel: scope.kind === "project" ? "プロジェクト全体" : `${scope.id} ${m?.title ?? ""}`.trim(),
104
+ scopeRule: scope.kind === "project"
105
+ ? "すべての要望(マイルストーンなしを含む)。見送り・アーカイブは除く"
106
+ : `マイルストーン ${scope.id} に今直接属する要望。見送り・アーカイブは除く(親子が別のマイルストーンならそれぞれの所属で数える)`,
107
+ generatedAt: new Date().toISOString(),
108
+ metrics: METRIC_DEFINITIONS.map(({ compute, manual: _manual, ...def }) => ({ ...def, ...compute(input) })),
109
+ notices,
110
+ scopes: metricScopes(ctx),
111
+ };
112
+ }