kirograph 0.19.0 → 0.20.0

package/dist/memory/compress.d.ts

@@ -0,0 +1,19 @@
+/**
+ * KiroGraph Memory — Deterministic observation compressor
+ *
+ * Applies caveman grammar rules programmatically. No LLM involved.
+ * Only runs when cavemanMode is not 'off'. Uses the same level the user chose.
+ */
+import type { CompressResult } from './types';
+export type CavemanMode = 'off' | 'lite' | 'full' | 'ultra';
+/**
+ * Compress observation text using caveman grammar rules.
+ * Returns the text unchanged if mode is 'off'.
+ */
+export declare function compressObservation(text: string, mode: CavemanMode): CompressResult;
+/**
+ * Extract candidate identifiers from text (camelCase, PascalCase, snake_case).
+ * Used for symbol detection.
+ */
+export declare function extractIdentifiers(text: string): string[];
+//# sourceMappingURL=compress.d.ts.map

package/dist/memory/compress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../../src/memory/compress.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAuE5D;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,cAAc,CAqFnF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAoBzD"}

package/dist/memory/database.d.ts

@@ -0,0 +1,92 @@
+/**
+ * KiroGraph Memory — Database layer
+ *
+ * Operates on mem_* tables within the same SQLite database as the code graph.
+ * Completely isolated: no FK to core nodes/edges tables.
+ */
+import type { MemSession, MemObservation, MemLink, ScoredObservation, MemSearchOptions, MemStats } from './types';
+export declare class MemoryDatabase {
+    private db;
+    private initialized;
+    constructor(db: any);
+    /**
+     * Apply memory schema. Called once when enableMemory is true.
+     */
+    initialize(): void;
+    /**
+     * Add temporal fact columns to mem_observations if missing.
+     * Safe to run multiple times (uses IF NOT EXISTS pattern via try/catch).
+     */
+    private migrateTemporalColumns;
+    /**
+     * Get or create an active session. Auto-creates if no active session exists
+     * within the timeout window.
+     */
+    getOrCreateSession(ide: string, cwd: string, timeoutSeconds?: number): string;
+    endSession(sessionId: string): void;
+    getSession(sessionId: string): MemSession | null;
+    listSessions(limit?: number): MemSession[];
+    /**
+     * Insert an observation. Returns the ID, or null if a duplicate (same content_hash).
+     */
+    insertObservation(content: string, opts?: {
+        contentRaw?: string;
+        kind?: string;
+        source?: string;
+        tags?: string[];
+        sessionId?: string;
+    }): string | null;
+    getObservation(id: string): MemObservation | null;
+    getObservationsBySession(sessionId: string, limit?: number): MemObservation[];
+    getObservationsByTimeRange(from: number, to: number, limit?: number): MemObservation[];
+    searchFTS(query: string, opts?: MemSearchOptions): ScoredObservation[];
+    linkToSymbol(observationId: string, qualifiedName: string, relevance?: number): void;
+    linkToSymbols(observationId: string, qualifiedNames: string[]): void;
+    /**
+     * Get observations linked to a symbol by qualified_name.
+     * Resolves through mem_links — no dependency on node IDs.
+     */
+    getLinkedObservations(qualifiedName: string, limit?: number): ScoredObservation[];
+    /**
+     * Get observations linked to any of the given qualified names.
+     * Used by kirograph_context and kirograph_impact to surface memory.
+     */
+    getLinkedObservationsForSymbols(qualifiedNames: string[], limit?: number): ScoredObservation[];
+    insertVector(observationId: string, embedding: Buffer, model: string): void;
+    getVector(observationId: string): {
+        embedding: Buffer;
+        model: string;
+    } | null;
+    getVectorCount(): number;
+    getVectorModelMismatch(currentModel: string): number;
+    getAllVectors(model?: string): Array<{
+        observationId: string;
+        embedding: Buffer;
+    }>;
+    deleteVectors(): void;
+    getStats(currentModel?: string): MemStats;
+    /**
+     * Delete observations older than the given timestamp.
+     * Cascades to mem_links and mem_vectors via FK.
+     */
+    prune(olderThan: number): number;
+    /**
+     * Find stale links where qualified_name no longer exists in the nodes table.
+     */
+    findStaleLinks(): MemLink[];
+    /**
+     * Remove stale links (where qualified_name no longer resolves).
+     */
+    removeStaleLinks(): number;
+    /**
+     * Close stale sessions (started but never ended, older than timeout).
+     */
+    closeStaleSessionsOlderThan(timeoutMs: number): number;
+    /**
+     * Strip <private>...</private> blocks from text.
+     */
+    static stripPrivate(text: string): string;
+    private rowToSession;
+    private rowToObservation;
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/memory/database.d.ts.map

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

package/dist/memory/database.js

@@ -74,6 +74,44 @@ class MemoryDatabase {
       }
     }
   }
+  // ── Watchmen ─────────────────────────────────────────────────────────────
+  /**
+   * Count non-summary observations created after the most recent summary.
+   * Used by WatchmenChecker to decide if synthesis should trigger.
+   */
+  countSinceLastSummary() {
+    const lastSummary = this.db.get(
+      `SELECT created_at FROM mem_observations WHERE kind = 'summary' ORDER BY created_at DESC LIMIT 1`
+    );
+    const since = lastSummary?.created_at ?? 0;
+    const row = this.db.get(
+      `SELECT COUNT(*) as count FROM mem_observations WHERE kind != 'summary' AND created_at > ?`,
+      [since]
+    );
+    return row?.count ?? 0;
+  }
+  getObservationsSinceLastSummary(limit = 50) {
+    const lastSummary = this.db.get(
+      `SELECT created_at FROM mem_observations WHERE kind = 'summary' ORDER BY created_at DESC LIMIT 1`
+    );
+    const since = lastSummary?.created_at ?? 0;
+    const rows = this.db.all(
+      `SELECT * FROM mem_observations WHERE kind != 'summary' AND created_at > ?
+       ORDER BY created_at DESC LIMIT ?`,
+      [since, limit]
+    );
+    return rows.map((row) => ({
+      id: row.id,
+      sessionId: row.session_id ?? void 0,
+      content: row.content,
+      contentRaw: row.content_raw ?? void 0,
+      contentHash: row.content_hash,
+      kind: row.kind,
+      source: row.source,
+      tags: row.tags ? JSON.parse(row.tags) : void 0,
+      createdAt: row.created_at
+    }));
+  }
   // ── Sessions ─────────────────────────────────────────────────────────────
   /**
    * Get or create an active session. Auto-creates if no active session exists

package/dist/memory/database.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/memory/database.ts"],
-  "sourcesContent": ["/**\n * KiroGraph Memory \u2014 Database layer\n *\n * Operates on mem_* tables within the same SQLite database as the code graph.\n * Completely isolated: no FK to core nodes/edges tables.\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport * as crypto from 'crypto';\nimport type {\n  MemSession,\n  MemObservation,\n  MemObservationInput,\n  MemLink,\n  ScoredObservation,\n  MemSearchOptions,\n  MemTimelineOptions,\n  MemStats,\n} from './types';\n\n// \u2500\u2500 Helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction generateId(): string {\n  return crypto.randomUUID();\n}\n\nfunction hashContent(content: string): string {\n  return crypto.createHash('sha256').update(content).digest('hex');\n}\n\n// \u2500\u2500 MemoryDatabase \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport class MemoryDatabase {\n  private db: any;\n  private initialized = false;\n\n  constructor(db: any) {\n    this.db = db;\n  }\n\n  /**\n   * Apply memory schema. Called once when enableMemory is true.\n   */\n  initialize(): void {\n    if (this.initialized) return;\n    const schemaPath = path.join(__dirname, '../db/memory-schema.sql');\n    const sql = fs.readFileSync(schemaPath, 'utf8');\n    this.db.exec(sql);\n\n    // Migration: add temporal columns if they don't exist (for existing databases)\n    this.migrateTemporalColumns();\n\n    this.initialized = true;\n  }\n\n  /**\n   * Add temporal fact columns to mem_observations if missing.\n   * Safe to run multiple times (uses IF NOT EXISTS pattern via try/catch).\n   */\n  private migrateTemporalColumns(): void {\n    const columnsToAdd = [\n      { name: 'valid_from', type: 'INTEGER' },\n      { name: 'valid_until', type: 'INTEGER' },\n      { name: 'superseded_by', type: 'TEXT' },\n      { name: 'fact_type', type: \"TEXT DEFAULT 'observation'\" },\n    ];\n\n    for (const col of columnsToAdd) {\n      try {\n        this.db.exec(`ALTER TABLE mem_observations ADD COLUMN ${col.name} ${col.type}`);\n      } catch {\n        // Column already exists \u2014 ignore\n      }\n    }\n  }\n\n  // \u2500\u2500 Sessions \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Get or create an active session. Auto-creates if no active session exists\n   * within the timeout window.\n   */\n  getOrCreateSession(ide: string, cwd: string, timeoutSeconds = 7200): string {\n    const cutoff = Date.now() - (timeoutSeconds * 1000);\n\n    // Look for an active session (no ended_at, same ide, started within timeout)\n    const existing = this.db.get(\n      `SELECT id FROM mem_sessions\n       WHERE ended_at IS NULL AND ide = ? AND started_at > ?\n       ORDER BY started_at DESC LIMIT 1`,\n      [ide, cutoff]\n    );\n\n    if (existing) return existing.id;\n\n    // Auto-close any stale sessions for this IDE\n    this.db.run(\n      `UPDATE mem_sessions SET ended_at = ? WHERE ended_at IS NULL AND ide = ?`,\n      [Date.now(), ide]\n    );\n\n    // Create new session\n    const id = generateId();\n    this.db.run(\n      `INSERT INTO mem_sessions (id, ide, cwd, started_at) VALUES (?, ?, ?, ?)`,\n      [id, ide, cwd, Date.now()]\n    );\n    return id;\n  }\n\n  endSession(sessionId: string): void {\n    this.db.run(\n      `UPDATE mem_sessions SET ended_at = ? WHERE id = ? AND ended_at IS NULL`,\n      [Date.now(), sessionId]\n    );\n  }\n\n  getSession(sessionId: string): MemSession | null {\n    const row = this.db.get('SELECT * FROM mem_sessions WHERE id = ?', [sessionId]);\n    return row ? this.rowToSession(row) : null;\n  }\n\n  listSessions(limit = 10): MemSession[] {\n    return this.db.all(\n      'SELECT * FROM mem_sessions ORDER BY started_at DESC LIMIT ?',\n      [limit]\n    ).map(this.rowToSession);\n  }\n\n  // \u2500\u2500 Observations \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Insert an observation. Returns the ID, or null if a duplicate (same content_hash).\n   */\n  insertObservation(\n    content: string,\n    opts: {\n      contentRaw?: string;\n      kind?: string;\n      source?: string;\n      tags?: string[];\n      sessionId?: string;\n    } = {}\n  ): string | null {\n    const id = generateId();\n    const contentHash = hashContent(content);\n    const kind = opts.kind ?? 'note';\n    const source = opts.source ?? 'manual';\n    const tags = opts.tags ? JSON.stringify(opts.tags) : null;\n    const now = Date.now();\n\n    try {\n      this.db.run(\n        `INSERT INTO mem_observations (id, session_id, content, content_raw, content_hash, kind, source, tags, created_at)\n         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n        [id, opts.sessionId ?? null, content, opts.contentRaw ?? null, contentHash, kind, source, tags, now]\n      );\n    } catch (err: any) {\n      // Unique constraint on content_hash \u2014 duplicate, skip silently\n      if (err.message?.includes('UNIQUE constraint failed') || err.message?.includes('unique')) {\n        return null;\n      }\n      throw err;\n    }\n\n    // Keep FTS in sync\n    this.db.run(\n      `INSERT INTO mem_fts (id, content, kind) VALUES (?, ?, ?)`,\n      [id, content, kind]\n    );\n\n    return id;\n  }\n\n  getObservation(id: string): MemObservation | null {\n    const row = this.db.get('SELECT * FROM mem_observations WHERE id = ?', [id]);\n    return row ? this.rowToObservation(row) : null;\n  }\n\n  getObservationsBySession(sessionId: string, limit = 50): MemObservation[] {\n    return this.db.all(\n      'SELECT * FROM mem_observations WHERE session_id = ? ORDER BY created_at DESC LIMIT ?',\n      [sessionId, limit]\n    ).map(this.rowToObservation);\n  }\n\n  getObservationsByTimeRange(from: number, to: number, limit = 50): MemObservation[] {\n    return this.db.all(\n      'SELECT * FROM mem_observations WHERE created_at >= ? AND created_at <= ? ORDER BY created_at DESC LIMIT ?',\n      [from, to, limit]\n    ).map(this.rowToObservation);\n  }\n\n  // \u2500\u2500 FTS Search \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  searchFTS(query: string, opts: MemSearchOptions = {}): ScoredObservation[] {\n    const { limit = 10, kind, sessionId, asOf } = opts;\n\n    // Sanitize for FTS5\n    const safe = query\n      .replace(/\\b(AND|OR|NOT)\\b/g, ' ')\n      .replace(/['\"*()?\\-+^~:{}\\\\\\.\\/,]/g, ' ')\n      .replace(/\\s+/g, ' ')\n      .trim();\n    if (!safe) return [];\n\n    const ftsQuery = safe + '*';\n    const safeLimit = Math.max(1, Math.floor(Number(limit)));\n\n    const conditions: string[] = [];\n    const params: any[] = [];\n\n    if (kind) {\n      conditions.push('o.kind = ?');\n      params.push(kind);\n    }\n    if (sessionId) {\n      conditions.push('o.session_id = ?');\n      params.push(sessionId);\n    }\n\n    // Temporal filtering: exclude expired and superseded facts\n    if (asOf) {\n      conditions.push('(o.valid_from IS NULL OR o.valid_from <= ?)');\n      params.push(asOf);\n      conditions.push('(o.valid_until IS NULL OR o.valid_until > ?)');\n      params.push(asOf);\n      conditions.push('o.superseded_by IS NULL');\n    }\n\n    const where = conditions.length > 0 ? `AND ${conditions.join(' AND ')}` : '';\n\n    const rows = this.db.all(\n      `SELECT o.*, rank FROM mem_fts f\n       JOIN mem_observations o ON o.id = f.id\n       WHERE mem_fts MATCH '${ftsQuery}' ${where}\n       ORDER BY rank\n       LIMIT ${safeLimit}`,\n      params\n    );\n\n    return rows.map((row: any) => ({\n      observation: this.rowToObservation(row),\n      score: Math.abs(row.rank ?? 0),\n      scoreSource: 'fts' as const,\n    }));\n  }\n\n  // \u2500\u2500 Links \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  linkToSymbol(observationId: string, qualifiedName: string, relevance = 1.0): void {\n    this.db.run(\n      `INSERT OR IGNORE INTO mem_links (observation_id, qualified_name, relevance)\n       VALUES (?, ?, ?)`,\n      [observationId, qualifiedName, relevance]\n    );\n  }\n\n  linkToSymbols(observationId: string, qualifiedNames: string[]): void {\n    for (const qn of qualifiedNames) {\n      this.linkToSymbol(observationId, qn);\n    }\n  }\n\n  /**\n   * Get observations linked to a symbol by qualified_name.\n   * Resolves through mem_links \u2014 no dependency on node IDs.\n   */\n  getLinkedObservations(qualifiedName: string, limit = 10): ScoredObservation[] {\n    const rows = this.db.all(\n      `SELECT o.*, l.relevance FROM mem_observations o\n       JOIN mem_links l ON l.observation_id = o.id\n       WHERE l.qualified_name = ?\n       ORDER BY l.relevance DESC, o.created_at DESC\n       LIMIT ?`,\n      [qualifiedName, limit]\n    );\n\n    return rows.map((row: any) => ({\n      observation: this.rowToObservation(row),\n      score: row.relevance ?? 1.0,\n      scoreSource: 'fts' as const,\n    }));\n  }\n\n  /**\n   * Get observations linked to any of the given qualified names.\n   * Used by kirograph_context and kirograph_impact to surface memory.\n   */\n  getLinkedObservationsForSymbols(qualifiedNames: string[], limit = 5): ScoredObservation[] {\n    if (qualifiedNames.length === 0) return [];\n    const placeholders = qualifiedNames.map(() => '?').join(',');\n    const rows = this.db.all(\n      `SELECT DISTINCT o.*, MAX(l.relevance) as relevance FROM mem_observations o\n       JOIN mem_links l ON l.observation_id = o.id\n       WHERE l.qualified_name IN (${placeholders})\n       GROUP BY o.id\n       ORDER BY relevance DESC, o.created_at DESC\n       LIMIT ?`,\n      [...qualifiedNames, limit]\n    );\n\n    return rows.map((row: any) => ({\n      observation: this.rowToObservation(row),\n      score: row.relevance ?? 1.0,\n      scoreSource: 'fts' as const,\n    }));\n  }\n\n  // \u2500\u2500 Vectors \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  insertVector(observationId: string, embedding: Buffer, model: string): void {\n    this.db.run(\n      `INSERT OR REPLACE INTO mem_vectors (observation_id, embedding, model, created_at)\n       VALUES (?, ?, ?, ?)`,\n      [observationId, embedding, model, Date.now()]\n    );\n  }\n\n  getVector(observationId: string): { embedding: Buffer; model: string } | null {\n    const row = this.db.get(\n      'SELECT embedding, model FROM mem_vectors WHERE observation_id = ?',\n      [observationId]\n    );\n    return row ? { embedding: row.embedding, model: row.model } : null;\n  }\n\n  getVectorCount(): number {\n    const row = this.db.get('SELECT COUNT(*) as count FROM mem_vectors');\n    return row?.count ?? 0;\n  }\n\n  getVectorModelMismatch(currentModel: string): number {\n    const row = this.db.get(\n      'SELECT COUNT(*) as count FROM mem_vectors WHERE model != ?',\n      [currentModel]\n    );\n    return row?.count ?? 0;\n  }\n\n  getAllVectors(model?: string): Array<{ observationId: string; embedding: Buffer }> {\n    const sql = model\n      ? 'SELECT observation_id, embedding FROM mem_vectors WHERE model = ?'\n      : 'SELECT observation_id, embedding FROM mem_vectors';\n    const params = model ? [model] : [];\n    return this.db.all(sql, params).map((row: any) => ({\n      observationId: row.observation_id,\n      embedding: row.embedding,\n    }));\n  }\n\n  deleteVectors(): void {\n    this.db.run('DELETE FROM mem_vectors');\n  }\n\n  // \u2500\u2500 Stats \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  getStats(currentModel?: string): MemStats {\n    const sessions = this.db.get('SELECT COUNT(*) as c FROM mem_sessions')?.c ?? 0;\n    const activeSessions = this.db.get('SELECT COUNT(*) as c FROM mem_sessions WHERE ended_at IS NULL')?.c ?? 0;\n    const observations = this.db.get('SELECT COUNT(*) as c FROM mem_observations')?.c ?? 0;\n    const links = this.db.get('SELECT COUNT(*) as c FROM mem_links')?.c ?? 0;\n    const vectors = this.db.get('SELECT COUNT(*) as c FROM mem_vectors')?.c ?? 0;\n    const mismatch = currentModel ? this.getVectorModelMismatch(currentModel) : 0;\n\n    return {\n      sessions,\n      activeSessions,\n      observations,\n      links,\n      vectors,\n      embeddableCount: observations,\n      modelMismatch: mismatch > 0,\n      currentModel,\n    };\n  }\n\n  // \u2500\u2500 Maintenance \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Delete observations older than the given timestamp.\n   * Cascades to mem_links and mem_vectors via FK.\n   */\n  prune(olderThan: number): number {\n    // Get IDs to delete (for FTS cleanup)\n    const ids = this.db.all(\n      'SELECT id FROM mem_observations WHERE created_at < ?',\n      [olderThan]\n    ).map((r: any) => r.id);\n\n    if (ids.length === 0) return 0;\n\n    const placeholders = ids.map(() => '?').join(',');\n    this.db.run(`DELETE FROM mem_fts WHERE id IN (${placeholders})`, ids);\n    this.db.run(`DELETE FROM mem_observations WHERE created_at < ?`, [olderThan]);\n\n    // Clean up empty sessions\n    this.db.run(\n      `DELETE FROM mem_sessions WHERE id NOT IN (SELECT DISTINCT session_id FROM mem_observations WHERE session_id IS NOT NULL)`\n    );\n\n    return ids.length;\n  }\n\n  /**\n   * Find stale links where qualified_name no longer exists in the nodes table.\n   */\n  findStaleLinks(): MemLink[] {\n    const rows = this.db.all(\n      `SELECT l.* FROM mem_links l\n       LEFT JOIN nodes n ON n.qualified_name = l.qualified_name\n       WHERE n.id IS NULL`\n    );\n    return rows.map((row: any) => ({\n      observationId: row.observation_id,\n      qualifiedName: row.qualified_name,\n      relevance: row.relevance,\n    }));\n  }\n\n  /**\n   * Remove stale links (where qualified_name no longer resolves).\n   */\n  removeStaleLinks(): number {\n    const result = this.db.run(\n      `DELETE FROM mem_links WHERE qualified_name NOT IN (SELECT DISTINCT qualified_name FROM nodes)`\n    );\n    return result?.changes ?? 0;\n  }\n\n  /**\n   * Close stale sessions (started but never ended, older than timeout).\n   */\n  closeStaleSessionsOlderThan(timeoutMs: number): number {\n    const cutoff = Date.now() - timeoutMs;\n    const result = this.db.run(\n      `UPDATE mem_sessions SET ended_at = ? WHERE ended_at IS NULL AND started_at < ?`,\n      [Date.now(), cutoff]\n    );\n    return result?.changes ?? 0;\n  }\n\n  // \u2500\u2500 Privacy \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Strip <private>...</private> blocks from text.\n   */\n  static stripPrivate(text: string): string {\n    return text.replace(/<private>[\\s\\S]*?<\\/private>/gi, '').trim();\n  }\n\n  // \u2500\u2500 Row mappers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  private rowToSession(row: any): MemSession {\n    return {\n      id: row.id,\n      ide: row.ide ?? undefined,\n      cwd: row.cwd ?? undefined,\n      startedAt: row.started_at,\n      endedAt: row.ended_at ?? undefined,\n    };\n  }\n\n  private rowToObservation(row: any): MemObservation {\n    return {\n      id: row.id,\n      sessionId: row.session_id ?? undefined,\n      content: row.content,\n      contentRaw: row.content_raw ?? undefined,\n      contentHash: row.content_hash,\n      kind: row.kind,\n      source: row.source,\n      tags: row.tags ? JSON.parse(row.tags) : undefined,\n      createdAt: row.created_at,\n      validFrom: row.valid_from ?? undefined,\n      validUntil: row.valid_until ?? undefined,\n      supersededBy: row.superseded_by ?? undefined,\n      factType: row.fact_type ?? undefined,\n    };\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * KiroGraph Memory \u2014 Database layer\n *\n * Operates on mem_* tables within the same SQLite database as the code graph.\n * Completely isolated: no FK to core nodes/edges tables.\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport * as crypto from 'crypto';\nimport type {\n  MemSession,\n  MemObservation,\n  MemObservationInput,\n  MemLink,\n  ScoredObservation,\n  MemSearchOptions,\n  MemTimelineOptions,\n  MemStats,\n} from './types';\n\n// \u2500\u2500 Helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction generateId(): string {\n  return crypto.randomUUID();\n}\n\nfunction hashContent(content: string): string {\n  return crypto.createHash('sha256').update(content).digest('hex');\n}\n\n// \u2500\u2500 MemoryDatabase \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport class MemoryDatabase {\n  private db: any;\n  private initialized = false;\n\n  constructor(db: any) {\n    this.db = db;\n  }\n\n  /**\n   * Apply memory schema. Called once when enableMemory is true.\n   */\n  initialize(): void {\n    if (this.initialized) return;\n    const schemaPath = path.join(__dirname, '../db/memory-schema.sql');\n    const sql = fs.readFileSync(schemaPath, 'utf8');\n    this.db.exec(sql);\n\n    // Migration: add temporal columns if they don't exist (for existing databases)\n    this.migrateTemporalColumns();\n\n    this.initialized = true;\n  }\n\n  /**\n   * Add temporal fact columns to mem_observations if missing.\n   * Safe to run multiple times (uses IF NOT EXISTS pattern via try/catch).\n   */\n  private migrateTemporalColumns(): void {\n    const columnsToAdd = [\n      { name: 'valid_from', type: 'INTEGER' },\n      { name: 'valid_until', type: 'INTEGER' },\n      { name: 'superseded_by', type: 'TEXT' },\n      { name: 'fact_type', type: \"TEXT DEFAULT 'observation'\" },\n    ];\n\n    for (const col of columnsToAdd) {\n      try {\n        this.db.exec(`ALTER TABLE mem_observations ADD COLUMN ${col.name} ${col.type}`);\n      } catch {\n        // Column already exists \u2014 ignore\n      }\n    }\n  }\n\n  // \u2500\u2500 Watchmen \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Count non-summary observations created after the most recent summary.\n   * Used by WatchmenChecker to decide if synthesis should trigger.\n   */\n  countSinceLastSummary(): number {\n    const lastSummary = this.db.get(\n      `SELECT created_at FROM mem_observations WHERE kind = 'summary' ORDER BY created_at DESC LIMIT 1`\n    ) as { created_at: number } | undefined;\n\n    const since = lastSummary?.created_at ?? 0;\n    const row = this.db.get(\n      `SELECT COUNT(*) as count FROM mem_observations WHERE kind != 'summary' AND created_at > ?`,\n      [since]\n    ) as { count: number };\n\n    return row?.count ?? 0;\n  }\n\n  getObservationsSinceLastSummary(limit = 50): MemObservation[] {\n    const lastSummary = this.db.get(\n      `SELECT created_at FROM mem_observations WHERE kind = 'summary' ORDER BY created_at DESC LIMIT 1`\n    ) as { created_at: number } | undefined;\n\n    const since = lastSummary?.created_at ?? 0;\n    const rows = this.db.all(\n      `SELECT * FROM mem_observations WHERE kind != 'summary' AND created_at > ?\n       ORDER BY created_at DESC LIMIT ?`,\n      [since, limit]\n    ) as any[];\n\n    return rows.map(row => ({\n      id: row.id,\n      sessionId: row.session_id ?? undefined,\n      content: row.content,\n      contentRaw: row.content_raw ?? undefined,\n      contentHash: row.content_hash,\n      kind: row.kind,\n      source: row.source,\n      tags: row.tags ? JSON.parse(row.tags) : undefined,\n      createdAt: row.created_at,\n    }));\n  }\n\n  // \u2500\u2500 Sessions \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Get or create an active session. Auto-creates if no active session exists\n   * within the timeout window.\n   */\n  getOrCreateSession(ide: string, cwd: string, timeoutSeconds = 7200): string {\n    const cutoff = Date.now() - (timeoutSeconds * 1000);\n\n    // Look for an active session (no ended_at, same ide, started within timeout)\n    const existing = this.db.get(\n      `SELECT id FROM mem_sessions\n       WHERE ended_at IS NULL AND ide = ? AND started_at > ?\n       ORDER BY started_at DESC LIMIT 1`,\n      [ide, cutoff]\n    );\n\n    if (existing) return existing.id;\n\n    // Auto-close any stale sessions for this IDE\n    this.db.run(\n      `UPDATE mem_sessions SET ended_at = ? WHERE ended_at IS NULL AND ide = ?`,\n      [Date.now(), ide]\n    );\n\n    // Create new session\n    const id = generateId();\n    this.db.run(\n      `INSERT INTO mem_sessions (id, ide, cwd, started_at) VALUES (?, ?, ?, ?)`,\n      [id, ide, cwd, Date.now()]\n    );\n    return id;\n  }\n\n  endSession(sessionId: string): void {\n    this.db.run(\n      `UPDATE mem_sessions SET ended_at = ? WHERE id = ? AND ended_at IS NULL`,\n      [Date.now(), sessionId]\n    );\n  }\n\n  getSession(sessionId: string): MemSession | null {\n    const row = this.db.get('SELECT * FROM mem_sessions WHERE id = ?', [sessionId]);\n    return row ? this.rowToSession(row) : null;\n  }\n\n  listSessions(limit = 10): MemSession[] {\n    return this.db.all(\n      'SELECT * FROM mem_sessions ORDER BY started_at DESC LIMIT ?',\n      [limit]\n    ).map(this.rowToSession);\n  }\n\n  // \u2500\u2500 Observations \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Insert an observation. Returns the ID, or null if a duplicate (same content_hash).\n   */\n  insertObservation(\n    content: string,\n    opts: {\n      contentRaw?: string;\n      kind?: string;\n      source?: string;\n      tags?: string[];\n      sessionId?: string;\n    } = {}\n  ): string | null {\n    const id = generateId();\n    const contentHash = hashContent(content);\n    const kind = opts.kind ?? 'note';\n    const source = opts.source ?? 'manual';\n    const tags = opts.tags ? JSON.stringify(opts.tags) : null;\n    const now = Date.now();\n\n    try {\n      this.db.run(\n        `INSERT INTO mem_observations (id, session_id, content, content_raw, content_hash, kind, source, tags, created_at)\n         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n        [id, opts.sessionId ?? null, content, opts.contentRaw ?? null, contentHash, kind, source, tags, now]\n      );\n    } catch (err: any) {\n      // Unique constraint on content_hash \u2014 duplicate, skip silently\n      if (err.message?.includes('UNIQUE constraint failed') || err.message?.includes('unique')) {\n        return null;\n      }\n      throw err;\n    }\n\n    // Keep FTS in sync\n    this.db.run(\n      `INSERT INTO mem_fts (id, content, kind) VALUES (?, ?, ?)`,\n      [id, content, kind]\n    );\n\n    return id;\n  }\n\n  getObservation(id: string): MemObservation | null {\n    const row = this.db.get('SELECT * FROM mem_observations WHERE id = ?', [id]);\n    return row ? this.rowToObservation(row) : null;\n  }\n\n  getObservationsBySession(sessionId: string, limit = 50): MemObservation[] {\n    return this.db.all(\n      'SELECT * FROM mem_observations WHERE session_id = ? ORDER BY created_at DESC LIMIT ?',\n      [sessionId, limit]\n    ).map(this.rowToObservation);\n  }\n\n  getObservationsByTimeRange(from: number, to: number, limit = 50): MemObservation[] {\n    return this.db.all(\n      'SELECT * FROM mem_observations WHERE created_at >= ? AND created_at <= ? ORDER BY created_at DESC LIMIT ?',\n      [from, to, limit]\n    ).map(this.rowToObservation);\n  }\n\n  // \u2500\u2500 FTS Search \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  searchFTS(query: string, opts: MemSearchOptions = {}): ScoredObservation[] {\n    const { limit = 10, kind, sessionId, asOf } = opts;\n\n    // Sanitize for FTS5\n    const safe = query\n      .replace(/\\b(AND|OR|NOT)\\b/g, ' ')\n      .replace(/['\"*()?\\-+^~:{}\\\\\\.\\/,]/g, ' ')\n      .replace(/\\s+/g, ' ')\n      .trim();\n    if (!safe) return [];\n\n    const ftsQuery = safe + '*';\n    const safeLimit = Math.max(1, Math.floor(Number(limit)));\n\n    const conditions: string[] = [];\n    const params: any[] = [];\n\n    if (kind) {\n      conditions.push('o.kind = ?');\n      params.push(kind);\n    }\n    if (sessionId) {\n      conditions.push('o.session_id = ?');\n      params.push(sessionId);\n    }\n\n    // Temporal filtering: exclude expired and superseded facts\n    if (asOf) {\n      conditions.push('(o.valid_from IS NULL OR o.valid_from <= ?)');\n      params.push(asOf);\n      conditions.push('(o.valid_until IS NULL OR o.valid_until > ?)');\n      params.push(asOf);\n      conditions.push('o.superseded_by IS NULL');\n    }\n\n    const where = conditions.length > 0 ? `AND ${conditions.join(' AND ')}` : '';\n\n    const rows = this.db.all(\n      `SELECT o.*, rank FROM mem_fts f\n       JOIN mem_observations o ON o.id = f.id\n       WHERE mem_fts MATCH '${ftsQuery}' ${where}\n       ORDER BY rank\n       LIMIT ${safeLimit}`,\n      params\n    );\n\n    return rows.map((row: any) => ({\n      observation: this.rowToObservation(row),\n      score: Math.abs(row.rank ?? 0),\n      scoreSource: 'fts' as const,\n    }));\n  }\n\n  // \u2500\u2500 Links \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  linkToSymbol(observationId: string, qualifiedName: string, relevance = 1.0): void {\n    this.db.run(\n      `INSERT OR IGNORE INTO mem_links (observation_id, qualified_name, relevance)\n       VALUES (?, ?, ?)`,\n      [observationId, qualifiedName, relevance]\n    );\n  }\n\n  linkToSymbols(observationId: string, qualifiedNames: string[]): void {\n    for (const qn of qualifiedNames) {\n      this.linkToSymbol(observationId, qn);\n    }\n  }\n\n  /**\n   * Get observations linked to a symbol by qualified_name.\n   * Resolves through mem_links \u2014 no dependency on node IDs.\n   */\n  getLinkedObservations(qualifiedName: string, limit = 10): ScoredObservation[] {\n    const rows = this.db.all(\n      `SELECT o.*, l.relevance FROM mem_observations o\n       JOIN mem_links l ON l.observation_id = o.id\n       WHERE l.qualified_name = ?\n       ORDER BY l.relevance DESC, o.created_at DESC\n       LIMIT ?`,\n      [qualifiedName, limit]\n    );\n\n    return rows.map((row: any) => ({\n      observation: this.rowToObservation(row),\n      score: row.relevance ?? 1.0,\n      scoreSource: 'fts' as const,\n    }));\n  }\n\n  /**\n   * Get observations linked to any of the given qualified names.\n   * Used by kirograph_context and kirograph_impact to surface memory.\n   */\n  getLinkedObservationsForSymbols(qualifiedNames: string[], limit = 5): ScoredObservation[] {\n    if (qualifiedNames.length === 0) return [];\n    const placeholders = qualifiedNames.map(() => '?').join(',');\n    const rows = this.db.all(\n      `SELECT DISTINCT o.*, MAX(l.relevance) as relevance FROM mem_observations o\n       JOIN mem_links l ON l.observation_id = o.id\n       WHERE l.qualified_name IN (${placeholders})\n       GROUP BY o.id\n       ORDER BY relevance DESC, o.created_at DESC\n       LIMIT ?`,\n      [...qualifiedNames, limit]\n    );\n\n    return rows.map((row: any) => ({\n      observation: this.rowToObservation(row),\n      score: row.relevance ?? 1.0,\n      scoreSource: 'fts' as const,\n    }));\n  }\n\n  // \u2500\u2500 Vectors \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  insertVector(observationId: string, embedding: Buffer, model: string): void {\n    this.db.run(\n      `INSERT OR REPLACE INTO mem_vectors (observation_id, embedding, model, created_at)\n       VALUES (?, ?, ?, ?)`,\n      [observationId, embedding, model, Date.now()]\n    );\n  }\n\n  getVector(observationId: string): { embedding: Buffer; model: string } | null {\n    const row = this.db.get(\n      'SELECT embedding, model FROM mem_vectors WHERE observation_id = ?',\n      [observationId]\n    );\n    return row ? { embedding: row.embedding, model: row.model } : null;\n  }\n\n  getVectorCount(): number {\n    const row = this.db.get('SELECT COUNT(*) as count FROM mem_vectors');\n    return row?.count ?? 0;\n  }\n\n  getVectorModelMismatch(currentModel: string): number {\n    const row = this.db.get(\n      'SELECT COUNT(*) as count FROM mem_vectors WHERE model != ?',\n      [currentModel]\n    );\n    return row?.count ?? 0;\n  }\n\n  getAllVectors(model?: string): Array<{ observationId: string; embedding: Buffer }> {\n    const sql = model\n      ? 'SELECT observation_id, embedding FROM mem_vectors WHERE model = ?'\n      : 'SELECT observation_id, embedding FROM mem_vectors';\n    const params = model ? [model] : [];\n    return this.db.all(sql, params).map((row: any) => ({\n      observationId: row.observation_id,\n      embedding: row.embedding,\n    }));\n  }\n\n  deleteVectors(): void {\n    this.db.run('DELETE FROM mem_vectors');\n  }\n\n  // \u2500\u2500 Stats \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  getStats(currentModel?: string): MemStats {\n    const sessions = this.db.get('SELECT COUNT(*) as c FROM mem_sessions')?.c ?? 0;\n    const activeSessions = this.db.get('SELECT COUNT(*) as c FROM mem_sessions WHERE ended_at IS NULL')?.c ?? 0;\n    const observations = this.db.get('SELECT COUNT(*) as c FROM mem_observations')?.c ?? 0;\n    const links = this.db.get('SELECT COUNT(*) as c FROM mem_links')?.c ?? 0;\n    const vectors = this.db.get('SELECT COUNT(*) as c FROM mem_vectors')?.c ?? 0;\n    const mismatch = currentModel ? this.getVectorModelMismatch(currentModel) : 0;\n\n    return {\n      sessions,\n      activeSessions,\n      observations,\n      links,\n      vectors,\n      embeddableCount: observations,\n      modelMismatch: mismatch > 0,\n      currentModel,\n    };\n  }\n\n  // \u2500\u2500 Maintenance \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Delete observations older than the given timestamp.\n   * Cascades to mem_links and mem_vectors via FK.\n   */\n  prune(olderThan: number): number {\n    // Get IDs to delete (for FTS cleanup)\n    const ids = this.db.all(\n      'SELECT id FROM mem_observations WHERE created_at < ?',\n      [olderThan]\n    ).map((r: any) => r.id);\n\n    if (ids.length === 0) return 0;\n\n    const placeholders = ids.map(() => '?').join(',');\n    this.db.run(`DELETE FROM mem_fts WHERE id IN (${placeholders})`, ids);\n    this.db.run(`DELETE FROM mem_observations WHERE created_at < ?`, [olderThan]);\n\n    // Clean up empty sessions\n    this.db.run(\n      `DELETE FROM mem_sessions WHERE id NOT IN (SELECT DISTINCT session_id FROM mem_observations WHERE session_id IS NOT NULL)`\n    );\n\n    return ids.length;\n  }\n\n  /**\n   * Find stale links where qualified_name no longer exists in the nodes table.\n   */\n  findStaleLinks(): MemLink[] {\n    const rows = this.db.all(\n      `SELECT l.* FROM mem_links l\n       LEFT JOIN nodes n ON n.qualified_name = l.qualified_name\n       WHERE n.id IS NULL`\n    );\n    return rows.map((row: any) => ({\n      observationId: row.observation_id,\n      qualifiedName: row.qualified_name,\n      relevance: row.relevance,\n    }));\n  }\n\n  /**\n   * Remove stale links (where qualified_name no longer resolves).\n   */\n  removeStaleLinks(): number {\n    const result = this.db.run(\n      `DELETE FROM mem_links WHERE qualified_name NOT IN (SELECT DISTINCT qualified_name FROM nodes)`\n    );\n    return result?.changes ?? 0;\n  }\n\n  /**\n   * Close stale sessions (started but never ended, older than timeout).\n   */\n  closeStaleSessionsOlderThan(timeoutMs: number): number {\n    const cutoff = Date.now() - timeoutMs;\n    const result = this.db.run(\n      `UPDATE mem_sessions SET ended_at = ? WHERE ended_at IS NULL AND started_at < ?`,\n      [Date.now(), cutoff]\n    );\n    return result?.changes ?? 0;\n  }\n\n  // \u2500\u2500 Privacy \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Strip <private>...</private> blocks from text.\n   */\n  static stripPrivate(text: string): string {\n    return text.replace(/<private>[\\s\\S]*?<\\/private>/gi, '').trim();\n  }\n\n  // \u2500\u2500 Row mappers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  private rowToSession(row: any): MemSession {\n    return {\n      id: row.id,\n      ide: row.ide ?? undefined,\n      cwd: row.cwd ?? undefined,\n      startedAt: row.started_at,\n      endedAt: row.ended_at ?? undefined,\n    };\n  }\n\n  private rowToObservation(row: any): MemObservation {\n    return {\n      id: row.id,\n      sessionId: row.session_id ?? undefined,\n      content: row.content,\n      contentRaw: row.content_raw ?? undefined,\n      contentHash: row.content_hash,\n      kind: row.kind,\n      source: row.source,\n      tags: row.tags ? JSON.parse(row.tags) : undefined,\n      createdAt: row.created_at,\n      validFrom: row.valid_from ?? undefined,\n      validUntil: row.valid_until ?? undefined,\n      supersededBy: row.superseded_by ?? undefined,\n      factType: row.fact_type ?? undefined,\n    };\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/memory/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * KiroGraph Memory — Public API
+ *
+ * MemoryManager is the single entry point for all memory operations.
+ * Coordinates compression, storage, symbol detection, and embedding.
+ */
+import type { KiroGraphConfig } from '../config';
+import type { MemObservation, MemObservationInput, MemSession, ScoredObservation, MemSearchOptions, MemTimelineOptions, MemStats } from './types';
+export { MemoryDatabase } from './database';
+export { compressObservation, extractIdentifiers, type CavemanMode } from './compress';
+export { detectSymbols } from './symbols';
+export { MemoryVectorManager } from './vectors';
+export * from './types';
+export declare class MemoryManager {
+    private memDb;
+    private vectorMgr;
+    private config;
+    private db;
+    private cavemanMode;
+    private excludePatterns;
+    constructor(config: KiroGraphConfig, db: any);
+    /**
+     * Initialize memory tables. Must be called before any operations.
+     */
+    initialize(): void;
+    /**
+     * Check if memory is enabled in config.
+     */
+    static isEnabled(config: KiroGraphConfig): boolean;
+    /**
+     * Store an observation. Handles:
+     * 1. Privacy stripping (<private> blocks)
+     * 2. Exclude pattern checking
+     * 3. Caveman compression (if enabled)
+     * 4. Deduplication (content hash)
+     * 5. Symbol detection and linking
+     * 6. Embedding (if enabled)
+     *
+     * Returns the observation ID, or null if skipped (duplicate or excluded).
+     */
+    store(input: MemObservationInput, ide?: string): Promise<string | null>;
+    /**
+     * Hybrid search: combines FTS5 and vector search with configurable alpha.
+     */
+    search(query: string, opts?: MemSearchOptions): Promise<ScoredObservation[]>;
+    /**
+     * Get observations linked to specific symbols.
+     * Used by kirograph_context and kirograph_impact.
+     */
+    getLinkedObservations(qualifiedNames: string[], limit?: number, threshold?: number): ScoredObservation[];
+    /**
+     * List sessions with their observation counts.
+     */
+    timeline(opts?: MemTimelineOptions): {
+        sessions: MemSession[];
+        observations: Map<string, MemObservation[]>;
+    };
+    getStats(): MemStats;
+    endCurrentSession(ide?: string): void;
+    prune(olderThanMs: number): number;
+    reembed(batchSize?: number): Promise<number>;
+    lint(): {
+        staleLinks: number;
+        modelMismatch: boolean;
+        staleSessions: number;
+    };
+    removeStaleLinks(): number;
+    private shouldExclude;
+    private mergeResults;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,QAAQ,EAET,MAAM,SAAS,CAAC;AAOjB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,cAAc,SAAS,CAAC;AAIxB,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,EAAE,CAAM;IAChB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,eAAe,CAAW;gBAEtB,MAAM,EAAE,eAAe,EAAE,EAAE,EAAE,GAAG;IAS5C;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO;IAMlD;;;;;;;;;;OAUG;IACG,KAAK,CAAC,KAAK,EAAE,mBAAmB,EAAE,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiE7E;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAsBtF;;;OAGG;IACH,qBAAqB,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,KAAK,SAAI,EAAE,SAAS,SAAM,GAAG,iBAAiB,EAAE;IAOhG;;OAEG;IACH,QAAQ,CAAC,IAAI,GAAE,kBAAuB,GAAG;QAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;QAAC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAA;KAAE;IAuBhH,QAAQ,IAAI,QAAQ;IAOpB,iBAAiB,CAAC,GAAG,SAAS,GAAG,IAAI;IAUrC,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAK5B,OAAO,CAAC,SAAS,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9C,IAAI,IAAI;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE;IAQ7E,gBAAgB,IAAI,MAAM;IAM1B,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,YAAY;CAsCrB"}

package/dist/memory/index.js

@@ -31,6 +31,7 @@ var import_database = require("./database");
 var import_compress = require("./compress");
 var import_symbols = require("./symbols");
 var import_vectors = require("./vectors");
+var import_watchmen = require("../watchmen");
 var import_errors = require("../errors");
 var import_database2 = require("./database");
 var import_compress2 = require("./compress");
@@ -38,13 +39,15 @@ var import_symbols2 = require("./symbols");
 var import_vectors2 = require("./vectors");
 __reExport(memory_exports, require("./types"), module.exports);
 class MemoryManager {
-  constructor(config, db) {
+  constructor(config, db, projectRoot = process.cwd()) {
     this.config = config;
     this.db = db;
+    this.projectRoot = projectRoot;
     this.memDb = new import_database.MemoryDatabase(db);
     this.vectorMgr = new import_vectors.MemoryVectorManager(config, this.memDb);
     this.cavemanMode = config.cavemanMode ?? "off";
     this.excludePatterns = config.memoryExcludePatterns ?? [];
+    this.watchmenChecker = config.enableWatchmen ? new import_watchmen.WatchmenChecker(config.watchmenThreshold) : null;
   }
   /**
    * Initialize memory tables. Must be called before any operations.
@@ -67,8 +70,9 @@ class MemoryManager {
    * 4. Deduplication (content hash)
    * 5. Symbol detection and linking
    * 6. Embedding (if enabled)
+   * 7. Watchmen threshold check (if enabled) — returns WatchmenReadyResult when synthesis should run
    *
-   * Returns the observation ID, or null if skipped (duplicate or excluded).
+   * Returns the observation ID, a WatchmenReadyResult, or null if skipped (duplicate or excluded).
    */
   async store(input, ide = "kiro") {
     let text = input.content;
@@ -112,6 +116,12 @@ class MemoryManager {
     if (obs) {
       await this.vectorMgr.embedObservation(obs);
     }
+    if (this.watchmenChecker && input.kind !== "summary") {
+      const check = this.watchmenChecker.shouldSynthesize(this.memDb);
+      if (check.ready) {
+        return this.watchmenChecker.buildReadyResponse(id, check.pendingCount, this.projectRoot);
+      }
+    }
     return id;
   }
   // ── Search ─────────────────────────────────────────────────────────────────

package/dist/memory/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/memory/index.ts"],
-  "sourcesContent": ["/**\n * KiroGraph Memory \u2014 Public API\n *\n * MemoryManager is the single entry point for all memory operations.\n * Coordinates compression, storage, symbol detection, and embedding.\n */\n\nimport type { KiroGraphConfig } from '../config';\nimport type {\n  MemObservation,\n  MemObservationInput,\n  MemSession,\n  ScoredObservation,\n  MemSearchOptions,\n  MemTimelineOptions,\n  MemStats,\n  CompressResult,\n} from './types';\nimport { MemoryDatabase } from './database';\nimport { compressObservation, type CavemanMode } from './compress';\nimport { detectSymbols } from './symbols';\nimport { MemoryVectorManager } from './vectors';\nimport { logDebug } from '../errors';\n\nexport { MemoryDatabase } from './database';\nexport { compressObservation, extractIdentifiers, type CavemanMode } from './compress';\nexport { detectSymbols } from './symbols';\nexport { MemoryVectorManager } from './vectors';\nexport * from './types';\n\n// \u2500\u2500 MemoryManager \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport class MemoryManager {\n  private memDb: MemoryDatabase;\n  private vectorMgr: MemoryVectorManager;\n  private config: KiroGraphConfig;\n  private db: any; // raw sqlite handle for symbol detection\n  private cavemanMode: CavemanMode;\n  private excludePatterns: string[];\n\n  constructor(config: KiroGraphConfig, db: any) {\n    this.config = config;\n    this.db = db;\n    this.memDb = new MemoryDatabase(db);\n    this.vectorMgr = new MemoryVectorManager(config, this.memDb);\n    this.cavemanMode = (config as any).cavemanMode ?? 'off';\n    this.excludePatterns = (config as any).memoryExcludePatterns ?? [];\n  }\n\n  /**\n   * Initialize memory tables. Must be called before any operations.\n   */\n  initialize(): void {\n    this.memDb.initialize();\n  }\n\n  /**\n   * Check if memory is enabled in config.\n   */\n  static isEnabled(config: KiroGraphConfig): boolean {\n    return !!(config as any).enableMemory;\n  }\n\n  // \u2500\u2500 Store \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Store an observation. Handles:\n   * 1. Privacy stripping (<private> blocks)\n   * 2. Exclude pattern checking\n   * 3. Caveman compression (if enabled)\n   * 4. Deduplication (content hash)\n   * 5. Symbol detection and linking\n   * 6. Embedding (if enabled)\n   *\n   * Returns the observation ID, or null if skipped (duplicate or excluded).\n   */\n  async store(input: MemObservationInput, ide = 'kiro'): Promise<string | null> {\n    let text = input.content;\n\n    // 1. Strip <private> blocks\n    text = MemoryDatabase.stripPrivate(text);\n    if (!text.trim()) return null;\n\n    // 2. Check exclude patterns\n    if (this.shouldExclude(text)) return null;\n\n    // 3. Compress (if caveman is on)\n    let contentRaw: string | undefined;\n    if (this.cavemanMode !== 'off') {\n      const result = compressObservation(text, this.cavemanMode);\n      contentRaw = text;\n      text = result.compressed;\n    }\n\n    // 4. Get or create session\n    const cwd = process.cwd();\n    const sessionTimeout = (this.config as any).memorySessionTimeout ?? 7200;\n    const sessionId = this.memDb.getOrCreateSession(ide, cwd, sessionTimeout);\n\n    // 5. Insert observation (deduplicates via content_hash)\n    const id = this.memDb.insertObservation(text, {\n      contentRaw: this.cavemanMode !== 'off' ? contentRaw : undefined,\n      kind: input.kind ?? 'note',\n      source: input.source ?? 'manual',\n      tags: input.tags,\n      sessionId,\n    });\n\n    if (!id) {\n      logDebug('Memory: duplicate observation skipped');\n      return null;\n    }\n\n    // 6. Detect and link symbols\n    const symbols = detectSymbols(text, this.db);\n    if (symbols.length > 0) {\n      this.memDb.linkToSymbols(id, symbols.map(s => s.qualifiedName));\n    }\n\n    // Also detect in raw text if different\n    if (contentRaw) {\n      const rawSymbols = detectSymbols(contentRaw, this.db);\n      const extraSymbols = rawSymbols.filter(\n        s => !symbols.some(existing => existing.qualifiedName === s.qualifiedName)\n      );\n      if (extraSymbols.length > 0) {\n        this.memDb.linkToSymbols(id, extraSymbols.map(s => s.qualifiedName));\n      }\n    }\n\n    // 7. Embed (async, non-blocking for the store operation)\n    const obs = this.memDb.getObservation(id);\n    if (obs) {\n      await this.vectorMgr.embedObservation(obs);\n    }\n\n    return id;\n  }\n\n  // \u2500\u2500 Search \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Hybrid search: combines FTS5 and vector search with configurable alpha.\n   */\n  async search(query: string, opts: MemSearchOptions = {}): Promise<ScoredObservation[]> {\n    const limit = opts.limit ?? 10;\n    const alpha = opts.alpha ?? (this.config as any).memorySearchAlpha ?? 0.5;\n\n    // FTS search\n    const ftsResults = this.memDb.searchFTS(query, { ...opts, limit: limit * 2 });\n\n    // Vector search (if enabled and no model mismatch)\n    let vectorResults: ScoredObservation[] = [];\n    if (this.vectorMgr.isEnabled() && !this.vectorMgr.hasModelMismatch()) {\n      vectorResults = await this.vectorMgr.search(query, limit * 2);\n    }\n\n    // If only one source has results, return it directly\n    if (vectorResults.length === 0) return ftsResults.slice(0, limit);\n    if (ftsResults.length === 0) return vectorResults.slice(0, limit);\n\n    // Hybrid merge: normalize scores and blend\n    const merged = this.mergeResults(ftsResults, vectorResults, alpha);\n    return merged.slice(0, limit);\n  }\n\n  /**\n   * Get observations linked to specific symbols.\n   * Used by kirograph_context and kirograph_impact.\n   */\n  getLinkedObservations(qualifiedNames: string[], limit = 3, threshold = 0.3): ScoredObservation[] {\n    const results = this.memDb.getLinkedObservationsForSymbols(qualifiedNames, limit * 2);\n    return results.filter(r => r.score >= threshold).slice(0, limit);\n  }\n\n  // \u2500\u2500 Timeline \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * List sessions with their observation counts.\n   */\n  timeline(opts: MemTimelineOptions = {}): { sessions: MemSession[]; observations: Map<string, MemObservation[]> } {\n    const limit = opts.limit ?? 5;\n\n    if (opts.sessionId) {\n      const session = this.memDb.getSession(opts.sessionId);\n      if (!session) return { sessions: [], observations: new Map() };\n      const obs = this.memDb.getObservationsBySession(opts.sessionId);\n      const map = new Map<string, MemObservation[]>();\n      map.set(opts.sessionId, obs);\n      return { sessions: [session], observations: map };\n    }\n\n    const sessions = this.memDb.listSessions(limit);\n    const observations = new Map<string, MemObservation[]>();\n    for (const session of sessions) {\n      const obs = this.memDb.getObservationsBySession(session.id, 10);\n      observations.set(session.id, obs);\n    }\n    return { sessions, observations };\n  }\n\n  // \u2500\u2500 Status \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  getStats(): MemStats {\n    const modelName = (this.config as any).embeddingModel ?? 'nomic-ai/nomic-embed-text-v1.5';\n    return this.memDb.getStats(modelName);\n  }\n\n  // \u2500\u2500 Session management \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  endCurrentSession(ide = 'kiro'): void {\n    const cwd = process.cwd();\n    const sessionTimeout = (this.config as any).memorySessionTimeout ?? 7200;\n    // Find active session and close it\n    const sessionId = this.memDb.getOrCreateSession(ide, cwd, sessionTimeout);\n    this.memDb.endSession(sessionId);\n  }\n\n  // \u2500\u2500 Maintenance \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  prune(olderThanMs: number): number {\n    const cutoff = Date.now() - olderThanMs;\n    return this.memDb.prune(cutoff);\n  }\n\n  async reembed(batchSize = 32): Promise<number> {\n    return this.vectorMgr.reembed(batchSize);\n  }\n\n  lint(): { staleLinks: number; modelMismatch: boolean; staleSessions: number } {\n    const staleLinks = this.memDb.findStaleLinks().length;\n    const modelMismatch = this.vectorMgr.hasModelMismatch();\n    const sessionTimeout = ((this.config as any).memorySessionTimeout ?? 7200) * 1000;\n    const staleSessions = this.memDb.closeStaleSessionsOlderThan(sessionTimeout);\n    return { staleLinks, modelMismatch, staleSessions };\n  }\n\n  removeStaleLinks(): number {\n    return this.memDb.removeStaleLinks();\n  }\n\n  // \u2500\u2500 Private \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  private shouldExclude(text: string): boolean {\n    if (this.excludePatterns.length === 0) return false;\n\n    // Simple check: if any exclude pattern appears as a substring in the text\n    // This is a basic implementation; could use picomatch for glob matching\n    for (const pattern of this.excludePatterns) {\n      const normalized = pattern.replace(/\\*/g, '');\n      if (normalized && text.includes(normalized)) return true;\n    }\n    return false;\n  }\n\n  private mergeResults(\n    ftsResults: ScoredObservation[],\n    vectorResults: ScoredObservation[],\n    alpha: number\n  ): ScoredObservation[] {\n    // Normalize FTS scores (rank is negative in FTS5, lower = better)\n    const maxFts = Math.max(...ftsResults.map(r => r.score), 1);\n    const normalizedFts = new Map<string, number>();\n    for (const r of ftsResults) {\n      normalizedFts.set(r.observation.id, r.score / maxFts);\n    }\n\n    // Vector scores are already 0-1 (cosine similarity)\n    const normalizedVec = new Map<string, number>();\n    for (const r of vectorResults) {\n      normalizedVec.set(r.observation.id, r.score);\n    }\n\n    // Merge: collect all unique observation IDs\n    const allIds = new Set([...normalizedFts.keys(), ...normalizedVec.keys()]);\n    const merged: ScoredObservation[] = [];\n\n    // Build a lookup for observations\n    const obsMap = new Map<string, MemObservation>();\n    for (const r of ftsResults) obsMap.set(r.observation.id, r.observation);\n    for (const r of vectorResults) obsMap.set(r.observation.id, r.observation);\n\n    for (const id of allIds) {\n      const ftsScore = normalizedFts.get(id) ?? 0;\n      const vecScore = normalizedVec.get(id) ?? 0;\n      const hybridScore = (1 - alpha) * ftsScore + alpha * vecScore;\n      const obs = obsMap.get(id)!;\n      merged.push({ observation: obs, score: hybridScore, scoreSource: 'hybrid' });\n    }\n\n    merged.sort((a, b) => b.score - a.score);\n    return merged;\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * KiroGraph Memory \u2014 Public API\n *\n * MemoryManager is the single entry point for all memory operations.\n * Coordinates compression, storage, symbol detection, and embedding.\n */\n\nimport type { KiroGraphConfig } from '../config';\nimport type {\n  MemObservation,\n  MemObservationInput,\n  MemSession,\n  ScoredObservation,\n  MemSearchOptions,\n  MemTimelineOptions,\n  MemStats,\n  CompressResult,\n  WatchmenReadyResult,\n} from './types';\nimport { MemoryDatabase } from './database';\nimport { compressObservation, type CavemanMode } from './compress';\nimport { detectSymbols } from './symbols';\nimport { MemoryVectorManager } from './vectors';\nimport { WatchmenChecker } from '../watchmen';\nimport { logDebug } from '../errors';\n\nexport { MemoryDatabase } from './database';\nexport { compressObservation, extractIdentifiers, type CavemanMode } from './compress';\nexport { detectSymbols } from './symbols';\nexport { MemoryVectorManager } from './vectors';\nexport * from './types';\n\n// \u2500\u2500 MemoryManager \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport class MemoryManager {\n  private memDb: MemoryDatabase;\n  private vectorMgr: MemoryVectorManager;\n  private config: KiroGraphConfig;\n  private db: any; // raw sqlite handle for symbol detection\n  private cavemanMode: CavemanMode;\n  private excludePatterns: string[];\n  private watchmenChecker: WatchmenChecker | null;\n  private projectRoot: string;\n\n  constructor(config: KiroGraphConfig, db: any, projectRoot = process.cwd()) {\n    this.config = config;\n    this.db = db;\n    this.projectRoot = projectRoot;\n    this.memDb = new MemoryDatabase(db);\n    this.vectorMgr = new MemoryVectorManager(config, this.memDb);\n    this.cavemanMode = (config as any).cavemanMode ?? 'off';\n    this.excludePatterns = (config as any).memoryExcludePatterns ?? [];\n    this.watchmenChecker = config.enableWatchmen\n      ? new WatchmenChecker(config.watchmenThreshold)\n      : null;\n  }\n\n  /**\n   * Initialize memory tables. Must be called before any operations.\n   */\n  initialize(): void {\n    this.memDb.initialize();\n  }\n\n  /**\n   * Check if memory is enabled in config.\n   */\n  static isEnabled(config: KiroGraphConfig): boolean {\n    return !!(config as any).enableMemory;\n  }\n\n  // \u2500\u2500 Store \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Store an observation. Handles:\n   * 1. Privacy stripping (<private> blocks)\n   * 2. Exclude pattern checking\n   * 3. Caveman compression (if enabled)\n   * 4. Deduplication (content hash)\n   * 5. Symbol detection and linking\n   * 6. Embedding (if enabled)\n   * 7. Watchmen threshold check (if enabled) \u2014 returns WatchmenReadyResult when synthesis should run\n   *\n   * Returns the observation ID, a WatchmenReadyResult, or null if skipped (duplicate or excluded).\n   */\n  async store(input: MemObservationInput, ide = 'kiro'): Promise<string | WatchmenReadyResult | null> {\n    let text = input.content;\n\n    // 1. Strip <private> blocks\n    text = MemoryDatabase.stripPrivate(text);\n    if (!text.trim()) return null;\n\n    // 2. Check exclude patterns\n    if (this.shouldExclude(text)) return null;\n\n    // 3. Compress (if caveman is on)\n    let contentRaw: string | undefined;\n    if (this.cavemanMode !== 'off') {\n      const result = compressObservation(text, this.cavemanMode);\n      contentRaw = text;\n      text = result.compressed;\n    }\n\n    // 4. Get or create session\n    const cwd = process.cwd();\n    const sessionTimeout = (this.config as any).memorySessionTimeout ?? 7200;\n    const sessionId = this.memDb.getOrCreateSession(ide, cwd, sessionTimeout);\n\n    // 5. Insert observation (deduplicates via content_hash)\n    const id = this.memDb.insertObservation(text, {\n      contentRaw: this.cavemanMode !== 'off' ? contentRaw : undefined,\n      kind: input.kind ?? 'note',\n      source: input.source ?? 'manual',\n      tags: input.tags,\n      sessionId,\n    });\n\n    if (!id) {\n      logDebug('Memory: duplicate observation skipped');\n      return null;\n    }\n\n    // 6. Detect and link symbols\n    const symbols = detectSymbols(text, this.db);\n    if (symbols.length > 0) {\n      this.memDb.linkToSymbols(id, symbols.map(s => s.qualifiedName));\n    }\n\n    // Also detect in raw text if different\n    if (contentRaw) {\n      const rawSymbols = detectSymbols(contentRaw, this.db);\n      const extraSymbols = rawSymbols.filter(\n        s => !symbols.some(existing => existing.qualifiedName === s.qualifiedName)\n      );\n      if (extraSymbols.length > 0) {\n        this.memDb.linkToSymbols(id, extraSymbols.map(s => s.qualifiedName));\n      }\n    }\n\n    // 7. Embed (async, non-blocking for the store operation)\n    const obs = this.memDb.getObservation(id);\n    if (obs) {\n      await this.vectorMgr.embedObservation(obs);\n    }\n\n    // 8. Watchmen threshold check\n    if (this.watchmenChecker && input.kind !== 'summary') {\n      const check = this.watchmenChecker.shouldSynthesize(this.memDb);\n      if (check.ready) {\n        return this.watchmenChecker.buildReadyResponse(id, check.pendingCount, this.projectRoot);\n      }\n    }\n\n    return id;\n  }\n\n  // \u2500\u2500 Search \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Hybrid search: combines FTS5 and vector search with configurable alpha.\n   */\n  async search(query: string, opts: MemSearchOptions = {}): Promise<ScoredObservation[]> {\n    const limit = opts.limit ?? 10;\n    const alpha = opts.alpha ?? (this.config as any).memorySearchAlpha ?? 0.5;\n\n    // FTS search\n    const ftsResults = this.memDb.searchFTS(query, { ...opts, limit: limit * 2 });\n\n    // Vector search (if enabled and no model mismatch)\n    let vectorResults: ScoredObservation[] = [];\n    if (this.vectorMgr.isEnabled() && !this.vectorMgr.hasModelMismatch()) {\n      vectorResults = await this.vectorMgr.search(query, limit * 2);\n    }\n\n    // If only one source has results, return it directly\n    if (vectorResults.length === 0) return ftsResults.slice(0, limit);\n    if (ftsResults.length === 0) return vectorResults.slice(0, limit);\n\n    // Hybrid merge: normalize scores and blend\n    const merged = this.mergeResults(ftsResults, vectorResults, alpha);\n    return merged.slice(0, limit);\n  }\n\n  /**\n   * Get observations linked to specific symbols.\n   * Used by kirograph_context and kirograph_impact.\n   */\n  getLinkedObservations(qualifiedNames: string[], limit = 3, threshold = 0.3): ScoredObservation[] {\n    const results = this.memDb.getLinkedObservationsForSymbols(qualifiedNames, limit * 2);\n    return results.filter(r => r.score >= threshold).slice(0, limit);\n  }\n\n  // \u2500\u2500 Timeline \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * List sessions with their observation counts.\n   */\n  timeline(opts: MemTimelineOptions = {}): { sessions: MemSession[]; observations: Map<string, MemObservation[]> } {\n    const limit = opts.limit ?? 5;\n\n    if (opts.sessionId) {\n      const session = this.memDb.getSession(opts.sessionId);\n      if (!session) return { sessions: [], observations: new Map() };\n      const obs = this.memDb.getObservationsBySession(opts.sessionId);\n      const map = new Map<string, MemObservation[]>();\n      map.set(opts.sessionId, obs);\n      return { sessions: [session], observations: map };\n    }\n\n    const sessions = this.memDb.listSessions(limit);\n    const observations = new Map<string, MemObservation[]>();\n    for (const session of sessions) {\n      const obs = this.memDb.getObservationsBySession(session.id, 10);\n      observations.set(session.id, obs);\n    }\n    return { sessions, observations };\n  }\n\n  // \u2500\u2500 Status \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  getStats(): MemStats {\n    const modelName = (this.config as any).embeddingModel ?? 'nomic-ai/nomic-embed-text-v1.5';\n    return this.memDb.getStats(modelName);\n  }\n\n  // \u2500\u2500 Session management \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  endCurrentSession(ide = 'kiro'): void {\n    const cwd = process.cwd();\n    const sessionTimeout = (this.config as any).memorySessionTimeout ?? 7200;\n    // Find active session and close it\n    const sessionId = this.memDb.getOrCreateSession(ide, cwd, sessionTimeout);\n    this.memDb.endSession(sessionId);\n  }\n\n  // \u2500\u2500 Maintenance \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  prune(olderThanMs: number): number {\n    const cutoff = Date.now() - olderThanMs;\n    return this.memDb.prune(cutoff);\n  }\n\n  async reembed(batchSize = 32): Promise<number> {\n    return this.vectorMgr.reembed(batchSize);\n  }\n\n  lint(): { staleLinks: number; modelMismatch: boolean; staleSessions: number } {\n    const staleLinks = this.memDb.findStaleLinks().length;\n    const modelMismatch = this.vectorMgr.hasModelMismatch();\n    const sessionTimeout = ((this.config as any).memorySessionTimeout ?? 7200) * 1000;\n    const staleSessions = this.memDb.closeStaleSessionsOlderThan(sessionTimeout);\n    return { staleLinks, modelMismatch, staleSessions };\n  }\n\n  removeStaleLinks(): number {\n    return this.memDb.removeStaleLinks();\n  }\n\n  // \u2500\u2500 Private \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  private shouldExclude(text: string): boolean {\n    if (this.excludePatterns.length === 0) return false;\n\n    // Simple check: if any exclude pattern appears as a substring in the text\n    // This is a basic implementation; could use picomatch for glob matching\n    for (const pattern of this.excludePatterns) {\n      const normalized = pattern.replace(/\\*/g, '');\n      if (normalized && text.includes(normalized)) return true;\n    }\n    return false;\n  }\n\n  private mergeResults(\n    ftsResults: ScoredObservation[],\n    vectorResults: ScoredObservation[],\n    alpha: number\n  ): ScoredObservation[] {\n    // Normalize FTS scores (rank is negative in FTS5, lower = better)\n    const maxFts = Math.max(...ftsResults.map(r => r.score), 1);\n    const normalizedFts = new Map<string, number>();\n    for (const r of ftsResults) {\n      normalizedFts.set(r.observation.id, r.score / maxFts);\n    }\n\n    // Vector scores are already 0-1 (cosine similarity)\n    const normalizedVec = new Map<string, number>();\n    for (const r of vectorResults) {\n      normalizedVec.set(r.observation.id, r.score);\n    }\n\n    // Merge: collect all unique observation IDs\n    const allIds = new Set([...normalizedFts.keys(), ...normalizedVec.keys()]);\n    const merged: ScoredObservation[] = [];\n\n    // Build a lookup for observations\n    const obsMap = new Map<string, MemObservation>();\n    for (const r of ftsResults) obsMap.set(r.observation.id, r.observation);\n    for (const r of vectorResults) obsMap.set(r.observation.id, r.observation);\n\n    for (const id of allIds) {\n      const ftsScore = normalizedFts.get(id) ?? 0;\n      const vecScore = normalizedVec.get(id) ?? 0;\n      const hybridScore = (1 - alpha) * ftsScore + alpha * vecScore;\n      const obs = obsMap.get(id)!;\n      merged.push({ observation: obs, score: hybridScore, scoreSource: 'hybrid' });\n    }\n\n    merged.sort((a, b) => b.score - a.score);\n    return merged;\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmBA,sBAA+B;AAC/B,sBAAsD;AACtD,qBAA8B;AAC9B,qBAAoC;AACpC,sBAAgC;AAChC,oBAAyB;AAEzB,IAAAA,mBAA+B;AAC/B,IAAAC,mBAA0E;AAC1E,IAAAC,kBAA8B;AAC9B,IAAAC,kBAAoC;AACpC,2BAAc,oBA9Bd;AAkCO,MAAM,cAAc;AAAA,EAUzB,YAAY,QAAyB,IAAS,cAAc,QAAQ,IAAI,GAAG;AACzE,SAAK,SAAS;AACd,SAAK,KAAK;AACV,SAAK,cAAc;AACnB,SAAK,QAAQ,IAAI,+BAAe,EAAE;AAClC,SAAK,YAAY,IAAI,mCAAoB,QAAQ,KAAK,KAAK;AAC3D,SAAK,cAAe,OAAe,eAAe;AAClD,SAAK,kBAAmB,OAAe,yBAAyB,CAAC;AACjE,SAAK,kBAAkB,OAAO,iBAC1B,IAAI,gCAAgB,OAAO,iBAAiB,IAC5C;AAAA,EACN;AAAA;AAAA;AAAA;AAAA,EAKA,aAAmB;AACjB,SAAK,MAAM,WAAW;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,UAAU,QAAkC;AACjD,WAAO,CAAC,CAAE,OAAe;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,MAAM,MAAM,OAA4B,MAAM,QAAsD;AAClG,QAAI,OAAO,MAAM;AAGjB,WAAO,+BAAe,aAAa,IAAI;AACvC,QAAI,CAAC,KAAK,KAAK,EAAG,QAAO;AAGzB,QAAI,KAAK,cAAc,IAAI,EAAG,QAAO;AAGrC,QAAI;AACJ,QAAI,KAAK,gBAAgB,OAAO;AAC9B,YAAM,aAAS,qCAAoB,MAAM,KAAK,WAAW;AACzD,mBAAa;AACb,aAAO,OAAO;AAAA,IAChB;AAGA,UAAM,MAAM,QAAQ,IAAI;AACxB,UAAM,iBAAkB,KAAK,OAAe,wBAAwB;AACpE,UAAM,YAAY,KAAK,MAAM,mBAAmB,KAAK,KAAK,cAAc;AAGxE,UAAM,KAAK,KAAK,MAAM,kBAAkB,MAAM;AAAA,MAC5C,YAAY,KAAK,gBAAgB,QAAQ,aAAa;AAAA,MACtD,MAAM,MAAM,QAAQ;AAAA,MACpB,QAAQ,MAAM,UAAU;AAAA,MACxB,MAAM,MAAM;AAAA,MACZ;AAAA,IACF,CAAC;AAED,QAAI,CAAC,IAAI;AACP,kCAAS,uCAAuC;AAChD,aAAO;AAAA,IACT;AAGA,UAAM,cAAU,8BAAc,MAAM,KAAK,EAAE;AAC3C,QAAI,QAAQ,SAAS,GAAG;AACtB,WAAK,MAAM,cAAc,IAAI,QAAQ,IAAI,OAAK,EAAE,aAAa,CAAC;AAAA,IAChE;AAGA,QAAI,YAAY;AACd,YAAM,iBAAa,8BAAc,YAAY,KAAK,EAAE;AACpD,YAAM,eAAe,WAAW;AAAA,QAC9B,OAAK,CAAC,QAAQ,KAAK,cAAY,SAAS,kBAAkB,EAAE,aAAa;AAAA,MAC3E;AACA,UAAI,aAAa,SAAS,GAAG;AAC3B,aAAK,MAAM,cAAc,IAAI,aAAa,IAAI,OAAK,EAAE,aAAa,CAAC;AAAA,MACrE;AAAA,IACF;AAGA,UAAM,MAAM,KAAK,MAAM,eAAe,EAAE;AACxC,QAAI,KAAK;AACP,YAAM,KAAK,UAAU,iBAAiB,GAAG;AAAA,IAC3C;AAGA,QAAI,KAAK,mBAAmB,MAAM,SAAS,WAAW;AACpD,YAAM,QAAQ,KAAK,gBAAgB,iBAAiB,KAAK,KAAK;AAC9D,UAAI,MAAM,OAAO;AACf,eAAO,KAAK,gBAAgB,mBAAmB,IAAI,MAAM,cAAc,KAAK,WAAW;AAAA,MACzF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,OAAO,OAAe,OAAyB,CAAC,GAAiC;AACrF,UAAM,QAAQ,KAAK,SAAS;AAC5B,UAAM,QAAQ,KAAK,SAAU,KAAK,OAAe,qBAAqB;AAGtE,UAAM,aAAa,KAAK,MAAM,UAAU,OAAO,EAAE,GAAG,MAAM,OAAO,QAAQ,EAAE,CAAC;AAG5E,QAAI,gBAAqC,CAAC;AAC1C,QAAI,KAAK,UAAU,UAAU,KAAK,CAAC,KAAK,UAAU,iBAAiB,GAAG;AACpE,sBAAgB,MAAM,KAAK,UAAU,OAAO,OAAO,QAAQ,CAAC;AAAA,IAC9D;AAGA,QAAI,cAAc,WAAW,EAAG,QAAO,WAAW,MAAM,GAAG,KAAK;AAChE,QAAI,WAAW,WAAW,EAAG,QAAO,cAAc,MAAM,GAAG,KAAK;AAGhE,UAAM,SAAS,KAAK,aAAa,YAAY,eAAe,KAAK;AACjE,WAAO,OAAO,MAAM,GAAG,KAAK;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,sBAAsB,gBAA0B,QAAQ,GAAG,YAAY,KAA0B;AAC/F,UAAM,UAAU,KAAK,MAAM,gCAAgC,gBAAgB,QAAQ,CAAC;AACpF,WAAO,QAAQ,OAAO,OAAK,EAAE,SAAS,SAAS,EAAE,MAAM,GAAG,KAAK;AAAA,EACjE;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,SAAS,OAA2B,CAAC,GAA4E;AAC/G,UAAM,QAAQ,KAAK,SAAS;AAE5B,QAAI,KAAK,WAAW;AAClB,YAAM,UAAU,KAAK,MAAM,WAAW,KAAK,SAAS;AACpD,UAAI,CAAC,QAAS,QAAO,EAAE,UAAU,CAAC,GAAG,cAAc,oBAAI,IAAI,EAAE;AAC7D,YAAM,MAAM,KAAK,MAAM,yBAAyB,KAAK,SAAS;AAC9D,YAAM,MAAM,oBAAI,IAA8B;AAC9C,UAAI,IAAI,KAAK,WAAW,GAAG;AAC3B,aAAO,EAAE,UAAU,CAAC,OAAO,GAAG,cAAc,IAAI;AAAA,IAClD;AAEA,UAAM,WAAW,KAAK,MAAM,aAAa,KAAK;AAC9C,UAAM,eAAe,oBAAI,IAA8B;AACvD,eAAW,WAAW,UAAU;AAC9B,YAAM,MAAM,KAAK,MAAM,yBAAyB,QAAQ,IAAI,EAAE;AAC9D,mBAAa,IAAI,QAAQ,IAAI,GAAG;AAAA,IAClC;AACA,WAAO,EAAE,UAAU,aAAa;AAAA,EAClC;AAAA;AAAA,EAIA,WAAqB;AACnB,UAAM,YAAa,KAAK,OAAe,kBAAkB;AACzD,WAAO,KAAK,MAAM,SAAS,SAAS;AAAA,EACtC;AAAA;AAAA,EAIA,kBAAkB,MAAM,QAAc;AACpC,UAAM,MAAM,QAAQ,IAAI;AACxB,UAAM,iBAAkB,KAAK,OAAe,wBAAwB;AAEpE,UAAM,YAAY,KAAK,MAAM,mBAAmB,KAAK,KAAK,cAAc;AACxE,SAAK,MAAM,WAAW,SAAS;AAAA,EACjC;AAAA;AAAA,EAIA,MAAM,aAA6B;AACjC,UAAM,SAAS,KAAK,IAAI,IAAI;AAC5B,WAAO,KAAK,MAAM,MAAM,MAAM;AAAA,EAChC;AAAA,EAEA,MAAM,QAAQ,YAAY,IAAqB;AAC7C,WAAO,KAAK,UAAU,QAAQ,SAAS;AAAA,EACzC;AAAA,EAEA,OAA8E;AAC5E,UAAM,aAAa,KAAK,MAAM,eAAe,EAAE;AAC/C,UAAM,gBAAgB,KAAK,UAAU,iBAAiB;AACtD,UAAM,kBAAmB,KAAK,OAAe,wBAAwB,QAAQ;AAC7E,UAAM,gBAAgB,KAAK,MAAM,4BAA4B,cAAc;AAC3E,WAAO,EAAE,YAAY,eAAe,cAAc;AAAA,EACpD;AAAA,EAEA,mBAA2B;AACzB,WAAO,KAAK,MAAM,iBAAiB;AAAA,EACrC;AAAA;AAAA,EAIQ,cAAc,MAAuB;AAC3C,QAAI,KAAK,gBAAgB,WAAW,EAAG,QAAO;AAI9C,eAAW,WAAW,KAAK,iBAAiB;AAC1C,YAAM,aAAa,QAAQ,QAAQ,OAAO,EAAE;AAC5C,UAAI,cAAc,KAAK,SAAS,UAAU,EAAG,QAAO;AAAA,IACtD;AACA,WAAO;AAAA,EACT;AAAA,EAEQ,aACN,YACA,eACA,OACqB;AAErB,UAAM,SAAS,KAAK,IAAI,GAAG,WAAW,IAAI,OAAK,EAAE,KAAK,GAAG,CAAC;AAC1D,UAAM,gBAAgB,oBAAI,IAAoB;AAC9C,eAAW,KAAK,YAAY;AAC1B,oBAAc,IAAI,EAAE,YAAY,IAAI,EAAE,QAAQ,MAAM;AAAA,IACtD;AAGA,UAAM,gBAAgB,oBAAI,IAAoB;AAC9C,eAAW,KAAK,eAAe;AAC7B,oBAAc,IAAI,EAAE,YAAY,IAAI,EAAE,KAAK;AAAA,IAC7C;AAGA,UAAM,SAAS,oBAAI,IAAI,CAAC,GAAG,cAAc,KAAK,GAAG,GAAG,cAAc,KAAK,CAAC,CAAC;AACzE,UAAM,SAA8B,CAAC;AAGrC,UAAM,SAAS,oBAAI,IAA4B;AAC/C,eAAW,KAAK,WAAY,QAAO,IAAI,EAAE,YAAY,IAAI,EAAE,WAAW;AACtE,eAAW,KAAK,cAAe,QAAO,IAAI,EAAE,YAAY,IAAI,EAAE,WAAW;AAEzE,eAAW,MAAM,QAAQ;AACvB,YAAM,WAAW,cAAc,IAAI,EAAE,KAAK;AAC1C,YAAM,WAAW,cAAc,IAAI,EAAE,KAAK;AAC1C,YAAM,eAAe,IAAI,SAAS,WAAW,QAAQ;AACrD,YAAM,MAAM,OAAO,IAAI,EAAE;AACzB,aAAO,KAAK,EAAE,aAAa,KAAK,OAAO,aAAa,aAAa,SAAS,CAAC;AAAA,IAC7E;AAEA,WAAO,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK;AACvC,WAAO;AAAA,EACT;AACF;",
   "names": ["import_database", "import_compress", "import_symbols", "import_vectors"]
 }

package/dist/memory/symbols.d.ts

@@ -0,0 +1,21 @@
+/**
+ * KiroGraph Memory — Symbol detector
+ *
+ * Scans observation text for identifiers that match indexed symbols.
+ * Returns qualified_name for stable linking across reindex.
+ * No LLM involved — pure SQL lookup.
+ */
+export interface DetectedSymbol {
+    qualifiedName: string;
+    name: string;
+}
+/**
+ * Detect symbols in text that exist in the code graph.
+ * Extracts candidate identifiers and batch-looks them up in the nodes table.
+ *
+ * @param text - The observation text (compressed or raw)
+ * @param db - The GraphDatabase handle (raw sqlite)
+ * @returns Array of matched symbols with their qualified names
+ */
+export declare function detectSymbols(text: string, db: any): DetectedSymbol[];
+//# sourceMappingURL=symbols.d.ts.map

package/dist/memory/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../src/memory/symbols.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,GAAG,cAAc,EAAE,CAiCrE"}

package/dist/memory/types.d.ts

@@ -0,0 +1,78 @@
+/**
+ * KiroGraph Memory — Type definitions
+ */
+export interface MemSession {
+    id: string;
+    ide?: string;
+    cwd?: string;
+    startedAt: number;
+    endedAt?: number;
+}
+export type ObservationKind = 'decision' | 'error' | 'pattern' | 'architecture' | 'summary' | 'note';
+export type ObservationSource = 'hook' | 'manual' | 'agent';
+export interface MemObservation {
+    id: string;
+    sessionId?: string;
+    content: string;
+    contentRaw?: string;
+    contentHash: string;
+    kind: ObservationKind;
+    source: ObservationSource;
+    tags?: string[];
+    createdAt: number;
+    /** Temporal validity: when this fact became valid (epoch ms). */
+    validFrom?: number;
+    /** Temporal validity: when this fact expires (epoch ms). Null = no expiry. */
+    validUntil?: number;
+    /** ID of the observation that supersedes this one. */
+    supersededBy?: string;
+    /** Fact type for temporal classification. */
+    factType?: 'observation' | 'decision' | 'procedure' | 'constraint';
+}
+export interface MemObservationInput {
+    content: string;
+    kind?: ObservationKind;
+    source?: ObservationSource;
+    tags?: string[];
+}
+export interface MemLink {
+    observationId: string;
+    qualifiedName: string;
+    relevance: number;
+}
+export interface ScoredObservation {
+    observation: MemObservation;
+    score: number;
+    /** Source of the score: 'fts', 'vector', or 'hybrid' */
+    scoreSource: 'fts' | 'vector' | 'hybrid';
+}
+export interface MemSearchOptions {
+    limit?: number;
+    kind?: ObservationKind;
+    sessionId?: string;
+    /** FTS/vector blend: 0 = FTS only, 1 = vector only, 0.5 = equal blend */
+    alpha?: number;
+    /** Query facts valid at this timestamp (epoch ms). Filters out expired/superseded observations. */
+    asOf?: number;
+}
+export interface MemTimelineOptions {
+    limit?: number;
+    sessionId?: string;
+}
+export interface MemStats {
+    sessions: number;
+    activeSessions: number;
+    observations: number;
+    links: number;
+    vectors: number;
+    embeddableCount: number;
+    modelMismatch: boolean;
+    currentModel?: string;
+}
+export interface CompressResult {
+    compressed: string;
+    originalLength: number;
+    compressedLength: number;
+    detectedSymbols: string[];
+}
+//# sourceMappingURL=types.d.ts.map