anantham-v2 2.0.0-alpha.1 → 2.0.2

package/dist/persistence/repositories/event-repository.d.ts

@@ -15,6 +15,11 @@ export declare class EventRepository {
         limit?: number;
         offset?: number;
     }): Readonly<HarnessEvent>[];
+    listByProject(projectId: string, options?: {
+        type?: string;
+        limit?: number;
+        offset?: number;
+    }): Readonly<HarnessEvent>[];
     countBySession(sessionId: string): number;
 }
 //# sourceMappingURL=event-repository.d.ts.map

package/dist/persistence/repositories/event-repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-repository.d.ts","sourceRoot":"","sources":["../../../src/persistence/repositories/event-repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAiBxD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,YAAY;IAIhC,OAAO,CAAC,UAAU;IAmBlB;;;OAGG;IACI,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC;IA6BnD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAQnD,aAAa,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE;IAyBpB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAOjD"}
+{"version":3,"file":"event-repository.d.ts","sourceRoot":"","sources":["../../../src/persistence/repositories/event-repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAiBxD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,YAAY;IAIhC,OAAO,CAAC,UAAU;IAmBlB;;;OAGG;IACI,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC;IA6BnD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAQnD,aAAa,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE;IAyBpB,aAAa,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE;IAyBpB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAOjD"}

package/dist/persistence/repositories/event-repository.js

@@ -66,6 +66,27 @@ export class EventRepository {
         const rows = stmt.all(...params);
         return rows.map((r) => this.rowToEvent(r));
     }
+    listByProject(projectId, options) {
+        let sql = "SELECT * FROM events WHERE project_id = ?";
+        const params = [projectId];
+        if (options?.type) {
+            sql += " AND type = ?";
+            params.push(options.type);
+        }
+        sql += " ORDER BY timestamp ASC";
+        if (options?.limit) {
+            sql += " LIMIT ?";
+            params.push(options.limit);
+            if (options?.offset) {
+                sql += " OFFSET ?";
+                params.push(options.offset);
+            }
+        }
+        sql += ";";
+        const stmt = this.engine.raw.prepare(sql);
+        const rows = stmt.all(...params);
+        return rows.map((r) => this.rowToEvent(r));
+    }
     countBySession(sessionId) {
         const stmt = this.engine.raw.prepare(`
       SELECT COUNT(*) as count FROM events WHERE session_id = ?;

package/dist/persistence/repositories/event-repository.js.map

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

package/dist/persistence/user-config-manager.d.ts

@@ -0,0 +1,36 @@
+export interface UserConfig {
+    apiKeys: Record<string, string>;
+    defaultModel?: string;
+    theme?: string;
+    lastUpdated?: string;
+}
+/**
+ * UserConfigManager handles persistent configuration for Anantham V2
+ * across CLI, TUI, and Agent runtimes.
+ * Stores global config in ~/.anantham/config.json and optionally syncs with project .env.
+ */
+export declare class UserConfigManager {
+    private static instance;
+    private readonly configDir;
+    private readonly configPath;
+    private config;
+    constructor(customConfigDir?: string);
+    static getInstance(customConfigDir?: string): UserConfigManager;
+    private readFromDisk;
+    save(): void;
+    getApiKey(provider: string): string | undefined;
+    setApiKey(provider: string, apiKey: string, workspaceDir?: string): void;
+    removeApiKey(provider: string, workspaceDir?: string): boolean;
+    listKeys(): Array<{
+        provider: string;
+        configured: boolean;
+        masked: string;
+    }>;
+    getDefaultModel(): string;
+    setDefaultModel(modelId: string): void;
+    syncAllToProcessEnv(): void;
+    private maskSecret;
+    private syncToWorkspaceDotenv;
+    private removeFromWorkspaceDotenv;
+}
+//# sourceMappingURL=user-config-manager.d.ts.map

package/dist/persistence/user-config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-config-manager.d.ts","sourceRoot":"","sources":["../../src/persistence/user-config-manager.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,MAAM,CAAa;gBAEf,eAAe,CAAC,EAAE,MAAM;WAMtB,WAAW,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAOtE,OAAO,CAAC,YAAY;IAYb,IAAI,IAAI,IAAI;IAYZ,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK/C,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;IAaxE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO;IAc9D,QAAQ,IAAI,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAY5E,eAAe,IAAI,MAAM;IAIzB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKtC,mBAAmB,IAAI,IAAI;IASlC,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,yBAAyB;CAalC"}

package/dist/persistence/user-config-manager.js

@@ -0,0 +1,141 @@
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+/**
+ * UserConfigManager handles persistent configuration for Anantham V2
+ * across CLI, TUI, and Agent runtimes.
+ * Stores global config in ~/.anantham/config.json and optionally syncs with project .env.
+ */
+export class UserConfigManager {
+    static instance;
+    configDir;
+    configPath;
+    config;
+    constructor(customConfigDir) {
+        this.configDir = customConfigDir || path.join(os.homedir(), ".anantham");
+        this.configPath = path.join(this.configDir, "config.json");
+        this.config = this.readFromDisk();
+    }
+    static getInstance(customConfigDir) {
+        if (!UserConfigManager.instance || customConfigDir) {
+            UserConfigManager.instance = new UserConfigManager(customConfigDir);
+        }
+        return UserConfigManager.instance;
+    }
+    readFromDisk() {
+        try {
+            if (fs.existsSync(this.configPath)) {
+                const content = fs.readFileSync(this.configPath, "utf-8");
+                return JSON.parse(content);
+            }
+        }
+        catch {
+            // Fallback on read failure
+        }
+        return { apiKeys: {} };
+    }
+    save() {
+        try {
+            if (!fs.existsSync(this.configDir)) {
+                fs.mkdirSync(this.configDir, { recursive: true });
+            }
+            this.config.lastUpdated = new Date().toISOString();
+            fs.writeFileSync(this.configPath, JSON.stringify(this.config, null, 2), "utf-8");
+        }
+        catch (err) {
+            console.error("Warning: Failed to save ~/.anantham/config.json:", err);
+        }
+    }
+    getApiKey(provider) {
+        const key = provider.toLowerCase();
+        return this.config.apiKeys[key] || process.env[`${key.toUpperCase().replace(/-/g, "_")}_API_KEY`];
+    }
+    setApiKey(provider, apiKey, workspaceDir) {
+        const key = provider.toLowerCase();
+        this.config.apiKeys[key] = apiKey;
+        this.save();
+        // Sync to process.env immediately
+        const envVar = `${key.toUpperCase().replace(/-/g, "_")}_API_KEY`;
+        process.env[envVar] = apiKey;
+        // Sync to workspace .env if directory provided or current directory
+        this.syncToWorkspaceDotenv(envVar, apiKey, workspaceDir || process.cwd());
+    }
+    removeApiKey(provider, workspaceDir) {
+        const key = provider.toLowerCase();
+        if (this.config.apiKeys[key]) {
+            delete this.config.apiKeys[key];
+            this.save();
+            const envVar = `${key.toUpperCase().replace(/-/g, "_")}_API_KEY`;
+            delete process.env[envVar];
+            this.removeFromWorkspaceDotenv(envVar, workspaceDir || process.cwd());
+            return true;
+        }
+        return false;
+    }
+    listKeys() {
+        const knownProviders = ["openrouter", "openai", "anthropic", "gemini", "groq", "deepseek", "ollama"];
+        return knownProviders.map((p) => {
+            const val = this.getApiKey(p);
+            return {
+                provider: p,
+                configured: !!val,
+                masked: val ? this.maskSecret(val) : "Not Set",
+            };
+        });
+    }
+    getDefaultModel() {
+        return this.config.defaultModel || "gemini-2.5-pro";
+    }
+    setDefaultModel(modelId) {
+        this.config.defaultModel = modelId;
+        this.save();
+    }
+    syncAllToProcessEnv() {
+        for (const [provider, apiKey] of Object.entries(this.config.apiKeys)) {
+            const envVar = `${provider.toUpperCase().replace(/-/g, "_")}_API_KEY`;
+            if (!process.env[envVar] && apiKey) {
+                process.env[envVar] = apiKey;
+            }
+        }
+    }
+    maskSecret(secret) {
+        if (!secret || secret.length < 8)
+            return "****";
+        return `${secret.slice(0, 3)}...${secret.slice(-4)}`;
+    }
+    syncToWorkspaceDotenv(envVar, value, workspaceDir) {
+        try {
+            const dotenvPath = path.join(workspaceDir, ".env");
+            let content = "";
+            if (fs.existsSync(dotenvPath)) {
+                content = fs.readFileSync(dotenvPath, "utf-8");
+            }
+            const regex = new RegExp(`^${envVar}=.*$`, "m");
+            if (regex.test(content)) {
+                content = content.replace(regex, `${envVar}=${value}`);
+            }
+            else {
+                content = content ? `${content.trimEnd()}\n${envVar}=${value}\n` : `${envVar}=${value}\n`;
+            }
+            fs.writeFileSync(dotenvPath, content, "utf-8");
+        }
+        catch {
+            // Non-fatal if workspace .env is unwritable
+        }
+    }
+    removeFromWorkspaceDotenv(envVar, workspaceDir) {
+        try {
+            const dotenvPath = path.join(workspaceDir, ".env");
+            if (fs.existsSync(dotenvPath)) {
+                const content = fs.readFileSync(dotenvPath, "utf-8");
+                const regex = new RegExp(`^${envVar}=.*$\n?`, "m");
+                const updated = content.replace(regex, "");
+                fs.writeFileSync(dotenvPath, updated, "utf-8");
+            }
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+}
+//# sourceMappingURL=user-config-manager.js.map

package/dist/persistence/user-config-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-config-manager.js","sourceRoot":"","sources":["../../src/persistence/user-config-manager.ts"],"names":[],"mappings":"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"}

package/dist/persistence/wal-checkpoint-scheduler.d.ts

@@ -0,0 +1,51 @@
+import { SqliteEngine } from "./sqlite-engine.js";
+export type WALCheckpointMode = "PASSIVE" | "FULL" | "RESTART" | "TRUNCATE";
+export interface WALCheckpointStats {
+    timestamp: string;
+    mode: WALCheckpointMode;
+    busy: number;
+    logPages: number;
+    checkpointedPages: number;
+    walSizeBytes: number;
+    dbSizeBytes: number;
+    durationMs: number;
+    vacuumExecuted: boolean;
+    freelistPagesBefore?: number;
+    freelistPagesAfter?: number;
+}
+export interface WalCheckpointSchedulerConfig {
+    intervalMs?: number;
+    walSizeBytesThreshold?: number;
+    walPagesThreshold?: number;
+    freelistPagesThreshold?: number;
+    defaultMode?: WALCheckpointMode;
+    escalationMode?: WALCheckpointMode;
+    adaptiveScheduling?: boolean;
+}
+export declare class WalCheckpointScheduler {
+    private readonly engine;
+    private readonly config;
+    private timer;
+    private history;
+    private listeners;
+    constructor(engine: SqliteEngine, config?: WalCheckpointSchedulerConfig);
+    start(): void;
+    stop(): void;
+    isRunning(): boolean;
+    private getWalDiskSizeBytes;
+    private getDbDiskSizeBytes;
+    private getFreelistCount;
+    evaluateStatus(): {
+        shouldCheckpoint: boolean;
+        recommendedMode: WALCheckpointMode;
+        shouldVacuum: boolean;
+        walPages: number;
+        walSizeBytes: number;
+        freelistPages: number;
+    };
+    forceCheckpoint(mode?: WALCheckpointMode): WALCheckpointStats;
+    runMaintenanceCycle(): Promise<WALCheckpointStats>;
+    getHistory(): WALCheckpointStats[];
+    onCheckpoint(listener: (stats: WALCheckpointStats) => void): () => void;
+}
+//# sourceMappingURL=wal-checkpoint-scheduler.d.ts.map

package/dist/persistence/wal-checkpoint-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wal-checkpoint-scheduler.d.ts","sourceRoot":"","sources":["../../src/persistence/wal-checkpoint-scheduler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAE5E,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,4BAA4B;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAChE,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,SAAS,CAAkD;gBAEvD,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,4BAA4B;IAahE,KAAK,IAAI,IAAI;IAab,IAAI,IAAI,IAAI;IAOZ,SAAS,IAAI,OAAO;IAI3B,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,gBAAgB;IASjB,cAAc,IAAI;QACvB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,eAAe,EAAE,iBAAiB,CAAC;QACnC,YAAY,EAAE,OAAO,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB;IA4BM,eAAe,CAAC,IAAI,GAAE,iBAA2C,GAAG,kBAAkB;IAkFhF,mBAAmB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAMxD,UAAU,IAAI,kBAAkB,EAAE;IA6BlC,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI;CAM/E"}

package/dist/persistence/wal-checkpoint-scheduler.js

@@ -0,0 +1,214 @@
+import { existsSync, statSync } from "node:fs";
+export class WalCheckpointScheduler {
+    engine;
+    config;
+    timer = null;
+    history = [];
+    listeners = [];
+    constructor(engine, config) {
+        this.engine = engine;
+        this.config = {
+            intervalMs: config?.intervalMs ?? 60_000,
+            walSizeBytesThreshold: config?.walSizeBytesThreshold ?? 10 * 1024 * 1024,
+            walPagesThreshold: config?.walPagesThreshold ?? 1000,
+            freelistPagesThreshold: config?.freelistPagesThreshold ?? 500,
+            defaultMode: config?.defaultMode ?? "PASSIVE",
+            escalationMode: config?.escalationMode ?? "TRUNCATE",
+            adaptiveScheduling: config?.adaptiveScheduling ?? false,
+        };
+    }
+    start() {
+        if (this.timer) {
+            return;
+        }
+        this.timer = setInterval(() => {
+            this.runMaintenanceCycle().catch((err) => {
+                console.error("[WalCheckpointScheduler] Error during maintenance cycle:", err);
+            });
+        }, this.config.intervalMs);
+        // Unref timer so it does not block Node process exit in tests
+        this.timer.unref();
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    isRunning() {
+        return this.timer !== null;
+    }
+    getWalDiskSizeBytes() {
+        const dbPath = this.engine.config?.path;
+        if (!dbPath || dbPath === ":memory:") {
+            return 0;
+        }
+        const walPath = dbPath + "-wal";
+        if (existsSync(walPath)) {
+            try {
+                return statSync(walPath).size;
+            }
+            catch {
+                return 0;
+            }
+        }
+        return 0;
+    }
+    getDbDiskSizeBytes() {
+        const dbPath = this.engine.config?.path;
+        if (!dbPath || dbPath === ":memory:") {
+            return 0;
+        }
+        if (existsSync(dbPath)) {
+            try {
+                return statSync(dbPath).size;
+            }
+            catch {
+                return 0;
+            }
+        }
+        return 0;
+    }
+    getFreelistCount() {
+        try {
+            const row = this.engine.raw.prepare("PRAGMA freelist_count;").get();
+            return row?.freelist_count ?? 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+    evaluateStatus() {
+        const walSizeBytes = this.getWalDiskSizeBytes();
+        const freelistPages = this.getFreelistCount();
+        let walPages = 0;
+        try {
+            const row = this.engine.raw.prepare("PRAGMA wal_checkpoint(PASSIVE);").get();
+            walPages = row?.log ?? 0;
+        }
+        catch {
+            walPages = 0;
+        }
+        const shouldCheckpoint = walSizeBytes >= this.config.walSizeBytesThreshold || walPages >= this.config.walPagesThreshold;
+        const shouldVacuum = freelistPages >= this.config.freelistPagesThreshold;
+        const recommendedMode = walPages >= this.config.walPagesThreshold * 2
+            ? this.config.escalationMode
+            : this.config.defaultMode;
+        return {
+            shouldCheckpoint,
+            recommendedMode,
+            shouldVacuum,
+            walPages,
+            walSizeBytes,
+            freelistPages,
+        };
+    }
+    forceCheckpoint(mode = this.config.defaultMode) {
+        const startTime = performance.now();
+        const freelistBefore = this.getFreelistCount();
+        let busy = 0;
+        let logPages = 0;
+        let checkpointedPages = 0;
+        try {
+            const row = this.engine.raw.prepare("PRAGMA wal_checkpoint(" + mode + ");").get();
+            busy = row?.busy ?? 0;
+            logPages = row?.log ?? 0;
+            checkpointedPages = row?.checkpointed ?? 0;
+        }
+        catch {
+            // Fallback
+            this.engine.raw.exec("PRAGMA wal_checkpoint(" + mode + ");");
+        }
+        let vacuumExecuted = false;
+        if (freelistBefore >= this.config.freelistPagesThreshold) {
+            try {
+                this.engine.raw.exec("PRAGMA incremental_vacuum(100);");
+                vacuumExecuted = true;
+            }
+            catch {
+                // Ignored
+            }
+        }
+        const freelistAfter = this.getFreelistCount();
+        const durationMs = performance.now() - startTime;
+        const stats = {
+            timestamp: new Date().toISOString(),
+            mode,
+            busy,
+            logPages,
+            checkpointedPages,
+            walSizeBytes: this.getWalDiskSizeBytes(),
+            dbSizeBytes: this.getDbDiskSizeBytes(),
+            durationMs,
+            vacuumExecuted,
+            freelistPagesBefore: freelistBefore,
+            freelistPagesAfter: freelistAfter,
+        };
+        // Store in circular history buffer (max 100)
+        this.history.unshift(stats);
+        if (this.history.length > 100) {
+            this.history.pop();
+        }
+        // Persist to telemetry table if available
+        try {
+            const stmt = this.engine.raw.prepare(`
+        INSERT INTO wal_checkpoint_logs (timestamp, mode, busy, log_pages, checkpointed_pages, wal_size_bytes, db_size_bytes, duration_ms, vacuum_executed)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?);
+      `);
+            stmt.run(stats.timestamp, stats.mode, stats.busy, stats.logPages, stats.checkpointedPages, stats.walSizeBytes, stats.dbSizeBytes, stats.durationMs, stats.vacuumExecuted ? 1 : 0);
+        }
+        catch {
+            // Migration table may not be loaded yet in lightweight test setups
+        }
+        // Notify listeners
+        for (const listener of this.listeners) {
+            try {
+                listener(stats);
+            }
+            catch (err) {
+                console.error("[WalCheckpointScheduler] Error in checkpoint listener:", err);
+            }
+        }
+        return stats;
+    }
+    async runMaintenanceCycle() {
+        const evalStatus = this.evaluateStatus();
+        const mode = evalStatus.shouldCheckpoint ? evalStatus.recommendedMode : this.config.defaultMode;
+        return this.forceCheckpoint(mode);
+    }
+    getHistory() {
+        // If telemetry table exists, also load persisted logs
+        try {
+            const rows = this.engine.raw.prepare(`
+        SELECT timestamp, mode, busy, log_pages as logPages, checkpointed_pages as checkpointedPages,
+               wal_size_bytes as walSizeBytes, db_size_bytes as dbSizeBytes, duration_ms as durationMs,
+               vacuum_executed as vacuumExecuted
+        FROM wal_checkpoint_logs
+        ORDER BY id DESC
+        LIMIT 100;
+      `).all();
+            if (rows.length > 0) {
+                return rows.map((r) => ({
+                    timestamp: r.timestamp,
+                    mode: r.mode,
+                    busy: Number(r.busy),
+                    logPages: Number(r.logPages),
+                    checkpointedPages: Number(r.checkpointedPages),
+                    walSizeBytes: Number(r.walSizeBytes),
+                    dbSizeBytes: Number(r.dbSizeBytes),
+                    durationMs: Number(r.durationMs),
+                    vacuumExecuted: Boolean(r.vacuumExecuted),
+                }));
+            }
+        }
+        catch { }
+        return [...this.history];
+    }
+    onCheckpoint(listener) {
+        this.listeners.push(listener);
+        return () => {
+            this.listeners = this.listeners.filter((l) => l !== listener);
+        };
+    }
+}
+//# sourceMappingURL=wal-checkpoint-scheduler.js.map

package/dist/persistence/wal-checkpoint-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wal-checkpoint-scheduler.js","sourceRoot":"","sources":["../../src/persistence/wal-checkpoint-scheduler.ts"],"names":[],"mappings":"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"}