@kevinbermudezc/context-guard 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kevin Bermudez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,159 @@
+# 🛡️ ContextGuard
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Node: >=18](https://img.shields.io/badge/Node->=18.0.0-green.svg)](https://nodejs.org/)
+[![pnpm: >=10](https://img.shields.io/badge/pnpm->=10.0.0-F69220.svg?logo=pnpm&logoColor=white)](https://pnpm.io/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-7.0%20(Go%20Native)-blue.svg)](https://www.typescriptlang.org/)
+[![Go Engine](https://img.shields.io/badge/Compiler-Go%20Native%20(Corsa)-00ADD8.svg)](https://golang.org/)
+
+> **Intelligent context admission control & token optimization for Claude Code, Cursor, and Agentic AI workflows.**
+
+Stop burning expensive tokens and degrading reasoning accuracy. `ContextGuard` intercepts un-scoped, large file reads before they enter your frontier reasoning models (Claude Opus 5, Claude Sonnet 5, GPT-6 Astra), extracting structural signatures or delegating summarization to ultra-fast worker models (Gemini 3.8 Flash, local SLMs).
+
+---
+
+## ⚡ High-Performance Go Native Compiler (TypeScript 7.0)
+
+ContextGuard is built on **TypeScript 7.0**, utilizing the native **Go-based compiler engine** (*Corsa*):
+* **10x Faster Compilation:** Type-checking and build steps run directly on native machine code compiled in Go, taking full advantage of Apple Silicon / ARM64 and multi-threaded Goroutines.
+* **Sub-Millisecond Cold Starts:** Pure ESM standard library design with zero production runtime dependencies ensures the Claude Code `PreToolUse` hook executes in under **15ms**.
+
+---
+
+## 💡 The Problem
+
+Frontier models are incredible at reasoning, but reading massive files (1,000+ lines of monorepo code, generated types, or verbose logs) introduces two major problems:
+
+1. **FinOps Bleed:** Frontier models cost between \$3.00 and \$15.00+ per million input tokens. Dumping a few 2,000-line files into a session quickly adds up to dozens of dollars per day per developer.
+2. **Context Rot & "Lost in the Middle":** Saturating attention heads with hundreds of lines of boilerplate degrades precision, increases hallucination rates, and derails agentic reasoning loops.
+
+---
+
+## 🏗️ How ContextGuard Works
+
+ContextGuard acts as an **admission turnstile** using Claude Code's native `PreToolUse` hook lifecycle:
+
+```
+                      CLAUDE CODE TOOL INVOCATION
+                                    │
+                                    ▼
+                 Does the file exceed the limit (e.g. 300 lines)
+                     AND is it an un-scoped full read?
+                                    │
+                       ┌────────────┴────────────┐
+                      YES                        NO
+                       │                         │
+                       ▼                         ▼
+         ┌───────────────────────────┐      [ALLOW: Exit 0]
+         │    CONTEXTGUARD TRIGGER   │   File is small or
+         └─────────────┬─────────────┘   targeted slice requested
+                       │
+          ┌────────────┴────────────┐
+          ▼                         ▼
+    [Tier 0: Local AST]       [Tier 1: Worker Model]
+    TypeScript, Python, Go,   Logs, JSON, Markdown or
+    Rust, Java, C#            semantic question queries
+    • Cost: $0.00             • Gemini Flash / Ollama
+    • Latency: < 5ms          • Cost: ~95% cheaper
+          │                         │
+          └────────────┬────────────┘
+                       │
+                       ▼
+          [HARD BLOCK: Exit 2]
+     Emits signature skeleton with [L120] line tags to stderr
+                       │
+                       ▼
+     Claude receives system feedback & requests
+     the exact slice needed (e.g. offset=130, limit=40)
+```
+
+---
+
+## 🚀 Quick Start for Claude Code
+
+### 1. Installation
+
+Clone or install in your workspace:
+
+```bash
+pnpm add -D @kevinbermudezc/context-guard
+# Or global install:
+pnpm add -g @kevinbermudezc/context-guard
+```
+
+### 2. Configure Claude Code Hook
+
+Add ContextGuard to your `.claude/settings.json` (at project root or `~/.claude/settings.json` globally):
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "View|Bash",
+        "type": "command",
+        "command": "node ./node_modules/@kevinbermudezc/context-guard/dist/bin/claude-hook.js"
+      }
+    ]
+  }
+}
+```
+
+That's it! When Claude Code attempts to run `View` or bash commands like `cat massive-file.ts`, ContextGuard will intercept it, extract the structural map, and instruct Claude to seek only the exact line range it needs.
+
+---
+
+## 🛠️ CLI Usage
+
+You can also use ContextGuard directly as a command-line tool:
+
+```bash
+# View file through ContextGuard (auto-shunts if > 300 lines)
+npx @kevinbermudezc/context-guard src/large-service.ts
+
+# Ask a semantic question to the worker model
+npx @kevinbermudezc/context-guard logs/server.log --query "Find all 500 status database connection timeouts"
+
+# Specific line range (bypasses guard / passthrough)
+npx @kevinbermudezc/context-guard src/large-service.ts --start 120 --end 160
+
+# Output structured JSON
+npx @kevinbermudezc/context-guard src/large-service.ts --json
+```
+
+---
+
+## ⚙️ Configuration
+
+Customize thresholds and worker models via environment variables:
+
+| Variable | Default | Description |
+| :--- | :--- | :--- |
+| `CONTEXT_GUARD_MAX_LINES` | `300` | Maximum lines allowed for un-scoped direct reads |
+| `CONTEXT_GUARD_MAX_BYTES` | `25600` | Maximum file size in bytes (~25 KB) |
+| `CONTEXT_GUARD_PROVIDER` | `skeleton` | Worker mode: `skeleton` (Tier 0 AST), `gemini`, `ollama`, or `openai` |
+| `GEMINI_API_KEY` | - | API key for Gemini 2.5 Flash worker |
+| `GEMINI_MODEL` | `gemini-3.8-flash` | Gemini model name |
+| `OLLAMA_BASE_URL` | `http://localhost:11434` | Ollama local endpoint |
+| `OLLAMA_MODEL` | `qwen2.5-coder:7b` | Model to use in Ollama |
+
+---
+
+## 🧪 Development & Testing
+ 
+```bash
+# Install dependencies with strict symlink resolution
+pnpm install
+
+# Compile TypeScript using Go-powered tsc engine
+pnpm run build
+
+# Run unit and end-to-end tests
+pnpm test
+```
+
+---
+
+## 📄 License
+
+MIT © [Kevin Bermudez](https://github.com/kevinbermudezc)

package/dist/bin/claude-hook.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * ============================================================================
+ * ContextGuard PreToolUse Hook for Claude Code
+ * Intercepts un-scoped large file reads and prevents context saturation.
+ * Returns Exit Code 2 (Hard Block) with structured signatures to stderr.
+ * ============================================================================
+ */
+export {};
+//# sourceMappingURL=claude-hook.d.ts.map

package/dist/bin/claude-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-hook.d.ts","sourceRoot":"","sources":["../../bin/claude-hook.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG"}

package/dist/bin/claude-hook.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+/**
+ * ============================================================================
+ * ContextGuard PreToolUse Hook for Claude Code
+ * Intercepts un-scoped large file reads and prevents context saturation.
+ * Returns Exit Code 2 (Hard Block) with structured signatures to stderr.
+ * ============================================================================
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { CONFIG } from '../src/config.js';
+import { extractCodeSkeleton } from '../src/skeletonizer.js';
+async function runHook() {
+    const inputChunks = [];
+    for await (const chunk of process.stdin) {
+        inputChunks.push(chunk);
+    }
+    if (inputChunks.length === 0) {
+        process.exit(0);
+    }
+    let payload;
+    try {
+        payload = JSON.parse(Buffer.concat(inputChunks).toString('utf-8'));
+    }
+    catch {
+        process.exit(0); // If stdin is not valid JSON, allow
+    }
+    const toolName = payload.tool_name || payload.name;
+    const toolInput = payload.tool_input || payload.input || {};
+    let targetFilePath = null;
+    let isScoped = false;
+    // 1. Intercept "View" or "view_file" tools
+    if (toolName === 'View' || toolName === 'view_file') {
+        targetFilePath = toolInput.file_path || toolInput.path || toolInput.AbsolutePath || null;
+        // Check if Claude specified line bounds
+        if (toolInput.offset !== undefined ||
+            toolInput.limit !== undefined ||
+            toolInput.StartLine !== undefined ||
+            toolInput.EndLine !== undefined) {
+            isScoped = true;
+        }
+    }
+    // 2. Intercept Bash commands doing open reads (cat, less, more, head)
+    if (toolName === 'Bash' || toolName === 'bash') {
+        const cmd = (toolInput.command || '').trim();
+        // Allow piped/filtered commands (e.g. cat file | grep foo, or head -n 20)
+        if (cmd.includes('|') || cmd.includes('>') || cmd.startsWith('head -n') || cmd.startsWith('tail -n')) {
+            process.exit(0);
+        }
+        const catMatch = cmd.match(/^(?:cat|less|more)\s+(["']?)([^"'\s]+)\1$/);
+        if (catMatch) {
+            targetFilePath = catMatch[2];
+        }
+    }
+    // If not a reading tool or already scoped, allow execution immediately
+    if (!targetFilePath || isScoped) {
+        process.exit(0); // Exit 0 = ALLOW
+    }
+    const resolvedPath = path.resolve(process.cwd(), targetFilePath);
+    if (!fs.existsSync(resolvedPath) || fs.statSync(resolvedPath).isDirectory()) {
+        process.exit(0);
+    }
+    const stat = fs.statSync(resolvedPath);
+    const rawContent = fs.readFileSync(resolvedPath, 'utf-8');
+    const lines = rawContent.split('\n');
+    const totalLines = lines.length;
+    const ext = path.extname(resolvedPath);
+    // If within safety thresholds, allow direct read
+    if (totalLines <= CONFIG.maxLines && stat.size <= CONFIG.maxBytes) {
+        process.exit(0); // Exit 0 = ALLOW
+    }
+    // ========================================================================
+    // APPLY CONTEXTGUARD SHUNT (BLOCK AND EMIT SKELETON)
+    // ========================================================================
+    const skeleton = extractCodeSkeleton(rawContent, ext);
+    const preview = skeleton || lines.slice(0, 40).join('\n') + `\n... [${totalLines - 40} lines truncated by ContextGuard]`;
+    const feedbackMessage = [
+        `🛡️ [CONTEXTGUARD: LECTURA REGULADA - PREVENCIÓN DE SATURACIÓN DE TOKENS]`,
+        `El recurso "${path.basename(resolvedPath)}" contiene ${totalLines} líneas (~${(stat.size / 1024).toFixed(1)} KB).`,
+        `Para optimizar tu contexto y prevenir degradación de razonamiento, no se ha cargado el archivo completo en la ventana principal.`,
+        ``,
+        `📋 ESQUELETO ESTRUCTURAL Y FIRMAS (Con índices de línea):`,
+        `--------------------------------------------------------------------------------`,
+        preview,
+        `--------------------------------------------------------------------------------`,
+        ``,
+        `🎯 ACCIÓN RECOMENDADA:`,
+        `Revisa las firmas anteriores y ejecuta la herramienta "View" especificando los parámetros "offset" y "limit" (o StartLine y EndLine) para inspeccionar únicamente la sección necesaria.`
+    ].join('\n');
+    // Emit to stderr and exit with code 2 to trigger a controlled block with system feedback in Claude Code
+    process.stderr.write(feedbackMessage + '\n');
+    process.exit(2);
+}
+runHook().catch(() => process.exit(0));
+//# sourceMappingURL=claude-hook.js.map

package/dist/bin/claude-hook.js.map

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

package/dist/bin/context-guard.d.ts

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

package/dist/bin/context-guard.d.ts.map

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

package/dist/bin/context-guard.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+import path from 'node:path';
+import { processWithContextGuard } from '../src/index.js';
+async function runCli() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+        console.log(`
+ContextGuard CLI v1.0.0
+Intelligent context admission control & token optimization
+
+Usage:
+  context-guard <file-path> [options]
+
+Options:
+  --query, -q <text>      Semantic search / intent filter for worker model
+  --start <num>           Start line number (1-indexed slice passthrough)
+  --end <num>             End line number (1-indexed slice passthrough)
+  --force-worker          Force routing through worker model
+  --json                  Output result in JSON format
+  --help, -h              Show this help menu
+    `);
+        process.exit(0);
+    }
+    const filePath = path.resolve(args[0]);
+    let query = '';
+    let startLine;
+    let endLine;
+    let forceWorker = false;
+    let outputJson = false;
+    for (let i = 1; i < args.length; i++) {
+        if (args[i] === '--query' || args[i] === '-q')
+            query = args[++i];
+        if (args[i] === '--start')
+            startLine = parseInt(args[++i], 10);
+        if (args[i] === '--end')
+            endLine = parseInt(args[++i], 10);
+        if (args[i] === '--force-worker')
+            forceWorker = true;
+        if (args[i] === '--json')
+            outputJson = true;
+    }
+    const result = await processWithContextGuard({
+        filePath,
+        query,
+        startLine,
+        endLine,
+        forceWorker
+    });
+    if (outputJson) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        if (result.error) {
+            console.error(`[Error] ${result.error}`);
+            process.exit(1);
+        }
+        console.log(result.content);
+    }
+}
+runCli().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=context-guard.js.map

package/dist/bin/context-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-guard.js","sourceRoot":"","sources":["../../bin/context-guard.ts"],"names":[],"mappings":";AAEA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,KAAK,UAAU,MAAM;IACnB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;KAcX,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,SAA6B,CAAC;IAClC,IAAI,OAA2B,CAAC;IAChC,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACjE,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;YAAE,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO;YAAE,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,gBAAgB;YAAE,WAAW,GAAG,IAAI,CAAC;QACrD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ;YAAE,UAAU,GAAG,IAAI,CAAC;IAC9C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC;QAC3C,QAAQ;QACR,KAAK;QACL,SAAS;QACT,OAAO;QACP,WAAW;KACZ,CAAC,CAAC;IAEH,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;SAAM,CAAC;QACN,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,WAAW,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/src/config.d.ts

@@ -0,0 +1,3 @@
+import type { ContextGuardConfig } from './types.js';
+export declare const CONFIG: ContextGuardConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAkB,MAAM,YAAY,CAAC;AAErE,eAAO,MAAM,MAAM,EAAE,kBAiBpB,CAAC"}

package/dist/src/config.js

@@ -0,0 +1,16 @@
+export const CONFIG = {
+    maxLines: parseInt(process.env.CONTEXT_GUARD_MAX_LINES || '300', 10),
+    maxBytes: parseInt(process.env.CONTEXT_GUARD_MAX_BYTES || `${25 * 1024}`, 10), // 25 KB
+    provider: (process.env.CONTEXT_GUARD_PROVIDER || 'gemini'),
+    // Gemini Configuration
+    geminiApiKey: process.env.GEMINI_API_KEY || '',
+    geminiModel: process.env.GEMINI_MODEL || 'gemini-3.8-flash',
+    // Ollama Configuration
+    ollamaUrl: process.env.OLLAMA_BASE_URL || 'http://localhost:11434',
+    ollamaModel: process.env.OLLAMA_MODEL || 'qwen2.5-coder:7b',
+    // OpenAI-compatible Configuration
+    openaiBaseUrl: process.env.OPENAI_BASE_URL || '',
+    openaiApiKey: process.env.OPENAI_API_KEY || '',
+    openaiModel: process.env.OPENAI_MODEL || 'gpt-5.6-luna'
+};
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,MAAM,GAAuB;IACxC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,KAAK,EAAE,EAAE,CAAC;IACpE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,QAAQ;IACvF,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,QAAQ,CAAmB;IAE5E,uBAAuB;IACvB,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE;IAC9C,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,kBAAkB;IAE3D,uBAAuB;IACvB,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,wBAAwB;IAClE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,kBAAkB;IAE3D,kCAAkC;IAClC,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE;IAChD,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE;IAC9C,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,cAAc;CACxD,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,11 @@
+import type { ProcessFileOptions, ProcessFileResult } from './types.js';
+export * from './types.js';
+export * from './config.js';
+export * from './skeletonizer.js';
+export * from './worker-model.js';
+/**
+ * Main engine of ContextGuard
+ * Evaluates file size and either passes it through or shunts it to an AST/Worker summary.
+ */
+export declare function processWithContextGuard(options: ProcessFileOptions): Promise<ProcessFileResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAExE,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAElC;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoGrG"}

package/dist/src/index.js

@@ -0,0 +1,108 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { CONFIG } from './config.js';
+import { extractCodeSkeleton } from './skeletonizer.js';
+import { callWorkerModel } from './worker-model.js';
+export * from './types.js';
+export * from './config.js';
+export * from './skeletonizer.js';
+export * from './worker-model.js';
+/**
+ * Main engine of ContextGuard
+ * Evaluates file size and either passes it through or shunts it to an AST/Worker summary.
+ */
+export async function processWithContextGuard(options) {
+    const { filePath, query = '', startLine, endLine, forceWorker = false } = options;
+    const resolved = path.resolve(process.cwd(), filePath);
+    if (!fs.existsSync(resolved) || fs.statSync(resolved).isDirectory()) {
+        return {
+            status: 'ERROR',
+            error: `File not found or is a directory: ${filePath}`,
+            content: ''
+        };
+    }
+    const stat = fs.statSync(resolved);
+    const rawContent = fs.readFileSync(resolved, 'utf-8');
+    const lines = rawContent.split('\n');
+    const totalLines = lines.length;
+    const ext = path.extname(resolved).toLowerCase();
+    // 1. Scoped line requests bypass ContextGuard (Passthrough)
+    if (startLine !== undefined || endLine !== undefined) {
+        const s = Math.max(1, startLine || 1) - 1;
+        const e = Math.min(totalLines, endLine || totalLines);
+        const sliced = lines.slice(s, e).join('\n');
+        return {
+            status: 'PASSTHROUGH_SLICE',
+            reason: `Scoped slice requested (lines ${s + 1} to ${e})`,
+            content: sliced,
+            totalLines,
+            sizeBytes: stat.size
+        };
+    }
+    // 2. Small files pass through directly
+    const isSmall = totalLines <= CONFIG.maxLines && stat.size <= CONFIG.maxBytes;
+    if (isSmall && !forceWorker) {
+        return {
+            status: 'PASSTHROUGH_FULL',
+            reason: `File within limits (${totalLines} lines, ${(stat.size / 1024).toFixed(1)} KB)`,
+            content: rawContent,
+            totalLines,
+            sizeBytes: stat.size
+        };
+    }
+    // 3. Shunt Tier 0: Structural AST / Skeleton (0 tokens, < 5ms)
+    if (!query && !forceWorker && CONFIG.provider !== 'gemini' && CONFIG.provider !== 'ollama' && CONFIG.provider !== 'openai') {
+        const skeleton = extractCodeSkeleton(rawContent, ext);
+        if (skeleton) {
+            return {
+                status: 'SHUNTED_LOCAL_AST',
+                totalLines,
+                sizeBytes: stat.size,
+                content: `<!-- CONTEXTGUARD: Large file (${totalLines} lines, ${(stat.size / 1024).toFixed(1)} KB). Extracted structural skeleton. -->\n` +
+                    `<!-- Request specific line ranges (e.g. L120-L150) to inspect implementation. -->\n\n` +
+                    skeleton
+            };
+        }
+    }
+    // 4. Shunt Tier 0 Fallback to AST if provider fails or if local AST requested
+    const localSkeleton = extractCodeSkeleton(rawContent, ext);
+    if (!query && localSkeleton && CONFIG.provider === 'skeleton') {
+        return {
+            status: 'SHUNTED_LOCAL_AST',
+            totalLines,
+            sizeBytes: stat.size,
+            content: `<!-- CONTEXTGUARD: Structural skeleton (Tier 0 AST) -->\n\n` + localSkeleton
+        };
+    }
+    // 5. Shunt Tier 1: Worker Model
+    try {
+        const summary = await callWorkerModel(rawContent, query, ext);
+        return {
+            status: 'SHUNTED_WORKER_MODEL',
+            provider: CONFIG.provider,
+            totalLines,
+            sizeBytes: stat.size,
+            content: `<!-- CONTEXTGUARD: File of ${totalLines} lines summarized by Worker Model (${CONFIG.provider}) -->\n` +
+                `<!-- Request specific line ranges using offset/limit to read full blocks. -->\n\n` +
+                summary
+        };
+    }
+    catch (err) {
+        // If worker model fails, fallback to local skeleton or first 50 lines
+        if (localSkeleton) {
+            return {
+                status: 'SHUNTED_LOCAL_AST',
+                warning: `Worker failed (${err.message}). Fell back to local AST skeleton.`,
+                totalLines,
+                sizeBytes: stat.size,
+                content: localSkeleton
+            };
+        }
+        return {
+            status: 'SHUNT_FALLBACK',
+            warning: `Worker failed: ${err.message}. Showing head of file.`,
+            content: lines.slice(0, 50).join('\n') + `\n\n... [${totalLines - 50} lines truncated by ContextGuard] ...`
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

package/dist/src/skeletonizer.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tier 0 Structural Skeletonizer
+ * Extracts structural declarations, signatures, imports, and types with line numbers.
+ * Cost: $0.00 | Execution: < 5ms
+ */
+export declare function isSupportedExtension(ext: string): string | null;
+export declare function extractCodeSkeleton(content: string, ext: string): string | null;
+//# sourceMappingURL=skeletonizer.d.ts.map

package/dist/src/skeletonizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeletonizer.d.ts","sourceRoot":"","sources":["../../src/skeletonizer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiCH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU/D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiC/E"}

package/dist/src/skeletonizer.js

@@ -0,0 +1,76 @@
+/**
+ * Tier 0 Structural Skeletonizer
+ * Extracts structural declarations, signatures, imports, and types with line numbers.
+ * Cost: $0.00 | Execution: < 5ms
+ */
+const LANGUAGE_PATTERNS = {
+    // TypeScript & JavaScript
+    ts: [
+        /^(export\s+)?(default\s+)?(class|interface|type|enum)\s+([A-Za-z0-9_]+)/,
+        /^(export\s+)?(async\s+)?function\s+([A-Za-z0-9_]+)\s*\(/,
+        /^(export\s+)?const\s+([A-Za-z0-9_]+)\s*=\s*(async\s*)?\(/,
+        /^(export\s+)?((public|private|protected|static|async|\*)\s+)*([A-Za-z0-9_]+)\s*\([^)]*\)\s*[:{]/
+    ],
+    // Python
+    py: [
+        /^(async\s+)?def\s+([A-Za-z0-9_]+)\s*\(/,
+        /^class\s+([A-Za-z0-9_]+)(\s*\([^)]*\))?:/
+    ],
+    // Go
+    go: [
+        /^func\s+(\([^)]+\)\s+)?([A-Za-z0-9_]+)\s*\(/,
+        /^type\s+([A-Za-z0-9_]+)\s+(struct|interface)/
+    ],
+    // Rust
+    rs: [
+        /^(pub\s+)?(async\s+)?fn\s+([A-Za-z0-9_]+)/,
+        /^(pub\s+)?(struct|enum|trait|type)\s+([A-Za-z0-9_]+)/,
+        /^impl(\s+<[^>]+>)?\s+([A-Za-z0-9_]+)/
+    ],
+    // Java / C#
+    java: [
+        /^(public|private|protected|static|final|native|synchronized|abstract|\s+)+[\w\<\>\[\]]+\s+([A-Za-z0-9_]+)\s*\([^\)]*\)\s*(\{)?/,
+        /^(public|private|protected|static|abstract|\s+)+(class|interface|enum|record)\s+([A-Za-z0-9_]+)/
+    ]
+};
+export function isSupportedExtension(ext) {
+    const normalized = ext.toLowerCase().replace(/^\./, '');
+    const mapping = {
+        ts: 'ts', tsx: 'ts', js: 'ts', jsx: 'ts', mjs: 'ts', cjs: 'ts',
+        py: 'py',
+        go: 'go',
+        rs: 'rs',
+        java: 'java', cs: 'java'
+    };
+    return mapping[normalized] || null;
+}
+export function extractCodeSkeleton(content, ext) {
+    const langKey = isSupportedExtension(ext);
+    if (!langKey)
+        return null;
+    const patterns = LANGUAGE_PATTERNS[langKey] || [];
+    const lines = content.split('\n');
+    const skeleton = [];
+    lines.forEach((line, index) => {
+        const lineNum = index + 1;
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('//') || trimmed.startsWith('#') || trimmed.startsWith('/*')) {
+            return;
+        }
+        // Keep top-level import/from statements
+        if (trimmed.startsWith('import ') || trimmed.startsWith('from ') || (langKey === 'go' && trimmed.startsWith('import ('))) {
+            skeleton.push(`[L${lineNum}] ${trimmed}`);
+            return;
+        }
+        for (const pattern of patterns) {
+            if (pattern.test(trimmed)) {
+                // Strip trailing curly braces or semicolons for brevity
+                const clean = trimmed.replace(/\{\s*$/, '').trim();
+                skeleton.push(`[L${lineNum}] ${clean}`);
+                break;
+            }
+        }
+    });
+    return skeleton.length > 0 ? skeleton.join('\n') : null;
+}
+//# sourceMappingURL=skeletonizer.js.map

package/dist/src/skeletonizer.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,49 @@
+export type WorkerProvider = 'gemini' | 'ollama' | 'openai' | 'skeleton';
+export interface ContextGuardConfig {
+    maxLines: number;
+    maxBytes: number;
+    provider: WorkerProvider;
+    geminiApiKey?: string;
+    geminiModel?: string;
+    ollamaUrl?: string;
+    ollamaModel?: string;
+    openaiBaseUrl?: string;
+    openaiApiKey?: string;
+    openaiModel?: string;
+}
+export interface ProcessFileOptions {
+    filePath: string;
+    query?: string;
+    startLine?: number;
+    endLine?: number;
+    forceWorker?: boolean;
+}
+export type ProcessFileStatus = 'PASSTHROUGH_FULL' | 'PASSTHROUGH_SLICE' | 'SHUNTED_LOCAL_AST' | 'SHUNTED_WORKER_MODEL' | 'SHUNT_FALLBACK' | 'ERROR';
+export interface ProcessFileResult {
+    status: ProcessFileStatus;
+    content: string;
+    totalLines?: number;
+    sizeBytes?: number;
+    reason?: string;
+    provider?: string;
+    warning?: string;
+    error?: string;
+}
+export interface ClaudeToolInput {
+    file_path?: string;
+    path?: string;
+    AbsolutePath?: string;
+    offset?: number;
+    limit?: number;
+    StartLine?: number;
+    EndLine?: number;
+    command?: string;
+    [key: string]: unknown;
+}
+export interface ClaudeToolPayload {
+    tool_name?: string;
+    name?: string;
+    tool_input?: ClaudeToolInput;
+    input?: ClaudeToolInput;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,iBAAiB,GACzB,kBAAkB,GAClB,mBAAmB,GACnB,mBAAmB,GACnB,sBAAsB,GACtB,gBAAgB,GAChB,OAAO,CAAC;AAEZ,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB"}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/dist/src/worker-model.d.ts

@@ -0,0 +1,2 @@
+export declare function callWorkerModel(content: string, query?: string, ext?: string): Promise<string>;
+//# sourceMappingURL=worker-model.d.ts.map

package/dist/src/worker-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-model.d.ts","sourceRoot":"","sources":["../../src/worker-model.ts"],"names":[],"mappings":"AAEA,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,EAAE,GAAG,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAoF5G"}

package/dist/src/worker-model.js

@@ -0,0 +1,81 @@
+import { CONFIG } from './config.js';
+export async function callWorkerModel(content, query = '', ext = '') {
+    const systemPrompt = `Eres ContextGuard, un asistente de optimización de contexto y costes para IA.
+Tu misión es procesar un archivo grande y devolver ÚNICAMENTE una representación ultra compacta y precisa para el modelo principal.
+Reglas:
+1. Incluye las firmas de funciones y métodos, clases, tipos, interfaces y rutas expuestas.
+2. Anota los números de línea aproximados donde se ubica cada sección.
+3. Omite implementaciones internas, boilerplate, logs repetitivos o comentarios innecesarios.
+4. Si se proporcionó una intención/query, enfócate estrictamente en lo relevante para esa intención.
+5. Responde directamente con Markdown conciso, sin preámbulos ni saludos.`;
+    const userPrompt = query
+        ? `INTENCIÓN ESPECÍFICA: "${query}"\n\nCONTENIDO DEL ARCHIVO (${ext}):\n\`\`\`\n${content}\n\`\`\``
+        : `Genera un mapa de estructura y firmas con números de línea para este archivo (${ext}):\n\`\`\`\n${content}\n\`\`\``;
+    // 1. Proveedor Gemini Flash
+    if (CONFIG.provider === 'gemini') {
+        if (!CONFIG.geminiApiKey) {
+            throw new Error('GEMINI_API_KEY no configurada. Define la variable de entorno o usa CONFIG_GUARD_PROVIDER=skeleton.');
+        }
+        const url = `https://generativelanguage.googleapis.com/v1beta/models/${CONFIG.geminiModel}:generateContent?key=${CONFIG.geminiApiKey}`;
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                contents: [{ role: 'user', parts: [{ text: `${systemPrompt}\n\n${userPrompt}` }] }],
+                generationConfig: { temperature: 0.1, maxOutputTokens: 1500 }
+            })
+        });
+        if (!res.ok) {
+            const err = await res.text();
+            throw new Error(`Error en Gemini Flash API: ${res.status} - ${err}`);
+        }
+        const data = await res.json();
+        return data.candidates?.[0]?.content?.parts?.[0]?.text || 'No se pudo generar el resumen.';
+    }
+    // 2. Proveedor Ollama Local (0 costo / offline)
+    if (CONFIG.provider === 'ollama') {
+        const res = await fetch(`${CONFIG.ollamaUrl}/api/generate`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                model: CONFIG.ollamaModel,
+                system: systemPrompt,
+                prompt: userPrompt,
+                stream: false
+            })
+        });
+        if (!res.ok) {
+            throw new Error(`Error conectando con Ollama en ${CONFIG.ollamaUrl}`);
+        }
+        const data = await res.json();
+        return data.response || 'No se pudo generar el resumen.';
+    }
+    // 3. Proveedor OpenAI / compatible
+    if (CONFIG.provider === 'openai') {
+        const baseUrl = CONFIG.openaiBaseUrl || 'https://api.openai.com/v1';
+        const res = await fetch(`${baseUrl}/chat/completions`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${CONFIG.openaiApiKey}`
+            },
+            body: JSON.stringify({
+                model: CONFIG.openaiModel,
+                messages: [
+                    { role: 'system', content: systemPrompt },
+                    { role: 'user', content: userPrompt }
+                ],
+                temperature: 0.1,
+                max_tokens: 1500
+            })
+        });
+        if (!res.ok) {
+            const err = await res.text();
+            throw new Error(`Error en API OpenAI/compatible: ${res.status} - ${err}`);
+        }
+        const data = await res.json();
+        return data.choices?.[0]?.message?.content || 'No se pudo generar el resumen.';
+    }
+    throw new Error(`Proveedor no soportado: ${CONFIG.provider}`);
+}
+//# sourceMappingURL=worker-model.js.map

package/dist/src/worker-model.js.map

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

package/dist/tests/claude-hook.test.d.ts

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

package/dist/tests/claude-hook.test.d.ts.map

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

package/dist/tests/claude-hook.test.js

@@ -0,0 +1,76 @@
+import { describe, it } 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';
+const HOOK_PATH = path.resolve(process.cwd(), 'dist/bin/claude-hook.js');
+function runHookWithStdin(payload) {
+    return new Promise((resolve) => {
+        const proc = spawn('node', [HOOK_PATH], {
+            env: { ...process.env, CONTEXT_GUARD_MAX_LINES: '100' }
+        });
+        let stdout = '';
+        let stderr = '';
+        proc.stdout.on('data', (chunk) => { stdout += chunk.toString(); });
+        proc.stderr.on('data', (chunk) => { stderr += chunk.toString(); });
+        proc.on('close', (code) => {
+            resolve({ exitCode: code ?? 0, stderr, stdout });
+        });
+        proc.stdin.write(JSON.stringify(payload));
+        proc.stdin.end();
+    });
+}
+describe('Claude Code Hook PreToolUse End-to-End', () => {
+    it('should block un-scoped View of a file over threshold with Exit Code 2', async () => {
+        const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-hook-'));
+        const tempFile = path.join(tempDir, 'huge.ts');
+        // Create 150 lines of code
+        const lines = ['export class OrderService {'];
+        for (let i = 0; i < 150; i++) {
+            lines.push(`  // dummy line ${i}`);
+        }
+        lines.push('  public pay() { return true; }');
+        lines.push('}');
+        fs.writeFileSync(tempFile, lines.join('\n'));
+        const res = await runHookWithStdin({
+            tool_name: 'View',
+            tool_input: { file_path: tempFile }
+        });
+        assert.strictEqual(res.exitCode, 2, 'Must exit with 2 to hard block Claude Code');
+        assert.ok(res.stderr.includes('CONTEXTGUARD: LECTURA REGULADA'), 'Must emit warning in stderr');
+        assert.ok(res.stderr.includes('OrderService'), 'Must include skeleton in stderr');
+        fs.rmSync(tempDir, { recursive: true });
+    });
+    it('should allow (exit 0) when View has offset and limit', async () => {
+        const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-hook-'));
+        const tempFile = path.join(tempDir, 'huge.ts');
+        fs.writeFileSync(tempFile, Array.from({ length: 200 }, () => 'code').join('\n'));
+        const res = await runHookWithStdin({
+            tool_name: 'View',
+            tool_input: {
+                file_path: tempFile,
+                offset: 10,
+                limit: 20
+            }
+        });
+        assert.strictEqual(res.exitCode, 0, 'Must exit with 0 to allow Claude Code execution');
+        assert.strictEqual(res.stderr, '');
+        fs.rmSync(tempDir, { recursive: true });
+    });
+    it('should block open cat commands on large files with Exit Code 2', async () => {
+        const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-hook-'));
+        const tempFile = path.join(tempDir, 'huge.ts');
+        fs.writeFileSync(tempFile, Array.from({ length: 200 }, () => 'code').join('\n'));
+        const res = await runHookWithStdin({
+            tool_name: 'Bash',
+            tool_input: {
+                command: `cat ${tempFile}`
+            }
+        });
+        assert.strictEqual(res.exitCode, 2, 'Must block raw cat with exit 2');
+        assert.ok(res.stderr.includes('CONTEXTGUARD'));
+        fs.rmSync(tempDir, { recursive: true });
+    });
+});
+//# sourceMappingURL=claude-hook.test.js.map

package/dist/tests/claude-hook.test.js.map

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

package/dist/tests/hook.test.d.ts

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

package/dist/tests/hook.test.d.ts.map

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

package/dist/tests/hook.test.js

@@ -0,0 +1,62 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { processWithContextGuard } from '../src/index.js';
+describe('ContextGuard Engine Core', () => {
+    it('should passthrough small files directly', async () => {
+        const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-test-'));
+        const tempFile = path.join(tempDir, 'small.ts');
+        fs.writeFileSync(tempFile, 'const x = 1;\nconsole.log(x);');
+        const result = await processWithContextGuard({
+            filePath: tempFile
+        });
+        assert.strictEqual(result.status, 'PASSTHROUGH_FULL');
+        assert.strictEqual(result.content, 'const x = 1;\nconsole.log(x);');
+        assert.strictEqual(result.totalLines, 2);
+        fs.rmSync(tempDir, { recursive: true });
+    });
+    it('should passthrough sliced ranges when startLine/endLine are requested', async () => {
+        const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-test-'));
+        const tempFile = path.join(tempDir, 'big.ts');
+        const content = Array.from({ length: 400 }, (_, i) => `line ${i + 1}`).join('\n');
+        fs.writeFileSync(tempFile, content);
+        const result = await processWithContextGuard({
+            filePath: tempFile,
+            startLine: 10,
+            endLine: 15
+        });
+        assert.strictEqual(result.status, 'PASSTHROUGH_SLICE');
+        assert.strictEqual(result.totalLines, 400);
+        assert.ok(result.content.includes('line 10'));
+        assert.ok(result.content.includes('line 15'));
+        assert.ok(!result.content.includes('line 16'));
+        fs.rmSync(tempDir, { recursive: true });
+    });
+    it('should extract AST skeleton when file exceeds threshold without slice', async () => {
+        const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-test-'));
+        const tempFile = path.join(tempDir, 'large.ts');
+        // Create 350 lines with some exports
+        const lines = [
+            "import { foo } from './foo.js';",
+            "export class BigService {"
+        ];
+        for (let i = 0; i < 350; i++) {
+            lines.push(`  // comment line ${i}`);
+        }
+        lines.push("  public executeAction() { return true; }");
+        lines.push("}");
+        fs.writeFileSync(tempFile, lines.join('\n'));
+        // Test with skeleton provider
+        process.env.CONTEXT_GUARD_PROVIDER = 'skeleton';
+        const result = await processWithContextGuard({
+            filePath: tempFile
+        });
+        assert.strictEqual(result.status, 'SHUNTED_LOCAL_AST');
+        assert.ok(result.content.includes('export class BigService'));
+        assert.ok(result.content.includes('public executeAction()'));
+        fs.rmSync(tempDir, { recursive: true });
+    });
+});
+//# sourceMappingURL=hook.test.js.map

package/dist/tests/hook.test.js.map

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

package/dist/tests/skeletonizer.test.d.ts

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

package/dist/tests/skeletonizer.test.d.ts.map

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

package/dist/tests/skeletonizer.test.js

@@ -0,0 +1,71 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { extractCodeSkeleton, isSupportedExtension } from '../src/skeletonizer.js';
+describe('Skeletonizer Tier 0 Extraction', () => {
+    it('should identify supported extensions', () => {
+        assert.strictEqual(isSupportedExtension('.ts'), 'ts');
+        assert.strictEqual(isSupportedExtension('.py'), 'py');
+        assert.strictEqual(isSupportedExtension('.go'), 'go');
+        assert.strictEqual(isSupportedExtension('.rs'), 'rs');
+        assert.strictEqual(isSupportedExtension('.java'), 'java');
+        assert.strictEqual(isSupportedExtension('.txt'), null);
+    });
+    it('should extract TypeScript classes, interfaces, and functions with line numbers', () => {
+        const tsCode = `
+import { Config } from './config.js';
+import path from 'path';
+
+// Some comments
+export interface UserProfile {
+  id: string;
+  name: string;
+}
+
+export class UserManager {
+  private cache: Map<string, UserProfile>;
+
+  public async fetchUser(id: string): Promise<UserProfile> {
+    // 50 lines of boilerplate logic
+    return { id, name: 'Alice' };
+  }
+}
+
+export function calculateTotal(items: number[]): number {
+  return items.reduce((a, b) => a + b, 0);
+}
+    `.trim();
+        const skeleton = extractCodeSkeleton(tsCode, '.ts');
+        assert.ok(skeleton !== null);
+        if (!skeleton)
+            throw new Error('Skeleton is null');
+        assert.ok(skeleton.includes('[L1] import { Config } from \'./config.js\';'));
+        assert.ok(skeleton.includes('export interface UserProfile'));
+        assert.ok(skeleton.includes('export class UserManager'));
+        assert.ok(skeleton.includes('public async fetchUser(id: string)'));
+        assert.ok(skeleton.includes('export function calculateTotal(items: number[])'));
+    });
+    it('should extract Python classes and methods', () => {
+        const pyCode = `
+import os
+import sys
+
+class DataProcessor:
+    def __init__(self, path: str):
+        self.path = path
+
+    def process(self):
+        pass
+
+async def async_fetch():
+    pass
+    `.trim();
+        const skeleton = extractCodeSkeleton(pyCode, '.py');
+        assert.ok(skeleton !== null);
+        if (!skeleton)
+            throw new Error('Skeleton is null');
+        assert.ok(skeleton.includes('[L1] import os'));
+        assert.ok(skeleton.includes('class DataProcessor:'));
+        assert.ok(skeleton.includes('async def async_fetch()'));
+    });
+});
+//# sourceMappingURL=skeletonizer.test.js.map

package/dist/tests/skeletonizer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeletonizer.test.js","sourceRoot":"","sources":["../../tests/skeletonizer.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnF,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;QAC1D,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gFAAgF,EAAE,GAAG,EAAE;QACxF,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;KAsBd,CAAC,IAAI,EAAE,CAAC;QAET,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACpD,MAAM,CAAC,EAAE,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACnD,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,8CAA8C,CAAC,CAAC,CAAC;QAC7E,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,8BAA8B,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CAAC,CAAC;QACnE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,iDAAiD,CAAC,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,MAAM,GAAG;;;;;;;;;;;;;KAad,CAAC,IAAI,EAAE,CAAC;QAET,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACpD,MAAM,CAAC,EAAE,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACnD,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@kevinbermudezc/context-guard",
+  "version": "1.0.0",
+  "description": "Intelligent context admission control and token optimization for Claude Code, Cursor, and Agentic workflows.",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "bin": {
+    "context-guard": "./dist/bin/context-guard.js",
+    "context-guard-hook": "./dist/bin/claude-hook.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.13.9",
+    "typescript": "^7.0.2"
+  },
+  "keywords": [
+    "claude-code",
+    "pretooluse-hook",
+    "ai-agent",
+    "token-optimization",
+    "finops",
+    "context-window",
+    "typescript"
+  ],
+  "author": "Kevin Bermudez",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/bin/*.js",
+    "test": "pnpm run build && node --test dist/tests/**/*.test.js"
+  }
+}