@mnemoai/core 1.1.0 → 1.1.2

package/dist/src/smart-extractor.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/smart-extractor.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: MIT\n/**\n * Smart Memory Extractor \u2014 LLM-powered extraction pipeline\n * Replaces regex-triggered capture with intelligent 6-category extraction.\n *\n * Pipeline: conversation \u2192 LLM extract \u2192 candidates \u2192 dedup \u2192 persist\n *\n */\n\nimport type { MemoryStore, MemorySearchResult } from \"./store.js\";\nimport type { Embedder } from \"./embedder.js\";\nimport type { LlmClient } from \"./llm-client.js\";\nimport {\n  buildExtractionPrompt,\n  buildChineseExtractionPrompt,\n  buildDedupPrompt,\n  buildMergePrompt,\n} from \"./extraction-prompts.js\";\nimport {\n  type CandidateMemory,\n  type DedupDecision,\n  type DedupResult,\n  type ExtractionStats,\n  type MemoryCategory,\n  ALWAYS_MERGE_CATEGORIES,\n  MERGE_SUPPORTED_CATEGORIES,\n  MEMORY_CATEGORIES,\n  normalizeCategory,\n} from \"./memory-categories.js\";\nimport { isNoise } from \"./noise-filter.js\";\nimport type { NoisePrototypeBank } from \"./noise-prototypes.js\";\nimport { buildSmartMetadata, parseSmartMetadata, stringifySmartMetadata, parseSupportInfo, updateSupportStats } from \"./smart-metadata.js\";\nimport { log as _log } from \"./logger.js\";\n\n// ============================================================================\n// Constants\n// ============================================================================\n\nconst SIMILARITY_THRESHOLD = 0.7;\nconst MAX_SIMILAR_FOR_PROMPT = 3;\nconst MAX_MEMORIES_PER_EXTRACTION = 5;\nconst VALID_DECISIONS = new Set<string>([\"create\", \"merge\", \"skip\", \"support\", \"contextualize\", \"contradict\"]);\n\n// ============================================================================\n// CJK Detection\n// ============================================================================\n\n/**\n * Detect whether a text is predominantly CJK (Chinese/Japanese/Korean).\n * Returns true if CJK characters make up > 30% of non-whitespace characters.\n */\nfunction isCjkDominant(text: string): boolean {\n  // CJK Unified Ideographs + CJK Extension A/B + CJK Compatibility + Kana + Hangul\n  const cjkRegex = /[\\u4e00-\\u9fff\\u3400-\\u4dbf\\u3040-\\u309f\\u30a0-\\u30ff\\uac00-\\ud7af\\uf900-\\ufaff]/g;\n  const nonWhitespace = text.replace(/\\s/g, \"\");\n  if (nonWhitespace.length === 0) return false;\n  const cjkMatches = nonWhitespace.match(cjkRegex);\n  const cjkCount = cjkMatches ? cjkMatches.length : 0;\n  return cjkCount / nonWhitespace.length > 0.3;\n}\n\n// ============================================================================\n// Smart Extractor\n// ============================================================================\n\nexport interface SmartExtractorConfig {\n  /** User identifier for extraction prompt. */\n  user?: string;\n  /** Minimum conversation messages before extraction triggers. */\n  extractMinMessages?: number;\n  /** Maximum characters of conversation text to process. */\n  extractMaxChars?: number;\n  /** Default scope for new memories. */\n  defaultScope?: string;\n  /** Logger function. */\n  log?: (msg: string) => void;\n  /** Debug logger function. */\n  debugLog?: (msg: string) => void;\n  /** Optional embedding-based noise prototype bank for language-agnostic noise filtering. */\n  noiseBank?: NoisePrototypeBank;\n}\n\nexport interface ExtractPersistOptions {\n  /** Target scope for newly created memories. */\n  scope?: string;\n  /** Scopes visible to the current agent for dedup/merge. */\n  scopeFilter?: string[];\n}\n\nexport class SmartExtractor {\n  private log: (msg: string) => void;\n  private debugLog: (msg: string) => void;\n\n  constructor(\n    private store: MemoryStore,\n    private embedder: Embedder,\n    private llm: LlmClient,\n    private config: SmartExtractorConfig = {},\n  ) {\n    this.log = config.log ?? ((msg: string) => _log.info(msg));\n    this.debugLog = config.debugLog ?? (() => { });\n  }\n\n  // --------------------------------------------------------------------------\n  // Main entry point\n  // --------------------------------------------------------------------------\n\n  /**\n   * Extract memories from a conversation text and persist them.\n   * Returns extraction statistics.\n   */\n  async extractAndPersist(\n    conversationText: string,\n    sessionKey: string = \"unknown\",\n    options: ExtractPersistOptions = {},\n  ): Promise<ExtractionStats> {\n    const stats: ExtractionStats = { created: 0, merged: 0, skipped: 0 };\n    const targetScope = options.scope ?? this.config.defaultScope ?? \"global\";\n    const scopeFilter =\n      options.scopeFilter && options.scopeFilter.length > 0\n        ? options.scopeFilter\n        : [targetScope];\n\n    // Step 1: LLM extraction\n    const candidates = await this.extractCandidates(conversationText);\n\n    if (candidates.length === 0) {\n      this.log(\"memory-pro: smart-extractor: no memories extracted\");\n      // LLM returned zero candidates \u2192 strongest noise signal \u2192 feedback to noise bank\n      this.learnAsNoise(conversationText);\n      return stats;\n    }\n\n    this.log(\n      `memory-pro: smart-extractor: extracted ${candidates.length} candidate(s)`,\n    );\n\n    // Step 2: Process each candidate through dedup pipeline\n    for (const candidate of candidates.slice(0, MAX_MEMORIES_PER_EXTRACTION)) {\n      try {\n        await this.processCandidate(\n          candidate,\n          sessionKey,\n          stats,\n          targetScope,\n          scopeFilter,\n        );\n      } catch (err) {\n        this.log(\n          `memory-pro: smart-extractor: failed to process candidate [${candidate.category}]: ${String(err)}`,\n        );\n      }\n    }\n\n    return stats;\n  }\n\n  // --------------------------------------------------------------------------\n  // Embedding Noise Pre-Filter\n  // --------------------------------------------------------------------------\n\n  /**\n   * Filter out texts that match noise prototypes by embedding similarity.\n   * Long texts (>300 chars) are passed through without checking.\n   * Only active when noiseBank is configured and initialized.\n   */\n  async filterNoiseByEmbedding(texts: string[]): Promise<string[]> {\n    const noiseBank = this.config.noiseBank;\n    if (!noiseBank || !noiseBank.initialized) return texts;\n\n    const result: string[] = [];\n    for (const text of texts) {\n      // Very short texts lack semantic signal \u2014 skip noise check to avoid false positives\n      if (text.length <= 8) {\n        result.push(text);\n        continue;\n      }\n      // Long texts are unlikely to be pure noise queries\n      if (text.length > 300) {\n        result.push(text);\n        continue;\n      }\n      try {\n        const vec = await this.embedder.embed(text);\n        if (!vec || vec.length === 0 || !noiseBank.isNoise(vec)) {\n          result.push(text);\n        } else {\n          this.debugLog(\n            `mnemo: smart-extractor: embedding noise filtered: ${text.slice(0, 80)}`,\n          );\n        }\n      } catch {\n        // Embedding failed \u2014 pass text through\n        result.push(text);\n      }\n    }\n    return result;\n  }\n\n  /**\n   * Feed back conversation text to the noise prototype bank.\n   * Called when LLM extraction returns zero candidates (strongest noise signal).\n   */\n  private async learnAsNoise(conversationText: string): Promise<void> {\n    const noiseBank = this.config.noiseBank;\n    if (!noiseBank || !noiseBank.initialized) return;\n\n    try {\n      const tail = conversationText.slice(-300);\n      const vec = await this.embedder.embed(tail);\n      if (vec && vec.length > 0) {\n        noiseBank.learn(vec);\n        this.debugLog(\"mnemo: smart-extractor: learned noise from zero-extraction\");\n      }\n    } catch {\n      // Non-critical \u2014 silently skip\n    }\n  }\n\n  // --------------------------------------------------------------------------\n  // Step 1: LLM Extraction\n  // --------------------------------------------------------------------------\n\n  /**\n   * Call LLM to extract candidate memories from conversation text.\n   */\n  private async extractCandidates(\n    conversationText: string,\n  ): Promise<CandidateMemory[]> {\n    const maxChars = this.config.extractMaxChars ?? 8000;\n    const truncated =\n      conversationText.length > maxChars\n        ? conversationText.slice(-maxChars)\n        : conversationText;\n\n    const user = this.config.user ?? \"User\";\n    const prompt = isCjkDominant(truncated)\n      ? buildChineseExtractionPrompt(truncated, user)\n      : buildExtractionPrompt(truncated, user);\n\n    const result = await this.llm.completeJson<{\n      memories: Array<{\n        category: string;\n        abstract: string;\n        overview: string;\n        content: string;\n      }>;\n    }>(prompt, \"extract-candidates\");\n\n    if (!result) {\n      this.debugLog(\n        \"mnemo: smart-extractor: extract-candidates returned null\",\n      );\n      return [];\n    }\n    if (!result.memories || !Array.isArray(result.memories)) {\n      this.debugLog(\n        `mnemo: smart-extractor: extract-candidates returned unexpected shape keys=${Object.keys(result).join(\",\") || \"(none)\"}`,\n      );\n      return [];\n    }\n\n    this.debugLog(\n      `mnemo: smart-extractor: extract-candidates raw memories=${result.memories.length}`,\n    );\n\n    // Validate and normalize candidates\n    const candidates: CandidateMemory[] = [];\n    let invalidCategoryCount = 0;\n    let shortAbstractCount = 0;\n    let noiseAbstractCount = 0;\n    for (const raw of result.memories) {\n      const category = normalizeCategory(raw.category ?? \"\");\n      if (!category) {\n        invalidCategoryCount++;\n        this.debugLog(\n          `mnemo: smart-extractor: dropping candidate due to invalid category rawCategory=${JSON.stringify(raw.category ?? \"\")} abstract=${JSON.stringify((raw.abstract ?? \"\").trim().slice(0, 120))}`,\n        );\n        continue;\n      }\n\n      const abstract = (raw.abstract ?? \"\").trim();\n      const overview = (raw.overview ?? \"\").trim();\n      const content = (raw.content ?? \"\").trim();\n\n      // Skip empty or noise\n      if (!abstract || abstract.length < 5) {\n        shortAbstractCount++;\n        this.debugLog(\n          `mnemo: smart-extractor: dropping candidate due to short abstract category=${category} abstract=${JSON.stringify(abstract)}`,\n        );\n        continue;\n      }\n      if (isNoise(abstract)) {\n        noiseAbstractCount++;\n        this.debugLog(\n          `mnemo: smart-extractor: dropping candidate due to noise abstract category=${category} abstract=${JSON.stringify(abstract.slice(0, 120))}`,\n        );\n        continue;\n      }\n\n      candidates.push({ category, abstract, overview, content });\n    }\n\n    this.debugLog(\n      `mnemo: smart-extractor: validation summary accepted=${candidates.length}, invalidCategory=${invalidCategoryCount}, shortAbstract=${shortAbstractCount}, noiseAbstract=${noiseAbstractCount}`,\n    );\n\n    return candidates;\n  }\n\n  // --------------------------------------------------------------------------\n  // Step 2: Dedup + Persist\n  // --------------------------------------------------------------------------\n\n  /**\n   * Process a single candidate memory: dedup \u2192 merge/create \u2192 store\n   */\n  private async processCandidate(\n    candidate: CandidateMemory,\n    sessionKey: string,\n    stats: ExtractionStats,\n    targetScope: string,\n    scopeFilter: string[],\n  ): Promise<void> {\n    // Profile always merges (skip dedup)\n    if (ALWAYS_MERGE_CATEGORIES.has(candidate.category)) {\n      await this.handleProfileMerge(\n        candidate,\n        sessionKey,\n        targetScope,\n        scopeFilter,\n      );\n      stats.merged++;\n      return;\n    }\n\n    // Embed the candidate for vector dedup\n    const embeddingText = `${candidate.abstract} ${candidate.content}`;\n    const vector = await this.embedder.embed(embeddingText);\n    if (!vector || vector.length === 0) {\n      this.log(\"memory-pro: smart-extractor: embedding failed, storing as-is\");\n      await this.storeCandidate(candidate, vector || [], sessionKey, targetScope);\n      stats.created++;\n      return;\n    }\n\n    // Dedup pipeline\n    const dedupResult = await this.deduplicate(candidate, vector, scopeFilter);\n\n    switch (dedupResult.decision) {\n      case \"create\":\n        await this.storeCandidate(candidate, vector, sessionKey, targetScope);\n        stats.created++;\n        break;\n\n      case \"merge\":\n        if (\n          dedupResult.matchId &&\n          MERGE_SUPPORTED_CATEGORIES.has(candidate.category)\n        ) {\n          await this.handleMerge(\n            candidate,\n            dedupResult.matchId,\n            scopeFilter,\n            targetScope,\n            dedupResult.contextLabel,\n          );\n          stats.merged++;\n        } else {\n          // Category doesn't support merge \u2192 create instead\n          await this.storeCandidate(candidate, vector, sessionKey, targetScope);\n          stats.created++;\n        }\n        break;\n\n      case \"skip\":\n        this.log(\n          `memory-pro: smart-extractor: skipped [${candidate.category}] ${candidate.abstract.slice(0, 60)}`,\n        );\n        stats.skipped++;\n        break;\n\n      case \"support\":\n        if (dedupResult.matchId) {\n          await this.handleSupport(dedupResult.matchId, scopeFilter, { session: sessionKey, timestamp: Date.now() }, dedupResult.reason, dedupResult.contextLabel);\n          stats.supported = (stats.supported ?? 0) + 1;\n        } else {\n          await this.storeCandidate(candidate, vector, sessionKey, targetScope);\n          stats.created++;\n        }\n        break;\n\n      case \"contextualize\":\n        if (dedupResult.matchId) {\n          await this.handleContextualize(candidate, vector, dedupResult.matchId, sessionKey, targetScope, scopeFilter, dedupResult.contextLabel);\n          stats.created++;\n        } else {\n          await this.storeCandidate(candidate, vector, sessionKey, targetScope);\n          stats.created++;\n        }\n        break;\n\n      case \"contradict\":\n        if (dedupResult.matchId) {\n          await this.handleContradict(candidate, vector, dedupResult.matchId, sessionKey, targetScope, scopeFilter, dedupResult.contextLabel);\n          stats.created++;\n        } else {\n          await this.storeCandidate(candidate, vector, sessionKey, targetScope);\n          stats.created++;\n        }\n        break;\n    }\n  }\n\n  // --------------------------------------------------------------------------\n  // Dedup Pipeline (vector pre-filter + LLM decision)\n  // --------------------------------------------------------------------------\n\n  /**\n   * Two-stage dedup: vector similarity search \u2192 LLM decision.\n   */\n  private async deduplicate(\n    candidate: CandidateMemory,\n    candidateVector: number[],\n    scopeFilter: string[],\n  ): Promise<DedupResult> {\n    // Stage 1: Vector pre-filter \u2014 find similar memories\n    const similar = await this.store.vectorSearch(\n      candidateVector,\n      5,\n      SIMILARITY_THRESHOLD,\n      scopeFilter,\n    );\n\n    if (similar.length === 0) {\n      return { decision: \"create\", reason: \"No similar memories found\" };\n    }\n\n    // Stage 2: LLM decision\n    return this.llmDedupDecision(candidate, similar);\n  }\n\n  private async llmDedupDecision(\n    candidate: CandidateMemory,\n    similar: MemorySearchResult[],\n  ): Promise<DedupResult> {\n    const topSimilar = similar.slice(0, MAX_SIMILAR_FOR_PROMPT);\n    const existingFormatted = topSimilar\n      .map((r, i) => {\n        // Extract L0 abstract from metadata if available, fallback to text\n        let metaObj: Record<string, unknown> = {};\n        try {\n          metaObj = JSON.parse(r.entry.metadata || \"{}\");\n        } catch { }\n        const abstract = (metaObj.l0_abstract as string) || r.entry.text;\n        const overview = (metaObj.l1_overview as string) || \"\";\n        return `${i + 1}. [${(metaObj.memory_category as string) || r.entry.category}] ${abstract}\\n   Overview: ${overview}\\n   Score: ${r.score.toFixed(3)}`;\n      })\n      .join(\"\\n\");\n\n    const prompt = buildDedupPrompt(\n      candidate.abstract,\n      candidate.overview,\n      candidate.content,\n      existingFormatted,\n    );\n\n    try {\n      const data = await this.llm.completeJson<{\n        decision: string;\n        reason: string;\n        match_index?: number;\n        context_label?: string;\n      }>(prompt, \"dedup-decision\");\n\n      if (!data) {\n        this.log(\n          \"memory-pro: smart-extractor: dedup LLM returned unparseable response, defaulting to CREATE\",\n        );\n        return { decision: \"create\", reason: \"LLM response unparseable\" };\n      }\n\n      const decision = (data.decision?.toLowerCase() ??\n        \"create\") as DedupDecision;\n      if (!VALID_DECISIONS.has(decision)) {\n        return {\n          decision: \"create\",\n          reason: `Unknown decision: ${data.decision}`,\n        };\n      }\n\n      // Resolve merge target from LLM's match_index (1-based)\n      const idx = data.match_index;\n      const matchEntry =\n        typeof idx === \"number\" && idx >= 1 && idx <= topSimilar.length\n          ? topSimilar[idx - 1]\n          : topSimilar[0];\n\n      return {\n        decision,\n        reason: data.reason ?? \"\",\n        matchId: [\"merge\", \"support\", \"contextualize\", \"contradict\"].includes(decision) ? matchEntry?.entry.id : undefined,\n        contextLabel: typeof data.context_label === \"string\" ? data.context_label : undefined,\n      };\n    } catch (err) {\n      this.log(\n        `memory-pro: smart-extractor: dedup LLM failed: ${String(err)}`,\n      );\n      return { decision: \"create\", reason: `LLM failed: ${String(err)}` };\n    }\n  }\n\n  // --------------------------------------------------------------------------\n  // Merge Logic\n  // --------------------------------------------------------------------------\n\n  /**\n   * Profile always-merge: read existing profile, merge with LLM, upsert.\n   */\n  private async handleProfileMerge(\n    candidate: CandidateMemory,\n    sessionKey: string,\n    targetScope: string,\n    scopeFilter: string[],\n  ): Promise<void> {\n    // Find existing profile memory by category\n    const embeddingText = `${candidate.abstract} ${candidate.content}`;\n    const vector = await this.embedder.embed(embeddingText);\n\n    // Search for existing profile memories\n    const existing = await this.store.vectorSearch(\n      vector || [],\n      1,\n      0.3,\n      scopeFilter,\n    );\n    const profileMatch = existing.find((r) => {\n      try {\n        const meta = JSON.parse(r.entry.metadata || \"{}\");\n        return meta.memory_category === \"profile\";\n      } catch {\n        return false;\n      }\n    });\n\n    if (profileMatch) {\n      await this.handleMerge(\n        candidate,\n        profileMatch.entry.id,\n        scopeFilter,\n        targetScope,\n      );\n    } else {\n      // No existing profile \u2014 create new\n      await this.storeCandidate(candidate, vector || [], sessionKey, targetScope);\n    }\n  }\n\n  /**\n   * Merge a candidate into an existing memory using LLM.\n   */\n  private async handleMerge(\n    candidate: CandidateMemory,\n    matchId: string,\n    scopeFilter: string[],\n    targetScope: string,\n    contextLabel?: string,\n  ): Promise<void> {\n    let existingAbstract = \"\";\n    let existingOverview = \"\";\n    let existingContent = \"\";\n\n    try {\n      const existing = await this.store.getById(matchId, scopeFilter);\n      if (existing) {\n        const meta = parseSmartMetadata(existing.metadata, existing);\n        existingAbstract = meta.l0_abstract || existing.text;\n        existingOverview = meta.l1_overview || \"\";\n        existingContent = meta.l2_content || existing.text;\n      }\n    } catch {\n      // Fallback: store as new\n      this.log(\n        `memory-pro: smart-extractor: could not read existing memory ${matchId}, storing as new`,\n      );\n      const vector = await this.embedder.embed(\n        `${candidate.abstract} ${candidate.content}`,\n      );\n      await this.storeCandidate(\n        candidate,\n        vector || [],\n        \"merge-fallback\",\n        targetScope,\n      );\n      return;\n    }\n\n    // Call LLM to merge\n    const prompt = buildMergePrompt(\n      existingAbstract,\n      existingOverview,\n      existingContent,\n      candidate.abstract,\n      candidate.overview,\n      candidate.content,\n      candidate.category,\n    );\n\n    const merged = await this.llm.completeJson<{\n      abstract: string;\n      overview: string;\n      content: string;\n    }>(prompt, \"merge-memory\");\n\n    if (!merged) {\n      this.log(\"memory-pro: smart-extractor: merge LLM failed, skipping merge\");\n      return;\n    }\n\n    // Re-embed the merged content\n    const mergedText = `${merged.abstract} ${merged.content}`;\n    const newVector = await this.embedder.embed(mergedText);\n\n    // Update existing memory via store.update()\n    const existing = await this.store.getById(matchId, scopeFilter);\n    const metadata = stringifySmartMetadata(\n      buildSmartMetadata(existing ?? { text: merged.abstract }, {\n        l0_abstract: merged.abstract,\n        l1_overview: merged.overview,\n        l2_content: merged.content,\n        memory_category: candidate.category,\n        tier: \"working\",\n        confidence: 0.8,\n      }),\n    );\n\n    await this.store.update(\n      matchId,\n      {\n        text: merged.abstract,\n        vector: newVector,\n        metadata,\n      },\n      scopeFilter,\n    );\n\n    // Update support stats on the merged memory\n    try {\n      const updatedEntry = await this.store.getById(matchId, scopeFilter);\n      if (updatedEntry) {\n        const meta = parseSmartMetadata(updatedEntry.metadata, updatedEntry);\n        const supportInfo = parseSupportInfo(meta.support_info);\n        const updated = updateSupportStats(supportInfo, contextLabel, \"support\");\n        const finalMetadata = stringifySmartMetadata({ ...meta, support_info: updated });\n        await this.store.update(matchId, { metadata: finalMetadata }, scopeFilter);\n      }\n    } catch {\n      // Non-critical: merge succeeded, support stats update is best-effort\n    }\n\n    this.log(\n      `memory-pro: smart-extractor: merged [${candidate.category}]${contextLabel ? ` [${contextLabel}]` : \"\"} into ${matchId.slice(0, 8)}`,\n    );\n  }\n\n  // --------------------------------------------------------------------------\n  // Context-Aware Handlers (support / contextualize / contradict)\n  // --------------------------------------------------------------------------\n\n  /**\n   * Handle SUPPORT: update support stats on existing memory for a specific context.\n   */\n  private async handleSupport(\n    matchId: string,\n    scopeFilter: string[],\n    source: { session: string; timestamp: number },\n    reason: string,\n    contextLabel?: string,\n  ): Promise<void> {\n    const existing = await this.store.getById(matchId, scopeFilter);\n    if (!existing) return;\n\n    const meta = parseSmartMetadata(existing.metadata, existing);\n    const supportInfo = parseSupportInfo(meta.support_info);\n    const updated = updateSupportStats(supportInfo, contextLabel, \"support\");\n    meta.support_info = updated;\n\n    await this.store.update(\n      matchId,\n      { metadata: stringifySmartMetadata(meta) },\n      scopeFilter,\n    );\n\n    this.log(\n      `memory-pro: smart-extractor: support [${contextLabel || \"general\"}] on ${matchId.slice(0, 8)} \u2014 ${reason}`,\n    );\n  }\n\n  /**\n   * Handle CONTEXTUALIZE: create a new entry that adds situational nuance,\n   * linked to the original via a relation in metadata.\n   */\n  private async handleContextualize(\n    candidate: CandidateMemory,\n    vector: number[],\n    matchId: string,\n    sessionKey: string,\n    targetScope: string,\n    scopeFilter: string[],\n    contextLabel?: string,\n  ): Promise<void> {\n    const storeCategory = this.mapToStoreCategory(candidate.category);\n    const metadata = stringifySmartMetadata({\n      l0_abstract: candidate.abstract,\n      l1_overview: candidate.overview,\n      l2_content: candidate.content,\n      memory_category: candidate.category,\n      tier: \"working\" as const,\n      access_count: 0,\n      confidence: 0.7,\n      last_accessed_at: Date.now(),\n      source_session: sessionKey,\n      contexts: contextLabel ? [contextLabel] : [],\n      relations: [{ type: \"contextualizes\", targetId: matchId }],\n    });\n\n    await this.store.store({\n      text: candidate.abstract,\n      vector,\n      category: storeCategory,\n      scope: targetScope,\n      importance: this.getDefaultImportance(candidate.category),\n      metadata,\n    });\n\n    this.log(\n      `memory-pro: smart-extractor: contextualize [${contextLabel || \"general\"}] new entry linked to ${matchId.slice(0, 8)}`,\n    );\n  }\n\n  /**\n   * Handle CONTRADICT: create contradicting entry + record contradiction evidence\n   * on the original memory's support stats.\n   */\n  private async handleContradict(\n    candidate: CandidateMemory,\n    vector: number[],\n    matchId: string,\n    sessionKey: string,\n    targetScope: string,\n    scopeFilter: string[],\n    contextLabel?: string,\n  ): Promise<void> {\n    const now = Date.now();\n    const nowIso = new Date(now).toISOString();\n\n    // 1. Demote + expire the contradicted memory\n    const existing = await this.store.getById(matchId, scopeFilter);\n    if (existing) {\n      const meta = parseSmartMetadata(existing.metadata, existing);\n      const supportInfo = parseSupportInfo(meta.support_info);\n      const updated = updateSupportStats(supportInfo, contextLabel, \"contradict\");\n      meta.support_info = updated;\n      meta.expired_at = nowIso;\n      meta.expired_reason = `contradicted by: ${candidate.abstract.slice(0, 120)}`;\n      meta.superseded_by_session = sessionKey;\n      await this.store.update(\n        matchId,\n        {\n          importance: Math.max(0.05, (existing.importance ?? 0.7) * 0.2),\n          metadata: stringifySmartMetadata(meta),\n        },\n        scopeFilter,\n      );\n\n      // 2. Expire in Graphiti (fire-and-forget)\n      if (process.env.GRAPHITI_ENABLED === \"true\") {\n        const graphitiBase = process.env.GRAPHITI_BASE_URL || \"http://127.0.0.1:18799\";\n        fetch(`${graphitiBase}/facts/expire`, {\n          method: \"POST\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify({\n            text: existing.text,\n            expired_at: nowIso,\n            reason: `contradicted: ${candidate.abstract.slice(0, 80)}`,\n          }),\n          signal: AbortSignal.timeout(5000),\n        }).catch(() => {});\n      }\n\n      this.log(\n        `memory-pro: smart-extractor: expired old memory ${matchId.slice(0, 8)} (imp ${(existing.importance ?? 0.7).toFixed(2)}\u2192${Math.max(0.05, (existing.importance ?? 0.7) * 0.2).toFixed(2)})`,\n      );\n    }\n\n    // 3. Store the new (contradicting) entry with supersedes relation\n    const storeCategory = this.mapToStoreCategory(candidate.category);\n    const metadata = stringifySmartMetadata({\n      l0_abstract: candidate.abstract,\n      l1_overview: candidate.overview,\n      l2_content: candidate.content,\n      memory_category: candidate.category,\n      tier: \"working\" as const,\n      access_count: 0,\n      confidence: 0.85,\n      last_accessed_at: now,\n      source_session: sessionKey,\n      contexts: contextLabel ? [contextLabel] : [],\n      relations: [\n        { type: \"contradicts\", targetId: matchId },\n        { type: \"supersedes\", targetId: matchId },\n      ],\n      valid_from: nowIso,\n    });\n\n    await this.store.store({\n      text: candidate.abstract,\n      vector,\n      category: storeCategory,\n      scope: targetScope,\n      importance: Math.min(1.0, this.getDefaultImportance(candidate.category) + 0.1),\n      metadata,\n    });\n\n    this.log(\n      `memory-pro: smart-extractor: contradict [${contextLabel || \"general\"}] superseded ${matchId.slice(0, 8)} \u2192 new entry (imp ${(this.getDefaultImportance(candidate.category) + 0.1).toFixed(2)})`,\n    );\n  }\n\n  // --------------------------------------------------------------------------\n  // Store Helper\n  // --------------------------------------------------------------------------\n\n  /**\n   * Store a candidate memory as a new entry with L0/L1/L2 metadata.\n   */\n  private async storeCandidate(\n    candidate: CandidateMemory,\n    vector: number[],\n    sessionKey: string,\n    targetScope: string,\n  ): Promise<void> {\n    // Map 6-category to existing store categories for backward compatibility\n    const storeCategory = this.mapToStoreCategory(candidate.category);\n\n    const metadata = stringifySmartMetadata(\n      buildSmartMetadata(\n        {\n          text: candidate.abstract,\n          category: this.mapToStoreCategory(candidate.category),\n        },\n        {\n          l0_abstract: candidate.abstract,\n          l1_overview: candidate.overview,\n          l2_content: candidate.content,\n          memory_category: candidate.category,\n          tier: \"working\",\n          access_count: 0,\n          confidence: 0.7,\n          source_session: sessionKey,\n        },\n      ),\n    );\n\n    await this.store.store({\n      text: candidate.abstract, // L0 used as the searchable text\n      vector,\n      category: storeCategory,\n      scope: targetScope,\n      importance: this.getDefaultImportance(candidate.category),\n      metadata,\n    });\n\n    this.log(\n      `memory-pro: smart-extractor: created [${candidate.category}] ${candidate.abstract.slice(0, 60)}`,\n    );\n  }\n\n  /**\n   * Map 6-category to existing 5-category store type for backward compatibility.\n   */\n  private mapToStoreCategory(\n    category: MemoryCategory,\n  ): \"preference\" | \"fact\" | \"decision\" | \"entity\" | \"other\" {\n    switch (category) {\n      case \"profile\":\n        return \"fact\";\n      case \"preferences\":\n        return \"preference\";\n      case \"entities\":\n        return \"entity\";\n      case \"events\":\n        return \"decision\";\n      case \"cases\":\n        return \"fact\";\n      case \"patterns\":\n        return \"other\";\n      default:\n        return \"other\";\n    }\n  }\n\n  /**\n   * Get default importance score by category.\n   */\n  private getDefaultImportance(category: MemoryCategory): number {\n    switch (category) {\n      case \"profile\":\n        return 0.9; // Identity is very important\n      case \"preferences\":\n        return 0.8;\n      case \"entities\":\n        return 0.7;\n      case \"events\":\n        return 0.6;\n      case \"cases\":\n        return 0.8; // Problem-solution pairs are high value\n      case \"patterns\":\n        return 0.85; // Reusable processes are high value\n      default:\n        return 0.5;\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["existing"]
+}

package/dist/src/smart-metadata.d.ts

@@ -0,0 +1,103 @@
+import type { MemoryCategory, MemoryTier } from "./memory-categories.js";
+import type { DecayableMemory } from "./decay-engine.js";
+type LegacyStoreCategory = "preference" | "fact" | "decision" | "entity" | "other" | "reflection";
+type EntryLike = {
+    text?: string;
+    category?: LegacyStoreCategory;
+    importance?: number;
+    timestamp?: number;
+    metadata?: string;
+};
+export interface SmartMemoryMetadata {
+    l0_abstract: string;
+    l1_overview: string;
+    l2_content: string;
+    memory_category: MemoryCategory;
+    tier: MemoryTier;
+    access_count: number;
+    confidence: number;
+    last_accessed_at: number;
+    source_session?: string;
+    /** Emotional salience score (0-1). Higher = more emotionally significant = decays slower.
+     *  Computed at store time via heuristic rules (zero LLM cost). */
+    emotional_salience: number;
+    [key: string]: unknown;
+}
+export interface LifecycleMemory {
+    id: string;
+    importance: number;
+    confidence: number;
+    tier: MemoryTier;
+    accessCount: number;
+    createdAt: number;
+    lastAccessedAt: number;
+    emotionalSalience: number;
+}
+/**
+ * Compute emotional salience from text + category.
+ * Returns 0-1. Higher = more emotionally charged / personally significant.
+ * Pure heuristic, no LLM call.
+ */
+export declare function computeEmotionalSalience(text: string, category?: string, importance?: number): number;
+/**
+ * Calibrate LLM-returned emotion valence with rule-based post-processing.
+ *
+ * Fixes two common LLM failure modes:
+ * 1. Strong emotional text scored as neutral (0.4-0.6) → push toward extremes
+ * 2. Pure factual/data text scored as emotional → compress toward neutral
+ *
+ * @param text - The memory text
+ * @param rawValence - LLM-returned valence (0-1, 0.5 = neutral)
+ * @returns Calibrated valence (0-1)
+ */
+export declare function calibrateEmotion(text: string, rawValence: number): number;
+export declare function reverseMapLegacyCategory(oldCategory: LegacyStoreCategory | undefined, text?: string): MemoryCategory;
+export declare function parseSmartMetadata(rawMetadata: string | undefined, entry?: EntryLike): SmartMemoryMetadata;
+export declare function buildSmartMetadata(entry: EntryLike, patch?: Partial<SmartMemoryMetadata>): SmartMemoryMetadata;
+export declare function stringifySmartMetadata(metadata: SmartMemoryMetadata | Record<string, unknown>): string;
+export declare function toLifecycleMemory(id: string, entry: EntryLike): LifecycleMemory;
+/**
+ * Parse a memory entry into both a DecayableMemory (for the decay engine)
+ * and the raw SmartMemoryMetadata (for in-place mutation before write-back).
+ */
+export declare function getDecayableFromEntry(entry: EntryLike & {
+    id?: string;
+}): {
+    memory: DecayableMemory;
+    meta: SmartMemoryMetadata;
+};
+/** Predefined context vocabulary for support slices */
+export declare const SUPPORT_CONTEXT_VOCABULARY: readonly ["general", "morning", "afternoon", "evening", "night", "weekday", "weekend", "work", "leisure", "summer", "winter", "travel"];
+export type SupportContext = (typeof SUPPORT_CONTEXT_VOCABULARY)[number] | string;
+/** Max number of context slices per memory to prevent metadata bloat */
+export declare const MAX_SUPPORT_SLICES = 8;
+/** A single context-specific support slice */
+export interface ContextualSupport {
+    context: SupportContext;
+    confirmations: number;
+    contradictions: number;
+    strength: number;
+    last_observed_at: number;
+}
+/** V2 support info with per-context slices */
+export interface SupportInfoV2 {
+    global_strength: number;
+    total_observations: number;
+    slices: ContextualSupport[];
+}
+/**
+ * Normalize a raw context label to a canonical context.
+ * Maps common variants and falls back to "general".
+ */
+export declare function normalizeContext(raw: string | undefined): SupportContext;
+/**
+ * Parse support_info from metadata JSON. Handles V1 (flat) → V2 (sliced) migration.
+ */
+export declare function parseSupportInfo(raw: unknown): SupportInfoV2;
+/**
+ * Update support stats for a specific context.
+ * Returns a new SupportInfoV2 with the updated slice.
+ */
+export declare function updateSupportStats(existing: SupportInfoV2, contextLabel: string | undefined, event: "support" | "contradict"): SupportInfoV2;
+export {};
+//# sourceMappingURL=smart-metadata.d.ts.map

package/dist/src/smart-metadata.d.ts.map

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

package/dist/src/smart-metadata.js

@@ -0,0 +1,361 @@
+function clamp01(value, fallback) {
+  const n = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(n)) return fallback;
+  return Math.min(1, Math.max(0, n));
+}
+function clampCount(value, fallback = 0) {
+  const n = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(n) || n < 0) return fallback;
+  return Math.floor(n);
+}
+const SALIENCE_BOOSTERS = [
+  // Decisions and commitments
+  { pattern: /\b(决定|决策|confirmed|decided|commit|approved|批了|拍板|定了)\b/i, boost: 0.3 },
+  // Strong emotions
+  { pattern: /\b(震惊|惊喜|愤怒|失望|兴奋|amazing|shocked|frustrated|excited|worried|担心)\b/i, boost: 0.25 },
+  // First-time events
+  { pattern: /\b(第一次|首次|first time|first ever|从未|never before)\b/i, boost: 0.25 },
+  // Financial significance
+  { pattern: /\b(\d+万|\d+亿|\$[\d,.]+[MBK]|估值|valuation|投资|持仓)\b/i, boost: 0.2 },
+  // People and relationships (user-configurable entity names)
+  { pattern: /\b(colleague|partner|mentor|friend|manager|teammate)\b/i, boost: 0.15 },
+  // Lessons learned / mistakes
+  { pattern: /\b(教训|踩坑|pitfall|lesson|mistake|bug|故障|挂了|崩了)\b/i, boost: 0.2 },
+  // Preferences and identity
+  { pattern: /\b(喜欢|讨厌|偏好|prefer|hate|love|always|never)\b/i, boost: 0.15 },
+  // Exclamation / emphasis (emotional weight)
+  { pattern: /[!！]{2,}|‼️|⚠️|🔴|💀/, boost: 0.1 }
+];
+const SALIENCE_DAMPENERS = [
+  { pattern: /\b(heartbeat|HEARTBEAT_OK)\b/i, dampen: 0.2 },
+  { pattern: /\b(cron|restart|gateway|status)\b/i, dampen: 0.1 },
+  { pattern: /\b(debug|stack trace|npm|node_modules|\.tsx?|\.jsx?)\b/i, dampen: 0.1 },
+  { pattern: /^\[?(Updated|Added|Removed|Fixed|Set)\]?\s.{0,30}$/i, dampen: 0.15 }
+  // short auto-generated entries only
+];
+function computeEmotionalSalience(text, category, importance) {
+  let score = 0.35;
+  if (category === "decision") score += 0.15;
+  if (category === "preference") score += 0.1;
+  if (category === "reflection") score += 0.1;
+  if (typeof importance === "number" && importance > 0.8) score += 0.1;
+  if (typeof importance === "number" && importance > 0.9) score += 0.05;
+  for (const { pattern, boost } of SALIENCE_BOOSTERS) {
+    if (pattern.test(text)) score += boost;
+  }
+  for (const { pattern, dampen } of SALIENCE_DAMPENERS) {
+    if (pattern.test(text)) score -= dampen;
+  }
+  return Math.min(1, Math.max(0, score));
+}
+const STRONG_EMOTION_PATTERNS = [
+  /太好了|太棒了|amazing|incredible|wonderful|fantastic|excellent/i,
+  /terrible|horrible|awful|disgusting|devastating/i,
+  /fuck|shit|damn|靠|卧槽|我去|妈的/i,
+  /哈哈哈|lol|lmao|rofl|😂|🤣/i,
+  /[!！]{3,}/,
+  /heartbroken|ecstatic|furious|thrilled|terrified/i,
+  /崩溃|暴怒|狂喜|绝望|震惊|兴奋死了/i
+];
+const FACTUAL_PATTERNS = [
+  /估值|revenue|valuation|profit|loss|margin/i,
+  /[$￥€£]/,
+  /%/
+];
+function calibrateEmotion(text, rawValence) {
+  if (!Number.isFinite(rawValence)) return 0.5;
+  const hasStrongEmotion = STRONG_EMOTION_PATTERNS.some((p) => p.test(text));
+  const digitChars = (text.match(/\d/g) || []).length;
+  const digitRatio = text.length > 0 ? digitChars / text.length : 0;
+  const hasFactualSignals = digitRatio > 0.3 || FACTUAL_PATTERNS.some((p) => p.test(text));
+  let calibrated = rawValence;
+  if (hasStrongEmotion && rawValence >= 0.4 && rawValence <= 0.6) {
+    calibrated = rawValence <= 0.5 ? 0.3 : 0.7;
+  }
+  if (hasFactualSignals && !hasStrongEmotion) {
+    if (calibrated < 0.45) calibrated = 0.45;
+    if (calibrated > 0.55) calibrated = 0.55;
+  }
+  return Math.min(1, Math.max(0, calibrated));
+}
+function normalizeTier(value) {
+  switch (value) {
+    case "core":
+    case "working":
+    case "peripheral":
+      return value;
+    default:
+      return "working";
+  }
+}
+function reverseMapLegacyCategory(oldCategory, text = "") {
+  switch (oldCategory) {
+    case "preference":
+      return "preferences";
+    case "entity":
+      return "entities";
+    case "decision":
+      return "events";
+    case "other":
+      return "patterns";
+    case "fact":
+      if (/\b(my |i am |i'm |name is |叫我|我的|我是)\b/i.test(text) && text.length < 200) {
+        return "profile";
+      }
+      return "cases";
+    default:
+      return "patterns";
+  }
+}
+function defaultOverview(text) {
+  return `- ${text}`;
+}
+function normalizeText(value, fallback) {
+  return typeof value === "string" && value.trim() ? value.trim() : fallback;
+}
+function parseSmartMetadata(rawMetadata, entry = {}) {
+  let parsed = {};
+  if (rawMetadata) {
+    try {
+      const obj = JSON.parse(rawMetadata);
+      if (obj && typeof obj === "object") {
+        parsed = obj;
+      }
+    } catch {
+      parsed = {};
+    }
+  }
+  const text = entry.text ?? "";
+  const timestamp = typeof entry.timestamp === "number" && Number.isFinite(entry.timestamp) ? entry.timestamp : Date.now();
+  const memoryCategory = reverseMapLegacyCategory(entry.category, text);
+  const l0 = normalizeText(parsed.l0_abstract, text);
+  const l2 = normalizeText(parsed.l2_content, text);
+  const normalized = {
+    ...parsed,
+    l0_abstract: l0,
+    l1_overview: normalizeText(parsed.l1_overview, defaultOverview(l0)),
+    l2_content: l2,
+    memory_category: typeof parsed.memory_category === "string" ? parsed.memory_category : memoryCategory,
+    tier: normalizeTier(parsed.tier),
+    access_count: clampCount(parsed.access_count, 0),
+    confidence: clamp01(parsed.confidence, 0.7),
+    last_accessed_at: clampCount(parsed.last_accessed_at, timestamp),
+    source_session: typeof parsed.source_session === "string" ? parsed.source_session : void 0,
+    emotional_salience: clamp01(
+      parsed.emotional_salience,
+      computeEmotionalSalience(text, entry.category, entry.importance)
+    )
+  };
+  return normalized;
+}
+function buildSmartMetadata(entry, patch = {}) {
+  const base = parseSmartMetadata(entry.metadata, entry);
+  const text = entry.text ?? "";
+  const rawSalience = clamp01(
+    patch.emotional_salience ?? base.emotional_salience,
+    base.emotional_salience
+  );
+  const calibratedSalience = calibrateEmotion(text, rawSalience);
+  return {
+    ...base,
+    ...patch,
+    l0_abstract: normalizeText(patch.l0_abstract, base.l0_abstract),
+    l1_overview: normalizeText(patch.l1_overview, base.l1_overview),
+    l2_content: normalizeText(patch.l2_content, base.l2_content),
+    memory_category: typeof patch.memory_category === "string" ? patch.memory_category : base.memory_category,
+    tier: normalizeTier(patch.tier ?? base.tier),
+    access_count: clampCount(patch.access_count, base.access_count),
+    confidence: clamp01(patch.confidence, base.confidence),
+    last_accessed_at: clampCount(
+      patch.last_accessed_at,
+      base.last_accessed_at || entry.timestamp || Date.now()
+    ),
+    source_session: typeof patch.source_session === "string" ? patch.source_session : base.source_session,
+    emotional_salience: calibratedSalience
+  };
+}
+const MAX_SOURCES = 20;
+const MAX_HISTORY = 50;
+const MAX_RELATIONS = 16;
+function stringifySmartMetadata(metadata) {
+  const capped = { ...metadata };
+  if (Array.isArray(capped.sources) && capped.sources.length > MAX_SOURCES) {
+    capped.sources = capped.sources.slice(-MAX_SOURCES);
+  }
+  if (Array.isArray(capped.history) && capped.history.length > MAX_HISTORY) {
+    capped.history = capped.history.slice(-MAX_HISTORY);
+  }
+  if (Array.isArray(capped.relations) && capped.relations.length > MAX_RELATIONS) {
+    capped.relations = capped.relations.slice(0, MAX_RELATIONS);
+  }
+  return JSON.stringify(capped);
+}
+function toLifecycleMemory(id, entry) {
+  const metadata = parseSmartMetadata(entry.metadata, entry);
+  const createdAt = typeof entry.timestamp === "number" && Number.isFinite(entry.timestamp) ? entry.timestamp : Date.now();
+  return {
+    id,
+    importance: typeof entry.importance === "number" && Number.isFinite(entry.importance) ? entry.importance : 0.7,
+    confidence: metadata.confidence,
+    tier: metadata.tier,
+    accessCount: metadata.access_count,
+    createdAt,
+    lastAccessedAt: metadata.last_accessed_at || createdAt,
+    emotionalSalience: metadata.emotional_salience
+  };
+}
+function getDecayableFromEntry(entry) {
+  const meta = parseSmartMetadata(entry.metadata, entry);
+  const createdAt = typeof entry.timestamp === "number" && Number.isFinite(entry.timestamp) ? entry.timestamp : Date.now();
+  const memory = {
+    id: entry.id ?? "",
+    importance: typeof entry.importance === "number" && Number.isFinite(entry.importance) ? entry.importance : 0.7,
+    confidence: meta.confidence,
+    tier: meta.tier,
+    accessCount: meta.access_count,
+    createdAt,
+    lastAccessedAt: meta.last_accessed_at || createdAt,
+    emotionalSalience: meta.emotional_salience
+  };
+  return { memory, meta };
+}
+const SUPPORT_CONTEXT_VOCABULARY = [
+  "general",
+  "morning",
+  "afternoon",
+  "evening",
+  "night",
+  "weekday",
+  "weekend",
+  "work",
+  "leisure",
+  "summer",
+  "winter",
+  "travel"
+];
+const MAX_SUPPORT_SLICES = 8;
+function normalizeContext(raw) {
+  if (!raw || !raw.trim()) return "general";
+  const lower = raw.trim().toLowerCase();
+  if (SUPPORT_CONTEXT_VOCABULARY.includes(lower)) {
+    return lower;
+  }
+  const aliases = {
+    "\u65E9\u4E0A": "morning",
+    "\u4E0A\u5348": "morning",
+    "\u65E9\u6668": "morning",
+    "\u4E0B\u5348": "afternoon",
+    "\u508D\u665A": "evening",
+    "\u665A\u4E0A": "evening",
+    "\u6DF1\u591C": "night",
+    "\u591C\u665A": "night",
+    "\u51CC\u6668": "night",
+    "\u5DE5\u4F5C\u65E5": "weekday",
+    "\u5E73\u65F6": "weekday",
+    "\u5468\u672B": "weekend",
+    "\u5047\u65E5": "weekend",
+    "\u4F11\u606F\u65E5": "weekend",
+    "\u5DE5\u4F5C": "work",
+    "\u4E0A\u73ED": "work",
+    "\u529E\u516C": "work",
+    "\u4F11\u95F2": "leisure",
+    "\u653E\u677E": "leisure",
+    "\u4F11\u606F": "leisure",
+    "\u590F\u5929": "summer",
+    "\u590F\u5B63": "summer",
+    "\u51AC\u5929": "winter",
+    "\u51AC\u5B63": "winter",
+    "\u65C5\u884C": "travel",
+    "\u51FA\u5DEE": "travel",
+    "\u65C5\u6E38": "travel"
+  };
+  return aliases[lower] || lower;
+}
+function parseSupportInfo(raw) {
+  const defaultV2 = {
+    global_strength: 0.5,
+    total_observations: 0,
+    slices: []
+  };
+  if (!raw || typeof raw !== "object") return defaultV2;
+  const obj = raw;
+  if (Array.isArray(obj.slices)) {
+    return {
+      global_strength: typeof obj.global_strength === "number" ? obj.global_strength : 0.5,
+      total_observations: typeof obj.total_observations === "number" ? obj.total_observations : 0,
+      slices: obj.slices.filter(
+        (s) => s && typeof s.context === "string"
+      ).map((s) => ({
+        context: String(s.context),
+        confirmations: typeof s.confirmations === "number" && s.confirmations >= 0 ? s.confirmations : 0,
+        contradictions: typeof s.contradictions === "number" && s.contradictions >= 0 ? s.contradictions : 0,
+        strength: typeof s.strength === "number" && s.strength >= 0 && s.strength <= 1 ? s.strength : 0.5,
+        last_observed_at: typeof s.last_observed_at === "number" ? s.last_observed_at : Date.now()
+      }))
+    };
+  }
+  const conf = typeof obj.confirmations === "number" ? obj.confirmations : 0;
+  const contra = typeof obj.contradictions === "number" ? obj.contradictions : 0;
+  const total = conf + contra;
+  if (total === 0) return defaultV2;
+  return {
+    global_strength: total > 0 ? conf / total : 0.5,
+    total_observations: total,
+    slices: [{
+      context: "general",
+      confirmations: conf,
+      contradictions: contra,
+      strength: total > 0 ? conf / total : 0.5,
+      last_observed_at: Date.now()
+    }]
+  };
+}
+function updateSupportStats(existing, contextLabel, event) {
+  const ctx = normalizeContext(contextLabel);
+  const base = { ...existing, slices: [...existing.slices.map((s) => ({ ...s }))] };
+  let slice = base.slices.find((s) => s.context === ctx);
+  if (!slice) {
+    slice = { context: ctx, confirmations: 0, contradictions: 0, strength: 0.5, last_observed_at: Date.now() };
+    base.slices.push(slice);
+  }
+  if (event === "support") slice.confirmations++;
+  else slice.contradictions++;
+  const sliceTotal = slice.confirmations + slice.contradictions;
+  slice.strength = sliceTotal > 0 ? slice.confirmations / sliceTotal : 0.5;
+  slice.last_observed_at = Date.now();
+  let slices = base.slices;
+  let droppedConf = 0, droppedContra = 0;
+  if (slices.length > MAX_SUPPORT_SLICES) {
+    slices = slices.sort((a, b) => b.last_observed_at - a.last_observed_at);
+    const dropped = slices.slice(MAX_SUPPORT_SLICES);
+    for (const d of dropped) {
+      droppedConf += d.confirmations;
+      droppedContra += d.contradictions;
+    }
+    slices = slices.slice(0, MAX_SUPPORT_SLICES);
+  }
+  let totalConf = droppedConf, totalContra = droppedContra;
+  for (const s of slices) {
+    totalConf += s.confirmations;
+    totalContra += s.contradictions;
+  }
+  const totalObs = totalConf + totalContra;
+  const global_strength = totalObs > 0 ? totalConf / totalObs : 0.5;
+  return { global_strength, total_observations: totalObs, slices };
+}
+export {
+  MAX_SUPPORT_SLICES,
+  SUPPORT_CONTEXT_VOCABULARY,
+  buildSmartMetadata,
+  calibrateEmotion,
+  computeEmotionalSalience,
+  getDecayableFromEntry,
+  normalizeContext,
+  parseSmartMetadata,
+  parseSupportInfo,
+  reverseMapLegacyCategory,
+  stringifySmartMetadata,
+  toLifecycleMemory,
+  updateSupportStats
+};
+//# sourceMappingURL=smart-metadata.js.map