@mnemoai/core 1.1.0 → 1.1.1

package/dist/src/retriever.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/retriever.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: MIT\n/**\n * Hybrid Retrieval System\n * Combines vector search + BM25 full-text search with RRF fusion\n */\n\nimport type { MemoryEntry, MemoryStore, MemorySearchResult } from \"./store.js\";\nimport type { Embedder } from \"./embedder.js\";\nimport { filterNoise } from \"./noise-filter.js\";\nimport type { DecayEngine, DecayableMemory } from \"./decay-engine.js\";\nimport type { TierManager } from \"./tier-manager.js\";\nimport { toLifecycleMemory, getDecayableFromEntry } from \"./smart-metadata.js\";\nimport { getAdaptiveThreshold, recordResonanceScore } from \"./resonance-state.js\";\nimport { requirePro } from \"./license.js\";\nimport { log } from \"./logger.js\";\n\n// Pro: Access tracking & query tracking \u2014 graceful degradation without license\ntype AccessTracker = { bumpAccess: (id: string) => Promise<void> };\nlet _parseAccessMetadata: ((m: unknown) => { accessCount: number; lastAccessedAt: number }) | null = null;\nlet _computeEffectiveHalfLife: ((hl: number, ac: number, la: number, rf?: number, mx?: number) => number) | null = null;\n// TODO: type this with actual query-tracker signature\nlet _recordQuery: ((...args: unknown[]) => void) | null = null;\n\nif (requirePro(\"access-tracking\")) {\n  import(\"./access-tracker.js\").then((mod) => {\n    _parseAccessMetadata = mod.parseAccessMetadata;\n    _computeEffectiveHalfLife = mod.computeEffectiveHalfLife;\n  }).catch(() => {});\n}\nif (requirePro(\"query-tracking\")) {\n  import(\"./query-tracker.js\").then((mod) => {\n    _recordQuery = mod.recordQuery;\n  }).catch(() => {});\n}\n\n// Fallbacks for Core mode (no access reinforcement)\nfunction parseAccessMetadata(m: unknown): { accessCount: number; lastAccessedAt: number } {\n  if (_parseAccessMetadata) return _parseAccessMetadata(m);\n  return { accessCount: 0, lastAccessedAt: 0 };\n}\nfunction computeEffectiveHalfLife(hl: number, _ac: number, _la: number, _rf?: number, _mx?: number): number {\n  if (_computeEffectiveHalfLife) return _computeEffectiveHalfLife(hl, _ac, _la, _rf, _mx);\n  return hl; // Core: use fixed half-life without reinforcement\n}\nfunction recordQuery(data: unknown): void {\n  _recordQuery?.(data);\n}\nimport { appendFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\n// ============================================================================\n// Graphiti Graph Search Integration (3rd retrieval path)\n// ============================================================================\n\n/** Lazy-read env at call time \u2014 openclaw.json env may inject after module load. */\nfunction getGraphitiConfig() {\n  return {\n    enabled: process.env.GRAPHITI_ENABLED === \"true\",\n    baseUrl: process.env.GRAPHITI_BASE_URL || \"http://127.0.0.1:18799\",\n    timeoutMs: 3000,\n  };\n}\n\ninterface GraphitiFact {\n  fact: string;\n  source_node?: string;\n  target_node?: string;\n  from_node?: string;\n  to_node?: string;\n  created_at?: string;\n  valid_at?: string | null;\n  score?: number | null;\n  degree?: number;\n  source?: \"search\" | \"spread\";\n}\n\n/**\n * Query Graphiti /spread for graph-traversal results.\n * Returns synthetic MemorySearchResult entries. Fails silently (returns []).\n */\nasync function graphitiSpreadSearch(\n  query: string,\n  groupId: string = \"default\",\n  searchLimit: number = 3,\n  spreadLimit: number = 3,\n): Promise<Array<MemorySearchResult & { rank: number }>> {\n  const cfg = getGraphitiConfig();\n  if (!cfg.enabled) return [];\n\n  try {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), cfg.timeoutMs);\n    const resp = await fetch(`${cfg.baseUrl}/spread`, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        query,\n        group_id: groupId,\n        search_limit: searchLimit,\n        spread_depth: 1,\n        spread_limit: spreadLimit,\n      }),\n      signal: controller.signal,\n    });\n    clearTimeout(timeout);\n    if (!resp.ok) return [];\n\n    const facts: GraphitiFact[] = await resp.json();\n    if (!Array.isArray(facts) || facts.length === 0) return [];\n\n    const seen = new Set<string>();\n    const results: Array<MemorySearchResult & { rank: number }> = [];\n\n    for (let i = 0; i < facts.length; i++) {\n      const f = facts[i];\n      const factText = f.fact?.trim();\n      if (!factText || factText.length < 5 || seen.has(factText)) continue;\n      seen.add(factText);\n\n      const nodes = [f.source_node, f.target_node, f.from_node, f.to_node]\n        .filter(Boolean).join(\" \u2192 \");\n      const text = nodes ? `[\u56FE\u8C31] ${factText} (${nodes})` : `[\u56FE\u8C31] ${factText}`;\n\n      const baseScore = f.source === \"search\" ? 0.75 : 0.45;\n      const degreeBoost = f.degree ? Math.min(0.15, Math.log1p(f.degree) * 0.02) : 0;\n\n      results.push({\n        entry: {\n          id: `graphiti-${i}-${Date.now()}`,\n          text,\n          category: \"entity\" as const,\n          importance: 0.8,\n          timestamp: f.created_at ? new Date(f.created_at).getTime() : Date.now(),\n          scope: \"global\",\n        },\n        score: Math.min(1.0, baseScore + degreeBoost),\n        rank: i + 1,\n      });\n    }\n    return results;\n  } catch {\n    return []; // Silent fallback\n  }\n}\n\n// ============================================================================\n// Types & Configuration\n// ============================================================================\n\nexport interface RetrievalConfig {\n  mode: \"hybrid\" | \"vector\";\n  vectorWeight: number;\n  bm25Weight: number;\n  minScore: number;\n  rerank: \"cross-encoder\" | \"lightweight\" | \"none\";\n  candidatePoolSize: number;\n  /** Recency boost half-life in days (default: 14). Set 0 to disable. */\n  recencyHalfLifeDays: number;\n  /** Max recency boost factor (default: 0.10) */\n  recencyWeight: number;\n  /** Filter noise from results (default: true) */\n  filterNoise: boolean;\n  /** Reranker API key (enables cross-encoder reranking) */\n  rerankApiKey?: string;\n  /** Reranker model (default: jina-reranker-v3) */\n  rerankModel?: string;\n  /** Reranker API endpoint (default: https://api.jina.ai/v1/rerank). */\n  rerankEndpoint?: string;\n  /** Reranker provider format. Determines request/response shape and auth header.\n   *  - \"jina\" (default): Authorization: Bearer, string[] documents, results[].relevance_score\n   *  - \"siliconflow\": same format as jina (alias, for clarity)\n   *  - \"voyage\": Authorization: Bearer, string[] documents, data[].relevance_score\n   *  - \"pinecone\": Api-Key header, {text}[] documents, data[].score */\n  rerankProvider?: \"jina\" | \"siliconflow\" | \"voyage\" | \"pinecone\" | \"ollama\";\n  /**\n   * Length normalization: penalize long entries that dominate via sheer keyword\n   * density. Formula: score *= 1 / (1 + log2(charLen / anchor)).\n   * anchor = reference length (default: 500 chars). Entries shorter than anchor\n   * get a slight boost; longer entries get penalized progressively.\n   * Set 0 to disable. (default: 300)\n   */\n  lengthNormAnchor: number;\n  /**\n   * Hard cutoff after rerank: discard results below this score.\n   * Applied after all scoring stages (rerank, recency, importance, length norm).\n   * Higher = fewer but more relevant results. (default: 0.35)\n   */\n  hardMinScore: number;\n  /**\n   * Time decay half-life in days. Entries older than this lose score.\n   * Different from recencyBoost (additive bonus for new entries):\n   * this is a multiplicative penalty for old entries.\n   * Formula: score *= 0.5 + 0.5 * exp(-ageDays / halfLife)\n   * At halfLife days: ~0.68x. At 2*halfLife: ~0.59x. At 4*halfLife: ~0.52x.\n   * Set 0 to disable. (default: 60)\n   */\n  timeDecayHalfLifeDays: number;\n  /** Access reinforcement factor for time decay half-life extension.\n   *  Higher = stronger reinforcement. 0 to disable. (default: 0.5) */\n  reinforcementFactor: number;\n  /** Maximum half-life multiplier from access reinforcement.\n   *  Prevents frequently accessed memories from becoming immortal. (default: 3) */\n  maxHalfLifeMultiplier: number;\n  /** Enable multi-hop query routing: detected multi-hop queries skip Graphiti\n   *  spread and rely on LanceDB secondary retrieval instead. (default: true) */\n  multiHopRouting: boolean;\n}\n\nexport interface RetrievalContext {\n  query: string;\n  limit: number;\n  scopeFilter?: string[];\n  category?: string;\n  /** Retrieval source: \"manual\" for user-triggered, \"auto-recall\" for system-initiated, \"cli\" for CLI commands. */\n  source?: \"manual\" | \"auto-recall\" | \"cli\";\n}\n\nexport interface RetrievalResult extends MemorySearchResult {\n  sources: {\n    vector?: { score: number; rank: number };\n    bm25?: { score: number; rank: number };\n    graphiti?: { score: number; rank: number };\n    fused?: { score: number };\n    reranked?: { score: number };\n  };\n}\n\n// ============================================================================\n// Default Configuration\n// ============================================================================\n\nexport const DEFAULT_RETRIEVAL_CONFIG: RetrievalConfig = {\n  mode: \"hybrid\",\n  vectorWeight: 0.7,\n  bm25Weight: 0.3,\n  minScore: 0.3,\n  rerank: \"cross-encoder\",\n  candidatePoolSize: 20,\n  recencyHalfLifeDays: 14,\n  recencyWeight: 0.1,\n  filterNoise: true,\n  rerankModel: \"jina-reranker-v3\",\n  rerankEndpoint: \"https://api.jina.ai/v1/rerank\",\n  lengthNormAnchor: 500,\n  hardMinScore: 0.35,\n  timeDecayHalfLifeDays: 60,\n  reinforcementFactor: 0.5,\n  maxHalfLifeMultiplier: 3,\n  multiHopRouting: true,\n};\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\nfunction clampInt(value: number, min: number, max: number): number {\n  if (!Number.isFinite(value)) return min;\n  return Math.min(max, Math.max(min, Math.floor(value)));\n}\n\nfunction clamp01(value: number, fallback: number): number {\n  if (!Number.isFinite(value)) return Number.isFinite(fallback) ? fallback : 0;\n  return Math.min(1, Math.max(0, value));\n}\n\nfunction clamp01WithFloor(value: number, floor: number): number {\n  const safeFloor = clamp01(floor, 0);\n  return Math.max(safeFloor, clamp01(value, safeFloor));\n}\n\n// ============================================================================\n// Rerank Provider Adapters\n// ============================================================================\n\ntype RerankProvider = \"jina\" | \"siliconflow\" | \"voyage\" | \"pinecone\" | \"ollama\";\n\ninterface RerankItem {\n  index: number;\n  score: number;\n}\n\n/** Build provider-specific request headers and body */\nfunction buildRerankRequest(\n  provider: RerankProvider,\n  apiKey: string,\n  model: string,\n  query: string,\n  documents: string[],\n  topN: number,\n): { headers: Record<string, string>; body: Record<string, unknown> } {\n  switch (provider) {\n    case \"pinecone\":\n      return {\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"Api-Key\": apiKey,\n          \"X-Pinecone-API-Version\": \"2024-10\",\n        },\n        body: {\n          model,\n          query,\n          documents: documents.map((text) => ({ text })),\n          top_n: topN,\n          rank_fields: [\"text\"],\n        },\n      };\n    case \"voyage\":\n      return {\n        headers: {\n          \"Content-Type\": \"application/json\",\n          Authorization: `Bearer ${apiKey}`,\n        },\n        body: {\n          model,\n          query,\n          documents,\n          // Voyage uses top_k (not top_n) to limit reranked outputs.\n          top_k: topN,\n        },\n      };\n    case \"ollama\":\n      // Ollama rerank API: POST /api/rerank (available since Ollama 0.6+)\n      // Models: jina-reranker-v1-turbo, bge-reranker-v2-m3, etc.\n      // No API key needed for local Ollama\n      return {\n        headers: {\n          \"Content-Type\": \"application/json\",\n        },\n        body: {\n          model,\n          query,\n          documents,\n          top_n: topN,\n        },\n      };\n    case \"siliconflow\":\n    case \"jina\":\n    default:\n      return {\n        headers: {\n          \"Content-Type\": \"application/json\",\n          Authorization: `Bearer ${apiKey}`,\n        },\n        body: {\n          model,\n          query,\n          documents,\n          top_n: topN,\n        },\n      };\n  }\n}\n\n/** Parse provider-specific response into unified format */\nfunction parseRerankResponse(\n  provider: RerankProvider,\n  data: Record<string, unknown>,\n): RerankItem[] | null {\n  const parseItems = (\n    items: unknown,\n    scoreKeys: Array<\"score\" | \"relevance_score\">,\n  ): RerankItem[] | null => {\n    if (!Array.isArray(items)) return null;\n    const parsed: RerankItem[] = [];\n    for (const raw of items as Array<Record<string, unknown>>) {\n      const index =\n        typeof raw?.index === \"number\" ? raw.index : Number(raw?.index);\n      if (!Number.isFinite(index)) continue;\n      let score: number | null = null;\n      for (const key of scoreKeys) {\n        const value = raw?.[key];\n        const n = typeof value === \"number\" ? value : Number(value);\n        if (Number.isFinite(n)) {\n          score = n;\n          break;\n        }\n      }\n      if (score === null) continue;\n      parsed.push({ index, score });\n    }\n    return parsed.length > 0 ? parsed : null;\n  };\n\n  switch (provider) {\n    case \"ollama\": {\n      // Ollama: { results: [{ index, relevance_score }] }\n      // Same format as Jina, but also check data[] for compatibility\n      return (\n        parseItems(data.results, [\"relevance_score\", \"score\"]) ??\n        parseItems(data.data, [\"relevance_score\", \"score\"])\n      );\n    }\n    case \"pinecone\": {\n      // Pinecone: usually { data: [{ index, score, ... }] }\n      // Also tolerate results[] with score/relevance_score for robustness.\n      return (\n        parseItems(data.data, [\"score\", \"relevance_score\"]) ??\n        parseItems(data.results, [\"score\", \"relevance_score\"])\n      );\n    }\n    case \"voyage\": {\n      // Voyage: usually { data: [{ index, relevance_score }] }\n      // Also tolerate results[] for compatibility across gateways.\n      return (\n        parseItems(data.data, [\"relevance_score\", \"score\"]) ??\n        parseItems(data.results, [\"relevance_score\", \"score\"])\n      );\n    }\n    case \"siliconflow\":\n    case \"jina\":\n    default: {\n      // Jina / SiliconFlow: usually { results: [{ index, relevance_score }] }\n      // Also tolerate data[] for compatibility across gateways.\n      return (\n        parseItems(data.results, [\"relevance_score\", \"score\"]) ??\n        parseItems(data.data, [\"relevance_score\", \"score\"])\n      );\n    }\n  }\n}\n\n// Cosine similarity for reranking fallback\nfunction cosineSimilarity(a: number[], b: number[]): number {\n  if (a.length !== b.length) {\n    throw new Error(\"Vector dimensions must match for cosine similarity\");\n  }\n\n  let dotProduct = 0;\n  let normA = 0;\n  let normB = 0;\n\n  for (let i = 0; i < a.length; i++) {\n    dotProduct += a[i] * b[i];\n    normA += a[i] * a[i];\n    normB += b[i] * b[i];\n  }\n\n  const norm = Math.sqrt(normA) * Math.sqrt(normB);\n  return norm === 0 ? 0 : dotProduct / norm;\n}\n\n// ============================================================================\n// Memory Retriever\n// ============================================================================\n\nconst RETRIEVAL_LOG_PATH = join(homedir(), \".openclaw\", \"memory\", \"retrieval-log.jsonl\");\n\nexport class MemoryRetriever {\n  private accessTracker: AccessTracker | null = null;\n  private tierManager: TierManager | null = null;\n\n  constructor(\n    private store: MemoryStore,\n    private embedder: Embedder,\n    private config: RetrievalConfig = DEFAULT_RETRIEVAL_CONFIG,\n    private decayEngine: DecayEngine | null = null,\n  ) { }\n\n  setAccessTracker(tracker: AccessTracker): void {\n    this.accessTracker = tracker;\n  }\n\n  /**\n   * Resonance check: fast vector probe to see if the query \"resonates\"\n   * with any high-salience memories. Returns true if at least one memory\n   * has cosine similarity above threshold. This mimics human associative\n   * memory \u2014 most inputs don't trigger recall, only resonant ones do.\n   */\n  private async resonanceCheck(\n    query: string,\n    scopeFilter?: string[],\n  ): Promise<{ resonates: boolean; topScore: number }> {\n    try {\n      const queryVector = await this.embedder.embedQuery(query);\n      const threshold = getAdaptiveThreshold();\n      const probeResults = await this.store.vectorSearch(\n        queryVector,\n        3,\n        threshold,\n        scopeFilter,\n      );\n      if (probeResults.length === 0) return { resonates: false, topScore: 0 };\n\n      const topScore = Math.max(...probeResults.map(r => r.score));\n\n      // Record top score for adaptive threshold sliding window\n      recordResonanceScore(topScore);\n\n      // At least one result resonates \u2014 check if it has meaningful salience\n      // (not just a random match with a low-importance peripheral memory)\n      for (const r of probeResults) {\n        const importance = r.entry.importance ?? 0.5;\n        const similarity = r.score;\n        // Resonance = strong similarity OR moderate similarity + high importance\n        if (similarity >= 0.55 || (similarity >= threshold && importance >= 0.7)) {\n          return { resonates: true, topScore };\n        }\n      }\n      return { resonates: false, topScore };\n    } catch {\n      // If resonance check fails, allow recall (fail-open)\n      return { resonates: true, topScore: 0 };\n    }\n  }\n\n  /**\n   * Strip metadata blocks from auto-recall queries.\n   * OpenClaw core may pass the full message including Conversation info,\n   * Replied message, and Sender metadata JSON blocks. We only want the\n   * actual user text for semantic search.\n   */\n  private cleanAutoRecallQuery(raw: string): string {\n    // Remove ```json ... ``` code blocks (metadata envelopes)\n    let cleaned = raw.replace(/```json[\\s\\S]*?```/g, \"\");\n    // Remove known metadata headers\n    cleaned = cleaned.replace(/Conversation info \\(untrusted metadata\\):/g, \"\");\n    cleaned = cleaned.replace(/Sender \\(untrusted metadata\\):/g, \"\");\n    cleaned = cleaned.replace(/Replied message \\(untrusted, for context\\):/g, \"\");\n    // Remove [Queued messages ...] headers\n    cleaned = cleaned.replace(/\\[Queued messages[^\\]]*\\]/g, \"\");\n    cleaned = cleaned.replace(/---\\s*\\nQueued #\\d+/g, \"\");\n    // Collapse whitespace\n    cleaned = cleaned.replace(/\\n{3,}/g, \"\\n\").trim();\n    // If nothing left after cleaning, return original (safety)\n    return cleaned.length > 2 ? cleaned : raw;\n  }\n\n  /**\n   * Expand date expressions in query to multiple formats for BM25 matching.\n   * \"3\u670817\u65E5\" \u2192 \"3\u670817\u65E5 3/17 03-17 2026-03-17\"\n   * \"2026\u5E743\u670817\u65E5\" \u2192 \"2026\u5E743\u670817\u65E5 3/17 2026-03-17 03-17\"\n   * \"\u6628\u5929/\u524D\u5929/\u4E0A\u5468\" \u2192 resolved to absolute dates\n   */\n  private expandDateFormats(query: string): string {\n    const now = new Date();\n    const year = now.getFullYear();\n    let expanded = query;\n\n    // Pattern: X\u6708Y\u65E5 or X\u6708Y\u53F7\n    expanded = expanded.replace(/(\\d{1,2})\u6708(\\d{1,2})[\u65E5\u53F7]/g, (match, m, d) => {\n      const mm = String(m).padStart(2, \"0\");\n      const dd = String(d).padStart(2, \"0\");\n      return `${match} ${m}/${d} ${year}-${mm}-${dd} ${mm}-${dd}`;\n    });\n\n    // Pattern: YYYY\u5E74X\u6708Y\u65E5\n    expanded = expanded.replace(/(\\d{4})\u5E74(\\d{1,2})\u6708(\\d{1,2})[\u65E5\u53F7]/g, (match, y, m, d) => {\n      const mm = String(m).padStart(2, \"0\");\n      const dd = String(d).padStart(2, \"0\");\n      return `${match} ${m}/${d} ${y}-${mm}-${dd} ${mm}-${dd}`;\n    });\n\n    // Pattern: X.Y or X/Y (might be dates like 3/17)\n    // Don't expand \u2014 these are already BM25-friendly\n\n    // Relative dates\n    const relMap: Record<string, number> = {\n      \"\u4ECA\u5929\": 0, \"\u6628\u5929\": -1, \"\u524D\u5929\": -2, \"\u5927\u524D\u5929\": -3,\n    };\n    for (const [word, offset] of Object.entries(relMap)) {\n      if (expanded.includes(word)) {\n        const d = new Date(now.getTime() + offset * 86400000);\n        const iso = d.toISOString().slice(0, 10);\n        const m = d.getMonth() + 1;\n        const day = d.getDate();\n        expanded = expanded.replace(word, `${word} ${iso} ${m}/${day} ${m}\u6708${day}\u65E5`);\n      }\n    }\n\n    return expanded;\n  }\n\n  async retrieve(context: RetrievalContext): Promise<RetrievalResult[]> {\n    let { query, limit, scopeFilter, category, source } = context;\n    // Clean metadata pollution from auto-recall queries\n    if (source === \"auto-recall\") {\n      query = this.cleanAutoRecallQuery(query);\n    }\n    const safeLimit = clampInt(limit, 1, 20);\n    const t0 = performance.now();\n\n    // \u2500\u2500 \u5171\u632F\u95E8\u63A7\uFF1Aauto-recall \u65F6\u5148\u505A\u5FEB\u901F\u5171\u632F\u68C0\u6D4B \u2500\u2500\n    let resonanceTriggered = false;\n    let resonanceTopScore = 0;\n    if (source === \"auto-recall\") {\n      const { resonates, topScore: probeTopScore } = await this.resonanceCheck(query, scopeFilter);\n      resonanceTriggered = resonates;\n      resonanceTopScore = probeTopScore;\n      if (!resonates) {\n        // Fire-and-forget tracking for gated-out queries\n        const trackEntry = JSON.stringify({\n          ts: new Date().toISOString(),\n          query: query.substring(0, 200),\n          source: source || \"manual\",\n          queryType: \"gated-out\",\n          resonanceScore: resonanceTopScore,\n          resonanceTriggered: false,\n          lancedbCount: 0,\n          graphitiCount: 0,\n          rerankCount: 0,\n          finalCount: 0,\n          totalLatencyMs: Math.round(performance.now() - t0),\n          lancedbLatencyMs: 0,\n          graphitiLatencyMs: 0,\n          rerankLatencyMs: 0,\n        }) + \"\\n\";\n        appendFile(RETRIEVAL_LOG_PATH, trackEntry).catch(() => {});\n        recordQuery({\n          timestamp: new Date().toISOString(),\n          query: query.substring(0, 200),\n          source: (source === \"auto-recall\" ? \"auto\" : source || \"manual\") as \"auto\" | \"manual\" | \"cli\",\n          hitCount: 0,\n          topScore: resonanceTopScore,\n          latency_ms: Math.round(performance.now() - t0),\n          queryType: \"gated-out\",\n          resonancePass: false,\n        });\n        return []; // \u65E0\u5171\u632F \u2192 \u4E0D\u6CE8\u5165\u8BB0\u5FC6\n      }\n    }\n\n    // \u2500\u2500 Multi-hop \u68C0\u6D4B \u2500\u2500\n    const isMultiHop = this.config.multiHopRouting && this.isMultiHopQuery(query);\n\n    // \u2500\u2500 \u5E76\u53D1\u67E5\u8BE2\uFF1ALanceDB + Graphiti \u2500\u2500\n    const tLance0 = performance.now();\n    const lanceDbPromise = (async () => {\n      if (this.config.mode === \"vector\" || !this.store.hasFtsSupport) {\n        return this.vectorOnlyRetrieval(query, safeLimit, scopeFilter, category);\n      } else {\n        return this.hybridRetrieval(query, safeLimit, scopeFilter, category);\n      }\n    })();\n\n    const tGraphiti0 = performance.now();\n    const graphitiPromise = (async (): Promise<RetrievalResult[]> => {\n      if (process.env.GRAPHITI_ENABLED !== \"true\") return [];\n      try {\n        const graphitiBase = process.env.GRAPHITI_BASE_URL || \"http://127.0.0.1:18799\";\n        const scope = scopeFilter?.[0] || \"default\";\n        const groupId = scope.startsWith(\"agent:\") ? scope.split(\":\")[1] || \"default\" : \"default\";\n\n        // Multi-hop queries skip spread (spread follows single-entity neighborhoods)\n        const useSpread = source === \"auto-recall\" && !isMultiHop;\n        const endpoint = useSpread ? \"/spread\" : \"/search\";\n        const body = useSpread\n          ? { query, group_id: groupId, search_limit: 3, spread_depth: 1, spread_limit: 3 }\n          : { query, group_id: groupId, limit: Math.min(safeLimit, 5) };\n\n        const resp = await fetch(`${graphitiBase}${endpoint}`, {\n          method: \"POST\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify(body),\n          signal: AbortSignal.timeout(5000),\n        });\n        if (!resp.ok) return [];\n\n        const facts = (await resp.json()) as Array<{\n          fact: string; valid_at?: string; expired_at?: string; created_at?: string;\n          degree?: number; source?: string;\n        }>;\n        return facts\n          .filter(f => f.fact && !f.expired_at)\n          .map((f, i) => {\n            const isSpread = f.source === \"spread\";\n            const degreeBoost = f.degree ? Math.min(0.15, Math.log1p(f.degree) * 0.03) : 0;\n            const baseScore = isSpread ? 0.45 : 0.65;\n            return {\n              entry: {\n                id: `graphiti-${Date.now()}-${i}`,\n                text: f.fact,\n                vector: [],\n                category: \"fact\" as const,\n                scope: scope,\n                importance: 0.7,\n                timestamp: f.valid_at ? new Date(f.valid_at).getTime() : Date.now(),\n                metadata: JSON.stringify({ source: isSpread ? \"graphiti-spread\" : \"graphiti\", valid_at: f.valid_at, degree: f.degree }),\n              },\n              score: baseScore + (0.01 * (facts.length - i)) + degreeBoost,\n              sources: { graphiti: { rank: i + 1 } },\n            } as RetrievalResult;\n          });\n      } catch {\n        return [];\n      }\n    })();\n\n    const [lanceResults, graphitiResults] = await Promise.all([lanceDbPromise, graphitiPromise]);\n    const tLanceMs = Math.round(performance.now() - tLance0);\n    const tGraphitiMs = Math.round(performance.now() - tGraphiti0);\n\n    // Merge: LanceDB results first, append non-duplicate Graphiti facts\n    const lanceTexts = new Set(lanceResults.map(r => r.entry.text.slice(0, 80)));\n    const uniqueGraphiti = graphitiResults.filter(\n      r => !lanceTexts.has(r.entry.text.slice(0, 80))\n    );\n\n    // \u2500\u2500 \u8DE8\u6E90\u7EDF\u4E00 Rerank\uFF08\u6240\u6709\u7ED3\u679C\u90FD\u8FC7 reranker\uFF09\u2500\u2500\n    let merged: RetrievalResult[];\n    let rerankCount = 0;\n    const tRerank0 = performance.now();\n    const combined = [...lanceResults, ...uniqueGraphiti];\n    if (this.config.rerank !== \"none\" && this.config.rerankApiKey && combined.length > 0) {\n      const queryVector = await this.embedder.embedQuery(query);\n      merged = await this.rerankResults(query, queryVector, combined);\n      rerankCount = merged.length;\n      merged = merged.slice(0, safeLimit);\n    } else {\n      merged = combined.slice(0, safeLimit);\n    }\n    const tRerankMs = Math.round(performance.now() - tRerank0);\n\n    // Record access for reinforcement (manual recall only)\n    if (this.accessTracker && source === \"manual\" && merged.length > 0) {\n      this.accessTracker.recordAccess(\n        merged.filter(r => !r.entry.id.startsWith(\"graphiti-\")).map(r => r.entry.id)\n      );\n    }\n\n    // \u2500\u2500 Fire-and-forget tracking log \u2500\u2500\n    const topScore = merged.length > 0 ? Math.max(...merged.map(r => r.score)) : 0;\n    const trackEntry = JSON.stringify({\n      ts: new Date().toISOString(),\n      query: query.substring(0, 200),\n      source: source || \"manual\",\n      queryType: isMultiHop ? \"multi-hop\" : \"single\",\n      resonanceScore: topScore,\n      resonanceTriggered,\n      lancedbCount: lanceResults.length,\n      graphitiCount: graphitiResults.length,\n      rerankCount,\n      finalCount: merged.length,\n      totalLatencyMs: Math.round(performance.now() - t0),\n      lancedbLatencyMs: tLanceMs,\n      graphitiLatencyMs: tGraphitiMs,\n      rerankLatencyMs: tRerankMs,\n    }) + \"\\n\";\n    appendFile(RETRIEVAL_LOG_PATH, trackEntry).catch(() => {});\n    recordQuery({\n      timestamp: new Date().toISOString(),\n      query: query.substring(0, 200),\n      source: (source === \"auto-recall\" ? \"auto\" : source || \"manual\") as \"auto\" | \"manual\" | \"cli\",\n      hitCount: merged.length,\n      topScore,\n      latency_ms: Math.round(performance.now() - t0),\n      queryType: isMultiHop ? \"multi-hop\" : \"single\",\n      resonancePass: true,\n    });\n\n    return merged;\n  }\n\n  private async vectorOnlyRetrieval(\n    query: string,\n    limit: number,\n    scopeFilter?: string[],\n    category?: string,\n  ): Promise<RetrievalResult[]> {\n    const queryVector = await this.embedder.embedQuery(query);\n    const results = await this.store.vectorSearch(\n      queryVector,\n      limit,\n      this.config.minScore,\n      scopeFilter,\n    );\n\n    // Filter by category if specified\n    const filtered = category\n      ? results.filter((r) => r.entry.category === category)\n      : results;\n\n    const mapped = filtered.map(\n      (result, index) =>\n        ({\n          ...result,\n          sources: {\n            vector: { score: result.score, rank: index + 1 },\n          },\n        }) as RetrievalResult,\n    );\n\n    const weighted = this.decayEngine ? mapped : this.applyImportanceWeight(this.applyRecencyBoost(mapped));\n    const lengthNormalized = this.applyLengthNormalization(weighted);\n    const hardFiltered = lengthNormalized.filter(r => r.score >= this.config.hardMinScore);\n    const lifecycleRanked = this.decayEngine\n      ? this.applyDecayBoost(hardFiltered)\n      : this.applyTimeDecay(hardFiltered);\n    const denoised = this.config.filterNoise\n      ? filterNoise(lifecycleRanked, r => r.entry.text)\n      : lifecycleRanked;\n\n    // MMR deduplication: avoid top-k filled with near-identical memories\n    const deduplicated = this.applyMMRDiversity(denoised);\n\n    return deduplicated.slice(0, limit);\n  }\n\n  private async hybridRetrieval(\n    query: string,\n    limit: number,\n    scopeFilter?: string[],\n    category?: string,\n  ): Promise<RetrievalResult[]> {\n    const candidatePoolSize = Math.max(\n      this.config.candidatePoolSize,\n      limit * 2,\n    );\n\n    // Compute query embedding once, reuse for vector search + reranking\n    const queryVector = await this.embedder.embedQuery(query);\n\n    // Run vector, BM25, and Graphiti searches in parallel (3-way)\n    const [vectorResults, bm25Results, graphitiResults] = await Promise.all([\n      this.runVectorSearch(\n        queryVector,\n        candidatePoolSize,\n        scopeFilter,\n        category,\n      ),\n      this.runBM25Search(query, candidatePoolSize, scopeFilter, category),\n      graphitiSpreadSearch(query, \"default\", 3, 3),\n    ]);\n\n    // Fuse results using RRF (async: validates BM25-only entries exist in store)\n    // Graphiti results merged as 3rd signal\n    const fusedResults = await this.fuseResults(vectorResults, bm25Results, graphitiResults);\n\n    // Apply minimum score threshold\n    const filtered = fusedResults.filter(\n      (r) => r.score >= this.config.minScore,\n    );\n\n    // Rerank if enabled\n    const reranked =\n      this.config.rerank !== \"none\"\n        ? await this.rerankResults(\n          query,\n          queryVector,\n          filtered.slice(0, limit * 2),\n        )\n        : filtered;\n\n    const temporallyRanked = this.decayEngine\n      ? reranked\n      : this.applyImportanceWeight(this.applyRecencyBoost(reranked));\n\n    // Apply length normalization (penalize long entries dominating via keyword density)\n    const lengthNormalized = this.applyLengthNormalization(temporallyRanked);\n\n    // Hard minimum score cutoff should be based on semantic / lexical relevance.\n    // Lifecycle decay and time-decay are used for re-ranking, not for dropping\n    // otherwise relevant fresh memories.\n    const hardFiltered = lengthNormalized.filter(r => r.score >= this.config.hardMinScore);\n\n    // Apply lifecycle-aware decay or legacy time decay after thresholding\n    const lifecycleRanked = this.decayEngine\n      ? this.applyDecayBoost(hardFiltered)\n      : this.applyTimeDecay(hardFiltered);\n\n    // Filter noise\n    const denoised = this.config.filterNoise\n      ? filterNoise(lifecycleRanked, r => r.entry.text)\n      : lifecycleRanked;\n\n    // MMR deduplication: avoid top-k filled with near-identical memories\n    const deduplicated = this.applyMMRDiversity(denoised);\n\n    return deduplicated.slice(0, limit);\n  }\n\n  private async runVectorSearch(\n    queryVector: number[],\n    limit: number,\n    scopeFilter?: string[],\n    category?: string,\n  ): Promise<Array<MemorySearchResult & { rank: number }>> {\n    const results = await this.store.vectorSearch(\n      queryVector,\n      limit,\n      0.1,\n      scopeFilter,\n    );\n\n    // Filter by category if specified\n    const filtered = category\n      ? results.filter((r) => r.entry.category === category)\n      : results;\n\n    return filtered.map((result, index) => ({\n      ...result,\n      rank: index + 1,\n    }));\n  }\n\n  private async runBM25Search(\n    query: string,\n    limit: number,\n    scopeFilter?: string[],\n    category?: string,\n  ): Promise<Array<MemorySearchResult & { rank: number }>> {\n    // Expand date formats for better BM25 matching\n    const expandedQuery = this.expandDateFormats(query);\n    const results = await this.store.bm25Search(expandedQuery, limit, scopeFilter);\n\n    // Filter by category if specified\n    const filtered = category\n      ? results.filter((r) => r.entry.category === category)\n      : results;\n\n    return filtered.map((result, index) => ({\n      ...result,\n      rank: index + 1,\n    }));\n  }\n\n  private async fuseResults(\n    vectorResults: Array<MemorySearchResult & { rank: number }>,\n    bm25Results: Array<MemorySearchResult & { rank: number }>,\n    graphitiResults: Array<MemorySearchResult & { rank: number }> = [],\n  ): Promise<RetrievalResult[]> {\n    // Create maps for quick lookup\n    const vectorMap = new Map<string, MemorySearchResult & { rank: number }>();\n    const bm25Map = new Map<string, MemorySearchResult & { rank: number }>();\n\n    vectorResults.forEach((result) => {\n      vectorMap.set(result.entry.id, result);\n    });\n\n    bm25Results.forEach((result) => {\n      bm25Map.set(result.entry.id, result);\n    });\n\n    // Get all unique document IDs\n    const allIds = new Set([...vectorMap.keys(), ...bm25Map.keys()]);\n\n    // Calculate RRF scores\n    const fusedResults: RetrievalResult[] = [];\n\n    for (const id of allIds) {\n      const vectorResult = vectorMap.get(id);\n      const bm25Result = bm25Map.get(id);\n\n      // FIX(#15): BM25-only results may be \"ghost\" entries whose vector data was\n      // deleted but whose FTS index entry lingers until the next index rebuild.\n      // Validate that the entry actually exists in the store before including it.\n      if (!vectorResult && bm25Result) {\n        try {\n          const exists = await this.store.hasId(id);\n          if (!exists) continue; // Skip ghost entry\n        } catch {\n          // If hasId fails, keep the result (fail-open)\n        }\n      }\n\n      // Use the result with more complete data (prefer vector result if both exist)\n      const baseResult = vectorResult || bm25Result!;\n\n      // Use vector similarity as the base score.\n      // BM25 hit acts as a bonus (keyword match confirms relevance).\n      const vectorScore = vectorResult ? vectorResult.score : 0;\n      const bm25Score = bm25Result ? bm25Result.score : 0;\n      // Weighted fusion: vectorWeight/bm25Weight directly control score blending.\n      // BM25 high-score floor (>= 0.75) preserves exact keyword matches\n      // (e.g. API keys, ticket numbers) that may have low vector similarity.\n      const weightedFusion = (vectorScore * this.config.vectorWeight)\n                           + (bm25Score * this.config.bm25Weight);\n      const fusedScore = vectorResult\n        ? clamp01(\n          Math.max(\n            weightedFusion,\n            bm25Score >= 0.75 ? bm25Score * 0.92 : 0,\n          ),\n          0.1,\n        )\n        : clamp01(bm25Result!.score, 0.1);\n\n      fusedResults.push({\n        entry: baseResult.entry,\n        score: fusedScore,\n        sources: {\n          vector: vectorResult\n            ? { score: vectorResult.score, rank: vectorResult.rank }\n            : undefined,\n          bm25: bm25Result\n            ? { score: bm25Result.score, rank: bm25Result.rank }\n            : undefined,\n          fused: { score: fusedScore },\n        },\n      });\n    }\n\n    // Inject Graphiti graph traversal results as 3rd signal.\n    // Synthetic entries (not in LanceDB) \u2014 scored slightly lower to avoid dominating,\n    // but provide coverage for relational queries (e.g. \"Alice's clients\", \"who did Bob meet?\").\n    for (const gr of graphitiResults) {\n      fusedResults.push({\n        entry: gr.entry,\n        score: gr.score * 0.85,\n        sources: {\n          graphiti: { score: gr.score, rank: gr.rank },\n          fused: { score: gr.score * 0.85 },\n        },\n      });\n    }\n\n    // Sort by fused score descending\n    return fusedResults.sort((a, b) => b.score - a.score);\n  }\n\n  /**\n   * Rerank results using cross-encoder API (Jina, Pinecone, or compatible).\n   * Falls back to cosine similarity if API is unavailable or fails.\n   */\n  private async rerankResults(\n    query: string,\n    queryVector: number[],\n    results: RetrievalResult[],\n  ): Promise<RetrievalResult[]> {\n    if (results.length === 0) {\n      return results;\n    }\n\n    // Try cross-encoder rerank via configured provider API\n    log.warn(`[rerank-debug] rerank=${this.config.rerank}, hasKey=${!!this.config.rerankApiKey}, keyPrefix=${String(this.config.rerankApiKey || '').substring(0, 8)}, provider=${this.config.rerankProvider}, model=${this.config.rerankModel}`);\n    const isLocalRerank = this.config.rerankProvider === \"ollama\";\n    if (this.config.rerank === \"cross-encoder\" && (this.config.rerankApiKey || isLocalRerank)) {\n      try {\n        const provider = this.config.rerankProvider || \"jina\";\n        const model = this.config.rerankModel || (isLocalRerank ? \"bge-reranker-v2-m3\" : \"jina-reranker-v3\");\n        const endpoint =\n          this.config.rerankEndpoint || (isLocalRerank ? \"http://127.0.0.1:11434/api/rerank\" : \"https://api.jina.ai/v1/rerank\");\n        const documents = results.map((r) => r.entry.text);\n\n        // Build provider-specific request\n        const { headers, body } = buildRerankRequest(\n          provider,\n          this.config.rerankApiKey,\n          model,\n          query,\n          documents,\n          results.length,\n        );\n\n        // Timeout: 5 seconds to prevent stalling retrieval pipeline\n        const controller = new AbortController();\n        const timeout = setTimeout(() => controller.abort(), 5000);\n\n        const response = await fetch(endpoint, {\n          method: \"POST\",\n          headers,\n          body: JSON.stringify(body),\n          signal: controller.signal,\n        });\n\n        clearTimeout(timeout);\n\n        if (response.ok) {\n          const data = (await response.json()) as Record<string, unknown>;\n\n          // Parse provider-specific response into unified format\n          const parsed = parseRerankResponse(provider, data);\n\n          if (!parsed) {\n            log.warn(\n              \"Rerank API: invalid response shape, falling back to cosine\",\n            );\n          } else {\n            // Build a Set of returned indices to identify unreturned candidates\n            const returnedIndices = new Set(parsed.map((r) => r.index));\n\n            const reranked = parsed\n              .filter((item) => item.index >= 0 && item.index < results.length)\n              .map((item) => {\n                const original = results[item.index];\n                const floor = this.getRerankPreservationFloor(original, false);\n                // Blend: 60% cross-encoder score + 40% original fused score\n                const blendedScore = clamp01WithFloor(\n                  item.score * 0.6 + original.score * 0.4,\n                  floor,\n                );\n                return {\n                  ...original,\n                  score: blendedScore,\n                  sources: {\n                    ...original.sources,\n                    reranked: { score: item.score },\n                  },\n                };\n              });\n\n            // Keep unreturned candidates with their original scores (slightly penalized)\n            const unreturned = results\n              .filter((_, idx) => !returnedIndices.has(idx))\n              .map(r => ({\n                ...r,\n                score: clamp01WithFloor(\n                  r.score * 0.8,\n                  this.getRerankPreservationFloor(r, true),\n                ),\n              }));\n\n            return [...reranked, ...unreturned].sort(\n              (a, b) => b.score - a.score,\n            );\n          }\n        } else {\n          const errText = await response.text().catch(() => \"\");\n          log.warn(\n            `Rerank API returned ${response.status}: ${errText.slice(0, 200)}, falling back to cosine`,\n          );\n        }\n      } catch (error) {\n        if (error instanceof Error && error.name === \"AbortError\") {\n          log.warn(\"Rerank API timed out (5s), falling back to cosine\");\n        } else {\n          log.warn(\"Rerank API failed, falling back to cosine:\", error);\n        }\n      }\n    }\n\n    // Fallback: lightweight cosine similarity rerank\n    try {\n      const reranked = results.map((result) => {\n        const cosineScore = cosineSimilarity(queryVector, result.entry.vector);\n        const combinedScore = result.score * 0.7 + cosineScore * 0.3;\n\n        return {\n          ...result,\n          score: clamp01(combinedScore, result.score),\n          sources: {\n            ...result.sources,\n            reranked: { score: cosineScore },\n          },\n        };\n      });\n\n      return reranked.sort((a, b) => b.score - a.score);\n    } catch (error) {\n      log.warn(\"Reranking failed, returning original results:\", error);\n      return results;\n    }\n  }\n\n  private getRerankPreservationFloor(result: RetrievalResult, unreturned: boolean): number {\n    const bm25Score = result.sources.bm25?.score ?? 0;\n\n    // Exact lexical hits (IDs, env vars, ticket numbers) should not disappear\n    // just because a reranker under-scores symbolic or mixed-language queries.\n    if (bm25Score >= 0.75) {\n      return result.score * (unreturned ? 1.0 : 0.95);\n    }\n    if (bm25Score >= 0.6) {\n      return result.score * (unreturned ? 0.95 : 0.9);\n    }\n    return result.score * (unreturned ? 0.8 : 0.5);\n  }\n\n  /**\n   * Apply recency boost: newer memories get a small score bonus.\n   * This ensures corrections/updates naturally outrank older entries\n   * when semantic similarity is close.\n   * Formula: boost = exp(-ageDays / halfLife) * weight\n   */\n  private applyRecencyBoost(results: RetrievalResult[]): RetrievalResult[] {\n    const { recencyHalfLifeDays, recencyWeight } = this.config;\n    if (!recencyHalfLifeDays || recencyHalfLifeDays <= 0 || !recencyWeight) {\n      return results;\n    }\n\n    const now = Date.now();\n    const boosted = results.map((r) => {\n      const ts =\n        r.entry.timestamp && r.entry.timestamp > 0 ? r.entry.timestamp : now;\n      const ageDays = (now - ts) / 86_400_000;\n      const boost = Math.exp(-ageDays / recencyHalfLifeDays) * recencyWeight;\n      return {\n        ...r,\n        score: clamp01(r.score + boost, r.score),\n      };\n    });\n\n    return boosted.sort((a, b) => b.score - a.score);\n  }\n\n  /**\n   * Apply importance weighting: memories with higher importance get a score boost.\n   * This ensures critical memories (importance=1.0) outrank casual ones (importance=0.5)\n   * when semantic similarity is close.\n   * Formula: score *= (baseWeight + (1 - baseWeight) * importance)\n   * With baseWeight=0.7: importance=1.0 \u2192 \u00D71.0, importance=0.5 \u2192 \u00D70.85, importance=0.0 \u2192 \u00D70.7\n   */\n  private applyImportanceWeight(results: RetrievalResult[]): RetrievalResult[] {\n    const baseWeight = 0.7;\n    const weighted = results.map((r) => {\n      const importance = r.entry.importance ?? 0.7;\n      const factor = baseWeight + (1 - baseWeight) * importance;\n      return {\n        ...r,\n        score: clamp01(r.score * factor, r.score * baseWeight),\n      };\n    });\n    return weighted.sort((a, b) => b.score - a.score);\n  }\n\n  private applyDecayBoost(results: RetrievalResult[]): RetrievalResult[] {\n    if (!this.decayEngine || results.length === 0) return results;\n\n    const scored = results.map((result) => ({\n      memory: toLifecycleMemory(result.entry.id, result.entry),\n      score: result.score,\n    }));\n\n    this.decayEngine.applySearchBoost(scored);\n\n    const reranked = results.map((result, index) => ({\n      ...result,\n      score: clamp01(scored[index].score, result.score * 0.3),\n    }));\n\n    return reranked.sort((a, b) => b.score - a.score);\n  }\n\n  /**\n   * Detect multi-hop queries that involve multiple entities or relationships.\n   * Multi-hop queries benefit from LanceDB secondary retrieval rather than\n   * Graphiti spread (which follows single-entity neighborhoods).\n   */\n  private isMultiHopQuery(query: string): boolean {\n    // Count distinct capitalized words (potential entity names, >= 2 chars)\n    const capitalizedWords = new Set(\n      (query.match(/\\b[A-Z\\u4e00-\\u9fff][a-zA-Z\\u4e00-\\u9fff]{1,}/g) || [])\n    );\n    if (capitalizedWords.size >= 2) return true;\n\n    // Relationship / comparison patterns\n    const relationPatterns = [\n      /\u548C.{1,20}\u7684\u5173\u7CFB/,\n      /compared\\s+to/i,\n      /difference\\s+between/i,\n      /\u4E3A\u4EC0\u4E48/,\n      /how\\s+does\\s+.{1,30}\\s+relate\\s+to/i,\n      /between\\s+.{1,30}\\s+and\\s+/i,\n      /\u76F8\u6BD4/,\n      /\u533A\u522B/,\n      /\u4E4B\u95F4/,\n    ];\n    for (const pat of relationPatterns) {\n      if (pat.test(query)) return true;\n    }\n\n    // Long query with question mark\n    if (query.length > 100 && /[?\uFF1F]/.test(query)) return true;\n\n    return false;\n  }\n\n  /**\n   * via sheer keyword density and broad semantic coverage.\n   * Short, focused entries (< anchor) get a slight boost.\n   * Long, sprawling entries (> anchor) get penalized.\n   * Formula: score *= 1 / (1 + log2(charLen / anchor))\n   */\n  private applyLengthNormalization(\n    results: RetrievalResult[],\n  ): RetrievalResult[] {\n    const anchor = this.config.lengthNormAnchor;\n    if (!anchor || anchor <= 0) return results;\n\n    const normalized = results.map((r) => {\n      const charLen = r.entry.text.length;\n      const ratio = charLen / anchor;\n      // No penalty for entries at or below anchor length.\n      // Gentle logarithmic decay for longer entries:\n      //   anchor (500) \u2192 1.0, 800 \u2192 0.75, 1000 \u2192 0.67, 1500 \u2192 0.56, 2000 \u2192 0.50\n      // This prevents long, keyword-rich entries from dominating top-k\n      // while keeping their scores reasonable.\n      const logRatio = Math.log2(Math.max(ratio, 1)); // no boost for short entries\n      const factor = 1 / (1 + 0.5 * logRatio);\n      return {\n        ...r,\n        score: clamp01(r.score * factor, r.score * 0.3),\n      };\n    });\n\n    return normalized.sort((a, b) => b.score - a.score);\n  }\n\n  /**\n   * Time decay: multiplicative penalty for old entries.\n   * Unlike recencyBoost (additive bonus for new entries), this actively\n   * penalizes stale information so recent knowledge wins ties.\n   * Formula: score *= 0.5 + 0.5 * exp(-ageDays / halfLife)\n   * At 0 days: 1.0x (no penalty)\n   * At halfLife: ~0.68x\n   * At 2*halfLife: ~0.59x\n   * Floor at 0.5x (never penalize more than half)\n   */\n  private applyTimeDecay(results: RetrievalResult[]): RetrievalResult[] {\n    const halfLife = this.config.timeDecayHalfLifeDays;\n    if (!halfLife || halfLife <= 0) return results;\n\n    const now = Date.now();\n    const decayed = results.map((r) => {\n      const ts =\n        r.entry.timestamp && r.entry.timestamp > 0 ? r.entry.timestamp : now;\n      const ageDays = (now - ts) / 86_400_000;\n\n      // Access reinforcement: frequently recalled memories decay slower\n      const { accessCount, lastAccessedAt } = parseAccessMetadata(\n        r.entry.metadata,\n      );\n      const effectiveHL = computeEffectiveHalfLife(\n        halfLife,\n        accessCount,\n        lastAccessedAt,\n        this.config.reinforcementFactor,\n        this.config.maxHalfLifeMultiplier,\n      );\n\n      // floor at 0.5: even very old entries keep at least 50% of their score\n      const factor = 0.5 + 0.5 * Math.exp(-ageDays / effectiveHL);\n      return {\n        ...r,\n        score: clamp01(r.score * factor, r.score * 0.5),\n      };\n    });\n\n    return decayed.sort((a, b) => b.score - a.score);\n  }\n\n  /**\n   * Apply lifecycle-aware score adjustment (decay + tier floors).\n   *\n   * This is intentionally lightweight:\n   * - reads tier/access metadata (if any)\n   * - multiplies scores by max(tierFloor, decayComposite)\n   */\n  private applyLifecycleBoost(results: RetrievalResult[]): RetrievalResult[] {\n    if (!this.decayEngine) return results;\n\n    const now = Date.now();\n    const pairs = results.map(r => {\n      const { memory } = getDecayableFromEntry(r.entry);\n      return { r, memory };\n    });\n\n    const scored = pairs.map(p => ({ memory: p.memory, score: p.r.score }));\n    this.decayEngine.applySearchBoost(scored, now);\n\n    const boosted = pairs.map((p, i) => ({ ...p.r, score: scored[i].score }));\n    return boosted.sort((a, b) => b.score - a.score);\n  }\n\n  /**\n   * Record access stats (access_count, last_accessed_at) and apply tier\n   * promotion/demotion for a small number of top results.\n   *\n   * Note: this writes back to LanceDB via delete+readd; keep it bounded.\n   */\n  private async recordAccessAndMaybeTransition(results: RetrievalResult[]): Promise<void> {\n    if (!this.decayEngine && !this.tierManager) return;\n\n    const now = Date.now();\n    const toUpdate = results.slice(0, 3);\n\n    for (const r of toUpdate) {\n      const { memory, meta } = getDecayableFromEntry(r.entry);\n\n      // Update access stats in-memory first\n      const nextAccess = memory.accessCount + 1;\n      meta.access_count = nextAccess;\n      meta.last_accessed_at = now;\n      if (meta.created_at === undefined && meta.createdAt === undefined) {\n        meta.created_at = memory.createdAt;\n      }\n      if (meta.tier === undefined) {\n        meta.tier = memory.tier;\n      }\n      if (meta.confidence === undefined) {\n        meta.confidence = memory.confidence;\n      }\n\n      const updatedMemory: DecayableMemory = {\n        ...memory,\n        accessCount: nextAccess,\n        lastAccessedAt: now,\n      };\n\n      // Tier transition (optional)\n      if (this.decayEngine && this.tierManager) {\n        const ds = this.decayEngine.score(updatedMemory, now);\n        const transition = this.tierManager.evaluate(updatedMemory, ds, now);\n        if (transition) {\n          meta.tier = transition.toTier;\n        }\n      }\n\n      try {\n        await this.store.update(r.entry.id, {\n          metadata: JSON.stringify(meta),\n        });\n      } catch {\n        // best-effort: ignore\n      }\n    }\n  }\n\n  /**\n   * MMR-inspired diversity filter: greedily select results that are both\n   * relevant (high score) and diverse (low similarity to already-selected).\n   *\n   * Uses cosine similarity between memory vectors. If two memories have\n   * cosine similarity > threshold (default 0.92), the lower-scored one\n   * is demoted to the end rather than removed entirely.\n   *\n   * This prevents top-k from being filled with near-identical entries\n   * (e.g. 3 similar \"SVG style\" memories) while keeping them available\n   * if the pool is small.\n   */\n  private applyMMRDiversity(\n    results: RetrievalResult[],\n    similarityThreshold = 0.85,\n  ): RetrievalResult[] {\n    if (results.length <= 1) return results;\n\n    const selected: RetrievalResult[] = [];\n    const deferred: RetrievalResult[] = [];\n\n    for (const candidate of results) {\n      // Check if this candidate is too similar to any already-selected result\n      const tooSimilar = selected.some((s) => {\n        // Both must have vectors to compare.\n        // LanceDB returns Arrow Vector objects (not plain arrays),\n        // so use .length directly and Array.from() for conversion.\n        const sVec = s.entry.vector;\n        const cVec = candidate.entry.vector;\n        if (!sVec?.length || !cVec?.length) return false;\n        const sArr = Array.from(sVec as Iterable<number>);\n        const cArr = Array.from(cVec as Iterable<number>);\n        const sim = cosineSimilarity(sArr, cArr);\n        return sim > similarityThreshold;\n      });\n\n      if (tooSimilar) {\n        deferred.push(candidate);\n      } else {\n        selected.push(candidate);\n      }\n    }\n    // Append deferred results at the end (available but deprioritized)\n    return [...selected, ...deferred];\n  }\n\n  // Update configuration\n  updateConfig(newConfig: Partial<RetrievalConfig>): void {\n    this.config = { ...this.config, ...newConfig };\n  }\n\n  // Get current configuration\n  getConfig(): RetrievalConfig {\n    return { ...this.config };\n  }\n\n  // Test retrieval system\n  async test(query = \"test query\"): Promise<{\n    success: boolean;\n    mode: string;\n    hasFtsSupport: boolean;\n    error?: string;\n  }> {\n    try {\n      const results = await this.retrieve({\n        query,\n        limit: 1,\n      });\n\n      return {\n        success: true,\n        mode: this.config.mode,\n        hasFtsSupport: this.store.hasFtsSupport,\n      };\n    } catch (error) {\n      return {\n        success: false,\n        mode: this.config.mode,\n        hasFtsSupport: this.store.hasFtsSupport,\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n}\n\n// ============================================================================\n// Factory Function\n// ============================================================================\n\nexport interface RetrieverLifecycleOptions {\n  decayEngine?: DecayEngine;\n  tierManager?: TierManager;\n}\n\nexport function createRetriever(\n  store: MemoryStore,\n  embedder: Embedder,\n  config?: Partial<RetrievalConfig>,\n  options?: { decayEngine?: DecayEngine | null },\n): MemoryRetriever {\n  const fullConfig = { ...DEFAULT_RETRIEVAL_CONFIG, ...config };\n  return new MemoryRetriever(store, embedder, fullConfig, options?.decayEngine ?? null);\n}\n"],
+  "mappings": "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",
+  "names": ["trackEntry"]
+}

package/dist/src/scopes.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Multi-Scope Access Control System
+ * Manages memory isolation and access permissions
+ */
+export interface ScopeDefinition {
+    description: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ScopeConfig {
+    default: string;
+    definitions: Record<string, ScopeDefinition>;
+    agentAccess: Record<string, string[]>;
+}
+export interface ScopeManager {
+    getAccessibleScopes(agentId?: string): string[];
+    getDefaultScope(agentId?: string): string;
+    isAccessible(scope: string, agentId?: string): boolean;
+    validateScope(scope: string): boolean;
+    getAllScopes(): string[];
+    getScopeDefinition(scope: string): ScopeDefinition | undefined;
+}
+export declare const DEFAULT_SCOPE_CONFIG: ScopeConfig;
+export declare class MemoryScopeManager implements ScopeManager {
+    private config;
+    constructor(config?: Partial<ScopeConfig>);
+    private validateConfiguration;
+    private isBuiltInScope;
+    getAccessibleScopes(agentId?: string): string[];
+    getDefaultScope(agentId?: string): string;
+    isAccessible(scope: string, agentId?: string): boolean;
+    validateScope(scope: string): boolean;
+    getAllScopes(): string[];
+    getScopeDefinition(scope: string): ScopeDefinition | undefined;
+    addScopeDefinition(scope: string, definition: ScopeDefinition): void;
+    removeScopeDefinition(scope: string): boolean;
+    setAgentAccess(agentId: string, scopes: string[]): void;
+    removeAgentAccess(agentId: string): boolean;
+    private validateScopeFormat;
+    exportConfig(): ScopeConfig;
+    importConfig(config: Partial<ScopeConfig>): void;
+    getStats(): {
+        totalScopes: number;
+        agentsWithCustomAccess: number;
+        scopesByType: Record<string, number>;
+    };
+}
+export declare function createScopeManager(config?: Partial<ScopeConfig>): MemoryScopeManager;
+export declare function createAgentScope(agentId: string): string;
+export declare function createCustomScope(name: string): string;
+export declare function createProjectScope(projectId: string): string;
+export declare function createUserScope(userId: string): string;
+export declare function parseScopeId(scope: string): {
+    type: string;
+    id: string;
+} | null;
+export declare function isScopeAccessible(scope: string, allowedScopes: string[]): boolean;
+export declare function filterScopesForAgent(scopes: string[], agentId?: string, scopeManager?: ScopeManager): string[];
+//# sourceMappingURL=scopes.d.ts.map

package/dist/src/scopes.d.ts.map

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

package/dist/src/scopes.js

@@ -0,0 +1,252 @@
+import { log } from "./logger.js";
+const DEFAULT_SCOPE_CONFIG = {
+  default: "global",
+  definitions: {
+    global: {
+      description: "Shared knowledge across all agents"
+    }
+  },
+  agentAccess: {}
+};
+const SCOPE_PATTERNS = {
+  GLOBAL: "global",
+  AGENT: (agentId) => `agent:${agentId}`,
+  CUSTOM: (name) => `custom:${name}`,
+  PROJECT: (projectId) => `project:${projectId}`,
+  USER: (userId) => `user:${userId}`
+};
+class MemoryScopeManager {
+  config;
+  constructor(config = {}) {
+    this.config = {
+      default: config.default || DEFAULT_SCOPE_CONFIG.default,
+      definitions: {
+        ...DEFAULT_SCOPE_CONFIG.definitions,
+        ...config.definitions
+      },
+      agentAccess: {
+        ...DEFAULT_SCOPE_CONFIG.agentAccess,
+        ...config.agentAccess
+      }
+    };
+    if (!this.config.definitions.global) {
+      this.config.definitions.global = {
+        description: "Shared knowledge across all agents"
+      };
+    }
+    this.validateConfiguration();
+  }
+  validateConfiguration() {
+    if (!this.config.definitions[this.config.default]) {
+      throw new Error(`Default scope '${this.config.default}' not found in definitions`);
+    }
+    for (const [agentId, scopes] of Object.entries(this.config.agentAccess)) {
+      for (const scope of scopes) {
+        if (!this.config.definitions[scope] && !this.isBuiltInScope(scope)) {
+          log.warn(`Agent '${agentId}' has access to undefined scope '${scope}'`);
+        }
+      }
+    }
+  }
+  isBuiltInScope(scope) {
+    return scope === "global" || scope.startsWith("agent:") || scope.startsWith("custom:") || scope.startsWith("project:") || scope.startsWith("user:");
+  }
+  getAccessibleScopes(agentId) {
+    if (!agentId) {
+      return this.getAllScopes();
+    }
+    const explicitAccess = this.config.agentAccess[agentId];
+    if (explicitAccess) {
+      return explicitAccess;
+    }
+    const defaultScopes = ["global"];
+    const agentScope = SCOPE_PATTERNS.AGENT(agentId);
+    if (this.config.definitions[agentScope] || this.isBuiltInScope(agentScope)) {
+      defaultScopes.push(agentScope);
+    }
+    return defaultScopes;
+  }
+  getDefaultScope(agentId) {
+    if (!agentId) {
+      return this.config.default;
+    }
+    const agentScope = SCOPE_PATTERNS.AGENT(agentId);
+    const accessibleScopes = this.getAccessibleScopes(agentId);
+    if (accessibleScopes.includes(agentScope)) {
+      return agentScope;
+    }
+    return this.config.default;
+  }
+  isAccessible(scope, agentId) {
+    if (!agentId) {
+      return this.validateScope(scope);
+    }
+    const accessibleScopes = this.getAccessibleScopes(agentId);
+    return accessibleScopes.includes(scope);
+  }
+  validateScope(scope) {
+    if (!scope || typeof scope !== "string" || scope.trim().length === 0) {
+      return false;
+    }
+    const trimmedScope = scope.trim();
+    return this.config.definitions[trimmedScope] !== void 0 || this.isBuiltInScope(trimmedScope);
+  }
+  getAllScopes() {
+    return Object.keys(this.config.definitions);
+  }
+  getScopeDefinition(scope) {
+    return this.config.definitions[scope];
+  }
+  // Management methods
+  addScopeDefinition(scope, definition) {
+    if (!this.validateScopeFormat(scope)) {
+      throw new Error(`Invalid scope format: ${scope}`);
+    }
+    this.config.definitions[scope] = definition;
+  }
+  removeScopeDefinition(scope) {
+    if (scope === "global") {
+      throw new Error("Cannot remove global scope");
+    }
+    if (!this.config.definitions[scope]) {
+      return false;
+    }
+    delete this.config.definitions[scope];
+    for (const [agentId, scopes] of Object.entries(this.config.agentAccess)) {
+      const filtered = scopes.filter((s) => s !== scope);
+      if (filtered.length !== scopes.length) {
+        this.config.agentAccess[agentId] = filtered;
+      }
+    }
+    return true;
+  }
+  setAgentAccess(agentId, scopes) {
+    if (!agentId || typeof agentId !== "string") {
+      throw new Error("Invalid agent ID");
+    }
+    for (const scope of scopes) {
+      if (!this.validateScope(scope)) {
+        throw new Error(`Invalid scope: ${scope}`);
+      }
+    }
+    this.config.agentAccess[agentId] = [...scopes];
+  }
+  removeAgentAccess(agentId) {
+    if (!this.config.agentAccess[agentId]) {
+      return false;
+    }
+    delete this.config.agentAccess[agentId];
+    return true;
+  }
+  validateScopeFormat(scope) {
+    if (!scope || typeof scope !== "string") {
+      return false;
+    }
+    const trimmed = scope.trim();
+    if (trimmed.length === 0 || trimmed.length > 100) {
+      return false;
+    }
+    const validFormat = /^[a-zA-Z0-9._:-]+$/.test(trimmed);
+    return validFormat;
+  }
+  // Export/Import configuration
+  exportConfig() {
+    return JSON.parse(JSON.stringify(this.config));
+  }
+  importConfig(config) {
+    this.config = {
+      default: config.default || this.config.default,
+      definitions: {
+        ...this.config.definitions,
+        ...config.definitions
+      },
+      agentAccess: {
+        ...this.config.agentAccess,
+        ...config.agentAccess
+      }
+    };
+    this.validateConfiguration();
+  }
+  // Statistics
+  getStats() {
+    const scopes = this.getAllScopes();
+    const scopesByType = {
+      global: 0,
+      agent: 0,
+      custom: 0,
+      project: 0,
+      user: 0,
+      other: 0
+    };
+    for (const scope of scopes) {
+      if (scope === "global") {
+        scopesByType.global++;
+      } else if (scope.startsWith("agent:")) {
+        scopesByType.agent++;
+      } else if (scope.startsWith("custom:")) {
+        scopesByType.custom++;
+      } else if (scope.startsWith("project:")) {
+        scopesByType.project++;
+      } else if (scope.startsWith("user:")) {
+        scopesByType.user++;
+      } else {
+        scopesByType.other++;
+      }
+    }
+    return {
+      totalScopes: scopes.length,
+      agentsWithCustomAccess: Object.keys(this.config.agentAccess).length,
+      scopesByType
+    };
+  }
+}
+function createScopeManager(config) {
+  return new MemoryScopeManager(config);
+}
+function createAgentScope(agentId) {
+  return SCOPE_PATTERNS.AGENT(agentId);
+}
+function createCustomScope(name) {
+  return SCOPE_PATTERNS.CUSTOM(name);
+}
+function createProjectScope(projectId) {
+  return SCOPE_PATTERNS.PROJECT(projectId);
+}
+function createUserScope(userId) {
+  return SCOPE_PATTERNS.USER(userId);
+}
+function parseScopeId(scope) {
+  if (scope === "global") {
+    return { type: "global", id: "" };
+  }
+  const colonIndex = scope.indexOf(":");
+  if (colonIndex === -1) {
+    return null;
+  }
+  return {
+    type: scope.substring(0, colonIndex),
+    id: scope.substring(colonIndex + 1)
+  };
+}
+function isScopeAccessible(scope, allowedScopes) {
+  return allowedScopes.includes(scope);
+}
+function filterScopesForAgent(scopes, agentId, scopeManager) {
+  if (!scopeManager || !agentId) {
+    return scopes;
+  }
+  return scopes.filter((scope) => scopeManager.isAccessible(scope, agentId));
+}
+export {
+  DEFAULT_SCOPE_CONFIG,
+  MemoryScopeManager,
+  createAgentScope,
+  createCustomScope,
+  createProjectScope,
+  createScopeManager,
+  createUserScope,
+  filterScopesForAgent,
+  isScopeAccessible,
+  parseScopeId
+};
+//# sourceMappingURL=scopes.js.map

package/dist/src/scopes.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/scopes.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: MIT\n/**\n * Multi-Scope Access Control System\n * Manages memory isolation and access permissions\n */\n\nimport { log } from \"./logger.js\";\n\n// ============================================================================\n// Types & Configuration\n// ============================================================================\n\nexport interface ScopeDefinition {\n  description: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface ScopeConfig {\n  default: string;\n  definitions: Record<string, ScopeDefinition>;\n  agentAccess: Record<string, string[]>;\n}\n\nexport interface ScopeManager {\n  getAccessibleScopes(agentId?: string): string[];\n  getDefaultScope(agentId?: string): string;\n  isAccessible(scope: string, agentId?: string): boolean;\n  validateScope(scope: string): boolean;\n  getAllScopes(): string[];\n  getScopeDefinition(scope: string): ScopeDefinition | undefined;\n}\n\n// ============================================================================\n// Default Configuration\n// ============================================================================\n\nexport const DEFAULT_SCOPE_CONFIG: ScopeConfig = {\n  default: \"global\",\n  definitions: {\n    global: {\n      description: \"Shared knowledge across all agents\",\n    },\n  },\n  agentAccess: {},\n};\n\n// ============================================================================\n// Built-in Scope Patterns\n// ============================================================================\n\nconst SCOPE_PATTERNS = {\n  GLOBAL: \"global\",\n  AGENT: (agentId: string) => `agent:${agentId}`,\n  CUSTOM: (name: string) => `custom:${name}`,\n  PROJECT: (projectId: string) => `project:${projectId}`,\n  USER: (userId: string) => `user:${userId}`,\n};\n\n// ============================================================================\n// Scope Manager Implementation\n// ============================================================================\n\nexport class MemoryScopeManager implements ScopeManager {\n  private config: ScopeConfig;\n\n  constructor(config: Partial<ScopeConfig> = {}) {\n    this.config = {\n      default: config.default || DEFAULT_SCOPE_CONFIG.default,\n      definitions: {\n        ...DEFAULT_SCOPE_CONFIG.definitions,\n        ...config.definitions,\n      },\n      agentAccess: {\n        ...DEFAULT_SCOPE_CONFIG.agentAccess,\n        ...config.agentAccess,\n      },\n    };\n\n    // Ensure global scope always exists\n    if (!this.config.definitions.global) {\n      this.config.definitions.global = {\n        description: \"Shared knowledge across all agents\",\n      };\n    }\n\n    this.validateConfiguration();\n  }\n\n  private validateConfiguration(): void {\n    // Validate default scope exists in definitions\n    if (!this.config.definitions[this.config.default]) {\n      throw new Error(`Default scope '${this.config.default}' not found in definitions`);\n    }\n\n    // Validate agent access scopes exist in definitions\n    for (const [agentId, scopes] of Object.entries(this.config.agentAccess)) {\n      for (const scope of scopes) {\n        if (!this.config.definitions[scope] && !this.isBuiltInScope(scope)) {\n          log.warn(`Agent '${agentId}' has access to undefined scope '${scope}'`);\n        }\n      }\n    }\n  }\n\n  private isBuiltInScope(scope: string): boolean {\n    return (\n      scope === \"global\" ||\n      scope.startsWith(\"agent:\") ||\n      scope.startsWith(\"custom:\") ||\n      scope.startsWith(\"project:\") ||\n      scope.startsWith(\"user:\")\n    );\n  }\n\n  getAccessibleScopes(agentId?: string): string[] {\n    if (!agentId) {\n      // No agent specified, return all scopes\n      return this.getAllScopes();\n    }\n\n    // Check explicit agent access configuration\n    const explicitAccess = this.config.agentAccess[agentId];\n    if (explicitAccess) {\n      return explicitAccess;\n    }\n\n    // Default access: global + agent-specific scope\n    const defaultScopes = [\"global\"];\n    const agentScope = SCOPE_PATTERNS.AGENT(agentId);\n\n    // Only include agent scope if it already exists \u2014 don't mutate config as a side effect\n    if (this.config.definitions[agentScope] || this.isBuiltInScope(agentScope)) {\n      defaultScopes.push(agentScope);\n    }\n\n    return defaultScopes;\n  }\n\n  getDefaultScope(agentId?: string): string {\n    if (!agentId) {\n      return this.config.default;\n    }\n\n    // For agents, default to their private scope if they have access to it\n    const agentScope = SCOPE_PATTERNS.AGENT(agentId);\n    const accessibleScopes = this.getAccessibleScopes(agentId);\n\n    if (accessibleScopes.includes(agentScope)) {\n      return agentScope;\n    }\n\n    return this.config.default;\n  }\n\n  isAccessible(scope: string, agentId?: string): boolean {\n    if (!agentId) {\n      // No agent specified, allow access to all valid scopes\n      return this.validateScope(scope);\n    }\n\n    const accessibleScopes = this.getAccessibleScopes(agentId);\n    return accessibleScopes.includes(scope);\n  }\n\n  validateScope(scope: string): boolean {\n    if (!scope || typeof scope !== \"string\" || scope.trim().length === 0) {\n      return false;\n    }\n\n    const trimmedScope = scope.trim();\n\n    // Check if scope is defined or is a built-in pattern\n    return (\n      this.config.definitions[trimmedScope] !== undefined ||\n      this.isBuiltInScope(trimmedScope)\n    );\n  }\n\n  getAllScopes(): string[] {\n    return Object.keys(this.config.definitions);\n  }\n\n  getScopeDefinition(scope: string): ScopeDefinition | undefined {\n    return this.config.definitions[scope];\n  }\n\n  // Management methods\n\n  addScopeDefinition(scope: string, definition: ScopeDefinition): void {\n    if (!this.validateScopeFormat(scope)) {\n      throw new Error(`Invalid scope format: ${scope}`);\n    }\n\n    this.config.definitions[scope] = definition;\n  }\n\n  removeScopeDefinition(scope: string): boolean {\n    if (scope === \"global\") {\n      throw new Error(\"Cannot remove global scope\");\n    }\n\n    if (!this.config.definitions[scope]) {\n      return false;\n    }\n\n    delete this.config.definitions[scope];\n\n    // Clean up agent access references\n    for (const [agentId, scopes] of Object.entries(this.config.agentAccess)) {\n      const filtered = scopes.filter(s => s !== scope);\n      if (filtered.length !== scopes.length) {\n        this.config.agentAccess[agentId] = filtered;\n      }\n    }\n\n    return true;\n  }\n\n  setAgentAccess(agentId: string, scopes: string[]): void {\n    if (!agentId || typeof agentId !== \"string\") {\n      throw new Error(\"Invalid agent ID\");\n    }\n\n    // Validate all scopes\n    for (const scope of scopes) {\n      if (!this.validateScope(scope)) {\n        throw new Error(`Invalid scope: ${scope}`);\n      }\n    }\n\n    this.config.agentAccess[agentId] = [...scopes];\n  }\n\n  removeAgentAccess(agentId: string): boolean {\n    if (!this.config.agentAccess[agentId]) {\n      return false;\n    }\n\n    delete this.config.agentAccess[agentId];\n    return true;\n  }\n\n  private validateScopeFormat(scope: string): boolean {\n    if (!scope || typeof scope !== \"string\") {\n      return false;\n    }\n\n    const trimmed = scope.trim();\n\n    // Basic format validation\n    if (trimmed.length === 0 || trimmed.length > 100) {\n      return false;\n    }\n\n    // Allow alphanumeric, hyphens, underscores, colons, and dots\n    const validFormat = /^[a-zA-Z0-9._:-]+$/.test(trimmed);\n    return validFormat;\n  }\n\n  // Export/Import configuration\n\n  exportConfig(): ScopeConfig {\n    return JSON.parse(JSON.stringify(this.config));\n  }\n\n  importConfig(config: Partial<ScopeConfig>): void {\n    this.config = {\n      default: config.default || this.config.default,\n      definitions: {\n        ...this.config.definitions,\n        ...config.definitions,\n      },\n      agentAccess: {\n        ...this.config.agentAccess,\n        ...config.agentAccess,\n      },\n    };\n\n    this.validateConfiguration();\n  }\n\n  // Statistics\n\n  getStats(): {\n    totalScopes: number;\n    agentsWithCustomAccess: number;\n    scopesByType: Record<string, number>;\n  } {\n    const scopes = this.getAllScopes();\n    const scopesByType: Record<string, number> = {\n      global: 0,\n      agent: 0,\n      custom: 0,\n      project: 0,\n      user: 0,\n      other: 0,\n    };\n\n    for (const scope of scopes) {\n      if (scope === \"global\") {\n        scopesByType.global++;\n      } else if (scope.startsWith(\"agent:\")) {\n        scopesByType.agent++;\n      } else if (scope.startsWith(\"custom:\")) {\n        scopesByType.custom++;\n      } else if (scope.startsWith(\"project:\")) {\n        scopesByType.project++;\n      } else if (scope.startsWith(\"user:\")) {\n        scopesByType.user++;\n      } else {\n        scopesByType.other++;\n      }\n    }\n\n    return {\n      totalScopes: scopes.length,\n      agentsWithCustomAccess: Object.keys(this.config.agentAccess).length,\n      scopesByType,\n    };\n  }\n}\n\n// ============================================================================\n// Factory Functions\n// ============================================================================\n\nexport function createScopeManager(config?: Partial<ScopeConfig>): MemoryScopeManager {\n  return new MemoryScopeManager(config);\n}\n\nexport function createAgentScope(agentId: string): string {\n  return SCOPE_PATTERNS.AGENT(agentId);\n}\n\nexport function createCustomScope(name: string): string {\n  return SCOPE_PATTERNS.CUSTOM(name);\n}\n\nexport function createProjectScope(projectId: string): string {\n  return SCOPE_PATTERNS.PROJECT(projectId);\n}\n\nexport function createUserScope(userId: string): string {\n  return SCOPE_PATTERNS.USER(userId);\n}\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\nexport function parseScopeId(scope: string): { type: string; id: string } | null {\n  if (scope === \"global\") {\n    return { type: \"global\", id: \"\" };\n  }\n\n  const colonIndex = scope.indexOf(\":\");\n  if (colonIndex === -1) {\n    return null;\n  }\n\n  return {\n    type: scope.substring(0, colonIndex),\n    id: scope.substring(colonIndex + 1),\n  };\n}\n\nexport function isScopeAccessible(scope: string, allowedScopes: string[]): boolean {\n  return allowedScopes.includes(scope);\n}\n\nexport function filterScopesForAgent(scopes: string[], agentId?: string, scopeManager?: ScopeManager): string[] {\n  if (!scopeManager || !agentId) {\n    return scopes;\n  }\n\n  return scopes.filter(scope => scopeManager.isAccessible(scope, agentId));\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/self-improvement-files.d.ts

@@ -0,0 +1,20 @@
+export declare const DEFAULT_LEARNINGS_TEMPLATE = "# Learnings\n\nAppend structured entries:\n- LRN-YYYYMMDD-XXX for corrections / best practices / knowledge gaps\n- Include summary, details, suggested action, metadata, and status";
+export declare const DEFAULT_ERRORS_TEMPLATE = "# Errors\n\nAppend structured entries:\n- ERR-YYYYMMDD-XXX for command/tool/integration failures\n- Include symptom, context, probable cause, and prevention";
+export declare function ensureSelfImprovementLearningFiles(baseDir: string): Promise<void>;
+export interface AppendSelfImprovementEntryParams {
+    baseDir: string;
+    type: "learning" | "error";
+    summary: string;
+    details?: string;
+    suggestedAction?: string;
+    category?: string;
+    area?: string;
+    priority?: string;
+    status?: string;
+    source?: string;
+}
+export declare function appendSelfImprovementEntry(params: AppendSelfImprovementEntryParams): Promise<{
+    id: string;
+    filePath: string;
+}>;
+//# sourceMappingURL=self-improvement-files.d.ts.map

package/dist/src/self-improvement-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-improvement-files.d.ts","sourceRoot":"","sources":["../../src/self-improvement-files.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,0BAA0B,wLAI4B,CAAC;AAEpE,eAAO,MAAM,uBAAuB,iKAIuB,CAAC;AAyC5D,wBAAsB,kCAAkC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBvF;AAED,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,gCAAgC,GAAG,OAAO,CAAC;IAClG,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAqDD"}