@infodb/p3 0.11.0 → 0.12.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 (101) hide show
  1. package/README.md +4 -1
  2. package/dist/web/assets/ImprovementDialog-kQaVBGWH.js +1 -0
  3. package/dist/web/assets/Outputs-_nU_p3nu.js +1 -0
  4. package/dist/web/assets/{RequestStatus-Bg1OLbRc.js → RequestStatus-RG-OVQYY.js} +1 -1
  5. package/dist/web/assets/{Tabs-DTmggzgg.js → Tabs-ew9i5SKX.js} +1 -1
  6. package/dist/web/assets/TagInput-BtlJTF7i.js +1 -0
  7. package/dist/web/assets/TaskDrawer-DW8GyJqI.js +6 -0
  8. package/dist/web/assets/_requestId-6Nb727dD.js +1 -0
  9. package/dist/web/assets/_requestId-BykTgPax.js +1 -0
  10. package/dist/web/assets/appCtx-CxDdXABS.js +1 -0
  11. package/dist/web/assets/archive-Ckh295Xe.js +1 -0
  12. package/dist/web/assets/board-BVAIjK-Y.js +1 -0
  13. package/dist/web/assets/done-BGfA-3MA.js +1 -0
  14. package/dist/web/assets/index-CgRU744I.css +2 -0
  15. package/dist/web/assets/index-DacQ0yl4.js +12 -0
  16. package/dist/web/assets/{new-9TKiNT4O.js → new-DVygWvVc.js} +1 -1
  17. package/dist/web/assets/outputs-B6xDsLZf.js +1 -0
  18. package/dist/web/assets/preload-helper-DyCqp21K.js +1 -0
  19. package/dist/web/assets/quality-Pu6EISAM.js +1 -0
  20. package/dist/web/assets/release-notes-CCpzyiNf.js +5 -0
  21. package/dist/web/assets/requestData-D5vBnuMh.js +1 -0
  22. package/dist/web/assets/routes-Q91zvNc0.js +4 -0
  23. package/dist/web/assets/settings-BzRgcmUm.js +1 -0
  24. package/dist/web/assets/taskReview-_WCgnQit.js +1 -0
  25. package/dist/web/assets/workTarget-C9c57JAO.js +30 -0
  26. package/dist/web/index.html +4 -4
  27. package/docs/architecture.md +315 -2
  28. package/docs/development.md +1 -1
  29. package/docs/how-to-use.md +184 -0
  30. package/docs/installation.md +5 -5
  31. package/lib/cli/args.js +45 -0
  32. package/lib/cli/help.js +36 -1
  33. package/lib/cli/main.js +27 -3
  34. package/lib/cli/output.js +9 -1
  35. package/lib/cli/preflightCommands.js +7 -1
  36. package/lib/cli/project.js +3 -0
  37. package/lib/cli/qualityCommands.js +163 -0
  38. package/lib/cli/readOnly.js +2 -0
  39. package/lib/cli/requestCommands.js +12 -0
  40. package/lib/cli/showView.js +69 -3
  41. package/lib/cli/taskCommands.js +312 -17
  42. package/lib/cli/taskReviewCommands.js +178 -0
  43. package/lib/core/context.js +4 -1
  44. package/lib/core/milestoneReview/material.js +11 -1
  45. package/lib/core/milestoneReview/mockReviewer.js +1 -0
  46. package/lib/core/milestoneReview/review.js +70 -6
  47. package/lib/core/milestoneReview/service.js +29 -93
  48. package/lib/core/milestoneReview/store.js +12 -62
  49. package/lib/core/ops.js +9 -2
  50. package/lib/core/preflight/carryover.js +1 -1
  51. package/lib/core/preflight/engine.js +6 -0
  52. package/lib/core/preflight/instructions.js +18 -1
  53. package/lib/core/preflight/mockEngine.js +4 -0
  54. package/lib/core/preflight/service.js +45 -4
  55. package/lib/core/projectRegistry.js +3 -3
  56. package/lib/core/quality.js +21 -0
  57. package/lib/core/qualityImprovement.js +221 -0
  58. package/lib/core/requestOps.js +97 -6
  59. package/lib/core/reviewRuns.js +205 -0
  60. package/lib/core/store/archivedTasks.js +74 -0
  61. package/lib/core/store/collection.js +12 -2
  62. package/lib/core/store/normalize.js +16 -1
  63. package/lib/core/store/preflightStore.js +9 -1
  64. package/lib/core/store/projectFile.js +10 -0
  65. package/lib/core/store/workspace.js +33 -3
  66. package/lib/core/taskReview/material.js +452 -0
  67. package/lib/core/taskReview/mockReviewer.js +30 -0
  68. package/lib/core/taskReview/paths.js +15 -0
  69. package/lib/core/taskReview/review.js +305 -0
  70. package/lib/core/taskReview/service.js +187 -0
  71. package/lib/core/taskReview/store.js +214 -0
  72. package/lib/server/api/manifest.js +55 -4
  73. package/lib/server/api/milestoneReviewRoutes.js +4 -3
  74. package/lib/server/api/routes.js +145 -17
  75. package/lib/server/api/taskReviewRoutes.js +66 -0
  76. package/lib/server/server.js +2 -2
  77. package/lib/shared/acceptance.js +378 -0
  78. package/lib/shared/milestoneReview.js +2 -1
  79. package/lib/shared/quality.js +391 -0
  80. package/lib/shared/qualityImprovement.js +1 -0
  81. package/lib/shared/qualityTemplates.js +31 -0
  82. package/lib/shared/taskBlock.js +142 -0
  83. package/lib/shared/taskReview.js +56 -0
  84. package/package.json +1 -1
  85. package/skills/p3/SKILL.md +31 -2
  86. package/dist/web/assets/Outputs-ddwte0jj.js +0 -1
  87. package/dist/web/assets/TagInput-BHAgjLP7.js +0 -1
  88. package/dist/web/assets/TaskDrawer-Dz_5c2NH.js +0 -3
  89. package/dist/web/assets/_requestId-D9-gtIcG.js +0 -1
  90. package/dist/web/assets/_requestId-DzCNYvqf.js +0 -30
  91. package/dist/web/assets/appCtx-Cm24VpAf.js +0 -1
  92. package/dist/web/assets/board-MCHcZ-PU.js +0 -1
  93. package/dist/web/assets/done-zq10Bt08.js +0 -1
  94. package/dist/web/assets/index-Ce0ndpne.js +0 -12
  95. package/dist/web/assets/index-D68mkSnw.css +0 -2
  96. package/dist/web/assets/preload-helper-FBLw7u7x.js +0 -1
  97. package/dist/web/assets/release-notes-hK5XezLW.js +0 -5
  98. package/dist/web/assets/requestData-BnN7mctX.js +0 -1
  99. package/dist/web/assets/routes-usHwrrA0.js +0 -3
  100. package/dist/web/assets/settings-BVZDnL6O.js +0 -1
  101. package/dist/web/assets/workTarget-Cijqq4yH.js +0 -1
@@ -0,0 +1,214 @@
1
+ import { randomBytes } from "node:crypto";
2
+ import { lstat, mkdir, readdir, rm, writeFile } from "node:fs/promises";
3
+ import { dirname, join, resolve, sep } from "node:path";
4
+ import { REQUEST_ID, TASK_ID } from "../../shared/refs.js";
5
+ import { TASK_REVIEW_STATUSES, } from "../../shared/taskReview.js";
6
+ import { dirs, finishRunFile, readJson, ReviewStoreError, runStamp, updateRunFile, writeJson } from "../reviewRuns.js";
7
+ import { withFileLock } from "../store/fsutil.js";
8
+ import { safeRelPath } from "./paths.js";
9
+ /**
10
+ * タスクの AI レビューの履歴(要望のフォルダの中。要望をアーカイブすれば一緒に動き、タスクをアーカイブしても残る)。
11
+ *
12
+ * requests/<要望ID>/task-reviews/<タスクID>/<run>/input.json 固定した材料(作ったら変えない)
13
+ * requests/<要望ID>/task-reviews/<タスクID>/<run>/material/ 材料のファイル(差分・前後のコード。作ったら変えない)
14
+ * requests/<要望ID>/task-reviews/<タスクID>/<run>/run.json 実行の記録
15
+ * requests/<要望ID>/task-reviews/<タスクID>/<run>/review.json 結果(completed のときだけ。書き終えてから completed にする)
16
+ * requests/<要望ID>/task-reviews/.locks/<タスクID>.lock 状態を変えるときのロック(プロセス間。タスクごと)
17
+ *
18
+ * - キーは "<要望ID>/<タスクID>"。ID の形を確かめ、保存先の外を指すものは断る。同じ run は作り直さない
19
+ * - 保存・終わり・取消の規則はマイルストーンレビューと共通(reviewRuns.ts)
20
+ * - 結果はタスクのファイル(本文・証拠)には書かない。同じ OS の権限でファイルを直接書き換えることは防がない
21
+ */
22
+ export const TASK_REVIEWS_DIR = "task-reviews";
23
+ const RUN_ID = /^TR-\d{8}-\d{6}-[0-9a-f]{4}$/;
24
+ export function newTaskReviewRunId(now = new Date()) {
25
+ return `TR-${runStamp(now)}-${randomBytes(2).toString("hex")}`;
26
+ }
27
+ export function checkTaskReviewRunId(id) {
28
+ if (!RUN_ID.test(id))
29
+ throw new ReviewStoreError("bad_id", `タスクのレビューの run の ID ではありません: ${JSON.stringify(id)}(TR-YYYYMMDD-HHMMSS-xxxx)`);
30
+ }
31
+ /** キー(<要望ID>/<タスクID>)を分けて確かめる */
32
+ export function parseTaskReviewKey(key) {
33
+ const [rid, tid, extra] = key.split("/");
34
+ if (extra !== undefined || !rid || !tid || !REQUEST_ID.test(rid) || !TASK_ID.test(tid))
35
+ throw new ReviewStoreError("bad_id", `タスクの参照に使えません: ${JSON.stringify(key)}(<要望ID>/T001)`);
36
+ return { rid, tid };
37
+ }
38
+ export class TaskReviewStore {
39
+ requestsDir;
40
+ /** requestsDir: <data>/requests */
41
+ constructor(requestsDir) {
42
+ this.requestsDir = requestsDir;
43
+ }
44
+ within(...parts) {
45
+ const root = resolve(this.requestsDir);
46
+ const p = resolve(root, ...parts);
47
+ if (!p.startsWith(root + sep))
48
+ throw new ReviewStoreError("bad_id", `保存先の外を指します: ${parts.join("/")}`);
49
+ return p;
50
+ }
51
+ reviewsDir(rid) {
52
+ parseTaskReviewKey(`${rid}/T001`);
53
+ return this.within(rid, TASK_REVIEWS_DIR);
54
+ }
55
+ taskDir(key) {
56
+ const { rid, tid } = parseTaskReviewKey(key);
57
+ return this.within(rid, TASK_REVIEWS_DIR, tid);
58
+ }
59
+ runDir(key, run) {
60
+ checkTaskReviewRunId(run);
61
+ return join(this.taskDir(key), run);
62
+ }
63
+ materialDir(key, run) {
64
+ return join(this.runDir(key, run), "material");
65
+ }
66
+ /** タスクの状態を変えるときのロック(ほかのプロセスの開始・終わり・取消と1つずつにする。別のタスクは独立) */
67
+ withLock(key, fn) {
68
+ const { rid, tid } = parseTaskReviewKey(key);
69
+ return withFileLock(join(this.reviewsDir(rid), ".locks", `${tid}.lock`), fn, {
70
+ busyMessage: `${key} のレビューの記録を変えられませんでした(別のプロセスが使っています。少し待ってやり直してください)`,
71
+ });
72
+ }
73
+ /** run の ID(新しい順) */
74
+ async runIds(key) {
75
+ return (await dirs(this.taskDir(key))).filter((r) => RUN_ID.test(r)).sort().reverse();
76
+ }
77
+ async hasHistory(key) {
78
+ return (await this.runIds(key)).length > 0;
79
+ }
80
+ /** 履歴のあるタスク(アーカイブしたタスクも含む) */
81
+ async tasksWithHistory(rid) {
82
+ const out = [];
83
+ for (const d of await dirs(this.reviewsDir(rid)))
84
+ if (TASK_ID.test(d) && (await this.hasHistory(`${rid}/${d}`)))
85
+ out.push(d);
86
+ return out.sort((a, b) => a.localeCompare(b, undefined, { numeric: true }));
87
+ }
88
+ /**
89
+ * 新しい run を作る(材料のファイル・input.json・running の run.json)。同じ ID が既にあれば exists で断る(上書きしない)。
90
+ * 呼ぶ側がロックの中で呼ぶ(同じタスクで実行中の run を2つ作らないため)
91
+ */
92
+ async create(input, files, run) {
93
+ const key = `${run.request}/${run.task}`;
94
+ const dir = this.runDir(key, run.id);
95
+ const material = join(dir, "material");
96
+ // 書く前に全部のパスを確かめる(途中で断って作りかけを残さない)
97
+ const targets = [...files].map(([rel, data]) => {
98
+ const path = resolve(material, rel);
99
+ if (!safeRelPath(rel) || !path.startsWith(resolve(material) + sep))
100
+ throw new ReviewStoreError("bad_id", `材料のファイルのパスに使えません: ${JSON.stringify(rel)}`);
101
+ return { path, data };
102
+ });
103
+ await mkdir(this.taskDir(key), { recursive: true });
104
+ try {
105
+ await mkdir(dir);
106
+ }
107
+ catch (e) {
108
+ if (e.code === "EEXIST")
109
+ throw new ReviewStoreError("exists", `既にある run です: ${key}/${run.id}`);
110
+ throw e;
111
+ }
112
+ try {
113
+ for (const { path, data } of targets) {
114
+ await mkdir(dirname(path), { recursive: true });
115
+ // 作ったばかりのフォルダの中だけに書く(途中がシンボリックリンクなら断る。新しいファイルとしてだけ作る)
116
+ await assertNoLinks(material, path);
117
+ await writeFile(path, data, { flag: "wx" });
118
+ }
119
+ await writeJson(join(dir, "input.json"), input);
120
+ await writeJson(join(dir, "run.json"), run);
121
+ }
122
+ catch (e) {
123
+ // 作りかけの run は残さない(一覧に壊れた記録として出さない)
124
+ await rm(dir, { recursive: true, force: true });
125
+ throw e;
126
+ }
127
+ }
128
+ async readRun(key, run) {
129
+ return readJson(join(this.runDir(key, run), "run.json"), `${key}/${run}`, checkRunShape);
130
+ }
131
+ async readInput(key, run) {
132
+ return readJson(join(this.runDir(key, run), "input.json"), `${key}/${run} の input.json`, (x) => {
133
+ const i = x;
134
+ if (!i.task || !Array.isArray(i.items) || !Array.isArray(i.targets) || typeof i.hash !== "string")
135
+ throw new Error("形が違います");
136
+ });
137
+ }
138
+ async readResult(key, run) {
139
+ return readJson(join(this.runDir(key, run), "review.json"), `${key}/${run} の review.json`, (x) => {
140
+ const r = x;
141
+ if (typeof r.overall !== "string" || !Array.isArray(r.items))
142
+ throw new Error("形が違います");
143
+ });
144
+ }
145
+ /** 1回分(無ければ not_found、どれかが読めなければ broken) */
146
+ async get(key, run) {
147
+ const r = await this.readRun(key, run);
148
+ const input = await this.readInput(key, run);
149
+ const result = r.status === "completed" ? await this.readResult(key, run) : undefined;
150
+ return { run: r, input, ...(result ? { result } : {}) };
151
+ }
152
+ /** 一覧(新しい順)。読めない記録も broken として出す(隠さない) */
153
+ async list(key) {
154
+ const out = [];
155
+ for (const id of await this.runIds(key)) {
156
+ try {
157
+ const rec = await this.get(key, id);
158
+ const verdicts = {};
159
+ for (const i of rec.result?.items ?? [])
160
+ verdicts[i.verdict] = (verdicts[i.verdict] ?? 0) + 1;
161
+ out.push({ state: "ok", run: rec.run, inputHash: rec.input.hash, items: rec.input.items.length, ...(rec.result ? { verdicts } : {}) });
162
+ }
163
+ catch (e) {
164
+ out.push({ state: "broken", id, error: e.message });
165
+ }
166
+ }
167
+ const at = (x) => (x.state === "ok" ? x.run.startedAt.replace(/[-:]/g, "").replace("T", "-") : x.id.slice(3, 18));
168
+ return out.sort((a, b) => (at(a) < at(b) ? 1 : at(a) > at(b) ? -1 : 0));
169
+ }
170
+ async updateRunning(key, run, fn) {
171
+ return updateRunFile(`${key}/${run}`, await this.readRun(key, run), fn, (r) => writeJson(join(this.runDir(key, run), "run.json"), r));
172
+ }
173
+ async finish(key, run, patch, result) {
174
+ const dir = this.runDir(key, run);
175
+ return finishRunFile(`${key}/${run}`, await this.readRun(key, run), patch, result, {
176
+ writeRun: (r) => writeJson(join(dir, "run.json"), r),
177
+ writeResult: (r) => writeJson(join(dir, "review.json"), r),
178
+ });
179
+ }
180
+ /** 材料のファイルの一覧(材料のフォルダからの相対パス。シンボリックリンクは含めない) */
181
+ async materialFiles(key, run) {
182
+ const root = this.materialDir(key, run);
183
+ const out = [];
184
+ const walk = async (d, rel) => {
185
+ for (const e of await readdir(d, { withFileTypes: true }).catch(() => [])) {
186
+ const r = rel ? `${rel}/${e.name}` : e.name;
187
+ if (e.isDirectory())
188
+ await walk(join(d, e.name), r);
189
+ else if (e.isFile())
190
+ out.push(r);
191
+ }
192
+ };
193
+ await walk(root, "");
194
+ return out.sort();
195
+ }
196
+ }
197
+ /** root から path までの途中(root を除く)にシンボリックリンクが無いこと */
198
+ async function assertNoLinks(root, path) {
199
+ const parts = path.slice(resolve(root).length + 1).split(sep);
200
+ let cur = resolve(root);
201
+ for (const p of parts.slice(0, -1)) {
202
+ cur = join(cur, p);
203
+ if ((await lstat(cur)).isSymbolicLink())
204
+ throw new ReviewStoreError("bad_id", `材料のフォルダの中にシンボリックリンクがあります: ${cur}`);
205
+ }
206
+ }
207
+ function checkRunShape(x) {
208
+ const r = x;
209
+ if (typeof r.id !== "string" || typeof r.request !== "string" || typeof r.task !== "string" || !TASK_REVIEW_STATUSES.includes(r.status) || typeof r.startedAt !== "string") {
210
+ throw new Error("形が違います");
211
+ }
212
+ if (!Array.isArray(r.log))
213
+ throw new Error("log がありません");
214
+ }
@@ -22,6 +22,32 @@ export const AI_MANIFEST = {
22
22
  "ここに無い API は /api/projects/:project/... の下に置く(通常の serve の /api/... と同じ)。変える操作には x-p3-project-generation が要る(無ければ 428、違えば 409 code: changed)。" +
23
23
  "プロジェクトを書かないデータの API は 404 code: project_required。/api/chatgpt(engine は null)・/api/user-theme・/api/events(一覧・テーマ・接続の変更)はプロジェクトを選ばずに使える",
24
24
  },
25
+ {
26
+ method: "GET|POST",
27
+ path: "/api/quality",
28
+ desc: "品質基準(project.yaml の quality)。GET は {quality: {state: unset | set | invalid, ...}, version, diffs(採用したテンプレートの改版の差分), templates}。" +
29
+ "POST {ops: [{op: init | adopt | upgrade | add | replace | edit | remove | exempt | unexempt, ...}], version?} で操作を順に当てて quality だけを書く(version が違えば 409 quality_conflict、" +
30
+ "規則に合わなければ 400 quality_invalid、読めない設定は 400 quality_unreadable。設定の保存 PUT /api/project は quality を書かない)。コマンドは実行しない",
31
+ },
32
+ { method: "GET", path: "/api/requests/:rid/tasks/:tid/quality-diff", desc: "タスクの受け入れ基準と今の品質基準の差分 {quality, version, diff: [{kind: add | change | remove | exempt | edited, quality, criterion?, text?, reason?}]}(読むだけ)" },
33
+ {
34
+ method: "POST",
35
+ path: "/api/requests/:rid/tasks/:tid/quality-import",
36
+ desc: "差分を明示して受け入れ基準に取り込む {keys?: [\"<kind>:<品質 ID>\"], rev?}(add は足す、change は文と出典を直す(証拠は再確認が必要になる)、remove・exempt は消す)。POST tasks の quality: auto | none | [ID] で作るときにも取り込む",
37
+ },
38
+ {
39
+ method: "POST",
40
+ path: "/api/quality/improvements/preview",
41
+ desc: "品質の不足の診断と改善要望の原稿 {source: {type: project} | {type: task-review, request, task, run} | {type: milestone-review, milestone, run}, keys?}。" +
42
+ "{findings: [{key, kind: unset | invalid | violated | undetermined | exempt, ...}], hash, registered, picked, draft?}(読むだけ。除外は既定で選ばない)",
43
+ },
44
+ {
45
+ method: "POST",
46
+ path: "/api/quality/improvements",
47
+ desc: "改善要望を明示して登録する {source, keys, title, body, hash, reopenClosed?}(201 {request, keys})。診断が変わっていれば 409 diagnosis_changed、開いている登録先があれば 409 existing(existing.request)、" +
48
+ "閉じた要望で扱った不足は reopenClosed が無ければ 409 closed_existing。不足ごとの登録先は quality-improvements.json に残す",
49
+ },
50
+ { method: "GET", path: "/api/quality/templates/:id[?version=]", desc: "同梱の品質基準のテンプレートの中身(版つきの例。業界の標準への認証ではない)" },
25
51
  { method: "GET", path: "/api/project", desc: "プロジェクト設定と milestonesVersion(マイルストーンの版)" },
26
52
  {
27
53
  method: "PUT",
@@ -41,7 +67,7 @@ export const AI_MANIFEST = {
41
67
  desc: "参照先(共有の定義)。GET は読めたかの状態と、ローカルの画面にだけこのマシンのパス。POST {name, role?, readFirst?, writable?, map?, path?}",
42
68
  },
43
69
  { method: "PUT|DELETE", path: "/api/repos/:name/path", desc: "参照先のこのマシンのパス(個人設定)。このマシンのローカルの画面(Origin)からだけ" },
44
- { method: "GET", path: "/api/requests[?parent=<要望ID>]", desc: "要望の一覧と進捗(更新の新しい順。parent で直下の子だけを親の表示順に)" },
70
+ { method: "GET", path: "/api/requests[?parent=<要望ID>]", desc: "要望の一覧と進捗(更新の新しい順。parent で直下の子だけを親の表示順に)。止まっている自分のタスクの数 blocked と配下の数 subtree.blocked(作業中にも数える)、タスクの印に停止の今の値 block" },
45
71
  { method: "POST", path: "/api/requests", desc: "要望の作成(parent で子の要望にする。省いた期限・マイルストーン・タグは親から写す)" },
46
72
  {
47
73
  method: "GET",
@@ -62,8 +88,18 @@ export const AI_MANIFEST = {
62
88
  "重複・無い要望・直下の子でない・足りないは 409 code: child_order_invalid(reason・ids・今の並び children。子が変わっていれば読み直す)、rev が違えば 409 code: rev_conflict。" +
63
89
  "表示の順で、実行の順・着手できるかは表さない",
64
90
  },
65
- { method: "GET|POST", path: "/api/requests/:rid/tasks", desc: "要望のタスク(対応済の要望に未完了のタスクを足すと進行中に戻し reopened を返す。対応済の祖先も戻して reopenedAncestors、完了済の祖先は warnings の ancestor_done)" },
66
- { method: "GET|PATCH|DELETE", path: "/api/requests/:rid/tasks/:tid", desc: "タスク(GET は置き換えの印 superseded も返す。PATCH は rev で楽観ロック、null で項目を消す。置き換えられたタスクを作業中にすると warnings を添える)" },
91
+ { method: "GET|POST", path: "/api/requests/:rid/tasks", desc: "要望のタスク(GET の ?blocked=true で止まっているものだけ(status・area・q と AND)。POST の criteria: [文] で受け入れ基準を付ける(ID は p3 が振る)。対応済の要望に未完了のタスクを足すと進行中に戻し reopened を返す。対応済の祖先も戻して reopenedAncestors、完了済の祖先は warnings の ancestor_done)" },
92
+ { method: "GET|PATCH|DELETE", path: "/api/requests/:rid/tasks/:tid", desc: "タスク(GET は置き換えの印 superseded と受け入れ基準の状態 acceptance(不足 shortfalls。基準なしは null)も返す。PATCH は rev で楽観ロック、null で項目を消す。置き換えられたタスクを作業中にすると warnings を添える。" +
93
+ "受け入れ基準・証拠は PATCH の acceptance: [{op: add|edit|remove|order|record|unrecord, ...}] で順に当て、規則に合わなければ何も書かず 400 code: acceptance_invalid。" +
94
+ "済みのタスクの基準・証拠の中身が変わると済みを外し checkCleared を返す。" +
95
+ "止まっている理由(停止)は PATCH の blockOp: {op: set, reason, decision?}(作業中だけ。内容を直しても since は変えない)/ {op: clear, resolution}(解除。状態は変えない)で変え、" +
96
+ "日時・履歴は受け付けない。規則に合わなければ 400 block_invalid / block_not_doing、止まったまま未着手・完了へ動かすと 409 blocked(解除と移動を同じ PATCH に書けば一緒に保存する))" },
97
+ {
98
+ method: "GET",
99
+ path: "/api/requests/:rid/archived-tasks[/:tid]",
100
+ desc: "アーカイブしたタスク(読むだけ。各タスクに archived: true)。一覧は {request, tasks, errors}(ID の数値順。壊れたファイルは errors)、" +
101
+ "1件は {task}。無い → 404、読めない → 500 code: archive_unreadable。通常の tasks・進捗・対応済の判定には入らない。DELETE /tasks/:tid がアーカイブする",
102
+ },
67
103
  { method: "POST", path: "/api/requests/:rid/preflight", desc: "Preflight の実行 {engine?: codex|mock, note?: メモ}。前回の結果とまだ渡していないメモを引き継ぐ" },
68
104
  { method: "GET|POST", path: "/api/requests/:rid/notes", desc: "Preflight へのメモ(GET は渡し済みか・次に引き継ぐ前回の run も返す。POST {body})" },
69
105
  {
@@ -103,7 +139,9 @@ export const AI_MANIFEST = {
103
139
  {
104
140
  method: "PATCH",
105
141
  path: "/api/requests/:rid/preflight/:run/drafts/:key",
106
- desc: "タスク案を直す {title?, description?, include?, repo?, expectedTitle?}。expectedTitle(編集を始めたときの題。制御用で案には書かない)を渡すと、" +
142
+ desc: "タスク案を直す {title?, description?, include?, repo?, acceptanceCriteria?, expectedTitle?, expectedCriteria?}。" +
143
+ "acceptanceCriteria は受け入れ基準の並び全体 [{id?, text}](id は残し、無い項目に振る。空で基準なし)で、expectedCriteria(編集を始めたときの基準)が要る。違えば 409 rev_conflict。" +
144
+ "expectedTitle(編集を始めたときの題。制御用で案には書かない)を渡すと、" +
107
145
  "案のファイルを読み直した今の題と比べ、違えば 409 code: rev_conflict(current に今の案)で書かない。画面から題を変えるときは必ず渡す",
108
146
  },
109
147
  {
@@ -153,6 +191,19 @@ export const AI_MANIFEST = {
153
191
  path: "/api/release-generations/:id[/cancel]",
154
192
  desc: "生成1件 {status: running|completed|failed|cancelled, failure?, items(文と出典), markdown(本文の案), warnings, materialChanged, log} / 取り消し",
155
193
  },
194
+ {
195
+ method: "POST",
196
+ path: "/api/requests/:rid/tasks/:tid/review-preview",
197
+ desc: "タスクの AI レビューの今の材料の要約と hash {targets?, viewpoint?}(比較項目・作業した側の証拠の状態・比較対象・観点の出典・注意・engineRequired。何も書かない)",
198
+ },
199
+ {
200
+ method: "GET|POST",
201
+ path: "/api/requests/:rid/tasks/:tid/reviews",
202
+ desc: "タスクの AI レビューの履歴(新しい順。読めない記録も broken)/ 始める(202。{targets?, viewpoint?, engine?, expectedHash?}。完了したタスクだけ。" +
203
+ "材料が変わっていれば 409 material_changed、実行中なら 409 running、Preflight の担当が agent で engine を明示していなければ 400 engine_required)。結果はタスクの状態・済み・基準・証拠を変えない",
204
+ },
205
+ { method: "GET", path: "/api/requests/:rid/tasks/:tid/reviews/:run", desc: "タスクの AI レビューの1回分(固定した材料・結果。実行中は所有者の状態 owner)。結果を直す口は無い" },
206
+ { method: "POST", path: "/api/requests/:rid/tasks/:tid/reviews/:run/cancel", desc: "タスクの AI レビューを取り消す {acknowledgeStopped?}(マイルストーンレビューと同じ規則)" },
156
207
  { method: "GET", path: "/api/milestone-reviews", desc: "レビューの履歴のあるマイルストーン {milestones}(project.yaml に無い孤立も。履歴のあるマイルストーンは消せず ID も変えられない)" },
157
208
  { method: "GET", path: "/api/milestones/:mid/review-preview", desc: "マイルストーンレビューの今の材料(比較単位・目的・要望の件数と状態・参照先のコード・範囲・警告・hash)。何も書かない" },
158
209
  {
@@ -24,7 +24,7 @@ export function milestoneReviewRoutes(ctx) {
24
24
  return c.json({ error: err.message, code: err.code }, status);
25
25
  }
26
26
  if (err instanceof ReviewRejected) {
27
- const status = err.code === "running" ? 409 : err.code === "unknown_milestone" ? 404 : 400;
27
+ const status = err.code === "running" || err.code === "material_changed" ? 409 : err.code === "unknown_milestone" ? 404 : 400;
28
28
  return c.json({ error: err.message, code: err.code, ...(err.running ? { run: err.running } : {}) }, status);
29
29
  }
30
30
  if (err instanceof ReviewCancelRefused)
@@ -50,6 +50,7 @@ export function milestoneReviewRoutes(ctx) {
50
50
  context: i.context.length,
51
51
  code: i.code ?? [],
52
52
  warnings: i.warnings,
53
+ ...(i.quality ? { quality: { state: i.quality.state, version: i.quality.version, standards: (i.quality.standards ?? []).map((q) => ({ id: q.id, text: q.text, exempt: q.exempt?.reason })) } } : {}),
53
54
  scope: i.scope,
54
55
  hash: i.hash,
55
56
  extractedAt: i.extractedAt,
@@ -57,8 +58,8 @@ export function milestoneReviewRoutes(ctx) {
57
58
  });
58
59
  app.get("/milestones/:mid/reviews", async (c) => c.json({ items: await svc().list(c.req.param("mid")) }));
59
60
  app.post("/milestones/:mid/reviews", async (c) => {
60
- const { engine } = z.object({ engine: z.enum(["codex", "mock"]).optional() }).parse(await c.req.json().catch(() => ({})));
61
- return c.json(await svc().start(c.req.param("mid"), actorOf(c), engine), 202);
61
+ const { engine, expectedHash } = z.object({ engine: z.enum(["codex", "mock"]).optional(), expectedHash: z.string().optional() }).parse(await c.req.json().catch(() => ({})));
62
+ return c.json(await svc().start(c.req.param("mid"), actorOf(c), engine, { expectedHash }), 202);
62
63
  });
63
64
  app.get("/milestones/:mid/reviews/:run", async (c) => c.json(await svc().get(c.req.param("mid"), c.req.param("run"))));
64
65
  app.post("/milestones/:mid/reviews/:run/cancel", async (c) => {
@@ -5,9 +5,15 @@ import { normalizeTaskId } from "../../shared/refs.js";
5
5
  import { REQUEST_STATUSES, TASK_STATUSES } from "../../shared/types.js";
6
6
  import { listTasks, progress, resolve } from "../../core/ops.js";
7
7
  import { ConflictError, NotFoundError } from "../../core/store/collection.js";
8
+ import { ACCEPTANCE_RESULTS, AcceptanceInputError, acceptanceStatus } from "../../shared/acceptance.js";
9
+ import { BlockInputError } from "../../shared/taskBlock.js";
10
+ import { QualityInputError, taskQualityDiff } from "../../shared/quality.js";
11
+ import { qualityTemplate, qualityView, updateQuality } from "../../core/quality.js";
12
+ import { diagnoseQuality, ImprovementError, improvementDraft, registerImprovement } from "../../core/qualityImprovement.js";
8
13
  import { ATTACHMENT_LIMITS, ATTACHMENT_TYPES, AttachmentError, safeFileName } from "../../core/store/attachments.js";
9
14
  import { bodyLimit } from "hono/body-limit";
10
15
  import { MilestonesConflictError, ReloadError } from "../../core/store/workspace.js";
16
+ import { ArchivedTaskReadError, getArchivedTask, listArchivedTasks } from "../../core/store/archivedTasks.js";
11
17
  import { completionCheckOf, hierarchyNow, resolvedIssue } from "../../core/requestStatus.js";
12
18
  import { HierarchyError, hierarchyView } from "../../core/hierarchy.js";
13
19
  import { supersededMarks } from "../../core/supersede.js";
@@ -18,7 +24,8 @@ import { AI_MANIFEST } from "./manifest.js";
18
24
  import { repoRoutes } from "./repoRoutes.js";
19
25
  import { releaseNoteRoutes } from "./releaseNoteRoutes.js";
20
26
  import { milestoneReviewRoutes } from "./milestoneReviewRoutes.js";
21
- import { archiveTask, checkMilestoneRemoval, createRequest, createTask, orderChildren, updateRequest, updateTask } from "../../core/requestOps.js";
27
+ import { taskReviewRoutes } from "./taskReviewRoutes.js";
28
+ import { archiveTask, checkMilestoneRemoval, createRequest, createTask, orderChildren, updateRequest, updateTask, importQuality } from "../../core/requestOps.js";
22
29
  import { PREFLIGHT_RUNNERS } from "../../shared/preflightRunner.js";
23
30
  import { StaleInputError } from "../../core/preflight/input.js";
24
31
  import { CancelRefusedError, ChildConflictError, ChildDraftsChangedError, DraftConflictError, PulseInputError } from "../../core/preflight/service.js";
@@ -28,10 +35,12 @@ import { CancelRefusedError, ChildConflictError, ChildDraftsChangedError, DraftC
28
35
  * /requests 要望(進捗つき)
29
36
  * /requests/:rid 要望の詳細
30
37
  * /requests/:rid/tasks[/:tid] 要望のタスク
38
+ * /requests/:rid/archived-tasks[/:tid] アーカイブしたタスク(読むだけ)
31
39
  * /requests/:rid/preflight[/:run] Preflight
32
40
  * /requests/:rid/notes Preflight へのメモ
33
41
  * /release-notes[/:mid] マイルストーンのリリースノート(releaseNoteRoutes.ts)
34
42
  * /milestones/:mid/review[s...] マイルストーンレビュー(milestoneReviewRoutes.ts)
43
+ * /requests/:rid/tasks/:tid/review[s...] タスクの AI レビュー(taskReviewRoutes.ts)
35
44
  */
36
45
  const date = z.string().regex(/^\d{4}-\d{2}-\d{2}$/);
37
46
  const taskInput = z.object({
@@ -47,8 +56,47 @@ const taskInput = z.object({
47
56
  /** 変更の記録(Markdown。完了にするときに書く) */
48
57
  record: z.string().nullable().optional(),
49
58
  });
50
- /** checked: 完了したタスクに人が「済み」を付ける / 外す */
51
- const taskPatch = taskInput.partial().extend({ rev: z.number().int().optional(), checked: z.boolean().optional() });
59
+ /** 受け入れ基準・証拠への操作(規則は shared/acceptance.ts。CLI の criteria / evidence と同じ) */
60
+ const acceptanceOp = z.discriminatedUnion("op", [
61
+ z.object({ op: z.literal("add"), text: z.string() }),
62
+ z.object({ op: z.literal("edit"), id: z.string(), text: z.string() }),
63
+ z.object({ op: z.literal("remove"), id: z.string() }),
64
+ z.object({ op: z.literal("order"), ids: z.array(z.string()) }),
65
+ z.object({ op: z.literal("record"), id: z.string(), result: z.enum(ACCEPTANCE_RESULTS), evidence: z.string().default("") }),
66
+ z.object({ op: z.literal("unrecord"), id: z.string() }),
67
+ ]);
68
+ /** 品質基準の操作(規則は shared/quality.ts。CLI の p3 quality と同じ) */
69
+ const qualityCheck = z.discriminatedUnion("kind", [
70
+ z.object({ kind: z.literal("machine"), command: z.string(), success: z.string() }),
71
+ z.object({ kind: z.literal("manual"), reference: z.string() }),
72
+ ]);
73
+ const qualityInput = z.object({ text: z.string(), repos: z.array(z.string()).optional(), check: qualityCheck });
74
+ const qualityOp = z.discriminatedUnion("op", [
75
+ z.object({ op: z.literal("init") }),
76
+ z.object({ op: z.literal("adopt"), template: z.string(), version: z.number().int().optional() }),
77
+ z.object({ op: z.literal("upgrade"), template: z.string() }),
78
+ z.object({ op: z.literal("add"), standard: qualityInput }),
79
+ z.object({
80
+ op: z.literal("replace"),
81
+ standards: z.array(qualityInput.extend({ id: z.string().optional(), exemptReason: z.string().optional(), source: z.object({ template: z.string(), version: z.number().int(), key: z.string() }).optional() })).max(200),
82
+ templates: z.array(z.object({ id: z.string(), version: z.number().int() })).optional(),
83
+ }),
84
+ z.object({ op: z.literal("edit"), id: z.string(), standard: qualityInput.partial() }),
85
+ z.object({ op: z.literal("remove"), id: z.string() }),
86
+ z.object({ op: z.literal("exempt"), id: z.string(), reason: z.string() }),
87
+ z.object({ op: z.literal("unexempt"), id: z.string() }),
88
+ ]);
89
+ /** 作るとき: 受け入れ基準は文の並び(ID は p3 が振る) */
90
+ const taskCreate = taskInput.extend({ criteria: z.array(z.string()).optional(), quality: z.union([z.enum(["auto", "none"]), z.array(z.string())]).optional() });
91
+ /** checked: 完了したタスクに人が「済み」を付ける / 外す。acceptance: 基準・証拠への操作(順に当て、1つでも合わなければ何も書かない) */
92
+ /** 停止の操作(規則は shared/taskBlock.ts。CLI の block / unblock と同じ。日時・履歴は受け付けない) */
93
+ const blockOp = z.discriminatedUnion("op", [
94
+ z.object({ op: z.literal("set"), reason: z.string(), decision: z.string().optional() }),
95
+ z.object({ op: z.literal("clear"), resolution: z.string() }),
96
+ ]);
97
+ const taskPatch = taskInput
98
+ .partial()
99
+ .extend({ rev: z.number().int().optional(), checked: z.boolean().optional(), acceptance: z.array(acceptanceOp).optional(), blockOp: blockOp.optional() });
52
100
  const requestInput = z.object({
53
101
  title: z.string().min(1),
54
102
  body: z.string().optional(),
@@ -141,12 +189,29 @@ export function apiRoutes(ctx, opts = {}) {
141
189
  return c.json({ error: err.message, code: err.code, milestonesVersion: err.current }, 409);
142
190
  if (err instanceof z.ZodError)
143
191
  return c.json({ error: "invalid input", issues: err.issues }, 400);
192
+ // 受け入れ基準・証拠の操作が規則に合わない(何も書いていない)
193
+ if (err instanceof AcceptanceInputError)
194
+ return c.json({ error: err.message, code: err.code }, 400);
195
+ // 停止の操作が規則に合わない・止まったままの移動(何も書いていない)
196
+ if (err instanceof BlockInputError)
197
+ return c.json({ error: err.message, code: err.code }, err.code === "blocked" ? 409 : 400);
198
+ // 品質基準(版が違えば 409 quality_conflict。何も書いていない)
199
+ if (err instanceof QualityInputError)
200
+ return c.json({ error: err.message, code: err.code }, err.code === "quality_conflict" ? 409 : 400);
201
+ // 改善要望(診断が変わった・登録先がある → 409。作っていない)
202
+ if (err instanceof ImprovementError) {
203
+ const status = err.code === "not_found" ? 404 : err.code === "diagnosis_changed" || err.code === "existing" || err.code === "closed_existing" ? 409 : 400;
204
+ return c.json({ error: err.message, code: err.code, ...(err.existing ? { existing: err.existing } : {}) }, status);
205
+ }
144
206
  // 個人設定のファイルが読めない・壊れている(ファイルは変えていない)
145
207
  if (err instanceof UserConfigError)
146
208
  return c.json({ error: err.message }, 500);
147
209
  // データのフォルダが読めない(メモリ上の状態は変えていない)
148
210
  if (err instanceof ReloadError)
149
211
  return c.json({ error: err.message }, 503);
212
+ // アーカイブのフォルダ・ファイルが読めない(無いのは 404)
213
+ if (err instanceof ArchivedTaskReadError)
214
+ return c.json({ error: err.message, code: err.code }, 500);
150
215
  console.error(err);
151
216
  return c.json({ error: err.message }, 400);
152
217
  });
@@ -187,6 +252,7 @@ export function apiRoutes(ctx, opts = {}) {
187
252
  /** マイルストーンのリリースノート(材料・保存・出力・要約の生成) */
188
253
  app.route("/", releaseNoteRoutes(ctx));
189
254
  app.route("/", milestoneReviewRoutes(ctx));
255
+ app.route("/", taskReviewRoutes(ctx));
190
256
  // --- requests -------------------------------------------------------------
191
257
  app.get("/requests", (c) => {
192
258
  // ?parent=<ID>: 直下の子だけを、親の表示順(子の一覧・詳細と同じ)で。省くと更新の新しい順
@@ -227,13 +293,42 @@ export function apiRoutes(ctx, opts = {}) {
227
293
  const r = await orderChildren(ctx, id, children, { expectedRev: expectedRev(c, { rev }), actor: actorOf(c) });
228
294
  return c.json({ request: r, children: hierarchyNow(ws).children(id).map((k) => k.id) });
229
295
  });
296
+ // --- 品質基準(project.yaml の quality。core/quality.ts) ----------------------------
297
+ app.get("/quality", (c) => c.json(qualityView(ws)));
298
+ app.get("/quality/templates/:id", (c) => {
299
+ const v = c.req.query("version");
300
+ const t = qualityTemplate(c.req.param("id"), v ? Number(v) : undefined);
301
+ return t ? c.json(t) : c.json({ error: `テンプレートがありません: ${c.req.param("id")}`, code: "not_found" }, 404);
302
+ });
303
+ app.post("/quality", async (c) => {
304
+ const { ops, version } = z.object({ ops: z.array(qualityOp).min(1).max(200), version: z.string().optional() }).parse(await c.req.json());
305
+ return c.json(await updateQuality(ws, ops, { expectedVersion: version }));
306
+ });
307
+ // --- 品質の改善要望(core/qualityImprovement.ts。診断と原稿は読むだけ、登録は明示したときだけ) ------------
308
+ const improvementSource = z.discriminatedUnion("type", [
309
+ z.object({ type: z.literal("project") }),
310
+ z.object({ type: z.literal("task-review"), request: z.string(), task: z.string(), run: z.string() }),
311
+ z.object({ type: z.literal("milestone-review"), milestone: z.string(), run: z.string() }),
312
+ ]);
313
+ app.post("/quality/improvements/preview", async (c) => {
314
+ const { source, keys } = z.object({ source: improvementSource, keys: z.array(z.string()).optional() }).parse(await c.req.json());
315
+ const d = await diagnoseQuality(ctx, source);
316
+ const picked = keys ?? d.findings.filter((f) => f.suggested).map((f) => f.key);
317
+ return c.json({ ...d, picked, ...(picked.length ? { draft: improvementDraft(d, picked) } : {}) });
318
+ });
319
+ app.post("/quality/improvements", async (c) => {
320
+ const body = z
321
+ .object({ source: improvementSource, keys: z.array(z.string()).min(1), title: z.string(), body: z.string(), hash: z.string(), reopenClosed: z.boolean().optional() })
322
+ .parse(await c.req.json());
323
+ return c.json(await registerImprovement(ctx, body, actorOf(c)), 201);
324
+ });
230
325
  // --- tasks(要望の中) --------------------------------------------------------
231
326
  app.get("/requests/:rid/tasks", (c) => {
232
- const { status, area, q } = c.req.query();
233
- return c.json(listTasks(ctx, { request: rid(c), status: status?.split(","), area, q }));
327
+ const { status, area, q, blocked } = c.req.query();
328
+ return c.json(listTasks(ctx, { request: rid(c), status: status?.split(","), area, q, blocked: blocked === "true" }));
234
329
  });
235
330
  app.post("/requests/:rid/tasks", async (c) => {
236
- const raw = taskInput.parse(await c.req.json());
331
+ const raw = taskCreate.parse(await c.req.json());
237
332
  const { repo, ...b } = unnull(raw);
238
333
  // 作業先は null(作業先なし)を残す。書かなければ既定(requestOps.createTask)
239
334
  const input = { ...b, ...("repo" in raw ? { repo: raw.repo ?? null } : {}) };
@@ -242,19 +337,39 @@ export function apiRoutes(ctx, opts = {}) {
242
337
  });
243
338
  app.get("/requests/:rid/tasks/:tid", (c) => {
244
339
  const task = ws.tasksOf(rid(c)).require(tid(c));
245
- return c.json({ task, superseded: supersededMarks(ws).get(task.ref) ?? [] });
340
+ return c.json({ task, superseded: supersededMarks(ws).get(task.ref) ?? [], acceptance: acceptanceStatus(task) ?? null });
246
341
  });
247
342
  app.patch("/requests/:rid/tasks/:tid", async (c) => {
248
- const { rev, checked, ...patch } = taskPatch.parse(await c.req.json());
249
- const next = { ...unnull(patch), ...("repo" in patch ? { repo: patch.repo ?? null } : {}), ...(checked !== undefined ? { checked } : {}) };
250
- // 置き換えられたタスクを作業中にしたら警告を添える(操作は続ける)
251
- const { task, warnings, reopened, reopenedAncestors } = await updateTask(ctx, rid(c), tid(c), next, { expectedRev: expectedRev(c, { rev }), actor: actorOf(c) });
252
- return c.json({ ...task, ...(warnings.length ? { warnings } : {}), ...(reopened ? { reopened } : {}), ...(reopenedAncestors ? { reopenedAncestors } : {}) });
343
+ const { rev, checked, acceptance, blockOp: bop, ...patch } = taskPatch.parse(await c.req.json());
344
+ const next = {
345
+ ...(bop ? { blockOp: bop } : {}),
346
+ ...unnull(patch),
347
+ ...("repo" in patch ? { repo: patch.repo ?? null } : {}),
348
+ ...(checked !== undefined ? { checked } : {}),
349
+ ...(acceptance?.length ? { acceptance } : {}),
350
+ };
351
+ // 置き換えられたタスクを作業中にしたら警告を添える(操作は続ける)。基準・証拠が変わって済みを外したら checkCleared
352
+ const { task, warnings, reopened, reopenedAncestors, checkCleared } = await updateTask(ctx, rid(c), tid(c), next, { expectedRev: expectedRev(c, { rev }), actor: actorOf(c) });
353
+ return c.json({ ...task, ...(warnings.length ? { warnings } : {}), ...(reopened ? { reopened } : {}), ...(reopenedAncestors ? { reopenedAncestors } : {}), ...(checkCleared ? { checkCleared } : {}) });
354
+ });
355
+ /** 今の品質基準との差分(読むだけ。タスクは書き換えない) */
356
+ app.get("/requests/:rid/tasks/:tid/quality-diff", (c) => {
357
+ const task = ws.tasksOf(rid(c)).require(tid(c));
358
+ return c.json({ quality: ws.project.quality?.state ?? "unset", version: ws.project.qualityVersion, diff: taskQualityDiff(task.acceptanceCriteria ?? [], ws.project.quality, task.repo) });
359
+ });
360
+ /** 差分を明示して取り込む(keys: "<kind>:<品質 ID>"。省くと「直した」以外の全部) */
361
+ app.post("/requests/:rid/tasks/:tid/quality-import", async (c) => {
362
+ const { keys, rev } = z.object({ keys: z.array(z.string()).optional(), rev: z.number().int().optional() }).parse(await c.req.json().catch(() => ({})));
363
+ const r = await importQuality(ctx, rid(c), tid(c), keys, { expectedRev: expectedRev(c, { rev }), actor: actorOf(c) });
364
+ return c.json({ ...r.task, applied: r.applied, ...(r.checkCleared ? { checkCleared: r.checkCleared } : {}) });
253
365
  });
254
366
  app.delete("/requests/:rid/tasks/:tid", async (c) => {
255
367
  await archiveTask(ctx, rid(c), tid(c));
256
368
  return c.json({ ok: true });
257
369
  });
370
+ // --- アーカイブしたタスク(読むだけ。通常のタスクの道はアーカイブを探さない) ------------------------
371
+ app.get("/requests/:rid/archived-tasks", async (c) => c.json(await listArchivedTasks(ws, c.req.param("rid"))));
372
+ app.get("/requests/:rid/archived-tasks/:tid", async (c) => c.json({ task: await getArchivedTask(ws, c.req.param("rid"), tid(c)) }));
258
373
  // --- preflight ----------------------------------------------------------
259
374
  app.post("/requests/:rid/preflight", async (c) => {
260
375
  const body = z
@@ -380,11 +495,24 @@ export function apiRoutes(ctx, opts = {}) {
380
495
  });
381
496
  app.patch("/requests/:rid/preflight/:run/drafts/:key", async (c) => {
382
497
  // expectedTitle: 編集を始めたときの題(制御用。案には書かない)。今の題と違えば 409 で書かない
383
- const { expectedTitle, ...patch } = z
384
- .object({ title: z.string(), description: z.string(), include: z.boolean(), repo: z.string().nullable(), expectedTitle: z.string() })
498
+ // acceptanceCriteria: 受け入れ基準の並び全体(id は残し、無い項目に振る)。expectedCriteria: 編集を始めたときの基準(違えば 409)
499
+ const criterion = z.object({ id: z.string().nullish(), text: z.string() });
500
+ const { expectedTitle, expectedCriteria, ...patch } = z
501
+ .object({
502
+ title: z.string(),
503
+ description: z.string(),
504
+ include: z.boolean(),
505
+ repo: z.string().nullable(),
506
+ acceptanceCriteria: z.array(criterion),
507
+ expectedTitle: z.string(),
508
+ expectedCriteria: z.array(z.object({ id: z.string(), text: z.string() })),
509
+ })
385
510
  .partial()
386
511
  .parse(await c.req.json());
387
- return c.json(await preflight.updateDraft(rid(c), c.req.param("run"), c.req.param("key"), patch, { expectedTitle }));
512
+ if (patch.acceptanceCriteria !== undefined && expectedCriteria === undefined) {
513
+ return c.json({ error: "受け入れ基準を直すときは expectedCriteria(編集を始めたときの基準)を渡してください", code: "acceptance_invalid" }, 400);
514
+ }
515
+ return c.json(await preflight.updateDraft(rid(c), c.req.param("run"), c.req.param("key"), patch, { expectedTitle, expectedCriteria }));
388
516
  });
389
517
  /** 子の要望の案(分割の run)を直す。expectedTitle は上と同じ */
390
518
  app.patch("/requests/:rid/preflight/:run/children/:key", async (c) => {
@@ -409,8 +537,8 @@ export function apiRoutes(ctx, opts = {}) {
409
537
  });
410
538
  // --- 横断 --------------------------------------------------------------
411
539
  app.get("/tasks", (c) => {
412
- const { status, area, q } = c.req.query();
413
- return c.json(listTasks(ctx, { status: status?.split(","), area, q }));
540
+ const { status, area, q, blocked } = c.req.query();
541
+ return c.json(listTasks(ctx, { status: status?.split(","), area, q, blocked: blocked === "true" }));
414
542
  });
415
543
  /** 参照・タイトルから対象を特定する(?request= で今の要望を優先) */
416
544
  app.get("/resolve", (c) => c.json(resolve(ctx, c.req.query("q") ?? "", c.req.query("request"))));