@co-engram/core 0.1.0

package/dist/i18n/field-names.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Engram / Synapse 磁盘字段名双语映射
+ *
+ * 设计要点：
+ * - 内存运行时字段名永远是英文（`EngramFrontmatter` interface 的硬约束）
+ * - 磁盘 YAML 字段名根据当前 language 决定（英文 identity / 中文映射）
+ * - `__lang` / `__语言` 是保留字段：写入时填入，读取后剥离（不进入运行时对象）
+ * - 反向索引在模块加载时一次性构建（O(1) lookup）
+ *
+ * @module @co-engram/core/i18n
+ */
+import type { Language } from "./types.js";
+/**
+ * Frontmatter 中标记语言的保留字段（写入时填入，delocalize 时剥离）
+ *
+ * 英文模式：`__lang: en`
+ * 中文模式：`__语言: zh`
+ */
+export declare const LANG_MARKER_FIELD_EN = "__lang";
+export declare const LANG_MARKER_FIELD_ZH = "__\u8BED\u8A00";
+/**
+ * Engram frontmatter 字段映射
+ *
+ * key = 运行时英文字段名（与 `EngramFrontmatter` interface 对齐）
+ * value = 该语言下的磁盘字段名
+ */
+export declare const ENGRAM_FIELD_MAP: Readonly<Record<Language, Readonly<Record<string, string>>>>;
+/**
+ * Synapse 顶层字段映射
+ */
+export declare const SYNAPSE_FIELD_MAP: Readonly<Record<Language, Readonly<Record<string, string>>>>;
+/**
+ * SynapseEvidence 嵌套字段映射（数组元素的 shape）
+ */
+export declare const SYNAPSE_EVIDENCE_FIELD_MAP: Readonly<Record<Language, Readonly<Record<string, string>>>>;
+/**
+ * SynapseResolutionState 嵌套字段映射
+ */
+export declare const SYNAPSE_RESOLUTION_FIELD_MAP: Readonly<Record<Language, Readonly<Record<string, string>>>>;
+export declare const ENGRAM_FIELD_REVERSE_MAP: Readonly<Record<string, string>>;
+export declare const SYNAPSE_FIELD_REVERSE_MAP: Readonly<Record<string, string>>;
+export declare const SYNAPSE_EVIDENCE_FIELD_REVERSE_MAP: Readonly<Record<string, string>>;
+export declare const SYNAPSE_RESOLUTION_FIELD_REVERSE_MAP: Readonly<Record<string, string>>;
+/**
+ * 把对象的所有 key 按 fieldMap 替换为目标语言的磁盘字段名
+ *
+ * - 值保持不变（包括嵌套数组/对象，调用方负责递归）
+ * - 写入前调用
+ *
+ * @param obj 原始对象（运行时英文 keys）
+ * @param language 目标语言
+ * @param fieldMap 字段映射表（ENGRAM_FIELD_MAP / SYNAPSE_FIELD_MAP / ...）
+ * @param options.attachLangMarker 是否追加 `__lang` / `__语言` 标记字段
+ */
+export declare function localizeKeys<T extends Record<string, unknown>>(obj: T, language: Language, fieldMap: Readonly<Record<Language, Readonly<Record<string, string>>>>, options?: {
+    attachLangMarker?: boolean;
+}): Record<string, unknown>;
+/**
+ * 把磁盘读出的对象 key 归一化为运行时英文字段名
+ *
+ * - 反向索引找不到的 key 原样保留（兼容未知字段 / 扩展字段）
+ * - 剥离语言标记字段（`__lang` / `__语言`），返回值附带检测到的语言
+ *
+ * @param rawObj 磁盘读出的对象（YAML parse 结果）
+ * @param reverseMap 反向索引
+ */
+export declare function delocalizeKeys(rawObj: Record<string, unknown>, reverseMap: Readonly<Record<string, string>>): {
+    normalized: Record<string, unknown>;
+    detectedLanguage: Language | undefined;
+};
+/**
+ * 递归 localize Synapse 完整对象（顶层 + evidence[] + resolutionState）
+ *
+ * Synapse 的嵌套结构需要递归处理，不能只映射顶层。
+ */
+export declare function localizeSynapse(synapse: Record<string, unknown>, language: Language, options?: {
+    attachLangMarker?: boolean;
+}): Record<string, unknown>;
+/**
+ * 递归 delocalize Synapse 完整对象（磁盘 → 运行时）
+ */
+export declare function delocalizeSynapse(rawSynapse: Record<string, unknown>): {
+    normalized: Record<string, unknown>;
+    detectedLanguage: Language | undefined;
+};
+/**
+ * 启发式检测：磁盘读出的对象是否使用中文字段名
+ *
+ * 仅在 `__lang` / `__语言` 标记缺失时使用。检测条件：
+ * - 对象包含任意一个中文 keys（来自 ENGRAM_FIELD_MAP.zh / SYNAPSE_FIELD_MAP.zh）
+ *
+ * @param rawKeys 磁盘读出的对象的所有 key
+ */
+export declare function detectChineseKeys(rawKeys: readonly string[]): boolean;
+//# sourceMappingURL=field-names.d.ts.map

package/dist/i18n/field-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-names.d.ts","sourceRoot":"","sources":["../../src/i18n/field-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAC7C,eAAO,MAAM,oBAAoB,mBAAS,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CACrC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CA4EnD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CACtC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAkCnD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAC/C,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAgBnD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CACjD,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CA0BnD,CAAC;AAwBF,eAAO,MAAM,wBAAwB,kCAAoC,CAAC;AAC1E,eAAO,MAAM,yBAAyB,kCAAqC,CAAC;AAC5E,eAAO,MAAM,kCAAkC,kCAE9C,CAAC;AACF,eAAO,MAAM,oCAAoC,kCAEhD,CAAC;AAUF;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,GAAG,EAAE,CAAC,EACN,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EACtE,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,GACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC3C;IACD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,gBAAgB,EAAE,QAAQ,GAAG,SAAS,CAAC;CACxC,CAeA;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,GACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+BzB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACtE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,gBAAgB,EAAE,QAAQ,GAAG,SAAS,CAAC;CACxC,CA6BA;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAQrE"}

package/dist/i18n/field-names.js

@@ -0,0 +1,329 @@
+/**
+ * Engram / Synapse 磁盘字段名双语映射
+ *
+ * 设计要点：
+ * - 内存运行时字段名永远是英文（`EngramFrontmatter` interface 的硬约束）
+ * - 磁盘 YAML 字段名根据当前 language 决定（英文 identity / 中文映射）
+ * - `__lang` / `__语言` 是保留字段：写入时填入，读取后剥离（不进入运行时对象）
+ * - 反向索引在模块加载时一次性构建（O(1) lookup）
+ *
+ * @module @co-engram/core/i18n
+ */
+/**
+ * Frontmatter 中标记语言的保留字段（写入时填入，delocalize 时剥离）
+ *
+ * 英文模式：`__lang: en`
+ * 中文模式：`__语言: zh`
+ */
+export const LANG_MARKER_FIELD_EN = "__lang";
+export const LANG_MARKER_FIELD_ZH = "__语言";
+/**
+ * Engram frontmatter 字段映射
+ *
+ * key = 运行时英文字段名（与 `EngramFrontmatter` interface 对齐）
+ * value = 该语言下的磁盘字段名
+ */
+export const ENGRAM_FIELD_MAP = {
+    en: {
+        id: "id",
+        title: "title",
+        slug: "slug",
+        kind: "kind",
+        kinds: "kinds",
+        tags: "tags",
+        domainTags: "domainTags",
+        summary: "summary",
+        contentHash: "contentHash",
+        contentSize: "contentSize",
+        createdBy: "createdBy",
+        createdAt: "createdAt",
+        updatedBy: "updatedBy",
+        updatedAt: "updatedAt",
+        version: "version",
+        importance: "importance",
+        confidence: "confidence",
+        emotionalValence: "emotionalValence",
+        sourceType: "sourceType",
+        evidenceCount: "evidenceCount",
+        retrievalCount: "retrievalCount",
+        effectiveRetrievals: "effectiveRetrievals",
+        failedUses: "failedUses",
+        reinforcementScore: "reinforcementScore",
+        decayHalfLifeDays: "decayHalfLifeDays",
+        lastRetrievedAt: "lastRetrievedAt",
+        lastEffectiveAt: "lastEffectiveAt",
+        lastRetrievalScore: "lastRetrievalScore",
+        forcedFreshness: "forcedFreshness",
+        status: "status",
+        visibility: "visibility",
+        verificationStatus: "verificationStatus",
+        encodingContext: "encodingContext",
+        perspective: "perspective",
+        contextTags: "contextTags",
+    },
+    zh: {
+        id: "标识",
+        title: "标题",
+        slug: "别名",
+        kind: "类型",
+        kinds: "类型列表",
+        tags: "标签",
+        domainTags: "领域标签",
+        summary: "摘要",
+        contentHash: "内容哈希",
+        contentSize: "内容大小",
+        createdBy: "创建者",
+        createdAt: "创建时间",
+        updatedBy: "更新者",
+        updatedAt: "更新时间",
+        version: "版本",
+        importance: "重要性",
+        confidence: "置信度",
+        emotionalValence: "情感极性",
+        sourceType: "来源类型",
+        evidenceCount: "证据数",
+        retrievalCount: "检索次数",
+        effectiveRetrievals: "有效检索数",
+        failedUses: "失败使用数",
+        reinforcementScore: "强化分数",
+        decayHalfLifeDays: "半衰期天数",
+        lastRetrievedAt: "最近检索时间",
+        lastEffectiveAt: "最近有效时间",
+        lastRetrievalScore: "最近检索分数",
+        forcedFreshness: "强制新鲜度",
+        status: "状态",
+        visibility: "可见性",
+        verificationStatus: "验证状态",
+        encodingContext: "编码情境",
+        perspective: "视角",
+        contextTags: "情境标签",
+    },
+};
+/**
+ * Synapse 顶层字段映射
+ */
+export const SYNAPSE_FIELD_MAP = {
+    en: {
+        id: "id",
+        from: "from",
+        to: "to",
+        kind: "kind",
+        weight: "weight",
+        direction: "direction",
+        evidence: "evidence",
+        createdBy: "createdBy",
+        createdAt: "createdAt",
+        updatedAt: "updatedAt",
+        retrievalWeight: "retrievalWeight",
+        sourceSemantic: "sourceSemantic",
+        targetSemantic: "targetSemantic",
+        resolutionState: "resolutionState",
+    },
+    zh: {
+        id: "标识",
+        from: "起点",
+        to: "终点",
+        kind: "类型",
+        weight: "权重",
+        direction: "方向",
+        evidence: "证据",
+        createdBy: "创建者",
+        createdAt: "创建时间",
+        updatedAt: "更新时间",
+        retrievalWeight: "检索权重",
+        sourceSemantic: "源语义",
+        targetSemantic: "目标语义",
+        resolutionState: "裁决状态",
+    },
+};
+/**
+ * SynapseEvidence 嵌套字段映射（数组元素的 shape）
+ */
+export const SYNAPSE_EVIDENCE_FIELD_MAP = {
+    en: {
+        description: "description",
+        source: "source",
+        confidence: "confidence",
+        addedAt: "addedAt",
+        addedBy: "addedBy",
+    },
+    zh: {
+        description: "描述",
+        source: "来源",
+        confidence: "置信度",
+        addedAt: "添加时间",
+        addedBy: "添加者",
+    },
+};
+/**
+ * SynapseResolutionState 嵌套字段映射
+ */
+export const SYNAPSE_RESOLUTION_FIELD_MAP = {
+    en: {
+        status: "status",
+        phase: "phase",
+        verdict: "verdict",
+        rationale: "rationale",
+        confidence: "confidence",
+        escalatedTo: "escalatedTo",
+        escalatedAt: "escalatedAt",
+        expiresAt: "expiresAt",
+        resolvedAt: "resolvedAt",
+        resolvedBy: "resolvedBy",
+    },
+    zh: {
+        status: "状态",
+        phase: "阶段",
+        verdict: "裁决",
+        rationale: "理由",
+        confidence: "置信度",
+        escalatedTo: "升级给",
+        escalatedAt: "升级时间",
+        expiresAt: "过期时间",
+        resolvedAt: "解决时间",
+        resolvedBy: "解决者",
+    },
+};
+/**
+ * 模块加载时构建的反向索引：磁盘字段名（任意语言）→ 运行时英文字段名
+ *
+ * 若同一个中文 key 恰好与某个英文 key 重名（实际不会发生，因为中文 keys 都是中文词），
+ * 英文优先（先注册）。
+ */
+function buildReverseMap(fieldMap) {
+    const reverse = {};
+    // 先注册英文（identity），再注册中文；若冲突英文优先
+    for (const [enKey, enDiskKey] of Object.entries(fieldMap.en)) {
+        reverse[enDiskKey] = enKey;
+    }
+    for (const [enKey, zhDiskKey] of Object.entries(fieldMap.zh)) {
+        if (!(zhDiskKey in reverse)) {
+            reverse[zhDiskKey] = enKey;
+        }
+    }
+    return Object.freeze(reverse);
+}
+export const ENGRAM_FIELD_REVERSE_MAP = buildReverseMap(ENGRAM_FIELD_MAP);
+export const SYNAPSE_FIELD_REVERSE_MAP = buildReverseMap(SYNAPSE_FIELD_MAP);
+export const SYNAPSE_EVIDENCE_FIELD_REVERSE_MAP = buildReverseMap(SYNAPSE_EVIDENCE_FIELD_MAP);
+export const SYNAPSE_RESOLUTION_FIELD_REVERSE_MAP = buildReverseMap(SYNAPSE_RESOLUTION_FIELD_MAP);
+/**
+ * 语言标记字段的反向索引：磁盘标记名 → 是否中文
+ */
+const LANG_MARKER_REVERSE = {
+    [LANG_MARKER_FIELD_EN]: false,
+    [LANG_MARKER_FIELD_ZH]: true,
+};
+/**
+ * 把对象的所有 key 按 fieldMap 替换为目标语言的磁盘字段名
+ *
+ * - 值保持不变（包括嵌套数组/对象，调用方负责递归）
+ * - 写入前调用
+ *
+ * @param obj 原始对象（运行时英文 keys）
+ * @param language 目标语言
+ * @param fieldMap 字段映射表（ENGRAM_FIELD_MAP / SYNAPSE_FIELD_MAP / ...）
+ * @param options.attachLangMarker 是否追加 `__lang` / `__语言` 标记字段
+ */
+export function localizeKeys(obj, language, fieldMap, options) {
+    const targetMap = fieldMap[language];
+    const out = {};
+    for (const [runtimeKey, value] of Object.entries(obj)) {
+        const diskKey = targetMap[runtimeKey] ?? runtimeKey;
+        out[diskKey] = value;
+    }
+    if (options?.attachLangMarker) {
+        if (language === "zh") {
+            out[LANG_MARKER_FIELD_ZH] = "zh";
+        }
+        else {
+            out[LANG_MARKER_FIELD_EN] = "en";
+        }
+    }
+    return out;
+}
+/**
+ * 把磁盘读出的对象 key 归一化为运行时英文字段名
+ *
+ * - 反向索引找不到的 key 原样保留（兼容未知字段 / 扩展字段）
+ * - 剥离语言标记字段（`__lang` / `__语言`），返回值附带检测到的语言
+ *
+ * @param rawObj 磁盘读出的对象（YAML parse 结果）
+ * @param reverseMap 反向索引
+ */
+export function delocalizeKeys(rawObj, reverseMap) {
+    const normalized = {};
+    let detectedLanguage;
+    for (const [diskKey, value] of Object.entries(rawObj)) {
+        // 先检测语言标记
+        if (diskKey in LANG_MARKER_REVERSE) {
+            detectedLanguage = LANG_MARKER_REVERSE[diskKey] ? "zh" : "en";
+            continue; // 标记字段不进入运行时对象
+        }
+        const runtimeKey = reverseMap[diskKey] ?? diskKey;
+        normalized[runtimeKey] = value;
+    }
+    return { normalized, detectedLanguage };
+}
+/**
+ * 递归 localize Synapse 完整对象（顶层 + evidence[] + resolutionState）
+ *
+ * Synapse 的嵌套结构需要递归处理，不能只映射顶层。
+ */
+export function localizeSynapse(synapse, language, options) {
+    const topLocalized = localizeKeys(synapse, language, SYNAPSE_FIELD_MAP, options);
+    const synapseMap = SYNAPSE_FIELD_MAP[language];
+    // evidence: 数组，每个元素用 SYNAPSE_EVIDENCE_FIELD_MAP
+    const evidenceDiskKey = synapseMap.evidence;
+    if (Array.isArray(topLocalized[evidenceDiskKey])) {
+        topLocalized[evidenceDiskKey] = topLocalized[evidenceDiskKey].map((item) => localizeKeys(item, language, SYNAPSE_EVIDENCE_FIELD_MAP));
+    }
+    // resolutionState: 对象（可选），用 SYNAPSE_RESOLUTION_FIELD_MAP
+    const resolutionDiskKey = synapseMap.resolutionState;
+    if (topLocalized[resolutionDiskKey] &&
+        typeof topLocalized[resolutionDiskKey] === "object") {
+        topLocalized[resolutionDiskKey] = localizeKeys(topLocalized[resolutionDiskKey], language, SYNAPSE_RESOLUTION_FIELD_MAP);
+    }
+    return topLocalized;
+}
+/**
+ * 递归 delocalize Synapse 完整对象（磁盘 → 运行时）
+ */
+export function delocalizeSynapse(rawSynapse) {
+    const { normalized: topNormalized, detectedLanguage } = delocalizeKeys(rawSynapse, SYNAPSE_FIELD_REVERSE_MAP);
+    // evidence 反向映射
+    if (Array.isArray(topNormalized.evidence)) {
+        topNormalized.evidence = topNormalized.evidence.map((item) => {
+            const ev = delocalizeKeys(item, SYNAPSE_EVIDENCE_FIELD_REVERSE_MAP);
+            return ev.normalized;
+        });
+    }
+    // resolutionState 反向映射
+    if (topNormalized.resolutionState &&
+        typeof topNormalized.resolutionState === "object") {
+        const rs = delocalizeKeys(topNormalized.resolutionState, SYNAPSE_RESOLUTION_FIELD_REVERSE_MAP);
+        topNormalized.resolutionState = rs.normalized;
+    }
+    return { normalized: topNormalized, detectedLanguage };
+}
+/**
+ * 启发式检测：磁盘读出的对象是否使用中文字段名
+ *
+ * 仅在 `__lang` / `__语言` 标记缺失时使用。检测条件：
+ * - 对象包含任意一个中文 keys（来自 ENGRAM_FIELD_MAP.zh / SYNAPSE_FIELD_MAP.zh）
+ *
+ * @param rawKeys 磁盘读出的对象的所有 key
+ */
+export function detectChineseKeys(rawKeys) {
+    const zhKeys = new Set();
+    for (const zk of Object.values(ENGRAM_FIELD_MAP.zh))
+        zhKeys.add(zk);
+    for (const zk of Object.values(SYNAPSE_FIELD_MAP.zh))
+        zhKeys.add(zk);
+    for (const zk of Object.values(SYNAPSE_EVIDENCE_FIELD_MAP.zh))
+        zhKeys.add(zk);
+    for (const zk of Object.values(SYNAPSE_RESOLUTION_FIELD_MAP.zh))
+        zhKeys.add(zk);
+    return rawKeys.some((k) => zhKeys.has(k));
+}
+//# sourceMappingURL=field-names.js.map

package/dist/i18n/field-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-names.js","sourceRoot":"","sources":["../../src/i18n/field-names.ts"],"names":[],"mappings":"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"}

package/dist/i18n/index.d.ts

@@ -0,0 +1,92 @@
+/**
+ * i18n 公共 API
+ *
+ * 翻译函数 + 工具描述本地化 + 语言解析工具。
+ *
+ * @module @co-engram/core/i18n
+ */
+import type { Language, StringKey, TranslationDict } from "./types.js";
+import { en } from "./en.js";
+import { zh } from "./zh.js";
+export { TEAM_MEMORY_CONFIG_FILENAME, readTeamMemoryConfig, writeTeamMemoryConfig, } from "../config/index.js";
+export type { TeamMemoryConfig } from "../config/types.js";
+import type { TeamMemoryConfig } from "../config/types.js";
+/**
+ * 默认语言
+ *
+ * 默认中文(本项目主要面向中文团队)。国际团队可在 `.co-engram/config.json`
+ * 或 `CO_ENGRAM_LANGUAGE=en` 显式覆盖。
+ */
+export declare const DEFAULT_LANGUAGE: Language;
+/**
+ * 所有支持的语言
+ */
+export declare const SUPPORTED_LANGUAGES: readonly Language[];
+/**
+ * 把任意字符串解析为 Language,无法识别时返回默认语言
+ *
+ * 接受 'en' / 'zh' / 'EN' / 'ZH' / 'english' / 'chinese' / 'zh-CN' / 'zh-CN' 等。
+ */
+export declare function parseLanguage(raw: string | undefined | null): Language;
+/**
+ * 翻译函数
+ *
+ * - 在字典里找不到 key 时,返回 key 本身(便于发现遗漏)
+ * - 接受可选的 vars 参数,做 ${name} 模板替换
+ *
+ * @example
+ * ```ts
+ * t('en', 'tool.engram_create')
+ * t('zh', 'prompt.proposal_prompt', { count: 3, plural: 's' })
+ * ```
+ */
+export declare function t(language: Language, key: StringKey, vars?: Readonly<Record<string, string | number>>): string;
+/**
+ * 本地化工具描述
+ *
+ * 在 i18n 字典里没有对应翻译时,fallback 到原始 description(向后兼容)。
+ *
+ * @param toolName snake_case 工具名,如 'engram_create'
+ * @param language 目标语言
+ * @param fallback 原始 description(host adapter 注入)
+ */
+export declare function localizeToolDescription(toolName: string, language: Language, fallback?: string): string;
+/**
+ * 翻译字符串并把模板变量替换好(等价于 t())
+ *
+ * 主要用于 host adapter 在 register 时一次性把模板字符串转成最终文本。
+ */
+export declare function translatePrompt(language: Language, key: StringKey, vars?: Readonly<Record<string, string | number>>): string;
+/**
+ * 把数字按英文复数规则返回 's' 或 ''
+ *
+ * 中文场景下返回 ''(中文没有复数形式),英文场景下 1 返回 '' 其余返回 's'。
+ */
+export declare function pluralSuffix(language: Language, count: number): string;
+/**
+ * 解析语言优先级
+ *
+ * 解析顺序(高 → 低):
+ *   1. envLanguage 显式传入(来自 CO_ENGRAM_LANGUAGE)
+ *   2. team-memory 持久化配置(`.co-engram/config.json`)
+ *   3. DEFAULT_LANGUAGE
+ *
+ * 这样可以让 env 覆盖持久化配置(临时实验),持久化覆盖默认。
+ *
+ * @param envLanguage 来自环境变量的值(可识别 'en'/'zh' 等)
+ * @param persistedConfig 来自 .co-engram/config.json 的配置(可能为 undefined)
+ */
+export declare function resolveLanguage(envLanguage: string | undefined, persistedConfig?: TeamMemoryConfig): Language;
+/**
+ * 读取 team-memory 持久化配置
+ *
+ * 文件路径:`${dataRoot}/.co-engram/${TEAM_MEMORY_CONFIG_FILENAME}`
+ *
+ * 如果文件不存在或解析失败,返回 undefined(不抛错,因为首次启动时确实没有)。
+ *
+ * @param dataRoot team-memory 根目录
+ * @param fsRead 可选的自定义读取函数(测试注入用);默认走 node:fs
+ */
+export { en, zh };
+export type { Language, StringKey, TranslationDict };
+//# sourceMappingURL=index.d.ts.map

package/dist/i18n/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAG7B,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAe,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,QAAQ,EAAiB,CAAC;AAUrE;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,QAAQ,CAOtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,CAAC,CACf,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,SAAS,EACd,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,GAC/C,MAAM,CAOR;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAQR;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,SAAS,EACd,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,GAC/C,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,eAAe,CAAC,EAAE,gBAAgB,GACjC,QAAQ,CAIV;AAED;;;;;;;;;GASG;AAKH,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;AAClB,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC"}

package/dist/i18n/index.js

@@ -0,0 +1,135 @@
+/**
+ * i18n 公共 API
+ *
+ * 翻译函数 + 工具描述本地化 + 语言解析工具。
+ *
+ * @module @co-engram/core/i18n
+ */
+import { en } from "./en.js";
+import { zh } from "./zh.js";
+// 配置相关 API 已迁至 @co-engram/core/config。这里保留 re-export 以向后兼容。
+export { TEAM_MEMORY_CONFIG_FILENAME, readTeamMemoryConfig, writeTeamMemoryConfig, } from "../config/index.js";
+/**
+ * 默认语言
+ *
+ * 默认中文(本项目主要面向中文团队)。国际团队可在 `.co-engram/config.json`
+ * 或 `CO_ENGRAM_LANGUAGE=en` 显式覆盖。
+ */
+export const DEFAULT_LANGUAGE = "zh";
+/**
+ * 所有支持的语言
+ */
+export const SUPPORTED_LANGUAGES = ["en", "zh"];
+/**
+ * 字典表(只读)
+ */
+const DICTIONARIES = {
+    en,
+    zh,
+};
+/**
+ * 把任意字符串解析为 Language,无法识别时返回默认语言
+ *
+ * 接受 'en' / 'zh' / 'EN' / 'ZH' / 'english' / 'chinese' / 'zh-CN' / 'zh-CN' 等。
+ */
+export function parseLanguage(raw) {
+    if (!raw)
+        return DEFAULT_LANGUAGE;
+    const lower = raw.toLowerCase().trim();
+    if (lower === "en" || lower === "english")
+        return "en";
+    if (lower.startsWith("zh") || lower === "chinese" || lower === "cn")
+        return "zh";
+    return DEFAULT_LANGUAGE;
+}
+/**
+ * 翻译函数
+ *
+ * - 在字典里找不到 key 时,返回 key 本身(便于发现遗漏)
+ * - 接受可选的 vars 参数,做 ${name} 模板替换
+ *
+ * @example
+ * ```ts
+ * t('en', 'tool.engram_create')
+ * t('zh', 'prompt.proposal_prompt', { count: 3, plural: 's' })
+ * ```
+ */
+export function t(language, key, vars) {
+    const dict = DICTIONARIES[language] ?? en;
+    const template = dict[key] ?? en[key] ?? key;
+    if (!vars)
+        return template;
+    return template.replace(/\$\{(\w+)\}/g, (_, name) => vars[name] !== undefined ? String(vars[name]) : `\${${name}}`);
+}
+/**
+ * 本地化工具描述
+ *
+ * 在 i18n 字典里没有对应翻译时,fallback 到原始 description(向后兼容)。
+ *
+ * @param toolName snake_case 工具名,如 'engram_create'
+ * @param language 目标语言
+ * @param fallback 原始 description(host adapter 注入)
+ */
+export function localizeToolDescription(toolName, language, fallback) {
+    const key = `tool.${toolName}`;
+    const dict = DICTIONARIES[language];
+    const translated = dict[key];
+    if (translated)
+        return translated;
+    // fallback 顺序:目标语言找不到 → 英文 → 原始
+    const enDict = en;
+    return enDict[key] ?? fallback ?? toolName;
+}
+/**
+ * 翻译字符串并把模板变量替换好(等价于 t())
+ *
+ * 主要用于 host adapter 在 register 时一次性把模板字符串转成最终文本。
+ */
+export function translatePrompt(language, key, vars) {
+    return t(language, key, vars);
+}
+/**
+ * 把数字按英文复数规则返回 's' 或 ''
+ *
+ * 中文场景下返回 ''(中文没有复数形式),英文场景下 1 返回 '' 其余返回 's'。
+ */
+export function pluralSuffix(language, count) {
+    if (language === "en")
+        return count === 1 ? "" : "s";
+    return "";
+}
+/**
+ * 解析语言优先级
+ *
+ * 解析顺序(高 → 低):
+ *   1. envLanguage 显式传入(来自 CO_ENGRAM_LANGUAGE)
+ *   2. team-memory 持久化配置(`.co-engram/config.json`)
+ *   3. DEFAULT_LANGUAGE
+ *
+ * 这样可以让 env 覆盖持久化配置(临时实验),持久化覆盖默认。
+ *
+ * @param envLanguage 来自环境变量的值(可识别 'en'/'zh' 等)
+ * @param persistedConfig 来自 .co-engram/config.json 的配置(可能为 undefined)
+ */
+export function resolveLanguage(envLanguage, persistedConfig) {
+    if (envLanguage)
+        return parseLanguage(envLanguage);
+    if (persistedConfig?.language)
+        return parseLanguage(persistedConfig.language);
+    return DEFAULT_LANGUAGE;
+}
+/**
+ * 读取 team-memory 持久化配置
+ *
+ * 文件路径:`${dataRoot}/.co-engram/${TEAM_MEMORY_CONFIG_FILENAME}`
+ *
+ * 如果文件不存在或解析失败,返回 undefined(不抛错,因为首次启动时确实没有)。
+ *
+ * @param dataRoot team-memory 根目录
+ * @param fsRead 可选的自定义读取函数(测试注入用);默认走 node:fs
+ */
+// readTeamMemoryConfig / writeTeamMemoryConfig 已迁至 @co-engram/core/config,
+// 此处由顶部 `export ... from '../config/index.js'` 提供。
+// 保留 unresolved re-export 以维持向后兼容的命名导入。
+export { en, zh };
+//# sourceMappingURL=index.js.map