@aquex/cmos-mcp 1.0.0

package/dist/tools/cmos/cmos-mission-show.d.ts

@@ -0,0 +1,115 @@
+/**
+ * cmos_mission_show Tool
+ *
+ * MCP tool for retrieving full mission details by ID from the CMOS database.
+ * Returns complete mission specification including objective, context,
+ * success criteria, deliverables, and reference docs.
+ *
+ * @module tools/cmos/cmos-mission-show
+ */
+import { z } from 'zod';
+import type { CmosToolResult, MissionStatus } from './types';
+/**
+ * Full mission details with parsed JSON fields.
+ */
+export interface MissionShowResult {
+    /** Mission ID (e.g., "s12-m06") */
+    id: string;
+    /** Mission name/title */
+    name: string;
+    /** Current status */
+    status: MissionStatus;
+    /** Mission objective - what this mission aims to achieve */
+    objective: string | null;
+    /** Context explaining why this mission matters */
+    context: string | null;
+    /** Success criteria (parsed from JSON) */
+    successCriteria: string[] | null;
+    /** Deliverables (parsed from JSON) */
+    deliverables: string[] | null;
+    /** Reference docs (parsed from JSON) */
+    referenceDocs: string[] | null;
+    /** Domain-specific fields (parsed from JSON) */
+    domainFields: Record<string, unknown> | null;
+    /** Notes about the mission */
+    notes: string | null;
+    /** Completion timestamp */
+    completedAt: string | null;
+    /** When mission was created */
+    createdAt: string | null;
+    /** When mission first moved to In Progress */
+    startedAt: string | null;
+    /** Last state change timestamp */
+    updatedAt: string | null;
+    /** Additional metadata (parsed from JSON) */
+    metadata: Record<string, unknown> | null;
+    /** Sprint information (if mission belongs to a sprint) */
+    sprint: SprintInfo | null;
+}
+/**
+ * Minimal sprint info for context.
+ */
+export interface SprintInfo {
+    id: string;
+    title: string;
+    focus: string | null;
+    status: string | null;
+}
+/**
+ * Input parameters schema for cmos_mission_show tool.
+ */
+export declare const cmosMissionShowSchema: z.ZodObject<{
+    /** The mission ID to retrieve */
+    missionId: z.ZodString;
+    /** Optional: explicit project root to search from */
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    missionId: string;
+    projectRoot?: string | undefined;
+}, {
+    missionId: string;
+    projectRoot?: string | undefined;
+}>;
+export type CmosMissionShowParams = z.infer<typeof cmosMissionShowSchema>;
+/**
+ * MCP Tool Definition for cmos_mission_show.
+ *
+ * Conforms to MCP tool definition spec for registration with the server.
+ */
+export declare const cmosMissionShowToolDefinition: {
+    readonly name: "cmos_mission_show";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly missionId: {
+                readonly type: "string";
+                readonly description: "The mission ID to retrieve (e.g., \"s12-m06\")";
+            };
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Project root directory to search for CMOS database (defaults to cwd)";
+            };
+        };
+        readonly required: readonly ["missionId"];
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * Execute the cmos_mission_show tool.
+ *
+ * Retrieves full mission details from the CMOS database by mission ID.
+ * Includes sprint context if the mission belongs to a sprint.
+ *
+ * @param params - Tool parameters (missionId, projectRoot)
+ * @returns CmosToolResult with full mission details or actionable error
+ */
+export declare function cmosMissionShow(params: CmosMissionShowParams): Promise<CmosToolResult<MissionShowResult>>;
+/**
+ * Format mission show result for LLM readability.
+ *
+ * @param result - Mission show result
+ * @returns Human-readable formatted mission details
+ */
+export declare function formatMissionShowForLLM(result: CmosToolResult<MissionShowResult>): string;
+//# sourceMappingURL=cmos-mission-show.d.ts.map

package/dist/tools/cmos/cmos-mission-show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-mission-show.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-mission-show.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAW,aAAa,EAAU,MAAM,SAAS,CAAC;AAG9E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IAEX,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,MAAM,EAAE,aAAa,CAAC;IAEtB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,kDAAkD;IAClD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB,0CAA0C;IAC1C,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEjC,sCAAsC;IACtC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAE9B,wCAAwC;IACxC,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAE/B,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE7C,8BAA8B;IAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,+BAA+B;IAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,kCAAkC;IAClC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEzC,0DAA0D;IAC1D,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;IAChC,iCAAiC;;IAGjC,qDAAqD;;;;;;;;EAKrD,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;CAsBhC,CAAC;AAEX;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAuF5C;AA6CD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,CAAC,iBAAiB,CAAC,GAAG,MAAM,CAyFzF"}

package/dist/tools/cmos/cmos-mission-show.js

@@ -0,0 +1,278 @@
+"use strict";
+/**
+ * cmos_mission_show Tool
+ *
+ * MCP tool for retrieving full mission details by ID from the CMOS database.
+ * Returns complete mission specification including objective, context,
+ * success criteria, deliverables, and reference docs.
+ *
+ * @module tools/cmos/cmos-mission-show
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosMissionShowToolDefinition = exports.cmosMissionShowSchema = void 0;
+exports.cmosMissionShow = cmosMissionShow;
+exports.formatMissionShowForLLM = formatMissionShowForLLM;
+const zod_1 = require("zod");
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+/**
+ * Input parameters schema for cmos_mission_show tool.
+ */
+exports.cmosMissionShowSchema = zod_1.z.object({
+    /** The mission ID to retrieve */
+    missionId: zod_1.z.string().min(1).describe('The mission ID to retrieve (e.g., "s12-m06")'),
+    /** 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_mission_show.
+ *
+ * Conforms to MCP tool definition spec for registration with the server.
+ */
+exports.cmosMissionShowToolDefinition = {
+    name: 'cmos_mission_show',
+    description: 'Get full details of a specific mission by ID. ' +
+        'Returns complete mission specification including objective, context, ' +
+        'success criteria, deliverables, reference docs, and sprint information. ' +
+        'Use this when you need the complete mission spec to execute work.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            missionId: {
+                type: 'string',
+                description: 'The mission ID to retrieve (e.g., "s12-m06")',
+            },
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory to search for CMOS database (defaults to cwd)',
+            },
+        },
+        required: ['missionId'],
+        additionalProperties: false,
+    },
+};
+/**
+ * Execute the cmos_mission_show tool.
+ *
+ * Retrieves full mission details from the CMOS database by mission ID.
+ * Includes sprint context if the mission belongs to a sprint.
+ *
+ * @param params - Tool parameters (missionId, projectRoot)
+ * @returns CmosToolResult with full mission details or actionable error
+ */
+async function cmosMissionShow(params) {
+    // Validate required parameter
+    if (!params.missionId || params.missionId.trim() === '') {
+        return (0, errors_1.createError)(errors_1.CmosErrors.missingParameter('missionId'));
+    }
+    const missionId = params.missionId.trim();
+    return (0, client_1.withClient)((client) => {
+        // Query mission by ID (with soft column detection for timestamps)
+        const missionColumns = getMissionColumns(client);
+        const createdAtExpr = missionColumns.has('created_at') ? 'created_at' : 'NULL AS created_at';
+        const startedAtExpr = missionColumns.has('started_at') ? 'started_at' : 'NULL AS started_at';
+        const updatedAtExpr = missionColumns.has('updated_at') ? 'updated_at' : 'NULL AS updated_at';
+        const missionResult = client.getOne(`
+        SELECT
+          id, sprint_id, name, status, completed_at, notes,
+          objective, context, success_criteria, deliverables,
+          reference_docs, domain_fields, metadata,
+          ${createdAtExpr}, ${startedAtExpr}, ${updatedAtExpr}
+        FROM missions
+        WHERE id = ?
+      `, [missionId]);
+        if (!missionResult.success) {
+            return (0, errors_1.createError)(missionResult.error ?? { code: 'DB_QUERY_FAILED', message: 'Failed to query mission' });
+        }
+        if (!missionResult.data) {
+            return (0, errors_1.createError)(errors_1.CmosErrors.missionNotFound(missionId));
+        }
+        const mission = missionResult.data;
+        // Get sprint info if mission has a sprint_id
+        let sprintInfo = null;
+        if (mission.sprint_id) {
+            const sprintResult = client.getOne(`
+          SELECT id, title, focus, status
+          FROM sprints
+          WHERE id = ?
+        `, [mission.sprint_id]);
+            if (sprintResult.success && sprintResult.data) {
+                sprintInfo = {
+                    id: sprintResult.data.id,
+                    title: sprintResult.data.title,
+                    focus: sprintResult.data.focus,
+                    status: sprintResult.data.status,
+                };
+            }
+        }
+        // Parse and transform mission
+        const result = {
+            id: mission.id,
+            name: mission.name,
+            status: mission.status,
+            objective: mission.objective,
+            context: mission.context,
+            successCriteria: parseJsonArray(mission.success_criteria),
+            deliverables: parseJsonArray(mission.deliverables),
+            referenceDocs: parseJsonArray(mission.reference_docs),
+            domainFields: parseJsonObject(mission.domain_fields),
+            notes: mission.notes,
+            completedAt: mission.completed_at,
+            createdAt: mission.created_at ?? null,
+            startedAt: mission.started_at ?? null,
+            updatedAt: mission.updated_at ?? null,
+            metadata: parseJsonObject(mission.metadata),
+            sprint: sprintInfo,
+        };
+        return (0, errors_1.createSuccess)(result);
+    }, { projectRoot: params.projectRoot });
+}
+/**
+ * Get the set of column names for the missions table.
+ */
+function getMissionColumns(client) {
+    const result = client.getMany("PRAGMA table_info('missions')", []);
+    if (!result.success || !result.data) {
+        return new Set();
+    }
+    return new Set(result.data.map((row) => row.name));
+}
+/**
+ * Safely parse a JSON array string.
+ */
+function parseJsonArray(jsonString) {
+    if (!jsonString)
+        return null;
+    try {
+        const parsed = JSON.parse(jsonString);
+        if (Array.isArray(parsed)) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Safely parse a JSON object string.
+ */
+function parseJsonObject(jsonString) {
+    if (!jsonString)
+        return null;
+    try {
+        const parsed = JSON.parse(jsonString);
+        if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Format mission show result for LLM readability.
+ *
+ * @param result - Mission show result
+ * @returns Human-readable formatted mission details
+ */
+function formatMissionShowForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        const lines = [
+            '❌ Failed to retrieve mission',
+            '',
+            `Error: ${error?.message ?? 'Unknown error'}`,
+        ];
+        if (error?.suggestion) {
+            lines.push('');
+            lines.push(`Suggestion: ${error.suggestion}`);
+        }
+        return lines.join('\n');
+    }
+    const m = result.data;
+    const lines = [];
+    // Header with ID and status
+    const statusIcon = getStatusIcon(m.status);
+    lines.push(`# ${m.id}: ${m.name}`);
+    lines.push(`**Status**: ${statusIcon} ${m.status}`);
+    // Sprint context
+    if (m.sprint) {
+        lines.push(`**Sprint**: ${m.sprint.id} - ${m.sprint.title}`);
+        if (m.sprint.focus) {
+            lines.push(`**Focus**: ${m.sprint.focus}`);
+        }
+    }
+    lines.push('');
+    // Objective
+    if (m.objective) {
+        lines.push('## Objective');
+        lines.push(m.objective);
+        lines.push('');
+    }
+    // Context
+    if (m.context) {
+        lines.push('## Context');
+        lines.push(m.context);
+        lines.push('');
+    }
+    // Success Criteria
+    if (m.successCriteria && m.successCriteria.length > 0) {
+        lines.push('## Success Criteria');
+        for (const criterion of m.successCriteria) {
+            lines.push(`- [ ] ${criterion}`);
+        }
+        lines.push('');
+    }
+    // Deliverables
+    if (m.deliverables && m.deliverables.length > 0) {
+        lines.push('## Deliverables');
+        for (const deliverable of m.deliverables) {
+            lines.push(`- ${deliverable}`);
+        }
+        lines.push('');
+    }
+    // Reference Docs
+    if (m.referenceDocs && m.referenceDocs.length > 0) {
+        lines.push('## Reference Docs');
+        for (const doc of m.referenceDocs) {
+            lines.push(`- ${doc}`);
+        }
+        lines.push('');
+    }
+    // Notes
+    if (m.notes) {
+        lines.push('## Notes');
+        lines.push(m.notes);
+        lines.push('');
+    }
+    // Completion info
+    if (m.completedAt) {
+        lines.push(`**Completed**: ${m.completedAt}`);
+    }
+    return lines.join('\n').trim();
+}
+/**
+ * Get a status icon for display.
+ */
+function getStatusIcon(status) {
+    switch (status) {
+        case 'Queued':
+            return '○';
+        case 'Current':
+            return '◉';
+        case 'In Progress':
+            return '◐';
+        case 'Completed':
+            return '✓';
+        case 'Blocked':
+            return '⊘';
+        default:
+            return '?';
+    }
+}
+//# sourceMappingURL=cmos-mission-show.js.map

package/dist/tools/cmos/cmos-mission-show.js.map

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

package/dist/tools/cmos/cmos-mission-start.d.ts

@@ -0,0 +1,94 @@
+/**
+ * cmos_mission_start Tool
+ *
+ * MCP tool for starting a mission - transitions from Queued/Current to In Progress.
+ * Validates state transitions and returns actionable errors.
+ *
+ * @module tools/cmos/cmos-mission-start
+ */
+import { z } from 'zod';
+import type { CmosToolResult, MissionStatus } from './types';
+import { type RelevantDecision } from './relevance-surfacing';
+/**
+ * Result of starting a mission.
+ */
+export interface MissionStartResult {
+    /** The mission ID that was started */
+    missionId: string;
+    /** Previous status before transition */
+    previousStatus: MissionStatus;
+    /** Current status after transition (always 'In Progress') */
+    currentStatus: MissionStatus;
+    /** Human-readable message */
+    message: string;
+    /** Timestamp when mission was started */
+    startedAt: string;
+    /** Active decisions relevant to this mission's objective (0-5 items) */
+    relevantDecisions?: RelevantDecision[];
+}
+/**
+ * Input parameters schema for cmos_mission_start tool.
+ */
+export declare const cmosMissionStartSchema: z.ZodObject<{
+    /** The mission ID to start */
+    missionId: z.ZodString;
+    /** Optional notes about starting this mission */
+    notes: z.ZodOptional<z.ZodString>;
+    /** Optional: explicit project root to search from */
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    missionId: string;
+    projectRoot?: string | undefined;
+    notes?: string | undefined;
+}, {
+    missionId: string;
+    projectRoot?: string | undefined;
+    notes?: string | undefined;
+}>;
+export type CmosMissionStartParams = z.infer<typeof cmosMissionStartSchema>;
+/**
+ * MCP Tool Definition for cmos_mission_start.
+ *
+ * Conforms to MCP tool definition spec for registration with the server.
+ */
+export declare const cmosMissionStartToolDefinition: {
+    readonly name: "cmos_mission_start";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly missionId: {
+                readonly type: "string";
+                readonly description: "The mission ID to start (e.g., \"s12-m06\")";
+            };
+            readonly notes: {
+                readonly type: "string";
+                readonly description: "Optional notes about why this mission is being started";
+            };
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Project root directory to search for CMOS database (defaults to cwd)";
+            };
+        };
+        readonly required: readonly ["missionId"];
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * Execute the cmos_mission_start tool.
+ *
+ * Transitions a mission from Queued or Current to In Progress.
+ * Validates the state transition and returns actionable errors if invalid.
+ *
+ * @param params - Tool parameters (missionId, notes, projectRoot)
+ * @returns CmosToolResult with start result or actionable error
+ */
+export declare function cmosMissionStart(params: CmosMissionStartParams): Promise<CmosToolResult<MissionStartResult>>;
+/**
+ * Format mission start result for LLM readability.
+ *
+ * @param result - Mission start result
+ * @returns Human-readable formatted result
+ */
+export declare function formatMissionStartForLLM(result: CmosToolResult<MissionStartResult>): string;
+//# sourceMappingURL=cmos-mission-start.d.ts.map

package/dist/tools/cmos/cmos-mission-start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-mission-start.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-mission-start.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAW,aAAa,EAAE,MAAM,SAAS,CAAC;AAStE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAElB,wCAAwC;IACxC,cAAc,EAAE,aAAa,CAAC;IAE9B,6DAA6D;IAC7D,aAAa,EAAE,aAAa,CAAC;IAE7B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAElB,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACxC;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB;IACjC,8BAA8B;;IAG9B,iDAAiD;;IAGjD,qDAAqD;;;;;;;;;;EAKrD,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;CAyBjC,CAAC;AAEX;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC,CA+N7C;AAuGD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,CAAC,kBAAkB,CAAC,GAAG,MAAM,CA6C3F"}