@aquex/cmos-mcp 1.0.0

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

@@ -0,0 +1,359 @@
+"use strict";
+/**
+ * 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
+ */
+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.cmosDbSnapshotToolDefinition = exports.cmosDbSnapshotSchema = void 0;
+exports.cmosDbSnapshot = cmosDbSnapshot;
+exports.formatDbSnapshotForLLM = formatDbSnapshotForLLM;
+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_PREFIX = 'snapshot-';
+const SNAPSHOT_FILE_EXTENSION = '.sqlite';
+const DEFAULT_MAX_SNAPSHOTS = 50;
+/**
+ * Input schema for cmos_db_snapshot.
+ */
+exports.cmosDbSnapshotSchema = zod_1.z.object({
+    /** Optional: list snapshots without creating a new one */
+    listOnly: zod_1.z
+        .boolean()
+        .optional()
+        .describe('If true, return existing snapshots only. If false (default), create a new snapshot first.'),
+    /** Optional: maximum snapshots to retain (oldest removed first) */
+    maxSnapshots: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(500)
+        .optional()
+        .describe('Maximum number of snapshots to keep (default from CMOS_MAX_SNAPSHOTS env or 50). Oldest snapshots are removed first.'),
+    /** 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_snapshot.
+ */
+exports.cmosDbSnapshotToolDefinition = {
+    name: 'cmos_db_snapshot',
+    description: 'Create or list SQLite database snapshots for CMOS safety operations. ' +
+        'Creates timestamped snapshots in cmos/db/snapshots, returns metadata, and enforces configurable retention.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            listOnly: {
+                type: 'boolean',
+                description: 'If true, list existing snapshots only. If false (default), create a new snapshot first.',
+            },
+            maxSnapshots: {
+                type: 'integer',
+                minimum: 1,
+                maximum: 500,
+                description: 'Maximum snapshots to keep (default: CMOS_MAX_SNAPSHOTS env or 50). Oldest are pruned first.',
+            },
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory to search for CMOS database (defaults to cwd)',
+            },
+        },
+        additionalProperties: false,
+    },
+};
+/**
+ * Execute the cmos_db_snapshot tool.
+ *
+ * @param params - Tool parameters
+ * @returns Snapshot metadata or actionable error
+ */
+async function cmosDbSnapshot(params = {}) {
+    const maxSnapshots = resolveMaxSnapshots(params.maxSnapshots);
+    const listOnly = params.listOnly === true;
+    const statsResult = await getDatabaseStats(params.projectRoot);
+    if (!statsResult.success || !statsResult.data) {
+        return (0, errors_1.createError)(statsResult.error ?? {
+            code: 'DB_QUERY_FAILED',
+            message: 'Failed to gather database statistics for snapshot.',
+            suggestion: 'Check database connectivity with cmos_db_health and retry.',
+        });
+    }
+    const stats = statsResult.data;
+    const snapshotDirectory = getSnapshotDirectory(stats.dbPath);
+    ensureDirectory(snapshotDirectory);
+    if (listOnly) {
+        const snapshots = listSnapshots(snapshotDirectory);
+        return (0, errors_1.createSuccess)({
+            mode: 'list',
+            snapshotDirectory,
+            maxSnapshots,
+            snapshots,
+            createdSnapshot: null,
+            missionCount: null,
+            sessionCount: null,
+            prunedSnapshotIds: [],
+            message: `Found ${snapshots.length} snapshot${snapshots.length === 1 ? '' : 's'}.`,
+        });
+    }
+    const snapshotId = generateSnapshotId();
+    const snapshotFilename = `${snapshotId}${SNAPSHOT_FILE_EXTENSION}`;
+    const snapshotPath = path.join(snapshotDirectory, snapshotFilename);
+    try {
+        await backupDatabase(stats.dbPath, snapshotPath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown backup failure';
+        return (0, errors_1.createError)({
+            code: 'SNAPSHOT_CREATION_FAILED',
+            message: `Failed to create database snapshot: ${message}`,
+            suggestion: 'Check filesystem permissions and available disk space.',
+        });
+    }
+    const prunedSnapshotIds = pruneSnapshots(snapshotDirectory, maxSnapshots);
+    const snapshots = listSnapshots(snapshotDirectory);
+    const createdSnapshot = snapshots.find((snapshot) => snapshot.id === snapshotId) ??
+        toSnapshotMetadata(snapshotPath, snapshotFilename);
+    return (0, errors_1.createSuccess)({
+        mode: 'create',
+        snapshotDirectory,
+        maxSnapshots,
+        snapshots,
+        createdSnapshot,
+        missionCount: stats.missionCount,
+        sessionCount: stats.sessionCount,
+        prunedSnapshotIds,
+        message: prunedSnapshotIds.length > 0
+            ? `Snapshot '${snapshotId}' created. Pruned ${prunedSnapshotIds.length} old snapshot${prunedSnapshotIds.length === 1 ? '' : 's'}.`
+            : `Snapshot '${snapshotId}' created successfully.`,
+    });
+}
+/**
+ * Format snapshot results for LLM readability.
+ */
+function formatDbSnapshotForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        const lines = [
+            '❌ Failed to process database snapshot',
+            '',
+            `Error: ${error?.message ?? 'Unknown error'}`,
+        ];
+        if (error?.suggestion) {
+            lines.push('', `Suggestion: ${error.suggestion}`);
+        }
+        return lines.join('\n');
+    }
+    const data = result.data;
+    const lines = [];
+    if (data.mode === 'create' && data.createdSnapshot) {
+        lines.push('✅ Database snapshot created');
+        lines.push('');
+        lines.push(`**Snapshot ID**: ${data.createdSnapshot.id}`);
+        lines.push(`**Path**: ${data.createdSnapshot.path}`);
+        lines.push(`**Created**: ${data.createdSnapshot.createdAt}`);
+        lines.push(`**Size**: ${formatBytes(data.createdSnapshot.sizeBytes)}`);
+        lines.push(`**Mission Count**: ${data.missionCount ?? 0}`);
+        lines.push(`**Session Count**: ${data.sessionCount ?? 0}`);
+    }
+    else {
+        lines.push('📚 Database snapshot inventory');
+        lines.push('');
+        lines.push(`**Snapshots Found**: ${data.snapshots.length}`);
+    }
+    lines.push('');
+    lines.push(`**Snapshot Directory**: ${data.snapshotDirectory}`);
+    lines.push(`**Retention Max**: ${data.maxSnapshots}`);
+    if (data.prunedSnapshotIds.length > 0) {
+        lines.push(`**Pruned**: ${data.prunedSnapshotIds.join(', ')}`);
+    }
+    if (data.snapshots.length === 0) {
+        lines.push('');
+        lines.push('_No snapshots available._');
+    }
+    else {
+        lines.push('');
+        lines.push('**Snapshots (newest first)**:');
+        for (const snapshot of data.snapshots.slice(0, 10)) {
+            lines.push(`- ${snapshot.id} (${snapshot.createdAt}, ${formatBytes(snapshot.sizeBytes)})`);
+        }
+        if (data.snapshots.length > 10) {
+            lines.push(`- ... ${data.snapshots.length - 10} more`);
+        }
+    }
+    lines.push('');
+    lines.push(data.message);
+    return lines.join('\n');
+}
+async function getDatabaseStats(projectRoot) {
+    return (0, client_1.withClient)((client) => {
+        const missionCountResult = client.getOne('SELECT COUNT(*) as count FROM missions');
+        if (!missionCountResult.success) {
+            return (0, errors_1.createError)(missionCountResult.error ?? {
+                code: 'DB_QUERY_FAILED',
+                message: 'Failed to count missions.',
+            });
+        }
+        const sessionCountResult = client.getOne('SELECT COUNT(*) as count FROM sessions');
+        if (!sessionCountResult.success) {
+            return (0, errors_1.createError)(sessionCountResult.error ?? {
+                code: 'DB_QUERY_FAILED',
+                message: 'Failed to count sessions.',
+            });
+        }
+        return (0, errors_1.createSuccess)({
+            dbPath: client.path,
+            missionCount: missionCountResult.data?.count ?? 0,
+            sessionCount: sessionCountResult.data?.count ?? 0,
+        });
+    }, { projectRoot });
+}
+function getSnapshotDirectory(dbPath) {
+    return path.join(path.dirname(dbPath), 'snapshots');
+}
+function ensureDirectory(directoryPath) {
+    fs.mkdirSync(directoryPath, { recursive: true });
+}
+function resolveMaxSnapshots(explicit) {
+    if (explicit !== undefined) {
+        return explicit;
+    }
+    const envValue = process.env.CMOS_MAX_SNAPSHOTS;
+    if (!envValue) {
+        return DEFAULT_MAX_SNAPSHOTS;
+    }
+    const parsed = Number.parseInt(envValue, 10);
+    return Number.isInteger(parsed) && parsed > 0 ? parsed : DEFAULT_MAX_SNAPSHOTS;
+}
+function generateSnapshotId() {
+    const timestamp = new Date()
+        .toISOString()
+        .replace(/[-:]/g, '')
+        .replace(/\.(\d{3})Z$/, '$1Z');
+    const suffix = (0, crypto_1.randomBytes)(2).toString('hex');
+    return `${SNAPSHOT_FILE_PREFIX}${timestamp}-${suffix}`;
+}
+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 pruneSnapshots(snapshotDirectory, maxSnapshots) {
+    const snapshots = listSnapshots(snapshotDirectory);
+    if (snapshots.length <= maxSnapshots) {
+        return [];
+    }
+    const toDelete = snapshots.slice(maxSnapshots);
+    const prunedIds = [];
+    for (const snapshot of toDelete) {
+        try {
+            fs.rmSync(snapshot.path, { force: true });
+            prunedIds.push(snapshot.id);
+        }
+        catch {
+            // Keep operation best-effort; missing file cleanup should not fail snapshot creation.
+        }
+    }
+    return prunedIds;
+}
+function listSnapshots(snapshotDirectory) {
+    if (!fs.existsSync(snapshotDirectory)) {
+        return [];
+    }
+    const entries = fs
+        .readdirSync(snapshotDirectory, { withFileTypes: true })
+        .filter((entry) => entry.isFile())
+        .filter((entry) => entry.name.startsWith(SNAPSHOT_FILE_PREFIX))
+        .filter((entry) => entry.name.endsWith(SNAPSHOT_FILE_EXTENSION));
+    const snapshots = entries.map((entry) => {
+        const snapshotPath = path.join(snapshotDirectory, entry.name);
+        return toSnapshotMetadata(snapshotPath, entry.name);
+    });
+    snapshots.sort((a, b) => {
+        const dateDiff = Date.parse(b.createdAt) - Date.parse(a.createdAt);
+        if (dateDiff !== 0) {
+            return dateDiff;
+        }
+        return b.filename.localeCompare(a.filename);
+    });
+    return snapshots;
+}
+function toSnapshotMetadata(snapshotPath, filename) {
+    const stats = fs.statSync(snapshotPath);
+    const id = filename.endsWith(SNAPSHOT_FILE_EXTENSION)
+        ? filename.slice(0, -SNAPSHOT_FILE_EXTENSION.length)
+        : filename;
+    return {
+        id,
+        filename,
+        path: snapshotPath,
+        sizeBytes: stats.size,
+        createdAt: stats.mtime.toISOString(),
+    };
+}
+function formatBytes(bytes) {
+    if (bytes < 1024) {
+        return `${bytes} B`;
+    }
+    const kb = bytes / 1024;
+    if (kb < 1024) {
+        return `${kb.toFixed(1)} KB`;
+    }
+    const mb = kb / 1024;
+    return `${mb.toFixed(1)} MB`;
+}
+//# sourceMappingURL=cmos-db-snapshot.js.map

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

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

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

@@ -0,0 +1,103 @@
+/**
+ * cmos_db Tool
+ *
+ * Consolidated database admin tool with action parameter support.
+ * Actions: health, snapshot, restore.
+ * Routes to existing DB handlers without rewriting business logic.
+ *
+ * @module tools/cmos/cmos-db
+ */
+import { z } from 'zod';
+import type { CmosToolResult } from './types';
+import { type CmosDbHealthResult } from './cmos-db-health';
+import { type CmosDbSnapshotResult } from './cmos-db-snapshot';
+import { type CmosDbRestoreResult } from './cmos-db-restore';
+import { type CmosDbBackfillResult } from './cmos-db-backfill';
+import { type ReconciliationResult, type PurgeResult, type PgOrphanReport } from './cmos-db-backfill';
+export declare const CMOS_DB_ACTIONS: readonly ["health", "snapshot", "restore", "backfill", "reconcile", "purge", "identify_orphans"];
+export type CmosDbAction = (typeof CMOS_DB_ACTIONS)[number];
+export type CmosDbResult = CmosDbHealthResult | CmosDbSnapshotResult | CmosDbRestoreResult | CmosDbBackfillResult | ReconciliationResult | PurgeResult | PgOrphanReport;
+export declare const cmosDbSchema: z.ZodObject<{
+    action: z.ZodEnum<["health", "snapshot", "restore", "backfill", "reconcile", "purge", "identify_orphans"]>;
+    listOnly: z.ZodOptional<z.ZodBoolean>;
+    maxSnapshots: z.ZodOptional<z.ZodNumber>;
+    snapshotId: z.ZodOptional<z.ZodString>;
+    confirm: z.ZodOptional<z.ZodBoolean>;
+    force: z.ZodOptional<z.ZodBoolean>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+    expectedSlug: z.ZodOptional<z.ZodString>;
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    action: "backfill" | "snapshot" | "health" | "restore" | "reconcile" | "purge" | "identify_orphans";
+    projectRoot?: string | undefined;
+    listOnly?: boolean | undefined;
+    maxSnapshots?: number | undefined;
+    force?: boolean | undefined;
+    snapshotId?: string | undefined;
+    confirm?: boolean | undefined;
+    dryRun?: boolean | undefined;
+    expectedSlug?: string | undefined;
+}, {
+    action: "backfill" | "snapshot" | "health" | "restore" | "reconcile" | "purge" | "identify_orphans";
+    projectRoot?: string | undefined;
+    listOnly?: boolean | undefined;
+    maxSnapshots?: number | undefined;
+    force?: boolean | undefined;
+    snapshotId?: string | undefined;
+    confirm?: boolean | undefined;
+    dryRun?: boolean | undefined;
+    expectedSlug?: string | undefined;
+}>;
+export type CmosDbParams = z.infer<typeof cmosDbSchema>;
+export declare const cmosDbToolDefinition: {
+    readonly name: "cmos_db";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly action: {
+                readonly type: "string";
+                readonly enum: readonly ["health", "snapshot", "restore", "backfill", "reconcile", "purge", "identify_orphans"];
+                readonly description: "Database action: health | snapshot | restore | backfill | reconcile | purge | identify_orphans";
+            };
+            readonly listOnly: {
+                readonly type: "boolean";
+                readonly description: "List snapshots instead of creating one";
+            };
+            readonly maxSnapshots: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly description: "Max snapshots to list";
+            };
+            readonly snapshotId: {
+                readonly type: "string";
+                readonly description: "Snapshot ID for restore action";
+            };
+            readonly confirm: {
+                readonly type: "boolean";
+                readonly description: "Confirmation flag for restore action";
+            };
+            readonly force: {
+                readonly type: "boolean";
+                readonly description: "Force full backfill, ignoring cursor";
+            };
+            readonly dryRun: {
+                readonly type: "boolean";
+                readonly description: "Preview backfill without pushing";
+            };
+            readonly expectedSlug: {
+                readonly type: "string";
+                readonly description: "Expected project slug for guardrail checks on purge";
+            };
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Project root directory to search for CMOS database (defaults to cwd)";
+            };
+        };
+        readonly required: readonly ["action"];
+        readonly additionalProperties: false;
+    };
+};
+export declare function cmosDb(params: CmosDbParams): Promise<CmosToolResult<CmosDbResult>>;
+export declare function formatDbForLLM(action: string | undefined, result: CmosToolResult<CmosDbResult>): string;
+//# sourceMappingURL=cmos-db.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-db.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-db.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,KAAK,oBAAoB,EAGzB,KAAK,WAAW,EAGhB,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,eAAe,kGAQlB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,oBAAoB,GACpB,mBAAmB,GACnB,oBAAoB,GACpB,oBAAoB,GACpB,WAAW,GACX,cAAc,CAAC;AAEnB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCd,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCvB,CAAC;AAMX,wBAAsB,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAgDxF;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,cAAc,CAAC,YAAY,CAAC,GACnC,MAAM,CAyCR"}

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

@@ -0,0 +1,182 @@
+"use strict";
+/**
+ * cmos_db Tool
+ *
+ * Consolidated database admin tool with action parameter support.
+ * Actions: health, snapshot, restore.
+ * Routes to existing DB handlers without rewriting business logic.
+ *
+ * @module tools/cmos/cmos-db
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosDbToolDefinition = exports.cmosDbSchema = exports.CMOS_DB_ACTIONS = void 0;
+exports.cmosDb = cmosDb;
+exports.formatDbForLLM = formatDbForLLM;
+const zod_1 = require("zod");
+const errors_1 = require("./errors");
+const cmos_db_health_1 = require("./cmos-db-health");
+const cmos_db_snapshot_1 = require("./cmos-db-snapshot");
+const cmos_db_restore_1 = require("./cmos-db-restore");
+const cmos_db_backfill_1 = require("./cmos-db-backfill");
+const cmos_db_backfill_2 = require("./cmos-db-backfill");
+exports.CMOS_DB_ACTIONS = [
+    'health',
+    'snapshot',
+    'restore',
+    'backfill',
+    'reconcile',
+    'purge',
+    'identify_orphans',
+];
+exports.cmosDbSchema = zod_1.z
+    .object({
+    action: zod_1.z
+        .enum(exports.CMOS_DB_ACTIONS)
+        .describe('Database action: health | snapshot | restore | backfill | reconcile | purge | identify_orphans'),
+    // snapshot params
+    listOnly: zod_1.z.boolean().optional().describe('List snapshots instead of creating one'),
+    maxSnapshots: zod_1.z.number().int().positive().optional().describe('Max snapshots to list'),
+    // restore params
+    snapshotId: zod_1.z
+        .string()
+        .optional()
+        .describe('Snapshot ID for restore action (required for restore)'),
+    confirm: zod_1.z
+        .boolean()
+        .optional()
+        .describe('Confirmation flag for restore action (required for restore)'),
+    // backfill params
+    force: zod_1.z
+        .boolean()
+        .optional()
+        .describe('Force full backfill, ignoring cursor (for backfill action)'),
+    dryRun: zod_1.z
+        .boolean()
+        .optional()
+        .describe('Preview backfill without pushing (for backfill action)'),
+    expectedSlug: zod_1.z
+        .string()
+        .optional()
+        .describe('Expected project slug for guardrail checks on purge (optional)'),
+    projectRoot: zod_1.z
+        .string()
+        .optional()
+        .describe('Project root directory to search for CMOS database (defaults to cwd)'),
+})
+    .strict();
+exports.cmosDbToolDefinition = {
+    name: 'cmos_db',
+    description: 'Consolidated database admin tool with action parameter support. ' +
+        'Actions: health, snapshot, restore, backfill, reconcile, purge, identify_orphans. ' +
+        'Routes to the existing DB handlers without changing DB business logic.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                enum: [...exports.CMOS_DB_ACTIONS],
+                description: 'Database action: health | snapshot | restore | backfill | reconcile | purge | identify_orphans',
+            },
+            listOnly: { type: 'boolean', description: 'List snapshots instead of creating one' },
+            maxSnapshots: { type: 'number', minimum: 1, description: 'Max snapshots to list' },
+            snapshotId: { type: 'string', description: 'Snapshot ID for restore action' },
+            confirm: { type: 'boolean', description: 'Confirmation flag for restore action' },
+            force: { type: 'boolean', description: 'Force full backfill, ignoring cursor' },
+            dryRun: { type: 'boolean', description: 'Preview backfill without pushing' },
+            expectedSlug: {
+                type: 'string',
+                description: 'Expected project slug for guardrail checks on purge',
+            },
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory to search for CMOS database (defaults to cwd)',
+            },
+        },
+        required: ['action'],
+        additionalProperties: false,
+    },
+};
+function isDbAction(value) {
+    return exports.CMOS_DB_ACTIONS.includes(value);
+}
+async function cmosDb(params) {
+    const actionValue = typeof params.action === 'string' ? params.action : '';
+    if (!isDbAction(actionValue)) {
+        return (0, errors_1.createError)(errors_1.CmosErrors.invalidAction('cmos_db', actionValue, exports.CMOS_DB_ACTIONS));
+    }
+    switch (actionValue) {
+        case 'health':
+            return (0, cmos_db_health_1.cmosDbHealth)({
+                projectRoot: params.projectRoot,
+            });
+        case 'snapshot':
+            return (0, cmos_db_snapshot_1.cmosDbSnapshot)({
+                listOnly: params.listOnly,
+                maxSnapshots: params.maxSnapshots,
+                projectRoot: params.projectRoot,
+            });
+        case 'restore':
+            return (0, cmos_db_restore_1.cmosDbRestore)({
+                snapshotId: params.snapshotId ?? '',
+                confirm: params.confirm ?? false,
+                projectRoot: params.projectRoot,
+            });
+        case 'backfill':
+            return (0, cmos_db_backfill_1.cmosDbBackfill)({
+                force: params.force,
+                dryRun: params.dryRun,
+                projectRoot: params.projectRoot,
+            });
+        case 'reconcile':
+            return (0, cmos_db_backfill_2.cmosDbReconcile)({
+                projectRoot: params.projectRoot,
+            });
+        case 'purge':
+            return (0, cmos_db_backfill_2.cmosDbPurge)({
+                confirm: params.confirm,
+                expectedSlug: params.expectedSlug,
+                projectRoot: params.projectRoot,
+            });
+        case 'identify_orphans':
+            return (0, cmos_db_backfill_2.identifyPgOrphans)({
+                projectRoot: params.projectRoot,
+            });
+    }
+}
+function formatDbForLLM(action, result) {
+    if (!result.success && result.error?.code === 'INVALID_ACTION') {
+        const availableActions = result.error.availableActions ??
+            result.error.available_actions ??
+            result.error.validValues ??
+            [];
+        const lines = ['❌ Failed to execute cmos_db', '', `Error: ${result.error.message}`];
+        if (availableActions.length > 0) {
+            lines.push('');
+            lines.push(`Available actions: ${availableActions.join(', ')}`);
+        }
+        if (result.error.suggestion) {
+            lines.push('');
+            lines.push(`Suggestion: ${result.error.suggestion}`);
+        }
+        return lines.join('\n');
+    }
+    switch (action) {
+        case 'health':
+            return (0, cmos_db_health_1.formatHealthForLLM)(result);
+        case 'snapshot':
+            return (0, cmos_db_snapshot_1.formatDbSnapshotForLLM)(result);
+        case 'restore':
+            return (0, cmos_db_restore_1.formatDbRestoreForLLM)(result);
+        case 'backfill':
+            return (0, cmos_db_backfill_1.formatBackfillForLLM)(result);
+        case 'reconcile':
+            return (0, cmos_db_backfill_2.formatReconciliationForLLM)(result);
+        case 'purge':
+            return (0, cmos_db_backfill_2.formatPurgeForLLM)(result);
+        case 'identify_orphans':
+            return (0, cmos_db_backfill_2.formatPgOrphanReportForLLM)(result);
+        default:
+            return result.success ? '✓ Database action completed' : '❌ Failed to execute cmos_db';
+    }
+}
+//# sourceMappingURL=cmos-db.js.map