@a-company/sentinel 0.2.0

package/dist/chunk-KPMG4XED.js

@@ -0,0 +1,1249 @@
+// src/storage.ts
+import initSqlJs from "sql.js";
+import { v4 as uuidv4 } from "uuid";
+import * as path from "path";
+import * as fs from "fs";
+var SCHEMA_VERSION = 2;
+var DEFAULT_CONFIDENCE = {
+  score: 50,
+  timesMatched: 0,
+  timesResolved: 0,
+  timesRecurred: 0
+};
+var SQL = null;
+var SentinelStorage = class {
+  db = null;
+  dbPath;
+  incidentCounter = 0;
+  initialized = false;
+  constructor(dbPath) {
+    this.dbPath = dbPath || this.getDefaultDbPath();
+  }
+  getDefaultDbPath() {
+    const dataDir = process.env.SENTINEL_DATA_DIR || process.env.PARADIGM_DATA_DIR || path.join(process.cwd(), ".paradigm", "sentinel");
+    return path.join(dataDir, "sentinel.db");
+  }
+  createSchema() {
+    if (!this.db) return;
+    this.db.run(`
+      -- Metadata table for schema versioning
+      CREATE TABLE IF NOT EXISTS metadata (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+
+      -- Incidents table
+      CREATE TABLE IF NOT EXISTS incidents (
+        id TEXT PRIMARY KEY,
+        timestamp TEXT NOT NULL,
+        status TEXT NOT NULL DEFAULT 'open',
+        error_message TEXT NOT NULL,
+        error_stack TEXT,
+        error_code TEXT,
+        error_type TEXT,
+        symbols TEXT NOT NULL,
+        flow_position TEXT,
+        environment TEXT NOT NULL,
+        service TEXT,
+        version TEXT,
+        user_id TEXT,
+        request_id TEXT,
+        group_id TEXT,
+        notes TEXT DEFAULT '[]',
+        related_incidents TEXT DEFAULT '[]',
+        resolved_at TEXT,
+        resolved_by TEXT,
+        resolution TEXT,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+
+      -- Patterns table
+      CREATE TABLE IF NOT EXISTS patterns (
+        id TEXT PRIMARY KEY,
+        name TEXT NOT NULL,
+        description TEXT,
+        pattern TEXT NOT NULL,
+        resolution TEXT NOT NULL,
+        confidence TEXT NOT NULL,
+        source TEXT NOT NULL DEFAULT 'manual',
+        private INTEGER NOT NULL DEFAULT 0,
+        tags TEXT DEFAULT '[]',
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+
+      -- Incident groups
+      CREATE TABLE IF NOT EXISTS groups (
+        id TEXT PRIMARY KEY,
+        name TEXT,
+        common_symbols TEXT,
+        common_error_patterns TEXT,
+        suggested_pattern_id TEXT,
+        first_seen TEXT NOT NULL,
+        last_seen TEXT NOT NULL,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+
+      -- Group members
+      CREATE TABLE IF NOT EXISTS group_members (
+        group_id TEXT NOT NULL,
+        incident_id TEXT NOT NULL,
+        added_at TEXT NOT NULL,
+        PRIMARY KEY (group_id, incident_id)
+      );
+
+      -- Resolutions history
+      CREATE TABLE IF NOT EXISTS resolutions (
+        id TEXT PRIMARY KEY,
+        incident_id TEXT NOT NULL,
+        pattern_id TEXT,
+        commit_hash TEXT,
+        pr_url TEXT,
+        notes TEXT,
+        resolved_at TEXT NOT NULL,
+        recurred INTEGER DEFAULT 0
+      );
+
+      -- Practice events (habits system)
+      CREATE TABLE IF NOT EXISTS practice_events (
+        id TEXT PRIMARY KEY,
+        timestamp TEXT NOT NULL,
+        habit_id TEXT NOT NULL,
+        habit_category TEXT NOT NULL,
+        result TEXT NOT NULL CHECK (result IN ('followed', 'skipped', 'partial')),
+        engineer TEXT NOT NULL,
+        session_id TEXT NOT NULL,
+        lore_entry_id TEXT,
+        task_description TEXT,
+        symbols_touched TEXT DEFAULT '[]',
+        files_modified TEXT DEFAULT '[]',
+        related_incident_id TEXT,
+        notes TEXT
+      );
+
+      -- Indexes
+      CREATE INDEX IF NOT EXISTS idx_incidents_timestamp ON incidents(timestamp);
+      CREATE INDEX IF NOT EXISTS idx_incidents_status ON incidents(status);
+      CREATE INDEX IF NOT EXISTS idx_incidents_environment ON incidents(environment);
+      CREATE INDEX IF NOT EXISTS idx_patterns_source ON patterns(source);
+      CREATE INDEX IF NOT EXISTS idx_practice_events_timestamp ON practice_events(timestamp);
+      CREATE INDEX IF NOT EXISTS idx_practice_events_habit_id ON practice_events(habit_id);
+      CREATE INDEX IF NOT EXISTS idx_practice_events_engineer ON practice_events(engineer);
+      CREATE INDEX IF NOT EXISTS idx_practice_events_session_id ON practice_events(session_id);
+    `);
+    this.db.run(
+      "INSERT OR REPLACE INTO metadata (key, value) VALUES ('schema_version', ?)",
+      [String(SCHEMA_VERSION)]
+    );
+  }
+  save() {
+    if (!this.db) return;
+    const data = this.db.export();
+    const buffer = Buffer.from(data);
+    fs.writeFileSync(this.dbPath, buffer);
+  }
+  // ─── Incidents ───────────────────────────────────────────────────
+  recordIncident(input) {
+    const db = this.db;
+    if (!db) {
+      this.initializeSync();
+    }
+    this.incidentCounter++;
+    const id = `INC-${String(this.incidentCounter).padStart(3, "0")}`;
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    this.db.run(
+      `INSERT INTO incidents (
+        id, timestamp, status, error_message, error_stack, error_code, error_type,
+        symbols, flow_position, environment, service, version, user_id, request_id,
+        group_id, notes, related_incidents, resolved_at, resolved_by, resolution,
+        created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      [
+        id,
+        input.timestamp || now,
+        input.status || "open",
+        input.error.message,
+        input.error.stack || null,
+        input.error.code || null,
+        input.error.type || null,
+        JSON.stringify(input.symbols),
+        input.flowPosition ? JSON.stringify(input.flowPosition) : null,
+        input.environment,
+        input.service || null,
+        input.version || null,
+        input.userId || null,
+        input.requestId || null,
+        input.groupId || null,
+        "[]",
+        "[]",
+        input.resolvedAt || null,
+        input.resolvedBy || null,
+        input.resolution ? JSON.stringify(input.resolution) : null,
+        now,
+        now
+      ]
+    );
+    this.save();
+    return id;
+  }
+  initializeSync() {
+    if (this.initialized && this.db) return;
+    if (!this.db && SQL) {
+      const dir = path.dirname(this.dbPath);
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+      }
+      if (fs.existsSync(this.dbPath)) {
+        const fileData = fs.readFileSync(this.dbPath);
+        this.db = new SQL.Database(fileData);
+      } else {
+        this.db = new SQL.Database();
+        this.createSchema();
+      }
+      try {
+        const result = this.db.exec(
+          "SELECT MAX(CAST(SUBSTR(id, 5) AS INTEGER)) as max FROM incidents"
+        );
+        if (result.length > 0 && result[0].values.length > 0 && result[0].values[0][0]) {
+          this.incidentCounter = result[0].values[0][0];
+        }
+      } catch {
+        this.incidentCounter = 0;
+      }
+      this.migrateSchema();
+      this.initialized = true;
+      this.save();
+    }
+  }
+  /**
+   * Run schema migrations from older versions
+   */
+  migrateSchema() {
+    if (!this.db) return;
+    let currentVersion = 1;
+    try {
+      const result = this.db.exec(
+        "SELECT value FROM metadata WHERE key = 'schema_version'"
+      );
+      if (result.length > 0 && result[0].values.length > 0) {
+        currentVersion = parseInt(result[0].values[0][0], 10) || 1;
+      }
+    } catch {
+    }
+    if (currentVersion < 2) {
+      try {
+        this.db.run(`
+          CREATE TABLE IF NOT EXISTS practice_events (
+            id TEXT PRIMARY KEY,
+            timestamp TEXT NOT NULL,
+            habit_id TEXT NOT NULL,
+            habit_category TEXT NOT NULL,
+            result TEXT NOT NULL CHECK (result IN ('followed', 'skipped', 'partial')),
+            engineer TEXT NOT NULL,
+            session_id TEXT NOT NULL,
+            lore_entry_id TEXT,
+            task_description TEXT,
+            symbols_touched TEXT DEFAULT '[]',
+            files_modified TEXT DEFAULT '[]',
+            related_incident_id TEXT,
+            notes TEXT
+          );
+
+          CREATE INDEX IF NOT EXISTS idx_practice_events_timestamp ON practice_events(timestamp);
+          CREATE INDEX IF NOT EXISTS idx_practice_events_habit_id ON practice_events(habit_id);
+          CREATE INDEX IF NOT EXISTS idx_practice_events_engineer ON practice_events(engineer);
+          CREATE INDEX IF NOT EXISTS idx_practice_events_session_id ON practice_events(session_id);
+        `);
+      } catch {
+      }
+      this.db.run(
+        "INSERT OR REPLACE INTO metadata (key, value) VALUES ('schema_version', '2')"
+      );
+    }
+  }
+  /**
+   * Ensure the storage is ready for use. Must be called once before using storage methods.
+   */
+  async ensureReady() {
+    if (!SQL) {
+      SQL = await initSqlJs();
+    }
+    this.initializeSync();
+  }
+  getIncident(id) {
+    this.initializeSync();
+    const result = this.db.exec("SELECT * FROM incidents WHERE id = ?", [id]);
+    if (result.length === 0 || result[0].values.length === 0) return null;
+    return this.rowToIncident(result[0].columns, result[0].values[0]);
+  }
+  getRecentIncidents(options = {}) {
+    this.initializeSync();
+    const { limit = 50, offset = 0 } = options;
+    const conditions = [];
+    const params = [];
+    if (options.status && options.status !== "all") {
+      conditions.push("status = ?");
+      params.push(options.status);
+    }
+    if (options.environment) {
+      conditions.push("environment = ?");
+      params.push(options.environment);
+    }
+    if (options.symbol) {
+      conditions.push("symbols LIKE ?");
+      params.push(`%${options.symbol}%`);
+    }
+    if (options.search) {
+      conditions.push("(error_message LIKE ? OR notes LIKE ?)");
+      params.push(`%${options.search}%`, `%${options.search}%`);
+    }
+    if (options.dateFrom) {
+      conditions.push("timestamp >= ?");
+      params.push(options.dateFrom);
+    }
+    if (options.dateTo) {
+      conditions.push("timestamp <= ?");
+      params.push(options.dateTo);
+    }
+    if (options.groupId) {
+      conditions.push("group_id = ?");
+      params.push(options.groupId);
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    const result = this.db.exec(
+      `SELECT * FROM incidents ${whereClause} ORDER BY timestamp DESC LIMIT ? OFFSET ?`,
+      [...params, limit, offset]
+    );
+    if (result.length === 0) return [];
+    return result[0].values.map(
+      (row) => this.rowToIncident(result[0].columns, row)
+    );
+  }
+  updateIncident(id, updates) {
+    this.initializeSync();
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const setClauses = ["updated_at = ?"];
+    const params = [now];
+    if (updates.status !== void 0) {
+      setClauses.push("status = ?");
+      params.push(updates.status);
+    }
+    if (updates.error !== void 0) {
+      setClauses.push("error_message = ?");
+      params.push(updates.error.message);
+      if (updates.error.stack !== void 0) {
+        setClauses.push("error_stack = ?");
+        params.push(updates.error.stack || null);
+      }
+    }
+    if (updates.symbols !== void 0) {
+      setClauses.push("symbols = ?");
+      params.push(JSON.stringify(updates.symbols));
+    }
+    if (updates.flowPosition !== void 0) {
+      setClauses.push("flow_position = ?");
+      params.push(
+        updates.flowPosition ? JSON.stringify(updates.flowPosition) : null
+      );
+    }
+    if (updates.groupId !== void 0) {
+      setClauses.push("group_id = ?");
+      params.push(updates.groupId || null);
+    }
+    if (updates.resolvedAt !== void 0) {
+      setClauses.push("resolved_at = ?");
+      params.push(updates.resolvedAt || null);
+    }
+    if (updates.resolvedBy !== void 0) {
+      setClauses.push("resolved_by = ?");
+      params.push(updates.resolvedBy || null);
+    }
+    if (updates.resolution !== void 0) {
+      setClauses.push("resolution = ?");
+      params.push(
+        updates.resolution ? JSON.stringify(updates.resolution) : null
+      );
+    }
+    params.push(id);
+    this.db.run(
+      `UPDATE incidents SET ${setClauses.join(", ")} WHERE id = ?`,
+      params
+    );
+    this.save();
+  }
+  addIncidentNote(incidentId, note) {
+    this.initializeSync();
+    const incident = this.getIncident(incidentId);
+    if (!incident) return;
+    const newNote = {
+      id: uuidv4(),
+      ...note
+    };
+    const notes = [...incident.notes, newNote];
+    this.db.run(
+      "UPDATE incidents SET notes = ?, updated_at = ? WHERE id = ?",
+      [JSON.stringify(notes), (/* @__PURE__ */ new Date()).toISOString(), incidentId]
+    );
+    this.save();
+  }
+  linkIncidents(incidentId, relatedId) {
+    this.initializeSync();
+    const incident = this.getIncident(incidentId);
+    if (!incident) return;
+    if (!incident.relatedIncidents.includes(relatedId)) {
+      const related = [...incident.relatedIncidents, relatedId];
+      this.db.run(
+        "UPDATE incidents SET related_incidents = ?, updated_at = ? WHERE id = ?",
+        [JSON.stringify(related), (/* @__PURE__ */ new Date()).toISOString(), incidentId]
+      );
+    }
+    const relatedIncident = this.getIncident(relatedId);
+    if (relatedIncident && !relatedIncident.relatedIncidents.includes(incidentId)) {
+      const related = [...relatedIncident.relatedIncidents, incidentId];
+      this.db.run(
+        "UPDATE incidents SET related_incidents = ?, updated_at = ? WHERE id = ?",
+        [JSON.stringify(related), (/* @__PURE__ */ new Date()).toISOString(), relatedId]
+      );
+    }
+    this.save();
+  }
+  getIncidentCount(options = {}) {
+    this.initializeSync();
+    const conditions = [];
+    const params = [];
+    if (options.status && options.status !== "all") {
+      conditions.push("status = ?");
+      params.push(options.status);
+    }
+    if (options.environment) {
+      conditions.push("environment = ?");
+      params.push(options.environment);
+    }
+    if (options.dateFrom) {
+      conditions.push("timestamp >= ?");
+      params.push(options.dateFrom);
+    }
+    if (options.dateTo) {
+      conditions.push("timestamp <= ?");
+      params.push(options.dateTo);
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    const result = this.db.exec(
+      `SELECT COUNT(*) as count FROM incidents ${whereClause}`,
+      params
+    );
+    if (result.length === 0 || result[0].values.length === 0) return 0;
+    return result[0].values[0][0];
+  }
+  // ─── Patterns ────────────────────────────────────────────────────
+  addPattern(input) {
+    this.initializeSync();
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const confidence = {
+      ...DEFAULT_CONFIDENCE,
+      ...input.confidence
+    };
+    this.db.run(
+      `INSERT INTO patterns (
+        id, name, description, pattern, resolution, confidence,
+        source, private, tags, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      [
+        input.id,
+        input.name,
+        input.description || null,
+        JSON.stringify(input.pattern),
+        JSON.stringify(input.resolution),
+        JSON.stringify(confidence),
+        input.source,
+        input.private ? 1 : 0,
+        JSON.stringify(input.tags || []),
+        now,
+        now
+      ]
+    );
+    this.save();
+    return input.id;
+  }
+  getPattern(id) {
+    this.initializeSync();
+    const result = this.db.exec("SELECT * FROM patterns WHERE id = ?", [id]);
+    if (result.length === 0 || result[0].values.length === 0) return null;
+    return this.rowToPattern(result[0].columns, result[0].values[0]);
+  }
+  getAllPatterns(options = {}) {
+    this.initializeSync();
+    const conditions = [];
+    const params = [];
+    if (options.source) {
+      conditions.push("source = ?");
+      params.push(options.source);
+    }
+    if (options.minConfidence !== void 0) {
+      conditions.push("json_extract(confidence, '$.score') >= ?");
+      params.push(options.minConfidence);
+    }
+    if (!options.includePrivate) {
+      conditions.push("private = 0");
+    }
+    if (options.tags && options.tags.length > 0) {
+      const tagConditions = options.tags.map(() => "tags LIKE ?");
+      conditions.push(`(${tagConditions.join(" OR ")})`);
+      params.push(...options.tags.map((tag) => `%"${tag}"%`));
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    const result = this.db.exec(
+      `SELECT * FROM patterns ${whereClause} ORDER BY json_extract(confidence, '$.score') DESC`,
+      params
+    );
+    if (result.length === 0) return [];
+    return result[0].values.map(
+      (row) => this.rowToPattern(result[0].columns, row)
+    );
+  }
+  updatePattern(id, updates) {
+    this.initializeSync();
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const setClauses = ["updated_at = ?"];
+    const params = [now];
+    if (updates.name !== void 0) {
+      setClauses.push("name = ?");
+      params.push(updates.name);
+    }
+    if (updates.description !== void 0) {
+      setClauses.push("description = ?");
+      params.push(updates.description || null);
+    }
+    if (updates.pattern !== void 0) {
+      setClauses.push("pattern = ?");
+      params.push(JSON.stringify(updates.pattern));
+    }
+    if (updates.resolution !== void 0) {
+      setClauses.push("resolution = ?");
+      params.push(JSON.stringify(updates.resolution));
+    }
+    if (updates.confidence !== void 0) {
+      setClauses.push("confidence = ?");
+      params.push(JSON.stringify(updates.confidence));
+    }
+    if (updates.source !== void 0) {
+      setClauses.push("source = ?");
+      params.push(updates.source);
+    }
+    if (updates.private !== void 0) {
+      setClauses.push("private = ?");
+      params.push(updates.private ? 1 : 0);
+    }
+    if (updates.tags !== void 0) {
+      setClauses.push("tags = ?");
+      params.push(JSON.stringify(updates.tags));
+    }
+    params.push(id);
+    this.db.run(
+      `UPDATE patterns SET ${setClauses.join(", ")} WHERE id = ?`,
+      params
+    );
+    this.save();
+  }
+  deletePattern(id) {
+    this.initializeSync();
+    this.db.run("DELETE FROM patterns WHERE id = ?", [id]);
+    this.save();
+  }
+  updatePatternConfidence(patternId, event) {
+    const pattern = this.getPattern(patternId);
+    if (!pattern) return;
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const confidence = { ...pattern.confidence };
+    switch (event) {
+      case "matched":
+        confidence.timesMatched++;
+        confidence.lastMatched = now;
+        break;
+      case "resolved":
+        confidence.timesResolved++;
+        confidence.lastResolved = now;
+        confidence.score = Math.min(100, confidence.score + 2);
+        break;
+      case "recurred":
+        confidence.timesRecurred++;
+        confidence.score = Math.max(10, confidence.score - 5);
+        break;
+    }
+    this.updatePattern(patternId, { confidence });
+  }
+  // ─── Groups ──────────────────────────────────────────────────────
+  createGroup(input) {
+    this.initializeSync();
+    const id = `GRP-${uuidv4().substring(0, 8)}`;
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    this.db.run(
+      `INSERT INTO groups (
+        id, name, common_symbols, common_error_patterns,
+        suggested_pattern_id, first_seen, last_seen, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      [
+        id,
+        input.name || null,
+        JSON.stringify(input.commonSymbols),
+        JSON.stringify(input.commonErrorPatterns),
+        input.suggestedPattern?.id || null,
+        input.firstSeen,
+        input.lastSeen,
+        now,
+        now
+      ]
+    );
+    for (const incidentId of input.incidents) {
+      this.addToGroup(id, incidentId);
+    }
+    this.save();
+    return id;
+  }
+  getGroup(id) {
+    this.initializeSync();
+    const result = this.db.exec("SELECT * FROM groups WHERE id = ?", [id]);
+    if (result.length === 0 || result[0].values.length === 0) return null;
+    return this.rowToGroup(result[0].columns, result[0].values[0]);
+  }
+  getGroups(options = {}) {
+    this.initializeSync();
+    const limit = options.limit || 100;
+    const result = this.db.exec(
+      "SELECT * FROM groups ORDER BY last_seen DESC LIMIT ?",
+      [limit]
+    );
+    if (result.length === 0) return [];
+    return result[0].values.map(
+      (row) => this.rowToGroup(result[0].columns, row)
+    );
+  }
+  addToGroup(groupId, incidentId) {
+    this.initializeSync();
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    this.db.run(
+      "INSERT OR IGNORE INTO group_members (group_id, incident_id, added_at) VALUES (?, ?, ?)",
+      [groupId, incidentId, now]
+    );
+    this.db.run("UPDATE incidents SET group_id = ? WHERE id = ?", [
+      groupId,
+      incidentId
+    ]);
+    this.db.run(
+      "UPDATE groups SET last_seen = ?, updated_at = ? WHERE id = ?",
+      [now, now, groupId]
+    );
+    this.save();
+  }
+  // ─── Resolutions ─────────────────────────────────────────────────
+  recordResolution(resolution) {
+    this.initializeSync();
+    const id = uuidv4();
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    this.db.run(
+      `INSERT INTO resolutions (id, incident_id, pattern_id, commit_hash, pr_url, notes, resolved_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?)`,
+      [
+        id,
+        resolution.incidentId,
+        resolution.patternId || null,
+        resolution.commitHash || null,
+        resolution.prUrl || null,
+        resolution.notes || null,
+        now
+      ]
+    );
+    this.updateIncident(resolution.incidentId, {
+      status: "resolved",
+      resolvedAt: now,
+      resolvedBy: resolution.patternId || "manual",
+      resolution: {
+        patternId: resolution.patternId,
+        commitHash: resolution.commitHash,
+        prUrl: resolution.prUrl,
+        notes: resolution.notes
+      }
+    });
+    if (resolution.patternId) {
+      this.updatePatternConfidence(resolution.patternId, "resolved");
+    }
+    this.save();
+  }
+  markRecurred(incidentId) {
+    this.initializeSync();
+    this.db.run(
+      "UPDATE resolutions SET recurred = 1 WHERE incident_id = ?",
+      [incidentId]
+    );
+    const result = this.db.exec(
+      "SELECT pattern_id FROM resolutions WHERE incident_id = ?",
+      [incidentId]
+    );
+    if (result.length > 0 && result[0].values.length > 0 && result[0].values[0][0]) {
+      this.updatePatternConfidence(result[0].values[0][0], "recurred");
+    }
+    this.save();
+  }
+  getResolutionHistory(options = {}) {
+    this.initializeSync();
+    const conditions = [];
+    const params = [];
+    if (options.patternId) {
+      conditions.push("pattern_id = ?");
+      params.push(options.patternId);
+    }
+    if (options.symbol) {
+      conditions.push(`incident_id IN (
+        SELECT id FROM incidents WHERE symbols LIKE ?
+      )`);
+      params.push(`%${options.symbol}%`);
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    const limit = options.limit || 100;
+    const result = this.db.exec(
+      `SELECT * FROM resolutions ${whereClause} ORDER BY resolved_at DESC LIMIT ?`,
+      [...params, limit]
+    );
+    if (result.length === 0) return [];
+    const columns = result[0].columns;
+    return result[0].values.map((row) => {
+      const obj = {};
+      columns.forEach((col, i) => {
+        obj[col] = row[i];
+      });
+      return {
+        id: obj.id,
+        incidentId: obj.incident_id,
+        patternId: obj.pattern_id || void 0,
+        commitHash: obj.commit_hash || void 0,
+        prUrl: obj.pr_url || void 0,
+        notes: obj.notes || void 0,
+        resolvedAt: obj.resolved_at,
+        recurred: obj.recurred === 1
+      };
+    });
+  }
+  // ─── Stats ───────────────────────────────────────────────────────
+  getStats(period) {
+    this.initializeSync();
+    const { start, end } = period;
+    const total = this.getIncidentCount({ dateFrom: start, dateTo: end });
+    const open = this.getIncidentCount({
+      dateFrom: start,
+      dateTo: end,
+      status: "open"
+    });
+    const resolved = this.getIncidentCount({
+      dateFrom: start,
+      dateTo: end,
+      status: "resolved"
+    });
+    const envResult = this.db.exec(
+      `SELECT environment, COUNT(*) as count
+      FROM incidents
+      WHERE timestamp >= ? AND timestamp <= ?
+      GROUP BY environment`,
+      [start, end]
+    );
+    const byEnvironment = {};
+    if (envResult.length > 0) {
+      for (const row of envResult[0].values) {
+        byEnvironment[row[0]] = row[1];
+      }
+    }
+    const dayResult = this.db.exec(
+      `SELECT DATE(timestamp) as date, COUNT(*) as count
+      FROM incidents
+      WHERE timestamp >= ? AND timestamp <= ?
+      GROUP BY DATE(timestamp)
+      ORDER BY date`,
+      [start, end]
+    );
+    const byDay = [];
+    if (dayResult.length > 0) {
+      for (const row of dayResult[0].values) {
+        byDay.push({ date: row[0], count: row[1] });
+      }
+    }
+    const patterns = this.getAllPatterns({ includePrivate: true });
+    const avgConfidence = patterns.length > 0 ? patterns.reduce((sum, p) => sum + p.confidence.score, 0) / patterns.length : 0;
+    const mostEffective = patterns.sort((a, b) => b.confidence.timesResolved - a.confidence.timesResolved).slice(0, 5).map((p) => ({ patternId: p.id, resolvedCount: p.confidence.timesResolved }));
+    const leastEffective = patterns.filter((p) => p.confidence.timesMatched > 0).map((p) => ({
+      patternId: p.id,
+      recurrenceRate: p.confidence.timesRecurred / Math.max(1, p.confidence.timesResolved)
+    })).sort((a, b) => b.recurrenceRate - a.recurrenceRate).slice(0, 5);
+    const symbolCounts = /* @__PURE__ */ new Map();
+    const incidents = this.getRecentIncidents({
+      dateFrom: start,
+      dateTo: end,
+      limit: 1e3
+    });
+    for (const incident of incidents) {
+      for (const [, value] of Object.entries(incident.symbols)) {
+        if (value) {
+          symbolCounts.set(value, (symbolCounts.get(value) || 0) + 1);
+        }
+      }
+    }
+    const mostIncidents = Array.from(symbolCounts.entries()).sort((a, b) => b[1] - a[1]).slice(0, 10).map(([symbol, count]) => ({ symbol, count }));
+    const resolutions = this.getResolutionHistory({ limit: 1e3 });
+    const periodResolutions = resolutions.filter(
+      (r) => r.resolvedAt >= start && r.resolvedAt <= end
+    );
+    const resolvedWithPattern = periodResolutions.filter(
+      (r) => r.patternId
+    ).length;
+    const resolvedManually = periodResolutions.length - resolvedWithPattern;
+    return {
+      period: { start, end },
+      incidents: {
+        total,
+        open,
+        resolved,
+        byEnvironment,
+        byDay
+      },
+      patterns: {
+        total: patterns.length,
+        avgConfidence: Math.round(avgConfidence),
+        mostEffective,
+        leastEffective
+      },
+      symbols: {
+        mostIncidents,
+        mostResolved: [],
+        hotspots: mostIncidents.slice(0, 5).map((s) => ({
+          symbol: s.symbol,
+          incidentRate: s.count / Math.max(1, total)
+        }))
+      },
+      resolution: {
+        avgTimeToResolve: 0,
+        resolvedWithPattern,
+        resolvedManually,
+        resolutionRate: total > 0 ? resolved / total * 100 : 0
+      }
+    };
+  }
+  getSymbolHealth(symbol) {
+    const incidents = this.getRecentIncidents({ symbol, limit: 1e3 });
+    const incidentCount = incidents.length;
+    const patternCounts = /* @__PURE__ */ new Map();
+    for (const incident of incidents) {
+      if (incident.resolution?.patternId) {
+        const count = patternCounts.get(incident.resolution.patternId) || 0;
+        patternCounts.set(incident.resolution.patternId, count + 1);
+      }
+    }
+    const topPatterns = Array.from(patternCounts.entries()).sort((a, b) => b[1] - a[1]).slice(0, 5).map(([patternId, count]) => ({ patternId, count }));
+    return {
+      incidentCount,
+      avgTimeToResolve: 0,
+      topPatterns
+    };
+  }
+  // ─── Import/Export ───────────────────────────────────────────────
+  exportPatterns(options = {}) {
+    const patterns = this.getAllPatterns({
+      includePrivate: options.includePrivate
+    });
+    return {
+      version: "1.0.0",
+      exportedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      patterns
+    };
+  }
+  importPatterns(data, options = {}) {
+    let imported = 0;
+    let skipped = 0;
+    for (const pattern of data.patterns) {
+      const existing = this.getPattern(pattern.id);
+      if (existing && !options.overwrite) {
+        skipped++;
+        continue;
+      }
+      if (existing) {
+        this.updatePattern(pattern.id, pattern);
+      } else {
+        this.addPattern({
+          ...pattern,
+          source: "imported"
+        });
+      }
+      imported++;
+    }
+    return { imported, skipped };
+  }
+  exportBackup() {
+    const incidents = this.getRecentIncidents({ limit: 1e5 });
+    const patterns = this.getAllPatterns({ includePrivate: true });
+    const groups = this.getGroups({ limit: 1e4 });
+    return {
+      version: "1.0.0",
+      exportedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      incidents,
+      patterns,
+      groups
+    };
+  }
+  importBackup(data) {
+    this.initializeSync();
+    this.db.run("DELETE FROM group_members");
+    this.db.run("DELETE FROM resolutions");
+    this.db.run("DELETE FROM groups");
+    this.db.run("DELETE FROM incidents");
+    this.db.run("DELETE FROM patterns");
+    for (const pattern of data.patterns) {
+      this.addPattern(pattern);
+    }
+    for (const incident of data.incidents) {
+      const now2 = incident.timestamp;
+      this.db.run(
+        `INSERT INTO incidents (
+          id, timestamp, status, error_message, error_stack, error_code, error_type,
+          symbols, flow_position, environment, service, version, user_id, request_id,
+          group_id, notes, related_incidents, resolved_at, resolved_by, resolution,
+          created_at, updated_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        [
+          incident.id,
+          incident.timestamp,
+          incident.status,
+          incident.error.message,
+          incident.error.stack || null,
+          incident.error.code || null,
+          incident.error.type || null,
+          JSON.stringify(incident.symbols),
+          incident.flowPosition ? JSON.stringify(incident.flowPosition) : null,
+          incident.environment,
+          incident.service || null,
+          incident.version || null,
+          incident.userId || null,
+          incident.requestId || null,
+          incident.groupId || null,
+          JSON.stringify(incident.notes),
+          JSON.stringify(incident.relatedIncidents),
+          incident.resolvedAt || null,
+          incident.resolvedBy || null,
+          incident.resolution ? JSON.stringify(incident.resolution) : null,
+          now2,
+          now2
+        ]
+      );
+    }
+    const result = this.db.exec(
+      "SELECT MAX(CAST(SUBSTR(id, 5) AS INTEGER)) as max FROM incidents"
+    );
+    if (result.length > 0 && result[0].values.length > 0 && result[0].values[0][0]) {
+      this.incidentCounter = result[0].values[0][0];
+    }
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    for (const group of data.groups) {
+      this.db.run(
+        `INSERT INTO groups (
+          id, name, common_symbols, common_error_patterns,
+          suggested_pattern_id, first_seen, last_seen, created_at, updated_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        [
+          group.id,
+          group.name || null,
+          JSON.stringify(group.commonSymbols),
+          JSON.stringify(group.commonErrorPatterns),
+          group.suggestedPattern?.id || null,
+          group.firstSeen,
+          group.lastSeen,
+          now,
+          now
+        ]
+      );
+      for (const incidentId of group.incidents) {
+        this.db.run(
+          "INSERT OR IGNORE INTO group_members (group_id, incident_id, added_at) VALUES (?, ?, ?)",
+          [group.id, incidentId, now]
+        );
+      }
+    }
+    this.save();
+  }
+  // ─── Helper Methods ──────────────────────────────────────────────
+  rowToIncident(columns, row) {
+    const obj = {};
+    columns.forEach((col, i) => {
+      obj[col] = row[i];
+    });
+    return {
+      id: obj.id,
+      timestamp: obj.timestamp,
+      status: obj.status,
+      error: {
+        message: obj.error_message,
+        stack: obj.error_stack || void 0,
+        code: obj.error_code || void 0,
+        type: obj.error_type || void 0
+      },
+      symbols: JSON.parse(obj.symbols || "{}"),
+      flowPosition: obj.flow_position ? JSON.parse(obj.flow_position) : void 0,
+      environment: obj.environment,
+      service: obj.service || void 0,
+      version: obj.version || void 0,
+      userId: obj.user_id || void 0,
+      requestId: obj.request_id || void 0,
+      groupId: obj.group_id || void 0,
+      notes: JSON.parse(obj.notes || "[]"),
+      relatedIncidents: JSON.parse(obj.related_incidents || "[]"),
+      resolvedAt: obj.resolved_at || void 0,
+      resolvedBy: obj.resolved_by || void 0,
+      resolution: obj.resolution ? JSON.parse(obj.resolution) : void 0
+    };
+  }
+  rowToPattern(columns, row) {
+    const obj = {};
+    columns.forEach((col, i) => {
+      obj[col] = row[i];
+    });
+    return {
+      id: obj.id,
+      name: obj.name,
+      description: obj.description || "",
+      pattern: JSON.parse(obj.pattern),
+      resolution: JSON.parse(obj.resolution),
+      confidence: JSON.parse(obj.confidence),
+      source: obj.source,
+      private: obj.private === 1,
+      tags: JSON.parse(obj.tags || "[]"),
+      createdAt: obj.created_at,
+      updatedAt: obj.updated_at
+    };
+  }
+  rowToGroup(columns, row) {
+    const obj = {};
+    columns.forEach((col, i) => {
+      obj[col] = row[i];
+    });
+    const membersResult = this.db.exec(
+      "SELECT incident_id FROM group_members WHERE group_id = ?",
+      [obj.id]
+    );
+    const incidents = [];
+    if (membersResult.length > 0) {
+      for (const r of membersResult[0].values) {
+        incidents.push(r[0]);
+      }
+    }
+    const envResult = this.db.exec(
+      `SELECT DISTINCT environment FROM incidents
+      WHERE id IN (SELECT incident_id FROM group_members WHERE group_id = ?)`,
+      [obj.id]
+    );
+    const environments = [];
+    if (envResult.length > 0) {
+      for (const r of envResult[0].values) {
+        environments.push(r[0]);
+      }
+    }
+    return {
+      id: obj.id,
+      name: obj.name || void 0,
+      incidents,
+      commonSymbols: JSON.parse(obj.common_symbols || "{}"),
+      commonErrorPatterns: JSON.parse(
+        obj.common_error_patterns || "[]"
+      ),
+      count: incidents.length,
+      firstSeen: obj.first_seen,
+      lastSeen: obj.last_seen,
+      environments,
+      suggestedPattern: obj.suggested_pattern_id ? this.getPattern(obj.suggested_pattern_id) || void 0 : void 0
+    };
+  }
+  // ─── Practice Events ─────────────────────────────────────────────
+  recordPracticeEvent(input) {
+    this.initializeSync();
+    const id = `PE-${uuidv4().substring(0, 8)}`;
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    this.db.run(
+      `INSERT INTO practice_events (
+        id, timestamp, habit_id, habit_category, result,
+        engineer, session_id, lore_entry_id, task_description,
+        symbols_touched, files_modified, related_incident_id, notes
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      [
+        id,
+        now,
+        input.habitId,
+        input.habitCategory,
+        input.result,
+        input.engineer,
+        input.sessionId,
+        input.loreEntryId || null,
+        input.taskDescription || null,
+        JSON.stringify(input.symbolsTouched || []),
+        JSON.stringify(input.filesModified || []),
+        input.relatedIncidentId || null,
+        input.notes || null
+      ]
+    );
+    this.save();
+    return id;
+  }
+  getPracticeEvents(options = {}) {
+    this.initializeSync();
+    const { limit = 100, offset = 0 } = options;
+    const conditions = [];
+    const params = [];
+    if (options.habitId) {
+      conditions.push("habit_id = ?");
+      params.push(options.habitId);
+    }
+    if (options.habitCategory) {
+      conditions.push("habit_category = ?");
+      params.push(options.habitCategory);
+    }
+    if (options.result) {
+      conditions.push("result = ?");
+      params.push(options.result);
+    }
+    if (options.engineer) {
+      conditions.push("engineer = ?");
+      params.push(options.engineer);
+    }
+    if (options.sessionId) {
+      conditions.push("session_id = ?");
+      params.push(options.sessionId);
+    }
+    if (options.dateFrom) {
+      conditions.push("timestamp >= ?");
+      params.push(options.dateFrom);
+    }
+    if (options.dateTo) {
+      conditions.push("timestamp <= ?");
+      params.push(options.dateTo);
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    const result = this.db.exec(
+      `SELECT * FROM practice_events ${whereClause} ORDER BY timestamp DESC LIMIT ? OFFSET ?`,
+      [...params, limit, offset]
+    );
+    if (result.length === 0) return [];
+    return result[0].values.map(
+      (row) => this.rowToPracticeEvent(result[0].columns, row)
+    );
+  }
+  getPracticeEventCount(options = {}) {
+    this.initializeSync();
+    const conditions = [];
+    const params = [];
+    if (options.habitId) {
+      conditions.push("habit_id = ?");
+      params.push(options.habitId);
+    }
+    if (options.habitCategory) {
+      conditions.push("habit_category = ?");
+      params.push(options.habitCategory);
+    }
+    if (options.result) {
+      conditions.push("result = ?");
+      params.push(options.result);
+    }
+    if (options.engineer) {
+      conditions.push("engineer = ?");
+      params.push(options.engineer);
+    }
+    if (options.dateFrom) {
+      conditions.push("timestamp >= ?");
+      params.push(options.dateFrom);
+    }
+    if (options.dateTo) {
+      conditions.push("timestamp <= ?");
+      params.push(options.dateTo);
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    const result = this.db.exec(
+      `SELECT COUNT(*) as count FROM practice_events ${whereClause}`,
+      params
+    );
+    if (result.length === 0 || result[0].values.length === 0) return 0;
+    return result[0].values[0][0];
+  }
+  getComplianceRate(options = {}) {
+    this.initializeSync();
+    const conditions = [];
+    const params = [];
+    if (options.habitId) {
+      conditions.push("habit_id = ?");
+      params.push(options.habitId);
+    }
+    if (options.habitCategory) {
+      conditions.push("habit_category = ?");
+      params.push(options.habitCategory);
+    }
+    if (options.engineer) {
+      conditions.push("engineer = ?");
+      params.push(options.engineer);
+    }
+    if (options.dateFrom) {
+      conditions.push("timestamp >= ?");
+      params.push(options.dateFrom);
+    }
+    if (options.dateTo) {
+      conditions.push("timestamp <= ?");
+      params.push(options.dateTo);
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    const result = this.db.exec(
+      `SELECT result, COUNT(*) as count
+       FROM practice_events ${whereClause}
+       GROUP BY result`,
+      params
+    );
+    let followed = 0;
+    let skipped = 0;
+    let partial = 0;
+    if (result.length > 0) {
+      for (const row of result[0].values) {
+        const r = row[0];
+        const count = row[1];
+        if (r === "followed") followed = count;
+        else if (r === "skipped") skipped = count;
+        else if (r === "partial") partial = count;
+      }
+    }
+    const total = followed + skipped + partial;
+    const rate = total > 0 ? (followed + partial * 0.5) / total * 100 : 100;
+    return { total, followed, skipped, partial, rate: Math.round(rate) };
+  }
+  rowToPracticeEvent(columns, row) {
+    const obj = {};
+    columns.forEach((col, i) => {
+      obj[col] = row[i];
+    });
+    return {
+      id: obj.id,
+      timestamp: obj.timestamp,
+      habitId: obj.habit_id,
+      habitCategory: obj.habit_category,
+      result: obj.result,
+      engineer: obj.engineer,
+      sessionId: obj.session_id,
+      loreEntryId: obj.lore_entry_id || void 0,
+      taskDescription: obj.task_description || void 0,
+      symbolsTouched: JSON.parse(obj.symbols_touched || "[]"),
+      filesModified: JSON.parse(obj.files_modified || "[]"),
+      relatedIncidentId: obj.related_incident_id || void 0,
+      notes: obj.notes || void 0
+    };
+  }
+  close() {
+    if (this.db) {
+      this.save();
+      this.db.close();
+      this.db = null;
+    }
+  }
+};
+
+export {
+  SentinelStorage
+};