@mohantn/gate-keeper 2.1.0

package/dist/mcp/installer.js

@@ -0,0 +1,341 @@
+"use strict";
+/**
+ * Platform integration installer — generates config files that wire gate-keeper
+ * into various AI coding assistants.
+ *
+ * Each platform generator returns the target file path and content to write.
+ * The handler is responsible for actually writing to disk and checking conflicts.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claudeCodeConfig = claudeCodeConfig;
+exports.copilotConfig = copilotConfig;
+exports.cursorConfig = cursorConfig;
+exports.vscodeConfig = vscodeConfig;
+exports.githubActionConfig = githubActionConfig;
+exports.getPlatformConfig = getPlatformConfig;
+const path = __importStar(require("path"));
+// ── Platform config generators ─────────────────────────────
+function claudeCodeConfig(repoRoot) {
+    const content = `
+## Gate Keeper — Graphify Integration
+
+**Session Start Protocol:**
+1. Call \`get_graph_report\` to understand the architecture before writing any code.
+2. Call \`get_centrality_rank\` to identify high-blast-radius files.
+3. Before editing any file, call \`check_pre_edit_safety\` — treat **block** verdicts as hard stops.
+
+**MCP Tools available:** get_impact_set, trace_path, summarize_file, find_callers, check_pre_edit_safety, get_graph_report, query_graph, explain_node, get_session_metrics
+
+**Token efficiency:** Use these tools instead of reading raw files. One graph query (~100–300 tokens) replaces reading 5+ files (~25 000 tokens).
+`;
+    return {
+        platform: 'claude-code',
+        filePath: path.join(repoRoot, 'CLAUDE.md'),
+        content,
+        description: 'Appends gate-keeper session protocol to CLAUDE.md',
+        append: true,
+    };
+}
+function copilotConfig(repoRoot, mcpServerPath) {
+    const serverPath = mcpServerPath ?? 'node dist/mcp/server.js';
+    const content = `# Gate Keeper — Mandatory Quality Workflow
+
+> **Every code action (plan, create, edit) must pass through the gate-keeper MCP tools. No exceptions.**
+
+---
+
+## MCP Server Configuration
+
+Add this to your VS Code settings (or \`mcp.json\`) to register the gate-keeper MCP server:
+
+\`\`\`json
+{
+  "mcpServers": {
+    "gate-keeper": {
+      "command": "node",
+      "args": ["${serverPath}"],
+      "cwd": "${repoRoot}"
+    }
+  }
+}
+\`\`\`
+
+---
+
+## Tool Quick Reference
+
+| Category | Tool | What it does |
+|----------|------|-------------|
+| **Quality** | \`analyze_file\` | Rate a file 0–10, get violations |
+| | \`analyze_code\` | Preview quality before writing a new file |
+| | \`get_quality_rules\` | Learn scoring thresholds and deductions |
+| **Context** | \`summarize_file\` | Get file overview without reading raw content |
+| | \`get_file_context\` | Dependencies, reverse deps, cycles, rating |
+| | \`get_dependency_graph\` | Full repo graph: nodes (relative paths), nd (node data), adj (integer-indexed) |
+| | \`get_graph_summary\` | Pre-computed analytics: hotspots, worst files, coupling |
+| | \`get_graph_report\` | Narrative report: god nodes, surprises |
+| **Safety** | \`check_pre_edit_safety\` | Risk verdict before editing (safe/warn/block) |
+| | \`get_impact_set\` | Files that would break if you change this one |
+| | \`predict_impact_with_remediation\` | Blast radius + fix instructions |
+| | \`find_callers\` | All call sites before renaming a function |
+| **Analysis** | \`suggest_refactoring\` | Ranked fixes for a low-rated file |
+| | \`get_codebase_health\` | Overall project quality scan |
+| | \`get_violation_patterns\` | Most common violations across the codebase |
+
+---
+
+## Session Start (once per session)
+
+\`\`\`
+get_quality_rules          ← learn scoring thresholds
+get_dependency_graph       ← full repo graph: nodes, nd, adj (integer-indexed)
+get_graph_summary          ← pre-computed analytics: hotspots, worst files, module coupling
+\`\`\`
+
+---
+
+## Before Any Change
+
+\`\`\`
+get_file_context <file>
+\`\`\`
+
+If the file has **many reverse dependencies**:
+\`\`\`
+get_impact_analysis <file>             ← direct + transitive dependents
+predict_impact_with_remediation <file>  ← remediation for at-risk downstream files
+\`\`\`
+
+---
+
+## Writing Code
+
+### New file
+1. \`analyze_code <code string>\` — preview quality BEFORE writing to disk
+2. Only write if rating ≥ 7.0, or fix the code first
+3. After writing: \`analyze_file <path>\` to verify
+
+### Existing file
+1. Edit the file
+2. Immediately: \`analyze_file <absolute path>\` (MANDATORY)
+
+| Rating | Action |
+|--------|--------|
+| ≥ 7.0 | ✅ Done — proceed |
+| < 7.0 | \`suggest_refactoring\` → fix → \`analyze_file\` again (max 3 cycles) |
+
+---
+
+## After Bulk Changes (3+ files)
+
+\`\`\`
+get_codebase_health  ← verify overall project quality has not degraded
+\`\`\`
+
+---
+
+## Hard Rules
+
+- Never use \`any\` — use specific types or \`unknown\`
+- Never leave empty catch blocks
+- Never skip \`analyze_file\` after editing a code file
+- Never edit a widely-imported file without \`get_impact_analysis\` first
+
+---
+
+## Quality Thresholds
+
+| Metric | Deduction |
+|--------|-----------|
+| Error violation | −1.5 |
+| Warning violation | −0.5 |
+| Info violation | −0.1 |
+| Cyclomatic complexity >20 / >10 | −2.0 / −1.0 |
+| Import count >30 / >15 | −2.0 / −0.5 |
+| Lines >500 / >300 | −1.5 / −0.5 |
+| Circular dependency | −1.0 per cycle |
+| Test coverage <30% / <50% / <80% | −2.5 / −2.0 / −1.0 |
+
+**Minimum passing rating: 7.0 / 10**
+
+---
+
+## Fix Priority
+
+1. **Errors −1.5 each** — missing \`key\` props, empty catch blocks
+2. **Warnings −0.5 each** — \`any\` types, god classes, long methods (>50 lines), tight coupling
+3. **Circular deps −1.0 each** — break import cycles via shared types or dependency inversion
+4. **Info −0.1 each** — console.log statements
+`;
+    return {
+        platform: 'copilot',
+        filePath: path.join(repoRoot, '.github', 'copilot-instructions.md'),
+        content,
+        description: 'Creates .github/copilot-instructions.md with gate-keeper usage guide',
+        append: false,
+    };
+}
+function cursorConfig(repoRoot) {
+    const content = `# Gate Keeper — Cursor Rules
+
+## Before editing any file
+1. Call MCP tool \`check_pre_edit_safety\` with the file path.
+2. If verdict is "warn": also call \`get_impact_set\` to see affected files.
+3. If verdict is "block": fix fragile dependents first.
+
+## Architecture awareness
+- Call \`get_graph_report\` once per session to understand module structure.
+- Use \`summarize_file\` instead of reading raw files for context.
+- Use \`find_callers\` before renaming or deleting any function/export.
+- Use \`trace_path\` to understand why two modules are coupled.
+
+## Quality gates
+- After every file edit, call \`analyze_file\`. Target rating ≥ 7.0/10.
+- If rating < 7.0, call \`suggest_refactoring\` and fix violations.
+
+## MCP Server: node dist/mcp/server.js (in repo root)
+`;
+    return {
+        platform: 'cursor',
+        filePath: path.join(repoRoot, '.cursorrules'),
+        content,
+        description: 'Creates .cursorrules with gate-keeper workflow instructions',
+        append: false,
+    };
+}
+function vscodeConfig(repoRoot, gateKeeperPath) {
+    const serverPath = gateKeeperPath ?? repoRoot;
+    const config = {
+        servers: {
+            'gate-keeper': {
+                command: 'node',
+                args: ['dist/mcp/server.js'],
+                cwd: serverPath,
+                env: {},
+            },
+        },
+    };
+    return {
+        platform: 'vscode',
+        filePath: path.join(repoRoot, '.vscode', 'mcp.json'),
+        content: JSON.stringify(config, null, 2),
+        description: 'Creates .vscode/mcp.json registering gate-keeper as a VS Code MCP server',
+        append: false,
+    };
+}
+function githubActionConfig() {
+    const content = `name: Gate Keeper — Code Quality Analysis
+
+on:
+  push:
+    branches: ["**"]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  quality-analysis:
+    name: Analyze code quality
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: |
+            package-lock.json
+
+      - name: Install gate-keeper
+        run: npm ci
+
+      - name: Build gate-keeper
+        run: npm run build
+
+      - name: Run quality analysis
+        id: analysis
+        run: |
+          node -e "
+          const { UniversalAnalyzer } = require('./dist/analyzer/universal-analyzer');
+          const { findSourceFiles } = require('./dist/mcp/helpers');
+          const files = findSourceFiles('.', 100);
+          Promise.all(files.map(f => new UniversalAnalyzer().analyze(f)))
+            .then(results => {
+              const avg = results.reduce((s, r) => s + r.rating, 0) / results.length;
+              const failed = results.filter(r => r.rating < 7.0);
+              console.log('overall_rating=' + avg.toFixed(1));
+              console.log('failed_files=' + failed.length);
+              if (failed.length > 0) process.exit(1);
+            })
+            .catch(e => { console.error(e); process.exit(1); });
+          " | tee -a "\$GITHUB_OUTPUT"
+
+      - name: Post quality summary
+        if: github.event_name == 'pull_request'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const overall = '\${{ steps.analysis.outputs.overall_rating }}';
+            const failed = '\${{ steps.analysis.outputs.failed_files }}';
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: \`## Gate Keeper Quality Report\\n\\n**Overall rating:** \${overall}/10\\n**Files below threshold:** \${failed}\\n\\nRun \\\`get_graph_report\\\` in gate-keeper MCP for full analysis.\`
+            });
+`;
+    return {
+        platform: 'github-action',
+        filePath: path.join('.github', 'workflows', 'gate-keeper.yml'),
+        content,
+        description: 'Creates .github/workflows/gate-keeper.yml for CI quality analysis',
+        append: false,
+    };
+}
+function getPlatformConfig(platform, repoRoot, gateKeeperPath) {
+    switch (platform) {
+        case 'claude-code': return claudeCodeConfig(repoRoot);
+        case 'copilot': return copilotConfig(repoRoot, gateKeeperPath);
+        case 'cursor': return cursorConfig(repoRoot);
+        case 'vscode': return vscodeConfig(repoRoot, gateKeeperPath);
+        case 'github-action': return githubActionConfig();
+    }
+}
+//# sourceMappingURL=installer.js.map

package/dist/mcp/installer.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Gate Keeper — MCP Server
+ *
+ * Exposes code-quality analysis as MCP tools that AI agents (GitHub Copilot,
+ * Claude, etc.) call after file edits. The agent sees the rating, violations,
+ * and codebase health, then self-corrects until quality reaches the threshold.
+ *
+ * Protocol: JSON-RPC 2.0 over stdio (MCP standard transport).
+ *
+ * Run: npx tsx src/mcp/server.ts
+ *      node dist/mcp/server.js
+ */
+export declare const TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            file_path?: undefined;
+            repo?: undefined;
+            directory?: undefined;
+            max_files?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            file_path: {
+                type: string;
+                description: string;
+            };
+            repo: {
+                type: string;
+                description: string;
+            };
+            directory?: undefined;
+            max_files?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            repo: {
+                type: string;
+                description: string;
+            };
+            file_path?: undefined;
+            directory?: undefined;
+            max_files?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            directory: {
+                type: string;
+                description: string;
+            };
+            max_files: {
+                type: string;
+                description: string;
+            };
+            file_path?: undefined;
+            repo?: undefined;
+        };
+        required?: undefined;
+    };
+})[];
+export interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id?: number | string;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: number | string | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/** Send JSON-RPC response to stdout */
+export declare function send(response: JsonRpcResponse): void;
+/** Send successful result */
+export declare function sendResult(id: number | string | null, result: unknown): void;
+/** Send error response */
+export declare function sendError(id: number | string | null, code: number, message: string): void;
+/** Handle incoming JSON-RPC message */
+export declare function handleMessage(msg: JsonRpcRequest): Promise<void>;
+/** Process a line of input from stdin */
+export declare function processLine(line: string, buffer: {
+    current: string;
+}): void;
+/** Start the MCP server (stdio transport) */
+export declare function startServer(): void;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwFjB,CAAC;AAIF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3D;AAED,uCAAuC;AACvC,wBAAgB,IAAI,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAGpD;AAED,6BAA6B;AAC7B,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAE5E;AAED,0BAA0B;AAC1B,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzF;AAED,uCAAuC;AACvC,wBAAsB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDtE;AAED,yCAAyC;AACzC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAmB3E;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,IAAI,IAAI,CAwBlC"}

package/dist/mcp/server.js

@@ -0,0 +1,216 @@
+"use strict";
+/**
+ * Gate Keeper — MCP Server
+ *
+ * Exposes code-quality analysis as MCP tools that AI agents (GitHub Copilot,
+ * Claude, etc.) call after file edits. The agent sees the rating, violations,
+ * and codebase health, then self-corrects until quality reaches the threshold.
+ *
+ * Protocol: JSON-RPC 2.0 over stdio (MCP standard transport).
+ *
+ * Run: npx tsx src/mcp/server.ts
+ *      node dist/mcp/server.js
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOLS = void 0;
+exports.send = send;
+exports.sendResult = sendResult;
+exports.sendError = sendError;
+exports.handleMessage = handleMessage;
+exports.processLine = processLine;
+exports.startServer = startServer;
+const handlers_1 = require("./handlers");
+// ── Tool definitions ───────────────────────────────────────
+exports.TOOLS = [
+    {
+        name: 'get_quality_rules',
+        description: 'Return the quality rules, thresholds, and scoring deductions Gate Keeper enforces. ' +
+            'Call this at session start to understand what to avoid when writing code.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'get_file_context',
+        description: 'Get full context for a file: quality rating, dependencies (what it imports), ' +
+            'reverse dependencies (files that import it), circular dependency cycles, ' +
+            'rating breakdown, rating trend, and git diff. Compact response for LLM consumption.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                file_path: {
+                    type: 'string',
+                    description: 'Absolute path to the source file',
+                },
+                repo: {
+                    type: 'string',
+                    description: 'Repository root path (defaults to git root of file_path)',
+                },
+            },
+            required: ['file_path'],
+        },
+    },
+    {
+        name: 'get_graph_summary',
+        description: 'Return a pre-computed dependency graph summary: rating distribution, ' +
+            'top fan-in / fan-out hotspots (with fragileHub flags), worst-rated files, ' +
+            'circular dependencies, and module-level coupling. Also returns raw ' +
+            'nodes/edges/adjacency/reverseAdjacency for power use. Use the `summary` ' +
+            'fields directly instead of recomputing them — they answer the common ' +
+            '"which files are risky/hottest/worst?" questions without further analysis.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                repo: {
+                    type: 'string',
+                    description: 'Repository root path (defaults to git root of cwd)',
+                },
+            },
+        },
+    },
+    {
+        name: 'get_dependency_graph',
+        description: 'Return the full repository dependency graph in a compact, LLM-optimized format. ' +
+            'Includes: adjacency (file → imports), reverseAdjacency (file → dependents), ' +
+            'nodeData (rating, violations, LOC per file), edges, and cycles. ' +
+            'Use this for full graph traversal and architecture analysis. ' +
+            'For pre-computed analytics (hotspots, worst files), use get_graph_summary instead.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                repo: {
+                    type: 'string',
+                    description: 'Repository root path (defaults to git root of cwd)',
+                },
+            },
+        },
+    },
+    {
+        name: 'get_codebase_health',
+        description: 'Scan the codebase and return overall quality: average rating, rating distribution, ' +
+            'worst-rated files, most common violations, and topological fix order.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                directory: {
+                    type: 'string',
+                    description: 'Absolute path to the directory to scan (defaults to git root or cwd)',
+                },
+                max_files: {
+                    type: 'number',
+                    description: 'Maximum files to analyze (default 200)',
+                },
+            },
+        },
+    },
+];
+/** Send JSON-RPC response to stdout */
+function send(response) {
+    const json = JSON.stringify(response);
+    process.stdout.write(json + '\n');
+}
+/** Send successful result */
+function sendResult(id, result) {
+    send({ jsonrpc: '2.0', id, result });
+}
+/** Send error response */
+function sendError(id, code, message) {
+    send({ jsonrpc: '2.0', id, error: { code, message } });
+}
+/** Handle incoming JSON-RPC message */
+async function handleMessage(msg) {
+    const { id, method, params } = msg;
+    switch (method) {
+        case 'initialize':
+            sendResult(id ?? null, {
+                protocolVersion: '2024-11-05',
+                capabilities: { tools: {} },
+                serverInfo: { name: 'gate-keeper', version: '1.0.0' },
+            });
+            break;
+        case 'notifications/initialized':
+            // No response needed for notifications
+            break;
+        case 'tools/list':
+            sendResult(id ?? null, { tools: exports.TOOLS });
+            break;
+        case 'tools/call': {
+            const callParams = params;
+            const toolName = String(callParams?.name ?? '');
+            const toolArgs = (callParams?.arguments ?? {});
+            try {
+                const result = await (0, handlers_1.handleToolCall)(toolName, toolArgs);
+                sendResult(id ?? null, result);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                sendResult(id ?? null, {
+                    content: [{ type: 'text', text: `Error: ${message}` }],
+                    isError: true,
+                });
+            }
+            break;
+        }
+        case 'ping':
+            sendResult(id ?? null, {});
+            break;
+        default:
+            // Ignore unknown notifications (no id), error on unknown requests (with id)
+            if (id !== undefined) {
+                sendError(id, -32601, `Method not found: ${method}`);
+            }
+            break;
+    }
+}
+/** Process a line of input from stdin */
+function processLine(line, buffer) {
+    buffer.current += line;
+    let nlIndex;
+    while ((nlIndex = buffer.current.indexOf('\n')) !== -1) {
+        const completeLine = buffer.current.substring(0, nlIndex).trim();
+        buffer.current = buffer.current.substring(nlIndex + 1);
+        if (!completeLine || completeLine.startsWith('Content-Length:'))
+            continue;
+        try {
+            const msg = JSON.parse(completeLine);
+            handleMessage(msg).catch(err => {
+                process.stderr.write(`[gate-keeper] Handler error: ${err}\n`);
+            });
+        }
+        catch {
+            // Not valid JSON — skip
+        }
+    }
+}
+/** Start the MCP server (stdio transport) */
+function startServer() {
+    const buffer = { current: '' };
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (chunk) => {
+        buffer.current += chunk;
+        let nlIndex;
+        while ((nlIndex = buffer.current.indexOf('\n')) !== -1) {
+            const line = buffer.current.substring(0, nlIndex).trim();
+            buffer.current = buffer.current.substring(nlIndex + 1);
+            if (!line || line.startsWith('Content-Length:'))
+                continue;
+            try {
+                const msg = JSON.parse(line);
+                handleMessage(msg).catch(err => {
+                    process.stderr.write(`[gate-keeper] Handler error: ${err}\n`);
+                });
+            }
+            catch {
+                // Not valid JSON — skip
+            }
+        }
+    });
+    process.stdin.on('end', () => process.exit(0));
+    process.stderr.write('[gate-keeper] MCP server started (stdio)\n');
+}
+// Only start server when run directly, not when imported for testing
+if (require.main === module) {
+    startServer();
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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