@stackmemoryai/stackmemory 1.7.0 → 1.8.1

package/dist/src/agents/core/agent-task-manager.js

@@ -161,7 +161,7 @@ class AgentTaskManager {
   /**
    * Run a single verifier
    */
-  async runVerifier(verifierId, action, context) {
+  async runVerifier(verifierId, _action, _context) {
     const mockResults = {
       formatter: () => ({
         verifierId: "formatter",
@@ -317,7 +317,7 @@ class AgentTaskManager {
    * Generate feedback from verification results
    */
   generateFeedback(results) {
-    const failed = results.filter((r) => !r.passed);
+    const _failed = results.filter((r) => !r.passed);
     const warnings = results.filter(
       (r) => !r.passed && r.severity === "warning"
     );
@@ -363,7 +363,7 @@ ${warningMessages}`;
       taskId: session.taskId,
       turnCount: session.turnCount
     });
-    const task = this.taskStore.getTask(session.taskId);
+    const _task = this.taskStore.getTask(session.taskId);
     const isComplete = this.assessTaskCompletion(session);
     if (isComplete) {
       await this.completeSession(session);

package/dist/src/agents/verifiers/formatter-verifier.js

@@ -95,7 +95,7 @@ class FormatterVerifier extends BaseVerifier {
   async runFormatter(formatter, context) {
     const command = `${formatter.checkCommand} "${context.filePath}"`;
     try {
-      const { stdout, stderr } = await execAsync(command, {
+      const { _stdout, _stderr } = await execAsync(command, {
         cwd: process.cwd(),
         timeout: this.config.timeout
       });

package/dist/src/agents/verifiers/llm-judge.js

@@ -28,7 +28,7 @@ class LLMJudge extends BaseVerifier {
       ...config
     });
   }
-  shouldActivate(context) {
+  shouldActivate(_context) {
     return true;
   }
   async verify(input, context) {
@@ -185,7 +185,7 @@ class LLMJudge extends BaseVerifier {
       }
     );
   }
-  generateJudgementFeedback(criteria, overallScore, context) {
+  generateJudgementFeedback(criteria, overallScore, _context) {
     if (overallScore >= this.VETO_THRESHOLD) {
       return `Semantic validation PASSED (${(overallScore * 100).toFixed(1)}% confidence). Changes adequately address the requirements.`;
     }

package/dist/src/cli/commands/context-rehydrate.js

@@ -289,7 +289,7 @@ async function listCheckpoints() {
       console.log(
         "\u{1F4A1} Verify: stackmemory context rehydrate --verify -c <checkpoint-id>"
       );
-    } catch (err) {
+    } catch {
       console.log("\u{1F4ED} No rehydration checkpoints directory found");
       console.log(
         "\u{1F4A1} Create first checkpoint with: stackmemory context rehydrate --create"
@@ -382,7 +382,7 @@ async function captureStackTraces() {
   try {
     const traces = [];
     const fs = await import("fs/promises");
-    const { execSync } = await import("child_process");
+    const { _execSync } = await import("child_process");
     const stackMemoryLogs = [
       ".stackmemory/error.log",
       ".stackmemory/compaction.log",

package/dist/src/cli/commands/log.js

@@ -10,7 +10,7 @@ function createLogCommand() {
   const log = new Command("log").alias("history").description("View recent activity log").option("-n, --lines <n>", "Number of entries to show", "20").option("-t, --type <type>", "Filter by type (task, frame, event, sync)").option("-f, --follow", "Follow log in real-time").action(async (options) => {
     const projectRoot = process.cwd();
     const dbPath = join(projectRoot, ".stackmemory", "context.db");
-    const tasksPath = join(projectRoot, ".stackmemory", "tasks.jsonl");
+    const _tasksPath = join(projectRoot, ".stackmemory", "tasks.jsonl");
     if (!existsSync(dbPath)) {
       console.log(
         '\u274C StackMemory not initialized. Run "stackmemory init" first.'

package/dist/src/cli/commands/onboard.js

@@ -99,7 +99,7 @@ async function runOnboarding() {
         console.log(chalk.gray(`Opening signup page: ${signupUrl}`));
         const mod = await import("open");
         await mod.default(signupUrl);
-      } catch (e) {
+      } catch {
         console.log(
           chalk.yellow(
             "Could not open browser automatically. Please sign up and obtain your DATABASE_URL."
@@ -379,7 +379,7 @@ DATABASE_URL=${config.databaseUrl}
           "    Tip: export DATABASE_URL from this file in your shell profile."
         )
       );
-    } catch (e) {
+    } catch {
       console.log(chalk.yellow("  \u26A0 Could not write hosted DB env file"));
     }
   }
@@ -410,7 +410,7 @@ exec stackmemory "$@"
       execFileSync("ln", ["-s", sourcePath, binPath]);
       console.log(chalk.green("  \u2713 Created claude-sm command"));
     }
-  } catch (error) {
+  } catch {
     console.log(
       chalk.yellow("  \u26A0 Could not create claude-sm symlink (may need sudo)")
     );
@@ -506,7 +506,7 @@ fi
       execFileSync("ln", ["-s", codexSourcePath, codexBinPath]);
       console.log(chalk.green("  \u2713 Created codex-sm command"));
     }
-  } catch (error) {
+  } catch {
     console.log(
       chalk.yellow("  \u26A0 Could not create codex-sm symlink (may need sudo)")
     );

package/dist/src/cli/commands/search.js

@@ -88,7 +88,7 @@ function createSearchCommand() {
           console.log("");
           totalResults += tasks.length;
         }
-      } catch (error) {
+      } catch {
       }
     }
     if (searchContext) {
@@ -123,7 +123,7 @@ function createSearchCommand() {
           console.log("");
           totalResults += contexts.length;
         }
-      } catch (error) {
+      } catch {
       }
     }
     if (searchContext) {
@@ -154,7 +154,7 @@ function createSearchCommand() {
           console.log("");
           totalResults += events.length;
         }
-      } catch (error) {
+      } catch {
       }
     }
     db.close();

package/dist/src/cli/commands/setup.js

@@ -759,7 +759,7 @@ function createSetupRemoteCommand() {
     const serviceDir = platform === "darwin" ? join(home, "Library", "LaunchAgents") : join(home, ".config", "systemd", "user");
     const serviceFile = platform === "darwin" ? join(serviceDir, `${serviceName}.plist`) : join(serviceDir, `${serviceName}.service`);
     const logDir = join(home, ".stackmemory", "logs");
-    const pidFile = join(home, ".stackmemory", "remote-mcp.pid");
+    const _pidFile = join(home, ".stackmemory", "remote-mcp.pid");
     if (options.status) {
       console.log(chalk.cyan("\nRemote MCP Server Status\n"));
       if (platform === "darwin") {

package/dist/src/cli/commands/signup.js

@@ -15,7 +15,7 @@ function registerSignupCommand(program) {
       try {
         await open(signupUrl);
         console.log(chalk.green("\u2713 Opened: ") + chalk.cyan(signupUrl));
-      } catch (error) {
+      } catch {
         console.log(chalk.yellow("Could not open browser automatically."));
         console.log(chalk.gray("Please visit: ") + chalk.cyan(signupUrl));
       }

package/dist/src/cli/commands/skills.js

@@ -46,7 +46,7 @@ function getVersion() {
   _version = "0.0.0";
   return _version;
 }
-function getEnv(key, defaultValue) {
+function _getEnv(key, defaultValue) {
   const value = process.env[key];
   if (value === void 0) {
     if (defaultValue !== void 0) return defaultValue;
@@ -58,7 +58,7 @@ function getEnv(key, defaultValue) {
   }
   return value;
 }
-function getOptionalEnv(key) {
+function _getOptionalEnv(key) {
   return process.env[key];
 }
 async function initializeSkillContext() {

package/dist/src/cli/commands/worktree.js

@@ -75,7 +75,7 @@ Detected ${worktrees.length} worktree(s):`));
         } else {
           contextStatus = "\u25CB Not initialized";
         }
-      } catch (error) {
+      } catch {
         contextStatus = "\u2717 Error";
       }
       table.push([

package/dist/src/core/config/config-manager.js

@@ -7,7 +7,8 @@ import * as path from "path";
 import * as yaml from "js-yaml";
 import {
   DEFAULT_CONFIG,
-  PRESET_PROFILES
+  PRESET_PROFILES,
+  DEFAULT_ENRICHMENT
 } from "./types.js";
 class ConfigManager {
   static instance = null;
@@ -75,6 +76,7 @@ class ConfigManager {
         }
       },
       performance: { ...DEFAULT_CONFIG.performance, ...loaded.performance },
+      enrichment: { ...DEFAULT_ENRICHMENT, ...loaded.enrichment },
       profiles: { ...PRESET_PROFILES, ...loaded.profiles }
     };
     if (config.profile && config.profiles?.[config.profile]) {

package/dist/src/core/config/types.js

@@ -103,6 +103,11 @@ const PRESET_PROFILES = {
     }
   }
 };
+const DEFAULT_ENRICHMENT = {
+  enabled: false,
+  lookbackDepth: 3,
+  extractEntities: true
+};
 const DEFAULT_CONFIG = {
   version: "1.0",
   scoring: {
@@ -133,10 +138,12 @@ const DEFAULT_CONFIG = {
     retrieval_timeout_ms: 500,
     batch_upload_size: 100
   },
+  enrichment: DEFAULT_ENRICHMENT,
   profiles: PRESET_PROFILES
 };
 export {
   DEFAULT_CONFIG,
+  DEFAULT_ENRICHMENT,
   DEFAULT_TOOL_SCORES,
   DEFAULT_WEIGHTS,
   PRESET_PROFILES

package/dist/src/core/context/dual-stack-manager.js

@@ -19,7 +19,7 @@ class DualStackManager {
   activeContext;
   handoffRequests = /* @__PURE__ */ new Map();
   permissionManager;
-  constructor(adapter, projectId, userId, defaultTeamId) {
+  constructor(adapter, projectId, userId, _defaultTeamId) {
     this.adapter = adapter;
     this.permissionManager = new PermissionManager();
     const rawDb = adapter instanceof SQLiteAdapter ? adapter.getRawDatabase() : null;
@@ -796,7 +796,7 @@ class DualStackManager {
               )
             );
             stacks.push(context);
-          } catch (permissionError) {
+          } catch {
             logger.debug("User lacks access to stack", {
               stackId: context.stackId,
               userId: this.activeContext.ownerId

package/dist/src/core/context/frame-database.js

@@ -150,6 +150,44 @@ class FrameDatabase {
         -- Set initial schema version if not exists
         INSERT OR IGNORE INTO schema_version (version) VALUES (1);
       `);
+      try {
+        this.db.exec(
+          "ALTER TABLE frames ADD COLUMN access_count INTEGER DEFAULT 0"
+        );
+      } catch {
+      }
+      try {
+        this.db.exec("ALTER TABLE frames ADD COLUMN last_accessed INTEGER");
+      } catch {
+      }
+      this.db.exec(`
+        CREATE TABLE IF NOT EXISTS frame_access_log (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          frame_id TEXT NOT NULL,
+          accessed_at INTEGER NOT NULL DEFAULT (unixepoch()),
+          FOREIGN KEY (frame_id) REFERENCES frames(frame_id) ON DELETE CASCADE
+        );
+        CREATE INDEX IF NOT EXISTS idx_frame_access_log_frame
+          ON frame_access_log(frame_id);
+      `);
+      this.db.exec(`
+        CREATE TABLE IF NOT EXISTS entity_states (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          project_id TEXT NOT NULL,
+          entity_name TEXT NOT NULL,
+          relation TEXT NOT NULL,
+          value TEXT NOT NULL,
+          context TEXT,
+          source_frame_id TEXT,
+          valid_from INTEGER NOT NULL DEFAULT (unixepoch()),
+          superseded_at INTEGER,
+          FOREIGN KEY (source_frame_id) REFERENCES frames(frame_id)
+        );
+        CREATE INDEX IF NOT EXISTS idx_entity_name
+          ON entity_states(project_id, entity_name, relation);
+        CREATE INDEX IF NOT EXISTS idx_entity_temporal
+          ON entity_states(entity_name, valid_from DESC);
+      `);
       this.db.exec(`
         CREATE TABLE IF NOT EXISTS cord_tasks (
           task_id TEXT PRIMARY KEY,

package/dist/src/core/context/frame-enrichment.js

@@ -0,0 +1,93 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { logger } from "../monitoring/logger.js";
+import { frameLifecycleHooks } from "./frame-lifecycle-hooks.js";
+const ENRICHMENT_PROMPT = `You are a context enrichment engine. Given a frame digest and its parent context, do two things:
+1. Rewrite the digest to be fully self-contained \u2014 resolve all pronouns ("it", "that", "the project") using parent context.
+2. Extract entity-relation-value triples from the content.
+
+Respond in JSON only:
+{"enrichedDigest":"...","entities":[{"name":"...","relation":"...","value":"...","context":"..."}]}`;
+function buildEnrichmentInput(frame, parents) {
+  const parentCtx = parents.map((p) => `[${p.name}]: ${p.digest_text ?? ""}`).join("\n");
+  return `Parent context:
+${parentCtx}
+
+Current frame "${frame.name}":
+${frame.digest_text ?? ""}`;
+}
+async function enrichFrame(frame, parents, apiKey) {
+  try {
+    const Anthropic = (await import("@anthropic-ai/sdk")).default;
+    const client = new Anthropic({ apiKey });
+    const input = buildEnrichmentInput(frame, parents);
+    const response = await client.messages.create({
+      model: "claude-3-5-haiku-latest",
+      max_tokens: 1024,
+      system: ENRICHMENT_PROMPT,
+      messages: [{ role: "user", content: input }]
+    });
+    const text = response.content[0].type === "text" ? response.content[0].text : "";
+    return JSON.parse(text);
+  } catch (err) {
+    logger.warn("Frame enrichment LLM call failed", {
+      error: err instanceof Error ? err.message : String(err),
+      frameId: frame.frame_id
+    });
+    return void 0;
+  }
+}
+let unregister = null;
+function registerEnrichmentHook(config, deps) {
+  if (unregister) unregister();
+  if (!config.enabled) return () => {
+  };
+  const apiKey = process.env.ANTHROPIC_API_KEY;
+  if (!apiKey) {
+    logger.warn("Enrichment enabled but ANTHROPIC_API_KEY not set");
+    return () => {
+    };
+  }
+  unregister = frameLifecycleHooks.onFrameClosed(
+    "frame-enrichment",
+    async (data) => {
+      if (!data.frame.digest_text) return;
+      const parents = await deps.getParentFrames(
+        data.frame.frame_id,
+        config.lookbackDepth
+      );
+      const result = await enrichFrame(data.frame, parents, apiKey);
+      if (!result) return;
+      await deps.updateDigest(data.frame.frame_id, result.enrichedDigest);
+      if (config.extractEntities) {
+        for (const entity of result.entities) {
+          try {
+            deps.recordEntity(
+              data.frame.project_id,
+              entity.name,
+              entity.relation,
+              entity.value,
+              entity.context,
+              data.frame.frame_id
+            );
+          } catch {
+          }
+        }
+      }
+    },
+    -10
+    // low priority — runs after other hooks
+  );
+  return () => {
+    if (unregister) {
+      unregister();
+      unregister = null;
+    }
+  };
+}
+export {
+  enrichFrame,
+  registerEnrichmentHook
+};

package/dist/src/core/context/frame-handoff-manager.js

@@ -489,7 +489,7 @@ class FrameHandoffManager {
    */
   async getHandoffMetrics(timeRange) {
     const handoffs = Array.from(this.activeHandoffs.values());
-    const filteredHandoffs = timeRange ? handoffs.filter((h) => {
+    const filteredHandoffs = timeRange ? handoffs.filter((_h) => {
       return true;
     }) : handoffs;
     const completedHandoffs = filteredHandoffs.filter(

package/dist/src/core/context/frame-manager.js

@@ -12,7 +12,7 @@ import {
 } from "../errors/index.js";
 import { FrameQueryMode } from "../session/index.js";
 import { frameLifecycleHooks } from "./frame-lifecycle-hooks.js";
-const MAX_FRAME_DEPTH = 100;
+const _MAX_FRAME_DEPTH = 100;
 const DEFAULT_MAX_DEPTH = 100;
 import { FrameDatabase } from "./frame-database.js";
 import { FrameStack } from "./frame-stack.js";
@@ -167,7 +167,7 @@ class FrameManager {
       outputs: {},
       digest_json: {}
     };
-    const createdFrame = this.frameDb.insertFrame(frame);
+    const _createdFrame = this.frameDb.insertFrame(frame);
     this.frameStack.pushFrame(frameId);
     logger.info("Created frame", {
       frameId,
@@ -275,7 +275,7 @@ class FrameManager {
       event_type: eventType,
       payload
     };
-    const createdEvent = this.frameDb.insertEvent(event);
+    const _createdEvent = this.frameDb.insertEvent(event);
     logger.debug("Added event", {
       eventId,
       frameId: targetFrameId,
@@ -316,7 +316,7 @@ class FrameManager {
       priority,
       metadata
     };
-    const createdAnchor = this.frameDb.insertAnchor(anchor);
+    const _createdAnchor = this.frameDb.insertAnchor(anchor);
     logger.debug("Added anchor", {
       anchorId,
       frameId: targetFrameId,

package/dist/src/core/context/rehydration.js

@@ -622,7 +622,7 @@ class EnhancedRehydrationManager {
       ];
       const files = await this.getDirectoryFiles(workingDir);
       for (const file of files) {
-        const ext = path.extname(file);
+        const _ext = path.extname(file);
         const basename = path.basename(file);
         if (configPatterns.some(
           (pattern) => pattern.includes("*") ? basename.includes(pattern.replace("*", "")) : basename === pattern
@@ -825,10 +825,10 @@ Stack preview: ${trace.stack_frames.slice(0, 3).join("\n")}`,
     logger.info("Rich context injected successfully");
   }
   // Helper methods
-  async getDirectoryFiles(dir) {
+  async getDirectoryFiles(_dir) {
     return [];
   }
-  async getRecentlyModifiedFiles(dir) {
+  async getRecentlyModifiedFiles(_dir) {
     return [];
   }
   inferContextTags(filePath) {
@@ -917,7 +917,7 @@ Stack preview: ${trace.stack_frames.slice(0, 3).join("\n")}`,
         resolution_attempted: data.resolutionAttempts || [],
         resolution_status: data.resolved ? "resolved" : "pending"
       };
-    } catch (error) {
+    } catch {
       return null;
     }
   }
@@ -944,7 +944,7 @@ Stack preview: ${trace.stack_frames.slice(0, 3).join("\n")}`,
     }
     return [...new Set(workflows)];
   }
-  inferCurrentFocus(snapshots, context) {
+  inferCurrentFocus(snapshots, _context) {
     if (snapshots.some((s) => s.contextTags.includes("migration"))) {
       return "Data migration and transformation";
     }
@@ -953,7 +953,7 @@ Stack preview: ${trace.stack_frames.slice(0, 3).join("\n")}`,
     }
     return "Development";
   }
-  createRecoveryAnchors(snapshots, context) {
+  createRecoveryAnchors(snapshots, _context) {
     const anchors = [];
     for (const snapshot of snapshots.slice(0, 3)) {
       anchors.push(

package/dist/src/core/database/sqlite-adapter.js

@@ -468,19 +468,11 @@ class SQLiteAdapter extends FeatureAwareDatabaseAdapter {
     };
   }
   /**
-   * Compute importance score for a single frame.
-   * Score range: [0.0, 1.0] — higher means more important, less likely to be GC'd.
+   * Compute structural salience for a frame (range 0.3-1.0).
+   * Based on anchors, events, digest, and children.
    */
-  computeImportanceScore(frameId) {
-    if (!this.db)
-      throw new DatabaseError(
-        "Database not connected",
-        ErrorCode.DB_CONNECTION_FAILED
-      );
-    const frame = this.db.prepare(
-      "SELECT frame_id, digest_text, created_at FROM frames WHERE frame_id = ?"
-    ).get(frameId);
-    if (!frame) return 0.3;
+  computeSalience(frameId, digestText) {
+    if (!this.db) return 0.3;
     let score = 0.3;
     const decisionCount = this.db.prepare(
       "SELECT COUNT(*) as count FROM anchors WHERE frame_id = ? AND type = 'DECISION'"
@@ -488,14 +480,61 @@ class SQLiteAdapter extends FeatureAwareDatabaseAdapter {
     if (decisionCount > 0) score += 0.15;
     const eventCount = this.db.prepare("SELECT COUNT(*) as count FROM events WHERE frame_id = ?").get(frameId).count;
     if (eventCount > 3) score += 0.1;
-    if (frame.digest_text) score += 0.15;
+    if (digestText) score += 0.15;
     const childCount = this.db.prepare(
       "SELECT COUNT(*) as count FROM frames WHERE parent_frame_id = ?"
     ).get(frameId).count;
     if (childCount > 0) score += 0.1;
+    return Math.min(score, 1);
+  }
+  /**
+   * Compute importance score using Ebbinghaus retention decay + reinforcement.
+   *
+   * R(frame, t) = I_salience * e^(-lambda * dt) + sigma * sum(1 / (t - t_access_i))
+   *
+   * Score range: [0.05, 1.0] — never fully zero.
+   */
+  computeImportanceScore(frameId) {
+    if (!this.db)
+      throw new DatabaseError(
+        "Database not connected",
+        ErrorCode.DB_CONNECTION_FAILED
+      );
+    const frame = this.db.prepare(
+      "SELECT frame_id, digest_text, created_at FROM frames WHERE frame_id = ?"
+    ).get(frameId);
+    if (!frame) return 0.3;
+    const salience = this.computeSalience(frameId, frame.digest_text);
     const nowSec = Math.floor(Date.now() / 1e3);
-    if (nowSec - frame.created_at < 86400) score += 0.1;
-    return Math.round(Math.min(score, 1) * 100) / 100;
+    const dtDays = Math.max(0, (nowSec - frame.created_at) / 86400);
+    const lambda = 0.05;
+    const decayTerm = salience * Math.exp(-lambda * dtDays);
+    const sigma = 0.1;
+    const accesses = this.db.prepare("SELECT accessed_at FROM frame_access_log WHERE frame_id = ?").all(frameId);
+    let reinforcement = 0;
+    for (const a of accesses) {
+      const gap = nowSec - a.accessed_at;
+      if (gap > 0) reinforcement += 1 / gap;
+    }
+    const raw = decayTerm + sigma * reinforcement;
+    return Math.round(Math.min(Math.max(raw, 0.05), 1) * 100) / 100;
+  }
+  /**
+   * Record a frame access for retention decay scoring.
+   * Inserts into frame_access_log and bumps access_count/last_accessed.
+   */
+  recordFrameAccess(frameId) {
+    if (!this.db) return;
+    const nowSec = Math.floor(Date.now() / 1e3);
+    try {
+      this.db.prepare(
+        "INSERT INTO frame_access_log (frame_id, accessed_at) VALUES (?, ?)"
+      ).run(frameId, nowSec);
+      this.db.prepare(
+        "UPDATE frames SET access_count = COALESCE(access_count, 0) + 1, last_accessed = ? WHERE frame_id = ?"
+      ).run(nowSec, frameId);
+    } catch {
+    }
   }
   /**
    * Compress a frame by stripping data according to strategy.
@@ -1611,6 +1650,88 @@ class SQLiteAdapter extends FeatureAwareDatabaseAdapter {
       }
     });
   }
+  // --- Entity State Methods ---
+  recordEntityState(projectId, entityName, relation, value, context, sourceFrameId) {
+    if (!this.db)
+      throw new DatabaseError(
+        "Database not connected",
+        ErrorCode.DB_CONNECTION_FAILED
+      );
+    const nowSec = Math.floor(Date.now() / 1e3);
+    this.db.prepare(
+      `UPDATE entity_states
+         SET superseded_at = ?
+         WHERE entity_name = ? AND relation = ? AND superseded_at IS NULL`
+    ).run(nowSec, entityName, relation);
+    const result = this.db.prepare(
+      `INSERT INTO entity_states
+         (project_id, entity_name, relation, value, context, source_frame_id, valid_from)
+         VALUES (?, ?, ?, ?, ?, ?, ?)`
+    ).run(
+      projectId,
+      entityName,
+      relation,
+      value,
+      context ?? null,
+      sourceFrameId ?? null,
+      nowSec
+    );
+    return Number(result.lastInsertRowid);
+  }
+  getEntityState(entityName, relation, asOf) {
+    if (!this.db)
+      throw new DatabaseError(
+        "Database not connected",
+        ErrorCode.DB_CONNECTION_FAILED
+      );
+    if (asOf != null) {
+      const relFilter2 = relation ? " AND relation = ?" : "";
+      const sql2 = `SELECT * FROM entity_states
+        WHERE entity_name = ?${relFilter2}
+          AND valid_from <= ?
+          AND (superseded_at IS NULL OR superseded_at > ?)
+        ORDER BY valid_from DESC`;
+      const params2 = [entityName];
+      if (relation) params2.push(relation);
+      params2.push(asOf, asOf);
+      return this.db.prepare(sql2).all(...params2);
+    }
+    const relFilter = relation ? " AND relation = ?" : "";
+    const sql = `SELECT * FROM entity_states
+      WHERE entity_name = ?${relFilter} AND superseded_at IS NULL
+      ORDER BY valid_from DESC, id DESC`;
+    const params = [entityName];
+    if (relation) params.push(relation);
+    return this.db.prepare(sql).all(...params);
+  }
+  getEntityHistory(entityName, relation) {
+    if (!this.db)
+      throw new DatabaseError(
+        "Database not connected",
+        ErrorCode.DB_CONNECTION_FAILED
+      );
+    const relFilter = relation ? " AND relation = ?" : "";
+    const sql = `SELECT * FROM entity_states
+      WHERE entity_name = ?${relFilter}
+      ORDER BY valid_from DESC, id DESC`;
+    const params = [entityName];
+    if (relation) params.push(relation);
+    return this.db.prepare(sql).all(...params);
+  }
+  getEntityDiff(entityName, since) {
+    if (!this.db)
+      throw new DatabaseError(
+        "Database not connected",
+        ErrorCode.DB_CONNECTION_FAILED
+      );
+    const sinceFilter = since != null ? " AND valid_from > ?" : "";
+    const sql = `SELECT * FROM entity_states
+      WHERE entity_name = ?${sinceFilter}
+      ORDER BY valid_from DESC, id DESC`;
+    const params = [entityName];
+    if (since != null) params.push(since);
+    return this.db.prepare(sql).all(...params);
+  }
 }
 export {
   SQLiteAdapter