@remnic/core 10.0.6 → 10.0.8

package/dist/active-recall.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/active-recall.ts"],"sourcesContent":["import { appendFile, mkdir } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { DEFAULT_REASONING_MODEL } from \"./config.js\";\nimport { collapseWhitespace, truncateCodePointSafe } from \"./whitespace.js\";\nimport type {\n  ActiveRecallChatType,\n  ActiveRecallModelFallbackPolicy,\n  ActiveRecallPromptStyle,\n  ActiveRecallQueryMode,\n  ActiveRecallThinking,\n} from \"./types.js\";\n\nexport interface ActiveRecallTurn {\n  role: \"user\" | \"assistant\";\n  content: string;\n}\n\nexport interface ActiveRecallInput {\n  sessionKey: string;\n  agentId: string;\n  chatType: ActiveRecallChatType;\n  recentTurns: ActiveRecallTurn[];\n  currentMessage: string;\n}\n\nexport interface ActiveRecallConfig {\n  enabled: boolean;\n  agents: string[] | null;\n  allowedChatTypes: ActiveRecallChatType[];\n  queryMode: ActiveRecallQueryMode;\n  promptStyle: ActiveRecallPromptStyle;\n  customInstruction: string | null;\n  promptReplacement: string | null;\n  promptAppend: string | null;\n  maxSummaryChars: number;\n  recentUserTurns: number;\n  recentAssistantTurns: number;\n  recentUserChars: number;\n  recentAssistantChars: number;\n  thinking: ActiveRecallThinking;\n  timeoutMs: number;\n  cacheTtlMs: number;\n  persistTranscripts: boolean;\n  transcriptDir: string;\n  entityGraphDepth: number;\n  includeCausalTrajectories: boolean;\n  includeDaySummary: boolean;\n  attachRecallExplain: boolean;\n  modelOverride: string | null;\n  modelFallbackPolicy: ActiveRecallModelFallbackPolicy;\n}\n\nexport interface ActiveRecallResult {\n  summary: string | null;\n  citations: Array<{ memoryId: string; relevance: number }>;\n  latencyMs: number;\n  cacheHit: boolean;\n  modelUsed: string;\n  transcriptPath: string | null;\n}\n\nexport interface ActiveRecallDependencies {\n  recall(query: string, sessionKey: string): Promise<string | null>;\n  getLastRecallSnapshot?(sessionKey: string): { memoryIds?: string[] } | null;\n  walkEntityGraph?(params: {\n    sessionKey: string;\n    query: string;\n    depth: number;\n  }): Promise<string[]>;\n  loadCausalTrajectories?(params: {\n    sessionKey: string;\n    query: string;\n  }): Promise<string[]>;\n  loadDaySummary?(sessionKey: string): Promise<string | null>;\n  explainLastRecall?(sessionKey: string): Promise<string | null>;\n  generateSummary?(params: {\n    prompt: string;\n    sessionKey: string;\n    agentId: string;\n    model: string;\n    timeoutMs: number;\n    thinking: ActiveRecallThinking;\n    fallbackPolicy: ActiveRecallModelFallbackPolicy;\n  }): Promise<{ text: string | null; modelUsed?: string; cacheHit?: boolean }>;\n  now?: () => number;\n}\n\ninterface CachedRecallResult {\n  expiresAt: number;\n  value: ActiveRecallResult;\n}\n\ninterface ActiveRecallTurnWithIndex {\n  index: number;\n  role: ActiveRecallTurn[\"role\"];\n  content: string;\n}\n\nconst ACTIVE_RECALL_CACHE_MAX_ENTRIES = 256;\n\nconst NONE_SET = new Set([\n  \"\",\n  \"none\",\n  \"no_reply\",\n  \"nothing useful\",\n  \"no relevant memory\",\n  \"timeout\",\n  \"[]\",\n  \"{}\",\n  \"null\",\n  \"n/a\",\n]);\n\nconst STYLE_INSTRUCTIONS: Record<ActiveRecallPromptStyle, string> = {\n  balanced: \"Summarize the most relevant memory context in a compact, neutral way.\",\n  strict: \"Only include memory that is directly supported by the retrieved context.\",\n  contextual: \"Prefer concise context that helps the next reply stay grounded in recent work.\",\n  \"recall-heavy\": \"Bias toward richer recall coverage when multiple retrieved items reinforce each other.\",\n  \"precision-heavy\": \"Bias toward precision. Omit anything uncertain or weakly supported.\",\n  \"preference-only\": \"Only surface user preference or operating-style memory when present.\",\n};\n\nfunction cloneRecallResult(value: ActiveRecallResult): ActiveRecallResult {\n  return {\n    ...value,\n    citations: [...value.citations],\n  };\n}\n\nfunction buildCacheKey(input: ActiveRecallInput, config: ActiveRecallConfig, queryBundle: string): string {\n  return JSON.stringify({\n    sessionKey: input.sessionKey,\n    agentId: input.agentId,\n    queryMode: config.queryMode,\n    promptStyle: config.promptStyle,\n    customInstruction: config.customInstruction,\n    promptReplacement: config.promptReplacement,\n    promptAppend: config.promptAppend,\n    maxSummaryChars: config.maxSummaryChars,\n    entityGraphDepth: config.entityGraphDepth,\n    includeCausalTrajectories: config.includeCausalTrajectories,\n    includeDaySummary: config.includeDaySummary,\n    attachRecallExplain: config.attachRecallExplain,\n    modelOverride: config.modelOverride,\n    modelFallbackPolicy: config.modelFallbackPolicy,\n    thinking: config.thinking,\n    queryBundle,\n  });\n}\n\nfunction pruneExpiredCache(\n  cache: Map<string, CachedRecallResult>,\n  currentTime: number,\n): void {\n  for (const [key, entry] of cache.entries()) {\n    if (entry.expiresAt <= currentTime) {\n      cache.delete(key);\n    }\n  }\n}\n\nfunction enforceCacheLimit(cache: Map<string, CachedRecallResult>): void {\n  while (cache.size > ACTIVE_RECALL_CACHE_MAX_ENTRIES) {\n    const oldestKey = cache.keys().next().value;\n    if (typeof oldestKey !== \"string\") {\n      break;\n    }\n    cache.delete(oldestKey);\n  }\n}\n\nfunction cropTurns(\n  turns: ActiveRecallTurn[],\n  role: \"user\" | \"assistant\",\n  maxTurns: number,\n  maxChars: number,\n): ActiveRecallTurnWithIndex[] {\n  if (maxTurns <= 0) {\n    return [];\n  }\n\n  const selected: ActiveRecallTurnWithIndex[] = [];\n  for (let index = turns.length - 1; index >= 0 && selected.length < maxTurns; index -= 1) {\n    const turn = turns[index];\n    if (turn?.role === role) {\n      selected.push({\n        index,\n        role: turn.role,\n        content: collapseWhitespace(truncateCodePointSafe(turn.content, maxChars)),\n      });\n    }\n  }\n\n  return selected.reverse();\n}\n\nfunction mergeChronologicalTurns(\n  userTurns: ActiveRecallTurnWithIndex[],\n  assistantTurns: ActiveRecallTurnWithIndex[],\n): ActiveRecallTurnWithIndex[] {\n  return [...userTurns, ...assistantTurns]\n    .sort((left, right) => left.index - right.index)\n    .filter((value) => value.content.length > 0);\n}\n\nexport function buildActiveRecallQueryBundle(\n  input: ActiveRecallInput,\n  config: ActiveRecallConfig,\n): string {\n  if (config.queryMode === \"message\") {\n    return collapseWhitespace(input.currentMessage);\n  }\n\n  const userTurns = cropTurns(\n    input.recentTurns,\n    \"user\",\n    config.recentUserTurns,\n    config.recentUserChars,\n  );\n  const assistantTurns = cropTurns(\n    input.recentTurns,\n    \"assistant\",\n    config.recentAssistantTurns,\n    config.recentAssistantChars,\n  );\n  const mergedTurns = mergeChronologicalTurns(userTurns, assistantTurns);\n\n  const parts = [\n    ...mergedTurns.map((turn) => `${turn.role}: ${turn.content}`),\n  ];\n\n  if (config.queryMode === \"full\") {\n    return [...parts, `current: ${collapseWhitespace(input.currentMessage)}`]\n      .filter((value) => value.trim().length > 0)\n      .join(\"\\n\");\n  }\n\n  return [`current: ${collapseWhitespace(input.currentMessage)}`, ...parts]\n    .filter((value) => value.trim().length > 0)\n    .join(\"\\n\");\n}\n\nexport function normalizeActiveRecallSummary(value: string | null, maxChars: number): string | null {\n  if (value == null) return null;\n  const compact = collapseWhitespace(value);\n  if (NONE_SET.has(compact.toLowerCase())) return null;\n  return truncateCodePointSafe(compact, maxChars);\n}\n\nfunction sanitizeTranscriptPathSegment(value: string): string {\n  const normalized = collapseWhitespace(value);\n  return encodeURIComponent(normalized.length > 0 ? normalized : \"unknown\").replaceAll(\n    \".\",\n    \"%2E\",\n  );\n}\n\nexport function buildActiveRecallPrompt(params: {\n  config: ActiveRecallConfig;\n  queryBundle: string;\n  recallContext: string | null;\n  graphContext: string[];\n  causalContext: string[];\n  daySummary: string | null;\n  recallExplain: string | null;\n}): string {\n  const promptReplacement = params.config.promptReplacement?.trim();\n  if (promptReplacement) {\n    return promptReplacement;\n  }\n\n  const sections = [\n    params.config.customInstruction?.trim() || STYLE_INSTRUCTIONS[params.config.promptStyle],\n    `Query bundle:\\n${params.queryBundle}`,\n    params.recallContext ? `Retrieved memory:\\n${params.recallContext}` : null,\n    params.graphContext.length > 0 ? `Entity graph:\\n${params.graphContext.join(\"\\n\")}` : null,\n    params.causalContext.length > 0 ? `Causal trajectories:\\n${params.causalContext.join(\"\\n\")}` : null,\n    params.daySummary ? `Day summary:\\n${params.daySummary}` : null,\n    params.recallExplain ? `Recall explain:\\n${params.recallExplain}` : null,\n    params.config.promptAppend?.trim() || null,\n    \"Return either NONE or a compact summary grounded only in the supplied context.\",\n  ];\n  return sections.filter((value): value is string => !!value && value.trim().length > 0).join(\"\\n\\n\");\n}\n\nasync function appendActiveRecallTranscript(\n  transcriptRoot: string,\n  input: ActiveRecallInput,\n  config: ActiveRecallConfig,\n  result: ActiveRecallResult,\n  queryBundle: string,\n): Promise<string> {\n  const date = new Date().toISOString().slice(0, 10);\n  const filePath = path.join(\n    transcriptRoot,\n    \"agents\",\n    sanitizeTranscriptPathSegment(input.agentId),\n    date,\n    `${sanitizeTranscriptPathSegment(input.sessionKey)}.jsonl`,\n  );\n  await mkdir(path.dirname(filePath), { recursive: true });\n  await appendFile(\n    filePath,\n    `${JSON.stringify({\n      ts: new Date().toISOString(),\n      sessionKey: input.sessionKey,\n      agentId: input.agentId,\n      queryMode: config.queryMode,\n      promptStyle: config.promptStyle,\n      queryBundle,\n      summary: result.summary,\n      citations: result.citations,\n      latencyMs: result.latencyMs,\n      cacheHit: result.cacheHit,\n      modelUsed: result.modelUsed,\n    })}\\n`,\n    \"utf8\",\n  );\n  return filePath;\n}\n\nexport function createActiveRecallEngine(\n  deps: ActiveRecallDependencies,\n  config: ActiveRecallConfig,\n) {\n  const cache = new Map<string, CachedRecallResult>();\n  const now = deps.now ?? (() => Date.now());\n\n  return {\n    async run(input: ActiveRecallInput): Promise<ActiveRecallResult> {\n      if (!config.enabled) {\n        return {\n          summary: null,\n          citations: [],\n          latencyMs: 0,\n          cacheHit: false,\n          modelUsed: config.modelOverride ?? \"disabled\",\n          transcriptPath: null,\n        };\n      }\n      if (config.agents && !config.agents.includes(input.agentId)) {\n        return {\n          summary: null,\n          citations: [],\n          latencyMs: 0,\n          cacheHit: false,\n          modelUsed: config.modelOverride ?? \"filtered\",\n          transcriptPath: null,\n        };\n      }\n      if (!config.allowedChatTypes.includes(input.chatType)) {\n        return {\n          summary: null,\n          citations: [],\n          latencyMs: 0,\n          cacheHit: false,\n          modelUsed: config.modelOverride ?? \"filtered\",\n          transcriptPath: null,\n        };\n      }\n\n      const queryBundle = buildActiveRecallQueryBundle(input, config);\n      const cacheKey = buildCacheKey(input, config, queryBundle);\n      const currentTime = now();\n      const cacheEnabled = config.cacheTtlMs > 0;\n      if (cacheEnabled) {\n        pruneExpiredCache(cache, currentTime);\n      }\n      const cached = cache.get(cacheKey);\n      if (cacheEnabled && cached) {\n        const result: ActiveRecallResult = {\n          ...cloneRecallResult(cached.value),\n          latencyMs: Math.max(0, now() - currentTime),\n          cacheHit: true,\n        };\n        result.transcriptPath = null;\n        if (config.persistTranscripts) {\n          try {\n            result.transcriptPath = await appendActiveRecallTranscript(\n              config.transcriptDir,\n              input,\n              config,\n              result,\n              queryBundle,\n            );\n          } catch {\n            result.transcriptPath = null;\n          }\n        }\n        return result;\n      }\n\n      const start = currentTime;\n      const recallContext = await deps.recall(queryBundle, input.sessionKey);\n      const graphContext =\n        config.entityGraphDepth > 0 && deps.walkEntityGraph\n          ? await deps.walkEntityGraph({\n              sessionKey: input.sessionKey,\n              query: queryBundle,\n              depth: config.entityGraphDepth,\n            })\n          : [];\n      const causalContext =\n        config.includeCausalTrajectories && deps.loadCausalTrajectories\n          ? await deps.loadCausalTrajectories({\n              sessionKey: input.sessionKey,\n              query: queryBundle,\n            })\n          : [];\n      const daySummary =\n        config.includeDaySummary && deps.loadDaySummary\n          ? await deps.loadDaySummary(input.sessionKey)\n          : null;\n      const recallExplain =\n        config.attachRecallExplain && deps.explainLastRecall\n          ? await deps.explainLastRecall(input.sessionKey)\n          : null;\n      const prompt = buildActiveRecallPrompt({\n        config,\n        queryBundle,\n        recallContext,\n        graphContext,\n        causalContext,\n        daySummary,\n        recallExplain,\n      });\n\n      const generated = deps.generateSummary\n        ? await deps.generateSummary({\n            prompt,\n            sessionKey: input.sessionKey,\n            agentId: input.agentId,\n            model: config.modelOverride ?? DEFAULT_REASONING_MODEL,\n            timeoutMs: config.timeoutMs,\n            thinking: config.thinking,\n            fallbackPolicy: config.modelFallbackPolicy,\n          })\n        : {\n            text: recallContext,\n            modelUsed: config.modelOverride ?? DEFAULT_REASONING_MODEL,\n            cacheHit: false,\n          };\n      const summary = normalizeActiveRecallSummary(\n        generated.text,\n        config.maxSummaryChars,\n      );\n      const snapshot = deps.getLastRecallSnapshot?.(input.sessionKey);\n      const citations = (snapshot?.memoryIds ?? []).map((memoryId, index) => ({\n        memoryId,\n        relevance: Number((1 / (index + 1)).toFixed(3)),\n      }));\n      const result: ActiveRecallResult = {\n        summary,\n        citations,\n        latencyMs: Math.max(0, now() - start),\n        cacheHit: generated.cacheHit === true,\n        modelUsed: generated.modelUsed ?? config.modelOverride ?? DEFAULT_REASONING_MODEL,\n        transcriptPath: null,\n      };\n      if (config.persistTranscripts) {\n        try {\n          result.transcriptPath = await appendActiveRecallTranscript(\n            config.transcriptDir,\n            input,\n            config,\n            result,\n            queryBundle,\n          );\n        } catch {\n          result.transcriptPath = null;\n        }\n      }\n\n      if (cacheEnabled) {\n        const completedAt = now();\n        const cachedValue = cloneRecallResult(result);\n        cachedValue.transcriptPath = null;\n        cache.set(cacheKey, {\n          expiresAt: completedAt + config.cacheTtlMs,\n          value: cachedValue,\n        });\n        enforceCacheLimit(cache);\n      }\n      return result;\n    },\n  };\n}\n"],"mappings":"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","names":["result"]}
+{"version":3,"sources":["../src/active-recall.ts"],"sourcesContent":["import { appendFile, mkdir } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { DEFAULT_REASONING_MODEL } from \"./config.js\";\nimport { collapseWhitespace, truncateCodePointSafe } from \"./whitespace.js\";\nimport type {\n  ActiveRecallChatType,\n  ActiveRecallModelFallbackPolicy,\n  ActiveRecallPromptStyle,\n  ActiveRecallQueryMode,\n  ActiveRecallThinking,\n} from \"./types.js\";\n\nexport interface ActiveRecallTurn {\n  role: \"user\" | \"assistant\";\n  content: string;\n}\n\nexport interface ActiveRecallInput {\n  sessionKey: string;\n  agentId: string;\n  chatType: ActiveRecallChatType;\n  recentTurns: ActiveRecallTurn[];\n  currentMessage: string;\n}\n\nexport interface ActiveRecallConfig {\n  enabled: boolean;\n  agents: string[] | null;\n  allowedChatTypes: ActiveRecallChatType[];\n  queryMode: ActiveRecallQueryMode;\n  promptStyle: ActiveRecallPromptStyle;\n  customInstruction: string | null;\n  promptReplacement: string | null;\n  promptAppend: string | null;\n  maxSummaryChars: number;\n  recentUserTurns: number;\n  recentAssistantTurns: number;\n  recentUserChars: number;\n  recentAssistantChars: number;\n  thinking: ActiveRecallThinking;\n  timeoutMs: number;\n  cacheTtlMs: number;\n  persistTranscripts: boolean;\n  transcriptDir: string;\n  entityGraphDepth: number;\n  includeCausalTrajectories: boolean;\n  includeDaySummary: boolean;\n  attachRecallExplain: boolean;\n  modelOverride: string | null;\n  modelFallbackPolicy: ActiveRecallModelFallbackPolicy;\n}\n\nexport interface ActiveRecallResult {\n  summary: string | null;\n  citations: Array<{ memoryId: string; relevance: number }>;\n  latencyMs: number;\n  cacheHit: boolean;\n  modelUsed: string;\n  transcriptPath: string | null;\n}\n\nexport interface ActiveRecallDependencies {\n  recall(query: string, sessionKey: string): Promise<string | null>;\n  getLastRecallSnapshot?(sessionKey: string): { memoryIds?: string[] } | null;\n  walkEntityGraph?(params: {\n    sessionKey: string;\n    query: string;\n    depth: number;\n  }): Promise<string[]>;\n  loadCausalTrajectories?(params: {\n    sessionKey: string;\n    query: string;\n  }): Promise<string[]>;\n  loadDaySummary?(sessionKey: string): Promise<string | null>;\n  explainLastRecall?(sessionKey: string): Promise<string | null>;\n  generateSummary?(params: {\n    prompt: string;\n    sessionKey: string;\n    agentId: string;\n    model: string;\n    timeoutMs: number;\n    thinking: ActiveRecallThinking;\n    fallbackPolicy: ActiveRecallModelFallbackPolicy;\n  }): Promise<{ text: string | null; modelUsed?: string; cacheHit?: boolean }>;\n  now?: () => number;\n}\n\ninterface CachedRecallResult {\n  expiresAt: number;\n  value: ActiveRecallResult;\n}\n\ninterface ActiveRecallTurnWithIndex {\n  index: number;\n  role: ActiveRecallTurn[\"role\"];\n  content: string;\n}\n\nconst ACTIVE_RECALL_CACHE_MAX_ENTRIES = 256;\n\nconst NONE_SET = new Set([\n  \"\",\n  \"none\",\n  \"no_reply\",\n  \"nothing useful\",\n  \"no relevant memory\",\n  \"timeout\",\n  \"[]\",\n  \"{}\",\n  \"null\",\n  \"n/a\",\n]);\n\nconst STYLE_INSTRUCTIONS: Record<ActiveRecallPromptStyle, string> = {\n  balanced: \"Summarize the most relevant memory context in a compact, neutral way.\",\n  strict: \"Only include memory that is directly supported by the retrieved context.\",\n  contextual: \"Prefer concise context that helps the next reply stay grounded in recent work.\",\n  \"recall-heavy\": \"Bias toward richer recall coverage when multiple retrieved items reinforce each other.\",\n  \"precision-heavy\": \"Bias toward precision. Omit anything uncertain or weakly supported.\",\n  \"preference-only\": \"Only surface user preference or operating-style memory when present.\",\n};\n\nfunction cloneRecallResult(value: ActiveRecallResult): ActiveRecallResult {\n  return {\n    ...value,\n    citations: [...value.citations],\n  };\n}\n\nfunction buildCacheKey(input: ActiveRecallInput, config: ActiveRecallConfig, queryBundle: string): string {\n  return JSON.stringify({\n    sessionKey: input.sessionKey,\n    agentId: input.agentId,\n    queryMode: config.queryMode,\n    promptStyle: config.promptStyle,\n    customInstruction: config.customInstruction,\n    promptReplacement: config.promptReplacement,\n    promptAppend: config.promptAppend,\n    maxSummaryChars: config.maxSummaryChars,\n    entityGraphDepth: config.entityGraphDepth,\n    includeCausalTrajectories: config.includeCausalTrajectories,\n    includeDaySummary: config.includeDaySummary,\n    attachRecallExplain: config.attachRecallExplain,\n    modelOverride: config.modelOverride,\n    modelFallbackPolicy: config.modelFallbackPolicy,\n    thinking: config.thinking,\n    queryBundle,\n  });\n}\n\nfunction pruneExpiredCache(\n  cache: Map<string, CachedRecallResult>,\n  currentTime: number,\n): void {\n  for (const [key, entry] of cache.entries()) {\n    if (entry.expiresAt <= currentTime) {\n      cache.delete(key);\n    }\n  }\n}\n\nfunction enforceCacheLimit(cache: Map<string, CachedRecallResult>): void {\n  while (cache.size > ACTIVE_RECALL_CACHE_MAX_ENTRIES) {\n    const oldestKey = cache.keys().next().value;\n    if (typeof oldestKey !== \"string\") {\n      break;\n    }\n    cache.delete(oldestKey);\n  }\n}\n\nfunction cropTurns(\n  turns: ActiveRecallTurn[],\n  role: \"user\" | \"assistant\",\n  maxTurns: number,\n  maxChars: number,\n): ActiveRecallTurnWithIndex[] {\n  if (maxTurns <= 0) {\n    return [];\n  }\n\n  const selected: ActiveRecallTurnWithIndex[] = [];\n  for (let index = turns.length - 1; index >= 0 && selected.length < maxTurns; index -= 1) {\n    const turn = turns[index];\n    if (turn?.role === role) {\n      selected.push({\n        index,\n        role: turn.role,\n        content: collapseWhitespace(truncateCodePointSafe(turn.content, maxChars)),\n      });\n    }\n  }\n\n  return selected.reverse();\n}\n\nfunction mergeChronologicalTurns(\n  userTurns: ActiveRecallTurnWithIndex[],\n  assistantTurns: ActiveRecallTurnWithIndex[],\n): ActiveRecallTurnWithIndex[] {\n  return [...userTurns, ...assistantTurns]\n    .sort((left, right) => left.index - right.index)\n    .filter((value) => value.content.length > 0);\n}\n\nexport function buildActiveRecallQueryBundle(\n  input: ActiveRecallInput,\n  config: ActiveRecallConfig,\n): string {\n  if (config.queryMode === \"message\") {\n    return collapseWhitespace(input.currentMessage);\n  }\n\n  const userTurns = cropTurns(\n    input.recentTurns,\n    \"user\",\n    config.recentUserTurns,\n    config.recentUserChars,\n  );\n  const assistantTurns = cropTurns(\n    input.recentTurns,\n    \"assistant\",\n    config.recentAssistantTurns,\n    config.recentAssistantChars,\n  );\n  const mergedTurns = mergeChronologicalTurns(userTurns, assistantTurns);\n\n  const parts = [\n    ...mergedTurns.map((turn) => `${turn.role}: ${turn.content}`),\n  ];\n\n  if (config.queryMode === \"full\") {\n    return [...parts, `current: ${collapseWhitespace(input.currentMessage)}`]\n      .filter((value) => value.trim().length > 0)\n      .join(\"\\n\");\n  }\n\n  return [`current: ${collapseWhitespace(input.currentMessage)}`, ...parts]\n    .filter((value) => value.trim().length > 0)\n    .join(\"\\n\");\n}\n\nexport function normalizeActiveRecallSummary(value: string | null, maxChars: number): string | null {\n  if (value == null) return null;\n  const compact = collapseWhitespace(value);\n  if (NONE_SET.has(compact.toLowerCase())) return null;\n  return truncateCodePointSafe(compact, maxChars);\n}\n\nfunction sanitizeTranscriptPathSegment(value: string): string {\n  const normalized = collapseWhitespace(value);\n  return encodeURIComponent(normalized.length > 0 ? normalized : \"unknown\").replaceAll(\n    \".\",\n    \"%2E\",\n  );\n}\n\nexport function buildActiveRecallPrompt(params: {\n  config: ActiveRecallConfig;\n  queryBundle: string;\n  recallContext: string | null;\n  graphContext: string[];\n  causalContext: string[];\n  daySummary: string | null;\n  recallExplain: string | null;\n}): string {\n  const promptReplacement = params.config.promptReplacement?.trim();\n  if (promptReplacement) {\n    return promptReplacement;\n  }\n\n  const sections = [\n    params.config.customInstruction?.trim() || STYLE_INSTRUCTIONS[params.config.promptStyle],\n    `Query bundle:\\n${params.queryBundle}`,\n    params.recallContext ? `Retrieved memory:\\n${params.recallContext}` : null,\n    params.graphContext.length > 0 ? `Entity graph:\\n${params.graphContext.join(\"\\n\")}` : null,\n    params.causalContext.length > 0 ? `Causal trajectories:\\n${params.causalContext.join(\"\\n\")}` : null,\n    params.daySummary ? `Day summary:\\n${params.daySummary}` : null,\n    params.recallExplain ? `Recall explain:\\n${params.recallExplain}` : null,\n    params.config.promptAppend?.trim() || null,\n    \"Return either NONE or a compact summary grounded only in the supplied context.\",\n  ];\n  return sections.filter((value): value is string => !!value && value.trim().length > 0).join(\"\\n\\n\");\n}\n\nasync function appendActiveRecallTranscript(\n  transcriptRoot: string,\n  input: ActiveRecallInput,\n  config: ActiveRecallConfig,\n  result: ActiveRecallResult,\n  queryBundle: string,\n): Promise<string> {\n  const date = new Date().toISOString().slice(0, 10);\n  const filePath = path.join(\n    transcriptRoot,\n    \"agents\",\n    sanitizeTranscriptPathSegment(input.agentId),\n    date,\n    `${sanitizeTranscriptPathSegment(input.sessionKey)}.jsonl`,\n  );\n  await mkdir(path.dirname(filePath), { recursive: true });\n  await appendFile(\n    filePath,\n    `${JSON.stringify({\n      ts: new Date().toISOString(),\n      sessionKey: input.sessionKey,\n      agentId: input.agentId,\n      queryMode: config.queryMode,\n      promptStyle: config.promptStyle,\n      queryBundle,\n      summary: result.summary,\n      citations: result.citations,\n      latencyMs: result.latencyMs,\n      cacheHit: result.cacheHit,\n      modelUsed: result.modelUsed,\n    })}\\n`,\n    \"utf8\",\n  );\n  return filePath;\n}\n\nexport function createActiveRecallEngine(\n  deps: ActiveRecallDependencies,\n  config: ActiveRecallConfig,\n) {\n  const cache = new Map<string, CachedRecallResult>();\n  const now = deps.now ?? (() => Date.now());\n\n  return {\n    async run(input: ActiveRecallInput): Promise<ActiveRecallResult> {\n      if (!config.enabled) {\n        return {\n          summary: null,\n          citations: [],\n          latencyMs: 0,\n          cacheHit: false,\n          modelUsed: config.modelOverride ?? \"disabled\",\n          transcriptPath: null,\n        };\n      }\n      if (config.agents && !config.agents.includes(input.agentId)) {\n        return {\n          summary: null,\n          citations: [],\n          latencyMs: 0,\n          cacheHit: false,\n          modelUsed: config.modelOverride ?? \"filtered\",\n          transcriptPath: null,\n        };\n      }\n      if (!config.allowedChatTypes.includes(input.chatType)) {\n        return {\n          summary: null,\n          citations: [],\n          latencyMs: 0,\n          cacheHit: false,\n          modelUsed: config.modelOverride ?? \"filtered\",\n          transcriptPath: null,\n        };\n      }\n\n      const queryBundle = buildActiveRecallQueryBundle(input, config);\n      const cacheKey = buildCacheKey(input, config, queryBundle);\n      const currentTime = now();\n      const cacheEnabled = config.cacheTtlMs > 0;\n      if (cacheEnabled) {\n        pruneExpiredCache(cache, currentTime);\n      }\n      const cached = cache.get(cacheKey);\n      if (cacheEnabled && cached) {\n        const result: ActiveRecallResult = {\n          ...cloneRecallResult(cached.value),\n          latencyMs: Math.max(0, now() - currentTime),\n          cacheHit: true,\n        };\n        result.transcriptPath = null;\n        if (config.persistTranscripts) {\n          try {\n            result.transcriptPath = await appendActiveRecallTranscript(\n              config.transcriptDir,\n              input,\n              config,\n              result,\n              queryBundle,\n            );\n          } catch {\n            result.transcriptPath = null;\n          }\n        }\n        return result;\n      }\n\n      const start = currentTime;\n      const recallContext = await deps.recall(queryBundle, input.sessionKey);\n      const graphContext =\n        config.entityGraphDepth > 0 && deps.walkEntityGraph\n          ? await deps.walkEntityGraph({\n              sessionKey: input.sessionKey,\n              query: queryBundle,\n              depth: config.entityGraphDepth,\n            })\n          : [];\n      const causalContext =\n        config.includeCausalTrajectories && deps.loadCausalTrajectories\n          ? await deps.loadCausalTrajectories({\n              sessionKey: input.sessionKey,\n              query: queryBundle,\n            })\n          : [];\n      const daySummary =\n        config.includeDaySummary && deps.loadDaySummary\n          ? await deps.loadDaySummary(input.sessionKey)\n          : null;\n      const recallExplain =\n        config.attachRecallExplain && deps.explainLastRecall\n          ? await deps.explainLastRecall(input.sessionKey)\n          : null;\n      const prompt = buildActiveRecallPrompt({\n        config,\n        queryBundle,\n        recallContext,\n        graphContext,\n        causalContext,\n        daySummary,\n        recallExplain,\n      });\n\n      const generated = deps.generateSummary\n        ? await deps.generateSummary({\n            prompt,\n            sessionKey: input.sessionKey,\n            agentId: input.agentId,\n            model: config.modelOverride ?? DEFAULT_REASONING_MODEL,\n            timeoutMs: config.timeoutMs,\n            thinking: config.thinking,\n            fallbackPolicy: config.modelFallbackPolicy,\n          })\n        : {\n            text: recallContext,\n            modelUsed: config.modelOverride ?? DEFAULT_REASONING_MODEL,\n            cacheHit: false,\n          };\n      const summary = normalizeActiveRecallSummary(\n        generated.text,\n        config.maxSummaryChars,\n      );\n      const snapshot = deps.getLastRecallSnapshot?.(input.sessionKey);\n      const citations = (snapshot?.memoryIds ?? []).map((memoryId, index) => ({\n        memoryId,\n        relevance: Number((1 / (index + 1)).toFixed(3)),\n      }));\n      const result: ActiveRecallResult = {\n        summary,\n        citations,\n        latencyMs: Math.max(0, now() - start),\n        cacheHit: generated.cacheHit === true,\n        modelUsed: generated.modelUsed ?? config.modelOverride ?? DEFAULT_REASONING_MODEL,\n        transcriptPath: null,\n      };\n      if (config.persistTranscripts) {\n        try {\n          result.transcriptPath = await appendActiveRecallTranscript(\n            config.transcriptDir,\n            input,\n            config,\n            result,\n            queryBundle,\n          );\n        } catch {\n          result.transcriptPath = null;\n        }\n      }\n\n      if (cacheEnabled) {\n        const completedAt = now();\n        const cachedValue = cloneRecallResult(result);\n        cachedValue.transcriptPath = null;\n        cache.set(cacheKey, {\n          expiresAt: completedAt + config.cacheTtlMs,\n          value: cachedValue,\n        });\n        enforceCacheLimit(cache);\n      }\n      return result;\n    },\n  };\n}\n"],"mappings":"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","names":["result"]}

package/dist/adapters/index.js

@@ -3,7 +3,10 @@ import {
   AdapterRegistry,
   GrokAdapter,
   OpenCodeAdapter
-} from "../chunk-64S6X4IU.js";
+} from "../chunk-XTN54NML.js";
+import {
+  ClaudeCodeAdapter
+} from "../chunk-3JKYQBLC.js";
 import {
   CodexAdapter
 } from "../chunk-7RKSJVOQ.js";
@@ -13,9 +16,6 @@ import {
 import {
   ReplitAdapter
 } from "../chunk-SI36RWC3.js";
-import {
-  ClaudeCodeAdapter
-} from "../chunk-3JKYQBLC.js";
 import "../chunk-NJAIR57U.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/dist/adapters/registry.js

@@ -1,10 +1,10 @@
 import {
   AdapterRegistry
-} from "../chunk-64S6X4IU.js";
+} from "../chunk-XTN54NML.js";
+import "../chunk-3JKYQBLC.js";
 import "../chunk-7RKSJVOQ.js";
 import "../chunk-HCAGBFE7.js";
 import "../chunk-SI36RWC3.js";
-import "../chunk-3JKYQBLC.js";
 import "../chunk-NJAIR57U.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/dist/{auto-sync-FN7E3OTO.js → auto-sync-WSJAOLOP.js}

@@ -1,7 +1,7 @@
 import {
   dateInTimezone,
   defaultTimezone
-} from "./chunk-7CXL25AA.js";
+} from "./chunk-W4RLOZOG.js";
 import "./chunk-UCJINCZT.js";
 import "./chunk-UOBPK2OS.js";
 import "./chunk-CIO7GCWE.js";
@@ -21,22 +21,23 @@ import "./chunk-EP6BA7VV.js";
 import "./chunk-E2AWJ7KQ.js";
 import "./chunk-YCVB7X56.js";
 import "./chunk-YBA52OKG.js";
-import "./chunk-CLCMDKTB.js";
+import "./chunk-3I3U6FFT.js";
 import "./chunk-353C5UNV.js";
-import "./chunk-5AYUHSAU.js";
+import "./chunk-OFCHT2TN.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-PO7NXNGC.js";
+import "./chunk-VFTK5WKI.js";
 import "./chunk-RL6NEVXT.js";
 import "./chunk-C7HJ3NEI.js";
-import "./chunk-N4PYB235.js";
+import "./chunk-KI6UOSNR.js";
 import "./chunk-BTNNL7ZW.js";
 import "./chunk-5FVVY2EB.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-FFAZ2XFU.js";
+import "./chunk-EHRE7ZG3.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-2EMROIXS.js";
+import "./chunk-7LEQREP2.js";
 import "./chunk-ZEFVK7XC.js";
 import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";
@@ -97,4 +98,4 @@ function startWearablesAutoSync(settings, deps) {
 export {
   startWearablesAutoSync
 };
-//# sourceMappingURL=auto-sync-FN7E3OTO.js.map
+//# sourceMappingURL=auto-sync-WSJAOLOP.js.map

package/dist/{auto-sync-FN7E3OTO.js.map → auto-sync-WSJAOLOP.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/wearables/auto-sync.ts"],"sourcesContent":["/**\n * Wearables auto-sync — in-process periodic transcript refresh.\n *\n * Every tick re-syncs a short rolling window ending today for ALL\n * enabled sources, so the current day's transcript keeps growing while\n * the wearable records and provider-side revisions of recent days flow\n * in without operator action. Once per local day the window deepens to\n * `autoSyncDeepDays` to pick up late uploads and provider reprocessing\n * further back (phones syncing hours later, re-diarized transcripts).\n *\n * Day fetches are unconditional within the window — existing day files\n * are always re-fetched and re-composed; the content-hash skip in the\n * pipeline keeps unchanged days write-free, so a tick on a quiet day\n * is read-only. The timer is unref'd: it never keeps a one-shot CLI\n * process alive, and long-lived hosts stop it via the returned handle.\n */\n\nimport { describeErrorForOperator } from \"./errors.js\";\nimport { dateInTimezone, defaultTimezone } from \"./pipeline.js\";\n\nexport interface WearablesAutoSyncSettings {\n  /** Minutes between ticks. */\n  intervalMinutes: number;\n  /** Rolling window (days ending today) refreshed on a normal tick. */\n  days: number;\n  /**\n   * Window for the once-per-local-day deep pass. 0 disables the deep\n   * pass; otherwise must be >= `days` (validated at config parse).\n   */\n  deepDays: number;\n  /** IANA timezone used to detect the local-day rollover. */\n  timezone?: string;\n}\n\nexport interface WearablesAutoSyncDeps {\n  /** Run a sync across all enabled sources (WearablesService.sync). */\n  sync(options: { days: number; signal?: AbortSignal }): Promise<unknown>;\n  log: { info(message: string): void; warn(message: string): void };\n  /** Clock injection for tests. */\n  now?: () => Date;\n}\n\nexport interface WearablesAutoSyncHandle {\n  /** Run one scheduler tick now (first-run hook and test seam). */\n  tick(): Promise<void>;\n  /**\n   * Stop the scheduler: clears the timer, aborts the in-flight sync's\n   * provider fetches via AbortSignal, and resolves once the in-flight\n   * tick has fully settled — after `await stop()` nothing is writing\n   * or reindexing anymore. The handle is single-use; a restarted host\n   * starts a fresh one.\n   */\n  stop(): Promise<void>;\n}\n\n/**\n * Start the periodic refresh. The first tick fires after one full\n * interval rather than at start — gateways on low-power hardware can\n * restart-loop during setup (issue #462), and an immediate fetch on\n * every restart would hammer provider APIs. Operators who want an\n * instant refresh run `wearables sync` (or call `tick()`).\n */\nexport function startWearablesAutoSync(\n  settings: WearablesAutoSyncSettings,\n  deps: WearablesAutoSyncDeps,\n): WearablesAutoSyncHandle {\n  let inFlight: Promise<void> | null = null;\n  let stopped = false;\n  let lastDeepDate: string | null = null;\n  // Aborting cancels the in-flight sync's provider fetches promptly on\n  // shutdown — without it, a slow tick would keep writing/reindexing\n  // after orchestrator.destroy() while a restarted host starts a\n  // second scheduler (Kilo review on PR #1464).\n  const abortController = new AbortController();\n\n  const tick = async (): Promise<void> => {\n    // Overlap guard: a slow provider or large deep window must never\n    // stack a second sync on top of a running one. The skipped call\n    // resolves immediately — it must NOT await the running tick, or a\n    // caller holding both promises could deadlock itself.\n    if (inFlight || stopped) return;\n    const run = (async () => {\n      try {\n        const now = deps.now ? deps.now() : new Date();\n        const today = dateInTimezone(now, settings.timezone ?? defaultTimezone());\n        const deep = settings.deepDays > 0 && lastDeepDate !== today;\n        const days = deep ? settings.deepDays : settings.days;\n        await deps.sync({ days, signal: abortController.signal });\n        // Mark the deep pass done only AFTER it succeeded — a failed\n        // deep pass retries on the next tick instead of silently\n        // waiting for tomorrow (CLAUDE.md rule 25's \"confirm before\n        // consuming the one-shot\" shape).\n        if (deep) lastDeepDate = today;\n        deps.log.info(\n          `wearables auto-sync: refreshed ${days}-day window${deep ? \" (daily deep pass)\" : \"\"}`,\n        );\n      } catch (err) {\n        // An abort raised by stop() is intentional shutdown, not a\n        // failure — warning about it would be noise in every clean\n        // shutdown log.\n        if (!stopped) {\n          deps.log.warn(\n            `wearables auto-sync failed: ${describeErrorForOperator(err)} — retrying on the next tick`,\n          );\n        }\n      } finally {\n        inFlight = null;\n      }\n    })();\n    inFlight = run;\n    await run;\n  };\n\n  const timer = setInterval(() => {\n    void tick();\n  }, settings.intervalMinutes * 60_000);\n  timer.unref?.();\n\n  return {\n    tick,\n    stop: async () => {\n      stopped = true;\n      clearInterval(timer);\n      abortController.abort();\n      // tick() never rejects (all paths caught), so this only waits.\n      if (inFlight) await inFlight;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8DO,SAAS,uBACd,UACA,MACyB;AACzB,MAAI,WAAiC;AACrC,MAAI,UAAU;AACd,MAAI,eAA8B;AAKlC,QAAM,kBAAkB,IAAI,gBAAgB;AAE5C,QAAM,OAAO,YAA2B;AAKtC,QAAI,YAAY,QAAS;AACzB,UAAM,OAAO,YAAY;AACvB,UAAI;AACF,cAAM,MAAM,KAAK,MAAM,KAAK,IAAI,IAAI,oBAAI,KAAK;AAC7C,cAAM,QAAQ,eAAe,KAAK,SAAS,YAAY,gBAAgB,CAAC;AACxE,cAAM,OAAO,SAAS,WAAW,KAAK,iBAAiB;AACvD,cAAM,OAAO,OAAO,SAAS,WAAW,SAAS;AACjD,cAAM,KAAK,KAAK,EAAE,MAAM,QAAQ,gBAAgB,OAAO,CAAC;AAKxD,YAAI,KAAM,gBAAe;AACzB,aAAK,IAAI;AAAA,UACP,kCAAkC,IAAI,cAAc,OAAO,uBAAuB,EAAE;AAAA,QACtF;AAAA,MACF,SAAS,KAAK;AAIZ,YAAI,CAAC,SAAS;AACZ,eAAK,IAAI;AAAA,YACP,+BAA+B,yBAAyB,GAAG,CAAC;AAAA,UAC9D;AAAA,QACF;AAAA,MACF,UAAE;AACA,mBAAW;AAAA,MACb;AAAA,IACF,GAAG;AACH,eAAW;AACX,UAAM;AAAA,EACR;AAEA,QAAM,QAAQ,YAAY,MAAM;AAC9B,SAAK,KAAK;AAAA,EACZ,GAAG,SAAS,kBAAkB,GAAM;AACpC,QAAM,QAAQ;AAEd,SAAO;AAAA,IACL;AAAA,IACA,MAAM,YAAY;AAChB,gBAAU;AACV,oBAAc,KAAK;AACnB,sBAAgB,MAAM;AAEtB,UAAI,SAAU,OAAM;AAAA,IACtB;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/wearables/auto-sync.ts"],"sourcesContent":["/**\n * Wearables auto-sync — in-process periodic transcript refresh.\n *\n * Every tick re-syncs a short rolling window ending today for ALL\n * enabled sources, so the current day's transcript keeps growing while\n * the wearable records and provider-side revisions of recent days flow\n * in without operator action. Once per local day the window deepens to\n * `autoSyncDeepDays` to pick up late uploads and provider reprocessing\n * further back (phones syncing hours later, re-diarized transcripts).\n *\n * Day fetches are unconditional within the window — existing day files\n * are always re-fetched and re-composed; the content-hash skip in the\n * pipeline keeps unchanged days write-free, so a tick on a quiet day\n * is read-only. The timer is unref'd: it never keeps a one-shot CLI\n * process alive, and long-lived hosts stop it via the returned handle.\n */\n\nimport { describeErrorForOperator } from \"./errors.js\";\nimport { dateInTimezone, defaultTimezone } from \"./pipeline.js\";\n\nexport interface WearablesAutoSyncSettings {\n  /** Minutes between ticks. */\n  intervalMinutes: number;\n  /** Rolling window (days ending today) refreshed on a normal tick. */\n  days: number;\n  /**\n   * Window for the once-per-local-day deep pass. 0 disables the deep\n   * pass; otherwise must be >= `days` (validated at config parse).\n   */\n  deepDays: number;\n  /** IANA timezone used to detect the local-day rollover. */\n  timezone?: string;\n}\n\nexport interface WearablesAutoSyncDeps {\n  /** Run a sync across all enabled sources (WearablesService.sync). */\n  sync(options: { days: number; signal?: AbortSignal }): Promise<unknown>;\n  log: { info(message: string): void; warn(message: string): void };\n  /** Clock injection for tests. */\n  now?: () => Date;\n}\n\nexport interface WearablesAutoSyncHandle {\n  /** Run one scheduler tick now (first-run hook and test seam). */\n  tick(): Promise<void>;\n  /**\n   * Stop the scheduler: clears the timer, aborts the in-flight sync's\n   * provider fetches via AbortSignal, and resolves once the in-flight\n   * tick has fully settled — after `await stop()` nothing is writing\n   * or reindexing anymore. The handle is single-use; a restarted host\n   * starts a fresh one.\n   */\n  stop(): Promise<void>;\n}\n\n/**\n * Start the periodic refresh. The first tick fires after one full\n * interval rather than at start — gateways on low-power hardware can\n * restart-loop during setup (issue #462), and an immediate fetch on\n * every restart would hammer provider APIs. Operators who want an\n * instant refresh run `wearables sync` (or call `tick()`).\n */\nexport function startWearablesAutoSync(\n  settings: WearablesAutoSyncSettings,\n  deps: WearablesAutoSyncDeps,\n): WearablesAutoSyncHandle {\n  let inFlight: Promise<void> | null = null;\n  let stopped = false;\n  let lastDeepDate: string | null = null;\n  // Aborting cancels the in-flight sync's provider fetches promptly on\n  // shutdown — without it, a slow tick would keep writing/reindexing\n  // after orchestrator.destroy() while a restarted host starts a\n  // second scheduler (Kilo review on PR #1464).\n  const abortController = new AbortController();\n\n  const tick = async (): Promise<void> => {\n    // Overlap guard: a slow provider or large deep window must never\n    // stack a second sync on top of a running one. The skipped call\n    // resolves immediately — it must NOT await the running tick, or a\n    // caller holding both promises could deadlock itself.\n    if (inFlight || stopped) return;\n    const run = (async () => {\n      try {\n        const now = deps.now ? deps.now() : new Date();\n        const today = dateInTimezone(now, settings.timezone ?? defaultTimezone());\n        const deep = settings.deepDays > 0 && lastDeepDate !== today;\n        const days = deep ? settings.deepDays : settings.days;\n        await deps.sync({ days, signal: abortController.signal });\n        // Mark the deep pass done only AFTER it succeeded — a failed\n        // deep pass retries on the next tick instead of silently\n        // waiting for tomorrow (CLAUDE.md rule 25's \"confirm before\n        // consuming the one-shot\" shape).\n        if (deep) lastDeepDate = today;\n        deps.log.info(\n          `wearables auto-sync: refreshed ${days}-day window${deep ? \" (daily deep pass)\" : \"\"}`,\n        );\n      } catch (err) {\n        // An abort raised by stop() is intentional shutdown, not a\n        // failure — warning about it would be noise in every clean\n        // shutdown log.\n        if (!stopped) {\n          deps.log.warn(\n            `wearables auto-sync failed: ${describeErrorForOperator(err)} — retrying on the next tick`,\n          );\n        }\n      } finally {\n        inFlight = null;\n      }\n    })();\n    inFlight = run;\n    await run;\n  };\n\n  const timer = setInterval(() => {\n    void tick();\n  }, settings.intervalMinutes * 60_000);\n  timer.unref?.();\n\n  return {\n    tick,\n    stop: async () => {\n      stopped = true;\n      clearInterval(timer);\n      abortController.abort();\n      // tick() never rejects (all paths caught), so this only waits.\n      if (inFlight) await inFlight;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8DO,SAAS,uBACd,UACA,MACyB;AACzB,MAAI,WAAiC;AACrC,MAAI,UAAU;AACd,MAAI,eAA8B;AAKlC,QAAM,kBAAkB,IAAI,gBAAgB;AAE5C,QAAM,OAAO,YAA2B;AAKtC,QAAI,YAAY,QAAS;AACzB,UAAM,OAAO,YAAY;AACvB,UAAI;AACF,cAAM,MAAM,KAAK,MAAM,KAAK,IAAI,IAAI,oBAAI,KAAK;AAC7C,cAAM,QAAQ,eAAe,KAAK,SAAS,YAAY,gBAAgB,CAAC;AACxE,cAAM,OAAO,SAAS,WAAW,KAAK,iBAAiB;AACvD,cAAM,OAAO,OAAO,SAAS,WAAW,SAAS;AACjD,cAAM,KAAK,KAAK,EAAE,MAAM,QAAQ,gBAAgB,OAAO,CAAC;AAKxD,YAAI,KAAM,gBAAe;AACzB,aAAK,IAAI;AAAA,UACP,kCAAkC,IAAI,cAAc,OAAO,uBAAuB,EAAE;AAAA,QACtF;AAAA,MACF,SAAS,KAAK;AAIZ,YAAI,CAAC,SAAS;AACZ,eAAK,IAAI;AAAA,YACP,+BAA+B,yBAAyB,GAAG,CAAC;AAAA,UAC9D;AAAA,QACF;AAAA,MACF,UAAE;AACA,mBAAW;AAAA,MACb;AAAA,IACF,GAAG;AACH,eAAW;AACX,UAAM;AAAA,EACR;AAEA,QAAM,QAAQ,YAAY,MAAM;AAC9B,SAAK,KAAK;AAAA,EACZ,GAAG,SAAS,kBAAkB,GAAM;AACpC,QAAM,QAAQ;AAEd,SAAO;AAAA,IACL;AAAA,IACA,MAAM,YAAY;AAChB,gBAAU;AACV,oBAAc,KAAK;AACnB,sBAAgB,MAAM;AAEtB,UAAI,SAAU,OAAM;AAAA,IACtB;AAAA,EACF;AACF;","names":[]}

package/dist/briefing.js

@@ -18,15 +18,16 @@ import {
   renderBriefingMarkdown,
   resolveBriefingSaveDir,
   validateBriefingFormat
-} from "./chunk-GF4H3B3R.js";
+} from "./chunk-C3WJNRGR.js";
 import "./chunk-GZFKCLRC.js";
 import "./chunk-6JMQR72P.js";
-import "./chunk-37HCPM56.js";
-import "./chunk-46WM6JX2.js";
+import "./chunk-WJLGUY27.js";
 import "./chunk-UHVXE24Y.js";
+import "./chunk-LZKOVXMX.js";
 import "./chunk-V4JZCTMK.js";
-import "./chunk-RSMIRLKM.js";
-import "./chunk-U6OXJQEH.js";
+import "./chunk-7UX44C4N.js";
+import "./chunk-MB5EJ2CT.js";
+import "./chunk-CYEPCZN5.js";
 import "./chunk-T3FMRLWQ.js";
 import "./chunk-7VO6E5UD.js";
 import "./chunk-5BUCKFRE.js";
@@ -34,7 +35,6 @@ import "./chunk-S7LWX2PQ.js";
 import "./chunk-T2YX56QI.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-CYEPCZN5.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";
@@ -43,12 +43,12 @@ import "./chunk-S2V7RUCL.js";
 import "./chunk-X3724WL4.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
-import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
+import "./chunk-DM2T26WE.js";
 import "./chunk-FF6N7BXC.js";
 import "./chunk-2DT7PIDZ.js";
 import "./chunk-AAD2ZS6P.js";
-import "./chunk-EIFYYHAF.js";
+import "./chunk-YYO447A7.js";
 import "./chunk-ZIKENA2C.js";
 import "./chunk-3OUGSOJP.js";
 import "./chunk-SCU65EZI.js";
@@ -56,20 +56,20 @@ import "./chunk-3ONXXHQO.js";
 import "./chunk-YXZG5TVN.js";
 import "./chunk-3WU7XOFN.js";
 import "./chunk-6MKLMEBE.js";
-import "./chunk-W5XWHTDO.js";
+import "./chunk-QZZPUREO.js";
 import "./chunk-M5GVCJSJ.js";
 import "./chunk-RBOJCG4T.js";
-import "./chunk-R7QY5ZVB.js";
+import "./chunk-4NDWE44P.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-7CT3AI52.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-AJ6ORARY.js";
-import "./chunk-IUM3VSHI.js";
+import "./chunk-DGRMWDQY.js";
 import "./chunk-G26YNEOC.js";
-import "./chunk-IM2GO42H.js";
-import "./chunk-TPSLVZHS.js";
 import "./chunk-SIGAGKNE.js";
+import "./chunk-IUM3VSHI.js";
+import "./chunk-WVHRNAXL.js";
+import "./chunk-TPSLVZHS.js";
 import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
@@ -87,30 +87,31 @@ import "./chunk-PJKTFXE2.js";
 import "./chunk-W5BIQOAJ.js";
 import "./chunk-QWWMS4AE.js";
 import "./chunk-YBA52OKG.js";
-import "./chunk-5AYUHSAU.js";
+import "./chunk-OFCHT2TN.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-PO7NXNGC.js";
+import "./chunk-VFTK5WKI.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
 import "./chunk-L272A5QW.js";
-import "./chunk-XVC7JU2N.js";
+import "./chunk-FQD2KPQH.js";
 import "./chunk-ZA53AZND.js";
 import "./chunk-7RJUVTVF.js";
 import "./chunk-AL3UYZ5N.js";
 import "./chunk-RL6NEVXT.js";
 import "./chunk-PWPIERBM.js";
 import "./chunk-C7HJ3NEI.js";
-import "./chunk-N4PYB235.js";
+import "./chunk-KI6UOSNR.js";
 import "./chunk-BTNNL7ZW.js";
 import "./chunk-5FVVY2EB.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-FFAZ2XFU.js";
+import "./chunk-EHRE7ZG3.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-VUFL7X3H.js";
 import "./chunk-2EMROIXS.js";
+import "./chunk-7LEQREP2.js";
 import "./chunk-ZEFVK7XC.js";
 import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";

package/dist/buffer.js

@@ -1,43 +1,44 @@
 import {
   SmartBuffer
-} from "./chunk-I25RQA65.js";
+} from "./chunk-55ZVZBX4.js";
 import "./chunk-T5IF2ZCE.js";
 import "./chunk-H3FZVNRN.js";
-import "./chunk-KE5PWLI6.js";
-import "./chunk-OGVJXIHX.js";
+import "./chunk-LOFVW6JA.js";
+import "./chunk-PBVNVKYN.js";
 import "./chunk-CSAKJVXW.js";
 import "./chunk-K2XUWZBM.js";
 import "./chunk-OD4FM2U7.js";
 import "./chunk-TBBDFYXW.js";
 import "./chunk-ZJP66Q4I.js";
-import "./chunk-AJ6ORARY.js";
-import "./chunk-IUM3VSHI.js";
+import "./chunk-DGRMWDQY.js";
 import "./chunk-G26YNEOC.js";
-import "./chunk-IM2GO42H.js";
-import "./chunk-TPSLVZHS.js";
 import "./chunk-SIGAGKNE.js";
+import "./chunk-IUM3VSHI.js";
+import "./chunk-WVHRNAXL.js";
+import "./chunk-TPSLVZHS.js";
 import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
-import "./chunk-CLCMDKTB.js";
+import "./chunk-3I3U6FFT.js";
 import "./chunk-353C5UNV.js";
-import "./chunk-5AYUHSAU.js";
+import "./chunk-OFCHT2TN.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-PO7NXNGC.js";
+import "./chunk-VFTK5WKI.js";
 import "./chunk-E5H4TM4Y.js";
 import "./chunk-C7HJ3NEI.js";
-import "./chunk-N4PYB235.js";
+import "./chunk-KI6UOSNR.js";
 import "./chunk-BTNNL7ZW.js";
 import "./chunk-5FVVY2EB.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-FFAZ2XFU.js";
+import "./chunk-EHRE7ZG3.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-OEIA4IHU.js";
 import "./chunk-PCXDUHQH.js";
 import "./chunk-VUFL7X3H.js";
 import "./chunk-2EMROIXS.js";
+import "./chunk-7LEQREP2.js";
 import "./chunk-3Q3N35W7.js";
 import "./chunk-ZEFVK7XC.js";
 import "./chunk-6KH5NLQS.js";

package/dist/{capsule-merge-42GJGDUC.js → capsule-merge-M4HETD27.js}

@@ -1,6 +1,6 @@
 import {
   createVersion
-} from "./chunk-W5XWHTDO.js";
+} from "./chunk-QZZPUREO.js";
 import {
   bumpMemoryCorpusVersionForDir
 } from "./chunk-M5GVCJSJ.js";
@@ -13,7 +13,7 @@ import {
   repairContentAfterJournalMove,
   requestEntityCanonicalIdReconcile,
   withRawEntityPageMutation
-} from "./chunk-R7QY5ZVB.js";
+} from "./chunk-4NDWE44P.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-7CT3AI52.js";
@@ -29,7 +29,8 @@ import {
   isPathInsideRoot,
   sha256String
 } from "./chunk-GCGJW34D.js";
-import "./chunk-FFAZ2XFU.js";
+import "./chunk-EHRE7ZG3.js";
+import "./chunk-7LEQREP2.js";
 import "./chunk-VS2IYZRU.js";
 import "./chunk-KNA3BXXL.js";
 import "./chunk-3WCASNQZ.js";
@@ -278,4 +279,4 @@ async function readLocalFile(absPath) {
 export {
   mergeCapsule
 };
-//# sourceMappingURL=capsule-merge-42GJGDUC.js.map
+//# sourceMappingURL=capsule-merge-M4HETD27.js.map

package/dist/{capsule-merge-42GJGDUC.js.map → capsule-merge-M4HETD27.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/transfer/capsule-merge.ts"],"sourcesContent":["import { lstat, mkdir, readFile, realpath, stat, unlink, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { gunzipSync } from \"node:zlib\";\nimport { bumpMemoryCorpusVersionForDir } from \"../memory-corpus-version.js\";\nimport {\n  HistoricalEntityCanonicalIdCache,\n  canonicalizeEntityRefFrontmatter,\n  readEntityRefFromFrontmatter,\n  classifyEntityRefWritePath,\n  repairContentAfterJournalMove,\n  requestEntityCanonicalIdReconcile,\n} from \"../storage/entity-canonical-id-references.js\";\nimport { withRawEntityPageMutation } from \"../storage/entity-canonical-id-lock.js\";\nimport {\n  createVersion,\n  type VersioningConfig,\n  type VersioningLogger,\n} from \"../page-versioning.js\";\nimport {\n  assertIsDirectoryNotSymlink,\n  assertRealpathInsideRoot,\n  fromPosixRelPath,\n  isPathInsideRoot,\n  sha256String,\n} from \"./fs-utils.js\";\nimport {\n  parseExportBundle,\n  type CapsuleBlock,\n  type ExportManifestV2,\n  type ExportMemoryRecordV1,\n} from \"./types.js\";\n\n/**\n * Three-way conflict-resolution mode for {@link mergeCapsule}.\n *\n * A \"conflict\" is defined as: the same memory-file path exists in both the\n * source archive and the target directory AND the content hash of the local\n * file differs from the archive's manifest entry for that path.\n *\n * Files that exist only in the archive (no local counterpart) are always\n * written regardless of mode — there is no conflict to resolve.\n *\n * Files that are byte-identical (same content hash in both locations) are\n * recorded as {@link MergeCapsuleResult.skipped} with reason `\"identical\"` and\n * are never re-written regardless of mode; this is a no-op optimisation rather\n * than a conflict.\n *\n *  - `\"skip-conflicts\"` (default) — log the conflict, skip the conflicting\n *    archive entries, but continue importing non-conflicting entries. The\n *    resulting merge is the union of:\n *      - all non-conflicting archive files (written to target)\n *      - all pre-existing local files (left unchanged)\n *\n *  - `\"prefer-source\"` — for conflicting files, snapshot the local content via\n *    page-versioning (gotcha #54: snapshot before overwrite) then overwrite\n *    with the archive content.\n *\n *  - `\"prefer-local\"` — for conflicting files, keep the local content; the\n *    archive entry is skipped.\n */\nexport type MergeCapsuleConflictMode =\n  | \"skip-conflicts\"\n  | \"prefer-source\"\n  | \"prefer-local\";\n\n/**\n * Options accepted by {@link mergeCapsule}.\n *\n * `sourceArchive` — absolute or cwd-relative path to a `.capsule.json.gz`\n * archive produced by `exportCapsule`. Must be a V2 bundle.\n *\n * `targetRoot` — absolute or cwd-relative path to the memory directory that\n * receives the merged records. Must be an existing, non-symlink directory.\n *\n * `conflictMode` — see {@link MergeCapsuleConflictMode}. Defaults to\n * `\"skip-conflicts\"`.\n *\n * `versioning` — optional page-versioning config forwarded to\n * {@link createVersion} in `\"prefer-source\"` mode. When omitted or disabled,\n * overwrites proceed without snapshotting (not recommended for production).\n *\n * `log` — optional logger forwarded to {@link createVersion}.\n */\nexport interface MergeCapsuleOptions {\n  sourceArchive: string;\n  targetRoot: string;\n  conflictMode?: MergeCapsuleConflictMode;\n  versioning?: VersioningConfig;\n  log?: VersioningLogger;\n}\n\nexport interface MergeCapsuleWrittenRecord {\n  /** Capsule-relative posix path. */\n  sourcePath: string;\n  /** Memory-dir-relative posix path written on disk. */\n  targetPath: string;\n  /** Whether a page-versioning snapshot was taken before overwriting. */\n  snapshotted: boolean;\n}\n\nexport interface MergeCapsuleSkippedRecord {\n  /** Capsule-relative posix path. */\n  path: string;\n  /**\n   * Why the archive entry was not written.\n   *\n   * `\"conflict\"` — the entry existed locally with different content and the\n   * active mode did not resolve the conflict with a write (`\"skip-conflicts\"` /\n   * `\"prefer-local\"`).\n   *\n   * `\"identical\"` — the entry's content hash matches what is already on disk;\n   * no write is needed.\n   */\n  reason: \"conflict\" | \"identical\";\n}\n\nexport interface MergeCapsuleConflictRecord {\n  /** Capsule-relative posix path of the conflicting entry. */\n  path: string;\n  /** SHA-256 of the archive's copy. */\n  archiveSha256: string;\n  /** SHA-256 of the local copy. */\n  localSha256: string;\n}\n\nexport interface MergeCapsuleResult {\n  /** Records that were written to the target directory. */\n  merged: MergeCapsuleWrittenRecord[];\n  /**\n   * Records that were NOT written (conflict skipped, or byte-identical).\n   * Includes conflicts that were resolved by `\"prefer-local\"`.\n   */\n  skipped: MergeCapsuleSkippedRecord[];\n  /**\n   * Metadata about every detected conflict, regardless of which mode resolved\n   * it. Callers can use this to report \"N conflicts encountered; M overwritten\".\n   */\n  conflicts: MergeCapsuleConflictRecord[];\n  /** The manifest decoded from the archive. */\n  manifest: ExportManifestV2;\n}\n\n// ---------------------------------------------------------------------------\n// Main entry point\n// ---------------------------------------------------------------------------\n\n/**\n * Merge a V2 capsule archive into an existing memory directory using\n * three-way conflict semantics.\n *\n * Sequence:\n *   1. Read + gunzip + JSON.parse the archive.\n *   2. Validate through `parseExportBundle` (V1 rejected).\n *   3. Verify every record's content sha256 against the manifest.\n *      Any mismatch aborts BEFORE any file is written (gotcha #25).\n *   4. Classify each record as: new (no local copy), identical (same hash),\n *      or conflicting (different hash).\n *   5. Apply the selected {@link MergeCapsuleConflictMode} to conflicting\n *      entries; always write new entries; always skip identical entries.\n *\n * Determinism: `merged`, `skipped`, and `conflicts` are all returned sorted\n * by `path`/`sourcePath` so callers get stable output regardless of bundle\n * order.\n */\nexport async function mergeCapsule(\n  opts: MergeCapsuleOptions,\n): Promise<MergeCapsuleResult> {\n  const archiveAbs = path.resolve(opts.sourceArchive);\n  const rootAbs = path.resolve(opts.targetRoot);\n\n  await assertIsDirectoryNotSymlink(rootAbs, \"mergeCapsule\", \"targetRoot\");\n\n  const conflictMode: MergeCapsuleConflictMode =\n    opts.conflictMode ?? \"skip-conflicts\";\n\n  // Rule 51: reject invalid conflictMode values up-front before any I/O.\n  if (\n    conflictMode !== \"skip-conflicts\" &&\n    conflictMode !== \"prefer-source\" &&\n    conflictMode !== \"prefer-local\"\n  ) {\n    throw new Error(\n      `mergeCapsule: unknown conflictMode ${JSON.stringify(conflictMode)}; ` +\n        `expected \"skip-conflicts\", \"prefer-source\", or \"prefer-local\"`,\n    );\n  }\n\n  // ---------------------------------------------------------------------------\n  // Parse + validate archive\n  // ---------------------------------------------------------------------------\n\n  const raw = await readFile(archiveAbs);\n  let json: string;\n  try {\n    json = gunzipSync(raw).toString(\"utf-8\");\n  } catch (cause) {\n    throw new Error(\n      `mergeCapsule: archive is not a valid gzip file: ${archiveAbs}`,\n      { cause: cause as Error },\n    );\n  }\n\n  let parsedJson: unknown;\n  try {\n    parsedJson = JSON.parse(json);\n  } catch (cause) {\n    throw new Error(\n      `mergeCapsule: archive is not valid JSON after gunzip: ${archiveAbs}`,\n      { cause: cause as Error },\n    );\n  }\n\n  const parsed = parseExportBundle(parsedJson);\n  if (parsed.capsuleVersion !== 2) {\n    throw new Error(\n      \"mergeCapsule: archive is V1; only V2 capsule archives are supported\",\n    );\n  }\n\n  const bundle = parsed.bundle as {\n    manifest: ExportManifestV2;\n    records: ExportMemoryRecordV1[];\n  };\n  const manifest = bundle.manifest;\n  const capsule = manifest.capsule;\n\n  // Build path → manifest entry index for O(1) checksum lookup.\n  const manifestIndex = new Map<string, ExportManifestV2[\"files\"][number]>();\n  for (const f of manifest.files) {\n    manifestIndex.set(f.path, f);\n  }\n  if (manifestIndex.size !== manifest.files.length) {\n    throw new Error(\"mergeCapsule: manifest contains duplicate file paths\");\n  }\n\n  const recordPaths = new Set<string>();\n  for (const rec of bundle.records) {\n    if (recordPaths.has(rec.path)) {\n      throw new Error(\n        `mergeCapsule: bundle contains duplicate record path: ${rec.path}`,\n      );\n    }\n    recordPaths.add(rec.path);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Phase 1: verify checksums + validate paths before ANY filesystem mutation.\n  // (gotcha #25: don't destroy old state before confirming new state succeeds)\n  // ---------------------------------------------------------------------------\n\n  const rootReal = await realpath(rootAbs).catch(() => rootAbs);\n\n  // Tracks normalized, case-folded target paths seen so far in phase 1.  Maps\n  // targetAbs.toLowerCase() → first source path so the collision error can name\n  // both offending entries.  Two manifest entries whose computed target paths\n  // normalise to the same absolute path (e.g. `subdir/file.md` and\n  // `subdir/./file.md`, or differing case on case-insensitive filesystems such\n  // as macOS and Windows) would both refer to the same inode.  In\n  // `skip-conflicts`/`prefer-local` modes one entry would be misclassified as a\n  // local conflict against the OTHER entry's just-written content; in\n  // `prefer-source` the second entry would silently overwrite the first.  We\n  // reject the import up-front before any write (Codex P2 thread on PR #748,\n  // mirroring `capsule-import.ts`).\n  const seenTargetPaths = new Map<string, string>();\n\n  for (const rec of bundle.records) {\n    // Checksum validation.\n    const entry = manifestIndex.get(rec.path);\n    if (!entry) {\n      throw new Error(\n        `mergeCapsule: archive checksum mismatch (record without manifest entry: ${rec.path})`,\n      );\n    }\n    const { sha256, bytes } = sha256String(rec.content);\n    if (sha256 !== entry.sha256 || bytes !== entry.bytes) {\n      throw new Error(\n        `mergeCapsule: archive checksum mismatch for ${rec.path}: ` +\n          `expected sha256=${entry.sha256} bytes=${entry.bytes}, ` +\n          `got sha256=${sha256} bytes=${bytes}`,\n      );\n    }\n\n    // Path-traversal validation (mirrors capsule-import.ts).\n    if (rec.path.includes(\"\\\\\")) {\n      throw new Error(\n        `mergeCapsule: record path contains backslash separators (Windows-style paths are not allowed): ${rec.path}`,\n      );\n    }\n    const posixNormalized = path.posix.normalize(rec.path);\n    if (\n      rec.path.startsWith(\"/\") ||\n      rec.path.split(\"/\").some((seg) => seg === \"..\") ||\n      posixNormalized.startsWith(\"..\") ||\n      posixNormalized.startsWith(\"/\")\n    ) {\n      throw new Error(\n        `mergeCapsule: record path escapes target root: ${rec.path}`,\n      );\n    }\n\n    // Lexical root containment check.\n    const targetAbs = path.join(rootReal, fromPosixRelPath(rec.path));\n    if (!isPathInsideRoot(rootReal, targetAbs)) {\n      throw new Error(\n        `mergeCapsule: record path escapes target root: ${rec.path}`,\n      );\n    }\n\n    // Symlink-aware containment check (shared helper from fs-utils).\n    await assertRealpathInsideRoot(rootReal, targetAbs, rec.path, \"mergeCapsule\");\n\n    // Target-file symlink guard: if the target already exists as a symlink,\n    // reject — writes through symlinks can redirect to unexpected locations.\n    const targetLstat = await lstat(targetAbs).catch(() => null);\n    if (targetLstat !== null && targetLstat.isSymbolicLink()) {\n      throw new Error(\n        `mergeCapsule: record target is a symlink and cannot be written to safely: ${rec.path}`,\n      );\n    }\n\n    // Duplicate normalized target path detection (Codex P2 #748, mirrors\n    // capsule-import.ts).  `path.join` already normalises `.` segments\n    // (e.g. `subdir/./file.md` → `subdir/file.md`).  On case-insensitive\n    // filesystems (macOS default, Windows), two paths that differ only in case\n    // would resolve to the same inode.  We fold the dedup key to lowercase so\n    // that `subdir/File.md` and `subdir/file.md` are detected as duplicates\n    // before any write occurs.  This is intentionally unconditional: the cost\n    // of an extra `.toLowerCase()` on case-sensitive filesystems is negligible,\n    // and a defensive lowercase is far simpler than probing filesystem\n    // case-sensitivity at runtime.  Without this guard, prefer-source mode\n    // would silently overwrite one entry with the other, and skip-conflicts /\n    // prefer-local would misclassify the second entry as a local conflict\n    // against the first entry's freshly written content.\n    const dedupKey = targetAbs.toLowerCase();\n    const firstSourcePath = seenTargetPaths.get(dedupKey);\n    if (firstSourcePath !== undefined) {\n      throw new Error(\n        `mergeCapsule: manifest contains two entries that resolve to the same target path: ` +\n          `\"${firstSourcePath}\" and \"${rec.path}\" both map to \"${rec.path}\"`,\n      );\n    }\n    seenTargetPaths.set(dedupKey, rec.path);\n  }\n\n  // Detect manifest-only entries (missing record). Treat as corruption.\n  for (const f of manifest.files) {\n    if (!recordPaths.has(f.path)) {\n      throw new Error(\n        `mergeCapsule: archive checksum mismatch (manifest entry without record: ${f.path})`,\n      );\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Phase 2: classify records and apply conflict mode.\n  // ---------------------------------------------------------------------------\n\n  const merged: MergeCapsuleWrittenRecord[] = [];\n  const skipped: MergeCapsuleSkippedRecord[] = [];\n  const conflicts: MergeCapsuleConflictRecord[] = [];\n  // Same write-boundary rule as capsule-import (issue #2213): records land\n  // with their entityRef resolved through the target's migration journal,\n  // read through the identity-keyed cache PER RECORD so a peer migration\n  // completing mid-merge is picked up for every record written after it.\n  const journalStateDir = path.join(rootReal, \"state\");\n  const historicalIdCache = new HistoricalEntityCanonicalIdCache();\n  // Entity pages in THIS capsule can re-establish collisions the target's\n  // journal already resolved (Codex P1): once the next migration parks the\n  // mapping, a memory canonicalized onto the canonical claimant is\n  // permanently misattributed. Memories whose ref targets a capsule-supplied\n  // entity id merge byte-faithful behind the reconcile marker instead.\n  const capsuleEntityIds = new Set(\n    bundle.records\n      .filter((record) =>\n        classifyEntityRefWritePath(rootReal, path.join(rootReal, fromPosixRelPath(record.path))) === \"entity\")\n      .map((record) => path.basename(record.path, \".md\")),\n  );\n  // Write a record with its entityRef resolved AT the write, then repair if\n  // the journal moved across the write itself — a parked mapping cannot be\n  // fixed after the fact by the reconcile pass (issue #2213). Only memory-tier\n  // records canonicalize; entities/ pages carry relationship TARGETS only\n  // rewriteRelationshipTargets understands, so they merge byte-faithful with\n  // a reconcile marker; everything else merges losslessly. The corpus bump\n  // lands AFTER the repair so a warm cache rescan never captures pre-repair\n  // bytes.\n  // The reconcile marker is published ONCE, after every record landed\n  // (Codex P1, round 21): a per-record marker could be consumed by a peer\n  // between a legacy-preserving memory write and its colliding entity page,\n  // canonicalizing the memory onto the wrong claimant irreversibly.\n  let reconcileNeeded = false;\n  const writeCanonicalRecord = async (targetAbs: string, rawContent: string): Promise<void> => {\n    const kind = classifyEntityRefWritePath(rootReal, targetAbs);\n    const rawRef = kind === \"memory\" ? readEntityRefFromFrontmatter(rawContent) : null;\n    if (kind === \"memory\" && rawRef !== null && capsuleEntityIds.has(rawRef)) {\n      // Ref targets a capsule-supplied entity page (potential collision\n      // claimant): keep the legacy bytes; the deferred marker lets the\n      // migration settle the collision and rewrite per its verdict (Codex P1).\n      await writeFile(targetAbs, rawContent, \"utf-8\");\n      reconcileNeeded = true;\n      bumpMemoryCorpusVersionForDir(rootReal); // per-write bump (Cursor Medium, #1902)\n      return;\n    }\n    if (kind !== \"memory\") {\n      await writeFile(targetAbs, rawContent, \"utf-8\");\n      if (kind === \"entity\") {\n        reconcileNeeded = true;\n      }\n      bumpMemoryCorpusVersionForDir(rootReal); // per-write bump (Cursor Medium, #1902)\n      return;\n    }\n    const idsAtWrite = historicalIdCache.get(journalStateDir);\n    const written = canonicalizeEntityRefFrontmatter(rawContent, idsAtWrite);\n    // Snapshot the pre-write bytes: a repair failure after the write must\n    // restore them (or remove a newly created target) before propagating —\n    // the merge reports failure, so disk must return to its pre-write state\n    // and warm caches stay consistent (AGENTS.md §14).\n    const originalBytes = await readLocalFile(targetAbs);\n    await writeFile(targetAbs, written, \"utf-8\");\n    try {\n      await repairContentAfterJournalMove({\n        stateDir: journalStateDir,\n        cache: historicalIdCache,\n        idsAtWrite,\n        rawContent,\n        lastWritten: written,\n        rewrite: (content) => writeFile(targetAbs, content, \"utf-8\"),\n      });\n    } catch (err) {\n      if (originalBytes === null) {\n        await unlink(targetAbs).catch(() => undefined);\n      } else {\n        await writeFile(targetAbs, originalBytes, \"utf-8\").catch(() => undefined);\n      }\n      throw err;\n    }\n    bumpMemoryCorpusVersionForDir(rootReal); // per-write bump (Cursor Medium, #1902)\n  };\n\n  // Sort by source path for deterministic output (mirrors capsule-import.ts).\n  const sortedRecords = [...bundle.records].sort((a, b) =>\n    a.path.localeCompare(b.path),\n  );\n\n  const applyRecords = async (): Promise<void> => {\n  for (const rec of sortedRecords) {\n    const targetAbs = path.join(rootReal, fromPosixRelPath(rec.path));\n    const entry = manifestIndex.get(rec.path)!; // validated above\n\n    const localContent = await readLocalFile(targetAbs);\n\n    if (localContent === null) {\n      // No local copy — always write regardless of mode. Resolve at the write\n      // itself and verify the journal afterwards: a peer migration completing\n      // during any of these awaits (or the write) would otherwise strand the\n      // reference — capsule writes bump only the corpus version, which the\n      // migration fingerprint deliberately ignores.\n      await mkdir(path.dirname(targetAbs), { recursive: true });\n      await writeCanonicalRecord(targetAbs, rec.content);\n      merged.push({ sourcePath: rec.path, targetPath: rec.path, snapshotted: false });\n      continue;\n    }\n\n    // Local file exists. A local copy already holding the CANONICALIZED form\n    // (computed AFTER the local read, so a journal published during that\n    // await is reflected) is done. A local copy matching the RAW archive\n    // bytes while a mapping applies is UPGRADED in place — skipping would\n    // leave the legacy entityRef on disk forever, since corpus bumps no\n    // longer trigger migration rewrites (issue #2213).\n    const idsAtCompare = historicalIdCache.get(journalStateDir);\n    const compareRef = readEntityRefFromFrontmatter(rec.content);\n    const canonicalContent =\n      classifyEntityRefWritePath(rootReal, targetAbs) === \"memory\"\n      && !(compareRef !== null && capsuleEntityIds.has(compareRef))\n        ? canonicalizeEntityRefFrontmatter(rec.content, idsAtCompare)\n        : rec.content;\n    const { sha256: localSha256 } = sha256String(localContent);\n    const canonicalSha256 =\n      canonicalContent === rec.content ? entry.sha256 : sha256String(canonicalContent).sha256;\n\n    // The identical verdict is only valid for the snapshot it was computed\n    // under (Codex P1): a mapping parked/removed mid-compare can make the\n    // local copy's formerly-canonical ref stale with nothing left to repair\n    // it. A moved journal falls through to the write path, which resolves at\n    // the write and repairs after it.\n    if (localSha256 === canonicalSha256 && historicalIdCache.get(journalStateDir) === idsAtCompare) {\n      skipped.push({ path: rec.path, reason: \"identical\" });\n      continue;\n    }\n    if (localSha256 === canonicalSha256 || localSha256 === entry.sha256) {\n      await writeCanonicalRecord(targetAbs, rec.content);\n      merged.push({ sourcePath: rec.path, targetPath: rec.path, snapshotted: false });\n      continue;\n    }\n\n    // Content differs → conflict.\n    const { sha256: archiveSha256 } = sha256String(rec.content);\n    conflicts.push({\n      path: rec.path,\n      archiveSha256,\n      localSha256,\n    });\n\n    if (conflictMode === \"skip-conflicts\" || conflictMode === \"prefer-local\") {\n      // Keep local copy, skip archive entry.\n      skipped.push({ path: rec.path, reason: \"conflict\" });\n      continue;\n    }\n\n    // conflictMode === \"prefer-source\": snapshot local then overwrite.\n    let snapshotted = false;\n    if (opts.versioning && opts.versioning.enabled) {\n      // Gotcha #54: snapshot BEFORE overwriting.\n      await createVersion(\n        targetAbs,\n        localContent,\n        \"manual\",\n        opts.versioning,\n        opts.log,\n        `capsule-merge: ${capsule.id}`,\n        rootReal,\n      );\n      snapshotted = true;\n    }\n\n    // Same write-time re-resolve + post-write repair as above — the\n    // snapshot/read awaits give a peer migration a real window.\n    await writeCanonicalRecord(targetAbs, rec.content);\n    merged.push({ sourcePath: rec.path, targetPath: rec.path, snapshotted });\n  }\n\n  // Every record — including every collision claimant entity page — is on\n  // disk; NOW the reconcile pass can settle collisions safely.\n  if (reconcileNeeded) {\n    await requestEntityCanonicalIdReconcile(journalStateDir);\n  }\n  };\n  const firstEntityId = capsuleEntityIds.values().next().value;\n  if (firstEntityId === undefined) {\n    await applyRecords();\n  } else {\n    await withRawEntityPageMutation(\n      rootReal,\n      path.join(rootReal, \"entities\", `${firstEntityId}.md`),\n      applyRecords,\n    );\n  }\n\n  // Sort output lists for determinism.\n  merged.sort((a, b) => a.sourcePath.localeCompare(b.sourcePath));\n  skipped.sort((a, b) => a.path.localeCompare(b.path));\n  conflicts.sort((a, b) => a.path.localeCompare(b.path));\n\n  // Per-write corpus bumps happen inside the loop above (Cursor Medium, #1902):\n  // a concurrent readAllMemories during the merge rescans and never serves the\n  // pre-merge corpus mid-batch.\n\n  return { merged, skipped, conflicts, manifest };\n}\n\n// ---------------------------------------------------------------------------\n// Private helpers\n// ---------------------------------------------------------------------------\n\nasync function readLocalFile(absPath: string): Promise<string | null> {\n  const st = await stat(absPath).catch(() => null);\n  if (!st || !st.isFile()) return null;\n  return readFile(absPath, \"utf-8\");\n}\n\n// Re-export CapsuleBlock so callers don't need a deep import from types.ts.\nexport type { CapsuleBlock };\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/transfer/capsule-merge.ts"],"sourcesContent":["import { lstat, mkdir, readFile, realpath, stat, unlink, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { gunzipSync } from \"node:zlib\";\nimport { bumpMemoryCorpusVersionForDir } from \"../memory-corpus-version.js\";\nimport {\n  HistoricalEntityCanonicalIdCache,\n  canonicalizeEntityRefFrontmatter,\n  readEntityRefFromFrontmatter,\n  classifyEntityRefWritePath,\n  repairContentAfterJournalMove,\n  requestEntityCanonicalIdReconcile,\n} from \"../storage/entity-canonical-id-references.js\";\nimport { withRawEntityPageMutation } from \"../storage/entity-canonical-id-lock.js\";\nimport {\n  createVersion,\n  type VersioningConfig,\n  type VersioningLogger,\n} from \"../page-versioning.js\";\nimport {\n  assertIsDirectoryNotSymlink,\n  assertRealpathInsideRoot,\n  fromPosixRelPath,\n  isPathInsideRoot,\n  sha256String,\n} from \"./fs-utils.js\";\nimport {\n  parseExportBundle,\n  type CapsuleBlock,\n  type ExportManifestV2,\n  type ExportMemoryRecordV1,\n} from \"./types.js\";\n\n/**\n * Three-way conflict-resolution mode for {@link mergeCapsule}.\n *\n * A \"conflict\" is defined as: the same memory-file path exists in both the\n * source archive and the target directory AND the content hash of the local\n * file differs from the archive's manifest entry for that path.\n *\n * Files that exist only in the archive (no local counterpart) are always\n * written regardless of mode — there is no conflict to resolve.\n *\n * Files that are byte-identical (same content hash in both locations) are\n * recorded as {@link MergeCapsuleResult.skipped} with reason `\"identical\"` and\n * are never re-written regardless of mode; this is a no-op optimisation rather\n * than a conflict.\n *\n *  - `\"skip-conflicts\"` (default) — log the conflict, skip the conflicting\n *    archive entries, but continue importing non-conflicting entries. The\n *    resulting merge is the union of:\n *      - all non-conflicting archive files (written to target)\n *      - all pre-existing local files (left unchanged)\n *\n *  - `\"prefer-source\"` — for conflicting files, snapshot the local content via\n *    page-versioning (gotcha #54: snapshot before overwrite) then overwrite\n *    with the archive content.\n *\n *  - `\"prefer-local\"` — for conflicting files, keep the local content; the\n *    archive entry is skipped.\n */\nexport type MergeCapsuleConflictMode =\n  | \"skip-conflicts\"\n  | \"prefer-source\"\n  | \"prefer-local\";\n\n/**\n * Options accepted by {@link mergeCapsule}.\n *\n * `sourceArchive` — absolute or cwd-relative path to a `.capsule.json.gz`\n * archive produced by `exportCapsule`. Must be a V2 bundle.\n *\n * `targetRoot` — absolute or cwd-relative path to the memory directory that\n * receives the merged records. Must be an existing, non-symlink directory.\n *\n * `conflictMode` — see {@link MergeCapsuleConflictMode}. Defaults to\n * `\"skip-conflicts\"`.\n *\n * `versioning` — optional page-versioning config forwarded to\n * {@link createVersion} in `\"prefer-source\"` mode. When omitted or disabled,\n * overwrites proceed without snapshotting (not recommended for production).\n *\n * `log` — optional logger forwarded to {@link createVersion}.\n */\nexport interface MergeCapsuleOptions {\n  sourceArchive: string;\n  targetRoot: string;\n  conflictMode?: MergeCapsuleConflictMode;\n  versioning?: VersioningConfig;\n  log?: VersioningLogger;\n}\n\nexport interface MergeCapsuleWrittenRecord {\n  /** Capsule-relative posix path. */\n  sourcePath: string;\n  /** Memory-dir-relative posix path written on disk. */\n  targetPath: string;\n  /** Whether a page-versioning snapshot was taken before overwriting. */\n  snapshotted: boolean;\n}\n\nexport interface MergeCapsuleSkippedRecord {\n  /** Capsule-relative posix path. */\n  path: string;\n  /**\n   * Why the archive entry was not written.\n   *\n   * `\"conflict\"` — the entry existed locally with different content and the\n   * active mode did not resolve the conflict with a write (`\"skip-conflicts\"` /\n   * `\"prefer-local\"`).\n   *\n   * `\"identical\"` — the entry's content hash matches what is already on disk;\n   * no write is needed.\n   */\n  reason: \"conflict\" | \"identical\";\n}\n\nexport interface MergeCapsuleConflictRecord {\n  /** Capsule-relative posix path of the conflicting entry. */\n  path: string;\n  /** SHA-256 of the archive's copy. */\n  archiveSha256: string;\n  /** SHA-256 of the local copy. */\n  localSha256: string;\n}\n\nexport interface MergeCapsuleResult {\n  /** Records that were written to the target directory. */\n  merged: MergeCapsuleWrittenRecord[];\n  /**\n   * Records that were NOT written (conflict skipped, or byte-identical).\n   * Includes conflicts that were resolved by `\"prefer-local\"`.\n   */\n  skipped: MergeCapsuleSkippedRecord[];\n  /**\n   * Metadata about every detected conflict, regardless of which mode resolved\n   * it. Callers can use this to report \"N conflicts encountered; M overwritten\".\n   */\n  conflicts: MergeCapsuleConflictRecord[];\n  /** The manifest decoded from the archive. */\n  manifest: ExportManifestV2;\n}\n\n// ---------------------------------------------------------------------------\n// Main entry point\n// ---------------------------------------------------------------------------\n\n/**\n * Merge a V2 capsule archive into an existing memory directory using\n * three-way conflict semantics.\n *\n * Sequence:\n *   1. Read + gunzip + JSON.parse the archive.\n *   2. Validate through `parseExportBundle` (V1 rejected).\n *   3. Verify every record's content sha256 against the manifest.\n *      Any mismatch aborts BEFORE any file is written (gotcha #25).\n *   4. Classify each record as: new (no local copy), identical (same hash),\n *      or conflicting (different hash).\n *   5. Apply the selected {@link MergeCapsuleConflictMode} to conflicting\n *      entries; always write new entries; always skip identical entries.\n *\n * Determinism: `merged`, `skipped`, and `conflicts` are all returned sorted\n * by `path`/`sourcePath` so callers get stable output regardless of bundle\n * order.\n */\nexport async function mergeCapsule(\n  opts: MergeCapsuleOptions,\n): Promise<MergeCapsuleResult> {\n  const archiveAbs = path.resolve(opts.sourceArchive);\n  const rootAbs = path.resolve(opts.targetRoot);\n\n  await assertIsDirectoryNotSymlink(rootAbs, \"mergeCapsule\", \"targetRoot\");\n\n  const conflictMode: MergeCapsuleConflictMode =\n    opts.conflictMode ?? \"skip-conflicts\";\n\n  // Rule 51: reject invalid conflictMode values up-front before any I/O.\n  if (\n    conflictMode !== \"skip-conflicts\" &&\n    conflictMode !== \"prefer-source\" &&\n    conflictMode !== \"prefer-local\"\n  ) {\n    throw new Error(\n      `mergeCapsule: unknown conflictMode ${JSON.stringify(conflictMode)}; ` +\n        `expected \"skip-conflicts\", \"prefer-source\", or \"prefer-local\"`,\n    );\n  }\n\n  // ---------------------------------------------------------------------------\n  // Parse + validate archive\n  // ---------------------------------------------------------------------------\n\n  const raw = await readFile(archiveAbs);\n  let json: string;\n  try {\n    json = gunzipSync(raw).toString(\"utf-8\");\n  } catch (cause) {\n    throw new Error(\n      `mergeCapsule: archive is not a valid gzip file: ${archiveAbs}`,\n      { cause: cause as Error },\n    );\n  }\n\n  let parsedJson: unknown;\n  try {\n    parsedJson = JSON.parse(json);\n  } catch (cause) {\n    throw new Error(\n      `mergeCapsule: archive is not valid JSON after gunzip: ${archiveAbs}`,\n      { cause: cause as Error },\n    );\n  }\n\n  const parsed = parseExportBundle(parsedJson);\n  if (parsed.capsuleVersion !== 2) {\n    throw new Error(\n      \"mergeCapsule: archive is V1; only V2 capsule archives are supported\",\n    );\n  }\n\n  const bundle = parsed.bundle as {\n    manifest: ExportManifestV2;\n    records: ExportMemoryRecordV1[];\n  };\n  const manifest = bundle.manifest;\n  const capsule = manifest.capsule;\n\n  // Build path → manifest entry index for O(1) checksum lookup.\n  const manifestIndex = new Map<string, ExportManifestV2[\"files\"][number]>();\n  for (const f of manifest.files) {\n    manifestIndex.set(f.path, f);\n  }\n  if (manifestIndex.size !== manifest.files.length) {\n    throw new Error(\"mergeCapsule: manifest contains duplicate file paths\");\n  }\n\n  const recordPaths = new Set<string>();\n  for (const rec of bundle.records) {\n    if (recordPaths.has(rec.path)) {\n      throw new Error(\n        `mergeCapsule: bundle contains duplicate record path: ${rec.path}`,\n      );\n    }\n    recordPaths.add(rec.path);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Phase 1: verify checksums + validate paths before ANY filesystem mutation.\n  // (gotcha #25: don't destroy old state before confirming new state succeeds)\n  // ---------------------------------------------------------------------------\n\n  const rootReal = await realpath(rootAbs).catch(() => rootAbs);\n\n  // Tracks normalized, case-folded target paths seen so far in phase 1.  Maps\n  // targetAbs.toLowerCase() → first source path so the collision error can name\n  // both offending entries.  Two manifest entries whose computed target paths\n  // normalise to the same absolute path (e.g. `subdir/file.md` and\n  // `subdir/./file.md`, or differing case on case-insensitive filesystems such\n  // as macOS and Windows) would both refer to the same inode.  In\n  // `skip-conflicts`/`prefer-local` modes one entry would be misclassified as a\n  // local conflict against the OTHER entry's just-written content; in\n  // `prefer-source` the second entry would silently overwrite the first.  We\n  // reject the import up-front before any write (Codex P2 thread on PR #748,\n  // mirroring `capsule-import.ts`).\n  const seenTargetPaths = new Map<string, string>();\n\n  for (const rec of bundle.records) {\n    // Checksum validation.\n    const entry = manifestIndex.get(rec.path);\n    if (!entry) {\n      throw new Error(\n        `mergeCapsule: archive checksum mismatch (record without manifest entry: ${rec.path})`,\n      );\n    }\n    const { sha256, bytes } = sha256String(rec.content);\n    if (sha256 !== entry.sha256 || bytes !== entry.bytes) {\n      throw new Error(\n        `mergeCapsule: archive checksum mismatch for ${rec.path}: ` +\n          `expected sha256=${entry.sha256} bytes=${entry.bytes}, ` +\n          `got sha256=${sha256} bytes=${bytes}`,\n      );\n    }\n\n    // Path-traversal validation (mirrors capsule-import.ts).\n    if (rec.path.includes(\"\\\\\")) {\n      throw new Error(\n        `mergeCapsule: record path contains backslash separators (Windows-style paths are not allowed): ${rec.path}`,\n      );\n    }\n    const posixNormalized = path.posix.normalize(rec.path);\n    if (\n      rec.path.startsWith(\"/\") ||\n      rec.path.split(\"/\").some((seg) => seg === \"..\") ||\n      posixNormalized.startsWith(\"..\") ||\n      posixNormalized.startsWith(\"/\")\n    ) {\n      throw new Error(\n        `mergeCapsule: record path escapes target root: ${rec.path}`,\n      );\n    }\n\n    // Lexical root containment check.\n    const targetAbs = path.join(rootReal, fromPosixRelPath(rec.path));\n    if (!isPathInsideRoot(rootReal, targetAbs)) {\n      throw new Error(\n        `mergeCapsule: record path escapes target root: ${rec.path}`,\n      );\n    }\n\n    // Symlink-aware containment check (shared helper from fs-utils).\n    await assertRealpathInsideRoot(rootReal, targetAbs, rec.path, \"mergeCapsule\");\n\n    // Target-file symlink guard: if the target already exists as a symlink,\n    // reject — writes through symlinks can redirect to unexpected locations.\n    const targetLstat = await lstat(targetAbs).catch(() => null);\n    if (targetLstat !== null && targetLstat.isSymbolicLink()) {\n      throw new Error(\n        `mergeCapsule: record target is a symlink and cannot be written to safely: ${rec.path}`,\n      );\n    }\n\n    // Duplicate normalized target path detection (Codex P2 #748, mirrors\n    // capsule-import.ts).  `path.join` already normalises `.` segments\n    // (e.g. `subdir/./file.md` → `subdir/file.md`).  On case-insensitive\n    // filesystems (macOS default, Windows), two paths that differ only in case\n    // would resolve to the same inode.  We fold the dedup key to lowercase so\n    // that `subdir/File.md` and `subdir/file.md` are detected as duplicates\n    // before any write occurs.  This is intentionally unconditional: the cost\n    // of an extra `.toLowerCase()` on case-sensitive filesystems is negligible,\n    // and a defensive lowercase is far simpler than probing filesystem\n    // case-sensitivity at runtime.  Without this guard, prefer-source mode\n    // would silently overwrite one entry with the other, and skip-conflicts /\n    // prefer-local would misclassify the second entry as a local conflict\n    // against the first entry's freshly written content.\n    const dedupKey = targetAbs.toLowerCase();\n    const firstSourcePath = seenTargetPaths.get(dedupKey);\n    if (firstSourcePath !== undefined) {\n      throw new Error(\n        `mergeCapsule: manifest contains two entries that resolve to the same target path: ` +\n          `\"${firstSourcePath}\" and \"${rec.path}\" both map to \"${rec.path}\"`,\n      );\n    }\n    seenTargetPaths.set(dedupKey, rec.path);\n  }\n\n  // Detect manifest-only entries (missing record). Treat as corruption.\n  for (const f of manifest.files) {\n    if (!recordPaths.has(f.path)) {\n      throw new Error(\n        `mergeCapsule: archive checksum mismatch (manifest entry without record: ${f.path})`,\n      );\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Phase 2: classify records and apply conflict mode.\n  // ---------------------------------------------------------------------------\n\n  const merged: MergeCapsuleWrittenRecord[] = [];\n  const skipped: MergeCapsuleSkippedRecord[] = [];\n  const conflicts: MergeCapsuleConflictRecord[] = [];\n  // Same write-boundary rule as capsule-import (issue #2213): records land\n  // with their entityRef resolved through the target's migration journal,\n  // read through the identity-keyed cache PER RECORD so a peer migration\n  // completing mid-merge is picked up for every record written after it.\n  const journalStateDir = path.join(rootReal, \"state\");\n  const historicalIdCache = new HistoricalEntityCanonicalIdCache();\n  // Entity pages in THIS capsule can re-establish collisions the target's\n  // journal already resolved (Codex P1): once the next migration parks the\n  // mapping, a memory canonicalized onto the canonical claimant is\n  // permanently misattributed. Memories whose ref targets a capsule-supplied\n  // entity id merge byte-faithful behind the reconcile marker instead.\n  const capsuleEntityIds = new Set(\n    bundle.records\n      .filter((record) =>\n        classifyEntityRefWritePath(rootReal, path.join(rootReal, fromPosixRelPath(record.path))) === \"entity\")\n      .map((record) => path.basename(record.path, \".md\")),\n  );\n  // Write a record with its entityRef resolved AT the write, then repair if\n  // the journal moved across the write itself — a parked mapping cannot be\n  // fixed after the fact by the reconcile pass (issue #2213). Only memory-tier\n  // records canonicalize; entities/ pages carry relationship TARGETS only\n  // rewriteRelationshipTargets understands, so they merge byte-faithful with\n  // a reconcile marker; everything else merges losslessly. The corpus bump\n  // lands AFTER the repair so a warm cache rescan never captures pre-repair\n  // bytes.\n  // The reconcile marker is published ONCE, after every record landed\n  // (Codex P1, round 21): a per-record marker could be consumed by a peer\n  // between a legacy-preserving memory write and its colliding entity page,\n  // canonicalizing the memory onto the wrong claimant irreversibly.\n  let reconcileNeeded = false;\n  const writeCanonicalRecord = async (targetAbs: string, rawContent: string): Promise<void> => {\n    const kind = classifyEntityRefWritePath(rootReal, targetAbs);\n    const rawRef = kind === \"memory\" ? readEntityRefFromFrontmatter(rawContent) : null;\n    if (kind === \"memory\" && rawRef !== null && capsuleEntityIds.has(rawRef)) {\n      // Ref targets a capsule-supplied entity page (potential collision\n      // claimant): keep the legacy bytes; the deferred marker lets the\n      // migration settle the collision and rewrite per its verdict (Codex P1).\n      await writeFile(targetAbs, rawContent, \"utf-8\");\n      reconcileNeeded = true;\n      bumpMemoryCorpusVersionForDir(rootReal); // per-write bump (Cursor Medium, #1902)\n      return;\n    }\n    if (kind !== \"memory\") {\n      await writeFile(targetAbs, rawContent, \"utf-8\");\n      if (kind === \"entity\") {\n        reconcileNeeded = true;\n      }\n      bumpMemoryCorpusVersionForDir(rootReal); // per-write bump (Cursor Medium, #1902)\n      return;\n    }\n    const idsAtWrite = historicalIdCache.get(journalStateDir);\n    const written = canonicalizeEntityRefFrontmatter(rawContent, idsAtWrite);\n    // Snapshot the pre-write bytes: a repair failure after the write must\n    // restore them (or remove a newly created target) before propagating —\n    // the merge reports failure, so disk must return to its pre-write state\n    // and warm caches stay consistent (AGENTS.md §14).\n    const originalBytes = await readLocalFile(targetAbs);\n    await writeFile(targetAbs, written, \"utf-8\");\n    try {\n      await repairContentAfterJournalMove({\n        stateDir: journalStateDir,\n        cache: historicalIdCache,\n        idsAtWrite,\n        rawContent,\n        lastWritten: written,\n        rewrite: (content) => writeFile(targetAbs, content, \"utf-8\"),\n      });\n    } catch (err) {\n      if (originalBytes === null) {\n        await unlink(targetAbs).catch(() => undefined);\n      } else {\n        await writeFile(targetAbs, originalBytes, \"utf-8\").catch(() => undefined);\n      }\n      throw err;\n    }\n    bumpMemoryCorpusVersionForDir(rootReal); // per-write bump (Cursor Medium, #1902)\n  };\n\n  // Sort by source path for deterministic output (mirrors capsule-import.ts).\n  const sortedRecords = [...bundle.records].sort((a, b) =>\n    a.path.localeCompare(b.path),\n  );\n\n  const applyRecords = async (): Promise<void> => {\n  for (const rec of sortedRecords) {\n    const targetAbs = path.join(rootReal, fromPosixRelPath(rec.path));\n    const entry = manifestIndex.get(rec.path)!; // validated above\n\n    const localContent = await readLocalFile(targetAbs);\n\n    if (localContent === null) {\n      // No local copy — always write regardless of mode. Resolve at the write\n      // itself and verify the journal afterwards: a peer migration completing\n      // during any of these awaits (or the write) would otherwise strand the\n      // reference — capsule writes bump only the corpus version, which the\n      // migration fingerprint deliberately ignores.\n      await mkdir(path.dirname(targetAbs), { recursive: true });\n      await writeCanonicalRecord(targetAbs, rec.content);\n      merged.push({ sourcePath: rec.path, targetPath: rec.path, snapshotted: false });\n      continue;\n    }\n\n    // Local file exists. A local copy already holding the CANONICALIZED form\n    // (computed AFTER the local read, so a journal published during that\n    // await is reflected) is done. A local copy matching the RAW archive\n    // bytes while a mapping applies is UPGRADED in place — skipping would\n    // leave the legacy entityRef on disk forever, since corpus bumps no\n    // longer trigger migration rewrites (issue #2213).\n    const idsAtCompare = historicalIdCache.get(journalStateDir);\n    const compareRef = readEntityRefFromFrontmatter(rec.content);\n    const canonicalContent =\n      classifyEntityRefWritePath(rootReal, targetAbs) === \"memory\"\n      && !(compareRef !== null && capsuleEntityIds.has(compareRef))\n        ? canonicalizeEntityRefFrontmatter(rec.content, idsAtCompare)\n        : rec.content;\n    const { sha256: localSha256 } = sha256String(localContent);\n    const canonicalSha256 =\n      canonicalContent === rec.content ? entry.sha256 : sha256String(canonicalContent).sha256;\n\n    // The identical verdict is only valid for the snapshot it was computed\n    // under (Codex P1): a mapping parked/removed mid-compare can make the\n    // local copy's formerly-canonical ref stale with nothing left to repair\n    // it. A moved journal falls through to the write path, which resolves at\n    // the write and repairs after it.\n    if (localSha256 === canonicalSha256 && historicalIdCache.get(journalStateDir) === idsAtCompare) {\n      skipped.push({ path: rec.path, reason: \"identical\" });\n      continue;\n    }\n    if (localSha256 === canonicalSha256 || localSha256 === entry.sha256) {\n      await writeCanonicalRecord(targetAbs, rec.content);\n      merged.push({ sourcePath: rec.path, targetPath: rec.path, snapshotted: false });\n      continue;\n    }\n\n    // Content differs → conflict.\n    const { sha256: archiveSha256 } = sha256String(rec.content);\n    conflicts.push({\n      path: rec.path,\n      archiveSha256,\n      localSha256,\n    });\n\n    if (conflictMode === \"skip-conflicts\" || conflictMode === \"prefer-local\") {\n      // Keep local copy, skip archive entry.\n      skipped.push({ path: rec.path, reason: \"conflict\" });\n      continue;\n    }\n\n    // conflictMode === \"prefer-source\": snapshot local then overwrite.\n    let snapshotted = false;\n    if (opts.versioning && opts.versioning.enabled) {\n      // Gotcha #54: snapshot BEFORE overwriting.\n      await createVersion(\n        targetAbs,\n        localContent,\n        \"manual\",\n        opts.versioning,\n        opts.log,\n        `capsule-merge: ${capsule.id}`,\n        rootReal,\n      );\n      snapshotted = true;\n    }\n\n    // Same write-time re-resolve + post-write repair as above — the\n    // snapshot/read awaits give a peer migration a real window.\n    await writeCanonicalRecord(targetAbs, rec.content);\n    merged.push({ sourcePath: rec.path, targetPath: rec.path, snapshotted });\n  }\n\n  // Every record — including every collision claimant entity page — is on\n  // disk; NOW the reconcile pass can settle collisions safely.\n  if (reconcileNeeded) {\n    await requestEntityCanonicalIdReconcile(journalStateDir);\n  }\n  };\n  const firstEntityId = capsuleEntityIds.values().next().value;\n  if (firstEntityId === undefined) {\n    await applyRecords();\n  } else {\n    await withRawEntityPageMutation(\n      rootReal,\n      path.join(rootReal, \"entities\", `${firstEntityId}.md`),\n      applyRecords,\n    );\n  }\n\n  // Sort output lists for determinism.\n  merged.sort((a, b) => a.sourcePath.localeCompare(b.sourcePath));\n  skipped.sort((a, b) => a.path.localeCompare(b.path));\n  conflicts.sort((a, b) => a.path.localeCompare(b.path));\n\n  // Per-write corpus bumps happen inside the loop above (Cursor Medium, #1902):\n  // a concurrent readAllMemories during the merge rescans and never serves the\n  // pre-merge corpus mid-batch.\n\n  return { merged, skipped, conflicts, manifest };\n}\n\n// ---------------------------------------------------------------------------\n// Private helpers\n// ---------------------------------------------------------------------------\n\nasync function readLocalFile(absPath: string): Promise<string | null> {\n  const st = await stat(absPath).catch(() => null);\n  if (!st || !st.isFile()) return null;\n  return readFile(absPath, \"utf-8\");\n}\n\n// Re-export CapsuleBlock so callers don't need a deep import from types.ts.\nexport type { CapsuleBlock };\n"],"mappings":"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","names":[]}

package/dist/causal-behavior.js

@@ -1,11 +1,11 @@
 import {
   readChainIndex,
   resolveChainsDir
-} from "./chunk-IFCKHPY4.js";
+} from "./chunk-YDH2FSDI.js";
 import "./chunk-B7RWBZXW.js";
 import {
   resolveCausalTrajectoryStoreDir
-} from "./chunk-VZBW6CDG.js";
+} from "./chunk-BOOFTFFE.js";
 import {
   normalizeRecallTokens
 } from "./chunk-YCVB7X56.js";

package/dist/causal-chain.js

@@ -6,9 +6,9 @@ import {
   stitchCausalChain,
   validateCausalEdge,
   writeChainIndex
-} from "./chunk-IFCKHPY4.js";
+} from "./chunk-YDH2FSDI.js";
 import "./chunk-B7RWBZXW.js";
-import "./chunk-VZBW6CDG.js";
+import "./chunk-BOOFTFFE.js";
 import "./chunk-YCVB7X56.js";
 import "./chunk-A2IYSXDQ.js";
 import "./chunk-B6O2YLUR.js";