iterate-plugin 3.5.7 → 3.6.0

package/lib/client.js

@@ -60,6 +60,16 @@ function safeKeys(o) {
     return [];
   }
 }
+function coerceJsonNode(v) {
+  if (typeof v !== "string") return v;
+  const t = v.trim();
+  if (!t.startsWith("{") && !t.startsWith("[")) return v;
+  try {
+    return JSON.parse(t);
+  } catch {
+    return v;
+  }
+}
 function scanSessionForResume(obj, seen, maxDepth = 20) {
   if (maxDepth <= 0) return 0;
   if (!obj || typeof obj !== "object") return 0;
@@ -213,19 +223,16 @@ function scanSessionForReport(session) {
       const call = calls[i];
       if (!call) continue;
       if (safeGet(call, "tool") === "iterate_review" || String(safeGet(call, "tool") ?? "").endsWith("iterate_review")) {
-        const result = safeGet(call, "result");
+        const result = coerceJsonNode(safeGet(call, "result"));
         if (result && typeof result === "object") {
           const r = (
             /** @type {Record<string, unknown>} */
             result
           );
           const report = safeGet(r, "report");
-          if (report && typeof report === "object") {
-            return (
-              /** @type {Record<string, unknown>} */
-              report
-            );
-          }
+          if (isReviewReport(report)) return report;
+          const found = findReportInObject(result);
+          if (found) return found;
         }
       }
     }
@@ -244,8 +251,24 @@ function scanSessionForReport(session) {
         /** @type {Array<Record<string, unknown>>} */
         msgCalls
       );
-      for (const call of calls) {
+      for (let j = calls.length - 1; j >= 0; j--) {
+        const call = calls[j];
         if (!call) continue;
+        const callName = String(safeGet(call, "name") ?? safeGet(call, "tool") ?? "");
+        if (callName === "iterate_review" || callName.endsWith("iterate_review")) {
+          for (const key of ["result", "response", "message"]) {
+            const node = coerceJsonNode(safeGet(call, key));
+            if (!node || typeof node !== "object") continue;
+            const r = (
+              /** @type {Record<string, unknown>} */
+              node
+            );
+            const report = safeGet(r, "report");
+            if (isReviewReport(report)) return report;
+            const found = findReportInObject(node);
+            if (found) return found;
+          }
+        }
         const fn = safeGet(call, "function");
         if (fn && typeof fn === "object") {
           const f = (
@@ -402,10 +425,29 @@ function scanSessionForTranscript(session) {
       if (!msg) continue;
       const calls = safeGet(msg, "tool_calls");
       if (Array.isArray(calls)) {
-        for (const call of calls) {
+        const callList = (
+          /** @type {Array<Record<string, unknown>>} */
+          calls
+        );
+        for (let j = callList.length - 1; j >= 0; j--) {
+          const call = callList[j];
           if (!call) continue;
-          const args = safeGet(call, "arguments");
-          if (typeof args === "string") {
+          const fn = safeGet(call, "function");
+          const candidates = [
+            // Result surface first: `{ name|tool, result }` message tool calls
+            // (the same shape scanSessionForQualityGate already accepts).
+            safeGet(call, "result"),
+            safeGet(call, "response"),
+            safeGet(call, "message"),
+            safeGet(call, "arguments"),
+            fn && typeof fn === "object" ? safeGet(
+              /** @type {Record<string, unknown>} */
+              fn,
+              "arguments"
+            ) : void 0
+          ];
+          for (const args of candidates) {
+            if (args === void 0 || args === null) continue;
             const found2 = extractTranscript(args);
             if (found2) return found2;
           }
@@ -417,6 +459,34 @@ function scanSessionForTranscript(session) {
   }
   return null;
 }
+function normalizeValidations(raw) {
+  if (!Array.isArray(raw)) return [];
+  const out = [];
+  for (
+    const v of
+    /** @type {unknown[]} */
+    raw
+  ) {
+    if (!v || typeof v !== "object") continue;
+    const rec = (
+      /** @type {Record<string, unknown>} */
+      v
+    );
+    const roundRaw = Number(rec.round);
+    const exitRaw = rec.exitCode;
+    const command = typeof rec.command === "string" ? rec.command : String(rec.command ?? "");
+    if (!command) continue;
+    const rejectReason = typeof rec.rejectReason === "string" ? rec.rejectReason : "";
+    out.push({
+      round: Number.isFinite(roundRaw) && roundRaw > 0 ? Math.floor(roundRaw) : 0,
+      command,
+      exitCode: typeof exitRaw === "number" && Number.isFinite(exitRaw) ? exitRaw : null,
+      allowed: rec.allowed === true,
+      ...rejectReason ? { rejectReason } : {}
+    });
+  }
+  return out;
+}
 function normalizeTranscript(manifest) {
   const src = manifest && typeof manifest === "object" ? (
     /** @type {Record<string, unknown>} */
@@ -481,6 +551,9 @@ function normalizeTranscript(manifest) {
     })),
     checkpoint,
     timeline: asArray(safeGet(src, "timeline")).map((t) => ({ ...t })),
+    // #6: per-round validation rows (command / exitCode / allowed), captured
+    // by the workflow and persisted through `iterate_transcript capture`.
+    validations: normalizeValidations(safeGet(src, "validations")),
     nudge,
     approval: ap && typeof ap === "object" ? { active: asBool(safeGet(ap, "active")), policy: asStr(safeGet(ap, "policy")) || "ask" } : { active: false, policy: "ask" }
   };
@@ -515,6 +588,11 @@ function isDefenseEventsResult(obj) {
 }
 function findFirstInObject(obj, predicate, seen, maxDepth = 20) {
   if (maxDepth <= 0) return null;
+  if (typeof obj === "string") {
+    const parsed = coerceJsonNode(obj);
+    if (parsed === obj) return null;
+    return findFirstInObject(parsed, predicate, seen, maxDepth - 1);
+  }
   if (!obj || typeof obj !== "object") return null;
   const s = seen || /* @__PURE__ */ new Set();
   if (s.has(obj)) return null;
@@ -551,7 +629,7 @@ function findExperienceResultInObject(obj) {
 function findDefenseResultInObject(obj) {
   return findFirstInObject(obj, (o) => isDefenseEventsResult(o));
 }
-function latestToolResultNode(session, toolName) {
+function latestToolResultNode(session, toolName, find) {
   if (!session || typeof session !== "object") return null;
   const s = (
     /** @type {Record<string, unknown>} */
@@ -569,9 +647,9 @@ function latestToolResultNode(session, toolName) {
       const tool = String(safeGet(call, "tool") ?? "");
       if (tool !== toolName && !tool.endsWith(toolName)) continue;
       const result = safeGet(call, "result");
-      if (result !== void 0 && result !== null) return result;
+      if (result !== void 0 && result !== null && find(result)) return result;
       const message = safeGet(call, "message");
-      if (message !== void 0 && message !== null) return message;
+      if (message !== void 0 && message !== null && find(message)) return message;
     }
   }
   const messages = safeGet(s, "messages");
@@ -595,14 +673,15 @@ function latestToolResultNode(session, toolName) {
         const name2 = String(safeGet(call, "name") ?? safeGet(call, "tool") ?? "");
         if (name2 !== toolName && !name2.endsWith(toolName)) continue;
         const result = safeGet(call, "result") ?? safeGet(call, "response") ?? safeGet(call, "message");
-        if (result !== void 0 && result !== null) return result;
+        if (result !== void 0 && result !== null && find(result)) return result;
       }
     }
     for (let i = msgs.length - 1; i >= 0; i--) {
       const msg = msgs[i];
       if (!msg) continue;
       const content = safeGet(msg, "content");
-      if (content !== void 0 && content !== null) return content;
+      if (content === void 0 || content === null) continue;
+      if (find(content)) return content;
     }
   }
   return null;
@@ -651,7 +730,7 @@ function normalizeQualityGateSnapshot(raw) {
   };
 }
 function scanSessionForQualityGate(session) {
-  const node = latestToolResultNode(session, "iterate_quality_gate");
+  const node = latestToolResultNode(session, "iterate_quality_gate", findQualityGateInObject);
   if (node === null) return null;
   const found = findQualityGateInObject(node);
   if (!found) return null;
@@ -701,7 +780,7 @@ function normalizeExperienceBankResult(raw) {
   };
 }
 function scanSessionForExperienceBank(session) {
-  const node = latestToolResultNode(session, "iterate_experience");
+  const node = latestToolResultNode(session, "iterate_experience", findExperienceResultInObject);
   if (node === null) return null;
   const found = findExperienceResultInObject(node);
   if (!found) return null;
@@ -757,7 +836,7 @@ function normalizeDefenseEventsResult(raw) {
   };
 }
 function scanSessionForDefenseEvents(session) {
-  const node = latestToolResultNode(session, "iterate_defense_events");
+  const node = latestToolResultNode(session, "iterate_defense_events", findDefenseResultInObject);
   if (node === null) return null;
   const found = findDefenseResultInObject(node);
   if (!found) return null;
@@ -871,13 +950,14 @@ function normalizeReport(report) {
   );
   const rounds = (
     /** @type {Array<unknown>} */
-    report.rounds ?? []
+    Array.isArray(report.rounds) ? report.rounds : []
   );
   const findings = (
     /** @type {Array<Record<string, unknown>>} */
-    report.findings ?? []
+    Array.isArray(report.findings) ? report.findings : []
   );
   const totalRounds = typeof convergence.totalRounds === "number" ? convergence.totalRounds : rounds.length;
+  const explicitReason = typeof convergence.stoppedReason === "string" && convergence.stoppedReason.trim() ? convergence.stoppedReason : null;
   const normalizedConvergence = {
     totalRounds,
     findingsByRound: Array.isArray(convergence.findingsByRound) ? convergence.findingsByRound : rounds.map((r) => {
@@ -888,7 +968,7 @@ function normalizeReport(report) {
       return Array.isArray(rr?.findings) ? rr.findings.length : 0;
     }),
     converged: convergence.converged === true,
-    stoppedReason: convergence.stoppedReason ?? (rounds.length < totalRounds ? "converged" : "max_rounds_reached")
+    stoppedReason: explicitReason ?? (convergence.converged === true ? "converged" : rounds.length >= totalRounds ? "max_rounds_reached" : null)
   };
   let summary = report.summary;
   if (!summary || typeof summary !== "object") {
@@ -921,17 +1001,18 @@ function normalizeReport(report) {
   };
 }
 function computeSummaryFromFindings(findings) {
+  const list = Array.isArray(findings) ? findings : [];
   const counts = { critical: 0, high: 0, medium: 0, low: 0 };
-  const byDimension = {};
-  for (const f of findings) {
+  const byDimension = /* @__PURE__ */ Object.create(null);
+  for (const f of list) {
     if (!f || typeof f !== "object") continue;
     const sev = String(f.severity ?? "low");
-    if (sev in counts) counts[sev]++;
+    if (Object.prototype.hasOwnProperty.call(counts, sev)) counts[sev]++;
     const dim = String(f.dimension ?? "unknown");
     byDimension[dim] = (byDimension[dim] ?? 0) + 1;
   }
   return {
-    totalFindings: findings.length,
+    totalFindings: list.length,
     critical: counts.critical,
     high: counts.high,
     medium: counts.medium,
@@ -952,7 +1033,7 @@ function computeConvergenceProgress(report) {
 function currentRoundNumber(report) {
   const rounds = (
     /** @type {Array<Record<string, unknown>>} */
-    report.rounds ?? []
+    Array.isArray(report.rounds) ? report.rounds : []
   );
   let max = 0;
   for (const r of rounds) {
@@ -975,34 +1056,38 @@ function getTotalRounds(report) {
 function severityStats(report) {
   const findings = (
     /** @type {Array<Record<string, unknown>>} */
-    report.findings ?? []
+    Array.isArray(report.findings) ? report.findings : []
   );
   const counts = { critical: 0, high: 0, medium: 0, low: 0 };
   for (const f of findings) {
     if (!f || typeof f !== "object") continue;
     const sev = String(f.severity ?? "low");
-    if (sev in counts) counts[sev]++;
+    if (Object.prototype.hasOwnProperty.call(counts, sev)) counts[sev]++;
   }
   return counts;
 }
 function groupByDimension(report) {
   const findings = (
     /** @type {Array<Record<string, unknown>>} */
-    report.findings ?? []
+    Array.isArray(report.findings) ? report.findings : []
   );
-  const groups = {};
+  const groups = /* @__PURE__ */ Object.create(null);
   for (const f of findings) {
     if (!f || typeof f !== "object") continue;
     const dim = String(f.dimension ?? "unknown");
-    if (!groups[dim]) groups[dim] = [];
+    if (!Object.prototype.hasOwnProperty.call(groups, dim)) groups[dim] = [];
     groups[dim].push(f);
   }
   return groups;
 }
+var TRIAGE_VERDICTS = (
+  /** @type {const} */
+  ["keep", "skip", "ignore"]
+);
 function buildTriageState(report) {
   const findings = (
     /** @type {Array<unknown>} */
-    report.findings ?? []
+    Array.isArray(report.findings) ? report.findings : []
   );
   const state = {};
   for (let i = 0; i < findings.length; i++) {
@@ -1013,7 +1098,7 @@ function buildTriageState(report) {
 function hashReport(report) {
   const findings = (
     /** @type {Array<Record<string, unknown>>} */
-    report.findings ?? []
+    Array.isArray(report.findings) ? report.findings : []
   );
   let h = 2166136261;
   const mix = (s) => {
@@ -1058,17 +1143,27 @@ function buildApplyInstruction(entries) {
     null,
     2
   );
-  return `Please call \`iterate_triage\` with the following payload to apply the triage verdicts:
+  return `\u8BF7\u8C03\u7528 \`iterate_triage\` \u5E94\u7528\u4E0B\u9762\u7684 known_intentional \u6761\u76EE\uFF08\u7C98\u8D34\u540E\u7531\u6A21\u578B\u8C03\u7528 \`iterate_triage\` \u7684 \`operation: "apply"\` \u5199\u5165\u914D\u7F6E\uFF1A\u81EA\u52A8\u53BB\u91CD\u3001\u5199\u5165\u524D\u5907\u4EFD\u3001\u5931\u8D25\u81EA\u52A8\u56DE\u6EDA\uFF09\uFF1A
 
 \`\`\`json
 ${payload}
+\`\`\`
+
+\u5199\u5165\u5B8C\u6210\u540E\u8BF7\u590D\u5236\u9762\u677F\u7684\u300C\u56DE\u8BFB\u5DF2\u5199\u5165\u6761\u76EE\u300D\u6307\u4EE4\uFF08\`iterate_triage\` \`operation: "list"\`\uFF09\u6838\u5BF9\u7ED3\u679C\u3002`;
+}
+function buildTriageReadbackInstruction() {
+  return `\u8BF7\u8C03\u7528 \`iterate_triage\` \u56DE\u8BFB\u5F53\u524D\u5DF2\u5199\u5165\u914D\u7F6E\u7684 known_intentional \u6761\u76EE\uFF0C\u5E76\u628A\u6BCF\u6761\u7684 file / line / dimension / reason \u539F\u6837\u5217\u51FA\u6765\u4F9B\u6211\u6838\u5BF9\uFF1A
+
+\`\`\`json
+${JSON.stringify({ operation: "list" }, null, 2)}
 \`\`\``;
 }
 function collectIgnoredEntries(triageState, findings) {
+  const list = Array.isArray(findings) ? findings : [];
   const entries = [];
   for (const [idx, verdict] of Object.entries(triageState)) {
     if (verdict !== "ignore") continue;
-    const finding = findings[Number(idx)];
+    const finding = list[Number(idx)];
     if (!finding) continue;
     entries.push({
       file: String(finding.file ?? ""),
@@ -1079,6 +1174,204 @@ function collectIgnoredEntries(triageState, findings) {
   }
   return entries;
 }
+var CONTENT_PLACEHOLDER = "<\u7531\u6A21\u578B\u586B\u5199\uFF1A\u4FEE\u590D\u540E\u7684\u5B8C\u6574\u6587\u4EF6\u5185\u5BB9>";
+var ROUND_PLACEHOLDER = "<\u7531\u6A21\u578B\u586B\u5199\uFF1A\u5F53\u524D\u8FED\u4EE3\u8F6E\u6B21\uFF08\u22651 \u7684\u6574\u6570\uFF09>";
+var START_INSTRUCTION_FULL = '\u5F00\u59CB\u4E00\u6B21\u5B8C\u6574\u8FED\u4EE3\uFF08\u5BA1\u67E5 \u2192 \u4FEE\u590D \u2192 \u9A8C\u8BC1 \u2192 \u590D\u76D8\uFF09\uFF1A\u8BF7\u8C03\u7528 `workflow` \u5DE5\u5177\u8FD0\u884C iterate \u5DE5\u4F5C\u6D41\uFF0Cmode: "normal"\uFF0C\u6309\u7CFB\u7EDF\u63D0\u793A\u7684 Iterate Workflow \u6267\u884C plan \u2192 \u591A\u7EBF\u7A0B\u5E76\u884C\u8BC4\u5BA1 \u2192 \u5206\u8BCA \u2192 \u539F\u5B50\u4FEE\u590D \u2192 \u6BCF\u8F6E\u9A8C\u8BC1 \u2192 \u5FAA\u73AF\u76F4\u81F3\u6536\u655B\u6216\u8FBE\u5230 max_rounds \u2192 \u7EC8\u62A5\u5E76 `iterate_transcript` capture\u3002\u5F00\u8DD1\u524D\u5148 `iterate_config({operation:"read"})` \u68C0\u67E5 validation.commands\uFF1A\u82E5\u4E3A\u7A7A\uFF0C\u5148\u505C\u4E0B\u6765\u63D0\u793A\u6211\u7528 `iterate_config` \u5199\u5165\u9A8C\u8BC1\u547D\u4EE4\uFF0C\u5426\u5219\u672C\u8F6E\u8FED\u4EE3\u4E0D\u53D7\u4EFB\u4F55\u6D4B\u8BD5\u4FDD\u62A4\u3002';
+var START_INSTRUCTION_REVIEW_ONLY = '\u5F00\u59CB\u4E00\u6B21\u4EC5\u8BC4\u5BA1\uFF08dry-run\uFF0C\u4E0D\u4FEE\u6539\u4EFB\u4F55\u6587\u4EF6\uFF09\uFF1A\u8BF7\u8C03\u7528 `workflow` \u5DE5\u5177\u8FD0\u884C iterate \u5DE5\u4F5C\u6D41\uFF0Cmode: "dry-run"\uFF0C\u6309\u7CFB\u7EDF\u63D0\u793A\u7684 Iterate Workflow \u6267\u884C plan \u2192 \u591A\u7EBF\u7A0B\u5E76\u884C\u8BC4\u5BA1 \u2192 \u5206\u8BCA \u2192 `iterate_review aggregate` / `meta-review` \u7EC8\u62A5\u5E76 `iterate_transcript` capture\uFF1B\u5168\u7A0B\u4E0D\u8981\u8C03\u7528 `iterate_fix` / `iterate_rollback`\u3002';
+var START_INSTRUCTIONS = {
+  full: START_INSTRUCTION_FULL,
+  reviewOnly: START_INSTRUCTION_REVIEW_ONLY
+};
+function fixFindingPayload(finding) {
+  const f = finding && typeof finding === "object" ? finding : {};
+  const file = String(f.file ?? "");
+  return {
+    file,
+    ...typeof f.line === "number" && f.line > 0 ? { line: f.line } : {},
+    dimension: String(f.dimension ?? ""),
+    severity: String(f.severity ?? ""),
+    summary: String(f.summary ?? ""),
+    ...f.failure_scenario ? { failure_scenario: String(f.failure_scenario) } : {},
+    ...f.suggested_fix ? { suggested_fix: String(f.suggested_fix) } : {}
+  };
+}
+function buildFixInstruction(finding, opts) {
+  const payload = fixFindingPayload(finding);
+  if (!payload.file) return "";
+  const round = opts && Number.isInteger(opts.round) ? opts.round : null;
+  const call = {
+    file: payload.file,
+    content: CONTENT_PLACEHOLDER,
+    finding: payload,
+    round: round !== null ? round : ROUND_PLACEHOLDER
+  };
+  return [
+    "\u8BF7\u4FEE\u590D\u4E0B\u9762\u8FD9\u4E00\u4E2A finding\u3002`iterate_fix` \u4E00\u6B21\u53EA\u63A5\u53D7\u4E00\u4E2A finding\uFF0C\u4E14 file / content / finding / round \u56DB\u4E2A\u53C2\u6570\u5168\u90E8\u5FC5\u586B\uFF1A",
+    `\u6B65\u9AA4 1\uFF1A\u8BFB\u53D6 \`${payload.file}\`\uFF0C\u6309 finding \u751F\u6210\u4FEE\u590D\u540E\u7684\u3010\u5B8C\u6574\u6587\u4EF6\u5185\u5BB9\u3011\uFF08content \u5360\u4F4D\u5FC5\u987B\u6362\u6210\u771F\u5B9E\u6587\u4EF6\u5185\u5BB9\uFF09\u3002`,
+    `\u6B65\u9AA4 2\uFF1A\u8C03\u7528 \`iterate_fix\`\uFF0C\u628A content \u4E0E round \u586B\u6210\u771F\u5B9E\u503C${round !== null ? `\uFF08\u672C\u8F6E round = ${round}\uFF09` : ""}\uFF1A`,
+    "```json",
+    JSON.stringify(call, null, 2),
+    "```",
+    '\u9700\u8981\u8D85\u8FC7 atomic \u884C\u6570\u4E0A\u9650\u65F6\uFF0C\u53E6\u52A0 "force": true\u3002'
+  ].join("\n");
+}
+function buildAssignFixesInstruction(findings) {
+  const list = (Array.isArray(findings) ? findings : []).filter((f) => f && typeof f === "object");
+  if (list.length === 0) return "";
+  const payload = list.map((f) => fixFindingPayload(f)).filter((p) => p.file);
+  if (payload.length === 0) return "";
+  return [
+    `\u8BF7\u4FEE\u590D\u4E0B\u9762\u8FD9 ${payload.length} \u4E2A findings\u3002\u6CE8\u610F\uFF1A\`iterate_fix\` \u6BCF\u6B21\u53EA\u5904\u7406\u3010\u4E00\u4E2A\u3011finding\uFF08\u6CA1\u6709\u6570\u7EC4\u5165\u53C2\uFF09\uFF0C\u8BF7\u9010\u4E2A\u8C03\u7528 iterate_fix\u2014\u2014\u4E00\u6B21\u4E00\u4E2A finding\uFF0C\u5904\u7406\u5B8C\u4E00\u4E2A\u518D\u53D1\u8D77\u4E0B\u4E00\u4E2A\uFF0C\u7EDD\u4E0D\u8981\u628A\u6574\u6279\u6570\u7EC4\u5F53\u4F5C\u53C2\u6570\u4F20\u5165\u3002`,
+    "\u6BCF\u4E2A finding \u90FD\u8D70\u540C\u6837\u7684\u4E24\u6B65\uFF1A\u2460 \u8BFB\u53D6\u6587\u4EF6\u751F\u6210\u4FEE\u590D\u540E\u7684\u5B8C\u6574 content\uFF1B\u2461 \u8C03\u7528 iterate_fix\uFF08file / content / finding / round \u5FC5\u586B\uFF0Ccontent \u4E0E round \u7531\u4F60\u586B\u5199\uFF09\u3002",
+    "\u5F85\u4FEE\u590D\u6E05\u5355\uFF1A",
+    "```json",
+    JSON.stringify(payload, null, 2),
+    "```"
+  ].join("\n");
+}
+function buildArchitecturalFixInstruction(findings) {
+  const list = (Array.isArray(findings) ? findings : []).filter((f) => f && typeof f === "object");
+  const lines = [
+    '\u8BF7\u6279\u51C6\u5E76\u6267\u884C\u67B6\u6784\u578B\u4FEE\u590D\uFF08\u5141\u8BB8\u8D85\u8FC7 atomic \u884C\u6570\u4E0A\u9650\uFF09\uFF1A\u5BF9\u6BCF\u4E2A\u67B6\u6784\u578B finding \u9010\u4E2A\u8C03\u7528 `iterate_fix`\uFF0C\u4E00\u6B21\u4E00\u4E2A finding\uFF0C\u5E76\u663E\u5F0F\u8BBE\u7F6E `"force": true`\uFF1B',
+    "file / content / finding / round \u56DB\u4E2A\u5FC5\u586B\u53C2\u6570\u4E00\u4E2A\u90FD\u4E0D\u80FD\u5C11\uFF08content = \u4FEE\u590D\u540E\u7684\u5B8C\u6574\u6587\u4EF6\u5185\u5BB9\uFF0Cround = \u5F53\u524D\u8FED\u4EE3\u8F6E\u6B21\uFF0C\u4E24\u8005\u7531\u4F60\u586B\u5199\uFF09\u3002"
+  ];
+  if (list.length > 0) {
+    lines.push("\u672C\u9879\u76EE\u5269\u4F59\u67B6\u6784\u578B finding\uFF1A", "```json", JSON.stringify(list.map((f) => fixFindingPayload(f)), null, 2), "```");
+  }
+  return lines.join("\n");
+}
+function buildCheckpointResumeInstruction() {
+  return `\u8BF7\u8C03\u7528 \`iterate_checkpoint\` \u4ECE\u65AD\u70B9\u6062\u590D\u8FED\u4EE3\uFF08\u52A0\u8F7D\u65AD\u70B9\u5E76\u628A resumeCount +1\uFF09\uFF1A
+
+\`\`\`json
+${JSON.stringify({ operation: "resume" }, null, 2)}
+\`\`\``;
+}
+function buildCheckpointClearInstruction() {
+  return `\u8BF7\u8C03\u7528 \`iterate_checkpoint\` \u6E05\u9664\u5F53\u524D\u65AD\u70B9\uFF1A
+
+\`\`\`json
+${JSON.stringify({ operation: "clear" }, null, 2)}
+\`\`\``;
+}
+function buildQualityGateQueryInstruction() {
+  return `\u8BF7\u8C03\u7528 \`iterate_quality_gate\` \u67E5\u8BE2\u5F53\u524D\u8D28\u91CF\u95E8\u7981\u72B6\u6001\uFF08\u8BFB\u53D6\u78C1\u76D8\u4E0A\u6301\u4E45\u5316\u7684\u8BC1\u4E66\uFF09\uFF1A
+
+\`\`\`json
+${JSON.stringify({ operation: "read" }, null, 2)}
+\`\`\``;
+}
+function buildQualityGateClearInstruction() {
+  return `\u8BF7\u8C03\u7528 \`iterate_quality_gate\` \u6E05\u9664\u5F53\u524D\u8D28\u91CF\u95E8\u7981\u8BC1\u4E66\uFF1A
+
+\`\`\`json
+${JSON.stringify({ operation: "clear" }, null, 2)}
+\`\`\``;
+}
+function buildRollbackInstruction(id) {
+  return `\u8BF7\u8C03\u7528 \`iterate_rollback\` \u56DE\u6EDA\u4EE5\u4E0B\u4FEE\u590D\uFF1A
+
+\`\`\`json
+${JSON.stringify({ id: String(id || "") }, null, 2)}
+\`\`\``;
+}
+function buildExperienceListInstruction() {
+  return `\u8BF7\u8C03\u7528 \`iterate_experience\` \u5217\u51FA\u7ECF\u9A8C\u94F6\u884C\u4E2D\u7684\u6240\u6709\u7ECF\u9A8C\uFF0C\u5E76\u628A\u5B8C\u6574\u8FD4\u56DE\u7ED3\u679C\u56DE\u663E\u5230\u4F1A\u8BDD\u91CC\uFF1A
+
+\`\`\`json
+${JSON.stringify({ operation: "list" }, null, 2)}
+\`\`\``;
+}
+function buildDefenseEventsListInstruction() {
+  return `\u8BF7\u8C03\u7528 \`iterate_defense_events\` \u5217\u51FA\u5168\u90E8\u9632\u5FA1\u4E8B\u4EF6\uFF0C\u5E76\u628A\u5B8C\u6574\u8FD4\u56DE\u7ED3\u679C\u56DE\u663E\u5230\u4F1A\u8BDD\u91CC\uFF1A
+
+\`\`\`json
+${JSON.stringify({ operation: "list" }, null, 2)}
+\`\`\``;
+}
+function buildDiskSnapshotInstruction() {
+  const lines = [
+    "\u8BF7\u4ECE\u78C1\u76D8\u62C9\u53D6 iterate \u5FEB\u7167\uFF1A\u9010\u4E2A\u8C03\u7528\u4E0B\u9762\u7684\u53EA\u8BFB\u5DE5\u5177\uFF0C\u5E76\u628A\u6BCF\u4E2A\u5DE5\u5177\u7684\u3010\u5B8C\u6574\u8FD4\u56DE\u7ED3\u679C\u3011\u539F\u6837\u56DE\u663E\u5230\u4F1A\u8BDD\u91CC\uFF08\u4E0D\u8981\u53EA\u7ED9\u6458\u8981\u2014\u2014\u63D2\u4EF6\u9762\u677F\u9760\u8FD9\u4E9B\u56DE\u663E\u586B\u5145\uFF09\uFF1A"
+  ];
+  DISK_SNAPSHOT_SOURCES.forEach((s, i) => {
+    lines.push(`${i + 1}. \`${s.tool}\`\uFF08${s.label}\uFF09\uFF1A${JSON.stringify(s.args)}`);
+  });
+  lines.push("\u56DE\u663E\u540E\uFF0C\u89C2\u6D4B\u53F0\u5B9E\u65F6\u6D41 / F2 \u8DE8\u8F6E\u5BF9\u6BD4 / F5 \u65AD\u70B9 / F8 \u8D28\u91CF\u95E8\u7981 / F9 \u7ECF\u9A8C\u94F6\u884C / F10 \u9632\u5FA1\u4E8B\u4EF6\u4F1A\u81EA\u52A8\u8BFB\u53D6\u8FD9\u4E9B\u7ED3\u679C\u3002");
+  return lines.join("\n");
+}
+var DISK_SNAPSHOT_SOURCES = [
+  { tool: "iterate_status", args: {}, label: "\u8FD0\u884C\u72B6\u6001\u6C47\u603B" },
+  { tool: "iterate_transcript", args: { operation: "read" }, label: "transcript \u89C2\u6D4B\u6E05\u5355" },
+  { tool: "iterate_quality_gate", args: { operation: "read" }, label: "\u8D28\u91CF\u95E8\u7981\u8BC1\u4E66" },
+  { tool: "iterate_experience", args: { operation: "list" }, label: "\u7ECF\u9A8C\u94F6\u884C" },
+  { tool: "iterate_defense_events", args: { operation: "list" }, label: "\u9632\u5FA1\u4E8B\u4EF6\u6D41" },
+  { tool: "iterate_history", args: {}, label: "\u51B3\u7B56\u65E5\u5FD7\u4E0E\u4FEE\u590D\u6CE8\u518C\u8868\uFF08\u8DE8\u8F6E/\u8DE8\u4F1A\u8BDD\u5BF9\u6BD4\uFF09" }
+];
+function toolCalledInSession(session, toolName) {
+  if (!session || typeof session !== "object" || typeof toolName !== "string" || !toolName) return false;
+  const s = (
+    /** @type {Record<string, unknown>} */
+    session
+  );
+  const toolCalls = safeGet(s, "toolCalls");
+  if (Array.isArray(toolCalls)) {
+    for (
+      const call of
+      /** @type {unknown[]} */
+      toolCalls
+    ) {
+      if (!call || typeof call !== "object") continue;
+      const t = String(safeGet(
+        /** @type {Record<string, unknown>} */
+        call,
+        "tool"
+      ) ?? "");
+      if (t === toolName || t.endsWith(toolName)) return true;
+    }
+  }
+  const messages = safeGet(s, "messages");
+  if (Array.isArray(messages)) {
+    for (
+      const msg of
+      /** @type {unknown[]} */
+      messages
+    ) {
+      if (!msg || typeof msg !== "object") continue;
+      const calls = safeGet(
+        /** @type {Record<string, unknown>} */
+        msg,
+        "tool_calls"
+      );
+      if (!Array.isArray(calls)) continue;
+      for (
+        const call of
+        /** @type {unknown[]} */
+        calls
+      ) {
+        if (!call || typeof call !== "object") continue;
+        const c = (
+          /** @type {Record<string, unknown>} */
+          call
+        );
+        const name2 = String(safeGet(c, "name") ?? safeGet(c, "tool") ?? "");
+        if (name2 === toolName || name2.endsWith(toolName)) return true;
+        const fn = safeGet(c, "function");
+        if (fn && typeof fn === "object" && String(safeGet(
+          /** @type {Record<string, unknown>} */
+          fn,
+          "name"
+        ) ?? "") === toolName) {
+          return true;
+        }
+      }
+    }
+  }
+  return false;
+}
+function diskEmptyStateText(pulled, topic) {
+  const subject = topic || "\u6570\u636E";
+  return pulled ? `\u5DF2\u4ECE\u78C1\u76D8\u62C9\u53D6\uFF1A${subject}\u6682\u65E0\u8BB0\u5F55\uFF08\u78C1\u76D8\u65E0\u6570\u636E\uFF09\u3002` : `\u5C1A\u672A\u4ECE\u78C1\u76D8\u62C9\u53D6${subject}\uFF1A\u6570\u636E\u5B58\u653E\u5728\u9879\u76EE .iterate/ \u4E0B\uFF0C\u70B9\u300C\u62C9\u53D6\u78C1\u76D8\u5FEB\u7167\u300D\u590D\u5236\u6307\u4EE4\u53D1\u56DE\u4F1A\u8BDD\u5373\u53EF\u56DE\u586B\u3002`;
+}
 function normalizeFindingFilter(filter) {
   const f = filter && typeof filter === "object" ? filter : {};
   const severities = Array.isArray(f.severities) ? f.severities.filter((s) => SEVERITY_ORDER.includes(String(s))) : [];
@@ -1122,6 +1415,7 @@ function buildFilterOptions(findings) {
   const severities = SEVERITY_ORDER.map((value) => ({ value, count: 0 }));
   const dimCounts = {};
   for (const f of list) {
+    if (!f || typeof f !== "object") continue;
     const sev = String(f.severity ?? "low");
     const sv = severities.find((s) => s.value === sev);
     if (sv) sv.count++;
@@ -1141,7 +1435,7 @@ function countVerdicts(triageState) {
   return counts;
 }
 function batchSetVerdict(triageState, indices, verdict) {
-  if (verdict !== "keep" && verdict !== "skip" && verdict !== "ignore") return triageState;
+  if (!TRIAGE_VERDICTS.includes(verdict)) return triageState;
   if (!Array.isArray(indices) || indices.length === 0) return triageState;
   const next = { ...triageState };
   for (const idx of indices) {
@@ -1250,6 +1544,21 @@ var CONFIG_EDIT_FIELDS = [
   { key: "max_rounds", label: "\u6700\u5927\u8F6E\u6570", hint: "\u6B63\u6574\u6570" },
   { key: "review.scope", label: "\u5BA1\u67E5\u8303\u56F4", hint: '"full" \u6216 "changed-only"' },
   { key: "reasoning_effort", label: "\u5BA1\u67E5\u63A8\u7406\u5F3A\u5EA6", hint: '"low" / "medium" / "high"\uFF0C\u7F3A\u7701\u8DDF\u968F\u6A21\u578B\u9ED8\u8BA4' },
+  {
+    key: "validation.commands",
+    label: "\u9A8C\u8BC1\u547D\u4EE4",
+    hint: '\u6570\u7EC4\uFF0C\u6BCF\u9879\u662F\u4E00\u6761\u767D\u540D\u5355\u547D\u4EE4\u5B57\u7B26\u4E32\uFF0C\u5982 ["npm test","npm run lint"]\uFF1B\u6BCF\u8F6E\u9A8C\u8BC1\u9010\u6761\u6267\u884C\u3002\u7559\u7A7A\u6570\u7EC4 = \u4E0D\u9A8C\u8BC1\uFF08\u672C\u8F6E\u8FED\u4EE3\u4E0D\u53D7\u4EFB\u4F55\u6D4B\u8BD5\u4FDD\u62A4\uFF09'
+  },
+  {
+    key: "language",
+    label: "\u754C\u9762\u8BED\u8A00",
+    hint: '"zh" \u6216 "en"\uFF08\u9ED8\u8BA4 "en"\uFF09\uFF1A\u63A7\u5236\u5BA1\u6279\u7406\u7531\u3001\u9632\u5FA1\u4E8B\u4EF6\u6807\u7B7E\u7B49\u9762\u5411\u4EBA\u6587\u6848\u7684\u8BED\u8A00'
+  },
+  {
+    key: "personalization.known_intentional",
+    label: "\u5DF2\u77E5\u6709\u610F\u95EE\u9898",
+    hint: "\u6570\u7EC4\uFF0C\u6BCF\u9879 {file, line?, dimension, reason}\uFF1B\u547D\u4E2D\u6761\u76EE\u5728\u8BC4\u5BA1\u4E2D\u88AB\u8DF3\u8FC7\u3002\u53EF\u7528\u5206\u8BCA\u9762\u677F\u7684\u300C\u56DE\u8BFB\u5DF2\u5199\u5165\u6761\u76EE\u300D\u6838\u5BF9"
+  },
   { key: "atomic.max_lines", label: "\u539F\u5B50\u4FEE\u590D\u4E0A\u9650\u884C\u6570", hint: "\u6B63\u6574\u6570" },
   { key: "git.push_per_round", label: "\u6BCF\u8F6E\u63A8\u9001", hint: "true / false" }
 ];
@@ -1259,16 +1568,50 @@ function buildConfigEditGuide() {
     "---------------------",
     "\u914D\u7F6E\u6587\u4EF6\uFF1A\u9879\u76EE\u6839\u76EE\u5F55 iterate.config.yaml\u3002",
     "",
+    "\u26A0 \u672A\u914D\u7F6E validation.commands \u65F6\u8FED\u4EE3\u4E0D\u88AB\u4FDD\u62A4\uFF1A\u6BCF\u8F6E validate \u62FF\u5230\u7A7A\u7ED3\u679C\u4F1A\u88AB\u5F53\u4F5C",
+    "  \u201C\u9A8C\u8BC1\u901A\u8FC7\u201D\uFF0C\u7B49\u4E8E\u5728\u6CA1\u6709\u4EFB\u4F55\u6D4B\u8BD5\u4FDD\u62A4\u7684\u60C5\u51B5\u4E0B\u7EE7\u7EED\u6536\u655B\u3002\u7B2C\u4E00\u6B21\u542F\u52A8\u8FED\u4EE3\u524D\uFF0C",
+    "  \u8BF7\u5148\u7ED9 validation.commands \u914D\u4E0A\u81F3\u5C11\u4E00\u6761\u771F\u5B9E\u547D\u4EE4\uFF08\u5982 npm test\uFF09\u3002",
+    "",
     "\u53EF\u7F16\u8F91\u5B57\u6BB5\uFF1A",
     ...CONFIG_EDIT_FIELDS.map((f) => `- ${f.key}\uFF08${f.label}\uFF09\uFF1A${f.hint}`),
     "",
     "\u8BA9\u6A21\u578B\u5E2E\u4F60\u6539\uFF1A",
     '1. \u8C03\u7528 iterate_config({ operation: "read" }) \u67E5\u770B\u5F53\u524D\u914D\u7F6E\uFF1B',
-    "2. \u8BF4\u660E\u60F3\u6539\u7684\u5B57\u6BB5\uFF0C\u4F8B\u5982\u300C\u628A max_rounds \u6539\u6210 5\uFF0Cdimensions \u53EA\u4FDD\u7559 correctness \u548C security\u300D\uFF1B",
-    '3. \u6A21\u578B\u4F1A\u8C03\u7528 iterate_config({ operation: "write", updates: {...} }) \u5199\u5165\uFF0C\u5199\u5165\u524D\u81EA\u52A8\u5907\u4EFD\uFF0C\u5931\u8D25\u81EA\u52A8\u56DE\u6EDA\u3002'
+    "2. \u8BF4\u660E\u60F3\u6539\u7684\u5B57\u6BB5\uFF0C\u4F8B\u5982\u300C\u628A max_rounds \u6539\u6210 5\uFF0Cvalidation.commands \u52A0\u4E0A npm test\u300D\uFF1B",
+    '3. \u6A21\u578B\u4F1A\u8C03\u7528 iterate_config({ operation: "write", updates: {...} }) \u5199\u5165\uFF0C\u5199\u5165\u524D\u81EA\u52A8\u5907\u4EFD\uFF0C\u5931\u8D25\u81EA\u52A8\u56DE\u6EDA\u3002',
+    "",
+    "\u4E5F\u53EF\u4EE5\u7528\u8BBE\u7F6E\u9875\u7684\u201C\u9009\u5B57\u6BB5 \u2192 \u751F\u6210\u5199\u5165\u6307\u4EE4\u201D\u76F4\u63A5\u590D\u5236\u7B2C 3 \u6B65\u7684\u6307\u4EE4\u7C98\u8D34\u7ED9\u6A21\u578B\u3002"
   ];
   return lines.join("\n");
 }
+function buildConfigEditInstruction(desiredChanges) {
+  const payload = JSON.stringify({ operation: "write", updates: desiredChanges }, null, 2);
+  return `\u8BF7\u8C03\u7528 \`iterate_config\` \u5199\u5165\u4EE5\u4E0B\u914D\u7F6E\u66F4\u65B0\uFF1A
+
+\`\`\`json
+${payload}
+\`\`\``;
+}
+var CONFIG_VALUE_PLACEHOLDER = "<\u7531\u6A21\u578B\u586B\u5199\uFF1A\u8BE5\u5B57\u6BB5\u7684\u65B0\u503C>";
+function configFieldByKey(key) {
+  if (typeof key !== "string" || !key) return null;
+  return CONFIG_EDIT_FIELDS.find((f) => f.key === key) ?? null;
+}
+function buildConfigFieldInstruction(key, value) {
+  const field = configFieldByKey(key);
+  const label = field ? field.label : key;
+  const hint = field ? field.hint : "\u89C1 iterate.config.yaml";
+  const updates = { [key]: value === void 0 ? CONFIG_VALUE_PLACEHOLDER : value };
+  const payload = buildConfigEditInstruction(updates);
+  return [
+    `\u914D\u7F6E\u5B57\u6BB5 \xB7 ${label}\uFF08${key}\uFF09`,
+    `\u5B57\u6BB5\u8BF4\u660E\uFF1A${hint}`,
+    "",
+    payload,
+    "",
+    '\u5199\u5165\u524D\u8BF7\u5148 `operation: "read"` \u5C55\u793A\u5F53\u524D\u503C\uFF1B\u5199\u5165\u7531\u5DE5\u5177\u81EA\u52A8\u5907\u4EFD\uFF0C\u5931\u8D25\u81EA\u52A8\u56DE\u6EDA\u3002'
+  ].join("\n");
+}
 var VERDICT_SHORTCUTS = {
   y: "keep",
   Y: "keep",
@@ -1278,7 +1621,8 @@ var VERDICT_SHORTCUTS = {
   A: "ignore"
 };
 function keyToVerdict(key) {
-  return VERDICT_SHORTCUTS[key] ?? null;
+  const verdict = VERDICT_SHORTCUTS[key];
+  return verdict !== void 0 && TRIAGE_VERDICTS.includes(verdict) ? verdict : null;
 }
 function allVerdictKeys(triageState) {
   const state = triageState && typeof triageState === "object" ? triageState : {};
@@ -1352,11 +1696,12 @@ function filterTimelineEntries(entries, opts) {
   });
   return filtered.slice().sort((a, b) => String(b.timestamp ?? "").localeCompare(String(a.timestamp ?? "")));
 }
-function serializeObservatoryExport(manifest, live) {
+function serializeObservatoryExport(manifest, live, extra) {
   const payload = {
     exportedAt: (/* @__PURE__ */ new Date()).toISOString(),
     manifest: manifest && typeof manifest === "object" ? manifest : null,
-    live: Array.isArray(live) ? live : []
+    live: Array.isArray(live) ? live : [],
+    ...pickExportExtras(extra)
   };
   try {
     return JSON.stringify(payload, null, 2);
@@ -1364,6 +1709,62 @@ function serializeObservatoryExport(manifest, live) {
     return JSON.stringify({ exportedAt: payload.exportedAt, manifest: null, live: [] }, null, 2);
   }
 }
+var EXPORT_EXTRA_KEYS = ["qualityGate", "experienceBank", "defenseEvents", "report"];
+function pickExportExtras(extra) {
+  const out = {};
+  if (!extra || typeof extra !== "object") return out;
+  for (const key of EXPORT_EXTRA_KEYS) {
+    if (!Object.prototype.hasOwnProperty.call(extra, key)) continue;
+    const value = extra[key];
+    if (value === void 0) continue;
+    out[key] = value;
+  }
+  return out;
+}
+function buildRoundComparison(report, validations) {
+  const rounds = /* @__PURE__ */ new Map();
+  const rowsFor = (round) => {
+    const n = Number(round);
+    const key = Number.isFinite(n) && n > 0 ? Math.floor(n) : 0;
+    if (!rounds.has(key)) {
+      rounds.set(key, { round: key, findings: 0, fixed: 0, severities: /* @__PURE__ */ Object.create(null), validations: [] });
+    }
+    return rounds.get(key);
+  };
+  const list = report && Array.isArray(report.findings) ? report.findings : [];
+  for (const f of list) {
+    if (!f || typeof f !== "object") continue;
+    const row = rowsFor(f.round);
+    row.findings += 1;
+    const sev = typeof f.severity === "string" && f.severity ? f.severity : "unknown";
+    row.severities[sev] = (row.severities[sev] || 0) + 1;
+    if (f.status === "fixed") row.fixed += 1;
+  }
+  const vals = Array.isArray(validations) ? validations : [];
+  for (const v of vals) {
+    if (!v || typeof v !== "object") continue;
+    const row = rowsFor(v.round);
+    row.validations.push({
+      command: typeof v.command === "string" ? v.command : "",
+      exitCode: typeof v.exitCode === "number" ? v.exitCode : null,
+      allowed: v.allowed === true
+    });
+  }
+  return [...rounds.values()].filter((r) => r.round > 0).sort((a, b) => a.round - b.round).map((r) => ({ ...r, severities: { ...r.severities } }));
+}
+function dashboardRunState(transcript) {
+  const t = transcript && typeof transcript === "object" ? transcript : null;
+  if (!t) return { state: "empty", round: 0, phase: "", stoppedReason: "" };
+  const rawRound = Number(t.round);
+  const round = Number.isFinite(rawRound) && rawRound > 0 ? Math.floor(rawRound) : 1;
+  const stoppedReason = typeof t.stoppedReason === "string" ? t.stoppedReason.trim() : "";
+  return {
+    state: t.active === true ? "running" : "done",
+    round,
+    phase: latestPhase(t.phases),
+    stoppedReason
+  };
+}
 function latestPhase(phases) {
   const list = Array.isArray(phases) ? phases : [];
   let latest = "";
@@ -1453,6 +1854,7 @@ var ITERATE_CSS = `
 }
 .iterate-btn[data-primary] { border-color: var(--dsw-alias-brand-primary); color: var(--dsw-alias-brand-primary); }
 .iterate-btn[data-copied] { border-color: var(--dsw-alias-state-success-primary); color: var(--dsw-alias-state-success-primary); }
+.iterate-btn[data-failed], .iterate-cmd[data-failed] { border-color: var(--dsw-alias-state-error-primary); color: var(--dsw-alias-state-error-primary); }
 .iterate-payload { width: 100%; margin-top: 8px; padding: 8px; border: 1px solid var(--dsw-alias-border-l1); border-radius: 8px; background: var(--dsw-alias-bg-layer-2); color: var(--dsw-alias-label-primary); font-family: var(--dsw-font-mono, ui-monospace, monospace); font-size: 11px; white-space: pre-wrap; }
 
 .iterate-stats { margin: 10px 0; border: 1px solid var(--dsw-alias-border-l1); border-radius: 12px; background: var(--dsw-alias-bg-layer-1); padding: 12px 14px; }
@@ -1637,6 +2039,16 @@ var ITERATE_CSS = `
 .iterate-obs-block-head[data-click] { cursor: pointer; }
 .iterate-obs-block-body { padding: 8px 10px; }
 .iterate-obs-chip { display: inline-flex; align-items: center; gap: 6px; padding: 2px 8px; border-radius: 6px; background: var(--dsw-alias-bg-layer-1); border: 1px solid var(--dsw-alias-border-l1); font-size: 11px; color: var(--dsw-alias-label-secondary); white-space: nowrap; }
+/* Gap #6: validation / gate status colors (pass=green, fail=red). */
+.iterate-obs-chip[data-status="pass"], .iterate-obs-badge[data-status="pass"] { color: var(--dsw-alias-state-success-primary); background: color-mix(in srgb, var(--dsw-alias-state-success-primary) 12%, transparent); border-color: color-mix(in srgb, var(--dsw-alias-state-success-primary) 28%, transparent); }
+.iterate-obs-chip[data-status="fail"], .iterate-obs-badge[data-status="fail"] { color: var(--dsw-alias-state-error-primary); background: color-mix(in srgb, var(--dsw-alias-state-error-primary) 12%, transparent); border-color: color-mix(in srgb, var(--dsw-alias-state-error-primary) 28%, transparent); }
+.iterate-obs-row[data-status="fail"] { color: var(--dsw-alias-state-error-primary); }
+.iterate-obs-row[data-highlight] { background: color-mix(in srgb, var(--dsw-alias-state-error-primary) 14%, transparent); border-radius: 6px; padding-left: 6px; padding-right: 6px; border-bottom-color: transparent; font-weight: 600; }
+/* Gap #13: cross-round comparison table. */
+.iterate-obs-table { width: 100%; border-collapse: collapse; font-size: 11px; }
+.iterate-obs-table th, .iterate-obs-table td { text-align: left; padding: 5px 8px; border-bottom: 1px solid var(--dsw-alias-border-l1); white-space: nowrap; }
+.iterate-obs-table th { color: var(--dsw-alias-label-secondary); font-weight: 600; }
+.iterate-obs-table td { color: var(--dsw-alias-label-primary); }
 .iterate-obs-msg { padding: 2px 0; color: var(--dsw-alias-label-secondary); line-height: 1.5; font-size: 11px; word-break: break-word; }
 .iterate-obs-file { font-family: var(--dsw-font-mono, ui-monospace, monospace); font-size: 10.5px; color: var(--dsw-alias-label-secondary); word-break: break-all; }
 .iterate-obs-bar { display: flex; align-items: center; gap: 6px; font-size: 11px; color: var(--dsw-alias-label-secondary); flex-wrap: wrap; }
@@ -1853,11 +2265,25 @@ function TrendChart({ points }) {
 }
 function StartIterationButton() {
   const [copied, setCopied] = React.useState(null);
+  const [failed, setFailed] = React.useState(null);
+  const timers = React.useRef([]);
+  React.useEffect(
+    () => () => {
+      for (const t of timers.current) clearTimeout(t);
+      timers.current = [];
+    },
+    []
+  );
   const copy = (key, text) => {
     copyText(text).then((ok) => {
       if (ok) {
+        setFailed(null);
         setCopied(key);
-        setTimeout(() => setCopied((cur) => cur === key ? null : cur), 1600);
+        const t = window.setTimeout(() => setCopied((cur) => cur === key ? null : cur), 1600);
+        timers.current.push(t);
+      } else {
+        setCopied(null);
+        setFailed(key);
       }
     });
   };
@@ -1866,14 +2292,15 @@ function StartIterationButton() {
     className: "iterate-cmd",
     "data-primary": primary ? "" : void 0,
     "data-copied": copied === key ? "" : void 0,
+    "data-failed": failed === key ? "" : void 0,
     onClick: () => copy(key, command),
     title
-  }, copied === key ? "\u5DF2\u590D\u5236" : label);
+  }, copied === key ? "\u5DF2\u590D\u5236" : failed === key ? "\u590D\u5236\u5931\u8D25" : label);
   return React.createElement(
     "span",
     { className: "iterate-dashboard-launch" },
-    btn("start-full", "\u5B8C\u6574\u8FED\u4EE3", "/iterate", true, "\u590D\u5236\u542F\u52A8\u547D\u4EE4\uFF1A\u5B8C\u6574\u300C\u5BA1\u67E5 \u2192 \u4FEE\u590D \u2192 \u9A8C\u8BC1\u300D\u95ED\u73AF"),
-    btn("start-review", "\u4EC5\u8BC4\u5BA1", "/iterate review-only", false, "\u590D\u5236\u542F\u52A8\u547D\u4EE4\uFF1A\u53EA\u5BA1\u67E5\u4E0D\u4FEE\u6539\uFF08dry-run\uFF09")
+    btn("start-full", "\u5B8C\u6574\u8FED\u4EE3", START_INSTRUCTIONS.full, true, "\u590D\u5236\u542F\u52A8\u6307\u4EE4\uFF1A\u5B8C\u6574\u300C\u5BA1\u67E5 \u2192 \u4FEE\u590D \u2192 \u9A8C\u8BC1 \u2192 \u590D\u76D8\u300D\u95ED\u73AF\uFF08\u7C98\u8D34\u7ED9\u6A21\u578B\u5373\u53EF\uFF09"),
+    btn("start-review", "\u4EC5\u8BC4\u5BA1", START_INSTRUCTIONS.reviewOnly, false, "\u590D\u5236\u542F\u52A8\u6307\u4EE4\uFF1A\u53EA\u5BA1\u67E5\u4E0D\u4FEE\u6539\uFF08dry-run\uFF09\uFF08\u7C98\u8D34\u7ED9\u6A21\u578B\u5373\u53EF\uFF09")
   );
 }
 function ConvergenceDashboard(props) {
@@ -1888,9 +2315,36 @@ function ConvergenceDashboard(props) {
     setPulseKey((k) => k + 1);
   }, [report && hashReport(report) + ":" + getCurrentRound(report)]);
   if (!report) {
+    const runState = dashboardRunState(latestTranscript(session));
+    if (runState.state === "running") {
+      return React.createElement(
+        "div",
+        { "data-iterate-root": "", "data-iterate": "dashboard", "data-run-state": "running", className: "iterate-dashboard iterate-dashboard-empty" },
+        React.createElement("span", { className: "iterate-round-badge", "data-live": "" }, "\u8FD0\u884C\u4E2D"),
+        React.createElement(
+          "span",
+          { className: "iterate-empty-hint" },
+          `\u7B2C ${String(runState.round)} \u8F6E\u8FDB\u884C\u4E2D${runState.phase ? ` \xB7 \u9636\u6BB5\u300C${runState.phase}\u300D` : ""}\u2014\u2014\u9996\u8F6E\u6C47\u603B\u62A5\u544A\u843D\u5730\u540E\uFF0C\u8FD9\u91CC\u4F1A\u663E\u793A\u6536\u655B\u8FDB\u5EA6\u4E0E\u53D1\u73B0\u7EDF\u8BA1\u3002`
+        )
+        // No start button while a run is active.
+      );
+    }
+    if (runState.state === "done") {
+      return React.createElement(
+        "div",
+        { "data-iterate-root": "", "data-iterate": "dashboard", "data-run-state": "done", className: "iterate-dashboard iterate-dashboard-empty" },
+        React.createElement("span", { className: "iterate-round-badge" }, "\u5DF2\u7ED3\u675F"),
+        React.createElement(
+          "span",
+          { className: "iterate-empty-hint" },
+          `\u4E0A\u6B21\u8FED\u4EE3\u5728\u7B2C ${String(runState.round)} \u8F6E\u540E\u505C\u6B62${runState.stoppedReason ? `\uFF08${stoppedReasonLabel(runState.stoppedReason)}\uFF09` : ""}\uFF0C\u4F46\u6CA1\u6709\u53EF\u5C55\u793A\u7684\u6C47\u603B\u62A5\u544A\u3002`
+        ),
+        React.createElement(StartIterationButton, null)
+      );
+    }
     return React.createElement(
       "div",
-      { "data-iterate-root": "", "data-iterate": "dashboard", className: "iterate-dashboard iterate-dashboard-empty" },
+      { "data-iterate-root": "", "data-iterate": "dashboard", "data-run-state": "empty", className: "iterate-dashboard iterate-dashboard-empty" },
       React.createElement("span", { className: "iterate-round-badge" }, "iterate"),
       React.createElement("span", { className: "iterate-empty-hint" }, "\u8FD0\u884C\u4E00\u6B21\u8BC4\u5BA1\u540E\uFF0C\u8FD9\u91CC\u4F1A\u663E\u793A\u6536\u655B\u8FDB\u5EA6\u4E0E\u53D1\u73B0\u7EDF\u8BA1\u3002"),
       React.createElement(StartIterationButton, null)
@@ -2116,6 +2570,25 @@ function TriagePanel(props) {
   const [selected, setSelected] = React.useState(null);
   const [selectAll, setSelectAll] = React.useState(false);
   const [cmdCopied, setCmdCopied] = React.useState(null);
+  const [cmdFailed, setCmdFailed] = React.useState(null);
+  const cmdTimers = React.useRef([]);
+  React.useEffect(() => () => {
+    for (const t of cmdTimers.current) clearTimeout(t);
+    cmdTimers.current = [];
+  }, []);
+  const copyWithFeedback = (text, key) => {
+    copyText(text).then((ok) => {
+      if (ok) {
+        setCmdFailed(null);
+        setCmdCopied(key);
+        cmdTimers.current.push(window.setTimeout(() => setCmdCopied((cur) => cur === key ? null : cur), 1600));
+      } else {
+        setCmdCopied(null);
+        setCmdFailed(key);
+        setPayload(text);
+      }
+    });
+  };
   React.useEffect(() => {
     if (storage) storage.set(storageKey, JSON.stringify(verdicts));
   }, [storageKey, verdicts]);
@@ -2180,55 +2653,26 @@ function TriagePanel(props) {
   const ignoredCount = ignored.length;
   const counts = countVerdicts(verdicts);
   const doApproveArchitecturalFix = () => {
-    const cmd = "\u8BF7\u8C03\u7528 `iterate_fix`\uFF0C\u5BF9\u672C\u9879\u76EE\u5269\u4F59\u67B6\u6784\u578B finding \u751F\u6210\u4FEE\u590D\u5185\u5BB9\u5E76\u8BBE\u7F6E force: true \u5E94\u7528\uFF08\u67B6\u6784\u4FEE\u590D\u5141\u8BB8\u8D85\u8FC7 atomic \u9608\u503C\uFF09";
-    copyText(cmd).then((ok) => {
-      if (ok) {
-        setCmdCopied("approve-arch");
-        setTimeout(() => setCmdCopied(null), 1600);
-      }
-    });
+    const cmd = buildArchitecturalFixInstruction(findings);
+    if (!cmd) return;
+    copyWithFeedback(cmd, "approve-arch");
   };
   const doTriggerNewRound = () => {
     const cmd = "\u8BF7\u7EE7\u7EED\u6267\u884C\u4E0B\u4E00\u8F6E\u8FED\u4EE3\u5BA1\u67E5";
-    copyText(cmd).then((ok) => {
-      if (ok) {
-        setCmdCopied("new-round");
-        setTimeout(() => setCmdCopied(null), 1600);
-      }
-    });
+    copyWithFeedback(cmd, "new-round");
   };
   const doRollbackToCheckpoint = () => {
     const cmd = "\u8BF7\u56DE\u6EDA\u4E0A\u4E00\u8F6E\u8FED\u4EE3\u7684\u4FEE\u590D\uFF1A\u8C03\u7528 `iterate_history` \u67E5\u770B\u672C\u8F6E fix id\uFF0C\u518D\u7528 `iterate_rollback` \u9010\u4E2A\u64A4\u9500\u8FD9\u4E9B\u4FEE\u590D";
-    copyText(cmd).then((ok) => {
-      if (ok) {
-        setCmdCopied("rollback");
-        setTimeout(() => setCmdCopied(null), 1600);
-      }
-    });
+    copyWithFeedback(cmd, "rollback");
   };
   const doAssignFindings = () => {
     const targetAll = selectAll;
     const scopeIndices = targetAll ? allIndices : indices;
-    const scopeFindings = findings.filter((f, i) => scopeIndices.includes(i)).map((f) => ({
-      file: String(f.file || ""),
-      ...typeof f.line === "number" && f.line > 0 ? { line: f.line } : {},
-      dimension: String(f.dimension || ""),
-      severity: String(f.severity || ""),
-      summary: String(f.summary || ""),
-      ...f.suggested_fix ? { suggested_fix: String(f.suggested_fix) } : {}
-    }));
+    const scopeFindings = findings.filter((f, i) => scopeIndices.includes(i));
     if (scopeFindings.length === 0) return;
-    const cmd = `\u8BF7\u8C03\u7528 \`iterate_fix\` \u6307\u6D3E\u5E76\u4FEE\u590D\u4EE5\u4E0B findings\uFF1A
-
-\`\`\`json
-${JSON.stringify(scopeFindings, null, 2)}
-\`\`\``;
-    copyText(cmd).then((ok) => {
-      if (ok) {
-        setCmdCopied("assign");
-        setTimeout(() => setCmdCopied(null), 1600);
-      }
-    });
+    const cmd = buildAssignFixesInstruction(scopeFindings);
+    if (!cmd) return;
+    copyWithFeedback(cmd, "assign");
   };
   const doCopyYaml = () => {
     const yaml = toKnownIntentionalYaml(ignored);
@@ -2236,19 +2680,31 @@ ${JSON.stringify(scopeFindings, null, 2)}
     copyText(yaml).then((ok) => {
       if (ok) {
         setCopied(true);
-        setTimeout(() => setCopied(false), 1600);
+        cmdTimers.current.push(window.setTimeout(() => setCopied(false), 1600));
       } else {
         setPayload(yaml);
+        setCmdFailed("yaml");
       }
     });
   };
   const doBuildInstruction = () => {
     const text = buildApplyInstruction(ignored);
+    if (!text) return;
     setPayload(text);
-    if (text) copyText(text);
+    copyWithFeedback(text, "apply");
   };
-  const rows = filtered.map((finding, i) => {
-    const index = indices[i];
+  const doReadback = () => {
+    const text = buildTriageReadbackInstruction();
+    setPayload(text);
+    copyWithFeedback(text, "readback");
+  };
+  const rowPairs = [];
+  for (let i = 0; i < filtered.length; i++) {
+    const idx = indices[i];
+    const f = filtered[i];
+    if (typeof idx === "number" && f) rowPairs.push({ index: idx, finding: f });
+  }
+  const rows = rowPairs.map(({ index, finding }) => {
     const severity = finding.severity || "low";
     const verdict = verdicts[String(index)] || "keep";
     const isSelected = selected === index;
@@ -2368,22 +2824,35 @@ ${JSON.stringify(scopeFindings, null, 2)}
       React.createElement("span", {}, `y ${counts.keep} \xB7 n ${counts.skip} \xB7 a ${counts.ignore} \xB7 \u5F85\u5199\u56DE known_intentional\uFF1A${ignoredCount} \u6761`),
       React.createElement(
         "span",
-        { style: { display: "flex", gap: 6 } },
+        { style: { display: "flex", gap: 6, flexWrap: "wrap" } },
+        // Gap #7: the apply instruction (safe path) is PRIMARY; the raw YAML
+        // is demoted to an explicit "just the snippet" escape hatch.
         React.createElement("button", {
           className: "iterate-btn",
           "data-primary": "",
+          "data-copied": cmdCopied === "apply" ? "" : void 0,
+          "data-failed": cmdFailed === "apply" ? "" : void 0,
+          onClick: doBuildInstruction,
+          disabled: ignoredCount === 0,
+          title: ignoredCount === 0 ? "\u5F53\u524D\u6CA1\u6709\u6807\u8BB0\u4E3A\u300C\u5DF2\u77E5\u6709\u610F\u300D\u7684 finding" : "\u590D\u5236\u5E94\u7528\u6307\u4EE4\uFF1A\u7C98\u8D34\u540E\u6A21\u578B\u4F1A\u8C03\u7528 iterate_triage apply\uFF08\u6821\u9A8C\u3001\u53BB\u91CD\u3001\u5199\u5165\u524D\u5907\u4EFD\u3001\u5931\u8D25\u81EA\u52A8\u56DE\u6EDA\uFF09"
+        }, cmdCopied === "apply" ? "\u5DF2\u590D\u5236" : cmdFailed === "apply" ? "\u590D\u5236\u5931\u8D25" : `\u751F\u6210\u5E94\u7528\u6307\u4EE4${ignoredCount > 0 ? `\uFF08${ignoredCount}\uFF09` : ""}`),
+        React.createElement("button", {
+          className: "iterate-btn",
           "data-copied": copied ? "" : void 0,
+          "data-failed": cmdFailed === "yaml" ? "" : void 0,
           onClick: doCopyYaml,
           disabled: ignoredCount === 0,
-          title: ignoredCount === 0 ? "\u5F53\u524D\u6CA1\u6709\u6807\u8BB0\u4E3A\u300C\u5DF2\u77E5\u6709\u610F\u300D\u7684 finding" : "\u590D\u5236 known_intentional YAML"
-        }, copied ? "\u5DF2\u590D\u5236" : `\u590D\u5236 known_intentional${ignoredCount > 0 ? `\uFF08${ignoredCount}\uFF09` : ""}`),
+          title: ignoredCount === 0 ? "\u5F53\u524D\u6CA1\u6709\u6807\u8BB0\u4E3A\u300C\u5DF2\u77E5\u6709\u610F\u300D\u7684 finding" : "\u53EA\u590D\u5236 known_intentional YAML \u7247\u6BB5\uFF08\u9700\u81EA\u884C\u7C98\u5230 iterate.config.yaml \u7684 personalization.known_intentional \u4E0B\uFF09"
+        }, copied ? "\u5DF2\u590D\u5236" : cmdFailed === "yaml" ? "\u590D\u5236\u5931\u8D25" : "\u4EC5\u590D\u5236 YAML \u7247\u6BB5"),
         React.createElement("button", {
           className: "iterate-btn",
-          onClick: doBuildInstruction,
-          disabled: ignoredCount === 0,
-          title: ignoredCount === 0 ? "\u5F53\u524D\u6CA1\u6709\u6807\u8BB0\u4E3A\u300C\u5DF2\u77E5\u6709\u610F\u300D\u7684 finding" : "\u751F\u6210 iterate_triage \u5E94\u7528\u6307\u4EE4"
-        }, "\u751F\u6210\u5E94\u7528\u6307\u4EE4")
-      )
+          "data-copied": cmdCopied === "readback" ? "" : void 0,
+          "data-failed": cmdFailed === "readback" ? "" : void 0,
+          onClick: doReadback,
+          title: "\u590D\u5236 iterate_triage list \u6307\u4EE4\uFF0C\u6838\u5BF9\u5DF2\u7ECF\u5199\u5165\u7684 known_intentional \u6761\u76EE\uFF08\u5199\u56DE\u95ED\u73AF\u786E\u8BA4\uFF09"
+        }, cmdCopied === "readback" ? "\u5DF2\u590D\u5236" : cmdFailed === "readback" ? "\u590D\u5236\u5931\u8D25" : "\u56DE\u8BFB\u5DF2\u5199\u5165\u6761\u76EE")
+      ),
+      cmdCopied === "apply" ? React.createElement("span", { className: "iterate-triage-hint", role: "status" }, "\u5DF2\u590D\u5236\u5E94\u7528\u6307\u4EE4\u2014\u2014\u7C98\u8D34\u56DE\u4F1A\u8BDD\uFF0C\u6A21\u578B\u5C06\u8C03\u7528 iterate_triage apply \u5E76\u56DE\u62A5\u5199\u5165\u6761\u6570\u3002") : cmdCopied === "readback" ? React.createElement("span", { className: "iterate-triage-hint", role: "status" }, "\u5DF2\u590D\u5236\u56DE\u8BFB\u6307\u4EE4\u2014\u2014\u7C98\u8D34\u56DE\u4F1A\u8BDD\u53EF\u5217\u51FA\u5F53\u524D\u5DF2\u5199\u5165\u7684 known_intentional\u3002") : null
     ),
     // v3.0: Command buttons for native actions (§8)
     React.createElement(
@@ -2392,35 +2861,39 @@ ${JSON.stringify(scopeFindings, null, 2)}
       React.createElement("span", { style: { fontSize: 11, fontWeight: 600, color: "var(--dsw-alias-label-secondary)" } }, "\u6307\u6325\u64CD\u4F5C"),
       React.createElement(
         "span",
-        { style: { display: "flex", gap: 6 } },
+        { style: { display: "flex", gap: 6, flexWrap: "wrap" } },
         React.createElement("button", {
           className: "iterate-cmd",
           "data-primary": "",
           "data-copied": cmdCopied === "approve-arch" ? "" : void 0,
+          "data-failed": cmdFailed === "approve-arch" ? "" : void 0,
           onClick: doApproveArchitecturalFix,
-          title: "\u6279\u51C6\u67B6\u6784\u4FEE\u590D\uFF08\u590D\u5236\u6307\u4EE4\u6587\u672C\uFF09"
-        }, cmdCopied === "approve-arch" ? "\u5DF2\u590D\u5236" : "\u6279\u51C6\u67B6\u6784\u4FEE\u590D"),
+          title: "\u6279\u51C6\u67B6\u6784\u4FEE\u590D\uFF08\u590D\u5236\u6307\u4EE4\u6587\u672C\uFF1Aiterate_fix force:true\uFF0C\u542B\u5168\u90E8\u5FC5\u586B\u53C2\u6570\uFF09"
+        }, cmdCopied === "approve-arch" ? "\u5DF2\u590D\u5236" : cmdFailed === "approve-arch" ? "\u590D\u5236\u5931\u8D25" : "\u6279\u51C6\u67B6\u6784\u4FEE\u590D"),
         React.createElement("button", {
           className: "iterate-cmd",
           "data-copied": cmdCopied === "new-round" ? "" : void 0,
+          "data-failed": cmdFailed === "new-round" ? "" : void 0,
           onClick: doTriggerNewRound,
           title: "\u89E6\u53D1\u65B0\u4E00\u8F6E\u8FED\u4EE3\u5BA1\u67E5"
-        }, cmdCopied === "new-round" ? "\u5DF2\u590D\u5236" : "\u89E6\u53D1\u65B0\u4E00\u8F6E"),
+        }, cmdCopied === "new-round" ? "\u5DF2\u590D\u5236" : cmdFailed === "new-round" ? "\u590D\u5236\u5931\u8D25" : "\u89E6\u53D1\u65B0\u4E00\u8F6E"),
         React.createElement("button", {
           className: "iterate-cmd",
           "data-primary": "",
           "data-copied": cmdCopied === "assign" ? "" : void 0,
+          "data-failed": cmdFailed === "assign" ? "" : void 0,
           onClick: doAssignFindings,
           disabled: (selectAll ? allIndices : indices).length === 0,
-          title: selectAll ? `\u6307\u6D3E\u5168\u90E8 ${allIndices.length} \u4E2A findings \u4FEE\u590D` : `\u6307\u6D3E\u5F53\u524D\u53EF\u89C1 ${indices.length} \u4E2A findings \u4FEE\u590D`
-        }, cmdCopied === "assign" ? "\u5DF2\u590D\u5236" : "\u6307\u6D3E\u4FEE\u590D"),
+          title: selectAll ? `\u6307\u6D3E\u5168\u90E8 ${allIndices.length} \u4E2A findings \u4FEE\u590D\uFF08\u9010\u4E2A iterate_fix\uFF09` : `\u6307\u6D3E\u5F53\u524D\u53EF\u89C1 ${indices.length} \u4E2A findings \u4FEE\u590D\uFF08\u9010\u4E2A iterate_fix\uFF09`
+        }, cmdCopied === "assign" ? "\u5DF2\u590D\u5236" : cmdFailed === "assign" ? "\u590D\u5236\u5931\u8D25" : "\u6307\u6D3E\u4FEE\u590D"),
         React.createElement("button", {
           className: "iterate-cmd",
           "data-danger": "",
           "data-copied": cmdCopied === "rollback" ? "" : void 0,
+          "data-failed": cmdFailed === "rollback" ? "" : void 0,
           onClick: doRollbackToCheckpoint,
           title: "\u56DE\u6EDA\u5230\u4E0A\u4E00\u4E2A\u68C0\u67E5\u70B9"
-        }, cmdCopied === "rollback" ? "\u5DF2\u590D\u5236" : "\u56DE\u6EDA\u68C0\u67E5\u70B9")
+        }, cmdCopied === "rollback" ? "\u5DF2\u590D\u5236" : cmdFailed === "rollback" ? "\u590D\u5236\u5931\u8D25" : "\u56DE\u6EDA\u68C0\u67E5\u70B9")
       )
     ),
     payload ? React.createElement("div", { className: "iterate-payload" }, payload) : null
@@ -2522,33 +2995,57 @@ function SettingsPanel(_props) {
   const [showStatus, setShowStatus] = React.useState(false);
   const [confirming, setConfirming] = React.useState(false);
   const [clearedInfo, setClearedInfo] = React.useState(null);
+  const [cfgField, setCfgField] = React.useState(
+    () => CONFIG_EDIT_FIELDS.some((f) => f.key === "validation.commands") ? "validation.commands" : CONFIG_EDIT_FIELDS[0]?.key ?? "goal"
+  );
+  const [cfgCopied, setCfgCopied] = React.useState(false);
+  const [cfgFailed, setCfgFailed] = React.useState(false);
+  const [cfgText, setCfgText] = React.useState(null);
+  const [pullCopied, setPullCopied] = React.useState(false);
+  const [copyError, setCopyError] = React.useState(null);
   const guide = buildConfigEditGuide();
   const statusGuide = buildRuntimeStatusGuide();
+  const cfgTimers = React.useRef([]);
+  React.useEffect(() => () => {
+    for (const t of cfgTimers.current) clearTimeout(t);
+    cfgTimers.current = [];
+  }, []);
   const toggleTheme = () => {
     const next = !enabled;
     setEnabled(next);
     setThemeEnabled(next);
   };
   const flashCopied = (slot) => {
-    const setter = slot === "guide" ? setGuideCopied : setStatusCopied;
+    const setter = slot === "guide" ? setGuideCopied : slot === "status" ? setStatusCopied : setPullCopied;
     setter(true);
-    setTimeout(() => setter(false), 1600);
+    cfgTimers.current.push(window.setTimeout(() => setter(false), 1600));
   };
   const doCopy = (text, slot) => {
     copyText(text).then((ok) => {
+      setCopyError(ok ? null : slot);
       if (ok) flashCopied(slot);
     });
   };
+  const doBuildConfigInstruction = () => {
+    const text = buildConfigFieldInstruction(cfgField);
+    setCfgText(text);
+    copyText(text).then((ok) => {
+      setCfgFailed(!ok);
+      setCfgCopied(ok);
+      cfgTimers.current.push(window.setTimeout(() => setCfgCopied(false), 1600));
+      if (!ok) return;
+    });
+  };
   const requestClear = () => {
     if (confirming) {
       const count = removeStorageByPrefix(TRIAGE_STORAGE_PREFIX);
       setClearedInfo(count);
       setConfirming(false);
-      setTimeout(() => setClearedInfo(null), 3e3);
+      cfgTimers.current.push(window.setTimeout(() => setClearedInfo(null), 3e3));
       return;
     }
     setConfirming(true);
-    setTimeout(() => setConfirming(false), 3e3);
+    cfgTimers.current.push(window.setTimeout(() => setConfirming(false), 3e3));
   };
   const clearButton = clearedInfo !== null ? React.createElement("button", { className: "iterate-btn", "data-copied": "", disabled: true }, `\u5DF2\u6E05\u9664 ${clearedInfo} \u6761`) : React.createElement("button", {
     className: "iterate-btn",
@@ -2614,7 +3111,7 @@ function SettingsPanel(_props) {
         "div",
         {},
         React.createElement("div", { className: "iterate-settings-title" }, "\u914D\u7F6E\u7BA1\u7406"),
-        React.createElement("div", { className: "iterate-settings-desc" }, "\u76EE\u6807 / \u7EF4\u5EA6 / \u6700\u5927\u8F6E\u6570\u5199\u5728\u9879\u76EE\u7684 iterate.config.yaml\uFF0C\u590D\u5236\u6307\u5F15\u53EF\u8BA9\u6A21\u578B\u6309\u9700\u8C03\u6574\u3002")
+        React.createElement("div", { className: "iterate-settings-desc" }, "\u76EE\u6807 / \u7EF4\u5EA6 / \u6700\u5927\u8F6E\u6570 / validation.commands \u5199\u5728\u9879\u76EE\u7684 iterate.config.yaml\uFF0C\u590D\u5236\u6307\u5F15\u53EF\u8BA9\u6A21\u578B\u6309\u9700\u8C03\u6574\u3002")
       ),
       React.createElement(
         "div",
@@ -2623,6 +3120,50 @@ function SettingsPanel(_props) {
         React.createElement("button", { className: "iterate-btn", "data-ghost": "", onClick: () => setShowGuide((v) => !v) }, showGuide ? "\u6536\u8D77" : "\u5C55\u5F00")
       )
     ),
+    // Gap #8: wire up the previously-dead `buildConfigFieldInstruction` — pick
+    // a field, generate the `iterate_config` write payload for it, paste it to
+    // the model. `validation.commands` is the default selection.
+    React.createElement(
+      "div",
+      { className: "iterate-guide-bar", style: { marginTop: 8, flexWrap: "wrap" } },
+      React.createElement(
+        "select",
+        {
+          className: "iterate-filter-select",
+          value: cfgField,
+          "aria-label": "\u9009\u62E9\u8981\u4FEE\u6539\u7684\u914D\u7F6E\u5B57\u6BB5",
+          onChange: (e) => setCfgField(e.target.value)
+        },
+        ...CONFIG_EDIT_FIELDS.map(
+          (f) => React.createElement("option", { key: f.key, value: f.key }, `${f.label}\uFF08${f.key}\uFF09`)
+        )
+      ),
+      React.createElement(
+        "span",
+        { className: "iterate-settings-desc" },
+        configFieldByKey(cfgField)?.hint ?? ""
+      ),
+      React.createElement("button", {
+        className: "iterate-btn",
+        "data-primary": "",
+        "data-copied": cfgCopied ? "" : void 0,
+        "data-failed": cfgFailed ? "" : void 0,
+        onClick: doBuildConfigInstruction,
+        title: "\u751F\u6210\u5E76\u590D\u5236\u8BE5\u5B57\u6BB5\u7684 iterate_config \u5199\u5165\u6307\u4EE4\uFF08\u5199\u5165\u524D\u81EA\u52A8\u5907\u4EFD\u3001\u5931\u8D25\u81EA\u52A8\u56DE\u6EDA\uFF09"
+      }, cfgCopied ? "\u5DF2\u590D\u5236" : cfgFailed ? "\u590D\u5236\u5931\u8D25" : "\u751F\u6210\u5199\u5165\u6307\u4EE4"),
+      cfgFailed ? React.createElement("span", { className: "iterate-settings-desc" }, "\u526A\u8D34\u677F\u88AB\u62D2\u7EDD\u2014\u2014\u6307\u4EE4\u5DF2\u5C55\u793A\u5728\u4E0B\u65B9\uFF0C\u8BF7\u624B\u52A8\u590D\u5236\u3002") : null
+    ),
+    cfgText ? React.createElement(
+      "div",
+      { className: "iterate-guide" },
+      React.createElement(
+        "div",
+        { className: "iterate-guide-bar" },
+        React.createElement("span", {}, "\u5199\u5165\u6307\u4EE4\uFF08\u7C98\u8D34\u7ED9\u6A21\u578B\uFF09"),
+        React.createElement("button", { className: "iterate-btn", "data-ghost": "", onClick: () => doCopy(cfgText, "guide") }, "\u590D\u5236")
+      ),
+      React.createElement("div", { className: "iterate-guide-body" }, cfgText)
+    ) : null,
     showGuide ? React.createElement(
       "div",
       { className: "iterate-guide" },
@@ -2651,6 +3192,14 @@ function SettingsPanel(_props) {
         "div",
         { className: "iterate-scard-actions" },
         React.createElement("button", { className: "iterate-btn", "data-primary": "", "data-copied": statusCopied ? "" : void 0, onClick: () => doCopy(statusGuide, "status") }, statusCopied ? "\u5DF2\u590D\u5236" : "\u590D\u5236\u6307\u5F15"),
+        // Gap #4: RUNTIME_ARTIFACTS stops being documentation-only — this
+        // copies the instruction that makes the model echo those artifacts
+        // into the session so the observatory panels can read them.
+        React.createElement("button", {
+          className: "iterate-btn",
+          "data-copied": pullCopied ? "" : void 0,
+          onClick: () => doCopy(buildDiskSnapshotInstruction(), "pull")
+        }, pullCopied ? "\u5DF2\u590D\u5236" : "\u62C9\u53D6\u78C1\u76D8\u5FEB\u7167"),
         React.createElement("button", { className: "iterate-btn", "data-ghost": "", onClick: () => setShowStatus((v) => !v) }, showStatus ? "\u6536\u8D77" : "\u5C55\u5F00")
       )
     ),
@@ -2691,6 +3240,15 @@ function SettingsPanel(_props) {
     { "data-iterate-root": "", "data-iterate": "settings", className: "iterate-settings" },
     React.createElement("div", { className: "iterate-settings-title", style: { fontSize: 15, fontWeight: 700 } }, "iterate \u8BBE\u7F6E"),
     banner,
+    copyError ? React.createElement(
+      "div",
+      { key: "copy-err", className: "iterate-scard", role: "alert" },
+      React.createElement(
+        "div",
+        { className: "iterate-settings-desc" },
+        "\u526A\u8D34\u677F\u5199\u5165\u88AB\u62D2\u7EDD\uFF0C\u590D\u5236\u672A\u751F\u6548\u2014\u2014\u8BF7\u5C55\u5F00\u5BF9\u5E94\u533A\u5757\u624B\u52A8\u9009\u4E2D\u6587\u672C\u590D\u5236\u3002"
+      )
+    ) : null,
     themeCard,
     dataCard,
     guideCard,
@@ -2698,19 +3256,37 @@ function SettingsPanel(_props) {
   );
 }
 var OBS_TABS = [
-  { key: "live", label: "\u5B9E\u65F6\u6D3B\u52A8\u6D41" },
-  { key: "f1", label: "\u5BA1\u67E5\u7EBF\u7A0B" },
-  { key: "f2", label: "\u6536\u655B\u8D8B\u52BF" },
-  { key: "f3", label: "\u53D1\u73B0\u5B9A\u4F4D" },
-  { key: "f4", label: "\u4FEE\u590D\u4E0E\u56DE\u6EDA" },
-  { key: "f5", label: "\u65AD\u70B9\u6062\u590D" },
-  { key: "f6", label: "\u8FD0\u884C\u63A7\u5236\u53F0" },
-  { key: "f7", label: "\u51B3\u7B56\u65F6\u95F4\u7EBF" },
+  { key: "live", label: "\u5B9E\u65F6\u6D3B\u52A8\u6D41", hotkey: "" },
+  { key: "f1", label: "\u5BA1\u67E5\u7EBF\u7A0B", hotkey: "1" },
+  { key: "f2", label: "\u6536\u655B\u8D8B\u52BF", hotkey: "2" },
+  { key: "f3", label: "\u53D1\u73B0\u5B9A\u4F4D", hotkey: "3" },
+  { key: "f4", label: "\u4FEE\u590D\u4E0E\u56DE\u6EDA", hotkey: "4" },
+  { key: "f5", label: "\u65AD\u70B9\u6062\u590D", hotkey: "5" },
+  { key: "f6", label: "\u8FD0\u884C\u63A7\u5236\u53F0", hotkey: "6" },
+  { key: "f7", label: "\u51B3\u7B56\u65F6\u95F4\u7EBF", hotkey: "7" },
   // v3.0: Quality Command Center tabs
-  { key: "f8", label: "\u8D28\u91CF\u95E8\u7981" },
-  { key: "f9", label: "\u7ECF\u9A8C\u94F6\u884C" },
-  { key: "f10", label: "\u9632\u5FA1\u4E8B\u4EF6" }
+  { key: "f8", label: "\u8D28\u91CF\u95E8\u7981", hotkey: "8" },
+  { key: "f9", label: "\u7ECF\u9A8C\u94F6\u884C", hotkey: "9" },
+  { key: "f10", label: "\u9632\u5FA1\u4E8B\u4EF6", hotkey: "0" }
 ];
+var OBS_HOTKEY_TABS = {
+  1: "f1",
+  2: "f2",
+  3: "f3",
+  4: "f4",
+  5: "f5",
+  6: "f6",
+  7: "f7",
+  8: "f8",
+  9: "f9",
+  0: "f10",
+  "-": "live"
+};
+function obsTabLabel(t) {
+  if (t.key === "live") return t.label;
+  return `${t.key.toUpperCase()} ${t.label}`;
+}
+var OBS_HOTKEY_HINT = `${String(OBS_TABS.length)} \u9875 \xB7 \u6309 1-9/0 \u5207 Fn\u3001- \u56DE\u5B9E\u65F6\u6D41`;
 var OBS_LIVE_META = {
   read: { label: "\u9605\u8BFB", color: "var(--dsw-alias-brand-primary)" },
   fix: { label: "\u4FEE\u590D", color: "var(--dsw-alias-state-success-primary)" },
@@ -2760,18 +3336,7 @@ function latestDefenseEvents(session) {
   return scanSessionForDefenseEvents(session);
 }
 function buildObsFixInstruction(f) {
-  const payload = JSON.stringify({
-    file: String(f.file || ""),
-    ...typeof f.line === "number" && f.line > 0 ? { line: f.line } : {},
-    dimension: String(f.dimension || ""),
-    summary: String(f.summary || ""),
-    ...f.suggested_fix ? { suggested_fix: String(f.suggested_fix) } : {}
-  }, null, 2);
-  return `\u8BF7\u8C03\u7528 \`iterate_fix\` \u4FEE\u590D\u4EE5\u4E0B finding\uFF1A
-
-\`\`\`json
-${payload}
-\`\`\``;
+  return buildFixInstruction(f);
 }
 function ObservatoryPanel(props) {
   const session = props && props.session ? props.session : null;
@@ -2799,6 +3364,28 @@ function ObservatoryPanel(props) {
   React.useEffect(() => () => {
     if (copyTimer.current) clearTimeout(copyTimer.current);
   }, []);
+  React.useEffect(() => {
+    const doc = typeof document !== "undefined" ? document : null;
+    if (!doc || !open) return;
+    const onKeyDown = (ev) => {
+      if (ev.metaKey || ev.ctrlKey || ev.altKey || ev.shiftKey) return;
+      const t = ev.target;
+      if (t && (t.tagName === "INPUT" || t.tagName === "TEXTAREA" || t.tagName === "SELECT")) return;
+      if (t && typeof t.isContentEditable === "boolean" && t.isContentEditable) return;
+      const rootEl = doc.querySelector('[data-iterate="obs"]');
+      if (!rootEl) return;
+      const activeEl = doc.activeElement;
+      const inPanel = activeEl === rootEl || activeEl !== null && typeof rootEl.contains === "function" && rootEl.contains(activeEl);
+      const idle = activeEl === null || activeEl === doc.body;
+      if (!inPanel && !idle) return;
+      const next = OBS_HOTKEY_TABS[ev.key];
+      if (!next) return;
+      ev.preventDefault();
+      setTab(next);
+    };
+    doc.addEventListener("keydown", onKeyDown);
+    return () => doc.removeEventListener("keydown", onKeyDown);
+  }, [open]);
   const copyInstruction = (key, text) => {
     if (!text) return;
     copyText(text).then((ok) => {
@@ -2811,6 +3398,8 @@ function ObservatoryPanel(props) {
       copyTimer.current = setTimeout(() => setCopiedKey((cur) => cur === key ? null : cur), 1600);
     });
   };
+  const pullInstruction = buildDiskSnapshotInstruction();
+  const pullTitle = `\u590D\u5236\u62C9\u53D6\u78C1\u76D8\u5FEB\u7167\u6307\u4EE4\uFF1A\u8BA9\u6A21\u578B\u9010\u4E2A\u8C03\u7528 ${DISK_SNAPSHOT_SOURCES.map((s) => s.tool).join(" / ")} \u5E76\u56DE\u663E\u5B8C\u6574\u7ED3\u679C`;
   const toggleThread = (key) => {
     setThreadMode("auto");
     setExpandedThreads((prev) => {
@@ -2822,7 +3411,12 @@ function ObservatoryPanel(props) {
   };
   const exportObservatory = () => {
     if (!manifest) return;
-    const json = serializeObservatoryExport(manifest, manifest.live || []);
+    const json = serializeObservatoryExport(manifest, manifest.live || [], {
+      qualityGate,
+      experienceBank,
+      defenseEvents,
+      report: latestReport(session)
+    });
     const filename = `iterate-observatory-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}.json`;
     const flash = () => {
       setCopiedKey("export");
@@ -2858,7 +3452,16 @@ function ObservatoryPanel(props) {
         "div",
         { className: "iterate-obs-head", "data-closed": "" },
         React.createElement("span", { className: "iterate-obs-title" }, "iterate \u89C2\u6D4B\u53F0"),
-        React.createElement("span", { className: "iterate-obs-head-meta" }, "\u6682\u65E0\u8FD0\u884C\u65F6\u89C2\u6D4B\u6570\u636E")
+        React.createElement("span", { className: "iterate-obs-head-meta" }, `\u6682\u65E0\u8FD0\u884C\u65F6\u89C2\u6D4B\u6570\u636E \xB7 ${OBS_HOTKEY_HINT}`),
+        React.createElement("button", {
+          className: "iterate-btn",
+          "data-copied": copiedKey === "pull-snapshot" ? "" : void 0,
+          onClick: (e) => {
+            e.stopPropagation();
+            copyInstruction("pull-snapshot", pullInstruction);
+          },
+          title: "\u590D\u5236\u62C9\u53D6\u78C1\u76D8\u5FEB\u7167\u6307\u4EE4\uFF1A\u78C1\u76D8\u4E0A\u53EF\u80FD\u5DF2\u6709\u5386\u53F2\u4EA7\u7269\uFF0C\u56DE\u663E\u8FDB\u4F1A\u8BDD\u540E\u89C2\u6D4B\u53F0\u5373\u53EF\u586B\u5145"
+        }, copiedKey === "pull-snapshot" ? "\u5DF2\u590D\u5236" : "\u62C9\u53D6\u78C1\u76D8\u5FEB\u7167")
       )
     );
   }
@@ -2968,6 +3571,45 @@ function ObservatoryPanel(props) {
       return React.createElement("div", { className: "iterate-obs-empty" }, "\u6682\u65E0\u6536\u655B\u6570\u636E");
     }
     const points = conv.map((n, i) => ({ round: i + 1, count: n }));
+    const report = latestReport(session);
+    const comparison = buildRoundComparison(report, manifest.validations || []);
+    const comparisonTable = comparison.length === 0 ? null : React.createElement(
+      "table",
+      { className: "iterate-obs-table" },
+      React.createElement(
+        "thead",
+        {},
+        React.createElement(
+          "tr",
+          {},
+          React.createElement("th", {}, "\u8F6E\u6B21"),
+          React.createElement("th", {}, "\u53D1\u73B0"),
+          React.createElement("th", {}, "\u5DF2\u4FEE\u590D"),
+          React.createElement("th", {}, "\u4E25\u91CD\u5EA6\u5206\u5E03"),
+          React.createElement("th", {}, "\u9A8C\u8BC1")
+        )
+      ),
+      React.createElement(
+        "tbody",
+        {},
+        ...comparison.map((row) => {
+          const sevText = Object.entries(row.severities).map(([k, v]) => `${k}:${v}`).join(" \xB7 ");
+          const anyFailed = row.validations.some((v) => v.allowed !== true);
+          const valText = row.validations.length === 0 ? "\u2014" : `${row.validations.filter((v) => v.allowed === true).length}/${row.validations.length} \u901A\u8FC7${anyFailed ? "\uFF08\u542B\u5931\u8D25\uFF09" : ""}`;
+          return React.createElement(
+            "tr",
+            { key: `cmp-${row.round}` },
+            React.createElement("td", {}, `Round ${row.round}`),
+            React.createElement("td", {}, String(row.findings)),
+            React.createElement("td", {}, String(row.fixed)),
+            React.createElement("td", {}, sevText || "\u2014"),
+            React.createElement("td", {
+              style: anyFailed ? { color: "var(--dsw-alias-state-error-primary)", fontWeight: 600 } : row.validations.length > 0 ? { color: "var(--dsw-alias-state-success-primary)" } : void 0
+            }, valText)
+          );
+        })
+      )
+    );
     return React.createElement(
       "div",
       {},
@@ -2976,7 +3618,22 @@ function ObservatoryPanel(props) {
         "div",
         { className: "iterate-obs-bar", style: { marginTop: 6 } },
         `\u5404\u8F6E\u53D1\u73B0\u6570\u91CF\uFF1A${conv.join(" \u2192 ")}${typeof manifest.round === "number" ? ` \xB7 \u5F53\u524D Round ${manifest.round}` : ""}`
-      )
+      ),
+      comparisonTable ? React.createElement(
+        "div",
+        { className: "iterate-obs-block", style: { marginTop: 8 } },
+        React.createElement(
+          "div",
+          { className: "iterate-obs-block-head" },
+          React.createElement("span", {}, "\u8DE8\u8F6E\u5BF9\u6BD4\uFF08\u672C\u4F1A\u8BDD\uFF09"),
+          React.createElement(
+            "span",
+            { className: "iterate-obs-head-meta" },
+            "\u8DE8\u4F1A\u8BDD\u5BF9\u6BD4\uFF1A\u672C\u8868\u53EA\u8986\u76D6\u5F53\u524D\u4F1A\u8BDD\uFF1B\u70B9\u300C\u62C9\u53D6\u78C1\u76D8\u5FEB\u7167\u300D\u8BA9\u6A21\u578B\u56DE\u663E iterate_history\uFF0C\u518D\u7528\u300C\u5BFC\u51FA JSON\u300D\u5E76\u6392\u6BD4\u8F83\u4E24\u6B21\u8FD0\u884C"
+          )
+        ),
+        React.createElement("div", { className: "iterate-obs-block-body" }, comparisonTable)
+      ) : null
     );
   };
   const renderFindings = () => {
@@ -3109,11 +3766,7 @@ function ObservatoryPanel(props) {
     return React.createElement("div", {}, ...fixes.map((f, i) => {
       const k = `f4-${i}`;
       const id = String(f.id || `fix#${i + 1}`);
-      const rollbackText = `\u8BF7\u8C03\u7528 \`iterate_rollback\` \u56DE\u6EDA\u4EE5\u4E0B\u4FEE\u590D\uFF1A
-
-\`\`\`json
-${JSON.stringify({ id }, null, 2)}
-\`\`\``;
+      const rollbackText = buildRollbackInstruction(id);
       const added = typeof f.linesAdded === "number" ? f.linesAdded : 0;
       const removed = typeof f.linesRemoved === "number" ? f.linesRemoved : 0;
       return React.createElement(
@@ -3151,22 +3804,14 @@ ${JSON.stringify({ id }, null, 2)}
   const renderCheckpoint = () => {
     const cp = manifest.checkpoint;
     if (!cp) {
-      return React.createElement("div", { className: "iterate-obs-empty" }, "\u6682\u65E0\u65AD\u70B9");
+      return React.createElement(
+        "div",
+        { className: "iterate-obs-empty" },
+        diskEmptyStateText(toolCalledInSession(session, "iterate_transcript"), "\u65AD\u70B9")
+      );
     }
-    const resumeText = `\u8BF7\u8C03\u7528 \`iterate_checkpoint\` \u4ECE\u65AD\u70B9\u6062\u590D\u8FED\u4EE3\uFF1A
-
-\`\`\`json
-${JSON.stringify({
-      operation: "resume",
-      mode: String(cp.mode || "normal"),
-      maxRounds: typeof cp.maxRounds === "number" ? cp.maxRounds : null
-    }, null, 2)}
-\`\`\``;
-    const clearText = `\u8BF7\u8C03\u7528 \`iterate_checkpoint\` \u6E05\u9664\u5F53\u524D\u65AD\u70B9\uFF1A
-
-\`\`\`json
-${JSON.stringify({ operation: "clear" }, null, 2)}
-\`\`\``;
+    const resumeText = buildCheckpointResumeInstruction();
+    const clearText = buildCheckpointClearInstruction();
     const item = (label, value) => React.createElement("span", { className: "iterate-obs-chip" }, `${label} ${String(value ?? "?")}`);
     return React.createElement(
       "div",
@@ -3227,6 +3872,53 @@ ${JSON.stringify({ operation: "nudge", text: nudgeText }, null, 2)}
 \`\`\`json
 ${JSON.stringify({ operation: "nudge", text: null }, null, 2)}
 \`\`\``;
+    const validations = Array.isArray(manifest.validations) ? manifest.validations : [];
+    const abortedByValidation = String(manifest.stoppedReason || "") === "aborted_by_validation";
+    const validationRows = validations.map((v, i) => {
+      const allowed = v.allowed === true;
+      const failed = !allowed;
+      const highlight = failed && abortedByValidation;
+      const exit = typeof v.exitCode === "number" ? `exit ${v.exitCode}` : "exit \u2014";
+      return React.createElement(
+        "div",
+        {
+          key: `val-${i}`,
+          className: "iterate-obs-row",
+          "data-status": allowed ? "pass" : "fail",
+          "data-highlight": highlight ? "" : void 0,
+          title: v.rejectReason ? String(v.rejectReason) : void 0
+        },
+        React.createElement("span", { className: "iterate-obs-head-meta" }, `Round ${typeof v.round === "number" ? v.round : "?"}`),
+        React.createElement("code", { className: "iterate-obs-mono" }, String(v.command || "")),
+        React.createElement(
+          "span",
+          { className: "iterate-obs-chip", "data-status": allowed ? "pass" : "fail" },
+          allowed ? "\u901A\u8FC7" : "\u5931\u8D25"
+        ),
+        React.createElement("span", { className: "iterate-obs-head-meta" }, exit),
+        highlight ? React.createElement("span", { className: "iterate-obs-chip", "data-status": "fail" }, "\u5BFC\u81F4\u4E2D\u6B62") : null
+      );
+    });
+    const validationsBlock = React.createElement(
+      "div",
+      { className: "iterate-obs-block", style: { marginTop: 8 } },
+      React.createElement(
+        "div",
+        { className: "iterate-obs-block-head" },
+        React.createElement("span", {}, "\u9A8C\u8BC1\u7ED3\u679C"),
+        validations.length === 0 ? React.createElement("span", { className: "iterate-obs-head-meta" }, "\u672C\u8F6E\u5C1A\u65E0\u9A8C\u8BC1\u8BB0\u5F55") : React.createElement("span", { className: "iterate-obs-head-meta" }, `${validations.length} \u6761\u547D\u4EE4`),
+        abortedByValidation ? React.createElement("span", { className: "iterate-obs-badge", "data-status": "fail" }, "\u56E0\u9A8C\u8BC1\u5931\u8D25\u4E2D\u6B62") : null
+      ),
+      React.createElement(
+        "div",
+        { className: "iterate-obs-block-body" },
+        validations.length === 0 ? React.createElement(
+          "div",
+          { className: "iterate-obs-empty" },
+          "\u5C1A\u672A\u62C9\u53D6\u9A8C\u8BC1\u7ED3\u679C\uFF1A\u6570\u636E\u5728\u78C1\u76D8 transcript \u91CC\uFF0C\u70B9\u300C\u62C9\u53D6\u78C1\u76D8\u5FEB\u7167\u300D\u590D\u5236\u6307\u4EE4\u53D1\u56DE\u4F1A\u8BDD\u5373\u53EF\u56DE\u586B\u3002"
+        ) : React.createElement(React.Fragment, null, ...validationRows)
+      )
+    );
     return React.createElement(
       "div",
       { className: "iterate-obs-block" },
@@ -3271,7 +3963,8 @@ ${JSON.stringify({ operation: "nudge", text: null }, null, 2)}
             onClick: () => copyInstruction("nudge", nudgeInstruction),
             title: "\u590D\u5236 iterate_transcript nudge \u6307\u4EE4\u6587\u672C"
           }, copiedKey === "nudge" ? "\u5DF2\u590D\u5236" : "\u590D\u5236 nudge \u6307\u4EE4")
-        )
+        ),
+        validationsBlock
       )
     );
   };
@@ -3374,18 +4067,15 @@ ${JSON.stringify({ operation: "nudge", text: null }, null, 2)}
     return React.createElement("div", {}, filterBar, ...rows);
   };
   const renderQualityGate = () => {
-    const gateInstruction = "\u8BF7\u8C03\u7528 `iterate_quality_gate` \u67E5\u8BE2\u5F53\u524D\u8D28\u91CF\u95E8\u7981\u72B6\u6001";
-    const gateClearInstruction = `\u8BF7\u8C03\u7528 \`iterate_quality_gate\` \u6E05\u9664\u5F53\u524D\u8D28\u91CF\u95E8\u7981\u8BC1\u4E66\uFF1A
-
-\`\`\`json
-${JSON.stringify({ operation: "clear" }, null, 2)}
-\`\`\``;
+    const gateInstruction = buildQualityGateQueryInstruction();
+    const gateClearInstruction = buildQualityGateClearInstruction();
     const gate = qualityGate;
     const dims = gate && gate.dimensions ? gate.dimensions : [];
     const hasGate = gate !== null && Boolean(gate.overallStatus || gate.overallScore != null || dims.length > 0);
     const status = gate && gate.overallStatus ? String(gate.overallStatus) : "pending";
     const statusLabel = status === "pass" ? "PASS" : status === "fail" ? "FAIL" : "PENDING";
     const num = (v) => Number(v != null ? v : 0);
+    const pulled = toolCalledInSession(session, "iterate_quality_gate");
     const headerBar = React.createElement(
       "div",
       { className: "iterate-obs-bar", style: { marginBottom: 8 } },
@@ -3395,7 +4085,7 @@ ${JSON.stringify({ operation: "clear" }, null, 2)}
         "data-primary": "",
         "data-copied": copiedKey === "qgate" ? "" : void 0,
         onClick: () => copyInstruction("qgate", gateInstruction),
-        title: "\u590D\u5236 iterate_quality_gate \u67E5\u8BE2\u6307\u4EE4"
+        title: "\u590D\u5236 iterate_quality_gate \u67E5\u8BE2\u6307\u4EE4\uFF08\u542B JSON \u53C2\u6570\uFF09"
       }, copiedKey === "qgate" ? "\u5DF2\u590D\u5236" : "\u67E5\u8BE2\u95E8\u7981"),
       React.createElement("button", {
         className: "iterate-btn",
@@ -3403,7 +4093,15 @@ ${JSON.stringify({ operation: "clear" }, null, 2)}
         "data-copied": copiedKey === "qgate-clear" ? "" : void 0,
         onClick: () => copyInstruction("qgate-clear", gateClearInstruction),
         title: "\u590D\u5236 iterate_quality_gate clear \u6307\u4EE4\u6587\u672C\uFF08\u91CD\u7F6E\u9648\u65E7\u7684 FAIL \u8BC1\u4E66\uFF09"
-      }, copiedKey === "qgate-clear" ? "\u5DF2\u590D\u5236" : "\u6E05\u9664\u95E8\u7981")
+      }, copiedKey === "qgate-clear" ? "\u5DF2\u590D\u5236" : "\u6E05\u9664\u95E8\u7981"),
+      // Gap #4: the browser cannot read `.iterate/` directly — one click
+      // copies the pull instruction that makes the model echo it into the stream.
+      React.createElement("button", {
+        className: "iterate-btn",
+        "data-copied": copiedKey === "disk-snapshot" ? "" : void 0,
+        onClick: () => copyInstruction("disk-snapshot", pullInstruction),
+        title: "\u590D\u5236\u62C9\u53D6\u78C1\u76D8\u5FEB\u7167\u6307\u4EE4\uFF1A\u8BA9\u6A21\u578B\u56DE\u663E .iterate/ \u4E0B\u7684\u95E8\u7981\u3001\u7ECF\u9A8C\u3001\u9632\u5FA1\u4E8B\u4EF6\u4E0E transcript"
+      }, copiedKey === "disk-snapshot" ? "\u5DF2\u590D\u5236" : "\u62C9\u53D6\u78C1\u76D8\u5FEB\u7167")
     );
     if (!hasGate) {
       return React.createElement(
@@ -3422,7 +4120,18 @@ ${JSON.stringify({ operation: "clear" }, null, 2)}
           React.createElement(
             "div",
             { className: "iterate-obs-block-body" },
-            React.createElement("div", { className: "iterate-obs-msg" }, "\u8D28\u91CF\u95E8\u7981\u663E\u793A\u5404\u7EF4\u5EA6\u6536\u655B\u5EA6\u3001\u9A8C\u8BC1\u901A\u8FC7\u7387\u548C\u6574\u4F53 PASS/FAIL \u72B6\u6001\u3002"),
+            React.createElement(
+              "div",
+              { className: "iterate-obs-msg" },
+              // Gap #4: distinguish "we pulled it and it is empty" from "we
+              // never asked the model to read the disk".
+              diskEmptyStateText(pulled, "\u8D28\u91CF\u95E8\u7981\u8BC1\u4E66")
+            ),
+            React.createElement(
+              "div",
+              { className: "iterate-obs-msg", style: { marginTop: 6 } },
+              "\u8D28\u91CF\u95E8\u7981\u663E\u793A\u5404\u7EF4\u5EA6\u6536\u655B\u5EA6\u3001\u9A8C\u8BC1\u901A\u8FC7\u7387\u548C\u6574\u4F53 PASS/FAIL \u72B6\u6001\u3002"
+            ),
             React.createElement(
               "div",
               { className: "iterate-obs-bar", style: { marginTop: 8 } },
@@ -3431,7 +4140,13 @@ ${JSON.stringify({ operation: "clear" }, null, 2)}
                 "data-copied": copiedKey === "qgate-instr" ? "" : void 0,
                 onClick: () => copyInstruction("qgate-instr", gateInstruction),
                 title: "\u590D\u5236\u67E5\u8BE2\u6307\u4EE4"
-              }, copiedKey === "qgate-instr" ? "\u5DF2\u590D\u5236" : "\u590D\u5236\u67E5\u8BE2\u6307\u4EE4")
+              }, copiedKey === "qgate-instr" ? "\u5DF2\u590D\u5236" : "\u590D\u5236\u67E5\u8BE2\u6307\u4EE4"),
+              React.createElement("button", {
+                className: "iterate-btn",
+                "data-copied": copiedKey === "disk-snapshot-2" ? "" : void 0,
+                onClick: () => copyInstruction("disk-snapshot-2", pullInstruction),
+                title: "\u590D\u5236\u62C9\u53D6\u78C1\u76D8\u5FEB\u7167\u6307\u4EE4"
+              }, copiedKey === "disk-snapshot-2" ? "\u5DF2\u590D\u5236" : "\u62C9\u53D6\u78C1\u76D8\u5FEB\u7167")
             )
           )
         )
@@ -3500,12 +4215,13 @@ ${JSON.stringify({ operation: "clear" }, null, 2)}
 
 \`\`\`json
 ${JSON.stringify({ operation: "search", query: expSearch }, null, 2)}
-\`\`\`` : "\u8BF7\u8C03\u7528 `iterate_experience` \u5217\u51FA\u6240\u6709\u7ECF\u9A8C";
+\`\`\`` : buildExperienceListInstruction();
     const expEntries = experienceBank && experienceBank.entries ? experienceBank.entries : [];
     const query = expSearch.trim().toLowerCase();
     const visible = query ? expEntries.filter(
       (e) => [e.pattern, e.description, e.id, e.dimension, e.severity, ...e.tags || []].filter(Boolean).some((t) => String(t).toLowerCase().includes(query))
     ) : expEntries;
+    const pulled = toolCalledInSession(session, "iterate_experience");
     const resultRows = visible.map((e, i) => {
       const adoptInstruction = `\u8BF7\u8C03\u7528 \`iterate_experience\` \u91C7\u7EB3\u7ECF\u9A8C\u5E76\u5E94\u7528\u5DF2\u9A8C\u8BC1\u4FEE\u6CD5\uFF1A
 
@@ -3552,9 +4268,15 @@ ${JSON.stringify({ operation: "get", id: e.id }, null, 2)}
           className: "iterate-btn",
           "data-primary": "",
           "data-copied": copiedKey === "exp-list" ? "" : void 0,
-          onClick: () => copyInstruction("exp-list", "\u8BF7\u8C03\u7528 `iterate_experience` \u5217\u51FA\u6240\u6709\u7ECF\u9A8C"),
-          title: "\u590D\u5236\u5217\u51FA\u7ECF\u9A8C\u6307\u4EE4"
-        }, copiedKey === "exp-list" ? "\u5DF2\u590D\u5236" : "\u5217\u51FA\u7ECF\u9A8C")
+          onClick: () => copyInstruction("exp-list", buildExperienceListInstruction()),
+          title: "\u590D\u5236\u5217\u51FA\u7ECF\u9A8C\u6307\u4EE4\uFF08\u542B JSON \u53C2\u6570\uFF09"
+        }, copiedKey === "exp-list" ? "\u5DF2\u590D\u5236" : "\u5217\u51FA\u7ECF\u9A8C"),
+        React.createElement("button", {
+          className: "iterate-btn",
+          "data-copied": copiedKey === "exp-snapshot" ? "" : void 0,
+          onClick: () => copyInstruction("exp-snapshot", pullInstruction),
+          title: "\u590D\u5236\u62C9\u53D6\u78C1\u76D8\u5FEB\u7167\u6307\u4EE4\uFF1A\u628A .iterate/ \u4E0B\u7684\u7ECF\u9A8C\u94F6\u884C\u7B49\u4EA7\u7269\u56DE\u663E\u8FDB\u4F1A\u8BDD"
+        }, copiedKey === "exp-snapshot" ? "\u5DF2\u590D\u5236" : "\u62C9\u53D6\u78C1\u76D8\u5FEB\u7167")
       ),
       React.createElement(
         "div",
@@ -3575,7 +4297,13 @@ ${JSON.stringify({ operation: "get", id: e.id }, null, 2)}
           title: "\u590D\u5236\u641C\u7D22\u6307\u4EE4"
         }, copiedKey === "exp-search" ? "\u5DF2\u590D\u5236" : "\u641C\u7D22")
       ),
-      resultRows.length > 0 ? React.createElement("div", {}, ...resultRows) : expEntries.length > 0 ? React.createElement("div", { className: "iterate-obs-empty" }, "\u6CA1\u6709\u5339\u914D\u300C" + expSearch + "\u300D\u7684\u7ECF\u9A8C") : React.createElement("div", { className: "iterate-obs-empty" }, "\u672C\u6B21\u4F1A\u8BDD\u6682\u65E0\u7ECF\u9A8C\u8BB0\u5F55\uFF0C\u53EF\u70B9\u51FB\u300C\u5217\u51FA\u7ECF\u9A8C\u300D\u67E5\u8BE2\u5386\u53F2\u7ECF\u9A8C")
+      resultRows.length > 0 ? React.createElement("div", {}, ...resultRows) : expEntries.length > 0 ? React.createElement("div", { className: "iterate-obs-empty" }, "\u6CA1\u6709\u5339\u914D\u300C" + expSearch + "\u300D\u7684\u7ECF\u9A8C") : React.createElement(
+        "div",
+        {},
+        // Gap #4: separate "pulled and empty" from "never pulled".
+        React.createElement("div", { className: "iterate-obs-empty" }, diskEmptyStateText(pulled, "\u7ECF\u9A8C\u94F6\u884C")),
+        React.createElement("div", { className: "iterate-obs-empty" }, "\u4E5F\u53EF\u70B9\u300C\u5217\u51FA\u7ECF\u9A8C\u300D\u67E5\u8BE2\u78C1\u76D8\u4E0A\u7684\u5168\u90E8\u5386\u53F2\u7ECF\u9A8C\u3002")
+      )
     );
   };
   const renderDefenseEvents = () => {
@@ -3583,7 +4311,7 @@ ${JSON.stringify({ operation: "get", id: e.id }, null, 2)}
 
 \`\`\`json
 ${JSON.stringify({ operation: "list", type: defenseFilter || void 0 }, null, 2)}
-\`\`\`` : "\u8BF7\u8C03\u7528 `iterate_defense_events` \u5217\u51FA\u6240\u6709\u9632\u5FA1\u4E8B\u4EF6";
+\`\`\`` : buildDefenseEventsListInstruction();
     const typeOptions = [
       { value: "", label: "\u5168\u90E8\u7C7B\u578B" },
       { value: "precondition_failed", label: "\u524D\u7F6E\u6821\u9A8C\u5931\u8D25" },
@@ -3610,14 +4338,24 @@ ${JSON.stringify({ operation: "list", type: defenseFilter || void 0 }, null, 2)}
         className: "iterate-btn",
         "data-primary": "",
         "data-copied": copiedKey === "defense-list" ? "" : void 0,
-        onClick: () => copyInstruction("defense-list", "\u8BF7\u8C03\u7528 `iterate_defense_events` \u5217\u51FA\u6240\u6709\u9632\u5FA1\u4E8B\u4EF6"),
-        title: "\u590D\u5236\u5217\u51FA\u9632\u5FA1\u4E8B\u4EF6\u6307\u4EE4"
+        onClick: () => copyInstruction("defense-list", buildDefenseEventsListInstruction()),
+        title: "\u590D\u5236\u5217\u51FA\u9632\u5FA1\u4E8B\u4EF6\u6307\u4EE4\uFF08\u542B JSON \u53C2\u6570\uFF09"
       }, copiedKey === "defense-list" ? "\u5DF2\u590D\u5236" : "\u5217\u51FA\u4E8B\u4EF6"),
+      React.createElement("button", {
+        className: "iterate-btn",
+        "data-copied": copiedKey === "defense-snapshot" ? "" : void 0,
+        onClick: () => copyInstruction("defense-snapshot", pullInstruction),
+        title: "\u590D\u5236\u62C9\u53D6\u78C1\u76D8\u5FEB\u7167\u6307\u4EE4\uFF1A\u628A .iterate/ \u4E0B\u7684\u9632\u5FA1\u4E8B\u4EF6\u6D41\u56DE\u663E\u8FDB\u4F1A\u8BDD"
+      }, copiedKey === "defense-snapshot" ? "\u5DF2\u590D\u5236" : "\u62C9\u53D6\u78C1\u76D8\u5FEB\u7167"),
       React.createElement("button", {
         className: "iterate-btn",
         "data-copied": copiedKey === "defense-counts" ? "" : void 0,
-        onClick: () => copyInstruction("defense-counts", "\u8BF7\u8C03\u7528 `iterate_defense_events` \u67E5\u8BE2\u4E8B\u4EF6\u7EDF\u8BA1"),
-        title: "\u590D\u5236\u7EDF\u8BA1\u6307\u4EE4"
+        onClick: () => copyInstruction("defense-counts", `\u8BF7\u8C03\u7528 \`iterate_defense_events\` \u67E5\u8BE2\u4E8B\u4EF6\u7EDF\u8BA1\uFF1A
+
+\`\`\`json
+${JSON.stringify({ operation: "counts" }, null, 2)}
+\`\`\``),
+        title: "\u590D\u5236\u7EDF\u8BA1\u6307\u4EE4\uFF08\u542B JSON \u53C2\u6570\uFF09"
       }, copiedKey === "defense-counts" ? "\u5DF2\u590D\u5236" : "\u7EDF\u8BA1"),
       React.createElement("button", {
         className: "iterate-btn",
@@ -3648,7 +4386,16 @@ ${JSON.stringify({ operation: "clear" }, null, 2)}
           React.createElement(
             "div",
             { className: "iterate-obs-block-body" },
-            React.createElement("div", { className: "iterate-obs-msg" }, "\u9632\u5FA1\u4E8B\u4EF6\u5305\u62EC\uFF1A\u524D\u7F6E\u6821\u9A8C\u5931\u8D25\u3001\u56DE\u6EDA\u3001\u4E0D\u53D8\u91CF\u8FDD\u53CD\u3001\u5047\u8BBE\u88AB\u8BC1\u4F2A\u3002"),
+            React.createElement(
+              "div",
+              { className: "iterate-obs-msg" },
+              diskEmptyStateText(toolCalledInSession(session, "iterate_defense_events"), "\u9632\u5FA1\u4E8B\u4EF6\u6D41")
+            ),
+            React.createElement(
+              "div",
+              { className: "iterate-obs-msg", style: { marginTop: 6 } },
+              "\u9632\u5FA1\u4E8B\u4EF6\u5305\u62EC\uFF1A\u524D\u7F6E\u6821\u9A8C\u5931\u8D25\u3001\u56DE\u6EDA\u3001\u4E0D\u53D8\u91CF\u8FDD\u53CD\u3001\u5047\u8BBE\u88AB\u8BC1\u4F2A\u3002"
+            ),
             React.createElement(
               "div",
               { className: "iterate-obs-bar", style: { marginTop: 8 } },
@@ -3832,6 +4579,11 @@ ${JSON.stringify({ operation: "clear" }, null, 2)}
       React.createElement("span", { className: "iterate-obs-title" }, "iterate \u89C2\u6D4B\u53F0"),
       React.createElement("span", { className: "iterate-obs-badge", "data-live": live ? "" : void 0 }, runStatusText(live, manifest)),
       React.createElement("span", { className: "iterate-obs-head-meta" }, headMeta || "runtime"),
+      // Gap #14: make the tab system discoverable without expanding it.
+      React.createElement("span", {
+        className: "iterate-obs-head-meta",
+        title: OBS_HOTKEY_HINT
+      }, OBS_HOTKEY_HINT),
       React.createElement("button", {
         className: "iterate-btn",
         "data-ghost": "",
@@ -3875,18 +4627,30 @@ ${JSON.stringify({ operation: "clear" }, null, 2)}
           "data-copied": copiedKey === "export" ? "" : void 0,
           onClick: exportObservatory,
           title: "\u5C06\u89C2\u6D4B\u53F0\u5168\u90E8\u6570\u636E\u5BFC\u51FA\u4E3A JSON\uFF08\u4F18\u5148\u4E0B\u8F7D\uFF0C\u5931\u8D25\u5219\u590D\u5236\uFF09"
-        }, copiedKey === "export" ? "\u5DF2\u5BFC\u51FA" : "\u5BFC\u51FA JSON")
+        }, copiedKey === "export" ? "\u5DF2\u5BFC\u51FA" : "\u5BFC\u51FA JSON"),
+        // Gap #4: `.iterate/` artifacts are unreachable from the browser;
+        // this copies the one instruction that makes the model echo them
+        // into the session stream (which is what every panel scans).
+        React.createElement("button", {
+          className: "iterate-btn",
+          "data-copied": copiedKey === "pull-snapshot" ? "" : void 0,
+          onClick: () => copyInstruction("pull-snapshot", pullInstruction),
+          title: pullTitle
+        }, copiedKey === "pull-snapshot" ? "\u5DF2\u590D\u5236" : "\u62C9\u53D6\u78C1\u76D8\u5FEB\u7167")
       ),
       React.createElement(
         "div",
-        { className: "iterate-obs-tabs" },
+        { className: "iterate-obs-tabs", role: "tablist", "aria-label": "\u89C2\u6D4B\u53F0\u9875\u7B7E\uFF08\u5FEB\u6377\u952E 1-9 / 0 / -\uFF09" },
         ...OBS_TABS.map(
           (t) => React.createElement("button", {
             key: t.key,
             className: "iterate-obs-tab",
+            role: "tab",
+            "aria-selected": tab === t.key,
             "data-active": tab === t.key ? "" : void 0,
-            onClick: () => setTab(t.key)
-          }, t.label)
+            onClick: () => setTab(t.key),
+            title: t.hotkey ? `${obsTabLabel(t)}\uFF08\u6309 ${t.hotkey} \u5207\u6362\uFF09` : `${obsTabLabel(t)}\uFF08\u6309 - \u5207\u6362\uFF09`
+          }, obsTabLabel(t))
         )
       ),
       React.createElement("div", { className: "iterate-obs-body" }, renderBody())