@infodb/p3 0.11.0 → 0.13.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 (138) hide show
  1. package/README.md +33 -33
  2. package/dist/web/assets/CompletionReview-gZKZrDu_.js +1 -0
  3. package/dist/web/assets/ImprovementDialog-Dno6dPnG.js +1 -0
  4. package/dist/web/assets/Outputs-BgHalMGb.js +1 -0
  5. package/dist/web/assets/RequestStatus-hZcBUUIu.js +1 -0
  6. package/dist/web/assets/Tabs-C3NmwCc3.js +1 -0
  7. package/dist/web/assets/TagInput-B2b862qn.js +1 -0
  8. package/dist/web/assets/TaskDrawer-4BQBELXa.js +6 -0
  9. package/dist/web/assets/_requestId-BMAG1t3o.js +1 -0
  10. package/dist/web/assets/_requestId-tbg2pA2S.js +1 -0
  11. package/dist/web/assets/archive-DMl6WyOe.js +1 -0
  12. package/dist/web/assets/board-BMTcHKyt.js +1 -0
  13. package/dist/web/assets/done-CL6Nlsua.js +1 -0
  14. package/dist/web/assets/draft-BvGxfD7v.js +2 -0
  15. package/dist/web/assets/index-Dp7Fc4VI.css +2 -0
  16. package/dist/web/assets/index-KdlgMitg.js +12 -0
  17. package/dist/web/assets/metrics-Cu7gJ7Rk.js +1 -0
  18. package/dist/web/assets/new-DTXWHuFO.js +1 -0
  19. package/dist/web/assets/outputs-CXqnjSqV.js +1 -0
  20. package/dist/web/assets/preflightInput-ClKwkp8R.js +2 -0
  21. package/dist/web/assets/preload-helper-oLCrNCwz.js +1 -0
  22. package/dist/web/assets/quality-RFd-7k3r.js +1 -0
  23. package/dist/web/assets/release-notes-Bpdi6RdY.js +5 -0
  24. package/dist/web/assets/requestData-CbFxwW5w.js +1 -0
  25. package/dist/web/assets/routes-BIt8bExF.js +6 -0
  26. package/dist/web/assets/settings-CsCqF_1B.js +1 -0
  27. package/dist/web/assets/taskReview-_WCgnQit.js +1 -0
  28. package/dist/web/assets/ui-BGK72r3u.js +1 -0
  29. package/dist/web/assets/workTarget-CySfKyfB.js +30 -0
  30. package/dist/web/index.html +4 -4
  31. package/docs/architecture.md +610 -33
  32. package/docs/development.md +61 -17
  33. package/docs/how-to-use.md +554 -17
  34. package/docs/installation.md +235 -144
  35. package/docs/publishing.md +1 -1
  36. package/lib/cli/agentsStatus.js +197 -0
  37. package/lib/cli/args.js +111 -2
  38. package/lib/cli/guide.js +27 -0
  39. package/lib/cli/guide.md +214 -0
  40. package/lib/cli/help.js +74 -1
  41. package/lib/cli/main.js +97 -17
  42. package/lib/cli/metricsCommands.js +77 -0
  43. package/lib/cli/output.js +19 -1
  44. package/lib/cli/preflightCommands.js +7 -1
  45. package/lib/cli/project.js +13 -24
  46. package/lib/cli/qualityCommands.js +188 -0
  47. package/lib/cli/readOnly.js +17 -0
  48. package/lib/cli/requestCommands.js +33 -4
  49. package/lib/cli/requirementCommands.js +288 -0
  50. package/lib/cli/retroCommands.js +106 -0
  51. package/lib/cli/revisitCommands.js +73 -0
  52. package/lib/cli/showView.js +183 -4
  53. package/lib/cli/taskCommands.js +341 -20
  54. package/lib/cli/taskReviewCommands.js +178 -0
  55. package/lib/cli/userConfig.js +47 -0
  56. package/lib/core/completionRefs.js +46 -0
  57. package/lib/core/context.js +4 -1
  58. package/lib/core/metrics/definitions.js +434 -0
  59. package/lib/core/metrics/index.js +88 -0
  60. package/lib/core/metrics/manual.js +180 -0
  61. package/lib/core/milestoneReview/material.js +11 -1
  62. package/lib/core/milestoneReview/mockReviewer.js +1 -0
  63. package/lib/core/milestoneReview/review.js +70 -6
  64. package/lib/core/milestoneReview/service.js +29 -93
  65. package/lib/core/milestoneReview/store.js +12 -62
  66. package/lib/core/ops.js +23 -3
  67. package/lib/core/preflight/carryover.js +6 -2
  68. package/lib/core/preflight/codexEngine.js +34 -17
  69. package/lib/core/preflight/diagnose.js +4 -9
  70. package/lib/core/preflight/engine.js +15 -0
  71. package/lib/core/preflight/hostPaths.js +260 -0
  72. package/lib/core/preflight/input.js +33 -5
  73. package/lib/core/preflight/instructions.js +36 -2
  74. package/lib/core/preflight/mockEngine.js +24 -2
  75. package/lib/core/preflight/render.js +22 -3
  76. package/lib/core/preflight/service.js +99 -8
  77. package/lib/core/preflight/uiRender.js +3 -0
  78. package/lib/core/projectRegistry.js +3 -3
  79. package/lib/core/quality.js +21 -0
  80. package/lib/core/qualityImprovement.js +221 -0
  81. package/lib/core/requestOps.js +294 -11
  82. package/lib/core/retrospective.js +208 -0
  83. package/lib/core/reviewCandidates.js +56 -0
  84. package/lib/core/reviewRuns.js +205 -0
  85. package/lib/core/store/archivedTasks.js +74 -0
  86. package/lib/core/store/collection.js +32 -3
  87. package/lib/core/store/normalize.js +35 -2
  88. package/lib/core/store/preflightStore.js +23 -1
  89. package/lib/core/store/projectFile.js +10 -0
  90. package/lib/core/store/workspace.js +49 -3
  91. package/lib/core/taskReview/material.js +459 -0
  92. package/lib/core/taskReview/mockReviewer.js +30 -0
  93. package/lib/core/taskReview/paths.js +15 -0
  94. package/lib/core/taskReview/review.js +312 -0
  95. package/lib/core/taskReview/service.js +187 -0
  96. package/lib/core/taskReview/store.js +214 -0
  97. package/lib/server/api/manifest.js +104 -5
  98. package/lib/server/api/milestoneReviewRoutes.js +4 -3
  99. package/lib/server/api/routes.js +265 -17
  100. package/lib/server/api/taskReviewRoutes.js +66 -0
  101. package/lib/server/server.js +2 -2
  102. package/lib/shared/acceptance.js +618 -0
  103. package/lib/shared/completionRecord.js +327 -0
  104. package/lib/shared/metrics.js +42 -0
  105. package/lib/shared/milestoneReview.js +2 -1
  106. package/lib/shared/preflightInput.js +1 -1
  107. package/lib/shared/quality.js +391 -0
  108. package/lib/shared/qualityImprovement.js +1 -0
  109. package/lib/shared/qualityTemplates.js +31 -0
  110. package/lib/shared/requirementSource.js +635 -0
  111. package/lib/shared/retrospective.js +286 -0
  112. package/lib/shared/reviewCandidate.js +308 -0
  113. package/lib/shared/reworkHistory.js +81 -0
  114. package/lib/shared/taskBlock.js +142 -0
  115. package/lib/shared/taskReview.js +56 -0
  116. package/package.json +3 -2
  117. package/skills/p3/SKILL.md +9 -152
  118. package/dist/web/assets/Outputs-ddwte0jj.js +0 -1
  119. package/dist/web/assets/RequestStatus-Bg1OLbRc.js +0 -1
  120. package/dist/web/assets/Tabs-DTmggzgg.js +0 -1
  121. package/dist/web/assets/TagInput-BHAgjLP7.js +0 -1
  122. package/dist/web/assets/TaskDrawer-Dz_5c2NH.js +0 -3
  123. package/dist/web/assets/_requestId-D9-gtIcG.js +0 -1
  124. package/dist/web/assets/_requestId-DzCNYvqf.js +0 -30
  125. package/dist/web/assets/appCtx-Cm24VpAf.js +0 -1
  126. package/dist/web/assets/board-MCHcZ-PU.js +0 -1
  127. package/dist/web/assets/done-zq10Bt08.js +0 -1
  128. package/dist/web/assets/draft-CfJeyLOl.js +0 -1
  129. package/dist/web/assets/index-Ce0ndpne.js +0 -12
  130. package/dist/web/assets/index-D68mkSnw.css +0 -2
  131. package/dist/web/assets/new-9TKiNT4O.js +0 -1
  132. package/dist/web/assets/preflightInput-BAeEJYUK.js +0 -2
  133. package/dist/web/assets/preload-helper-FBLw7u7x.js +0 -1
  134. package/dist/web/assets/release-notes-hK5XezLW.js +0 -5
  135. package/dist/web/assets/requestData-BnN7mctX.js +0 -1
  136. package/dist/web/assets/routes-usHwrrA0.js +0 -3
  137. package/dist/web/assets/settings-BVZDnL6O.js +0 -1
  138. package/dist/web/assets/workTarget-Cijqq4yH.js +0 -1
@@ -0,0 +1,327 @@
1
+ import { readAcceptance } from "./acceptance.js";
2
+ import { qualityPlain, readQuality, standardsFor } from "./quality.js";
3
+ import { readRequirement, requestSubject } from "./requirementSource.js";
4
+ /**
5
+ * 完了の記録(完了・人の済み・対応済・完了済にしたときの条件の写し)の規則。CLI・API・画面で同じものを使う
6
+ * (保存は core/requestOps.ts の createTask / updateTask / updateRequest がこれで作る)。
7
+ *
8
+ * - タスク(task.md の completionRecords)と要望(request.md の completionRecords)に追記だけで持つ。状態と同じ rev の更新で書くので、
9
+ * 片方だけが保存されることはない。再開・済みの解除でも消さず、再完了・再確認で新しい記録を足す。同じ状態の再保存・成果物の追記では足さない
10
+ * - 契機は、タスクの完了(task_done)・人の済み(task_checked。人の最終確認で、AI の承認ではない)・要望の対応済(request_resolved)・
11
+ * 要望の完了済(request_done)。日時・保存した主体(by。アクターの名前)・書いた後の rev と状態を持つ
12
+ * - 写すもの: タスクは受け入れ基準(取り込んだ品質基準の版を含む)・証拠と根拠の種類・基準ごとの要求の根拠、要望の要求の根拠と確認履歴、
13
+ * 品質の状態・版・作業先に当てはまる項目と除外(完了したときの最新の値。取り込んだときの版は基準の quality に残る)。要望は題・本文の hash・
14
+ * 要求の根拠・品質の状態と版、完了の判定に使ったタスクと子の要望(ID・rev・状態・その時点の最新の記録 ID)
15
+ * - 参照先: 登録された参照先ごとに、取得した時点の HEAD のコミット・未コミットの変更の有無・取得時刻、取れなければ取れない理由
16
+ * (git でない・このマシンのパスなし・パスが無い・取得に失敗)。このマシンのパスは残さない。過去の Preflight の評価から推測して埋めない
17
+ * - 読めない条件(品質の設定・基準・根拠が壊れている)は problems として写し、完了は拒まない。記録の無い古いデータは補わず「記録なし」と読む
18
+ * - 複数のファイル(project.yaml・要望・タスク・参照先)を同じ瞬間に固定するものではない(それぞれ書く直前に読んだ値と取得時刻)
19
+ * - 直接編集で壊れた記録は黙って消さず completionProblems にし、関係のない更新ではファイルの元の値のまま書き戻す(keepRaw)。
20
+ * 壊れている間は新しい記録を足さない(完了は拒まず、足せなかったことを知らせる)
21
+ */
22
+ export const COMPLETION_TRIGGERS = ["task_done", "task_checked", "request_resolved", "request_done"];
23
+ const isTrigger = (v) => typeof v === "string" && COMPLETION_TRIGGERS.includes(v);
24
+ export const COMPLETION_TRIGGER_LABEL = {
25
+ task_done: "タスクの完了",
26
+ task_checked: "人の済み(人の最終確認)",
27
+ request_resolved: "要望の対応済",
28
+ request_done: "要望の完了済",
29
+ };
30
+ /** 参照先を取得した結果。ok: 取得できた / not_git: git のリポジトリでない / unregistered: このマシンのパスなし / missing: パスが無い / notdir: フォルダでない / failed: git の実行に失敗 */
31
+ export const REF_CAPTURE_STATES = ["ok", "not_git", "unregistered", "missing", "notdir", "failed"];
32
+ const isRefState = (v) => typeof v === "string" && REF_CAPTURE_STATES.includes(v);
33
+ export const REF_CAPTURE_LABEL = {
34
+ ok: "取得",
35
+ not_git: "git でない",
36
+ unregistered: "このマシンのパスなし",
37
+ missing: "パスが無い",
38
+ notdir: "フォルダでない",
39
+ failed: "取得に失敗",
40
+ };
41
+ /** ファイルに書く項目(壊れていたら元の値のまま書き戻す) */
42
+ export const COMPLETION_KEYS = ["completionRecords"];
43
+ export const COMPLETION_ID_RE = /^C\d+$/;
44
+ // --- 読む ---------------------------------------------------------------------
45
+ const str = (v) => (typeof v === "string" && v ? v : undefined);
46
+ const iso = (v) => (v instanceof Date ? v.toISOString() : str(v));
47
+ const int = (v) => (Number.isInteger(v) && v >= 0 ? v : undefined);
48
+ const obj = (v) => (v && typeof v === "object" && !Array.isArray(v) ? v : undefined);
49
+ const strList = (v) => (Array.isArray(v) && v.every((x) => typeof x === "string") ? v : undefined);
50
+ function readQualityCondition(v) {
51
+ const o = obj(v);
52
+ if (!o)
53
+ return "quality が読めません";
54
+ const state = o.state;
55
+ if (state !== "unset" && state !== "set" && state !== "invalid")
56
+ return "quality.state が読めません(unset / set / invalid)";
57
+ const version = typeof o.version === "string" ? o.version : undefined;
58
+ if (version === undefined)
59
+ return "quality.version がありません";
60
+ const out = { state, version };
61
+ if ("repo" in o)
62
+ out.repo = typeof o.repo === "string" && o.repo ? o.repo : null;
63
+ if (o.standards !== undefined) {
64
+ const q = readQuality({ standards: o.standards });
65
+ if (q.state !== "set")
66
+ return `quality.standards が読めません: ${q.state === "invalid" ? q.problems.join(" / ") : ""}`;
67
+ out.standards = q.config.standards;
68
+ }
69
+ if (o.problems !== undefined) {
70
+ const p = strList(o.problems);
71
+ if (!p)
72
+ return "quality.problems が読めません";
73
+ out.problems = p;
74
+ }
75
+ return out;
76
+ }
77
+ function readAcceptanceCondition(v) {
78
+ const o = obj(v);
79
+ if (!o)
80
+ return "acceptance が読めません";
81
+ if (o.problems !== undefined) {
82
+ const p = strList(o.problems);
83
+ return p ? { problems: p } : "acceptance.problems が読めません";
84
+ }
85
+ const a = readAcceptance({ acceptanceCriteria: o.criteria, acceptanceEvidence: o.evidence, acceptanceSources: o.sources });
86
+ if (a.acceptanceProblems?.length)
87
+ return `acceptance が読めません: ${a.acceptanceProblems.join(" / ")}`;
88
+ return {
89
+ ...(a.acceptanceCriteria?.length ? { criteria: a.acceptanceCriteria } : {}),
90
+ ...(a.acceptanceEvidence?.length ? { evidence: a.acceptanceEvidence } : {}),
91
+ ...(a.acceptanceSources?.length ? { sources: a.acceptanceSources } : {}),
92
+ };
93
+ }
94
+ function readRequirementCondition(v) {
95
+ const o = obj(v);
96
+ if (!o)
97
+ return "requirement が読めません";
98
+ if (o.problems !== undefined) {
99
+ const p = strList(o.problems);
100
+ return p ? { problems: p } : "requirement.problems が読めません";
101
+ }
102
+ const r = readRequirement({ requirementSources: o.sources });
103
+ if (r.requirementProblems?.length)
104
+ return `requirement が読めません: ${r.requirementProblems.join(" / ")}`;
105
+ return r.requirementSources?.length ? { sources: r.requirementSources } : {};
106
+ }
107
+ function readRefs(v) {
108
+ if (!Array.isArray(v))
109
+ return "refs が並びになっていません";
110
+ const out = [];
111
+ for (const raw of v) {
112
+ const o = obj(raw);
113
+ const name = str(o?.name);
114
+ const at = iso(o?.at);
115
+ if (!o || !name || !at || !isRefState(o.state))
116
+ return "refs の項目が読めません(name・state・at が要ります)";
117
+ if (o.commit !== undefined && !/^[0-9a-f]{7,64}$/.test(String(o.commit)))
118
+ return `refs の ${name} の commit が読めません`;
119
+ if (o.dirty !== undefined && typeof o.dirty !== "boolean")
120
+ return `refs の ${name} の dirty が読めません`;
121
+ out.push({ name, state: o.state, ...(o.commit !== undefined ? { commit: String(o.commit) } : {}), ...(typeof o.dirty === "boolean" ? { dirty: o.dirty } : {}), at, ...(str(o.reason) ? { reason: str(o.reason) } : {}) });
122
+ }
123
+ return out;
124
+ }
125
+ function readParts(v, key) {
126
+ if (!Array.isArray(v))
127
+ return `${key} が並びになっていません`;
128
+ const out = [];
129
+ for (const raw of v) {
130
+ const o = obj(raw);
131
+ const id = str(o?.id);
132
+ const rev = int(o?.rev);
133
+ const status = str(o?.status);
134
+ if (!o || !id || rev === undefined || !status)
135
+ return `${key} の項目が読めません(id・rev・status が要ります)`;
136
+ if (o.record !== undefined && !COMPLETION_ID_RE.test(String(o.record)))
137
+ return `${key} の ${id} の record が読めません`;
138
+ out.push({ id, rev, status, ...(typeof o.checked === "boolean" ? { checked: o.checked } : {}), ...(o.record !== undefined ? { record: String(o.record) } : {}) });
139
+ }
140
+ return out;
141
+ }
142
+ function readRecord(raw, at) {
143
+ const o = obj(raw);
144
+ if (!o)
145
+ return `${at} が読めません`;
146
+ const id = str(o.id) ?? "";
147
+ const label = `${at}${id ? `(${id})` : ""}`;
148
+ if (!COMPLETION_ID_RE.test(id))
149
+ return `${label} の id が読めません(C1, C2, ...)`;
150
+ if (!isTrigger(o.trigger))
151
+ return `${label} の trigger が読めません(${COMPLETION_TRIGGERS.join(" / ")})`;
152
+ const when = iso(o.at);
153
+ if (!when)
154
+ return `${label} の at がありません`;
155
+ const rev = int(o.rev);
156
+ if (rev === undefined)
157
+ return `${label} の rev が読めません`;
158
+ const status = str(o.status);
159
+ if (!status)
160
+ return `${label} の status がありません`;
161
+ const quality = readQualityCondition(o.quality);
162
+ if (typeof quality === "string")
163
+ return `${label}: ${quality}`;
164
+ const rec = { id, trigger: o.trigger, at: when, ...(str(o.by) ? { by: str(o.by) } : {}), rev, status, ...(typeof o.checked === "boolean" ? { checked: o.checked } : {}), quality };
165
+ if (o.requirement !== undefined) {
166
+ const r = readRequirementCondition(o.requirement);
167
+ if (typeof r === "string")
168
+ return `${label}: ${r}`;
169
+ rec.requirement = r;
170
+ }
171
+ if (o.acceptance !== undefined) {
172
+ const a = readAcceptanceCondition(o.acceptance);
173
+ if (typeof a === "string")
174
+ return `${label}: ${a}`;
175
+ rec.acceptance = a;
176
+ }
177
+ if (o.title !== undefined)
178
+ rec.title = String(o.title);
179
+ if (o.subject !== undefined)
180
+ rec.subject = String(o.subject);
181
+ for (const key of ["tasks", "children"]) {
182
+ if (o[key] === undefined)
183
+ continue;
184
+ const p = readParts(o[key], key);
185
+ if (typeof p === "string")
186
+ return `${label}: ${p}`;
187
+ rec[key] = p;
188
+ }
189
+ if (o.refs !== undefined) {
190
+ const r = readRefs(o.refs);
191
+ if (typeof r === "string")
192
+ return `${label}: ${r}`;
193
+ rec.refs = r;
194
+ }
195
+ return rec;
196
+ }
197
+ /** frontmatter の completionRecords を読む。無ければ何も足さない(記録の無い古いデータはそのまま「記録なし」) */
198
+ export function readCompletion(d) {
199
+ if (d.completionRecords === undefined || d.completionRecords === null)
200
+ return {};
201
+ if (!Array.isArray(d.completionRecords))
202
+ return { completionProblems: ["completionRecords が並びになっていません"] };
203
+ const problems = [];
204
+ const list = [];
205
+ for (const [i, raw] of d.completionRecords.entries()) {
206
+ const r = readRecord(raw, `完了の記録 ${i + 1} 件目`);
207
+ if (typeof r === "string")
208
+ problems.push(r);
209
+ else if (list.some((x) => x.id === r.id))
210
+ problems.push(`完了の記録の id が重複しています: ${r.id}`);
211
+ else
212
+ list.push(r);
213
+ }
214
+ return { ...(list.length ? { completionRecords: list } : {}), ...(problems.length ? { completionProblems: problems } : {}) };
215
+ }
216
+ // --- 作る ---------------------------------------------------------------------
217
+ /** 次の記録の ID(消さないので最大の番号の次) */
218
+ export function nextCompletionId(list) {
219
+ const max = Math.max(0, ...(list ?? []).map((r) => Number(r.id.slice(1))));
220
+ return `C${max + 1}`;
221
+ }
222
+ /** 最新の記録(無ければ undefined) */
223
+ export const latestCompletion = (list) => list?.at(-1);
224
+ /**
225
+ * タスクの書く前(prev。作るときは無い)と書いた後(next)から、足す記録の契機を決める。
226
+ * acceptanceChanged: この更新で基準・証拠・基準の根拠の中身が変わった(済みのまま中身を変えて済みを付け直したら、新しい人の済みの記録にする)
227
+ */
228
+ export function taskTriggers(prev, next, acceptanceChanged) {
229
+ if (next.status !== "done")
230
+ return [];
231
+ const out = [];
232
+ const wasDone = prev?.status === "done";
233
+ if (!wasDone)
234
+ out.push("task_done");
235
+ if (next.checkedAt && (!wasDone || !prev?.checkedAt || acceptanceChanged))
236
+ out.push("task_checked");
237
+ return out;
238
+ }
239
+ /** 要望の状態の変化から、足す記録の契機を決める */
240
+ export function requestTriggers(prev, next) {
241
+ if (prev === next)
242
+ return [];
243
+ if (next === "resolved")
244
+ return ["request_resolved"];
245
+ if (next === "done")
246
+ return ["request_done"];
247
+ return [];
248
+ }
249
+ /** 品質の条件(タスクなら作業先に当てはまる項目と除外を写す) */
250
+ export function qualityCondition(state, version, task) {
251
+ const st = state ?? { state: "unset" };
252
+ const base = { state: st.state, version: version ?? "", ...(task ? { repo: task.repo } : {}) };
253
+ if (st.state === "invalid")
254
+ return { ...base, problems: [...st.problems] };
255
+ if (st.state !== "set" || !task)
256
+ return base;
257
+ const { applies, exempt } = standardsFor(st.config, task.repo);
258
+ const hit = st.config.standards.filter((s) => applies.includes(s) || exempt.includes(s));
259
+ // 書く形(qualityPlain)にそろえて写す(読み直しても同じ値になる)
260
+ return { ...base, standards: qualityPlain({ standards: hit }).standards.map((s) => structuredClone(s)) };
261
+ }
262
+ const requirementOf = (r) => {
263
+ if (!r)
264
+ return undefined;
265
+ if (r.requirementProblems?.length)
266
+ return { problems: [...r.requirementProblems] };
267
+ return r.requirementSources?.length ? { sources: structuredClone(r.requirementSources) } : undefined;
268
+ };
269
+ /** タスクの記録(task は書いた後の値。rev は書いた後の rev) */
270
+ export function taskCompletionRecord(id, trigger, task, rev, request, ctx) {
271
+ let acceptance;
272
+ if (task.acceptanceProblems?.length)
273
+ acceptance = { problems: [...task.acceptanceProblems] };
274
+ else if (task.acceptanceCriteria?.length || task.acceptanceEvidence?.length || task.acceptanceSources?.length) {
275
+ acceptance = {
276
+ ...(task.acceptanceCriteria?.length ? { criteria: structuredClone(task.acceptanceCriteria) } : {}),
277
+ ...(task.acceptanceEvidence?.length ? { evidence: structuredClone(task.acceptanceEvidence) } : {}),
278
+ ...(task.acceptanceSources?.length ? { sources: structuredClone(task.acceptanceSources) } : {}),
279
+ };
280
+ }
281
+ const requirement = requirementOf(request);
282
+ return {
283
+ id,
284
+ trigger,
285
+ at: ctx.at,
286
+ ...(ctx.by ? { by: ctx.by } : {}),
287
+ rev,
288
+ status: task.status,
289
+ checked: !!task.checkedAt,
290
+ quality: qualityCondition(ctx.quality, ctx.qualityVersion, task),
291
+ ...(requirement ? { requirement } : {}),
292
+ ...(acceptance ? { acceptance } : {}),
293
+ ...(ctx.refs ? { refs: structuredClone(ctx.refs) } : {}),
294
+ };
295
+ }
296
+ /** 要望の記録(request は書いた後の値。tasks・children は判定に使った配下) */
297
+ export function requestCompletionRecord(id, trigger, request, rev, parts, ctx) {
298
+ const requirement = requirementOf(request);
299
+ const part = (x) => {
300
+ const rec = latestCompletion(x.completionRecords);
301
+ return { id: x.id, rev: x.rev, status: x.status, ...(rec ? { record: rec.id } : {}) };
302
+ };
303
+ return {
304
+ id,
305
+ trigger,
306
+ at: ctx.at,
307
+ ...(ctx.by ? { by: ctx.by } : {}),
308
+ rev,
309
+ status: request.status,
310
+ quality: qualityCondition(ctx.quality, ctx.qualityVersion),
311
+ ...(requirement ? { requirement } : {}),
312
+ title: request.title,
313
+ subject: requestSubject(request),
314
+ tasks: parts.tasks.map((t) => ({ ...part(t), checked: !!t.checkedAt })),
315
+ children: parts.children.map(part),
316
+ ...(ctx.refs ? { refs: structuredClone(ctx.refs) } : {}),
317
+ };
318
+ }
319
+ /** 記録を足した値(壊れた記録があれば足さずに undefined) */
320
+ export function appendCompletion(cur, make) {
321
+ if (cur.completionProblems?.length)
322
+ return undefined;
323
+ const list = cur.completionRecords ?? [];
324
+ return [...list, make(nextCompletionId(list))];
325
+ }
326
+ /** 壊れた記録のため記録を足せなかったときの知らせ */
327
+ export const COMPLETION_SKIPPED = "完了の記録が読めないため、今回の記録は残していません(状態は変えました)。ファイルの completionRecords を直してください";
@@ -0,0 +1,42 @@
1
+ /**
2
+ * 開発の指標(記録から出す値と、人が記録する値)の型。CLI・API・画面で同じものを使う。
3
+ * 定義(何から・どう数えるか)と集計は core/metrics/definitions.ts の1か所にある(指標を足すときはそこに1件足す)。
4
+ *
5
+ * - 指標は改善の材料で、人や AI の成績の評価には使わない(個人・エージェントごとの値や順位は出さない)
6
+ * - 値の無い理由を数値の 0 と区別する: 対象なし(no_targets)・記録の欠損だけ(no_data)・まだ到達していない(not_reached)
7
+ * - 古い記録で欠けている値は欠損として数え、0 や推測(updatedAt など)で埋めない
8
+ */
9
+ export const METRIC_UNITS = ["hours", "count", "amount"];
10
+ /** amount は通貨ごとの金額(単位は記録ごとの通貨コード) */
11
+ export const METRIC_UNIT_LABEL = { hours: "時間", count: "件", amount: "金額" };
12
+ /**
13
+ * 値の状態。ok: 値あり / no_targets: 数える対象が無い / no_data: 対象はあるが記録が欠けて値を出せない /
14
+ * not_reached: 対象はあるがまだどれも到達していない(所要時間の指標) / unrecorded: 対象はあるが記録がまだ無い(レビューをしていない・値を記録していない)
15
+ */
16
+ export const METRIC_STATES = ["ok", "no_targets", "no_data", "not_reached", "unrecorded"];
17
+ export const METRIC_STATE_LABEL = {
18
+ ok: "値あり",
19
+ no_targets: "対象なし",
20
+ no_data: "記録の欠損で出せない",
21
+ not_reached: "まだ到達していない",
22
+ unrecorded: "記録なし",
23
+ };
24
+ /**
25
+ * metrics_invalid: 入力が規則に合わない(知らない指標・範囲・負の値・不正な期間など。CLI は 1、API は 400)/
26
+ * metrics_conflict: 読んだ版と違う・版を照らさない訂正(CLI は 3)/ metrics_unreadable: 記録のファイルが読めない(CLI は 1)。どれも何も書いていない
27
+ */
28
+ export class MetricsError extends Error {
29
+ code;
30
+ constructor(message, code = "metrics_invalid") {
31
+ super(message);
32
+ this.code = code;
33
+ }
34
+ }
35
+ /** 中央値(空なら undefined) */
36
+ export function median(values) {
37
+ if (!values.length)
38
+ return undefined;
39
+ const s = [...values].sort((a, b) => a - b);
40
+ const mid = Math.floor(s.length / 2);
41
+ return s.length % 2 ? s[mid] : (s[mid - 1] + s[mid]) / 2;
42
+ }
@@ -16,7 +16,8 @@ export const REVIEW_VERDICT_LABELS = {
16
16
  };
17
17
  /** 評価の範囲(結果と一緒に保存し、画面・CLI に出す) */
18
18
  export const REVIEW_SCOPE = "保存してあるマイルストーンの目的・予定機能に対して、参照先のリポジトリのコードと git の履歴(抽出のときの作業ツリー・タスクに残したコミット)を読み、" +
19
- "このマイルストーンに直接属する要望・タスクの記録を手がかりに確かめた結果です。テストやアプリを実際に動かしてはいません。公開されたかは確かめていません。" +
19
+ "このマイルストーンに直接属する要望・タスクの記録を手がかりに確かめた結果です。品質基準が設定してあれば、目的の達成とは別に品質基準への適合も確かめています(検査のコマンドは実行していません)。" +
20
+ "テストやアプリを実際に動かしてはいません。公開されたかは確かめていません。" +
20
21
  "成果物の URL や添付の中身は読んでいません。アーカイブした要望は含みません。";
21
22
  /** 読める参照先が無いときの評価の範囲(記録だけの点検で、実装は確かめていない) */
22
23
  export const REVIEW_SCOPE_RECORDS_ONLY = "読める参照先(リポジトリ)が無かったため、保存してあるマイルストーンの目的・予定機能と、直接属する要望・タスクの記録だけを比べた結果です。" +
@@ -12,7 +12,7 @@ export function normalizeInput(r) {
12
12
  }
13
13
  /** 保存すると同じになる本文か */
14
14
  export const sameText = (a, b) => normalizeText(a) === normalizeText(b);
15
- const FIELD_LABEL = { title: "タイトル", body: "本文", parent: "親の目的(題・本文)", children: "子の要望" };
15
+ const FIELD_LABEL = { title: "タイトル", body: "本文", parent: "親の目的(題・本文)", children: "子の要望", requirement: "要求の根拠・確認事項への回答" };
16
16
  /** 変わった項目の表示(「タイトルと本文」) */
17
17
  export const changedLabel = (fields) => (fields ?? []).map((k) => FIELD_LABEL[k]).join("と");
18
18
  /** この run からのタスク化が終わっている(途中で止まったものは含めない) */