@aquex/cmos-mcp 1.0.0

package/dist/tools/cmos/cmos-db-restore.js

@@ -0,0 +1,359 @@
+"use strict";
+/**
+ * cmos_db_restore Tool
+ *
+ * MCP tool for restoring the active CMOS SQLite database from a named snapshot.
+ * This operation is destructive and requires explicit confirmation.
+ *
+ * @module tools/cmos/cmos-db-restore
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosDbRestoreToolDefinition = exports.cmosDbRestoreSchema = void 0;
+exports.cmosDbRestore = cmosDbRestore;
+exports.formatDbRestoreForLLM = formatDbRestoreForLLM;
+const crypto_1 = require("crypto");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const zod_1 = require("zod");
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+const SNAPSHOT_FILE_EXTENSION = '.sqlite';
+const PRE_RESTORE_BACKUP_PREFIX = 'pre-restore-';
+const REQUIRED_TABLES = ['missions', 'sessions', 'contexts'];
+/**
+ * Input schema for cmos_db_restore.
+ */
+exports.cmosDbRestoreSchema = zod_1.z.object({
+    /** Snapshot identifier (from cmos_db_snapshot output) */
+    snapshotId: zod_1.z
+        .string()
+        .min(1)
+        .describe('Snapshot ID to restore from. Use cmos_db_snapshot(listOnly=true) to list snapshots.'),
+    /** Explicit confirmation required for destructive restore */
+    confirm: zod_1.z
+        .boolean()
+        .describe('Must be true to proceed. Restore is destructive and replaces the active cmos.sqlite database.'),
+    /** Optional: explicit project root to search from */
+    projectRoot: zod_1.z
+        .string()
+        .optional()
+        .describe('Project root directory to search for CMOS database (defaults to cwd)'),
+});
+/**
+ * MCP Tool Definition for cmos_db_restore.
+ */
+exports.cmosDbRestoreToolDefinition = {
+    name: 'cmos_db_restore',
+    description: 'Restore the active CMOS SQLite database from a named snapshot. ' +
+        'Creates an automatic pre-restore backup, validates snapshot schema, and requires explicit confirmation.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            snapshotId: {
+                type: 'string',
+                description: 'Snapshot ID to restore from. Use cmos_db_snapshot(listOnly=true) to view available snapshots.',
+                minLength: 1,
+            },
+            confirm: {
+                type: 'boolean',
+                description: 'Must be true to proceed. Restore is destructive and replaces the active database.',
+            },
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory to search for CMOS database (defaults to cwd)',
+            },
+        },
+        required: ['snapshotId', 'confirm'],
+        additionalProperties: false,
+    },
+};
+/**
+ * Execute the cmos_db_restore tool.
+ *
+ * @param params - Tool parameters
+ * @returns Restore status or actionable error
+ */
+async function cmosDbRestore(params) {
+    if (params.confirm !== true) {
+        return (0, errors_1.createError)({
+            code: errors_1.CMOS_ERROR_CODES.INVALID_PARAMETER,
+            message: 'Restore is destructive and requires confirm=true.',
+            field: 'confirm',
+            providedValue: params.confirm,
+            suggestion: 'Retry with confirm=true after verifying the snapshotId.',
+        });
+    }
+    const snapshotId = params.snapshotId.trim();
+    if (!snapshotId) {
+        return (0, errors_1.createError)(errors_1.CmosErrors.missingParameter('snapshotId'));
+    }
+    if (snapshotId.includes('/') || snapshotId.includes('\\')) {
+        return (0, errors_1.createError)({
+            code: errors_1.CMOS_ERROR_CODES.INVALID_PARAMETER,
+            message: 'snapshotId must be a filename or snapshot ID, not a path.',
+            field: 'snapshotId',
+            providedValue: params.snapshotId,
+            suggestion: 'Use cmos_db_snapshot(listOnly=true) and pass one of the listed snapshot IDs.',
+        });
+    }
+    const dbPathResult = await resolveDbPath(params.projectRoot);
+    if (!dbPathResult.success || !dbPathResult.data) {
+        return (0, errors_1.createError)(dbPathResult.error ?? {
+            code: 'DB_CONNECTION_FAILED',
+            message: 'Failed to resolve active CMOS database path.',
+            suggestion: 'Check projectRoot or run cmos_db_health for diagnostics.',
+        });
+    }
+    const dbPath = dbPathResult.data.dbPath;
+    const snapshotDirectory = path.join(path.dirname(dbPath), 'snapshots');
+    const preRestoreBackupDirectory = path.join(snapshotDirectory, 'pre-restore');
+    fs.mkdirSync(preRestoreBackupDirectory, { recursive: true });
+    const resolvedSnapshotPath = resolveSnapshotPath(snapshotDirectory, snapshotId);
+    if (!resolvedSnapshotPath) {
+        return (0, errors_1.createError)(errors_1.CmosErrors.snapshotNotFound(snapshotId));
+    }
+    const validationError = validateSnapshotDatabase(resolvedSnapshotPath);
+    if (validationError) {
+        return (0, errors_1.createError)(validationError);
+    }
+    const backupId = generatePreRestoreBackupId();
+    const backupPath = path.join(preRestoreBackupDirectory, `${backupId}${SNAPSHOT_FILE_EXTENSION}`);
+    try {
+        await backupDatabase(dbPath, backupPath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown backup failure';
+        return (0, errors_1.createError)({
+            code: errors_1.CMOS_ERROR_CODES.SNAPSHOT_RESTORE_FAILED,
+            message: `Failed to create pre-restore backup: ${message}`,
+            suggestion: 'Check disk space and filesystem permissions before retrying restore.',
+        });
+    }
+    try {
+        replaceActiveDatabase(dbPath, resolvedSnapshotPath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown restore failure';
+        return (0, errors_1.createError)({
+            code: errors_1.CMOS_ERROR_CODES.SNAPSHOT_RESTORE_FAILED,
+            message: `Failed to replace active database: ${message}`,
+            suggestion: `Pre-restore backup saved at '${backupPath}'.`,
+        });
+    }
+    const verificationResult = await verifyRestoredDatabase(dbPath);
+    if (!verificationResult.success || !verificationResult.data) {
+        const rollbackMessage = attemptRollback(backupPath, dbPath);
+        return (0, errors_1.createError)({
+            code: errors_1.CMOS_ERROR_CODES.SNAPSHOT_RESTORE_FAILED,
+            message: verificationResult.error?.message ??
+                'Restore verification failed. The database may not be a valid CMOS schema.',
+            suggestion: `${rollbackMessage} Inspect snapshot integrity and retry restore.`,
+        });
+    }
+    const restoredAt = new Date().toISOString();
+    return (0, errors_1.createSuccess)({
+        snapshotId: normalizeSnapshotId(resolvedSnapshotPath),
+        snapshotPath: resolvedSnapshotPath,
+        backupId,
+        backupPath,
+        restoredAt,
+        missionCount: verificationResult.data.missionCount,
+        sessionCount: verificationResult.data.sessionCount,
+        contextCount: verificationResult.data.contextCount,
+        message: `Database restored from snapshot '${normalizeSnapshotId(resolvedSnapshotPath)}'.`,
+    });
+}
+/**
+ * Format restore result for LLM readability.
+ */
+function formatDbRestoreForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        const lines = [
+            '❌ Failed to restore database snapshot',
+            '',
+            `Error: ${error?.message ?? 'Unknown error'}`,
+        ];
+        if (error?.suggestion) {
+            lines.push('', `Suggestion: ${error.suggestion}`);
+        }
+        return lines.join('\n');
+    }
+    const data = result.data;
+    return [
+        '✅ Database restore complete',
+        '',
+        `**Snapshot ID**: ${data.snapshotId}`,
+        `**Snapshot Path**: ${data.snapshotPath}`,
+        `**Pre-Restore Backup**: ${data.backupPath}`,
+        `**Restored At**: ${data.restoredAt}`,
+        '',
+        '**Post-Restore Counts**:',
+        `- Missions: ${data.missionCount}`,
+        `- Sessions: ${data.sessionCount}`,
+        `- Contexts: ${data.contextCount}`,
+        '',
+        data.message,
+    ].join('\n');
+}
+async function resolveDbPath(projectRoot) {
+    return (0, client_1.withClient)((client) => (0, errors_1.createSuccess)({
+        dbPath: client.path,
+    }), { projectRoot });
+}
+function resolveSnapshotPath(snapshotDirectory, snapshotId) {
+    const normalized = path.basename(snapshotId);
+    const candidates = normalized.endsWith(SNAPSHOT_FILE_EXTENSION)
+        ? [normalized]
+        : [`${normalized}${SNAPSHOT_FILE_EXTENSION}`, normalized];
+    for (const candidate of candidates) {
+        const candidatePath = path.join(snapshotDirectory, candidate);
+        if (fs.existsSync(candidatePath) && fs.statSync(candidatePath).isFile()) {
+            return candidatePath;
+        }
+    }
+    return null;
+}
+function normalizeSnapshotId(snapshotPath) {
+    const filename = path.basename(snapshotPath);
+    return filename.endsWith(SNAPSHOT_FILE_EXTENSION)
+        ? filename.slice(0, -SNAPSHOT_FILE_EXTENSION.length)
+        : filename;
+}
+function validateSnapshotDatabase(snapshotPath) {
+    let db = null;
+    try {
+        db = new better_sqlite3_1.default(snapshotPath, { readonly: true, fileMustExist: true });
+        const tableRows = db
+            .prepare("SELECT name FROM sqlite_master WHERE type = 'table'")
+            .all();
+        const tableSet = new Set(tableRows.map((row) => row.name));
+        const missingTables = REQUIRED_TABLES.filter((table) => !tableSet.has(table));
+        if (missingTables.length > 0) {
+            return {
+                code: errors_1.CMOS_ERROR_CODES.DB_SCHEMA_MISMATCH,
+                message: `Snapshot is not a valid CMOS database. Missing tables: ${missingTables.join(', ')}`,
+                suggestion: 'Use cmos_db_snapshot to create a valid snapshot from a CMOS database.',
+            };
+        }
+        const integrityCheck = db.pragma('integrity_check', { simple: true });
+        if (integrityCheck !== 'ok') {
+            return {
+                code: errors_1.CMOS_ERROR_CODES.DB_SCHEMA_MISMATCH,
+                message: `Snapshot integrity check failed: ${integrityCheck}`,
+                suggestion: 'Select a different snapshot or recreate snapshots from a healthy database.',
+            };
+        }
+        return null;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown SQLite error';
+        return {
+            code: errors_1.CMOS_ERROR_CODES.DB_SCHEMA_MISMATCH,
+            message: `Snapshot validation failed: ${message}`,
+            suggestion: 'Ensure snapshot file exists and is a readable SQLite database.',
+        };
+    }
+    finally {
+        db?.close();
+    }
+}
+async function backupDatabase(sourcePath, destinationPath) {
+    if (fs.existsSync(destinationPath)) {
+        fs.rmSync(destinationPath, { force: true });
+    }
+    const db = new better_sqlite3_1.default(sourcePath, { readonly: true, fileMustExist: true });
+    try {
+        await db.backup(destinationPath);
+    }
+    finally {
+        db.close();
+    }
+}
+function replaceActiveDatabase(activeDbPath, snapshotPath) {
+    const tempPath = `${activeDbPath}.restore-${Date.now()}-${(0, crypto_1.randomBytes)(2).toString('hex')}`;
+    try {
+        fs.copyFileSync(snapshotPath, tempPath);
+        fs.renameSync(tempPath, activeDbPath);
+        cleanupWalFiles(activeDbPath);
+    }
+    finally {
+        if (fs.existsSync(tempPath)) {
+            fs.rmSync(tempPath, { force: true });
+        }
+    }
+}
+async function verifyRestoredDatabase(dbPath) {
+    return (0, client_1.withClient)((client) => {
+        const healthResult = client.health();
+        if (!healthResult.success || !healthResult.data) {
+            return healthResult;
+        }
+        return (0, errors_1.createSuccess)({
+            missionCount: healthResult.data.missionCount,
+            sessionCount: healthResult.data.sessionCount,
+            contextCount: healthResult.data.contextCount,
+        });
+    }, { dbPath });
+}
+function cleanupWalFiles(dbPath) {
+    fs.rmSync(`${dbPath}-wal`, { force: true });
+    fs.rmSync(`${dbPath}-shm`, { force: true });
+}
+function attemptRollback(backupPath, dbPath) {
+    try {
+        fs.copyFileSync(backupPath, dbPath);
+        cleanupWalFiles(dbPath);
+        return `Restore verification failed; rolled back from '${backupPath}'.`;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown rollback failure';
+        return `Restore verification failed and rollback also failed: ${message}.`;
+    }
+}
+function generatePreRestoreBackupId() {
+    const timestamp = new Date()
+        .toISOString()
+        .replace(/[-:]/g, '')
+        .replace(/\.(\d{3})Z$/, '$1Z');
+    const suffix = (0, crypto_1.randomBytes)(2).toString('hex');
+    return `${PRE_RESTORE_BACKUP_PREFIX}${timestamp}-${suffix}`;
+}
+//# sourceMappingURL=cmos-db-restore.js.map

package/dist/tools/cmos/cmos-db-restore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-db-restore.js","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-db-restore.ts"],"names":[],"mappings":"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"}

package/dist/tools/cmos/cmos-db-snapshot.d.ts

@@ -0,0 +1,108 @@
+/**
+ * cmos_db_snapshot Tool
+ *
+ * MCP tool for creating and listing SQLite database snapshots.
+ * Snapshots are stored in cmos/db/snapshots and can be restored
+ * later with cmos_db_restore.
+ *
+ * @module tools/cmos/cmos-db-snapshot
+ */
+import { z } from 'zod';
+import type { CmosToolResult } from './types';
+/**
+ * Snapshot metadata.
+ */
+export interface DbSnapshotMetadata {
+    /** Snapshot identifier (filename without extension) */
+    id: string;
+    /** Snapshot filename */
+    filename: string;
+    /** Absolute snapshot file path */
+    path: string;
+    /** Snapshot file size in bytes */
+    sizeBytes: number;
+    /** Snapshot creation timestamp */
+    createdAt: string;
+}
+/**
+ * Result payload for cmos_db_snapshot.
+ */
+export interface CmosDbSnapshotResult {
+    /** Operation mode */
+    mode: 'create' | 'list';
+    /** Snapshot storage directory */
+    snapshotDirectory: string;
+    /** Maximum retained snapshots */
+    maxSnapshots: number;
+    /** Available snapshots (newest first) */
+    snapshots: DbSnapshotMetadata[];
+    /** Created snapshot (create mode only) */
+    createdSnapshot: DbSnapshotMetadata | null;
+    /** Mission count captured at snapshot creation */
+    missionCount: number | null;
+    /** Session count captured at snapshot creation */
+    sessionCount: number | null;
+    /** Snapshot IDs pruned by retention */
+    prunedSnapshotIds: string[];
+    /** Human-readable summary */
+    message: string;
+}
+/**
+ * Input schema for cmos_db_snapshot.
+ */
+export declare const cmosDbSnapshotSchema: z.ZodObject<{
+    /** Optional: list snapshots without creating a new one */
+    listOnly: z.ZodOptional<z.ZodBoolean>;
+    /** Optional: maximum snapshots to retain (oldest removed first) */
+    maxSnapshots: z.ZodOptional<z.ZodNumber>;
+    /** Optional: explicit project root to search from */
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    projectRoot?: string | undefined;
+    listOnly?: boolean | undefined;
+    maxSnapshots?: number | undefined;
+}, {
+    projectRoot?: string | undefined;
+    listOnly?: boolean | undefined;
+    maxSnapshots?: number | undefined;
+}>;
+export type CmosDbSnapshotParams = z.infer<typeof cmosDbSnapshotSchema>;
+/**
+ * MCP Tool Definition for cmos_db_snapshot.
+ */
+export declare const cmosDbSnapshotToolDefinition: {
+    readonly name: "cmos_db_snapshot";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly listOnly: {
+                readonly type: "boolean";
+                readonly description: "If true, list existing snapshots only. If false (default), create a new snapshot first.";
+            };
+            readonly maxSnapshots: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 500;
+                readonly description: "Maximum snapshots to keep (default: CMOS_MAX_SNAPSHOTS env or 50). Oldest are pruned first.";
+            };
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Project root directory to search for CMOS database (defaults to cwd)";
+            };
+        };
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * Execute the cmos_db_snapshot tool.
+ *
+ * @param params - Tool parameters
+ * @returns Snapshot metadata or actionable error
+ */
+export declare function cmosDbSnapshot(params?: CmosDbSnapshotParams): Promise<CmosToolResult<CmosDbSnapshotResult>>;
+/**
+ * Format snapshot results for LLM readability.
+ */
+export declare function formatDbSnapshotForLLM(result: CmosToolResult<CmosDbSnapshotResult>): string;
+//# sourceMappingURL=cmos-db-snapshot.d.ts.map

package/dist/tools/cmos/cmos-db-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-db-snapshot.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-db-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAO9C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IAEX,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IAEb,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAElB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,qBAAqB;IACrB,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAExB,iCAAiC;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAE1B,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;IAErB,yCAAyC;IACzC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAEhC,0CAA0C;IAC1C,eAAe,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAE3C,kDAAkD;IAClD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B,kDAAkD;IAClD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B,uCAAuC;IACvC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAE5B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAQD;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAC/B,0DAA0D;;IAQ1D,mEAAmE;;IAWnE,qDAAqD;;;;;;;;;;EAKrD,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;CA2B/B,CAAC;AAEX;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,MAAM,GAAE,oBAAyB,GAChC,OAAO,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,CAqE/C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,CAAC,oBAAoB,CAAC,GAAG,MAAM,CA0D3F"}