alphacouncil-agent 0.9.2 → 0.9.4

package/mcp/lib/rpc.mjs

@@ -4,7 +4,7 @@ import readline from "node:readline";
 import { COUNCIL_MODES, LIMITS, MASTER_STANCES, OUTPUT_MODES, QUICK_TASKS, SERVER_NAME, VERSION } from "./constants.mjs";
 import { RpcCode, methodNotFound, invalidParams, toRpcError } from "./errors.mjs";
 import { readJson, readJsonl, writeJson } from "./fsutil.mjs";
-import { resolveLanguage } from "./lang.mjs";
+import { localized, resolveLanguage } from "./lang.mjs";
 import { sweepStaleOutputs } from "./codex.mjs";
 import { completenessStatus, sourceManifest } from "./gates.mjs";
 import { artifactPaths, existingDebate, runId, runPath, safeSymbol, saveRun } from "./run-store.mjs";
@@ -76,7 +76,14 @@ export function recordAck(run, extra = {}) {
   };
 }
 
-function renderSelectionCatalog(data, zh) {
+function renderSelectionCatalog(data) {
+  const copy = (messages) => localized(data.language, messages);
+  const labels = copy({
+    en: { identity: "Identity", method: "Method", bestFor: "Best for", maturity: "Maturity", pack: "Pack format", preselected: "preselected" },
+    zh: { identity: "身份", method: "方法", bestFor: "适合", maturity: "成熟度", pack: "物理格式", preselected: "已预选" },
+    ja: { identity: "人物像", method: "手法", bestFor: "適した対象", maturity: "成熟度", pack: "パック形式", preselected: "事前選択済み" },
+    ko: { identity: "정체성", method: "방법", bestFor: "적합 대상", maturity: "성숙도", pack: "팩 형식", preselected: "사전 선택" },
+  });
   const preselected = new Set(data.preselected_master_ids || []);
   // Some MCP hosts expose only text content even when the server also returns
   // structuredContent. Keep the selection handshake usable on those hosts by
@@ -91,31 +98,45 @@ function renderSelectionCatalog(data, zh) {
     council_mode: data.council_mode,
   })}`;
   const cards = data.masters.map((master) => [
-    `${master.index}. ${master.title} [${master.id}]${preselected.has(master.id) ? (zh ? " [已预选]" : " [preselected]") : ""}`,
-    `${zh ? "身份" : "Identity"}: ${master.identity}`,
-    `${zh ? "方法" : "Method"}: ${master.method}`,
-    `${zh ? "适合" : "Best for"}: ${master.best_for}`,
-    `${zh ? "成熟度" : "Maturity"}: ${master.maturity}`,
-    `${zh ? "物理格式" : "Pack format"}: ${master.pack_format} (${master.admission_level})`,
+    `${master.index}. ${master.title} [${master.id}]${preselected.has(master.id) ? ` [${labels.preselected}]` : ""}`,
+    `${labels.identity}: ${master.identity}`,
+    `${labels.method}: ${master.method}`,
+    `${labels.bestFor}: ${master.best_for}`,
+    `${labels.maturity}: ${master.maturity_label} (${master.maturity})`,
+    `${labels.pack}: ${master.pack_format} (${master.admission_level})`,
   ].join("\n   ")).join("\n\n");
   const quick = data.council_mode === "quick";
-  const instructions = zh
-    ? quick
-      ? `Quick 模式请选择 1 至 ${data.maximum} 位大师。回复编号、范围或稳定 ID，例如：1 / 1,3,8 / 1-4 / master_buffett；不支持 all 全选。`
-      : `请选择 1 至 ${data.maximum} 位大师。回复编号、范围、稳定 ID，或 all 全选，例如：1 / 1,3,8 / 1-5 / master_buffett / all。`
-    : quick
-      ? `Quick mode: choose 1 to ${data.maximum} masters. Submit numbers, ranges, or stable IDs, for example: 1 / 1,3,8 / 1-4 / master_buffett. Selecting all is not supported.`
-      : `Choose 1 to ${data.maximum} masters. Submit numbers, ranges, stable IDs, or all, for example: 1 / 1,3,8 / 1-5 / master_buffett / all.`;
+  const instructions = quick
+    ? copy({
+      en: `Quick mode: choose 1 to ${data.maximum} masters. Submit numbers, ranges, or stable IDs, for example: 1 / 1,3,8 / 1-4 / master_buffett. Selecting all is not supported.`,
+      zh: `Quick 模式请选择 1 至 ${data.maximum} 位大师。回复编号、范围或稳定 ID，例如：1 / 1,3,8 / 1-4 / master_buffett；不支持 all 全选。`,
+      ja: `Quick モードでは1席から${data.maximum}席を選んでください。番号、範囲、stable ID（例：1 / 1,3,8 / 1-4 / master_buffett）を送信してください。all は使用できません。`,
+      ko: `Quick 모드에서는 1개에서 ${data.maximum}개 마스터 좌석을 선택하십시오. 번호, 범위 또는 stable ID(예: 1 / 1,3,8 / 1-4 / master_buffett)를 제출하십시오. all은 지원하지 않습니다.`,
+    })
+    : copy({
+      en: `Choose 1 to ${data.maximum} masters. Submit numbers, ranges, stable IDs, or all, for example: 1 / 1,3,8 / 1-5 / master_buffett / all.`,
+      zh: `请选择 1 至 ${data.maximum} 位大师。回复编号、范围、稳定 ID，或 all 全选，例如：1 / 1,3,8 / 1-5 / master_buffett / all。`,
+      ja: `1席から${data.maximum}席のマスターを選んでください。番号、範囲、stable ID、または all（例：1 / 1,3,8 / 1-5 / master_buffett / all）を送信してください。`,
+      ko: `1개에서 ${data.maximum}개 마스터 좌석을 선택하십시오. 번호, 범위, stable ID 또는 all(예: 1 / 1,3,8 / 1-5 / master_buffett / all)을 제출하십시오.`,
+    });
   return [
-    zh
-      ? `大师选择（目录共 ${data.masters.length} 席；最多选择 ${data.maximum} 席）`
-      : `Master selection (${data.masters.length} in catalog; choose up to ${data.maximum})`,
+    copy({
+      en: `Master selection (${data.masters.length} in catalog; choose up to ${data.maximum})`,
+      zh: `大师选择（目录共 ${data.masters.length} 席；最多选择 ${data.maximum} 席）`,
+      ja: `マスター選択（全${data.masters.length}席、最大${data.maximum}席まで）`,
+      ko: `마스터 선택(전체 ${data.masters.length}개 좌석, 최대 ${data.maximum}개 선택)`,
+    }),
     fallbackContext,
     "",
     cards,
     "",
     instructions,
-    zh ? "提交选择后才会开始研究。" : "Research starts only after this selection is submitted.",
+    copy({
+      en: "Research starts only after this selection is submitted.",
+      zh: "提交选择后才会开始研究。",
+      ja: "選択を送信するまで調査は開始されません。",
+      ko: "선택을 제출하기 전에는 조사를 시작하지 않습니다.",
+    }),
   ].join("\n");
 }
 
@@ -176,6 +197,12 @@ function startValidation(args, entryTool) {
       maximum_ms: LIMITS.QUICK_HARD_MAX_MS,
     });
   }
+  if (mode === "full" && args.total_timeout_ms > LIMITS.FULL_HARD_MAX_MS) {
+    throw invalidParams(`Full council total_timeout_ms cannot exceed ${LIMITS.FULL_HARD_MAX_MS}.`, {
+      reason: "FULL_TOTAL_TIMEOUT_EXCEEDS_MAX",
+      maximum_ms: LIMITS.FULL_HARD_MAX_MS,
+    });
+  }
   if (mode === "quick" && args.synthesis === false) {
     throw invalidParams("Quick council requires its one-round bull/bear and portfolio-manager synthesis.", {
       reason: "QUICK_SYNTHESIS_REQUIRED",
@@ -230,7 +257,9 @@ function selectedRunArgs(args = {}, entryTool) {
       selection_receipt: args.selection_receipt,
       symbol,
       run_id: id,
-      language: args.language || "English",
+      // Preserve omission so consumeCouncilSelection can infer the same locale
+      // from the prompt that begin_council_selection bound into the receipt.
+      language: args.language,
       prompt: typeof args.prompt === "string" ? args.prompt : "",
       council_mode: args.council_mode || "full",
     });
@@ -373,9 +402,8 @@ export function tools() {
     synthesis_timeout_ms: { type: "number", default: LIMITS.CODEX_TIMEOUT_MS },
     total_timeout_ms: {
       type: "number",
-      default: LIMITS.QUICK_TOTAL_MS,
-      maximum: LIMITS.QUICK_HARD_MAX_MS,
-      description: "Hard end-to-end wall-clock budget for council_mode=quick, including grounding wait, retries and synthesis. It may be lowered but never raised above ten minutes. Full mode has no implicit global deadline.",
+      maximum: LIMITS.FULL_HARD_MAX_MS,
+      description: "Hard queue-to-persistence wall-clock budget. quick defaults to and cannot exceed ten minutes; full defaults to and cannot exceed thirty minutes. Callers may lower the applicable ceiling, never raise it.",
     },
     output_mode: { type: "string", enum: OUTPUT_MODES, default: "public_equity", description: "Final synthesis target shape." },
     selection_receipt: { type: "string", description: "One-run receipt returned by confirm_master_selection. Required for every council run and consumed exactly once." },
@@ -435,7 +463,7 @@ export function tools() {
       },
       required: ["symbol", "selection_receipt"],
     }),
-    tool("record_visible_packet", "MANDATORY sequential step (not optional): record one completed visible evidence agent packet into a planned visible run. Every planned evidence task MUST be recorded before the portfolio_manager decision; a run missing any planned packet will be marked incomplete.", {
+    tool("record_visible_packet", "MANDATORY sequential step (not optional): record one completed visible evidence agent packet into a planned visible run. Every reader-facing field must use the run language or the packet is rejected without changing run state. Every planned evidence task MUST be recorded before debate completion and portfolio_manager.", {
       type: "object",
       properties: {
         run_id: { type: "string" },
@@ -446,16 +474,27 @@ export function tools() {
       },
       required: ["run_id", "task", "packet"],
     }),
-    tool("record_visible_decision", "Record one completed visible bull_researcher / bear_researcher / portfolio_manager packet. Record bull_researcher and bear_researcher before portfolio_manager. For role=portfolio_manager, ALL planned evidence packets AND both debate researchers (bull_researcher and bear_researcher) MUST already be recorded; otherwise the run is marked status=incomplete (NOT complete) and final_report.md gets a visible INCOMPLETE banner. This is the LAST step.", {
+    tool("record_visible_decision", "Record exactly one visible decision step. Full visible bull_researcher and bear_researcher calls MUST supply round=1, then round=2, then round=3; both sides of the prior round are required before advancing. Round 2 asks exactly three questions; Round 3 preserves its own questions and answers the opponent's questions with exact bindings. Packets are persisted by role+round: an identical replay is idempotent and conflicting content is rejected. portfolio_manager accepts no round and is rejected until all evidence, selected masters, both three-round sides, and the exact Q&A gate are complete. Every reader-facing field must use the run language.", {
       type: "object",
       properties: {
         run_id: { type: "string" },
         role: { type: "string", enum: debateIds },
+        round: { type: "integer", minimum: 1, maximum: 3, description: "Required for bull_researcher and bear_researcher. Full visible runs require 1, 2, and 3 in order. Omit for portfolio_manager." },
         packet: { type: "object" },
         thread_id: { type: "string" },
         thread_title: { type: "string" },
       },
       required: ["run_id", "role", "packet"],
+      allOf: [
+        {
+          if: { properties: { role: { enum: ["bull_researcher", "bear_researcher"] } }, required: ["role"] },
+          then: { required: ["round"] },
+        },
+        {
+          if: { properties: { role: { const: "portfolio_manager" } }, required: ["role"] },
+          then: { not: { required: ["round"] } },
+        },
+      ],
     }),
     tool("collect_evidence", "Launch Codex subagents and save shared JSON evidence packets. Use dry_run=true only for planning/self-tests.", {
       type: "object",
@@ -504,7 +543,7 @@ export function tools() {
       type: "object",
       properties: { language: common.language },
     }, { readOnlyHint: true, destructiveHint: false, openWorldHint: false }),
-    tool("record_master_opinion", "Record one completed selected master-seat opinion into a planned visible run. Masters run AFTER every evidence packet is recorded and BEFORE the bull/bear debate, so the debate has their disagreements to argue with. A master may return stance=out_of_scope, which is a recorded conclusion rather than an abstention. Every selected seat must either report or be settled deterministically before the run can be complete.", {
+    tool("record_master_opinion", "Record one completed selected master-seat opinion into a planned visible run. Every reader-facing field must use the run language or the opinion is rejected without changing run state. Masters run AFTER every evidence packet is recorded and BEFORE the bull/bear debate, so the debate has their disagreements to argue with. A master may return stance=out_of_scope, which is a recorded conclusion rather than an abstention. Every selected seat must either report or be settled deterministically before the run can be complete.", {
       type: "object",
       properties: {
         run_id: { type: "string" },
@@ -692,8 +731,7 @@ export async function handleToolCall(id, params) {
   const args = params?.arguments || {};
   if (name === "begin_council_selection") {
     const data = beginCouncilSelection(args);
-    const zh = /中文|chinese|zh/i.test(String(data.language || ""));
-    sendResult(id, jsonContent(renderSelectionCatalog(data, zh), data));
+    sendResult(id, jsonContent(renderSelectionCatalog(data), data));
     return;
   }
   if (name === "confirm_master_selection") {
@@ -705,10 +743,13 @@ export async function handleToolCall(id, params) {
       intent_hash: data.intent_hash,
       council_mode: data.council_mode,
     })}`;
-    sendResult(id, jsonContent(
-      `${fallbackContext}\nConfirmed ${data.selected_count} master seat(s) for ${data.symbol}. Use the one-time selection_receipt to start this run.`,
-      data,
-    ));
+    const confirmation = localized(data.language, {
+      en: `Confirmed ${data.selected_count} master seat(s) for ${data.symbol}. Use the one-time selection_receipt to start this run.`,
+      zh: `已为 ${data.symbol} 确认 ${data.selected_count} 个大师席位。请使用一次性 selection_receipt 启动本轮运行。`,
+      ja: `${data.symbol} について ${data.selected_count} 席のマスターを確定しました。今回の実行を開始するには1回限りの selection_receipt を使用してください。`,
+      ko: `${data.symbol}에 대해 마스터 ${data.selected_count}개 좌석을 확정했습니다. 이번 실행을 시작하려면 일회용 selection_receipt를 사용하십시오.`,
+    });
+    sendResult(id, jsonContent(`${fallbackContext}\n${confirmation}`, data));
     return;
   }
   if (name === "plan_visible_run") {
@@ -766,11 +807,12 @@ export async function handleToolCall(id, params) {
   if (name === "record_visible_decision") {
     const result = recordVisibleDecision(args);
     sendResult(id, jsonContent(
-      `Recorded visible decision ${args.role} for ${result.run.symbol}: ${result.run.run_id}`,
+      `Recorded visible decision ${args.role}${args.round ? ` round ${args.round}` : ""} for ${result.run.symbol}: ${result.run.run_id}`,
       // decision and opinion are small and are what a caller reads back; only the full
       // run object is dropped.
       recordAck(result.run, {
         decision: result.decision,
+        idempotent_replay: result.idempotent_replay === true,
         report_quality: result.report_quality?.status,
         missing_report_items: result.report_quality?.missing || [],
       }),

package/mcp/lib/run-store.mjs

@@ -54,6 +54,13 @@ export function statusSnapshot(run) {
   const recordedMasters = (run.master_opinions || []).map((opinion) => opinion.master);
   const recordedSet = new Set(recordedMasters);
   const pendingMasters = selectedMasters.filter((master) => !recordedSet.has(master));
+  const visibleDebate = run.execution_mode === "visible_host_threads" ? run.visible_debate : null;
+  const visibleDebateRounds = visibleDebate
+    ? Object.fromEntries(["bull_researcher", "bear_researcher"].map((role) => [
+        role,
+        Object.keys(visibleDebate.rounds?.[role] || {}).map(Number).filter(Number.isInteger).sort((a, b) => a - b),
+      ]))
+    : null;
   return {
     run_id: run.run_id,
     symbol: run.symbol,
@@ -62,13 +69,29 @@ export function statusSnapshot(run) {
     execution_mode: run.execution_mode,
     council_mode: run.council_mode || "full",
     debate_format: run.debate_format || "three_round_cross_exam",
+    visible_debate_contract: visibleDebate?.contract || null,
+    visible_debate_rounds_expected: visibleDebate?.rounds_expected || null,
+    visible_debate_rounds_recorded: visibleDebateRounds,
+    visible_debate_qna_gate: visibleDebate?.qna_gate?.status || null,
     report_contract: run.council_mode === "quick" ? "quick_v1" : "full_v2",
     full_council_equivalent: run.council_mode !== "quick",
+    master_worker_contract: run.execution_mode === "background_codex_exec"
+      ? "one_isolated_worker_per_selected_method_v1"
+      : run.execution_mode === "dry_run"
+        ? "planned_not_executed"
+        : "host_managed_not_plugin_enforced",
+    deadline_enforced: run.deadline_enforced === true,
     time_budget_ms: run.time_budget_ms || null,
     deadline_at: run.deadline_at || null,
     remaining_budget_ms: run.deadline_at
       ? Math.max(0, Date.parse(run.deadline_at) - Date.now())
       : null,
+    elapsed_ms: run.started_at
+      ? Math.max(0, Date.parse(run.completed_at || new Date().toISOString()) - Date.parse(run.started_at))
+      : null,
+    deadline_met: run.deadline_at && run.completed_at
+      ? Date.parse(run.completed_at) <= Date.parse(run.deadline_at)
+      : null,
     visibility_required: run.visibility_required,
     dry_run: run.dry_run,
     status: run.status,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alphacouncil-agent",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "description": "Multi-agent public-equity research workflow plugin for Codex & Claude Code: sourced evidence packets, bull/bear debate, and a portfolio-manager Buy/Overweight/Hold/Underweight/Sell decision.",
   "type": "module",
   "license": "MIT",
@@ -33,7 +33,7 @@
     "check": "node scripts/selfcheck.mjs",
     "test": "node scripts/run-tests.mjs",
     "test:source": "node --test",
-    "test:package": "node scripts/package-smoke.mjs",
+    "test:package": "node scripts/check-packaged-host-parity.mjs --check",
     "sync": "node scripts/sync-personas.mjs",
     "persona:corpus": "node scripts/report-persona-corpus-gaps.mjs",
     "persona:build-specs": "node scripts/report-persona-v3-build-specs.mjs",

package/schemas/persona-v3.schema.json

@@ -19,6 +19,31 @@
     "components"
   ],
   "additionalProperties": false,
+  "allOf": [
+    {
+      "if": {
+        "required": ["build_profile"],
+        "properties": { "build_profile": { "const": "solo_test" } }
+      },
+      "then": {
+        "properties": {
+          "identity": {
+            "properties": {
+              "public_label": { "$ref": "#/$defs/localizedTextFourLocales" },
+              "operator_label": { "$ref": "#/$defs/localizedTextFourLocales" }
+            }
+          },
+          "selection": {
+            "properties": {
+              "identity": { "$ref": "#/$defs/localizedTextFourLocales" },
+              "method": { "$ref": "#/$defs/localizedTextFourLocales" },
+              "best_for": { "$ref": "#/$defs/localizedTextFourLocales" }
+            }
+          }
+        }
+      }
+    }
+  ],
   "properties": {
     "schema_version": { "const": 3 },
     "build_profile": {
@@ -38,7 +63,9 @@
           "additionalProperties": false,
           "properties": {
             "en": { "type": "string", "minLength": 3 },
-            "zh": { "type": "string", "minLength": 2 }
+            "zh": { "type": "string", "minLength": 2 },
+            "ja": { "type": "string", "minLength": 2 },
+            "ko": { "type": "string", "minLength": 2 }
           }
         },
         "operator_label": {
@@ -192,9 +219,17 @@
       "additionalProperties": false,
       "properties": {
         "en": { "type": "string", "minLength": 3 },
-        "zh": { "type": "string", "minLength": 2 }
+        "zh": { "type": "string", "minLength": 2 },
+        "ja": { "type": "string", "minLength": 2 },
+        "ko": { "type": "string", "minLength": 2 }
       }
     },
+    "localizedTextFourLocales": {
+      "allOf": [
+        { "$ref": "#/$defs/localizedText" },
+        { "required": ["en", "zh", "ja", "ko"] }
+      ]
+    },
     "strings": {
       "type": "array",
       "items": { "type": "string", "minLength": 1 },

package/scripts/lib/packaged-host-parity.mjs

@@ -29,7 +29,12 @@ import { isDeepStrictEqual } from "node:util";
 const HERE = dirname(fileURLToPath(import.meta.url));
 export const PACKAGED_PARITY_REPO_ROOT = resolve(HERE, "../..");
 export const PACKAGED_HOST_IDS = Object.freeze(["claude_code", "codex", "opencode", "grok"]);
-export const PACKAGED_SELECTION_INPUT = "2,23-24,26";
+export const PACKAGED_SELECTION_INPUT = Object.freeze([
+  "master_buffett",
+  "master_damodaran",
+  "master_taleb",
+  "master_sinclair",
+]);
 
 const TEMP_PREFIX = "alphacouncil-packaged-parity-";
 const SYMBOL = "NOK";
@@ -39,6 +44,13 @@ const PROMPT = "packaged adapter parity fixture";
 const TASKS = Object.freeze(["market_data"]);
 const REQUEST_TIMEOUT_MS = 30_000;
 const PROCESS_TIMEOUT_MS = 120_000;
+const EXPECTED_TOOL_COUNT = 31;
+const INSTALLED_LOCALE_CASES = Object.freeze([
+  Object.freeze({ language: "en-US", prompt: "installed package locale smoke", key: "en", script: /[A-Za-z]/u }),
+  Object.freeze({ language: "zh-CN", prompt: "安装包语言烟雾测试", key: "zh", script: /\p{Script=Han}/u }),
+  Object.freeze({ language: "ja-JP", prompt: "インストール済みパッケージの言語スモークテスト", key: "ja", script: /[\p{Script=Hiragana}\p{Script=Katakana}]/u }),
+  Object.freeze({ language: "ko-KR", prompt: "설치 패키지 언어 스모크 테스트", key: "ko", script: /\p{Script=Hangul}/u }),
+]);
 const REQUIRED_PACKAGE_FILES = Object.freeze([
   "mcp/server.mjs",
   "data/host-capabilities.v1.json",
@@ -575,16 +587,28 @@ function assertCompleteCatalog(opened, text, hostId) {
   for (const [offset, master] of opened.masters.entries()) {
     if (master.index !== offset + 1 || seen.has(master.id)) fail(`${hostId}: catalog order or IDs are invalid`);
     seen.add(master.id);
-    for (const field of ["identity", "method", "best_for", "maturity", "pack_hash"]) {
+    for (const field of ["identity", "method", "best_for", "maturity", "maturity_label", "pack_hash"]) {
       if (typeof master[field] !== "string" || !master[field]) fail(`${hostId}: catalog seat ${master.id} lacks ${field}`);
     }
     if (!/^sha256:[a-f0-9]{64}$/u.test(master.pack_hash)) fail(`${hostId}: ${master.id} pack hash is invalid`);
-    for (const visible of [`${master.index}. `, `[${master.id}]`, master.identity, master.method, master.best_for, master.maturity]) {
+    for (const visible of [`${master.index}. `, `[${master.id}]`, master.identity, master.method, master.best_for, master.maturity, master.maturity_label]) {
       if (!text.includes(visible)) fail(`${hostId}: returned text did not display ${master.id} field ${visible}`);
     }
   }
 }
 
+function assertLocalizedCatalog(opened, text, locale) {
+  assertCompleteCatalog(opened, text, `installed-${locale.key}`);
+  for (const master of opened.masters) {
+    for (const field of ["identity", "method", "best_for", "maturity_label"]) {
+      if (!locale.script.test(master[field])) fail(`installed-${locale.key}: ${master.id}.${field} lacks requested-locale prose`);
+      if (locale.key !== "en" && /\b[a-z]+(?:_[a-z0-9]+)+\b/u.test(master[field])) {
+        fail(`installed-${locale.key}: ${master.id}.${field} leaked a machine domain id into reader-facing prose`);
+      }
+    }
+  }
+}
+
 function normalizedReceiptBinding(record) {
   return {
     symbol: record.symbol,
@@ -624,7 +648,27 @@ async function executePackagedAdapters({ pack, surfaces, tempRoot }) {
         networkSentinel,
       });
       await server.request("initialize", {});
-      sessions.push({ hostId, dataDir, server });
+      const listed = await server.request("tools/list", {});
+      const tools = listed.result?.tools || [];
+      if (tools.length !== EXPECTED_TOOL_COUNT) fail(`${hostId}: installed server exposed ${tools.length} tools, expected ${EXPECTED_TOOL_COUNT}`);
+      sessions.push({ hostId, dataDir, server, toolCount: tools.length });
+    }
+
+    const localeCases = process.env.ALPHACOUNCIL_PERSONA_BUILD_PROFILE === "production"
+      ? INSTALLED_LOCALE_CASES.slice(0, 1)
+      : INSTALLED_LOCALE_CASES;
+    const localeCatalogHashes = {};
+    for (const locale of localeCases) {
+      const response = await sessions[0].server.callTool("begin_council_selection", {
+        symbol: SYMBOL,
+        as_of: AS_OF,
+        language: locale.language,
+        prompt: locale.prompt,
+        host: "installed-package-locale-smoke",
+      });
+      const opened = structured(response, `installed ${locale.language} begin_council_selection`);
+      assertLocalizedCatalog(opened, response.result.content?.[0]?.text || "", locale);
+      localeCatalogHashes[locale.key] = opened.catalog_hash;
     }
 
     for (const session of sessions) {
@@ -642,7 +686,7 @@ async function executePackagedAdapters({ pack, surfaces, tempRoot }) {
         selection_id: opened.selection_id,
         catalog_hash: opened.catalog_hash,
         display_ack: true,
-        selection: PACKAGED_SELECTION_INPUT,
+        selected_master_ids: PACKAGED_SELECTION_INPUT,
       }), `${session.hostId} confirm_master_selection`);
       session.opened = opened;
       session.confirmed = confirmed;
@@ -744,11 +788,15 @@ async function executePackagedAdapters({ pack, surfaces, tempRoot }) {
       evidence_scope: "installed_npm_tarball_mcp_stdio_adapters_only",
       host_order: PACKAGED_HOST_IDS,
       host_count: sessions.length,
+      tool_count: EXPECTED_TOOL_COUNT,
+      locale_count: localeCases.length,
+      locale_catalog_hashes: localeCatalogHashes,
       catalog_count: baseline.catalog.length,
       catalog_hash: baseline.catalog_hash,
       catalog_order_hash: sha256(baseline.catalog),
       maturity_counts: maturityCounts,
       selection_input: PACKAGED_SELECTION_INPUT,
+      selection_input_type: "stable_ids",
       selected_master_ids: baseline.selected_master_ids,
       selected_master_pack_hashes: baseline.selected_master_pack_hashes,
       receipt_binding_hash: sha256(baseline.receipt_binding),
@@ -774,6 +822,7 @@ async function executePackagedAdapters({ pack, surfaces, tempRoot }) {
         host_id: session.hostId,
         server_entry: "mcp/server.mjs",
         adapter_status: "passed",
+        tool_count: session.toolCount,
         catalog_count: session.catalog.length,
         catalog_hash: session.opened.catalog_hash,
         selected_master_ids: session.confirmed.selected_master_ids,

package/scripts/lib/persona-v3-solo-test-packs.mjs

@@ -21,6 +21,11 @@ import { fileURLToPath } from "node:url";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 
 import buildInventory from "../../data/persona-v3-build-specs.v1.mjs";
+import {
+  selectorBestForLocale,
+  selectorMethodLocale,
+} from "../../data/master-selector-method-locales.v1.mjs";
+import { selectorCard } from "../../mcp/lib/master-catalog.mjs";
 import { inspectPersonaAdmission } from "../../mcp/lib/personas-v3/admission.mjs";
 import {
   canonicalValue,
@@ -381,14 +386,26 @@ function buildDocuments({ seat, blueprint, rawTools, packVersion, formulaManifes
   if (policyErrors.length) fail(`${seat.persona_id}: generated deterministic policy is invalid`, { errors: policyErrors });
 
   const publicTitle = blueprint.canonical_title;
+  const selectorPersona = { id: seat.persona_id, title: publicTitle };
+  const chineseMethod = selectorCard(selectorPersona, "zh-CN").method;
   const manifest = canonicalValue({
     schema_version: 3,
     build_profile: "solo_test",
     pack_version: packVersion,
     identity: {
       persona_id: seat.persona_id,
-      public_label: { en: `${publicTitle.en} Solo Test`, zh: `${publicTitle.zh}单人测试` },
-      operator_label: { en: `${publicTitle.en} Provisional Operator Lens`, zh: `${publicTitle.zh}临时操作视角` },
+      public_label: {
+        en: `${publicTitle.en} Solo Test`,
+        zh: `${publicTitle.zh}单人测试`,
+        ja: `${publicTitle.en} 単独テスト`,
+        ko: `${publicTitle.en} 단독 테스트`,
+      },
+      operator_label: {
+        en: `${publicTitle.en} Provisional Operator Lens`,
+        zh: `${publicTitle.zh}临时操作视角`,
+        ja: `${publicTitle.en} 暫定オペレーター・レンズ`,
+        ko: `${publicTitle.en} 임시 오퍼레이터 렌즈`,
+      },
       maturity: "operator_lens",
       source_cutoff: SOURCE_DATE,
     },
@@ -396,11 +413,20 @@ function buildDocuments({ seat, blueprint, rawTools, packVersion, formulaManifes
       identity: {
         en: `${publicTitle.en}; project-derived and not human reviewed`,
         zh: `${publicTitle.zh}；项目派生、未经人工审定`,
+        ja: `${publicTitle.en}。プロジェクト派生で、方法帰属について人による審査を受けていない暫定オペレーター・レンズ。本人の発言や現在の見解ではない。`,
+        ko: `${publicTitle.en}. 프로젝트에서 파생되었고 방법 귀속에 대한 인적 심사를 거치지 않은 임시 오퍼레이터 렌즈다. 본인의 발언이나 현재 견해가 아니다.`,
+      },
+      method: {
+        en: seat.method_scope.planning_hypothesis,
+        zh: chineseMethod,
+        ja: selectorMethodLocale(seat.persona_id, "ja"),
+        ko: selectorMethodLocale(seat.persona_id, "ko"),
       },
-      method: { en: seat.method_scope.planning_hypothesis, zh: seat.method_scope.planning_hypothesis },
       best_for: {
-        en: `Testing deterministic behavior in ${seat.method_scope.applicable_domains.join(", ")}`,
-        zh: `用于测试确定性行为：${seat.method_scope.applicable_domains.join("、")}`,
+        en: selectorBestForLocale(seat.persona_id, "en"),
+        zh: selectorBestForLocale(seat.persona_id, "zh"),
+        ja: selectorBestForLocale(seat.persona_id, "ja"),
+        ko: selectorBestForLocale(seat.persona_id, "ko"),
       },
     },
     capability: {

package/scripts/package-smoke.mjs

@@ -107,19 +107,38 @@ export async function runPackageSmoke() {
 
     const listed = await server.request("tools/list", {});
     const tools = listed.result?.tools || [];
+    assert.equal(tools.length, 31, "installed server must expose exactly 31 MCP tools");
     const names = new Set(tools.map((tool) => tool.name));
     for (const required of ["begin_council_selection", "confirm_master_selection", "plan_visible_run", "analyze_symbol"]) {
       assert.ok(names.has(required), `installed server is missing ${required}`);
     }
 
-    const prompt = "bounded installed-package smoke";
-    const opened = structured(await server.callTool("begin_council_selection", {
-      symbol: "AAPL",
-      language: "English",
-      host: "package-smoke",
-      prompt,
-    }));
-    assert.equal(opened.masters.length, 26, "installed catalog must contain exactly 26 seats");
+    const localeCases = [
+      { language: "en-US", prompt: "bounded installed-package smoke", script: /[A-Za-z]/u },
+      { language: "zh-CN", prompt: "安装包有界烟雾测试", script: /\p{Script=Han}/u },
+      { language: "ja-JP", prompt: "インストール済みパッケージの有界スモークテスト", script: /[\p{Script=Hiragana}\p{Script=Katakana}]/u },
+      { language: "ko-KR", prompt: "설치 패키지의 제한된 스모크 테스트", script: /\p{Script=Hangul}/u },
+    ];
+    let opened;
+    let prompt;
+    for (const locale of localeCases) {
+      const catalog = structured(await server.callTool("begin_council_selection", {
+        symbol: "AAPL",
+        language: locale.language,
+        host: "package-smoke",
+        prompt: locale.prompt,
+      }));
+      assert.equal(catalog.masters.length, 26, `${locale.language} installed catalog must contain exactly 26 seats`);
+      for (const master of catalog.masters) {
+        for (const field of ["identity", "method", "best_for", "maturity_label"]) {
+          assert.match(master[field], locale.script, `${locale.language} ${master.id}.${field}`);
+        }
+      }
+      if (locale.language === "zh-CN") {
+        opened = catalog;
+        prompt = locale.prompt;
+      }
+    }
 
     const confirmed = structured(await server.callTool("confirm_master_selection", {
       selection_id: opened.selection_id,
@@ -132,7 +151,7 @@ export async function runPackageSmoke() {
     const runId = `PACKAGE-SMOKE-${process.pid}`;
     const planned = structured(await server.callTool("plan_visible_run", {
       symbol: "AAPL",
-      language: "English",
+      language: "zh-CN",
       prompt,
       run_id: runId,
       tasks: ["market_data"],
@@ -143,7 +162,7 @@ export async function runPackageSmoke() {
 
     const replay = await server.callTool("plan_visible_run", {
       symbol: "AAPL",
-      language: "English",
+      language: "zh-CN",
       prompt,
       run_id: `${runId}-REPLAY`,
       tasks: ["market_data"],
@@ -152,8 +171,8 @@ export async function runPackageSmoke() {
     });
     assert.equal(replay.error?.data?.reason, "MASTER_SELECTION_REPLAYED");
 
-    process.stdout.write(`package-smoke: passed tools=${tools.length} catalog=26 selected=1 replay_rejected=true\n`);
-    return { tools: tools.length, catalog: 26, selected: 1, replay_rejected: true };
+    process.stdout.write(`package-smoke: passed tools=${tools.length} catalog=26 locales=4 selected=1 replay_rejected=true\n`);
+    return { tools: tools.length, catalog: 26, locales: 4, selected: 1, replay_rejected: true };
   } finally {
     if (!server.child.killed) await server.close().catch(() => server.child.kill());
     rmSync(dataDir, { recursive: true, force: true });

package/scripts/run-tests.mjs

@@ -32,6 +32,23 @@ export const SOURCE_PORTABLE_EXCLUDED_TESTS = Object.freeze([
 ]);
 
 export const SOURCE_PORTABLE_EXCLUDED_TEST_COUNT = 14;
+// The suite contains several package-install and hash-audit files that each spawn
+// their own child processes. Node's CPU-count default can oversubscribe large CI
+// hosts and turn deterministic sub-second fixtures into platform-specific timeouts.
+export const SOURCE_TEST_CONCURRENCY = 4;
+
+export function sourceTestConcurrencyArg(concurrency = SOURCE_TEST_CONCURRENCY, nodeVersion = process.versions.node) {
+  const [major = 0, minor = 0] = String(nodeVersion).split(".").map(Number);
+  const supported = (major === 18 && minor >= 19)
+    || (major === 20 && minor >= 10)
+    || major >= 21;
+  return supported ? `--test-concurrency=${concurrency}` : null;
+}
+
+function sourceTestArgs(files = []) {
+  const concurrencyArg = sourceTestConcurrencyArg();
+  return Object.freeze(["--test", ...(concurrencyArg ? [concurrencyArg] : []), ...files]);
+}
 
 function listMjsFiles(root, directory = join(root, "test")) {
   if (!existsSync(directory)) return [];
@@ -81,7 +98,11 @@ export function buildTestPlan(root = repoRoot) {
     return Object.freeze({ mode: "installed_package", excluded: Object.freeze([]), args: Object.freeze(["scripts/package-smoke.mjs"]) });
   }
   if (staging === "present") {
-    return Object.freeze({ mode: "source_with_staging", excluded: Object.freeze([]), args: Object.freeze(["--test"]) });
+    return Object.freeze({
+      mode: "source_with_staging",
+      excluded: Object.freeze([]),
+      args: sourceTestArgs(),
+    });
   }
 
   const excluded = new Set(SOURCE_PORTABLE_EXCLUDED_TESTS);
@@ -91,7 +112,7 @@ export function buildTestPlan(root = repoRoot) {
   return Object.freeze({
     mode: "source_portable",
     excluded: SOURCE_PORTABLE_EXCLUDED_TESTS,
-    args: Object.freeze(["--test", ...selected]),
+    args: sourceTestArgs(selected),
   });
 }