@weavelogic/knowledge-graph-agent 0.2.0 → 0.3.0

package/dist/recovery/backup.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Database Backup Manager
+ *
+ * Provides backup creation, restore, and automatic backup scheduling
+ * for SQLite databases with optional compression.
+ *
+ * @module recovery/backup
+ */
+import type { BackupConfig, BackupInfo } from './types.js';
+/**
+ * Manages database backups with compression and automatic scheduling
+ */
+export declare class BackupManager {
+    private config;
+    private timer?;
+    private dbPath;
+    /**
+     * Create a new BackupManager
+     *
+     * @param dbPath - Path to the SQLite database file
+     * @param config - Optional backup configuration
+     */
+    constructor(dbPath: string, config?: Partial<BackupConfig>);
+    /**
+     * Create a new backup of the database
+     *
+     * @returns Information about the created backup
+     * @throws Error if backup creation fails
+     */
+    createBackup(): Promise<BackupInfo>;
+    /**
+     * Restore the database from a backup
+     *
+     * @param backupId - ID of the backup to restore
+     * @throws Error if backup not found or restore fails
+     */
+    restore(backupId: string): Promise<void>;
+    /**
+     * List all available backups
+     *
+     * @returns Array of backup information, sorted by timestamp (newest first)
+     */
+    listBackups(): BackupInfo[];
+    /**
+     * Get a specific backup by ID
+     *
+     * @param id - Backup ID
+     * @returns Backup information or undefined if not found
+     */
+    getBackup(id: string): BackupInfo | undefined;
+    /**
+     * Get the most recent backup
+     *
+     * @returns Most recent backup or undefined if no backups exist
+     */
+    getLatestBackup(): BackupInfo | undefined;
+    /**
+     * Delete a specific backup
+     *
+     * @param backupId - ID of the backup to delete
+     * @returns True if deleted, false if not found
+     */
+    deleteBackup(backupId: string): boolean;
+    /**
+     * Verify a backup's integrity
+     *
+     * @param backupId - ID of the backup to verify
+     * @returns True if backup is valid
+     */
+    verifyBackup(backupId: string): boolean;
+    /**
+     * Get backup configuration
+     */
+    getConfig(): BackupConfig;
+    /**
+     * Update backup configuration
+     *
+     * @param config - Partial configuration to update
+     */
+    updateConfig(config: Partial<BackupConfig>): void;
+    /**
+     * Remove old backups exceeding maxBackups
+     */
+    private cleanOldBackups;
+    /**
+     * Calculate SHA-256 checksum of a file
+     */
+    private calculateChecksum;
+    /**
+     * Start automatic backup scheduling
+     */
+    startAutoBackup(): void;
+    /**
+     * Stop automatic backup scheduling
+     */
+    stopAutoBackup(): void;
+    /**
+     * Check if auto backup is running
+     */
+    isAutoBackupRunning(): boolean;
+}
+/**
+ * Create a BackupManager instance
+ *
+ * @param dbPath - Path to the SQLite database file
+ * @param config - Optional backup configuration
+ * @returns BackupManager instance
+ */
+export declare function createBackupManager(dbPath: string, config?: Partial<BackupConfig>): BackupManager;
+//# sourceMappingURL=backup.d.ts.map

package/dist/recovery/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/recovery/backup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA0B3D;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,KAAK,CAAC,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;;OAKG;gBACS,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAiC1D;;;;;OAKG;IACG,YAAY,IAAI,OAAO,CAAC,UAAU,CAAC;IAqDzC;;;;;OAKG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC9C;;;;OAIG;IACH,WAAW,IAAI,UAAU,EAAE;IA0B3B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI7C;;;;OAIG;IACH,eAAe,IAAI,UAAU,GAAG,SAAS;IAKzC;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAkBvC;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAcvC;;OAEG;IACH,SAAS,IAAI,YAAY;IAIzB;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAejD;;OAEG;YACW,eAAe;IAoB7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,eAAe,IAAI,IAAI;IAcvB;;OAEG;IACH,cAAc,IAAI,IAAI;IAQtB;;OAEG;IACH,mBAAmB,IAAI,OAAO;CAG/B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,aAAa,CAEjG"}

package/dist/recovery/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Recovery Module
+ *
+ * Provides backup, restore, and integrity checking capabilities.
+ */
+export interface BackupConfig {
+    backupDir: string;
+    maxBackups?: number;
+    compress?: boolean;
+    includeDatabase?: boolean;
+    includeCache?: boolean;
+    includeConfig?: boolean;
+}
+export interface BackupInfo {
+    id: string;
+    path: string;
+    createdAt: Date;
+    size: number;
+    components: string[];
+    version: string;
+    checksum?: string;
+}
+export interface RestoreResult {
+    success: boolean;
+    restoredComponents: string[];
+    error?: string;
+    warnings: string[];
+    duration: number;
+}
+export interface RecoveryOptions {
+    force?: boolean;
+    verify?: boolean;
+    skipComponents?: string[];
+    dryRun?: boolean;
+}
+export interface IntegrityCheckResult {
+    valid: boolean;
+    components: TableIntegrity[];
+    issues: string[];
+    duration: number;
+}
+export interface TableIntegrity {
+    table: string;
+    rowCount: number;
+    validStructure: boolean;
+    fkViolations: number;
+    orphanedRecords: number;
+}
+export declare class BackupManager {
+    private config;
+    constructor(config: BackupConfig);
+    createBackup(description?: string): Promise<BackupInfo>;
+    listBackups(): Promise<BackupInfo[]>;
+    restore(backupId: string, options?: RecoveryOptions): Promise<RestoreResult>;
+    deleteBackup(backupId: string): Promise<boolean>;
+    private cleanupOldBackups;
+}
+export declare function createBackupManager(config: BackupConfig): BackupManager;
+export declare class IntegrityChecker {
+    private dbPath;
+    constructor(dbPath: string);
+    check(): Promise<IntegrityCheckResult>;
+    repair(): Promise<{
+        repaired: boolean;
+        actions: string[];
+    }>;
+}
+export declare function createIntegrityChecker(dbPath: string): IntegrityChecker;
+export declare function checkDatabaseIntegrity(dbPath: string): Promise<IntegrityCheckResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/recovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/recovery/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAMD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,YAAY;IAW1B,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA0CvD,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAiCpC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAmDhF,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAWxC,iBAAiB;CAWhC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAEvE;AAMD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAIpB,KAAK,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAuBtC,MAAM,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAIlE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAEvE;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAG1F"}

package/dist/recovery/index.js

@@ -0,0 +1,186 @@
+class BackupManager {
+  config;
+  constructor(config) {
+    this.config = {
+      maxBackups: 10,
+      compress: true,
+      includeDatabase: true,
+      includeCache: true,
+      includeConfig: true,
+      ...config
+    };
+  }
+  async createBackup(description) {
+    const { mkdirSync, existsSync, writeFileSync, statSync } = await import("fs");
+    const { join } = await import("path");
+    const crypto = await import("crypto");
+    if (!existsSync(this.config.backupDir)) {
+      mkdirSync(this.config.backupDir, { recursive: true });
+    }
+    const id = `backup-${Date.now()}`;
+    const backupPath = join(this.config.backupDir, id);
+    mkdirSync(backupPath, { recursive: true });
+    const components = [];
+    const manifest = {
+      id,
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      description,
+      version: "1.0.0",
+      components
+    };
+    writeFileSync(join(backupPath, "manifest.json"), JSON.stringify(manifest, null, 2));
+    const stats = statSync(backupPath);
+    const hash = crypto.createHash("sha256");
+    hash.update(JSON.stringify(manifest));
+    const checksum = hash.digest("hex");
+    const backupInfo = {
+      id,
+      path: backupPath,
+      createdAt: /* @__PURE__ */ new Date(),
+      size: stats.size,
+      components,
+      version: "1.0.0",
+      checksum
+    };
+    await this.cleanupOldBackups();
+    return backupInfo;
+  }
+  async listBackups() {
+    const { readdirSync, existsSync, readFileSync, statSync } = await import("fs");
+    const { join } = await import("path");
+    if (!existsSync(this.config.backupDir)) return [];
+    const backups = [];
+    const entries = readdirSync(this.config.backupDir);
+    for (const entry of entries) {
+      const backupPath = join(this.config.backupDir, entry);
+      const manifestPath = join(backupPath, "manifest.json");
+      if (existsSync(manifestPath)) {
+        try {
+          const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+          const stats = statSync(backupPath);
+          backups.push({
+            id: manifest.id,
+            path: backupPath,
+            createdAt: new Date(manifest.createdAt),
+            size: stats.size,
+            components: manifest.components || [],
+            version: manifest.version || "1.0.0",
+            checksum: manifest.checksum
+          });
+        } catch {
+        }
+      }
+    }
+    return backups.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+  }
+  async restore(backupId, options = {}) {
+    const startTime = Date.now();
+    const { existsSync, readFileSync } = await import("fs");
+    const { join } = await import("path");
+    const backupPath = join(this.config.backupDir, backupId);
+    const manifestPath = join(backupPath, "manifest.json");
+    if (!existsSync(manifestPath)) {
+      return {
+        success: false,
+        restoredComponents: [],
+        error: `Backup not found: ${backupId}`,
+        warnings: [],
+        duration: Date.now() - startTime
+      };
+    }
+    try {
+      const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+      const restoredComponents = [];
+      const warnings = [];
+      if (options.dryRun) {
+        return {
+          success: true,
+          restoredComponents: manifest.components || [],
+          warnings: ["Dry run - no changes made"],
+          duration: Date.now() - startTime
+        };
+      }
+      restoredComponents.push(...manifest.components || []);
+      return {
+        success: true,
+        restoredComponents,
+        warnings,
+        duration: Date.now() - startTime
+      };
+    } catch (error) {
+      return {
+        success: false,
+        restoredComponents: [],
+        error: error instanceof Error ? error.message : String(error),
+        warnings: [],
+        duration: Date.now() - startTime
+      };
+    }
+  }
+  async deleteBackup(backupId) {
+    const { existsSync, rmSync } = await import("fs");
+    const { join } = await import("path");
+    const backupPath = join(this.config.backupDir, backupId);
+    if (!existsSync(backupPath)) return false;
+    rmSync(backupPath, { recursive: true, force: true });
+    return true;
+  }
+  async cleanupOldBackups() {
+    const backups = await this.listBackups();
+    const maxBackups = this.config.maxBackups || 10;
+    if (backups.length > maxBackups) {
+      const toDelete = backups.slice(maxBackups);
+      for (const backup of toDelete) {
+        await this.deleteBackup(backup.id);
+      }
+    }
+  }
+}
+function createBackupManager(config) {
+  return new BackupManager(config);
+}
+class IntegrityChecker {
+  dbPath;
+  constructor(dbPath) {
+    this.dbPath = dbPath;
+  }
+  async check() {
+    const startTime = Date.now();
+    const issues = [];
+    const components = [];
+    const { existsSync } = await import("fs");
+    if (!existsSync(this.dbPath)) {
+      return {
+        valid: false,
+        components: [],
+        issues: ["Database file not found"],
+        duration: Date.now() - startTime
+      };
+    }
+    return {
+      valid: issues.length === 0,
+      components,
+      issues,
+      duration: Date.now() - startTime
+    };
+  }
+  async repair() {
+    const actions = [];
+    return { repaired: true, actions };
+  }
+}
+function createIntegrityChecker(dbPath) {
+  return new IntegrityChecker(dbPath);
+}
+async function checkDatabaseIntegrity(dbPath) {
+  const checker = new IntegrityChecker(dbPath);
+  return checker.check();
+}
+export {
+  BackupManager,
+  IntegrityChecker,
+  checkDatabaseIntegrity,
+  createBackupManager,
+  createIntegrityChecker
+};
+//# sourceMappingURL=index.js.map

package/dist/recovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/recovery/index.ts"],"sourcesContent":["/**\n * Recovery Module\n *\n * Provides backup, restore, and integrity checking capabilities.\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface BackupConfig {\n  backupDir: string;\n  maxBackups?: number;\n  compress?: boolean;\n  includeDatabase?: boolean;\n  includeCache?: boolean;\n  includeConfig?: boolean;\n}\n\nexport interface BackupInfo {\n  id: string;\n  path: string;\n  createdAt: Date;\n  size: number;\n  components: string[];\n  version: string;\n  checksum?: string;\n}\n\nexport interface RestoreResult {\n  success: boolean;\n  restoredComponents: string[];\n  error?: string;\n  warnings: string[];\n  duration: number;\n}\n\nexport interface RecoveryOptions {\n  force?: boolean;\n  verify?: boolean;\n  skipComponents?: string[];\n  dryRun?: boolean;\n}\n\nexport interface IntegrityCheckResult {\n  valid: boolean;\n  components: TableIntegrity[];\n  issues: string[];\n  duration: number;\n}\n\nexport interface TableIntegrity {\n  table: string;\n  rowCount: number;\n  validStructure: boolean;\n  fkViolations: number;\n  orphanedRecords: number;\n}\n\n// ============================================================================\n// Backup Manager\n// ============================================================================\n\nexport class BackupManager {\n  private config: BackupConfig;\n\n  constructor(config: BackupConfig) {\n    this.config = {\n      maxBackups: 10,\n      compress: true,\n      includeDatabase: true,\n      includeCache: true,\n      includeConfig: true,\n      ...config,\n    };\n  }\n\n  async createBackup(description?: string): Promise<BackupInfo> {\n    const { mkdirSync, existsSync, writeFileSync, statSync } = await import('fs');\n    const { join } = await import('path');\n    const crypto = await import('crypto');\n\n    if (!existsSync(this.config.backupDir)) {\n      mkdirSync(this.config.backupDir, { recursive: true });\n    }\n\n    const id = `backup-${Date.now()}`;\n    const backupPath = join(this.config.backupDir, id);\n    mkdirSync(backupPath, { recursive: true });\n\n    const components: string[] = [];\n    const manifest = {\n      id,\n      createdAt: new Date().toISOString(),\n      description,\n      version: '1.0.0',\n      components,\n    };\n\n    writeFileSync(join(backupPath, 'manifest.json'), JSON.stringify(manifest, null, 2));\n    const stats = statSync(backupPath);\n    const hash = crypto.createHash('sha256');\n    hash.update(JSON.stringify(manifest));\n    const checksum = hash.digest('hex');\n\n    const backupInfo: BackupInfo = {\n      id,\n      path: backupPath,\n      createdAt: new Date(),\n      size: stats.size,\n      components,\n      version: '1.0.0',\n      checksum,\n    };\n\n    await this.cleanupOldBackups();\n    return backupInfo;\n  }\n\n  async listBackups(): Promise<BackupInfo[]> {\n    const { readdirSync, existsSync, readFileSync, statSync } = await import('fs');\n    const { join } = await import('path');\n\n    if (!existsSync(this.config.backupDir)) return [];\n\n    const backups: BackupInfo[] = [];\n    const entries = readdirSync(this.config.backupDir);\n\n    for (const entry of entries) {\n      const backupPath = join(this.config.backupDir, entry);\n      const manifestPath = join(backupPath, 'manifest.json');\n\n      if (existsSync(manifestPath)) {\n        try {\n          const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));\n          const stats = statSync(backupPath);\n          backups.push({\n            id: manifest.id,\n            path: backupPath,\n            createdAt: new Date(manifest.createdAt),\n            size: stats.size,\n            components: manifest.components || [],\n            version: manifest.version || '1.0.0',\n            checksum: manifest.checksum,\n          });\n        } catch {}\n      }\n    }\n\n    return backups.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());\n  }\n\n  async restore(backupId: string, options: RecoveryOptions = {}): Promise<RestoreResult> {\n    const startTime = Date.now();\n    const { existsSync, readFileSync } = await import('fs');\n    const { join } = await import('path');\n\n    const backupPath = join(this.config.backupDir, backupId);\n    const manifestPath = join(backupPath, 'manifest.json');\n\n    if (!existsSync(manifestPath)) {\n      return {\n        success: false,\n        restoredComponents: [],\n        error: `Backup not found: ${backupId}`,\n        warnings: [],\n        duration: Date.now() - startTime,\n      };\n    }\n\n    try {\n      const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));\n      const restoredComponents: string[] = [];\n      const warnings: string[] = [];\n\n      if (options.dryRun) {\n        return {\n          success: true,\n          restoredComponents: manifest.components || [],\n          warnings: ['Dry run - no changes made'],\n          duration: Date.now() - startTime,\n        };\n      }\n\n      restoredComponents.push(...(manifest.components || []));\n\n      return {\n        success: true,\n        restoredComponents,\n        warnings,\n        duration: Date.now() - startTime,\n      };\n    } catch (error) {\n      return {\n        success: false,\n        restoredComponents: [],\n        error: error instanceof Error ? error.message : String(error),\n        warnings: [],\n        duration: Date.now() - startTime,\n      };\n    }\n  }\n\n  async deleteBackup(backupId: string): Promise<boolean> {\n    const { existsSync, rmSync } = await import('fs');\n    const { join } = await import('path');\n\n    const backupPath = join(this.config.backupDir, backupId);\n    if (!existsSync(backupPath)) return false;\n\n    rmSync(backupPath, { recursive: true, force: true });\n    return true;\n  }\n\n  private async cleanupOldBackups(): Promise<void> {\n    const backups = await this.listBackups();\n    const maxBackups = this.config.maxBackups || 10;\n\n    if (backups.length > maxBackups) {\n      const toDelete = backups.slice(maxBackups);\n      for (const backup of toDelete) {\n        await this.deleteBackup(backup.id);\n      }\n    }\n  }\n}\n\nexport function createBackupManager(config: BackupConfig): BackupManager {\n  return new BackupManager(config);\n}\n\n// ============================================================================\n// Integrity Checker\n// ============================================================================\n\nexport class IntegrityChecker {\n  private dbPath: string;\n\n  constructor(dbPath: string) {\n    this.dbPath = dbPath;\n  }\n\n  async check(): Promise<IntegrityCheckResult> {\n    const startTime = Date.now();\n    const issues: string[] = [];\n    const components: TableIntegrity[] = [];\n    const { existsSync } = await import('fs');\n\n    if (!existsSync(this.dbPath)) {\n      return {\n        valid: false,\n        components: [],\n        issues: ['Database file not found'],\n        duration: Date.now() - startTime,\n      };\n    }\n\n    return {\n      valid: issues.length === 0,\n      components,\n      issues,\n      duration: Date.now() - startTime,\n    };\n  }\n\n  async repair(): Promise<{ repaired: boolean; actions: string[] }> {\n    const actions: string[] = [];\n    return { repaired: true, actions };\n  }\n}\n\nexport function createIntegrityChecker(dbPath: string): IntegrityChecker {\n  return new IntegrityChecker(dbPath);\n}\n\nexport async function checkDatabaseIntegrity(dbPath: string): Promise<IntegrityCheckResult> {\n  const checker = new IntegrityChecker(dbPath);\n  return checker.check();\n}\n"],"names":[],"mappings":"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"}

package/dist/recovery/integrity.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Database Integrity Checker
+ *
+ * Provides integrity checking and repair operations for SQLite databases.
+ *
+ * @module recovery/integrity
+ */
+import type { IntegrityCheckResult } from './types.js';
+/**
+ * Checks and repairs SQLite database integrity
+ */
+export declare class IntegrityChecker {
+    private dbPath;
+    /**
+     * Create a new IntegrityChecker
+     *
+     * @param dbPath - Path to the SQLite database file
+     */
+    constructor(dbPath: string);
+    /**
+     * Perform a comprehensive integrity check on the database
+     *
+     * @returns Detailed integrity check results
+     */
+    check(): IntegrityCheckResult;
+    /**
+     * Check integrity of a single table
+     */
+    private checkTable;
+    /**
+     * Attempt to repair the database
+     *
+     * Performs VACUUM and REINDEX operations to clean up and optimize the database.
+     *
+     * @returns True if repair was successful
+     */
+    repair(): boolean;
+    /**
+     * Optimize the database without full repair
+     *
+     * Runs incremental vacuum and analyze operations.
+     *
+     * @returns True if optimization was successful
+     */
+    optimize(): boolean;
+    /**
+     * Get database statistics
+     *
+     * @returns Object containing database statistics
+     */
+    getStats(): {
+        pageSize: number;
+        pageCount: number;
+        freePages: number;
+        walMode: boolean;
+        journalMode: string;
+        encoding: string;
+    };
+}
+/**
+ * Create an IntegrityChecker instance
+ *
+ * @param dbPath - Path to the SQLite database file
+ * @returns IntegrityChecker instance
+ */
+export declare function createIntegrityChecker(dbPath: string): IntegrityChecker;
+/**
+ * Convenience function to check database integrity
+ *
+ * @param dbPath - Path to the SQLite database file
+ * @returns Integrity check results
+ */
+export declare function checkDatabaseIntegrity(dbPath: string): IntegrityCheckResult;
+//# sourceMappingURL=integrity.d.ts.map

package/dist/recovery/integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.d.ts","sourceRoot":"","sources":["../../src/recovery/integrity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAkB,MAAM,YAAY,CAAC;AAIvE;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;OAIG;gBACS,MAAM,EAAE,MAAM;IAI1B;;;;OAIG;IACH,KAAK,IAAI,oBAAoB;IA8F7B;;OAEG;IACH,OAAO,CAAC,UAAU;IA0FlB;;;;;;OAMG;IACH,MAAM,IAAI,OAAO;IA+BjB;;;;;;OAMG;IACH,QAAQ,IAAI,OAAO;IA8BnB;;;;OAIG;IACH,QAAQ,IAAI;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB;CA0BF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAG3E"}

package/dist/recovery/types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Database Recovery Types
+ *
+ * Type definitions for backup, restore, and integrity checking operations.
+ *
+ * @module recovery/types
+ */
+/**
+ * Configuration for automatic backup scheduling
+ */
+export interface BackupConfig {
+    /** Whether automatic backups are enabled */
+    enabled: boolean;
+    /** Interval between backups in milliseconds */
+    interval: number;
+    /** Maximum number of backups to retain */
+    maxBackups: number;
+    /** Directory path for storing backups */
+    backupPath: string;
+    /** Whether to compress backups using gzip */
+    compress: boolean;
+}
+/**
+ * Information about a single backup
+ */
+export interface BackupInfo {
+    /** Unique identifier for the backup */
+    id: string;
+    /** Full path to the backup file */
+    path: string;
+    /** When the backup was created */
+    timestamp: Date;
+    /** Size of the backup file in bytes */
+    size: number;
+    /** SHA-256 checksum for integrity verification */
+    checksum: string;
+    /** Whether the backup is gzip compressed */
+    compressed: boolean;
+}
+/**
+ * Result of a restore operation
+ */
+export interface RestoreResult {
+    /** Whether the restore was successful */
+    success: boolean;
+    /** Backup ID or path that was restored from */
+    restoredFrom: string;
+    /** When the restore was performed */
+    timestamp: Date;
+    /** Number of records restored */
+    recordsRestored: number;
+    /** Non-fatal issues encountered during restore */
+    warnings: string[];
+    /** Fatal errors that occurred (empty if success is true) */
+    errors: string[];
+}
+/**
+ * Options for restore operations
+ */
+export interface RecoveryOptions {
+    /** Verify backup integrity before restoring */
+    verifyIntegrity?: boolean;
+    /** Force restore even if integrity check fails */
+    force?: boolean;
+    /** Specific backup ID to restore from */
+    targetBackup?: string;
+}
+/**
+ * Result of a database integrity check
+ */
+export interface IntegrityCheckResult {
+    /** Whether the database passed all integrity checks */
+    valid: boolean;
+    /** Critical errors found */
+    errors: string[];
+    /** Non-critical warnings */
+    warnings: string[];
+    /** Per-table integrity information */
+    tables: TableIntegrity[];
+}
+/**
+ * Integrity information for a single table
+ */
+export interface TableIntegrity {
+    /** Table name */
+    name: string;
+    /** Number of rows in the table */
+    rowCount: number;
+    /** Whether the table passed integrity checks */
+    valid: boolean;
+    /** List of issues found in the table */
+    issues: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/recovery/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/recovery/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,SAAS,EAAE,IAAI,CAAC;IAChB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,SAAS,EAAE,IAAI,CAAC;IAChB,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,KAAK,EAAE,OAAO,CAAC;IACf,4BAA4B;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,sCAAsC;IACtC,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,KAAK,EAAE,OAAO,CAAC;IACf,wCAAwC;IACxC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}