@snoai/memory 0.0.0-stage → 1.0.0

package/dist/internal/store/maintenance.d.ts

@@ -0,0 +1,75 @@
+import { g as ProductMode, y as Settings } from "../../plugin-config-schema-C0UUbOmG.js";
+import { C as MemoryStore } from "../../memory-store-base-XRA4S9Xl.js";
+import { r as MemoryTelemetryUsageOutbox } from "../../memory-telemetry-outbox-ddTdImt7.js";
+import { runIntegrityCheck } from "@snoai/sqlite-crypto";
+//#region src/store/maintenance.d.ts
+/**
+ * Usage events ('recall'/'inject') older than this are pruned from the
+ * `nodix_memory_events` ledger. MUST stay >= the purge-safety recall lookback
+ * (RECENT_RECALL_WINDOW_MS, 30 d) — coupled by a unit test — so retention can
+ * never erase evidence the cascade-purge preview depends on. Lifecycle events
+ * are never pruned (database-enforced by the guarded delete trigger).
+ */
+export declare const MEMORY_EVENTS_USAGE_RETENTION_MS: number;
+/** Quarantined outbox rows older than this are deleted by the maintenance pass. */
+export declare const OUTBOX_QUARANTINE_RETENTION_MS: number;
+/** The first tick runs shortly after boot, so every job gets near-boot coverage. */
+export declare const MAINTENANCE_FIRST_TICK_DELAY_MS = 6e4;
+export type MaintenanceJob = "integrity" | "usage-outbox" | "usage-retention" | "fts-merge" | "planner-statistics" | "backup" | "rem-trigger";
+export type MaintenanceIntervals = Readonly<Record<MaintenanceJob, number>>;
+/** Each job's own cadence; see the MAINTENANCE section of config/index.ts. */
+export declare const MAINTENANCE_INTERVALS: MaintenanceIntervals;
+/** Every job on one interval — what the sidecar's maintenance-interval override asks for. */
+export declare function uniformMaintenanceIntervals(intervalMs: number): MaintenanceIntervals;
+export interface MaintenanceDeps {
+  mode?: ProductMode;
+  modelCalls: Settings["modelCalls"];
+  remSettings: {
+    mode: ProductMode;
+    requestedOperations: Settings["rem"]["operations"];
+    tickEnabled: boolean;
+  };
+  hasConnectedHost?: () => boolean;
+  store: MemoryStore;
+  remClock?: Date;
+  remVolumeThreshold?: number;
+  usageOutbox?: MemoryTelemetryUsageOutbox;
+  dbPath: string;
+  backupDir: string;
+  /** sno-station-mem state directory for maintenance records. */
+  stateDir: string;
+  /**
+   * Integrity sweep implementation; defaults to sqlite-crypto's runIntegrityCheck.
+   * Injectable so the integrity integration test can drive the failure path
+   * (pre-declared in the DB-optimization plan's test design).
+   */
+  integrityCheck?: (rawDb: Parameters<typeof runIntegrityCheck>[0]) => void;
+  /**
+   * Wall-clock budget for usage-event retention pruning per pass; defaults to
+   * RETENTION_PRUNE_BUDGET_MS. Injectable so a test can force early cutoff of
+   * a large backlog without waiting on the real budget (host adversarial
+   * review 2026-07-13; same seam pattern as integrityCheck above).
+   */
+  retentionPruneBudgetMs?: number;
+}
+export interface MaintenanceReport {
+  aborted: boolean;
+  integrityRecovery: "none" | "recovered" | "retained";
+  integrityMs: number;
+  outboxFlushed: number;
+  quarantinePruned: number;
+  usageEventsPruned: number;
+  backupPath: string | undefined;
+}
+/** Runs the requested maintenance jobs independently. */
+export declare function runMaintenancePass(deps: MaintenanceDeps, due?: ReadonlySet<MaintenanceJob>, backupIntervalMs?: number): MaintenanceReport;
+export interface MaintenanceTimerHandle {
+  stop(): void;
+}
+/**
+ * Gateway maintenance schedule: first tick MAINTENANCE_FIRST_TICK_DELAY_MS after boot, then every
+ * tickMs. Each tick runs the jobs whose own interval has elapsed since they last ran; the first
+ * tick runs all of them. Stops when its store closes.
+ */
+export declare function startMaintenanceTimer(deps: MaintenanceDeps, tickMs?: number, firstTickDelayMs?: number, intervals?: MaintenanceIntervals): MaintenanceTimerHandle;
+//#endregion