@aquex/cmos-mcp 1.0.0

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

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * cmos_mission_undepends Tool
+ *
+ * MCP tool for removing mission dependencies from the CMOS database.
+ * Validates that the dependency exists before deletion.
+ *
+ * @module tools/cmos/cmos-mission-undepends
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosMissionUndepends = cmosMissionUndepends;
+exports.formatMissionUndependsForLLM = formatMissionUndependsForLLM;
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+/**
+ * Remove a dependency relationship between two missions.
+ */
+async function cmosMissionUndepends(params) {
+    const { fromId, toId } = params;
+    if (!fromId || fromId.trim() === '') {
+        return (0, errors_1.createError)({ code: errors_1.CMOS_ERROR_CODES.MISSING_PARAMETER, message: 'fromId is required' });
+    }
+    if (!toId || toId.trim() === '') {
+        return (0, errors_1.createError)({ code: errors_1.CMOS_ERROR_CODES.MISSING_PARAMETER, message: 'toId is required' });
+    }
+    return (0, client_1.withClientValidated)((client) => {
+        // Verify the dependency exists
+        const existing = client.getOne('SELECT from_id, to_id, type FROM mission_dependencies WHERE from_id = ? AND to_id = ?', [fromId.trim(), toId.trim()]);
+        if (!existing.success) {
+            return (0, errors_1.createError)(existing.error ?? { code: 'DB_QUERY_FAILED', message: 'Failed to check dependency' });
+        }
+        if (!existing.data) {
+            return (0, errors_1.createError)({
+                code: errors_1.CMOS_ERROR_CODES.INVALID_PARAMETER,
+                message: `No dependency found from '${fromId}' to '${toId}'`,
+                suggestion: 'Check the fromId and toId values. Use cmos_mission(action="show") to see existing dependencies.',
+            });
+        }
+        // Delete the dependency
+        const deleteResult = client.execute('DELETE FROM mission_dependencies WHERE from_id = ? AND to_id = ?', [fromId.trim(), toId.trim()]);
+        if (!deleteResult.success) {
+            return (0, errors_1.createError)(deleteResult.error ?? { code: 'DB_QUERY_FAILED', message: 'Failed to remove dependency' });
+        }
+        const now = new Date().toISOString();
+        // Log removal event
+        client.execute(`INSERT INTO session_events (ts, agent, mission, action, status, summary, raw_event)
+         VALUES (?, 'mcp-tool', ?, 'dependency', ?, ?, ?)`, [
+            now,
+            fromId.trim(),
+            'dependency_removed',
+            `Removed ${existing.data.type} dependency: ${fromId} -> ${toId}`,
+            JSON.stringify({
+                tool: 'cmos_mission_undepends',
+                fromId: fromId.trim(),
+                toId: toId.trim(),
+                type: existing.data.type,
+            }),
+        ]);
+        return (0, errors_1.createSuccess)({
+            fromId: fromId.trim(),
+            toId: toId.trim(),
+            removedAt: now,
+            message: `Dependency removed: ${fromId} no longer ${existing.data.type.toLowerCase()} ${toId}`,
+        });
+    }, { projectRoot: params.projectRoot });
+}
+/**
+ * Format dependency removal result for LLM readability.
+ */
+function formatMissionUndependsForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        const lines = [
+            'Failed to remove mission dependency',
+            '',
+            `Error: ${error?.message ?? 'Unknown error'}`,
+        ];
+        if (error?.suggestion) {
+            lines.push('');
+            lines.push(`Suggestion: ${error.suggestion}`);
+        }
+        return lines.join('\n');
+    }
+    const data = result.data;
+    return [
+        'Dependency removed',
+        '',
+        `From: ${data.fromId}`,
+        `To: ${data.toId}`,
+        '',
+        data.message,
+    ].join('\n');
+}
+//# sourceMappingURL=cmos-mission-undepends.js.map

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

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

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

@@ -0,0 +1,225 @@
+/**
+ * cmos_mission_update Tool
+ *
+ * MCP tool for partially updating mission fields in the CMOS database.
+ * Only provided fields are updated, others remain unchanged.
+ *
+ * @module tools/cmos/cmos-mission-update
+ */
+import { z } from 'zod';
+import type { CmosToolResult, MissionStatus } from './types';
+/**
+ * Fields that can be updated on a mission.
+ * Matches the missions table schema.
+ */
+export interface MissionUpdateFields {
+    /** Mission name/title */
+    name?: string;
+    /** Mission status (validates state transitions) */
+    status?: MissionStatus;
+    /** Mission objective */
+    objective?: string;
+    /** Context explaining why this mission matters */
+    context?: string;
+    /** Success criteria (array of strings) */
+    successCriteria?: string[];
+    /** Deliverables (array of strings) */
+    deliverables?: string[];
+    /** Reference docs (array of strings) */
+    referenceDocs?: string[];
+    /** Domain-specific fields (key-value object) */
+    domainFields?: Record<string, unknown>;
+    /** Notes about the mission */
+    notes?: string;
+    /** Additional metadata (key-value object) */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result of updating a mission.
+ */
+export interface MissionUpdateResult {
+    /** The mission ID that was updated */
+    missionId: string;
+    /** Fields that were updated */
+    updatedFields: string[];
+    /** Human-readable message */
+    message: string;
+    /** Previous status (if status was changed) */
+    previousStatus?: MissionStatus;
+    /** Current status (if status was changed) */
+    currentStatus?: MissionStatus;
+}
+/**
+ * Input parameters schema for cmos_mission_update tool.
+ */
+export declare const cmosMissionUpdateSchema: z.ZodObject<{
+    /** The mission ID to update */
+    missionId: z.ZodString;
+    /** Fields to update (only provided fields are changed) */
+    fields: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodEnum<["Queued", "Current", "In Progress", "Completed", "Blocked", "Dropped", "Deferred"]>>;
+        objective: z.ZodOptional<z.ZodString>;
+        context: z.ZodOptional<z.ZodString>;
+        successCriteria: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        deliverables: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        referenceDocs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        domainFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        notes: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        name?: string | undefined;
+        status?: "Queued" | "Current" | "In Progress" | "Completed" | "Blocked" | "Dropped" | "Deferred" | undefined;
+        notes?: string | undefined;
+        objective?: string | undefined;
+        context?: string | undefined;
+        deliverables?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        successCriteria?: string[] | undefined;
+        referenceDocs?: string[] | undefined;
+        domainFields?: Record<string, unknown> | undefined;
+    }, {
+        name?: string | undefined;
+        status?: "Queued" | "Current" | "In Progress" | "Completed" | "Blocked" | "Dropped" | "Deferred" | undefined;
+        notes?: string | undefined;
+        objective?: string | undefined;
+        context?: string | undefined;
+        deliverables?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        successCriteria?: string[] | undefined;
+        referenceDocs?: string[] | undefined;
+        domainFields?: Record<string, unknown> | undefined;
+    }>;
+    /** Optional: explicit project root to search from */
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    missionId: string;
+    fields: {
+        name?: string | undefined;
+        status?: "Queued" | "Current" | "In Progress" | "Completed" | "Blocked" | "Dropped" | "Deferred" | undefined;
+        notes?: string | undefined;
+        objective?: string | undefined;
+        context?: string | undefined;
+        deliverables?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        successCriteria?: string[] | undefined;
+        referenceDocs?: string[] | undefined;
+        domainFields?: Record<string, unknown> | undefined;
+    };
+    projectRoot?: string | undefined;
+}, {
+    missionId: string;
+    fields: {
+        name?: string | undefined;
+        status?: "Queued" | "Current" | "In Progress" | "Completed" | "Blocked" | "Dropped" | "Deferred" | undefined;
+        notes?: string | undefined;
+        objective?: string | undefined;
+        context?: string | undefined;
+        deliverables?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        successCriteria?: string[] | undefined;
+        referenceDocs?: string[] | undefined;
+        domainFields?: Record<string, unknown> | undefined;
+    };
+    projectRoot?: string | undefined;
+}>;
+export type CmosMissionUpdateParams = z.infer<typeof cmosMissionUpdateSchema>;
+/**
+ * MCP Tool Definition for cmos_mission_update.
+ *
+ * Conforms to MCP tool definition spec for registration with the server.
+ */
+export declare const cmosMissionUpdateToolDefinition: {
+    readonly name: "cmos_mission_update";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly missionId: {
+                readonly type: "string";
+                readonly description: "The mission ID to update (e.g., \"s12-m06\")";
+            };
+            readonly fields: {
+                readonly type: "object";
+                readonly description: "Fields to update (only provided fields are changed)";
+                readonly properties: {
+                    readonly name: {
+                        readonly type: "string";
+                        readonly description: "Mission name/title";
+                    };
+                    readonly status: {
+                        readonly type: "string";
+                        readonly enum: readonly ["Queued", "Current", "In Progress", "Completed", "Blocked", "Dropped", "Deferred"];
+                        readonly description: "Mission status (validates state transitions)";
+                    };
+                    readonly objective: {
+                        readonly type: "string";
+                        readonly description: "Mission objective";
+                    };
+                    readonly context: {
+                        readonly type: "string";
+                        readonly description: "Context explaining why this mission matters";
+                    };
+                    readonly successCriteria: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "Success criteria (array of strings)";
+                    };
+                    readonly deliverables: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "Deliverables (array of strings)";
+                    };
+                    readonly referenceDocs: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "Reference docs (array of strings)";
+                    };
+                    readonly domainFields: {
+                        readonly type: "object";
+                        readonly description: "Domain-specific fields (key-value object)";
+                    };
+                    readonly notes: {
+                        readonly type: "string";
+                        readonly description: "Notes about the mission";
+                    };
+                    readonly metadata: {
+                        readonly type: "object";
+                        readonly description: "Additional metadata (key-value object)";
+                    };
+                };
+                readonly additionalProperties: false;
+            };
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Project root directory to search for CMOS database (defaults to cwd)";
+            };
+        };
+        readonly required: readonly ["missionId", "fields"];
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * Execute the cmos_mission_update tool.
+ *
+ * Partially updates mission fields in the CMOS database.
+ * Only fields included in the `fields` object are updated.
+ *
+ * @param params - Tool parameters (missionId, fields, projectRoot)
+ * @returns CmosToolResult with update result or actionable error
+ */
+export declare function cmosMissionUpdate(params: CmosMissionUpdateParams): Promise<CmosToolResult<MissionUpdateResult>>;
+/**
+ * Format mission update result for LLM readability.
+ *
+ * @param result - Mission update result
+ * @returns Human-readable formatted result
+ */
+export declare function formatMissionUpdateForLLM(result: CmosToolResult<MissionUpdateResult>): string;
+//# sourceMappingURL=cmos-mission-update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-mission-update.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-mission-update.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAW,aAAa,EAAE,MAAM,SAAS,CAAC;AAetE;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,mDAAmD;IACnD,MAAM,CAAC,EAAE,aAAa,CAAC;IAEvB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvC,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAElB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,aAAa,CAAC;IAE/B,6CAA6C;IAC7C,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB;IAClC,+BAA+B;;IAG/B,0DAA0D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAyB1D,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKrD,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgFlC,CAAC;AAEX;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,CAoN9C;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAiC7F"}

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

@@ -0,0 +1,350 @@
+"use strict";
+/**
+ * cmos_mission_update Tool
+ *
+ * MCP tool for partially updating mission fields in the CMOS database.
+ * Only provided fields are updated, others remain unchanged.
+ *
+ * @module tools/cmos/cmos-mission-update
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosMissionUpdateToolDefinition = exports.cmosMissionUpdateSchema = void 0;
+exports.cmosMissionUpdate = cmosMissionUpdate;
+exports.formatMissionUpdateForLLM = formatMissionUpdateForLLM;
+const zod_1 = require("zod");
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+const content_sanitizer_1 = require("../../intelligence/content-sanitizer");
+/**
+ * Input parameters schema for cmos_mission_update tool.
+ */
+exports.cmosMissionUpdateSchema = zod_1.z.object({
+    /** The mission ID to update */
+    missionId: zod_1.z.string().min(1).describe('The mission ID to update (e.g., "s12-m06")'),
+    /** Fields to update (only provided fields are changed) */
+    fields: zod_1.z
+        .object({
+        name: zod_1.z.string().optional().describe('Mission name/title'),
+        status: zod_1.z
+            .enum(['Queued', 'Current', 'In Progress', 'Completed', 'Blocked', 'Dropped', 'Deferred'])
+            .optional()
+            .describe('Mission status (validates state transitions)'),
+        objective: zod_1.z.string().optional().describe('Mission objective'),
+        context: zod_1.z.string().optional().describe('Context explaining why this mission matters'),
+        successCriteria: zod_1.z
+            .array(zod_1.z.string())
+            .optional()
+            .describe('Success criteria (array of strings)'),
+        deliverables: zod_1.z.array(zod_1.z.string()).optional().describe('Deliverables (array of strings)'),
+        referenceDocs: zod_1.z.array(zod_1.z.string()).optional().describe('Reference docs (array of strings)'),
+        domainFields: zod_1.z
+            .record(zod_1.z.unknown())
+            .optional()
+            .describe('Domain-specific fields (key-value object)'),
+        notes: zod_1.z.string().optional().describe('Notes about the mission'),
+        metadata: zod_1.z.record(zod_1.z.unknown()).optional().describe('Additional metadata (key-value object)'),
+    })
+        .describe('Fields to update (only provided fields are changed)'),
+    /** 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_update.
+ *
+ * Conforms to MCP tool definition spec for registration with the server.
+ */
+exports.cmosMissionUpdateToolDefinition = {
+    name: 'cmos_mission_update',
+    description: 'Update specific fields of a mission without replacing the entire record. ' +
+        'Only provided fields are updated, others remain unchanged. ' +
+        'If updating status, validates state transitions and returns INVALID_STATE_TRANSITION error if invalid.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            missionId: {
+                type: 'string',
+                description: 'The mission ID to update (e.g., "s12-m06")',
+            },
+            fields: {
+                type: 'object',
+                description: 'Fields to update (only provided fields are changed)',
+                properties: {
+                    name: {
+                        type: 'string',
+                        description: 'Mission name/title',
+                    },
+                    status: {
+                        type: 'string',
+                        enum: [
+                            'Queued',
+                            'Current',
+                            'In Progress',
+                            'Completed',
+                            'Blocked',
+                            'Dropped',
+                            'Deferred',
+                        ],
+                        description: 'Mission status (validates state transitions)',
+                    },
+                    objective: {
+                        type: 'string',
+                        description: 'Mission objective',
+                    },
+                    context: {
+                        type: 'string',
+                        description: 'Context explaining why this mission matters',
+                    },
+                    successCriteria: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Success criteria (array of strings)',
+                    },
+                    deliverables: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Deliverables (array of strings)',
+                    },
+                    referenceDocs: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Reference docs (array of strings)',
+                    },
+                    domainFields: {
+                        type: 'object',
+                        description: 'Domain-specific fields (key-value object)',
+                    },
+                    notes: {
+                        type: 'string',
+                        description: 'Notes about the mission',
+                    },
+                    metadata: {
+                        type: 'object',
+                        description: 'Additional metadata (key-value object)',
+                    },
+                },
+                additionalProperties: false,
+            },
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory to search for CMOS database (defaults to cwd)',
+            },
+        },
+        required: ['missionId', 'fields'],
+        additionalProperties: false,
+    },
+};
+/**
+ * Execute the cmos_mission_update tool.
+ *
+ * Partially updates mission fields in the CMOS database.
+ * Only fields included in the `fields` object are updated.
+ *
+ * @param params - Tool parameters (missionId, fields, projectRoot)
+ * @returns CmosToolResult with update result or actionable error
+ */
+async function cmosMissionUpdate(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 sanitizedFields = [];
+    const rawFields = params.fields;
+    const fields = { ...rawFields };
+    const scalarFieldNames = ['name', 'objective', 'context', 'notes'];
+    for (const key of scalarFieldNames) {
+        const value = fields[key];
+        if (typeof value === 'string') {
+            const r = (0, content_sanitizer_1.sanitizeContentField)(value);
+            if (r.wasModified) {
+                sanitizedFields.push({ field: `fields.${key}`, reason: r.reason ?? '' });
+                fields[key] = r.cleaned;
+            }
+        }
+    }
+    const arrayFieldNames = ['successCriteria', 'deliverables', 'referenceDocs'];
+    for (const key of arrayFieldNames) {
+        const value = fields[key];
+        if (Array.isArray(value)) {
+            const r = (0, content_sanitizer_1.sanitizeStringArray)(`fields.${key}`, value);
+            sanitizedFields.push(...r.sanitizedFields);
+            fields[key] = r.cleaned;
+        }
+    }
+    // Check if any fields are provided
+    const fieldKeys = Object.keys(fields).filter((k) => fields[k] !== undefined);
+    if (fieldKeys.length === 0) {
+        return (0, errors_1.createError)({
+            code: errors_1.CMOS_ERROR_CODES.INVALID_PARAMETER,
+            message: 'No fields provided to update',
+            suggestion: 'Provide at least one field to update (e.g., name, status, objective, notes)',
+        });
+    }
+    // Validate status if provided
+    if (fields.status !== undefined && !errors_1.VALID_MISSION_STATUSES.includes(fields.status)) {
+        return (0, errors_1.createError)(errors_1.CmosErrors.invalidParameter('status', fields.status, errors_1.VALID_MISSION_STATUSES));
+    }
+    return (0, client_1.withClientValidated)((client) => {
+        // Query mission by ID
+        const missionResult = client.getOne(`
+        SELECT id, status, name
+        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;
+        let previousStatus;
+        let newStatus;
+        // Validate status transition if status is being changed
+        if (fields.status !== undefined && fields.status !== currentStatus) {
+            const validTransitions = errors_1.VALID_STATE_TRANSITIONS[currentStatus];
+            if (!validTransitions.includes(fields.status)) {
+                return (0, errors_1.createError)(errors_1.CmosErrors.missionInvalidTransition(missionId, currentStatus, fields.status));
+            }
+            previousStatus = currentStatus;
+            newStatus = fields.status;
+        }
+        // Build dynamic UPDATE query
+        const setClauses = [];
+        const queryParams = [];
+        // Map of TypeScript field names to database column names
+        const fieldMapping = {
+            name: 'name',
+            status: 'status',
+            objective: 'objective',
+            context: 'context',
+            successCriteria: 'success_criteria',
+            deliverables: 'deliverables',
+            referenceDocs: 'reference_docs',
+            domainFields: 'domain_fields',
+            notes: 'notes',
+            metadata: 'metadata',
+        };
+        // JSON fields that need serialization
+        const jsonFields = new Set([
+            'successCriteria',
+            'deliverables',
+            'referenceDocs',
+            'domainFields',
+            'metadata',
+        ]);
+        for (const key of fieldKeys) {
+            const dbColumn = fieldMapping[key];
+            if (!dbColumn)
+                continue;
+            const value = fields[key];
+            if (value === undefined)
+                continue;
+            setClauses.push(`${dbColumn} = ?`);
+            if (jsonFields.has(key)) {
+                queryParams.push(JSON.stringify(value));
+            }
+            else {
+                queryParams.push(value);
+            }
+        }
+        // Handle completed_at for status changes
+        if (newStatus === 'Completed') {
+            setClauses.push('completed_at = ?');
+            queryParams.push(new Date().toISOString());
+        }
+        // Note: Completed is a terminal state per VALID_STATE_TRANSITIONS,
+        // so we cannot move away from it. No need to clear completed_at.
+        // Add missionId as the last parameter for WHERE clause
+        queryParams.push(missionId);
+        const updateQuery = `
+        UPDATE missions
+        SET ${setClauses.join(', ')}
+        WHERE id = ?
+      `;
+        const updateResult = client.execute(updateQuery, queryParams);
+        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 if status changed
+        if (previousStatus !== undefined && newStatus !== undefined) {
+            const now = new Date().toISOString();
+            const eventResult = client.execute(`
+          INSERT INTO session_events (ts, agent, mission, action, status, summary, raw_event)
+          VALUES (?, 'mcp-tool', ?, 'update', ?, ?, ?)
+        `, [
+                now,
+                missionId,
+                newStatus,
+                `Updated mission ${missionId}: status changed from ${previousStatus} to ${newStatus}`,
+                JSON.stringify({
+                    tool: 'cmos_mission_update',
+                    missionId,
+                    previousStatus,
+                    newStatus,
+                    updatedFields: fieldKeys,
+                }),
+            ]);
+            // Don't fail the operation if event logging fails (non-critical)
+            if (!eventResult.success) {
+                console.warn('Failed to log mission update event:', eventResult.error);
+            }
+        }
+        // Build result
+        const result = {
+            missionId,
+            updatedFields: fieldKeys,
+            message: `Mission '${missionId}' updated successfully (${fieldKeys.length} field${fieldKeys.length === 1 ? '' : 's'})`,
+        };
+        if (previousStatus !== undefined && newStatus !== undefined) {
+            result.previousStatus = previousStatus;
+            result.currentStatus = newStatus;
+        }
+        return (0, errors_1.createSuccess)(result, undefined, sanitizedFields);
+    }, { projectRoot: params.projectRoot });
+}
+/**
+ * Format mission update result for LLM readability.
+ *
+ * @param result - Mission update result
+ * @returns Human-readable formatted result
+ */
+function formatMissionUpdateForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        const lines = ['Failed to update 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}' updated`,
+        '',
+        `Updated fields: ${data.updatedFields.join(', ')}`,
+    ];
+    if (data.previousStatus && data.currentStatus) {
+        lines.push(`Status: ${data.previousStatus} -> ${data.currentStatus}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=cmos-mission-update.js.map