@aquex/cmos-mcp 1.0.0

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

@@ -0,0 +1,104 @@
+/**
+ * cmos_mission_block Tool
+ *
+ * MCP tool for blocking a mission - transitions from Current/In Progress to Blocked.
+ * Validates state transitions and returns actionable errors.
+ *
+ * @module tools/cmos/cmos-mission-block
+ */
+import { z } from 'zod';
+import type { CmosToolResult, MissionStatus } from './types';
+/**
+ * Result of blocking a mission.
+ */
+export interface MissionBlockResult {
+    /** The mission ID that was blocked */
+    missionId: string;
+    /** Previous status before transition */
+    previousStatus: MissionStatus;
+    /** Current status after transition (always 'Blocked') */
+    currentStatus: MissionStatus;
+    /** The reason for blocking */
+    reason: string;
+    /** Human-readable message */
+    message: string;
+    /** Timestamp when mission was blocked */
+    blockedAt: string;
+}
+/**
+ * Input parameters schema for cmos_mission_block tool.
+ */
+export declare const cmosMissionBlockSchema: z.ZodObject<{
+    /** The mission ID to block */
+    missionId: z.ZodString;
+    /** The reason for blocking */
+    reason: z.ZodString;
+    /** Optional list of things needed to unblock */
+    blockers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Optional: explicit project root to search from */
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    missionId: string;
+    reason: string;
+    projectRoot?: string | undefined;
+    blockers?: string[] | undefined;
+}, {
+    missionId: string;
+    reason: string;
+    projectRoot?: string | undefined;
+    blockers?: string[] | undefined;
+}>;
+export type CmosMissionBlockParams = z.infer<typeof cmosMissionBlockSchema>;
+/**
+ * MCP Tool Definition for cmos_mission_block.
+ *
+ * Conforms to MCP tool definition spec for registration with the server.
+ */
+export declare const cmosMissionBlockToolDefinition: {
+    readonly name: "cmos_mission_block";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly missionId: {
+                readonly type: "string";
+                readonly description: "The mission ID to block (e.g., \"s12-m06\")";
+            };
+            readonly reason: {
+                readonly type: "string";
+                readonly description: "The reason why this mission is being blocked";
+            };
+            readonly blockers: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Optional list of items or dependencies needed to unblock";
+            };
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Project root directory to search for CMOS database (defaults to cwd)";
+            };
+        };
+        readonly required: readonly ["missionId", "reason"];
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * Execute the cmos_mission_block tool.
+ *
+ * Transitions a mission from Current or In Progress to Blocked.
+ * Requires a reason and optionally accepts blockers list.
+ *
+ * @param params - Tool parameters (missionId, reason, blockers, projectRoot)
+ * @returns CmosToolResult with block result or actionable error
+ */
+export declare function cmosMissionBlock(params: CmosMissionBlockParams): Promise<CmosToolResult<MissionBlockResult>>;
+/**
+ * Format mission block result for LLM readability.
+ *
+ * @param result - Mission block result
+ * @returns Human-readable formatted result
+ */
+export declare function formatMissionBlockForLLM(result: CmosToolResult<MissionBlockResult>): string;
+//# sourceMappingURL=cmos-mission-block.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-mission-block.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-mission-block.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAW,aAAa,EAAwB,MAAM,SAAS,CAAC;AAW5F;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAElB,wCAAwC;IACxC,cAAc,EAAE,aAAa,CAAC;IAE9B,yDAAyD;IACzD,aAAa,EAAE,aAAa,CAAC;IAE7B,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IAEf,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB;IACjC,8BAA8B;;IAG9B,8BAA8B;;IAG9B,gDAAgD;;IAMhD,qDAAqD;;;;;;;;;;;;EAKrD,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BjC,CAAC;AAEX;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC,CA4K7C;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,CAAC,kBAAkB,CAAC,GAAG,MAAM,CA+B3F"}

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

@@ -0,0 +1,248 @@
+"use strict";
+/**
+ * cmos_mission_block Tool
+ *
+ * MCP tool for blocking a mission - transitions from Current/In Progress to Blocked.
+ * Validates state transitions and returns actionable errors.
+ *
+ * @module tools/cmos/cmos-mission-block
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosMissionBlockToolDefinition = exports.cmosMissionBlockSchema = void 0;
+exports.cmosMissionBlock = cmosMissionBlock;
+exports.formatMissionBlockForLLM = formatMissionBlockForLLM;
+const zod_1 = require("zod");
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+const schema_migrations_1 = require("./schema-migrations");
+const content_sanitizer_1 = require("../../intelligence/content-sanitizer");
+/**
+ * Input parameters schema for cmos_mission_block tool.
+ */
+exports.cmosMissionBlockSchema = zod_1.z.object({
+    /** The mission ID to block */
+    missionId: zod_1.z.string().min(1).describe('The mission ID to block (e.g., "s12-m06")'),
+    /** The reason for blocking */
+    reason: zod_1.z.string().min(1).describe('The reason why this mission is being blocked'),
+    /** Optional list of things needed to unblock */
+    blockers: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .describe('Optional list of items or dependencies needed to unblock'),
+    /** 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_block.
+ *
+ * Conforms to MCP tool definition spec for registration with the server.
+ */
+exports.cmosMissionBlockToolDefinition = {
+    name: 'cmos_mission_block',
+    description: 'Block a mission by transitioning it to Blocked status. ' +
+        'Requires a reason for why the mission is blocked. ' +
+        'Valid from Current or In Progress status. ' +
+        'Returns INVALID_STATE_TRANSITION error with current_state and valid_transitions if the mission cannot be blocked.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            missionId: {
+                type: 'string',
+                description: 'The mission ID to block (e.g., "s12-m06")',
+            },
+            reason: {
+                type: 'string',
+                description: 'The reason why this mission is being blocked',
+            },
+            blockers: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Optional list of items or dependencies needed to unblock',
+            },
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory to search for CMOS database (defaults to cwd)',
+            },
+        },
+        required: ['missionId', 'reason'],
+        additionalProperties: false,
+    },
+};
+/**
+ * Execute the cmos_mission_block tool.
+ *
+ * Transitions a mission from Current or In Progress to Blocked.
+ * Requires a reason and optionally accepts blockers list.
+ *
+ * @param params - Tool parameters (missionId, reason, blockers, projectRoot)
+ * @returns CmosToolResult with block result or actionable error
+ */
+async function cmosMissionBlock(params) {
+    // Validate required parameters
+    if (!params.missionId || params.missionId.trim() === '') {
+        return (0, errors_1.createError)(errors_1.CmosErrors.missingParameter('missionId'));
+    }
+    if (!params.reason || params.reason.trim() === '') {
+        return (0, errors_1.createError)(errors_1.CmosErrors.missingParameter('reason'));
+    }
+    const missionId = params.missionId.trim();
+    // Sprint 60 m02: sanitize text inputs before persistence so XML-marshalling
+    // sibling absorption is stripped + surfaced rather than written verbatim.
+    const inputSanitized = [];
+    let cleanedReason = params.reason;
+    const reasonSanitize = (0, content_sanitizer_1.sanitizeContentField)(params.reason);
+    if (reasonSanitize.wasModified) {
+        cleanedReason = reasonSanitize.cleaned;
+        inputSanitized.push({ field: 'reason', reason: reasonSanitize.reason ?? '' });
+    }
+    if (!cleanedReason || cleanedReason.trim() === '') {
+        return (0, errors_1.createError)(errors_1.CmosErrors.missingParameter('reason'));
+    }
+    let cleanedBlockers = params.blockers;
+    if (Array.isArray(cleanedBlockers)) {
+        const r = (0, content_sanitizer_1.sanitizeStringArray)('blockers', cleanedBlockers);
+        cleanedBlockers = r.cleaned;
+        inputSanitized.push(...r.sanitizedFields);
+    }
+    const reason = cleanedReason.trim();
+    const targetStatus = 'Blocked';
+    return (0, client_1.withClientValidated)((client) => {
+        // Query mission by ID
+        const missionResult = client.getOne(`
+        SELECT id, status, name, domain_fields
+        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;
+        const currentStatus = mission.status;
+        // Check if already blocked
+        if (currentStatus === targetStatus) {
+            return (0, errors_1.createError)({
+                code: errors_1.CMOS_ERROR_CODES.MISSION_ALREADY_BLOCKED,
+                message: `Mission '${missionId}' is already Blocked`,
+                currentState: currentStatus,
+                suggestion: 'Use cmos_mission_unblock to unblock it first, or update the block reason',
+            });
+        }
+        // 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();
+        // Update domain_fields with blocker information
+        let existingDomainFields = {};
+        if (mission.domain_fields) {
+            try {
+                existingDomainFields = JSON.parse(mission.domain_fields);
+            }
+            catch {
+                // If parsing fails, start fresh
+                existingDomainFields = {};
+            }
+        }
+        const updatedDomainFields = {
+            ...existingDomainFields,
+            blocker: reason,
+            blockedSince: now,
+            blockers: cleanedBlockers ?? [],
+        };
+        // Build note text
+        const blockNote = cleanedBlockers?.length
+            ? `[Blocked] ${reason}. Needs: ${cleanedBlockers.join(', ')}`
+            : `[Blocked] ${reason}`;
+        // Ensure timestamp columns exist (migration)
+        (0, schema_migrations_1.ensureMissionTimestamps)(client);
+        const updateResult = client.execute(`
+        UPDATE missions
+        SET status = ?,
+            domain_fields = ?,
+            notes = COALESCE(notes || ' | ', '') || ?,
+            updated_at = ?
+        WHERE id = ?
+      `, [targetStatus, JSON.stringify(updatedDomainFields), blockNote, now, missionId]);
+        if (!updateResult.success) {
+            return (0, errors_1.createError)(updateResult.error ?? { code: 'DB_QUERY_FAILED', message: 'Failed to update mission' });
+        }
+        if (updateResult.data?.changes === 0) {
+            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',
+            });
+        }
+        // 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', ?, 'block', ?, ?, ?)
+      `, [
+            now,
+            missionId,
+            targetStatus,
+            reason,
+            JSON.stringify({
+                tool: 'cmos_mission_block',
+                missionId,
+                previousStatus: currentStatus,
+                newStatus: targetStatus,
+                reason,
+                blockers: cleanedBlockers,
+            }),
+        ]);
+        // Don't fail the operation if event logging fails (non-critical)
+        if (!eventResult.success) {
+            console.warn('Failed to log mission block event:', eventResult.error);
+        }
+        return (0, errors_1.createSuccess)({
+            missionId,
+            previousStatus: currentStatus,
+            currentStatus: targetStatus,
+            reason,
+            message: `Mission '${missionId}' has been blocked: ${reason}`,
+            blockedAt: now,
+        }, undefined, inputSanitized);
+    }, { projectRoot: params.projectRoot });
+}
+/**
+ * Format mission block result for LLM readability.
+ *
+ * @param result - Mission block result
+ * @returns Human-readable formatted result
+ */
+function formatMissionBlockForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        const lines = ['❌ Failed to block 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}' blocked`,
+        '',
+        `Status: ${data.previousStatus} → ${data.currentStatus}`,
+        `Reason: ${data.reason}`,
+        `Blocked at: ${data.blockedAt}`,
+    ];
+    return lines.join('\n');
+}
+//# sourceMappingURL=cmos-mission-block.js.map

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

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

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

@@ -0,0 +1,127 @@
+/**
+ * cmos_mission_complete Tool
+ *
+ * MCP tool for completing a mission - transitions from In Progress to Completed.
+ * Validates state transitions and returns actionable errors.
+ *
+ * @module tools/cmos/cmos-mission-complete
+ */
+import { z } from 'zod';
+import { type CmosDatabaseClient } from './client';
+import type { CmosToolResult, MissionStatus } from './types';
+/**
+ * Result of completing a mission.
+ */
+export interface MissionCompleteResult {
+    /** The mission ID that was completed */
+    missionId: string;
+    /** Previous status before transition */
+    previousStatus: MissionStatus;
+    /** Current status after transition (always 'Completed') */
+    currentStatus: MissionStatus;
+    /** Human-readable message */
+    message: string;
+    /** Timestamp when mission was completed */
+    completedAt: string;
+    /** Whether master_context was updated with mission completion summary */
+    contextAggregated?: boolean;
+    /** Whether a sprint completion summary was added */
+    sprintSummaryAdded?: boolean;
+    /** Snapshot ID created for context aggregation */
+    contextSnapshotId?: number | null;
+    /** Number of decisions captured with this completion */
+    decisionCount?: number;
+    /** Total decisions captured for this mission's sprint */
+    sprintDecisionCount?: number;
+    /** Number of learnings captured for this mission */
+    learningCount?: number;
+    /** Persisted agent_feedback.id when agentFeedback was supplied (Sprint 56 m03). */
+    feedbackId?: number;
+}
+/**
+ * Input parameters schema for cmos_mission_complete tool.
+ */
+export declare const cmosMissionCompleteSchema: z.ZodObject<{
+    /** The mission ID to complete */
+    missionId: z.ZodString;
+    /** Optional notes or outcome summary */
+    notes: z.ZodOptional<z.ZodString>;
+    /** Optional decisions made during this mission */
+    decisions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Optional free-text UX feedback from the agent (Sprint 56 m03). */
+    agentFeedback: 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;
+    agentFeedback?: string | undefined;
+    decisions?: string[] | undefined;
+}, {
+    missionId: string;
+    projectRoot?: string | undefined;
+    notes?: string | undefined;
+    agentFeedback?: string | undefined;
+    decisions?: string[] | undefined;
+}>;
+export type CmosMissionCompleteParams = z.infer<typeof cmosMissionCompleteSchema>;
+/**
+ * MCP Tool Definition for cmos_mission_complete.
+ *
+ * Conforms to MCP tool definition spec for registration with the server.
+ */
+export declare const cmosMissionCompleteToolDefinition: {
+    readonly name: "cmos_mission_complete";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly missionId: {
+                readonly type: "string";
+                readonly description: "The mission ID to complete (e.g., \"s12-m06\")";
+            };
+            readonly notes: {
+                readonly type: "string";
+                readonly description: "Optional notes or outcome summary for completion";
+            };
+            readonly decisions: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Decisions made during this mission. When omitted, a soft warning is included in the response.";
+            };
+            readonly agentFeedback: {
+                readonly type: "string";
+                readonly maxLength: 2000;
+                readonly description: "Optional free-text UX feedback. Use this to report rough edges, improvement ideas, or surprising tool behavior you hit while working this mission. Reviewed periodically via cmos_feedback(action=\"list\").";
+            };
+            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_complete tool.
+ *
+ * Transitions a mission from In Progress to Completed.
+ * Validates the state transition and returns actionable errors if invalid.
+ *
+ * @param params - Tool parameters (missionId, notes, projectRoot)
+ * @returns CmosToolResult with completion result or actionable error
+ */
+export declare function cmosMissionComplete(params: CmosMissionCompleteParams): Promise<CmosToolResult<MissionCompleteResult>>;
+export declare function ensureMissionIdColumn(client: CmosDatabaseClient): void;
+/**
+ * Format mission complete result for LLM readability.
+ *
+ * @param result - Mission complete result
+ * @returns Human-readable formatted result
+ */
+export declare function formatMissionCompleteForLLM(result: CmosToolResult<MissionCompleteResult>): string;
+//# sourceMappingURL=cmos-mission-complete.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-mission-complete.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-mission-complete.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAuB,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAwB,MAAM,SAAS,CAAC;AAoBnF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAElB,wCAAwC;IACxC,cAAc,EAAE,aAAa,CAAC;IAE9B,2DAA2D;IAC3D,aAAa,EAAE,aAAa,CAAC;IAE7B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IAEpB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,yDAAyD;IACzD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB;IACpC,iCAAiC;;IAGjC,wCAAwC;;IAGxC,kDAAkD;;IAQlD,qEAAqE;;IASrE,qDAAqD;;;;;;;;;;;;;;EAKrD,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAElF;;;;GAIG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCpC,CAAC;AAEX;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC,CAmOhD;AA+ED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAItE;AAgND;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,cAAc,CAAC,qBAAqB,CAAC,GAAG,MAAM,CAkEjG"}