dotmem 0.1.1 → 0.1.3

package/global.cjs

@@ -1657,7 +1657,10 @@ var init_discover = __esm({
 `);
       }
     }, "diagnostic");
-    DEFAULT_LIMITS = { current: 5, deep: 25 };
+    DEFAULT_LIMITS = {
+      current: 8,
+      deep: 25
+    };
     FIELD_ORDER = [
       "id",
       "knowledge",
@@ -2882,7 +2885,7 @@ var init_policy_store = __esm({
 });
 
 // core/knowledge/acquisition-limits.ts
-var MEMORY_ACQUIRE_LIMITS, MEMORY_ACQUIRE_LIMITS_MCP, MEMORY_STORE_LIMITS, DOTMEM_ACQUIRE_ERROR_CODES, MemoryAcquireLimitError, MemoryAcquireConcurrencyError, encoder, serializedBytes, measureKnowledge, checkAcquireLimits;
+var MEMORY_ACQUIRE_LIMITS, MEMORY_ACQUIRE_LIMITS_MCP, MEMORY_STORE_LIMITS, DOTMEM_ACQUIRE_ERROR_CODES, MemoryAcquireLimitError, MemoryAcquireConcurrencyError, MemoryAcquireDuplicateClaimError, encoder, serializedBytes, measureKnowledge, checkAcquireLimits;
 var init_acquisition_limits = __esm({
   "core/knowledge/acquisition-limits.ts"() {
     MEMORY_ACQUIRE_LIMITS = Object.freeze({
@@ -2905,7 +2908,8 @@ var init_acquisition_limits = __esm({
       STORE_UNREADABLE: "DOTMEM_STORE_UNREADABLE",
       CONCURRENT_WRITE: "DOTMEM_CONCURRENT_WRITE",
       SESSION_ACQUIRE_LIMIT: "DOTMEM_SESSION_ACQUIRE_LIMIT",
-      POLICY_REFUSED: "DOTMEM_POLICY_REFUSED"
+      POLICY_REFUSED: "DOTMEM_POLICY_REFUSED",
+      DUPLICATE_CLAIM: "DOTMEM_DUPLICATE_CLAIM"
     });
     MemoryAcquireLimitError = class extends Error {
       static {
@@ -2929,6 +2933,17 @@ var init_acquisition_limits = __esm({
         this.name = "MemoryAcquireConcurrencyError";
       }
     };
+    MemoryAcquireDuplicateClaimError = class extends Error {
+      static {
+        __name(this, "MemoryAcquireDuplicateClaimError");
+      }
+      code = DOTMEM_ACQUIRE_ERROR_CODES.DUPLICATE_CLAIM;
+      retryable = false;
+      constructor(message, options) {
+        super(message, options);
+        this.name = "MemoryAcquireDuplicateClaimError";
+      }
+    };
     encoder = new TextEncoder();
     serializedBytes = /* @__PURE__ */ __name((value) => {
       const json = JSON.stringify(value);
@@ -5409,6 +5424,267 @@ var init_user_identity = __esm({
   }
 });
 
+// core/knowledge/user-language.ts
+var user_language_exports = {};
+__export(user_language_exports, {
+  DEFAULT_LANGUAGE: () => DEFAULT_LANGUAGE,
+  DEFAULT_RESPONSE_LANGUAGE: () => DEFAULT_RESPONSE_LANGUAGE,
+  DEFAULT_USER_LANGUAGE: () => DEFAULT_USER_LANGUAGE,
+  LANGUAGE_DEFAULT: () => LANGUAGE_DEFAULT,
+  LANGUAGE_PREFERENCE_FILE_NAME: () => LANGUAGE_PREFERENCE_FILE_NAME,
+  PREFERENCES_FILE_NAME: () => PREFERENCES_FILE_NAME,
+  USER_LANGUAGE_DEFAULT: () => USER_LANGUAGE_DEFAULT,
+  USER_LANGUAGE_FILE_NAME: () => USER_LANGUAGE_FILE_NAME,
+  USER_LANGUAGE_PREFERENCE_FILE_NAME: () => USER_LANGUAGE_PREFERENCE_FILE_NAME,
+  USER_PREFERENCES_FILE_NAME: () => USER_PREFERENCES_FILE_NAME,
+  getLanguagePreference: () => getLanguagePreference,
+  getResponseLanguage: () => getResponseLanguage,
+  getUserLanguage: () => getUserLanguage,
+  getUserLanguagePreference: () => getUserLanguagePreference,
+  isItalian: () => isItalian,
+  language: () => language,
+  languageTag: () => languageTag,
+  loadLanguagePreference: () => loadLanguagePreference,
+  loadUserLanguage: () => loadUserLanguage,
+  loadUserLanguagePreference: () => loadUserLanguagePreference,
+  preferredLanguage: () => preferredLanguage,
+  readUserLanguage: () => readUserLanguage,
+  resolveLanguage: () => resolveLanguage,
+  resolveLanguagePath: () => resolveLanguagePath,
+  resolveLanguagePreference: () => resolveLanguagePreference,
+  resolveLanguagePreferencePath: () => resolveLanguagePreferencePath,
+  resolveResponseLanguage: () => resolveResponseLanguage,
+  resolveUserLanguage: () => resolveUserLanguage,
+  resolveUserLanguagePath: () => resolveUserLanguagePath,
+  resolveUserLanguagePreferencePath: () => resolveUserLanguagePreferencePath,
+  responseLanguage: () => responseLanguage,
+  saveLanguagePreference: () => saveLanguagePreference,
+  saveUserLanguage: () => saveUserLanguage,
+  setUserLanguage: () => setUserLanguage,
+  userLanguage: () => userLanguage,
+  writeUserLanguage: () => writeUserLanguage
+});
+function joinPath3(base, child) {
+  const separator3 = process.platform === "win32" ? "\\" : "/";
+  return `${base.replace(/[\\/]+/g, separator3)}${separator3}${child}`;
+}
+function resolveUserLanguagePath() {
+  return joinPath3(resolveUserDotMemPath(), USER_LANGUAGE_FILE_NAME);
+}
+function resolveUserLanguagePreferencePath() {
+  return resolveUserLanguagePath();
+}
+function resolveLanguagePath() {
+  return resolveUserLanguagePath();
+}
+function resolveLanguagePreferencePath() {
+  return resolveUserLanguagePath();
+}
+function readJsonFile(path) {
+  const fs = getSyncFs();
+  if (!fs) return null;
+  let raw;
+  try {
+    raw = fs.readFileSync(path, "utf8");
+  } catch {
+    return null;
+  }
+  if (typeof raw !== "string") return null;
+  if (raw.charCodeAt(0) === 65279) raw = raw.slice(1);
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function extractLanguage(value) {
+  if (value === null || value === void 0) return null;
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed ? trimmed : null;
+  }
+  if (typeof value !== "object" || Array.isArray(value)) return null;
+  for (const key of LANGUAGE_KEYS) {
+    if (Object.prototype.hasOwnProperty.call(value, key)) {
+      const candidate = extractLanguage(value[key]);
+      if (candidate) return candidate;
+    }
+  }
+  for (const containerKey of ["preferences", "user", "agent", "config", "settings", "storage"]) {
+    if (Object.prototype.hasOwnProperty.call(value, containerKey)) {
+      const candidate = extractLanguage(value[containerKey]);
+      if (candidate) return candidate;
+    }
+  }
+  return null;
+}
+function loadUserLanguage() {
+  const fs = getSyncFs();
+  const anchor = resolveUserDotMemPath();
+  if (fs) {
+    for (const name of LANGUAGE_FILE_NAMES) {
+      const candidatePath = joinPath3(anchor, name);
+      const parsed = readJsonFile(candidatePath);
+      const language2 = extractLanguage(parsed);
+      if (language2) return language2;
+    }
+    try {
+      const govPath = joinPath3(joinPath3(anchor, "policy"), "identity-governance.json");
+      const gov = readJsonFile(govPath);
+      const language2 = extractLanguage(gov);
+      if (language2) return language2;
+    } catch {
+    }
+    try {
+      const settingsPath = joinPath3(anchor, "dotmem.settings.json");
+      const settings = readJsonFile(settingsPath);
+      const language2 = extractLanguage(settings);
+      if (language2) return language2;
+    } catch {
+    }
+  }
+  const env = globalThis?.process?.env;
+  const envLang = env?.DOTMEM_LANGUAGE || env?.DOTMEM_RESPONSE_LANGUAGE || env?.DOTMEM_USER_LANGUAGE;
+  if (typeof envLang === "string" && envLang.trim()) return envLang.trim();
+  return DEFAULT_USER_LANGUAGE;
+}
+function readUserLanguage() {
+  return loadUserLanguage();
+}
+function getUserLanguage() {
+  return loadUserLanguage();
+}
+function resolveUserLanguage() {
+  return loadUserLanguage();
+}
+function resolveLanguage() {
+  return loadUserLanguage();
+}
+function loadLanguagePreference() {
+  return loadUserLanguage();
+}
+function getLanguagePreference() {
+  return loadUserLanguage();
+}
+function resolveLanguagePreference() {
+  return loadUserLanguage();
+}
+function loadUserLanguagePreference() {
+  return loadUserLanguage();
+}
+function getUserLanguagePreference() {
+  return loadUserLanguage();
+}
+function resolveResponseLanguage() {
+  return loadUserLanguage();
+}
+function getResponseLanguage() {
+  return loadUserLanguage();
+}
+async function setUserLanguage(language2) {
+  const fsMod = await import('fs/promises');
+  const path = resolveUserLanguagePath();
+  const dir = parentStoragePath(path);
+  await fsMod.mkdir(dir, { recursive: true });
+  const payload = { format: "dotmem.language", version: 1, language: String(language2).trim() };
+  const temporary = `${path}.${process.pid}.${Date.now().toString(36)}.tmp`;
+  await fsMod.writeFile(temporary, `${JSON.stringify(payload, null, 2)}
+`, "utf8");
+  await fsMod.rename(temporary, path);
+  return payload.language;
+}
+async function saveUserLanguage(language2) {
+  return setUserLanguage(language2);
+}
+async function writeUserLanguage(language2) {
+  return setUserLanguage(language2);
+}
+async function saveLanguagePreference(language2) {
+  return setUserLanguage(language2);
+}
+function isItalian(language2) {
+  const value = (language2 ?? loadUserLanguage()).toLowerCase();
+  return value === "it" || value === "it-it" || value.startsWith("it-");
+}
+function languageTag() {
+  return loadUserLanguage();
+}
+var USER_LANGUAGE_FILE_NAME, USER_LANGUAGE_PREFERENCE_FILE_NAME, LANGUAGE_PREFERENCE_FILE_NAME, USER_PREFERENCES_FILE_NAME, PREFERENCES_FILE_NAME, DEFAULT_USER_LANGUAGE, DEFAULT_LANGUAGE, USER_LANGUAGE_DEFAULT, LANGUAGE_DEFAULT, DEFAULT_RESPONSE_LANGUAGE, LANGUAGE_FILE_NAMES, LANGUAGE_KEYS, userLanguage, language, responseLanguage, preferredLanguage;
+var init_user_language = __esm({
+  "core/knowledge/user-language.ts"() {
+    init_user_paths();
+    init_storage_paths();
+    USER_LANGUAGE_FILE_NAME = "language.json";
+    USER_LANGUAGE_PREFERENCE_FILE_NAME = "user-language.json";
+    LANGUAGE_PREFERENCE_FILE_NAME = "language-preference.json";
+    USER_PREFERENCES_FILE_NAME = "user-preferences.json";
+    PREFERENCES_FILE_NAME = "preferences.json";
+    DEFAULT_USER_LANGUAGE = "it-IT";
+    DEFAULT_LANGUAGE = "it-IT";
+    USER_LANGUAGE_DEFAULT = "it-IT";
+    LANGUAGE_DEFAULT = "it-IT";
+    DEFAULT_RESPONSE_LANGUAGE = "it-IT";
+    LANGUAGE_FILE_NAMES = [
+      USER_LANGUAGE_FILE_NAME,
+      USER_LANGUAGE_PREFERENCE_FILE_NAME,
+      LANGUAGE_PREFERENCE_FILE_NAME,
+      USER_PREFERENCES_FILE_NAME,
+      PREFERENCES_FILE_NAME,
+      "config.json",
+      "user-config.json",
+      "agent-config.json",
+      "dotmem.config.json"
+    ];
+    LANGUAGE_KEYS = [
+      "language",
+      "Language",
+      "responseLanguage",
+      "response_language",
+      "preferredLanguage",
+      "preferred_language",
+      "userLanguage",
+      "user_language",
+      "defaultLanguage",
+      "default_language",
+      "locale",
+      "lang",
+      "uiLanguage",
+      "ui_language",
+      "conversationLanguage",
+      "conversation_language"
+    ];
+    __name(joinPath3, "joinPath");
+    __name(resolveUserLanguagePath, "resolveUserLanguagePath");
+    __name(resolveUserLanguagePreferencePath, "resolveUserLanguagePreferencePath");
+    __name(resolveLanguagePath, "resolveLanguagePath");
+    __name(resolveLanguagePreferencePath, "resolveLanguagePreferencePath");
+    __name(readJsonFile, "readJsonFile");
+    __name(extractLanguage, "extractLanguage");
+    __name(loadUserLanguage, "loadUserLanguage");
+    __name(readUserLanguage, "readUserLanguage");
+    __name(getUserLanguage, "getUserLanguage");
+    __name(resolveUserLanguage, "resolveUserLanguage");
+    __name(resolveLanguage, "resolveLanguage");
+    __name(loadLanguagePreference, "loadLanguagePreference");
+    __name(getLanguagePreference, "getLanguagePreference");
+    __name(resolveLanguagePreference, "resolveLanguagePreference");
+    __name(loadUserLanguagePreference, "loadUserLanguagePreference");
+    __name(getUserLanguagePreference, "getUserLanguagePreference");
+    __name(resolveResponseLanguage, "resolveResponseLanguage");
+    __name(getResponseLanguage, "getResponseLanguage");
+    __name(setUserLanguage, "setUserLanguage");
+    __name(saveUserLanguage, "saveUserLanguage");
+    __name(writeUserLanguage, "writeUserLanguage");
+    __name(saveLanguagePreference, "saveLanguagePreference");
+    __name(isItalian, "isItalian");
+    __name(languageTag, "languageTag");
+    userLanguage = loadUserLanguage();
+    language = loadUserLanguage();
+    responseLanguage = loadUserLanguage();
+    preferredLanguage = loadUserLanguage();
+  }
+});
+
 // core/profile/ai.json
 var ai_default;
 var init_ai = __esm({
@@ -5817,6 +6093,45 @@ var init_project_identity = __esm({
   }
 });
 
+// core/knowledge/uuid.ts
+var generateUuidV7;
+var init_uuid = __esm({
+  "core/knowledge/uuid.ts"() {
+    generateUuidV7 = /* @__PURE__ */ __name(() => {
+      const cryptoObj = globalThis.crypto;
+      const ms = Date.now();
+      const rand = new Uint8Array(10);
+      if (cryptoObj && typeof cryptoObj.getRandomValues === "function") {
+        cryptoObj.getRandomValues(rand);
+      } else {
+        for (let i2 = 0; i2 < rand.length; i2 += 1) {
+          rand[i2] = Math.floor(Math.random() * 256);
+        }
+      }
+      const bytes = new Uint8Array(16);
+      bytes[0] = ms / 1099511627776 & 255;
+      bytes[1] = ms / 4294967296 & 255;
+      bytes[2] = ms / 16777216 & 255;
+      bytes[3] = ms / 65536 & 255;
+      bytes[4] = ms / 256 & 255;
+      bytes[5] = ms & 255;
+      const randA = (rand[0] << 8 | rand[1]) & 4095;
+      bytes[6] = 112 | randA >> 8;
+      bytes[7] = randA & 255;
+      bytes[8] = 128 | rand[2] & 63;
+      bytes[9] = rand[3];
+      bytes[10] = rand[4];
+      bytes[11] = rand[5];
+      bytes[12] = rand[6];
+      bytes[13] = rand[7];
+      bytes[14] = rand[8];
+      bytes[15] = rand[9];
+      const hex = Array.from(bytes).map((byte) => byte.toString(16).padStart(2, "0")).join("");
+      return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+    }, "generateUuidV7");
+  }
+});
+
 // core/knowledge/staging.ts
 var DOTMEM_STAGE_FORMAT, DOTMEM_STAGE_VERSION, StageFileError, generateRequestId, nodeCwd, resolveStagingDirectory, stagePathFor, nodeFs6, normalizeClaimIds, revisionFromOptions, writeStageFile, readStageFile, validateStageFile, commitStageFile, cleanupStageFile;
 var init_staging = __esm({
@@ -5828,6 +6143,7 @@ var init_staging = __esm({
     init_store_queue();
     init_state();
     init_project_identity();
+    init_uuid();
     init_project_anchor();
     DOTMEM_STAGE_FORMAT = "dotmem.stage";
     DOTMEM_STAGE_VERSION = 1;
@@ -5871,9 +6187,11 @@ var init_staging = __esm({
       return void 0;
     }, "revisionFromOptions");
     writeStageFile = /* @__PURE__ */ __name(async (claim, scope, sourceProject) => {
+      const claimId = claim.id && claim.id.trim() ? claim.id.trim() : generateUuidV7();
       const sanitized = sanitizeKnowledge(claim.knowledge);
       const sanitizedClaim = {
         ...claim,
+        id: claimId,
         knowledge: sanitized.knowledge
       };
       const requestId = generateRequestId();
@@ -5971,11 +6289,12 @@ var init_staging = __esm({
         ...validated.claim,
         knowledge: boundary.knowledge
       };
+      const claimId = sanitizedClaim.id && sanitizedClaim.id.trim() ? sanitizedClaim.id.trim() : generateUuidV7();
       const kind = boundary.kind ?? "experience";
       const target = await resolveMemoryTarget(kind, scope, sourceProject);
       const revision = revisionFromOptions(sanitizedClaim);
       const claim = buildClaimRecord({
-        id: sanitizedClaim.id,
+        id: claimId,
         knowledge: sanitizedClaim.knowledge,
         applicability: sanitizedClaim.applicability,
         evidence: sanitizedClaim.evidence,
@@ -5995,13 +6314,13 @@ var init_staging = __esm({
         });
       });
       const verification = await target.repository.load();
-      if (!verification.claims.some((c) => c.id === sanitizedClaim.id)) {
-        throw new Error(`Persistence verification failed: claim ${sanitizedClaim.id} was not persisted`);
+      if (!verification.claims.some((c) => c.id === claimId)) {
+        throw new Error(`Persistence verification failed: claim ${claimId} was not persisted`);
       }
       await cleanupStageFile(requestId);
       return {
         requestId,
-        claimId: sanitizedClaim.id,
+        claimId,
         sourceId: target.sourceId,
         scope,
         kind
@@ -6022,12 +6341,12 @@ var init_staging = __esm({
 });
 
 // core/knowledge/loops.ts
-function joinPath3(base, child) {
+function joinPath4(base, child) {
   const separator3 = process.platform === "win32" ? "\\" : "/";
   return `${base.replace(/[\\/]+/g, separator3)}${separator3}${child}`;
 }
 function resolveLoopsFilePath() {
-  return joinPath3(resolveUserDotMemPath(), LOOPS_FILE_NAME);
+  return joinPath4(resolveUserDotMemPath(), LOOPS_FILE_NAME);
 }
 async function readFile(path) {
   try {
@@ -6159,7 +6478,7 @@ var init_loops = __esm({
     init_user_paths();
     LOOPS_FILE_NAME = "loops.json";
     LOOPS_FORMAT_VERSION = 1;
-    __name(joinPath3, "joinPath");
+    __name(joinPath4, "joinPath");
     __name(resolveLoopsFilePath, "resolveLoopsFilePath");
     __name(readFile, "readFile");
     __name(writeFile, "writeFile");
@@ -6255,12 +6574,12 @@ var init_session = __esm({
 });
 
 // core/knowledge/exemplars.ts
-function joinPath4(base, child) {
+function joinPath5(base, child) {
   const separator3 = process.platform === "win32" ? "\\" : "/";
   return `${base.replace(/[\\/]+/g, separator3)}${separator3}${child}`;
 }
 function resolveExemplarsPath() {
-  return joinPath4(resolveUserDotMemPath(), EXEMPLARS_FILE_NAME);
+  return joinPath5(resolveUserDotMemPath(), EXEMPLARS_FILE_NAME);
 }
 async function readFile2(path) {
   try {
@@ -6397,7 +6716,7 @@ var init_exemplars = __esm({
     init_user_paths();
     EXEMPLARS_FILE_NAME = "exemplars.json";
     EXEMPLARS_FORMAT_VERSION = 1;
-    __name(joinPath4, "joinPath");
+    __name(joinPath5, "joinPath");
     __name(resolveExemplarsPath, "resolveExemplarsPath");
     __name(readFile2, "readFile");
     __name(writeFile2, "writeFile");
@@ -6412,12 +6731,12 @@ var init_exemplars = __esm({
 });
 
 // core/knowledge/personality-anchor.ts
-function joinPath5(base, child) {
+function joinPath6(base, child) {
   const separator3 = process.platform === "win32" ? "\\" : "/";
   return `${base.replace(/[\\/]+/g, separator3)}${separator3}${child}`;
 }
 function resolvePersonalityAnchorPath() {
-  return joinPath5(resolveUserDotMemPath(), PERSONALITY_ANCHOR_FILE_NAME);
+  return joinPath6(resolveUserDotMemPath(), PERSONALITY_ANCHOR_FILE_NAME);
 }
 async function readFile3(path) {
   try {
@@ -6605,7 +6924,7 @@ var init_personality_anchor = __esm({
     init_user_paths();
     PERSONALITY_ANCHOR_FILE_NAME = "personality-anchor.json";
     PERSONALITY_ANCHOR_FORMAT_VERSION = 1;
-    __name(joinPath5, "joinPath");
+    __name(joinPath6, "joinPath");
     __name(resolvePersonalityAnchorPath, "resolvePersonalityAnchorPath");
     __name(readFile3, "readFile");
     __name(writeFile3, "writeFile");
@@ -6648,6 +6967,7 @@ var init_knowledge = __esm({
     init_storage_location();
     init_storage_settings();
     init_user_identity();
+    init_user_language();
     init_identity_resolution();
     init_identity_governance();
     init_effective_contract();
@@ -8390,6 +8710,8 @@ init_router();
 init_store_queue();
 init_staging();
 init_user_paths();
+init_uuid();
+init_acquisition_limits();
 init_storage_coordinator();
 init_mem_repository();
 function normalizeClaimIds3(value) {
@@ -8440,9 +8762,10 @@ async function findClaimAcrossAllSources(claimId, scope, sourceProject) {
 __name(findClaimAcrossAllSources, "findClaimAcrossAllSources");
 var acquire = {
   async acquire(opts) {
+    const claimId = opts.id && opts.id.trim() ? opts.id.trim() : generateUuidV7();
     if (opts.scope === void 0 && opts.applicability?.scope !== void 0) {
       throw new Error(
-        `Claim ${opts.id} uses applicability.scope for routing. Use top-level scope instead.`
+        `Claim ${claimId} uses applicability.scope for routing. Use top-level scope instead.`
       );
     }
     const scope = opts.scope ?? "project";
@@ -8453,19 +8776,18 @@ var acquire = {
     }
     const boundary = await crossAcquisitionBoundary(opts);
     if (boundary.sanitized && DEV) {
-      console.warn(`[dotmem] Sanitized secret values from claim ${opts.id}`);
+      console.warn(`[dotmem] Sanitized secret values from claim ${claimId}`);
     }
     if (boundary.removedTierFields > 0 && DEV) {
-      console.warn(`[dotmem] Removed ${boundary.removedTierFields} non-authoritative tier field(s) from claim ${opts.id}`);
+      console.warn(`[dotmem] Removed ${boundary.removedTierFields} non-authoritative tier field(s) from claim ${claimId}`);
     }
     const kind = boundary.kind;
     const target = await resolveMemoryTarget(kind, scope, sourceProject);
-    const existing = await findClaimAcrossAllSources(opts.id, scope, sourceProject);
+    const existing = await findClaimAcrossAllSources(claimId, scope, sourceProject);
     if (existing) {
       const acquiredAt = existing.acquiredAt ? ` (acquired ${existing.acquiredAt})` : "";
-      throw new Error(
-        `Claim id ${opts.id} already exists in ${existing.sourceId}${acquiredAt}. Use a revision relationship (retracts/supersedes/refines) to revise it, or run 'npx dotmem doctor' to audit duplicates.`
-      );
+      const detail = `Claim id ${claimId} already exists in ${existing.sourceId}${acquiredAt}. Use a revision relationship (retracts/supersedes/refines) to revise it, or run 'npx dotmem doctor' to audit duplicates.`;
+      throw new MemoryAcquireDuplicateClaimError("A claim with this ID already exists.", { cause: new Error(detail) });
     }
     const revision = revisionFromAcquire2(opts);
     const repository = target.repository;
@@ -8475,7 +8797,7 @@ var acquire = {
         const next = updateKnowledge(state3, {
           basedOnVersion: state3.version,
           claims: [buildClaimRecord({
-            id: opts.id,
+            id: claimId,
             knowledge: boundary.knowledge,
             applicability: opts.applicability,
             evidence: opts.evidence,
@@ -8492,10 +8814,11 @@ var acquire = {
       });
     });
     const verification = await target.repository.load();
-    if (!verification.claims.some((claim) => claim.id === opts.id)) {
-      throw new Error(`Acquisition verification failed: claim ${opts.id} was not persisted`);
+    if (!verification.claims.some((claim) => claim.id === claimId)) {
+      throw new Error(`Acquisition verification failed: claim ${claimId} was not persisted`);
     }
-    memorio.dispatch.set("dotmem:memory:acquired", { detail: { id: opts.id } });
+    memorio.dispatch.set("dotmem:memory:acquired", { detail: { id: claimId } });
+    return claimId;
   },
   async acquireStaged(opts) {
     const scope = opts.scope ?? "project";
@@ -8503,7 +8826,8 @@ var acquire = {
     const sourceProject = resolvedProjectId ? normalizeProjectId(resolvedProjectId) : void 0;
     const { requestId } = await writeStageFile(opts, scope, sourceProject);
     try {
-      await commitStageFile(requestId);
+      const result = await commitStageFile(requestId);
+      return result.claimId;
     } catch (error) {
       if (error instanceof StageFileError) {
         await cleanupStageFile(requestId);
@@ -9716,6 +10040,17 @@ var memory = {
       return profile.get(id);
     }
   },
+  /** Persistent default response language (canonical user config). */
+  language: {
+    async get() {
+      const m = await Promise.resolve().then(() => (init_user_language(), user_language_exports));
+      return m.resolveUserLanguage();
+    },
+    async set(value) {
+      const m = await Promise.resolve().then(() => (init_user_language(), user_language_exports));
+      return m.setUserLanguage(value);
+    }
+  },
   /** Note surface: store and retrieve markdown files and text blocks. */
   note: {
     async add(opts) {