@askexenow/exe-os 0.9.255 → 0.9.259

package/dist/{chunk-3VLFVOM7.js → chunk-LRKJGSNH.js}

@@ -1,6 +1,6 @@
 import {
   sessionScopeFilter
-} from "./chunk-CS267UMH.js";
+} from "./chunk-5LDTCWYX.js";
 
 // src/lib/git-task-sweep.ts
 import { execSync } from "child_process";
@@ -178,7 +178,7 @@ async function sweepTasks(projectName, options = {}) {
     }
     if (!dryRun) {
       try {
-        const { updateTaskStatus } = await import("./tasks-crud-F732BVOE.js");
+        const { updateTaskStatus } = await import("./tasks-crud-KOIA5SAH.js");
         await updateTaskStatus({
           taskId: task.id,
           status: "needs_review",

package/dist/{chunk-4FT3SQAS.js → chunk-LVY74L2J.js}

@@ -1,10 +1,10 @@
 import {
   sessionScopeFilter
-} from "./chunk-CS267UMH.js";
+} from "./chunk-5LDTCWYX.js";
 import {
   getClient,
   getIdentity
-} from "./chunk-5U7WB4YG.js";
+} from "./chunk-WVBZ3QBR.js";
 
 // src/lib/dreaming.ts
 var DreamingEngine = class {

package/dist/{chunk-X4T7LR2X.js → chunk-M7PZFYHE.js}

@@ -1,6 +1,6 @@
 import {
   getClient
-} from "./chunk-5U7WB4YG.js";
+} from "./chunk-WVBZ3QBR.js";
 
 // src/lib/memory-graph-extractor.ts
 function entityId(type, name) {
@@ -247,7 +247,7 @@ async function upsertMemoryGraph(result, memoryId) {
     });
   }
   try {
-    const { createCoOccurrenceEdges } = await import("./co-occurrence-L6QOQTJB.js");
+    const { createCoOccurrenceEdges } = await import("./co-occurrence-ETAVWYVE.js");
     await createCoOccurrenceEdges(result.entities, memoryId);
   } catch {
   }

package/dist/{chunk-CIX64N7D.js → chunk-MGTVPIEZ.js}

@@ -2,7 +2,7 @@ import {
   connectEmbedDaemon,
   disconnectClient,
   embedViaClient
-} from "./chunk-Z6GHDYQI.js";
+} from "./chunk-Z2AEOVEZ.js";
 import {
   EMBEDDING_DIM
 } from "./chunk-FXU7JOXK.js";

package/dist/{chunk-MXCBORCC.js → chunk-MKTEGZ37.js}

@@ -4,17 +4,17 @@ import {
   resolveExeSession,
   sendIntercom,
   strictSessionScopeFilter
-} from "./chunk-CS267UMH.js";
+} from "./chunk-5LDTCWYX.js";
 import {
   parseMessage,
   serializeMessage
 } from "./chunk-4JERP7NT.js";
 import {
   recordOrchestrationEventBestEffort
-} from "./chunk-USLVSLQ5.js";
+} from "./chunk-VDCPKJUQ.js";
 import {
   getClient
-} from "./chunk-5U7WB4YG.js";
+} from "./chunk-WVBZ3QBR.js";
 
 // src/lib/messaging.ts
 import crypto from "crypto";

package/dist/chunk-MMRUBN3I.js

@@ -0,0 +1,36 @@
+// src/lib/support-report-marker.ts
+import { appendFile, readFile } from "fs/promises";
+import { appendFileSync, readFileSync } from "fs";
+var SUPPORT_REPORT_SENT_MARKER = "upstream_sent: true";
+function isSupportReportSentStatus(status) {
+  return /^sent\b/.test(status.trim());
+}
+async function markSupportReportSent(filePath) {
+  try {
+    const content = await readFile(filePath, "utf8");
+    if (!content.includes(SUPPORT_REPORT_SENT_MARKER)) {
+      await appendFile(filePath, `
+${SUPPORT_REPORT_SENT_MARKER}
+`, { encoding: "utf8" });
+    }
+  } catch {
+  }
+}
+function markSupportReportSentSync(filePath) {
+  try {
+    const content = readFileSync(filePath, "utf8");
+    if (!content.includes(SUPPORT_REPORT_SENT_MARKER)) {
+      appendFileSync(filePath, `
+${SUPPORT_REPORT_SENT_MARKER}
+`, { encoding: "utf8" });
+    }
+  } catch {
+  }
+}
+
+export {
+  SUPPORT_REPORT_SENT_MARKER,
+  isSupportReportSentStatus,
+  markSupportReportSent,
+  markSupportReportSentSync
+};

package/dist/{chunk-4MONXPWR.js → chunk-MPXLF7TA.js}

@@ -1,7 +1,7 @@
 import {
   getIdentity,
   loadEmployeesSync
-} from "./chunk-5U7WB4YG.js";
+} from "./chunk-WVBZ3QBR.js";
 
 // src/lib/drift-probes.ts
 var DRIFT_THRESHOLD = 80;

package/dist/{chunk-6QMXKKFD.js → chunk-N27CTUFU.js}

@@ -1,6 +1,6 @@
 import {
   getClient
-} from "./chunk-5U7WB4YG.js";
+} from "./chunk-WVBZ3QBR.js";
 
 // src/lib/session-kill-telemetry.ts
 import crypto from "crypto";

package/dist/{chunk-YDHPC4PX.js → chunk-N4ES27RI.js}

@@ -1,9 +1,9 @@
 import {
   fastDbInit
-} from "./chunk-LY2DYTDL.js";
+} from "./chunk-RFJESVEL.js";
 import {
   sessionScopeFilter
-} from "./chunk-CS267UMH.js";
+} from "./chunk-5LDTCWYX.js";
 import {
   formatStatusAll,
   formatStatusDeep,
@@ -14,7 +14,7 @@ import {
   getClient,
   isCoordinatorRole,
   loadEmployees
-} from "./chunk-5U7WB4YG.js";
+} from "./chunk-WVBZ3QBR.js";
 import {
   isMainModule
 } from "./chunk-6Y4B3QF6.js";

package/dist/{chunk-WIRJ574R.js → chunk-NGQQRGLP.js}

@@ -1,9 +1,9 @@
 import {
   storeBehavior
-} from "./chunk-2NEQQCRC.js";
+} from "./chunk-25JAXHON.js";
 import {
   getClient
-} from "./chunk-5U7WB4YG.js";
+} from "./chunk-WVBZ3QBR.js";
 import {
   loadConfig
 } from "./chunk-VXIMSRTO.js";

package/dist/{chunk-AQOCHSIR.js → chunk-OCJ5GZKV.js}

@@ -5,13 +5,13 @@ import {
   notifyParentExe,
   resolveExeSession,
   sendIntercom
-} from "./chunk-CS267UMH.js";
+} from "./chunk-5LDTCWYX.js";
 import {
   getTransport
 } from "./chunk-MVW62NIZ.js";
 import {
   recordOrchestrationEventBestEffort
-} from "./chunk-USLVSLQ5.js";
+} from "./chunk-VDCPKJUQ.js";
 import {
   getAgentRuntime
 } from "./chunk-XJUUWHVN.js";
@@ -22,7 +22,7 @@ import {
   isCoordinatorName,
   isMultiInstance,
   shouldAutoInstance
-} from "./chunk-5U7WB4YG.js";
+} from "./chunk-WVBZ3QBR.js";
 
 // src/lib/tasks-notify.ts
 var VERIFY_DELAY_MS = 1e4;
@@ -68,7 +68,7 @@ async function dispatchTaskToEmployee(input) {
   let crossProject = false;
   if (input.projectName) {
     try {
-      const { assertSessionScope } = await import("./session-scope-ZB4SR3AX.js");
+      const { assertSessionScope } = await import("./session-scope-DHTVH3D4.js");
       const check = assertSessionScope("dispatch_task", input.projectName);
       if (check.reason === "cross_session_denied") {
         crossProject = true;

package/dist/{chunk-O477L4LV.js → chunk-OSPS5N2I.js}

@@ -1,6 +1,6 @@
 import {
   processCRMEvent
-} from "./chunk-VPHOOQLR.js";
+} from "./chunk-3GHTBVZO.js";
 
 // src/gateway/adapters/crm-webhook.ts
 function parseTwentyWebhook(payload) {

package/dist/{chunk-5WEH43HH.js → chunk-PQHA6X6Y.js}

@@ -1,6 +1,6 @@
 import {
   isCoordinatorRole
-} from "./chunk-5U7WB4YG.js";
+} from "./chunk-WVBZ3QBR.js";
 
 // src/lib/task-router.ts
 import { randomUUID } from "crypto";

package/dist/{chunk-DJYIBHN5.js → chunk-PQQTSNXS.js}

@@ -1,6 +1,6 @@
 import {
   routeTask
-} from "./chunk-5WEH43HH.js";
+} from "./chunk-PQHA6X6Y.js";
 import {
   createTaskCore,
   employeeSessionName,
@@ -9,11 +9,11 @@ import {
   isEmployeeAlive,
   sessionScopeFilter,
   updateTaskStatus
-} from "./chunk-CS267UMH.js";
+} from "./chunk-5LDTCWYX.js";
 import {
   DEFAULT_COORDINATOR_TEMPLATE_NAME,
   getCoordinatorName
-} from "./chunk-5U7WB4YG.js";
+} from "./chunk-WVBZ3QBR.js";
 
 // src/runtime/orchestrator.ts
 var STALE_THRESHOLD_MS = 2 * 60 * 60 * 1e3;

package/dist/{chunk-LGFB67MY.js → chunk-Q3GLQDZI.js}

@@ -4,7 +4,7 @@ import {
 import {
   isClientConnected,
   sendDaemonRequest
-} from "./chunk-Z6GHDYQI.js";
+} from "./chunk-Z2AEOVEZ.js";
 
 // src/lib/memory-queue-client.ts
 async function writeMemoryViaDaemon(entry) {

package/dist/{chunk-7GR7VBBW.js → chunk-QUC27OCW.js}

@@ -1,6 +1,6 @@
 import {
   writeMemoryViaDaemon
-} from "./chunk-LGFB67MY.js";
+} from "./chunk-Q3GLQDZI.js";
 
 // src/lib/auto-checkpoint.ts
 var FILE_RE = /(?:^|\s)([\w./-]+\.(?:ts|tsx|js|jsx|json|md|yml|yaml|sql|go|py|css|scss|html|sh))(?:\b|$)/g;

package/dist/{chunk-5NBOFYJG.js → chunk-QYNFWFFH.js}

@@ -1,6 +1,6 @@
 import {
   MultiAgentOrchestrator
-} from "./chunk-DJYIBHN5.js";
+} from "./chunk-PQQTSNXS.js";
 import {
   createQuietRenderer,
   createTerminalRenderer,
@@ -206,7 +206,7 @@ function createExeOSHooks(config) {
         );
       }
       try {
-        const { listBehaviors } = await import("./behaviors-G6QHSQBN.js");
+        const { listBehaviors } = await import("./behaviors-2TZCFJLU.js");
         const behaviors = await listBehaviors(config.agentId, config.projectName, 12);
         if (behaviors.length > 0) {
           process.stderr.write(
@@ -327,7 +327,7 @@ function createExeOSHooks(config) {
     async onSubagentStop(_reason) {
       try {
         const { getClient } = await import("./lib/database.js");
-        const { sessionScopeFilter } = await import("./task-scope-XKNAY5S7.js");
+        const { sessionScopeFilter } = await import("./task-scope-AKF3CSWO.js");
         const client = getClient();
         const ehScope = sessionScopeFilter();
         const tasks = await client.execute({
@@ -419,7 +419,7 @@ function createExeOSHooks(config) {
         try {
           const { writeMemory, flushBatch } = await import("./lib/store.js");
           const { getClient } = await import("./lib/database.js");
-          const { sessionScopeFilter: cpScopeFilter } = await import("./task-scope-XKNAY5S7.js");
+          const { sessionScopeFilter: cpScopeFilter } = await import("./task-scope-AKF3CSWO.js");
           const client = getClient();
           const cpScope = cpScopeFilter();
           const tasks = await client.execute({

package/dist/{chunk-X7I6NLIA.js → chunk-T2EUNNUX.js}

@@ -1,24 +1,24 @@
 import {
   recordSessionKill
-} from "./chunk-6QMXKKFD.js";
+} from "./chunk-N27CTUFU.js";
 import {
   sessionScopeFilter,
   verifyPaneAtCapacity,
   writeNotification
-} from "./chunk-CS267UMH.js";
+} from "./chunk-5LDTCWYX.js";
 import {
   listSessions
-} from "./chunk-SD2R3SEA.js";
+} from "./chunk-J3YNCJ4A.js";
 import {
   getTransport
 } from "./chunk-MVW62NIZ.js";
 import {
   recordOrchestrationEventBestEffort
-} from "./chunk-USLVSLQ5.js";
+} from "./chunk-VDCPKJUQ.js";
 import {
   getClient,
   isCoordinatorName
-} from "./chunk-5U7WB4YG.js";
+} from "./chunk-WVBZ3QBR.js";
 
 // src/lib/capacity-monitor.ts
 var CAPACITY_PATTERNS = [

package/dist/{chunk-VRWOLLKN.js → chunk-T4NFOOPB.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-GNHN5HRQ.js";
 import {
   buildClaudeHttpMcpEntry
-} from "./chunk-MRZE5IOP.js";
+} from "./chunk-CXOX7TRG.js";
 import {
   EXE_HOOKS,
   isLegacyHomeDirHookCommand,
@@ -11,7 +11,7 @@ import {
 } from "./chunk-L3TB7CC3.js";
 import {
   ensureAllAgentSymlinks
-} from "./chunk-R7FBOZT5.js";
+} from "./chunk-ISL3NSVX.js";
 import {
   MCP_LEGACY_KEY,
   MCP_PRIMARY_KEY

package/dist/{chunk-2YJSDJEH.js → chunk-TZPHTI5Q.js}

@@ -1,6 +1,6 @@
 import {
   getClient
-} from "./chunk-5U7WB4YG.js";
+} from "./chunk-WVBZ3QBR.js";
 
 // src/lib/reminders.ts
 import crypto from "crypto";

package/dist/{chunk-CQSFIQGN.js → chunk-UOZ5KUNN.js}

@@ -7,7 +7,7 @@ import {
 import {
   connectEmbedDaemon,
   embedBatchViaClient
-} from "./chunk-Z6GHDYQI.js";
+} from "./chunk-Z2AEOVEZ.js";
 import {
   EXE_AI_DIR
 } from "./chunk-VXIMSRTO.js";

package/dist/{chunk-5R4R743Q.js → chunk-V2UVWYHO.js}

@@ -2,7 +2,7 @@ import {
   dispatchTaskToEmployee,
   markTaskNotificationsRead,
   notifyTaskDone
-} from "./chunk-AQOCHSIR.js";
+} from "./chunk-OCJ5GZKV.js";
 import {
   cleanupReviewFile,
   createTaskCore,
@@ -11,7 +11,7 @@ import {
   sessionScopeFilter,
   updateTaskStatus,
   writeNotification
-} from "./chunk-CS267UMH.js";
+} from "./chunk-5LDTCWYX.js";
 import {
   orgBus
 } from "./chunk-MP2AFCGL.js";
@@ -19,7 +19,7 @@ import {
   getClient,
   getCoordinatorName,
   isCoordinatorName
-} from "./chunk-5U7WB4YG.js";
+} from "./chunk-WVBZ3QBR.js";
 import {
   EXE_AI_DIR
 } from "./chunk-VXIMSRTO.js";
@@ -61,7 +61,7 @@ async function cascadeUnblock(taskId, baseDir, now) {
   }
   if (unblockedRows.rows.length > 0 && !process.env.VITEST) {
     try {
-      const { dispatchTaskToEmployee: dispatchTaskToEmployee2 } = await import("./tasks-notify-LJ65U7DF.js");
+      const { dispatchTaskToEmployee: dispatchTaskToEmployee2 } = await import("./tasks-notify-7ZTE4ZQM.js");
       const dispatched = /* @__PURE__ */ new Set();
       for (const ur of unblockedRows.rows) {
         const assignee = String(ur.assigned_to);
@@ -258,20 +258,22 @@ async function updateTask(input) {
       const taskTitle = String(row.title);
       let delivered = false;
       try {
-        const { sendIntercom, resolveExeSession } = await import("./lib/tmux-routing.js");
+        const { sendIntercom, resolveExeSession, employeeSessionName } = await import("./lib/tmux-routing.js");
         const exeSession = row.session_scope ? String(row.session_scope) : resolveExeSession();
         if (exeSession) {
-          const reviewerSession = `${reviewer}-${exeSession}`;
-          const result = sendIntercom(reviewerSession, { reason: "completion" });
-          if (result !== "failed") {
-            delivered = true;
-            process.stderr.write(`[tasks] EVENT: notified reviewer "${reviewer}" via tmux for "${taskTitle}"
-`);
-          } else if (isCoordinatorName(reviewer)) {
-            const cooResult = sendIntercom(exeSession, { reason: "completion" });
+          if (isCoordinatorName(reviewer)) {
+            const cooResult = sendIntercom(exeSession, { force: true, reason: "completion" });
             if (cooResult !== "failed") {
               delivered = true;
-              process.stderr.write(`[tasks] EVENT: notified coordinator "${reviewer}" for "${taskTitle}"
+              process.stderr.write(`[tasks] EVENT: notified coordinator "${reviewer}" for "${taskTitle}" (force)
+`);
+            }
+          } else {
+            const reviewerSession = employeeSessionName(reviewer, exeSession);
+            const result = sendIntercom(reviewerSession, { force: true, reason: "completion" });
+            if (result !== "failed") {
+              delivered = true;
+              process.stderr.write(`[tasks] EVENT: notified reviewer "${reviewer}" via tmux for "${taskTitle}"
 `);
             }
           }
@@ -328,7 +330,7 @@ async function updateTask(input) {
     await markTaskNotificationsRead(taskFile);
     if (input.status === "needs_review" && !isCoordinator) {
       try {
-        const { writeNotification: writeNotification2 } = await import("./notifications-BETWD6EK.js");
+        const { writeNotification: writeNotification2 } = await import("./notifications-ZKGLZVCU.js");
         await writeNotification2({
           agentId: String(row.assigned_to),
           agentRole: String(row.assigned_to),

package/dist/{chunk-VKCZ3OGM.js → chunk-VD676VIC.js}

@@ -1,13 +1,13 @@
 import {
   deactivateBehavior
-} from "./chunk-2NEQQCRC.js";
+} from "./chunk-25JAXHON.js";
 import {
   getActiveAgent
-} from "./chunk-VGWQBI76.js";
+} from "./chunk-GBR4MAAK.js";
 import {
   canCoordinate,
   getClient
-} from "./chunk-5U7WB4YG.js";
+} from "./chunk-WVBZ3QBR.js";
 
 // src/mcp/tools/deactivate-behavior.ts
 import { z } from "zod";
@@ -24,7 +24,7 @@ function registerDeactivateBehavior(server) {
     async ({ behavior_id }) => {
       const caller = getActiveAgent();
       try {
-        const { StewardGate } = await import("./steward-gate-HSV67KLF.js");
+        const { StewardGate } = await import("./steward-gate-EQV6CZKY.js");
         const steward = new StewardGate();
         const gateDecision = await steward.checkAuthority(caller.agentId || "unknown", "deactivate_behavior", behavior_id);
         if (!gateDecision.allowed) {

package/dist/{chunk-USLVSLQ5.js → chunk-VDCPKJUQ.js}

@@ -1,6 +1,6 @@
 import {
   getClient
-} from "./chunk-5U7WB4YG.js";
+} from "./chunk-WVBZ3QBR.js";
 
 // src/lib/orchestration-events.ts
 import crypto from "crypto";

package/dist/{chunk-Y7NMPQXZ.js → chunk-VLX6AHTD.js}

@@ -1,9 +1,9 @@
 import {
   recordSessionKill
-} from "./chunk-6QMXKKFD.js";
+} from "./chunk-N27CTUFU.js";
 import {
   updateTask
-} from "./chunk-5R4R743Q.js";
+} from "./chunk-V2UVWYHO.js";
 import {
   ensureEmployee,
   extractRootExe,
@@ -14,13 +14,13 @@ import {
   sessionScopeFilter,
   strictSessionScopeFilter,
   writeNotification
-} from "./chunk-CS267UMH.js";
+} from "./chunk-5LDTCWYX.js";
 import {
   queueIntercom
 } from "./chunk-5CHYEKMH.js";
 import {
   listSessions
-} from "./chunk-SD2R3SEA.js";
+} from "./chunk-J3YNCJ4A.js";
 import {
   getTransport
 } from "./chunk-MVW62NIZ.js";
@@ -30,7 +30,7 @@ import {
 } from "./chunk-CX6GL3ZJ.js";
 import {
   recordOrchestrationEventBestEffort
-} from "./chunk-USLVSLQ5.js";
+} from "./chunk-VDCPKJUQ.js";
 import {
   getAgentRuntime
 } from "./chunk-XJUUWHVN.js";
@@ -38,7 +38,7 @@ import {
   baseAgentName,
   isCoordinatorName,
   shouldAutoInstance
-} from "./chunk-5U7WB4YG.js";
+} from "./chunk-WVBZ3QBR.js";
 import {
   loadConfigSync
 } from "./chunk-VXIMSRTO.js";
@@ -1657,7 +1657,7 @@ async function reapOrphanedWorktrees(deps, nowMs = Date.now()) {
 }
 async function createWorktreeReaperRealDeps() {
   const { getPaneCwdAsync } = await import("./lib/tmux-status.js");
-  const { getGitRoot, isWorktreeDirty: isDirty } = await import("./worktree-3N5BPITS.js");
+  const { getGitRoot, isWorktreeDirty: isDirty } = await import("./worktree-NK7GZNEA.js");
   const { statSync: statSync2 } = await import("fs");
   const { basename } = await import("path");
   const { promisify } = await import("util");
@@ -1798,7 +1798,7 @@ async function gcStaleCheckpoints() {
 }
 async function pollTaskGroupBarriers() {
   try {
-    const { checkAndFireBarriers } = await import("./tasks-crud-F732BVOE.js");
+    const { checkAndFireBarriers } = await import("./tasks-crud-KOIA5SAH.js");
     const firedGroupIds = await checkAndFireBarriers();
     if (firedGroupIds.length === 0) return 0;
     const { getClient } = await import("./lib/database.js");

package/dist/{chunk-ITPIBVSG.js → chunk-WMZTSHNX.js}

@@ -3,12 +3,19 @@ import {
 } from "./chunk-VXIMSRTO.js";
 
 // src/lib/db-backup.ts
-import { existsSync, readdirSync, unlinkSync, statSync } from "fs";
+import { existsSync, readdirSync, unlinkSync, statSync, statfsSync } from "fs";
 import { copyFile, mkdir, unlink } from "fs/promises";
 import path from "path";
 var BACKUP_DIR = path.join(EXE_AI_DIR, "backups");
 var DEFAULT_KEEP_DAYS = 3;
 var DB_NAMES = ["memories.db", "exe-mem.db", "exe-os.db", "exe.db"];
+var REASON_COUNT_CAP = {
+  "pre-restart": 5,
+  "pre-consolidation": 5,
+  "pre-fix": 5,
+  "pre-restore": 5
+};
+var MIN_FREE_BYTES = 5 * 1024 * 1024 * 1024;
 function findActiveDb() {
   for (const name of DB_NAMES) {
     const p = path.join(EXE_AI_DIR, name);
@@ -23,6 +30,22 @@ async function createBackupAsync(reason = "manual") {
   const dbPath = findActiveDb();
   if (!dbPath) return null;
   await mkdir(BACKUP_DIR, { recursive: true });
+  try {
+    let dbSize = 0;
+    try {
+      dbSize = statSync(dbPath).size;
+    } catch {
+    }
+    const freeBytes = getFreeBytes(BACKUP_DIR);
+    if (!hasEnoughDiskSpace(freeBytes, dbSize)) {
+      process.stderr.write(
+        `[db-backup] DISK GUARD: skipping "${reason}" backup \u2014 ${Math.round(freeBytes / 1024 / 1024)}MB free, need >${Math.round(Math.max(MIN_FREE_BYTES, dbSize * 2) / 1024 / 1024)}MB. Disk is nearly full; refusing to make it worse.
+`
+      );
+      return null;
+    }
+  } catch {
+  }
   const dbName = path.basename(dbPath, ".db");
   const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
   const backupName = `${dbName}-${reason}-${timestamp}.db`;
@@ -99,6 +122,61 @@ function rotateBackups(keepDays = DEFAULT_KEEP_DAYS) {
   }
   return deleted;
 }
+function selectBackupsToDelete(backups, keep) {
+  if (keep < 0) keep = 0;
+  const sorted = [...backups].sort((a, b) => b.mtimeMs - a.mtimeMs);
+  return sorted.slice(keep).map((b) => b.path);
+}
+function hasEnoughDiskSpace(freeBytes, backupSizeBytes, minFreeBytes = MIN_FREE_BYTES) {
+  const required = Math.max(minFreeBytes, backupSizeBytes * 2);
+  return freeBytes >= required;
+}
+function getFreeBytes(dir) {
+  try {
+    const s = statfsSync(dir);
+    return s.bavail * s.bsize;
+  } catch {
+    return Number.POSITIVE_INFINITY;
+  }
+}
+function rotateBackupsByReason(reason, keep) {
+  if (!existsSync(BACKUP_DIR)) return 0;
+  let deleted = 0;
+  try {
+    const files = readdirSync(BACKUP_DIR);
+    const matches = [];
+    for (const file of files) {
+      if (!file.endsWith(".db")) continue;
+      if (!file.includes(`-${reason}-`)) continue;
+      const filePath = path.join(BACKUP_DIR, file);
+      try {
+        matches.push({ path: filePath, mtimeMs: statSync(filePath).mtimeMs });
+      } catch {
+      }
+    }
+    for (const target of selectBackupsToDelete(matches, keep)) {
+      for (const p of [target, target + "-wal", target + "-shm"]) {
+        try {
+          if (existsSync(p)) {
+            unlinkSync(p);
+            if (p === target) deleted++;
+          }
+        } catch {
+        }
+      }
+    }
+  } catch {
+  }
+  return deleted;
+}
+function enforceRetention(reason, keepDays = DEFAULT_KEEP_DAYS) {
+  let deleted = rotateBackups(keepDays);
+  const cap = REASON_COUNT_CAP[reason];
+  if (typeof cap === "number") {
+    deleted += rotateBackupsByReason(reason, cap);
+  }
+  return deleted;
+}
 function listBackups() {
   if (!existsSync(BACKUP_DIR)) return [];
   try {
@@ -170,6 +248,10 @@ export {
   createBackup,
   createBackupAsync,
   rotateBackups,
+  selectBackupsToDelete,
+  hasEnoughDiskSpace,
+  rotateBackupsByReason,
+  enforceRetention,
   listBackups,
   hasBackupToday,
   getLatestBackup,