@tienne/gestalt 0.12.3 → 0.14.0

package/dist/src/mcp/server.js

@@ -5,7 +5,7 @@ import { loadConfig } from '../core/config.js';
 import { log } from '../core/log.js';
 import { getVersion, checkForUpdates, getCachedUpdateResult } from '../core/version.js';
 import { EventStore } from '../events/store.js';
-import { AnthropicAdapter } from '../llm/adapter.js';
+import { createAdapter } from '../llm/factory.js';
 import { InterviewEngine } from '../interview/engine.js';
 import { PassthroughEngine } from '../interview/passthrough-engine.js';
 import { SpecGenerator } from '../spec/generator.js';
@@ -24,8 +24,11 @@ import { handleAgentPassthrough } from './tools/agent-passthrough.js';
 import { handleReviewPassthrough } from './tools/review-passthrough.js';
 import { handleCodeGraphPassthrough } from './tools/code-graph-passthrough.js';
 import { handleGraphVisualizePassthrough } from './tools/graph-visualize-passthrough.js';
+import { handleGenerateKb } from './tools/generate-kb.js';
+import { handleSearchKb } from './tools/search-kb.js';
+import { handleSyncKb } from './tools/sync-kb.js';
 import { PassthroughReviewEngine } from '../review/passthrough-engine.js';
-import { interviewInputSchema, specInputSchema, executeInputSchema, agentCreateInputSchema, benchmarkInputSchema, statusInputSchema, codeGraphInputSchema, graphVisualizeInputSchema } from './schemas.js';
+import { interviewInputSchema, specInputSchema, executeInputSchema, agentCreateInputSchema, benchmarkInputSchema, statusInputSchema, codeGraphInputSchema, graphVisualizeInputSchema, } from './schemas.js';
 import { PassthroughExecuteEngine } from '../execute/passthrough-engine.js';
 import { PassthroughAgentGenerator } from '../agent/passthrough-generator.js';
 import { RoleAgentRegistry } from '../agent/role-agent-registry.js';
@@ -48,37 +51,67 @@ export async function createMcpServer(configOverrides) {
         const ptEngine = new PassthroughEngine(eventStore, agentRegistry);
         const ptSpecGen = new PassthroughSpecGenerator(eventStore, agentRegistry);
         server.tool('ges_interview', 'Conduct a Gestalt-driven interview (passthrough mode — returns prompts for caller LLM to generate questions/scores). Actions: start, respond, score, complete.', {
-            action: z.enum(['start', 'respond', 'score', 'complete']).describe('start: begin interview, respond: answer a question, score: check resolution, complete: finish interview'),
+            action: z
+                .enum(['start', 'respond', 'score', 'complete'])
+                .describe('start: begin interview, respond: answer a question, score: check resolution, complete: finish interview'),
             topic: z.string().optional().describe('Topic for the interview (required for start)'),
-            sessionId: z.string().optional().describe('Session ID (required for respond/score/complete)'),
-            response: z.string().optional().describe('User response to the current question (required for respond)'),
+            sessionId: z
+                .string()
+                .optional()
+                .describe('Session ID (required for respond/score/complete)'),
+            response: z
+                .string()
+                .optional()
+                .describe('User response to the current question (required for respond)'),
             cwd: z.string().optional().describe('Working directory for brownfield detection'),
-            generatedQuestion: z.string().optional().describe('Question generated by the caller LLM (required for respond in passthrough mode)'),
-            resolutionScore: z.object({
+            generatedQuestion: z
+                .string()
+                .optional()
+                .describe('Question generated by the caller LLM (required for respond in passthrough mode)'),
+            resolutionScore: z
+                .object({
                 goalClarity: z.number().min(0).max(1),
                 constraintClarity: z.number().min(0).max(1),
                 successCriteria: z.number().min(0).max(1),
                 priorityClarity: z.number().min(0).max(1),
                 contextClarity: z.number().min(0).max(1).optional(),
                 contradictions: z.array(z.string()).optional(),
-            }).optional().describe('Resolution scores computed by the caller LLM'),
-            record: z.boolean().optional().describe('Generate a GIF recording of the interview session on complete'),
+            })
+                .optional()
+                .describe('Resolution scores computed by the caller LLM'),
+            record: z
+                .boolean()
+                .optional()
+                .describe('Generate a GIF recording of the interview session on complete'),
         }, (params) => {
             const input = interviewInputSchema.parse(params);
             const result = handleInterviewPassthrough(ptEngine, input);
             return { content: [{ type: 'text', text: result }] };
         });
         server.tool('ges_generate_spec', 'Generate a Spec specification (passthrough mode — returns prompt or validates externally generated spec).', {
-            sessionId: z.string().optional().describe('Interview session ID (required when not using text input)'),
-            text: z.string().optional().describe('Plain text description to generate spec directly without interview'),
-            force: z.boolean().optional().default(false).describe('Force generation even if resolution threshold is not met'),
-            spec: z.object({
+            sessionId: z
+                .string()
+                .optional()
+                .describe('Interview session ID (required when not using text input)'),
+            text: z
+                .string()
+                .optional()
+                .describe('Plain text description to generate spec directly without interview'),
+            force: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('Force generation even if resolution threshold is not met'),
+            spec: z
+                .object({
                 goal: z.string(),
                 constraints: z.array(z.string()),
                 acceptanceCriteria: z.array(z.string()),
                 ontologySchema: z.object({ entities: z.array(z.any()), relations: z.array(z.any()) }),
                 gestaltAnalysis: z.array(z.any()),
-            }).optional().describe('Externally generated spec JSON to validate and store'),
+            })
+                .optional()
+                .describe('Externally generated spec JSON to validate and store'),
         }, (params) => {
             const input = specInputSchema.parse(params);
             const result = handleSpecPassthrough(ptEngine, ptSpecGen, input, agentRegistry);
@@ -89,14 +122,31 @@ export async function createMcpServer(configOverrides) {
         const ptExecuteEngine = new PassthroughExecuteEngine(eventStore, agentRegistry, roleAgentRegistry);
         const ptReviewEngine = new PassthroughReviewEngine(eventStore);
         server.tool('ges_execute', 'Execute a Spec specification using Gestalt principles (passthrough mode). Actions: start, plan_step, plan_complete, execute_start, execute_task, evaluate, status, evolve_fix, evolve, evolve_patch, evolve_re_execute, evolve_lateral, evolve_lateral_result, review_start, review_submit, review_consensus, review_fix.', {
-            action: z.enum([
-                'start', 'plan_step', 'plan_complete', 'execute_start', 'execute_task', 'evaluate', 'status',
-                'evolve_fix', 'evolve', 'evolve_patch', 'evolve_re_execute',
-                'evolve_lateral', 'evolve_lateral_result',
-                'role_match', 'role_consensus',
-                'review_start', 'review_submit', 'review_consensus', 'review_fix',
-            ]).describe('planning: start/plan_step/plan_complete, execution: execute_start/execute_task, evaluate: check results, status: session status, evolve_*: resilience loop, review_*: code review'),
-            spec: z.object({
+            action: z
+                .enum([
+                'start',
+                'plan_step',
+                'plan_complete',
+                'execute_start',
+                'execute_task',
+                'evaluate',
+                'status',
+                'evolve_fix',
+                'evolve',
+                'evolve_patch',
+                'evolve_re_execute',
+                'evolve_lateral',
+                'evolve_lateral_result',
+                'role_match',
+                'role_consensus',
+                'review_start',
+                'review_submit',
+                'review_consensus',
+                'review_fix',
+            ])
+                .describe('planning: start/plan_step/plan_complete, execution: execute_start/execute_task, evaluate: check results, status: session status, evolve_*: resilience loop, review_*: code review'),
+            spec: z
+                .object({
                 version: z.string(),
                 goal: z.string(),
                 constraints: z.array(z.string()),
@@ -109,14 +159,21 @@ export async function createMcpServer(configOverrides) {
                     resolutionScore: z.number(),
                     generatedAt: z.string(),
                 }),
-            }).optional().describe('Spec specification (required for start)'),
-            sessionId: z.string().optional().describe('Execute session ID (required for plan_step/plan_complete/status)'),
-            stepResult: z.object({
+            })
+                .optional()
+                .describe('Spec specification (required for start)'),
+            sessionId: z
+                .string()
+                .optional()
+                .describe('Execute session ID (required for plan_step/plan_complete/status)'),
+            stepResult: z
+                .object({
                 principle: z.enum(['figure_ground', 'closure', 'proximity', 'continuity']),
                 classifiedACs: z.array(z.any()).optional(),
                 atomicTasks: z.array(z.any()).optional(),
                 taskGroups: z.array(z.any()).optional(),
-                dagValidation: z.object({
+                dagValidation: z
+                    .object({
                     isValid: z.boolean(),
                     hasCycles: z.boolean(),
                     cycleDetails: z.array(z.string()).optional(),
@@ -124,15 +181,22 @@ export async function createMcpServer(configOverrides) {
                     conflictDetails: z.array(z.string()).optional(),
                     topologicalOrder: z.array(z.string()),
                     criticalPath: z.array(z.string()),
-                }).optional(),
-            }).optional().describe('Planning step result (required for plan_step)'),
-            taskResult: z.object({
+                })
+                    .optional(),
+            })
+                .optional()
+                .describe('Planning step result (required for plan_step)'),
+            taskResult: z
+                .object({
                 taskId: z.string(),
                 status: z.enum(['pending', 'in_progress', 'completed', 'failed', 'skipped']),
                 output: z.string(),
                 artifacts: z.array(z.string()),
-            }).optional().describe('Task execution result (required for execute_task)'),
-            evaluationResult: z.object({
+            })
+                .optional()
+                .describe('Task execution result (required for execute_task)'),
+            evaluationResult: z
+                .object({
                 verifications: z.array(z.object({
                     acIndex: z.number(),
                     satisfied: z.boolean(),
@@ -142,8 +206,11 @@ export async function createMcpServer(configOverrides) {
                 overallScore: z.number().min(0).max(1),
                 goalAlignment: z.number().min(0).max(1).optional().default(0),
                 recommendations: z.array(z.string()),
-            }).optional().describe('Evaluation result (optional for evaluate action)'),
-            structuralResult: z.object({
+            })
+                .optional()
+                .describe('Evaluation result (optional for evaluate action)'),
+            structuralResult: z
+                .object({
                 commands: z.array(z.object({
                     name: z.string(),
                     command: z.string(),
@@ -151,53 +218,78 @@ export async function createMcpServer(configOverrides) {
                     output: z.string(),
                 })),
                 allPassed: z.boolean(),
-            }).optional().describe('Structural check results (required for evaluate after structural stage)'),
-            fixTasks: z.array(z.object({
+            })
+                .optional()
+                .describe('Structural check results (required for evaluate after structural stage)'),
+            fixTasks: z
+                .array(z.object({
                 taskId: z.string(),
                 failedCommand: z.string(),
                 errorOutput: z.string(),
                 fixDescription: z.string(),
                 artifacts: z.array(z.string()),
-            })).optional().describe('Fix task results (for evolve_fix)'),
-            specPatch: z.object({
+            }))
+                .optional()
+                .describe('Fix task results (for evolve_fix)'),
+            specPatch: z
+                .object({
                 acceptanceCriteria: z.array(z.string()).optional(),
                 constraints: z.array(z.string()).optional(),
-                ontologySchema: z.object({
+                ontologySchema: z
+                    .object({
                     entities: z.array(z.any()).optional(),
                     relations: z.array(z.any()).optional(),
-                }).optional(),
-            }).optional().describe('Spec patch for contextual evolution (for evolve_patch)'),
-            reExecuteTaskResult: z.object({
+                })
+                    .optional(),
+            })
+                .optional()
+                .describe('Spec patch for contextual evolution (for evolve_patch)'),
+            reExecuteTaskResult: z
+                .object({
                 taskId: z.string(),
                 status: z.enum(['pending', 'in_progress', 'completed', 'failed', 'skipped']),
                 output: z.string(),
                 artifacts: z.array(z.string()),
-            }).optional().describe('Re-execution task result (for evolve_re_execute)'),
+            })
+                .optional()
+                .describe('Re-execution task result (for evolve_re_execute)'),
             terminateReason: z.enum(['caller']).optional().describe('Caller-initiated termination'),
-            lateralResult: z.object({
+            lateralResult: z
+                .object({
                 persona: z.enum(['multistability', 'simplicity', 'reification', 'invariance']),
                 specPatch: z.object({
                     acceptanceCriteria: z.array(z.string()).optional(),
                     constraints: z.array(z.string()).optional(),
-                    ontologySchema: z.object({
+                    ontologySchema: z
+                        .object({
                         entities: z.array(z.any()).optional(),
                         relations: z.array(z.any()).optional(),
-                    }).optional(),
+                    })
+                        .optional(),
                 }),
                 description: z.string(),
-            }).optional().describe('Lateral thinking result (for evolve_lateral_result)'),
-            matchResult: z.array(z.object({
+            })
+                .optional()
+                .describe('Lateral thinking result (for evolve_lateral_result)'),
+            matchResult: z
+                .array(z.object({
                 agentName: z.string(),
                 domain: z.array(z.string()),
                 relevanceScore: z.number().min(0).max(1),
                 reasoning: z.string(),
-            })).optional().describe('Role match results (for role_match action)'),
-            perspectives: z.array(z.object({
+            }))
+                .optional()
+                .describe('Role match results (for role_match action)'),
+            perspectives: z
+                .array(z.object({
                 agentName: z.string(),
                 perspective: z.string(),
                 confidence: z.number().min(0).max(1),
-            })).optional().describe('Role perspectives (for role_consensus action)'),
-            consensus: z.object({
+            }))
+                .optional()
+                .describe('Role perspectives (for role_consensus action)'),
+            consensus: z
+                .object({
                 consensus: z.string(),
                 conflictResolutions: z.array(z.string()),
                 perspectives: z.array(z.object({
@@ -205,7 +297,9 @@ export async function createMcpServer(configOverrides) {
                     perspective: z.string(),
                     confidence: z.number().min(0).max(1),
                 })),
-            }).optional().describe('Synthesized consensus (for role_consensus action)'),
+            })
+                .optional()
+                .describe('Synthesized consensus (for role_consensus action)'),
         }, async (params) => {
             const input = executeInputSchema.parse(params);
             // Route review actions to review engine
@@ -218,18 +312,31 @@ export async function createMcpServer(configOverrides) {
         });
         const ptAgentGen = new PassthroughAgentGenerator(eventStore, roleAgentRegistry);
         server.tool('ges_create_agent', 'Create a custom Role Agent from a completed interview session (passthrough mode). Actions: start, submit.', {
-            action: z.enum(['start', 'submit']).describe('start: get agent creation context with prompts, submit: validate and save AGENT.md'),
+            action: z
+                .enum(['start', 'submit'])
+                .describe('start: get agent creation context with prompts, submit: validate and save AGENT.md'),
             sessionId: z.string().describe('The interview session ID'),
-            agentContent: z.string().optional().describe('Complete AGENT.md content (frontmatter + body) to validate and save (required for submit)'),
-            cwd: z.string().optional().describe('Working directory where agents/{name}/AGENT.md will be created (defaults to process.cwd())'),
+            agentContent: z
+                .string()
+                .optional()
+                .describe('Complete AGENT.md content (frontmatter + body) to validate and save (required for submit)'),
+            cwd: z
+                .string()
+                .optional()
+                .describe('Working directory where agents/{name}/AGENT.md will be created (defaults to process.cwd())'),
         }, (params) => {
             const input = agentCreateInputSchema.parse(params);
             const result = handleCreateAgentPassthrough(ptEngine, ptAgentGen, input);
             return { content: [{ type: 'text', text: result }] };
         });
-        server.tool('ges_agent', 'List available agents or retrieve a specific agent\'s system prompt for standalone use — no pipeline required. Actions: list (get all role/review agents), get (retrieve agent by name).', {
-            action: z.enum(['list', 'get']).describe('list: get all available agents grouped by type, get: retrieve a specific agent\'s systemPrompt'),
-            name: z.string().optional().describe('Agent name (required for action=get, e.g. "architect", "security-reviewer")'),
+        server.tool('ges_agent', "List available agents or retrieve a specific agent's system prompt for standalone use — no pipeline required. Actions: list (get all role/review agents), get (retrieve agent by name).", {
+            action: z
+                .enum(['list', 'get'])
+                .describe("list: get all available agents grouped by type, get: retrieve a specific agent's systemPrompt"),
+            name: z
+                .string()
+                .optional()
+                .describe('Agent name (required for action=get, e.g. "architect", "security-reviewer")'),
         }, (params) => {
             const result = handleAgentPassthrough(roleAgentRegistry, {
                 action: params.action,
@@ -238,22 +345,42 @@ export async function createMcpServer(configOverrides) {
             return { content: [{ type: 'text', text: result }] };
         });
         server.tool('ges_benchmark', 'Run Gestalt pipeline benchmarks in passthrough mode. Actions: start (begin a scenario), respond (submit LLM response), status (check progress). No API key required — caller acts as the LLM.', {
-            action: z.enum(['start', 'respond', 'status']).describe('start: begin benchmark scenario, respond: submit LLM response for current step, status: check benchmark progress'),
-            scenario: z.string().optional().describe('Scenario name for start: auth-system, dashboard, api-gateway'),
-            benchmarkSessionId: z.string().optional().describe('Benchmark session ID (required for respond/status)'),
-            response: z.string().optional().describe('JSON response from the caller LLM (required for respond)'),
-            usage: z.object({
+            action: z
+                .enum(['start', 'respond', 'status'])
+                .describe('start: begin benchmark scenario, respond: submit LLM response for current step, status: check benchmark progress'),
+            scenario: z
+                .string()
+                .optional()
+                .describe('Scenario name for start: auth-system, dashboard, api-gateway'),
+            benchmarkSessionId: z
+                .string()
+                .optional()
+                .describe('Benchmark session ID (required for respond/status)'),
+            response: z
+                .string()
+                .optional()
+                .describe('JSON response from the caller LLM (required for respond)'),
+            usage: z
+                .object({
                 inputTokens: z.number(),
                 outputTokens: z.number(),
-            }).optional().describe('Token usage from the caller LLM call (optional, for metrics)'),
+            })
+                .optional()
+                .describe('Token usage from the caller LLM call (optional, for metrics)'),
         }, (params) => {
             const input = benchmarkInputSchema.parse(params);
             const result = handleBenchmarkPassthrough(input);
             return { content: [{ type: 'text', text: result }] };
         });
         server.tool('ges_status', 'Check the status of interview and execute sessions.', {
-            sessionId: z.string().optional().describe('Specific session ID to check (omit for all sessions)'),
-            sessionType: z.enum(['interview', 'execute', 'all']).optional().default('all')
+            sessionId: z
+                .string()
+                .optional()
+                .describe('Specific session ID to check (omit for all sessions)'),
+            sessionType: z
+                .enum(['interview', 'execute', 'all'])
+                .optional()
+                .default('all')
                 .describe('Filter by session type (default: all)'),
         }, (params) => {
             const input = statusInputSchema.parse(params);
@@ -261,17 +388,36 @@ export async function createMcpServer(configOverrides) {
             return { content: [{ type: 'text', text: result }] };
         });
         server.tool('ges_code_graph', 'Build and query the code knowledge graph for a repository. Actions: build (index codebase), blast_radius (find impacted files from changes), query (graph traversal), stats (show DB stats), db_exists (check if graph DB exists).', {
-            action: z.enum(['build', 'blast_radius', 'query', 'stats', 'db_exists']).describe('build: index codebase into graph DB, blast_radius: find files impacted by changes, query: traverse graph, stats: show stats, db_exists: check if DB exists'),
+            action: z
+                .enum(['build', 'blast_radius', 'query', 'stats', 'db_exists'])
+                .describe('build: index codebase into graph DB, blast_radius: find files impacted by changes, query: traverse graph, stats: show stats, db_exists: check if DB exists'),
             repoRoot: z.string().describe('Absolute path to the repository root'),
-            include: z.array(z.string()).optional().describe('Glob patterns to include (default: **/*)'),
+            include: z
+                .array(z.string())
+                .optional()
+                .describe('Glob patterns to include (default: **/*)'),
             exclude: z.array(z.string()).optional().describe('Glob patterns to exclude'),
-            mode: z.enum(['full', 'incremental']).optional().describe('Build mode: full (default) or incremental (hash-based skip)'),
-            changedFiles: z.array(z.string()).optional().describe('Changed file paths (auto-detected from git diff HEAD~1 if omitted)'),
+            mode: z
+                .enum(['full', 'incremental'])
+                .optional()
+                .describe('Build mode: full (default) or incremental (hash-based skip)'),
+            changedFiles: z
+                .array(z.string())
+                .optional()
+                .describe('Changed file paths (auto-detected from git diff HEAD~1 if omitted)'),
             base: z.string().optional().describe('Git base ref for diff detection (default: HEAD~1)'),
-            maxDepth: z.number().optional().describe('BFS traversal depth for blast_radius (default: 2)'),
-            pattern: z.enum(['callers_of', 'callees_of', 'tests_for', 'imports_of']).optional()
+            maxDepth: z
+                .number()
+                .optional()
+                .describe('BFS traversal depth for blast_radius (default: 2)'),
+            pattern: z
+                .enum(['callers_of', 'callees_of', 'tests_for', 'imports_of'])
+                .optional()
                 .describe('Query pattern (required for query action)'),
-            target: z.string().optional().describe('Target function or file path (required for query action)'),
+            target: z
+                .string()
+                .optional()
+                .describe('Target function or file path (required for query action)'),
         }, async (params) => {
             const input = codeGraphInputSchema.parse(params);
             const result = await handleCodeGraphPassthrough(input);
@@ -279,25 +425,69 @@ export async function createMcpServer(configOverrides) {
         });
         server.tool('ges_graph_visualize', 'Start a local HTTP server that renders an interactive D3.js force-directed graph visualization of the code knowledge graph. Opens the browser automatically. Requires an existing or auto-buildable code-graph.db.', {
             repoRoot: z.string().describe('Absolute path to the repository root'),
-            port: z.number().optional().describe('Preferred server port (default: 7891, auto-increments on conflict)'),
+            port: z
+                .number()
+                .optional()
+                .describe('Preferred server port (default: 7891, auto-increments on conflict)'),
         }, async (params) => {
             const input = graphVisualizeInputSchema.parse(params);
             const result = await handleGraphVisualizePassthrough(input);
             return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
         });
+        server.tool('ges_generate_kb', 'Gestalt 코드 그래프 분석 결과 및 도메인 내용을 MD 파일로 내보내고 임베딩을 생성합니다', {
+            repoRoot: z.string().optional().describe('분석할 레포 경로 (기본: cwd)'),
+            outputPath: z.string().optional().describe('출력 경로 (기본: .gestalt-kb/)'),
+            types: z
+                .array(z.enum(['code-graph', 'business-logic', 'api-spec', 'adr', 'policy']))
+                .optional()
+                .describe('생성할 타입 필터'),
+        }, async (params) => {
+            const result = await handleGenerateKb(params, process.cwd());
+            return { content: [{ type: 'text', text: result }] };
+        });
+        server.tool('ges_search', 'Knowledge Base에서 시맨틱 검색을 수행합니다', {
+            query: z.string().describe('검색 쿼리'),
+            k: z.number().optional().describe('반환할 결과 수 (기본: 5)'),
+            kbPath: z.string().optional().describe('Knowledge Base 경로 (기본: .gestalt-kb/)'),
+            types: z
+                .array(z.enum(['code-graph', 'business-logic', 'api-spec', 'adr', 'policy']))
+                .optional()
+                .describe('검색할 타입 필터'),
+        }, async (params) => {
+            const result = await handleSearchKb(params, process.cwd());
+            return { content: [{ type: 'text', text: result }] };
+        });
+        server.tool('ges_sync', 'Knowledge Base를 다른 경로로 동기화(복사)합니다', {
+            sourcePath: z.string().optional().describe('소스 경로 (기본: .gestalt-kb/)'),
+            targetPath: z.string().describe('동기화 대상 경로'),
+        }, async (params) => {
+            const result = await handleSyncKb(params, process.cwd());
+            return { content: [{ type: 'text', text: result }] };
+        });
     }
     else {
         // ─── Normal mode: direct LLM calls ──────────────────────────
-        const llm = new AnthropicAdapter(config.llm.apiKey, config.llm.model);
+        const llm = createAdapter(config.llm);
         const engine = new InterviewEngine(llm, eventStore);
         const specGenerator = new SpecGenerator(llm, eventStore);
         server.tool('ges_interview', 'Conduct a Gestalt-driven interview to clarify project requirements. Actions: start, respond, score, complete.', {
-            action: z.enum(['start', 'respond', 'score', 'complete']).describe('start: begin interview, respond: answer a question, score: check resolution, complete: finish interview'),
+            action: z
+                .enum(['start', 'respond', 'score', 'complete'])
+                .describe('start: begin interview, respond: answer a question, score: check resolution, complete: finish interview'),
             topic: z.string().optional().describe('Topic for the interview (required for start)'),
-            sessionId: z.string().optional().describe('Session ID (required for respond/score/complete)'),
-            response: z.string().optional().describe('User response to the current question (required for respond)'),
+            sessionId: z
+                .string()
+                .optional()
+                .describe('Session ID (required for respond/score/complete)'),
+            response: z
+                .string()
+                .optional()
+                .describe('User response to the current question (required for respond)'),
             cwd: z.string().optional().describe('Working directory for brownfield detection'),
-            record: z.boolean().optional().describe('Generate a GIF recording of the interview session on complete'),
+            record: z
+                .boolean()
+                .optional()
+                .describe('Generate a GIF recording of the interview session on complete'),
         }, async (params) => {
             const input = interviewInputSchema.parse(params);
             const result = await handleInterview(engine, input);
@@ -305,15 +495,25 @@ export async function createMcpServer(configOverrides) {
         });
         server.tool('ges_generate_spec', 'Generate a Spec specification from a completed interview session.', {
             sessionId: z.string().describe('The interview session ID'),
-            force: z.boolean().optional().default(false).describe('Force generation even if resolution threshold is not met'),
+            force: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('Force generation even if resolution threshold is not met'),
         }, async (params) => {
             const input = specInputSchema.parse(params);
             const result = await handleSpec(engine, specGenerator, input);
             return { content: [{ type: 'text', text: result }] };
         });
         server.tool('ges_status', 'Check the status of interview and execute sessions.', {
-            sessionId: z.string().optional().describe('Specific session ID to check (omit for all sessions)'),
-            sessionType: z.enum(['interview', 'execute', 'all']).optional().default('all')
+            sessionId: z
+                .string()
+                .optional()
+                .describe('Specific session ID to check (omit for all sessions)'),
+            sessionType: z
+                .enum(['interview', 'execute', 'all'])
+                .optional()
+                .default('all')
                 .describe('Filter by session type (default: all)'),
         }, (params) => {
             const input = statusInputSchema.parse(params);
@@ -369,7 +569,7 @@ function handleStatusPassthrough(engine, executeEngine, input) {
             }
         }
         // List mode
-        const interviewSessions = (sessionType === 'interview' || sessionType === 'all')
+        const interviewSessions = sessionType === 'interview' || sessionType === 'all'
             ? engine.listSessions().map((s) => ({
                 sessionId: s.sessionId,
                 topic: s.topic,
@@ -380,7 +580,7 @@ function handleStatusPassthrough(engine, executeEngine, input) {
                 createdAt: s.createdAt,
             }))
             : [];
-        const executeSessions = (sessionType === 'execute' || sessionType === 'all')
+        const executeSessions = sessionType === 'execute' || sessionType === 'all'
             ? executeEngine.listSessions().map((s) => formatExecuteSessionSummary(s))
             : [];
         return JSON.stringify({
@@ -434,38 +634,49 @@ function formatExecuteSession(session) {
         currentStep: session.currentStep,
         stepsCompleted: session.planningSteps.map((s) => s.principle),
         hasPlan: !!session.executionPlan,
-        taskProgress: { total: totalTasks, completed: completedTasks, failed: failedTasks, pending: pendingTasks },
+        taskProgress: {
+            total: totalTasks,
+            completed: completedTasks,
+            failed: failedTasks,
+            pending: pendingTasks,
+        },
         satisfiedACs: `${satisfiedACs}/${totalACs}`,
         evaluateStage: session.evaluateStage ?? null,
         hasEvaluation: !!session.evaluationResult,
         evaluationScore: session.evaluationResult?.overallScore ?? null,
         goalAlignment: session.evaluationResult?.goalAlignment ?? null,
         driftAlerts: session.driftHistory.filter((d) => d.thresholdExceeded).length,
-        evolution: session.evolutionHistory.length > 0 ? {
-            scoreProgression: session.evolutionHistory.map((gen) => ({
-                generation: gen.generation,
-                score: gen.evaluationScore,
-                goalAlignment: gen.goalAlignment,
-                fieldsChanged: Object.keys(gen.delta).filter((k) => {
-                    const val = gen.delta[k];
-                    return Array.isArray(val) ? val.length > 0 : val !== undefined;
-                }),
-            })),
-            summary: summarizeEvolution(session),
-        } : null,
+        evolution: session.evolutionHistory.length > 0
+            ? {
+                scoreProgression: session.evolutionHistory.map((gen) => ({
+                    generation: gen.generation,
+                    score: gen.evaluationScore,
+                    goalAlignment: gen.goalAlignment,
+                    fieldsChanged: Object.keys(gen.delta).filter((k) => {
+                        const val = gen.delta[k];
+                        return Array.isArray(val) ? val.length > 0 : val !== undefined;
+                    }),
+                })),
+                summary: summarizeEvolution(session),
+            }
+            : null,
         evolveStage: session.evolveStage ?? null,
         currentGeneration: session.currentGeneration,
         terminationReason: session.terminationReason ?? null,
-        lateral: session.lateralTriedPersonas.length > 0 ? {
-            triedPersonas: session.lateralTriedPersonas,
-            totalAttempts: session.lateralAttempts,
-            currentPersona: session.lateralCurrentPersona ?? null,
-            currentPattern: session.lateralCurrentPattern ?? null,
-        } : null,
-        roleAgent: session.roleMatches ? {
-            matchedAgents: session.roleMatches.map((m) => m.agentName),
-            hasConsensus: !!session.roleConsensus,
-        } : null,
+        lateral: session.lateralTriedPersonas.length > 0
+            ? {
+                triedPersonas: session.lateralTriedPersonas,
+                totalAttempts: session.lateralAttempts,
+                currentPersona: session.lateralCurrentPersona ?? null,
+                currentPattern: session.lateralCurrentPattern ?? null,
+            }
+            : null,
+        roleAgent: session.roleMatches
+            ? {
+                matchedAgents: session.roleMatches.map((m) => m.agentName),
+                hasConsensus: !!session.roleConsensus,
+            }
+            : null,
         createdAt: session.createdAt,
         updatedAt: session.updatedAt,
     };
@@ -497,12 +708,14 @@ export async function startMcpServer(configOverrides) {
     const transport = new StdioServerTransport();
     await server.connect(transport);
     log(`MCP server started on stdio${isPassthrough ? ' (passthrough mode)' : ''}`);
-    checkForUpdates().then((result) => {
+    checkForUpdates()
+        .then((result) => {
         if (result?.updateAvailable) {
             log(`Update available: ${result.currentVersion} → ${result.latestVersion}`);
             log(`Run: npx -y @tienne/gestalt@latest`);
         }
-    }).catch(() => { });
+    })
+        .catch(() => { });
     process.on('SIGINT', async () => {
         await skillRegistry.stopWatching();
         await agentRegistry.stopWatching();