@infodb/p3 0.10.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 (104) hide show
  1. package/README.md +6 -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-DGaoQoIa.js → RequestStatus-RG-OVQYY.js} +1 -1
  5. package/dist/web/assets/{Tabs-D16MqQxu.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-ChFzBoL2.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 +392 -3
  28. package/docs/development.md +1 -1
  29. package/docs/how-to-use.md +261 -5
  30. package/docs/installation.md +5 -5
  31. package/lib/cli/args.js +45 -0
  32. package/lib/cli/help.js +43 -1
  33. package/lib/cli/main.js +42 -4
  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 +219 -14
  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 +7 -1
  44. package/lib/core/milestoneReview/code.js +129 -0
  45. package/lib/core/milestoneReview/material.js +148 -0
  46. package/lib/core/milestoneReview/mockReviewer.js +28 -0
  47. package/lib/core/milestoneReview/review.js +325 -0
  48. package/lib/core/milestoneReview/service.js +214 -0
  49. package/lib/core/milestoneReview/store.js +176 -0
  50. package/lib/core/ops.js +9 -2
  51. package/lib/core/preflight/carryover.js +1 -1
  52. package/lib/core/preflight/codexEngine.js +20 -6
  53. package/lib/core/preflight/engine.js +6 -0
  54. package/lib/core/preflight/instructions.js +18 -1
  55. package/lib/core/preflight/mockEngine.js +4 -0
  56. package/lib/core/preflight/service.js +45 -4
  57. package/lib/core/projectRegistry.js +3 -3
  58. package/lib/core/quality.js +21 -0
  59. package/lib/core/qualityImprovement.js +221 -0
  60. package/lib/core/requestOps.js +101 -6
  61. package/lib/core/reviewRuns.js +205 -0
  62. package/lib/core/store/archivedTasks.js +74 -0
  63. package/lib/core/store/collection.js +12 -2
  64. package/lib/core/store/normalize.js +43 -2
  65. package/lib/core/store/preflightStore.js +9 -1
  66. package/lib/core/store/projectFile.js +18 -1
  67. package/lib/core/store/workspace.js +122 -14
  68. package/lib/core/taskReview/material.js +452 -0
  69. package/lib/core/taskReview/mockReviewer.js +30 -0
  70. package/lib/core/taskReview/paths.js +15 -0
  71. package/lib/core/taskReview/review.js +305 -0
  72. package/lib/core/taskReview/service.js +187 -0
  73. package/lib/core/taskReview/store.js +214 -0
  74. package/lib/server/api/manifest.js +74 -5
  75. package/lib/server/api/milestoneReviewRoutes.js +70 -0
  76. package/lib/server/api/routes.js +164 -20
  77. package/lib/server/api/taskReviewRoutes.js +66 -0
  78. package/lib/server/server.js +2 -2
  79. package/lib/shared/acceptance.js +378 -0
  80. package/lib/shared/milestoneGoals.js +57 -0
  81. package/lib/shared/milestoneReview.js +27 -0
  82. package/lib/shared/quality.js +391 -0
  83. package/lib/shared/qualityImprovement.js +1 -0
  84. package/lib/shared/qualityTemplates.js +31 -0
  85. package/lib/shared/taskBlock.js +142 -0
  86. package/lib/shared/taskReview.js +56 -0
  87. package/package.json +1 -1
  88. package/skills/p3/SKILL.md +31 -2
  89. package/dist/web/assets/Outputs-B4Tr7JzU.js +0 -1
  90. package/dist/web/assets/TagInput-pSYxm4bz.js +0 -1
  91. package/dist/web/assets/TaskDrawer-1Ev3RpRV.js +0 -3
  92. package/dist/web/assets/_requestId-BKhn019m.js +0 -1
  93. package/dist/web/assets/_requestId-Btpvuu7-.js +0 -30
  94. package/dist/web/assets/appCtx-D_Iaoh2e.js +0 -1
  95. package/dist/web/assets/board-DeHdxbN4.js +0 -1
  96. package/dist/web/assets/done-BFaHGt03.js +0 -1
  97. package/dist/web/assets/index-BF1xMdJo.css +0 -2
  98. package/dist/web/assets/index-CDWcKy1L.js +0 -12
  99. package/dist/web/assets/preload-helper-hSId95YD.js +0 -1
  100. package/dist/web/assets/release-notes-BWNDFDkH.js +0 -3
  101. package/dist/web/assets/requestData-B_320uxL.js +0 -1
  102. package/dist/web/assets/routes-BBD464IS.js +0 -3
  103. package/dist/web/assets/settings-D7PPrGjT.js +0 -1
  104. package/dist/web/assets/workTarget-Cijqq4yH.js +0 -1
package/lib/cli/main.js CHANGED
@@ -4,6 +4,16 @@ import { openProject } from "../core/context.js";
4
4
  import { machineSettingsSource, resolveMachineSettings, SettingsError } from "../core/machineSettings.js";
5
5
  import { progress, resolveRef, resolveRequestId, titleOf } from "../core/ops.js";
6
6
  import { OpRuleError } from "../core/requestOps.js";
7
+ import { AcceptanceInputError } from "../shared/acceptance.js";
8
+ import { BlockInputError } from "../shared/taskBlock.js";
9
+ import { taskReviewCommand } from "./taskReviewCommands.js";
10
+ import { qualityCommand } from "./qualityCommands.js";
11
+ import { QualityInputError } from "../shared/quality.js";
12
+ import { ImprovementError } from "../core/qualityImprovement.js";
13
+ import { TaskReviewRejected } from "../core/taskReview/material.js";
14
+ import { MilestonesConflictError, ProjectInputError } from "../core/store/workspace.js";
15
+ import { ReviewCancelRefused, ReviewRejected } from "../core/milestoneReview/service.js";
16
+ import { ReviewStoreError } from "../core/milestoneReview/store.js";
7
17
  import { HierarchyError } from "../core/hierarchy.js";
8
18
  import { startServer } from "../server/server.js";
9
19
  import { ConflictError, NotFoundError } from "../core/store/collection.js";
@@ -222,7 +232,7 @@ async function main(argv) {
222
232
  return { col: ctx.ws.tasksOf(rid), rid, tid };
223
233
  };
224
234
  const env = { ctx, out, args, o, actor, current, expectedRev, requestArg, taskArg, split, cwd, target };
225
- const handled = (await taskCommand(cmd, env)) ?? (await preflightCommand(cmd, env));
235
+ const handled = (await taskCommand(cmd, env)) ?? (await taskReviewCommand(cmd, env)) ?? (await preflightCommand(cmd, env));
226
236
  if (handled !== undefined)
227
237
  return handled;
228
238
  switch (cmd) {
@@ -273,16 +283,18 @@ async function main(argv) {
273
283
  : "",
274
284
  p.request.tags.map((t) => `#${t}`).join(" "),
275
285
  // 子のある要望は配下の集計(自分の値とは別)、子は親を添える
276
- `${p.request.title}${p.children.length ? ` [配下 ${p.subtree.done}/${p.subtree.total}・子 ${p.children.length}]` : ""}${p.request.parent ? ` ↑${p.request.parent}` : ""}${p.hierarchyIssues.length ? " ※親子の問題" : ""}`,
286
+ `${p.request.title}${p.blocked ? ` ⏸停止 ${p.blocked}` : ""}${p.children.length ? ` [配下 ${p.subtree.done}/${p.subtree.total}・子 ${p.children.length}${p.subtree.blocked > p.blocked ? `・配下の停止 ${p.subtree.blocked - p.blocked}` : ""}]` : ""}${p.request.parent ? ` ↑${p.request.parent}` : ""}${p.hierarchyIssues.length ? " ※親子の問題" : ""}`,
277
287
  ]);
278
288
  return `${head}\n${table(rows)}`;
279
289
  })
280
290
  .join("\n\n") || "要望はありません");
281
291
  });
282
292
  }
293
+ case "quality":
294
+ return qualityCommand(env);
283
295
  case "milestone":
284
296
  case "milestones":
285
- return milestoneCommand(ctx, out, args, o);
297
+ return milestoneCommand(ctx, out, args, o, actor);
286
298
  case "release-notes":
287
299
  case "release-note":
288
300
  return releaseNotesCommand(env);
@@ -327,10 +339,36 @@ main(process.argv.slice(2)).then((code) => process.exit(code), (e) => {
327
339
  const changedSet = e.code === "child_order_invalid" && (e.detail.reason === "not_child" || e.detail.reason === "missing");
328
340
  process.exit(e.code === "hierarchy_busy" || changedSet ? 3 : 1);
329
341
  }
342
+ // マイルストーンレビュー: 無い → 2、実行中・終わっている・動いている所有者がいる → 3、ほか(目的が無い・上限・ID・読めない)→ 1
343
+ if (e instanceof ReviewRejected || e instanceof ReviewStoreError || e instanceof ReviewCancelRefused) {
344
+ process.stderr.write(`${e.message}\n`);
345
+ const code = e.code;
346
+ process.exit(code === "not_found" || code === "unknown_milestone" ? 2 : code === "running" || code === "finished" || code === "owner_alive" || code === "exists" ? 3 : 1);
347
+ }
348
+ // タスクのレビュー: 実行中・材料が変わった → 3、ほか(未完了・比較対象・観点・上限・担当)→ 1
349
+ if (e instanceof TaskReviewRejected) {
350
+ process.stderr.write(`${e.message}\n`);
351
+ process.exit(e.code === "running" || e.code === "material_changed" ? 3 : 1);
352
+ }
353
+ // 改善要望: 診断が変わった・登録先がある → 3、無い → 2、ほか → 1
354
+ if (e instanceof ImprovementError) {
355
+ process.stderr.write(`${e.message}\n`);
356
+ process.exit(e.code === "not_found" ? 2 : e.code === "diagnosis_changed" || e.code === "existing" || e.code === "closed_existing" ? 3 : 1);
357
+ }
358
+ // 品質基準: 版が違う → 3、規則に合わない・読めない → 1
359
+ if (e instanceof QualityInputError) {
360
+ process.stderr.write(`${e.message}\n`);
361
+ process.exit(e.code === "quality_conflict" ? 3 : 1);
362
+ }
363
+ // マイルストーンの版が違う(読んだ後に他で変わった)→ 3。何も書いていない
364
+ if (e instanceof MilestonesConflictError) {
365
+ process.stderr.write(`競合: ${e.message}\n`);
366
+ process.exit(3);
367
+ }
330
368
  if (e instanceof NotFoundError) {
331
369
  process.stderr.write(`見つかりません: ${e.id}\n`);
332
370
  process.exit(2);
333
371
  }
334
- process.stderr.write(`${e instanceof UsageError || e instanceof OpRuleError ? "" : "エラー: "}${e.message}\n`);
372
+ process.stderr.write(`${e instanceof UsageError || e instanceof OpRuleError || e instanceof ProjectInputError || e instanceof AcceptanceInputError || e instanceof BlockInputError ? "" : "エラー: "}${e.message}\n`);
335
373
  process.exit(1);
336
374
  });
package/lib/cli/output.js CHANGED
@@ -4,6 +4,7 @@ import {} from "../core/context.js";
4
4
  import { resolve, titleOf } from "../core/ops.js";
5
5
  import {} from "../core/supersede.js";
6
6
  import { table } from "./format.js";
7
+ import { formatAcceptance, formatBlock } from "./showView.js";
7
8
  import { taskWork } from "../core/workTargets.js";
8
9
  import { DIRECT_TASK_NOTE, LATER_PREFLIGHT_NOTE } from "../shared/directTask.js";
9
10
  /** CLI の出力(人向けの表と --json)と、表示の部品 */
@@ -26,7 +27,7 @@ export function formatEntity(ctx, item, file) {
26
27
  const lines = [`${head} ${item.title}`, ""];
27
28
  if ("ref" in item)
28
29
  lines.push(` ${"作業先".padEnd(11)} ${workHint(ctx, item).replace(/^作業先: /, "")}`);
29
- const skip = new Set(["id", "ref", "request", "title", "body", "relations", "repo", "record"]);
30
+ const skip = new Set(["id", "ref", "request", "title", "body", "relations", "repo", "record", "acceptanceCriteria", "acceptanceEvidence", "acceptanceSeq", "acceptanceProblems", "block", "blockHistory", "blockProblems"]);
30
31
  for (const [k, v] of Object.entries(item)) {
31
32
  if (skip.has(k) || v === undefined || (Array.isArray(v) && !v.length))
32
33
  continue;
@@ -36,6 +37,13 @@ export function formatEntity(ctx, item, file) {
36
37
  lines.push("", indent(item.body.trim()));
37
38
  if ("record" in item && item.record)
38
39
  lines.push("", "変更の記録:", indent(item.record));
40
+ if ("ref" in item) {
41
+ const blk = formatBlock(item, { history: true });
42
+ if (blk.length)
43
+ lines.push("", ...blk);
44
+ }
45
+ if ("ref" in item)
46
+ lines.push("", ...formatAcceptance(item));
39
47
  if ("ref" in item) {
40
48
  const out = item.relations.map((r) => ` → ${pad(relationRole(r.type, "out"))} ${r.target} ${titleOf(ctx, `${home}/${r.target}`)}`);
41
49
  const inc = [
@@ -303,7 +303,7 @@ function inputMatchLine(rid, run, m) {
303
303
  }
304
304
  return `\n※ ${staleMessage(rid, run.id, m)}`;
305
305
  }
306
- async function pickRun(ctx, rid, runId) {
306
+ export async function pickRun(ctx, rid, runId) {
307
307
  const runs = await ctx.preflight.list(rid);
308
308
  const run = runId ? runs.find((r) => r.id === runId) : runs[0];
309
309
  if (!run)
@@ -348,6 +348,12 @@ function formatRun(ctx, rid, run) {
348
348
  d.title,
349
349
  d.dependsOn.length ? `← ${d.dependsOn.join(",")}` : "",
350
350
  ])));
351
+ // 受け入れ基準(タスク化の前に p3 criteria <D> で直せる)
352
+ for (const d of run.drafts) {
353
+ if (!d.acceptanceCriteria?.length && !d.acceptanceProblems?.length)
354
+ continue;
355
+ lines.push(` ${d.key} の受け入れ基準:`, ...(d.acceptanceCriteria ?? []).map((c) => ` ${c.id} ${c.text}`), ...(d.acceptanceProblems ?? []).map((p) => ` ※読めない: ${p}`));
356
+ }
351
357
  lines.push("", `ファイル: ${relative(process.cwd(), join(ctx.ws.preflight.runDir(rid, run.id), "drafts"))}/`);
352
358
  }
353
359
  if (a?.split) {
@@ -141,11 +141,14 @@ export function agentsSnippet(kinds) {
141
141
  - 着手する前に \`p3 show T003 --brief --json\` で本文・依存とその状態(\`dependencies\`)・置き換えの注意(\`warnings\`)を読む
142
142
  - 着手する前に、\`--brief --json\` の \`work\`(作業先のリポジトリとブランチ)を見て、そのリポジトリでブランチに入る(作業先なしなら移動しない)
143
143
  - 着手するときは \`p3 move T003 doing\`。テストを通したら、コミットする前に \`p3 move T003 done --output <今ある成果物(変えたファイルや説明)> --record -\` で完了にする(変更の記録は必須: 何を変えたか・なぜ・入れた決まり・やめたもの を標準入力から Markdown で。まだ無い URL は書かない)
144
+ - 受け入れ基準(\`--brief --json\` の \`item.acceptanceCriteria\`)があれば着手する前に読み、完了するときに基準ごとの証拠を \`--evidence-file evidence.md\`(見出し \`## A1 met\` ごとに通したテスト・コマンドと結果・確かめたこと)で残す。\`[Q1]\` で始まる基準はプロジェクトの品質基準で、その検査は自分で実行してコマンド・参照先とコミット(未コミットならそう書く)・結果・範囲を証拠に書く(P3 が実行したとは書かない)。満たせなかった・確かめていない項目は \`unmet\` / \`unverified\` と理由を正直に書き(推測で \`met\` にしない)、未達・未検証を残して完了にしたら人に伝える。証拠は自分の申告で、済みにするかは人が決める。基準を自分で消す・書き換えて満たしたことにしない
144
145
  - 要望のタスクを全部終えたら、コミットする前に \`p3 request set <要望ID> status=resolved\`(対応済)にする。完了済(done)・見送り(rejected)とタスクの済み(check)は人が決める
145
146
  - 子の要望(\`parent\` のある要望)は、親とは別の要望として子ごとのタスクとブランチで作業する(親のタスクにしない)。分割の案の採用(\`accept\`)は人が行う。子の Preflight は親と同じ担当で、頼まれたときだけ(分割の採用・子の作成から自分で評価へ進まない)。親を対応済にするのは、親のタスクと見送り以外の子(\`request show <親> --brief --json\` の \`children\`)が全部終わってから
146
147
  - データのフォルダがこの作業ツリーの中で git 管理されているなら、要望のフォルダ(\`requests/<要望ID>/\`)の変更も実装と同じコミットに入れる(後のレビューで要望とやったことを精査するため。子なら祖先の要望のフォルダ、親を対応済にするときは子孫の要望のフォルダ(見送りの子など)のまだ入っていない変更も入れ、ほかの要望・関係ない変更は入れない。外・無視・worktree のときは入らないので、移動や \`git add -f\` はしない)。push に失敗したら完了の記録は残し、公開できていないことを伝える。要望のフォルダは、マージするまで要望のブランチにしか無い。既定のブランチに切り替えると、その要望(子なら親の子の一覧からも)が消えたように見えるが、データはブランチにある(作り直したり、別のブランチから写したりしない)
147
148
  - コミットや PR の URL は後から \`p3 move T003 done --output <URL>\` で足す(完了・記録はそのまま。データをコミットしているなら追記もコミットして push)。複数のリポジトリにまたがるときは最後のタスクに \`--repo-output <参照先>=<PR の URL>\` で全部の PR を残す
149
+ - タスクの AI レビュー(\`p3 review\`)は頼まれずに始めない(Codex を使う)。結果を理由に済みにしたり基準・証拠を書き換えたりしない
148
150
  - 置き換えられたタスク(\`p3 ls\` の \`※置換\`、\`--json\` の \`superseded\`)からは始めない。\`move\` が \`warnings\` を返したら止めて人に確かめる
151
+ - 人の判断・権限が要る・前提が崩れた・テストが通らず先に進めないなどでタスクを続けられなくなったら、\`p3 block T003 --reason "<具体的な理由>" --decision "<人に決めてほしいこと>" --json\` で止まっている理由を付け(通常の修正・調査の途中では使わない)、JSON の \`block\` で保存できたことを確かめてから、理由・いつから・答えてほしいこと・再開のしかたを人に伝えて作業を終える(止まったまま完了・済み・対応済に進めない。基準や証拠を書き換えない)。回答を受けたら \`p3 unblock T003 --resolution "<回答>"\` で解除して再開する(解除だけでは再開しない。人が先に解除していたら履歴の回答を読んで確かめる)
149
152
  - 作業中に新しく必要になった作業は \`p3 new "<タイトル>" --body "..."\` でタスクにする(人への質問はタスクにしない)
150
153
  `;
151
154
  }
@@ -0,0 +1,163 @@
1
+ import { qualityTemplate, qualityView, updateQuality } from "../core/quality.js";
2
+ import { checkLine } from "../shared/quality.js";
3
+ import { diagnoseQuality, improvementDraft, registerImprovement } from "../core/qualityImprovement.js";
4
+ import { readBody } from "./args.js";
5
+ import { table } from "./format.js";
6
+ import { UsageError } from "./project.js";
7
+ /**
8
+ * 品質基準(core/quality.ts。画面の設定の「品質基準」と同じ)。
9
+ * quality 今の設定(未設定・設定済み・読めない)とテンプレートの改版の差分
10
+ * quality templates / quality template <id> 同梱のテンプレートの一覧・中身
11
+ * quality init 空の品質基準を設定する(意図して空)
12
+ * quality adopt <テンプレート> テンプレートを写して採用する / quality upgrade <テンプレート> 改版の差分を当てる
13
+ * quality add --text 文 [--repo 名前]... (--command コマンド --success 成功の条件 | --reference 確かめ方)
14
+ * quality set <Q1> [--text] [--repo]... [--command --success | --reference] quality rm <Q1>
15
+ * quality exempt <Q1> --reason 理由 / quality unexempt <Q1>
16
+ * 変える操作は --version <版>(quality --json の version)を付けると、違えば競合(終了コード 3)
17
+ */
18
+ export async function qualityCommand(env) {
19
+ const { ctx, out, args, o } = env;
20
+ const [sub, ...rest] = args;
21
+ const ws = ctx.ws;
22
+ if (sub === undefined || sub === "show") {
23
+ const v = qualityView(ws);
24
+ return out.result(v, () => formatQuality(v));
25
+ }
26
+ if (sub === "templates") {
27
+ const v = qualityView(ws);
28
+ return out.result(v.templates, () => table(v.templates.map((t) => [`${t.id}@${t.version}`, t.title, `${t.items} 件`, t.description])));
29
+ }
30
+ if (sub === "template") {
31
+ const t = qualityTemplate(rest[0] ?? "", o.version ? Number(o.version) : undefined);
32
+ if (!t)
33
+ throw new UsageError(`テンプレートがありません: ${rest[0] ?? ""}(p3 quality templates)`);
34
+ return out.result(t, () => [`${t.id}@${t.version} ${t.title}`, ` ${t.description}`, "", ...t.items.map((i) => ` ${i.key} ${i.text}\n ${checkLine(i.check)}`)].join("\n"));
35
+ }
36
+ if (sub === "improve")
37
+ return improveCommand(env, rest);
38
+ const check = () => {
39
+ if (o.reference !== undefined) {
40
+ if (o.command !== undefined || o.success !== undefined)
41
+ throw new UsageError("--reference(人の確認)と --command / --success(機械の検査)はどちらか一方です");
42
+ return { kind: "manual", reference: readBody(o.reference) };
43
+ }
44
+ if (o.command !== undefined || o.success !== undefined)
45
+ return { kind: "machine", command: o.command ?? "", success: o.success ?? "" };
46
+ return undefined;
47
+ };
48
+ let ops;
49
+ switch (sub) {
50
+ case "init":
51
+ ops = [{ op: "init" }];
52
+ break;
53
+ case "adopt":
54
+ if (!rest[0])
55
+ throw new UsageError("使い方: p3 quality adopt <テンプレート>(p3 quality templates)");
56
+ ops = [{ op: "adopt", template: rest[0] }];
57
+ break;
58
+ case "upgrade":
59
+ if (!rest[0])
60
+ throw new UsageError("使い方: p3 quality upgrade <テンプレート>(差分は p3 quality で見る)");
61
+ ops = [{ op: "upgrade", template: rest[0] }];
62
+ break;
63
+ case "add": {
64
+ const c = check();
65
+ if (!c)
66
+ throw new UsageError("確認の方法を指定してください: --command <コマンド> --success <成功の条件>(機械の検査)か --reference <確かめ方>(人の確認)");
67
+ ops = [{ op: "add", standard: { text: readBody(o.text ?? ""), ...(o.repo !== undefined ? { repos: [o.repo] } : {}), check: c } }];
68
+ break;
69
+ }
70
+ case "set": {
71
+ if (!rest[0])
72
+ throw new UsageError("使い方: p3 quality set <Q1> [--text 文] [--repo 名前|all] [--command ... --success ... | --reference ...]");
73
+ const c = check();
74
+ ops = [{ op: "edit", id: rest[0], standard: { ...(o.text !== undefined ? { text: readBody(o.text) } : {}), ...(o.repo !== undefined ? { repos: o.repo === "all" ? [] : [o.repo] } : {}), ...(c ? { check: c } : {}) } }];
75
+ break;
76
+ }
77
+ case "rm":
78
+ case "remove":
79
+ if (!rest.length)
80
+ throw new UsageError("使い方: p3 quality rm <Q1> [...]");
81
+ ops = rest.map((id) => ({ op: "remove", id }));
82
+ break;
83
+ case "exempt":
84
+ if (!rest[0] || o.reason === undefined)
85
+ throw new UsageError("使い方: p3 quality exempt <Q1> --reason 理由(理由は必須)");
86
+ ops = [{ op: "exempt", id: rest[0], reason: readBody(o.reason) }];
87
+ break;
88
+ case "unexempt":
89
+ if (!rest[0])
90
+ throw new UsageError("使い方: p3 quality unexempt <Q1>");
91
+ ops = [{ op: "unexempt", id: rest[0] }];
92
+ break;
93
+ default:
94
+ throw new UsageError(`quality の操作は show / templates / template / init / adopt / upgrade / add / set / rm / exempt / unexempt / improve です: ${sub}`);
95
+ }
96
+ const v = await updateQuality(ws, ops, { expectedVersion: o.version });
97
+ return out.result(v, () => formatQuality(v));
98
+ }
99
+ /**
100
+ * quality improve [task <要望>/<T> <run> | milestone <ID> <run>] 不足の診断と改善要望の原稿(読むだけ。省くとプロジェクトの設定)
101
+ * --key <不足の鍵>...(省くと既定で選ぶもの)
102
+ * --register --hash <診断の版> [--title 題] [--body 本文|-] [--reopen] 明示して登録する
103
+ */
104
+ async function improveCommand({ ctx, out, o, actor }, rest) {
105
+ const [kind, a, b] = rest;
106
+ let source;
107
+ if (kind === undefined || kind === "project")
108
+ source = { type: "project" };
109
+ else if (kind === "task") {
110
+ const [rid, tid] = (a ?? "").split("/");
111
+ if (!rid || !tid || !b)
112
+ throw new UsageError("使い方: p3 quality improve task <要望>/<T> <run>");
113
+ source = { type: "task-review", request: rid, task: tid, run: b };
114
+ }
115
+ else if (kind === "milestone") {
116
+ if (!a || !b)
117
+ throw new UsageError("使い方: p3 quality improve milestone <ID> <run>");
118
+ source = { type: "milestone-review", milestone: a, run: b };
119
+ }
120
+ else
121
+ throw new UsageError("使い方: p3 quality improve [task <要望>/<T> <run> | milestone <ID> <run>]");
122
+ const d = await diagnoseQuality(ctx, source);
123
+ const keys = o.key?.length ? o.key : d.findings.filter((f) => f.suggested).map((f) => f.key);
124
+ if (!o.register) {
125
+ const draft = keys.length ? improvementDraft(d, keys) : undefined;
126
+ return out.result({ ...d, picked: keys, ...(draft ? { draft } : {}) }, () => [
127
+ `品質の診断(${kind ?? "project"}。版 ${d.hash}):`,
128
+ ...(d.findings.length ? d.findings.map((f) => ` [${keys.includes(f.key) ? "x" : " "}] ${f.key} ${f.reason}${d.registered[f.key] ? ` → 登録済み ${d.registered[f.key].request}(${d.registered[f.key].status ?? "?"})` : ""}`) : [" 不足はありません"]),
129
+ ...d.notes.map((n) => ` ※ ${n}`),
130
+ ...(draft ? ["", `題: ${draft.title}`, "", draft.body, "", `登録するなら: p3 quality improve ${rest.join(" ")} --register --hash ${d.hash}${o.key?.length ? o.key.map((k) => ` --key ${k}`).join("") : ""}`] : []),
131
+ ].join("\n"));
132
+ }
133
+ if (!o.hash)
134
+ throw new UsageError("登録するには、原稿を確かめた診断の版を --hash で渡してください(p3 quality improve で出ます)");
135
+ const draft = improvementDraft(d, keys);
136
+ const r = await registerImprovement(ctx, { source, keys, title: o.title ?? draft.title, body: o.body !== undefined ? readBody(o.body) : draft.body, hash: o.hash, reopenClosed: o.reopen }, actor);
137
+ return out.result(r, () => `要望を登録しました: ${r.request.id} ${r.request.title}(不足 ${r.keys.join(", ")})`);
138
+ }
139
+ export function formatQuality(v) {
140
+ const q = v.quality;
141
+ if (q.state === "unset") {
142
+ return [
143
+ "品質基準: 未設定(初めて作ったときの状態に任せています)",
144
+ " テンプレートから始める: p3 quality adopt basic(一覧は p3 quality templates)。空のまま設定するなら p3 quality init",
145
+ ].join("\n");
146
+ }
147
+ if (q.state === "invalid")
148
+ return ["品質基準: 読めません(project.yaml の quality を直してください。保存しても消しません)", ...q.problems.map((p) => ` - ${p}`)].join("\n");
149
+ const lines = [`品質基準: ${q.config.standards.length} 件(版 ${v.version}${q.config.templates?.length ? `・テンプレート ${q.config.templates.map((t) => `${t.id}@${t.version}`).join(", ")}` : ""})`];
150
+ if (!q.config.standards.length)
151
+ lines.push(" (意図して空にしています)");
152
+ for (const s of q.config.standards) {
153
+ lines.push(` ${s.id} ${s.text}${s.repos?.length ? ` [${s.repos.join(", ")}]` : ""}${s.exempt ? " ※除外" : ""}`, ` ${checkLine(s.check)}`);
154
+ if (s.exempt)
155
+ lines.push(` 除外の理由: ${s.exempt.reason}`);
156
+ }
157
+ for (const w of q.warnings ?? [])
158
+ lines.push(` ⚠ ${w}`);
159
+ for (const d of v.diffs) {
160
+ lines.push(`テンプレート ${d.template} に新しい版があります(${d.from} → ${d.to}。足す ${d.added.length}・変わる ${d.changed.length}・消える ${d.removed.length})。当てるなら p3 quality upgrade ${d.template}`);
161
+ }
162
+ return lines.join("\n");
163
+ }
@@ -19,6 +19,8 @@ export function readsOnly(cmd, args) {
19
19
  case "request":
20
20
  case "req":
21
21
  return sub === "ls" || sub === "list" || sub === "show";
22
+ case "quality":
23
+ return sub === undefined || sub === "show" || sub === "templates" || sub === "template";
22
24
  case "milestone":
23
25
  case "milestones":
24
26
  return sub === undefined || sub === "ls" || sub === "list";
@@ -1,5 +1,9 @@
1
- import { basename, relative } from "node:path";
1
+ import { readFile } from "node:fs/promises";
2
+ import { basename, relative, resolve as resolvePath } from "node:path";
2
3
  import { REQUEST_STATUSES } from "../shared/types.js";
4
+ import { nextGoalId } from "../shared/milestoneGoals.js";
5
+ import { QUALITY_VERDICT_LABELS } from "../shared/taskReview.js";
6
+ import { REVIEW_STATUS_LABELS, REVIEW_VERDICT_LABELS, REVIEW_VERDICTS } from "../shared/milestoneReview.js";
3
7
  import {} from "../core/context.js";
4
8
  import { archiveRequest, checkMilestone, checkMilestoneRemoval, createRequest, orderChildren, updateRequest } from "../core/requestOps.js";
5
9
  import { hierarchyNow, resolvedIssue } from "../core/requestStatus.js";
@@ -155,37 +159,238 @@ export async function requestCommand(ctx, out, args, o, actor, requestArg, expec
155
159
  }
156
160
  // --- マイルストーン -----------------------------------------------------------
157
161
  /** マイルストーン(リリース)。複数の要望をまとめる単位で、project.yaml に書く */
158
- export async function milestoneCommand(ctx, out, args, o) {
162
+ const MILESTONE_USAGE = "p3 milestone [ls | show <id> | add <id> | set <id> | rm <id> | purpose <id> (--body 本文|- | --file ファイル | --off) | goal add <id> <文> | goal set <id> <G番号> <文> | goal rm <id> <G番号> | review <id> | reviews <id> | review-show <id> <run> | review-cancel <id> <run>]";
163
+ /**
164
+ * マイルストーンの操作。保存はロックの中で読んだ最新の並びから作り直す(Workspace.updateMilestones。指定した項目のほかを巻き戻さない)。
165
+ * --version(show --json の milestonesVersion)を付けると、その版から変わっていれば競合(終了コード 3)で何も書かない
166
+ */
167
+ export async function milestoneCommand(ctx, out, args, o, actor) {
159
168
  const [sub, id] = args;
169
+ if (sub === "review" || sub === "reviews" || sub === "review-show" || sub === "review-cancel")
170
+ return reviewCommand(ctx, out, args, o, actor);
160
171
  const ms = ctx.ws.project.milestones;
161
172
  const count = (mid) => ctx.ws.requests.list().filter((r) => r.milestone === mid).length;
173
+ const save = { milestonesVersion: o.version };
174
+ /** 最新の並びの中で id のマイルストーンを変える(無ければ使い方の誤り) */
175
+ const change = async (mid, fn) => {
176
+ const p = await ctx.ws.updateMilestones((cur) => {
177
+ if (!cur.some((m) => m.id === mid))
178
+ throw new UsageError(`マイルストーンがありません: ${mid}`);
179
+ return cur.map((m) => (m.id === mid ? fn(m) : m));
180
+ }, save);
181
+ return p.milestones.find((m) => m.id === mid);
182
+ };
183
+ const needId = (cmd) => {
184
+ if (!id)
185
+ throw new UsageError(`p3 milestone ${cmd} <id>`);
186
+ return id;
187
+ };
162
188
  if (sub === "add" || sub === "set") {
163
189
  if (!id || !/^[A-Za-z0-9._-]+$/.test(id))
164
190
  throw new UsageError(`p3 milestone ${sub} <id>(英数字と . _ -)`);
165
- const cur = ms.find((m) => m.id === id);
166
- if (sub === "add" && cur)
167
- throw new UsageError(`既にあります: ${id}(変えるなら p3 milestone set)`);
168
- if (sub === "set" && !cur)
169
- throw new UsageError(`マイルストーンがありません: ${id}`);
170
- const next = {
191
+ const make = (cur) => ({
192
+ ...cur,
171
193
  id,
172
194
  title: o.title ?? cur?.title ?? id,
173
195
  due: o.due !== undefined ? (o.due ? date(o.due) : undefined) : cur?.due,
174
196
  done: o.done ?? cur?.done,
175
- };
176
- await ctx.ws.saveProject({ milestones: cur ? ms.map((m) => (m.id === id ? next : m)) : [...ms, next] });
177
- return out.result(next, () => `${cur ? "更新" : "追加"}しました: ${next.title}(${id}${next.due ? ` · ${next.due}` : ""})`);
197
+ });
198
+ let existed = false;
199
+ const p = await ctx.ws.updateMilestones((cur) => {
200
+ const was = cur.find((m) => m.id === id);
201
+ existed = !!was;
202
+ if (sub === "add" && was)
203
+ throw new UsageError(`既にあります: ${id}(変えるなら p3 milestone set)`);
204
+ if (sub === "set" && !was)
205
+ throw new UsageError(`マイルストーンがありません: ${id}`);
206
+ return was ? cur.map((m) => (m.id === id ? make(m) : m)) : [...cur, make(undefined)];
207
+ }, save);
208
+ const next = p.milestones.find((m) => m.id === id);
209
+ return out.result(next, () => `${existed ? "更新" : "追加"}しました: ${next.title}(${id}${next.due ? ` · ${next.due}` : ""})`);
178
210
  }
179
211
  if (sub === "rm" || sub === "remove") {
180
212
  if (!id || !ms.some((m) => m.id === id))
181
213
  throw new UsageError(`マイルストーンがありません: ${id ?? ""}`);
182
214
  await checkMilestoneRemoval(ctx, ms.filter((m) => m.id !== id).map((m) => m.id));
183
- await ctx.ws.saveProject({ milestones: ms.filter((m) => m.id !== id) });
215
+ await ctx.ws.updateMilestones((cur) => cur.filter((m) => m.id !== id), save);
184
216
  return out.result({ removed: id }, () => `外しました: ${id}`);
185
217
  }
218
+ if (sub === "show") {
219
+ const mid = needId("show");
220
+ const m = ms.find((x) => x.id === mid);
221
+ if (!m)
222
+ throw new UsageError(`マイルストーンがありません: ${mid}`);
223
+ return out.result({ ...m, requests: count(mid), milestonesVersion: ctx.ws.milestonesVersion }, () => formatMilestone(m, count(mid)));
224
+ }
225
+ if (sub === "purpose") {
226
+ const mid = needId("purpose");
227
+ const given = [o.off, o.body !== undefined, o.file !== undefined].filter(Boolean).length;
228
+ if (given !== 1)
229
+ throw new UsageError(`p3 milestone purpose ${mid} --body 本文|- か --file ファイル か --off(どれか1つ)`);
230
+ const text = o.off ? "" : o.file !== undefined ? await readFile(resolvePath(process.cwd(), o.file), "utf8") : readBody(o.body);
231
+ const m = await change(mid, (x) => ({ ...x, purpose: text }));
232
+ return out.result(m, () => (m.purpose ? `目的を保存しました: ${mid}` : `目的を外しました: ${mid}`));
233
+ }
234
+ if (sub === "goal") {
235
+ const [, op, mid, a, b] = args;
236
+ if (!mid || !["add", "set", "rm", "remove"].includes(op ?? ""))
237
+ throw new UsageError("p3 milestone goal add <id> <文> | goal set <id> <G番号> <文> | goal rm <id> <G番号>");
238
+ if (op === "add") {
239
+ if (a === undefined)
240
+ throw new UsageError(`p3 milestone goal add ${mid} <文>`);
241
+ let gid = "";
242
+ const m = await change(mid, (x) => {
243
+ gid = nextGoalId(x.goals ?? []);
244
+ return { ...x, goals: [...(x.goals ?? []), { id: gid, text: a }] };
245
+ });
246
+ return out.result({ ...m, added: gid }, () => `予定機能を追加しました: ${mid} ${gid}`);
247
+ }
248
+ if (!a)
249
+ throw new UsageError(`p3 milestone goal ${op} ${mid} <G番号>`);
250
+ const exists = (x) => {
251
+ if (!(x.goals ?? []).some((g) => g.id === a))
252
+ throw new UsageError(`予定機能がありません: ${mid} ${a}`);
253
+ };
254
+ if (op === "set") {
255
+ if (b === undefined)
256
+ throw new UsageError(`p3 milestone goal set ${mid} ${a} <文>`);
257
+ const m = await change(mid, (x) => (exists(x), { ...x, goals: (x.goals ?? []).map((g) => (g.id === a ? { ...g, text: b } : g)) }));
258
+ return out.result(m, () => `予定機能を更新しました: ${mid} ${a}`);
259
+ }
260
+ const m = await change(mid, (x) => (exists(x), { ...x, goals: (x.goals ?? []).filter((g) => g.id !== a) }));
261
+ return out.result({ ...m, removed: a }, () => `予定機能を外しました: ${mid} ${a}`);
262
+ }
186
263
  if (sub && sub !== "ls" && sub !== "list")
187
- throw new UsageError("p3 milestone [ls | add <id> | set <id> | rm <id>]");
264
+ throw new UsageError(MILESTONE_USAGE);
188
265
  const shown = sortMilestones(ms);
189
- return out.result(shown, () => table(shown.map((m) => [m.id, m.title, m.due ?? "", m.done ? "済" : "", `要望 ${count(m.id)}`])) ||
266
+ return out.result(shown, () => table(shown.map((m) => [m.id, m.title, m.due ?? "", m.done ? "済" : "", `要望 ${count(m.id)}`, m.purpose ? "目的あり" : "", m.goals?.length ? `予定機能 ${m.goals.length}` : ""])) ||
190
267
  "マイルストーンはありません(p3 milestone add v0.1 --title 最初のリリース --due 2026-11-30)");
191
268
  }
269
+ /** milestone show の人向けの表示 */
270
+ function formatMilestone(m, requests) {
271
+ const lines = [`${m.id} ${m.title}${m.due ? ` 期限 ${m.due}` : ""}${m.done ? " リリース済み" : ""} 要望 ${requests}`, "", "目的:"];
272
+ lines.push(m.purpose ? m.purpose.split("\n").map((l) => ` ${l}`).join("\n") : ` (なし。p3 milestone purpose ${m.id} --file 目的.md)`);
273
+ lines.push("", "予定している機能・目標:");
274
+ lines.push(m.goals?.length ? m.goals.map((g) => ` ${g.id} ${g.text}`).join("\n") : ` (なし。p3 milestone goal add ${m.id} "文")`);
275
+ return lines.join("\n");
276
+ }
277
+ // --- マイルストーンレビュー ----------------------------------------------------
278
+ /**
279
+ * マイルストーンレビュー(core/milestoneReview。画面と同じ規則)。review は終わるまで待ち、進み具合は stderr に出す(Ctrl-C で取り消す)。
280
+ * 結果は参考の記録で、要望の状態・リリースノート・リリース済みは変えない
281
+ */
282
+ async function reviewCommand(ctx, out, args, o, actor) {
283
+ const [sub, mid, run] = args;
284
+ if (!mid)
285
+ throw new UsageError(`p3 milestone ${sub} <id>${sub === "review-show" || sub === "review-cancel" ? " <run>" : ""}`);
286
+ const svc = ctx.milestoneReview;
287
+ if (sub === "reviews") {
288
+ const items = await svc.list(mid);
289
+ return out.result(items, () => items.length
290
+ ? table(items.map((x) => x.state === "broken"
291
+ ? [x.id, "読めない", x.error]
292
+ : [x.run.id, REVIEW_STATUS_LABELS[x.run.status], x.run.startedAt.slice(0, 16).replace("T", " "), verdictSummary(x.verdicts), x.run.error ?? ""]))
293
+ : `レビューの履歴はありません(p3 milestone review ${mid})`);
294
+ }
295
+ if (sub === "review-show" || sub === "review-cancel") {
296
+ if (!run)
297
+ throw new UsageError(`p3 milestone ${sub} ${mid} <run>`);
298
+ if (sub === "review-show") {
299
+ const d = await svc.get(mid, run);
300
+ return out.result(d, () => formatReview(d));
301
+ }
302
+ const r = await svc.cancel(mid, run, actor, { acknowledgeStopped: o["acknowledge-stopped"] });
303
+ return out.result(r, () => r.requested
304
+ ? `取消を頼みました: ${mid}/${run}(実行しているプロセスが見つけて止めます)`
305
+ : r.run.abandoned
306
+ ? `中断にしました: ${mid}/${run}(記録の上で終わりにしました。ほかの環境で動いているプロセスを止めたとは限りません)`
307
+ : `終わりにしました: ${mid}/${run}(${REVIEW_STATUS_LABELS[r.run.status]}${r.run.error ? `: ${r.run.error}` : ""})`);
308
+ }
309
+ if (o.engine !== undefined && o.engine !== "codex" && o.engine !== "mock")
310
+ throw new UsageError("--engine は codex か mock");
311
+ const started = await svc.start(mid, actor, o.engine);
312
+ process.stderr.write(`レビューを始めました: ${mid}/${started.id}(Ctrl-C で取り消す)\n`);
313
+ let shown = 0;
314
+ const tick = setInterval(() => {
315
+ void svc.get(mid, started.id).then((d) => {
316
+ for (const e of d.run.log.slice(shown))
317
+ process.stderr.write(` ${e.text}\n`);
318
+ shown = Math.max(shown, d.run.log.length);
319
+ }, () => undefined);
320
+ }, 500);
321
+ const onInt = () => void svc.cancel(mid, started.id, actor).catch(() => undefined);
322
+ process.on("SIGINT", onInt);
323
+ const d = await svc.wait(mid, started.id);
324
+ clearInterval(tick);
325
+ process.removeListener("SIGINT", onInt);
326
+ for (const e of d.run.log.slice(shown))
327
+ process.stderr.write(` ${e.text}\n`);
328
+ if (d.run.status !== "completed") {
329
+ if (out.json)
330
+ out.result(d, () => "");
331
+ else
332
+ process.stderr.write(`${REVIEW_STATUS_LABELS[d.run.status]}: ${d.run.error ?? ""}\n`);
333
+ return 1;
334
+ }
335
+ return out.result(d, () => formatReview(d));
336
+ }
337
+ function verdictSummary(v) {
338
+ if (!v)
339
+ return "";
340
+ return REVIEW_VERDICTS.filter((k) => v[k]).map((k) => `${REVIEW_VERDICT_LABELS[k]} ${v[k]}`).join(" · ");
341
+ }
342
+ /** review-show の人向けの表示 */
343
+ function formatReview(d) {
344
+ const { run, input, result } = d;
345
+ const lines = [`${run.milestone}/${run.id} ${REVIEW_STATUS_LABELS[run.status]} ${run.startedAt}${run.startedBy ? ` ${run.startedBy}` : ""} (${run.engine})`];
346
+ if (run.error)
347
+ lines.push(` ${run.error}`);
348
+ if (d.owner && d.owner.state !== "local" && d.owner.state !== "alive") {
349
+ lines.push(` 実行しているプロセスを確かめられません(${"reason" in d.owner ? d.owner.reason : ""})。止まっていると確かめたら p3 milestone review-cancel ${run.milestone} ${run.id} --acknowledge-stopped`);
350
+ }
351
+ if (input) {
352
+ lines.push("", "評価したときの目的:", input.milestone.purpose ? input.milestone.purpose.split("\n").map((l) => ` ${l}`).join("\n") : " (なし)");
353
+ lines.push(`材料: 要望 ${input.requests.length} 件・文脈 ${input.context.length} 件(${input.extractedAt})`);
354
+ for (const c of input.code ?? []) {
355
+ lines.push(c.status === "ok"
356
+ ? ` 参照先 ${c.name}: ${c.head ? `${c.branch ? `${c.branch} ` : ""}${c.head.slice(0, 7)}` : "HEAD なし"}${c.dirty ? `・未コミットの変更 ${c.dirty} 件` : ""}・タスクのコミット ${c.commits.filter((x) => x.found).length} 件`
357
+ : ` 参照先 ${c.name}: 読めません(${c.reason ?? c.status})`);
358
+ for (const x of c.commits)
359
+ lines.push(` ${x.sha.slice(0, 12)} ${x.from}${x.found ? "" : " (履歴に無い)"}`);
360
+ }
361
+ for (const w of input.warnings)
362
+ lines.push(` ⚠ ${w.message}`);
363
+ }
364
+ if (result) {
365
+ const text = new Map(input?.units.map((u) => [u.id, u.text]));
366
+ lines.push("", "全体の所見:", ...result.overall.split("\n").map((l) => ` ${l}`), "");
367
+ for (const u of result.units) {
368
+ lines.push(`■ ${u.unit} ${REVIEW_VERDICT_LABELS[u.verdict]} ${(text.get(u.unit) ?? "").split("\n")[0]}`);
369
+ lines.push(` 理由: ${u.reason}`);
370
+ if (u.evidence.length)
371
+ lines.push(` 根拠: ${u.evidence.join(", ")}`);
372
+ for (const g of u.gaps)
373
+ lines.push(` 不足: ${g}`);
374
+ }
375
+ if (result.unplanned) {
376
+ lines.push("", "目的・予定機能に無い変更(意図しない変更の候補):");
377
+ if (!result.unplanned.length)
378
+ lines.push(" (見つかっていません)");
379
+ for (const u of result.unplanned)
380
+ lines.push(` - ${u.text}${u.evidence.length ? `(根拠: ${u.evidence.join(", ")})` : ""}`);
381
+ }
382
+ const q = input?.quality;
383
+ lines.push("", !q ? "品質: 評価していません(品質基準を材料に入れる前の記録です)" : q.state !== "set" ? `品質: 評価していません(品質基準が${q.state === "unset" ? "未設定" : "読めません"})` : `品質(品質基準 版 ${q.version}。目的の達成とは別):`);
384
+ for (const r of result.quality ?? []) {
385
+ lines.push(` ${r.verdict === "violated" ? "✗" : "・"} ${r.standard} ${QUALITY_VERDICT_LABELS[r.verdict]}${r.regression ? "(品質の低下)" : ""} ${r.reason}`);
386
+ if (r.evidence.length)
387
+ lines.push(` 根拠: ${r.evidence.join(", ")}`);
388
+ if (r.unread)
389
+ lines.push(` 確かめられなかった範囲: ${r.unread}`);
390
+ }
391
+ if (d.run.inputChanged)
392
+ lines.push("※ 実行中に材料が変わりました(結果は始めたときの材料に対するものです)");
393
+ lines.push("", `範囲: ${result.scope}`);
394
+ }
395
+ return lines.join("\n");
396
+ }