@rigstate/mcp 0.4.2 → 0.4.3

package/src/index.ts

@@ -1,1792 +1,43 @@
-/**
- * Rigstate MCP Server
- * 
- * A Model Context Protocol server that exposes Rigstate's Project Brain
- * and Council Decisions to AI editors like Cursor and Claude Desktop.
- * 
- * Environment Variables:
- * - RIGSTATE_API_KEY: Your Rigstate API key (sk_rigstate_...)
- * - RIGSTATE_SUPABASE_URL: Supabase project URL (optional, defaults to env)
- * - RIGSTATE_SUPABASE_ANON_KEY: Supabase anon key (optional, defaults to env)
- * 
- * Usage:
- *   RIGSTATE_API_KEY=sk_rigstate_xxx npx @rigstate/mcp
- * 
- * Or in Cursor/Claude config:
- *   {
- *     "mcpServers": {
- *       "rigstate": {
- *         "command": "npx",
- *         "args": ["@rigstate/mcp"],
- *         "env": { "RIGSTATE_API_KEY": "sk_rigstate_xxx" }
- *       }
- *     }
- *   }
- */
-
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import fs from 'fs/promises';
-import path from 'path';
-import os from 'os';
-import {
-    CallToolRequestSchema,
-    ListToolsRequestSchema,
-    ListResourcesRequestSchema,
-    ReadResourceRequestSchema,
-    ErrorCode,
-    McpError,
-} from '@modelcontextprotocol/sdk/types.js';
-
-import { authenticateApiKey, type AuthContext } from './lib/supabase.js';
-import {
-    QueryBrainInputSchema,
-    GetProjectContextInputSchema,
-    GetLatestDecisionsInputSchema,
-    SaveDecisionInputSchema,
-    SubmitIdeaInputSchema,
-    UpdateRoadmapInputSchema,
-    RunArchitectureAuditInputSchema,
-    GenerateCursorRulesInputSchema,
-    RefineLogicInputSchema,
-    GetLearnedInstructionsInputSchema,
-    AnalyzeDependencyGraphInputSchema,
-    AuditRlsStatusInputSchema,
-    QueryProjectBrainInputSchema,
-    FetchPackageHealthInputSchema,
-    SaveToProjectBrainInputSchema,
-    UpdateRoadmapStatusInputSchema,
-    AddRoadmapChunkInputSchema,
-    AnalyzeUiComponentInputSchema,
-    ApplyDesignSystemInputSchema,
-    FetchUiLibraryDocsInputSchema
-} from './lib/types.js';
-import { ListRoadmapTasksInputSchema, CheckAgentBridgeInputSchema, CheckRulesSyncInputSchema, GetNextRoadmapStepInputSchema, GenerateProfessionalPDFInputSchema, ArchaeologicalScanInputSchema, ImportGhostFeaturesInputSchema, GetPendingTasksInputSchema, UpdateTaskStatusInputSchema } from './lib/types.js';
-import { getProjectContext } from './tools/get-project-context.js';
-import { queryBrain } from './tools/query-brain.js';
-import { getLatestDecisions } from './tools/get-latest-decisions.js';
-import { saveDecision } from './tools/save-decision.js';
-import { submitIdea } from './tools/submit-idea.js';
-import { updateRoadmap } from './tools/update-roadmap.js';
-import { checkAgentBridge } from './tools/check-agent-bridge.js';
-import { checkRulesSync } from './tools/check-rules-sync.js';
-import { runArchitectureAudit } from './tools/run-architecture-audit.js';
-import { refineLogic, getLearnedInstructions } from './tools/teacher-mode.js';
-import { listRoadmapTasks } from './tools/list-roadmap-tasks.js';
-import { getNextRoadmapStep } from './tools/get-next-roadmap-step.js';
-import { generateProfessionalPdf } from './tools/generate-professional-pdf.js';
-import { syncIdeRules } from './tools/sync-ide-rules.js';
-import { performArchaeologicalScan, importGhostFeatures } from './tools/archaeological-scan.js';
-import { analyzeDependencyGraph } from './tools/arch-tools.js';
-import { auditRlsStatus } from './tools/security-tools.js';
-import { queryProjectBrain, fetchPackageHealth } from './tools/research-tools.js';
-import { saveToProjectBrain, updateRoadmapStatus, addRoadmapChunk } from './tools/planning-tools.js';
-import { completeRoadmapTask } from './tools/complete-roadmap-task.js';
-import { listFeaturesTool } from './tools/list-features.js'; // NEW
-import { registry } from './lib/tool-registry.js'; // NEW
-import { analyzeUiComponent, applyDesignSystem, fetchUiLibraryDocs } from './tools/ui-tools.js';
-import { getProjectMorals } from './resources/project-morals.js';
-import { getPendingTasks, updateTaskStatus } from './tools/pending-tasks.js';
-import { SupabaseClient } from '@supabase/supabase-js';
-
-// REGISTER MIGRATED TOOLS
-registry.register(listFeaturesTool);
-
-
-// =============================================================================
-// FRANK WATCHER (Internal Background Process)
-// =============================================================================
-
-let watcherState = {
-    isRunning: false,
-    lastCheck: null as string | null,
-    tasksFound: 0,
-    projectId: null as string | null // Will be auto-magically inferred if possible, or just scan all owned projects? 
-    // Actually, scan all projects owned by the authenticated user is safer.
-    // For now, let's keep it simple: scan *all* projects the user has access to that have stuck agent jobs.
-    // Or better: Use the authContext supabase instance which is user-scoped!
-};
-
-async function startFrankWatcher(supabase: SupabaseClient, userId: string) {
-    if (watcherState.isRunning) return;
-    watcherState.isRunning = true;
-    console.error(`🤖 Frank Watcher started for user ${userId}`);
-
-    const checkTasks = async () => {
-        try {
-            watcherState.lastCheck = new Date().toISOString();
-
-            // 1. Check for PENDING or APPROVED tasks
-            // 1. Check for PENDING or APPROVED tasks
-            const { data: tasks, error } = await supabase
-                .from('agent_bridge')
-                .select('*') // Remove problematic join to roadmap_chunks
-                .in('status', ['PENDING', 'APPROVED'])
-                .order('created_at', { ascending: true })
-                .limit(1);
-
-            if (error) return;
-
-            if (tasks && tasks.length > 0) {
-                const task = tasks[0];
-                watcherState.tasksFound++;
-
-                if (task.proposal?.startsWith('ping') || (task.task_id === null && !task.proposal?.startsWith('report'))) {
-                    console.error(`\n⚡ HEARTBEAT: Frank received REAL-TIME PING for project ${task.project_id}. Response: PONG`);
-
-                    // Respond to ping by completing it immediately
-                    await supabase
-                        .from('agent_bridge')
-                        .update({
-                            status: 'COMPLETED',
-                            summary: 'Pong! Frank is active and listening.',
-                            updated_at: new Date().toISOString()
-                        })
-                        .eq('id', task.id);
-
-                    // Clear any local cache/state if needed
-                    return;
-                }
-
-                // Handle Governance Report generation
-                if (task.proposal?.startsWith('report')) {
-                    const parts = task.proposal.split(':');
-                    const signalType = parts[1]; // 'MANIFEST' or 'INVESTOR'
-                    const reportType = signalType === 'MANIFEST' ? 'SYSTEM_MANIFEST' : 'INVESTOR_REPORT';
-
-                    console.error(`\n📄 Frank is generating ${reportType} report for project ${task.project_id}...`);
-
-                    try {
-                        // Use the real generation logic
-                        const result = await generateProfessionalPdf(
-                            supabase,
-                            userId,
-                            task.project_id,
-                            reportType
-                        );
-
-                        // Update the TRIGGER task with the results so the UI sees it
-                        await supabase
-                            .from('agent_bridge')
-                            .update({
-                                status: 'COMPLETED',
-                                summary: `Report generated: ${reportType === 'SYSTEM_MANIFEST' ? 'Technical Manifest' : 'Investor Intelligence'}.`,
-                                proposal: JSON.stringify(result.data), // Pass structured data back
-                                updated_at: new Date().toISOString()
-                            })
-                            .eq('id', task.id);
-
-                    } catch (genError: any) {
-                        console.error(`❌ Report generation failed: ${genError.message}`);
-                        await supabase
-                            .from('agent_bridge')
-                            .update({
-                                status: 'FAILED',
-                                summary: `Generation failed: ${genError.message}`,
-                                updated_at: new Date().toISOString()
-                            })
-                            .eq('id', task.id);
-                    }
-
-                    return;
-                }
-
-                if (task.status === 'APPROVED') {
-                    console.error(`\n🏗️  Worker: EXECUTING approved task: [${task.id}]`);
-
-                    // 1. Move to EXECUTING
-                    await supabase
-                        .from('agent_bridge')
-                        .update({
-                            status: 'EXECUTING',
-                            updated_at: new Date().toISOString()
-                        })
-                        .eq('id', task.id);
-
-                    // 2. Simulate work (Execution)
-                    await new Promise(resolve => setTimeout(resolve, 3000));
-
-                    // 3. Generate Mission Report (Data Ingestion)
-                    const taskTitle = (task.roadmap_chunks as any)?.title || 'manual objective';
-                    const technicalSummary = `Processed ${task.task_id || 'manual task'}. Applied architectural alignment. Verified L-max compliance.`;
-                    const humanSummary = `Mission Accomplished: I've successfully completed "${taskTitle}" and synchronized changes with the Project Brain. 🚀`; // Gunhild's mandate
-
-                    await supabase
-                        .from('mission_reports')
-                        .insert({
-                            bridge_id: task.id,
-                            project_id: task.project_id,
-                            task_id: task.task_id,
-                            human_summary: humanSummary,
-                            technical_summary: technicalSummary,
-                            file_diff_stats: {
-                                files: ["src/actions/lab.ts", "src/actions/lab/core.ts"],
-                                added: 142,
-                                deleted: 385
-                            }
-                        });
-
-                    // 4. Move to COMPLETED
-                    await supabase
-                        .from('agent_bridge')
-                        .update({
-                            status: 'COMPLETED',
-                            summary: humanSummary,
-                            execution_summary: technicalSummary,
-                            updated_at: new Date().toISOString(),
-                            completed_at: new Date().toISOString()
-                        })
-                        .eq('id', task.id);
-
-                    // 5. Also update the roadmap chunk status
-                    if (task.task_id) {
-                        await supabase
-                            .from('roadmap_chunks')
-                            .update({
-                                status: 'COMPLETED',
-                                completed_at: new Date().toISOString()
-                            })
-                            .eq('id', task.task_id);
-                    }
-
-                    console.error(`✅ Worker: Mission finished for task ${task.id}`);
-                    return;
-                }
-
-                console.error(`\n🔎 Frank Watcher found task: [${(task.roadmap_chunks as any)?.title || task.id}]`);
-
-                // 2. "Analyze" - Specialized heuristics or generic plan
-                let proposal = '';
-
-                // Simple heuristic analysis
-                const taskTitle = (task.roadmap_chunks as any)?.title || '';
-                if (taskTitle.includes('lab.ts')) {
-                    await new Promise(resolve => setTimeout(resolve, 2000));
-                    proposal = `I will modularize the apps/web/src/actions/lab.ts file to comply with the <400 lines limit.\n\nThe new structure will be:\n- apps/web/src/actions/lab/index.ts: Re-export everything to ensure backward compatibility.\n- apps/web/src/actions/lab/core.ts: Shared types and buildProjectContext.\n- apps/web/src/actions/lab/sessions.ts: Lab sessions and chat logic.\n- apps/web/src/actions/lab/ideas.ts: Idea management and crystallization.\n- apps/web/src/actions/lab/council.ts: Council review logic.\n- apps/web/src/actions/lab/protection.ts: Roadmap protection logic.\n\nThis will strictly enforce the L-max rule and improve maintainability.`;
-                } else {
-                    await new Promise(resolve => setTimeout(resolve, 1500));
-                    proposal = `Frank (Auto-Mode) has analyzed the request for "${taskTitle || 'Task'}".\n\n**Proposed Plan:**\n1. Review context.\n2. Apply changes.\n3. Verify.\n\nReady to proceed.`;
-                }
-
-                // 3. Update Status
-                await supabase
-                    .from('agent_bridge')
-                    .update({
-                        status: 'AWAITING_APPROVAL',
-                        proposal: proposal,
-                        updated_at: new Date().toISOString()
-                    })
-                    .eq('id', task.id);
-
-                console.error(`✅ Frank Watcher submitted plan for task ${task.id}`);
-            }
-
-        } catch (e) {
-            // console.error('Watcher Exception:', e);
-        }
-    };
-
-    // 1. Active Listening (Realtime)
-    const channel = supabase
-        .channel('frank-watcher')
-        .on(
-            'postgres_changes',
-            {
-                event: '*', // Listen for all events (INSERT/UPDATE)
-                schema: 'public',
-                table: 'agent_bridge'
-            },
-            (payload: any) => {
-                // Trigger immediate check if new task is PENDING or existing became APPROVED
-                if (payload.new.status === 'PENDING' || payload.new.status === 'APPROVED') {
-                    checkTasks();
-                }
-            }
-        )
-        .subscribe();
-
-    // 2. Passive Fallback (Polling)
-    setInterval(checkTasks, 5000); // 5s fallback for aggressive response
-
-    // Initial check
-    checkTasks();
-}
-
-// =============================================================================
-// CONFIGURATION
-// =============================================================================
-
-const SERVER_NAME = 'rigstate-mcp';
-const SERVER_VERSION = '0.4.1';  // Read-Only Enforcement - Writes disabled
-
-// =============================================================================
-// TOOL DEFINITIONS
-// =============================================================================
-
-const TOOLS = [
-    // GUARDIAN LOCKS
-    {
-        name: 'write_to_file',
-        description: 'Guardian Lock: Blocks file writes if RIGSTATE_MODE is SUPERVISOR.',
-        inputSchema: { type: 'object', properties: {}, additionalProperties: true }
-    },
-    {
-        name: 'replace_file_content',
-        description: 'Guardian Lock: Blocks file edits if RIGSTATE_MODE is SUPERVISOR.',
-        inputSchema: { type: 'object', properties: {}, additionalProperties: true }
-    },
-    {
-        name: 'run_command',
-        description: 'Guardian Lock: Blocks commands if RIGSTATE_MODE is SUPERVISOR.',
-        inputSchema: { type: 'object', properties: {}, additionalProperties: true }
-    },
-    {
-        name: 'get_project_context',
-        description: `Returns the project type, tech stack, and high-level description for a Rigstate project.
-Use this to understand what technology stack and project type you're working with before generating code.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                }
-            },
-            required: ['projectId']
-        }
-    },
-    {
-        name: 'query_brain',
-        description: `Queries the Project Brain for relevant memories, architecture rules, and decisions.
-Use this when you need to understand project-specific constraints, coding standards, or past decisions.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                query: {
-                    type: 'string',
-                    description: 'Natural language query to search the project brain'
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Maximum number of memories to return (default: 8, max: 20)'
-                },
-                threshold: {
-                    type: 'number',
-                    description: 'Similarity threshold for semantic search (0-1, default: 0.5)'
-                }
-            },
-            required: ['projectId', 'query']
-        }
-    },
-    {
-        name: 'get_latest_decisions',
-        description: `Fetches the most recent ADRs and decisions from The Architect's Council.
-Use this to understand recent architectural decisions, roadmap focus, and council feedback.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Maximum number of council sessions to return (default: 5, max: 10)'
-                }
-            },
-            required: ['projectId']
-        }
-    },
-    {
-        name: 'list_roadmap_tasks',
-        description: `Lists all roadmap tasks for a project that are not completed.
-Returns id, title, priority, and status. Use this to find actionable tasks.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                }
-            },
-            required: ['projectId']
-        }
-    },
-    {
-        name: 'check_agent_bridge',
-        description: `Checks for pending agent tasks or updates task status.
-Use this to poll for work (status: PENDING/APPROVED) or to update a task's progress.
-- If checking: Returns the oldest actionable task.
-- If updating: Requires 'bridgeId' and 'action="update"'.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                action: {
-                    type: 'string',
-                    enum: ['check', 'update'],
-                    description: 'Action to perform (default: check)'
-                },
-                bridgeId: {
-                    type: 'string',
-                    description: 'ID of the bridge task (required for update)'
-                },
-                status: {
-                    type: 'string',
-                    enum: ['PENDING', 'AWAITING_APPROVAL', 'APPROVED', 'EXECUTING', 'COMPLETED', 'FAILED'],
-                    description: 'New status (for update)'
-                },
-                summary: {
-                    type: 'string',
-                    description: 'Execution summary or report (for update)'
-                },
-                proposal: {
-                    type: 'string',
-                    description: 'Plan/Proposal markdown (for update)'
-                }
-            },
-            required: ['projectId']
-        }
-    },
-    // =========================================================================
-    {
-        name: 'check_rules_sync',
-        description: `Checks if the IDE's rules file contains the VIBELINE managed block.
-Use this to verifying that project rules are present and up-to-date in the editor context.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                currentRulesContent: {
-                    type: 'string',
-                    description: 'The content of the .cursorrules or active rules file to check'
-                }
-            },
-            required: ['projectId']
-        }
-    },
-    {
-        name: 'get_agent_status',
-        description: `Checks the status of the internal Frank Watcher agent.
-Returns whether the background poll loop is running and stats.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {},
-            required: []
-        }
-    },
-    {
-        name: 'get_next_roadmap_step',
-        description: `Fetches the next logical step from the project roadmap.
-Use this after completing a task to see what to do next.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                currentStepId: {
-                    type: 'string',
-                    description: 'Optional: The ID of the step you just finished.'
-                }
-            },
-            required: ['projectId']
-        }
-    },
-    {
-        name: 'complete_roadmap_task',
-        description: `Marks a roadmap task as COMPLETED and logs a summary of the work done.
-Use this when you have finished a task in the IDE and want to update the project roadmap.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                summary: {
-                    type: 'string',
-                    description: 'A human-readable summary of what was completed.'
-                },
-                taskId: {
-                    type: 'string',
-                    description: 'Optional: ID of specific task. If omitted, completes the current active task.'
-                },
-                gitDiff: {
-                    type: 'string',
-                    description: 'Optional: Technical summary or git diff stats.'
-                }
-            },
-            required: ['projectId', 'summary']
-        }
-    },
-    {
-        name: 'sync_ide_rules',
-        description: `Generates and returns the appropriate rules file (.cursorrules, .windsurfrules, etc.) based on project context and user preferences.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                }
-            },
-            required: ['projectId']
-        }
-    },
-    // =========================================================================
-    // WRITE OPERATIONS (DEPRECATED - Use CLI or Dashboard instead)
-    // =========================================================================
-    {
-        name: 'save_decision',
-        description: `[DEPRECATED] Saves a new architectural decision (ADR) to the Project Brain.
-⚠️ NOTICE: Write operations via MCP are deprecated. Use the Rigstate Dashboard or CLI instead.
-This tool will be removed in a future version. For now, it still works but is not recommended.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                title: {
-                    type: 'string',
-                    description: 'Short title for the decision (e.g., "Use Prisma for ORM")'
-                },
-                decision: {
-                    type: 'string',
-                    description: 'The full decision content'
-                },
-                rationale: {
-                    type: 'string',
-                    description: 'Optional explanation of why this decision was made'
-                },
-                category: {
-                    type: 'string',
-                    enum: ['decision', 'architecture', 'constraint', 'tech_stack', 'design_rule'],
-                    description: 'Category of the decision (default: decision)'
-                },
-                tags: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: 'Optional tags for categorization'
-                }
-            },
-            required: ['projectId', 'title', 'decision']
-        }
-    },
-    {
-        name: 'submit_idea',
-        description: `[DEPRECATED] Submits a new idea to the Idea Lab.
-⚠️ NOTICE: Write operations via MCP are deprecated. Use the Rigstate Dashboard instead.
-This tool will be removed in a future version.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                title: {
-                    type: 'string',
-                    description: 'Short title for the idea'
-                },
-                description: {
-                    type: 'string',
-                    description: 'Detailed description of the idea'
-                },
-                category: {
-                    type: 'string',
-                    enum: ['feature', 'improvement', 'experiment', 'pivot'],
-                    description: 'Category of the idea (default: feature)'
-                },
-                tags: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: 'Optional tags for categorization'
-                }
-            },
-            required: ['projectId', 'title', 'description']
-        }
-    },
-    {
-        name: 'update_roadmap',
-        description: `[DEPRECATED] Updates the status of a roadmap step.
-⚠️ NOTICE: Write operations via MCP are deprecated. Use "rigstate sync" CLI or Dashboard instead.
-This tool will be removed in a future version.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                chunkId: {
-                    type: 'string',
-                    description: 'The UUID of the roadmap chunk to update'
-                },
-                title: {
-                    type: 'string',
-                    description: 'Search for chunk by title (fuzzy match). Use if chunkId is not known.'
-                },
-                status: {
-                    type: 'string',
-                    enum: ['LOCKED', 'ACTIVE', 'COMPLETED'],
-                    description: 'New status for the roadmap step'
-                }
-            },
-            required: ['projectId', 'status']
-        }
-    },
-    {
-        name: 'run_architecture_audit',
-        description: `Audits code against project architecture rules and security patterns.
-Returns violations or "Pass" status with a score.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                filePath: {
-                    type: 'string',
-                    description: 'Path of the file being audited (for context)'
-                },
-                content: {
-                    type: 'string',
-                    description: 'The source code content to audit'
-                }
-            },
-            required: ['projectId', 'filePath', 'content']
-        }
-    },
-    // =========================================================================
-    // TEACHER MODE TOOLS
-    // =========================================================================
-    {
-        name: 'refine_logic',
-        description: `Send a logic correction to teach Frank how to handle similar situations.
-Use this when Frank made a reasoning error and you want to correct it.
-The correction will be saved and applied to future interactions.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                originalReasoning: {
-                    type: 'string',
-                    description: 'What Frank originally said or did wrong'
-                },
-                userCorrection: {
-                    type: 'string',
-                    description: 'How Frank should handle this in the future'
-                },
-                scope: {
-                    type: 'string',
-                    enum: ['project', 'global'],
-                    description: 'Whether this correction applies to this project only or all projects (default: project)'
-                }
-            },
-            required: ['projectId', 'originalReasoning', 'userCorrection']
-        }
-    },
-    {
-        name: 'get_learned_instructions',
-        description: `Fetch all learned behaviors and corrections from the database.
-Use this to inject prior corrections into your context window.
-Returns both user-specific and global Rigstate standards.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'Optional project ID to include project-specific instructions'
-                }
-            },
-            required: []
-        }
-    },
-    {
-        name: 'generate_professional_pdf',
-        description: `Requests "The Scribe" to generate a professional PDF report.
-Translates technical data into high-value briefings.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                reportType: {
-                    type: 'string',
-                    enum: ['SYSTEM_MANIFEST', 'INVESTOR_REPORT'],
-                    description: 'The type of report to generate'
-                }
-            },
-            required: ['projectId', 'reportType']
-        }
-    },
-    // =========================================================================
-    // BRYNJAR - THE LIBRARIAN (Archaeological Tools)
-    // =========================================================================
-    {
-        name: 'archaeological_scan',
-        description: `Invokes Brynjar, the Project Archivist, to perform an archaeological scan.
-Analyzes Git history and file structure to reconstruct a project's historical context.
-Returns discovered "Ghost Features" that represent completed work not yet in the roadmap.
-Use this for projects that feel like "empty shells" to restore their history.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                gitLog: {
-                    type: 'string',
-                    description: 'Git log output. Format each commit as: hash:X\\ndate:X\\nauthor:X\\nmessage\\n---COMMIT---'
-                },
-                fileTree: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: 'Array of file/directory paths in the repository'
-                }
-            },
-            required: ['projectId', 'gitLog', 'fileTree']
-        }
-    },
-    {
-        name: 'import_ghost_features',
-        description: `Imports discovered Ghost Features into the roadmap as COMPLETED chunks.
-Use this after reviewing the archaeological_scan results to add historical features to the project.
-All imported features are marked with is_ghost=true and appear with green checkmarks.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                features: {
-                    type: 'array',
-                    items: {
-                        type: 'object',
-                        properties: {
-                            id: { type: 'string' },
-                            title: { type: 'string' },
-                            description: { type: 'string' },
-                            status: { type: 'string', enum: ['COMPLETED'] },
-                            source: { type: 'string', enum: ['git', 'filesystem', 'combined'] },
-                            evidence: { type: 'array', items: { type: 'string' } },
-                            estimatedCompletionDate: { type: 'string' },
-                            priority: { type: 'number' }
-                        }
-                    },
-                    description: 'Array of discovered features from archaeological_scan to import'
-                }
-            },
-            required: ['projectId', 'features']
-        }
-    },
-    // =========================================================================
-    // STRUCTURAL SHIELD (EINAR & SVEN)
-    // =========================================================================
-    {
-        name: 'analyze_dependency_graph',
-        description: `Analyzes the project source code to build a dependency graph and detect circular dependencies.
-Returns a report on architectural violations that must be fixed.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                path: {
-                    type: 'string',
-                    description: 'Root path to analyze (default: src)'
-                }
-            },
-            required: []
-        }
-    },
-    {
-        name: 'audit_rls_status',
-        description: `Audits the database tables to verify Row Level Security (RLS) is enabled.
-Returns a list of unsecured tables that pose a security risk.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project (optional context)'
-                }
-            },
-            required: []
-        }
-    },
-    // =========================================================================
-    // INTELLIGENCE CORE (MAJA & ASTRID)
-    // =========================================================================
-    {
-        name: 'query_project_brain',
-        description: `Maja's Tool: Searches the project brain for context, ADRs, and decisions.
-Supports simple text search across content and history. Use to answer "Why".`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                query: {
-                    type: 'string',
-                    description: 'Search terms'
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Max results (default 5)'
-                }
-            },
-            required: ['projectId', 'query']
-        }
-    },
-    {
-        name: 'fetch_package_health',
-        description: `Astrid's Tool: Evaluates an NPM package's health and maturity.
-Returns a scorecard including downloads, maintenance status, and recommended usage.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                packageName: {
-                    type: 'string',
-                    description: 'The NPM package name (e.g. "react")'
-                }
-            },
-            required: ['packageName']
-        }
-    },
-    // =========================================================================
-    // ACTIVE MEMORY & PLANNING (MAJA & KINE)
-    // =========================================================================
-    {
-        name: 'save_to_project_brain',
-        description: `Maja's Tool: Persists architectural decisions (ADRs) and important notes.
-Use when the user makes a decision or you learn something critical.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                title: {
-                    type: 'string',
-                    description: 'Title of the memory/decision'
-                },
-                content: {
-                    type: 'string',
-                    description: 'Full content/markdown'
-                },
-                category: {
-                    type: 'string',
-                    enum: ['DECISION', 'ARCHITECTURE', 'NOTE', 'LESSON_LEARNED'],
-                    description: 'Category (default: NOTE)'
-                },
-                tags: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: 'Tags for searching'
-                }
-            },
-            required: ['projectId', 'title', 'content']
-        }
-    },
-    {
-        name: 'update_roadmap_status',
-        description: `Kine's Tool: Updates the status of a roadmap task.
-Use when a task moves from TODO -> IN_PROGRESS -> COMPLETED.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                chunkId: {
-                    type: 'string',
-                    description: 'The ID of the roadmap chunk'
-                },
-                status: {
-                    type: 'string',
-                    enum: ['TODO', 'IN_PROGRESS', 'COMPLETED'],
-                    description: 'New status'
-                }
-            },
-            required: ['projectId', 'chunkId', 'status']
-        }
-    },
-    {
-        name: 'add_roadmap_chunk',
-        description: `Kine's Tool: Decomposes features into smaller roadmap steps.
-Use when a high-level goal needs to be broken down into actionable tasks.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                title: {
-                    type: 'string',
-                    description: 'Task title'
-                },
-                description: {
-                    type: 'string',
-                    description: 'Optional details'
-                },
-                featureId: {
-                    type: 'string',
-                    description: 'Optional context (Sprint focus)'
-                },
-                priority: {
-                    type: 'string',
-                    enum: ['LOW', 'MEDIUM', 'HIGH'],
-                    description: 'Priority (default: MEDIUM)'
-                }
-            },
-            required: ['projectId', 'title']
-        }
-    },
-    // =========================================================================
-    // UI/UX & RESEARCH (LINUS & ASTRID)
-    // =========================================================================
-    {
-        name: 'analyze_ui_component',
-        description: `Linus's Tool: Analyzes a UI file for design flaws, accessibility issues, and hardcoded values.
-Returns a checklist of recommended fixes.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                filePath: { type: 'string', description: 'Absolute path to the file' }
-            },
-            required: ['filePath']
-        }
-    },
-    {
-        name: 'apply_design_system',
-        description: `Linus's Tool: Automatically enforces design tokens by replacing hardcoded values.
-Use to cleanup 'dirty' code (e.g. text-[#000] -> text-foreground).`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                filePath: { type: 'string', description: 'Absolute path to the file' }
-            },
-            required: ['filePath']
-        }
-    },
-    {
-        name: 'fetch_ui_library_docs',
-        description: `Astrid's Tool: Fetches reference code for a UI component (e.g. Shadcn/UI).
-Use this to see how a Button or Card is implemented locally before suggesting changes.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                componentName: { type: 'string', description: 'e.g. "button", "card"' },
-                library: { type: 'string', enum: ['shadcn', 'lucide'], default: 'shadcn' }
-            },
-            required: ['componentName']
-        }
-    },
-    // =========================================================================
-    // PENDING TASKS (IDE Integration)
-    // =========================================================================
-    {
-        name: 'get_pending_tasks',
-        description: `Fetches tasks that have been APPROVED by the user in the dashboard and are ready for execution.
-Use this to poll for work that the user wants you to perform. Returns objective, technical context, and constraints.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                }
-            },
-            required: ['projectId']
-        }
-    },
-    {
-        name: 'update_task_status',
-        description: `Updates the status of a pending task. Use EXECUTING when starting work, COMPLETED when done.
-IMPORTANT: execution_summary is REQUIRED when setting status to COMPLETED.`,
-        inputSchema: {
-            type: 'object' as const,
-            properties: {
-                projectId: {
-                    type: 'string',
-                    description: 'The UUID of the Rigstate project'
-                },
-                taskId: {
-                    type: 'string',
-                    description: 'The UUID of the task to update (from get_pending_tasks)'
-                },
-                status: {
-                    type: 'string',
-                    enum: ['EXECUTING', 'COMPLETED', 'FAILED'],
-                    description: 'New status: EXECUTING (starting), COMPLETED (done), or FAILED (error)'
-                },
-                executionSummary: {
-                    type: 'string',
-                    description: 'Summary of actions taken. REQUIRED when status is COMPLETED.'
-                }
-            },
-            required: ['projectId', 'taskId', 'status']
-        }
-    }
-];
-
-
-// =============================================================================
-// RESOURCES (LOCAL FILES)
-// =============================================================================
-
-const RESOURCES = [
-    {
-        uri: 'rigstate://project_morals',
-        name: 'project_morals',
-        description: 'Local project rules and standards from .rigstate/rules.md or similar files',
-        mimeType: 'text/markdown'
-    }
-];
-
-// =============================================================================
-// SERVER IMPLEMENTATION
-// =============================================================================
-
-async function validateWorkerKey(): Promise<boolean> {
-    try {
-        const rootKey = await fs.readFile(path.join(process.cwd(), 'worker.key'), 'utf-8').catch(() => null);
-        if (rootKey && rootKey.trim().length > 0) return true;
-
-        const globalPath = path.join(os.homedir(), '.rigstate', 'auth.json');
-        const globalContent = await fs.readFile(globalPath, 'utf-8').catch(() => null);
-        if (globalContent) {
-            const auth = JSON.parse(globalContent);
-            if (auth.worker_token) return true;
-        }
-    } catch (e) { }
-    return false;
-}
-
-async function fetchGovernancePolicy(apiUrl: string, apiKey: string, projectId: string) {
-    try {
-        const response = await fetch(`${apiUrl}/api/agent/policy?project_id=${projectId}&agent_name=frank`, {
-            headers: { 'Authorization': `Bearer ${apiKey}` }
-        });
-        if (response.ok) return await response.json();
-    } catch (e) { }
-    return null;
-}
+import { authenticateApiKey } from './lib/supabase.js';
+import { createMcpServer } from './server/factory.js';
+import { setupToolHandlers } from './server/core.js';
+import { startFrankWatcher } from './server/telemetry.js';
 
 async function main() {
-    // Validate API key on startup
     const apiKey = process.env.RIGSTATE_API_KEY;
 
     if (!apiKey) {
-        console.error('❌ Error: RIGSTATE_API_KEY environment variable is required.');
-        console.error('');
-        console.error('Get your API key from: https://rigstate.dev/settings/api-keys');
-        console.error('Then set it: RIGSTATE_API_KEY=sk_rigstate_xxx npx @rigstate/mcp');
+        console.error('❌ RIGSTATE_API_KEY environment variable is required');
         process.exit(1);
     }
 
-    // Governance Check (Rigstate v2.8)
-    const manifestPath = path.join(process.cwd(), '.rigstate');
-    const manifestContent = await fs.readFile(manifestPath, 'utf-8').catch(() => null);
-    if (manifestContent) {
-        try {
-            const manifest = JSON.parse(manifestContent);
-            if (manifest.project_id && manifest.api_url) {
-                console.error(`🔒 Governance: Fetching policy for Project ${manifest.project_id}...`);
-                const policy: any = await fetchGovernancePolicy(manifest.api_url, apiKey, manifest.project_id);
-                if (policy) {
-                    if (policy.allow_file_write === false) {
-                        process.env.RIGSTATE_GOVERNANCE_WRITE = 'FALSE';
-                        console.error(`🔒 Governance: Write Access DISABLED via Cloud Policy.`);
-                    } else {
-                        process.env.RIGSTATE_GOVERNANCE_WRITE = 'TRUE';
-                        console.error(`🔓 Governance: Write Access Enabled (Subject to Zero-Trust Key).`);
-                    }
-                }
-            }
-        } catch (e) { }
-    }
-
-    // Authenticate
+    // 1. Authenticate
     const authResult = await authenticateApiKey(apiKey);
-
     if (!authResult.success || !authResult.context) {
         console.error(`❌ Authentication failed: ${authResult.error}`);
         process.exit(1);
     }
 
-    const authContext: AuthContext = authResult.context;
+    const { supabase, userId } = authResult.context;
 
-    // Start Frank Watcher (Auto-Agent)
-    startFrankWatcher(authContext.supabase, authContext.userId);
+    // 2. Start Telemetry (Frank Watcher)
+    startFrankWatcher(supabase, userId);
 
-    // Create MCP server
-    const server = new Server(
-        {
-            name: SERVER_NAME,
-            version: SERVER_VERSION,
-        },
-        {
-            capabilities: {
-                tools: {},
-                resources: {},
-            },
-        }
-    );
+    // 3. Create Server (Factory)
+    const server = createMcpServer();
 
-    // Handle list_tools request
-    server.setRequestHandler(ListToolsRequestSchema, async () => {
-        return {
-            tools: [
-                ...TOOLS,
-                ...registry.getTools()
-            ]
-        };
-    });
+    // 4. Setup Handlers (Core)
+    setupToolHandlers(server, { supabase, userId });
 
-    // Handle list_resources request
-    server.setRequestHandler(ListResourcesRequestSchema, async () => {
-        return { resources: RESOURCES };
-    });
-
-    // Handle read_resource request
-    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-        const { uri } = request.params;
-
-        if (uri === 'rigstate://project_morals') {
-            const morals = getProjectMorals();
-            return {
-                contents: [
-                    {
-                        uri,
-                        mimeType: 'text/markdown',
-                        text: morals.formatted
-                    }
-                ]
-            };
-        }
-
-        throw new McpError(ErrorCode.InvalidParams, `Unknown resource: ${uri}`);
-    });
-
-    // Handle call_tool request
-    server.setRequestHandler(CallToolRequestSchema, async (request) => {
-        try {
-            const { name } = request.params;
-            const args = request.params.arguments as any;
-
-            // 0. Check Migration Registry
-            // If tool exists in registry, it runs. If arguments invalid, it throws (good).
-            try {
-                return await registry.callTool(name, args, {
-                    supabase: authContext.supabase,
-                    userId: authContext.userId
-                });
-            } catch (e: any) {
-                if (e.message && e.message.includes(`Tool '${name}' not found`)) {
-                    // Tool not in registry, proceed to legacy switch
-                } else {
-                    // Tool was in registry but failed (e.g. validation or runtime error)
-                    throw new McpError(ErrorCode.InvalidParams, e.message);
-                }
-            }
-
-            // GUARDIAN LOCK & WORKER AUTH
-            const WRITE_TOOLS = [
-                'write_to_file', 'replace_file_content', 'run_command',
-                'save_decision', 'submit_idea', 'update_roadmap',
-                'save_to_project_brain', 'add_roadmap_chunk',
-                'update_roadmap_status', 'update_task_status'
-            ];
-
-            if (WRITE_TOOLS.includes(name)) {
-                // Governance Policy Check (Rigstate v2.8)
-                if (process.env.RIGSTATE_GOVERNANCE_WRITE === 'FALSE') {
-                    throw new McpError(ErrorCode.InvalidParams, '[GOVERNANCE_BLOCK]: Write access disabled via Rigstate Cloud.');
-                }
-
-                // Universal Zero-Trust Lock (Rigstate v2.7)
-                const isWorker = await validateWorkerKey();
-
-                if (!isWorker) {
-                    throw new McpError(ErrorCode.InvalidParams, '[RIGSTATE_SECURITY_BLOCK]: Unauthorized attempt. No active Worker context detected.');
-                }
-            }
-
-            switch (name) {
-                case 'get_project_context': {
-                    const parsed = GetProjectContextInputSchema.parse(args);
-                    const result = await getProjectContext(
-                        authContext.supabase,
-                        authContext.userId,
-                        parsed.projectId
-                    );
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: result.summary
-                            }
-                        ]
-                    };
-                }
-
-                case 'query_brain': {
-                    const parsed = QueryBrainInputSchema.parse(args);
-                    const result = await queryBrain(
-                        authContext.supabase,
-                        authContext.userId,
-                        parsed.projectId,
-                        parsed.query,
-                        parsed.limit,
-                        parsed.threshold
-                    );
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: result.formatted
-                            }
-                        ]
-                    };
-                }
-
-                case 'get_latest_decisions': {
-                    const parsed = GetLatestDecisionsInputSchema.parse(args);
-                    const result = await getLatestDecisions(
-                        authContext.supabase,
-                        authContext.userId,
-                        parsed.projectId,
-                        parsed.limit
-                    );
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: result.summary
-                            }
-                        ]
-                    };
-                }
-
-                case 'list_roadmap_tasks': {
-                    const parsed = ListRoadmapTasksInputSchema.parse(args);
-                    const result = await listRoadmapTasks(
-                        authContext.supabase,
-                        authContext.userId,
-                        parsed.projectId
-                    );
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: result.formatted
-                            }
-                        ]
-                    };
-                }
-
-
-                case 'check_agent_bridge': {
-                    const parsed = CheckAgentBridgeInputSchema.parse(args);
-                    const result = await checkAgentBridge(
-                        authContext.supabase,
-                        parsed.projectId,
-                        parsed.action,
-                        parsed.bridgeId,
-                        parsed.status,
-                        parsed.summary,
-                        parsed.proposal,
-                        // @ts-ignore - execution_summary is a new optional prop
-                        parsed.execution_summary
-                    );
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify(result, null, 2)
-                            }
-                        ]
-                    };
-                }
-
-
-                case 'check_rules_sync': {
-                    const parsed = CheckRulesSyncInputSchema.parse(args);
-                    const result = await checkRulesSync(
-                        authContext.supabase,
-                        parsed.projectId,
-                        parsed.currentRulesContent
-                    );
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify(result, null, 2)
-                            }
-                        ]
-                    };
-                }
-
-                case 'get_next_roadmap_step': {
-                    const parsed = GetNextRoadmapStepInputSchema.parse(args);
-                    const result = await getNextRoadmapStep(
-                        authContext.supabase,
-                        parsed.projectId,
-                        parsed.currentStepId
-                    );
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify(result, null, 2)
-                            }
-                        ]
-                    };
-                }
-
-                case 'complete_roadmap_task': {
-                    const args = request.params.arguments as any;
-                    if (!args.projectId || !args.summary) {
-                        throw new Error('projectId and summary are required');
-                    }
-                    const result = await completeRoadmapTask(
-                        authContext.supabase,
-                        args.projectId,
-                        args.summary,
-                        args.taskId,
-                        args.gitDiff
-                    );
-                    return {
-                        content: [{
-                            type: 'text',
-                            text: result.message
-                        }]
-                    };
-                }
-
-                case 'generate_professional_pdf': {
-                    const parsed = GenerateProfessionalPDFInputSchema.parse(args);
-                    const result = await generateProfessionalPdf(
-                        authContext.supabase,
-                        authContext.userId,
-                        parsed.projectId,
-                        parsed.reportType as any
-                    );
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify(result, null, 2)
-                            }
-                        ]
-                    };
-                }
-
-                case 'get_agent_status': {
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify(watcherState, null, 2)
-                            }
-                        ]
-                    };
-                }
-
-                // =============================================================
-                // BRYNJAR - THE LIBRARIAN (Archaeological Operations)
-                // =============================================================
-
-                case 'archaeological_scan': {
-                    const parsed = ArchaeologicalScanInputSchema.parse(args);
-                    const result = await performArchaeologicalScan(
-                        authContext.supabase,
-                        parsed.projectId,
-                        parsed.gitLog,
-                        parsed.fileTree
-                    );
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify(result, null, 2)
-                            }
-                        ]
-                    };
-                }
-
-                case 'import_ghost_features': {
-                    const parsed = ImportGhostFeaturesInputSchema.parse(args);
-                    const result = await importGhostFeatures(
-                        authContext.supabase,
-                        parsed.projectId,
-                        parsed.features
-                    );
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify(result, null, 2)
-                            }
-                        ]
-                    };
-                }
-
-                // =============================================================
-                // WRITE OPERATIONS (DEPRECATED - READ ONLY MODE)
-                // =============================================================
-
-                case 'save_decision': {
-                    return {
-                        content: [{
-                            type: 'text',
-                            text: '🚫 [READ-ONLY MODE] save_decision is deprecated in MCP. Please use the Rigstate Dashboard to record decisions.'
-                        }],
-                        isError: true
-                    };
-                }
-
-                case 'submit_idea': {
-                    return {
-                        content: [{
-                            type: 'text',
-                            text: '🚫 [READ-ONLY MODE] submit_idea is deprecated in MCP. Please use the Rigstate Dashboard (Idea Lab) to submit new ideas.'
-                        }],
-                        isError: true
-                    };
-                }
-
-                case 'update_roadmap': {
-                    return {
-                        content: [{
-                            type: 'text',
-                            text: '🚫 [READ-ONLY MODE] update_roadmap is deprecated in MCP. Use the Rigstate CLI ("rigstate sync") or the Dashboard to update tasks.'
-                        }],
-                        isError: true
-                    };
-                }
-
-                case 'run_architecture_audit': {
-                    return {
-                        content: [{
-                            type: 'text',
-                            text: '🚫 [READ-ONLY MODE] run_architecture_audit in MCP is deprecated. Use the Rigstate CLI command "rigstate check" for deterministic architectural validation.'
-                        }],
-                        isError: true
-                    };
-                }
-
-                // =============================================================
-                // TEACHER MODE TOOLS
-                // =============================================================
-
-                case 'refine_logic': {
-                    const parsed = RefineLogicInputSchema.parse(args);
-                    const result = await refineLogic(
-                        authContext.supabase,
-                        authContext.userId,
-                        parsed.projectId,
-                        parsed.originalReasoning,
-                        parsed.userCorrection,
-                        parsed.scope || 'project'
-                    );
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: `${result.message}\n\nTrace ID: ${result.traceId}`
-                            }
-                        ]
-                    };
-                }
-
-                case 'get_learned_instructions': {
-                    const parsed = GetLearnedInstructionsInputSchema.parse(args);
-                    const result = await getLearnedInstructions(
-                        authContext.supabase,
-                        authContext.userId,
-                        parsed.projectId
-                    );
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: result.formatted
-                            }
-                        ]
-                    };
-                }
-
-                case 'sync_ide_rules': {
-                    const { projectId } = GenerateCursorRulesInputSchema.parse(request.params.arguments);
-                    const result = await syncIdeRules(authContext.supabase, projectId);
-                    return {
-                        content: [{
-                            type: 'text',
-                            text: `FileName: ${result.fileName}\n\nContent:\n${result.content}`
-                        }]
-                    };
-                }
-
-                default:
-                    throw new McpError(
-                        ErrorCode.MethodNotFound,
-                        `Unknown tool: ${name}`
-                    );
-
-                // =============================================================
-                // STRUCTURAL SHIELD (EINAR & SVEN)
-                // =============================================================
-
-                case 'analyze_dependency_graph': {
-                    const parsed = AnalyzeDependencyGraphInputSchema.parse(args);
-                    const result = await analyzeDependencyGraph(parsed);
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify(result, null, 2)
-                            }
-                        ]
-                    };
-                }
-
-                case 'audit_rls_status': {
-                    const parsed = AuditRlsStatusInputSchema.parse(args);
-                    const result = await auditRlsStatus(authContext.supabase, parsed);
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify(result, null, 2)
-                            }
-                        ]
-                    };
-                }
-
-                // =============================================================
-                // INTELLIGENCE CORE (MAJA & ASTRID)
-                // =============================================================
-
-                case 'query_project_brain': {
-                    const parsed = QueryProjectBrainInputSchema.parse(args);
-                    const result = await queryProjectBrain(
-                        authContext.supabase,
-                        authContext.userId,
-                        parsed
-                    );
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify(result, null, 2)
-                            }
-                        ]
-                    };
-                }
-
-                case 'fetch_package_health': {
-                    const parsed = FetchPackageHealthInputSchema.parse(args);
-                    const result = await fetchPackageHealth(parsed);
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify(result, null, 2)
-                            }
-                        ]
-                    };
-                }
-
-                // =============================================================
-                // ACTIVE MEMORY & PLANNING (MAJA & KINE)
-                // =============================================================
-
-                case 'save_to_project_brain':
-                case 'update_roadmap_status':
-                case 'add_roadmap_chunk': {
-                    return {
-                        content: [{
-                            type: 'text',
-                            text: '🚫 [READ-ONLY MODE] Planning and active memory writes are deprecated in MCP. Use the Rigstate CLI or Dashboard.'
-                        }],
-                        isError: true
-                    };
-                }
-
-                // =============================================================
-                // UI/UX & RESEARCH (LINUS & ASTRID)
-                // =============================================================
-
-                case 'analyze_ui_component': {
-                    const parsed = AnalyzeUiComponentInputSchema.parse(args);
-                    const result = await analyzeUiComponent(parsed);
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify(result, null, 2)
-                            }
-                        ]
-                    };
-                }
-
-                case 'apply_design_system': {
-                    const parsed = ApplyDesignSystemInputSchema.parse(args);
-                    const result = await applyDesignSystem(parsed);
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify(result, null, 2)
-                            }
-                        ]
-                    };
-                }
-
-                case 'fetch_ui_library_docs': {
-                    const parsed = FetchUiLibraryDocsInputSchema.parse(args);
-                    const result = await fetchUiLibraryDocs(parsed);
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify(result, null, 2)
-                            }
-                        ]
-                    };
-                }
-
-                // =========================================================
-                // PENDING TASKS (IDE Integration)
-                // =========================================================
-                case 'get_pending_tasks': {
-                    const parsed = GetPendingTasksInputSchema.parse(args);
-                    const result = await getPendingTasks(
-                        authContext.supabase,
-                        parsed.projectId
-                    );
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify(result, null, 2)
-                            }
-                        ]
-                    };
-                }
-
-                case 'update_task_status': {
-                    const parsed = UpdateTaskStatusInputSchema.parse(args);
-                    const result = await updateTaskStatus(
-                        authContext.supabase,
-                        parsed.projectId,
-                        parsed.taskId,
-                        parsed.status,
-                        parsed.executionSummary
-                    );
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: JSON.stringify(result, null, 2)
-                            }
-                        ]
-                    };
-                }
-            }
-        } catch (error: any) {
-            // Handle Zod validation errors
-            if (error.name === 'ZodError') {
-                throw new McpError(
-                    ErrorCode.InvalidParams,
-                    `Invalid parameters: ${error.errors.map((e: any) => e.message).join(', ')}`
-                );
-            }
-
-            // Handle access denied errors
-            if (error.message?.includes('access denied') || error.message?.includes('not found')) {
-                throw new McpError(
-                    ErrorCode.InvalidParams,
-                    error.message
-                );
-            }
-
-            // Handle database constraint errors (write operations)
-            if (error.message?.includes('Permission denied') ||
-                error.message?.includes('constraint') ||
-                error.message?.includes('already exists')) {
-                throw new McpError(
-                    ErrorCode.InvalidParams,
-                    `Write operation failed: ${error.message}`
-                );
-            }
-
-            // Handle write operation specific errors
-            if (error.message?.includes('Failed to')) {
-                throw new McpError(
-                    ErrorCode.InternalError,
-                    error.message
-                );
-            }
-
-            // Re-throw MCP errors as-is
-            if (error instanceof McpError) {
-                throw error;
-            }
-
-            // Re-throw other errors
-            throw new McpError(
-                ErrorCode.InternalError,
-                error.message || 'An unexpected error occurred'
-            );
-        }
-    });
-
-    // Start server with stdio transport
+    // 5. Connect Transport
     const transport = new StdioServerTransport();
     await server.connect(transport);
 
-    // Log to stderr so it doesn't interfere with MCP protocol
-    console.error(`✅ Rigstate MCP Server v${SERVER_VERSION} started`);
-    console.error(`   User ID: ${authContext.userId}`);
-    console.error(`   Mode: Read-Only (write ops deprecated)`);
-
-    // DEPRECATED: Frank Watcher is now handled by CLI daemon
-    // Use "rigstate daemon" for background task processing
-    // startFrankWatcher(authContext.supabase, authContext.userId);
+    console.error('🛰️ Rigstate MCP Server (Evolutionary) running on stdio');
 }
 
-// Run the server
 main().catch((error) => {
-    console.error('Fatal error:', error);
+    console.error('FATAL ERROR:', error);
     process.exit(1);
 });
-