kirograph 0.14.0 → 0.15.0

package/dist/memory/database.js

@@ -0,0 +1,375 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var database_exports = {};
+__export(database_exports, {
+  MemoryDatabase: () => MemoryDatabase
+});
+module.exports = __toCommonJS(database_exports);
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var crypto = __toESM(require("crypto"));
+function generateId() {
+  return crypto.randomUUID();
+}
+function hashContent(content) {
+  return crypto.createHash("sha256").update(content).digest("hex");
+}
+class MemoryDatabase {
+  constructor(db) {
+    this.initialized = false;
+    this.db = db;
+  }
+  /**
+   * Apply memory schema. Called once when enableMemory is true.
+   */
+  initialize() {
+    if (this.initialized) return;
+    const schemaPath = path.join(__dirname, "../db/memory-schema.sql");
+    const sql = fs.readFileSync(schemaPath, "utf8");
+    this.db.exec(sql);
+    this.initialized = true;
+  }
+  // ── Sessions ─────────────────────────────────────────────────────────────
+  /**
+   * Get or create an active session. Auto-creates if no active session exists
+   * within the timeout window.
+   */
+  getOrCreateSession(ide, cwd, timeoutSeconds = 7200) {
+    const cutoff = Date.now() - timeoutSeconds * 1e3;
+    const existing = this.db.get(
+      `SELECT id FROM mem_sessions
+       WHERE ended_at IS NULL AND ide = ? AND started_at > ?
+       ORDER BY started_at DESC LIMIT 1`,
+      [ide, cutoff]
+    );
+    if (existing) return existing.id;
+    this.db.run(
+      `UPDATE mem_sessions SET ended_at = ? WHERE ended_at IS NULL AND ide = ?`,
+      [Date.now(), ide]
+    );
+    const id = generateId();
+    this.db.run(
+      `INSERT INTO mem_sessions (id, ide, cwd, started_at) VALUES (?, ?, ?, ?)`,
+      [id, ide, cwd, Date.now()]
+    );
+    return id;
+  }
+  endSession(sessionId) {
+    this.db.run(
+      `UPDATE mem_sessions SET ended_at = ? WHERE id = ? AND ended_at IS NULL`,
+      [Date.now(), sessionId]
+    );
+  }
+  getSession(sessionId) {
+    const row = this.db.get("SELECT * FROM mem_sessions WHERE id = ?", [sessionId]);
+    return row ? this.rowToSession(row) : null;
+  }
+  listSessions(limit = 10) {
+    return this.db.all(
+      "SELECT * FROM mem_sessions ORDER BY started_at DESC LIMIT ?",
+      [limit]
+    ).map(this.rowToSession);
+  }
+  // ── Observations ─────────────────────────────────────────────────────────
+  /**
+   * Insert an observation. Returns the ID, or null if a duplicate (same content_hash).
+   */
+  insertObservation(content, opts = {}) {
+    const id = generateId();
+    const contentHash = hashContent(content);
+    const kind = opts.kind ?? "note";
+    const source = opts.source ?? "manual";
+    const tags = opts.tags ? JSON.stringify(opts.tags) : null;
+    const now = Date.now();
+    try {
+      this.db.run(
+        `INSERT INTO mem_observations (id, session_id, content, content_raw, content_hash, kind, source, tags, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        [id, opts.sessionId ?? null, content, opts.contentRaw ?? null, contentHash, kind, source, tags, now]
+      );
+    } catch (err) {
+      if (err.message?.includes("UNIQUE constraint failed") || err.message?.includes("unique")) {
+        return null;
+      }
+      throw err;
+    }
+    this.db.run(
+      `INSERT INTO mem_fts (id, content, kind) VALUES (?, ?, ?)`,
+      [id, content, kind]
+    );
+    return id;
+  }
+  getObservation(id) {
+    const row = this.db.get("SELECT * FROM mem_observations WHERE id = ?", [id]);
+    return row ? this.rowToObservation(row) : null;
+  }
+  getObservationsBySession(sessionId, limit = 50) {
+    return this.db.all(
+      "SELECT * FROM mem_observations WHERE session_id = ? ORDER BY created_at DESC LIMIT ?",
+      [sessionId, limit]
+    ).map(this.rowToObservation);
+  }
+  getObservationsByTimeRange(from, to, limit = 50) {
+    return this.db.all(
+      "SELECT * FROM mem_observations WHERE created_at >= ? AND created_at <= ? ORDER BY created_at DESC LIMIT ?",
+      [from, to, limit]
+    ).map(this.rowToObservation);
+  }
+  // ── FTS Search ───────────────────────────────────────────────────────────
+  searchFTS(query, opts = {}) {
+    const { limit = 10, kind, sessionId } = opts;
+    const safe = query.replace(/\b(AND|OR|NOT)\b/g, " ").replace(/['"*()?\-+^~:{}\\\.\/,]/g, " ").replace(/\s+/g, " ").trim();
+    if (!safe) return [];
+    const ftsQuery = safe + "*";
+    const safeLimit = Math.max(1, Math.floor(Number(limit)));
+    const conditions = [];
+    const params = [];
+    if (kind) {
+      conditions.push("o.kind = ?");
+      params.push(kind);
+    }
+    if (sessionId) {
+      conditions.push("o.session_id = ?");
+      params.push(sessionId);
+    }
+    const where = conditions.length > 0 ? `AND ${conditions.join(" AND ")}` : "";
+    const rows = this.db.all(
+      `SELECT o.*, rank FROM mem_fts f
+       JOIN mem_observations o ON o.id = f.id
+       WHERE mem_fts MATCH '${ftsQuery}' ${where}
+       ORDER BY rank
+       LIMIT ${safeLimit}`,
+      params
+    );
+    return rows.map((row) => ({
+      observation: this.rowToObservation(row),
+      score: Math.abs(row.rank ?? 0),
+      scoreSource: "fts"
+    }));
+  }
+  // ── Links ────────────────────────────────────────────────────────────────
+  linkToSymbol(observationId, qualifiedName, relevance = 1) {
+    this.db.run(
+      `INSERT OR IGNORE INTO mem_links (observation_id, qualified_name, relevance)
+       VALUES (?, ?, ?)`,
+      [observationId, qualifiedName, relevance]
+    );
+  }
+  linkToSymbols(observationId, qualifiedNames) {
+    for (const qn of qualifiedNames) {
+      this.linkToSymbol(observationId, qn);
+    }
+  }
+  /**
+   * Get observations linked to a symbol by qualified_name.
+   * Resolves through mem_links — no dependency on node IDs.
+   */
+  getLinkedObservations(qualifiedName, limit = 10) {
+    const rows = this.db.all(
+      `SELECT o.*, l.relevance FROM mem_observations o
+       JOIN mem_links l ON l.observation_id = o.id
+       WHERE l.qualified_name = ?
+       ORDER BY l.relevance DESC, o.created_at DESC
+       LIMIT ?`,
+      [qualifiedName, limit]
+    );
+    return rows.map((row) => ({
+      observation: this.rowToObservation(row),
+      score: row.relevance ?? 1,
+      scoreSource: "fts"
+    }));
+  }
+  /**
+   * Get observations linked to any of the given qualified names.
+   * Used by kirograph_context and kirograph_impact to surface memory.
+   */
+  getLinkedObservationsForSymbols(qualifiedNames, limit = 5) {
+    if (qualifiedNames.length === 0) return [];
+    const placeholders = qualifiedNames.map(() => "?").join(",");
+    const rows = this.db.all(
+      `SELECT DISTINCT o.*, MAX(l.relevance) as relevance FROM mem_observations o
+       JOIN mem_links l ON l.observation_id = o.id
+       WHERE l.qualified_name IN (${placeholders})
+       GROUP BY o.id
+       ORDER BY relevance DESC, o.created_at DESC
+       LIMIT ?`,
+      [...qualifiedNames, limit]
+    );
+    return rows.map((row) => ({
+      observation: this.rowToObservation(row),
+      score: row.relevance ?? 1,
+      scoreSource: "fts"
+    }));
+  }
+  // ── Vectors ──────────────────────────────────────────────────────────────
+  insertVector(observationId, embedding, model) {
+    this.db.run(
+      `INSERT OR REPLACE INTO mem_vectors (observation_id, embedding, model, created_at)
+       VALUES (?, ?, ?, ?)`,
+      [observationId, embedding, model, Date.now()]
+    );
+  }
+  getVector(observationId) {
+    const row = this.db.get(
+      "SELECT embedding, model FROM mem_vectors WHERE observation_id = ?",
+      [observationId]
+    );
+    return row ? { embedding: row.embedding, model: row.model } : null;
+  }
+  getVectorCount() {
+    const row = this.db.get("SELECT COUNT(*) as count FROM mem_vectors");
+    return row?.count ?? 0;
+  }
+  getVectorModelMismatch(currentModel) {
+    const row = this.db.get(
+      "SELECT COUNT(*) as count FROM mem_vectors WHERE model != ?",
+      [currentModel]
+    );
+    return row?.count ?? 0;
+  }
+  getAllVectors(model) {
+    const sql = model ? "SELECT observation_id, embedding FROM mem_vectors WHERE model = ?" : "SELECT observation_id, embedding FROM mem_vectors";
+    const params = model ? [model] : [];
+    return this.db.all(sql, params).map((row) => ({
+      observationId: row.observation_id,
+      embedding: row.embedding
+    }));
+  }
+  deleteVectors() {
+    this.db.run("DELETE FROM mem_vectors");
+  }
+  // ── Stats ────────────────────────────────────────────────────────────────
+  getStats(currentModel) {
+    const sessions = this.db.get("SELECT COUNT(*) as c FROM mem_sessions")?.c ?? 0;
+    const activeSessions = this.db.get("SELECT COUNT(*) as c FROM mem_sessions WHERE ended_at IS NULL")?.c ?? 0;
+    const observations = this.db.get("SELECT COUNT(*) as c FROM mem_observations")?.c ?? 0;
+    const links = this.db.get("SELECT COUNT(*) as c FROM mem_links")?.c ?? 0;
+    const vectors = this.db.get("SELECT COUNT(*) as c FROM mem_vectors")?.c ?? 0;
+    const mismatch = currentModel ? this.getVectorModelMismatch(currentModel) : 0;
+    return {
+      sessions,
+      activeSessions,
+      observations,
+      links,
+      vectors,
+      embeddableCount: observations,
+      modelMismatch: mismatch > 0,
+      currentModel
+    };
+  }
+  // ── Maintenance ──────────────────────────────────────────────────────────
+  /**
+   * Delete observations older than the given timestamp.
+   * Cascades to mem_links and mem_vectors via FK.
+   */
+  prune(olderThan) {
+    const ids = this.db.all(
+      "SELECT id FROM mem_observations WHERE created_at < ?",
+      [olderThan]
+    ).map((r) => r.id);
+    if (ids.length === 0) return 0;
+    const placeholders = ids.map(() => "?").join(",");
+    this.db.run(`DELETE FROM mem_fts WHERE id IN (${placeholders})`, ids);
+    this.db.run(`DELETE FROM mem_observations WHERE created_at < ?`, [olderThan]);
+    this.db.run(
+      `DELETE FROM mem_sessions WHERE id NOT IN (SELECT DISTINCT session_id FROM mem_observations WHERE session_id IS NOT NULL)`
+    );
+    return ids.length;
+  }
+  /**
+   * Find stale links where qualified_name no longer exists in the nodes table.
+   */
+  findStaleLinks() {
+    const rows = this.db.all(
+      `SELECT l.* FROM mem_links l
+       LEFT JOIN nodes n ON n.qualified_name = l.qualified_name
+       WHERE n.id IS NULL`
+    );
+    return rows.map((row) => ({
+      observationId: row.observation_id,
+      qualifiedName: row.qualified_name,
+      relevance: row.relevance
+    }));
+  }
+  /**
+   * Remove stale links (where qualified_name no longer resolves).
+   */
+  removeStaleLinks() {
+    const result = this.db.run(
+      `DELETE FROM mem_links WHERE qualified_name NOT IN (SELECT DISTINCT qualified_name FROM nodes)`
+    );
+    return result?.changes ?? 0;
+  }
+  /**
+   * Close stale sessions (started but never ended, older than timeout).
+   */
+  closeStaleSessionsOlderThan(timeoutMs) {
+    const cutoff = Date.now() - timeoutMs;
+    const result = this.db.run(
+      `UPDATE mem_sessions SET ended_at = ? WHERE ended_at IS NULL AND started_at < ?`,
+      [Date.now(), cutoff]
+    );
+    return result?.changes ?? 0;
+  }
+  // ── Privacy ──────────────────────────────────────────────────────────────
+  /**
+   * Strip <private>...</private> blocks from text.
+   */
+  static stripPrivate(text) {
+    return text.replace(/<private>[\s\S]*?<\/private>/gi, "").trim();
+  }
+  // ── Row mappers ──────────────────────────────────────────────────────────
+  rowToSession(row) {
+    return {
+      id: row.id,
+      ide: row.ide ?? void 0,
+      cwd: row.cwd ?? void 0,
+      startedAt: row.started_at,
+      endedAt: row.ended_at ?? void 0
+    };
+  }
+  rowToObservation(row) {
+    return {
+      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
+    };
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MemoryDatabase
+});
+//# sourceMappingURL=database.js.map

package/dist/memory/database.js.map

@@ -0,0 +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    this.initialized = true;\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 } = 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    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    };\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/memory/index.js

@@ -0,0 +1,239 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var memory_exports = {};
+__export(memory_exports, {
+  MemoryDatabase: () => import_database2.MemoryDatabase,
+  MemoryManager: () => MemoryManager,
+  MemoryVectorManager: () => import_vectors2.MemoryVectorManager,
+  compressObservation: () => import_compress2.compressObservation,
+  detectSymbols: () => import_symbols2.detectSymbols,
+  extractIdentifiers: () => import_compress2.extractIdentifiers
+});
+module.exports = __toCommonJS(memory_exports);
+var import_database = require("./database");
+var import_compress = require("./compress");
+var import_symbols = require("./symbols");
+var import_vectors = require("./vectors");
+var import_errors = require("../errors");
+var import_database2 = require("./database");
+var import_compress2 = require("./compress");
+var import_symbols2 = require("./symbols");
+var import_vectors2 = require("./vectors");
+__reExport(memory_exports, require("./types"), module.exports);
+class MemoryManager {
+  constructor(config, db) {
+    this.config = config;
+    this.db = db;
+    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 ?? [];
+  }
+  /**
+   * Initialize memory tables. Must be called before any operations.
+   */
+  initialize() {
+    this.memDb.initialize();
+  }
+  /**
+   * Check if memory is enabled in config.
+   */
+  static isEnabled(config) {
+    return !!config.enableMemory;
+  }
+  // ── Store ──────────────────────────────────────────────────────────────────
+  /**
+   * 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).
+   */
+  async store(input, ide = "kiro") {
+    let text = input.content;
+    text = import_database.MemoryDatabase.stripPrivate(text);
+    if (!text.trim()) return null;
+    if (this.shouldExclude(text)) return null;
+    let contentRaw;
+    if (this.cavemanMode !== "off") {
+      const result = (0, import_compress.compressObservation)(text, this.cavemanMode);
+      contentRaw = text;
+      text = result.compressed;
+    }
+    const cwd = process.cwd();
+    const sessionTimeout = this.config.memorySessionTimeout ?? 7200;
+    const sessionId = this.memDb.getOrCreateSession(ide, cwd, sessionTimeout);
+    const id = this.memDb.insertObservation(text, {
+      contentRaw: this.cavemanMode !== "off" ? contentRaw : void 0,
+      kind: input.kind ?? "note",
+      source: input.source ?? "manual",
+      tags: input.tags,
+      sessionId
+    });
+    if (!id) {
+      (0, import_errors.logDebug)("Memory: duplicate observation skipped");
+      return null;
+    }
+    const symbols = (0, import_symbols.detectSymbols)(text, this.db);
+    if (symbols.length > 0) {
+      this.memDb.linkToSymbols(id, symbols.map((s) => s.qualifiedName));
+    }
+    if (contentRaw) {
+      const rawSymbols = (0, import_symbols.detectSymbols)(contentRaw, this.db);
+      const extraSymbols = rawSymbols.filter(
+        (s) => !symbols.some((existing) => existing.qualifiedName === s.qualifiedName)
+      );
+      if (extraSymbols.length > 0) {
+        this.memDb.linkToSymbols(id, extraSymbols.map((s) => s.qualifiedName));
+      }
+    }
+    const obs = this.memDb.getObservation(id);
+    if (obs) {
+      await this.vectorMgr.embedObservation(obs);
+    }
+    return id;
+  }
+  // ── Search ─────────────────────────────────────────────────────────────────
+  /**
+   * Hybrid search: combines FTS5 and vector search with configurable alpha.
+   */
+  async search(query, opts = {}) {
+    const limit = opts.limit ?? 10;
+    const alpha = opts.alpha ?? this.config.memorySearchAlpha ?? 0.5;
+    const ftsResults = this.memDb.searchFTS(query, { ...opts, limit: limit * 2 });
+    let vectorResults = [];
+    if (this.vectorMgr.isEnabled() && !this.vectorMgr.hasModelMismatch()) {
+      vectorResults = await this.vectorMgr.search(query, limit * 2);
+    }
+    if (vectorResults.length === 0) return ftsResults.slice(0, limit);
+    if (ftsResults.length === 0) return vectorResults.slice(0, limit);
+    const merged = this.mergeResults(ftsResults, vectorResults, alpha);
+    return merged.slice(0, limit);
+  }
+  /**
+   * Get observations linked to specific symbols.
+   * Used by kirograph_context and kirograph_impact.
+   */
+  getLinkedObservations(qualifiedNames, limit = 3, threshold = 0.3) {
+    const results = this.memDb.getLinkedObservationsForSymbols(qualifiedNames, limit * 2);
+    return results.filter((r) => r.score >= threshold).slice(0, limit);
+  }
+  // ── Timeline ───────────────────────────────────────────────────────────────
+  /**
+   * List sessions with their observation counts.
+   */
+  timeline(opts = {}) {
+    const limit = opts.limit ?? 5;
+    if (opts.sessionId) {
+      const session = this.memDb.getSession(opts.sessionId);
+      if (!session) return { sessions: [], observations: /* @__PURE__ */ new Map() };
+      const obs = this.memDb.getObservationsBySession(opts.sessionId);
+      const map = /* @__PURE__ */ new Map();
+      map.set(opts.sessionId, obs);
+      return { sessions: [session], observations: map };
+    }
+    const sessions = this.memDb.listSessions(limit);
+    const observations = /* @__PURE__ */ new Map();
+    for (const session of sessions) {
+      const obs = this.memDb.getObservationsBySession(session.id, 10);
+      observations.set(session.id, obs);
+    }
+    return { sessions, observations };
+  }
+  // ── Status ─────────────────────────────────────────────────────────────────
+  getStats() {
+    const modelName = this.config.embeddingModel ?? "nomic-ai/nomic-embed-text-v1.5";
+    return this.memDb.getStats(modelName);
+  }
+  // ── Session management ─────────────────────────────────────────────────────
+  endCurrentSession(ide = "kiro") {
+    const cwd = process.cwd();
+    const sessionTimeout = this.config.memorySessionTimeout ?? 7200;
+    const sessionId = this.memDb.getOrCreateSession(ide, cwd, sessionTimeout);
+    this.memDb.endSession(sessionId);
+  }
+  // ── Maintenance ────────────────────────────────────────────────────────────
+  prune(olderThanMs) {
+    const cutoff = Date.now() - olderThanMs;
+    return this.memDb.prune(cutoff);
+  }
+  async reembed(batchSize = 32) {
+    return this.vectorMgr.reembed(batchSize);
+  }
+  lint() {
+    const staleLinks = this.memDb.findStaleLinks().length;
+    const modelMismatch = this.vectorMgr.hasModelMismatch();
+    const sessionTimeout = (this.config.memorySessionTimeout ?? 7200) * 1e3;
+    const staleSessions = this.memDb.closeStaleSessionsOlderThan(sessionTimeout);
+    return { staleLinks, modelMismatch, staleSessions };
+  }
+  removeStaleLinks() {
+    return this.memDb.removeStaleLinks();
+  }
+  // ── Private ────────────────────────────────────────────────────────────────
+  shouldExclude(text) {
+    if (this.excludePatterns.length === 0) return false;
+    for (const pattern of this.excludePatterns) {
+      const normalized = pattern.replace(/\*/g, "");
+      if (normalized && text.includes(normalized)) return true;
+    }
+    return false;
+  }
+  mergeResults(ftsResults, vectorResults, alpha) {
+    const maxFts = Math.max(...ftsResults.map((r) => r.score), 1);
+    const normalizedFts = /* @__PURE__ */ new Map();
+    for (const r of ftsResults) {
+      normalizedFts.set(r.observation.id, r.score / maxFts);
+    }
+    const normalizedVec = /* @__PURE__ */ new Map();
+    for (const r of vectorResults) {
+      normalizedVec.set(r.observation.id, r.score);
+    }
+    const allIds = /* @__PURE__ */ new Set([...normalizedFts.keys(), ...normalizedVec.keys()]);
+    const merged = [];
+    const obsMap = /* @__PURE__ */ new Map();
+    for (const r of ftsResults) obsMap.set(r.observation.id, r.observation);
+    for (const r of vectorResults) obsMap.set(r.observation.id, r.observation);
+    for (const id of allIds) {
+      const ftsScore = normalizedFts.get(id) ?? 0;
+      const vecScore = normalizedVec.get(id) ?? 0;
+      const hybridScore = (1 - alpha) * ftsScore + alpha * vecScore;
+      const obs = obsMap.get(id);
+      merged.push({ observation: obs, score: hybridScore, scoreSource: "hybrid" });
+    }
+    merged.sort((a, b) => b.score - a.score);
+    return merged;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MemoryDatabase,
+  MemoryManager,
+  MemoryVectorManager,
+  compressObservation,
+  detectSymbols,
+  extractIdentifiers,
+  ...require("./types")
+});
+//# sourceMappingURL=index.js.map