context-compress 2026.3.21 → 2026.5.0

package/dist/cli/filter.js

@@ -0,0 +1,200 @@
+import { spawn } from "node:child_process";
+import { deduplicateLines, groupErrorLines, stripAnsi, stripProgressLines } from "../executor.js";
+import { DEFAULT_MODE, applyCommandFilter, parseRequestedMode, } from "../filters.js";
+import { pickModeAuto } from "../util/auto-mode.js";
+import { StreamCompressor } from "../util/stream-compress.js";
+// Generic dedup/progress/group pipeline kicks in once output crosses these
+// thresholds. Lower thresholds = pipeline runs on more outputs = better
+// compression on mid-size noisy outputs. Higher = preserve small outputs as-is.
+const BALANCED_DEDUP_THRESHOLD = 5_000;
+const AGGRESSIVE_DEDUP_THRESHOLD = 2_000;
+/**
+ * Apply the full context-compress output pipeline to a buffer.
+ *
+ *   conservative: ANSI strip only — preserve everything else.
+ *   balanced:     ANSI strip → command filter (drops universal noise:
+ *                 progress bars, hint lines, ./.., 'total N', truncates
+ *                 git log bodies past 3 lines) → dedup/group (if >5KB).
+ *                 Preserves all metadata (perms, dates, commit headers).
+ *   aggressive:   balanced + aggressive command filters that drop metadata
+ *                 (git log → oneline, ls -la → name+size, etc.) and lower
+ *                 the dedup threshold to 2KB.
+ *
+ * Mirrors what SubprocessExecutor does internally so the same compression
+ * is available to standalone shell commands or other agents that don't
+ * route through the MCP execute() tool.
+ */
+export function compressOutput(stdout, originalCmd, mode = DEFAULT_MODE) {
+    let out = stripAnsi(stdout);
+    if (mode === "conservative")
+        return out;
+    if (originalCmd) {
+        const filtered = applyCommandFilter(originalCmd, out, mode);
+        if (filtered.filtered)
+            out = filtered.output;
+    }
+    const threshold = mode === "aggressive" ? AGGRESSIVE_DEDUP_THRESHOLD : BALANCED_DEDUP_THRESHOLD;
+    if (out.length > threshold) {
+        out = stripProgressLines(out);
+        out = deduplicateLines(out);
+        out = groupErrorLines(out);
+    }
+    return out;
+}
+/**
+ * Async variant that handles the "auto" meta-mode by asking an LLM to
+ * pick conservative/balanced/aggressive for the given command + output.
+ * Concrete modes route to the synchronous compressOutput.
+ */
+export async function compressOutputAsync(stdout, originalCmd, mode = DEFAULT_MODE) {
+    if (mode !== "auto") {
+        return { output: compressOutput(stdout, originalCmd, mode), resolvedMode: mode };
+    }
+    const result = await pickModeAuto(originalCmd ?? "", stdout);
+    return {
+        output: compressOutput(stdout, originalCmd, result.mode),
+        resolvedMode: result.mode,
+        autoSource: result.source,
+    };
+}
+/** Resolve mode from CLI args, env, or default — in that priority order. */
+function resolveMode(args) {
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === "--mode" && i + 1 < args.length) {
+            return parseRequestedMode(args[i + 1]);
+        }
+    }
+    return parseRequestedMode(process.env.CONTEXT_COMPRESS_MODE);
+}
+/** Read stdin to a string. */
+async function readStdin() {
+    process.stdin.setEncoding("utf-8");
+    let buf = "";
+    for await (const chunk of process.stdin)
+        buf += chunk;
+    return buf;
+}
+/**
+ * `context-compress filter [--cmd '<orig>'] [--mode conservative|balanced|aggressive|auto]`
+ * Reads stdin, applies the pipeline, writes to stdout. Exits 0.
+ */
+export async function runFilter(args) {
+    let cmd;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === "--cmd" && i + 1 < args.length) {
+            cmd = args[i + 1];
+            i++;
+        }
+    }
+    const mode = resolveMode(args);
+    const input = await readStdin();
+    const { output: compressed } = await compressOutputAsync(input, cmd, mode);
+    process.stdout.write(compressed);
+    if (!compressed.endsWith("\n"))
+        process.stdout.write("\n");
+    return 0;
+}
+/**
+ * `context-compress wrap [--stream] -- <cmd ...>`
+ *
+ * Default (buffered): spawn cmd, capture all stdout, apply full pipeline,
+ * print filtered stdout, propagate child's exit code.
+ *
+ * `--stream`: emit filtered output line-by-line as the child produces it.
+ * Use for long-running commands (tail -f, cargo watch, builds with
+ * progressive output) where buffering would defer all output until exit.
+ * Stream mode applies ANSI strip + progress filter + adjacent dedup only —
+ * command-aware filters need the full output.
+ *
+ * Usage:
+ *   context-compress wrap "npm test"
+ *   context-compress wrap --stream "tail -f /var/log/app.log"
+ *   context-compress wrap -- npm test
+ */
+export async function runWrap(args) {
+    if (args.length === 0) {
+        process.stderr.write("Usage: context-compress wrap [--stream] [--mode <m>] <command...>\n");
+        return 2;
+    }
+    let stream = false;
+    const remaining = [];
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "--stream") {
+            stream = true;
+        }
+        else if (a === "--mode" && i + 1 < args.length) {
+            // Consumed by resolveMode below; skip the value here.
+            i++;
+        }
+        else {
+            remaining.push(a);
+        }
+    }
+    const mode = resolveMode(args);
+    const sepIdx = remaining.indexOf("--");
+    const cmdLine = sepIdx >= 0 ? remaining.slice(sepIdx + 1).join(" ") : remaining.join(" ");
+    if (!cmdLine.trim()) {
+        process.stderr.write("Usage: context-compress wrap [--stream] [--mode <m>] <command...>\n");
+        return 2;
+    }
+    return await new Promise((resolve) => {
+        const proc = spawn(cmdLine, {
+            shell: true,
+            stdio: ["inherit", "pipe", "pipe"],
+            env: { ...process.env, NO_COLOR: "1" },
+        });
+        if (stream) {
+            runStreaming(proc, resolve);
+        }
+        else {
+            runBuffered(proc, cmdLine, mode, resolve);
+        }
+    });
+}
+function runBuffered(proc, cmdLine, mode, resolve) {
+    const stdoutChunks = [];
+    const stderrChunks = [];
+    proc.stdout?.on("data", (c) => stdoutChunks.push(c));
+    proc.stderr?.on("data", (c) => stderrChunks.push(c));
+    proc.on("error", (err) => {
+        process.stderr.write(`context-compress wrap: ${err.message}\n`);
+        resolve(127);
+    });
+    proc.on("close", (code) => {
+        const stdout = Buffer.concat(stdoutChunks).toString("utf-8");
+        const stderr = Buffer.concat(stderrChunks).toString("utf-8");
+        // auto mode triggers an LLM call; concrete modes are sync. Both flow
+        // through compressOutputAsync.
+        compressOutputAsync(stdout, cmdLine, mode).then(({ output: compressed }) => {
+            process.stdout.write(compressed);
+            if (compressed && !compressed.endsWith("\n"))
+                process.stdout.write("\n");
+            if (stderr)
+                process.stderr.write(stderr);
+            resolve(code ?? 0);
+        });
+    });
+}
+function runStreaming(proc, resolve) {
+    const compressor = new StreamCompressor();
+    proc.stdout?.setEncoding("utf-8");
+    proc.stdout?.on("data", (chunk) => {
+        const out = compressor.process(chunk);
+        if (out)
+            process.stdout.write(out);
+    });
+    // stderr passes through unchanged — typically small, error-relevant.
+    proc.stderr?.on("data", (c) => process.stderr.write(c));
+    proc.on("error", (err) => {
+        process.stderr.write(`context-compress wrap: ${err.message}\n`);
+        resolve(127);
+    });
+    proc.on("close", (code) => {
+        const tail = compressor.flush();
+        if (tail)
+            process.stdout.write(tail);
+        resolve(code ?? 0);
+    });
+}
+//# sourceMappingURL=filter.js.map

package/dist/cli/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../src/cli/filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,EACN,YAAY,EAGZ,kBAAkB,EAClB,kBAAkB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D,2EAA2E;AAC3E,wEAAwE;AACxE,gFAAgF;AAChF,MAAM,wBAAwB,GAAG,KAAK,CAAC;AACvC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAEzC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAC7B,MAAc,EACd,WAAoB,EACpB,OAAmB,YAAY;IAE/B,IAAI,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5B,IAAI,IAAI,KAAK,cAAc;QAAE,OAAO,GAAG,CAAC;IAExC,IAAI,WAAW,EAAE,CAAC;QACjB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5D,IAAI,QAAQ,CAAC,QAAQ;YAAE,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC9C,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,wBAAwB,CAAC;IAChG,IAAI,GAAG,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAC5B,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAC9B,GAAG,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC5B,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,MAAc,EACd,WAA+B,EAC/B,OAAsB,YAAY;IAElC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAClF,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,WAAW,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;IAC7D,OAAO;QACN,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC;QACxD,YAAY,EAAE,MAAM,CAAC,IAAI;QACzB,UAAU,EAAE,MAAM,CAAC,MAAM;KACzB,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,SAAS,WAAW,CAAC,IAAc;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACjD,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC;IACF,CAAC;IACD,OAAO,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;AAC9D,CAAC;AAED,8BAA8B;AAC9B,KAAK,UAAU,SAAS;IACvB,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK;QAAE,GAAG,IAAI,KAAK,CAAC;IACtD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAc;IAC7C,IAAI,GAAuB,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAChD,GAAG,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAClB,CAAC,EAAE,CAAC;QACL,CAAC;IACF,CAAC;IACD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,mBAAmB,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC3E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACjC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,CAAC,CAAC;AACV,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAc;IAC3C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qEAAqE,CAAC,CAAC;QAC5F,OAAO,CAAC,CAAC;IACV,CAAC;IAED,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;YACtB,MAAM,GAAG,IAAI,CAAC;QACf,CAAC;aAAM,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAClD,sDAAsD;YACtD,CAAC,EAAE,CAAC;QACL,CAAC;aAAM,CAAC;YACP,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;IACF,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE1F,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qEAAqE,CAAC,CAAC;QAC5F,OAAO,CAAC,CAAC;IACV,CAAC;IAED,OAAO,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE;YAC3B,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC;YAClC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE;SACtC,CAAC,CAAC;QAEH,IAAI,MAAM,EAAE,CAAC;YACZ,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACP,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;IACF,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CACnB,IAA8B,EAC9B,OAAe,EACf,IAAmB,EACnB,OAA+B;IAE/B,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7D,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;QAChE,OAAO,CAAC,GAAG,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QACzB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC7D,qEAAqE;QACrE,+BAA+B;QAC/B,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE;YAC1E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACjC,IAAI,UAAU,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACzE,IAAI,MAAM;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,IAA8B,EAAE,OAA+B;IACpF,MAAM,UAAU,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAE1C,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;QACzC,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,GAAG;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,qEAAqE;IACrE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhE,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;QAChE,OAAO,CAAC,GAAG,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,IAAI;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/cli/index.d.ts

@@ -3,10 +3,14 @@
  * 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
+ *   context-compress                    → Start MCP server (stdio)
+ *   context-compress setup              → Interactive setup (prints instructions)
+ *   context-compress setup --auto       → One-line setup: write ~/.claude/settings.json
+ *   context-compress init --auto        → Alias for setup --auto
+ *   context-compress doctor             → Diagnose issues
+ *   context-compress uninstall          → Clean removal
+ *   context-compress filter [--cmd '<orig>']   → stdin → compressed → stdout
+ *   context-compress wrap <cmd>         → run cmd, compress its stdout, exit with cmd's code
  */
 export {};
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/cli/index.js

@@ -3,16 +3,21 @@
  * 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
+ *   context-compress                    → Start MCP server (stdio)
+ *   context-compress setup              → Interactive setup (prints instructions)
+ *   context-compress setup --auto       → One-line setup: write ~/.claude/settings.json
+ *   context-compress init --auto        → Alias for setup --auto
+ *   context-compress doctor             → Diagnose issues
+ *   context-compress uninstall          → Clean removal
+ *   context-compress filter [--cmd '<orig>']   → stdin → compressed → stdout
+ *   context-compress wrap <cmd>         → run cmd, compress its stdout, exit with cmd's code
  */
 const args = process.argv.slice(2);
 const command = args[0];
-if (command === "setup") {
+const rest = args.slice(1);
+if (command === "setup" || command === "init") {
     const { setup } = await import("./setup.js");
-    await setup();
+    await setup(rest);
 }
 else if (command === "doctor") {
     const { doctor } = await import("./doctor.js");
@@ -23,6 +28,14 @@ else if (command === "uninstall") {
     const { uninstall } = await import("./uninstall.js");
     await uninstall();
 }
+else if (command === "filter") {
+    const { runFilter } = await import("./filter.js");
+    process.exit(await runFilter(rest));
+}
+else if (command === "wrap") {
+    const { runWrap } = await import("./filter.js");
+    process.exit(await runWrap(rest));
+}
 else {
     // Default: start MCP server
     await import("../index.js");

package/dist/cli/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAEH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AACxB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAE3B,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;IAC/C,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;AACnB,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,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;IACjC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AACrC,CAAC;KAAM,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;IAC/B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AACnC,CAAC;KAAM,CAAC;IACP,4BAA4B;IAC5B,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;AAC7B,CAAC"}

package/dist/cli/lite.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * context-compress lite CLI — only the filter/wrap commands.
+ *
+ * No MCP server, no SQLite, no better-sqlite3 native bindings. Designed to
+ * be compiled into a single static binary via `bun build --compile` for
+ * RTK-style "curl | sh" install — covers the transparent shell-filter
+ * use case without any Node.js or npm install.
+ *
+ * Usage:
+ *   cc-lite filter [--cmd '<orig>']        Read stdin → compressed → stdout.
+ *   cc-lite wrap [--stream] <cmd...>       Run cmd, compress its stdout.
+ */
+export {};
+//# sourceMappingURL=lite.d.ts.map

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

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

package/dist/cli/lite.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+/**
+ * context-compress lite CLI — only the filter/wrap commands.
+ *
+ * No MCP server, no SQLite, no better-sqlite3 native bindings. Designed to
+ * be compiled into a single static binary via `bun build --compile` for
+ * RTK-style "curl | sh" install — covers the transparent shell-filter
+ * use case without any Node.js or npm install.
+ *
+ * Usage:
+ *   cc-lite filter [--cmd '<orig>']        Read stdin → compressed → stdout.
+ *   cc-lite wrap [--stream] <cmd...>       Run cmd, compress its stdout.
+ */
+const args = process.argv.slice(2);
+const command = args[0];
+const rest = args.slice(1);
+async function main() {
+    if (command === "filter") {
+        const { runFilter } = await import("./filter.js");
+        return await runFilter(rest);
+    }
+    if (command === "wrap") {
+        const { runWrap } = await import("./filter.js");
+        return await runWrap(rest);
+    }
+    if (command === "--help" || command === "-h" || !command) {
+        process.stderr.write("context-compress lite CLI\n\n" +
+            "  filter [--cmd '<orig>']        stdin → compressed → stdout\n" +
+            "  wrap [--stream] <cmd...>       run cmd, compress stdout, propagate exit code\n");
+        return command ? 0 : 2;
+    }
+    process.stderr.write(`Unknown command: ${command}\n`);
+    return 2;
+}
+main().then((code) => process.exit(code));
+export {};
+//# sourceMappingURL=lite.js.map

package/dist/cli/lite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lite.js","sourceRoot":"","sources":["../../src/cli/lite.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG;AAEH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AACxB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAE3B,KAAK,UAAU,IAAI;IAClB,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAClD,OAAO,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACxB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAChD,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,CACnB,+BAA+B;YAC9B,gEAAgE;YAChE,kFAAkF,CACnF,CAAC;QACF,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,OAAO,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,CAAC;AACV,CAAC;AAED,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC"}

package/dist/cli/setup.d.ts

@@ -1,2 +1,24 @@
-export declare function setup(): Promise<void>;
+interface ClaudeSettings {
+    hooks?: Record<string, Array<{
+        matcher?: string;
+        hooks?: Array<{
+            command?: string;
+            type?: string;
+        }>;
+    }>>;
+    mcpServers?: Record<string, {
+        command: string;
+        args: string[];
+    }>;
+    env?: Record<string, string>;
+    [k: string]: unknown;
+}
+/** Add or replace context-compress entries in settings.json. Returns list of changes made. */
+export declare function applyAutoConfig(settings: ClaudeSettings, paths: {
+    serverEntry: string;
+    hookEntry: string;
+    binPath: string;
+}, filterBash: boolean): string[];
+export declare function setup(args?: string[]): Promise<void>;
+export {};
 //# sourceMappingURL=setup.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAaA,UAAU,cAAc;IACvB,KAAK,CAAC,EAAE,MAAM,CACb,MAAM,EACN,KAAK,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAC;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAC/E,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACrB;AAsCD,8FAA8F;AAC9F,wBAAgB,eAAe,CAC9B,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAClE,UAAU,EAAE,OAAO,GACjB,MAAM,EAAE,CAiDV;AAkCD,wBAAsB,KAAK,CAAC,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAuC9D"}

package/dist/cli/setup.js

@@ -1,43 +1,144 @@
-import { execSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
 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
+/**
+ * Resolve the absolute paths the hook + MCP server need. We support two layouts:
+ *   - Installed npm package: dist/cli/setup.js → ../index.js, ../../hooks/pretooluse.mjs
+ *   - Dev (tsx): src/cli/setup.ts → ../index.js (built) or fall back to src/index.ts
+ */
+function resolvePaths() {
+    const distServer = resolve(__dirname, "..", "index.js");
+    const distHook = resolve(__dirname, "..", "..", "hooks", "pretooluse.mjs");
+    const distCli = resolve(__dirname, "index.js");
+    const srcHook = resolve(__dirname, "..", "hooks", "pretooluse.ts");
+    const srcCli = resolve(__dirname, "index.ts");
+    const serverEntry = existsSync(distServer) ? distServer : resolve(__dirname, "..", "index.ts");
+    const hookEntry = existsSync(distHook) ? distHook : srcHook;
+    const binPath = existsSync(distCli) ? distCli : srcCli;
+    return { serverEntry, hookEntry, binPath };
+}
+function isBuiltJs(p) {
+    return p.endsWith(".js") || p.endsWith(".mjs");
+}
+function readSettings(path) {
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+function writeSettings(path, settings) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(settings, null, 2)}\n`, "utf-8");
+}
+/** Add or replace context-compress entries in settings.json. Returns list of changes made. */
+export function applyAutoConfig(settings, paths, filterBash) {
+    const changes = [];
+    // 1. MCP server registration
+    const serverCmd = isBuiltJs(paths.serverEntry) ? "node" : "tsx";
+    const serverArgs = [paths.serverEntry];
+    settings.mcpServers ??= {};
+    const existing = settings.mcpServers["context-compress"];
+    if (!existing ||
+        existing.command !== serverCmd ||
+        JSON.stringify(existing.args) !== JSON.stringify(serverArgs)) {
+        settings.mcpServers["context-compress"] = { command: serverCmd, args: serverArgs };
+        changes.push(`Registered MCP server (${serverCmd} ${paths.serverEntry})`);
+    }
+    // 2. PreToolUse hook
+    settings.hooks ??= {};
+    settings.hooks.PreToolUse ??= [];
+    const hookCmd = isBuiltJs(paths.hookEntry) ? `node ${paths.hookEntry}` : `tsx ${paths.hookEntry}`;
+    const hookEntries = settings.hooks.PreToolUse;
+    const alreadyInstalled = hookEntries.some((entry) => entry.hooks?.some((h) => h.command?.includes("pretooluse")));
+    if (!alreadyInstalled) {
+        hookEntries.push({
+            matcher: "Bash|Read|Grep|WebFetch|Task",
+            hooks: [{ type: "command", command: hookCmd }],
+        });
+        changes.push(`Installed PreToolUse hook (${hookCmd})`);
+    }
+    // 3. Bash filter mode (opt-in, but on by default with --auto)
+    if (filterBash) {
+        settings.env ??= {};
+        if (settings.env.CONTEXT_COMPRESS_FILTER_BASH !== "1") {
+            settings.env.CONTEXT_COMPRESS_FILTER_BASH = "1";
+            changes.push("Enabled CONTEXT_COMPRESS_FILTER_BASH=1 (transparent Bash compression)");
+        }
+        // Pin CONTEXT_COMPRESS_BIN so the hook knows where to find the wrap command.
+        const binCmd = isBuiltJs(paths.binPath) ? `node ${paths.binPath}` : `tsx ${paths.binPath}`;
+        if (settings.env.CONTEXT_COMPRESS_BIN !== binCmd) {
+            settings.env.CONTEXT_COMPRESS_BIN = binCmd;
+            changes.push(`Set CONTEXT_COMPRESS_BIN to ${binCmd}`);
+        }
+    }
+    return changes;
+}
+function showRuntimes() {
     console.log("  Detecting runtimes...");
+}
+async function showRuntimeReport() {
+    showRuntimes();
     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));
+    const optional = ["python", "ruby", "go", "rust", "php", "perl", "r", "elixir"];
+    const missing = optional.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");
+}
+function showInstructions(serverEntry) {
     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");
+    console.log(`    claude mcp add context-compress -- node ${serverEntry}\n`);
+    console.log("  Or use --auto to do everything automatically:");
+    console.log("    context-compress setup --auto\n");
+}
+export async function setup(args = []) {
+    const opts = {
+        auto: args.includes("--auto"),
+        filterBash: !args.includes("--no-filter-bash"),
+    };
+    console.log("\n  context-compress setup\n");
+    await showRuntimeReport();
+    const paths = resolvePaths();
+    if (!opts.auto) {
+        showInstructions(paths.serverEntry);
+        console.log("  Setup complete!\n");
+        return;
+    }
+    // --auto: write settings.json directly
+    const settingsPath = resolve(homedir(), ".claude", "settings.json");
+    console.log(`  Writing config to ${settingsPath}...`);
+    const settings = readSettings(settingsPath);
+    const changes = applyAutoConfig(settings, paths, opts.filterBash);
+    if (changes.length === 0) {
+        console.log("  Already configured. No changes made.\n");
+    }
+    else {
+        writeSettings(settingsPath, settings);
+        console.log();
+        for (const c of changes)
+            console.log(`  + ${c}`);
+        console.log();
+    }
+    console.log("  Setup complete! Restart Claude Code to load the new configuration.");
+    console.log(opts.filterBash
+        ? "  Bash output for git/npm/cargo/test/find/docker/kubectl/... will be auto-compressed.\n"
+        : "  Tip: pass --filter-bash on next setup to enable transparent Bash compression.\n");
 }
 //# sourceMappingURL=setup.js.map

package/dist/cli/setup.js.map

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

package/dist/executor.d.ts

@@ -1,6 +1,12 @@
 import type { Config } from "./config.js";
 import type { RuntimeMap } from "./runtime/index.js";
 import type { ExecFileOptions, ExecOptions, ExecResult } from "./types.js";
+declare function stripAnsi(str: string): string;
+/**
+ * Strip progress/spinner lines that add no informational value.
+ * Removes: percentage bars, spinner characters, ANSI escape codes, download progress.
+ */
+declare function stripProgressLines(output: string): string;
 /**
  * Deduplicate consecutive repeated lines.
  * Replaces N identical consecutive lines with "line (×N)".
@@ -11,7 +17,7 @@ declare function deduplicateLines(output: string): string;
  * Collapses "ERROR: foo at line 1", "ERROR: foo at line 2" → "ERROR: foo (×2 occurrences, lines: 1, 2)"
  */
 declare function groupErrorLines(output: string): string;
-export { deduplicateLines, groupErrorLines };
+export { deduplicateLines, groupErrorLines, stripAnsi, stripProgressLines };
 export declare class SubprocessExecutor {
     private runtimes;
     private config;

package/dist/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAY,MAAM,YAAY,CAAC;AA2ErF;;;GAGG;AACH,iBAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA+BhD;AAED;;;GAGG;AACH,iBAAS,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA6D/C;AA2CD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAE7C,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,GAAG,CAAyB;IACpC,OAAO,CAAC,eAAe,CAAwD;gBAEnE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM;IAMhD,+DAA+D;IAC/D,QAAQ,IAAI,IAAI;IAWhB;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAyErD;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAsB7D,OAAO,CAAC,eAAe;IAwGvB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,cAAc;CAOtB"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAY,MAAM,YAAY,CAAC;AAUrF,iBAAS,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtC;AAwED;;;GAGG;AACH,iBAAS,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAkBlD;AAED;;;GAGG;AACH,iBAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA+BhD;AAED;;;GAGG;AACH,iBAAS,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA6D/C;AA2CD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;AAE5E,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,GAAG,CAAyB;IACpC,OAAO,CAAC,eAAe,CAAwD;gBAEnE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM;IAMhD,+DAA+D;IAC/D,QAAQ,IAAI,IAAI;IAWhB;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IA0ErD;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAsB7D,OAAO,CAAC,eAAe;IAsHvB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,cAAc;CAOtB"}