@kevinbermudezc/context-guard 1.3.2 → 1.5.0

package/dist/tests/init.test.js

@@ -0,0 +1,63 @@
+/**
+ * Tests for context-guard init workspace command
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert';
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+const CLI_BIN = path.resolve(process.cwd(), 'dist/bin/context-guard.js');
+describe('context-guard init (Phase 3)', () => {
+    let tmpWorkspace;
+    beforeEach(() => {
+        tmpWorkspace = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-init-test-'));
+    });
+    afterEach(() => {
+        if (fs.existsSync(tmpWorkspace)) {
+            try {
+                fs.rmSync(tmpWorkspace, { recursive: true, force: true });
+            }
+            catch { }
+        }
+    });
+    it('should initialize Antigravity rules, skill and mcp config when targeting antigravity', () => {
+        const res = spawnSync('node', [CLI_BIN, 'init', 'antigravity'], {
+            cwd: tmpWorkspace,
+            encoding: 'utf-8'
+        });
+        assert.strictEqual(res.status, 0);
+        assert.ok(res.stdout.includes('Google Antigravity'));
+        const rulePath = path.join(tmpWorkspace, '.agents/rules/context-guard.md');
+        const skillPath = path.join(tmpWorkspace, '.agents/skills/context-guard/SKILL.md');
+        const mcpPath = path.join(tmpWorkspace, '.agents/mcp.json');
+        assert.ok(fs.existsSync(rulePath), 'Antigravity rule must exist');
+        assert.ok(fs.existsSync(skillPath), 'Antigravity skill must exist');
+        assert.ok(fs.existsSync(mcpPath), 'Antigravity MCP config must exist');
+        const mcpJson = JSON.parse(fs.readFileSync(mcpPath, 'utf-8'));
+        assert.ok(mcpJson.mcpServers['context-guard']);
+    });
+    it('should initialize Cursor rules and mcp config when targeting cursor', () => {
+        const res = spawnSync('node', [CLI_BIN, 'init', 'cursor'], {
+            cwd: tmpWorkspace,
+            encoding: 'utf-8'
+        });
+        assert.strictEqual(res.status, 0);
+        assert.ok(res.stdout.includes('Cursor'));
+        const rulePath = path.join(tmpWorkspace, '.cursor/rules/context-guard.mdc');
+        const mcpPath = path.join(tmpWorkspace, '.cursor/mcp.json');
+        assert.ok(fs.existsSync(rulePath), 'Cursor rule must exist');
+        assert.ok(fs.existsSync(mcpPath), 'Cursor MCP config must exist');
+    });
+    it('should configure all adapters when run with no arguments or "all"', () => {
+        const res = spawnSync('node', [CLI_BIN, 'init'], {
+            cwd: tmpWorkspace,
+            encoding: 'utf-8'
+        });
+        assert.strictEqual(res.status, 0);
+        assert.ok(fs.existsSync(path.join(tmpWorkspace, '.agents/rules/context-guard.md')));
+        assert.ok(fs.existsSync(path.join(tmpWorkspace, '.cursor/rules/context-guard.mdc')));
+        assert.ok(fs.existsSync(path.join(tmpWorkspace, '.claude/settings.json')));
+    });
+});
+//# sourceMappingURL=init.test.js.map

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

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

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

@@ -90,7 +90,7 @@ describe('ContextGuard MCP Server (Phase 2)', () => {
         assert.ok(result.serverInfo, 'Must include serverInfo');
         const info = result.serverInfo;
         assert.strictEqual(info.name, 'context-guard');
-        assert.strictEqual(info.version, '1.3.2');
+        assert.strictEqual(info.version, '1.5.0');
     });
     it('should list exactly 3 registered tools', async () => {
         const res = await sendRequest(proc, req('tools/list'));

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

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

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

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

package/dist/tests/telemetry.test.js

@@ -0,0 +1,79 @@
+/**
+ * Unit tests for Anonymous Opt-Out Telemetry
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert';
+import { isTelemetryEnabled, enableTelemetry, disableTelemetry, getAnonymousId, sendTelemetryPing } from '../src/telemetry.js';
+describe('Anonymous Telemetry System', () => {
+    const originalEnv = { ...process.env };
+    const testDir = path.join(os.tmpdir(), `cg-telemetry-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    const disabledFile = path.join(testDir, 'telemetry-disabled');
+    beforeEach(() => {
+        delete process.env.CONTEXT_GUARD_TELEMETRY;
+        delete process.env.DO_NOT_TRACK;
+        process.env.CONTEXT_GUARD_DIR = testDir;
+        if (fs.existsSync(disabledFile)) {
+            try {
+                fs.unlinkSync(disabledFile);
+            }
+            catch { }
+        }
+    });
+    afterEach(() => {
+        process.env = { ...originalEnv };
+        if (fs.existsSync(testDir)) {
+            try {
+                fs.rmSync(testDir, { recursive: true, force: true });
+            }
+            catch { }
+        }
+    });
+    it('should be enabled by default', () => {
+        assert.strictEqual(isTelemetryEnabled(), true);
+    });
+    it('should respect CONTEXT_GUARD_TELEMETRY=0 environment variable', () => {
+        process.env.CONTEXT_GUARD_TELEMETRY = '0';
+        assert.strictEqual(isTelemetryEnabled(), false);
+        process.env.CONTEXT_GUARD_TELEMETRY = 'false';
+        assert.strictEqual(isTelemetryEnabled(), false);
+    });
+    it('should respect global DO_NOT_TRACK=1 standard', () => {
+        process.env.DO_NOT_TRACK = '1';
+        assert.strictEqual(isTelemetryEnabled(), false);
+    });
+    it('should respect disableTelemetry() and enableTelemetry() flags', () => {
+        disableTelemetry();
+        assert.strictEqual(isTelemetryEnabled(), false);
+        assert.strictEqual(fs.existsSync(disabledFile), true);
+        enableTelemetry();
+        assert.strictEqual(isTelemetryEnabled(), true);
+        assert.strictEqual(fs.existsSync(disabledFile), false);
+    });
+    it('should generate a persistent, valid UUIDv4 anonymous machine ID', () => {
+        const id1 = getAnonymousId();
+        assert.ok(id1);
+        assert.strictEqual(typeof id1, 'string');
+        // UUID v4 regex validation
+        assert.match(id1, /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i);
+        const id2 = getAnonymousId();
+        assert.strictEqual(id1, id2, 'Anonymous ID must be persistent across calls');
+    });
+    it('should send telemetry ping non-blockingly without throwing errors even if offline or invalid endpoint', () => {
+        process.env.CONTEXT_GUARD_TELEMETRY_ENDPOINT = 'http://127.0.0.1:54321/non-existent';
+        assert.doesNotThrow(() => {
+            sendTelemetryPing('cli', 'file_intercepted', '1.4.0', 1500);
+        });
+    });
+    it('should not send telemetry ping when telemetry is disabled', () => {
+        disableTelemetry();
+        // Point to an invalid endpoint that would fail if attempted
+        process.env.CONTEXT_GUARD_TELEMETRY_ENDPOINT = 'http://127.0.0.1:54321/must-not-be-called';
+        assert.doesNotThrow(() => {
+            sendTelemetryPing('mcp', 'outline_inspected', '1.4.0', 500);
+        });
+    });
+});
+//# sourceMappingURL=telemetry.test.js.map

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

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

package/dist/tests/update-notifier.test.d.ts

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

package/dist/tests/update-notifier.test.d.ts.map

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

package/dist/tests/update-notifier.test.js

@@ -0,0 +1,60 @@
+/**
+ * Tests for the update notifier system
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { isNewerVersion, getCachedLatestVersion, saveUpdateCache, shouldCheckRegistry, getUpdateNotice } from '../src/update-notifier.js';
+describe('Update Notifier System', () => {
+    let tempDir;
+    const originalEnv = { ...process.env };
+    beforeEach(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-update-test-'));
+        process.env.CONTEXT_GUARD_DIR = tempDir;
+    });
+    afterEach(() => {
+        process.env = { ...originalEnv };
+        if (fs.existsSync(tempDir)) {
+            try {
+                fs.rmSync(tempDir, { recursive: true, force: true });
+            }
+            catch { }
+        }
+    });
+    it('should accurately compare semver versions', () => {
+        assert.strictEqual(isNewerVersion('1.4.1', '1.4.0'), true);
+        assert.strictEqual(isNewerVersion('1.5.0', '1.4.9'), true);
+        assert.strictEqual(isNewerVersion('2.0.0', '1.9.9'), true);
+        assert.strictEqual(isNewerVersion('1.4.0', '1.4.0'), false);
+        assert.strictEqual(isNewerVersion('1.3.2', '1.4.0'), false);
+    });
+    it('should read and write cache properly', () => {
+        assert.strictEqual(getCachedLatestVersion(), null);
+        assert.strictEqual(shouldCheckRegistry(), true);
+        saveUpdateCache('1.4.5');
+        assert.strictEqual(getCachedLatestVersion(), '1.4.5');
+        assert.strictEqual(shouldCheckRegistry(), false);
+    });
+    it('should return a clean, unboxed notification message when a newer version is available', () => {
+        saveUpdateCache('1.5.0');
+        const notice = getUpdateNotice('1.4.0');
+        assert.ok(notice);
+        assert.strictEqual(notice.latestVersion, '1.5.0');
+        assert.ok(notice.message.includes('ContextGuard update available'));
+        assert.ok(notice.message.includes('v1.4.0'));
+        assert.ok(notice.message.includes('v1.5.0'));
+        assert.ok(notice.message.includes('npm i -g @kevinbermudezc/context-guard@latest'));
+        // Ensure no broken ASCII box-drawing characters
+        assert.strictEqual(notice.message.includes('╭'), false);
+        assert.strictEqual(notice.message.includes('╰'), false);
+        assert.strictEqual(notice.message.includes('│'), false);
+    });
+    it('should return null when the current version is equal or newer', () => {
+        saveUpdateCache('1.4.0');
+        const notice = getUpdateNotice('1.4.0');
+        assert.strictEqual(notice, null);
+    });
+});
+//# sourceMappingURL=update-notifier.test.js.map

package/dist/tests/update-notifier.test.js.map

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

package/examples/hooks/antigravity-hooks.json

@@ -0,0 +1,17 @@
+{
+  "context-guard-admission": {
+    "enabled": true,
+    "PreToolUse": [
+      {
+        "matcher": "view_file",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx -y -p @kevinbermudezc/context-guard context-guard-hook",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}

package/examples/rules/antigravity/context-guard.md

@@ -0,0 +1,15 @@
+# 🛡️ ContextGuard Project Rule for Google Antigravity (AGY)
+
+You MUST follow these context admission control and token optimization rules:
+
+## 1. Context Admission Control
+- **Do NOT read large files (>300 lines) into context unrestricted.** Dumping large files floods the context window and accelerates model degradation.
+- When `read_file_safe` is available via MCP:
+  - Use `inspect_outline(file_path)` to get a structural map of the file with line numbers `[L#]`.
+  - Use `read_file_safe(file_path)` which automatically returns an AST skeleton for files >300 lines.
+  - When inspecting implementations, read targeted line ranges:
+    `read_file_safe(file_path, start_line=..., end_line=...)` or `view_file(AbsolutePath=..., StartLine=..., EndLine=...)`.
+
+## 2. Lockfiles and Binaries
+- **Never open lockfiles** (`package-lock.json`, `pnpm-lock.yaml`, `yarn.lock`, `bun.lockb`) or compiled/minified bundles (`.min.js`, `.wasm`, `.pyc`).
+- Use command-line tools (`pnpm why <pkg>`, `npm ls <pkg>`, or read `package.json` directly) to check package dependencies.

package/examples/rules/cursor/context-guard.mdc

@@ -0,0 +1,25 @@
+---
+description: ContextGuard FinOps and Context Window Admission Control
+globs: *
+alwaysApply: true
+---
+
+# 🛡️ ContextGuard Rule for Cursor (Composer & Chat)
+
+You MUST follow these context admission control and token optimization rules to protect the model context window and prevent latency degradation from massive files:
+
+## 1. Zero Direct Reads for Large Files (>300 lines)
+- **NEVER** read files larger than 300 lines without line constraints (`start_line`, `end_line`).
+- Instead of using default read tools, prioritize calling ContextGuard MCP tools:
+  - Call `read_file_safe(file_path: "path/to/file")` to automatically receive an AST structural skeleton if the file is large (>300 lines).
+  - Call `inspect_outline(file_path: "path/to/file")` (< 5ms, 0 tokens) to inspect classes, methods, and types with their exact line tags `[L#]`.
+  - Once the relevant code block is located, read only the target slice:
+    `read_file_safe(file_path: "path/to/file", start_line: 120, end_line: 180)`
+
+## 2. Pattern Searching
+- When searching for symbols or references across files, use `grep_distilled(pattern: "myFunction")`.
+- It isolates only matching signatures and structural surroundings rather than returning huge dumps of implementation code.
+
+## 3. Binaries and Lockfiles
+- Do NOT read `package-lock.json`, `pnpm-lock.yaml`, `bun.lockb`, or minified bundles (`.min.js`).
+- Use CLI commands (`npm ls`, `pnpm why`, `cat package.json`) to inspect dependencies.

package/examples/skills/context-guard/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: context-guard
+description: >-
+  Uses ContextGuard to inspect large files, outlines, and structural AST skeletons safely without blowing up the context window. Use whenever exploring unfamiliar files, large components (>300 lines), or auditing token consumption.
+---
+
+# 🛡️ ContextGuard Skill for Antigravity
+
+ContextGuard provides intelligent context admission control, reducing token usage by up to 90% when reading large source files.
+
+## When to Use
+- Whenever you need to read or understand a source file larger than 300 lines.
+- When locating functions, classes, interfaces, or types in a large codebase.
+- When searching patterns across unfamiliar repositories.
+
+## Workflow
+
+### 1. Inspect File Structure First (<5ms, 0 tokens)
+Instead of dumping full files into context, call `inspect_outline`:
+```json
+{
+  "file_path": "path/to/large-service.ts"
+}
+```
+This returns all class declarations, function signatures, and exported types with exact line numbers `[L120]`.
+
+### 2. Read Safe Protected Content
+When reading files through MCP, call `read_file_safe`:
+```json
+{
+  "file_path": "path/to/large-service.ts"
+}
+```
+- If the file is small (≤300 lines), full content is returned.
+- If the file is large (>300 lines), an AST skeleton is returned with instructions.
+
+### 3. Read Only Targeted Slices
+Once you identify the line numbers from the outline, read only the relevant function:
+```json
+{
+  "file_path": "path/to/large-service.ts",
+  "start_line": 120,
+  "end_line": 160
+}
+```
+
+### 4. Search Symbols with Structural Distillation
+Use `grep_distilled` instead of raw regex searches to see structural context around matches without dumping hundreds of lines of implementation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kevinbermudezc/context-guard",
-  "version": "1.3.2",
+  "version": "1.5.0",
   "description": "Intelligent context admission control and token optimization for Claude Code, Cursor, Windsurf, Antigravity, and Agentic AI workflows.",
   "publishConfig": {
     "access": "public"