dsh-config-manager 0.1.71 → 0.1.72

package/src/foreign/gemini.ts

@@ -16,6 +16,7 @@
 import { normalizePlatform } from './platform-paths.ts';
 import { draftFromTranscript, sessionSourceOf } from './session-source.ts';
 import type { RootProbeOptions } from './session-source.ts';
+import { engineMsg } from './messages.ts';
 import { FOREIGN_TRUTH_TABLES } from './truth-table.ts';
 import type { ForeignTruthTableEntry } from './truth-table.ts';
 import type { ForeignSource } from './registry.ts';
@@ -28,7 +29,7 @@ export const GEMINI_PROVIDER = 'gemini';
 
 function truthEntryOf(id: ForeignSourceId): ForeignTruthTableEntry {
   const found = FOREIGN_TRUTH_TABLES.find((entry) => entry.id === id);
-  if (found === undefined) throw new Error('真值表缺少来源定义: ' + id);
+  if (found === undefined) throw new Error(engineMsg('foreign.truthTableMissingSource', { id }));
   return found;
 }
 

package/src/foreign/goose.ts

@@ -18,6 +18,7 @@ import { draftFromTranscript } from './session-source.ts';
 import type { RootProbeOptions, SessionDraft } from './session-source.ts';
 import { sessionSourceOf } from './session-source.ts';
 import type { ForeignSource } from './registry.ts';
+import { engineMsg } from './messages.ts';
 import { FOREIGN_TRUTH_TABLES } from './truth-table.ts';
 import type { ForeignTruthTableEntry } from './truth-table.ts';
 import type { ForeignEvidenceKind, ForeignSourceId } from './types.ts';
@@ -27,7 +28,7 @@ import { gooseDbPath, readGoose } from './read-goose.ts';
 /** 真值表条目（找不到即装配期炸：宁可炸，也不让来源悄悄少一份取证声明 —— 与 registry.ts 同口径） */
 function truthEntryOf(id: ForeignSourceId): ForeignTruthTableEntry {
   const found = FOREIGN_TRUTH_TABLES.find((entry) => entry.id === id);
-  if (found === undefined) throw new Error('真值表缺少来源定义: ' + id);
+  if (found === undefined) throw new Error(engineMsg('foreign.truthTableMissingSource', { id }));
   return found;
 }
 

package/src/foreign/kilocode.ts

@@ -17,6 +17,7 @@ import { draftFromTranscript } from './session-source.ts';
 import type { RootProbeOptions, SessionDraft } from './session-source.ts';
 import { sessionSourceOf } from './session-source.ts';
 import type { ForeignSource } from './registry.ts';
+import { engineMsg } from './messages.ts';
 import { FOREIGN_TRUTH_TABLES } from './truth-table.ts';
 import type { ForeignTruthTableEntry } from './truth-table.ts';
 import type { ForeignEvidenceKind, ForeignSourceId } from './types.ts';
@@ -26,7 +27,7 @@ import { kilocodeDbPath, readKilocode } from './read-kilocode.ts';
 /** 真值表条目（找不到即装配期炸：宁可炸，也不让来源悄悄少一份取证声明 —— 与 registry.ts 同口径） */
 function truthEntryOf(id: ForeignSourceId): ForeignTruthTableEntry {
   const found = FOREIGN_TRUTH_TABLES.find((entry) => entry.id === id);
-  if (found === undefined) throw new Error('真值表缺少来源定义: ' + id);
+  if (found === undefined) throw new Error(engineMsg('foreign.truthTableMissingSource', { id }));
   return found;
 }
 

package/src/foreign/kimi.ts

@@ -18,6 +18,7 @@
 import { normalizePlatform } from './platform-paths.ts';
 import { draftFromTranscript, sessionSourceOf } from './session-source.ts';
 import type { RootProbeOptions } from './session-source.ts';
+import { engineMsg } from './messages.ts';
 import { FOREIGN_TRUTH_TABLES } from './truth-table.ts';
 import type { ForeignTruthTableEntry } from './truth-table.ts';
 import type { ForeignSource } from './registry.ts';
@@ -30,7 +31,7 @@ export const KIMI_PROVIDER = 'kimi';
 
 function truthEntryOf(id: ForeignSourceId): ForeignTruthTableEntry {
   const found = FOREIGN_TRUTH_TABLES.find((entry) => entry.id === id);
-  if (found === undefined) throw new Error('真值表缺少来源定义: ' + id);
+  if (found === undefined) throw new Error(engineMsg('foreign.truthTableMissingSource', { id }));
   return found;
 }
 

package/src/foreign/messages.ts

@@ -0,0 +1,44 @@
+/**
+ * foreign 域（src/foreign/**）的追加消息目录（zh 源 / en 镜像），归 t6 作用域。
+ *
+ * 为什么不在 \`src/core/messages.ts\` 追加：该文件不在本作用域的 inScope 内，且既有 372 键有冻结指纹。
+ * 本模块经 \`registerMessageCatalog\` 注册**追加目录**：engineMsg / makeMsg 的查找顺序是
+ * 「既有目录 → en 下回退既有 zh → 注册目录 → 键名」，所以本域新键只在既有目录未命中时生效。
+ *
+ * 纪律：zh 值 = 改动前的既有中文文案**逐字原样**；en 为 \`Record<keyof typeof zh, string>\`（缺键即编译错）。
+ * **导入本模块即完成注册**：本域消费面是 engineMsg（装配期抛错的文案），导入本模块即完成目录注册。
+ * 注：\`src/foreign/truth-table.ts\` 的取证文本是数据（守卫 §3.5 白名单 61 命中），不在本目录范围。
+ */
+import { engineMsg as engineMsgOf, registerMessageCatalog } from '../core/engine-locale.ts';
+import type { MsgFunc } from '../core/msg-types.ts';
+
+export const zh = {
+  // ---------- 外部来源注册表 ----------
+  'foreign.truthTableMissingSource': '真值表缺少来源定义: {id}',
+  'foreign.truthTableMissingSourceDetailed': '真值表缺少来源定义: {id}（truth-table.ts 是 evidence/probePaths 的单一事实源）',
+  'foreign.availableSourcesEmpty': '(空)',
+  'foreign.duplicateSourceId': '外部来源 id 重复注册: {id}；可用: {available}',
+  'foreign.unknownSourceId': '未知外部来源 id: {id}；可用: {available}',
+  'foreign.invalidSourceDefinition': '外部来源定义非法: {id}；可用: {available}',
+  'foreign.sourceIdMissing': '(无 id)',
+  // ---------- bundle 装配 ----------
+  'foreign.bundleFileSectionPrefixMissing': '外部导入：文件类分区缺少 ZIP 前缀 {section}',
+  'foreign.bundleJsonSectionPathMissing': '外部导入：JSON 类分区缺少 ZIP 路径 {section}',
+} as const;
+
+export const en: Record<keyof typeof zh, string> = {
+  'foreign.truthTableMissingSource': 'The truth table has no definition for source {id}',
+  'foreign.truthTableMissingSourceDetailed': 'The truth table has no definition for source {id} (truth-table.ts is the single source of truth for evidence/probePaths)',
+  'foreign.availableSourcesEmpty': '(none)',
+  'foreign.duplicateSourceId': 'Duplicate external source id: {id}; available: {available}',
+  'foreign.unknownSourceId': 'Unknown external source id: {id}; available: {available}',
+  'foreign.invalidSourceDefinition': 'Invalid external source definition: {id}; available: {available}',
+  'foreign.sourceIdMissing': '(no id)',
+  'foreign.bundleFileSectionPrefixMissing': 'External import: file section is missing its ZIP prefix {section}',
+  'foreign.bundleJsonSectionPathMissing': 'External import: JSON section is missing its ZIP path {section}',
+};
+
+registerMessageCatalog({ id: 'foreign-domain', zh, en });
+
+/** 本域活翻译器（与 core 的 engineMsg 同一实现；导入本模块即完成目录注册）。 */
+export const engineMsg: MsgFunc = engineMsgOf;

package/src/foreign/mimocode.ts

@@ -17,6 +17,7 @@ import { draftFromTranscript } from './session-source.ts';
 import type { RootProbeOptions, SessionDraft } from './session-source.ts';
 import { sessionSourceOf } from './session-source.ts';
 import type { ForeignSource } from './registry.ts';
+import { engineMsg } from './messages.ts';
 import { FOREIGN_TRUTH_TABLES } from './truth-table.ts';
 import type { ForeignTruthTableEntry } from './truth-table.ts';
 import type { ForeignEvidenceKind, ForeignSourceId } from './types.ts';
@@ -26,7 +27,7 @@ import { mimocodeDbPath, readMimocode } from './read-mimocode.ts';
 /** 真值表条目（找不到即装配期炸：宁可炸，也不让来源悄悄少一份取证声明 —— 与 registry.ts 同口径） */
 function truthEntryOf(id: ForeignSourceId): ForeignTruthTableEntry {
   const found = FOREIGN_TRUTH_TABLES.find((entry) => entry.id === id);
-  if (found === undefined) throw new Error('真值表缺少来源定义: ' + id);
+  if (found === undefined) throw new Error(engineMsg('foreign.truthTableMissingSource', { id }));
   return found;
 }
 

package/src/foreign/openclaw.ts

@@ -18,6 +18,7 @@
 import { normalizePlatform } from './platform-paths.ts';
 import { draftFromTranscript, sessionSourceOf } from './session-source.ts';
 import type { RootProbeOptions } from './session-source.ts';
+import { engineMsg } from './messages.ts';
 import { FOREIGN_TRUTH_TABLES } from './truth-table.ts';
 import type { ForeignTruthTableEntry } from './truth-table.ts';
 import type { ForeignSource } from './registry.ts';
@@ -30,7 +31,7 @@ export const OPENCLAW_PROVIDER = 'openclaw';
 
 function truthEntryOf(id: ForeignSourceId): ForeignTruthTableEntry {
   const found = FOREIGN_TRUTH_TABLES.find((entry) => entry.id === id);
-  if (found === undefined) throw new Error('真值表缺少来源定义: ' + id);
+  if (found === undefined) throw new Error(engineMsg('foreign.truthTableMissingSource', { id }));
   return found;
 }
 

package/src/foreign/opencode.ts

@@ -18,6 +18,7 @@ import { draftFromTranscript } from './session-source.ts';
 import type { RootProbeOptions, SessionDraft } from './session-source.ts';
 import { sessionSourceOf } from './session-source.ts';
 import type { ForeignSource } from './registry.ts';
+import { engineMsg } from './messages.ts';
 import { FOREIGN_TRUTH_TABLES } from './truth-table.ts';
 import type { ForeignTruthTableEntry } from './truth-table.ts';
 import type { ForeignEvidenceKind, ForeignSourceId } from './types.ts';
@@ -27,7 +28,7 @@ import { opencodeDbPath, readOpencode } from './read-opencode.ts';
 /** 真值表条目（找不到即装配期炸：宁可炸，也不让来源悄悄少一份取证声明 —— 与 registry.ts 同口径） */
 function truthEntryOf(id: ForeignSourceId): ForeignTruthTableEntry {
   const found = FOREIGN_TRUTH_TABLES.find((entry) => entry.id === id);
-  if (found === undefined) throw new Error('真值表缺少来源定义: ' + id);
+  if (found === undefined) throw new Error(engineMsg('foreign.truthTableMissingSource', { id }));
   return found;
 }
 

package/src/foreign/pi.ts

@@ -20,6 +20,7 @@
 import { normalizePlatform } from './platform-paths.ts';
 import { draftFromTranscript, sessionSourceOf } from './session-source.ts';
 import type { RootProbeOptions } from './session-source.ts';
+import { engineMsg } from './messages.ts';
 import { FOREIGN_TRUTH_TABLES } from './truth-table.ts';
 import type { ForeignTruthTableEntry } from './truth-table.ts';
 import type { ForeignSource } from './registry.ts';
@@ -32,7 +33,7 @@ export const PI_PROVIDER = 'pi';
 
 function truthEntryOf(id: ForeignSourceId): ForeignTruthTableEntry {
   const found = FOREIGN_TRUTH_TABLES.find((entry) => entry.id === id);
-  if (found === undefined) throw new Error('真值表缺少来源定义: ' + id);
+  if (found === undefined) throw new Error(engineMsg('foreign.truthTableMissingSource', { id }));
   return found;
 }
 

package/src/foreign/qoder.ts

@@ -16,6 +16,7 @@
 import { normalizePlatform } from './platform-paths.ts';
 import { draftFromTranscript, sessionSourceOf } from './session-source.ts';
 import type { RootProbeOptions } from './session-source.ts';
+import { engineMsg } from './messages.ts';
 import { FOREIGN_TRUTH_TABLES } from './truth-table.ts';
 import type { ForeignTruthTableEntry } from './truth-table.ts';
 import type { ForeignSource } from './registry.ts';
@@ -29,7 +30,7 @@ export const QODER_PROVIDER = 'qoder';
 /** 按 id 取真值表条目；缺条目 = 装配期错误（宁可炸，也不悄悄少一份取证声明） */
 function truthEntryOf(id: ForeignSourceId): ForeignTruthTableEntry {
   const found = FOREIGN_TRUTH_TABLES.find((entry) => entry.id === id);
-  if (found === undefined) throw new Error('真值表缺少来源定义: ' + id);
+  if (found === undefined) throw new Error(engineMsg('foreign.truthTableMissingSource', { id }));
   return found;
 }
 

package/src/foreign/qwen.ts

@@ -17,6 +17,7 @@
 import { normalizePlatform } from './platform-paths.ts';
 import { draftFromTranscript, sessionSourceOf } from './session-source.ts';
 import type { RootProbeOptions } from './session-source.ts';
+import { engineMsg } from './messages.ts';
 import { FOREIGN_TRUTH_TABLES } from './truth-table.ts';
 import type { ForeignTruthTableEntry } from './truth-table.ts';
 import type { ForeignSource } from './registry.ts';
@@ -29,7 +30,7 @@ export const QWEN_PROVIDER = 'qwen';
 
 function truthEntryOf(id: ForeignSourceId): ForeignTruthTableEntry {
   const found = FOREIGN_TRUTH_TABLES.find((entry) => entry.id === id);
-  if (found === undefined) throw new Error('真值表缺少来源定义: ' + id);
+  if (found === undefined) throw new Error(engineMsg('foreign.truthTableMissingSource', { id }));
   return found;
 }
 

package/src/foreign/registry.ts

@@ -38,6 +38,7 @@ import { readCursor } from './read-cursor.ts';
 import { readHermes, resolveHermesHome } from './read-hermes.ts';
 import { normalizePlatform, roamingAppDataDir, xdgDataHome } from './platform-paths.ts';
 import type { ForeignPlatform } from './platform-paths.ts';
+import { engineMsg } from './messages.ts';
 import { FOREIGN_TRUTH_TABLES } from './truth-table.ts';
 import type { ForeignTruthTableEntry } from './truth-table.ts';
 /* ---- 档 B 24 个会话类来源的装配点（每一条自带 wiring，经 sessionSourceOf 收口）---- */
@@ -221,10 +222,10 @@ function describeForeignSourceError(
   sourceId: string,
   available: readonly string[],
 ): string {
-  const list = available.length > 0 ? available.join(', ') : '(空)';
-  if (code === 'duplicate-source') return '外部来源 id 重复注册: ' + sourceId + '；可用: ' + list;
-  if (code === 'unknown-source') return '未知外部来源 id: ' + sourceId + '；可用: ' + list;
-  return '外部来源定义非法: ' + sourceId + '；可用: ' + list;
+  const list = available.length > 0 ? available.join(', ') : engineMsg('foreign.availableSourcesEmpty');
+  if (code === 'duplicate-source') return engineMsg('foreign.duplicateSourceId', { id: sourceId, available: list });
+  if (code === 'unknown-source') return engineMsg('foreign.unknownSourceId', { id: sourceId, available: list });
+  return engineMsg('foreign.invalidSourceDefinition', { id: sourceId, available: list });
 }
 
 /* ---------------- 注册表 ---------------- */
@@ -278,7 +279,7 @@ function assertValidSource(source: ForeignSource, available: readonly string[]):
   const raw = source as { id?: unknown; labelKey?: unknown; detect?: unknown; build?: unknown };
   const id = typeof raw.id === 'string' ? raw.id : '';
   if (!isForeignSourceId(id)) {
-    throw new ForeignSourceError('invalid-source', id === '' ? '(无 id)' : id, available);
+    throw new ForeignSourceError('invalid-source', id === '' ? engineMsg('foreign.sourceIdMissing') : id, available);
   }
   if (typeof raw.labelKey !== 'string' || raw.labelKey === '') {
     throw new ForeignSourceError('invalid-source', id, available);
@@ -426,7 +427,7 @@ async function probeTree(
 function truthEntryOf(id: ForeignSourceId): ForeignTruthTableEntry {
   const found = FOREIGN_TRUTH_TABLES.find((entry) => entry.id === id);
   if (found === undefined) {
-    throw new Error('真值表缺少来源定义: ' + id + '（truth-table.ts 是 evidence/probePaths 的单一事实源）');
+    throw new Error(engineMsg('foreign.truthTableMissingSourceDetailed', { id }));
   }
   return found;
 }

package/src/foreign/teleagent.ts

@@ -18,6 +18,7 @@ import { draftFromTranscript } from './session-source.ts';
 import type { RootProbeOptions, SessionDraft } from './session-source.ts';
 import { sessionSourceOf } from './session-source.ts';
 import type { ForeignSource } from './registry.ts';
+import { engineMsg } from './messages.ts';
 import { FOREIGN_TRUTH_TABLES } from './truth-table.ts';
 import type { ForeignTruthTableEntry } from './truth-table.ts';
 import type { ForeignEvidenceKind, ForeignSourceId } from './types.ts';
@@ -27,7 +28,7 @@ import { readTeleagent, teleagentUsersDir } from './read-teleagent.ts';
 /** 真值表条目（找不到即装配期炸：宁可炸，也不让来源悄悄少一份取证声明 —— 与 registry.ts 同口径） */
 function truthEntryOf(id: ForeignSourceId): ForeignTruthTableEntry {
   const found = FOREIGN_TRUTH_TABLES.find((entry) => entry.id === id);
-  if (found === undefined) throw new Error('真值表缺少来源定义: ' + id);
+  if (found === undefined) throw new Error(engineMsg('foreign.truthTableMissingSource', { id }));
   return found;
 }
 

package/src/foreign/workbuddy.ts

@@ -17,6 +17,7 @@
 import { normalizePlatform } from './platform-paths.ts';
 import { draftFromTranscript, sessionSourceOf } from './session-source.ts';
 import type { RootProbeOptions } from './session-source.ts';
+import { engineMsg } from './messages.ts';
 import { FOREIGN_TRUTH_TABLES } from './truth-table.ts';
 import type { ForeignTruthTableEntry } from './truth-table.ts';
 import type { ForeignSource } from './registry.ts';
@@ -29,7 +30,7 @@ export const WORKBUDDY_PROVIDER = 'workbuddy';
 
 function truthEntryOf(id: ForeignSourceId): ForeignTruthTableEntry {
   const found = FOREIGN_TRUTH_TABLES.find((entry) => entry.id === id);
-  if (found === undefined) throw new Error('真值表缺少来源定义: ' + id);
+  if (found === undefined) throw new Error(engineMsg('foreign.truthTableMissingSource', { id }));
   return found;
 }
 

package/src/foreign/zcode.ts

@@ -17,6 +17,7 @@ import { draftFromTranscript } from './session-source.ts';
 import type { RootProbeOptions, SessionDraft } from './session-source.ts';
 import { sessionSourceOf } from './session-source.ts';
 import type { ForeignSource } from './registry.ts';
+import { engineMsg } from './messages.ts';
 import { FOREIGN_TRUTH_TABLES } from './truth-table.ts';
 import type { ForeignTruthTableEntry } from './truth-table.ts';
 import type { ForeignEvidenceKind, ForeignSourceId } from './types.ts';
@@ -26,7 +27,7 @@ import { readZcode, zcodeDbPath } from './read-zcode.ts';
 /** 真值表条目（找不到即装配期炸：宁可炸，也不让来源悄悄少一份取证声明 —— 与 registry.ts 同口径） */
 function truthEntryOf(id: ForeignSourceId): ForeignTruthTableEntry {
   const found = FOREIGN_TRUTH_TABLES.find((entry) => entry.id === id);
-  if (found === undefined) throw new Error('真值表缺少来源定义: ' + id);
+  if (found === undefined) throw new Error(engineMsg('foreign.truthTableMissingSource', { id }));
   return found;
 }
 

package/src/foreign/zed.ts

@@ -18,6 +18,7 @@ import { draftFromTranscript } from './session-source.ts';
 import type { RootProbeOptions, SessionDraft } from './session-source.ts';
 import { sessionSourceOf } from './session-source.ts';
 import type { ForeignSource } from './registry.ts';
+import { engineMsg } from './messages.ts';
 import { FOREIGN_TRUTH_TABLES } from './truth-table.ts';
 import type { ForeignTruthTableEntry } from './truth-table.ts';
 import type { ForeignEvidenceKind, ForeignSourceId } from './types.ts';
@@ -27,7 +28,7 @@ import { readZed, zedThreadsDbPath } from './read-zed.ts';
 /** 真值表条目（找不到即装配期炸：宁可炸，也不让来源悄悄少一份取证声明 —— 与 registry.ts 同口径） */
 function truthEntryOf(id: ForeignSourceId): ForeignTruthTableEntry {
   const found = FOREIGN_TRUTH_TABLES.find((entry) => entry.id === id);
-  if (found === undefined) throw new Error('真值表缺少来源定义: ' + id);
+  if (found === undefined) throw new Error(engineMsg('foreign.truthTableMissingSource', { id }));
   return found;
 }