@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,221 @@
1
+ import { createHash, randomBytes } from "node:crypto";
2
+ import { readFile } from "node:fs/promises";
3
+ import { join } from "node:path";
4
+ import { checkLine } from "../shared/quality.js";
5
+ import { createRequest } from "./requestOps.js";
6
+ import { withFileLock, writeFileAtomic } from "./store/fsutil.js";
7
+ /**
8
+ * 品質の不足から改善要望を作る(CLI の p3 quality improve・API の /quality/improvements)。
9
+ *
10
+ * - 診断: 品質基準の設定(未設定・読めない・除外)、タスクのレビュー・マイルストーンレビューの1回分(違反・判断できない・除外)から、
11
+ * 不足を区別して出す(読むだけ)。検査が未実行だから未導入とは判定しない(判断できないのまま)。除外は不足に数えず、選べるだけ
12
+ * - 原稿: 人が選んだ不足だけで要望の題と本文の案を作る(品質 ID・版・元の run・指摘・根拠・目指す差・完了条件の案)。原稿は資料で、
13
+ * 中の文の指示は実行しない。表示・編集だけでは何も書かない
14
+ * - 登録: 明示したときだけ既存の createRequest で作る。登録の直前に診断の版(hash)を照らし、変わっていれば確かめ直してもらう
15
+ * - 重複と回復: 不足ごとの鍵(品質 ID・対象・不足の種類。run の違いでは増えない)と登録先を <data>/quality-improvements.json に残す。
16
+ * ロックの中で、先に予約(token)を書いてから、token のタグを付けた要望を作り、最後に登録先を書く。途中で落ちても、次の登録で
17
+ * タグから要望を見つけて台帳を直す(孤立・重複を残さない)。開いている登録先があれば案内し、閉じた要望からの作り直しは明示させる
18
+ */
19
+ export class ImprovementError extends Error {
20
+ code;
21
+ existing;
22
+ constructor(code, message, existing) {
23
+ super(message);
24
+ this.code = code;
25
+ this.existing = existing;
26
+ }
27
+ }
28
+ const KIND_LABEL = { unset: "品質基準が未設定", invalid: "品質基準が読めない", violated: "レビューで確かめた違反", undetermined: "レビューで判断できなかった", exempt: "理由つきの除外" };
29
+ function hashOf(source, findings) {
30
+ return createHash("sha256").update(JSON.stringify([source, findings.map((f) => [f.key, f.kind, f.version, f.reason, f.evidence])])).digest("hex").slice(0, 16);
31
+ }
32
+ /** 診断(読むだけ) */
33
+ export async function diagnoseQuality(ctx, source) {
34
+ const ws = ctx.ws;
35
+ const findings = [];
36
+ const notes = [];
37
+ const pushSettings = (state, version, problems) => {
38
+ if (state === "unset")
39
+ findings.push({ key: "quality:unset", kind: "unset", version, target: "project", reason: "プロジェクトの品質基準が未設定です(初めて作ったときの状態に任せています)", evidence: ["project.yaml"], suggested: true });
40
+ if (state === "invalid")
41
+ findings.push({ key: "quality:invalid", kind: "invalid", version, target: "project", reason: `project.yaml の品質基準が読めません: ${(problems ?? []).join(" / ")}`, evidence: ["project.yaml"], suggested: true });
42
+ };
43
+ if (source.type === "project") {
44
+ const q = ws.project.quality ?? { state: "unset" };
45
+ const version = ws.project.qualityVersion ?? "";
46
+ pushSettings(q.state, version, q.state === "invalid" ? q.problems : undefined);
47
+ if (q.state === "set") {
48
+ for (const s of q.config.standards.filter((x) => x.exempt)) {
49
+ findings.push({ key: `${s.id}:project:exempt`, kind: "exempt", quality: s.id, qualityText: s.text, check: checkLine(s.check), version, target: "project", reason: `適用から除外しています: ${s.exempt.reason}`, evidence: ["project.yaml"], suggested: false });
50
+ }
51
+ if (!q.config.standards.length)
52
+ notes.push("品質基準は意図して空です");
53
+ }
54
+ }
55
+ else if (source.type === "task-review") {
56
+ const key = ctx.taskReview.key(source.request, source.task);
57
+ const rec = await ws.taskReviews.get(key, source.run).catch(() => undefined);
58
+ if (!rec)
59
+ throw new ImprovementError("not_found", `タスクのレビューがありません: ${key}/${source.run}`);
60
+ const q = rec.input.quality;
61
+ const target = `task:${key}`;
62
+ if (!q)
63
+ notes.push("この記録は品質を評価していません(品質基準を材料に入れる前の記録です)");
64
+ else if (q.latest.state !== "set")
65
+ pushSettings(q.latest.state, q.latest.version, q.latest.problems);
66
+ else {
67
+ for (const r of rec.result?.quality ?? []) {
68
+ if (r.verdict !== "violated" && r.verdict !== "undetermined")
69
+ continue;
70
+ const s = q.applies.find((x) => x.id === r.standard);
71
+ findings.push({ key: `${r.standard}:${target}:${r.verdict}`, kind: r.verdict, quality: r.standard, qualityText: s?.text, check: s ? checkLine(s.check) : undefined, version: q.latest.version, target, reason: r.reason, evidence: r.evidence, suggested: r.verdict === "violated" });
72
+ }
73
+ for (const s of q.exempt)
74
+ findings.push({ key: `${s.id}:${target}:exempt`, kind: "exempt", quality: s.id, qualityText: s.text, version: q.latest.version, target, reason: `適用から除外しています: ${s.exempt?.reason ?? ""}`, evidence: [], suggested: false });
75
+ }
76
+ if (rec.run.status !== "completed")
77
+ notes.push(`このレビューは完了していません(${rec.run.status})`);
78
+ }
79
+ else {
80
+ const rec = await ws.milestoneReviews.get(source.milestone, source.run).catch(() => undefined);
81
+ if (!rec)
82
+ throw new ImprovementError("not_found", `マイルストーンレビューがありません: ${source.milestone}/${source.run}`);
83
+ const q = rec.input?.quality;
84
+ const target = `milestone:${source.milestone}`;
85
+ if (!q)
86
+ notes.push("この記録は品質を評価していません(品質基準を材料に入れる前の記録です)");
87
+ else if (q.state !== "set")
88
+ pushSettings(q.state, q.version, q.problems);
89
+ else {
90
+ for (const r of rec.result?.quality ?? []) {
91
+ if (r.verdict !== "violated" && r.verdict !== "undetermined")
92
+ continue;
93
+ const s = q.standards?.find((x) => x.id === r.standard);
94
+ findings.push({ key: `${r.standard}:${target}:${r.verdict}`, kind: r.verdict, quality: r.standard, qualityText: s?.text, check: s ? checkLine(s.check) : undefined, version: q.version, target, reason: `${r.regression ? "(品質の低下)" : ""}${r.reason}`, evidence: r.evidence, suggested: r.verdict === "violated" });
95
+ }
96
+ for (const s of (q.standards ?? []).filter((x) => x.exempt))
97
+ findings.push({ key: `${s.id}:${target}:exempt`, kind: "exempt", quality: s.id, qualityText: s.text, version: q.version, target, reason: `適用から除外しています: ${s.exempt.reason}`, evidence: [], suggested: false });
98
+ }
99
+ }
100
+ const ledger = await readLedger(ws.dataDir);
101
+ const registered = {};
102
+ for (const f of findings) {
103
+ const e = ledger.entries[f.key];
104
+ if (!e?.request)
105
+ continue;
106
+ const r = ws.requests.get(e.request);
107
+ registered[f.key] = { request: e.request, ...(r ? { title: r.title, status: r.status } : {}) };
108
+ }
109
+ return { source, findings, hash: hashOf(source, findings), registered, notes };
110
+ }
111
+ const sourceLine = (s) => s.type === "project" ? "プロジェクトの品質基準の設定" : s.type === "task-review" ? `タスクのレビュー ${s.request}/${s.task} の ${s.run}` : `マイルストーンレビュー ${s.milestone} の ${s.run}`;
112
+ /** 選んだ不足から要望の原稿を作る(読むだけ) */
113
+ export function improvementDraft(d, keys) {
114
+ const picked = d.findings.filter((f) => keys.includes(f.key));
115
+ if (!picked.length)
116
+ throw new ImprovementError("no_findings", "改善する不足を選んでください");
117
+ const one = picked.length === 1 ? picked[0] : undefined;
118
+ const title = one
119
+ ? one.kind === "unset"
120
+ ? "プロジェクトの品質基準を決める"
121
+ : one.kind === "invalid"
122
+ ? "プロジェクトの品質基準の設定を直す"
123
+ : one.kind === "exempt"
124
+ ? `品質基準 ${one.quality} の除外を見直す`
125
+ : `品質基準 ${one.quality} の${one.kind === "violated" ? "違反を直す" : "確認の方法を整える"}(${one.qualityText ?? ""})`
126
+ : `品質の改善(${picked.map((f) => f.quality ?? f.kind).join(", ")})`;
127
+ const items = picked.map((f) => [
128
+ `### ${f.quality ? `${f.quality} ${f.qualityText ?? ""}` : KIND_LABEL[f.kind]}`,
129
+ `- 種類: ${KIND_LABEL[f.kind]}(対象: ${f.target}・品質基準の版 ${f.version || "なし"})`,
130
+ ...(f.check ? [`- 確認の方法: ${f.check}`] : []),
131
+ `- 指摘: ${f.reason}`,
132
+ ...(f.evidence.length ? [`- 根拠: ${f.evidence.join(", ")}`] : []),
133
+ `- 目指す差: ${f.kind === "unset" ? "プロジェクトとして守る最低限の品質基準が明記されている" : f.kind === "invalid" ? "project.yaml の品質基準が読める" : f.kind === "exempt" ? "除外の理由が今も妥当か判断し、要るなら適用する" : f.kind === "violated" ? "この品質基準を満たす" : "この品質基準を満たしているか確かめられる(確認の方法・材料を整える)"}`,
134
+ ].join("\n"));
135
+ const body = [
136
+ "## 目的",
137
+ "プロジェクトの品質基準に対する不足を解消する。",
138
+ "",
139
+ "## 現状(診断)",
140
+ `出典: ${sourceLine(d.source)}`,
141
+ "",
142
+ ...items.flatMap((x) => [x, ""]),
143
+ "## 完了条件の案",
144
+ ...picked.map((f) => `- ${f.quality ? `${f.quality}: ` : ""}${f.kind === "violated" ? "違反を直し、確認の方法で確かめた結果(コマンド・コミット・範囲)を証拠に残す" : f.kind === "undetermined" ? "確かめられる状態にし、確かめた結果を証拠に残す" : f.kind === "unset" ? "品質基準を設定する(p3 quality / 設定の「品質基準」)" : f.kind === "invalid" ? "project.yaml の quality を直して読めるようにする" : "除外を続けるか適用するかを決めて設定に残す"}`),
145
+ "",
146
+ "## 注記",
147
+ "- この原稿は P3 が診断から作った資料です。P3 は検査を実行していません(判断できないは未導入という意味ではありません)。",
148
+ ].join("\n");
149
+ return { title, body };
150
+ }
151
+ const ledgerPath = (dataDir) => join(dataDir, "quality-improvements.json");
152
+ export const tokenTag = (token) => `quality-improvement:${token}`;
153
+ async function readLedger(dataDir) {
154
+ const text = await readFile(ledgerPath(dataDir), "utf8").catch(() => "");
155
+ if (!text)
156
+ return { version: 1, entries: {} };
157
+ try {
158
+ const v = JSON.parse(text);
159
+ return v && typeof v.entries === "object" ? v : { version: 1, entries: {} };
160
+ }
161
+ catch {
162
+ throw new ImprovementError("invalid", `quality-improvements.json が読めません(${ledgerPath(dataDir)})。直すか退けてからやり直してください`);
163
+ }
164
+ }
165
+ const writeLedger = (dataDir, l) => writeFileAtomic(ledgerPath(dataDir), `${JSON.stringify(l, null, 2)}\n`);
166
+ const CLOSED = ["done", "rejected"];
167
+ /**
168
+ * 明示して登録する。hash は原稿を作った診断の版。reopenClosed: 閉じた要望が登録先の不足から作り直す。
169
+ * 開いている登録先があれば existing(作らない)。途中で落ちた予約は、タグから要望を見つけて台帳を直す
170
+ */
171
+ export async function registerImprovement(ctx, input, actor) {
172
+ const title = input.title.trim();
173
+ if (!title)
174
+ throw new ImprovementError("invalid", "要望の題を書いてください");
175
+ return withFileLock(join(ctx.ws.dataDir, ".quality-improvements.lock"), async () => {
176
+ const d = await diagnoseQuality(ctx, input.source);
177
+ if (d.hash !== input.hash)
178
+ throw new ImprovementError("diagnosis_changed", "原稿を作った後で診断(品質基準・レビューの結果)が変わりました。もう一度確かめてから登録してください");
179
+ const unknown = input.keys.filter((k) => !d.findings.some((f) => f.key === k));
180
+ if (!input.keys.length)
181
+ throw new ImprovementError("no_findings", "改善する不足を選んでください");
182
+ if (unknown.length)
183
+ throw new ImprovementError("bad_key", `診断に無い不足です: ${unknown.join(", ")}`);
184
+ const ledger = await readLedger(ctx.ws.dataDir);
185
+ // 途中で落ちた予約: token のタグを付けた要望があれば台帳を直す
186
+ for (const k of input.keys) {
187
+ const e = ledger.entries[k];
188
+ if (e && !e.request) {
189
+ const found = ctx.ws.requests.list().find((r) => r.tags.includes(tokenTag(e.token)));
190
+ if (found)
191
+ ledger.entries[k] = { ...e, request: found.id, registeredAt: e.registeredAt ?? new Date().toISOString() };
192
+ }
193
+ }
194
+ await writeLedger(ctx.ws.dataDir, ledger);
195
+ const open = input.keys.filter((k) => {
196
+ const id = ledger.entries[k]?.request;
197
+ const r = id ? ctx.ws.requests.get(id) : undefined;
198
+ return r && !CLOSED.includes(r.status);
199
+ });
200
+ if (open.length) {
201
+ const id = ledger.entries[open[0]].request;
202
+ throw new ImprovementError("existing", `この不足には登録した要望があります: ${id}(${ctx.ws.requests.get(id)?.title ?? ""})`, { request: id, keys: open });
203
+ }
204
+ const closed = input.keys.filter((k) => ledger.entries[k]?.request && !open.includes(k));
205
+ if (closed.length && !input.reopenClosed) {
206
+ const id = ledger.entries[closed[0]].request;
207
+ throw new ImprovementError("closed_existing", `この不足は閉じた要望 ${id} で扱いました。作り直すなら明示してください(--reopen / 画面のチェック)`, { request: id, keys: closed });
208
+ }
209
+ // 予約 → 要望を作る(token のタグ)→ 登録先を書く
210
+ const token = randomBytes(6).toString("hex");
211
+ const now = new Date().toISOString();
212
+ for (const k of input.keys)
213
+ ledger.entries[k] = { token, reservedAt: now, source: input.source };
214
+ await writeLedger(ctx.ws.dataDir, ledger);
215
+ const r = await createRequest(ctx, { title, body: input.body, tags: [tokenTag(token)] }, actor);
216
+ for (const k of input.keys)
217
+ ledger.entries[k] = { ...ledger.entries[k], request: r.id, registeredAt: new Date().toISOString() };
218
+ await writeLedger(ctx.ws.dataDir, ledger);
219
+ return { request: r, keys: input.keys };
220
+ });
221
+ }
@@ -1,4 +1,13 @@
1
+ import { acceptanceChanged, applyAcceptanceOps } from "../shared/acceptance.js";
2
+ import { readManual } from "./metrics/manual.js";
3
+ import { applyBlockOp, checkBlockedStatus } from "../shared/taskBlock.js";
4
+ import { qualityCriteria, standardHash, taskQualityDiff } from "../shared/quality.js";
5
+ import { answersKey, applySourceOps, makeAnswer, putAnswer, requestSubject, RequirementInputError, settleSources, sourceSeq, sourcesKey, } from "../shared/requirementSource.js";
1
6
  import { defaultRepo } from "../shared/workTarget.js";
7
+ import { appendCompletion, COMPLETION_SKIPPED, requestCompletionRecord, requestTriggers, taskCompletionRecord, taskTriggers } from "../shared/completionRecord.js";
8
+ import { captureRefs } from "./completionRefs.js";
9
+ import { appendRework, reworkOf, REWORK_SKIPPED } from "../shared/reworkHistory.js";
10
+ import { applyPremiseOp, PremiseInputError } from "../shared/reviewCandidate.js";
2
11
  import { withArchiveCheck, withChildOrder, withNewChild, withParentChange } from "./hierarchy.js";
3
12
  import { checkStatusChange, reopenAncestors, reopenIfNeeded } from "./requestStatus.js";
4
13
  import { startWarnings } from "./supersede.js";
@@ -13,6 +22,76 @@ import { checkRepoTarget, ensureWorkstreams } from "./workTargets.js";
13
22
  /** 入力が規則に合わない(何も書いていない)。CLI は使い方の誤り、API は 400 */
14
23
  export class OpRuleError extends Error {
15
24
  }
25
+ /** 品質基準を受け入れ基準に取り込む操作(未設定・読めない設定なら無し) */
26
+ export function qualityOpsFor(ctx, repo, choice) {
27
+ const q = ctx.ws.project.quality;
28
+ if (q?.state !== "set" || choice === "none")
29
+ return [];
30
+ if (choice === "auto" && !repo)
31
+ return [];
32
+ return qualityCriteria(q.config, ctx.ws.project.qualityVersion ?? "", { repo, ...(choice === "auto" ? {} : { ids: choice }) }).map((c) => ({ op: "add", text: c.text, quality: c.quality }));
33
+ }
34
+ /**
35
+ * 今の品質基準との差分から、明示して選んだものを受け入れ基準に取り込む(add は足す、change は文と出典を直す、remove・exempt は消す)。
36
+ * keys: "<kind>:<品質 ID>"(省くと edited 以外の全部)。書く直前に読み直した値に当てる。プロジェクトの設定を変えただけではタスクは変わらない
37
+ */
38
+ export async function importQuality(ctx, rid, tid, keys, opts = {}) {
39
+ const t = ctx.ws.tasksOf(rid).require(tid);
40
+ const diff = taskQualityDiff(t.acceptanceCriteria ?? [], ctx.ws.project.quality, t.repo).filter((d) => d.kind !== "edited");
41
+ const chosen = keys ? diff.filter((d) => keys.includes(`${d.kind}:${d.quality}`)) : diff;
42
+ if (keys) {
43
+ const unknown = keys.filter((k) => !diff.some((d) => `${d.kind}:${d.quality}` === k));
44
+ if (unknown.length)
45
+ throw new OpRuleError(`取り込める差分にありません: ${unknown.join(", ")}(今の差分は p3 criteria ${t.id} quality で見る)`);
46
+ }
47
+ if (!chosen.length)
48
+ throw new OpRuleError(`${t.ref} に取り込む品質基準の差分はありません`);
49
+ const q = ctx.ws.project.quality;
50
+ const version = ctx.ws.project.qualityVersion ?? "";
51
+ const config = q?.state === "set" ? q.config : { standards: [] };
52
+ const hashOf = (id) => standardHash(config.standards.find((s) => s.id === id));
53
+ const acceptance = chosen.map((d) => {
54
+ if (d.kind === "add")
55
+ return { op: "add", text: d.text, quality: { id: d.quality, hash: hashOf(d.quality), version } };
56
+ if (d.kind === "change")
57
+ return { op: "edit", id: d.criterion, text: d.text, quality: { id: d.quality, hash: hashOf(d.quality), version } };
58
+ return { op: "remove", id: d.criterion };
59
+ });
60
+ const r = await updateTask(ctx, rid, tid, { acceptance }, opts);
61
+ return { ...r, applied: chosen.map((d) => `${d.kind}:${d.quality}`) };
62
+ }
63
+ /** 書く必要が無い(更新の中から抜けるため。外には出さない) */
64
+ class NoChange extends Error {
65
+ }
66
+ /** 済みを外した理由(基準・証拠の中身が変わった) */
67
+ export const CHECK_CLEARED_BY_ACCEPTANCE = "受け入れ基準か証拠の中身が変わったため、人の「済み」を外しました(もう一度確かめてください)";
68
+ /** 完了の記録を作るときの周りの値(品質は今の project.yaml、参照先は書く前に取ったもの) */
69
+ const completionContext = (ctx, at, by, refs) => ({
70
+ at,
71
+ ...(by ? { by } : {}),
72
+ quality: ctx.ws.project.quality,
73
+ qualityVersion: ctx.ws.project.qualityVersion,
74
+ ...(refs ? { refs } : {}),
75
+ });
76
+ /**
77
+ * タスクを書いた後の値(final)に、足すべき完了の記録を足した patch の部分(無ければ空)。rev は書いた後の rev。
78
+ * 記録が壊れていて足せなければ skipped に理由を入れ、記録の項目には触れない(元の値のまま書き戻す)
79
+ */
80
+ function taskCompletionPatch(ctx, rid, prev, final, rev, acceptanceChanged, c) {
81
+ const triggers = taskTriggers(prev, final, acceptanceChanged);
82
+ if (!triggers.length)
83
+ return { patch: {} };
84
+ const request = ctx.ws.requests.get(rid);
85
+ const cc = completionContext(ctx, c.at, c.by, c.refs);
86
+ let state = final;
87
+ for (const trigger of triggers) {
88
+ const list = appendCompletion(state, (id) => taskCompletionRecord(id, trigger, final, rev, request, cc));
89
+ if (!list)
90
+ return { patch: {}, skipped: COMPLETION_SKIPPED };
91
+ state = { completionRecords: list };
92
+ }
93
+ return { patch: { completionRecords: state.completionRecords } };
94
+ }
16
95
  function changed(ctx, kind, request, ref) {
17
96
  ctx.ws.emit({ type: "changed", kind, request, ref });
18
97
  }
@@ -44,6 +123,14 @@ export async function checkMilestoneRemoval(ctx, next) {
44
123
  if (reviewed.length) {
45
124
  throw new OpRuleError(`レビューの履歴のあるマイルストーンは消せません(ID も変えられません): ${reviewed.join(", ")}(milestone-reviews/<ID>/ に残っています)`);
46
125
  }
126
+ // 人が記録した指標の値(読めなければ参照があるか分からないので消さない)
127
+ const manual = await readManual(ctx.ws.dataDir);
128
+ if (manual.problem)
129
+ throw new OpRuleError(`指標の記録(metrics/manual.json)が読めないため、マイルストーンを消せるか分かりません: ${manual.problem}`);
130
+ const measured = [...new Set(manual.records.filter((r) => removed.includes(r.scope)).map((r) => r.scope))];
131
+ if (measured.length) {
132
+ throw new OpRuleError(`指標の値を記録したマイルストーンは消せません(ID も変えられません): ${measured.join(", ")}(p3 metrics --milestone <ID> で確かめ、要らなければ p3 metrics rm で消してから)`);
133
+ }
47
134
  }
48
135
  /** 要望を変えた後: 配下に未完了ができたら対応済の祖先を進行中に戻し(変更通知も)、完了済の祖先は警告にする */
49
136
  async function afterRequestWrite(ctx, rid, actor) {
@@ -72,25 +159,44 @@ async function afterTaskWrite(ctx, rid, task, repo, actor) {
72
159
  * タスクを作る。repo: 省くと作業先にできる参照先が1つならそれ(ほかは作業先なし)、null は作業先なし。
73
160
  * 作業先とリポジトリごとの成果物の参照先は、作業先にできるものだけ(書く前に断る)
74
161
  */
75
- export async function createTask(ctx, rid, input, actor) {
162
+ export async function createTask(ctx, rid, { criteria, quality, ...input }, actor) {
76
163
  ctx.ws.requests.require(rid);
77
164
  const repo = "repo" in input ? (input.repo ?? null) : defaultRepo(ctx.ws.project);
78
165
  checkRepoTarget(ctx.ws, repo);
79
166
  for (const o of input.repoOutputs ?? [])
80
167
  checkRepoTarget(ctx.ws, o.repo);
81
- const task = await ctx.ws.tasksOf(rid).create({ ...input, repo, status: input.status ?? "todo" }, actor);
168
+ // 受け入れ基準は文の並びで受け取り、ID(A1, A2, ...)はここで振る(基準・証拠をそのまま渡す道は持たない)
169
+ // 停止は作るときには付けない(作業中にしてから block で付ける)
170
+ // 完了の記録は p3 が作る(値をそのまま書く道は持たない)
171
+ const { acceptanceCriteria: _c, acceptanceEvidence: _e, acceptanceSeq: _s, acceptanceSources: _as, acceptanceProblems: _p, block: _b, blockHistory: _bh, blockProblems: _bp, completionRecords: _cr, completionProblems: _cp, reworkHistory: _rh, reworkProblems: _rp, ...plain } = input;
172
+ // 品質基準: 作業先があれば当てはまるものを取り込む(auto)。作業先なしは明示したものだけ。none は取り込まない
173
+ const fromQuality = qualityOpsFor(ctx, repo, quality ?? "auto");
174
+ const ops = [...(criteria ?? []).map((text) => ({ op: "add", text })), ...fromQuality];
175
+ const now = new Date().toISOString();
176
+ const acceptance = ops.length ? applyAcceptanceOps({}, ops, { now, actor }) : {};
177
+ const status = input.status ?? "todo";
178
+ // 完了で作るなら、完了の記録を最初の記録として足す(参照先は書く前に取る)
179
+ const refs = status === "done" ? await captureRefs(ctx.ws.refs()) : undefined;
180
+ const draft = { ...plain, ...acceptance, repo, status };
181
+ const { patch: records } = taskCompletionPatch(ctx, rid, undefined, draft, 1, false, { at: now, by: actor, refs });
182
+ const task = await ctx.ws.tasksOf(rid).create({ ...plain, ...acceptance, repo, status, ...records }, actor);
82
183
  const { ancestorWarnings, ...after } = await afterTaskWrite(ctx, rid, task, repo, actor);
83
184
  return { task, warnings: ancestorWarnings, ...after };
84
185
  }
85
186
  /**
86
187
  * タスクを変える。checked: 人の「済み」を付ける / 外す(付けられるのは完了したタスクだけ)。
188
+ * acceptance: 受け入れ基準・証拠への操作(shared/acceptance.ts。書く直前に読み直した今の値に当て、規則に合わなければ何も書かない)。
189
+ * 済みのタスクの基準・証拠の中身が変わったら済みを外し、checkCleared に理由を返す(同じ値の再保存・成果物だけの追加では外さない)。
87
190
  * 置き換えられたタスクを作業中にすると warnings を返す(変更はする)
88
191
  */
89
192
  export async function updateTask(ctx, rid, tid, patch, opts = {}) {
90
193
  const col = ctx.ws.tasksOf(rid);
91
194
  const cur = col.require(tid);
92
- const { checked, ...rest } = patch;
93
- const next = { ...rest };
195
+ const { checked, acceptance, blockOp, ...rest } = patch;
196
+ // 基準・証拠は操作(acceptance)、停止は操作(blockOp)でだけ変える(値・履歴をそのまま書く道は持たない)
197
+ // 完了の記録は p3 が作る(値をそのまま書く道は持たない)
198
+ const { acceptanceCriteria: _c, acceptanceEvidence: _e, acceptanceSeq: _s, acceptanceSources: _as, acceptanceProblems: _p, block: _b, blockHistory: _bh, blockProblems: _bp, completionRecords: _cr, completionProblems: _cp, reworkHistory: _rh, reworkProblems: _rp, ...plain } = rest;
199
+ const next = { ...plain };
94
200
  if ("repo" in patch) {
95
201
  checkRepoTarget(ctx.ws, patch.repo);
96
202
  next.repo = patch.repo ?? null;
@@ -103,9 +209,66 @@ export async function updateTask(ctx, rid, tid, patch, opts = {}) {
103
209
  next.checkedAt = checked ? new Date().toISOString() : undefined;
104
210
  }
105
211
  const warnings = startWarnings(ctx.ws, cur.ref, cur.status, next.status);
106
- const task = await col.update(tid, next, opts);
212
+ let checkCleared;
213
+ let completionSkipped;
214
+ let reworkSkipped;
215
+ // 完了・済みになりうる更新なら、参照先を書く前に取る(ロックの外。取得時刻を残す)
216
+ const refs = next.status === "done" || checked === true ? await captureRefs(ctx.ws.refs()) : undefined;
217
+ // 停止の操作だけで何も変わらない(同じ内容の付け直し・付いていない解除)なら書かない(rev を上げない)
218
+ const onlyBlock = !!blockOp && !acceptance?.length && Object.keys(next).length === 0;
219
+ let unchanged;
220
+ const write = () => col.update(tid, (fresh) => {
221
+ const now = new Date().toISOString();
222
+ let out = next;
223
+ // 停止: 書く直前に読み直した値と、更新した後の状態で確かめる(止まったままの移動・作業中でない付与は断る)
224
+ const status = next.status ?? fresh.status;
225
+ const blockTo = blockOp ? applyBlockOp(fresh, blockOp, { now, actor: opts.actor, status }) : undefined;
226
+ if (onlyBlock && !blockTo) {
227
+ unchanged = fresh;
228
+ throw new NoChange();
229
+ }
230
+ if (blockTo)
231
+ out = { ...out, ...blockTo };
232
+ checkBlockedStatus(fresh.status, status, blockTo ? blockTo.block : fresh.block, fresh.ref);
233
+ // 書いた後の値で完了の記録を足す(同時に変えた基準・証拠は変えた後の内容を写す)
234
+ const withRecords = (o, contentChanged) => {
235
+ const final = { ...fresh, ...o };
236
+ if (final.status !== "done")
237
+ final.checkedAt = undefined;
238
+ const r = taskCompletionPatch(ctx, rid, fresh, final, fresh.rev + 1, contentChanged, { at: now, by: opts.actor, refs });
239
+ completionSkipped = r.skipped;
240
+ // 手戻り(済みの解除・完了からの再開)。書く直前の値と保存する値で決める
241
+ const rw = reworkOf(fresh, final, { explicitUncheck: checked === false, acceptanceChanged: contentChanged });
242
+ let history = {};
243
+ if (rw) {
244
+ const list = appendRework(fresh, { at: now, ...(opts.actor ? { by: opts.actor } : {}), rev: fresh.rev + 1, ...rw });
245
+ if (list)
246
+ history = { reworkHistory: list };
247
+ else
248
+ reworkSkipped = REWORK_SKIPPED;
249
+ }
250
+ return { ...o, ...r.patch, ...history };
251
+ };
252
+ if (!acceptance?.length)
253
+ return withRecords(out, false);
254
+ const changedTo = applyAcceptanceOps(fresh, acceptance, { now, actor: opts.actor, requestSources: ctx.ws.requests.get(rid)?.requirementSources ?? [] });
255
+ if (!acceptanceChanged(fresh, changedTo))
256
+ return withRecords(out, false);
257
+ // 済みの後に中身が変わった(同じ操作で済みを付け直すときは外さない)
258
+ const clear = !!fresh.checkedAt && !("checkedAt" in next);
259
+ if (clear)
260
+ checkCleared = CHECK_CLEARED_BY_ACCEPTANCE;
261
+ return withRecords({ ...out, ...changedTo, ...(clear ? { checkedAt: undefined } : {}) }, true);
262
+ }, opts);
263
+ const task = await write().catch((e) => {
264
+ if (e instanceof NoChange && unchanged)
265
+ return unchanged;
266
+ throw e;
267
+ });
268
+ if (unchanged && task === unchanged)
269
+ return { task, warnings };
107
270
  const { ancestorWarnings, ...after } = await afterTaskWrite(ctx, rid, task, patch.repo, opts.actor);
108
- return { task, warnings: [...warnings, ...ancestorWarnings], ...after };
271
+ return { task, warnings: [...warnings, ...ancestorWarnings], ...after, ...(checkCleared ? { checkCleared } : {}), ...(completionSkipped ? { completionSkipped } : {}), ...(reworkSkipped ? { reworkSkipped } : {}) };
109
272
  }
110
273
  /** タスクをアーカイブする(.archive/ へ移す。消さない) */
111
274
  export async function archiveTask(ctx, rid, tid) {
@@ -133,23 +296,124 @@ export async function createRequest(ctx, input, actor) {
133
296
  * 要望を変える。対応済にするのは全タスクが完了のときだけ(requestStatus.ts)。
134
297
  * parent を含むなら親の付け替え(undefined で外す)を関係のロックの中で確かめてから書く(hierarchy.ts)
135
298
  */
136
- export async function updateRequest(ctx, rid, patch, opts = {}) {
299
+ export async function updateRequest(ctx, rid, input, opts = {}) {
300
+ // 要求の根拠・回答は操作(updateRequirement・answerClarification)でだけ変える(値をそのまま書く道は持たない)
301
+ // 完了の記録も p3 が作る
302
+ const { requirementSources: _rs, requirementSeq: _sq, clarifyAnswers: _ca, requirementProblems: _rp, completionRecords: _cr, completionProblems: _cp, premiseChanges: _pc, premiseProblems: _pp, ...patch } = input;
137
303
  checkMilestone(ctx, patch.milestone);
138
304
  await checkStatusChange(ctx.ws, rid, patch.status);
305
+ // 対応済・完了済になりうる更新なら、参照先を書く前に取る
306
+ const refs = patch.status === "resolved" || patch.status === "done" ? await captureRefs(ctx.ws.refs()) : undefined;
307
+ let completionSkipped;
139
308
  // 状態か親が変わったら、未完了になった配下の分だけ祖先を戻す
140
309
  const after = async (r) => (patch.status !== undefined || "parent" in patch ? withAncestors(r, await afterRequestWrite(ctx, r.id, opts.actor)) : r);
310
+ // 題・本文を変えたら、要望の根拠の記録の確認は効かなくなる(書く直前に読み直した値で、履歴へ移す)
311
+ // 対応済・完了済にしたら、書いた後の値で完了の記録を足す(判定に使ったタスクと子の要望を写す)
312
+ const write = () => ctx.ws.requests.update(rid, (fresh) => {
313
+ const p = withSettledSources(fresh, patch);
314
+ const final = { ...fresh, ...p };
315
+ const triggers = requestTriggers(fresh.status, final.status);
316
+ if (!triggers.length)
317
+ return p;
318
+ const at = new Date().toISOString();
319
+ const parts = { tasks: ctx.ws.tasksOf(rid).list(), children: ctx.ws.requests.list().filter((r) => r.parent === rid) };
320
+ const list = appendCompletion(fresh, (id) => requestCompletionRecord(id, triggers[0], final, fresh.rev + 1, parts, completionContext(ctx, at, opts.actor, refs)));
321
+ if (!list) {
322
+ completionSkipped = COMPLETION_SKIPPED;
323
+ return p;
324
+ }
325
+ return { ...p, completionRecords: list };
326
+ }, opts);
327
+ const skipped = (r) => (completionSkipped ? { ...r, completionSkipped } : r);
141
328
  if (!("parent" in patch)) {
142
- const r = await ctx.ws.requests.update(rid, patch, opts);
329
+ const r = await write();
143
330
  changed(ctx, "request", r.id);
144
- return after(r);
331
+ return skipped(await after(r));
145
332
  }
146
- const { result: r, previous } = await withParentChange(ctx.ws, rid, patch.parent, () => ctx.ws.requests.update(rid, patch, opts));
333
+ const { result: r, previous } = await withParentChange(ctx.ws, rid, patch.parent, write);
147
334
  changed(ctx, "request", r.id);
148
335
  // 前と今の親の子の一覧も変わる
149
336
  for (const p of new Set([previous, r.parent]))
150
337
  if (p && p !== r.id)
151
338
  changed(ctx, "request", p);
152
- return after(r);
339
+ return skipped(await after(r));
340
+ }
341
+ /** 題・本文の変更で効かなくなった要望の根拠の確認を履歴へ移した patch(変わらなければ patch のまま) */
342
+ function withSettledSources(fresh, patch) {
343
+ if ((patch.title === undefined && patch.body === undefined) || !fresh.requirementSources?.length || fresh.requirementProblems?.length)
344
+ return patch;
345
+ const subject = requestSubject({ title: patch.title ?? fresh.title, body: patch.body ?? fresh.body });
346
+ const settled = settleSources(fresh.requirementSources, () => subject, new Date().toISOString());
347
+ return sourcesKey(settled) === sourcesKey(fresh.requirementSources) ? patch : { ...patch, requirementSources: settled };
348
+ }
349
+ /** 要望の根拠・回答が読めないときは変えない */
350
+ function checkRequirementReadable(r) {
351
+ if (r.requirementProblems?.length)
352
+ throw new RequirementInputError(`${r.id} の要求の根拠・回答のファイルの値が読めないため変えられません。request.md を直してください: ${r.requirementProblems.join(" / ")}`);
353
+ }
354
+ /**
355
+ * 要望の要求の根拠の記録を変える(shared/requirementSource.ts の操作。書く直前に読み直した値に当て、規則に合わなければ何も書かない)。
356
+ * 同じ値の再保存では書かない(rev を上げない)。expectedRev で競合を見る
357
+ */
358
+ export async function updateRequirement(ctx, rid, ops, opts = {}) {
359
+ if (!ops.length)
360
+ throw new RequirementInputError("根拠の記録への操作がありません");
361
+ let unchanged;
362
+ const r = await ctx.ws.requests
363
+ .update(rid, (fresh) => {
364
+ checkRequirementReadable(fresh);
365
+ const before = fresh.requirementSources ?? [];
366
+ const subject = requestSubject(fresh);
367
+ const { list, seq } = applySourceOps(before, ops, { now: new Date().toISOString(), actor: opts.actor, subjectOf: () => subject, seq: fresh.requirementSeq });
368
+ if (sourcesKey(list) === sourcesKey(before) && seq === (fresh.requirementSeq ?? sourceSeq(before))) {
369
+ unchanged = fresh;
370
+ throw new NoChange();
371
+ }
372
+ return { requirementSources: list.length ? list : undefined, requirementSeq: seq > 0 ? seq : undefined };
373
+ }, opts)
374
+ .catch((e) => {
375
+ if (e instanceof NoChange && unchanged)
376
+ return unchanged;
377
+ throw e;
378
+ });
379
+ if (r !== unchanged)
380
+ changed(ctx, "request", rid);
381
+ return r;
382
+ }
383
+ /**
384
+ * Preflight の確認事項に回答する(要望の clarifyAnswers に残す。過去の run と評価は書き換えない)。clarification は元の run の確認事項
385
+ * (呼ぶ側が run から取り出す)。回答しただけでは根拠の記録を確認記録ありにしない。answer が null なら回答を消す
386
+ */
387
+ export async function saveClarifyAnswer(ctx, rid, runId, q, input, opts = {}) {
388
+ let unchanged;
389
+ let saved;
390
+ const r = await ctx.ws.requests
391
+ .update(rid, (fresh) => {
392
+ checkRequirementReadable(fresh);
393
+ const cur = fresh.clarifyAnswers ?? [];
394
+ if (input === null) {
395
+ if (!cur.some((a) => a.run === runId && a.question === q.id))
396
+ throw new RequirementInputError(`${runId}/${q.id} への回答はありません`);
397
+ const next = cur.filter((a) => !(a.run === runId && a.question === q.id));
398
+ return { clarifyAnswers: next.length ? next : undefined };
399
+ }
400
+ saved = makeAnswer(runId, q, input, fresh.requirementSources ?? [], { now: new Date().toISOString(), actor: opts.actor });
401
+ const next = putAnswer(cur, saved);
402
+ if (answersKey(next) === answersKey(cur)) {
403
+ saved = cur.find((a) => a.run === runId && a.question === q.id);
404
+ unchanged = fresh;
405
+ throw new NoChange();
406
+ }
407
+ return { clarifyAnswers: next };
408
+ }, opts)
409
+ .catch((e) => {
410
+ if (e instanceof NoChange && unchanged)
411
+ return unchanged;
412
+ throw e;
413
+ });
414
+ if (r !== unchanged)
415
+ changed(ctx, "request", rid);
416
+ return { request: r, ...(saved ? { answer: saved } : {}) };
153
417
  }
154
418
  /**
155
419
  * 子の表示順を保存する(親の request.md の childOrder だけを書く。子・タスク・親子の所属は変えない)。ids は今の直下の子の完全な並び。
@@ -166,3 +430,22 @@ export async function archiveRequest(ctx, rid) {
166
430
  await withArchiveCheck(ctx.ws, rid, () => ctx.ws.requests.archive(rid));
167
431
  changed(ctx, "request", rid);
168
432
  }
433
+ /**
434
+ * 前提の変更を記録する(外部の規則の変更など。要望の premiseChanges に追記。shared/reviewCandidate.ts)。add: 対象(要望 ID・この要望の
435
+ * タスク ID・要望の根拠の ID)と理由・新しい条件 / ack: 変更を確かめたことを対象と条件の版つきで残す。過去の完了の記録・状態・済み・
436
+ * 基準・証拠は変えない。対象が無い・規則に合わない・rev の競合では何も書かない
437
+ */
438
+ export async function recordPremise(ctx, rid, op, opts = {}) {
439
+ let change;
440
+ const r = await ctx.ws.requests.update(rid, (fresh) => {
441
+ if (fresh.premiseProblems?.length)
442
+ throw new PremiseInputError(`${rid} の前提の変更の記録が読めないため足せません。request.md を直してください: ${fresh.premiseProblems.join(" / ")}`);
443
+ const tasks = ctx.ws.tasksOf(rid);
444
+ const exists = (t) => t === rid || !!tasks.get(t) || !!fresh.requirementSources?.some((s) => s.id === t);
445
+ const list = applyPremiseOp(fresh.premiseChanges ?? [], op, { now: new Date().toISOString(), actor: opts.actor, exists });
446
+ change = op.op === "add" ? list.at(-1) : list.find((c) => c.id === op.id);
447
+ return { premiseChanges: list };
448
+ }, opts);
449
+ changed(ctx, "request", rid);
450
+ return { request: r, change: change };
451
+ }