@kevinbermudezc/context-guard 1.1.1 → 1.2.0

package/README.md

@@ -145,7 +145,73 @@ That's it! When Claude Code attempts to run `Read` (or raw bash reads like `cat
 
 ---
 
-## 🛠️ CLI Usage
+## 🔌 MCP Server — Universal Agent Integration (Phase 2)
+
+ContextGuard ships a built-in **Model Context Protocol (MCP) server** compatible with any MCP host: **Cursor, Windsurf, Claude Desktop, Antigravity (AGY), Zed**, and more.
+
+The MCP server exposes three tools:
+
+| Tool | Description | Cost | Latency |
+|---|---|---|---|
+| `read_file_safe` | Protected file read — passthrough for small files, AST skeleton for large ones, block for binaries/lockfiles | **\$0.00** | **< 5ms** |
+| `inspect_outline` | Instant structural outline (classes, functions, types, signals) with line numbers | **\$0.00** | **< 5ms** |
+| `grep_distilled` | Pattern search returning only structural context around matches, never full file dumps | **\$0.00** | **< 50ms** |
+
+### Install & Run
+
+```bash
+# One-shot (no install):
+npx -y @kevinbermudezc/context-guard context-guard-mcp
+
+# Or as a local dependency:
+pnpm add -D @kevinbermudezc/context-guard
+node ./node_modules/@kevinbermudezc/context-guard/dist/bin/mcp-server.js
+```
+
+### 🖱️ Cursor (`~/.cursor/mcp.json`)
+
+```json
+{
+  "mcpServers": {
+    "context-guard": {
+      "command": "npx",
+      "args": ["-y", "@kevinbermudezc/context-guard@latest", "context-guard-mcp"]
+    }
+  }
+}
+```
+
+### 🤖 Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`)
+
+```json
+{
+  "mcpServers": {
+    "context-guard": {
+      "command": "npx",
+      "args": ["-y", "@kevinbermudezc/context-guard@latest", "context-guard-mcp"]
+    }
+  }
+}
+```
+
+### 🪁 Antigravity / Google AGY (`.agents/mcp.json` or `~/.config/agy/mcp.json`)
+
+```json
+{
+  "mcpServers": {
+    "context-guard": {
+      "command": "npx",
+      "args": ["-y", "@kevinbermudezc/context-guard@latest", "context-guard-mcp"]
+    }
+  }
+}
+```
+
+> **Note:** Configuration examples are also available in [`examples/mcp-configs/`](./examples/mcp-configs/).
+
+---
+
+## 🛠️ CLI Usage (Claude Code Hook)
 
 You can also use ContextGuard directly as a command-line tool:
 

package/dist/bin/mcp-server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=mcp-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../bin/mcp-server.ts"],"names":[],"mappings":""}

package/dist/bin/mcp-server.js

@@ -0,0 +1,328 @@
+#!/usr/bin/env node
+/**
+ * ContextGuard MCP Server (Phase 2)
+ * Universal Model Context Protocol server exposing ContextGuard's context
+ * admission and token optimization engine as MCP tools.
+ *
+ * Compatible with: Claude Desktop, Cursor, Windsurf, Antigravity (AGY), Zed.
+ * Transport: stdio (JSON-RPC 2.0)
+ * SDK: @modelcontextprotocol/server v2 (2026-07-28 spec)
+ *
+ * Tools:
+ *   read_file_safe   — Protected file read with size guard + AST skeleton fallback
+ *   inspect_outline  — Instant structural outline of any source file (<5ms, $0.00)
+ *   grep_distilled   — Pattern search returning structural context around matches
+ */
+import { McpServer } from '@modelcontextprotocol/server';
+import { StdioServerTransport } from '@modelcontextprotocol/server/stdio';
+import { z } from 'zod';
+import fs from 'node:fs';
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+import { processWithContextGuard } from '../src/index.js';
+import { extractCodeSkeleton, isSupportedExtension } from '../src/skeletonizer.js';
+// ─── Constants ────────────────────────────────────────────────────────────────
+const SERVER_NAME = 'context-guard';
+const SERVER_VERSION = '1.2.0';
+// Native Claude Code / multimodal formats — allow full passthrough
+const NATIVE_MEDIA_EXTS = new Set([
+    '.png', '.jpg', '.jpeg', '.gif', '.webp', '.svg', '.ico', '.bmp', '.avif',
+    '.pdf', '.ipynb'
+]);
+// ─── Server Setup ─────────────────────────────────────────────────────────────
+const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION });
+// ─── Tool: read_file_safe ─────────────────────────────────────────────────────
+server.registerTool('read_file_safe', {
+    title: 'Read File (ContextGuard Protected)',
+    description: [
+        'Reads a source file through the ContextGuard admission layer.',
+        '• If the file is small (≤300 lines / ≤25 KB): returns full content directly.',
+        '• If the file is large: returns an AST structural skeleton with line-tagged signatures.',
+        '• If the file is a binary (wasm/zip/sqlite/dll), lockfile, or minified bundle: returns an informative block message with CLI alternatives.',
+        '• If start_line / end_line are provided: returns the exact slice without applying the guard.',
+        'This tool replaces raw "Read file" calls and prevents context window flooding from large files.'
+    ].join('\n'),
+    inputSchema: {
+        file_path: z.string().describe('Absolute or relative path to the file to read.'),
+        start_line: z.number().int().positive().optional().describe('First line to read (1-indexed). Bypasses size guard if set.'),
+        end_line: z.number().int().positive().optional().describe('Last line to read (1-indexed, inclusive). Bypasses size guard if set.'),
+        query: z.string().optional().describe('Optional semantic question. If provided, the file is passed to a worker model (Gemini Flash / Ollama) for summarization instead of AST extraction.')
+    }
+}, async ({ file_path, start_line, end_line, query }) => {
+    try {
+        const resolved = path.resolve(process.cwd(), file_path);
+        // File existence check
+        if (!fs.existsSync(resolved)) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `⚠️ [CONTEXTGUARD] File not found: ${file_path}`
+                    }]
+            };
+        }
+        if (fs.statSync(resolved).isDirectory()) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `⚠️ [CONTEXTGUARD] Path is a directory: ${file_path}. Use a file path.`
+                    }]
+            };
+        }
+        const ext = path.extname(resolved).toLowerCase();
+        // Native multimodal / notebook formats — passthrough directly
+        if (NATIVE_MEDIA_EXTS.has(ext)) {
+            const raw = fs.readFileSync(resolved);
+            const isText = ext === '.ipynb' || ext === '.svg';
+            return {
+                content: [{
+                        type: 'text',
+                        text: isText
+                            ? raw.toString('utf-8')
+                            : `[Native binary format: ${ext}. Use multimodal vision tool or platform viewer to inspect.]`
+                    }]
+            };
+        }
+        // Run through ContextGuard engine
+        const result = await processWithContextGuard({
+            filePath: file_path,
+            startLine: start_line,
+            endLine: end_line,
+            query: query ?? ''
+        });
+        // Format the response with status metadata header
+        const statusBadge = {
+            PASSTHROUGH_FULL: '✅ PASSTHROUGH',
+            PASSTHROUGH_SLICE: '✅ SLICE',
+            SHUNTED_LOCAL_AST: '🛡️ AST SKELETON',
+            SHUNTED_WORKER_MODEL: '🤖 WORKER SUMMARY',
+            SHUNT_FALLBACK: '⚠️ FALLBACK',
+            BLOCKED_BINARY: '🛑 BLOCKED (BINARY)',
+            BLOCKED_LOCKFILE: '🛑 BLOCKED (LOCKFILE)',
+            BLOCKED_MINIFIED: '🛑 BLOCKED (MINIFIED)',
+            ERROR: '❌ ERROR'
+        };
+        const badge = statusBadge[result.status] ?? result.status;
+        const meta = result.totalLines
+            ? `${result.totalLines} lines · ${((result.sizeBytes ?? 0) / 1024).toFixed(1)} KB`
+            : '';
+        const header = meta
+            ? `<!-- [CONTEXTGUARD ${badge}] ${meta} -->\n`
+            : `<!-- [CONTEXTGUARD ${badge}] -->\n`;
+        const isBlocked = ['BLOCKED_BINARY', 'BLOCKED_LOCKFILE', 'BLOCKED_MINIFIED', 'ERROR'].includes(result.status);
+        return {
+            content: [{
+                    type: 'text',
+                    text: isBlocked
+                        ? `${badge}\n\n${result.content || result.error || result.reason}`
+                        : header + result.content
+                }],
+            isError: isBlocked
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `❌ [CONTEXTGUARD ERROR] ${err.message}` }],
+            isError: true
+        };
+    }
+});
+// ─── Tool: inspect_outline ────────────────────────────────────────────────────
+server.registerTool('inspect_outline', {
+    title: 'Inspect File Outline',
+    description: [
+        'Returns a structural outline (classes, interfaces, functions, types, signals) of a source file.',
+        'This is a zero-cost, <5ms operation using the Tier 0 local AST skeletonizer.',
+        'Supports: TypeScript, JavaScript, Python, Go, Rust, Java, C#, Svelte 5, Vue 3, Angular, Astro.',
+        'Use this to navigate large files before calling read_file_safe with targeted line ranges.',
+        'Returns null if the file format is not supported for structural extraction.'
+    ].join('\n'),
+    inputSchema: {
+        file_path: z.string().describe('Absolute or relative path to the source file.')
+    }
+}, async ({ file_path }) => {
+    try {
+        const resolved = path.resolve(process.cwd(), file_path);
+        if (!fs.existsSync(resolved)) {
+            return {
+                content: [{ type: 'text', text: `⚠️ File not found: ${file_path}` }],
+                isError: true
+            };
+        }
+        const ext = path.extname(resolved);
+        const langKey = isSupportedExtension(ext);
+        if (!langKey) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `ℹ️ [CONTEXTGUARD] File format "${ext}" is not supported for structural outline extraction.\nSupported: .ts, .tsx, .js, .jsx, .py, .go, .rs, .java, .cs, .svelte, .vue, .astro`
+                    }]
+            };
+        }
+        const raw = fs.readFileSync(resolved, 'utf-8');
+        const stat = fs.statSync(resolved);
+        const totalLines = raw.split('\n').length;
+        const skeleton = extractCodeSkeleton(raw, ext);
+        if (!skeleton) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `ℹ️ [CONTEXTGUARD] No structural declarations found in "${path.basename(file_path)}" (${totalLines} lines).`
+                    }]
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        `<!-- [CONTEXTGUARD OUTLINE] ${path.basename(file_path)} · ${totalLines} lines · ${(stat.size / 1024).toFixed(1)} KB -->`,
+                        `<!-- Use read_file_safe(file_path, start_line=N, end_line=M) to read any section. -->`,
+                        '',
+                        skeleton
+                    ].join('\n')
+                }]
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `❌ [CONTEXTGUARD ERROR] ${err.message}` }],
+            isError: true
+        };
+    }
+});
+// ─── Tool: grep_distilled ─────────────────────────────────────────────────────
+server.registerTool('grep_distilled', {
+    title: 'Grep (Distilled)',
+    description: [
+        'Searches for a pattern in files and returns only the structural outline of matching files,',
+        'not the full content. Prevents context flooding when searching across a large codebase.',
+        'For each matching file, returns the filename, matching lines, and the structural skeleton.',
+        'Pattern supports ripgrep syntax (fixed strings by default, pass is_regex=true for regex).',
+        'Results are capped at 20 files to keep context manageable.'
+    ].join('\n'),
+    inputSchema: {
+        pattern: z.string().describe('Search pattern (string or regex if is_regex=true).'),
+        directory: z.string().optional().describe('Directory to search in. Defaults to current working directory.'),
+        include: z.string().optional().describe('Glob to filter files (e.g. "*.ts", "src/**/*.py"). Defaults to all text files.'),
+        is_regex: z.boolean().optional().describe('Treat pattern as a regex. Default false (fixed string search).')
+    }
+}, async ({ pattern, directory, include, is_regex }) => {
+    try {
+        const searchDir = directory ? path.resolve(process.cwd(), directory) : process.cwd();
+        if (!fs.existsSync(searchDir)) {
+            return {
+                content: [{ type: 'text', text: `⚠️ Directory not found: ${directory}` }],
+                isError: true
+            };
+        }
+        // Build ripgrep command
+        const rgArgs = [
+            '--line-number',
+            '--with-filename',
+            '--no-heading',
+            '--color=never',
+            '--max-count=5', // max 5 matches per file
+            '-l' // list matching files first
+        ];
+        if (!is_regex)
+            rgArgs.push('--fixed-strings');
+        if (include)
+            rgArgs.push('--glob', include);
+        rgArgs.push('--', pattern, searchDir);
+        let matchingFiles = [];
+        try {
+            const output = execSync(`rg ${rgArgs.map(a => JSON.stringify(a)).join(' ')}`, {
+                encoding: 'utf-8',
+                maxBuffer: 1024 * 512
+            });
+            matchingFiles = output.trim().split('\n').filter(Boolean).slice(0, 20);
+        }
+        catch (rgErr) {
+            // rg exits with 1 if no matches
+            if (rgErr.status === 1) {
+                return {
+                    content: [{ type: 'text', text: `ℹ️ [CONTEXTGUARD GREP] No matches for "${pattern}" in ${searchDir}` }]
+                };
+            }
+            // rg not installed — fall back to a Node.js glob scan
+            return {
+                content: [{ type: 'text', text: `⚠️ ripgrep (rg) is not available. Install it with: brew install ripgrep\nCannot perform distilled grep without rg.` }],
+                isError: true
+            };
+        }
+        if (matchingFiles.length === 0) {
+            return {
+                content: [{ type: 'text', text: `ℹ️ [CONTEXTGUARD GREP] No matches for "${pattern}"` }]
+            };
+        }
+        // For each matching file: get matching lines + structural outline
+        const results = [
+            `<!-- [CONTEXTGUARD GREP] Pattern: "${pattern}" | ${matchingFiles.length} matching files -->`,
+            ''
+        ];
+        for (const filePath of matchingFiles) {
+            const ext = path.extname(filePath);
+            const relPath = path.relative(process.cwd(), filePath);
+            // Get matching lines with context
+            let matchLines = '';
+            try {
+                const matchArgs = [
+                    '--line-number', '--no-heading', '--color=never',
+                    '--max-count=5', '--context=1'
+                ];
+                if (!is_regex)
+                    matchArgs.push('--fixed-strings');
+                if (include)
+                    matchArgs.push('--glob', include);
+                matchArgs.push('--', pattern, filePath);
+                matchLines = execSync(`rg ${matchArgs.map(a => JSON.stringify(a)).join(' ')}`, {
+                    encoding: 'utf-8',
+                    maxBuffer: 1024 * 64
+                }).trim();
+            }
+            catch {
+                matchLines = '(error reading match lines)';
+            }
+            // Get structural outline
+            const raw = fs.readFileSync(filePath, 'utf-8');
+            const skeleton = extractCodeSkeleton(raw, ext);
+            const stat = fs.statSync(filePath);
+            const totalLines = raw.split('\n').length;
+            results.push(`### ${relPath} (${totalLines} lines, ${(stat.size / 1024).toFixed(1)} KB)`);
+            results.push('**Matches:**');
+            results.push('```');
+            results.push(matchLines);
+            results.push('```');
+            if (skeleton) {
+                results.push('**Structural outline:**');
+                results.push('```');
+                results.push(skeleton);
+                results.push('```');
+            }
+            results.push('');
+        }
+        if (matchingFiles.length === 20) {
+            results.push('> ⚠️ Results capped at 20 files. Narrow your search with a more specific pattern or --include glob.');
+        }
+        return {
+            content: [{ type: 'text', text: results.join('\n') }]
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `❌ [CONTEXTGUARD ERROR] ${err.message}` }],
+            isError: true
+        };
+    }
+});
+// ─── Start ─────────────────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr — never to stdout (would corrupt JSON-RPC channel)
+    process.stderr.write(`[ContextGuard MCP] Server v${SERVER_VERSION} running on stdio\n`);
+}
+main().catch((err) => {
+    process.stderr.write(`[ContextGuard MCP] Fatal error: ${err.message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=mcp-server.js.map

package/dist/bin/mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../../bin/mcp-server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnF,iFAAiF;AAEjF,MAAM,WAAW,GAAG,eAAe,CAAC;AACpC,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,mEAAmE;AACnE,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;IACzE,MAAM,EAAE,QAAQ;CACjB,CAAC,CAAC;AAEH,iFAAiF;AAEjF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;AAE7E,iFAAiF;AAEjF,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;IACE,KAAK,EAAE,oCAAoC;IAC3C,WAAW,EAAE;QACX,+DAA+D;QAC/D,8EAA8E;QAC9E,yFAAyF;QACzF,4IAA4I;QAC5I,8FAA8F;QAC9F,iGAAiG;KAClG,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,WAAW,EAAE;QACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;QAChF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;QAC1H,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uEAAuE,CAAC;QAClI,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oJAAoJ,CAAC;KAC5L;CACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;IACnD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;QAExD,uBAAuB;QACvB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,qCAAqC,SAAS,EAAE;qBACvD,CAAC;aACH,CAAC;QACJ,CAAC;QAED,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACxC,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,0CAA0C,SAAS,oBAAoB;qBAC9E,CAAC;aACH,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAEjD,8DAA8D;QAC9D,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACtC,MAAM,MAAM,GAAG,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,MAAM,CAAC;YAClD,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,MAAM;4BACV,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;4BACvB,CAAC,CAAC,0BAA0B,GAAG,8DAA8D;qBAChG,CAAC;aACH,CAAC;QACJ,CAAC;QAED,kCAAkC;QAClC,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC;YAC3C,QAAQ,EAAE,SAAS;YACnB,SAAS,EAAE,UAAU;YACrB,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,KAAK,IAAI,EAAE;SACnB,CAAC,CAAC;QAEH,kDAAkD;QAClD,MAAM,WAAW,GAA2B;YAC1C,gBAAgB,EAAE,eAAe;YACjC,iBAAiB,EAAE,SAAS;YAC5B,iBAAiB,EAAE,kBAAkB;YACrC,oBAAoB,EAAE,mBAAmB;YACzC,cAAc,EAAE,aAAa;YAC7B,cAAc,EAAE,qBAAqB;YACrC,gBAAgB,EAAE,uBAAuB;YACzC,gBAAgB,EAAE,uBAAuB;YACzC,KAAK,EAAE,SAAS;SACjB,CAAC;QAEF,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU;YAC5B,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,YAAY,CAAC,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;YAClF,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,MAAM,GAAG,IAAI;YACjB,CAAC,CAAC,sBAAsB,KAAK,KAAK,IAAI,QAAQ;YAC9C,CAAC,CAAC,sBAAsB,KAAK,SAAS,CAAC;QAEzC,MAAM,SAAS,GAAG,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAE9G,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,SAAS;wBACb,CAAC,CAAC,GAAG,KAAK,OAAO,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE;wBAClE,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO;iBAC5B,CAAC;YACF,OAAO,EAAE,SAAS;SACnB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CACF,CAAC;AAEF,iFAAiF;AAEjF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;IACE,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EAAE;QACX,iGAAiG;QACjG,8EAA8E;QAC9E,gGAAgG;QAChG,2FAA2F;QAC3F,6EAA6E;KAC9E,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,WAAW,EAAE;QACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;KAChF;CACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;IACtB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;QAExD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,SAAS,EAAE,EAAE,CAAC;gBACpE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAE1C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,kCAAkC,GAAG,0IAA0I;qBACtL,CAAC;aACH,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAC1C,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAE/C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,0DAA0D,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,UAAU,UAAU;qBACnH,CAAC;aACH,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACJ,+BAA+B,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,UAAU,YAAY,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;wBACzH,uFAAuF;wBACvF,EAAE;wBACF,QAAQ;qBACT,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb,CAAC;SACH,CAAC;IACJ,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CACF,CAAC;AAEF,iFAAiF;AAEjF,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;IACE,KAAK,EAAE,kBAAkB;IACzB,WAAW,EAAE;QACX,4FAA4F;QAC5F,yFAAyF;QACzF,4FAA4F;QAC5F,2FAA2F;QAC3F,4DAA4D;KAC7D,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,WAAW,EAAE;QACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;QAClF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;QAC3G,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;QACzH,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;KAC5G;CACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;IAClD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAErF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,SAAS,EAAE,EAAE,CAAC;gBACzE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,wBAAwB;QACxB,MAAM,MAAM,GAAa;YACvB,eAAe;YACf,iBAAiB;YACjB,cAAc;YACd,eAAe;YACf,eAAe,EAAO,yBAAyB;YAC/C,IAAI,CAAmB,4BAA4B;SACpD,CAAC;QAEF,IAAI,CAAC,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9C,IAAI,OAAO;YAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QAEtC,IAAI,aAAa,GAAa,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE;gBAC5E,QAAQ,EAAE,OAAO;gBACjB,SAAS,EAAE,IAAI,GAAG,GAAG;aACtB,CAAC,CAAC;YACH,aAAa,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,gCAAgC;YAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0CAA0C,OAAO,QAAQ,SAAS,EAAE,EAAE,CAAC;iBACxG,CAAC;YACJ,CAAC;YACD,sDAAsD;YACtD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oHAAoH,EAAE,CAAC;gBACvJ,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0CAA0C,OAAO,GAAG,EAAE,CAAC;aACxF,CAAC;QACJ,CAAC;QAED,kEAAkE;QAClE,MAAM,OAAO,GAAa;YACxB,sCAAsC,OAAO,OAAO,aAAa,CAAC,MAAM,qBAAqB;YAC7F,EAAE;SACH,CAAC;QAEF,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACnC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;YAEvD,kCAAkC;YAClC,IAAI,UAAU,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG;oBAChB,eAAe,EAAE,cAAc,EAAE,eAAe;oBAChD,eAAe,EAAE,aAAa;iBAC/B,CAAC;gBACF,IAAI,CAAC,QAAQ;oBAAE,SAAS,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;gBACjD,IAAI,OAAO;oBAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC/C,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;gBACxC,UAAU,GAAG,QAAQ,CAAC,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE;oBAC7E,QAAQ,EAAE,OAAO;oBACjB,SAAS,EAAE,IAAI,GAAG,EAAE;iBACrB,CAAC,CAAC,IAAI,EAAE,CAAC;YACZ,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU,GAAG,6BAA6B,CAAC;YAC7C,CAAC;YAED,yBAAyB;YACzB,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC/C,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC/C,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACnC,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YAE1C,OAAO,CAAC,IAAI,CAAC,OAAO,OAAO,KAAK,UAAU,WAAW,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC1F,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;gBACxC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,qGAAqG,CAAC,CAAC;QACtH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;SACtD,CAAC;IACJ,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CACF,CAAC;AAEF,kFAAkF;AAElF,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,mEAAmE;IACnE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,cAAc,qBAAqB,CAAC,CAAC;AAC1F,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;IACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tests/mcp-server.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-server.test.d.ts.map

package/dist/tests/mcp-server.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.test.d.ts","sourceRoot":"","sources":["../../tests/mcp-server.test.ts"],"names":[],"mappings":""}

package/dist/tests/mcp-server.test.js

@@ -0,0 +1,215 @@
+/**
+ * MCP Server Integration Tests (Phase 2)
+ * Tests the ContextGuard MCP server by spawning it as a child process
+ * and sending JSON-RPC 2.0 messages over stdin/stdout.
+ */
+import { describe, it, before, after } from 'node:test';
+import assert from 'node:assert';
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+import fs from 'node:fs';
+import os from 'node:os';
+import { fileURLToPath } from 'node:url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const MCP_SERVER_BIN = path.resolve(__dirname, '../../dist/bin/mcp-server.js');
+function sendRequest(proc, request) {
+    return new Promise((resolve, reject) => {
+        let buffer = '';
+        const onData = (chunk) => {
+            buffer += chunk.toString();
+            const lines = buffer.split('\n');
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const parsed = JSON.parse(line);
+                    if (parsed.id === request.id) {
+                        proc.stdout.removeListener('data', onData);
+                        resolve(parsed);
+                        return;
+                    }
+                }
+                catch {
+                    // partial or unrelated line — continue
+                }
+            }
+            buffer = lines[lines.length - 1] ?? '';
+        };
+        proc.stdout.on('data', onData);
+        proc.on('error', reject);
+        proc.stdin.write(JSON.stringify(request) + '\n');
+        setTimeout(() => {
+            proc.stdout.removeListener('data', onData);
+            reject(new Error(`Timeout waiting for response to request id=${request.id}`));
+        }, 5000);
+    });
+}
+// ─── Test Suite ───────────────────────────────────────────────────────────────
+describe('ContextGuard MCP Server (Phase 2)', () => {
+    let proc;
+    let nextId = 1;
+    const req = (method, params) => ({
+        jsonrpc: '2.0',
+        id: nextId++,
+        method,
+        params
+    });
+    before(() => {
+        proc = spawn('node', [MCP_SERVER_BIN], {
+            stdio: ['pipe', 'pipe', 'pipe']
+        });
+        proc.stderr.on('data', (d) => {
+            // Suppress server startup messages in test output
+            void d;
+        });
+        // Give the server a moment to initialize
+        return new Promise((r) => setTimeout(r, 300));
+    });
+    after(() => {
+        proc.stdin.end();
+        proc.kill();
+    });
+    // ── Initialization ──────────────────────────────────────────────────────────
+    it('should respond to initialize handshake', async () => {
+        const res = await sendRequest(proc, req('initialize', {
+            protocolVersion: '2024-11-05',
+            capabilities: {},
+            clientInfo: { name: 'test-client', version: '0.1.0' }
+        }));
+        assert.ok(!res.error, `Unexpected error: ${JSON.stringify(res.error)}`);
+        const result = res.result;
+        assert.ok(result.serverInfo, 'Must include serverInfo');
+        const info = result.serverInfo;
+        assert.strictEqual(info.name, 'context-guard');
+        assert.strictEqual(info.version, '1.2.0');
+    });
+    it('should list exactly 3 registered tools', async () => {
+        const res = await sendRequest(proc, req('tools/list'));
+        assert.ok(!res.error, `Unexpected error: ${JSON.stringify(res.error)}`);
+        const result = res.result;
+        const names = result.tools.map((t) => t.name);
+        assert.ok(names.includes('read_file_safe'), 'read_file_safe must be registered');
+        assert.ok(names.includes('inspect_outline'), 'inspect_outline must be registered');
+        assert.ok(names.includes('grep_distilled'), 'grep_distilled must be registered');
+        assert.strictEqual(names.length, 3, 'Must have exactly 3 tools');
+    });
+    // ── read_file_safe ──────────────────────────────────────────────────────────
+    it('read_file_safe: should return full content for a small file', async () => {
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-mcp-'));
+        const tmpFile = path.join(tmpDir, 'small.ts');
+        fs.writeFileSync(tmpFile, 'export const foo = 42;\nexport const bar = "hello";\n');
+        const res = await sendRequest(proc, req('tools/call', {
+            name: 'read_file_safe',
+            arguments: { file_path: tmpFile }
+        }));
+        assert.ok(!res.error, `Unexpected error: ${JSON.stringify(res.error)}`);
+        const result = res.result;
+        const text = result.content[0].text;
+        assert.ok(text.includes('PASSTHROUGH'), 'Must include PASSTHROUGH badge for small file');
+        assert.ok(text.includes('foo') || text.includes('bar'), 'Must include file content');
+        fs.rmSync(tmpDir, { recursive: true });
+    });
+    it('read_file_safe: should return AST skeleton for a large TypeScript file', async () => {
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-mcp-'));
+        const tmpFile = path.join(tmpDir, 'large.ts');
+        // Generate a file larger than 300 lines
+        const lines = [
+            'import path from "node:path";',
+            'import fs from "node:fs";',
+            '',
+            'export interface UserService {',
+            '  getUser(id: string): Promise<User>;',
+            '  createUser(data: CreateUserDto): Promise<User>;',
+            '}',
+            '',
+            'export class UserServiceImpl implements UserService {',
+            '  async getUser(id: string): Promise<User> { return null as any; }',
+            '  async createUser(data: CreateUserDto): Promise<User> { return null as any; }',
+            '}'
+        ];
+        // Pad to >300 lines
+        while (lines.length < 310)
+            lines.push(`  // line ${lines.length}`);
+        fs.writeFileSync(tmpFile, lines.join('\n'));
+        const res = await sendRequest(proc, req('tools/call', {
+            name: 'read_file_safe',
+            arguments: { file_path: tmpFile }
+        }));
+        assert.ok(!res.error, `Unexpected error: ${JSON.stringify(res.error)}`);
+        const result = res.result;
+        const text = result.content[0].text;
+        assert.ok(text.includes('SKELETON') || text.includes('SHUNT') || text.includes('UserService'), 'Must return skeleton or structural content for large file');
+        fs.rmSync(tmpDir, { recursive: true });
+    });
+    it('read_file_safe: should block a .wasm binary with isError=true', async () => {
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-mcp-'));
+        const wasmFile = path.join(tmpDir, 'module.wasm');
+        fs.writeFileSync(wasmFile, Buffer.from([0x00, 0x61, 0x73, 0x6d, 0x01, 0x00, 0x00, 0x00]));
+        const res = await sendRequest(proc, req('tools/call', {
+            name: 'read_file_safe',
+            arguments: { file_path: wasmFile }
+        }));
+        assert.ok(!res.error, 'JSON-RPC should not error — tool should handle it gracefully');
+        const result = res.result;
+        assert.ok(result.isError === true, 'isError must be true for blocked binary');
+        const text = result.content[0].text;
+        assert.ok(text.includes('BLOCKED') || text.includes('binario'), 'Must include block reason');
+        fs.rmSync(tmpDir, { recursive: true });
+    });
+    it('read_file_safe: should return a scoped slice when start_line/end_line given', async () => {
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-mcp-'));
+        const tmpFile = path.join(tmpDir, 'ranged.ts');
+        const content = Array.from({ length: 50 }, (_, i) => `// line ${i + 1}`).join('\n');
+        fs.writeFileSync(tmpFile, content);
+        const res = await sendRequest(proc, req('tools/call', {
+            name: 'read_file_safe',
+            arguments: { file_path: tmpFile, start_line: 5, end_line: 10 }
+        }));
+        assert.ok(!res.error, `Unexpected error: ${JSON.stringify(res.error)}`);
+        const result = res.result;
+        const text = result.content[0].text;
+        assert.ok(text.includes('line 5') || text.includes('SLICE'), 'Must contain sliced content');
+        fs.rmSync(tmpDir, { recursive: true });
+    });
+    // ── inspect_outline ─────────────────────────────────────────────────────────
+    it('inspect_outline: should return structural outline for a TypeScript file', async () => {
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-mcp-'));
+        const tmpFile = path.join(tmpDir, 'service.ts');
+        fs.writeFileSync(tmpFile, [
+            'export interface AuthService {',
+            '  login(email: string, password: string): Promise<string>;',
+            '  logout(token: string): void;',
+            '}',
+            '',
+            'export class AuthServiceImpl implements AuthService {',
+            '  async login(email: string, password: string): Promise<string> { return "token"; }',
+            '  logout(token: string): void {}',
+            '}'
+        ].join('\n'));
+        const res = await sendRequest(proc, req('tools/call', {
+            name: 'inspect_outline',
+            arguments: { file_path: tmpFile }
+        }));
+        assert.ok(!res.error, `Unexpected error: ${JSON.stringify(res.error)}`);
+        const result = res.result;
+        const text = result.content[0].text;
+        assert.ok(text.includes('AuthService') || text.includes('login'), 'Must include structural declarations');
+        assert.ok(text.includes('OUTLINE'), 'Must include OUTLINE badge');
+        fs.rmSync(tmpDir, { recursive: true });
+    });
+    // ── grep_distilled ──────────────────────────────────────────────────────────
+    it('grep_distilled: should return no-match message when pattern is not found', async () => {
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-mcp-'));
+        fs.writeFileSync(path.join(tmpDir, 'a.ts'), 'export const x = 1;');
+        const res = await sendRequest(proc, req('tools/call', {
+            name: 'grep_distilled',
+            arguments: { pattern: 'PATTERN_THAT_DOES_NOT_EXIST_XYZ123', directory: tmpDir }
+        }));
+        assert.ok(!res.error, `Unexpected error: ${JSON.stringify(res.error)}`);
+        const result = res.result;
+        const text = result.content[0].text;
+        assert.ok(text.includes('No matches') || text.includes('not available'), 'Must indicate no matches');
+        fs.rmSync(tmpDir, { recursive: true });
+    });
+});
+//# sourceMappingURL=mcp-server.test.js.map

package/dist/tests/mcp-server.test.js.map

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

package/examples/claude-settings.json

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Read|Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ./node_modules/@kevinbermudezc/context-guard/dist/bin/claude-hook.js"
+          }
+        ]
+      }
+    ]
+  }
+}

package/examples/mcp-configs/antigravity-mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "context-guard": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@kevinbermudezc/context-guard@latest",
+        "context-guard-mcp"
+      ]
+    }
+  }
+}

package/examples/mcp-configs/claude-desktop.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "context-guard": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@kevinbermudezc/context-guard@latest",
+        "context-guard-mcp"
+      ]
+    }
+  }
+}

package/examples/mcp-configs/cursor-mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "context-guard": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@kevinbermudezc/context-guard@latest",
+        "context-guard-mcp"
+      ]
+    }
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kevinbermudezc/context-guard",
-  "version": "1.1.1",
-  "description": "Intelligent context admission control and token optimization for Claude Code, Cursor, and Agentic workflows.",
+  "version": "1.2.0",
+  "description": "Intelligent context admission control and token optimization for Claude Code, Cursor, Windsurf, Antigravity, and Agentic AI workflows.",
   "publishConfig": {
     "access": "public"
   },
@@ -10,19 +10,26 @@
   "types": "./dist/src/index.d.ts",
   "bin": {
     "context-guard": "./dist/bin/context-guard.js",
-    "context-guard-hook": "./dist/bin/claude-hook.js"
+    "context-guard-hook": "./dist/bin/claude-hook.js",
+    "context-guard-mcp": "./dist/bin/mcp-server.js"
   },
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "examples"
   ],
   "devDependencies": {
     "@types/node": "^22.13.9",
-    "typescript": "^7.0.2"
+    "typescript": "^7.0.2",
+    "zod": "^4.6.5"
   },
   "keywords": [
     "claude-code",
+    "cursor",
+    "windsurf",
+    "mcp",
+    "model-context-protocol",
     "pretooluse-hook",
     "ai-agent",
     "token-optimization",
@@ -43,6 +50,9 @@
   "engines": {
     "node": ">=18.0.0"
   },
+  "dependencies": {
+    "@modelcontextprotocol/server": "2.2.0"
+  },
   "scripts": {
     "build": "tsc && chmod +x dist/bin/*.js",
     "test": "pnpm run build && node --test dist/tests/**/*.test.js"