@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,180 @@
1
+ import { readFile } from "node:fs/promises";
2
+ import { join } from "node:path";
3
+ import { MetricsError } from "../../shared/metrics.js";
4
+ import { withFileLock, writeFileAtomic } from "../store/fsutil.js";
5
+ import { METRIC_DEFINITIONS } from "./definitions.js";
6
+ /**
7
+ * 人が記録する指標の値(費用・リリース後の不具合など。記録から出せないもの)の保存。記録は CLI の p3 metrics record からだけ(API・画面は読むだけ)。
8
+ *
9
+ * <data>/metrics/manual.json {version: 1, seq, records: [...]}(プロジェクトのデータと一緒に共有する)
10
+ * <data>/metrics/.manual.lock 書くときのロック(同じマシンのプロセスの間)
11
+ *
12
+ * - 1件は 指標・範囲(project かマイルストーン ID)・観測期間(開始日・終了日)・単位 で決まる。同じ内容の再送は何も変えない。値・出典・メモを
13
+ * 変える訂正は、読んだ版(rev)を渡したときだけ(渡さない・違えば競合で何も書かない)
14
+ * - 値は0以上(不具合は整数)。費用は通貨コードごとで、通貨・期間の違う値を1つに合算しない。範囲の間(全体とマイルストーン)も合算しない
15
+ * - ロックの中で読み直してから書き、置き換えで書く(途中の状態を読ませない)。壊れたファイルは空とみなさず、読めないと知らせて書かない
16
+ * - 記録のあるマイルストーンは通常の削除で消さない(core/requestOps.ts の checkMilestoneRemoval)。直接編集で消えたら知らせる
17
+ */
18
+ const DIR = "metrics";
19
+ const FILE = "manual.json";
20
+ const DATE = /^\d{4}-\d{2}-\d{2}$/;
21
+ const CURRENCY = /^[A-Z]{3}$/;
22
+ const SOURCE_MAX = 1000;
23
+ export const manualFile = (dataDir) => join(dataDir, DIR, FILE);
24
+ const lockFile = (dataDir) => join(dataDir, DIR, `.${FILE.replace(".json", "")}.lock`);
25
+ const validDate = (v) => DATE.test(v) && new Date(`${v}T00:00:00Z`).toISOString().slice(0, 10) === v;
26
+ function readRecord(raw, i) {
27
+ const o = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : undefined;
28
+ const at = `${i + 1} 件目`;
29
+ if (!o)
30
+ throw new Error(`${at} がオブジェクトではありません`);
31
+ const s = (k) => (typeof o[k] === "string" && o[k] ? o[k] : undefined);
32
+ const id = s("id");
33
+ if (!id || !/^M\d+$/.test(id))
34
+ throw new Error(`${at} の id が読めません(M1, M2, ...)`);
35
+ for (const k of ["metric", "scope", "from", "to", "unit", "source", "createdAt", "updatedAt"])
36
+ if (!s(k))
37
+ throw new Error(`${at}(${id})の ${k} がありません`);
38
+ if (typeof o.value !== "number" || !Number.isFinite(o.value) || o.value < 0)
39
+ throw new Error(`${at}(${id})の value が 0 以上の数ではありません`);
40
+ if (!Number.isInteger(o.rev) || o.rev < 1)
41
+ throw new Error(`${at}(${id})の rev が読めません`);
42
+ return {
43
+ id,
44
+ metric: s("metric"),
45
+ scope: s("scope"),
46
+ from: s("from"),
47
+ to: s("to"),
48
+ value: o.value,
49
+ unit: s("unit"),
50
+ source: s("source"),
51
+ ...(s("note") ? { note: s("note") } : {}),
52
+ rev: o.rev,
53
+ createdAt: s("createdAt"),
54
+ ...(s("createdBy") ? { createdBy: s("createdBy") } : {}),
55
+ updatedAt: s("updatedAt"),
56
+ ...(s("updatedBy") ? { updatedBy: s("updatedBy") } : {}),
57
+ };
58
+ }
59
+ /** 記録を読む。無ければ空、壊れていれば problem(空とみなさない) */
60
+ export async function readManual(dataDir) {
61
+ let text;
62
+ try {
63
+ text = await readFile(manualFile(dataDir), "utf8");
64
+ }
65
+ catch (e) {
66
+ if (e.code === "ENOENT")
67
+ return { records: [], seq: 0 };
68
+ return { records: [], seq: 0, problem: `読めません: ${e.message}` };
69
+ }
70
+ try {
71
+ const j = JSON.parse(text);
72
+ if (!j || typeof j !== "object" || j.version !== 1 || !Array.isArray(j.records))
73
+ throw new Error("{version: 1, records: [...]} の形ではありません");
74
+ const records = j.records.map(readRecord);
75
+ const seq = Math.max(Number.isInteger(j.seq) ? j.seq : 0, ...records.map((r) => Number(r.id.slice(1))));
76
+ return { records, seq };
77
+ }
78
+ catch (e) {
79
+ return { records: [], seq: 0, problem: `${DIR}/${FILE} が読めません(直してください。記録は書き足しません): ${e.message}` };
80
+ }
81
+ }
82
+ const manualSpec = (metric) => {
83
+ const d = METRIC_DEFINITIONS.find((x) => x.id === metric);
84
+ if (!d?.manual) {
85
+ const ids = METRIC_DEFINITIONS.filter((x) => x.manual).map((x) => x.id);
86
+ throw new MetricsError(`人が記録する指標ではありません: ${metric}(${ids.join(" / ")})`);
87
+ }
88
+ return d.manual;
89
+ };
90
+ /** 入力を確かめて、識別に使う値と保存する値にする(何も書かない) */
91
+ export function cleanManual(ctx, i) {
92
+ const spec = manualSpec(i.metric);
93
+ const scope = i.scope || "project";
94
+ if (scope !== "project" && !ctx.ws.project.milestones.some((m) => m.id === scope))
95
+ throw new MetricsError(`マイルストーン ${scope} は登録されていません(project か登録済みのマイルストーン ID)`);
96
+ if (!validDate(i.from) || !validDate(i.to))
97
+ throw new MetricsError(`観測期間は YYYY-MM-DD の日付で指定してください(--from ${i.from || "?"} --to ${i.to || "?"})`);
98
+ if (i.from > i.to)
99
+ throw new MetricsError(`観測期間の開始日 ${i.from} が終了日 ${i.to} より後です`);
100
+ const value = typeof i.value === "number" ? i.value : i.value.trim() === "" ? NaN : Number(i.value);
101
+ if (!Number.isFinite(value))
102
+ throw new MetricsError(`値が数ではありません: ${String(i.value)}`);
103
+ if (value < 0)
104
+ throw new MetricsError(`値は 0 以上です: ${value}`);
105
+ if (spec.value === "integer" && !Number.isInteger(value))
106
+ throw new MetricsError(`${i.metric} の値は 0 以上の整数です: ${value}`);
107
+ let unit;
108
+ if (spec.unit === "currency") {
109
+ unit = (i.unit ?? "").trim().toUpperCase();
110
+ if (!CURRENCY.test(unit))
111
+ throw new MetricsError(`${i.metric} は通貨コード(--unit JPY / USD など 3 文字)が要ります`);
112
+ }
113
+ else {
114
+ unit = spec.unit;
115
+ if (i.unit !== undefined && i.unit.trim() !== unit)
116
+ throw new MetricsError(`${i.metric} の単位は「${unit}」だけです(--unit は省いてください)`);
117
+ }
118
+ const source = i.source?.trim() ?? "";
119
+ if (!source)
120
+ throw new MetricsError("出典(--source 請求書・課金の画面・不具合の管理表など)が要ります");
121
+ if (source.length > SOURCE_MAX)
122
+ throw new MetricsError(`出典は ${SOURCE_MAX} 文字までです`);
123
+ const note = i.note?.trim();
124
+ return { metric: i.metric, scope, from: i.from, to: i.to, value, unit, source, ...(note ? { note } : {}) };
125
+ }
126
+ const sameKey = (a, b) => a.metric === b.metric && a.scope === b.scope && a.from === b.from && a.to === b.to && a.unit === b.unit;
127
+ async function writeManual(dataDir, f) {
128
+ await writeFileAtomic(manualFile(dataDir), `${JSON.stringify(f, null, 2)}\n`);
129
+ }
130
+ async function locked(dataDir, fn) {
131
+ return withFileLock(lockFile(dataDir), async () => {
132
+ const cur = await readManual(dataDir);
133
+ if (cur.problem)
134
+ throw new MetricsError(cur.problem, "metrics_unreadable");
135
+ return fn(cur);
136
+ });
137
+ }
138
+ /**
139
+ * 記録する。同じ識別(指標・範囲・期間・単位)が無ければ足す。あって値・出典・メモが同じなら何もしない(changed: false)。
140
+ * 違えば訂正で、expectedRev がその記録の rev と同じときだけ書く(無い・違う → metrics_conflict)
141
+ */
142
+ export async function recordManual(ctx, input, opts = {}) {
143
+ const v = cleanManual(ctx, input);
144
+ const dataDir = ctx.ws.dataDir;
145
+ return locked(dataDir, async (cur) => {
146
+ const now = new Date().toISOString();
147
+ const hit = cur.records.find((r) => sameKey(r, v));
148
+ if (!hit) {
149
+ if (opts.expectedRev !== undefined && opts.expectedRev !== 0)
150
+ throw new MetricsError(`同じ指標・範囲・期間・単位の記録はありません(--rev ${opts.expectedRev} は使えません)`, "metrics_conflict");
151
+ const record = { id: `M${cur.seq + 1}`, ...v, rev: 1, createdAt: now, ...(opts.actor ? { createdBy: opts.actor } : {}), updatedAt: now, ...(opts.actor ? { updatedBy: opts.actor } : {}) };
152
+ await writeManual(dataDir, { version: 1, seq: cur.seq + 1, records: [...cur.records, record] });
153
+ return { record, changed: true, created: true };
154
+ }
155
+ if (hit.value === v.value && hit.source === v.source && (hit.note ?? "") === (v.note ?? ""))
156
+ return { record: hit, changed: false, created: false };
157
+ if (opts.expectedRev === undefined) {
158
+ throw new MetricsError(`${hit.id} に同じ指標・範囲・期間・単位の記録があります(値 ${hit.value} ${hit.unit}・版 ${hit.rev})。訂正するなら --rev ${hit.rev} を付けてください`, "metrics_conflict");
159
+ }
160
+ if (opts.expectedRev !== hit.rev)
161
+ throw new MetricsError(`${hit.id} は他で変わりました(読んだ版 ${opts.expectedRev}・今の版 ${hit.rev})。p3 metrics で確かめてからやり直してください`, "metrics_conflict");
162
+ const { note: _n, ...rest } = hit;
163
+ const record = { ...rest, value: v.value, source: v.source, ...(v.note ? { note: v.note } : {}), rev: hit.rev + 1, updatedAt: now, ...(opts.actor ? { updatedBy: opts.actor } : {}) };
164
+ await writeManual(dataDir, { version: 1, seq: cur.seq, records: cur.records.map((r) => (r.id === hit.id ? record : r)) });
165
+ return { record, changed: true, created: false };
166
+ });
167
+ }
168
+ /** 記録を消す(ID は使い直さない)。expectedRev を渡せば照らす */
169
+ export async function removeManual(ctx, id, opts = {}) {
170
+ const dataDir = ctx.ws.dataDir;
171
+ return locked(dataDir, async (cur) => {
172
+ const hit = cur.records.find((r) => r.id === id);
173
+ if (!hit)
174
+ throw new MetricsError(`人の記録 ${id} はありません(p3 metrics records で確かめてください)`);
175
+ if (opts.expectedRev !== undefined && opts.expectedRev !== hit.rev)
176
+ throw new MetricsError(`${id} は他で変わりました(読んだ版 ${opts.expectedRev}・今の版 ${hit.rev})`, "metrics_conflict");
177
+ await writeManual(dataDir, { version: 1, seq: cur.seq, records: cur.records.filter((r) => r.id !== id) });
178
+ return hit;
179
+ });
180
+ }
@@ -1,5 +1,6 @@
1
1
  import { createHash } from "node:crypto";
2
2
  import { PURPOSE_UNIT_ID, REVIEW_SCOPE, REVIEW_SCOPE_RECORDS_ONLY, } from "../../shared/milestoneReview.js";
3
+ import { qualitySnapshot } from "../../shared/quality.js";
3
4
  import { hierarchyNow } from "../requestStatus.js";
4
5
  import { Workspace } from "../store/workspace.js";
5
6
  import { reviewCode } from "./code.js";
@@ -37,6 +38,7 @@ export function withCode(i, code, warnings = []) {
37
38
  context: i.context,
38
39
  warnings: [...i.warnings, ...warnings],
39
40
  code,
41
+ ...(i.quality ? { quality: i.quality } : {}),
40
42
  scope: code.some((c) => c.status === "ok") ? REVIEW_SCOPE : REVIEW_SCOPE_RECORDS_ONLY,
41
43
  };
42
44
  return { ...body, extractedAt: i.extractedAt, extractedUntil: new Date().toISOString(), hash: reviewInputHash(body) };
@@ -119,7 +121,13 @@ export function reviewInputOf(ws, mid, extractedAt = new Date().toISOString()) {
119
121
  ...(m?.goals?.length ? { goals: m.goals.map((g) => ({ id: g.id, text: g.text })) } : {}),
120
122
  };
121
123
  const units = reviewUnits(m);
122
- const body = { milestone, units, requests, context, warnings, scope: REVIEW_SCOPE_RECORDS_ONLY };
124
+ // 品質基準(版つき)。未設定・読めないは警告にして、設定や改善の要望へ案内する
125
+ const quality = qualitySnapshot(ws.project.quality, ws.project.qualityVersion);
126
+ if (quality.state === "unset")
127
+ warnings.push({ code: "quality_unset", target: "project.yaml", message: "プロジェクトの品質基準は未設定です(品質は評価しません。p3 quality で設定するか、設定する要望を登録できます)" });
128
+ if (quality.state === "invalid")
129
+ warnings.push({ code: "quality_invalid", target: "project.yaml", message: `プロジェクトの品質基準が読めません(品質は評価しません。project.yaml を直してください): ${(quality.problems ?? []).join(" / ")}` });
130
+ const body = { milestone, units, requests, context, warnings, scope: REVIEW_SCOPE_RECORDS_ONLY, quality };
123
131
  return { ...body, extractedAt, extractedUntil: new Date().toISOString(), hash: reviewInputHash(body) };
124
132
  }
125
133
  /** 材料の識別子(抽出の日時・警告の文言は含めない) */
@@ -133,6 +141,8 @@ export function reviewInputHash(i) {
133
141
  ...(i.code
134
142
  ? { code: i.code.map((c) => [c.name, c.status, c.head ?? null, c.branch ?? null, c.dirty ?? 0, c.dirtyDigest ?? null, c.commits.map((x) => [x.sha, x.from, x.found])]) }
135
143
  : {}),
144
+ // 品質基準(状態と版。変われば材料が変わった)
145
+ ...(i.quality ? { quality: [i.quality.state, i.quality.version] } : {}),
136
146
  };
137
147
  return createHash("sha256").update(JSON.stringify(key)).digest("hex");
138
148
  }
@@ -20,6 +20,7 @@ export class MockReviewer {
20
20
  message: JSON.stringify({
21
21
  overall: `(Mock)評価していません。所属する要望 ${material.requests?.length ?? 0} 件を材料にしました`,
22
22
  units: (material.units ?? []).map((u) => ({ unit: u.id, verdict: "insufficient", reason: "(Mock)評価していません", evidence: [], gaps: ["Codex で実行すると評価します"] })),
23
+ ...(material.quality ? { quality: material.quality.standards.map((q) => ({ standard: q.id, verdict: "undetermined", reason: "(Mock)評価していません", evidence: [] })) } : {}),
23
24
  }),
24
25
  seconds: 0,
25
26
  };
@@ -2,6 +2,7 @@ import { spawnSync } from "node:child_process";
2
2
  import { existsSync } from "node:fs";
3
3
  import { isAbsolute, join, normalize } from "node:path";
4
4
  import { CONTAINER_WORKSPACE } from "@infodb/codex-workspace";
5
+ import { QUALITY_VERDICTS } from "../../shared/taskReview.js";
5
6
  import { REVIEW_VERDICTS, } from "../../shared/milestoneReview.js";
6
7
  /**
7
8
  * レビューの依頼文と、結果の確かめ方(Codex にもテストの偽物にも同じものを使う)。
@@ -54,9 +55,30 @@ export function reviewMaterial(input) {
54
55
  tasks: r.tasks.map((t) => ({ ref: t.ref, title: t.title, status: t.status, body: t.body, record: t.record ?? null, outputs: t.outputs })),
55
56
  })),
56
57
  context: input.context,
58
+ ...(input.quality?.state === "set"
59
+ ? {
60
+ quality: {
61
+ version: input.quality.version,
62
+ standards: (input.quality.standards ?? []).filter((q) => !q.exempt).map((q) => ({ id: q.id, text: q.text, repos: q.repos ?? "全部", check: q.check })),
63
+ exempt: (input.quality.standards ?? []).filter((q) => q.exempt).map((q) => ({ id: q.id, reason: q.exempt.reason })),
64
+ },
65
+ }
66
+ : {}),
57
67
  warnings: input.warnings.map((w) => w.message),
58
68
  };
59
69
  }
70
+ /** 品質を判定する基準(設定済みで除外していないもの) */
71
+ const qualityTargets = (input) => (input.quality?.state === "set" ? (input.quality.standards ?? []).filter((q) => !q.exempt) : []);
72
+ function qualityInstructions(input) {
73
+ const targets = qualityTargets(input);
74
+ if (!targets.length)
75
+ return "";
76
+ return `
77
+ - 品質(quality): 資料の quality.standards はプロジェクトの品質基準です。目的・予定機能の達成(units)とは別に、品質基準ごとにちょうど1回ずつ、実際のコードと履歴が適合しているかを判定してください。品質の問題を units の未達や unplanned に押し込めないでください。
78
+ - verdict: satisfied(満たす)/ violated(違反)/ undetermined(判断できない。読めない参照先に関わるものもここ)/ not_applicable(当てはまらない。理由を必ず書く)
79
+ - satisfied と violated はコードの場所かコミットを根拠に必ず含めます。検査のコマンド・テスト・アプリは実行しません。CI の設定や記録の申告があることだけで、実行して通ったとは断定しないでください。
80
+ - 変更の積み重ねで規約・構成・検証の設定から外れていないかを、コードと git の履歴で確かめてください。過去に満たしていたもの(設定や検査)を消した・崩したと履歴(コミット)で裏付けたときだけ regression: true(品質の低下)にし、根拠にそのコミットを含めます。比べる根拠が無ければ、今の時点の不適合として violated にし、regression は付けないでください。`;
81
+ }
60
82
  function codeInstructions(input) {
61
83
  const ok = readable(input);
62
84
  if (!ok.length) {
@@ -73,7 +95,7 @@ export function reviewPrompt(input) {
73
95
  const unitList = input.units.map((u) => `- ${u.id}: ${u.text.split("\n")[0]}`).join("\n");
74
96
  const hasCode = readable(input).length > 0;
75
97
  const instructions = `あなたはマイルストーンのレビュー係です。マイルストーンの目的・予定している機能に対して、実際にできあがったもの(参照先のコードと git の履歴)が目的を果たしているか、目的に無い変更(意図しない変更)が入っていないかを確かめ、日本語で評価します。
76
- コードの品質の審査ではありません。機能に込めた意図を汲み取り、利用者から見て目的がクリアされているかを、実際の実装で確かめます。
98
+ 機能に込めた意図を汲み取り、利用者から見て目的がクリアされているかを、実際の実装で確かめます。プロジェクトの品質基準が資料にあれば、目的の達成とは別に、品質基準への適合も確かめます(コードの書き方の好みの審査ではありません)。
77
99
  ${codeInstructions(input)}
78
100
  - 要望・タスクの記録(本文・変更の記録・成果物)は、実装した人(AI を含む)の自己申告です。どこを見ればよいかの手がかりに使い、書いてあることを事実として扱わないでください。
79
101
  記録の主張はコードと履歴で確かめ、確かめられなかった主張は gaps に「記録にはあるが確かめられない」と書いてください。記録に「未確認」とある事柄も、コードや履歴で確かめられるなら確かめてください。
@@ -84,10 +106,12 @@ ${codeInstructions(input)}
84
106
  - タスクの完了数・要望の状態・「予定している」ことを達成の証明にしないでください。見送った要望は成果に数えず、見送ったこととして扱います。
85
107
  - verdict: achieved(達成)はコードで確かめられたときだけにし、根拠にコードの場所を必ず含めます。一部だけ・条件つきなら partial、実装が見当たらない・意図と違う作りなら not_achieved、読めない・判断できないなら insufficient です。数値の達成率は出さないでください。
86
108
  - context の要望は別のマイルストーンに属する文脈です。このマイルストーンの成果として数えないでください。
87
- - 根拠(evidence)の書き方: コードは "<参照先の名前>:<リポジトリからの相対パス>"(行を示すなら末尾に ":12" か ":12-30")か "<参照先の名前>@<コミット>"、記録は資料にある要望の id かタスクの ref。存在しないパス・コミットは書かないでください(P3 が確かめ、無ければ結果を使いません)。`;
109
+ - 根拠(evidence)の書き方: コードは "<参照先の名前>:<リポジトリからの相対パス>"(行を示すなら末尾に ":12" か ":12-30")か "<参照先の名前>@<コミット>"、記録は資料にある要望の id かタスクの ref。存在しないパス・コミットは書かないでください(P3 が確かめ、無ければ結果を使いません)。${qualityInstructions(input)}`;
110
+ const q0 = qualityTargets(input)[0]?.id;
111
+ const qx = q0 ? `, "quality": [{"standard": "${q0}", "verdict": "undetermined", "reason": "理由", "evidence": [], "unread": "確かめられなかった範囲"}]` : "";
88
112
  const example = hasCode
89
- ? `{"overall": "全体の所見", "units": [{"unit": "${input.units[0]?.id ?? "G1"}", "verdict": "partial", "reason": "理由", "evidence": ["<参照先>:src/foo.ts:10-40", "<参照先>@<コミット>", "<要望ID>/T001"], "gaps": ["不足していること"]}], "unplanned": [{"text": "目的に無い変更とその影響", "evidence": ["<参照先>@<コミット>"]}]}`
90
- : `{"overall": "全体の所見", "units": [{"unit": "${input.units[0]?.id ?? "G1"}", "verdict": "insufficient", "reason": "理由", "evidence": ["<要望ID>/T001"], "gaps": ["不足していること"]}], "unplanned": []}`;
113
+ ? `{"overall": "全体の所見", "units": [{"unit": "${input.units[0]?.id ?? "G1"}", "verdict": "partial", "reason": "理由", "evidence": ["<参照先>:src/foo.ts:10-40", "<参照先>@<コミット>", "<要望ID>/T001"], "gaps": ["不足していること"]}], "unplanned": [{"text": "目的に無い変更とその影響", "evidence": ["<参照先>@<コミット>"]}]${qx}}`
114
+ : `{"overall": "全体の所見", "units": [{"unit": "${input.units[0]?.id ?? "G1"}", "verdict": "insufficient", "reason": "理由", "evidence": ["<要望ID>/T001"], "gaps": ["不足していること"]}], "unplanned": []${qx}}`;
91
115
  const prompt = `# マイルストーンのレビュー: ${input.milestone.title}(${input.milestone.id})
92
116
 
93
117
  次の JSON が資料です(目的・予定機能・参照先・要望とタスクの記録)。
@@ -107,7 +131,7 @@ ${unitList}
107
131
  - reason: そう判断した理由(どのコード・履歴・記録から読んだか)
108
132
  - evidence: 根拠(コードの場所・コミット・要望の id・タスクの ref)
109
133
  - gaps: 不足していること・確かめられなかったこと・次に検討すること(無ければ空の配列)
110
- 4. unplanned に、目的・予定機能・要望に無い変更(意図しない変更の候補)を、根拠と一緒に書く(無ければ空の配列)。
134
+ 4. unplanned に、目的・予定機能・要望に無い変更(意図しない変更の候補)を、根拠と一緒に書く(無ければ空の配列)。${qualityTargets(input).length ? `\n5. quality に、品質基準(${qualityTargets(input).map((q) => q.id).join(", ")})ごとに verdict・reason・evidence・unread(と裏付けたときだけ regression)を書く(全部にちょうど1回ずつ)。` : ""}
111
135
 
112
136
  ## 出力
113
137
  最後の応答に、次の形の JSON だけを返してください(前後に文章を付けない):
@@ -239,7 +263,47 @@ export function parseReview(message, input, model, locals) {
239
263
  // 比較単位の順にそろえる
240
264
  units.sort((a, b) => ids.indexOf(a.unit) - ids.indexOf(b.unit));
241
265
  const unplanned = parseUnplanned(o.unplanned, input, refs, locals);
242
- return { overall, units, unplanned, scope: input.scope, ...(model ? { model } : {}) };
266
+ const quality = parseQuality(data.quality, input, refs, locals);
267
+ return { overall, units, unplanned, ...(quality ? { quality } : {}), scope: input.scope, ...(model ? { model } : {}) };
268
+ }
269
+ /** 品質の判定を確かめる(品質基準が設定済みのときだけ。除外していない基準を全部ちょうど1回ずつ) */
270
+ function parseQuality(v, input, refs, locals) {
271
+ const targets = qualityTargets(input);
272
+ if (!targets.length)
273
+ return undefined;
274
+ if (!Array.isArray(v))
275
+ throw new InvalidReview("結果に quality(品質基準ごとの判定の配列)がありません");
276
+ const ids = targets.map((t) => t.id);
277
+ const seen = new Set();
278
+ const out = v.map((x, i) => {
279
+ const u = (x ?? {});
280
+ const at = `quality[${i}]`;
281
+ if (typeof u.standard !== "string" || !ids.includes(u.standard))
282
+ throw new InvalidReview(`${at}.standard が品質基準にありません: ${JSON.stringify(u.standard)}`);
283
+ if (seen.has(u.standard))
284
+ throw new InvalidReview(`${at}.standard が重複しています: ${u.standard}`);
285
+ seen.add(u.standard);
286
+ if (!QUALITY_VERDICTS.includes(u.verdict))
287
+ throw new InvalidReview(`${at}.verdict が区分にありません: ${JSON.stringify(u.verdict)}`);
288
+ if (typeof u.reason !== "string" || !u.reason.trim())
289
+ throw new InvalidReview(`${at}.reason がありません(対象外にも理由が要ります)`);
290
+ if (u.reason.trim().length > REVIEW_OUTPUT_LIMITS.reason)
291
+ throw new InvalidReview(`${at}.reason が長すぎます`);
292
+ const evidence = checkEvidence(u.evidence, at, input, refs, locals);
293
+ if ((u.verdict === "satisfied" || u.verdict === "violated") && !evidence.code)
294
+ throw new InvalidReview(`${at}: 「${u.verdict === "satisfied" ? "満たす" : "違反"}」の根拠にコードの場所かコミットがありません(${u.standard})`);
295
+ const regression = u.regression === true;
296
+ if (regression && (u.verdict !== "violated" || !evidence.list.some((e) => /^[^:@\s]+@[0-9a-f]{7,40}$/i.test(e)))) {
297
+ throw new InvalidReview(`${at}: 品質の低下(regression)は、違反で、履歴のコミットを根拠にしたときだけです(${u.standard})`);
298
+ }
299
+ if (u.unread !== undefined && (typeof u.unread !== "string" || u.unread.length > REVIEW_OUTPUT_LIMITS.reason))
300
+ throw new InvalidReview(`${at}.unread は ${REVIEW_OUTPUT_LIMITS.reason} 文字までの文字列にしてください`);
301
+ return { standard: u.standard, verdict: u.verdict, reason: u.reason.trim(), evidence: evidence.list, ...(typeof u.unread === "string" && u.unread.trim() ? { unread: u.unread.trim() } : {}), ...(regression ? { regression } : {}) };
302
+ });
303
+ const missing = ids.filter((id) => !seen.has(id));
304
+ if (missing.length)
305
+ throw new InvalidReview(`品質基準の判定が欠けています: ${missing.join(", ")}`);
306
+ return out.sort((a, b) => ids.indexOf(a.standard) - ids.indexOf(b.standard));
243
307
  }
244
308
  function parseUnplanned(v, input, refs, locals) {
245
309
  const L = REVIEW_OUTPUT_LIMITS;
@@ -1,9 +1,11 @@
1
1
  import { ChatGptAuthError } from "../chatgpt.js";
2
2
  import { CodexUnavailableError, CodexUsageLimitError } from "../preflight/codexEngine.js";
3
- import { currentOwner, ownerState, systemProbe } from "../preflight/owner.js";
3
+ import { currentOwner } from "../preflight/owner.js";
4
+ import { ReviewCancelRefused, RunControl, startedNow } from "../reviewRuns.js";
4
5
  import { extractReviewInput } from "./material.js";
5
6
  import { InvalidReview, parseReview, REVIEW_INPUT_LIMIT, reviewPrompt } from "./review.js";
6
- import { checkReviewMilestoneId, newReviewRunId, ReviewStoreError } from "./store.js";
7
+ import { checkReviewMilestoneId, newReviewRunId } from "./store.js";
8
+ export { ReviewCancelRefused };
7
9
  /**
8
10
  * マイルストーンレビューを任意のときに実行して記録する(CLI・API はここを呼ぶ)。材料の規則は material.ts、依頼文と結果の
9
11
  * 確かめ方は review.ts、保存は store.ts。
@@ -32,43 +34,34 @@ export class ReviewRejected extends Error {
32
34
  this.running = running;
33
35
  }
34
36
  }
35
- /** 取消・中断を受け付けない(終わっている・動いている所有者がいる) */
36
- export class ReviewCancelRefused extends Error {
37
- code;
38
- constructor(code, message) {
39
- super(message);
40
- this.code = code;
41
- }
42
- }
43
- /** 開始の日時(このプロセスでは前より必ず後にする。一覧を開始の順に並べるので、同じミリ秒の開始でも順が分かるように) */
44
- let lastStart = 0;
45
- function startedNow() {
46
- lastStart = Math.max(Date.now(), lastStart + 1);
47
- return new Date(lastStart).toISOString();
48
- }
49
37
  export class MilestoneReviewService {
50
38
  ws;
51
39
  reviewers;
52
40
  opts;
53
41
  local = new Map();
42
+ /** 実行中の run の扱い(回復・取消・取消の要求の見つけ方・終わり)は reviewRuns.ts と共通 */
43
+ control;
54
44
  constructor(ws, reviewers, opts = {}) {
55
45
  this.ws = ws;
56
46
  this.reviewers = reviewers;
57
47
  this.opts = opts;
48
+ this.control = new RunControl(ws.milestoneReviews, this.local, opts.probe, (_k, r) => this.emit(r));
58
49
  }
59
50
  get store() {
60
51
  return this.ws.milestoneReviews;
61
52
  }
62
53
  ownerOf(r) {
63
- if (this.local.has(r.id))
64
- return { state: "local" };
65
- return ownerState(r.owner, this.opts.probe ?? systemProbe);
54
+ return this.control.ownerOf(r);
66
55
  }
67
56
  /** 始める(終わるのは wait で待つ)。材料はここで固定する */
68
- async start(mid, actor, engine) {
57
+ async start(mid, actor, engine, opts = {}) {
69
58
  checkReviewMilestoneId(mid);
70
59
  const refs = this.ws.refs();
71
60
  const input = await extractReviewInput(this.ws.dataDir, mid, refs);
61
+ // 画面で確かめた材料(品質基準を含む)から変わっていれば始めない
62
+ if (opts.expectedHash !== undefined && opts.expectedHash !== input.hash) {
63
+ throw new ReviewRejected("material_changed", "確かめた後で材料(目的・要望・タスク・コード・品質基準)が変わりました。もう一度確かめてから始めてください");
64
+ }
72
65
  if (!input.milestone.known)
73
66
  throw new ReviewRejected("unknown_milestone", `マイルストーンがありません: ${mid}`);
74
67
  if (!input.units.length) {
@@ -94,12 +87,9 @@ export class MilestoneReviewService {
94
87
  log: [],
95
88
  };
96
89
  await this.store.withLock(mid, async () => {
97
- await this.recoverLocked(mid);
98
- for (const id of await this.store.runIds(mid)) {
99
- const r = await this.store.readRun(mid, id).catch(() => undefined);
100
- if (r?.status !== "running")
101
- continue;
102
- const o = this.ownerOf(r);
90
+ const busy = await this.control.runningLocked(mid);
91
+ if (busy) {
92
+ const { run: r, owner: o } = busy;
103
93
  const hint = o.state === "unknown"
104
94
  ? `。実行しているプロセスを確かめられません(${o.reason})。止まっていると確かめたら p3 milestone review-cancel ${mid} ${r.id} --acknowledge-stopped で中断できます`
105
95
  : "。終わるのを待つか取り消してください";
@@ -124,24 +114,8 @@ export class MilestoneReviewService {
124
114
  const timeoutMs = this.opts.timeoutMs ?? REVIEW_TIMEOUT_MS;
125
115
  const timeout = AbortSignal.timeout(timeoutMs);
126
116
  const signal = AbortSignal.any([abort.signal, timeout]);
127
- let flushed = 0;
128
117
  // ほかのプロセスからの取消の要求を見つけ、ログを run.json に書き足す
129
- const poll = setInterval(() => {
130
- void this.store
131
- .withLock(mid, async () => {
132
- const cur = await this.store.readRun(mid, id);
133
- if (cur.status !== "running")
134
- return abort.abort(new Error("ended"));
135
- if (cur.cancelRequested)
136
- abort.abort(new Error("cancelled"));
137
- if (log.length !== flushed) {
138
- flushed = log.length;
139
- await this.store.updateRunning(mid, id, (r) => ({ ...r, log: [...log] }));
140
- }
141
- })
142
- .catch(() => undefined);
143
- }, this.opts.pollMs ?? 1000);
144
- poll.unref?.();
118
+ const stopWatch = this.control.watch(mid, id, log, abort, this.opts.pollMs ?? 1000);
145
119
  let end;
146
120
  let result;
147
121
  try {
@@ -171,38 +145,25 @@ export class MilestoneReviewService {
171
145
  push({ kind: "error", text: end.error });
172
146
  }
173
147
  finally {
174
- clearInterval(poll);
175
- }
176
- try {
177
- const fin = await this.store.withLock(mid, () => this.store.finish(mid, id, { ...end, log: [...log] }, end.status === "completed" ? result : undefined));
178
- this.emit(fin);
179
- }
180
- catch (e) {
181
- // 既に終わっていた(人が中断した・回復した): 遅れて届いた結果は取り込まない
182
- if (!(e instanceof ReviewStoreError && e.code === "finished"))
183
- throw e;
184
- this.emit({ id, milestone: mid, status: (await this.store.readRun(mid, id).catch(() => run)).status });
148
+ stopWatch();
185
149
  }
186
- }
187
- /** 死んだと確かめられた所有者の run を失敗(crashed)にする(ロックの中で呼ぶ) */
188
- async recoverLocked(mid) {
189
- for (const id of await this.store.runIds(mid)) {
190
- const r = await this.store.readRun(mid, id).catch(() => undefined);
191
- if (r?.status !== "running" || this.local.has(r.id))
192
- continue;
193
- const o = this.ownerOf(r);
194
- if (o.state !== "dead")
195
- continue;
196
- const fin = await this.store.finish(mid, id, { status: "failed", failure: "crashed", error: `実行していたプロセスが途中で終わりました(${o.reason})` });
197
- this.emit(fin);
150
+ // 実行中に材料が変わったか(要望・タスク・コード・品質基準)。結果は始めたときの材料に対するもの
151
+ if (end.status === "completed") {
152
+ const now = await extractReviewInput(this.ws.dataDir, mid, ask.refs).catch(() => undefined);
153
+ if (now && now.hash !== input.hash) {
154
+ end = { ...end, inputChanged: true };
155
+ push({ kind: "info", text: "実行中に材料が変わりました(結果は始めたときの材料に対するものです)" });
156
+ }
198
157
  }
158
+ // 既に終わっていた(人が中断した・回復した)なら、遅れて届いた結果は取り込まない
159
+ await this.control.end(mid, id, { ...end, log: [...log] }, result);
199
160
  }
200
161
  /** 死んだ所有者の run を回復する(一覧・取得の前に) */
201
162
  async recover(mid) {
202
163
  checkReviewMilestoneId(mid);
203
164
  if (!(await this.store.hasHistory(mid)))
204
165
  return;
205
- await this.store.withLock(mid, () => this.recoverLocked(mid));
166
+ await this.store.withLock(mid, () => this.control.recoverLocked(mid));
206
167
  }
207
168
  async list(mid) {
208
169
  await this.recover(mid);
@@ -221,32 +182,7 @@ export class MilestoneReviewService {
221
182
  async cancel(mid, run, by, opts = {}) {
222
183
  checkReviewMilestoneId(mid);
223
184
  const local = this.local.get(run);
224
- const out = await this.store.withLock(mid, async () => {
225
- const cur = await this.store.readRun(mid, run);
226
- if (cur.status !== "running")
227
- throw new ReviewCancelRefused("finished", `${mid}/${run} は既に終わっています(${cur.status})`);
228
- const o = this.ownerOf(cur);
229
- if (opts.acknowledgeStopped && !local) {
230
- if (o.state === "alive")
231
- throw new ReviewCancelRefused("owner_alive", `${mid}/${run} を実行しているプロセスは動いています。--acknowledge-stopped ではなく取消を使ってください`);
232
- const at = new Date().toISOString();
233
- const fin = await this.store.finish(mid, run, {
234
- status: "cancelled",
235
- abandoned: { at, ...(by ? { by } : {}) },
236
- error: "人が中断しました(ほかの環境で動いているプロセスを止めたとは限りません)",
237
- });
238
- return { run: fin, requested: false };
239
- }
240
- if (o.state === "dead") {
241
- const fin = await this.store.finish(mid, run, { status: "failed", failure: "crashed", error: `実行していたプロセスが途中で終わりました(${o.reason})` });
242
- return { run: fin, requested: false };
243
- }
244
- const next = await this.store.updateRunning(mid, run, (r) => ({ ...r, cancelRequested: { at: new Date().toISOString(), ...(by ? { by } : {}) } }));
245
- return { run: next, requested: true };
246
- });
247
- local?.abort.abort(new Error("cancelled"));
248
- this.emit(out.run);
249
- return out;
185
+ return this.control.cancel(mid, run, by, { ...opts, label: `${mid}/${run}`, abortLocal: () => local?.abort.abort(new Error("cancelled")) });
250
186
  }
251
187
  /** 終わるまで待つ(このプロセスの run だけ) */
252
188
  async wait(mid, run) {