@aquex/cmos-mcp 1.0.0

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

@@ -0,0 +1,347 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosMissionStartToolDefinition = exports.cmosMissionStartSchema = void 0;
+exports.cmosMissionStart = cmosMissionStart;
+exports.formatMissionStartForLLM = formatMissionStartForLLM;
+const zod_1 = require("zod");
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+const schema_migrations_1 = require("./schema-migrations");
+const relevance_surfacing_1 = require("./relevance-surfacing");
+/**
+ * Input parameters schema for cmos_mission_start tool.
+ */
+exports.cmosMissionStartSchema = zod_1.z.object({
+    /** The mission ID to start */
+    missionId: zod_1.z.string().min(1).describe('The mission ID to start (e.g., "s12-m06")'),
+    /** Optional notes about starting this mission */
+    notes: zod_1.z.string().optional().describe('Optional notes about why this mission is being started'),
+    /** 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_start.
+ *
+ * Conforms to MCP tool definition spec for registration with the server.
+ */
+exports.cmosMissionStartToolDefinition = {
+    name: 'cmos_mission_start',
+    description: 'Start a mission by transitioning it to In Progress status. ' +
+        'Valid from Queued or Current status. ' +
+        'Returns INVALID_STATE_TRANSITION error with valid_transitions if the mission cannot be started.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            missionId: {
+                type: 'string',
+                description: 'The mission ID to start (e.g., "s12-m06")',
+            },
+            notes: {
+                type: 'string',
+                description: 'Optional notes about why this mission is being started',
+            },
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory to search for CMOS database (defaults to cwd)',
+            },
+        },
+        required: ['missionId'],
+        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
+ */
+async function cmosMissionStart(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();
+    const targetStatus = 'In Progress';
+    return (0, client_1.withClientValidated)((client) => {
+        // Query mission by ID
+        const missionResult = loadMissionForStart(client, 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;
+        const currentStatus = mission.status;
+        // Check if already in target status
+        if (currentStatus === targetStatus) {
+            return (0, errors_1.createError)({
+                code: errors_1.CMOS_ERROR_CODES.MISSION_INVALID_STATE,
+                message: `Mission '${missionId}' is already In Progress`,
+                currentState: currentStatus,
+                suggestion: 'Use cmos_mission_complete to mark it done or cmos_mission_block if blocked',
+            });
+        }
+        // Special handling for blocked missions - redirect to unblock tool
+        if (currentStatus === 'Blocked') {
+            return (0, errors_1.createError)({
+                code: errors_1.CMOS_ERROR_CODES.MISSION_INVALID_TRANSITION,
+                message: `Cannot start blocked mission '${missionId}'`,
+                currentState: currentStatus,
+                validTransitions: ['In Progress', 'Current'],
+                suggestion: 'Use cmos_mission_unblock to unblock this mission first. ' +
+                    'Provide a resolution explaining how the blocker was resolved.',
+            });
+        }
+        // Validate state transition
+        const validTransitions = errors_1.VALID_STATE_TRANSITIONS[currentStatus];
+        if (!validTransitions.includes(targetStatus)) {
+            return (0, errors_1.createError)(errors_1.CmosErrors.missionInvalidTransition(missionId, currentStatus, targetStatus));
+        }
+        // Perform the update
+        const now = new Date().toISOString();
+        const sprintActivationResult = shouldActivateParentSprint(client, mission.sprint_id);
+        if (!sprintActivationResult.success || sprintActivationResult.data === undefined) {
+            return (0, errors_1.createError)(sprintActivationResult.error ?? {
+                code: errors_1.CMOS_ERROR_CODES.DB_QUERY_FAILED,
+                message: `Failed to inspect parent sprint for mission '${missionId}'`,
+                suggestion: 'Check database connectivity and schema',
+            });
+        }
+        // Ensure timestamp columns exist (migration)
+        (0, schema_migrations_1.ensureMissionTimestamps)(client);
+        // Build update query - include notes if provided
+        // Set started_at only if not already set (first start), always update updated_at
+        let updateQuery;
+        let updateParams;
+        if (params.notes) {
+            updateQuery = `
+          UPDATE missions
+          SET status = ?,
+              notes = COALESCE(notes || ' | ', '') || ?,
+              started_at = COALESCE(started_at, ?),
+              updated_at = ?
+          WHERE id = ?
+        `;
+            updateParams = [targetStatus, `[Started] ${params.notes}`, now, now, missionId];
+        }
+        else {
+            updateQuery = `
+          UPDATE missions
+          SET status = ?,
+              started_at = COALESCE(started_at, ?),
+              updated_at = ?
+          WHERE id = ?
+        `;
+            updateParams = [targetStatus, now, now, missionId];
+        }
+        const beginResult = client.execute('BEGIN IMMEDIATE', []);
+        if (!beginResult.success) {
+            return (0, errors_1.createError)(beginResult.error ?? {
+                code: errors_1.CMOS_ERROR_CODES.DB_QUERY_FAILED,
+                message: `Failed to begin mission start transaction for '${missionId}'`,
+                suggestion: 'Retry the mission start once the database is available',
+            });
+        }
+        let transactionOpen = true;
+        const rollbackTransaction = () => {
+            if (!transactionOpen) {
+                return;
+            }
+            client.execute('ROLLBACK', []);
+            transactionOpen = false;
+        };
+        if (sprintActivationResult.data && mission.sprint_id) {
+            const activateSprintResult = activateParentSprint(client, mission.sprint_id, now);
+            if (!activateSprintResult.success) {
+                rollbackTransaction();
+                return (0, errors_1.createError)(activateSprintResult.error ?? {
+                    code: errors_1.CMOS_ERROR_CODES.DB_QUERY_FAILED,
+                    message: `Failed to activate parent sprint '${mission.sprint_id}'`,
+                    suggestion: 'Check database connectivity and retry the mission start.',
+                });
+            }
+        }
+        const updateResult = client.execute(updateQuery, updateParams);
+        if (!updateResult.success) {
+            rollbackTransaction();
+            return (0, errors_1.createError)(updateResult.error ?? { code: 'DB_QUERY_FAILED', message: 'Failed to update mission' });
+        }
+        if (updateResult.data?.changes === 0) {
+            rollbackTransaction();
+            return (0, errors_1.createError)({
+                code: errors_1.CMOS_ERROR_CODES.DB_QUERY_FAILED,
+                message: `Failed to update mission '${missionId}'`,
+                suggestion: 'The mission may have been modified by another process',
+            });
+        }
+        const commitResult = client.execute('COMMIT', []);
+        if (!commitResult.success) {
+            rollbackTransaction();
+            return (0, errors_1.createError)(commitResult.error ?? {
+                code: errors_1.CMOS_ERROR_CODES.DB_QUERY_FAILED,
+                message: `Failed to commit mission start for '${missionId}'`,
+                suggestion: 'Retry the mission start once the database transaction can be committed.',
+            });
+        }
+        transactionOpen = false;
+        // Log the state change to session_events
+        const eventResult = client.execute(`
+        INSERT INTO session_events (ts, agent, mission, action, status, summary, raw_event)
+        VALUES (?, 'mcp-tool', ?, 'start', ?, ?, ?)
+      `, [
+            now,
+            missionId,
+            targetStatus,
+            params.notes ?? `Started mission ${missionId}`,
+            JSON.stringify({
+                tool: 'cmos_mission_start',
+                missionId,
+                previousStatus: currentStatus,
+                newStatus: targetStatus,
+                notes: params.notes,
+            }),
+        ]);
+        // Don't fail the operation if event logging fails (non-critical)
+        if (!eventResult.success) {
+            console.warn('Failed to log mission start event:', eventResult.error);
+        }
+        // Surface relevant decisions for this mission (non-critical)
+        let relevantDecisions;
+        const missionDetail = client.getOne('SELECT objective, success_criteria FROM missions WHERE id = ?', [missionId]);
+        if (missionDetail.success && missionDetail.data) {
+            const searchText = (0, relevance_surfacing_1.buildMissionSearchText)(missionDetail.data.objective, missionDetail.data.success_criteria);
+            if (searchText.length > 0) {
+                const found = (0, relevance_surfacing_1.findRelevantDecisions)(client, searchText);
+                if (found.length > 0) {
+                    relevantDecisions = found;
+                }
+            }
+        }
+        return (0, errors_1.createSuccess)({
+            missionId,
+            previousStatus: currentStatus,
+            currentStatus: targetStatus,
+            message: `Mission '${missionId}' is now In Progress`,
+            startedAt: now,
+            relevantDecisions,
+        });
+    }, { projectRoot: params.projectRoot });
+}
+function loadMissionForStart(client, missionId) {
+    const missionResult = client.getOne(`
+      SELECT id, status, name, sprint_id
+      FROM missions
+      WHERE id = ?
+    `, [missionId]);
+    if (missionResult.success ||
+        missionResult.error?.code !== errors_1.CMOS_ERROR_CODES.DB_SCHEMA_MISMATCH ||
+        !missionResult.error?.message.includes('sprint_id')) {
+        return missionResult;
+    }
+    const legacyResult = client.getOne(`
+      SELECT id, status, name
+      FROM missions
+      WHERE id = ?
+    `, [missionId]);
+    if (!legacyResult.success || !legacyResult.data) {
+        return legacyResult;
+    }
+    return (0, errors_1.createSuccess)({
+        ...legacyResult.data,
+        sprint_id: null,
+    });
+}
+function shouldActivateParentSprint(client, sprintId) {
+    if (!sprintId) {
+        return (0, errors_1.createSuccess)(false);
+    }
+    const sprintResult = client.getOne('SELECT status FROM sprints WHERE id = ?', [sprintId]);
+    if (!sprintResult.success) {
+        return (0, errors_1.createError)(sprintResult.error ?? {
+            code: errors_1.CMOS_ERROR_CODES.DB_QUERY_FAILED,
+            message: `Failed to query sprint '${sprintId}'`,
+            suggestion: 'Check database connectivity and schema',
+        });
+    }
+    return (0, errors_1.createSuccess)(sprintResult.data?.status === 'Planned');
+}
+function activateParentSprint(client, sprintId, startedAt) {
+    const updateWithStartDate = client.execute(`
+      UPDATE sprints
+      SET status = 'Active',
+          start_date = COALESCE(start_date, ?)
+      WHERE id = ?
+        AND status = 'Planned'
+    `, [startedAt, sprintId]);
+    if (updateWithStartDate.success ||
+        updateWithStartDate.error?.code !== errors_1.CMOS_ERROR_CODES.DB_SCHEMA_MISMATCH ||
+        !updateWithStartDate.error?.message.includes('start_date')) {
+        return updateWithStartDate;
+    }
+    return client.execute(`
+      UPDATE sprints
+      SET status = 'Active'
+      WHERE id = ?
+        AND status = 'Planned'
+    `, [sprintId]);
+}
+/**
+ * Format mission start result for LLM readability.
+ *
+ * @param result - Mission start result
+ * @returns Human-readable formatted result
+ */
+function formatMissionStartForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        const lines = ['❌ Failed to start mission', '', `Error: ${error?.message ?? 'Unknown error'}`];
+        if (error?.currentState) {
+            lines.push(`Current status: ${error.currentState}`);
+        }
+        if (error?.validTransitions && error.validTransitions.length > 0) {
+            lines.push(`Valid transitions: ${error.validTransitions.join(', ')}`);
+        }
+        if (error?.suggestion) {
+            lines.push('');
+            lines.push(`Suggestion: ${error.suggestion}`);
+        }
+        return lines.join('\n');
+    }
+    const data = result.data;
+    const lines = [
+        `✓ Mission '${data.missionId}' started`,
+        '',
+        `Status: ${data.previousStatus} → ${data.currentStatus}`,
+        `Started at: ${data.startedAt}`,
+    ];
+    if (data.relevantDecisions && data.relevantDecisions.length > 0) {
+        lines.push('');
+        lines.push(`**Relevant Past Decisions** (${data.relevantDecisions.length}):`);
+        for (const d of data.relevantDecisions) {
+            const cat = d.category ? ` [${d.category}]` : '';
+            const sprint = d.sprintId ? ` (${d.sprintId})` : '';
+            const preview = d.decisionText.length > 100 ? d.decisionText.slice(0, 100) + '...' : d.decisionText;
+            lines.push(`  • #${d.id}${cat}${sprint}: ${preview}`);
+            if (d.evidence) {
+                lines.push(`    Evidence: ${d.evidence}`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=cmos-mission-start.js.map

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

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

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

@@ -0,0 +1,152 @@
+/**
+ * cmos_mission_status Tool
+ *
+ * MCP tool for showing the active work queue from the CMOS database.
+ * Provides a quick view of current/queued/in-progress missions to understand
+ * what to work on next.
+ *
+ * Priority order:
+ * 1. In Progress missions (actively being worked on)
+ * 2. Current missions (selected but not started)
+ * 3. Queued missions (limited, upcoming work)
+ *
+ * Optionally shows blocked missions separately for visibility.
+ *
+ * @module tools/cmos/cmos-mission-status
+ */
+import { z } from 'zod';
+import type { CmosToolResult, MissionStatus } from './types';
+/**
+ * Mission item with sprint context for the status view.
+ */
+export interface StatusMissionItem {
+    /** Mission ID (e.g., "s12-m07") */
+    id: string;
+    /** Mission name/title */
+    name: string;
+    /** Current status */
+    status: MissionStatus;
+    /** Mission objective */
+    objective: string | null;
+    /** Success criteria (parsed from JSON) */
+    successCriteria: string[] | null;
+    /** Deliverables (parsed from JSON) */
+    deliverables: string[] | null;
+    /** Notes about the mission */
+    notes: string | null;
+    /** Sprint context */
+    sprint: SprintContext | null;
+}
+/**
+ * Sprint context for a mission.
+ */
+export interface SprintContext {
+    /** Sprint ID */
+    id: string;
+    /** Sprint title */
+    title: string;
+    /** Sprint focus area */
+    focus: string | null;
+    /** Sprint status */
+    status: string | null;
+    /** Total missions in sprint */
+    totalMissions: number | null;
+    /** Completed missions in sprint */
+    completedMissions: number | null;
+}
+/**
+ * Result type for cmos_mission_status.
+ */
+export interface CmosMissionStatusResult {
+    /** Active sprint (the sprint currently being worked on) */
+    activeSprint: SprintContext | null;
+    /** Missions currently in progress (highest priority) */
+    inProgress: StatusMissionItem[];
+    /** Missions marked as current (selected, not started) */
+    current: StatusMissionItem[];
+    /** Queued missions (upcoming work, limited) */
+    queued: StatusMissionItem[];
+    /** Blocked missions (if includeBlocked was true) */
+    blocked: StatusMissionItem[] | null;
+    /** Summary of work queue state */
+    summary: {
+        /** Total active items (in_progress + current) */
+        activeCount: number;
+        /** Number of queued items */
+        queuedCount: number;
+        /** Number of blocked items (if included) */
+        blockedCount: number | null;
+        /** Recommendation for what to do next */
+        nextAction: string;
+    };
+}
+/**
+ * Input parameters schema for cmos_mission_status tool.
+ */
+export declare const cmosMissionStatusSchema: z.ZodObject<{
+    /** Whether to include blocked missions separately */
+    includeBlocked: z.ZodOptional<z.ZodBoolean>;
+    /** Maximum number of queued missions to return */
+    queuedLimit: z.ZodOptional<z.ZodNumber>;
+    /** Optional: explicit project root to search from */
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    projectRoot?: string | undefined;
+    includeBlocked?: boolean | undefined;
+    queuedLimit?: number | undefined;
+}, {
+    projectRoot?: string | undefined;
+    includeBlocked?: boolean | undefined;
+    queuedLimit?: number | undefined;
+}>;
+export type CmosMissionStatusParams = z.infer<typeof cmosMissionStatusSchema>;
+/**
+ * MCP Tool Definition for cmos_mission_status.
+ *
+ * Conforms to MCP tool definition spec for registration with the server.
+ */
+export declare const cmosMissionStatusToolDefinition: {
+    readonly name: "cmos_mission_status";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly includeBlocked: {
+                readonly type: "boolean";
+                readonly default: false;
+                readonly description: "Include blocked missions in a separate section (default: false)";
+            };
+            readonly queuedLimit: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 50;
+                readonly default: 5;
+                readonly description: "Maximum queued missions to show (1-50, default: 5)";
+            };
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Project root directory to search for CMOS database (defaults to cwd)";
+            };
+        };
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * Execute the cmos_mission_status tool.
+ *
+ * Retrieves the active work queue from the CMOS database, organized
+ * by priority (in_progress > current > queued). Includes sprint context
+ * for each mission to help agents understand the work context.
+ *
+ * @param params - Tool parameters (includeBlocked, queuedLimit, projectRoot)
+ * @returns CmosToolResult with status view or actionable error
+ */
+export declare function cmosMissionStatus(params?: CmosMissionStatusParams): Promise<CmosToolResult<CmosMissionStatusResult>>;
+/**
+ * Format mission status result for LLM readability.
+ *
+ * @param result - Mission status result
+ * @returns Human-readable summary
+ */
+export declare function formatMissionStatusForLLM(result: CmosToolResult<CmosMissionStatusResult>): string;
+//# sourceMappingURL=cmos-mission-status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-mission-status.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-mission-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;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,wBAAwB;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,0CAA0C;IAC1C,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEjC,sCAAsC;IACtC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAE9B,8BAA8B;IAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB,qBAAqB;IACrB,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAC;IAEX,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IAEd,wBAAwB;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB,oBAAoB;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,2DAA2D;IAC3D,YAAY,EAAE,aAAa,GAAG,IAAI,CAAC;IAEnC,wDAAwD;IACxD,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAEhC,yDAAyD;IACzD,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAE7B,+CAA+C;IAC/C,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAE5B,oDAAoD;IACpD,OAAO,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAAC;IAEpC,kCAAkC;IAClC,OAAO,EAAE;QACP,iDAAiD;QACjD,WAAW,EAAE,MAAM,CAAC;QAEpB,6BAA6B;QAC7B,WAAW,EAAE,MAAM,CAAC;QAEpB,4CAA4C;QAC5C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAE5B,yCAAyC;QACzC,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB;IAClC,qDAAqD;;IAMrD,kDAAkD;;IASlD,qDAAqD;;;;;;;;;;EAKrD,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;CA8BlC,CAAC;AAEX;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,GAAE,uBAA4B,GACnC,OAAO,CAAC,cAAc,CAAC,uBAAuB,CAAC,CAAC,CA0IlD;AAwLD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,CAAC,uBAAuB,CAAC,GAAG,MAAM,CA8FjG"}