pi-pier 0.4.2 → 0.4.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-pier",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "pier: pi extension that fuses pi agent sessions with the herdr pane/tab orchestrator — todo_write loop closure + interactive subagents in isolated panes",
   "license": "MIT",
   "type": "module",

package/schemas/efficiency-config.schema.json

@@ -8,15 +8,15 @@
     "onlineContextCompact": {
       "type": "object",
       "properties": {
-        "enabled": { "type": "boolean", "default": false, "description": "是否启用待办驱动的在线上下文压缩" },
-        "logEnabled": { "type": "boolean", "default": false, "description": "是否记录在线压缩的决策与节省量日志" },
+        "enabled": { "type": "boolean", "default": false, "description": "Enable todo-driven online context compaction" },
+        "logEnabled": { "type": "boolean", "default": false, "description": "Log online compaction decisions and savings" },
         "cacheWriteReadRatio": {
           "oneOf": [
             { "type": "number", "minimum": 0 },
             { "type": "string", "enum": ["auto"] }
           ],
           "default": "auto",
-          "description": "KV 缓存写入与读取成本比。auto 表示从 ctx.model.cost 自动推导"
+          "description": "KV cache write-to-read cost ratio. auto derives it from ctx.model.cost"
         },
         "firstCompactionRequestScale": { "type": "number", "default": 2.0, "minimum": 1.0 },
         "subsequentCompactionMargin": { "type": "number", "default": 1.5, "minimum": 1.0 },
@@ -24,13 +24,13 @@
           "type": "string",
           "enum": ["inherit", "off", "minimal", "low", "medium", "high", "xhigh", "max"],
           "default": "low",
-          "description": "压缩摘要请求的 thinking 等级上限（只降不升，结束后恢复会话等级）。inherit 表示沿用会话等级"
+          "description": "Thinking level cap for compaction summary requests (only lowers, never raises; the session level is restored afterwards). inherit keeps the session level"
         },
         "keepRecentTokens": {
           "type": "integer",
           "default": 20000,
           "minimum": 1000,
-          "description": "原生压缩保留区大小（同时用于 archiveTokens 估算与 nativeCompactionFeasible 预检）。缺省自动继承 pi 的 compaction.keepRecentTokens 设置（默认 20000）。"
+          "description": "Native compaction keep-recent window size (also used for archiveTokens estimation and the nativeCompactionFeasible precheck). Defaults to inheriting pi's compaction.keepRecentTokens setting (20000 when unset)."
         }
       },
       "additionalProperties": false
@@ -38,8 +38,8 @@
     "observationPack": {
       "type": "object",
       "properties": {
-        "enabled": { "type": "boolean", "default": false, "description": "是否启用大工具输出冷热分级打包" },
-        "logEnabled": { "type": "boolean", "default": false, "description": "是否记录观察结果打包与召回日志" },
+        "enabled": { "type": "boolean", "default": false, "description": "Enable hot/cold-tiered packing of large tool outputs" },
+        "logEnabled": { "type": "boolean", "default": false, "description": "Log observation packing and recall" },
         "thresholdBytes": { "type": "integer", "default": 10240, "minimum": 1024 },
         "fullSends": { "type": "integer", "default": 2, "minimum": 1 },
         "recallChunkBytes": { "type": "integer", "default": 16384, "minimum": 1024 },
@@ -50,31 +50,31 @@
     "evidencePreservingReducer": {
       "type": "object",
       "properties": {
-        "enabled": { "type": "boolean", "default": false, "description": "是否启用长测试日志保真提炼" },
-        "logEnabled": { "type": "boolean", "default": false, "description": "是否记录提炼比对、耗时与回退日志" },
+        "enabled": { "type": "boolean", "default": false, "description": "Enable fidelity-preserving refinement of long test logs" },
+        "logEnabled": { "type": "boolean", "default": false, "description": "Log refinement comparisons, durations and fallbacks" },
         "model": {
           "type": "string",
-          "description": "专用的轻量 Reducer 模型 (provider/model)。缺省使用当前模型并在日志中提示经济性"
+          "description": "Dedicated lightweight Reducer model (provider/model). Defaults to the current model and logs an economy hint"
         },
         "minBytes": { "type": "integer", "default": 4096, "minimum": 512 },
         "maxChars": { "type": "integer", "default": 600000 },
         "maxOutputTokens": { "type": "integer", "default": 2048 },
-        "timeoutMs": { "type": "integer", "default": 5000, "description": "同步拦截超时上限，默认 5 秒避免阻塞" },
-        "localOnly": { "type": "boolean", "default": false, "description": "仅本地归档长日志并跳过模型提炼" }
+        "timeoutMs": { "type": "integer", "default": 5000, "description": "Upper bound for the synchronous interception timeout; defaults to 5s to avoid blocking" },
+        "localOnly": { "type": "boolean", "default": false, "description": "Archive long logs locally only and skip model refinement" }
       },
       "additionalProperties": false
     },
     "jev": {
       "type": "object",
-      "description": "jev 决策层（RFC docs/rfc-jev-integration.md）：可选的 System One 分类调用，逐点 fail-open",
+      "description": "jev decision layer (RFC docs/rfc-jev-integration.md): optional System One classification calls, fail-open at each point",
       "properties": {
-        "enabled": { "type": "boolean", "default": false, "description": "是否启用 jev 决策层（还需配置 apiKey 才会真正发起调用）" },
-        "logEnabled": { "type": "boolean", "default": false, "description": "是否写 efficiency-logs/jev.jsonl（不记录请求/响应 body）" },
-        "baseUrl": { "type": "string", "description": "API 根地址覆盖（中转/网关）；缺省 https://api.typesafe.ai" },
-        "model": { "type": "string", "default": "jev-1.13.0", "description": "钉住的版本化模型 id；别名会静默漂移导致校准阈值失真" },
-        "timeoutMs": { "type": "integer", "default": 2000, "minimum": 500, "description": "单次调用总预算（AbortController 硬杀，SDK 无总预算模式）" },
-        "minConfidence": { "type": "number", "default": 0.6, "minimum": 0, "maximum": 1, "description": "Choice/Score 答案被采纳的最低置信度，低于则按未回答处理" },
-        "apiKey": { "type": "string", "description": "API key。解析优先级：PIER_JEV_API_KEY 环境变量 > 此处 > TYPESAFE_API_KEY 环境变量" }
+        "enabled": { "type": "boolean", "default": false, "description": "Enable the jev decision layer (calls are only made once apiKey is configured)" },
+        "logEnabled": { "type": "boolean", "default": false, "description": "Write efficiency-logs/jev.jsonl (no request/response bodies)" },
+        "baseUrl": { "type": "string", "description": "API base URL override (proxy/gateway); defaults to https://api.typesafe.ai" },
+        "model": { "type": "string", "default": "jev-1.13.0", "description": "Pinned versioned model id; aliases drift silently and skew calibration thresholds" },
+        "timeoutMs": { "type": "integer", "default": 2000, "minimum": 500, "description": "Total budget per call (hard kill via AbortController; the SDK has no total-budget mode)" },
+        "minConfidence": { "type": "number", "default": 0.6, "minimum": 0, "maximum": 1, "description": "Minimum confidence for accepting a Choice/Score answer; below it the answer is treated as unanswered" },
+        "apiKey": { "type": "string", "description": "API key. Resolution order: PIER_JEV_API_KEY env var > this field > TYPESAFE_API_KEY env var" }
       },
       "additionalProperties": false
     }

package/schemas/role-manifest.schema.json

@@ -1,19 +1,19 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://herdr-pi.local/schemas/role-manifest.schema.json",
-  "title": "herdr-pi role manifest（D76 v2）",
-  "description": "档2 role 档案契约：version（P2 语义版本）+ roleType（P3 planner/executor/hybrid）+ 三态 rules（P1 allow/ask/deny）。运行时校验为 src/role-manifest.ts 手写零依赖实现，本文件是合同文档。",
+  "title": "herdr-pi role manifest (D76 v2)",
+  "description": "Tier-2 role manifest contract: version (P2 semantic version) + roleType (P3 planner/executor/hybrid) + tri-state rules (P1 allow/ask/deny). Runtime validation is the hand-written zero-dependency implementation in src/role-manifest.ts; this file is the contract document.",
   "type": "object",
   "properties": {
-    "role": { "type": "string", "pattern": "^[a-z0-9-]+$", "description": "角色名，须与文件名一致" },
-    "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$", "description": "语义版本 x.y.z" },
-    "model": { "type": "string", "pattern": "^[A-Za-z0-9._-]+/[A-Za-z0-9._-]+$", "description": "按角色路由模型 provider/model（WS-D10；可省略 = 进程默认）" },
+    "role": { "type": "string", "pattern": "^[a-z0-9-]+$", "description": "Role name; must match the file name" },
+    "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$", "description": "Semantic version x.y.z" },
+    "model": { "type": "string", "pattern": "^[A-Za-z0-9._-]+/[A-Za-z0-9._-]+$", "description": "Per-role model routing, provider/model (WS-D10; optional = process default)" },
     "guidelines": {
       "type": "array",
       "minItems": 1,
       "maxItems": 20,
       "items": { "type": "string", "minLength": 1 },
-      "description": "P0 per-role 行为约束（RFC §4.6）：工具集表达不了的“怎么用”约束，每轮作为 pier-role prompt section 注入；空数组请省略"
+      "description": "P0 per-role behavior constraints (RFC §4.6): constraints on \"how to use\" tools that the tool set cannot express, injected each turn as the pier-role prompt section; omit instead of passing an empty array"
     },
     "manifest": {
       "type": "object",
@@ -23,17 +23,17 @@
           "minItems": 1,
           "items": { "type": "string", "pattern": "^[a-z0-9_-]+$" },
           "uniqueItems": true,
-          "description": "基线工具；必含 todo_write 与 ask_user_question（协调工具，运行时校验强制）"
+          "description": "Baseline tools; must include todo_write and ask_user_question (coordination tools, enforced by runtime validation)"
         },
         "rules": {
           "type": "object",
           "propertyNames": { "pattern": "^[a-z0-9_*-]+$" },
           "additionalProperties": { "enum": ["allow", "ask", "deny"] },
-          "description": "三态权限；* 为通配符默认；可省略 = {\"*\":\"allow\"}"
+          "description": "Tri-state permissions; * is the wildcard default; optional = {\"*\":\"allow\"}"
         },
         "unknownTools": {
           "enum": ["allow", "deny"],
-          "description": "D82 未知工具姿态（缺省 deny）：allow = 用户安装的扩展默认可见可用（master/worker）；deny = 清单外一律不可见。与 rules 的 * 通配分属两轴（可见性 vs 强制力）"
+          "description": "D82 unknown-tool stance (default deny): allow = user-installed extensions are visible and usable by default (master/worker); deny = anything outside the list is invisible. Orthogonal to the rules * wildcard (visibility vs enforcement)"
         }
       },
       "required": ["tools"],

package/src/efficiency-config-core.ts

@@ -156,19 +156,19 @@ function issueFor(section: string, field: FieldSpec): string {
   const path = `${section}.${field.key}`;
   switch (field.kind) {
     case 'bool':
-      return `${path} 必须是 boolean`;
+      return `${path} must be a boolean`;
     case 'int':
-      return `${path} 必须是 >= ${field.min} 的整数`;
+      return `${path} must be an integer >= ${field.min}`;
     case 'number':
       return field.max === undefined
-        ? `${path} 必须是 >= ${field.minText ?? field.min} 的数字`
-        : `${path} 必须是 ${field.min} 到 ${field.max} 之间的数字`;
+        ? `${path} must be a number >= ${field.minText ?? field.min}`
+        : `${path} must be a number between ${field.min} and ${field.max}`;
     case 'ratio':
-      return `${path} 必须是 "auto" 或非负有限数`;
+      return `${path} must be "auto" or a non-negative finite number`;
     case 'enum':
-      return `${path} 必须是 ${(field.values ?? []).join(' | ')} 之一`;
+      return `${path} must be one of ${(field.values ?? []).join(' | ')}`;
     default:
-      return `${path} 必须是非空字符串`;
+      return `${path} must be a non-empty string`;
   }
 }
 
@@ -229,15 +229,15 @@ export function validateEfficiencyConfig(raw: unknown): ValidateConfigResult {
   const config = defaults();
   if (!isPlainObject(raw)) {
     for (const section of SECTIONS) config[section.name].enabled = false;
-    return { ok: false, config, issues: ['efficiency config 必须是 JSON 对象'] };
+    return { ok: false, config, issues: ['efficiency config must be a JSON object'] };
   }
 
   const issues: string[] = [];
   for (const key of Object.keys(raw)) {
-    if (key !== 'version' && !SECTIONS.some((s) => s.name === key)) issues.push(`未知顶层配置项: "${key}"`);
+    if (key !== 'version' && !SECTIONS.some((s) => s.name === key)) issues.push(`unknown top-level config key: "${key}"`);
   }
   if (raw.version !== undefined && raw.version !== 1) {
-    issues.push(`version 必须是 1 (当前: ${JSON.stringify(raw.version)})`);
+    issues.push(`version must be 1 (got: ${JSON.stringify(raw.version)})`);
   }
   const topLevelInvalid = issues.length > 0;
 
@@ -247,10 +247,10 @@ export function validateEfficiencyConfig(raw: unknown): ValidateConfigResult {
     const rawSection = raw[section.name];
     if (rawSection !== undefined) {
       if (!isPlainObject(rawSection)) {
-        issues.push(`${section.name} 必须是 JSON 对象`);
+        issues.push(`${section.name} must be a JSON object`);
       } else {
         for (const key of Object.keys(rawSection)) {
-          if (!section.fields.some((f) => f.key === key)) issues.push(`${section.name} 未知配置项: "${key}"`);
+          if (!section.fields.some((f) => f.key === key)) issues.push(`${section.name} unknown config key: "${key}"`);
         }
         for (const field of section.fields) {
           if (!applyField(target, field, rawSection[field.key])) issues.push(issueFor(section.name, field));
@@ -337,10 +337,10 @@ function applyEnvOverrides(
       continue;
     }
     const requirement =
-      override.kind === 'unit' ? '（需 0 到 1）'
-      : override.kind === 'int' ? `（需 >= ${override.min} 的整数）`
+      override.kind === 'unit' ? ' (must be 0 to 1)'
+      : override.kind === 'int' ? ` (must be an integer >= ${override.min})`
       : '';
-    warn(`无效环境变量 ${override.env}="${raw}"${requirement}，忽略`);
+    warn(`invalid environment variable ${override.env}="${raw}"${requirement}, ignored`);
   }
 }
 
@@ -361,13 +361,13 @@ export function resolveEfficiencyConfig(opts: ResolveConfigOptions = {}): Effici
   let baseRaw: unknown = opts.userConfig;
   if (opts.workspaceConfig !== undefined) {
     if (isTrusted) baseRaw = opts.workspaceConfig;
-    else warn('工作区能效配置未被信任（isProjectTrusted=false），已安全忽略工作区配置');
+    else warn('workspace efficiency config is not trusted (isProjectTrusted=false); workspace config safely ignored');
   }
 
   let resolved = defaults();
   if (baseRaw !== undefined) {
     const validated = validateEfficiencyConfig(baseRaw);
-    if (!validated.ok) warn(`配置存在校验问题，已安全回退默认值: ${validated.issues.join('; ')}`);
+    if (!validated.ok) warn(`config has validation issues; safely fell back to defaults: ${validated.issues.join('; ')}`);
     resolved = validated.config;
   }
 
@@ -440,8 +440,8 @@ export function loadEfficiencyConfigFromDisk(opts: {
   const warnFile = (label: string, filePath: string, error: unknown): void => {
     opts.onWarning?.(`${label} ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
   };
-  const workspaceConfig = readJsonConfig(wsPath, (error) => warnFile('无法解析工作区能效配置文件', wsPath, error));
-  const userConfig = readJsonConfig(userPath, (error) => warnFile('无法解析用户能效配置文件', userPath, error));
+  const workspaceConfig = readJsonConfig(wsPath, (error) => warnFile('cannot parse workspace efficiency config file', wsPath, error));
+  const userConfig = readJsonConfig(userPath, (error) => warnFile('cannot parse user efficiency config file', userPath, error));
   const resolved = resolveEfficiencyConfig({
     workspaceConfig,
     userConfig,

package/src/index-notices.ts

@@ -14,7 +14,7 @@ export function collapseNotices(contents: readonly string[], max = NOTICE_MAX_SH
   if (contents.length === 0) return null;
   if (contents.length <= max) return contents.join('\n\n');
   const hidden = contents.length - max;
-  const tail = `…另有 ${hidden} 条结算未逐条展示。全量结果看 history 台账（路径公式见 subagent resume 工具描述）；在跑代理用 subagent list 查看。`;
+  const tail = `…${hidden} more settlement(s) not shown individually. See the history ledger for full results (path formula in the subagent resume tool description); use subagent list for running agents.`;
   return [...contents.slice(0, max), tail].join('\n\n');
 }
 

package/src/index.ts

@@ -667,8 +667,8 @@ export default async function (pi: ExtensionAPI) {
     // D96: master settled while background subagents still run → remind (worker port is unbound).
     if (plan.wake && plan.notice && !isSubagent) {
       const running = subagentPort.current?.listRunningSubs() ?? [];
-      const brief = running.map((s) => `${s.paneId} (${s.description})`).join('、');
-      const notice = `注意：仍有 ${running.length} 个后台 subagent 在运行：${brief}。若你的任务依赖它们，请等待其结算（subagent list 查看状态）；若不等待，请说明放弃原因。`;
+      const brief = running.map((s) => `${s.paneId} (${s.description})`).join(', ');
+      const notice = `Note: ${running.length} background subagent(s) still running: ${brief}. If your task depends on them, wait for their settlement (subagent list to check status); if you will not wait, state why you are abandoning them.`;
       void sendUserMessageAs(notice, 'followUp');
     }
     if (plan.compact && ctx && typeof ctx === 'object') {

package/src/manifest-compose.ts

@@ -36,7 +36,7 @@ export function composeManifest(sources: ManifestSources): ComposedManifest {
   if (baseline.length === 0) {
     throw new ManifestError(
       'INVALID_ROLE_CONFIG',
-      'INVALID_ROLE_CONFIG: 基线工具不能为空，至少需包含 todo_write 和 ask_user_question',
+      'INVALID_ROLE_CONFIG: baseline tools must not be empty; todo_write and ask_user_question are required',
     );
   }
   const candidates = new Set<string>([
@@ -62,9 +62,9 @@ export function composeManifest(sources: ManifestSources): ComposedManifest {
   if (tools.length === 0) {
     throw new ManifestError(
       'EMPTY_MANIFEST',
-      `裁剪后 manifest 为空（deny-all trap？）。基线: ${baseline.join(', ') || '(空)'}；` +
-        `模型建议: ${sources.modelSuggested.join(', ') || '(无)'}；` +
-        `规则: ${JSON.stringify(rules)}`,
+      `Trimmed manifest is empty (deny-all trap?). Baseline: ${baseline.join(', ') || '(empty)'}; ` +
+        `model suggestions: ${sources.modelSuggested.join(', ') || '(none)'}; ` +
+        `rules: ${JSON.stringify(rules)}`,
     );
   }
 

package/src/plugins/todo.ts

@@ -376,7 +376,7 @@ export default function todoPlugin(ctx: Context): void {
       }
       const age = archivedAgeMs();
       const head = formatTodoSummary(todos.items)
-        + (age != null ? ` · archived ${formatAge(age)}（不再注入）` : '');
+        + (age != null ? ` · archived ${formatAge(age)} (no longer injected)` : '');
       ui?.notify?.([head, ...body].join('\n'), 'info');
     },
   });

package/src/reducer-invoker.ts

@@ -105,7 +105,7 @@ function resolveCandidate(
   if (!isTrusted) {
     if (!untrustedWarningEmitted) {
       untrustedWarningEmitted = true;
-      console.warn('[pi-herdr] EPR 提炼已在未受信任项目中被安全禁用');
+      console.warn('[pi-herdr] EPR refinement is safely disabled in untrusted projects');
     }
     return undefined;
   }

package/src/role-loader.ts

@@ -98,7 +98,7 @@ export function listRoleNames(baseDir?: string, userDir?: string): string[] {
 
 export function loadRoleConfig(name: string, opts?: LoadRoleOptions): RoleManifest {
   if (typeof name !== 'string' || !ROLE_NAME_RE.test(name)) {
-    throw new RoleLoaderError('ROLE_NOT_FOUND', `role 不存在或名字非法（[a-z0-9-]+）: ${JSON.stringify(name)}`);
+    throw new RoleLoaderError('ROLE_NOT_FOUND', `role not found or invalid name ([a-z0-9-]+): ${JSON.stringify(name)}`);
   }
   const fileName = `${name}.json`;
 
@@ -108,7 +108,7 @@ export function loadRoleConfig(name: string, opts?: LoadRoleOptions): RoleManife
       text = opts.read(fileName);
     } catch (err) {
       const code = (err as { code?: unknown })?.code;
-      throw new RoleLoaderError('ROLE_NOT_FOUND', `role "${name}" 不存在（读 ${fileName} 失败: ${typeof code === 'string' ? code : 'error'}）`);
+      throw new RoleLoaderError('ROLE_NOT_FOUND', `role "${name}" not found (failed to read ${fileName}: ${typeof code === 'string' ? code : 'error'})`);
     }
     return parseAndValidate(name, fileName, text, 'builtin (src/roles/)');
   }
@@ -123,7 +123,7 @@ export function loadRoleConfig(name: string, opts?: LoadRoleOptions): RoleManife
       if (layerRead(layer.dir, fileName) != null) {
         throw new RoleLoaderError(
           'ROLE_RESERVED',
-          `role "${name}" 是内置保留名，不能在 ${layer.label} 层定义（内置档案优先；请删除该档案或改名）`,
+          `role "${name}" is a reserved built-in name and cannot be defined in the ${layer.label} layer (built-in manifests take precedence; delete that file or rename it)`,
         );
       }
     }
@@ -136,7 +136,7 @@ export function loadRoleConfig(name: string, opts?: LoadRoleOptions): RoleManife
   }
   throw new RoleLoaderError(
     'ROLE_NOT_FOUND',
-    `role "${name}" 不存在（查找层：${layers.map((l) => l.label).join(' → ')}）`,
+    `role "${name}" not found (searched layers: ${layers.map((l) => l.label).join(' → ')})`,
   );
 }
 
@@ -145,22 +145,22 @@ function parseAndValidate(name: string, fileName: string, text: string, layerLab
   try {
     parsed = JSON.parse(text);
   } catch (err) {
-    throw new RoleLoaderError('INVALID_ROLE_CONFIG', `role "${name}"（${layerLabel}）不是合法 JSON: ${(err as Error).message}`);
+    throw new RoleLoaderError('INVALID_ROLE_CONFIG', `role "${name}" (${layerLabel}) is not valid JSON: ${(err as Error).message}`);
   }
   const result = validateRoleManifest(parsed);
   // `ok === false` (instead of `!ok`) is required to narrow without strictNullChecks.
   if (result.ok === false) {
     throw new RoleLoaderError(
       'INVALID_ROLE_CONFIG',
-      `role "${name}"（${layerLabel}）校验失败:\n${result.issues.map((i) => `  - ${i}`).join('\n')}`,
+      `role "${name}" (${layerLabel}) failed validation:\n${result.issues.map((i) => `  - ${i}`).join('\n')}`,
       result.issues,
     );
   }
   if (result.value.role !== name) {
     throw new RoleLoaderError(
       'INVALID_ROLE_CONFIG',
-      `role 档案名不符：${layerLabel} 的 ${fileName} 内 role="${result.value.role}"`,
-      [`role 字段 "${result.value.role}" 与请求的 "${name}" 不一致`],
+      `role manifest name mismatch: role="${result.value.role}" in ${fileName} of ${layerLabel}`,
+      [`role field "${result.value.role}" does not match the requested "${name}"`],
     );
   }
   return result.value;

package/src/role-manifest.ts

@@ -53,79 +53,79 @@ const ACTIONS: readonly PermissionAction[] = ['allow', 'ask', 'deny'];
 export function validateRoleManifest(input: unknown): ValidateResult {
   const issues: string[] = [];
   if (!isPlainObject(input)) {
-    return { ok: false, code: 'INVALID_ROLE_CONFIG', issues: ['role 档案必须是 JSON 对象'] };
+    return { ok: false, code: 'INVALID_ROLE_CONFIG', issues: ['role manifest must be a JSON object'] };
   }
 
   const KNOWN_TOP = new Set(['role', 'version', 'model', 'description', 'guidelines', 'manifest', 'services']);
   for (const k of Object.keys(input)) {
-    if (!KNOWN_TOP.has(k)) issues.push(`未知顶层键 "${k}"（契约外字段，检查拼写）`);
+    if (!KNOWN_TOP.has(k)) issues.push(`unknown top-level key "${k}" (not in the contract; check spelling)`);
   }
 
   if (typeof input.role !== 'string' || !ROLE_NAME_RE.test(input.role)) {
-    issues.push(`role 必须是 [a-z0-9-]+ 字符串，收到 ${JSON.stringify(input.role)}`);
+    issues.push(`role must be a [a-z0-9-]+ string, got ${JSON.stringify(input.role)}`);
   }
 
   if (typeof input.version !== 'string' || !SEMVER_RE.test(input.version)) {
-    issues.push(`version 必须是 x.y.z 三段数字（如 1.0.0），收到 ${JSON.stringify(input.version)}`);
+    issues.push(`version must be three dot-separated numbers x.y.z (e.g. 1.0.0), got ${JSON.stringify(input.version)}`);
   }
 
   if (input.model !== undefined) {
     if (typeof input.model !== 'string' || !/^[A-Za-z0-9._-]+\/[A-Za-z0-9._-]+$/.test(input.model)) {
-      issues.push(`model 必须是 provider/model 形态（如 opencode-go/muse-spark-1.2-contributor），收到 ${JSON.stringify(input.model)}`);
+      issues.push(`model must be in provider/model form (e.g. opencode-go/muse-spark-1.2-contributor), got ${JSON.stringify(input.model)}`);
     }
   }
 
   if (input.description !== undefined && typeof input.description !== 'string') {
-    issues.push('description 必须是字符串');
+    issues.push('description must be a string');
   }
 
   if (input.guidelines !== undefined) {
     if (!Array.isArray(input.guidelines)) {
-      issues.push('guidelines 必须是字符串数组');
+      issues.push('guidelines must be an array of strings');
     } else if (input.guidelines.length === 0) {
-      issues.push('guidelines 为空数组时请直接省略该字段');
+      issues.push('omit guidelines entirely instead of passing an empty array');
     } else if (!input.guidelines.every((g) => typeof g === 'string' && g.trim() !== '')) {
-      issues.push('guidelines 的每一项必须是非空字符串');
+      issues.push('every guidelines entry must be a non-empty string');
     } else if (input.guidelines.length > 20) {
-      issues.push('guidelines 最多 20 条（prompt 预算保护）');
+      issues.push('at most 20 guidelines (prompt budget protection)');
     }
   }
 
   const m = input.manifest;
   if (!isPlainObject(m)) {
-    issues.push('manifest 必须是对象');
+    issues.push('manifest must be an object');
   } else {
     const KNOWN_MANIFEST = new Set(['tools', 'rules', 'unknownTools']);
     for (const k of Object.keys(m)) {
-      if (!KNOWN_MANIFEST.has(k)) issues.push(`manifest 内未知键 "${k}"`);
+      if (!KNOWN_MANIFEST.has(k)) issues.push(`unknown key "${k}" in manifest`);
     }
 
     if (m.unknownTools !== undefined && m.unknownTools !== 'allow' && m.unknownTools !== 'deny') {
-      issues.push(`manifest.unknownTools 必须是 allow/deny，收到 ${JSON.stringify(m.unknownTools)}`);
+      issues.push(`manifest.unknownTools must be allow/deny, got ${JSON.stringify(m.unknownTools)}`);
     }
 
     const tools = m.tools;
     if (!Array.isArray(tools) || !tools.every((t) => typeof t === 'string' && TOOL_KEY_RE.test(t))) {
-      issues.push('manifest.tools 必须是非空字符串数组（工具名 [a-z0-9_-]）');
+      issues.push('manifest.tools must be a non-empty array of strings (tool names [a-z0-9_-])');
     } else {
       const seen = new Set<string>();
       for (const t of tools) {
-        if (seen.has(t)) issues.push(`manifest.tools 重复项 "${t}"`);
+        if (seen.has(t)) issues.push(`duplicate entry in manifest.tools "${t}"`);
         seen.add(t);
       }
       for (const need of COORDINATION_TOOLS) {
-        if (!seen.has(need)) issues.push(`基线非空约束：manifest.tools 必须包含 "${need}"（协调工具）`);
+        if (!seen.has(need)) issues.push(`non-empty baseline constraint: manifest.tools must include "${need}" (coordination tool)`);
       }
     }
 
     if (m.rules !== undefined) {
       if (!isPlainObject(m.rules)) {
-        issues.push('manifest.rules 必须是对象');
+        issues.push('manifest.rules must be an object');
       } else {
         for (const [k, v] of Object.entries(m.rules)) {
-          if (!TOOL_KEY_RE.test(k)) issues.push(`rules 键 "${k}" 不是合法工具名（[a-z0-9_-] 或 *）`);
+          if (!TOOL_KEY_RE.test(k)) issues.push(`rules key "${k}" is not a valid tool name ([a-z0-9_-] or *)`);
           if (!ACTIONS.includes(v as PermissionAction)) {
-            issues.push(`rules["${k}"] 必须是 ${ACTIONS.join('/')} 之一，收到 ${JSON.stringify(v)}`);
+            issues.push(`rules["${k}"] must be one of ${ACTIONS.join('/')}, got ${JSON.stringify(v)}`);
           }
         }
       }
@@ -134,14 +134,14 @@ export function validateRoleManifest(input: unknown): ValidateResult {
 
   if (input.services !== undefined) {
     if (!isPlainObject(input.services)) {
-      issues.push('services 必须是对象');
+      issues.push('services must be an object');
     } else if (input.services.todos !== undefined) {
       const t = input.services.todos;
       if (!isPlainObject(t)) {
-        issues.push('services.todos 必须是对象');
+        issues.push('services.todos must be an object');
       } else {
         if (t.mode !== undefined && t.mode !== 'serial' && t.mode !== 'parallel') {
-          issues.push(`services.todos.mode 必须是 serial/parallel，收到 ${JSON.stringify(t.mode)}`);
+          issues.push(`services.todos.mode must be serial/parallel, got ${JSON.stringify(t.mode)}`);
         }
       }
     }

package/src/roles/master.json

@@ -1,7 +1,7 @@
 {
   "role": "master",
   "version": "1.4.0",
-  "description": "主控角色（WS-D7 自应用；D83 镜像源）：核心工具（todos/协调/subagent/terminal）+ pi 内建 + web_search；D82 unknownTools=allow。v1.4.0: 工具合并 terminal 6→1, subagent 5→1",
+  "description": "Master role (WS-D7 self-application; D83 mirror source): core tools (todos/coordination/subagent/terminal) + pi built-ins + web_search; D82 unknownTools=allow. v1.4.0: tool consolidation terminal 6→1, subagent 5→1",
   "manifest": {
     "unknownTools": "allow",
     "tools": [

package/src/roles/worker-default.json

@@ -1,7 +1,7 @@
 {
   "role": "worker-default",
   "version": "1.6.0",
-  "description": "默认worker角色（D83 继承制）：镜像 master.tools 减 subagent/terminal（禁嵌套、资源归属）；排除族显式 deny——在 D82 unknownTools=allow 姿态下仍持禁令；todos serial。v1.6.0: 删除 report_progress（一周 0 调用，D125）；v1.5.0: Phase 2 显式放行 report_progress；v1.4.0: 工具合并后更新 deny 列表",
+  "description": "Default worker role (D83 inheritance): mirrors master.tools minus subagent/terminal (no nesting, resource ownership); excluded families explicitly denied — still banned under the D82 unknownTools=allow stance; todos serial. v1.6.0: removed report_progress (0 calls in a week, D125); v1.5.0: Phase 2 explicitly allowed report_progress; v1.4.0: refreshed the deny list after tool consolidation",
   "manifest": {
     "unknownTools": "allow",
     "tools": [

package/src/tree-view.ts

@@ -66,7 +66,7 @@ export function workerLine(row: WorkerWidgetRow): string {
     const counts = countsOf(items);
     if (!cur) return `↳ ${ref} ${counts}`;
     if (cur.status === 'blocked') {
-      const why = cur.blocker && cur.blocker !== cur.content ? `（${clip(cur.blocker, 24)}）` : '';
+      const why = cur.blocker && cur.blocker !== cur.content ? ` (${clip(cur.blocker, 24)})` : '';
       return `↳ ${ref} ■ ${clip(cur.content, 40)}${why} ${counts}`;
     }
     return `↳ ${ref} ▶ ${clip(cur.content)} ${counts}`;
@@ -85,7 +85,7 @@ export function selfLine(items: readonly TodoItem[]): string | null {
   const cur = currentOf(items);
   if (!cur) return null;
   const counts = countsOf(items);
-  if (cur.status === 'blocked') return `■ 等人: ${clip(cur.blocker || cur.content, 40)} ${counts}`;
+  if (cur.status === 'blocked') return `■ waiting on: ${clip(cur.blocker || cur.content, 40)} ${counts}`;
   return `▶ ${clip(cur.content)} ${counts}`;
 }
 
@@ -100,8 +100,8 @@ export function unifiedWidgetLines(
   // Human gate open: the question owns the fixed area (unchanged discipline from the old widget).
   if ((opts?.blockedDepth ?? 0) > 0) {
     return workers.length === 0 || items.length === 0
-      ? [`${formatTodoSummary(items)} · /todos 全量`]
-      : [`${formatTodoSummary(items)} · ↳×${workers.length} · /todos 全量`];
+      ? [`${formatTodoSummary(items)} · /todos for all`]
+      : [`${formatTodoSummary(items)} · ↳×${workers.length} · /todos for all`];
   }
   if (items.length === 0 && workers.length === 0) return [];
   // Archived plans keep their degraded two-line form; workers stay visible underneath.
@@ -114,7 +114,7 @@ export function unifiedWidgetLines(
   const budget = WIDGET_MAX_LINES - head.length - 1;
   const shown = rows.slice(0, Math.max(budget, 0));
   const hidden = rows.length - shown.length;
-  return [...head, ...shown, ...(hidden > 0 ? [`…另 ${hidden} 个子代理 · /pier-tree`] : [])];
+  return [...head, ...shown, ...(hidden > 0 ? [`…+${hidden} more subagents · /pier-tree`] : [])];
 }
 
 /** Full delegation tree for /pier-tree: self todos in full + per-worker full lists + settled nodes. */
@@ -126,15 +126,15 @@ export function formatDelegationTree(opts: {
 }): string[] {
   const now = opts.now ?? Date.now();
   const lines: string[] = ['==================== PIER DELEGATION TREE ===================='];
-  lines.push(`● master（本 pane）· ${opts.selfItems.length} 项`);
+  lines.push(`● master (this pane) · ${opts.selfItems.length} items`);
   lines.push(...renderTodoGroups(opts.selfItems).map((l) => `  ${l}`));
   if (opts.workers.length > 0 || (opts.settled?.length ?? 0) > 0) lines.push('  │');
   for (const w of opts.workers) {
     const ref = w.slug ?? w.paneId;
     const items = w.todos?.items;
     const headSuffix = items && items.length > 0
-      ? `· ${items.length} 项`
-      : w.todos?.summary ? `· ${clip(w.todos.summary, 40)}` : '· todo 未同步';
+      ? `· ${items.length} items`
+      : w.todos?.summary ? `· ${clip(w.todos.summary, 40)}` : '· todos not synced';
     lines.push(`  ├─ ↳ ${ref} (${w.paneId} · running${w.kind && w.kind !== 'task' ? ` · ${w.kind}` : ''}) ${headSuffix}`);
     if (items && items.length > 0) {
       lines.push(...renderTodoGroups(toTodoItems(items)).map((l) => `  │    ${l}`));
@@ -143,10 +143,10 @@ export function formatDelegationTree(opts: {
   for (const s of opts.settled ?? []) {
     const ref = s.slug ?? s.paneId;
     const age = s.settledAt ? ` · settled ${formatAge(Math.max(now - s.settledAt, 0))} ago` : ' · settled';
-    lines.push(`  └─ ✓ ${ref} (${s.paneId}${age}) — 结果已注入结算通知`);
+    lines.push(`  └─ ✓ ${ref} (${s.paneId}${age}) — result delivered in the settlement notice`);
   }
   lines.push('----------------------------------------------------------------');
-  lines.push('提示: /todos 编辑自己的清单 · subagent list 交互子代理 · /dashboard ops 面板');
+  lines.push('Hint: /todos edit your own list · subagent list interact with subagents · /dashboard ops panel');
   return lines;
 }