@cleocode/mcp-server 0.86.0

package/dist/gateways/mutate.d.ts

@@ -0,0 +1,100 @@
+/**
+ * cleo_mutate Gateway - Write Operations
+ *
+ * Handles all state-modifying operations with strict validation,
+ * audit logging, and rollback support.
+ *
+ * Domains: tasks, session, orchestrate, research, lifecycle, validate, release, system
+ * Total operations: 53
+ *
+ * @task T2929
+ */
+import { DomainResponse } from '../lib/router.js';
+/**
+ * Mutate request interface
+ */
+export interface MutateRequest {
+    domain: 'tasks' | 'session' | 'orchestrate' | 'research' | 'lifecycle' | 'validate' | 'release' | 'system';
+    operation: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * Mutate response interface (aliases DomainResponse)
+ */
+export type MutateResponse = DomainResponse;
+/**
+ * Mutate operation matrix - all write operations by domain
+ * Reference: MCP-SERVER-SPECIFICATION.md Section 2.2.2
+ */
+export declare const MUTATE_OPERATIONS: Record<string, string[]>;
+/**
+ * Validate mutate request parameters
+ */
+export declare function validateMutateParams(request: MutateRequest): {
+    valid: boolean;
+    error?: DomainResponse;
+};
+/**
+ * Register cleo_mutate tool with MCP server
+ *
+ * Returns tool definition for ListToolsRequestSchema handler
+ */
+export declare function registerMutateTool(): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        required: string[];
+        properties: {
+            domain: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            operation: {
+                type: string;
+                description: string;
+            };
+            params: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+            };
+        };
+    };
+};
+/**
+ * Handle cleo_mutate request
+ *
+ * Validates parameters, logs to audit trail, routes to domain handler,
+ * and handles idempotency
+ *
+ * @param request Mutate request with domain, operation, and params
+ * @returns Promise resolving to mutate response
+ */
+export declare function handleMutateRequest(request: MutateRequest): Promise<MutateResponse>;
+/**
+ * Check if operation is idempotent
+ */
+export declare function isIdempotentOperation(domain: string, operation: string): boolean;
+/**
+ * Check if operation requires session binding
+ */
+export declare function requiresSession(domain: string, operation: string): boolean;
+/**
+ * Get mutate operation count for specific domain or all domains
+ */
+export declare function getMutateOperationCount(domain?: string): number;
+/**
+ * Check if operation is write (mutate)
+ */
+export declare function isMutateOperation(domain: string, operation: string): boolean;
+/**
+ * Get all mutate domains
+ */
+export declare function getMutateDomains(): string[];
+/**
+ * Get operations for specific mutate domain
+ */
+export declare function getMutateOperations(domain: string): string[];
+//# sourceMappingURL=mutate.d.ts.map

package/dist/gateways/mutate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutate.d.ts","sourceRoot":"","sources":["../../src/gateways/mutate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAiB,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIjE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC3G,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAiEtD,CAAC;AAmCF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG;IAC5D,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB,CAmEA;AA8pBD;;;;GAIG;AACH,wBAAgB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;EA0BjC;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,cAAc,CAAC,CAgFzB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEhF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAE5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAE5D"}