@aquex/cmos-mcp 1.0.0

package/dist/tools/cmos/cmos-project-list.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * cmos_project_list Tool
+ *
+ * MCP tool for listing registered CMOS projects.
+ * Returns project summaries with status indicators.
+ *
+ * @module tools/cmos/cmos-project-list
+ */
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosProjectListToolDefinition = exports.cmosProjectListSchema = void 0;
+exports.cmosProjectList = cmosProjectList;
+exports.formatProjectListForLLM = formatProjectListForLLM;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const zod_1 = require("zod");
+const project_registry_1 = require("../../intelligence/project-registry");
+const errors_1 = require("./errors");
+/**
+ * Input parameters schema for cmos_project_list tool.
+ */
+exports.cmosProjectListSchema = zod_1.z.object({});
+/**
+ * MCP Tool Definition for cmos_project_list.
+ */
+exports.cmosProjectListToolDefinition = {
+    name: 'cmos_project_list',
+    description: 'List all registered CMOS projects. ' +
+        'Returns project paths, names, and default status. ' +
+        'Use cmos_project_validate to check project health.',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        additionalProperties: false,
+    },
+};
+/**
+ * Execute the cmos_project_list tool.
+ *
+ * @param _params - Tool parameters (unused)
+ * @returns CmosToolResult with project list or error
+ */
+async function cmosProjectList(_params) {
+    try {
+        const registry = await project_registry_1.ProjectRegistry.create();
+        const projects = await registry.list();
+        const defaultProject = await registry.getDefault();
+        const items = projects.map((project) => ({
+            projectRoot: project.projectRoot,
+            name: project.name ?? project.projectRoot,
+            isDefault: project.projectRoot === defaultProject?.projectRoot,
+            dbExists: fs.existsSync(path.join(project.projectRoot, 'cmos', 'db', 'cmos.sqlite')),
+            registeredAt: project.registeredAt,
+            lastAccessedAt: project.lastAccessedAt,
+        }));
+        const missingCount = items.filter((p) => !p.dbExists).length;
+        return (0, errors_1.createSuccess)({
+            projects: items,
+            missingCount,
+            summary: {
+                total: items.length,
+            },
+            registryPath: registry.path,
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return (0, errors_1.createError)({
+            code: 'DB_CONNECTION_FAILED',
+            message: `Failed to list projects: ${message}`,
+            suggestion: 'Check registry file permissions',
+        });
+    }
+}
+/**
+ * Format project list result for LLM readability.
+ *
+ * @param result - Project list result
+ * @returns Human-readable summary
+ */
+function formatProjectListForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        const lines = ['❌ Failed to list projects', '', `Error: ${error?.message ?? 'Unknown error'}`];
+        if (error?.suggestion) {
+            lines.push('');
+            lines.push(`Suggestion: ${error.suggestion}`);
+        }
+        return lines.join('\n');
+    }
+    const data = result.data;
+    const lines = [];
+    if (data.projects.length === 0) {
+        lines.push('📋 No projects registered');
+        lines.push('');
+        lines.push('Use cmos_project_register to add a project.');
+    }
+    else {
+        const header = data.missingCount > 0
+            ? `📋 Registered Projects (${data.summary.total}, ${data.missingCount} missing)`
+            : `📋 Registered Projects (${data.summary.total})`;
+        lines.push(header);
+        lines.push('');
+        for (const project of data.projects) {
+            const defaultMarker = project.isDefault ? ' (default)' : '';
+            const missingMarker = project.dbExists ? '' : ' [MISSING]';
+            lines.push(`   ${project.name}${defaultMarker}${missingMarker}`);
+            lines.push(`   └─ ${project.projectRoot}`);
+            lines.push('');
+        }
+        if (data.missingCount > 0) {
+            lines.push('Tip: Run cmos_project(action="prune") to remove missing entries.');
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=cmos-project-list.js.map

package/dist/tools/cmos/cmos-project-list.js.map

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

package/dist/tools/cmos/cmos-project-register.d.ts

@@ -0,0 +1,90 @@
+/**
+ * cmos_project_register Tool
+ *
+ * MCP tool for registering a CMOS project in the persistent registry.
+ * Validates CMOS presence before registration.
+ *
+ * @module tools/cmos/cmos-project-register
+ */
+import { z } from 'zod';
+import type { CmosToolResult } from './types';
+/**
+ * Result type for cmos_project_register.
+ */
+export interface ProjectRegisterResult {
+    /** Project path that was registered */
+    projectRoot: string;
+    /** Display name of the project */
+    name: string;
+    /** Whether this project is now the default */
+    isDefault: boolean;
+    /** Whether project was already registered (updated) */
+    wasAlreadyRegistered: boolean;
+    /** Registration timestamp */
+    registeredAt: string;
+    /** Whether empty metadata was auto-populated */
+    metadataRepaired: boolean;
+    /** Confirmation message */
+    message: string;
+}
+/**
+ * Input parameters schema for cmos_project_register tool.
+ */
+export declare const cmosProjectRegisterSchema: z.ZodObject<{
+    /** Absolute path to project root */
+    projectRoot: z.ZodString;
+    /** Optional display name for the project */
+    name: z.ZodOptional<z.ZodString>;
+    /** Whether to set this project as the default */
+    setAsDefault: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    projectRoot: string;
+    name?: string | undefined;
+    setAsDefault?: boolean | undefined;
+}, {
+    projectRoot: string;
+    name?: string | undefined;
+    setAsDefault?: boolean | undefined;
+}>;
+export type CmosProjectRegisterParams = z.infer<typeof cmosProjectRegisterSchema>;
+/**
+ * MCP Tool Definition for cmos_project_register.
+ */
+export declare const cmosProjectRegisterToolDefinition: {
+    readonly name: "cmos_project_register";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Absolute path to the project root directory";
+            };
+            readonly name: {
+                readonly type: "string";
+                readonly description: "Optional display name for the project";
+            };
+            readonly setAsDefault: {
+                readonly type: "boolean";
+                readonly description: "Set this project as the default (for Claude Desktop fallback)";
+            };
+        };
+        readonly required: readonly ["projectRoot"];
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * Execute the cmos_project_register tool.
+ *
+ * @param params - Tool parameters
+ * @returns CmosToolResult with registered project or actionable error
+ */
+export declare function cmosProjectRegister(params: CmosProjectRegisterParams): Promise<CmosToolResult<ProjectRegisterResult>>;
+/**
+ * Format project register result for LLM readability.
+ *
+ * @param result - Project register result
+ * @returns Human-readable summary
+ */
+export declare function formatProjectRegisterForLLM(result: CmosToolResult<ProjectRegisterResult>): string;
+//# sourceMappingURL=cmos-project-register.d.ts.map

package/dist/tools/cmos/cmos-project-register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-project-register.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-project-register.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9C;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IAEpB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IAEb,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IAEnB,uDAAuD;IACvD,oBAAoB,EAAE,OAAO,CAAC;IAE9B,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAC;IAErB,gDAAgD;IAChD,gBAAgB,EAAE,OAAO,CAAC;IAE1B,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB;IACpC,oCAAoC;;IAGpC,4CAA4C;;IAG5C,iDAAiD;;;;;;;;;;EAKjD,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;CAyBpC,CAAC;AAEX;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC,CAsFhD;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,cAAc,CAAC,qBAAqB,CAAC,GAAG,MAAM,CA2BjG"}

package/dist/tools/cmos/cmos-project-register.js

@@ -0,0 +1,199 @@
+"use strict";
+/**
+ * cmos_project_register Tool
+ *
+ * MCP tool for registering a CMOS project in the persistent registry.
+ * Validates CMOS presence before registration.
+ *
+ * @module tools/cmos/cmos-project-register
+ */
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosProjectRegisterToolDefinition = exports.cmosProjectRegisterSchema = void 0;
+exports.cmosProjectRegister = cmosProjectRegister;
+exports.formatProjectRegisterForLLM = formatProjectRegisterForLLM;
+const path = __importStar(require("path"));
+const zod_1 = require("zod");
+const project_registry_1 = require("../../intelligence/project-registry");
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+/**
+ * Input parameters schema for cmos_project_register tool.
+ */
+exports.cmosProjectRegisterSchema = zod_1.z.object({
+    /** Absolute path to project root */
+    projectRoot: zod_1.z.string().min(1).describe('Absolute path to the project root directory'),
+    /** Optional display name for the project */
+    name: zod_1.z.string().optional().describe('Optional display name for the project'),
+    /** Whether to set this project as the default */
+    setAsDefault: zod_1.z
+        .boolean()
+        .optional()
+        .describe('Set this project as the default (for Claude Desktop fallback)'),
+});
+/**
+ * MCP Tool Definition for cmos_project_register.
+ */
+exports.cmosProjectRegisterToolDefinition = {
+    name: 'cmos_project_register',
+    description: 'Register a CMOS project in the persistent registry. ' +
+        'Validates that the project has a CMOS database (cmos/db/cmos.sqlite). ' +
+        'Optionally set as default project for Claude Desktop fallback.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            projectRoot: {
+                type: 'string',
+                description: 'Absolute path to the project root directory',
+            },
+            name: {
+                type: 'string',
+                description: 'Optional display name for the project',
+            },
+            setAsDefault: {
+                type: 'boolean',
+                description: 'Set this project as the default (for Claude Desktop fallback)',
+            },
+        },
+        required: ['projectRoot'],
+        additionalProperties: false,
+    },
+};
+/**
+ * Execute the cmos_project_register tool.
+ *
+ * @param params - Tool parameters
+ * @returns CmosToolResult with registered project or actionable error
+ */
+async function cmosProjectRegister(params) {
+    const { projectRoot, name, setAsDefault } = params;
+    // Validate required parameters
+    if (!projectRoot || projectRoot.trim() === '') {
+        return (0, errors_1.createError)(errors_1.CmosErrors.missingParameter('projectRoot'));
+    }
+    try {
+        const registry = await project_registry_1.ProjectRegistry.create();
+        const result = await registry.register(projectRoot, {
+            name,
+            setAsDefault,
+        });
+        if (!result.success) {
+            return (0, errors_1.createError)({
+                code: 'CMOS_NOT_DETECTED',
+                message: result.message,
+                suggestion: 'Ensure the project has a cmos/db/cmos.sqlite file',
+            });
+        }
+        // Check if this is the default
+        const defaultProject = await registry.getDefault();
+        const isDefault = defaultProject?.projectRoot === result.project?.projectRoot;
+        // Auto-populate empty metadata in the SQLite DB
+        const projectName = result.project.name ?? path.basename(result.project.projectRoot);
+        let metadataRepaired = false;
+        try {
+            const repairResult = await (0, client_1.withClientAsync)(async (db) => {
+                const pidResult = db.getOne(`SELECT value FROM metadata WHERE key = 'project_id'`);
+                const pnameResult = db.getOne(`SELECT value FROM metadata WHERE key = 'project_name'`);
+                const hasId = pidResult.success && pidResult.data?.value;
+                const hasName = pnameResult.success && pnameResult.data?.value;
+                if (!hasId || !hasName) {
+                    const derivedId = projectName.toLowerCase().replace(/\s+/g, '-');
+                    if (!hasId) {
+                        db.execute(`INSERT OR REPLACE INTO metadata (key, value) VALUES ('project_id', ?)`, [
+                            derivedId,
+                        ]);
+                    }
+                    if (!hasName) {
+                        db.execute(`INSERT OR REPLACE INTO metadata (key, value) VALUES ('project_name', ?)`, [projectName]);
+                    }
+                    return (0, errors_1.createSuccess)({ repaired: true });
+                }
+                return (0, errors_1.createSuccess)({ repaired: false });
+            }, { projectRoot: result.project.projectRoot });
+            metadataRepaired = repairResult.success && repairResult.data?.repaired === true;
+        }
+        catch {
+            // Non-critical — metadata repair is best-effort
+        }
+        return (0, errors_1.createSuccess)({
+            projectRoot: result.project.projectRoot,
+            name: result.project.name ?? result.project.projectRoot,
+            isDefault,
+            wasAlreadyRegistered: result.wasAlreadyRegistered ?? false,
+            registeredAt: result.project.registeredAt,
+            metadataRepaired,
+            message: result.message + (metadataRepaired ? ' (project metadata auto-populated)' : ''),
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return (0, errors_1.createError)({
+            code: 'DB_CONNECTION_FAILED',
+            message: `Failed to register project: ${message}`,
+            suggestion: 'Check that the path exists and is accessible',
+        });
+    }
+}
+/**
+ * Format project register result for LLM readability.
+ *
+ * @param result - Project register result
+ * @returns Human-readable summary
+ */
+function formatProjectRegisterForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        const lines = [
+            '❌ Failed to register project',
+            '',
+            `Error: ${error?.message ?? 'Unknown error'}`,
+        ];
+        if (error?.suggestion) {
+            lines.push('');
+            lines.push(`Suggestion: ${error.suggestion}`);
+        }
+        return lines.join('\n');
+    }
+    const data = result.data;
+    const lines = [
+        data.wasAlreadyRegistered ? '✓ Project registration updated' : '✓ Project registered',
+        '',
+        `   Path: ${data.projectRoot}`,
+        `   Name: ${data.name}`,
+        `   Default: ${data.isDefault ? 'Yes' : 'No'}`,
+    ];
+    return lines.join('\n');
+}
+//# sourceMappingURL=cmos-project-register.js.map

package/dist/tools/cmos/cmos-project-register.js.map

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

package/dist/tools/cmos/cmos-project-sweep.d.ts

@@ -0,0 +1,34 @@
+import { ProjectRegistry } from '../../intelligence/project-registry';
+import type { CmosToolResult } from './types';
+export interface SweepItem {
+    readonly instance_id: string;
+    readonly path: string;
+    readonly item_type: 'mission' | 'session';
+    readonly id: string;
+    readonly summary: string;
+    readonly status: string;
+    readonly sprint_id: string | null;
+}
+export interface SweepGroup {
+    readonly instance_id: string;
+    readonly path: string;
+    readonly items: SweepItem[];
+}
+export interface SweepResult {
+    readonly items: SweepItem[];
+    readonly groups: SweepGroup[];
+    readonly warnings: string[];
+    readonly instances_scanned: number;
+    readonly instances_skipped: number;
+}
+export interface SweepParams {
+    /** Restrict to these registry names only */
+    readonly instances?: string[];
+    /** Restrict to these mission/session statuses */
+    readonly statusFilter?: string[];
+    /** Restrict to 'mission' or 'session' */
+    readonly itemType?: 'mission' | 'session';
+}
+export declare function cmosProjectSweep(params: SweepParams, registryOverride?: ProjectRegistry): Promise<CmosToolResult<SweepResult>>;
+export declare function formatProjectSweepForLLM(result: CmosToolResult<SweepResult>): string;
+//# sourceMappingURL=cmos-project-sweep.d.ts.map

package/dist/tools/cmos/cmos-project-sweep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-project-sweep.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-project-sweep.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAM9C,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,iDAAiD;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAC3C;AAsED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,WAAW,EACnB,gBAAgB,CAAC,EAAE,eAAe,GACjC,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAiGtC;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,MAAM,CAgCpF"}