claude-memory-layer 1.0.11 → 1.0.12

package/dist/core/index.js

@@ -487,6 +487,15 @@ var ConsolidatedMemorySchema = z.object({
   accessedAt: z.date().optional(),
   accessCount: z.number().default(0)
 });
+var ConsolidationRuleSchema = z.object({
+  ruleId: z.string(),
+  rule: z.string(),
+  topics: z.array(z.string()),
+  sourceMemoryIds: z.array(z.string()),
+  sourceEvents: z.array(z.string()),
+  confidence: z.number(),
+  createdAt: z.date()
+});
 var TransitionTypeSchema = z.enum(["seamless", "topic_shift", "break"]);
 var ContinuityLogSchema = z.object({
   logId: z.string(),
@@ -639,11 +648,11 @@ function toDate(value) {
     return new Date(value);
   return new Date(String(value));
 }
-function createDatabase(path, options) {
+function createDatabase(path2, options) {
   if (options?.readOnly) {
-    return new duckdb.Database(path, { access_mode: "READ_ONLY" });
+    return new duckdb.Database(path2, { access_mode: "READ_ONLY" });
   }
-  return new duckdb.Database(path);
+  return new duckdb.Database(path2);
 }
 function dbRun(db, sql, params = []) {
   return new Promise((resolve, reject) => {
@@ -907,6 +916,17 @@ var EventStore = class {
         created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
       )
     `);
+    await dbRun(this.db, `
+      CREATE TABLE IF NOT EXISTS consolidated_rules (
+        rule_id VARCHAR PRIMARY KEY,
+        rule TEXT NOT NULL,
+        topics JSON,
+        source_memory_ids JSON,
+        source_events JSON,
+        confidence FLOAT DEFAULT 0.5,
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+      )
+    `);
     await dbRun(this.db, `
       CREATE TABLE IF NOT EXISTS endless_config (
         key VARCHAR PRIMARY KEY,
@@ -926,6 +946,7 @@ var EventStore = class {
     await dbRun(this.db, `CREATE INDEX IF NOT EXISTS idx_working_set_expires ON working_set(expires_at)`);
     await dbRun(this.db, `CREATE INDEX IF NOT EXISTS idx_working_set_relevance ON working_set(relevance_score DESC)`);
     await dbRun(this.db, `CREATE INDEX IF NOT EXISTS idx_consolidated_confidence ON consolidated_memories(confidence DESC)`);
+    await dbRun(this.db, `CREATE INDEX IF NOT EXISTS idx_consolidated_rules_confidence ON consolidated_rules(confidence DESC)`);
     await dbRun(this.db, `CREATE INDEX IF NOT EXISTS idx_continuity_created ON continuity_log(created_at)`);
     this.initialized = true;
   }
@@ -1312,12 +1333,12 @@ var EventStore = class {
 import Database from "better-sqlite3";
 import * as fs from "fs";
 import * as nodePath from "path";
-function createSQLiteDatabase(path, options) {
-  const dir = nodePath.dirname(path);
+function createSQLiteDatabase(path2, options) {
+  const dir = nodePath.dirname(path2);
   if (!fs.existsSync(dir)) {
     fs.mkdirSync(dir, { recursive: true });
   }
-  const db = new Database(path, {
+  const db = new Database(path2, {
     readonly: options?.readonly ?? false
   });
   if (!options?.readonly && (options?.walMode ?? true)) {
@@ -1363,6 +1384,66 @@ function toSQLiteTimestamp(date) {
 
 // src/core/sqlite-event-store.ts
 import { randomUUID as randomUUID2 } from "crypto";
+
+// src/core/markdown-mirror.ts
+import * as fs2 from "fs/promises";
+import * as path from "path";
+var DEFAULT_NAMESPACE = "default";
+var DEFAULT_CATEGORY = "uncategorized";
+function sanitizeSegment(input, fallback) {
+  const raw = String(input ?? "").trim().toLowerCase();
+  const safe = raw.normalize("NFKD").replace(/[^a-z0-9_-]+/g, "-").replace(/^-+|-+$/g, "");
+  if (!safe || safe === "." || safe === "..")
+    return fallback;
+  return safe;
+}
+function getCategorySegments(metadata, eventType) {
+  const raw = metadata?.categoryPath;
+  if (Array.isArray(raw) && raw.length > 0) {
+    return raw.map((s) => sanitizeSegment(s, DEFAULT_CATEGORY));
+  }
+  const single = metadata?.category;
+  if (typeof single === "string" && single.trim()) {
+    return [sanitizeSegment(single, DEFAULT_CATEGORY)];
+  }
+  return [sanitizeSegment(eventType, DEFAULT_CATEGORY)];
+}
+function buildMirrorPath(rootDir, event) {
+  const metadata = event.metadata;
+  const namespace = sanitizeSegment(metadata?.namespace, DEFAULT_NAMESPACE);
+  const categories = getCategorySegments(metadata, event.eventType);
+  const d = event.timestamp;
+  const yyyy = d.getFullYear();
+  const mm = String(d.getMonth() + 1).padStart(2, "0");
+  const dd = String(d.getDate()).padStart(2, "0");
+  return path.join(rootDir, "memory", namespace, ...categories, `${yyyy}-${mm}-${dd}.md`);
+}
+function formatMirrorEntry(event) {
+  const category = Array.isArray(event.metadata?.categoryPath) ? event.metadata.categoryPath.join("/") : String(event.metadata?.category ?? event.eventType);
+  return [
+    "",
+    `- ts: ${event.timestamp.toISOString()}`,
+    `  id: ${event.id}`,
+    `  type: ${event.eventType}`,
+    `  session: ${event.sessionId}`,
+    `  category: ${category}`,
+    "  content: |",
+    ...event.content.split("\n").map((line) => `    ${line}`)
+  ].join("\n") + "\n";
+}
+var MarkdownMirror = class {
+  constructor(rootDir) {
+    this.rootDir = rootDir;
+  }
+  async append(event) {
+    const outPath = buildMirrorPath(this.rootDir, event);
+    await fs2.mkdir(path.dirname(outPath), { recursive: true });
+    await fs2.appendFile(outPath, formatMirrorEntry(event), "utf8");
+    return outPath;
+  }
+};
+
+// src/core/sqlite-event-store.ts
 var SQLiteEventStore = class {
   constructor(dbPath, options) {
     this.dbPath = dbPath;
@@ -1371,10 +1452,12 @@ var SQLiteEventStore = class {
       readonly: this.readOnly,
       walMode: !this.readOnly
     });
+    this.markdownMirror = this.readOnly || !options?.markdownMirrorRoot ? null : new MarkdownMirror(options.markdownMirrorRoot);
   }
   db;
   initialized = false;
   readOnly;
+  markdownMirror;
   /**
    * Initialize database schema
    */
@@ -1581,6 +1664,17 @@ var SQLiteEventStore = class {
         created_at TEXT DEFAULT (datetime('now'))
       );
 
+      -- Consolidated Rules table (long-term stable memory)
+      CREATE TABLE IF NOT EXISTS consolidated_rules (
+        rule_id TEXT PRIMARY KEY,
+        rule TEXT NOT NULL,
+        topics TEXT,
+        source_memory_ids TEXT,
+        source_events TEXT,
+        confidence REAL DEFAULT 0.5,
+        created_at TEXT DEFAULT (datetime('now'))
+      );
+
       -- Endless Mode Config table
       CREATE TABLE IF NOT EXISTS endless_config (
         key TEXT PRIMARY KEY,
@@ -1605,6 +1699,24 @@ var SQLiteEventStore = class {
         measured_at TEXT
       );
 
+      -- Retrieval trace log (query -> candidates -> selected for context)
+      CREATE TABLE IF NOT EXISTS retrieval_traces (
+        trace_id TEXT PRIMARY KEY,
+        session_id TEXT,
+        project_hash TEXT,
+        query_text TEXT NOT NULL,
+        strategy TEXT,
+        candidate_event_ids TEXT,
+        selected_event_ids TEXT,
+        candidate_details_json TEXT,
+        selected_details_json TEXT,
+        candidate_count INTEGER DEFAULT 0,
+        selected_count INTEGER DEFAULT 0,
+        confidence TEXT,
+        fallback_trace TEXT,
+        created_at TEXT DEFAULT (datetime('now'))
+      );
+
       -- Sync position tracking (for SQLite -> DuckDB sync)
       CREATE TABLE IF NOT EXISTS sync_positions (
         target_name TEXT PRIMARY KEY,
@@ -1629,10 +1741,14 @@ var SQLiteEventStore = class {
       CREATE INDEX IF NOT EXISTS idx_working_set_relevance ON working_set(relevance_score);
       CREATE INDEX IF NOT EXISTS idx_consolidated_confidence ON consolidated_memories(confidence);
       CREATE INDEX IF NOT EXISTS idx_continuity_created ON continuity_log(created_at);
+      CREATE INDEX IF NOT EXISTS idx_consolidated_rules_confidence ON consolidated_rules(confidence);
       CREATE INDEX IF NOT EXISTS idx_embedding_outbox_status ON embedding_outbox(status);
       CREATE INDEX IF NOT EXISTS idx_helpfulness_event ON memory_helpfulness(event_id);
       CREATE INDEX IF NOT EXISTS idx_helpfulness_session ON memory_helpfulness(session_id);
       CREATE INDEX IF NOT EXISTS idx_helpfulness_score ON memory_helpfulness(helpfulness_score DESC);
+      CREATE INDEX IF NOT EXISTS idx_retrieval_traces_created_at ON retrieval_traces(created_at DESC);
+      CREATE INDEX IF NOT EXISTS idx_retrieval_traces_project_hash ON retrieval_traces(project_hash);
+      CREATE INDEX IF NOT EXISTS idx_retrieval_traces_session_id ON retrieval_traces(session_id);
 
       -- FTS5 Full-Text Search for fast keyword search
       CREATE VIRTUAL TABLE IF NOT EXISTS events_fts USING fts5(
@@ -1656,6 +1772,14 @@ var SQLiteEventStore = class {
         INSERT INTO events_fts(rowid, content, event_id) VALUES (NEW.rowid, NEW.content, NEW.id);
       END;
     `);
+    try {
+      sqliteExec(this.db, `ALTER TABLE retrieval_traces ADD COLUMN selected_details_json TEXT;`);
+    } catch {
+    }
+    try {
+      sqliteExec(this.db, `ALTER TABLE retrieval_traces ADD COLUMN candidate_details_json TEXT;`);
+    } catch {
+    }
     const tableInfo = sqliteAll(this.db, "PRAGMA table_info(events)", []);
     const columnNames = tableInfo.map((col) => col.name);
     if (!columnNames.includes("access_count")) {
@@ -1755,6 +1879,21 @@ var SQLiteEventStore = class {
         insertLevel.run(id);
       });
       transaction();
+      if (this.markdownMirror) {
+        const event = {
+          id,
+          eventType: input.eventType,
+          sessionId: input.sessionId,
+          timestamp: input.timestamp,
+          content: input.content,
+          canonicalKey,
+          dedupeKey,
+          metadata
+        };
+        this.markdownMirror.append(event).catch((err) => {
+          console.warn("[SQLiteEventStore] markdown mirror append failed:", err);
+        });
+      }
       return { success: true, eventId: id, isDuplicate: false };
     } catch (error) {
       return {
@@ -1813,6 +1952,92 @@ var SQLiteEventStore = class {
     );
     return rows.map(this.rowToEvent);
   }
+  /**
+   * Get events since a SQLite rowid (for robust incremental replication).
+   * Rowid is monotonic for append-only tables, independent of client timestamps.
+   */
+  async getEventsSinceRowid(lastRowid, limit = 1e3) {
+    await this.initialize();
+    const rows = sqliteAll(
+      this.db,
+      `SELECT rowid as _rowid, * FROM events WHERE rowid > ? ORDER BY rowid ASC LIMIT ?`,
+      [lastRowid, limit]
+    );
+    return rows.map((row) => ({
+      rowid: row._rowid,
+      event: this.rowToEvent(row)
+    }));
+  }
+  /**
+   * Import events with fixed IDs (used for cross-machine replication).
+   * Idempotent: skips if event id or dedupeKey already exists.
+   *
+   * NOTE: This bypasses the append() id generation to preserve stable IDs.
+   */
+  async importEvents(events) {
+    if (events.length === 0)
+      return { inserted: 0, skipped: 0 };
+    if (this.readOnly)
+      return { inserted: 0, skipped: events.length };
+    await this.initialize();
+    const getById = this.db.prepare(`SELECT id FROM events WHERE id = ?`);
+    const getByDedupe = this.db.prepare(`SELECT event_id FROM event_dedup WHERE dedupe_key = ?`);
+    const insertEvent = this.db.prepare(`
+      INSERT INTO events (id, event_type, session_id, timestamp, content, canonical_key, dedupe_key, metadata, turn_id)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+    const insertDedup = this.db.prepare(`
+      INSERT INTO event_dedup (dedupe_key, event_id) VALUES (?, ?)
+    `);
+    const insertLevel = this.db.prepare(`
+      INSERT INTO memory_levels (event_id, level) VALUES (?, 'L0')
+    `);
+    let inserted = 0;
+    let skipped = 0;
+    const insertedEvents = [];
+    const tx = this.db.transaction((batch) => {
+      for (const ev of batch) {
+        const existingById = getById.get(ev.id);
+        if (existingById) {
+          skipped++;
+          continue;
+        }
+        const canonicalKey = ev.canonicalKey || makeCanonicalKey(ev.content);
+        const dedupeKey = ev.dedupeKey || makeDedupeKey(ev.content, ev.sessionId);
+        const existingByDedupe = getByDedupe.get(dedupeKey);
+        if (existingByDedupe) {
+          skipped++;
+          continue;
+        }
+        const metadata = ev.metadata || {};
+        const turnId = metadata.turnId;
+        insertEvent.run(
+          ev.id,
+          ev.eventType,
+          ev.sessionId,
+          toSQLiteTimestamp(ev.timestamp),
+          ev.content,
+          canonicalKey,
+          dedupeKey,
+          JSON.stringify(metadata),
+          turnId ?? null
+        );
+        insertDedup.run(dedupeKey, ev.id);
+        insertLevel.run(ev.id);
+        inserted++;
+        insertedEvents.push(ev);
+      }
+    });
+    tx(events);
+    if (this.markdownMirror && insertedEvents.length > 0) {
+      for (const ev of insertedEvents) {
+        this.markdownMirror.append(ev).catch((err) => {
+          console.warn("[SQLiteEventStore] markdown mirror append failed:", err);
+        });
+      }
+    }
+    return { inserted, skipped };
+  }
   /**
    * Create or update session
    */
@@ -1975,6 +2200,35 @@ var SQLiteEventStore = class {
       [error, ...ids]
     );
   }
+  /**
+   * Get embedding/vector outbox health statistics
+   */
+  async getOutboxStats() {
+    await this.initialize();
+    const embeddingRows = sqliteAll(
+      this.db,
+      `SELECT status, COUNT(*) as count FROM embedding_outbox GROUP BY status`
+    );
+    const vectorRows = sqliteAll(
+      this.db,
+      `SELECT status, COUNT(*) as count FROM vector_outbox GROUP BY status`
+    );
+    const fromRows = (rows) => {
+      const out = { pending: 0, processing: 0, failed: 0, total: 0 };
+      for (const row of rows) {
+        const key = row.status;
+        if (key === "pending" || key === "processing" || key === "failed") {
+          out[key] += row.count;
+        }
+        out.total += row.count;
+      }
+      return out;
+    };
+    return {
+      embedding: fromRows(embeddingRows),
+      vector: fromRows(vectorRows)
+    };
+  }
   /**
    * Update memory level
    */
@@ -2333,6 +2587,79 @@ var SQLiteEventStore = class {
   getDatabase() {
     return this.db;
   }
+  async recordRetrievalTrace(input) {
+    await this.initialize();
+    const traceId = randomUUID2();
+    sqliteRun(
+      this.db,
+      `INSERT INTO retrieval_traces (
+        trace_id, session_id, project_hash, query_text, strategy,
+        candidate_event_ids, selected_event_ids, candidate_details_json, selected_details_json,
+        candidate_count, selected_count, confidence, fallback_trace
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      [
+        traceId,
+        input.sessionId || null,
+        input.projectHash || null,
+        input.queryText,
+        input.strategy || null,
+        JSON.stringify(input.candidateEventIds || []),
+        JSON.stringify(input.selectedEventIds || []),
+        JSON.stringify(input.candidateDetails || []),
+        JSON.stringify(input.selectedDetails || []),
+        (input.candidateEventIds || []).length,
+        (input.selectedEventIds || []).length,
+        input.confidence || null,
+        JSON.stringify(input.fallbackTrace || [])
+      ]
+    );
+  }
+  async getRecentRetrievalTraces(limit = 50) {
+    await this.initialize();
+    const rows = sqliteAll(
+      this.db,
+      `SELECT * FROM retrieval_traces ORDER BY created_at DESC LIMIT ?`,
+      [limit]
+    );
+    return rows.map((row) => ({
+      traceId: row.trace_id,
+      sessionId: row.session_id || void 0,
+      projectHash: row.project_hash || void 0,
+      queryText: row.query_text,
+      strategy: row.strategy || void 0,
+      candidateEventIds: row.candidate_event_ids ? JSON.parse(row.candidate_event_ids) : [],
+      selectedEventIds: row.selected_event_ids ? JSON.parse(row.selected_event_ids) : [],
+      candidateDetails: row.candidate_details_json ? JSON.parse(row.candidate_details_json) : [],
+      selectedDetails: row.selected_details_json ? JSON.parse(row.selected_details_json) : [],
+      candidateCount: Number(row.candidate_count || 0),
+      selectedCount: Number(row.selected_count || 0),
+      confidence: row.confidence || void 0,
+      fallbackTrace: row.fallback_trace ? JSON.parse(row.fallback_trace) : [],
+      createdAt: toDateFromSQLite(row.created_at)
+    }));
+  }
+  async getRetrievalTraceStats() {
+    await this.initialize();
+    const row = sqliteGet(
+      this.db,
+      `SELECT
+        COUNT(*) as total_queries,
+        AVG(candidate_count) as avg_candidate_count,
+        AVG(selected_count) as avg_selected_count,
+        CASE
+          WHEN SUM(candidate_count) > 0 THEN (SUM(selected_count) * 1.0 / SUM(candidate_count))
+          ELSE 0
+        END as selection_rate
+       FROM retrieval_traces`,
+      []
+    );
+    return {
+      totalQueries: Number(row?.total_queries || 0),
+      avgCandidateCount: Number(row?.avg_candidate_count || 0),
+      avgSelectedCount: Number(row?.avg_selected_count || 0),
+      selectionRate: Number(row?.selection_rate || 0)
+    };
+  }
   /**
    * Close database connection
    */
@@ -2666,8 +2993,282 @@ var SyncWorker = class {
   }
 };
 
-// src/core/entity-repo.ts
+// src/core/mongo-sync-worker.ts
 import { randomUUID as randomUUID3 } from "crypto";
+import * as os from "os";
+import { MongoClient } from "mongodb";
+function redactMongoUri(uri) {
+  const schemeIdx = uri.indexOf("://");
+  if (schemeIdx === -1)
+    return uri;
+  const atIdx = uri.indexOf("@", schemeIdx + 3);
+  if (atIdx === -1)
+    return uri;
+  const creds = uri.slice(schemeIdx + 3, atIdx);
+  const colonIdx = creds.indexOf(":");
+  if (colonIdx === -1)
+    return uri;
+  const prefix = uri.slice(0, schemeIdx + 3 + colonIdx + 1);
+  const suffix = uri.slice(atIdx);
+  return `${prefix}***${suffix}`;
+}
+function parseIntOrZero(value) {
+  if (!value)
+    return 0;
+  const n = parseInt(value, 10);
+  return Number.isFinite(n) ? n : 0;
+}
+var MongoSyncWorker = class {
+  constructor(sqliteStore, config) {
+    this.sqliteStore = sqliteStore;
+    this.config = {
+      uri: config.uri,
+      dbName: config.dbName,
+      projectKey: config.projectKey,
+      direction: config.direction ?? "both",
+      intervalMs: config.intervalMs ?? 3e4,
+      batchSize: config.batchSize ?? 500,
+      instanceId: config.instanceId ?? randomUUID3()
+    };
+  }
+  config;
+  intervalHandle = null;
+  running = false;
+  client = null;
+  db = null;
+  counters = null;
+  events = null;
+  indexesEnsured = false;
+  stats = {
+    lastSyncAt: null,
+    pushedEvents: 0,
+    pulledEvents: 0,
+    errors: 0,
+    status: "idle"
+  };
+  start() {
+    if (this.running)
+      return;
+    this.running = true;
+    this.stats.status = "idle";
+    this.syncNow().catch((err) => {
+      console.error("[MongoSyncWorker] Initial sync failed:", err);
+    });
+    this.intervalHandle = setInterval(() => {
+      this.syncNow().catch((err) => {
+        console.error("[MongoSyncWorker] Periodic sync failed:", err);
+      });
+    }, this.config.intervalMs);
+  }
+  stop() {
+    this.running = false;
+    this.stats.status = "stopped";
+    if (this.intervalHandle) {
+      clearInterval(this.intervalHandle);
+      this.intervalHandle = null;
+    }
+  }
+  async shutdown() {
+    this.stop();
+    await this.disconnect();
+  }
+  getStats() {
+    return { ...this.stats };
+  }
+  isRunning() {
+    return this.running;
+  }
+  async syncNow() {
+    if (this.stats.status === "syncing")
+      return { pushed: 0, pulled: 0 };
+    this.stats.status = "syncing";
+    let pushed = 0;
+    let pulled = 0;
+    try {
+      await this.sqliteStore.initialize();
+      await this.ensureConnected();
+      await this.ensureIndexes();
+      if (this.config.direction === "push" || this.config.direction === "both") {
+        pushed = await this.pushEvents();
+        this.stats.pushedEvents += pushed;
+      }
+      if (this.config.direction === "pull" || this.config.direction === "both") {
+        pulled = await this.pullEvents();
+        this.stats.pulledEvents += pulled;
+      }
+      this.stats.lastSyncAt = /* @__PURE__ */ new Date();
+      this.stats.status = "idle";
+      return { pushed, pulled };
+    } catch (error) {
+      this.stats.errors++;
+      this.stats.status = "error";
+      throw error;
+    }
+  }
+  async ensureConnected() {
+    if (this.client && this.db && this.counters && this.events)
+      return;
+    try {
+      this.client = new MongoClient(this.config.uri, {
+        appName: "claude-memory-layer",
+        serverSelectionTimeoutMS: 5e3
+      });
+      await this.client.connect();
+      this.db = this.client.db(this.config.dbName);
+      this.counters = this.db.collection("cml_counters");
+      this.events = this.db.collection("cml_events");
+    } catch (err) {
+      const safeUri = redactMongoUri(this.config.uri);
+      throw new Error(`MongoDB connection failed (${safeUri}, db=${this.config.dbName}): ${String(err)}`);
+    }
+  }
+  async disconnect() {
+    try {
+      await this.client?.close();
+    } finally {
+      this.client = null;
+      this.db = null;
+      this.counters = null;
+      this.events = null;
+      this.indexesEnsured = false;
+    }
+  }
+  async ensureIndexes() {
+    if (this.indexesEnsured)
+      return;
+    if (!this.events || !this.counters)
+      throw new Error("Mongo not connected");
+    try {
+      await this.events.createIndex({ projectKey: 1, seq: 1 }, { unique: true });
+      await this.events.createIndex({ projectKey: 1, eventId: 1 }, { unique: true });
+      await this.events.createIndex({ projectKey: 1, dedupeKey: 1 });
+    } catch (err) {
+      console.warn("[MongoSyncWorker] Failed to ensure indexes (continuing):", err);
+    }
+    this.indexesEnsured = true;
+  }
+  counterKey(kind) {
+    return `${kind}:${this.config.projectKey}`;
+  }
+  async allocateSeqRange(kind, count) {
+    if (!this.counters)
+      throw new Error("Mongo not connected");
+    if (count <= 0)
+      return 1;
+    const key = this.counterKey(kind);
+    const doc = await this.counters.findOneAndUpdate(
+      { _id: key },
+      { $inc: { seq: count } },
+      { upsert: true, returnDocument: "after" }
+    );
+    const endSeq = doc?.seq;
+    if (typeof endSeq !== "number") {
+      throw new Error(`Failed to allocate seq range for ${key}`);
+    }
+    return endSeq - count + 1;
+  }
+  pushTargetName() {
+    return `mongo_push_events_rowid:${this.config.projectKey}`;
+  }
+  pullTargetName() {
+    return `mongo_pull_events_seq:${this.config.projectKey}`;
+  }
+  async pushEvents() {
+    if (!this.events)
+      throw new Error("Mongo not connected");
+    const position = await this.sqliteStore.getSyncPosition(this.pushTargetName());
+    let lastRowid = parseIntOrZero(position.lastEventId);
+    let pushed = 0;
+    while (true) {
+      const batch = await this.sqliteStore.getEventsSinceRowid(lastRowid, this.config.batchSize);
+      if (batch.length === 0)
+        break;
+      const startSeq = await this.allocateSeqRange("events", batch.length);
+      const now = /* @__PURE__ */ new Date();
+      const hostname2 = os.hostname();
+      const ops = batch.map((item, idx) => {
+        const event = item.event;
+        const seq = startSeq + idx;
+        const docId = `${this.config.projectKey}:${event.id}`;
+        return {
+          updateOne: {
+            filter: { _id: docId },
+            update: {
+              $setOnInsert: {
+                _id: docId,
+                projectKey: this.config.projectKey,
+                seq,
+                eventId: event.id,
+                eventType: event.eventType,
+                sessionId: event.sessionId,
+                timestamp: event.timestamp,
+                content: event.content,
+                canonicalKey: event.canonicalKey,
+                dedupeKey: event.dedupeKey,
+                metadata: event.metadata ?? null,
+                insertedAt: now,
+                updatedAt: now,
+                source: { hostname: hostname2, instanceId: this.config.instanceId }
+              }
+            },
+            upsert: true
+          }
+        };
+      });
+      await this.events.bulkWrite(ops, { ordered: false });
+      const last = batch[batch.length - 1];
+      lastRowid = last.rowid;
+      await this.sqliteStore.updateSyncPosition(
+        this.pushTargetName(),
+        String(lastRowid),
+        last.event.timestamp.toISOString()
+      );
+      pushed += batch.length;
+      if (batch.length < this.config.batchSize)
+        break;
+    }
+    return pushed;
+  }
+  async pullEvents() {
+    if (!this.events)
+      throw new Error("Mongo not connected");
+    const position = await this.sqliteStore.getSyncPosition(this.pullTargetName());
+    let lastSeq = parseIntOrZero(position.lastEventId);
+    let pulled = 0;
+    while (true) {
+      const docs = await this.events.find(
+        { projectKey: this.config.projectKey, seq: { $gt: lastSeq } },
+        { sort: { seq: 1 }, limit: this.config.batchSize }
+      ).toArray();
+      if (docs.length === 0)
+        break;
+      const events = docs.map((d) => ({
+        id: d.eventId,
+        eventType: d.eventType,
+        sessionId: d.sessionId,
+        timestamp: d.timestamp instanceof Date ? d.timestamp : new Date(d.timestamp),
+        content: d.content,
+        canonicalKey: d.canonicalKey,
+        dedupeKey: d.dedupeKey,
+        metadata: d.metadata ?? void 0
+      }));
+      const result = await this.sqliteStore.importEvents(events);
+      pulled += result.inserted;
+      lastSeq = docs[docs.length - 1].seq;
+      await this.sqliteStore.updateSyncPosition(
+        this.pullTargetName(),
+        String(lastSeq),
+        (/* @__PURE__ */ new Date()).toISOString()
+      );
+      if (docs.length < this.config.batchSize)
+        break;
+    }
+    return pulled;
+  }
+};
+
+// src/core/entity-repo.ts
+import { randomUUID as randomUUID4 } from "crypto";
 var EntityRepo = class {
   constructor(db) {
     this.db = db;
@@ -2676,7 +3277,7 @@ var EntityRepo = class {
    * Create a new entity
    */
   async create(input) {
-    const entityId = randomUUID3();
+    const entityId = randomUUID4();
     const canonicalKey = makeEntityCanonicalKey(input.entityType, input.title, {
       project: input.project
     });
@@ -2930,7 +3531,7 @@ var EntityRepo = class {
 };
 
 // src/core/edge-repo.ts
-import { randomUUID as randomUUID4 } from "crypto";
+import { randomUUID as randomUUID5 } from "crypto";
 var EdgeRepo = class {
   constructor(db) {
     this.db = db;
@@ -2939,7 +3540,7 @@ var EdgeRepo = class {
    * Create a new edge (idempotent - ignores duplicates)
    */
   async create(input) {
-    const edgeId = randomUUID4();
+    const edgeId = randomUUID5();
     const now = /* @__PURE__ */ new Date();
     await dbRun(
       this.db,
@@ -3430,7 +4031,7 @@ function getDefaultEmbedder() {
 }
 
 // src/core/vector-outbox.ts
-import { randomUUID as randomUUID5 } from "crypto";
+import { randomUUID as randomUUID6 } from "crypto";
 var DEFAULT_CONFIG2 = {
   embeddingVersion: "v1",
   maxRetries: 3,
@@ -3449,7 +4050,7 @@ var VectorOutbox = class {
    */
   async enqueue(itemKind, itemId, embeddingVersion) {
     const version = embeddingVersion ?? this.config.embeddingVersion;
-    const jobId = randomUUID5();
+    const jobId = randomUUID6();
     const now = (/* @__PURE__ */ new Date()).toISOString();
     await dbRun(
       this.db,
@@ -4610,7 +5211,20 @@ var DEFAULT_OPTIONS2 = {
   topK: 5,
   minScore: 0.7,
   maxTokens: 2e3,
-  includeSessionContext: true
+  includeSessionContext: true,
+  strategy: "auto",
+  rerankWithKeyword: true,
+  decayPolicy: {
+    enabled: true,
+    windowDays: 30,
+    maxPenalty: 0.15
+  },
+  graphHop: {
+    enabled: true,
+    maxHops: 1,
+    hopPenalty: 0.08
+  },
+  projectScopeMode: "global"
 };
 var Retriever = class {
   eventStore;
@@ -4620,6 +5234,7 @@ var Retriever = class {
   sharedStore;
   sharedVectorStore;
   graduation;
+  queryRewriter;
   constructor(eventStore, vectorStore, embedder, matcher, sharedOptions) {
     this.eventStore = eventStore;
     this.vectorStore = vectorStore;
@@ -4628,47 +5243,105 @@ var Retriever = class {
     this.sharedStore = sharedOptions?.sharedStore;
     this.sharedVectorStore = sharedOptions?.sharedVectorStore;
   }
-  /**
-   * Set graduation pipeline for access tracking
-   */
   setGraduationPipeline(graduation) {
     this.graduation = graduation;
   }
-  /**
-   * Set shared stores after construction
-   */
   setSharedStores(sharedStore, sharedVectorStore) {
     this.sharedStore = sharedStore;
     this.sharedVectorStore = sharedVectorStore;
   }
-  /**
-   * Retrieve relevant memories for a query
-   */
+  setQueryRewriter(rewriter) {
+    this.queryRewriter = rewriter;
+  }
   async retrieve(query, options = {}) {
     const opts = { ...DEFAULT_OPTIONS2, ...options };
-    const queryEmbedding = await this.embedder.embed(query);
-    const searchResults = await this.vectorStore.search(queryEmbedding.vector, {
-      limit: opts.topK * 2,
-      // Get extra for filtering
+    const sessionFilter = opts.scope?.sessionId ?? opts.sessionId;
+    const fallbackTrace = [];
+    const fallbackEnabled = (opts.strategy ?? "auto") === "auto";
+    const primaryStrategy = opts.strategy === "auto" ? "fast" : opts.strategy || "fast";
+    let current = await this.runStage(query, {
+      strategy: primaryStrategy,
+      topK: opts.topK,
       minScore: opts.minScore,
-      sessionId: opts.sessionId
+      sessionId: sessionFilter,
+      scope: opts.scope,
+      rerankWithKeyword: opts.rerankWithKeyword !== false,
+      rerankWeights: opts.rerankWeights,
+      decayPolicy: opts.decayPolicy,
+      intentRewrite: opts.intentRewrite === true,
+      graphHop: opts.graphHop,
+      projectScopeMode: opts.projectScopeMode,
+      projectHash: opts.projectHash,
+      allowedProjectHashes: opts.allowedProjectHashes
     });
-    const matchResult = this.matcher.matchSearchResults(
-      searchResults,
-      (eventId) => this.getEventAgeDays(eventId)
-    );
-    const memories = await this.enrichResults(searchResults.slice(0, opts.topK), opts);
+    fallbackTrace.push(`stage:primary:${primaryStrategy}`);
+    if (fallbackEnabled && this.shouldFallback(current.matchResult, current.results) && primaryStrategy !== "deep") {
+      current = await this.runStage(query, {
+        strategy: "deep",
+        topK: opts.topK,
+        minScore: opts.minScore,
+        sessionId: sessionFilter,
+        scope: opts.scope,
+        rerankWithKeyword: opts.rerankWithKeyword !== false,
+        rerankWeights: opts.rerankWeights,
+        decayPolicy: opts.decayPolicy,
+        graphHop: opts.graphHop,
+        projectScopeMode: opts.projectScopeMode,
+        projectHash: opts.projectHash,
+        allowedProjectHashes: opts.allowedProjectHashes
+      });
+      fallbackTrace.push("fallback:deep");
+    }
+    if (fallbackEnabled && this.shouldFallback(current.matchResult, current.results)) {
+      current = await this.runStage(query, {
+        strategy: "deep",
+        topK: opts.topK,
+        minScore: Math.max(0.5, opts.minScore - 0.15),
+        sessionId: void 0,
+        scope: void 0,
+        rerankWithKeyword: true,
+        rerankWeights: opts.rerankWeights,
+        decayPolicy: opts.decayPolicy,
+        graphHop: opts.graphHop,
+        projectScopeMode: opts.projectScopeMode,
+        projectHash: opts.projectHash,
+        allowedProjectHashes: opts.allowedProjectHashes
+      });
+      fallbackTrace.push("fallback:scope-expanded");
+    }
+    if (fallbackEnabled && this.shouldFallback(current.matchResult, current.results)) {
+      const summary = await this.buildSummaryFallback(query, opts.topK);
+      current = {
+        results: summary,
+        candidateResults: summary,
+        matchResult: this.matcher.matchSearchResults(summary, () => 0)
+      };
+      fallbackTrace.push("fallback:summary");
+    }
+    const memories = await this.enrichResults(current.results.slice(0, opts.topK), opts);
     const context = this.buildContext(memories, opts.maxTokens);
     return {
       memories,
-      matchResult,
+      matchResult: current.matchResult,
       totalTokens: this.estimateTokens(context),
-      context
+      context,
+      fallbackTrace,
+      selectedDebug: current.results.slice(0, opts.topK).map((r) => ({
+        eventId: r.eventId,
+        score: r.score,
+        semanticScore: r.semanticScore,
+        lexicalScore: r.lexicalScore,
+        recencyScore: r.recencyScore
+      })),
+      candidateDebug: (current.candidateResults || []).slice(0, Math.max(opts.topK * 3, 20)).map((r) => ({
+        eventId: r.eventId,
+        score: r.score,
+        semanticScore: r.semanticScore,
+        lexicalScore: r.lexicalScore,
+        recencyScore: r.recencyScore
+      }))
     };
   }
-  /**
-   * Retrieve with unified search (project + shared)
-   */
   async retrieveUnified(query, options = {}) {
     const projectResult = await this.retrieve(query, options);
     if (!options.includeShared || !this.sharedStore || !this.sharedVectorStore) {
@@ -4676,22 +5349,19 @@ var Retriever = class {
     }
     try {
       const queryEmbedding = await this.embedder.embed(query);
-      const sharedVectorResults = await this.sharedVectorStore.search(
-        queryEmbedding.vector,
-        {
-          limit: options.topK || 5,
-          minScore: options.minScore || 0.7,
-          excludeProjectHash: options.projectHash
-        }
-      );
+      const sharedVectorResults = await this.sharedVectorStore.search(queryEmbedding.vector, {
+        limit: options.topK || 5,
+        minScore: options.minScore || 0.7,
+        excludeProjectHash: options.projectHash
+      });
       const sharedMemories = [];
       for (const result of sharedVectorResults) {
         const entry = await this.sharedStore.get(result.entryId);
-        if (entry) {
-          if (!options.projectHash || entry.sourceProjectHash !== options.projectHash) {
-            sharedMemories.push(entry);
-            await this.sharedStore.recordUsage(entry.entryId);
-          }
+        if (!entry)
+          continue;
+        if (!options.projectHash || entry.sourceProjectHash !== options.projectHash) {
+          sharedMemories.push(entry);
+          await this.sharedStore.recordUsage(entry.entryId);
         }
       }
       const unifiedContext = this.buildUnifiedContext(projectResult, sharedMemories);
@@ -4706,50 +5376,243 @@ var Retriever = class {
       return projectResult;
     }
   }
-  /**
-   * Build unified context combining project and shared memories
-   */
-  buildUnifiedContext(projectResult, sharedMemories) {
-    let context = projectResult.context;
-    if (sharedMemories.length > 0) {
-      context += "\n\n## Cross-Project Knowledge\n\n";
-      for (const memory of sharedMemories.slice(0, 3)) {
-        context += `### ${memory.title}
-`;
-        if (memory.symptoms.length > 0) {
-          context += `**Symptoms:** ${memory.symptoms.join(", ")}
-`;
-        }
-        context += `**Root Cause:** ${memory.rootCause}
-`;
-        context += `**Solution:** ${memory.solution}
-`;
-        if (memory.technologies && memory.technologies.length > 0) {
-          context += `**Technologies:** ${memory.technologies.join(", ")}
-`;
+  async runStage(query, input) {
+    let initialResults = await this.searchByStrategy(query, {
+      strategy: input.strategy,
+      topK: input.topK,
+      minScore: input.minScore,
+      sessionId: input.sessionId
+    });
+    if (input.intentRewrite && input.strategy === "deep" && this.queryRewriter) {
+      const rewritten = (await this.queryRewriter(query))?.trim();
+      if (rewritten && rewritten !== query) {
+        const rewrittenResults = await this.searchByStrategy(rewritten, {
+          strategy: "deep",
+          topK: input.topK,
+          minScore: Math.max(0.5, input.minScore - 0.1),
+          sessionId: input.sessionId
+        });
+        initialResults = this.mergeResults(initialResults, rewrittenResults, input.topK * 3);
+      }
+    }
+    const expandedResults = input.graphHop?.enabled === false ? initialResults : await this.expandGraphHops(initialResults, {
+      maxHops: Math.max(1, input.graphHop?.maxHops ?? 1),
+      hopPenalty: Math.max(0, input.graphHop?.hopPenalty ?? 0.08),
+      limit: input.topK * 4
+    });
+    const rerankedResults = input.rerankWithKeyword ? this.rerankByKeywordOverlap(expandedResults, query, input.rerankWeights, input.decayPolicy) : expandedResults;
+    const filtered = await this.applyScopeFilters(rerankedResults, {
+      scope: input.scope,
+      projectScopeMode: input.projectScopeMode,
+      projectHash: input.projectHash,
+      allowedProjectHashes: input.allowedProjectHashes
+    });
+    const top = filtered.slice(0, input.topK);
+    const matchResult = this.matcher.matchSearchResults(top, () => 0);
+    return { results: top, candidateResults: filtered, matchResult };
+  }
+  mergeResults(primary, secondary, limit) {
+    const byId = /* @__PURE__ */ new Map();
+    for (const row of primary)
+      byId.set(row.eventId, row);
+    for (const row of secondary) {
+      const prev = byId.get(row.eventId);
+      if (!prev || row.score > prev.score) {
+        byId.set(row.eventId, row);
+      }
+    }
+    return [...byId.values()].sort((a, b) => b.score - a.score).slice(0, limit);
+  }
+  async expandGraphHops(seeds, opts) {
+    const byId = /* @__PURE__ */ new Map();
+    for (const s of seeds)
+      byId.set(s.eventId, s);
+    let frontier = seeds.map((s) => ({ row: s, hop: 0 }));
+    for (let hop = 1; hop <= opts.maxHops; hop += 1) {
+      const next = [];
+      for (const f of frontier) {
+        const ev = await this.eventStore.getEvent(f.row.eventId);
+        if (!ev)
+          continue;
+        const rel = ev.metadata?.relatedEventIds ?? [];
+        const relatedIds = Array.isArray(rel) ? rel.filter((x) => typeof x === "string") : [];
+        for (const rid of relatedIds) {
+          if (byId.has(rid))
+            continue;
+          const target = await this.eventStore.getEvent(rid);
+          if (!target)
+            continue;
+          const score = Math.max(0, f.row.score - opts.hopPenalty * hop);
+          const row = {
+            id: `hop-${hop}-${rid}`,
+            eventId: target.id,
+            content: target.content,
+            score,
+            sessionId: target.sessionId,
+            eventType: target.eventType,
+            timestamp: target.timestamp.toISOString()
+          };
+          byId.set(row.eventId, row);
+          next.push({ row, hop });
+          if (byId.size >= opts.limit)
+            break;
         }
-        context += `_Confidence: ${(memory.confidence * 100).toFixed(0)}%_
-
-`;
+        if (byId.size >= opts.limit)
+          break;
       }
+      frontier = next;
+      if (frontier.length === 0 || byId.size >= opts.limit)
+        break;
     }
-    return context;
+    return [...byId.values()].sort((a, b) => b.score - a.score).slice(0, opts.limit);
+  }
+  shouldFallback(matchResult, results) {
+    if (results.length === 0)
+      return true;
+    if (matchResult.confidence === "none")
+      return true;
+    return false;
+  }
+  async buildSummaryFallback(query, topK) {
+    const recent = await this.eventStore.getRecentEvents(Math.max(topK * 6, 20));
+    const q = this.tokenize(query);
+    const ranked = recent.map((e) => ({ e, overlap: this.keywordOverlap(q, this.tokenize(e.content)) })).filter((r) => r.overlap > 0).sort((a, b) => b.overlap - a.overlap).slice(0, topK).map((row, idx) => ({
+      id: `summary-${row.e.id}`,
+      eventId: row.e.id,
+      content: row.e.content,
+      score: Math.max(0.25, 0.6 - idx * 0.05),
+      sessionId: row.e.sessionId,
+      eventType: row.e.eventType,
+      timestamp: row.e.timestamp.toISOString()
+    }));
+    return ranked;
+  }
+  async searchByStrategy(query, input) {
+    const strategy = input.strategy === "auto" ? "deep" : input.strategy;
+    if (strategy === "fast") {
+      const keyword = await this.searchByKeyword(query, {
+        limit: Math.max(5, input.topK * 3),
+        sessionId: input.sessionId
+      });
+      return keyword;
+    }
+    const queryEmbedding = await this.embedder.embed(query);
+    return this.vectorStore.search(queryEmbedding.vector, {
+      limit: Math.max(5, input.topK * 3),
+      minScore: input.minScore,
+      sessionId: input.sessionId
+    });
+  }
+  async searchByKeyword(query, input) {
+    if (this.eventStore.keywordSearch) {
+      const rows = await this.eventStore.keywordSearch(query, input.limit);
+      const filtered2 = input.sessionId ? rows.filter((r) => r.event.sessionId === input.sessionId) : rows;
+      return filtered2.map((row, idx) => ({
+        id: `kw-${row.event.id}`,
+        eventId: row.event.id,
+        content: row.event.content,
+        score: Math.max(0.4, 1 - idx * 0.04),
+        sessionId: row.event.sessionId,
+        eventType: row.event.eventType,
+        timestamp: row.event.timestamp.toISOString()
+      }));
+    }
+    const recent = await this.eventStore.getRecentEvents(input.limit * 4);
+    const tokens = this.tokenize(query);
+    const filtered = recent.filter((e) => input.sessionId ? e.sessionId === input.sessionId : true).map((e) => ({ e, overlap: this.keywordOverlap(tokens, this.tokenize(e.content)) })).filter((r) => r.overlap > 0).sort((a, b) => b.overlap - a.overlap).slice(0, input.limit);
+    return filtered.map((row, idx) => ({
+      id: `kw-fallback-${row.e.id}`,
+      eventId: row.e.id,
+      content: row.e.content,
+      score: Math.max(0.3, 0.9 - idx * 0.05),
+      sessionId: row.e.sessionId,
+      eventType: row.e.eventType,
+      timestamp: row.e.timestamp.toISOString()
+    }));
+  }
+  rerankByKeywordOverlap(results, query, weights, decayPolicy) {
+    const q = this.tokenize(query);
+    const now = Date.now();
+    const sw = Math.max(0, weights?.semantic ?? 0.7);
+    const lw = Math.max(0, weights?.lexical ?? 0.2);
+    const rw = Math.max(0, weights?.recency ?? 0.1);
+    const total = sw + lw + rw || 1;
+    const decayEnabled = decayPolicy?.enabled !== false;
+    const decayWindow = Math.max(1, decayPolicy?.windowDays ?? 30);
+    const decayMaxPenalty = Math.max(0, decayPolicy?.maxPenalty ?? 0.15);
+    return [...results].map((r) => {
+      const overlap = this.keywordOverlap(q, this.tokenize(r.content));
+      const recencyDays = Math.max(0, (now - new Date(r.timestamp).getTime()) / (1e3 * 60 * 60 * 24));
+      const recency = Math.max(0, 1 - recencyDays / decayWindow);
+      let blended = (r.score * sw + overlap * lw + recency * rw) / total;
+      if (decayEnabled && recencyDays > decayWindow && overlap < 0.5) {
+        const ageFactor = Math.min(1, (recencyDays - decayWindow) / decayWindow);
+        blended -= decayMaxPenalty * ageFactor;
+      }
+      return { ...r, score: Math.max(0, blended), semanticScore: r.score, lexicalScore: overlap, recencyScore: recency };
+    }).sort((a, b) => b.score - a.score);
+  }
+  async applyScopeFilters(results, options) {
+    const scope = options?.scope;
+    const projectScopeMode = options?.projectScopeMode ?? "global";
+    const allowedProjectHashes = new Set(
+      [options?.projectHash, ...options?.allowedProjectHashes || []].filter(
+        (value) => typeof value === "string" && value.length > 0
+      )
+    );
+    if (!scope && projectScopeMode === "global")
+      return results;
+    const normalizedIncludes = (scope?.contentIncludes || []).map((s) => s.toLowerCase());
+    const filtered = [];
+    for (const result of results) {
+      if (scope?.sessionId && result.sessionId !== scope.sessionId)
+        continue;
+      if (scope?.sessionIdPrefix && !result.sessionId.startsWith(scope.sessionIdPrefix))
+        continue;
+      if (scope?.eventTypes && scope.eventTypes.length > 0 && !scope.eventTypes.includes(result.eventType))
+        continue;
+      const event = await this.eventStore.getEvent(result.eventId);
+      if (!event)
+        continue;
+      if (scope?.canonicalKeyPrefix && !event.canonicalKey.startsWith(scope.canonicalKeyPrefix))
+        continue;
+      if (normalizedIncludes.length > 0) {
+        const lc = event.content.toLowerCase();
+        if (!normalizedIncludes.some((needle) => lc.includes(needle)))
+          continue;
+      }
+      if (scope?.metadata && !this.matchesMetadataScope(event.metadata, scope.metadata))
+        continue;
+      const projectHash = this.extractProjectHash(event.metadata);
+      filtered.push({ result, projectHash });
+    }
+    if (projectScopeMode === "global" || allowedProjectHashes.size === 0) {
+      return filtered.map((x) => x.result);
+    }
+    const projectMatched = filtered.filter((x) => x.projectHash && allowedProjectHashes.has(x.projectHash));
+    if (projectScopeMode === "strict") {
+      return projectMatched.map((x) => x.result);
+    }
+    return (projectMatched.length > 0 ? projectMatched : filtered).map((x) => x.result);
+  }
+  extractProjectHash(metadata) {
+    if (!metadata || typeof metadata !== "object")
+      return void 0;
+    const scope = metadata.scope;
+    if (!scope || typeof scope !== "object")
+      return void 0;
+    const project = scope.project;
+    if (!project || typeof project !== "object")
+      return void 0;
+    const hash = project.hash;
+    return typeof hash === "string" && hash.length > 0 ? hash : void 0;
   }
-  /**
-   * Retrieve memories from a specific session
-   */
   async retrieveFromSession(sessionId) {
     return this.eventStore.getSessionEvents(sessionId);
   }
-  /**
-   * Get recent memories across all sessions
-   */
   async retrieveRecent(limit = 100) {
     return this.eventStore.getRecentEvents(limit);
   }
-  /**
-   * Enrich search results with full event data
-   */
   async enrichResults(results, options) {
     const memories = [];
     for (const result of results) {
@@ -4757,27 +5620,16 @@ var Retriever = class {
       if (!event)
         continue;
       if (this.graduation) {
-        this.graduation.recordAccess(
-          event.id,
-          options.sessionId || "unknown",
-          result.score
-        );
+        this.graduation.recordAccess(event.id, options.sessionId || "unknown", result.score);
       }
       let sessionContext;
       if (options.includeSessionContext) {
         sessionContext = await this.getSessionContext(event.sessionId, event.id);
       }
-      memories.push({
-        event,
-        score: result.score,
-        sessionContext
-      });
+      memories.push({ event, score: result.score, sessionContext });
     }
     return memories;
   }
-  /**
-   * Get surrounding context from the same session
-   */
   async getSessionContext(sessionId, eventId) {
     const sessionEvents = await this.eventStore.getSessionEvents(sessionId);
     const eventIndex = sessionEvents.findIndex((e) => e.id === eventId);
@@ -4790,55 +5642,86 @@ var Retriever = class {
       return void 0;
     return contextEvents.filter((e) => e.id !== eventId).map((e) => `[${e.eventType}]: ${e.content.slice(0, 200)}...`).join("\n");
   }
-  /**
-   * Build context string from memories (respecting token limit)
-   */
+  buildUnifiedContext(projectResult, sharedMemories) {
+    let context = projectResult.context;
+    if (sharedMemories.length === 0)
+      return context;
+    context += "\n\n## Cross-Project Knowledge\n\n";
+    for (const memory of sharedMemories.slice(0, 3)) {
+      context += `### ${memory.title}
+`;
+      if (memory.symptoms.length > 0)
+        context += `**Symptoms:** ${memory.symptoms.join(", ")}
+`;
+      context += `**Root Cause:** ${memory.rootCause}
+`;
+      context += `**Solution:** ${memory.solution}
+`;
+      if (memory.technologies && memory.technologies.length > 0)
+        context += `**Technologies:** ${memory.technologies.join(", ")}
+`;
+      context += `_Confidence: ${(memory.confidence * 100).toFixed(0)}%_
+
+`;
+    }
+    return context;
+  }
   buildContext(memories, maxTokens) {
     const parts = [];
     let currentTokens = 0;
     for (const memory of memories) {
       const memoryText = this.formatMemory(memory);
       const memoryTokens = this.estimateTokens(memoryText);
-      if (currentTokens + memoryTokens > maxTokens) {
+      if (currentTokens + memoryTokens > maxTokens)
         break;
-      }
       parts.push(memoryText);
       currentTokens += memoryTokens;
     }
-    if (parts.length === 0) {
+    if (parts.length === 0)
       return "";
-    }
     return `## Relevant Memories
 
 ${parts.join("\n\n---\n\n")}`;
   }
-  /**
-   * Format a single memory for context
-   */
   formatMemory(memory) {
     const { event, score, sessionContext } = memory;
     const date = event.timestamp.toISOString().split("T")[0];
     let text = `**${event.eventType}** (${date}, score: ${score.toFixed(2)})
 ${event.content}`;
-    if (sessionContext) {
+    if (sessionContext)
       text += `
 
 _Context:_ ${sessionContext}`;
-    }
     return text;
   }
-  /**
-   * Estimate token count (rough approximation)
-   */
+  matchesMetadataScope(metadata, expected) {
+    if (!metadata)
+      return false;
+    return Object.entries(expected).every(([path2, value]) => {
+      const actual = path2.split(".").reduce((acc, key) => {
+        if (typeof acc !== "object" || acc === null)
+          return void 0;
+        return acc[key];
+      }, metadata);
+      return actual === value;
+    });
+  }
+  tokenize(text) {
+    return text.toLowerCase().replace(/[^\p{L}\p{N}\s]/gu, " ").split(/\s+/).filter((t) => t.length >= 2).slice(0, 64);
+  }
+  keywordOverlap(a, b) {
+    if (a.length === 0 || b.length === 0)
+      return 0;
+    const bs = new Set(b);
+    let hit = 0;
+    for (const t of a)
+      if (bs.has(t))
+        hit += 1;
+    return hit / a.length;
+  }
   estimateTokens(text) {
     return Math.ceil(text.length / 4);
   }
-  /**
-   * Get event age in days (for recency scoring)
-   */
-  getEventAgeDays(eventId) {
-    return 0;
-  }
 };
 function createRetriever(eventStore, vectorStore, embedder, matcher) {
   return new Retriever(eventStore, vectorStore, embedder, matcher);
@@ -5403,7 +6286,7 @@ var TaskMatcher = class {
 };
 
 // src/core/task/blocker-resolver.ts
-import { randomUUID as randomUUID6 } from "crypto";
+import { randomUUID as randomUUID7 } from "crypto";
 var URL_PATTERN = /^https?:\/\/.+/;
 var JIRA_PATTERN = /^[A-Z]+-\d+$/;
 var GITHUB_ISSUE_PATTERN = /^[^\/]+\/[^#]+#\d+$/;
@@ -5540,7 +6423,7 @@ var BlockerResolver = class {
    * Declare a new condition entity
    */
   async declareCondition(text, canonicalKey, candidates) {
-    const entityId = randomUUID6();
+    const entityId = randomUUID7();
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const currentJson = {
       text,
@@ -5583,7 +6466,7 @@ var BlockerResolver = class {
    * Declare a new artifact entity
    */
   async declareArtifact(identifier, canonicalKey) {
-    const entityId = randomUUID6();
+    const entityId = randomUUID7();
     const now = (/* @__PURE__ */ new Date()).toISOString();
     let artifactType = "generic";
     if (URL_PATTERN.test(identifier)) {
@@ -5648,7 +6531,7 @@ var BlockerResolver = class {
 };
 
 // src/core/task/task-resolver.ts
-import { randomUUID as randomUUID7 } from "crypto";
+import { randomUUID as randomUUID8 } from "crypto";
 var VALID_TRANSITIONS = {
   pending: ["in_progress", "cancelled"],
   in_progress: ["blocked", "done", "cancelled"],
@@ -5723,7 +6606,7 @@ var TaskResolver = class {
         isNew: false
       };
     }
-    const taskId = randomUUID7();
+    const taskId = randomUUID8();
     const canonicalKey = makeEntityCanonicalKey("task", extracted.title, {
       project: extracted.project
     });
@@ -5876,7 +6759,7 @@ var TaskResolver = class {
    * Emit task event to events table
    */
   async emitTaskEvent(eventType, payload) {
-    const eventId = randomUUID7();
+    const eventId = randomUUID8();
     const now = /* @__PURE__ */ new Date();
     const dedupeKey = makeTaskEventDedupeKey(
       eventType,
@@ -5934,14 +6817,14 @@ var TaskResolver = class {
       `INSERT INTO edges (edge_id, src_type, src_id, rel_type, dst_type, dst_id, meta_json)
        VALUES (?, 'entity', ?, 'resolves_to', 'entity', ?, ?)
        ON CONFLICT DO NOTHING`,
-      [randomUUID7(), conditionId, taskId, JSON.stringify({ resolved_at: (/* @__PURE__ */ new Date()).toISOString() })]
+      [randomUUID8(), conditionId, taskId, JSON.stringify({ resolved_at: (/* @__PURE__ */ new Date()).toISOString() })]
     );
     return eventId;
   }
 };
 
 // src/core/task/task-projector.ts
-import { randomUUID as randomUUID8 } from "crypto";
+import { randomUUID as randomUUID9 } from "crypto";
 var PROJECTOR_NAME = "task_projector";
 var TASK_EVENT_TYPES = [
   "task_created",
@@ -6137,7 +7020,7 @@ var TaskProjector = class {
    * Create blocker edge
    */
   async createBlockerEdge(taskId, blocker, relType) {
-    const edgeId = randomUUID8();
+    const edgeId = randomUUID9();
     await dbRun(
       this.db,
       `INSERT INTO edges (edge_id, src_type, src_id, rel_type, dst_type, dst_id, meta_json, created_at)
@@ -6175,7 +7058,7 @@ var TaskProjector = class {
    * Enqueue entity for vectorization
    */
   async enqueueForVectorization(itemId, itemKind) {
-    const jobId = randomUUID8();
+    const jobId = randomUUID9();
     const embeddingVersion = "v1";
     await dbRun(
       this.db,
@@ -6295,7 +7178,7 @@ function createSharedEventStore(dbPath) {
 }
 
 // src/core/shared-store.ts
-import { randomUUID as randomUUID9 } from "crypto";
+import { randomUUID as randomUUID10 } from "crypto";
 var SharedStore = class {
   constructor(sharedEventStore) {
     this.sharedEventStore = sharedEventStore;
@@ -6307,7 +7190,7 @@ var SharedStore = class {
    * Promote a verified troubleshooting entry to shared storage
    */
   async promoteEntry(input) {
-    const entryId = randomUUID9();
+    const entryId = randomUUID10();
     await dbRun(
       this.db,
       `INSERT INTO shared_troubleshooting (
@@ -6672,7 +7555,7 @@ function createSharedVectorStore(dbPath) {
 }
 
 // src/core/shared-promoter.ts
-import { randomUUID as randomUUID10 } from "crypto";
+import { randomUUID as randomUUID11 } from "crypto";
 var SharedPromoter = class {
   constructor(sharedStore, sharedVectorStore, embedder, config) {
     this.sharedStore = sharedStore;
@@ -6740,7 +7623,7 @@ var SharedPromoter = class {
       const embeddingContent = this.createEmbeddingContent(input);
       const embedding = await this.embedder.embed(embeddingContent);
       await this.sharedVectorStore.upsert({
-        id: randomUUID10(),
+        id: randomUUID11(),
         entryId,
         entryType: "troubleshooting",
         content: embeddingContent,
@@ -6865,6 +7748,7 @@ export {
   CitationUsageSchema,
   ConfigSchema,
   ConsolidatedMemorySchema,
+  ConsolidationRuleSchema,
   ContinuityLogSchema,
   DefaultContentProvider,
   EdgeRepo,
@@ -6901,6 +7785,7 @@ export {
   MemoryLevelSchema,
   MemoryMatchSchema,
   MemoryModeSchema,
+  MongoSyncWorker,
   NodeTypeSchema,
   OutboxItemKindSchema,
   OutboxJobSchema,