alphacouncil-agent 0.9.2 → 0.9.4

package/mcp/lib/markdown.mjs

@@ -3,51 +3,59 @@ import { join } from "node:path";
 import { DEBATE_ROLES, REPORT_SECTIONS } from "./constants.mjs";
 import { writeJson } from "./fsutil.mjs";
 import { headingIncludesAlias, normalizeHeading, parseHeadings } from "./headings.mjs";
-import { isChineseLanguage } from "./lang.mjs";
+import { isChineseLanguage, languageKey, localized } from "./lang.mjs";
 import { sha256 } from "./personas-v3/canonical.mjs";
+import { compiledPersonaPacks } from "./personas-v3/registry.mjs";
 import { bullets, clip, clipAtBoundary, fence } from "./text.mjs";
 import { completenessStatus, validateFinalReport, verificationStatus, withCompletenessBanner, withDisclaimer, withVerificationBanner } from "./gates.mjs";
 import { agentState, appendEvent, artifactPaths, runPath, taskState } from "./run-store.mjs";
 import { personaTitle, registry } from "./personas/registry.mjs";
 
-export function renderPacketMarkdown(packet, index) {
+export function renderPacketMarkdown(packet, index = 0, language = packet?.language) {
+  const key = languageKey(language);
+  const label = {
+    zh: { title: "证据分析子代理", symbol: "代码", asOf: "截至", confidence: "置信度", richness: "信息丰富度", summary: "摘要", claims: "论断", evidence: "证据", sources: "来源", metrics: "指标", questions: "未决问题", raw: "原始 worker 响应（仅供审计）", none: "无" },
+    en: { title: "Evidence Analyst Subagent", symbol: "Symbol", asOf: "As-of", confidence: "Confidence", richness: "Information richness", summary: "Summary", claims: "Claims", evidence: "Evidence", sources: "Sources", metrics: "Metrics", questions: "Open Questions", raw: "Raw Worker Response (audit only)", none: "None" },
+    ja: { title: "証拠分析サブエージェント", symbol: "銘柄コード", asOf: "基準日", confidence: "信頼度", richness: "情報充足度", summary: "要約", claims: "主張", evidence: "根拠", sources: "出典", metrics: "指標", questions: "未解決事項", raw: "ワーカーの生応答（監査専用）", none: "なし" },
+    ko: { title: "증거 분석 하위 에이전트", symbol: "종목 코드", asOf: "기준일", confidence: "신뢰도", richness: "정보 충실도", summary: "요약", claims: "주장", evidence: "근거", sources: "출처", metrics: "지표", questions: "미해결 질문", raw: "원본 워커 응답(감사 전용)", none: "없음" },
+  }[key];
   const claims = packet.claims.length
     ? packet.claims.map((claim, claimIndex) => [
       `${claimIndex + 1}. ${claim.claim || ""}`,
-      `   - Evidence: ${claim.evidence || ""}`,
-      `   - Confidence: ${claim.confidence || "low"}`,
-      `   - Sources: ${(claim.source_ids || []).join(", ") || "None"}`,
+      `   - ${label.evidence}: ${claim.evidence || ""}`,
+      `   - ${label.confidence}: ${claim.confidence || "low"}`,
+      `   - ${label.sources}: ${(claim.source_ids || []).join(", ") || label.none}`,
     ].join("\n")).join("\n")
-    : "No claims.";
+    : `${label.none}.`;
   const sources = packet.sources.length
     ? packet.sources.map((source) => `- ${source.id || "S?"}: ${source.title || ""} (${source.published_at || "unknown"}) ${source.url || ""}`).join("\n")
-    : "- None";
+    : `- ${label.none}`;
   return [
-    `## Evidence Subagent ${index + 1}: ${packet.task}`,
+    `## ${label.title} ${index + 1}: ${packet.task}`,
     "",
-    `- Symbol: ${packet.symbol}`,
-    `- As-of: ${packet.as_of}`,
+    `- ${label.symbol}: ${packet.symbol}`,
+    `- ${label.asOf}: ${packet.as_of}`,
     packet.thread_id ? `- Visible thread ID: ${packet.thread_id}` : "",
     packet.thread_title ? `- Visible thread title: ${packet.thread_title}` : "",
-    `- Confidence: ${packet.confidence}`,
-    `- Information richness: ${packet.information_richness || "unrated"}`,
+    `- ${label.confidence}: ${packet.confidence}`,
+    `- ${label.richness}: ${packet.information_richness || "unrated"}`,
     "",
-    "### Summary",
+    `### ${label.summary}`,
     packet.summary || "",
     "",
-    "### Claims",
+    `### ${label.claims}`,
     claims,
     "",
-    "### Metrics",
+    `### ${label.metrics}`,
     fence(packet.metrics || {}, "json"),
     "",
-    "### Sources",
+    `### ${label.sources}`,
     sources,
     "",
-    "### Open Questions",
+    `### ${label.questions}`,
     bullets(packet.open_questions),
     "",
-    "### Raw Output / Prompt",
+    `### ${label.raw}`,
     fence(packet.raw_text || "", "text"),
   ].join("\n");
 }
@@ -63,35 +71,68 @@ export function renderPacketMarkdown(packet, index) {
 export function renderMasterMarkdown(opinion, lang) {
   if (!opinion) return "";
   const title = masterTitle(opinion.master, lang);
+  const labels = {
+    zh: { statement: "本轮专属方法席发言（不是大师本人引语）", stance: "立场", verdict: "冻结判断", confidence: "置信度", worker: "专属 worker", summary: "方法席说明", findings: "关键发现", disagreements: "与分析师的分歧", disqualifiers: "触发的排除条件", change: "改变判断所需证据", sources: "来源" },
+    en: { statement: "Dedicated Method-Seat Statement (not a quote from the named person)", stance: "Stance", verdict: "Frozen verdict", confidence: "Confidence", worker: "Dedicated worker", summary: "Method-seat explanation", findings: "Key Findings", disagreements: "Disagreements With The Analysts", disqualifiers: "Disqualifiers Triggered", change: "What Would Change The View", sources: "Sources" },
+    ja: { statement: "専用メソッド席の発言（本人の発言・引用ではありません）", stance: "スタンス", verdict: "凍結済み判定", confidence: "信頼度", worker: "専用ワーカー", summary: "メソッド席の説明", findings: "主な所見", disagreements: "分析担当との相違", disqualifiers: "発動した除外条件", change: "判断が変わる条件", sources: "出典" },
+    ko: { statement: "전용 방법론 좌석 발언(본인의 실제 발언이나 인용이 아님)", stance: "입장", verdict: "동결된 판단", confidence: "신뢰도", worker: "전용 워커", summary: "방법론 좌석 설명", findings: "핵심 발견", disagreements: "분석가와의 이견", disqualifiers: "발동된 제외 조건", change: "판단 변경 조건", sources: "출처" },
+  }[languageKey(lang)];
   return [
     `## ${title}`,
     "",
     `- ID: ${opinion.master}`,
-    `- Stance: ${opinion.stance || "unknown"}`,
-    `- Verdict: ${opinion.verdict || ""}`,
-    `- Confidence: ${opinion.confidence || "low"}`,
+    `- ${labels.stance}: ${opinion.stance || "unknown"}`,
+    `- ${labels.verdict}: ${opinion.verdict || ""}`,
+    `- ${labels.confidence}: ${opinion.confidence || "low"}`,
+    `- ${labels.worker}: ${opinion.dedicated_worker?.status || opinion.voice_status || "not_recorded"}${opinion.dedicated_worker?.pid ? ` (pid ${opinion.dedicated_worker.pid})` : ""}`,
     opinion.thread_id ? `- Visible thread ID: ${opinion.thread_id}` : "",
     "",
-    "### Summary",
-    opinion.summary || "",
+    `### ${labels.statement}`,
+    opinion.voice_statement || opinion.summary || "",
     "",
-    "### Key Findings",
+    `### ${labels.summary}`,
+    opinion.deterministic_summary || opinion.summary || "",
+    "",
+    `### ${labels.findings}`,
     bullets(opinion.key_findings),
     "",
-    "### Disagreements With The Analysts",
+    `### ${labels.disagreements}`,
     bullets(opinion.disagreements),
     "",
-    "### Disqualifiers Triggered",
+    `### ${labels.disqualifiers}`,
     bullets(opinion.disqualifiers_triggered),
     "",
-    "### What Would Change My Mind",
+    `### ${labels.change}`,
     bullets(opinion.what_would_change_my_mind),
     "",
-    "### Sources",
+    `### ${labels.sources}`,
     (opinion.source_ids || []).length ? (opinion.source_ids || []).map((id) => `- ${id}`).join("\n") : "- None",
   ].filter((line) => line !== "").join("\n");
 }
 
+function renderMasterStatements(run) {
+  const key = languageKey(run?.language);
+  const heading = { zh: "逐席专属方法输出", en: "Dedicated Method-Seat Outputs", ja: "専用メソッド席ごとの出力", ko: "전용 방법론 좌석별 출력" }[key];
+  const statementLabel = { zh: "本轮发言（不是本人引语）", en: "Recorded statement (not a quote)", ja: "今回の発言（本人の引用ではありません）", ko: "이번 발언(본인 인용이 아님)" }[key];
+  const findingsLabel = { zh: "关键发现", en: "Key findings", ja: "主な所見", ko: "핵심 발견" }[key];
+  const disagreementsLabel = { zh: "与分析师分歧", en: "Disagreements", ja: "分析担当との相違", ko: "분석가와의 이견" }[key];
+  const changeLabel = { zh: "改变判断条件", en: "What would change the view", ja: "判断が変わる条件", ko: "판단 변경 조건" }[key];
+  const sourcesLabel = { zh: "来源或明确缺口", en: "Sources or explicit gaps", ja: "出典または明示的な欠落", ko: "출처 또는 명시적 데이터 공백" }[key];
+  const voiced = (run?.master_opinions || []).filter((opinion) => Boolean(opinion.voice_statement));
+  if (!voiced.length) return "";
+  const items = voiced.map((opinion) => [
+    `### ${masterTitle(opinion.master, run.language)} (\`${opinion.master}\`)`,
+    `- ${key === "zh" ? "立场" : key === "ja" ? "スタンス" : key === "ko" ? "입장" : "Stance"}: ${opinion.stance || "unknown"}`,
+    `- ${key === "zh" ? "专属 worker" : key === "ja" ? "専用ワーカー" : key === "ko" ? "전용 워커" : "Dedicated worker"}: ${opinion.dedicated_worker?.status || opinion.voice_status || "not_recorded"}`,
+    `- ${statementLabel}: ${opinion.voice_statement || opinion.verdict || opinion.summary || ""}`,
+    `- ${findingsLabel}: ${(opinion.key_findings || []).slice(0, 4).join("；") || "—"}`,
+    `- ${disagreementsLabel}: ${(opinion.disagreements || []).slice(0, 3).join("；") || "—"}`,
+    `- ${changeLabel}: ${(opinion.what_would_change_my_mind || []).slice(0, 3).join("；") || "—"}`,
+    `- ${sourcesLabel}: ${(opinion.source_ids || []).join(", ") || (opinion.disqualifiers_triggered || []).join(", ") || "—"}`,
+  ].join("\n")).join("\n\n");
+  return `### ${heading}\n\n${items}`;
+}
+
 /**
  * Printed above every rendered bench, in the report's language.
  *
@@ -110,19 +151,31 @@ export function masterCorrelationNote(run) {
     stances.set(key, (stances.get(key) || 0) + 1);
   }
   const spread = [...stances.entries()].map(([stance, n]) => `${stance}=${n}`).join(", ");
-  const zh = isChineseLanguage(run?.language);
-  return zh
-    ? [
+  const key = languageKey(run?.language);
+  return {
+    zh: [
       "> **这些席位不是独立样本。** 它们共享同一个基础模型、同一份证据简报和同一个上下文，",
       `> 因此错误是相关的。本次立场分布（${spread}）**不能当作票数来计算**：一致本身是预期结果，`,
       "> 不是发现。有信息量的是分歧席位，以及它的分歧来自信息差还是方法差。",
     ].join("\n")
-    : [
+    ,
+    en: [
       "> **These seats are not independent samples.** They share a base model, an evidence",
       `> brief and a context window, so their errors are correlated. The stance spread (${spread})`,
       "> **is not a vote count**: agreement is the expected outcome, not a finding. The",
       "> informative seat is the dissenting one, and why it dissents.",
-    ].join("\n");
+    ].join("\n"),
+    ja: [
+      "> **これらの席は独立標本ではありません。** 同じ基盤モデル、証拠要約、コンテキストを共有するため、",
+      `> 誤りも相関します。立場の分布（${spread}）を**投票数として数えてはいけません**。一致は予想される結果であり、発見ではありません。`,
+      "> 情報量が高いのは反対する席と、その相違が情報差か方法差かという点です。",
+    ].join("\n"),
+    ko: [
+      "> **이 좌석들은 독립 표본이 아닙니다.** 동일한 기반 모델, 증거 요약, 컨텍스트를 공유하므로 오류도 상관되어 있습니다.",
+      `> 입장 분포(${spread})를 **투표수로 계산하면 안 됩니다**. 일치는 예상되는 결과이지 새로운 발견이 아닙니다.`,
+      "> 정보량이 높은 부분은 반대 좌석과 그 차이가 정보 차이인지 방법론 차이인지입니다.",
+    ].join("\n"),
+  }[key];
 }
 
 /**
@@ -137,7 +190,7 @@ export function masterCorrelationNote(run) {
 export function renderBenchSummary(run) {
   const opinions = run?.master_opinions || [];
   if (!opinions.length) return "";
-  const zh = isChineseLanguage(run?.language);
+  const key = languageKey(run?.language);
   const counts = new Map();
   for (const o of opinions) counts.set(o.stance || "unknown", (counts.get(o.stance || "unknown") || 0) + 1);
   const ranked = [...counts.entries()].sort((a, b) => b[1] - a[1]);
@@ -145,19 +198,24 @@ export function renderBenchSummary(run) {
   const minority = opinions.filter((o) => (o.stance || "unknown") !== majority);
   const concurring = opinions.filter((o) => (o.stance || "unknown") === majority);
 
-  const row = (o) => `| ${masterTitle(o.master, run?.language)} (\`${o.master}\`) | ${o.stance || "unknown"} | ${o.confidence || "low"} | ${clip(o.verdict || o.summary || "", 90)} |`;
-  const head = zh
-    ? ["| 方法 | 立场 | 置信度 | 判断 |", "|---|---|---|---|"]
-    : ["| Method | Stance | Confidence | Verdict |", "|---|---|---|---|"];
+  // The table is the frozen deterministic judgment; the dedicated worker statement is
+  // rendered once in the per-seat detail block below. Keeping them separate prevents a
+  // fluent explanation from being mistaken for, or duplicating, the frozen method result.
+  const row = (o) => `| ${masterTitle(o.master, run?.language)} (\`${o.master}\`) | ${o.stance || "unknown"} | ${o.confidence || "low"} | ${clip(o.verdict || o.deterministic_summary || o.summary || o.voice_statement || "", 140)} |`;
+  const copy = {
+    zh: { head: ["| 方法 | 立场 | 置信度 | 判断 |", "|---|---|---|---|"], minority: "### 少数派（先读这个）", minorityNone: "### 少数派：无\n\n所有席位立场一致。鉴于它们共享模型与证据，一致是预期结果而非确认——本轮没有产生任何独立的反对意见。", divergence: `${minority.length} 席与多数不同。分歧席位是本轮信息量最高的部分——请先判断分歧来自信息差还是方法差。`, rest: "### 其余席位" },
+    en: { head: ["| Method | Stance | Confidence | Verdict |", "|---|---|---|---|"], minority: "### Minority report (read this first)", minorityNone: "### Minority report: none\n\nEvery seat agreed. Given a shared model and a shared brief, agreement is the expected outcome rather than confirmation: this run produced no independent dissent.", divergence: `${minority.length} seat(s) diverge. Divergence is the highest-information part of this run: establish whether it comes from the evidence slice or from the method.`, rest: "### Concurring seats" },
+    ja: { head: ["| メソッド | スタンス | 信頼度 | 判定 |", "|---|---|---|---|"], minority: "### 少数意見（最初に読む）", minorityNone: "### 少数意見：なし\n\n全席が一致しました。同じモデルと証拠を共有するため、一致は確認ではなく予想される結果です。本輪では独立した反対意見が出ませんでした。", divergence: `${minority.length}席が多数と異なります。最も情報量が高い部分なので、相違が証拠範囲と方法のどちらに由来するか確認してください。`, rest: "### その他の席" },
+    ko: { head: ["| 방법론 | 입장 | 신뢰도 | 판단 |", "|---|---|---|---|"], minority: "### 소수 의견(먼저 확인)", minorityNone: "### 소수 의견: 없음\n\n모든 좌석이 일치했습니다. 동일한 모델과 증거를 공유하므로 일치는 확인이 아니라 예상되는 결과입니다. 이번 실행에는 독립적인 반대 의견이 없었습니다.", divergence: `${minority.length}개 좌석이 다수와 다릅니다. 가장 정보량이 높은 부분이므로 차이가 증거 범위와 방법론 중 어디에서 비롯됐는지 확인하십시오.`, rest: "### 나머지 좌석" },
+  }[key];
+  const head = copy.head;
 
   const sections = [masterCorrelationNote(run), ""];
   if (minority.length) {
     sections.push(
-      zh ? "### 少数派（先读这个）" : "### Minority report (read this first)",
+      copy.minority,
       "",
-      zh
-        ? `${minority.length} 席与多数不同。分歧席位是本次运行里信息量最高的部分——请先判断分歧来自信息差还是方法差。`
-        : `${minority.length} seat(s) diverge. Divergence is the highest-information part of this run: establish whether it comes from the evidence slice or from the method.`,
+      copy.divergence,
       "",
       ...head,
       ...minority.map(row),
@@ -165,14 +223,12 @@ export function renderBenchSummary(run) {
     );
   } else {
     sections.push(
-      zh
-        ? "### 少数派：无\n\n所有席位立场一致。鉴于它们共享模型与证据，一致是预期结果而非确认——本次运行没有产生任何独立的反对意见。"
-        : "### Minority report: none\n\nEvery seat agreed. Given a shared model and a shared brief, agreement is the expected outcome rather than confirmation: this run produced no independent dissent.",
+      copy.minorityNone,
       "",
     );
   }
   sections.push(
-    zh ? "### 其余席位" : "### Concurring seats",
+    copy.rest,
     "",
     ...head,
     ...concurring.map(row),
@@ -214,6 +270,9 @@ export function renderDecisionTable(decisions, lang) {
 function masterTitle(id, lang) {
   if (!id) return "Master";
   try {
+    const v3 = compiledPersonaPacks().get(id);
+    const v3Title = v3?.admitted_label?.[languageKey(lang)];
+    if (v3Title) return `${v3Title} (${id})`;
     const persona = registry().get(id);
     const title = personaTitle(persona, lang);
     return title && title !== id ? `${title} (${id})` : id;
@@ -222,81 +281,102 @@ function masterTitle(id, lang) {
   }
 }
 
-export function renderDebateRounds(rounds) {
+export function renderDebateRounds(rounds, language = "English") {
   if (!Array.isArray(rounds) || rounds.length === 0) return "";
+  const key = languageKey(language);
+  const label = {
+    zh: { round: "轮次", long: "多头论据", short: "空头论据", questions: "提出的问题", answered: "逐题回答", raw: "原始 worker 响应（仅供审计）", title: "辩论轮次" },
+    en: { round: "Round", long: "Long Thesis", short: "Short Thesis", questions: "Questions", answered: "Questions Answered", raw: "Raw Worker Response (audit only)", title: "Debate Rounds" },
+    ja: { round: "ラウンド", long: "強気論拠", short: "弱気論拠", questions: "質問", answered: "質問への回答", raw: "ワーカーの生応答（監査専用）", title: "討論ラウンド" },
+    ko: { round: "라운드", long: "강세 논거", short: "약세 논거", questions: "질문", answered: "질문별 답변", raw: "원본 워커 응답(감사 전용)", title: "토론 라운드" },
+  }[key];
   const blocks = rounds.map((round) => [
-    `#### Round ${round.round}`,
+    `#### ${label.round} ${round.round}`,
     "",
     round.summary || "",
     "",
-    "##### Long Thesis",
+    `##### ${label.long}`,
     bullets(round.long_thesis),
     "",
-    "##### Short Thesis",
+    `##### ${label.short}`,
     bullets(round.short_thesis),
     "",
-    "##### Questions",
+    `##### ${label.questions}`,
     bullets(round.questions),
     "",
-    "##### Questions Answered",
+    `##### ${label.answered}`,
     bullets(round.questions_answered),
     "",
-    "##### Raw Output / Prompt",
+    `##### ${label.raw}`,
     fence(round.raw_text || "", "text"),
   ].join("\n"));
-  return ["### Debate Rounds", "", ...blocks].join("\n\n");
+  return [`### ${label.title}`, "", ...blocks].join("\n\n");
 }
 
-export function renderDebateMarkdown(agent) {
+export function renderDebateMarkdown(agent, language = agent?.language) {
   if (!agent) return "";
+  const key = languageKey(language);
+  const label = {
+    zh: { rating: "评级", winner: "胜方", verdict: "判断", confidence: "置信度", summary: "摘要", long: "多头论据", short: "空头论据", valuation: "估值区间", catalysts: "催化剂", risks: "风险", position: "仓位", invalidation: "失效条件", sources: "来源 ID", report: "报告正文", raw: "原始 worker 响应（仅供审计）", none: "无" },
+    en: { rating: "Rating", winner: "Winner", verdict: "Verdict", confidence: "Confidence", summary: "Summary", long: "Long Thesis", short: "Short Thesis", valuation: "Valuation Range", catalysts: "Catalysts", risks: "Risks", position: "Position", invalidation: "Invalidation", sources: "Source IDs", report: "Report Markdown", raw: "Raw Worker Response (audit only)", none: "None" },
+    ja: { rating: "評価", winner: "優勢側", verdict: "判断", confidence: "信頼度", summary: "要約", long: "強気論拠", short: "弱気論拠", valuation: "評価レンジ", catalysts: "カタリスト", risks: "リスク", position: "ポジション", invalidation: "無効化条件", sources: "出典 ID", report: "レポート本文", raw: "ワーカーの生応答（監査専用）", none: "なし" },
+    ko: { rating: "등급", winner: "우세 측", verdict: "판단", confidence: "신뢰도", summary: "요약", long: "강세 논거", short: "약세 논거", valuation: "가치평가 범위", catalysts: "촉매", risks: "위험", position: "포지션", invalidation: "무효화 조건", sources: "출처 ID", report: "보고서 본문", raw: "원본 워커 응답(감사 전용)", none: "없음" },
+  }[key];
   return [
     `## ${agent.role}`,
     "",
-    `- Rating: ${agent.rating}`,
-    `- Winner: ${agent.winner}`,
-    `- Verdict: ${agent.verdict}`,
-    `- Confidence: ${agent.confidence}`,
+    `- ${label.rating}: ${agent.rating}`,
+    `- ${label.winner}: ${agent.winner}`,
+    `- ${label.verdict}: ${agent.verdict}`,
+    `- ${label.confidence}: ${agent.confidence}`,
     agent.thread_id ? `- Visible thread ID: ${agent.thread_id}` : "",
     agent.thread_title ? `- Visible thread title: ${agent.thread_title}` : "",
     "",
-    "### Summary",
+    `### ${label.summary}`,
     agent.summary || "",
     "",
-    "### Long Thesis",
+    `### ${label.long}`,
     bullets(agent.long_thesis),
     "",
-    "### Short Thesis",
+    `### ${label.short}`,
     bullets(agent.short_thesis),
     "",
-    "### Valuation Range",
-    agent.valuation_range || "None",
+    `### ${label.valuation}`,
+    agent.valuation_range || label.none,
     "",
-    "### Catalysts",
+    `### ${label.catalysts}`,
     bullets(agent.catalysts),
     "",
-    "### Risks",
+    `### ${label.risks}`,
     bullets(agent.risks),
     "",
-    "### Position",
-    agent.position || "None",
+    `### ${label.position}`,
+    agent.position || label.none,
     "",
-    "### Invalidation",
+    `### ${label.invalidation}`,
     bullets(agent.invalidation),
     "",
-    "### Source IDs",
+    `### ${label.sources}`,
     bullets(agent.source_ids),
     "",
-    "### Report Markdown",
+    `### ${label.report}`,
     agent.report_markdown || "",
     "",
-    renderDebateRounds(agent.debate_rounds),
-    "### Raw Output / Prompt",
+    renderDebateRounds(agent.debate_rounds, language),
+    `### ${label.raw}`,
     fence(agent.raw_text || "", "text"),
   ].filter(Boolean).join("\n");
 }
 
 export function writeAllAgentsMarkdown(run, debate = {}) {
   const dir = runPath(run.run_id);
+  const key = languageKey(run.language);
+  const label = {
+    zh: { title: "全部代理审计追踪", metadata: "运行元数据", runId: "运行 ID", symbol: "代码", asOf: "截至", language: "语言", execution: "执行模式", visibility: "要求可见", dry: "演练", status: "状态", phase: "阶段", started: "开始", updated: "更新", completed: "完成", tasks: "任务", taskStatus: "证据席状态", debateStatus: "辩论席状态", evidence: "证据分析子代理", masters: "方法席", debate: "多空辩论与组合经理", none: "无" },
+    en: { title: "Full Agent Audit Trace", metadata: "Run Metadata", runId: "Run ID", symbol: "Symbol", asOf: "As-of", language: "Language", execution: "Execution mode", visibility: "Visibility required", dry: "Dry run", status: "Status", phase: "Phase", started: "Started", updated: "Updated", completed: "Completed", tasks: "Tasks", taskStatus: "Evidence-Seat Status", debateStatus: "Debate-Seat Status", evidence: "Evidence Analyst Subagents", masters: "Method-Seat Bench", debate: "Bull/Bear Debate and Portfolio Manager", none: "None" },
+    ja: { title: "全エージェント監査トレース", metadata: "実行メタデータ", runId: "実行 ID", symbol: "銘柄コード", asOf: "基準日", language: "言語", execution: "実行モード", visibility: "可視性要件", dry: "ドライラン", status: "状態", phase: "フェーズ", started: "開始", updated: "更新", completed: "完了", tasks: "タスク", taskStatus: "証拠席の状態", debateStatus: "討論席の状態", evidence: "証拠分析サブエージェント", masters: "メソッド席", debate: "強気・弱気討論とポートフォリオ管理者", none: "なし" },
+    ko: { title: "전체 에이전트 감사 추적", metadata: "실행 메타데이터", runId: "실행 ID", symbol: "종목 코드", asOf: "기준일", language: "언어", execution: "실행 모드", visibility: "가시성 요구", dry: "드라이런", status: "상태", phase: "단계", started: "시작", updated: "갱신", completed: "완료", tasks: "작업", taskStatus: "증거 좌석 상태", debateStatus: "토론 좌석 상태", evidence: "증거 분석 하위 에이전트", masters: "방법론 좌석", debate: "강세·약세 토론 및 포트폴리오 관리자", none: "없음" },
+  }[key];
   const taskStatus = run.tasks.map((task) => {
     const state = taskState(run, task);
     return `- ${task}: ${state.status}${state.output ? ` (${state.output})` : ""}${state.error ? ` - ${state.error}` : ""}`;
@@ -306,41 +386,41 @@ export function writeAllAgentsMarkdown(run, debate = {}) {
     return `- ${role}: ${state.status}${state.output ? ` (${state.output})` : ""}${state.error ? ` - ${state.error}` : ""}`;
   }).join("\n");
   const sections = [
-    `# AlphaCouncil Agent Full Agent Trace: ${run.symbol}`,
+    `# AlphaCouncil Agent ${label.title}: ${run.symbol}`,
     "",
-    "## Run Metadata",
+    `## ${label.metadata}`,
     "",
-    `- Run ID: ${run.run_id}`,
-    `- Symbol: ${run.symbol}`,
-    `- As-of: ${run.as_of}`,
-    `- Language: ${run.language || "auto"}`,
-    `- Execution mode: ${run.execution_mode || "background_codex_exec"}`,
-    `- Visibility required: ${run.visibility_required || false}`,
-    `- Dry run: ${run.dry_run}`,
-    `- Status: ${run.status || "unknown"}`,
-    `- Phase: ${run.phase || "unknown"}`,
-    `- Started: ${run.started_at}`,
-    `- Updated: ${run.updated_at || ""}`,
-    `- Completed: ${run.completed_at || ""}`,
-    `- Tasks: ${run.tasks.join(", ")}`,
+    `- ${label.runId}: ${run.run_id}`,
+    `- ${label.symbol}: ${run.symbol}`,
+    `- ${label.asOf}: ${run.as_of}`,
+    `- ${label.language}: ${run.language || "auto"}`,
+    `- ${label.execution}: ${run.execution_mode || "background_codex_exec"}`,
+    `- ${label.visibility}: ${run.visibility_required || false}`,
+    `- ${label.dry}: ${run.dry_run}`,
+    `- ${label.status}: ${run.status || "unknown"}`,
+    `- ${label.phase}: ${run.phase || "unknown"}`,
+    `- ${label.started}: ${run.started_at}`,
+    `- ${label.updated}: ${run.updated_at || ""}`,
+    `- ${label.completed}: ${run.completed_at || ""}`,
+    `- ${label.tasks}: ${run.tasks.join(", ")}`,
     "",
-    "## Task Status",
+    `## ${label.taskStatus}`,
     "",
-    taskStatus || "- None",
+    taskStatus || `- ${label.none}`,
     "",
-    "## Analyst Status",
+    `## ${label.debateStatus}`,
     "",
-    agentStatus || "- None",
+    agentStatus || `- ${label.none}`,
     "",
-    "# Evidence Subagents",
+    `# ${label.evidence}`,
     "",
-    ...run.packets.map(renderPacketMarkdown),
+    ...run.packets.map((packet, index) => renderPacketMarkdown(packet, index, run.language)),
   ];
   const opinions = run.master_opinions || [];
   if (opinions.length) {
     sections.push(
       "",
-      "# Master Bench",
+      `# ${label.masters}`,
       "",
       renderBenchSummary(run),
       "",
@@ -350,13 +430,13 @@ export function writeAllAgentsMarkdown(run, debate = {}) {
   if (debate.bull || debate.bear || debate.manager) {
     sections.push(
       "",
-      "# Analyst Debate And Portfolio Manager",
+      `# ${label.debate}`,
       "",
-      renderDebateMarkdown(debate.bull),
+      renderDebateMarkdown(debate.bull, run.language),
       "",
-      renderDebateMarkdown(debate.bear),
+      renderDebateMarkdown(debate.bear, run.language),
       "",
-      renderDebateMarkdown(debate.manager),
+      renderDebateMarkdown(debate.manager, run.language),
     );
   }
   const path = join(dir, "all_agents.md");
@@ -367,7 +447,7 @@ export function writeAllAgentsMarkdown(run, debate = {}) {
 export function writeAnalystMarkdownFiles(run, debate = {}) {
   const dir = runPath(run.run_id);
   for (const [index, packet] of (run.packets || []).entries()) {
-    writeFileSync(join(dir, `${packet.task}.md`), `${renderPacketMarkdown(packet, index)}\n`);
+    writeFileSync(join(dir, `${packet.task}.md`), `${renderPacketMarkdown(packet, index, run.language)}\n`);
   }
   const debateFiles = [
     ["bull_researcher", debate.bull],
@@ -375,7 +455,7 @@ export function writeAnalystMarkdownFiles(run, debate = {}) {
     ["portfolio_manager", debate.manager],
   ];
   for (const [role, packet] of debateFiles) {
-    if (packet) writeFileSync(join(dir, `${role}.md`), `${renderDebateMarkdown({ ...packet, role })}\n`);
+    if (packet) writeFileSync(join(dir, `${role}.md`), `${renderDebateMarkdown({ ...packet, role }, run.language)}\n`);
   }
   for (const opinion of run.master_opinions || []) {
     writeFileSync(join(dir, `${opinion.master}.md`), `${renderMasterMarkdown(opinion, run.language)}\n`);
@@ -398,6 +478,8 @@ function recordedBenchMarker(run) {
     stance: String(opinion?.stance || "unknown"),
     summary: String(opinion?.summary || ""),
     verdict: String(opinion?.verdict || ""),
+    voice_statement: String(opinion?.voice_statement || ""),
+    voice_status: String(opinion?.voice_status || ""),
   }));
   return `<!-- ${RECORDED_BENCH_MARKER_PREFIX}${sha256(subject)} -->`;
 }
@@ -422,12 +504,18 @@ function withRecordedMasterBench(run, markdown) {
   const lines = body.split(/\r?\n/);
   const headings = parseHeadings(body);
   const removals = [];
-  const commentaryTitle = isChineseLanguage(run.language)
-    ? "PM 对方法席位的叙述（非系统记录）"
-    : "PM Commentary on Method Seats (non-authoritative)";
+  const commentaryTitle = localized(run.language, {
+    zh: "PM 对方法席位的叙述（非系统记录）",
+    en: "PM Commentary on Method Seats (non-authoritative)",
+    ja: "PMによるメソッド席の説明（非公式記録）",
+    ko: "PM의 방법론 좌석 설명(비공식 기록)",
+  });
 
   for (const [index, heading] of headings.entries()) {
-    if (!isMasterBenchHeading(heading.title)) continue;
+    // Only a publication section can own the bench. Localized per-seat subheadings such as
+    // Japanese "メソッド席" may contain a bench alias, but they are level 3+ details and
+    // must not be scheduled for a second overlapping removal during idempotent assembly.
+    if (heading.level > 2 || !isMasterBenchHeading(heading.title)) continue;
     const next = headings.slice(index + 1).find((candidate) => candidate.level <= heading.level);
     const start = heading.line - 1;
     const end = next ? next.line - 1 : lines.length;
@@ -442,11 +530,52 @@ function withRecordedMasterBench(run, markdown) {
     lines.splice(start, end - start);
   }
   const cleaned = lines.join("\n").trimEnd();
-  const heading = isChineseLanguage(run.language) ? "## 大师席位 / Master Bench" : "## Master Bench";
-  const systemBench = `${heading}\n\n${recordedBenchMarker(run)}\n\n${renderBenchSummary(run)}`;
+  const heading = localized(run.language, {
+    zh: "## 大师席位",
+    en: "## Master Bench",
+    ja: "## マスター・ベンチ",
+    ko: "## 마스터 벤치",
+  });
+  const systemBench = `${heading}\n\n${recordedBenchMarker(run)}\n\n${renderBenchSummary(run)}\n\n${renderMasterStatements(run)}`;
   return `${cleaned ? `${cleaned}\n\n` : ""}${systemBench}\n`;
 }
 
+function withRecordedPriceSnapshot(run, markdown) {
+  const markerStart = "<!-- alphacouncil:recorded-price-snapshot:v1:begin -->";
+  const markerEnd = "<!-- alphacouncil:recorded-price-snapshot:v1:end -->";
+  let cleaned = String(markdown || "");
+  let start = cleaned.indexOf(markerStart);
+  while (start !== -1) {
+    const end = cleaned.indexOf(markerEnd, start + markerStart.length);
+    cleaned = end === -1
+      ? cleaned.slice(0, start)
+      : `${cleaned.slice(0, start)}${cleaned.slice(end + markerEnd.length)}`;
+    start = cleaned.indexOf(markerStart);
+  }
+  const quote = run?.grounding?.quote;
+  const key = languageKey(run?.language);
+  const heading = { zh: "## 系统记录价格快照", en: "## System-Recorded Price Snapshot", ja: "## システム記録価格スナップショット", ko: "## 시스템 기록 가격 스냅샷" }[key];
+  const unavailable = { zh: "本轮未取得可验证报价；不得补造价格。", en: "No verifiable quote was retrieved; no price was invented.", ja: "検証可能な価格を取得できなかったため、価格は補完していません。", ko: "검증 가능한 시세를 가져오지 못했으며 가격을 임의로 만들지 않았습니다." }[key];
+  const label = {
+    zh: { symbol: "代码", price: "价格", change: "涨跌", time: "报价时间", exchange: "交易所", feed: "数据源", source: "原始链接", unknown: "未知", unavailable: "不可用", delayed: "延迟数据" },
+    en: { symbol: "Symbol", price: "Price", change: "Change", time: "Quote time", exchange: "Exchange", feed: "Feed", source: "Source", unknown: "unknown", unavailable: "unavailable", delayed: "delayed data" },
+    ja: { symbol: "銘柄コード", price: "価格", change: "騰落", time: "価格時刻", exchange: "取引所", feed: "データ源", source: "原典リンク", unknown: "不明", unavailable: "取得不可", delayed: "遅延データ" },
+    ko: { symbol: "종목 코드", price: "가격", change: "등락", time: "시세 시각", exchange: "거래소", feed: "데이터 소스", source: "원문 링크", unknown: "알 수 없음", unavailable: "확인 불가", delayed: "지연 데이터" },
+  }[key];
+  const body = quote && Number.isFinite(Number(quote.price))
+    ? [
+      `- ${label.symbol}: ${quote.symbol || run.symbol}`,
+      `- ${label.price}: ${quote.price} ${quote.currency || ""}`.trimEnd(),
+      `- ${label.change}: ${quote.change ?? label.unavailable} (${quote.change_pct ?? label.unavailable}%)`,
+      `- ${label.time}: ${quote.quote_time || label.unknown}`,
+      `- ${label.exchange}: ${quote.exchange || label.unknown}`,
+      `- ${label.feed}: ${quote.source || label.unknown}; ${quote.note || label.delayed}`,
+      `- ${label.source}: ${quote.source_url || label.unavailable}`,
+    ].join("\n")
+    : `- ${unavailable}`;
+  return `${cleaned.trimEnd()}\n\n${markerStart}\n${heading}\n\n${body}\n${markerEnd}\n`;
+}
+
 function withDegradedLedger(run, markdown, completeness) {
   const markerStart = "<!-- alphacouncil:degraded-ledger:v1:begin -->";
   const markerEnd = "<!-- alphacouncil:degraded-ledger:v1:end -->";
@@ -462,20 +591,27 @@ function withDegradedLedger(run, markdown, completeness) {
   const tasks = completeness.degraded_evidence || [];
   const roles = completeness.degraded_debate || [];
   if (!tasks.length && !roles.length) return cleaned;
-  const chinese = isChineseLanguage(run.language);
+  const key = languageKey(run.language);
+  const unavailable = { zh: "证据不可用", en: "evidence unavailable", ja: "証拠を取得できません", ko: "증거를 확보하지 못함" }[key];
+  const debateUnavailable = { zh: "辩论席不可用", en: "debate seat unavailable", ja: "討論席を利用できません", ko: "토론 좌석을 사용할 수 없음" }[key];
+  const deadlineText = { zh: "全局时限耗尽", en: "global deadline exhausted", ja: "全体期限を超過", ko: "전체 기한 소진" }[key];
   const rows = [
     ...tasks.map((task) => {
       const state = taskState(run, task);
-      return `- ${task}: ${state.status}; ${state.error || (chinese ? "证据不可用" : "evidence unavailable")}${state.deadline_exhausted ? "; global deadline exhausted" : ""}`;
+      return `- ${task}: ${state.status}; ${state.error || unavailable}${state.deadline_exhausted ? `; ${deadlineText}` : ""}`;
     }),
     ...roles.map((role) => {
       const state = agentState(run, role);
-      return `- ${role}: ${state.status}; ${state.error || (chinese ? "辩论席不可用" : "debate seat unavailable")}`;
+      return `- ${role}: ${state.status}; ${state.error || debateUnavailable}`;
     }),
   ].join("\n");
-  const banner = chinese
-    ? `> [!WARNING]\n> **DEGRADED QUICK RUN — 部分席位失败。** 报告结构可能通过质量检查，但以下席位没有提供可用证据，不能把本轮当作完整覆盖：\n>\n${rows.split("\n").map((line) => `> ${line}`).join("\n")}`
-    : `> [!WARNING]\n> **DEGRADED QUICK RUN — one or more seats failed.** The report structure may pass quality checks, but the following seats supplied no usable evidence and this run is not full coverage:\n>\n${rows.split("\n").map((line) => `> ${line}`).join("\n")}`;
+  const intro = {
+    zh: "**QUICK 运行已降级——一个或多个席位失败。** 报告结构可能通过质量检查，但下列席位没有提供可用证据；本轮不代表完整覆盖：",
+    en: "**DEGRADED QUICK RUN — one or more seats failed.** The report structure may pass quality checks, but the following seats supplied no usable evidence and this run is not full coverage:",
+    ja: "**QUICK 実行は縮退しました——1つ以上の席が失敗しました。** レポート構造が品質検査を通っても、次の席は利用可能な証拠を提供していないため、完全な網羅ではありません：",
+    ko: "**QUICK 실행 성능 저하—하나 이상의 좌석이 실패했습니다.** 보고서 구조가 품질 검사를 통과해도 다음 좌석은 사용 가능한 증거를 제공하지 않았으므로 전체 범위를 대표하지 않습니다:",
+  }[key];
+  const banner = `> [!WARNING]\n> ${intro}\n>\n${rows.split("\n").map((line) => `> ${line}`).join("\n")}`;
   return `${markerStart}\n${banner}\n${markerEnd}\n\n${cleaned.trimStart()}`;
 }
 
@@ -492,16 +628,23 @@ function withQuickScope(run, markdown) {
     start = cleaned.indexOf(markerStart);
   }
   if (run.council_mode !== "quick") return cleaned;
-  const banner = isChineseLanguage(run.language)
-    ? "> [!NOTE]\n> **QUICK_V1 范围。** 本轮不是 full council：固定 4 个核心证据席、1–4 个方法席、一次并行多空陈述和短 PM；没有三轮交叉问答或对抗 verifier。`full_council_equivalent=false`。"
-    : "> [!NOTE]\n> **QUICK_V1 SCOPE.** This is not a full council: four fixed core evidence seats, one to four method seats, one parallel bull/bear statement and a short PM; no three-round cross-exam or adversarial verifier. `full_council_equivalent=false`.";
+  const copy = {
+    zh: "**QUICK_V1 范围。** 本轮不是 full council：固定 4 个核心证据席、1–4 个方法席、一次并行多空陈述和短 PM；没有三轮交叉问答或对抗核验。`full_council_equivalent=false`。",
+    en: "**QUICK_V1 SCOPE.** This is not a full council: four fixed core evidence seats, one to four method seats, one parallel bull/bear statement and a short PM; no three-round cross-exam or adversarial verifier. `full_council_equivalent=false`.",
+    ja: "**QUICK_V1 の範囲。** full council ではありません。固定4つの中核証拠席、1〜4のメソッド席、強気・弱気の並列1ラウンド、短いPMのみで、3ラウンドの交差質問や対抗検証はありません。`full_council_equivalent=false`。",
+    ko: "**QUICK_V1 범위.** full council이 아닙니다. 고정된 4개 핵심 증거 좌석, 1~4개 방법론 좌석, 병렬 강세·약세 1라운드와 짧은 PM만 실행하며 3라운드 교차 질문이나 적대적 검증은 없습니다. `full_council_equivalent=false`.",
+  }[languageKey(run.language)];
+  const banner = `> [!NOTE]\n> ${copy}`;
   return `${markerStart}\n${banner}\n${markerEnd}\n\n${cleaned.trimStart()}`;
 }
 
 export function finalReportMarkdown(run, manager) {
   const gate = verificationStatus(run);
   const completeness = completenessStatus(run);
-  const reportBody = withRecordedMasterBench(run, manager.report_markdown || manager.summary);
+  const reportBody = withRecordedPriceSnapshot(
+    run,
+    withRecordedMasterBench(run, manager.report_markdown || manager.summary),
+  );
   return withDisclaimer(
     withCompletenessBanner(
       withQuickScope(
@@ -517,33 +660,40 @@ export function finalReportMarkdown(run, manager) {
 
 export function writeArtifactIndex(run, debate = {}) {
   const artifacts = artifactPaths(run);
+  const key = languageKey(run.language);
+  const label = {
+    zh: { title: "AlphaCouncil 工件索引", run: "运行 ID", status: "状态", quality: "报告质量", main: "主要文件", final: "最终报告", handoff: "聊天交接摘要", trace: "全部代理审计追踪", evidence: "证据 JSON", decision: "决策 JSON", sources: "来源清单", statusFile: "状态", events: "事件", qualityFile: "报告质量", analysts: "分析师 Markdown 文件", masters: "方法席 Markdown 文件" },
+    en: { title: "AlphaCouncil Artifact Index", run: "Run ID", status: "Status", quality: "Report quality", main: "Main Files", final: "Final report", handoff: "Chat handoff summary", trace: "Full agent audit trace", evidence: "Evidence JSON", decision: "Decision JSON", sources: "Source manifest", statusFile: "Status", events: "Events", qualityFile: "Report quality", analysts: "Analyst Markdown Files", masters: "Method-Seat Markdown Files" },
+    ja: { title: "AlphaCouncil 成果物索引", run: "実行 ID", status: "状態", quality: "レポート品質", main: "主要ファイル", final: "最終レポート", handoff: "チャット引継ぎ要約", trace: "全エージェント監査トレース", evidence: "証拠 JSON", decision: "判断 JSON", sources: "出典一覧", statusFile: "状態", events: "イベント", qualityFile: "レポート品質", analysts: "分析担当 Markdown ファイル", masters: "メソッド席 Markdown ファイル" },
+    ko: { title: "AlphaCouncil 산출물 색인", run: "실행 ID", status: "상태", quality: "보고서 품질", main: "주요 파일", final: "최종 보고서", handoff: "채팅 인계 요약", trace: "전체 에이전트 감사 추적", evidence: "증거 JSON", decision: "판단 JSON", sources: "출처 목록", statusFile: "상태", events: "이벤트", qualityFile: "보고서 품질", analysts: "분석가 Markdown 파일", masters: "방법론 좌석 Markdown 파일" },
+  }[key];
   const lines = [
-    `# ${run.symbol} AlphaCouncil Artifacts`,
+    `# ${run.symbol} ${label.title}`,
     "",
-    `- Run ID: ${run.run_id}`,
-    `- Status: ${run.status}`,
-    `- Report quality: ${run.report_quality?.status || "not_checked"}`,
+    `- ${label.run}: ${run.run_id}`,
+    `- ${label.status}: ${run.status}`,
+    `- ${label.quality}: ${run.report_quality?.status || "not_checked"}`,
     "",
-    "## Main Files",
+    `## ${label.main}`,
     "",
-    `- Final report: ${artifacts.final_report_md}`,
-    `- Chat handoff summary: ${artifacts.user_response_md}`,
-    `- Full agent trace: ${artifacts.all_agents_md}`,
-    `- Evidence JSON: ${artifacts.evidence_json}`,
-    `- Decision JSON: ${artifacts.decision_json}`,
-    `- Source manifest: ${artifacts.source_manifest_json}`,
-    `- Status: ${artifacts.status_json}`,
-    `- Events: ${artifacts.events_jsonl}`,
-    `- Report quality: ${artifacts.report_quality_json}`,
+    `- ${label.final}: ${artifacts.final_report_md}`,
+    `- ${label.handoff}: ${artifacts.user_response_md}`,
+    `- ${label.trace}: ${artifacts.all_agents_md}`,
+    `- ${label.evidence}: ${artifacts.evidence_json}`,
+    `- ${label.decision}: ${artifacts.decision_json}`,
+    `- ${label.sources}: ${artifacts.source_manifest_json}`,
+    `- ${label.statusFile}: ${artifacts.status_json}`,
+    `- ${label.events}: ${artifacts.events_jsonl}`,
+    `- ${label.qualityFile}: ${artifacts.report_quality_json}`,
     "",
-    "## Analyst Markdown Files",
+    `## ${label.analysts}`,
     "",
     ...(run.tasks || []).map((task) => `- ${task}: ${artifacts.analyst_markdown[task]}`),
     debate.bull ? `- bull_researcher: ${artifacts.analyst_markdown.bull_researcher}` : "",
     debate.bear ? `- bear_researcher: ${artifacts.analyst_markdown.bear_researcher}` : "",
     debate.manager ? `- portfolio_manager: ${artifacts.analyst_markdown.portfolio_manager}` : "",
     ...((run.master_opinions || []).length
-      ? ["", "## Master Bench Markdown Files", "",
+      ? ["", `## ${label.masters}`, "",
         ...(run.master_opinions || []).map((o) => `- ${o.master} (${o.stance || "unknown"}): ${join(runPath(run.run_id), `${o.master}.md`)}`)]
       : []),
   ].filter(Boolean);
@@ -559,7 +709,7 @@ function quickUserResponse(run, manager, artifacts, chinese) {
   const managerCompleted = agentState(run, "portfolio_manager").status === "completed"
     && manager?.decision_available !== false;
   const masters = (run.master_opinions || []).map((opinion) =>
-    `- ${masterTitle(opinion.master, run.language)} (\`${opinion.master}\`) — ${opinion.stance || "unknown"}, ${opinion.confidence || "low"}: ${clipAtBoundary(opinion.verdict || opinion.summary, 360)}`,
+    `- ${masterTitle(opinion.master, run.language)} (\`${opinion.master}\`) — ${opinion.stance || "unknown"}, ${opinion.confidence || "low"}: ${clipAtBoundary(opinion.voice_statement || opinion.summary || opinion.verdict, 360)}`,
   ).join("\n") || (chinese ? "- 没有已记录的方法席结论。" : "- No recorded method-seat conclusion.");
   const analysts = (run.tasks || []).map((task) => {
     const packet = (run.packets || []).find((item) => item.task === task);
@@ -670,7 +820,7 @@ function quickUserResponse(run, manager, artifacts, chinese) {
   ].join("\n");
 }
 
-export function userResponseMarkdown(run, manager) {
+function legacyUserResponseMarkdown(run, manager) {
   const chinese = isChineseLanguage(run.language);
   const artifacts = artifactPaths(run);
   const decisionAvailable = manager?.decision_available !== false;
@@ -732,6 +882,165 @@ export function userResponseMarkdown(run, manager) {
   ].join("\n");
 }
 
+function handoffCopy(language) {
+  return {
+    zh: {
+      title: "AlphaCouncil 运行摘要", status: "运行状态与时限", statusLabel: "状态", contract: "报告契约", scope: "执行范围", elapsed: "耗时", deadline: "硬截止时间", deadlineMet: "是否在截止前落盘",
+      fullScope: "full_v2：8 个证据席、每个已选方法席的专属 worker、三轮多空交叉问答和 PM；插件托管运行硬上限 30 分钟。", quickScope: "quick_v1：4 个证据席、1–4 个方法席、单轮多空和短 PM；不等同 full council。",
+      price: "系统记录价格", noPrice: "未取得可验证报价；没有补造价格。", delayed: "延迟行情", conclusion: "结论", rating: "评级", winner: "多空胜负", confidence: "置信度", judgment: "判断", noDecision: "NEEDS_MANAGER_REVIEW；工具或 PM 失败不能转换成投资评级。",
+      masters: "逐席大神方法输出（不是本人引语）", analysts: "分析师逐席内容", worker: "专属代理", key: "关键内容", earnings: "最新财报", forward: "前瞻门槛", news: "新闻/行业信号", recentNews: "近期公司与行业新闻", newsSummary: "新闻席摘要", noDatedNews: "本轮没有取得 as_of 之前 120 天内且带日期的新闻来源。", newsExcluded: "新闻时间门禁排除", valuation: "估值/价位", position: "仓位", gaps: "数据缺口与失败席", invalidation: "失效条件", files: "文件位置", report: "完整报告", index: "代理工件索引", trace: "全部代理追踪", quality: "报告质量检查", missing: "未覆盖。", noGaps: "未记录额外缺口。", noInvalidation: "没有正式失效条件。",
+    },
+    en: {
+      title: "AlphaCouncil Run Summary", status: "Run Status and Deadline", statusLabel: "Status", contract: "Report contract", scope: "Execution scope", elapsed: "Elapsed", deadline: "Hard deadline", deadlineMet: "Persisted before deadline",
+      fullScope: "full_v2: eight evidence seats, one dedicated worker per selected method, three-round cross-examination and PM; plugin-managed runs have a hard thirty-minute ceiling.", quickScope: "quick_v1: four evidence seats, one to four method seats, one debate round and short PM; not equivalent to full council.",
+      price: "System-Recorded Price", noPrice: "No verifiable quote was retrieved; no price was invented.", delayed: "delayed quote", conclusion: "Conclusion", rating: "Rating", winner: "Debate winner", confidence: "Confidence", judgment: "Judgment", noDecision: "NEEDS_MANAGER_REVIEW; a tool or PM failure cannot be converted into an investment rating.",
+      masters: "Recorded Method-Seat Statements (not quotes from the named people)", analysts: "Analyst Views by Seat", worker: "dedicated worker", key: "Key Content", earnings: "Latest earnings", forward: "Forward thresholds", news: "News / industry signal", recentNews: "Recent Company and Industry News", newsSummary: "News-seat summary", noDatedNews: "No dated news source inside the 120 days through as_of was retrieved.", newsExcluded: "Recent-news gate excluded", valuation: "Valuation / price range", position: "Position", gaps: "Data Gaps and Failed Seats", invalidation: "Invalidation", files: "File Locations", report: "Full report", index: "Agent artifact index", trace: "Full agent trace", quality: "Report quality check", missing: "Not covered.", noGaps: "No additional gap was recorded.", noInvalidation: "No formal invalidation conditions are available.",
+    },
+    ja: {
+      title: "AlphaCouncil 実行サマリー", status: "実行状況と期限", statusLabel: "状態", contract: "レポート契約", scope: "実行範囲", elapsed: "所要時間", deadline: "ハード期限", deadlineMet: "期限内に保存", fullScope: "full_v2：8つの証拠席、選択した各メソッド専用ワーカー、3ラウンドの多空質疑、PM。プラグイン管理実行は30分で必ず終端状態になります。", quickScope: "quick_v1：4つの証拠席、1–4のメソッド席、1ラウンドの多空議論、短いPM。full council相当ではありません。", price: "システム記録価格", noPrice: "検証可能な価格を取得できず、価格は補完していません。", delayed: "遅延価格", conclusion: "結論", rating: "評価", winner: "勝者", confidence: "信頼度", judgment: "判断", noDecision: "NEEDS_MANAGER_REVIEW。ツールまたはPMの失敗を投資評価に変換できません。", masters: "メソッド席ごとの記録（本人の発言・引用ではありません）", analysts: "分析担当ごとの内容", worker: "専用ワーカー", key: "主要内容", earnings: "直近決算", forward: "先行条件", news: "ニュース・業界シグナル", recentNews: "直近の企業・業界ニュース", newsSummary: "ニュース席の要約", noDatedNews: "as_of までの120日間にある日付付きニュース出典を取得できませんでした。", newsExcluded: "ニュース時刻ゲートで除外", valuation: "評価レンジ・価格条件", position: "ポジション", gaps: "データ欠落と失敗した席", invalidation: "無効化条件", files: "ファイル", report: "完全レポート", index: "代理成果物一覧", trace: "全代理トレース", quality: "レポート品質検査", missing: "未取得。", noGaps: "追加の欠落は記録されていません。", noInvalidation: "正式な無効化条件はありません。",
+    },
+    ko: {
+      title: "AlphaCouncil 실행 요약", status: "실행 상태 및 기한", statusLabel: "상태", contract: "보고서 계약", scope: "실행 범위", elapsed: "소요 시간", deadline: "하드 기한", deadlineMet: "기한 내 저장", fullScope: "full_v2: 8개 증거 좌석, 선택된 각 방법론 전용 워커, 3라운드 롱/숏 질의응답, PM. 플러그인 관리 실행은 30분 안에 반드시 종단 상태가 됩니다.", quickScope: "quick_v1: 4개 증거 좌석, 1–4개 방법론 좌석, 단일 롱/숏 라운드, 짧은 PM. full council과 동등하지 않습니다.", price: "시스템 기록 가격", noPrice: "검증 가능한 시세를 가져오지 못했으며 가격을 임의로 만들지 않았습니다.", delayed: "지연 시세", conclusion: "결론", rating: "등급", winner: "토론 승자", confidence: "신뢰도", judgment: "판단", noDecision: "NEEDS_MANAGER_REVIEW. 도구 또는 PM 실패를 투자 등급으로 바꿀 수 없습니다.", masters: "방법론 좌석별 기록(본인의 실제 발언이나 인용이 아님)", analysts: "분석가 좌석별 내용", worker: "전용 워커", key: "핵심 내용", earnings: "최근 실적", forward: "선행 조건", news: "뉴스·산업 신호", recentNews: "최근 기업 및 산업 뉴스", newsSummary: "뉴스 좌석 요약", noDatedNews: "as_of까지 120일 이내의 날짜가 있는 뉴스 출처를 확보하지 못했습니다.", newsExcluded: "뉴스 시간 게이트에서 제외", valuation: "가치평가 범위·가격 조건", position: "포지션", gaps: "데이터 공백 및 실패 좌석", invalidation: "무효화 조건", files: "파일 위치", report: "전체 보고서", index: "에이전트 산출물 색인", trace: "전체 에이전트 추적", quality: "보고서 품질 검사", missing: "미확보.", noGaps: "추가 공백이 기록되지 않았습니다.", noInvalidation: "공식 무효화 조건이 없습니다.",
+    },
+  }[languageKey(language)];
+}
+
+function localizedFailure(error, language) {
+  const value = String(error || "");
+  const key = languageKey(language);
+  const labels = {
+    zh: { parse_failed: "返回格式无法修复", timeout: "超时", timed_out: "超时", global_deadline: "全局时限耗尽", qna_incomplete: "问答不完整", unexpected_error: "意外工具错误", failed: "子代理未成功返回", skipped: "因上游门禁未运行", degraded: "降级", pending: "尚未运行", missing: "缺失" },
+    en: { parse_failed: "response format could not be repaired", timeout: "timed out", timed_out: "timed out", global_deadline: "global deadline exhausted", qna_incomplete: "Q&A was incomplete", unexpected_error: "unexpected tool error", failed: "subagent did not return successfully", skipped: "not run because an upstream gate failed", degraded: "degraded", pending: "not started", missing: "missing" },
+    ja: { parse_failed: "応答形式を修復できませんでした", timeout: "タイムアウト", timed_out: "タイムアウト", global_deadline: "全体期限を超過", qna_incomplete: "質疑応答が不完全", unexpected_error: "予期しないツールエラー", failed: "サブエージェントが正常に応答しませんでした", skipped: "上流ゲートの失敗により未実行", degraded: "縮退", pending: "未開始", missing: "欠落" },
+    ko: { parse_failed: "응답 형식을 복구하지 못함", timeout: "시간 초과", timed_out: "시간 초과", global_deadline: "전체 기한 소진", qna_incomplete: "질의응답 불완전", unexpected_error: "예기치 않은 도구 오류", failed: "하위 에이전트가 정상 응답하지 못함", skipped: "상위 게이트 실패로 실행하지 않음", degraded: "성능 저하", pending: "시작 전", missing: "누락" },
+  }[key];
+  if (value.startsWith("exit code")) return labels.failed;
+  if (value.includes("gate_failed") || value.startsWith("global_deadline_before")) return labels.skipped;
+  return labels[value] || labels.missing;
+}
+
+function recentNewsHandoff(run, copy) {
+  const packet = (run.packets || []).find((item) => item.task === "news_industry_management");
+  const asOfTime = Date.parse(`${String(run.as_of || "").slice(0, 10)}T23:59:59.999Z`);
+  const cutoff = Number.isFinite(asOfTime) ? asOfTime - (120 * 24 * 60 * 60 * 1000) : -Infinity;
+  const excluded = { undated: 0, future: 0, stale: 0 };
+  const eligible = (packet?.sources || []).filter((source) => {
+    const published = Date.parse(source?.published_at || "");
+    if (!Number.isFinite(published)) { excluded.undated += 1; return false; }
+    if (Number.isFinite(asOfTime) && published > asOfTime) { excluded.future += 1; return false; }
+    if (Number.isFinite(asOfTime) && published < cutoff) { excluded.stale += 1; return false; }
+    return true;
+  }).sort((a, b) => String(b.published_at || "").localeCompare(String(a.published_at || ""))).slice(0, 6);
+  const sources = eligible.length
+    ? eligible.map((source) => `- ${source.published_at} — ${clipAtBoundary(source.title || "", 240)}${source.url ? ` — ${source.url}` : ""}`).join("\n")
+    : `- ${copy.noDatedNews}`;
+  const totalExcluded = excluded.undated + excluded.future + excluded.stale;
+  const exclusion = totalExcluded ? {
+    zh: `- ${copy.newsExcluded} ${totalExcluded} 个来源：无日期 ${excluded.undated}、晚于 as_of ${excluded.future}、早于 120 天窗口 ${excluded.stale}。`,
+    en: `- ${copy.newsExcluded} ${totalExcluded}: undated=${excluded.undated}, after_as_of=${excluded.future}, older_than_120d=${excluded.stale}.`,
+    ja: `- ${copy.newsExcluded}：合計 ${totalExcluded} 件（日付なし ${excluded.undated}、as_of 後 ${excluded.future}、120日超 ${excluded.stale}）。`,
+    ko: `- ${copy.newsExcluded}: 총 ${totalExcluded}개(날짜 없음 ${excluded.undated}, as_of 이후 ${excluded.future}, 120일 초과 ${excluded.stale}).`,
+  }[languageKey(run.language)] : "";
+  return { packet, sources, exclusion };
+}
+
+function localizedDisplayValue(value, language) {
+  const key = languageKey(language);
+  const token = value === true ? "true" : value === false ? "false" : String(value || "unknown");
+  const maps = {
+    zh: { unknown: "未知", unavailable: "不可用", true: "是", false: "否", pending: "待运行", running: "运行中", waiting: "等待中", completed: "已完成", complete: "完整", failed: "失败", degraded: "降级", incomplete: "不完整", skipped: "未运行", declined: "不适用", constructive: "建设性", cautious: "谨慎", opposed: "反对", out_of_scope: "证据范围外", high: "高", medium: "中", low: "低", Buy: "买入", Overweight: "增持", Hold: "持有", Underweight: "减持", Sell: "卖出", bull: "多方", bear: "空方", balanced: "平衡" },
+    en: { unknown: "unknown", unavailable: "unavailable", true: "yes", false: "no" },
+    ja: { unknown: "不明", unavailable: "取得不可", true: "はい", false: "いいえ", pending: "待機中", running: "実行中", waiting: "待機中", completed: "完了", complete: "完了", failed: "失敗", degraded: "縮退", incomplete: "不完全", skipped: "未実行", declined: "適用外", constructive: "前向き", cautious: "慎重", opposed: "反対", out_of_scope: "証拠範囲外", high: "高", medium: "中", low: "低", Buy: "買い", Overweight: "オーバーウェイト", Hold: "中立", Underweight: "アンダーウェイト", Sell: "売り", bull: "強気", bear: "弱気", balanced: "均衡" },
+    ko: { unknown: "알 수 없음", unavailable: "확인 불가", true: "예", false: "아니요", pending: "대기 중", running: "실행 중", waiting: "대기 중", completed: "완료", complete: "완료", failed: "실패", degraded: "성능 저하", incomplete: "불완전", skipped: "미실행", declined: "적용 범위 밖", constructive: "긍정적", cautious: "신중", opposed: "반대", out_of_scope: "증거 범위 밖", high: "높음", medium: "중간", low: "낮음", Buy: "매수", Overweight: "비중 확대", Hold: "보유", Underweight: "비중 축소", Sell: "매도", bull: "강세", bear: "약세", balanced: "균형" },
+  };
+  return maps[key]?.[token] || token;
+}
+
+export function userResponseMarkdown(run, manager) {
+  const artifacts = artifactPaths(run);
+  const copy = handoffCopy(run.language);
+  const news = recentNewsHandoff(run, copy);
+  const decisionAvailable = manager?.decision_available !== false;
+  const quote = run?.grounding?.quote;
+  const priceLine = quote && Number.isFinite(Number(quote.price))
+    ? `${quote.price} ${quote.currency || ""}; ${quote.quote_time || localizedDisplayValue("unknown", run.language)}; ${quote.exchange || localizedDisplayValue("unknown", run.language)}; ${copy.delayed}; ${quote.source_url || localizedDisplayValue("unavailable", run.language)}`
+    : copy.noPrice;
+  const masterLines = (run.masters || []).map((id) => {
+    const opinion = (run.master_opinions || []).find((item) => item.master === id);
+    const state = run.master_status?.[id] || { status: "pending" };
+    if (!opinion) return `- ${masterTitle(id, run.language)} (\`${id}\`) [${localizedDisplayValue(state.status, run.language)}]: ${localizedFailure(state.error, run.language) || copy.missing}`;
+    return `- ${masterTitle(id, run.language)} (\`${id}\`) [${localizedDisplayValue(opinion.stance, run.language)}/${localizedDisplayValue(opinion.confidence || "low", run.language)}; ${copy.worker}=${localizedDisplayValue(opinion.dedicated_worker?.status || opinion.voice_status || "unknown", run.language)}]: ${clipAtBoundary(opinion.voice_statement || opinion.summary || opinion.verdict, 520)}`;
+  }).join("\n") || `- ${copy.missing}`;
+  const analystLines = (run.tasks || []).map((task) => {
+    const packet = (run.packets || []).find((item) => item.task === task);
+    const state = taskState(run, task);
+    return `- \`${task}\` [${localizedDisplayValue(state.status, run.language)}/${localizedDisplayValue(packet?.confidence || "low", run.language)}]: ${clipAtBoundary(packet?.summary || "", 520) || localizedFailure(state.error, run.language) || copy.missing}`;
+  }).join("\n") || `- ${copy.missing}`;
+  const gaps = [...new Set([
+    ...(run.tasks || []).filter((task) => taskState(run, task).status !== "completed")
+      .map((task) => `${task}: ${localizedFailure(taskState(run, task).error || taskState(run, task).status, run.language)}`),
+    ...(run.masters || []).filter((id) => !(run.master_opinions || []).some((opinion) => opinion.master === id))
+      .map((id) => `${id}: ${localizedFailure(run.master_status?.[id]?.error || run.master_status?.[id]?.status, run.language)}`),
+    ...(run.packets || []).flatMap((packet) => packet.open_questions || []),
+  ])].slice(0, 12).map((item) => `- ${clipAtBoundary(item, 360)}`).join("\n") || `- ${copy.noGaps}`;
+  const invalidation = decisionAvailable
+    ? (manager.invalidation || []).slice(0, 3).map((item) => `- ${clipAtBoundary(item, 260)}`).join("\n") || `- ${copy.noInvalidation}`
+    : `- ${copy.noInvalidation}`;
+  const elapsed = run.started_at
+    ? Math.max(0, Date.parse(run.completed_at || new Date().toISOString()) - Date.parse(run.started_at))
+    : localizedDisplayValue("unknown", run.language);
+  return [
+    `# ${run.symbol} ${copy.title}`,
+    "",
+    `## ${copy.status}`,
+    `- ${copy.statusLabel}: ${localizedDisplayValue(run.status, run.language)}`,
+    `- ${copy.contract}: ${run.council_mode === "quick" ? "quick_v1" : "full_v2"}`,
+    `- ${copy.scope}: ${run.council_mode === "quick" ? copy.quickScope : copy.fullScope}`,
+    `- ${copy.elapsed}: ${elapsed} ms`,
+    `- ${copy.deadline}: ${run.deadline_at || localizedDisplayValue("unknown", run.language)}`,
+    `- ${copy.deadlineMet}: ${localizedDisplayValue(run.deadline_at && run.completed_at ? Date.parse(run.completed_at) <= Date.parse(run.deadline_at) : "unknown", run.language)}`,
+    "",
+    `## ${copy.price}`,
+    `- ${priceLine}`,
+    "",
+    `## ${copy.conclusion}`,
+    `- ${copy.rating}: ${localizedDisplayValue(decisionAvailable ? manager.rating : "unavailable", run.language)}`,
+    `- ${copy.winner}: ${localizedDisplayValue(decisionAvailable ? (manager.winner || "unknown") : "unavailable", run.language)}`,
+    `- ${copy.confidence}: ${localizedDisplayValue(decisionAvailable ? (manager.confidence || "low") : "unavailable", run.language)}`,
+    `- ${copy.judgment}: ${decisionAvailable ? clipAtBoundary(manager.verdict || manager.summary, 720) : copy.noDecision}`,
+    "",
+    `## ${copy.masters}`,
+    masterLines,
+    "",
+    `## ${copy.analysts}`,
+    analystLines,
+    "",
+    `## ${copy.recentNews}`,
+    `- ${copy.newsSummary}: ${clipAtBoundary(news.packet?.summary || "", 620) || copy.missing}`,
+    news.sources,
+    news.exclusion,
+    "",
+    `## ${copy.key}`,
+    `- ${copy.earnings}: ${clipAtBoundary(packetSummary(run, "earnings_deep_dive"), 520) || copy.missing}`,
+    `- ${copy.forward}: ${clipAtBoundary(packetSummary(run, "forward_expectations"), 520) || copy.missing}`,
+    `- ${copy.news}: ${clipAtBoundary(packetSummary(run, "news_industry_management"), 620) || copy.missing}`,
+    `- ${copy.valuation}: ${decisionAvailable ? (clipAtBoundary(manager.valuation_range, 620) || copy.missing) : localizedDisplayValue("unavailable", run.language)}`,
+    `- ${copy.position}: ${decisionAvailable ? (clipAtBoundary(manager.position, 520) || copy.missing) : localizedDisplayValue("unavailable", run.language)}`,
+    "",
+    `## ${copy.gaps}`,
+    gaps,
+    "",
+    `## ${copy.invalidation}`,
+    invalidation,
+    "",
+    `## ${copy.files}`,
+    `- ${copy.report}: ${artifacts.final_report_md}`,
+    `- ${copy.index}: ${artifacts.artifact_index_md}`,
+    `- ${copy.trace}: ${artifacts.all_agents_md}`,
+    `- ${copy.quality}: ${artifacts.report_quality_json}`,
+  ].join("\n");
+}
+
 export function writeUserResponse(run, manager) {
   const markdown = userResponseMarkdown(run, manager);
   writeFileSync(artifactPaths(run).user_response_md, `${markdown}\n`);