sqlew 3.6.5 → 3.6.6

package/dist/utils/action-specs.js

@@ -0,0 +1,527 @@
+/**
+ * Action Specification Registry for MCP Tool Parameter Validation
+ *
+ * Centralized registry of all action-specific parameter requirements across
+ * sqlew MCP tools. Used by parameter-validator.ts to generate structured
+ * error messages with examples and typo suggestions.
+ *
+ * Each action spec includes:
+ * - required: Array of required parameter names
+ * - optional: Array of optional parameter names
+ * - example: Valid example object demonstrating correct usage
+ * - hint: Optional helpful tip for using the action
+ */
+// ============================================================================
+// DECISION TOOL (16 actions)
+// ============================================================================
+export const DECISION_ACTION_SPECS = {
+    set: {
+        required: ['key', 'value'],
+        optional: ['agent', 'layer', 'tags', 'status', 'version', 'scopes'],
+        example: {
+            action: 'set',
+            key: 'database/postgresql-choice',
+            value: 'Selected PostgreSQL over MongoDB because of complex relational queries and ACID compliance requirements',
+            layer: 'data',
+            tags: ['database', 'architecture'],
+            status: 'active',
+            version: '1.0.0'
+        },
+        hint: "Use 'quick_set' for simpler usage with auto-inferred metadata"
+    },
+    get: {
+        required: ['key'],
+        optional: ['include_context'],
+        example: {
+            action: 'get',
+            key: 'database/postgresql-choice',
+            include_context: true
+        },
+        hint: "Set include_context=true to get attached rationale and alternatives"
+    },
+    list: {
+        required: [],
+        optional: ['status', 'layer', 'tags', 'scope', 'tag_match', 'limit', 'offset'],
+        example: {
+            action: 'list',
+            status: 'active',
+            layer: 'business',
+            limit: 20
+        }
+    },
+    search_tags: {
+        required: ['tags'],
+        optional: ['match_mode', 'status', 'layer'],
+        example: {
+            action: 'search_tags',
+            tags: ['security', 'authentication'],
+            match_mode: 'AND',
+            status: 'active'
+        },
+        hint: "Use match_mode='AND' to find decisions with ALL tags, 'OR' for ANY tag"
+    },
+    search_layer: {
+        required: ['layer'],
+        optional: ['status', 'include_tags'],
+        example: {
+            action: 'search_layer',
+            layer: 'business',
+            status: 'active',
+            include_tags: true
+        },
+        hint: "Valid layers: presentation, business, data, infrastructure, cross-cutting"
+    },
+    versions: {
+        required: ['key'],
+        optional: [],
+        example: {
+            action: 'versions',
+            key: 'database/postgresql-choice'
+        },
+        hint: "Returns version history with timestamps and who made changes"
+    },
+    quick_set: {
+        required: ['key', 'value'],
+        optional: ['agent', 'layer', 'version', 'status', 'tags', 'scopes'],
+        example: {
+            action: 'quick_set',
+            key: 'api/instruments/oscillator-refactor',
+            value: 'Moved oscillator_type to MonophonicSynthConfig for better separation'
+        },
+        hint: "Auto-infers layer from key prefix (api/*→presentation, db/*→data, service/*→business). Reduces required parameters from 7 to 2."
+    },
+    search_advanced: {
+        required: [],
+        optional: [
+            'layers', 'tags_all', 'tags_any', 'exclude_tags', 'scopes',
+            'updated_after', 'updated_before', 'decided_by', 'statuses',
+            'search_text', 'sort_by', 'sort_order', 'limit', 'offset'
+        ],
+        example: {
+            action: 'search_advanced',
+            layers: ['business', 'data'],
+            tags_all: ['breaking'],
+            updated_after: '2025-01-01',
+            sort_by: 'updated',
+            sort_order: 'desc',
+            limit: 20
+        },
+        hint: "Use tags_all for AND logic (must have ALL tags), tags_any for OR logic (must have ANY tag)"
+    },
+    set_batch: {
+        required: ['decisions'],
+        optional: ['atomic'],
+        example: {
+            action: 'set_batch',
+            decisions: [
+                { key: 'cache/redis-choice', value: 'Using Redis for session storage', layer: 'infrastructure' },
+                { key: 'cache/ttl', value: '3600', layer: 'infrastructure' }
+            ],
+            atomic: false
+        },
+        hint: "Use atomic:false for best-effort batch operations (recommended for AI agents). Set atomic:true only when all-or-nothing is required. Max 50 decisions per batch."
+    },
+    has_updates: {
+        required: ['agent_name', 'since_timestamp'],
+        optional: [],
+        example: {
+            action: 'has_updates',
+            agent_name: 'my-agent',
+            since_timestamp: '2025-10-14T08:00:00Z'
+        },
+        hint: "Lightweight polling mechanism (~5-10 tokens per check). Use ISO 8601 timestamp format."
+    },
+    set_from_template: {
+        required: ['template', 'key', 'value'],
+        optional: ['agent', 'layer', 'version', 'status', 'tags', 'scopes'],
+        example: {
+            action: 'set_from_template',
+            template: 'breaking_change',
+            key: 'api/remove-legacy-endpoint',
+            value: 'Removed /v1/users endpoint - migrate to /v2/users'
+        },
+        hint: "Built-in templates: breaking_change, security_vulnerability, performance_optimization, deprecation, architecture_decision"
+    },
+    create_template: {
+        required: ['name', 'defaults'],
+        optional: ['required_fields', 'created_by'],
+        example: {
+            action: 'create_template',
+            name: 'bug_fix',
+            defaults: {
+                layer: 'business',
+                tags: ['bug', 'fix'],
+                status: 'active'
+            },
+            created_by: 'team-lead'
+        },
+        hint: "Templates enable reusable decision patterns with consistent metadata"
+    },
+    list_templates: {
+        required: [],
+        optional: [],
+        example: {
+            action: 'list_templates'
+        },
+        hint: "Returns both built-in and custom templates"
+    },
+    hard_delete: {
+        required: ['key'],
+        optional: [],
+        example: {
+            action: 'hard_delete',
+            key: 'old-test-decision'
+        },
+        hint: "⚠️ IRREVERSIBLE! Permanently deletes decision and all history. Use for cleanup after migration or removing sensitive data."
+    },
+    add_decision_context: {
+        required: ['key', 'rationale'],
+        optional: ['alternatives_considered', 'tradeoffs', 'decided_by', 'related_task_id', 'related_constraint_id'],
+        example: {
+            action: 'add_decision_context',
+            key: 'database/postgresql-choice',
+            rationale: 'PostgreSQL chosen for ACID compliance and complex query support',
+            alternatives_considered: ['MongoDB', 'MySQL', 'SQLite'],
+            tradeoffs: {
+                pros: ['Strong ACID compliance', 'Advanced query features'],
+                cons: ['Slightly higher resource usage', 'Steeper learning curve']
+            },
+            decided_by: 'architecture-team'
+        },
+        hint: "Add rich context explaining WHY decisions were made, not just WHAT was decided"
+    },
+    list_decision_contexts: {
+        required: [],
+        optional: ['decision_key', 'related_task_id', 'related_constraint_id', 'decided_by', 'limit', 'offset'],
+        example: {
+            action: 'list_decision_contexts',
+            decision_key: 'database/postgresql-choice',
+            limit: 50
+        },
+        hint: "Query decision contexts with optional filters for traceability"
+    }
+};
+// ============================================================================
+// TASK TOOL (12 actions)
+// ============================================================================
+export const TASK_ACTION_SPECS = {
+    create: {
+        required: ['title'],
+        optional: ['description', 'acceptance_criteria', 'notes', 'priority', 'assigned_agent', 'created_by_agent', 'layer', 'tags', 'status', 'watch_files'],
+        example: {
+            action: 'create',
+            title: 'Implement JWT authentication',
+            description: 'Add JWT-based authentication to /api/login endpoint',
+            priority: 3,
+            assigned_agent: 'backend-agent',
+            layer: 'business',
+            tags: ['authentication', 'security'],
+            watch_files: ['src/api/auth.ts', 'src/middleware/jwt.ts']
+        },
+        hint: "⭐ Use watch_files to automatically link and monitor files. Priority: 1=low, 2=medium, 3=high, 4=critical"
+    },
+    update: {
+        required: ['task_id'],
+        optional: ['title', 'priority', 'assigned_agent', 'layer', 'description', 'acceptance_criteria', 'notes', 'watch_files'],
+        example: {
+            action: 'update',
+            task_id: 5,
+            priority: 4,
+            assigned_agent: 'senior-backend-agent',
+            watch_files: ['src/api/users.ts']
+        },
+        hint: "Only specified fields will be updated; others remain unchanged"
+    },
+    get: {
+        required: ['task_id'],
+        optional: ['include_dependencies'],
+        example: {
+            action: 'get',
+            task_id: 5,
+            include_dependencies: true
+        },
+        hint: "Set include_dependencies=true to see blocking/blocked relationships"
+    },
+    list: {
+        required: [],
+        optional: ['status', 'assigned_agent', 'layer', 'tags', 'limit', 'offset', 'include_dependency_counts'],
+        example: {
+            action: 'list',
+            status: 'in_progress',
+            assigned_agent: 'backend-agent',
+            limit: 20
+        },
+        hint: "Valid statuses: todo, in_progress, waiting_review, blocked, done, archived"
+    },
+    move: {
+        required: ['task_id', 'new_status'],
+        optional: [],
+        example: {
+            action: 'move',
+            task_id: 5,
+            new_status: 'in_progress'
+        },
+        hint: "Status transitions are validated. E.g., can't move from 'todo' directly to 'done'"
+    },
+    link: {
+        required: ['task_id', 'link_type', 'target_id'],
+        optional: ['link_relation'],
+        example: {
+            action: 'link',
+            task_id: 5,
+            link_type: 'decision',
+            target_id: 'api/auth-method',
+            link_relation: 'implements'
+        },
+        hint: "⚠️ link_type='file' is DEPRECATED in v3.4.1. Use watch_files parameter or watch_files action instead."
+    },
+    archive: {
+        required: ['task_id'],
+        optional: [],
+        example: {
+            action: 'archive',
+            task_id: 5
+        },
+        hint: "Task must be in 'done' status before archiving"
+    },
+    batch_create: {
+        required: ['tasks'],
+        optional: ['atomic'],
+        example: {
+            action: 'batch_create',
+            tasks: [
+                { title: 'Design API', priority: 3 },
+                { title: 'Implement API', priority: 3 },
+                { title: 'Write tests', priority: 2 }
+            ],
+            atomic: false
+        },
+        hint: "Max 50 tasks per batch. Use atomic:false for best-effort creation."
+    },
+    add_dependency: {
+        required: ['blocker_task_id', 'blocked_task_id'],
+        optional: [],
+        example: {
+            action: 'add_dependency',
+            blocker_task_id: 1,
+            blocked_task_id: 2
+        },
+        hint: "Task #1 must complete before Task #2 can start. Prevents circular dependencies."
+    },
+    remove_dependency: {
+        required: ['blocker_task_id', 'blocked_task_id'],
+        optional: [],
+        example: {
+            action: 'remove_dependency',
+            blocker_task_id: 1,
+            blocked_task_id: 2
+        },
+        hint: "Silently succeeds even if dependency doesn't exist (idempotent)"
+    },
+    get_dependencies: {
+        required: ['task_id'],
+        optional: ['include_details'],
+        example: {
+            action: 'get_dependencies',
+            task_id: 2,
+            include_details: false
+        },
+        hint: "Returns bidirectional: tasks that block this task AND tasks this task blocks"
+    },
+    watch_files: {
+        required: ['task_id', 'action'],
+        optional: ['file_paths'],
+        example: {
+            action: 'watch_files',
+            task_id: 5,
+            subaction: 'watch',
+            file_paths: ['src/api/auth.ts', 'src/middleware/jwt.ts']
+        },
+        hint: "⭐ NEW in v3.4.1: Replaces task.link(file). Actions: watch, unwatch, list"
+    }
+};
+// ============================================================================
+// FILE TOOL (4 actions)
+// ============================================================================
+export const FILE_ACTION_SPECS = {
+    record: {
+        required: ['file_path', 'agent_name', 'change_type'],
+        optional: ['layer', 'description'],
+        example: {
+            action: 'record',
+            file_path: 'src/api/auth.ts',
+            agent_name: 'refactor-agent',
+            change_type: 'modified',
+            layer: 'business',
+            description: 'Added JWT validation'
+        },
+        hint: "Valid change_type: created, modified, deleted"
+    },
+    get: {
+        required: [],
+        optional: ['file_path', 'agent_name', 'layer', 'change_type', 'since', 'limit'],
+        example: {
+            action: 'get',
+            agent_name: 'refactor-agent',
+            layer: 'business',
+            limit: 10
+        },
+        hint: "Use 'since' with ISO 8601 timestamp for time-based filtering"
+    },
+    check_lock: {
+        required: ['file_path'],
+        optional: ['lock_duration'],
+        example: {
+            action: 'check_lock',
+            file_path: 'src/database/schema.sql',
+            lock_duration: 300
+        },
+        hint: "Default lock_duration is 300 seconds (5 minutes). Prevents concurrent edits."
+    },
+    record_batch: {
+        required: ['file_changes'],
+        optional: ['atomic'],
+        example: {
+            action: 'record_batch',
+            file_changes: [
+                { file_path: 'src/api.ts', agent_name: 'bot1', change_type: 'modified', layer: 'presentation' },
+                { file_path: 'src/types.ts', agent_name: 'bot1', change_type: 'modified', layer: 'data' }
+            ],
+            atomic: false
+        },
+        hint: "Max 50 file changes per batch. Use atomic:false for best-effort recording."
+    }
+};
+// ============================================================================
+// CONSTRAINT TOOL (3 actions)
+// ============================================================================
+export const CONSTRAINT_ACTION_SPECS = {
+    add: {
+        required: ['category', 'constraint_text', 'priority'],
+        optional: ['layer', 'tags', 'created_by'],
+        example: {
+            action: 'add',
+            category: 'performance',
+            constraint_text: 'API response time must be <100ms for 95th percentile',
+            priority: 'high',
+            layer: 'business',
+            tags: ['api', 'latency']
+        },
+        hint: "Valid categories: performance, architecture, security. Valid priorities: low, medium, high, critical"
+    },
+    get: {
+        required: [],
+        optional: ['category', 'layer', 'priority', 'tags', 'limit'],
+        example: {
+            action: 'get',
+            category: 'performance',
+            priority: 'high',
+            limit: 50
+        },
+        hint: "Returns only active constraints by default"
+    },
+    deactivate: {
+        required: ['constraint_id'],
+        optional: [],
+        example: {
+            action: 'deactivate',
+            constraint_id: 5
+        },
+        hint: "Soft delete - constraint remains in database but marked inactive"
+    }
+};
+// ============================================================================
+// STATS TOOL (5 actions)
+// ============================================================================
+export const STATS_ACTION_SPECS = {
+    layer_summary: {
+        required: [],
+        optional: [],
+        example: {
+            action: 'layer_summary'
+        },
+        hint: "Returns decision, file change, and constraint counts per layer"
+    },
+    db_stats: {
+        required: [],
+        optional: [],
+        example: {
+            action: 'db_stats'
+        },
+        hint: "Comprehensive statistics including task counts by status and priority"
+    },
+    clear: {
+        required: [],
+        optional: ['messages_older_than_hours', 'file_changes_older_than_days'],
+        example: {
+            action: 'clear',
+            messages_older_than_hours: 48,
+            file_changes_older_than_days: 14
+        },
+        hint: "If no parameters provided, uses config-based weekend-aware retention"
+    },
+    activity_log: {
+        required: [],
+        optional: ['since', 'agent_names', 'actions', 'limit'],
+        example: {
+            action: 'activity_log',
+            since: '1h',
+            agent_names: ['bot1', 'bot2'],
+            limit: 50
+        },
+        hint: "Use relative time formats: '5m', '1h', '2d' or ISO 8601 timestamps"
+    },
+    flush: {
+        required: [],
+        optional: [],
+        example: {
+            action: 'flush'
+        },
+        hint: "Forces WAL checkpoint to flush pending transactions. Run before git commits."
+    }
+};
+// ============================================================================
+// MASTER REGISTRY
+// ============================================================================
+export const ACTION_SPECS_BY_TOOL = {
+    decision: DECISION_ACTION_SPECS,
+    task: TASK_ACTION_SPECS,
+    file: FILE_ACTION_SPECS,
+    constraint: CONSTRAINT_ACTION_SPECS,
+    stats: STATS_ACTION_SPECS
+};
+/**
+ * Get action specification for a tool/action combination
+ * @param tool Tool name (e.g., 'decision', 'task')
+ * @param action Action name (e.g., 'set', 'create')
+ * @returns Action specification or null if not found
+ */
+export function getActionSpec(tool, action) {
+    const toolSpecs = ACTION_SPECS_BY_TOOL[tool];
+    if (!toolSpecs) {
+        return null;
+    }
+    return toolSpecs[action] || null;
+}
+/**
+ * Check if an action exists for a tool
+ * @param tool Tool name
+ * @param action Action name
+ * @returns True if action exists
+ */
+export function hasAction(tool, action) {
+    return getActionSpec(tool, action) !== null;
+}
+/**
+ * Get all action names for a tool
+ * @param tool Tool name
+ * @returns Array of action names or empty array if tool not found
+ */
+export function getToolActions(tool) {
+    const toolSpecs = ACTION_SPECS_BY_TOOL[tool];
+    if (!toolSpecs) {
+        return [];
+    }
+    return Object.keys(toolSpecs);
+}
+//# sourceMappingURL=action-specs.js.map

package/dist/utils/action-specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-specs.js","sourceRoot":"","sources":["../../src/utils/action-specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E,MAAM,CAAC,MAAM,qBAAqB,GAA+B;IAC/D,GAAG,EAAE;QACH,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;QAC1B,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC;QACnE,OAAO,EAAE;YACP,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,4BAA4B;YACjC,KAAK,EAAE,yGAAyG;YAChH,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,CAAC,UAAU,EAAE,cAAc,CAAC;YAClC,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,OAAO;SACjB;QACD,IAAI,EAAE,+DAA+D;KACtE;IAED,GAAG,EAAE;QACH,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,QAAQ,EAAE,CAAC,iBAAiB,CAAC;QAC7B,OAAO,EAAE;YACP,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,4BAA4B;YACjC,eAAe,EAAE,IAAI;SACtB;QACD,IAAI,EAAE,qEAAqE;KAC5E;IAED,IAAI,EAAE;QACJ,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC;QAC9E,OAAO,EAAE;YACP,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,EAAE;SACV;KACF;IAED,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,QAAQ,EAAE,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC;QAC3C,OAAO,EAAE;YACP,MAAM,EAAE,aAAa;YACrB,IAAI,EAAE,CAAC,UAAU,EAAE,gBAAgB,CAAC;YACpC,UAAU,EAAE,KAAK;YACjB,MAAM,EAAE,QAAQ;SACjB;QACD,IAAI,EAAE,wEAAwE;KAC/E;IAED,YAAY,EAAE;QACZ,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,QAAQ,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC;QACpC,OAAO,EAAE;YACP,MAAM,EAAE,cAAc;YACtB,KAAK,EAAE,UAAU;YACjB,MAAM,EAAE,QAAQ;YAChB,YAAY,EAAE,IAAI;SACnB;QACD,IAAI,EAAE,2EAA2E;KAClF;IAED,QAAQ,EAAE;QACR,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE;YACP,MAAM,EAAE,UAAU;YAClB,GAAG,EAAE,4BAA4B;SAClC;QACD,IAAI,EAAE,8DAA8D;KACrE;IAED,SAAS,EAAE;QACT,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;QAC1B,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;QACnE,OAAO,EAAE;YACP,MAAM,EAAE,WAAW;YACnB,GAAG,EAAE,qCAAqC;YAC1C,KAAK,EAAE,sEAAsE;SAC9E;QACD,IAAI,EAAE,iIAAiI;KACxI;IAED,eAAe,EAAE;QACf,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE;YACR,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ;YAC1D,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU;YAC3D,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ;SAC1D;QACD,OAAO,EAAE;YACP,MAAM,EAAE,iBAAiB;YACzB,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;YAC5B,QAAQ,EAAE,CAAC,UAAU,CAAC;YACtB,aAAa,EAAE,YAAY;YAC3B,OAAO,EAAE,SAAS;YAClB,UAAU,EAAE,MAAM;YAClB,KAAK,EAAE,EAAE;SACV;QACD,IAAI,EAAE,4FAA4F;KACnG;IAED,SAAS,EAAE;QACT,QAAQ,EAAE,CAAC,WAAW,CAAC;QACvB,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,OAAO,EAAE;YACP,MAAM,EAAE,WAAW;YACnB,SAAS,EAAE;gBACT,EAAE,GAAG,EAAE,oBAAoB,EAAE,KAAK,EAAE,iCAAiC,EAAE,KAAK,EAAE,gBAAgB,EAAE;gBAChG,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE;aAC7D;YACD,MAAM,EAAE,KAAK;SACd;QACD,IAAI,EAAE,kKAAkK;KACzK;IAED,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC,YAAY,EAAE,iBAAiB,CAAC;QAC3C,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE;YACP,MAAM,EAAE,aAAa;YACrB,UAAU,EAAE,UAAU;YACtB,eAAe,EAAE,sBAAsB;SACxC;QACD,IAAI,EAAE,wFAAwF;KAC/F;IAED,iBAAiB,EAAE;QACjB,QAAQ,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC;QACtC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;QACnE,OAAO,EAAE;YACP,MAAM,EAAE,mBAAmB;YAC3B,QAAQ,EAAE,iBAAiB;YAC3B,GAAG,EAAE,4BAA4B;YACjC,KAAK,EAAE,mDAAmD;SAC3D;QACD,IAAI,EAAE,2HAA2H;KAClI;IAED,eAAe,EAAE;QACf,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;QAC9B,QAAQ,EAAE,CAAC,iBAAiB,EAAE,YAAY,CAAC;QAC3C,OAAO,EAAE;YACP,MAAM,EAAE,iBAAiB;YACzB,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE;gBACR,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;gBACpB,MAAM,EAAE,QAAQ;aACjB;YACD,UAAU,EAAE,WAAW;SACxB;QACD,IAAI,EAAE,sEAAsE;KAC7E;IAED,cAAc,EAAE;QACd,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE;YACP,MAAM,EAAE,gBAAgB;SACzB;QACD,IAAI,EAAE,4CAA4C;KACnD;IAED,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE;YACP,MAAM,EAAE,aAAa;YACrB,GAAG,EAAE,mBAAmB;SACzB;QACD,IAAI,EAAE,4HAA4H;KACnI;IAED,oBAAoB,EAAE;QACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC;QAC9B,QAAQ,EAAE,CAAC,yBAAyB,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,CAAC;QAC5G,OAAO,EAAE;YACP,MAAM,EAAE,sBAAsB;YAC9B,GAAG,EAAE,4BAA4B;YACjC,SAAS,EAAE,iEAAiE;YAC5E,uBAAuB,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC;YACvD,SAAS,EAAE;gBACT,IAAI,EAAE,CAAC,wBAAwB,EAAE,yBAAyB,CAAC;gBAC3D,IAAI,EAAE,CAAC,gCAAgC,EAAE,wBAAwB,CAAC;aACnE;YACD,UAAU,EAAE,mBAAmB;SAChC;QACD,IAAI,EAAE,gFAAgF;KACvF;IAED,sBAAsB,EAAE;QACtB,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,CAAC,cAAc,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,CAAC;QACvG,OAAO,EAAE;YACP,MAAM,EAAE,wBAAwB;YAChC,YAAY,EAAE,4BAA4B;YAC1C,KAAK,EAAE,EAAE;SACV;QACD,IAAI,EAAE,gEAAgE;KACvE;CACF,CAAC;AAEF,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,iBAAiB,GAA+B;IAC3D,MAAM,EAAE;QACN,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,QAAQ,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC;QACrJ,OAAO,EAAE;YACP,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,8BAA8B;YACrC,WAAW,EAAE,qDAAqD;YAClE,QAAQ,EAAE,CAAC;YACX,cAAc,EAAE,eAAe;YAC/B,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,CAAC,gBAAgB,EAAE,UAAU,CAAC;YACpC,WAAW,EAAE,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;SAC1D;QACD,IAAI,EAAE,0GAA0G;KACjH;IAED,MAAM,EAAE;QACN,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,OAAO,EAAE,aAAa,CAAC;QACxH,OAAO,EAAE;YACP,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,CAAC;YACX,cAAc,EAAE,sBAAsB;YACtC,WAAW,EAAE,CAAC,kBAAkB,CAAC;SAClC;QACD,IAAI,EAAE,gEAAgE;KACvE;IAED,GAAG,EAAE;QACH,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,QAAQ,EAAE,CAAC,sBAAsB,CAAC;QAClC,OAAO,EAAE;YACP,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,CAAC;YACV,oBAAoB,EAAE,IAAI;SAC3B;QACD,IAAI,EAAE,qEAAqE;KAC5E;IAED,IAAI,EAAE;QACJ,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,2BAA2B,CAAC;QACvG,OAAO,EAAE;YACP,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,aAAa;YACrB,cAAc,EAAE,eAAe;YAC/B,KAAK,EAAE,EAAE;SACV;QACD,IAAI,EAAE,4EAA4E;KACnF;IAED,IAAI,EAAE;QACJ,QAAQ,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC;QACnC,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE;YACP,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,CAAC;YACV,UAAU,EAAE,aAAa;SAC1B;QACD,IAAI,EAAE,mFAAmF;KAC1F;IAED,IAAI,EAAE;QACJ,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC;QAC/C,QAAQ,EAAE,CAAC,eAAe,CAAC;QAC3B,OAAO,EAAE;YACP,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,UAAU;YACrB,SAAS,EAAE,iBAAiB;YAC5B,aAAa,EAAE,YAAY;SAC5B;QACD,IAAI,EAAE,uGAAuG;KAC9G;IAED,OAAO,EAAE;QACP,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE;YACP,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,CAAC;SACX;QACD,IAAI,EAAE,gDAAgD;KACvD;IAED,YAAY,EAAE;QACZ,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,OAAO,EAAE;YACP,MAAM,EAAE,cAAc;YACtB,KAAK,EAAE;gBACL,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,EAAE;gBACpC,EAAE,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,EAAE;gBACvC,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,EAAE;aACtC;YACD,MAAM,EAAE,KAAK;SACd;QACD,IAAI,EAAE,oEAAoE;KAC3E;IAED,cAAc,EAAE;QACd,QAAQ,EAAE,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;QAChD,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE;YACP,MAAM,EAAE,gBAAgB;YACxB,eAAe,EAAE,CAAC;YAClB,eAAe,EAAE,CAAC;SACnB;QACD,IAAI,EAAE,iFAAiF;KACxF;IAED,iBAAiB,EAAE;QACjB,QAAQ,EAAE,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;QAChD,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE;YACP,MAAM,EAAE,mBAAmB;YAC3B,eAAe,EAAE,CAAC;YAClB,eAAe,EAAE,CAAC;SACnB;QACD,IAAI,EAAE,iEAAiE;KACxE;IAED,gBAAgB,EAAE;QAChB,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,QAAQ,EAAE,CAAC,iBAAiB,CAAC;QAC7B,OAAO,EAAE;YACP,MAAM,EAAE,kBAAkB;YAC1B,OAAO,EAAE,CAAC;YACV,eAAe,EAAE,KAAK;SACvB;QACD,IAAI,EAAE,8EAA8E;KACrF;IAED,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;QAC/B,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,OAAO,EAAE;YACP,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,OAAO;YAClB,UAAU,EAAE,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;SACzD;QACD,IAAI,EAAE,0EAA0E;KACjF;CACF,CAAC;AAEF,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,iBAAiB,GAA+B;IAC3D,MAAM,EAAE;QACN,QAAQ,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,aAAa,CAAC;QACpD,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC;QAClC,OAAO,EAAE;YACP,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,iBAAiB;YAC5B,UAAU,EAAE,gBAAgB;YAC5B,WAAW,EAAE,UAAU;YACvB,KAAK,EAAE,UAAU;YACjB,WAAW,EAAE,sBAAsB;SACpC;QACD,IAAI,EAAE,+CAA+C;KACtD;IAED,GAAG,EAAE;QACH,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC;QAC/E,OAAO,EAAE;YACP,MAAM,EAAE,KAAK;YACb,UAAU,EAAE,gBAAgB;YAC5B,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,EAAE;SACV;QACD,IAAI,EAAE,8DAA8D;KACrE;IAED,UAAU,EAAE;QACV,QAAQ,EAAE,CAAC,WAAW,CAAC;QACvB,QAAQ,EAAE,CAAC,eAAe,CAAC;QAC3B,OAAO,EAAE;YACP,MAAM,EAAE,YAAY;YACpB,SAAS,EAAE,yBAAyB;YACpC,aAAa,EAAE,GAAG;SACnB;QACD,IAAI,EAAE,8EAA8E;KACrF;IAED,YAAY,EAAE;QACZ,QAAQ,EAAE,CAAC,cAAc,CAAC;QAC1B,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,OAAO,EAAE;YACP,MAAM,EAAE,cAAc;YACtB,YAAY,EAAE;gBACZ,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,EAAE;gBAC/F,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE;aAC1F;YACD,MAAM,EAAE,KAAK;SACd;QACD,IAAI,EAAE,4EAA4E;KACnF;CACF,CAAC;AAEF,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E,MAAM,CAAC,MAAM,uBAAuB,GAA+B;IACjE,GAAG,EAAE;QACH,QAAQ,EAAE,CAAC,UAAU,EAAE,iBAAiB,EAAE,UAAU,CAAC;QACrD,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC;QACzC,OAAO,EAAE;YACP,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,aAAa;YACvB,eAAe,EAAE,sDAAsD;YACvE,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC;SACzB;QACD,IAAI,EAAE,sGAAsG;KAC7G;IAED,GAAG,EAAE;QACH,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC;QAC5D,OAAO,EAAE;YACP,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,aAAa;YACvB,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,EAAE;SACV;QACD,IAAI,EAAE,4CAA4C;KACnD;IAED,UAAU,EAAE;QACV,QAAQ,EAAE,CAAC,eAAe,CAAC;QAC3B,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE;YACP,MAAM,EAAE,YAAY;YACpB,aAAa,EAAE,CAAC;SACjB;QACD,IAAI,EAAE,kEAAkE;KACzE;CACF,CAAC;AAEF,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,kBAAkB,GAA+B;IAC5D,aAAa,EAAE;QACb,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE;YACP,MAAM,EAAE,eAAe;SACxB;QACD,IAAI,EAAE,gEAAgE;KACvE;IAED,QAAQ,EAAE;QACR,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE;YACP,MAAM,EAAE,UAAU;SACnB;QACD,IAAI,EAAE,uEAAuE;KAC9E;IAED,KAAK,EAAE;QACL,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,CAAC,2BAA2B,EAAE,8BAA8B,CAAC;QACvE,OAAO,EAAE;YACP,MAAM,EAAE,OAAO;YACf,yBAAyB,EAAE,EAAE;YAC7B,4BAA4B,EAAE,EAAE;SACjC;QACD,IAAI,EAAE,sEAAsE;KAC7E;IAED,YAAY,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC;QACtD,OAAO,EAAE;YACP,MAAM,EAAE,cAAc;YACtB,KAAK,EAAE,IAAI;YACX,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;YAC7B,KAAK,EAAE,EAAE;SACV;QACD,IAAI,EAAE,oEAAoE;KAC3E;IAED,KAAK,EAAE;QACL,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE;YACP,MAAM,EAAE,OAAO;SAChB;QACD,IAAI,EAAE,8EAA8E;KACrF;CACF,CAAC;AAEF,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,oBAAoB,GAA+C;IAC9E,QAAQ,EAAE,qBAAqB;IAC/B,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,iBAAiB;IACvB,UAAU,EAAE,uBAAuB;IACnC,KAAK,EAAE,kBAAkB;CAC1B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,MAAc;IACxD,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,MAAc;IACpD,OAAO,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAChC,CAAC"}

package/dist/utils/error-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmBH;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,GAAG,GACX;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAyBrC;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAiB5D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,CAAC,EAAE,MAAM,IAAI,GACrB,IAAI,CAsDN;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,GACxB,MAAM,CAMR"}
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoCH;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,GAAG,GACX;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAyBrC;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAiB5D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,CAAC,EAAE,MAAM,IAAI,GACrB,IAAI,CAsDN;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,GACxB,MAAM,CAMR"}

package/dist/utils/error-handler.js

@@ -3,6 +3,23 @@
  * Provides consistent error logging, reporting, and recovery
  */
 import { debugLog, debugLogError } from './debug-logger.js';
+/**
+ * Safe console error wrapper that prevents EPIPE errors from crashing the error handler
+ * When the pipe to Claude Code is broken, console.error throws EPIPE
+ * This wrapper silently fails instead of creating cascading errors
+ */
+function safeConsoleError(...args) {
+    try {
+        // Check if stderr is writable before attempting to write
+        if (process.stderr && process.stderr.writable) {
+            console.error(...args);
+        }
+    }
+    catch (error) {
+        // Silently ignore EPIPE and other write errors
+        // The debug logger will still capture the original error
+    }
+}
 /**
  * Format error details for logging and reporting
  */
@@ -26,17 +43,17 @@ export function handleToolError(toolName, action, error, params) {
         errorType: errorType,
         stack: stack
     });
-    // Log to stderr for immediate visibility
-    console.error(`\n❌ ERROR in ${toolName}.${action}:`);
-    console.error(`   Message: ${message}`);
+    // Log to stderr for immediate visibility (pipe-safe)
+    safeConsoleError(`\n❌ ERROR in ${toolName}.${action}:`);
+    safeConsoleError(`   Message: ${message}`);
     if (stack) {
-        console.error(`   Stack trace:`);
-        console.error(stack.split('\n').map(line => `     ${line}`).join('\n'));
+        safeConsoleError(`   Stack trace:`);
+        safeConsoleError(stack.split('\n').map(line => `     ${line}`).join('\n'));
     }
     if (params) {
-        console.error(`   Params: ${JSON.stringify(params, null, 2)}`);
+        safeConsoleError(`   Params: ${JSON.stringify(params, null, 2)}`);
     }
-    console.error('');
+    safeConsoleError('');
     return { message, stack };
 }
 /**
@@ -49,13 +66,13 @@ export function handleInitializationError(error) {
         errorType: errorType,
         stack: stack
     });
-    console.error('\n❌ INITIALIZATION ERROR:');
-    console.error(`   Message: ${message}`);
+    safeConsoleError('\n❌ INITIALIZATION ERROR:');
+    safeConsoleError(`   Message: ${message}`);
     if (stack) {
-        console.error(`   Stack trace:`);
-        console.error(stack.split('\n').map(line => `     ${line}`).join('\n'));
+        safeConsoleError(`   Stack trace:`);
+        safeConsoleError(stack.split('\n').map(line => `     ${line}`).join('\n'));
     }
-    console.error('');
+    safeConsoleError('');
     return message;
 }
 /**
@@ -66,42 +83,42 @@ export function setupGlobalErrorHandlers(onCleanup) {
     // Handle uncaught exceptions
     process.on('uncaughtException', (error) => {
         const { message, stack, errorType } = formatErrorDetails(error);
-        console.error('\n❌ UNCAUGHT EXCEPTION (server continuing):');
-        console.error(`   Message: ${message}`);
-        console.error(`   Stack trace:`);
-        console.error(stack?.split('\n').map(line => `     ${line}`).join('\n'));
+        safeConsoleError('\n❌ UNCAUGHT EXCEPTION (server continuing):');
+        safeConsoleError(`   Message: ${message}`);
+        safeConsoleError(`   Stack trace:`);
+        safeConsoleError(stack?.split('\n').map(line => `     ${line}`).join('\n'));
         debugLogError('UNCAUGHT_EXCEPTION', error, {
             errorType: errorType,
             stack: stack
         });
-        console.error('   ⚠️  Server continuing despite error\n');
+        safeConsoleError('   ⚠️  Server continuing despite error\n');
     });
     // Handle unhandled promise rejections
     process.on('unhandledRejection', (reason, promise) => {
         const { message, stack, errorType } = formatErrorDetails(reason);
-        console.error('\n❌ UNHANDLED PROMISE REJECTION (server continuing):');
-        console.error(`   Reason: ${message}`);
+        safeConsoleError('\n❌ UNHANDLED PROMISE REJECTION (server continuing):');
+        safeConsoleError(`   Reason: ${message}`);
         if (stack) {
-            console.error(`   Stack trace:`);
-            console.error(stack.split('\n').map(line => `     ${line}`).join('\n'));
+            safeConsoleError(`   Stack trace:`);
+            safeConsoleError(stack.split('\n').map(line => `     ${line}`).join('\n'));
         }
         debugLogError('UNHANDLED_REJECTION', reason, {
             errorType: errorType,
             stack: stack,
             promise: String(promise)
         });
-        console.error('   ⚠️  Server continuing despite error\n');
+        safeConsoleError('   ⚠️  Server continuing despite error\n');
     });
     // Handle graceful shutdown
     process.on('SIGINT', async () => {
-        console.error('\n✓ Shutting down MCP server...');
+        safeConsoleError('\n✓ Shutting down MCP server...');
         if (onCleanup) {
             onCleanup();
         }
         process.exit(0);
     });
     process.on('SIGTERM', async () => {
-        console.error('\n✓ Shutting down MCP server...');
+        safeConsoleError('\n✓ Shutting down MCP server...');
         if (onCleanup) {
             onCleanup();
         }