context-compress 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Open330
+
+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,275 @@
+<div align="center">
+
+# context-compress
+
+**Keep your context window lean. Let the sandbox do the heavy lifting.**
+
+[![CI](https://github.com/Open330/context-compress/actions/workflows/ci.yml/badge.svg)](https://github.com/Open330/context-compress/actions)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178C6?logo=typescript&logoColor=white)](tsconfig.json)
+
+A context-aware **MCP server** for [Claude Code](https://claude.ai/claude-code) that compresses tool output by processing it in isolated subprocesses. Raw data stays in the sandbox — only concise summaries enter your context window.
+
+[Quickstart for Agents](#quickstart-for-agents) · [Getting Started](#getting-started) · [How It Works](#how-it-works) · [Configuration](#configuration) · [CLI](#cli) · [Changelog](CHANGELOG.md)
+
+</div>
+
+---
+
+## Quickstart for Agents
+
+```
+npm install -g context-compress && claude mcp add context-compress -- node $(which context-compress)
+```
+
+MCP server that compresses tool output for Claude Code — raw data stays in sandboxed subprocesses, only concise summaries enter your context window.
+
+---
+
+## Why?
+
+Every byte of tool output that enters your Claude Code context window **reduces quality and speed**.
+A single `git log` or `npm test` can dump 50KB+ into context — that's ~12,000 tokens gone.
+
+**context-compress** intercepts these tools, processes output in a sandbox, and returns only what matters:
+
+```
+Before:  git log --oneline -100  →  8.2KB into context
+After:   execute("git log ...")  →  0.3KB summary + full data searchable in FTS5
+```
+
+> Based on [context-mode](https://github.com/mksglu/claude-context-mode) by Mert Koseoğlu — rewritten in TypeScript with security hardening, architectural improvements, and better DX.
+
+---
+
+## Getting Started
+
+### Install
+
+```bash
+npm install -g context-compress
+```
+
+### Add to Claude Code
+
+```bash
+claude mcp add context-compress -- node $(which context-compress)
+```
+
+Or add to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "context-compress": {
+      "command": "node",
+      "args": ["/path/to/context-compress/dist/index.js"]
+    }
+  }
+}
+```
+
+### Verify
+
+```bash
+context-compress doctor
+```
+
+---
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                     Claude Code                          │
+│                                                          │
+│  "Run tests"  ──→  PreToolUse Hook intercepts            │
+│                          │                               │
+│                          ▼                               │
+│               ┌──────────────────┐                       │
+│               │  context-compress │                      │
+│               │   MCP Server      │                      │
+│               └────────┬─────────┘                       │
+│                        │                                 │
+│            ┌───────────┼───────────┐                     │
+│            ▼           ▼           ▼                     │
+│     ┌──────────┐ ┌──────────┐ ┌──────────┐              │
+│     │ Executor │ │  Store   │ │  Stats   │              │
+│     │ (11 lang)│ │  (FTS5)  │ │ Tracker  │              │
+│     └──────────┘ └──────────┘ └──────────┘              │
+│            │           │                                 │
+│            ▼           ▼                                 │
+│     Raw output    Indexed &     Only summary             │
+│     stays here    searchable    enters context           │
+└─────────────────────────────────────────────────────────┘
+```
+
+### 7 MCP Tools
+
+| Tool | What it does |
+|:-----|:-------------|
+| **`execute`** | Run code in 11 languages. Only stdout enters context. |
+| **`execute_file`** | Process a file via `FILE_CONTENT` variable — file never enters context. |
+| **`index`** | Chunk markdown/text into FTS5 knowledge base for search. |
+| **`search`** | BM25 search with Porter stemming → trigram → fuzzy fallback. |
+| **`fetch_and_index`** | Fetch URL → HTML-to-markdown → auto-index. Preview only in context. |
+| **`batch_execute`** | Run N commands + search in ONE call. Replaces 30+ tool calls. |
+| **`stats`** | Real-time session statistics: bytes saved, tokens avoided, savings ratio. |
+
+### Supported Languages
+
+`javascript` · `typescript` · `python` · `shell` · `ruby` · `go` · `rust` · `php` · `perl` · `r` · `elixir`
+
+> Bun auto-detected for 3-5x faster JS/TS execution.
+
+---
+
+## What Changed from context-mode
+
+| | context-mode | context-compress |
+|:--|:------------|:-----------------|
+| **Credentials** | 20+ auth env vars passed by default | Opt-in only (`passthroughEnvVars: []`) |
+| **Hook writes** | Self-modifies `settings.json` | Zero filesystem writes |
+| **Rust compile** | Shell string → injection risk | `execFileSync` with array args |
+| **Upgrade** | `git clone` arbitrary code | Removed entirely |
+| **FTS5 indexing** | Always dual-table (Porter + trigram) | Lazy trigram — 50% fewer writes |
+| **Runtime detect** | Sequential `execSync` ~250ms | Parallel `Promise.all` ~40ms |
+| **batch_execute** | Sequential commands | `Promise.allSettled` parallel |
+| **Config** | None | ENV + file + defaults |
+| **Errors** | 23 silent catch blocks | `CONTEXT_COMPRESS_DEBUG=1` logs all |
+| **Uninstall** | None | `context-compress uninstall` |
+
+---
+
+## Configuration
+
+Loaded in order: **ENV vars** → **`.context-compress.json`** → **defaults**
+
+### Environment Variables
+
+```bash
+# Enable debug logging (stderr)
+CONTEXT_COMPRESS_DEBUG=1
+
+# Pass specific env vars to subprocesses (default: none)
+CONTEXT_COMPRESS_PASSTHROUGH_ENV=GH_TOKEN,AWS_PROFILE
+
+# Disable curl/wget blocking
+CONTEXT_COMPRESS_BLOCK_CURL=0
+
+# Disable WebFetch blocking
+CONTEXT_COMPRESS_BLOCK_WEBFETCH=0
+
+# Disable Read/Grep nudges
+CONTEXT_COMPRESS_NUDGE_READ=0
+CONTEXT_COMPRESS_NUDGE_GREP=0
+```
+
+### Config File
+
+Create `.context-compress.json` in your project root or home directory:
+
+```json
+{
+  "passthroughEnvVars": ["GH_TOKEN", "AWS_PROFILE", "KUBECONFIG"],
+  "blockCurl": true,
+  "blockWebFetch": true,
+  "debug": false
+}
+```
+
+---
+
+## CLI
+
+```bash
+context-compress            # Start MCP server (stdio)
+context-compress setup      # Detect runtimes, show install instructions
+context-compress doctor     # Diagnose: runtimes, hooks, FTS5, version
+context-compress uninstall  # Clean removal: hooks, MCP reg, stale DBs
+```
+
+### Doctor Output Example
+
+```
+  context-compress doctor
+
+  [PASS] Performance: FAST — Bun detected
+  [PASS] Language coverage: 7/11 (64%)
+  [PASS] Server test: OK
+  [PASS] PreToolUse hook configured
+  [PASS] FTS5 / better-sqlite3 works
+
+  Version: v1.0.0
+  All checks passed.
+```
+
+---
+
+## Project Structure
+
+```
+context-compress/
+├── src/
+│   ├── index.ts              # Entry point
+│   ├── server.ts             # MCP server (7 tools)
+│   ├── executor.ts           # SubprocessExecutor
+│   ├── store.ts              # ContentStore (FTS5)
+│   ├── config.ts             # Config system
+│   ├── logger.ts             # Debug logger
+│   ├── snippet.ts            # FTS5 snippet extraction
+│   ├── stats.ts              # Session tracker
+│   ├── types.ts              # Shared types
+│   ├── runtime/
+│   │   ├── plugin.ts         # LanguagePlugin interface
+│   │   ├── index.ts          # Registry + parallel detection
+│   │   └── languages/        # 11 language plugins
+│   ├── hooks/
+│   │   └── pretooluse.ts     # PreToolUse hook (no self-mod)
+│   └── cli/
+│       ├── index.ts          # CLI entry
+│       ├── setup.ts          # Interactive setup
+│       ├── doctor.ts         # Diagnostics
+│       └── uninstall.ts      # Clean removal
+├── tests/
+│   ├── unit/                 # 7 unit test files
+│   └── integration/          # 3 integration test files
+├── hooks/
+│   └── hooks.json            # Hook matcher config
+├── skills/                   # Slash command definitions
+└── dist/                     # Compiled output
+```
+
+---
+
+## Security
+
+| Threat | Mitigation |
+|:-------|:-----------|
+| Credential leakage | `passthroughEnvVars` defaults to `[]` — zero env vars passed unless opted in |
+| Shell injection (Rust) | `execFileSync` with array arguments — no string interpolation |
+| Hook self-modification | No `fs.writeFileSync` in hooks — zero filesystem side effects |
+| Arbitrary code execution | No `upgrade` command — no `git clone` or `npm install` at runtime |
+| Silent failures | Debug mode surfaces all catch block errors to stderr |
+
+---
+
+## Contributing
+
+```bash
+git clone https://github.com/Open330/context-compress
+cd context-compress
+npm install
+npm run typecheck     # Type checking
+npm run lint          # Biome linting
+npm run test:unit     # 36 unit tests
+npm run test          # All tests (unit + integration)
+npm run build         # Compile + bundle
+```
+
+---
+
+## License
+
+[MIT](LICENSE) — Based on [context-mode](https://github.com/mksglu/claude-context-mode) by Mert Koseoğlu.

package/dist/cli/doctor.d.ts

@@ -0,0 +1,2 @@
+export declare function doctor(): Promise<number>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AA6BA,wBAAsB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CA4G9C"}

package/dist/cli/doctor.js

@@ -0,0 +1,131 @@
+import { constants, accessSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import Database from "better-sqlite3";
+import { loadConfig } from "../config.js";
+import { SubprocessExecutor } from "../executor.js";
+import { detectRuntimes, getRuntimeSummary, hasBun } from "../runtime/index.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+function getVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(resolve(__dirname, "..", "..", "package.json"), "utf-8"));
+        return pkg.version ?? "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+function readSettings() {
+    try {
+        const path = resolve(homedir(), ".claude", "settings.json");
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+export async function doctor() {
+    console.log("\n  context-compress doctor\n");
+    let criticalFails = 0;
+    // 1. Runtimes
+    console.log("  Detecting runtimes...");
+    const runtimes = await detectRuntimes();
+    console.log(getRuntimeSummary(runtimes));
+    console.log();
+    if (hasBun(runtimes)) {
+        console.log("  [PASS] Performance: FAST — Bun detected");
+    }
+    else {
+        console.log("  [WARN] Performance: NORMAL — Using Node.js (install Bun for 3-5x speed)");
+    }
+    const pct = ((runtimes.size / 11) * 100).toFixed(0);
+    if (runtimes.size < 2) {
+        criticalFails++;
+        console.log(`  [FAIL] Language coverage: ${runtimes.size}/11 (${pct}%)`);
+    }
+    else {
+        console.log(`  [PASS] Language coverage: ${runtimes.size}/11 (${pct}%)`);
+    }
+    // 2. Server test
+    console.log("\n  Testing server...");
+    try {
+        const config = loadConfig();
+        const executor = new SubprocessExecutor(runtimes, config);
+        const result = await executor.execute({
+            language: "javascript",
+            code: 'console.log("ok");',
+            timeout: 5000,
+        });
+        if (result.exitCode === 0 && result.stdout.trim() === "ok") {
+            console.log("  [PASS] Server test: OK");
+        }
+        else {
+            criticalFails++;
+            console.log(`  [FAIL] Server test: exit ${result.exitCode}`);
+        }
+    }
+    catch (err) {
+        criticalFails++;
+        const msg = err instanceof Error ? err.message : String(err);
+        console.log(`  [FAIL] Server test: ${msg}`);
+    }
+    // 3. Hooks
+    console.log("\n  Checking hooks...");
+    const settings = readSettings();
+    if (settings) {
+        const hooks = settings.hooks;
+        const preToolUse = hooks?.PreToolUse;
+        if (preToolUse?.some((e) => e.hooks?.some((h) => h.command?.includes("pretooluse.mjs")))) {
+            console.log("  [PASS] PreToolUse hook configured");
+        }
+        else {
+            console.log("  [WARN] PreToolUse hook not found — run setup to configure");
+        }
+    }
+    else {
+        console.log("  [WARN] Could not read ~/.claude/settings.json");
+    }
+    // 4. Hook script
+    const hookPath = resolve(__dirname, "..", "..", "hooks", "pretooluse.mjs");
+    try {
+        accessSync(hookPath, constants.R_OK);
+        console.log("  [PASS] Hook script exists");
+    }
+    catch {
+        console.log(`  [WARN] Hook script not found at ${hookPath}`);
+    }
+    // 5. FTS5 / better-sqlite3
+    console.log("\n  Checking FTS5...");
+    try {
+        const db = new Database(":memory:");
+        db.exec("CREATE VIRTUAL TABLE fts_test USING fts5(content)");
+        db.exec("INSERT INTO fts_test(content) VALUES ('hello world')");
+        const row = db.prepare("SELECT * FROM fts_test WHERE fts_test MATCH 'hello'").get();
+        db.close();
+        if (row?.content === "hello world") {
+            console.log("  [PASS] FTS5 / better-sqlite3 works");
+        }
+        else {
+            criticalFails++;
+            console.log("  [FAIL] FTS5 returned unexpected result");
+        }
+    }
+    catch (err) {
+        criticalFails++;
+        const msg = err instanceof Error ? err.message : String(err);
+        console.log(`  [FAIL] FTS5: ${msg}`);
+    }
+    // 6. Version
+    const version = getVersion();
+    console.log(`\n  Version: v${version}`);
+    // Summary
+    console.log();
+    if (criticalFails > 0) {
+        console.log(`  ${criticalFails} critical issue(s) found.\n`);
+        return 1;
+    }
+    console.log("  All checks passed.\n");
+    return 0;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * context-compress CLI
+ *
+ * Usage:
+ *   context-compress          → Start MCP server (stdio)
+ *   context-compress setup    → Interactive setup
+ *   context-compress doctor   → Diagnose issues
+ *   context-compress uninstall → Clean removal
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}

package/dist/cli/index.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+/**
+ * context-compress CLI
+ *
+ * Usage:
+ *   context-compress          → Start MCP server (stdio)
+ *   context-compress setup    → Interactive setup
+ *   context-compress doctor   → Diagnose issues
+ *   context-compress uninstall → Clean removal
+ */
+const args = process.argv.slice(2);
+const command = args[0];
+if (command === "setup") {
+    const { setup } = await import("./setup.js");
+    await setup();
+}
+else if (command === "doctor") {
+    const { doctor } = await import("./doctor.js");
+    const code = await doctor();
+    process.exit(code);
+}
+else if (command === "uninstall") {
+    const { uninstall } = await import("./uninstall.js");
+    await uninstall();
+}
+else {
+    // Default: start MCP server
+    await import("../index.js");
+}
+export {};
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAEH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAExB,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;IACzB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,KAAK,EAAE,CAAC;AACf,CAAC;KAAM,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;IACjC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,MAAM,MAAM,EAAE,CAAC;IAC5B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC;KAAM,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;IACpC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACrD,MAAM,SAAS,EAAE,CAAC;AACnB,CAAC;KAAM,CAAC;IACP,4BAA4B;IAC5B,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;AAC7B,CAAC"}

package/dist/cli/setup.d.ts

@@ -0,0 +1,2 @@
+export declare function setup(): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/cli/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAOA,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA+C3C"}

package/dist/cli/setup.js

@@ -0,0 +1,43 @@
+import { execSync } from "node:child_process";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { detectRuntimes, getRuntimeSummary, hasBun } from "../runtime/index.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export async function setup() {
+    console.log("\n  context-compress setup\n");
+    // Step 1: Detect runtimes
+    console.log("  Detecting runtimes...");
+    const runtimes = await detectRuntimes();
+    console.log(`  Found ${runtimes.size} languages:\n`);
+    console.log(getRuntimeSummary(runtimes));
+    console.log();
+    // Step 2: Check Bun
+    if (hasBun(runtimes)) {
+        console.log("  Bun detected — JS/TS will run at maximum speed.\n");
+    }
+    else {
+        console.log("  Bun not found — JS/TS will use Node.js (install Bun for 3-5x speed).\n");
+    }
+    // Step 3: Missing optional runtimes
+    const all = ["python", "ruby", "go", "rust", "php", "perl", "r", "elixir"];
+    const missing = all.filter((lang) => !runtimes.has(lang));
+    if (missing.length > 0) {
+        console.log(`  Optional runtimes not found: ${missing.join(", ")}`);
+        console.log("  Install them to enable additional language support.\n");
+    }
+    // Step 4: Show installation instructions
+    const serverPath = resolve(__dirname, "..", "index.js");
+    console.log("  To add to Claude Code, run:");
+    console.log(`    claude mcp add context-compress -- node ${serverPath}\n`);
+    console.log("  Or add to .mcp.json:");
+    console.log(JSON.stringify({
+        mcpServers: {
+            "context-compress": {
+                command: "node",
+                args: [serverPath],
+            },
+        },
+    }, null, 4));
+    console.log("\n  Setup complete!\n");
+}
+//# sourceMappingURL=setup.js.map

package/dist/cli/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAEhF,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,KAAK;IAC1B,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAE5C,0BAA0B;IAC1B,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,MAAM,cAAc,EAAE,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,WAAW,QAAQ,CAAC,IAAI,eAAe,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,oBAAoB;IACpB,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;IACpE,CAAC;SAAM,CAAC;QACP,OAAO,CAAC,GAAG,CAAC,0EAA0E,CAAC,CAAC;IACzF,CAAC;IAED,oCAAoC;IACpC,MAAM,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAU,CAAC;IACpF,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,kCAAkC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;IACxE,CAAC;IAED,yCAAyC;IACzC,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,+CAA+C,UAAU,IAAI,CAAC,CAAC;IAE3E,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CACV,IAAI,CAAC,SAAS,CACb;QACC,UAAU,EAAE;YACX,kBAAkB,EAAE;gBACnB,OAAO,EAAE,MAAM;gBACf,IAAI,EAAE,CAAC,UAAU,CAAC;aAClB;SACD;KACD,EACD,IAAI,EACJ,CAAC,CACD,CACD,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AACtC,CAAC"}

package/dist/cli/uninstall.d.ts

@@ -0,0 +1,2 @@
+export declare function uninstall(): Promise<void>;
+//# sourceMappingURL=uninstall.d.ts.map

package/dist/cli/uninstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../src/cli/uninstall.ts"],"names":[],"mappings":"AAKA,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAkG/C"}

package/dist/cli/uninstall.js

@@ -0,0 +1,102 @@
+import { readFileSync, readdirSync, rmSync, unlinkSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+export async function uninstall() {
+    console.log("\n  context-compress uninstall\n");
+    const changes = [];
+    // 1. Remove hooks from settings.json
+    console.log("  Removing hooks from settings.json...");
+    const settingsPath = resolve(homedir(), ".claude", "settings.json");
+    try {
+        const settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
+        const hooks = settings.hooks;
+        if (hooks?.PreToolUse && Array.isArray(hooks.PreToolUse)) {
+            const before = hooks.PreToolUse.length;
+            hooks.PreToolUse = hooks.PreToolUse.filter((entry) => {
+                const entryHooks = entry.hooks;
+                return !entryHooks?.some((h) => h.command?.includes("context-compress") || h.command?.includes("pretooluse.mjs"));
+            });
+            if (hooks.PreToolUse.length === 0) {
+                // biome-ignore lint/performance/noDelete: removing key from JSON object
+                delete hooks.PreToolUse;
+            }
+            if (hooks.PreToolUse === undefined || hooks.PreToolUse.length < before) {
+                settings.hooks = hooks;
+                writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}\n`, "utf-8");
+                changes.push("Removed PreToolUse hooks from settings.json");
+            }
+        }
+    }
+    catch {
+        console.log("  Could not modify settings.json (may not exist)");
+    }
+    // 2. Remove MCP server registration
+    console.log("  Removing MCP server registration...");
+    try {
+        const mcpPath = resolve(homedir(), ".claude", "settings.json");
+        const settings = JSON.parse(readFileSync(mcpPath, "utf-8"));
+        const mcpServers = settings.mcpServers;
+        if (mcpServers && "context-compress" in mcpServers) {
+            mcpServers["context-compress"] = undefined;
+            writeFileSync(mcpPath, `${JSON.stringify(settings, null, 2)}\n`, "utf-8");
+            changes.push("Removed context-compress MCP server from settings");
+        }
+    }
+    catch {
+        // May not exist
+    }
+    // Also check project-level .mcp.json
+    try {
+        const cwd = process.cwd();
+        const mcpJson = resolve(cwd, ".mcp.json");
+        const mcp = JSON.parse(readFileSync(mcpJson, "utf-8"));
+        const servers = mcp.mcpServers;
+        if (servers && "context-compress" in servers) {
+            servers["context-compress"] = undefined;
+            writeFileSync(mcpJson, `${JSON.stringify(mcp, null, 2)}\n`, "utf-8");
+            changes.push("Removed context-compress from .mcp.json");
+        }
+    }
+    catch {
+        // May not exist
+    }
+    // 3. Clean stale databases
+    console.log("  Cleaning stale databases...");
+    const dir = tmpdir();
+    try {
+        const files = readdirSync(dir);
+        let cleaned = 0;
+        for (const file of files) {
+            if (file.startsWith("context-compress-") && file.endsWith(".db")) {
+                for (const suffix of ["", "-wal", "-shm"]) {
+                    try {
+                        unlinkSync(join(dir, file + suffix));
+                    }
+                    catch {
+                        // Ignore
+                    }
+                }
+                cleaned++;
+            }
+        }
+        if (cleaned > 0) {
+            changes.push(`Cleaned ${cleaned} database file(s)`);
+        }
+    }
+    catch {
+        // Ignore
+    }
+    // Summary
+    console.log();
+    if (changes.length > 0) {
+        for (const change of changes) {
+            console.log(`  + ${change}`);
+        }
+    }
+    else {
+        console.log("  Nothing to clean up.");
+    }
+    console.log("\n  Uninstall complete. Restart Claude Code to apply changes.\n");
+}
+//# sourceMappingURL=uninstall.js.map