@diegoaltoworks/chatter 0.63.0 → 0.65.0

package/dist/channels/whatsapp/channel.d.ts.map

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

package/dist/channels/whatsapp/index.js

@@ -402,13 +402,31 @@ async function acquireSessionLease(sessionId, deps) {
     retry();
     return;
   }
+  const demoteSelf = () => {
+    void loseSession(sessionId, sessions).then((lost) => {
+      if (lost) retry();
+    });
+  };
+  let lastHeartbeatSuccessAt = now();
   const heartbeat = setInterval(() => {
-    void leaseStore.tryAcquire(sessionId, instanceId, now(), staleMs).then((stillHeld) => {
-      if (stillHeld || isStopped()) return;
-      logger.error(`WhatsApp[${sessionId}]: lost the lease to another instance \u2014 disconnecting`);
-      void loseSession(sessionId, sessions).then((lost) => {
-        if (lost) retry();
-      });
+    if (isStopped()) return;
+    const attemptAt = now();
+    const failingForMs = attemptAt - lastHeartbeatSuccessAt;
+    if (failingForMs >= staleMs) {
+      logger.error(
+        `WhatsApp[${sessionId}]: lease heartbeats have been failing for ${failingForMs}ms, treating the lease as lost`
+      );
+      demoteSelf();
+      return;
+    }
+    void leaseStore.tryAcquire(sessionId, instanceId, attemptAt, staleMs).then((stillHeld) => {
+      if (isStopped()) return;
+      if (!stillHeld) {
+        logger.error(`WhatsApp[${sessionId}]: lost the lease to another instance, disconnecting`);
+        demoteSelf();
+        return;
+      }
+      lastHeartbeatSuccessAt = Math.max(lastHeartbeatSuccessAt, attemptAt);
     }).catch((error) => logger.warn(`WhatsApp[${sessionId}]: lease heartbeat failed:`, error));
   }, heartbeatMs);
   if (typeof heartbeat === "object" && "unref" in heartbeat) heartbeat.unref();

package/dist/channels/whatsapp/index.mjs

@@ -337,13 +337,31 @@ async function acquireSessionLease(sessionId, deps) {
     retry();
     return;
   }
+  const demoteSelf = () => {
+    void loseSession(sessionId, sessions).then((lost) => {
+      if (lost) retry();
+    });
+  };
+  let lastHeartbeatSuccessAt = now();
   const heartbeat = setInterval(() => {
-    void leaseStore.tryAcquire(sessionId, instanceId, now(), staleMs).then((stillHeld) => {
-      if (stillHeld || isStopped()) return;
-      logger.error(`WhatsApp[${sessionId}]: lost the lease to another instance \u2014 disconnecting`);
-      void loseSession(sessionId, sessions).then((lost) => {
-        if (lost) retry();
-      });
+    if (isStopped()) return;
+    const attemptAt = now();
+    const failingForMs = attemptAt - lastHeartbeatSuccessAt;
+    if (failingForMs >= staleMs) {
+      logger.error(
+        `WhatsApp[${sessionId}]: lease heartbeats have been failing for ${failingForMs}ms, treating the lease as lost`
+      );
+      demoteSelf();
+      return;
+    }
+    void leaseStore.tryAcquire(sessionId, instanceId, attemptAt, staleMs).then((stillHeld) => {
+      if (isStopped()) return;
+      if (!stillHeld) {
+        logger.error(`WhatsApp[${sessionId}]: lost the lease to another instance, disconnecting`);
+        demoteSelf();
+        return;
+      }
+      lastHeartbeatSuccessAt = Math.max(lastHeartbeatSuccessAt, attemptAt);
     }).catch((error) => logger.warn(`WhatsApp[${sessionId}]: lease heartbeat failed:`, error));
   }, heartbeatMs);
   if (typeof heartbeat === "object" && "unref" in heartbeat) heartbeat.unref();

package/dist/core/knowledgeHealth.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Post-boot and periodic health checks for the default `VectorStore`
+ * knowledge base, so a collapse is visible in logs the moment it happens
+ * instead of waiting for a user to notice broken answers - the gap that let
+ * two knowledge-base wipes go unnoticed until someone spotted broken
+ * answers.
+ */
+import type { Client as LibsqlClient } from "@libsql/client";
+import { type BuildLock } from "./buildLock";
+import { type Logger } from "./logger";
+export interface KnowledgeHealth {
+    chunksByBucket: Record<string, number>;
+    totalChunks: number;
+    totalEmbeddings: number;
+    /** Embeddings rows with no matching chunks row. */
+    orphanedEmbeddings: number;
+    /** Chunks rows with no matching embeddings row (e.g. a build interrupted mid-embed). */
+    missingEmbeddings: number;
+}
+/**
+ * Read-only snapshot of chunks/embeddings consistency, logged at `info` -
+ * escalating to `warn` when `totalChunks === 0` (the exact signature of both
+ * knowledge-base wipes) or `orphanedEmbeddings > 0`. The query shape mirrors
+ * the diagnostic used live to investigate the second incident.
+ */
+export declare function checkKnowledgeHealth(db: LibsqlClient, logger: Logger): Promise<KnowledgeHealth>;
+export interface KnowledgeHealthCheckConfig {
+    /** Run post-boot and periodic health checks. Default: true. */
+    enabled?: boolean;
+    /** How often to re-run the check after boot. Default: 30 minutes. */
+    intervalMs?: number;
+    /**
+     * Delete orphaned embeddings rows (no matching chunk) whenever a check
+     * finds them. Default: false - opt-in, since it's a delete even though a
+     * safe/idempotent one. Under normal operation orphans should be rare
+     * (`cleanupStaleChunks` already deletes a stale chunk and its embedding
+     * together); this exists chiefly to clean up historical damage and catch
+     * any future code path that doesn't maintain that invariant.
+     */
+    autoCleanOrphanedEmbeddings?: boolean;
+}
+export declare const DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS: number;
+export interface KnowledgeHealthScheduler {
+    /** Runs one check immediately, applying auto-clean if configured. */
+    runOnce(): Promise<KnowledgeHealth>;
+    /** Stops periodic re-checks. Safe to call even if periodic checks never started. */
+    stop(): void;
+}
+export interface ScheduleKnowledgeHealthChecksOptions {
+    db: LibsqlClient;
+    config?: KnowledgeHealthCheckConfig;
+    /** Default: a console logger writing to stderr. */
+    logger?: Logger;
+    /** Default: a lock table in `db` (see buildLock.ts) - the same lock `VectorStore.build()` uses. */
+    buildLock?: BuildLock;
+    /** Identifies this process while it holds the build lock during cleanup. Default: a random id. */
+    instanceId?: string;
+    /** Injectable for tests; defaults to `setInterval`/`clearInterval`. */
+    schedule?: (fn: () => void, ms: number) => {
+        stop: () => void;
+    };
+}
+/**
+ * Runs {@link checkKnowledgeHealth} once immediately and, unless disabled,
+ * again on `intervalMs` via an unref'd timer - so it never blocks process
+ * exit or leaves an open handle in tests. `enabled: false` skips both the
+ * immediate run and the periodic one.
+ */
+export declare function scheduleKnowledgeHealthChecks(options: ScheduleKnowledgeHealthChecksOptions): Promise<KnowledgeHealthScheduler>;
+//# sourceMappingURL=knowledgeHealth.d.ts.map

package/dist/core/knowledgeHealth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledgeHealth.d.ts","sourceRoot":"","sources":["../../src/core/knowledgeHealth.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAGL,KAAK,SAAS,EAEf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAuB,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wFAAwF;IACxF,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,CAuC1B;AAsCD,MAAM,WAAW,0BAA0B;IACzC,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AAED,eAAO,MAAM,oCAAoC,QAAc,CAAC;AAEhE,MAAM,WAAW,wBAAwB;IACvC,qEAAqE;IACrE,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACpC,oFAAoF;IACpF,IAAI,IAAI,IAAI,CAAC;CACd;AAED,MAAM,WAAW,oCAAoC;IACnD,EAAE,EAAE,YAAY,CAAC;IACjB,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mGAAmG;IACnG,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,kGAAkG;IAClG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK;QAAE,IAAI,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;CACjE;AAQD;;;;;GAKG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,oCAAoC,GAC5C,OAAO,CAAC,wBAAwB,CAAC,CAyCnC"}

package/dist/index.js

@@ -416,6 +416,119 @@ var init_retrieval = __esm({
   }
 });
 
+// src/core/knowledgeHealth.ts
+var knowledgeHealth_exports = {};
+__export(knowledgeHealth_exports, {
+  DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS: () => DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS,
+  checkKnowledgeHealth: () => checkKnowledgeHealth,
+  scheduleKnowledgeHealthChecks: () => scheduleKnowledgeHealthChecks
+});
+async function checkKnowledgeHealth(db, logger) {
+  const [byBucket, totalChunksRes, totalEmbeddingsRes, orphanedRes, missingRes] = await Promise.all(
+    [
+      db.execute("SELECT bucket, COUNT(*) as count FROM chunks GROUP BY bucket"),
+      db.execute("SELECT COUNT(*) as count FROM chunks"),
+      db.execute("SELECT COUNT(*) as count FROM embeddings"),
+      db.execute(
+        "SELECT COUNT(*) as count FROM embeddings e LEFT JOIN chunks c ON c.id = e.id WHERE c.id IS NULL"
+      ),
+      db.execute(
+        "SELECT COUNT(*) as count FROM chunks c LEFT JOIN embeddings e ON e.id = c.id WHERE e.id IS NULL"
+      )
+    ]
+  );
+  const chunksByBucket = {};
+  for (const row of byBucket.rows) {
+    chunksByBucket[String(row.bucket)] = Number(row.count ?? 0);
+  }
+  const health = {
+    chunksByBucket,
+    totalChunks: Number(totalChunksRes.rows[0]?.count ?? 0),
+    totalEmbeddings: Number(totalEmbeddingsRes.rows[0]?.count ?? 0),
+    orphanedEmbeddings: Number(orphanedRes.rows[0]?.count ?? 0),
+    missingEmbeddings: Number(missingRes.rows[0]?.count ?? 0)
+  };
+  const summary = `chunksByBucket=${JSON.stringify(health.chunksByBucket)} totalChunks=${health.totalChunks} totalEmbeddings=${health.totalEmbeddings} orphanedEmbeddings=${health.orphanedEmbeddings} missingEmbeddings=${health.missingEmbeddings}`;
+  if (health.totalChunks === 0 || health.orphanedEmbeddings > 0) {
+    logger.warn(`Knowledge base health check: ${summary}`);
+  } else {
+    logger.info(`Knowledge base health check: ${summary}`);
+  }
+  return health;
+}
+async function cleanOrphanedEmbeddings(db, buildLock, instanceId, logger) {
+  const acquired = await buildLock.tryAcquire(
+    BUILD_LOCK_KEY,
+    instanceId,
+    Date.now(),
+    BUILD_LOCK_STALE_MS
+  );
+  if (!acquired) {
+    logger.warn(
+      "Knowledge health: skipping orphaned-embeddings cleanup - the build lock is held by another instance."
+    );
+    return;
+  }
+  try {
+    const result = await db.execute(
+      "DELETE FROM embeddings WHERE id NOT IN (SELECT id FROM chunks)"
+    );
+    if (result.rowsAffected > 0) {
+      logger.warn(`Knowledge health: deleted ${result.rowsAffected} orphaned embedding row(s).`);
+    }
+  } finally {
+    await buildLock.release(BUILD_LOCK_KEY, instanceId);
+  }
+}
+async function scheduleKnowledgeHealthChecks(options) {
+  const logger = options.logger ?? createConsoleLogger();
+  const enabled = options.config?.enabled !== false;
+  const intervalMs = options.config?.intervalMs ?? DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS;
+  const autoClean = options.config?.autoCleanOrphanedEmbeddings === true;
+  const buildLock = options.buildLock ?? createTursoBuildLock(options.db);
+  const instanceId = options.instanceId ?? crypto.randomUUID();
+  const schedule = options.schedule ?? defaultSchedule;
+  async function runOnce() {
+    const health = await checkKnowledgeHealth(options.db, logger);
+    if (autoClean && health.orphanedEmbeddings > 0) {
+      await cleanOrphanedEmbeddings(options.db, buildLock, instanceId, logger);
+    }
+    return health;
+  }
+  let handle;
+  if (enabled) {
+    await runOnce();
+    if (intervalMs > 0) {
+      let ticking = false;
+      handle = schedule(() => {
+        if (ticking) return;
+        ticking = true;
+        runOnce().catch((error) => logger.error("Knowledge health check failed:", error)).finally(() => {
+          ticking = false;
+        });
+      }, intervalMs);
+    }
+  }
+  return {
+    runOnce,
+    stop: () => handle?.stop()
+  };
+}
+var DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS, defaultSchedule;
+var init_knowledgeHealth = __esm({
+  "src/core/knowledgeHealth.ts"() {
+    "use strict";
+    init_buildLock();
+    init_logger();
+    DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS = 30 * 6e4;
+    defaultSchedule = (fn, ms) => {
+      const timer = setInterval(fn, ms);
+      if (typeof timer === "object" && "unref" in timer) timer.unref();
+      return { stop: () => clearInterval(timer) };
+    };
+  }
+});
+
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
@@ -1221,6 +1334,7 @@ async function createMCPServer(config) {
   });
   const model = config.openai.model || DEFAULT_MODEL;
   let store;
+  let db;
   if (config.retriever) {
     store = config.retriever;
   } else {
@@ -1228,7 +1342,7 @@ async function createMCPServer(config) {
       throw new Error(DATABASE_CONFIG_REQUIRED_MESSAGE);
     }
     const { DEFAULT_KNOWLEDGE_DIR: DEFAULT_KNOWLEDGE_DIR2, VectorStore: VectorStore2, createOpenAIEmbedder: createOpenAIEmbedder2, openLibsqlClient: openLibsqlClient2 } = await Promise.resolve().then(() => (init_retrieval(), retrieval_exports));
-    const db = await openLibsqlClient2(config.database);
+    db = await openLibsqlClient2(config.database);
     store = new VectorStore2(createOpenAIEmbedder2(client), {
       databaseClient: db,
       knowledgeDir: config.knowledgeDir || DEFAULT_KNOWLEDGE_DIR2,
@@ -1237,6 +1351,15 @@ async function createMCPServer(config) {
   }
   await store.build?.();
   log.info("\u2705 Knowledge base ready");
+  let knowledgeHealth;
+  if (db) {
+    const { scheduleKnowledgeHealthChecks: scheduleKnowledgeHealthChecks2 } = await Promise.resolve().then(() => (init_knowledgeHealth(), knowledgeHealth_exports));
+    knowledgeHealth = await scheduleKnowledgeHealthChecks2({
+      db,
+      config: config.knowledgeHealthCheck,
+      logger: log
+    });
+  }
   const prompts = new PromptLoader(promptsDir, config.bot);
   const server = new McpServer({
     name: config.bot.name,
@@ -1433,7 +1556,9 @@ async function createMCPServer(config) {
   log.info(
     `\u2705 ${config.bot.name} MCP Server ready (transport: ${transportMode}, tools: ${enabledTools.join(", ") || "none"})`
   );
-  return server;
+  return Object.assign(server, {
+    stopKnowledgeHealthChecks: () => knowledgeHealth?.stop()
+  });
 }
 
 // src/middleware/apiKey.ts
@@ -2416,6 +2541,15 @@ async function createServer(config) {
   }
   await store.build?.();
   logger.info("\u2705 Knowledge base ready");
+  let knowledgeHealth;
+  if (db && !config.retriever) {
+    const { scheduleKnowledgeHealthChecks: scheduleKnowledgeHealthChecks2 } = await Promise.resolve().then(() => (init_knowledgeHealth(), knowledgeHealth_exports));
+    knowledgeHealth = await scheduleKnowledgeHealthChecks2({
+      db,
+      config: config.knowledgeHealthCheck,
+      logger
+    });
+  }
   const prompts = new PromptLoader(promptsDir, config.bot);
   let apiKeyManager;
   const secret = config.auth?.secret || process.env.CHATTER_SECRET;
@@ -2546,6 +2680,7 @@ async function createServer(config) {
     // (sync or async) is caught per-channel so one misbehaving channel can't
     // stop the rest from cleaning up.
     stopChannels: async () => {
+      knowledgeHealth?.stop();
       await Promise.allSettled(
         started.map(async (channel) => {
           try {

package/dist/index.mjs

@@ -393,6 +393,119 @@ var init_retrieval = __esm({
   }
 });
 
+// src/core/knowledgeHealth.ts
+var knowledgeHealth_exports = {};
+__export(knowledgeHealth_exports, {
+  DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS: () => DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS,
+  checkKnowledgeHealth: () => checkKnowledgeHealth,
+  scheduleKnowledgeHealthChecks: () => scheduleKnowledgeHealthChecks
+});
+async function checkKnowledgeHealth(db, logger) {
+  const [byBucket, totalChunksRes, totalEmbeddingsRes, orphanedRes, missingRes] = await Promise.all(
+    [
+      db.execute("SELECT bucket, COUNT(*) as count FROM chunks GROUP BY bucket"),
+      db.execute("SELECT COUNT(*) as count FROM chunks"),
+      db.execute("SELECT COUNT(*) as count FROM embeddings"),
+      db.execute(
+        "SELECT COUNT(*) as count FROM embeddings e LEFT JOIN chunks c ON c.id = e.id WHERE c.id IS NULL"
+      ),
+      db.execute(
+        "SELECT COUNT(*) as count FROM chunks c LEFT JOIN embeddings e ON e.id = c.id WHERE e.id IS NULL"
+      )
+    ]
+  );
+  const chunksByBucket = {};
+  for (const row of byBucket.rows) {
+    chunksByBucket[String(row.bucket)] = Number(row.count ?? 0);
+  }
+  const health = {
+    chunksByBucket,
+    totalChunks: Number(totalChunksRes.rows[0]?.count ?? 0),
+    totalEmbeddings: Number(totalEmbeddingsRes.rows[0]?.count ?? 0),
+    orphanedEmbeddings: Number(orphanedRes.rows[0]?.count ?? 0),
+    missingEmbeddings: Number(missingRes.rows[0]?.count ?? 0)
+  };
+  const summary = `chunksByBucket=${JSON.stringify(health.chunksByBucket)} totalChunks=${health.totalChunks} totalEmbeddings=${health.totalEmbeddings} orphanedEmbeddings=${health.orphanedEmbeddings} missingEmbeddings=${health.missingEmbeddings}`;
+  if (health.totalChunks === 0 || health.orphanedEmbeddings > 0) {
+    logger.warn(`Knowledge base health check: ${summary}`);
+  } else {
+    logger.info(`Knowledge base health check: ${summary}`);
+  }
+  return health;
+}
+async function cleanOrphanedEmbeddings(db, buildLock, instanceId, logger) {
+  const acquired = await buildLock.tryAcquire(
+    BUILD_LOCK_KEY,
+    instanceId,
+    Date.now(),
+    BUILD_LOCK_STALE_MS
+  );
+  if (!acquired) {
+    logger.warn(
+      "Knowledge health: skipping orphaned-embeddings cleanup - the build lock is held by another instance."
+    );
+    return;
+  }
+  try {
+    const result = await db.execute(
+      "DELETE FROM embeddings WHERE id NOT IN (SELECT id FROM chunks)"
+    );
+    if (result.rowsAffected > 0) {
+      logger.warn(`Knowledge health: deleted ${result.rowsAffected} orphaned embedding row(s).`);
+    }
+  } finally {
+    await buildLock.release(BUILD_LOCK_KEY, instanceId);
+  }
+}
+async function scheduleKnowledgeHealthChecks(options) {
+  const logger = options.logger ?? createConsoleLogger();
+  const enabled = options.config?.enabled !== false;
+  const intervalMs = options.config?.intervalMs ?? DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS;
+  const autoClean = options.config?.autoCleanOrphanedEmbeddings === true;
+  const buildLock = options.buildLock ?? createTursoBuildLock(options.db);
+  const instanceId = options.instanceId ?? crypto.randomUUID();
+  const schedule = options.schedule ?? defaultSchedule;
+  async function runOnce() {
+    const health = await checkKnowledgeHealth(options.db, logger);
+    if (autoClean && health.orphanedEmbeddings > 0) {
+      await cleanOrphanedEmbeddings(options.db, buildLock, instanceId, logger);
+    }
+    return health;
+  }
+  let handle;
+  if (enabled) {
+    await runOnce();
+    if (intervalMs > 0) {
+      let ticking = false;
+      handle = schedule(() => {
+        if (ticking) return;
+        ticking = true;
+        runOnce().catch((error) => logger.error("Knowledge health check failed:", error)).finally(() => {
+          ticking = false;
+        });
+      }, intervalMs);
+    }
+  }
+  return {
+    runOnce,
+    stop: () => handle?.stop()
+  };
+}
+var DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS, defaultSchedule;
+var init_knowledgeHealth = __esm({
+  "src/core/knowledgeHealth.ts"() {
+    "use strict";
+    init_buildLock();
+    init_logger();
+    DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS = 30 * 6e4;
+    defaultSchedule = (fn, ms) => {
+      const timer = setInterval(fn, ms);
+      if (typeof timer === "object" && "unref" in timer) timer.unref();
+      return { stop: () => clearInterval(timer) };
+    };
+  }
+});
+
 // src/auth/apikeys.ts
 import { randomUUID } from "node:crypto";
 import { jwtVerify, SignJWT } from "jose";
@@ -1146,6 +1259,7 @@ async function createMCPServer(config) {
   });
   const model = config.openai.model || DEFAULT_MODEL;
   let store;
+  let db;
   if (config.retriever) {
     store = config.retriever;
   } else {
@@ -1153,7 +1267,7 @@ async function createMCPServer(config) {
       throw new Error(DATABASE_CONFIG_REQUIRED_MESSAGE);
     }
     const { DEFAULT_KNOWLEDGE_DIR: DEFAULT_KNOWLEDGE_DIR2, VectorStore: VectorStore2, createOpenAIEmbedder: createOpenAIEmbedder2, openLibsqlClient: openLibsqlClient2 } = await Promise.resolve().then(() => (init_retrieval(), retrieval_exports));
-    const db = await openLibsqlClient2(config.database);
+    db = await openLibsqlClient2(config.database);
     store = new VectorStore2(createOpenAIEmbedder2(client), {
       databaseClient: db,
       knowledgeDir: config.knowledgeDir || DEFAULT_KNOWLEDGE_DIR2,
@@ -1162,6 +1276,15 @@ async function createMCPServer(config) {
   }
   await store.build?.();
   log.info("\u2705 Knowledge base ready");
+  let knowledgeHealth;
+  if (db) {
+    const { scheduleKnowledgeHealthChecks: scheduleKnowledgeHealthChecks2 } = await Promise.resolve().then(() => (init_knowledgeHealth(), knowledgeHealth_exports));
+    knowledgeHealth = await scheduleKnowledgeHealthChecks2({
+      db,
+      config: config.knowledgeHealthCheck,
+      logger: log
+    });
+  }
   const prompts = new PromptLoader(promptsDir, config.bot);
   const server = new McpServer({
     name: config.bot.name,
@@ -1358,7 +1481,9 @@ async function createMCPServer(config) {
   log.info(
     `\u2705 ${config.bot.name} MCP Server ready (transport: ${transportMode}, tools: ${enabledTools.join(", ") || "none"})`
   );
-  return server;
+  return Object.assign(server, {
+    stopKnowledgeHealthChecks: () => knowledgeHealth?.stop()
+  });
 }
 
 // src/middleware/apiKey.ts
@@ -2340,6 +2465,15 @@ async function createServer(config) {
   }
   await store.build?.();
   logger.info("\u2705 Knowledge base ready");
+  let knowledgeHealth;
+  if (db && !config.retriever) {
+    const { scheduleKnowledgeHealthChecks: scheduleKnowledgeHealthChecks2 } = await Promise.resolve().then(() => (init_knowledgeHealth(), knowledgeHealth_exports));
+    knowledgeHealth = await scheduleKnowledgeHealthChecks2({
+      db,
+      config: config.knowledgeHealthCheck,
+      logger
+    });
+  }
   const prompts = new PromptLoader(promptsDir, config.bot);
   let apiKeyManager;
   const secret = config.auth?.secret || process.env.CHATTER_SECRET;
@@ -2470,6 +2604,7 @@ async function createServer(config) {
     // (sync or async) is caught per-channel so one misbehaving channel can't
     // stop the rest from cleaning up.
     stopChannels: async () => {
+      knowledgeHealth?.stop();
       await Promise.allSettled(
         started.map(async (channel) => {
           try {

package/dist/mcp-server.d.ts

@@ -31,5 +31,7 @@ import type { MCPServerOptions } from "./mcp-server/types";
  * await server.connect(transport);
  * ```
  */
-export declare function createMCPServer(config: MCPServerOptions): Promise<import("@modelcontextprotocol/sdk/server/mcp").McpServer>;
+export declare function createMCPServer(config: MCPServerOptions): Promise<import("@modelcontextprotocol/sdk/server/mcp").McpServer & {
+    stopKnowledgeHealthChecks: () => void;
+}>;
 //# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH,YAAY,EACV,WAAW,EACX,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,gBAAgB,qEA0T7D"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsBH,YAAY,EACV,WAAW,EACX,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,gBAAgB;qCA4U3B,IAAI;GAEtC"}

package/dist/mcp-server.js

@@ -411,6 +411,119 @@ var init_retrieval = __esm({
   }
 });
 
+// src/core/knowledgeHealth.ts
+var knowledgeHealth_exports = {};
+__export(knowledgeHealth_exports, {
+  DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS: () => DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS,
+  checkKnowledgeHealth: () => checkKnowledgeHealth,
+  scheduleKnowledgeHealthChecks: () => scheduleKnowledgeHealthChecks
+});
+async function checkKnowledgeHealth(db, logger) {
+  const [byBucket, totalChunksRes, totalEmbeddingsRes, orphanedRes, missingRes] = await Promise.all(
+    [
+      db.execute("SELECT bucket, COUNT(*) as count FROM chunks GROUP BY bucket"),
+      db.execute("SELECT COUNT(*) as count FROM chunks"),
+      db.execute("SELECT COUNT(*) as count FROM embeddings"),
+      db.execute(
+        "SELECT COUNT(*) as count FROM embeddings e LEFT JOIN chunks c ON c.id = e.id WHERE c.id IS NULL"
+      ),
+      db.execute(
+        "SELECT COUNT(*) as count FROM chunks c LEFT JOIN embeddings e ON e.id = c.id WHERE e.id IS NULL"
+      )
+    ]
+  );
+  const chunksByBucket = {};
+  for (const row of byBucket.rows) {
+    chunksByBucket[String(row.bucket)] = Number(row.count ?? 0);
+  }
+  const health = {
+    chunksByBucket,
+    totalChunks: Number(totalChunksRes.rows[0]?.count ?? 0),
+    totalEmbeddings: Number(totalEmbeddingsRes.rows[0]?.count ?? 0),
+    orphanedEmbeddings: Number(orphanedRes.rows[0]?.count ?? 0),
+    missingEmbeddings: Number(missingRes.rows[0]?.count ?? 0)
+  };
+  const summary = `chunksByBucket=${JSON.stringify(health.chunksByBucket)} totalChunks=${health.totalChunks} totalEmbeddings=${health.totalEmbeddings} orphanedEmbeddings=${health.orphanedEmbeddings} missingEmbeddings=${health.missingEmbeddings}`;
+  if (health.totalChunks === 0 || health.orphanedEmbeddings > 0) {
+    logger.warn(`Knowledge base health check: ${summary}`);
+  } else {
+    logger.info(`Knowledge base health check: ${summary}`);
+  }
+  return health;
+}
+async function cleanOrphanedEmbeddings(db, buildLock, instanceId, logger) {
+  const acquired = await buildLock.tryAcquire(
+    BUILD_LOCK_KEY,
+    instanceId,
+    Date.now(),
+    BUILD_LOCK_STALE_MS
+  );
+  if (!acquired) {
+    logger.warn(
+      "Knowledge health: skipping orphaned-embeddings cleanup - the build lock is held by another instance."
+    );
+    return;
+  }
+  try {
+    const result = await db.execute(
+      "DELETE FROM embeddings WHERE id NOT IN (SELECT id FROM chunks)"
+    );
+    if (result.rowsAffected > 0) {
+      logger.warn(`Knowledge health: deleted ${result.rowsAffected} orphaned embedding row(s).`);
+    }
+  } finally {
+    await buildLock.release(BUILD_LOCK_KEY, instanceId);
+  }
+}
+async function scheduleKnowledgeHealthChecks(options) {
+  const logger = options.logger ?? createConsoleLogger();
+  const enabled = options.config?.enabled !== false;
+  const intervalMs = options.config?.intervalMs ?? DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS;
+  const autoClean = options.config?.autoCleanOrphanedEmbeddings === true;
+  const buildLock = options.buildLock ?? createTursoBuildLock(options.db);
+  const instanceId = options.instanceId ?? crypto.randomUUID();
+  const schedule = options.schedule ?? defaultSchedule;
+  async function runOnce() {
+    const health = await checkKnowledgeHealth(options.db, logger);
+    if (autoClean && health.orphanedEmbeddings > 0) {
+      await cleanOrphanedEmbeddings(options.db, buildLock, instanceId, logger);
+    }
+    return health;
+  }
+  let handle;
+  if (enabled) {
+    await runOnce();
+    if (intervalMs > 0) {
+      let ticking = false;
+      handle = schedule(() => {
+        if (ticking) return;
+        ticking = true;
+        runOnce().catch((error) => logger.error("Knowledge health check failed:", error)).finally(() => {
+          ticking = false;
+        });
+      }, intervalMs);
+    }
+  }
+  return {
+    runOnce,
+    stop: () => handle?.stop()
+  };
+}
+var DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS, defaultSchedule;
+var init_knowledgeHealth = __esm({
+  "src/core/knowledgeHealth.ts"() {
+    "use strict";
+    init_buildLock();
+    init_logger();
+    DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS = 30 * 6e4;
+    defaultSchedule = (fn, ms) => {
+      const timer = setInterval(fn, ms);
+      if (typeof timer === "object" && "unref" in timer) timer.unref();
+      return { stop: () => clearInterval(timer) };
+    };
+  }
+});
+
 // src/mcp-server.ts
 var mcp_server_exports = {};
 __export(mcp_server_exports, {
@@ -899,6 +1012,7 @@ async function createMCPServer(config) {
   });
   const model = config.openai.model || DEFAULT_MODEL;
   let store;
+  let db;
   if (config.retriever) {
     store = config.retriever;
   } else {
@@ -906,7 +1020,7 @@ async function createMCPServer(config) {
       throw new Error(DATABASE_CONFIG_REQUIRED_MESSAGE);
     }
     const { DEFAULT_KNOWLEDGE_DIR: DEFAULT_KNOWLEDGE_DIR2, VectorStore: VectorStore2, createOpenAIEmbedder: createOpenAIEmbedder2, openLibsqlClient: openLibsqlClient2 } = await Promise.resolve().then(() => (init_retrieval(), retrieval_exports));
-    const db = await openLibsqlClient2(config.database);
+    db = await openLibsqlClient2(config.database);
     store = new VectorStore2(createOpenAIEmbedder2(client), {
       databaseClient: db,
       knowledgeDir: config.knowledgeDir || DEFAULT_KNOWLEDGE_DIR2,
@@ -915,6 +1029,15 @@ async function createMCPServer(config) {
   }
   await store.build?.();
   log.info("\u2705 Knowledge base ready");
+  let knowledgeHealth;
+  if (db) {
+    const { scheduleKnowledgeHealthChecks: scheduleKnowledgeHealthChecks2 } = await Promise.resolve().then(() => (init_knowledgeHealth(), knowledgeHealth_exports));
+    knowledgeHealth = await scheduleKnowledgeHealthChecks2({
+      db,
+      config: config.knowledgeHealthCheck,
+      logger: log
+    });
+  }
   const prompts = new PromptLoader(promptsDir, config.bot);
   const server = new McpServer({
     name: config.bot.name,
@@ -1111,7 +1234,9 @@ async function createMCPServer(config) {
   log.info(
     `\u2705 ${config.bot.name} MCP Server ready (transport: ${transportMode}, tools: ${enabledTools.join(", ") || "none"})`
   );
-  return server;
+  return Object.assign(server, {
+    stopKnowledgeHealthChecks: () => knowledgeHealth?.stop()
+  });
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/mcp-server.mjs

@@ -388,6 +388,119 @@ var init_retrieval = __esm({
   }
 });
 
+// src/core/knowledgeHealth.ts
+var knowledgeHealth_exports = {};
+__export(knowledgeHealth_exports, {
+  DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS: () => DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS,
+  checkKnowledgeHealth: () => checkKnowledgeHealth,
+  scheduleKnowledgeHealthChecks: () => scheduleKnowledgeHealthChecks
+});
+async function checkKnowledgeHealth(db, logger) {
+  const [byBucket, totalChunksRes, totalEmbeddingsRes, orphanedRes, missingRes] = await Promise.all(
+    [
+      db.execute("SELECT bucket, COUNT(*) as count FROM chunks GROUP BY bucket"),
+      db.execute("SELECT COUNT(*) as count FROM chunks"),
+      db.execute("SELECT COUNT(*) as count FROM embeddings"),
+      db.execute(
+        "SELECT COUNT(*) as count FROM embeddings e LEFT JOIN chunks c ON c.id = e.id WHERE c.id IS NULL"
+      ),
+      db.execute(
+        "SELECT COUNT(*) as count FROM chunks c LEFT JOIN embeddings e ON e.id = c.id WHERE e.id IS NULL"
+      )
+    ]
+  );
+  const chunksByBucket = {};
+  for (const row of byBucket.rows) {
+    chunksByBucket[String(row.bucket)] = Number(row.count ?? 0);
+  }
+  const health = {
+    chunksByBucket,
+    totalChunks: Number(totalChunksRes.rows[0]?.count ?? 0),
+    totalEmbeddings: Number(totalEmbeddingsRes.rows[0]?.count ?? 0),
+    orphanedEmbeddings: Number(orphanedRes.rows[0]?.count ?? 0),
+    missingEmbeddings: Number(missingRes.rows[0]?.count ?? 0)
+  };
+  const summary = `chunksByBucket=${JSON.stringify(health.chunksByBucket)} totalChunks=${health.totalChunks} totalEmbeddings=${health.totalEmbeddings} orphanedEmbeddings=${health.orphanedEmbeddings} missingEmbeddings=${health.missingEmbeddings}`;
+  if (health.totalChunks === 0 || health.orphanedEmbeddings > 0) {
+    logger.warn(`Knowledge base health check: ${summary}`);
+  } else {
+    logger.info(`Knowledge base health check: ${summary}`);
+  }
+  return health;
+}
+async function cleanOrphanedEmbeddings(db, buildLock, instanceId, logger) {
+  const acquired = await buildLock.tryAcquire(
+    BUILD_LOCK_KEY,
+    instanceId,
+    Date.now(),
+    BUILD_LOCK_STALE_MS
+  );
+  if (!acquired) {
+    logger.warn(
+      "Knowledge health: skipping orphaned-embeddings cleanup - the build lock is held by another instance."
+    );
+    return;
+  }
+  try {
+    const result = await db.execute(
+      "DELETE FROM embeddings WHERE id NOT IN (SELECT id FROM chunks)"
+    );
+    if (result.rowsAffected > 0) {
+      logger.warn(`Knowledge health: deleted ${result.rowsAffected} orphaned embedding row(s).`);
+    }
+  } finally {
+    await buildLock.release(BUILD_LOCK_KEY, instanceId);
+  }
+}
+async function scheduleKnowledgeHealthChecks(options) {
+  const logger = options.logger ?? createConsoleLogger();
+  const enabled = options.config?.enabled !== false;
+  const intervalMs = options.config?.intervalMs ?? DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS;
+  const autoClean = options.config?.autoCleanOrphanedEmbeddings === true;
+  const buildLock = options.buildLock ?? createTursoBuildLock(options.db);
+  const instanceId = options.instanceId ?? crypto.randomUUID();
+  const schedule = options.schedule ?? defaultSchedule;
+  async function runOnce() {
+    const health = await checkKnowledgeHealth(options.db, logger);
+    if (autoClean && health.orphanedEmbeddings > 0) {
+      await cleanOrphanedEmbeddings(options.db, buildLock, instanceId, logger);
+    }
+    return health;
+  }
+  let handle;
+  if (enabled) {
+    await runOnce();
+    if (intervalMs > 0) {
+      let ticking = false;
+      handle = schedule(() => {
+        if (ticking) return;
+        ticking = true;
+        runOnce().catch((error) => logger.error("Knowledge health check failed:", error)).finally(() => {
+          ticking = false;
+        });
+      }, intervalMs);
+    }
+  }
+  return {
+    runOnce,
+    stop: () => handle?.stop()
+  };
+}
+var DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS, defaultSchedule;
+var init_knowledgeHealth = __esm({
+  "src/core/knowledgeHealth.ts"() {
+    "use strict";
+    init_buildLock();
+    init_logger();
+    DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS = 30 * 6e4;
+    defaultSchedule = (fn, ms) => {
+      const timer = setInterval(fn, ms);
+      if (typeof timer === "object" && "unref" in timer) timer.unref();
+      return { stop: () => clearInterval(timer) };
+    };
+  }
+});
+
 // src/mcp-server.ts
 import OpenAI from "openai";
 
@@ -871,6 +984,7 @@ async function createMCPServer(config) {
   });
   const model = config.openai.model || DEFAULT_MODEL;
   let store;
+  let db;
   if (config.retriever) {
     store = config.retriever;
   } else {
@@ -878,7 +992,7 @@ async function createMCPServer(config) {
       throw new Error(DATABASE_CONFIG_REQUIRED_MESSAGE);
     }
     const { DEFAULT_KNOWLEDGE_DIR: DEFAULT_KNOWLEDGE_DIR2, VectorStore: VectorStore2, createOpenAIEmbedder: createOpenAIEmbedder2, openLibsqlClient: openLibsqlClient2 } = await Promise.resolve().then(() => (init_retrieval(), retrieval_exports));
-    const db = await openLibsqlClient2(config.database);
+    db = await openLibsqlClient2(config.database);
     store = new VectorStore2(createOpenAIEmbedder2(client), {
       databaseClient: db,
       knowledgeDir: config.knowledgeDir || DEFAULT_KNOWLEDGE_DIR2,
@@ -887,6 +1001,15 @@ async function createMCPServer(config) {
   }
   await store.build?.();
   log.info("\u2705 Knowledge base ready");
+  let knowledgeHealth;
+  if (db) {
+    const { scheduleKnowledgeHealthChecks: scheduleKnowledgeHealthChecks2 } = await Promise.resolve().then(() => (init_knowledgeHealth(), knowledgeHealth_exports));
+    knowledgeHealth = await scheduleKnowledgeHealthChecks2({
+      db,
+      config: config.knowledgeHealthCheck,
+      logger: log
+    });
+  }
   const prompts = new PromptLoader(promptsDir, config.bot);
   const server = new McpServer({
     name: config.bot.name,
@@ -1083,7 +1206,9 @@ async function createMCPServer(config) {
   log.info(
     `\u2705 ${config.bot.name} MCP Server ready (transport: ${transportMode}, tools: ${enabledTools.join(", ") || "none"})`
   );
-  return server;
+  return Object.assign(server, {
+    stopKnowledgeHealthChecks: () => knowledgeHealth?.stop()
+  });
 }
 export {
   createMCPServer

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAgB5B,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,SAAS,CAAC;AAEjE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG;IAAE,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAEtE;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAiP7E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAiB5B,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,SAAS,CAAC;AAEjE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG;IAAE,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAEtE;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CA+P7E"}

package/dist/server.js

@@ -411,6 +411,119 @@ var init_retrieval = __esm({
   }
 });
 
+// src/core/knowledgeHealth.ts
+var knowledgeHealth_exports = {};
+__export(knowledgeHealth_exports, {
+  DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS: () => DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS,
+  checkKnowledgeHealth: () => checkKnowledgeHealth,
+  scheduleKnowledgeHealthChecks: () => scheduleKnowledgeHealthChecks
+});
+async function checkKnowledgeHealth(db, logger) {
+  const [byBucket, totalChunksRes, totalEmbeddingsRes, orphanedRes, missingRes] = await Promise.all(
+    [
+      db.execute("SELECT bucket, COUNT(*) as count FROM chunks GROUP BY bucket"),
+      db.execute("SELECT COUNT(*) as count FROM chunks"),
+      db.execute("SELECT COUNT(*) as count FROM embeddings"),
+      db.execute(
+        "SELECT COUNT(*) as count FROM embeddings e LEFT JOIN chunks c ON c.id = e.id WHERE c.id IS NULL"
+      ),
+      db.execute(
+        "SELECT COUNT(*) as count FROM chunks c LEFT JOIN embeddings e ON e.id = c.id WHERE e.id IS NULL"
+      )
+    ]
+  );
+  const chunksByBucket = {};
+  for (const row of byBucket.rows) {
+    chunksByBucket[String(row.bucket)] = Number(row.count ?? 0);
+  }
+  const health = {
+    chunksByBucket,
+    totalChunks: Number(totalChunksRes.rows[0]?.count ?? 0),
+    totalEmbeddings: Number(totalEmbeddingsRes.rows[0]?.count ?? 0),
+    orphanedEmbeddings: Number(orphanedRes.rows[0]?.count ?? 0),
+    missingEmbeddings: Number(missingRes.rows[0]?.count ?? 0)
+  };
+  const summary = `chunksByBucket=${JSON.stringify(health.chunksByBucket)} totalChunks=${health.totalChunks} totalEmbeddings=${health.totalEmbeddings} orphanedEmbeddings=${health.orphanedEmbeddings} missingEmbeddings=${health.missingEmbeddings}`;
+  if (health.totalChunks === 0 || health.orphanedEmbeddings > 0) {
+    logger.warn(`Knowledge base health check: ${summary}`);
+  } else {
+    logger.info(`Knowledge base health check: ${summary}`);
+  }
+  return health;
+}
+async function cleanOrphanedEmbeddings(db, buildLock, instanceId, logger) {
+  const acquired = await buildLock.tryAcquire(
+    BUILD_LOCK_KEY,
+    instanceId,
+    Date.now(),
+    BUILD_LOCK_STALE_MS
+  );
+  if (!acquired) {
+    logger.warn(
+      "Knowledge health: skipping orphaned-embeddings cleanup - the build lock is held by another instance."
+    );
+    return;
+  }
+  try {
+    const result = await db.execute(
+      "DELETE FROM embeddings WHERE id NOT IN (SELECT id FROM chunks)"
+    );
+    if (result.rowsAffected > 0) {
+      logger.warn(`Knowledge health: deleted ${result.rowsAffected} orphaned embedding row(s).`);
+    }
+  } finally {
+    await buildLock.release(BUILD_LOCK_KEY, instanceId);
+  }
+}
+async function scheduleKnowledgeHealthChecks(options) {
+  const logger = options.logger ?? createConsoleLogger();
+  const enabled = options.config?.enabled !== false;
+  const intervalMs = options.config?.intervalMs ?? DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS;
+  const autoClean = options.config?.autoCleanOrphanedEmbeddings === true;
+  const buildLock = options.buildLock ?? createTursoBuildLock(options.db);
+  const instanceId = options.instanceId ?? crypto.randomUUID();
+  const schedule = options.schedule ?? defaultSchedule;
+  async function runOnce() {
+    const health = await checkKnowledgeHealth(options.db, logger);
+    if (autoClean && health.orphanedEmbeddings > 0) {
+      await cleanOrphanedEmbeddings(options.db, buildLock, instanceId, logger);
+    }
+    return health;
+  }
+  let handle;
+  if (enabled) {
+    await runOnce();
+    if (intervalMs > 0) {
+      let ticking = false;
+      handle = schedule(() => {
+        if (ticking) return;
+        ticking = true;
+        runOnce().catch((error) => logger.error("Knowledge health check failed:", error)).finally(() => {
+          ticking = false;
+        });
+      }, intervalMs);
+    }
+  }
+  return {
+    runOnce,
+    stop: () => handle?.stop()
+  };
+}
+var DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS, defaultSchedule;
+var init_knowledgeHealth = __esm({
+  "src/core/knowledgeHealth.ts"() {
+    "use strict";
+    init_buildLock();
+    init_logger();
+    DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS = 30 * 6e4;
+    defaultSchedule = (fn, ms) => {
+      const timer = setInterval(fn, ms);
+      if (typeof timer === "object" && "unref" in timer) timer.unref();
+      return { stop: () => clearInterval(timer) };
+    };
+  }
+});
+
 // src/server.ts
 var server_exports = {};
 __export(server_exports, {
@@ -1891,6 +2004,15 @@ async function createServer(config) {
   }
   await store.build?.();
   logger.info("\u2705 Knowledge base ready");
+  let knowledgeHealth;
+  if (db && !config.retriever) {
+    const { scheduleKnowledgeHealthChecks: scheduleKnowledgeHealthChecks2 } = await Promise.resolve().then(() => (init_knowledgeHealth(), knowledgeHealth_exports));
+    knowledgeHealth = await scheduleKnowledgeHealthChecks2({
+      db,
+      config: config.knowledgeHealthCheck,
+      logger
+    });
+  }
   const prompts = new PromptLoader(promptsDir, config.bot);
   let apiKeyManager;
   const secret = config.auth?.secret || process.env.CHATTER_SECRET;
@@ -2021,6 +2143,7 @@ async function createServer(config) {
     // (sync or async) is caught per-channel so one misbehaving channel can't
     // stop the rest from cleaning up.
     stopChannels: async () => {
+      knowledgeHealth?.stop();
       await Promise.allSettled(
         started.map(async (channel) => {
           try {

package/dist/server.mjs

@@ -388,6 +388,119 @@ var init_retrieval = __esm({
   }
 });
 
+// src/core/knowledgeHealth.ts
+var knowledgeHealth_exports = {};
+__export(knowledgeHealth_exports, {
+  DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS: () => DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS,
+  checkKnowledgeHealth: () => checkKnowledgeHealth,
+  scheduleKnowledgeHealthChecks: () => scheduleKnowledgeHealthChecks
+});
+async function checkKnowledgeHealth(db, logger) {
+  const [byBucket, totalChunksRes, totalEmbeddingsRes, orphanedRes, missingRes] = await Promise.all(
+    [
+      db.execute("SELECT bucket, COUNT(*) as count FROM chunks GROUP BY bucket"),
+      db.execute("SELECT COUNT(*) as count FROM chunks"),
+      db.execute("SELECT COUNT(*) as count FROM embeddings"),
+      db.execute(
+        "SELECT COUNT(*) as count FROM embeddings e LEFT JOIN chunks c ON c.id = e.id WHERE c.id IS NULL"
+      ),
+      db.execute(
+        "SELECT COUNT(*) as count FROM chunks c LEFT JOIN embeddings e ON e.id = c.id WHERE e.id IS NULL"
+      )
+    ]
+  );
+  const chunksByBucket = {};
+  for (const row of byBucket.rows) {
+    chunksByBucket[String(row.bucket)] = Number(row.count ?? 0);
+  }
+  const health = {
+    chunksByBucket,
+    totalChunks: Number(totalChunksRes.rows[0]?.count ?? 0),
+    totalEmbeddings: Number(totalEmbeddingsRes.rows[0]?.count ?? 0),
+    orphanedEmbeddings: Number(orphanedRes.rows[0]?.count ?? 0),
+    missingEmbeddings: Number(missingRes.rows[0]?.count ?? 0)
+  };
+  const summary = `chunksByBucket=${JSON.stringify(health.chunksByBucket)} totalChunks=${health.totalChunks} totalEmbeddings=${health.totalEmbeddings} orphanedEmbeddings=${health.orphanedEmbeddings} missingEmbeddings=${health.missingEmbeddings}`;
+  if (health.totalChunks === 0 || health.orphanedEmbeddings > 0) {
+    logger.warn(`Knowledge base health check: ${summary}`);
+  } else {
+    logger.info(`Knowledge base health check: ${summary}`);
+  }
+  return health;
+}
+async function cleanOrphanedEmbeddings(db, buildLock, instanceId, logger) {
+  const acquired = await buildLock.tryAcquire(
+    BUILD_LOCK_KEY,
+    instanceId,
+    Date.now(),
+    BUILD_LOCK_STALE_MS
+  );
+  if (!acquired) {
+    logger.warn(
+      "Knowledge health: skipping orphaned-embeddings cleanup - the build lock is held by another instance."
+    );
+    return;
+  }
+  try {
+    const result = await db.execute(
+      "DELETE FROM embeddings WHERE id NOT IN (SELECT id FROM chunks)"
+    );
+    if (result.rowsAffected > 0) {
+      logger.warn(`Knowledge health: deleted ${result.rowsAffected} orphaned embedding row(s).`);
+    }
+  } finally {
+    await buildLock.release(BUILD_LOCK_KEY, instanceId);
+  }
+}
+async function scheduleKnowledgeHealthChecks(options) {
+  const logger = options.logger ?? createConsoleLogger();
+  const enabled = options.config?.enabled !== false;
+  const intervalMs = options.config?.intervalMs ?? DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS;
+  const autoClean = options.config?.autoCleanOrphanedEmbeddings === true;
+  const buildLock = options.buildLock ?? createTursoBuildLock(options.db);
+  const instanceId = options.instanceId ?? crypto.randomUUID();
+  const schedule = options.schedule ?? defaultSchedule;
+  async function runOnce() {
+    const health = await checkKnowledgeHealth(options.db, logger);
+    if (autoClean && health.orphanedEmbeddings > 0) {
+      await cleanOrphanedEmbeddings(options.db, buildLock, instanceId, logger);
+    }
+    return health;
+  }
+  let handle;
+  if (enabled) {
+    await runOnce();
+    if (intervalMs > 0) {
+      let ticking = false;
+      handle = schedule(() => {
+        if (ticking) return;
+        ticking = true;
+        runOnce().catch((error) => logger.error("Knowledge health check failed:", error)).finally(() => {
+          ticking = false;
+        });
+      }, intervalMs);
+    }
+  }
+  return {
+    runOnce,
+    stop: () => handle?.stop()
+  };
+}
+var DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS, defaultSchedule;
+var init_knowledgeHealth = __esm({
+  "src/core/knowledgeHealth.ts"() {
+    "use strict";
+    init_buildLock();
+    init_logger();
+    DEFAULT_KNOWLEDGE_HEALTH_INTERVAL_MS = 30 * 6e4;
+    defaultSchedule = (fn, ms) => {
+      const timer = setInterval(fn, ms);
+      if (typeof timer === "object" && "unref" in timer) timer.unref();
+      return { stop: () => clearInterval(timer) };
+    };
+  }
+});
+
 // src/server.ts
 import { relative } from "node:path";
 import { Hono as Hono5 } from "hono";
@@ -1862,6 +1975,15 @@ async function createServer(config) {
   }
   await store.build?.();
   logger.info("\u2705 Knowledge base ready");
+  let knowledgeHealth;
+  if (db && !config.retriever) {
+    const { scheduleKnowledgeHealthChecks: scheduleKnowledgeHealthChecks2 } = await Promise.resolve().then(() => (init_knowledgeHealth(), knowledgeHealth_exports));
+    knowledgeHealth = await scheduleKnowledgeHealthChecks2({
+      db,
+      config: config.knowledgeHealthCheck,
+      logger
+    });
+  }
   const prompts = new PromptLoader(promptsDir, config.bot);
   let apiKeyManager;
   const secret = config.auth?.secret || process.env.CHATTER_SECRET;
@@ -1992,6 +2114,7 @@ async function createServer(config) {
     // (sync or async) is caught per-channel so one misbehaving channel can't
     // stop the rest from cleaning up.
     stopChannels: async () => {
+      knowledgeHealth?.stop();
       await Promise.allSettled(
         started.map(async (channel) => {
           try {

package/dist/types.d.ts

@@ -10,6 +10,7 @@ import type OpenAI from "openai";
 import type { Channel, ChannelSenderRegistry } from "./channels";
 import type { AnswerFn, TransformReply } from "./core/answer";
 import type { BucketsFor } from "./core/buckets";
+import type { KnowledgeHealthCheckConfig } from "./core/knowledgeHealth";
 import type { Logger, LogLevel } from "./core/logger";
 import type { FallbackFn, RerankContext, RewriteQuery } from "./core/pipeline";
 import type { PromptLoader } from "./core/prompts";
@@ -208,6 +209,15 @@ export interface ChatterConfig extends BrainHooks {
      * Unset: `database` is required, and the built-in `VectorStore` is used.
      */
     retriever?: Retriever;
+    /**
+     * Post-boot and periodic consistency checks on the default `VectorStore`
+     * knowledge base (chunk/embedding counts, orphaned and missing rows),
+     * logged so a collapse is visible immediately instead of waiting for a
+     * user to notice broken answers. Ignored when `retriever` is set - the
+     * checks query the `chunks`/`embeddings` schema `VectorStore` itself
+     * owns. See [knowledgeHealth.ts](./core/knowledgeHealth.ts).
+     */
+    knowledgeHealthCheck?: KnowledgeHealthCheckConfig;
     auth?: {
         /** Secret for JWT API key creation/verification */
         secret?: string;

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegoaltoworks/chatter",
-  "version": "0.63.0",
+  "version": "0.65.0",
   "description": "Embeddable AI chatbot framework with RAG, authentication, and customizable widgets",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",