@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
@@ -1,16 +1,24 @@
1
- import { relative } from "node:path";
2
- import { listTasks, resolve, resolveRef } from "../core/ops.js";
3
- import { archiveTask, createTask, updateTask } from "../core/requestOps.js";
1
+ import { readFileSync } from "node:fs";
2
+ import { join, relative, resolve as resolvePath } from "node:path";
3
+ import { relationRole } from "../shared/types.js";
4
+ import { normalizeTaskId } from "../shared/refs.js";
5
+ import { getArchivedTask, listArchivedTasks } from "../core/store/archivedTasks.js";
6
+ import { listTasks, resolve, resolveRef, resolveRequestId } from "../core/ops.js";
7
+ import { archiveTask, createTask, importQuality, updateTask } from "../core/requestOps.js";
8
+ import { taskQualityDiff } from "../shared/quality.js";
4
9
  import { supersededMarks } from "../core/supersede.js";
5
10
  import { table } from "./format.js";
6
11
  import { taskRepo } from "../shared/workTarget.js";
7
12
  import { addRepoOutputs, parseRepoOutput, repoArg } from "../core/workTargets.js";
8
- import { briefTask, formatBriefTask, taskExtras } from "./showView.js";
13
+ import { briefTask, formatAcceptance, formatBlock, formatBriefTask, taskExtras } from "./showView.js";
9
14
  import { UsageError } from "./project.js";
10
- import { parseTaskAssignments, checkStatus, readBody } from "./args.js";
11
- import { dependentsOf, formatEntity, ambiguous, replacedBy, reopenedNote, warn, deps, workHint } from "./output.js";
15
+ import { NotFoundError } from "../core/store/collection.js";
16
+ import { parseTaskAssignments, checkStatus, evidenceOps, readBody } from "./args.js";
17
+ import { ACCEPTANCE_RESULTS, acceptanceStatus, applyAcceptanceOps, isAcceptanceResult } from "../shared/acceptance.js";
18
+ import { dependentsOf, formatEntity, indent, ambiguous, replacedBy, reopenedNote, warn, deps, workHint } from "./output.js";
12
19
  import { requestCommand } from "./requestCommands.js";
13
- /** タスクのコマンド(ls / show / find / impact / new / set / move / check / link / unlink / archive)。変更は server/requestOps.ts を通す。扱わないコマンドは undefined */
20
+ import { pickRun } from "./preflightCommands.js";
21
+ /** タスクのコマンド(ls / show / find / impact / new / set / move / check / criteria / evidence / archive)。変更は server/requestOps.ts を通す。扱わないコマンドは undefined */
14
22
  const RECORD_REQUIRED = "AI が完了にするときは --record で変更の記録を残してください(何を変えたか・なぜ・入れた決まり・やめたもの。Markdown。- で標準入力)\n" +
15
23
  " 例: p3 move T003 done --output <成果物(変えたファイルや説明。URL は後から足せます)> --record - < record.md";
16
24
  export async function taskCommand(cmd, env) {
@@ -19,10 +27,12 @@ export async function taskCommand(cmd, env) {
19
27
  // --- タスク -------------------------------------------------------------
20
28
  case "ls":
21
29
  case "list": {
30
+ if (o.archived)
31
+ return listArchived(env);
22
32
  if (o.repo !== undefined && o.repo !== "none" && !ctx.ws.project.repos.some((r) => r.name === o.repo)) {
23
33
  throw new UsageError(`参照先「${o.repo}」は登録されていません(p3 repo ls)`);
24
34
  }
25
- const filter = { status: o.status?.split(","), area: o.area?.[0], q: o.q, repo: o.repo };
35
+ const filter = { status: o.status?.split(","), area: o.area?.[0], q: o.q, repo: o.repo, blocked: o.blocked };
26
36
  const tasks = listTasks(ctx, { ...filter, request: o.all ? undefined : requestArg(undefined) });
27
37
  const marks = supersededMarks(ctx.ws);
28
38
  const items = tasks.map((t) => (marks.has(t.ref) ? { ...t, superseded: marks.get(t.ref) } : t));
@@ -33,10 +43,12 @@ export async function taskCommand(cmd, env) {
33
43
  t.status,
34
44
  ...(multi ? [taskRepo(t) ?? "(なし)"] : []),
35
45
  t.title,
36
- [deps(t), replacedBy(t, marks)].filter(Boolean).join(" "),
37
- ])) || "タスクはありません");
46
+ [t.block ? `⏸停止 ${t.block.since.slice(0, 10)}: ${t.block.reason.split("\n")[0]}` : "", deps(t), replacedBy(t, marks)].filter(Boolean).join(" "),
47
+ ])) || (o.blocked ? "止まっているタスクはありません" : "タスクはありません"));
38
48
  }
39
49
  case "show": {
50
+ if (o.archived)
51
+ return showArchived(env);
40
52
  const query = args.join(" ");
41
53
  const ref = resolveRef(ctx, query, current) ?? resolve(ctx, query, current).match;
42
54
  if (!ref)
@@ -52,7 +64,8 @@ export async function taskCommand(cmd, env) {
52
64
  const file = relative(cwd, split(ref).col.path(item.id));
53
65
  const { superseded, dependencies, warnings } = taskExtras(ctx, item, marks);
54
66
  const dependents = dependentsOf(ctx, item).map((t) => ({ ref: t.ref, title: t.title, status: t.status }));
55
- return out.result({ item, file, superseded, dependencies, dependents, warnings }, () => [superseded.length ? `※ 置き換えられています: ${superseded.map((m) => `${m.from}${m.note ? `(${m.note})` : ""}`).join(" / ")}\n` : "", formatEntity(ctx, item, file)].join(""));
67
+ const acceptance = acceptanceStatus(item) ?? null;
68
+ return out.result({ item, file, superseded, dependencies, dependents, warnings, acceptance }, () => [superseded.length ? `※ 置き換えられています: ${superseded.map((m) => `${m.from}${m.note ? `(${m.note})` : ""}`).join(" / ")}\n` : "", formatEntity(ctx, item, file)].join(""));
56
69
  }
57
70
  case "find":
58
71
  case "resolve": {
@@ -81,6 +94,9 @@ export async function taskCommand(cmd, env) {
81
94
  areas: o.area ?? [],
82
95
  outputs: o.output ?? [],
83
96
  ...(repoOutputs.length ? { repoOutputs: addRepoOutputs([], repoOutputs) } : {}),
97
+ ...(o.criterion?.length ? { criteria: o.criterion } : {}),
98
+ // 品質基準: 省く・all は作業先に当てはまるもの(作業先なしは取り込まない)、none は取り込まない、Q1,Q2 は明示したもの
99
+ ...(o.quality !== undefined ? { quality: o.quality === "all" ? "auto" : o.quality === "none" ? "none" : o.quality.split(",").map((x) => x.trim()).filter(Boolean) } : {}),
84
100
  body: readBody(o.body),
85
101
  }, actor);
86
102
  const t = r.task;
@@ -102,13 +118,17 @@ export async function taskCommand(cmd, env) {
102
118
  const add = o["repo-output"].map((x) => parseRepoOutput(ctx.ws, x));
103
119
  patch.repoOutputs = addRepoOutputs(patch.repoOutputs ?? col.require(tid).repoOutputs ?? [], add);
104
120
  }
105
- if (!Object.keys(patch).length)
106
- throw new UsageError("キー=値 を指定してください");
107
- const r = await updateTask(ctx, ref.split("/")[0], tid, patch, { expectedRev, actor });
121
+ // 受け入れ基準を足す(--criterion)・証拠を残す(--evidence / --evidence-file)
122
+ const acceptance = [...(o.criterion ?? []).map((text) => ({ op: "add", text })), ...evidenceOps(o)];
123
+ if (!Object.keys(patch).length && !acceptance.length)
124
+ throw new UsageError("キー=値 を指定してください(受け入れ基準は --criterion、証拠は --evidence / --evidence-file)");
125
+ const r = await updateTask(ctx, ref.split("/")[0], tid, { ...patch, ...(acceptance.length ? { acceptance } : {}) }, { expectedRev, actor });
108
126
  const { task: next, warnings } = r;
109
127
  warn(warnings);
128
+ checkClearedNote(r.checkCleared);
110
129
  const reopened = reopenedNote(r.reopened, r.reopenedAncestors);
111
- return out.result({ ...next, ...(warnings.length ? { warnings } : {}), ...(reopened ? { reopened } : {}), ...(r.reopenedAncestors ? { reopenedAncestors: r.reopenedAncestors } : {}) }, () => [`更新: ${next.ref} (rev ${next.rev}) ${Object.keys(patch).join(", ")}`, "repo" in patch ? workHint(ctx, next) : ""].filter(Boolean).join("\n"));
130
+ const keys = [...Object.keys(patch), ...(acceptance.length ? ["acceptance"] : [])];
131
+ return out.result({ ...next, ...(warnings.length ? { warnings } : {}), ...(reopened ? { reopened } : {}), ...(r.reopenedAncestors ? { reopenedAncestors: r.reopenedAncestors } : {}), ...(r.checkCleared ? { checkCleared: r.checkCleared } : {}) }, () => [`更新: ${next.ref} (rev ${next.rev}) ${keys.join(", ")}`, "repo" in patch ? workHint(ctx, next) : ""].filter(Boolean).join("\n"));
112
132
  }
113
133
  case "move": {
114
134
  const ref = taskArg(args[0]);
@@ -129,11 +149,17 @@ export async function taskCommand(cmd, env) {
129
149
  // リポジトリごとの成果物(最後のタスクに、関係するリポジトリの PR を全部残せる)
130
150
  if (o["repo-output"]?.length)
131
151
  patch.repoOutputs = addRepoOutputs(cur.repoOutputs ?? [], o["repo-output"].map((x) => parseRepoOutput(ctx.ws, x)));
132
- const r = await updateTask(ctx, cur.request, tid, patch, { expectedRev, actor });
152
+ // 完了と同時に項目ごとの証拠を残す(--evidence / --evidence-file。不足があっても完了は拒まない)
153
+ const acceptance = evidenceOps(o);
154
+ const r = await updateTask(ctx, cur.request, tid, { ...patch, ...(acceptance.length ? { acceptance } : {}) }, { expectedRev, actor });
133
155
  const { task: next, warnings } = r;
134
156
  warn(warnings);
157
+ checkClearedNote(r.checkCleared);
135
158
  const reopened = reopenedNote(r.reopened, r.reopenedAncestors);
136
- return out.result({ ...next, ...(warnings.length ? { warnings } : {}), ...(reopened ? { reopened } : {}), ...(r.reopenedAncestors ? { reopenedAncestors: r.reopenedAncestors } : {}) }, () => `${next.ref} → ${status}${[...(o.output ?? []), ...(o["repo-output"] ?? [])].length ? ` (${[...(o.output ?? []), ...(o["repo-output"] ?? [])].join(", ")})` : ""}`);
159
+ const short = status === "done" ? acceptanceStatus(next)?.shortfalls : undefined;
160
+ if (short?.length)
161
+ process.stderr.write(`受け入れ基準の不足(完了はしました。人が確かめます): ${short.join(" / ")}\n`);
162
+ return out.result({ ...next, ...(warnings.length ? { warnings } : {}), ...(reopened ? { reopened } : {}), ...(r.reopenedAncestors ? { reopenedAncestors: r.reopenedAncestors } : {}), ...(r.checkCleared ? { checkCleared: r.checkCleared } : {}) }, () => `${next.ref} → ${status}${[...(o.output ?? []), ...(o["repo-output"] ?? [])].length ? ` (${[...(o.output ?? []), ...(o["repo-output"] ?? [])].join(", ")})` : ""}`);
137
163
  }
138
164
  case "check": {
139
165
  const ref = taskArg(args[0]);
@@ -141,6 +167,13 @@ export async function taskCommand(cmd, env) {
141
167
  const { task: next } = await updateTask(ctx, ref.split("/")[0], tid, { checked: !o.off }, { expectedRev, actor });
142
168
  return out.result(next, () => `${next.ref} ${o.off ? "の済みを外しました" : "を済みにしました"}`);
143
169
  }
170
+ case "block":
171
+ case "unblock":
172
+ return blockCommand(cmd, env);
173
+ case "criteria":
174
+ return criteriaCommand(env);
175
+ case "evidence":
176
+ return evidenceCommand(env);
144
177
  case "archive": {
145
178
  const ref = taskArg(args[0]);
146
179
  const { tid } = split(ref);
@@ -150,3 +183,265 @@ export async function taskCommand(cmd, env) {
150
183
  }
151
184
  return undefined;
152
185
  }
186
+ // --- 止まっている理由(停止) ---------------------------------------------------------
187
+ /**
188
+ * block <T> --reason 理由|- [--decision 決めてほしいこと|-] 作業中のタスクに停止を付ける・内容を直す(止まった時刻は変えない)
189
+ * unblock <T> --resolution 回答・解決の内容|- 解除する(状態は変えない。自動では再開しない)
190
+ * - は標準入力(どれか1つだけ)
191
+ */
192
+ async function blockCommand(cmd, { ctx, out, args, o, actor, expectedRev, taskArg, split }) {
193
+ const ref = taskArg(args[0]);
194
+ const stdin = [o.reason, o.decision, o.resolution].filter((v) => v === "-").length;
195
+ if (stdin > 1)
196
+ throw new UsageError("標準入力(-)は --reason / --decision / --resolution のどれか1つだけに使えます");
197
+ let op;
198
+ if (cmd === "block") {
199
+ if (o.reason === undefined)
200
+ throw new UsageError(`使い方: p3 block ${args[0] ?? "<T>"} --reason "止まっている理由" [--decision "決めてほしいこと"]`);
201
+ op = { op: "set", reason: readBody(o.reason), ...(o.decision !== undefined ? { decision: readBody(o.decision) } : {}) };
202
+ }
203
+ else {
204
+ if (o.resolution === undefined)
205
+ throw new UsageError(`使い方: p3 unblock ${args[0] ?? "<T>"} --resolution "回答・解決の内容"`);
206
+ op = { op: "clear", resolution: readBody(o.resolution) };
207
+ }
208
+ const { tid } = split(ref);
209
+ const before = ctx.ws.requireTask(ref);
210
+ const r = await updateTask(ctx, ref.split("/")[0], tid, { blockOp: op }, { expectedRev, actor });
211
+ const t = r.task;
212
+ const changed = t.rev !== before.rev;
213
+ return out.result({ ...t, changed }, () => !changed
214
+ ? cmd === "block"
215
+ ? `${t.ref} は同じ内容で止まっています(変えていません)`
216
+ : `${t.ref} は止まっていません(変えていません)`
217
+ : t.block
218
+ ? `${t.ref} を止めました(${t.block.since} から): ${t.block.reason}${t.block.decision ? `\n 決めてほしいこと: ${t.block.decision}` : ""}`
219
+ : `${t.ref} の停止を解除しました(状態は ${t.status} のまま。自動では再開しません)`);
220
+ }
221
+ // --- 受け入れ基準と証拠 -------------------------------------------------------------
222
+ function checkClearedNote(msg) {
223
+ if (msg)
224
+ process.stderr.write(`${msg}\n`);
225
+ }
226
+ /** 基準・証拠の操作を当てて、今の基準と不足を出す */
227
+ async function applyAcceptance({ ctx, out, actor, expectedRev, split }, ref, acceptance) {
228
+ const { tid } = split(ref);
229
+ const r = await updateTask(ctx, ref.split("/")[0], tid, { acceptance }, { expectedRev, actor });
230
+ checkClearedNote(r.checkCleared);
231
+ const acc = acceptanceStatus(r.task);
232
+ return out.result({ ...r.task, acceptance: acc ?? null, ...(r.checkCleared ? { checkCleared: r.checkCleared } : {}) }, () => [`更新: ${r.task.ref} (rev ${r.task.rev})`, ...formatAcceptance(r.task)].join("\n"));
233
+ }
234
+ /**
235
+ * criteria <タスク> 基準と証拠・不足を出す
236
+ * criteria <タスク> add <文> [<文> ...] 足す(ID は A1, A2, ... を振る)
237
+ * criteria <タスク> edit <ID> <文> 文を変える(記録済みの証拠は再確認が必要になる)
238
+ * criteria <タスク> rm <ID> [...] 消す(証拠は対応する基準のない証拠として残る)
239
+ * criteria <タスク> order <ID> ... 並べ替える(今の ID を全部)
240
+ */
241
+ async function criteriaCommand(env) {
242
+ const { ctx, out, args, taskArg } = env;
243
+ // タスク案(D1。--run で run、省くと最新)の基準はタスク化の前に直す
244
+ const draft = /^(?:([^/]+)\/)?(D\d+)$/i.exec(args[0] ?? "");
245
+ if (draft)
246
+ return draftCriteriaCommand(env, draft[1], draft[2].toUpperCase());
247
+ const ref = taskArg(args[0]);
248
+ const [sub, ...rest] = args.slice(1);
249
+ if (sub === "quality")
250
+ return qualitySubcommand(env, ref, rest);
251
+ if (sub === undefined || sub === "ls" || sub === "show") {
252
+ const task = ctx.ws.requireTask(ref);
253
+ const acc = acceptanceStatus(task);
254
+ return out.result({ ref: task.ref, rev: task.rev, criteria: task.acceptanceCriteria ?? [], evidence: task.acceptanceEvidence ?? [], acceptance: acc ?? null }, () => formatAcceptance(task).join("\n"));
255
+ }
256
+ const need = (n, usage) => {
257
+ if (rest.length < n)
258
+ throw new UsageError(`使い方: p3 criteria <タスク> ${usage}`);
259
+ };
260
+ switch (sub) {
261
+ case "add":
262
+ need(1, "add <文> [<文> ...]");
263
+ return applyAcceptance(env, ref, rest.map((text) => ({ op: "add", text })));
264
+ case "edit":
265
+ case "set":
266
+ need(2, "edit <ID> <文>");
267
+ return applyAcceptance(env, ref, [{ op: "edit", id: rest[0], text: rest.slice(1).join(" ") }]);
268
+ case "rm":
269
+ case "remove":
270
+ need(1, "rm <ID> [<ID> ...]");
271
+ return applyAcceptance(env, ref, rest.map((id) => ({ op: "remove", id })));
272
+ case "order":
273
+ need(1, "order <ID> <ID> ...(今の ID を全部)");
274
+ return applyAcceptance(env, ref, [{ op: "order", ids: rest }]);
275
+ }
276
+ throw new UsageError(`criteria の操作は add / edit / rm / order です: ${sub}`);
277
+ }
278
+ /**
279
+ * criteria <T> quality 今の品質基準との差分(追加・変更・削除・除外・タスクで直した)。読むだけ
280
+ * criteria <T> quality import [<kind>:<Q>...] 差分を明示して取り込む(省くと「直した」以外の全部)
281
+ */
282
+ async function qualitySubcommand({ ctx, out, actor, expectedRev }, ref, rest) {
283
+ const t = ctx.ws.requireTask(ref);
284
+ if (rest[0] === undefined || rest[0] === "diff") {
285
+ const q = ctx.ws.project.quality;
286
+ const diff = taskQualityDiff(t.acceptanceCriteria ?? [], q, t.repo);
287
+ const state = q?.state ?? "unset";
288
+ const label = { add: "足す", change: "変わった", remove: "消す", exempt: "除外になった", edited: "タスクで直した" };
289
+ return out.result({ ref: t.ref, quality: state, version: ctx.ws.project.qualityVersion, diff }, () => state !== "set"
290
+ ? `品質基準は${state === "unset" ? "未設定" : "読めません"}です(p3 quality)`
291
+ : diff.length
292
+ ? [
293
+ `${t.ref} と今の品質基準の差分(版 ${ctx.ws.project.qualityVersion}):`,
294
+ ...diff.map((d) => ` ${d.kind}:${d.quality} ${label[d.kind]}${d.criterion ? `(${d.criterion})` : ""}${d.text ? ` ${d.text}` : ""}${d.reason ? ` ${d.reason}` : ""}`),
295
+ t.repo ? "" : " ※作業先なしのタスクには、足す案を出しません(p3 new --quality Q1,Q2 のように明示して取り込めます)",
296
+ `取り込む: p3 criteria ${t.id} quality import [<kind>:<Q>...]`,
297
+ ]
298
+ .filter(Boolean)
299
+ .join("\n")
300
+ : `${t.ref} は今の品質基準と差分がありません`);
301
+ }
302
+ if (rest[0] !== "import")
303
+ throw new UsageError("使い方: p3 criteria <T> quality [import [<kind>:<Q>...]]");
304
+ const r = await importQuality(ctx, t.request, t.id, rest.length > 1 ? rest.slice(1) : undefined, { expectedRev, actor });
305
+ if (r.checkCleared)
306
+ process.stderr.write(`${r.checkCleared}\n`);
307
+ return out.result({ ...r.task, applied: r.applied, ...(r.checkCleared ? { checkCleared: r.checkCleared } : {}) }, () => [`取り込みました: ${r.applied.join(", ")}`, ...formatAcceptance(r.task)].join("\n"));
308
+ }
309
+ /**
310
+ * criteria <D1> [add|edit|rm|order] --req <要望> [--run <run>]: タスク案の基準(タスク化すると ID ごとタスクに写る)。
311
+ * 案のファイルを読み直し、読んだときの基準と比べてから書く(他で変わっていれば競合)。読めなかった項目は、直すと消える
312
+ */
313
+ async function draftCriteriaCommand({ ctx, out, args, o, requestArg }, head, key) {
314
+ const rid = head ? resolveRequestId(ctx, head) : requestArg(undefined);
315
+ if (!rid)
316
+ throw new NotFoundError(head ?? "要望");
317
+ const run = await pickRun(ctx, rid, o.run);
318
+ const d = run.drafts.find((x) => x.key === key);
319
+ if (!d)
320
+ throw new NotFoundError(`${run.id}/${key}`);
321
+ const [sub, ...rest] = args.slice(1);
322
+ const show = (x) => [
323
+ `${rid} / ${run.id} / ${x.key} ${x.title}`,
324
+ ...(x.acceptanceCriteria?.length ? x.acceptanceCriteria.map((c) => ` ${c.id} ${c.text}`) : [" 受け入れ基準なし"]),
325
+ ...(x.acceptanceProblems ?? []).map((p) => ` ※読めない: ${p}(直すと消えます)`),
326
+ ].join("\n");
327
+ if (sub === undefined || sub === "ls" || sub === "show")
328
+ return out.result({ request: rid, run: run.id, key, criteria: d.acceptanceCriteria ?? [], problems: d.acceptanceProblems ?? [] }, () => show(d));
329
+ if (run.materialized?.length || run.children)
330
+ throw new UsageError(`${run.id} はタスク化済みか子の要望の案の run です(タスクの基準は p3 criteria <T>)`);
331
+ const ops = sub === "add" ? rest.map((text) => ({ op: "add", text }))
332
+ : sub === "edit" || sub === "set" ? [{ op: "edit", id: rest[0] ?? "", text: rest.slice(1).join(" ") }]
333
+ : sub === "rm" || sub === "remove" ? rest.map((id) => ({ op: "remove", id }))
334
+ : sub === "order" ? [{ op: "order", ids: rest }]
335
+ : [];
336
+ if (!ops.length)
337
+ throw new UsageError("使い方: p3 criteria <D1> add <文>... / edit <ID> <文> / rm <ID>... / order <ID>... --req <要望> [--run <run>]");
338
+ // 案は採番を持たないので、操作は今の基準だけに当てる(読めなかった項目は除いたまま書き直す)
339
+ const next = applyAcceptanceOps({ acceptanceCriteria: d.acceptanceCriteria }, ops, { now: new Date().toISOString() });
340
+ const saved = await ctx.preflight.updateDraft(rid, run.id, key, { acceptanceCriteria: next.acceptanceCriteria ?? [] }, { expectedCriteria: d.acceptanceCriteria ?? [] });
341
+ return out.result({ request: rid, run: run.id, key, criteria: saved.acceptanceCriteria ?? [], problems: [] }, () => show(saved));
342
+ }
343
+ /**
344
+ * evidence <タスク> <ID> <結果> [--body 本文|- | --file 本文.md] 1項目の証拠を残す(再記録は置き換え)
345
+ * evidence <タスク> --file 証拠.md|- 見出し「## <ID> <結果>」ごとにまとめて残す
346
+ * evidence <タスク> rm <ID> [...] 証拠を消す
347
+ */
348
+ async function evidenceCommand(env) {
349
+ const { args, o, taskArg } = env;
350
+ const ref = taskArg(args[0]);
351
+ const [first, ...rest] = args.slice(1);
352
+ if (first === "rm" || first === "remove") {
353
+ if (!rest.length)
354
+ throw new UsageError("使い方: p3 evidence <タスク> rm <ID> [<ID> ...]");
355
+ return applyAcceptance(env, ref, rest.map((id) => ({ op: "unrecord", id })));
356
+ }
357
+ if (first === undefined) {
358
+ if (o.file === undefined)
359
+ throw new UsageError("使い方: p3 evidence <タスク> <ID> <結果> [--body 本文|- | --file 本文.md](まとめてなら --file 証拠.md)");
360
+ return applyAcceptance(env, ref, evidenceOps({ "evidence-file": o.file }));
361
+ }
362
+ const result = rest[0];
363
+ if (!isAcceptanceResult(result))
364
+ throw new UsageError(`結果は ${ACCEPTANCE_RESULTS.join(" / ")} のどれかです: p3 evidence <タスク> ${first} <結果>`);
365
+ if (o.body !== undefined && o.file !== undefined)
366
+ throw new UsageError("--body と --file はどちらか一方です");
367
+ let evidence = rest.slice(1).join(" ");
368
+ if (o.body !== undefined)
369
+ evidence = readBody(o.body);
370
+ else if (o.file !== undefined) {
371
+ try {
372
+ evidence = readFileSync(resolvePath(process.cwd(), o.file), "utf8");
373
+ }
374
+ catch {
375
+ throw new UsageError(`証拠のファイルが読めません: ${o.file}`);
376
+ }
377
+ }
378
+ return applyAcceptance(env, ref, [{ op: "record", id: first, result, evidence }]);
379
+ }
380
+ // --- アーカイブしたタスク(--archived を付けたときだけ。読むだけ) ------------------------------------
381
+ /** ls --archived: 今の要望(--req)のアーカイブの一覧。通常の絞り込み・--all とは混ぜない */
382
+ async function listArchived({ ctx, out, o, requestArg }) {
383
+ const mixed = ["all", "status", "area", "q", "repo", "blocked"].filter((k) => o[k] !== undefined && o[k] !== false);
384
+ if (mixed.length)
385
+ throw new UsageError(`--archived では ${mixed.map((k) => `--${k}`).join(" ")} を使えません(要望は --req で1つ指定)`);
386
+ const list = await listArchivedTasks(ctx.ws, requestArg(undefined));
387
+ return out.result(list, () => [
388
+ table(list.tasks.map((t) => [t.id, t.status, t.updatedAt.slice(0, 10), t.title])) || "アーカイブしたタスクはありません",
389
+ ...list.errors.map((e) => `読めない: ${e.id} ${e.error}`),
390
+ list.tasks.length || list.errors.length ? "(状態・日付はアーカイブする前の最後の値。進捗・対応済の判定には数えない)" : "",
391
+ ]
392
+ .filter(Boolean)
393
+ .join("\n"));
394
+ }
395
+ /** show <T003|要望/T003> --archived: アーカイブの1件。通常のタスクは探さない(同じ ID が通常にあってもアーカイブを読む) */
396
+ async function showArchived({ ctx, out, args, current, cwd }) {
397
+ const raw = args.join(" ").trim();
398
+ if (!raw)
399
+ throw new UsageError("タスクを指定してください(T003 / <要望>/T003)");
400
+ const [head, tail] = raw.split("/", 2);
401
+ const rid = tail !== undefined ? resolveRequestId(ctx, head) : current;
402
+ if (tail === undefined && !current)
403
+ throw new UsageError(`${raw}: 要望を --req で指定してください`);
404
+ if (!rid)
405
+ throw new NotFoundError(head);
406
+ const tid = normalizeTaskId(tail ?? head);
407
+ if (!tid)
408
+ throw new UsageError(`${raw}: タスクの ID(T003)を指定してください`);
409
+ const item = await getArchivedTask(ctx.ws, rid, tid);
410
+ const file = relative(cwd, join(ctx.ws.requestsDir, rid, "tasks", ".archive", `${tid}.md`));
411
+ return out.result({ item, file }, () => formatArchived(item, file));
412
+ }
413
+ function formatArchived(t, file) {
414
+ const lines = [`${t.ref} ${t.title}`, " [アーカイブ・閲覧専用] 状態・最終更新はアーカイブする前の最後の値(アーカイブの日時ではない)", ""];
415
+ const fields = [
416
+ ["status", t.status],
417
+ ["repo", t.repo ?? "(なし)"],
418
+ ["labels", t.labels.join(", ")],
419
+ ["areas", t.areas.join(", ")],
420
+ ["outputs", t.outputs.join(" / ")],
421
+ ["repoOutputs", t.repoOutputs?.map((r) => `${r.repo}=${r.output}`).join(" / ")],
422
+ ["createdAt", t.createdAt],
423
+ ["startedAt", t.startedAt],
424
+ ["doneAt", t.doneAt],
425
+ ["checkedAt", t.checkedAt],
426
+ ["updatedAt", t.updatedAt],
427
+ ["updatedBy", t.updatedBy],
428
+ ];
429
+ for (const [k, v] of fields)
430
+ if (v)
431
+ lines.push(` ${k.padEnd(13)} ${String(v)}`);
432
+ if (t.body.trim())
433
+ lines.push("", indent(t.body.trim()));
434
+ if (t.record)
435
+ lines.push("", "変更の記録:", indent(t.record));
436
+ const acc = formatAcceptance(t, { emptyLine: false });
437
+ if (acc.length)
438
+ lines.push("", ...acc);
439
+ const blk = formatBlock(t, { history: true });
440
+ if (blk.length)
441
+ lines.push("", ...blk);
442
+ // 保存された関係をそのまま出す(相手が今の通常のタスクかは解かない)
443
+ if (t.relations.length)
444
+ lines.push("", "保存された関係:", ...t.relations.map((r) => ` → ${relationRole(r.type, "out")} ${r.target}`));
445
+ lines.push("", `ファイル: ${file}`);
446
+ return lines.join("\n");
447
+ }
@@ -0,0 +1,178 @@
1
+ import { resolveRequestId } from "../core/ops.js";
2
+ import { NotFoundError } from "../core/store/collection.js";
3
+ import { normalizeTaskId } from "../shared/refs.js";
4
+ import { previewOf, QUALITY_VERDICT_LABELS, TASK_REVIEW_SCOPE, TASK_REVIEW_VERDICT_LABELS, TASK_REVIEW_VERDICTS } from "../shared/taskReview.js";
5
+ import { table } from "./format.js";
6
+ import { UsageError } from "./project.js";
7
+ /**
8
+ * タスクの AI レビュー(core/taskReview。画面と同じサービス)。
9
+ * review <T> [--target ...] [--viewpoint ...] [--engine codex|mock] [--preview] 材料を固定して始め、終わるまで待つ(進み具合は stderr、
10
+ * Ctrl-C で取り消す)。--preview は材料を見るだけ
11
+ * reviews <T> / review-show <T> <run> / review-cancel <T> <run> [--acknowledge-stopped]
12
+ * 結果は参考の記録で、タスクの状態・済み・基準・証拠を変えない。アーカイブしたタスクの履歴も読める
13
+ */
14
+ const STATUS_LABEL = { running: "実行中", completed: "完了", failed: "失敗", cancelled: "取消" };
15
+ /** タスクの参照(アーカイブしたタスクも読むので、今のタスクの一覧では探さない) */
16
+ function taskKey({ ctx, current }, raw) {
17
+ if (!raw)
18
+ throw new UsageError("タスクを指定してください(T003 / <要望>/T003)");
19
+ const [head, tail] = raw.split("/", 2);
20
+ const rid = tail !== undefined ? resolveRequestId(ctx, head) : current;
21
+ if (tail === undefined && !current)
22
+ throw new UsageError(`${raw}: 要望を --req で指定してください`);
23
+ if (!rid)
24
+ throw new NotFoundError(head);
25
+ const tid = normalizeTaskId(tail ?? head);
26
+ if (!tid)
27
+ throw new UsageError(`${raw}: タスクの ID(T003)を指定してください`);
28
+ return { rid, tid };
29
+ }
30
+ export async function taskReviewCommand(cmd, env) {
31
+ if (cmd !== "review" && cmd !== "reviews" && cmd !== "review-show" && cmd !== "review-cancel")
32
+ return undefined;
33
+ const { ctx, out, args, o, actor } = env;
34
+ const svc = ctx.taskReview;
35
+ const { rid, tid } = taskKey(env, args[0]);
36
+ const key = `${rid}/${tid}`;
37
+ if (cmd === "reviews") {
38
+ const items = await svc.list(rid, tid);
39
+ return out.result(items, () => items.length
40
+ ? table(items.map((x) => x.state === "broken"
41
+ ? [x.id, "読めない", x.error]
42
+ : [x.run.id, STATUS_LABEL[x.run.status], x.run.startedAt.slice(0, 16).replace("T", " "), verdictSummary(x.verdicts), x.run.error ?? ""]))
43
+ : `レビューの履歴はありません(p3 review ${key})`);
44
+ }
45
+ if (cmd === "review-show" || cmd === "review-cancel") {
46
+ const run = args[1];
47
+ if (!run)
48
+ throw new UsageError(`p3 ${cmd} ${key} <run>`);
49
+ if (cmd === "review-show") {
50
+ const d = await svc.get(rid, tid, run);
51
+ return out.result(d, () => formatTaskReview(d));
52
+ }
53
+ const r = await svc.cancel(rid, tid, run, actor, { acknowledgeStopped: o["acknowledge-stopped"] });
54
+ return out.result(r, () => r.requested
55
+ ? `取消を頼みました: ${key}/${run}(実行しているプロセスが見つけて止めます)`
56
+ : r.run.abandoned
57
+ ? `中断にしました: ${key}/${run}(記録の上で終わりにしました。ほかの環境で動いているプロセスを止めたとは限りません)`
58
+ : `終わりにしました: ${key}/${run}(${STATUS_LABEL[r.run.status]}${r.run.error ? `: ${r.run.error}` : ""})`);
59
+ }
60
+ if (o.engine !== undefined && o.engine !== "codex" && o.engine !== "mock")
61
+ throw new UsageError("--engine は codex か mock");
62
+ const opts = { targets: o.target, viewpoint: o.viewpoint };
63
+ if (o.preview) {
64
+ const p = await svc.preview(rid, tid, opts);
65
+ const view = { ...previewOf(p.input), engineRequired: p.engineRequired };
66
+ return out.result(view, () => formatPreview(view));
67
+ }
68
+ const started = await svc.start(rid, tid, actor, { ...opts, engine: o.engine });
69
+ process.stderr.write(`レビューを始めました: ${key}/${started.id}(Ctrl-C で取り消す)\n`);
70
+ let shown = 0;
71
+ const tick = setInterval(() => {
72
+ void svc.get(rid, tid, started.id).then((d) => {
73
+ for (const e of d.run.log.slice(shown))
74
+ process.stderr.write(` ${e.text}\n`);
75
+ shown = Math.max(shown, d.run.log.length);
76
+ }, () => undefined);
77
+ }, 500);
78
+ const onInt = () => void svc.cancel(rid, tid, started.id, actor).catch(() => undefined);
79
+ process.on("SIGINT", onInt);
80
+ const d = await svc.wait(rid, tid, started.id);
81
+ clearInterval(tick);
82
+ process.removeListener("SIGINT", onInt);
83
+ for (const e of d.run.log.slice(shown))
84
+ process.stderr.write(` ${e.text}\n`);
85
+ if (d.run.status !== "completed") {
86
+ if (out.json)
87
+ out.result(d, () => "");
88
+ else
89
+ process.stderr.write(`${STATUS_LABEL[d.run.status]}: ${d.run.error ?? ""}\n`);
90
+ return 1;
91
+ }
92
+ return out.result(d, () => formatTaskReview(d));
93
+ }
94
+ function verdictSummary(v) {
95
+ if (!v)
96
+ return "";
97
+ return TASK_REVIEW_VERDICTS.filter((k) => v[k]).map((k) => `${TASK_REVIEW_VERDICT_LABELS[k]} ${v[k]}`).join(" · ");
98
+ }
99
+ function formatPreview(p) {
100
+ const lines = [`${p.task.ref} ${p.task.title}`, `材料の hash: ${p.hash}`, "", "比較項目:"];
101
+ for (const i of p.items)
102
+ lines.push(` ${i.id} ${i.text.split("\n")[0]}${i.kind === "body" ? "(本文から)" : ""}`);
103
+ lines.push("", "比較対象:");
104
+ for (const t of p.targets) {
105
+ lines.push(` ${t.repo} ${t.kind === "range" ? `${t.range.baseSpec}..${t.range.headSpec}(merge-base ${t.range.mergeBase.slice(0, 12)})` : "コミット"} 変更 ${t.changes} 件 出典: ${t.sources.join(", ")}`);
106
+ for (const c of t.commits)
107
+ lines.push(` ${c.sha.slice(0, 12)} ${c.subject}${c.otherTasks.length ? ` ※ほかのタスク ${c.otherTasks.join(", ")}` : ""}`);
108
+ }
109
+ if (p.quality)
110
+ lines.push("", `品質基準: ${p.quality.state === "set" ? `版 ${p.quality.version}・判定する ${p.quality.applies.map((q) => q.id).join(", ") || "なし"}${p.quality.exempt.length ? `・除外 ${p.quality.exempt.map((q) => q.id).join(", ")}` : ""}` : p.quality.state === "unset" ? "未設定" : "読めません"}`);
111
+ lines.push("", `観点: ${p.viewpoint.source}${p.viewpoint.repo ? `(${p.viewpoint.repo}@${p.viewpoint.sha?.slice(0, 12)}:${p.viewpoint.path})` : ""}`);
112
+ for (const n of p.notes)
113
+ lines.push(` ⚠ ${n.message}`);
114
+ if (p.engineRequired)
115
+ lines.push("", "※ Preflight の担当が agent なので、Codex で実行するなら --engine codex を付けてください");
116
+ return lines.join("\n");
117
+ }
118
+ /** 品質の表示(評価した版・最新との差・基準ごとの判定・違反の指摘)。古い記録は品質を評価していない */
119
+ function qualityLines(input, result) {
120
+ const q = input.quality;
121
+ if (!q)
122
+ return ["品質: 評価していません(品質基準を材料に入れる前の記録です)"];
123
+ if (q.latest.state !== "set")
124
+ return [`品質: 評価していません(品質基準が${q.latest.state === "unset" ? "未設定" : "読めません"})`];
125
+ const lines = [`品質(最新の品質基準 版 ${q.latest.version}。タスクに取り込んだ版: ${q.imported.length ? [...new Set(q.imported.map((x) => x.version))].join(", ") : "なし"}):`];
126
+ for (const d of q.diff.filter((x) => x.kind !== "edited"))
127
+ lines.push(` 差: ${d.kind}:${d.quality}${d.reason ? `(${d.reason})` : ""}`);
128
+ for (const r of result.quality ?? []) {
129
+ lines.push(` ${r.verdict === "violated" ? "✗" : "・"} ${r.standard} ${QUALITY_VERDICT_LABELS[r.verdict]} ${r.reason}`);
130
+ if (r.evidence.length)
131
+ lines.push(` 根拠: ${r.evidence.join(", ")}`);
132
+ if (r.unread)
133
+ lines.push(` 確かめられなかった範囲: ${r.unread}`);
134
+ }
135
+ for (const e of q.exempt)
136
+ lines.push(` ・ ${e.id} 除外(${e.exempt?.reason ?? ""})`);
137
+ const violated = (result.quality ?? []).filter((r) => r.verdict === "violated");
138
+ if (violated.length)
139
+ lines.push(`品質の指摘: ${violated.map((r) => r.standard).join(", ")} に違反があります(作業した側の証拠とは別の判定です)`);
140
+ return lines;
141
+ }
142
+ /** review-show の人向けの表示 */
143
+ export function formatTaskReview(d) {
144
+ const { run, input, result } = d;
145
+ const lines = [`${run.request}/${run.task}/${run.id} ${STATUS_LABEL[run.status]} ${run.startedAt}${run.startedBy ? ` ${run.startedBy}` : ""} (${run.engine}${run.model ? ` ${run.model}` : ""})`];
146
+ if (run.error)
147
+ lines.push(` ${run.error}`);
148
+ if (d.owner && d.owner.state !== "local" && d.owner.state !== "alive") {
149
+ lines.push(` 実行しているプロセスを確かめられません(${"reason" in d.owner ? d.owner.reason : ""})。止まっていると確かめたら p3 review-cancel ${run.request}/${run.task} ${run.id} --acknowledge-stopped`);
150
+ }
151
+ lines.push(`材料: 比較項目 ${input.items.length} 件・ファイル ${input.files.length} 件・観点 ${input.viewpoint.source}(${input.extractedAt})`);
152
+ for (const t of input.targets)
153
+ lines.push(` ${t.repo}: ${t.kind === "range" ? `${t.range.base.slice(0, 12)}..${t.range.head.slice(0, 12)}` : t.commits.map((c) => c.sha.slice(0, 12)).join(", ")}`);
154
+ for (const n of input.notes)
155
+ lines.push(` ⚠ ${n.message}`);
156
+ if (result) {
157
+ const text = new Map(input.items.map((i) => [i.id, i.text]));
158
+ lines.push("", "全体の所見:", ...result.overall.split("\n").map((l) => ` ${l}`), "");
159
+ for (const i of result.items) {
160
+ lines.push(`■ ${i.item} ${TASK_REVIEW_VERDICT_LABELS[i.verdict]} ${(text.get(i.item) ?? "").split("\n")[0]}`);
161
+ lines.push(` 理由: ${i.reason}`);
162
+ if (i.evidence.length)
163
+ lines.push(` 根拠: ${i.evidence.join(", ")}`);
164
+ for (const g of i.gaps)
165
+ lines.push(` 不足: ${g}`);
166
+ }
167
+ lines.push("", "意図しない変更の候補:");
168
+ if (!result.unplanned.length)
169
+ lines.push(" (見つかっていません)");
170
+ for (const u of result.unplanned)
171
+ lines.push(` - ${u.text}${u.evidence.length ? `(根拠: ${u.evidence.join(", ")})` : ""}`);
172
+ if (result.checks.length)
173
+ lines.push("", "人が確かめる点:", ...result.checks.map((c) => ` - ${c}`));
174
+ lines.push("", ...qualityLines(input, result));
175
+ lines.push("", `読めた範囲: ${result.coverage.read}`, `読めなかった範囲: ${result.coverage.unread || "(なし)"}`, "", `範囲: ${TASK_REVIEW_SCOPE}`);
176
+ }
177
+ return lines.join("\n");
178
+ }
@@ -10,6 +10,8 @@ import { ReleaseGenerator } from "./releaseNotes/generate.js";
10
10
  import { MockSummarizer } from "./releaseNotes/mockSummarizer.js";
11
11
  import { MilestoneReviewService } from "./milestoneReview/service.js";
12
12
  import { MockReviewer } from "./milestoneReview/mockReviewer.js";
13
+ import { TaskReviewService } from "./taskReview/service.js";
14
+ import { MockTaskReviewer } from "./taskReview/mockReviewer.js";
13
15
  /** p3 本体(パッケージ)のルート */
14
16
  export const P3_ROOT = fileURLToPath(new URL("../../", import.meta.url));
15
17
  /**
@@ -40,5 +42,6 @@ export async function openProject(dataDir, opts = {}) {
40
42
  // 要約の生成も Preflight と同じ接続と既定のエンジン(preflight.engine)を使う
41
43
  const releaseGenerator = new ReleaseGenerator(ws, { codex, mock: new MockSummarizer() }, { engine: async () => (await source.get()).preflight.engine });
42
44
  const milestoneReview = new MilestoneReviewService(ws, { codex, mock: new MockReviewer() }, { engine: async () => (await source.get()).preflight.engine });
43
- return { ws, preflight, releaseGenerator, milestoneReview, chatgpt, projectName: opts.projectName };
45
+ const taskReview = new TaskReviewService(ws, { codex, mock: new MockTaskReviewer() }, { engine: async () => (await source.get()).preflight.engine });
46
+ return { ws, preflight, releaseGenerator, milestoneReview, taskReview, chatgpt, projectName: opts.projectName };
44
47
  }
@@ -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
  }