@kevinbermudezc/context-guard 1.1.1 → 1.2.1

package/README.md

@@ -145,7 +145,82 @@ 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 tools, passive resources, and optimized prompt templates:
+
+### 🛠️ 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 (uses ripgrep with pure Node fallback) | **\$0.00** | **< 50ms** |
+
+### 📦 Resources & Prompts
+
+| Type | URI / Name | Description |
+|---|---|---|
+| **Resource** | `contextguard://config` | Live inspection of active thresholds, bypass formats, and worker provider |
+| **Prompt** | `investigate_codebase_safely` | System prompt template enforcing token preservation and outline-first navigation |
+
+### Install & Run
+
+```bash
+# One-shot (no install):
+npx -y -p @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", "-p", "@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", "-p", "@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", "-p", "@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,446 @@
+#!/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 { processWithContextGuard } from '../src/index.js';
+import { CONFIG } from '../src/config.js';
+import { extractCodeSkeleton, isSupportedExtension } from '../src/skeletonizer.js';
+import { spawnSync } from 'node:child_process';
+// ─── 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'
+]);
+// Ignored directories for pure Node recursive scan fallback
+const IGNORED_DIRS = new Set([
+    'node_modules', '.git', 'dist', 'build', '.next', '.turbo', '.cache',
+    'coverage', '.vscode', '.idea'
+]);
+/**
+ * Pure Node.js fallback scanner when ripgrep (rg) is not installed on the system.
+ */
+function safeNodeGrep(searchDir, pattern, isRegex, includeGlob, maxFiles = 20) {
+    const results = [];
+    let matcher;
+    if (isRegex) {
+        try {
+            const re = new RegExp(pattern);
+            matcher = (l) => re.test(l);
+        }
+        catch {
+            return [];
+        }
+    }
+    else {
+        matcher = (l) => l.includes(pattern);
+    }
+    // Simple extension or filename filter
+    const filterExt = includeGlob?.startsWith('*.') ? includeGlob.slice(1).toLowerCase() : null;
+    function walk(currentDir) {
+        if (results.length >= maxFiles)
+            return;
+        let entries = [];
+        try {
+            entries = fs.readdirSync(currentDir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (results.length >= maxFiles)
+                break;
+            const fullPath = path.join(currentDir, entry.name);
+            if (entry.isDirectory()) {
+                if (!IGNORED_DIRS.has(entry.name) && !entry.name.startsWith('.')) {
+                    walk(fullPath);
+                }
+            }
+            else if (entry.isFile()) {
+                if (filterExt && !entry.name.toLowerCase().endsWith(filterExt)) {
+                    continue;
+                }
+                try {
+                    const content = fs.readFileSync(fullPath, 'utf-8');
+                    const lines = content.split('\n');
+                    const matchingLines = [];
+                    for (let i = 0; i < lines.length; i++) {
+                        if (matcher(lines[i])) {
+                            const start = Math.max(0, i - 1);
+                            const end = Math.min(lines.length - 1, i + 1);
+                            for (let c = start; c <= end; c++) {
+                                matchingLines.push(`${c + 1}:${lines[c]}`);
+                            }
+                            if (matchingLines.length >= 10)
+                                break;
+                        }
+                    }
+                    if (matchingLines.length > 0) {
+                        results.push({ filePath: fullPath, matches: matchingLines });
+                    }
+                }
+                catch {
+                    // ignore binary or unreadable files
+                }
+            }
+        }
+    }
+    walk(searchDir);
+    return results;
+}
+// ─── Server Setup ─────────────────────────────────────────────────────────────
+const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION });
+// ─── MCP Resources (Static/Live System Inspection) ───────────────────────────
+server.registerResource('config', 'contextguard://config', {
+    title: 'ContextGuard Active Configuration',
+    description: 'Current thresholds, active worker provider, and buffer safety settings in effect.',
+    mimeType: 'application/json'
+}, async (uri) => {
+    return {
+        contents: [{
+                uri: uri.href,
+                text: JSON.stringify({
+                    version: SERVER_VERSION,
+                    maxLinesThreshold: CONFIG.maxLines,
+                    maxBytesThreshold: CONFIG.maxBytes,
+                    workerProvider: CONFIG.provider,
+                    supportedSfcFrameworks: ['svelte', 'vue', 'angular', 'astro'],
+                    nativeMediaBypass: Array.from(NATIVE_MEDIA_EXTS)
+                }, null, 2),
+                mimeType: 'application/json'
+            }]
+    };
+});
+// ─── MCP Prompts (Optimized System Prompt Templates) ─────────────────────────
+server.registerPrompt('investigate_codebase_safely', {
+    title: 'Investigate Codebase Safely',
+    description: 'Standard system instruction guiding the AI agent to avoid full-file dumps by prioritizing inspect_outline and targeted read_file_safe ranges.'
+}, async () => {
+    return {
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: [
+                        'Follow ContextGuard FinOps & token preservation rules:',
+                        '1. Do not perform unrestricted open reads of files over 300 lines.',
+                        '2. Call "inspect_outline" first to discover method and type signatures with their exact line tags [L#].',
+                        '3. Read only targeted slices with "read_file_safe(file_path, start_line, end_line)".',
+                        '4. When searching for symbols, use "grep_distilled" to examine matching signatures instead of dumping entire source files.'
+                    ].join('\n')
+                }
+            }]
+    };
+});
+// ─── 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.',
+        'Uses ripgrep if available, with an automatic fallback to pure Node.js scanning.',
+        '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
+            };
+        }
+        let matchingEntries = [];
+        // 1. Attempt ripgrep using safe spawnSync (no shell injection)
+        const rgArgs = [
+            '--line-number',
+            '--with-filename',
+            '--no-heading',
+            '--color=never',
+            '--max-count=5',
+            '-l'
+        ];
+        if (!is_regex)
+            rgArgs.push('--fixed-strings');
+        if (include)
+            rgArgs.push('--glob', include);
+        rgArgs.push('--', pattern, searchDir);
+        const rgResult = spawnSync('rg', rgArgs, { encoding: 'utf-8', maxBuffer: 1024 * 512 });
+        if (rgResult.error && rgResult.error.code === 'ENOENT') {
+            // ripgrep is not installed — use pure Node.js fallback!
+            const nodeMatches = safeNodeGrep(searchDir, pattern, !!is_regex, include, 20);
+            matchingEntries = nodeMatches.map(m => ({
+                filePath: m.filePath,
+                matchLines: m.matches.slice(0, 5).join('\n')
+            }));
+        }
+        else if (rgResult.status === 0 && rgResult.stdout) {
+            const filePaths = rgResult.stdout.trim().split('\n').filter(Boolean).slice(0, 20);
+            for (const fp of filePaths) {
+                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, fp);
+                const matchRes = spawnSync('rg', matchArgs, { encoding: 'utf-8', maxBuffer: 1024 * 64 });
+                matchingEntries.push({
+                    filePath: fp,
+                    matchLines: (matchRes.stdout || '').trim() || '(matches found)'
+                });
+            }
+        }
+        else if (rgResult.status === 1) {
+            // No matches found by ripgrep
+            return {
+                content: [{ type: 'text', text: `ℹ️ [CONTEXTGUARD GREP] No matches for "${pattern}" in ${searchDir}` }]
+            };
+        }
+        if (matchingEntries.length === 0) {
+            return {
+                content: [{ type: 'text', text: `ℹ️ [CONTEXTGUARD GREP] No matches for "${pattern}" in ${searchDir}` }]
+            };
+        }
+        // Format results with outlines
+        const results = [
+            `<!-- [CONTEXTGUARD GREP] Pattern: "${pattern}" | ${matchingEntries.length} matching files -->`,
+            ''
+        ];
+        for (const entry of matchingEntries) {
+            const ext = path.extname(entry.filePath);
+            const relPath = path.relative(process.cwd(), entry.filePath);
+            let skeleton = null;
+            let totalLines = 0;
+            let sizeBytes = 0;
+            try {
+                const raw = fs.readFileSync(entry.filePath, 'utf-8');
+                skeleton = extractCodeSkeleton(raw, ext);
+                totalLines = raw.split('\n').length;
+                sizeBytes = fs.statSync(entry.filePath).size;
+            }
+            catch { }
+            results.push(`### ${relPath} (${totalLines} lines, ${(sizeBytes / 1024).toFixed(1)} KB)`);
+            results.push('**Matches:**');
+            results.push('```');
+            results.push(entry.matchLines);
+            results.push('```');
+            if (skeleton) {
+                results.push('**Structural outline:**');
+                results.push('```');
+                results.push(skeleton);
+                results.push('```');
+            }
+            results.push('');
+        }
+        if (matchingEntries.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":"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"}

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,248 @@
+/**
+ * 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 onError = (err) => {
+            cleanup();
+            reject(err);
+        };
+        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) {
+                        cleanup();
+                        resolve(parsed);
+                        return;
+                    }
+                }
+                catch {
+                    // partial or unrelated line — continue
+                }
+            }
+            buffer = lines[lines.length - 1] ?? '';
+        };
+        const cleanup = () => {
+            proc.stdout.removeListener('data', onData);
+            proc.removeListener('error', onError);
+        };
+        proc.stdout.on('data', onData);
+        proc.on('error', onError);
+        proc.stdin.write(JSON.stringify(request) + '\n');
+        setTimeout(() => {
+            cleanup();
+            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 });
+    });
+    it('grep_distilled: should find matches and extract structural outline via ripgrep or node fallback', async () => {
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-mcp-'));
+        const testFile = path.join(tmpDir, 'controller.ts');
+        fs.writeFileSync(testFile, [
+            'export class UserController {',
+            '  async findUserById(id: string) {',
+            '    const targetId = id;',
+            '    return targetId;',
+            '  }',
+            '}'
+        ].join('\n'));
+        const res = await sendRequest(proc, req('tools/call', {
+            name: 'grep_distilled',
+            arguments: { pattern: 'targetId', 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('controller.ts'), 'Must find controller.ts file');
+        assert.ok(text.includes('targetId'), 'Must contain match line');
+        fs.rmSync(tmpDir, { recursive: true });
+    });
+    // ── Resources & Prompts (MCP Best Practices) ────────────────────────────────
+    it('resources: should list contextguard://config and read active configuration', async () => {
+        const listRes = await sendRequest(proc, req('resources/list'));
+        assert.ok(!listRes.error, `Unexpected error: ${JSON.stringify(listRes.error)}`);
+        const listResult = listRes.result;
+        assert.ok(listResult.resources.some((r) => r.uri === 'contextguard://config'), 'Must list config resource');
+        const readRes = await sendRequest(proc, req('resources/read', { uri: 'contextguard://config' }));
+        assert.ok(!readRes.error, `Unexpected error: ${JSON.stringify(readRes.error)}`);
+        const readResult = readRes.result;
+        assert.ok(readResult.contents[0].text.includes('maxLinesThreshold'), 'Must return valid config JSON');
+    });
+    it('prompts: should list investigate_codebase_safely prompt', async () => {
+        const res = await sendRequest(proc, req('prompts/list'));
+        assert.ok(!res.error, `Unexpected error: ${JSON.stringify(res.error)}`);
+        const result = res.result;
+        assert.ok(result.prompts.some((p) => p.name === 'investigate_codebase_safely'), 'Must expose prompt template');
+    });
+});
+//# 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,13 @@
+{
+  "mcpServers": {
+    "context-guard": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "-p",
+        "@kevinbermudezc/context-guard@latest",
+        "context-guard-mcp"
+      ]
+    }
+  }
+}

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

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

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

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "context-guard": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "-p",
+        "@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.1",
+  "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"