@hasna/terminal 2.0.4 → 2.2.0

package/dist/ai.js

@@ -1,368 +0,0 @@
-import { cacheGet, cacheSet } from "./cache.js";
-import { getProvider } from "./providers/index.js";
-import { existsSync, readFileSync } from "fs";
-import { join } from "path";
-// ── model routing ─────────────────────────────────────────────────────────────
-// Simple queries → fast model. Complex/ambiguous → smart model.
-const COMPLEX_SIGNALS = [
-    /\b(undo|revert|rollback|previous|last)\b/i,
-    /\b(all files?|recursively|bulk|batch)\b/i,
-    /\b(pipeline|chain|then|and then|after)\b/i,
-    /\b(if|when|unless|only if)\b/i,
-    /\b(go into|go to|navigate|cd into|enter)\b.*\b(and|then)\b/i, // multi-step navigation
-    /\b(inside|within|under)\b/i, // relative references need context awareness
-    /[|&;]{2}/, // pipes / &&  in NL (unusual = complex intent)
-];
-/** Model routing per provider */
-function pickModel(nl) {
-    const isComplex = COMPLEX_SIGNALS.some((r) => r.test(nl)) || nl.split(" ").length > 10;
-    const provider = getProvider();
-    if (provider.name === "anthropic") {
-        return {
-            fast: "claude-haiku-4-5-20251001",
-            smart: "claude-sonnet-4-6",
-            pick: isComplex ? "smart" : "fast",
-        };
-    }
-    // Cerebras — qwen for everything (llama3.1-8b too unreliable)
-    return {
-        fast: "qwen-3-235b-a22b-instruct-2507",
-        smart: "qwen-3-235b-a22b-instruct-2507",
-        pick: isComplex ? "smart" : "fast",
-    };
-}
-// ── irreversibility ───────────────────────────────────────────────────────────
-const IRREVERSIBLE_PATTERNS = [
-    /\brm\s/, /\brmdir\b/, /\btruncate\b/, /\bdrop\s+table\b/i,
-    /\bdelete\s+from\b/i, /\bmv\b.*\/dev\/null/, /\becho\b.*>\s*[^>]/, /\bcat\b.*>\s*[^>]/,
-    /\bdd\b/, /\bmkfs\b/, /\bformat\b/, /\bshred\b/,
-    // Process/service killing
-    /\bkill\b/, /\bkillall\b/, /\bpkill\b/,
-    // Git push/force operations
-    /\bgit\s+push\b/, /\bgit\s+reset\s+--hard\b/, /\bgit\s+force\b/,
-    // Code modification / package installation (security risk)
-    /\bnpx\s+\S+/, /\bnpm\s+install\b/, /\bbun\s+add\b/, /\bpip\s+install\b/,
-    /\bcodemod\b/, /\bsed\s+-i\b/, /\bawk\s.*>\s*\S+\.\w+/, /\bperl\s+-[pi]\b/,
-    // File creation/modification (READ-ONLY terminal)
-    /\btouch\b/, /\bmkdir\b/, /\becho\s.*>/, /\btee\b/, /\bcp\b/, /\bmv\b/,
-    // Starting servers/processes (dangerous from NL)
-    /\b(bun|npm|pnpm|yarn)\s+run\s+dev\b/, /\b(bun|npm)\s+start\b/,
-];
-// Commands that are ALWAYS safe (read-only git, etc.)
-const SAFE_OVERRIDES = [
-    /^\s*git\s+(log|show|diff|branch|status|blame|tag|remote|stash\s+list)\b/,
-    /^\s*git\s+log\b/,
-    // find -exec with read-only tools is safe
-    /\bfind\b.*-exec\s+(wc|cat|head|tail|grep|stat|file|du|ls)\b/,
-    // find without -exec is always safe
-    /^\s*find\b(?!.*-exec\s+(rm|mv|chmod|chown|sed))/,
-    // xargs with read-only tools is safe
-    /\bxargs\s+(wc|cat|head|tail|grep|stat|file|du|ls|git\s+log|git\s+show|git\s+blame)\b/,
-    /\bxargs\s+-I\s*\S+\s+(wc|cat|head|tail|grep|stat|git)\b/,
-];
-export function isIrreversible(command) {
-    // Safe overrides take priority
-    if (SAFE_OVERRIDES.some((r) => r.test(command)))
-        return false;
-    return IRREVERSIBLE_PATTERNS.some((r) => r.test(command));
-}
-// ── permissions ───────────────────────────────────────────────────────────────
-const DESTRUCTIVE_PATTERNS = [/\brm\b/, /\brmdir\b/, /\btruncate\b/, /\bdrop\s+table\b/i, /\bdelete\s+from\b/i];
-const NETWORK_PATTERNS = [/\bcurl\b/, /\bwget\b/, /\bssh\b/, /\bscp\b/, /\bping\b/, /\bnc\b/, /\bnetcat\b/];
-const SUDO_PATTERNS = [/\bsudo\b/];
-const INSTALL_PATTERNS = [/\bbrew\s+install\b/, /\bnpm\s+install\s+-g\b/, /\bpip\s+install\b/, /\bapt\s+install\b/, /\byum\s+install\b/];
-const WRITE_OUTSIDE_PATTERNS = [/\s(\/etc|\/usr|\/var|\/opt|\/root|~\/[^.])/, />\s*\//];
-export function checkPermissions(command, perms) {
-    if (!perms.destructive && DESTRUCTIVE_PATTERNS.some((r) => r.test(command)))
-        return "destructive commands are disabled";
-    if (!perms.network && NETWORK_PATTERNS.some((r) => r.test(command)))
-        return "network commands are disabled";
-    if (!perms.sudo && SUDO_PATTERNS.some((r) => r.test(command)))
-        return "sudo is disabled";
-    if (!perms.install && INSTALL_PATTERNS.some((r) => r.test(command)))
-        return "package installation is disabled";
-    if (!perms.write_outside_cwd && WRITE_OUTSIDE_PATTERNS.some((r) => r.test(command)))
-        return "writing outside cwd is disabled";
-    return null;
-}
-// ── project context ──────────────────────────────────────────────────────────
-function detectProjectContext() {
-    const cwd = process.cwd();
-    const parts = [];
-    // Node.js / TypeScript
-    const pkgPath = join(cwd, "package.json");
-    if (existsSync(pkgPath)) {
-        try {
-            const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
-            parts.push(`Project: ${pkg.name}@${pkg.version} (Node.js/TypeScript)`);
-            parts.push(`npm package: ${pkg.name} (use this name for npm view, npm info, etc.)`);
-            if (pkg.scripts) {
-                const scripts = Object.entries(pkg.scripts).map(([k, v]) => `${k}: ${v}`).slice(0, 8);
-                parts.push(`Available scripts: ${scripts.join(", ")}`);
-            }
-            if (pkg.dependencies)
-                parts.push(`Dependencies: ${Object.keys(pkg.dependencies).join(", ")}`);
-            parts.push(`Use npm/bun/pnpm commands, NOT maven/gradle/cargo.`);
-        }
-        catch { }
-    }
-    // Python
-    if (existsSync(join(cwd, "pyproject.toml"))) {
-        try {
-            const pyproject = readFileSync(join(cwd, "pyproject.toml"), "utf8");
-            const nameMatch = pyproject.match(/name\s*=\s*"([^"]+)"/);
-            const versionMatch = pyproject.match(/version\s*=\s*"([^"]+)"/);
-            parts.push(`Project: ${nameMatch?.[1] ?? "Python"}${versionMatch ? `@${versionMatch[1]}` : ""} (Python)`);
-        }
-        catch {
-            parts.push("Project: Python (pyproject.toml found)");
-        }
-        parts.push("Use pip/python/pytest commands. Test: pytest. Build: python -m build.");
-    }
-    else if (existsSync(join(cwd, "requirements.txt"))) {
-        parts.push("Project: Python (requirements.txt). Use pip/python/pytest commands.");
-    }
-    // Go
-    if (existsSync(join(cwd, "go.mod"))) {
-        try {
-            const gomod = readFileSync(join(cwd, "go.mod"), "utf8");
-            const moduleMatch = gomod.match(/module\s+(\S+)/);
-            parts.push(`Project: ${moduleMatch?.[1] ?? "Go"} (Go module)`);
-        }
-        catch {
-            parts.push("Project: Go (go.mod found)");
-        }
-        parts.push("Use go build/test/run. Test: go test ./... Build: go build.");
-    }
-    // Rust
-    if (existsSync(join(cwd, "Cargo.toml"))) {
-        try {
-            const cargo = readFileSync(join(cwd, "Cargo.toml"), "utf8");
-            const nameMatch = cargo.match(/name\s*=\s*"([^"]+)"/);
-            const versionMatch = cargo.match(/version\s*=\s*"([^"]+)"/);
-            parts.push(`Project: ${nameMatch?.[1] ?? "Rust"}${versionMatch ? `@${versionMatch[1]}` : ""} (Rust/Cargo)`);
-        }
-        catch {
-            parts.push("Project: Rust (Cargo.toml found)");
-        }
-        parts.push("Use cargo build/test/run. Test: cargo test. Build: cargo build --release.");
-    }
-    // Java
-    if (existsSync(join(cwd, "pom.xml"))) {
-        parts.push("Project: Java/Maven. Use mvn commands. Test: mvn test. Build: mvn package.");
-    }
-    if (existsSync(join(cwd, "build.gradle")) || existsSync(join(cwd, "build.gradle.kts"))) {
-        parts.push("Project: Java/Gradle. Use gradle commands. Test: gradle test. Build: gradle build.");
-    }
-    // Docker
-    if (existsSync(join(cwd, "Dockerfile")) || existsSync(join(cwd, "docker-compose.yml")) || existsSync(join(cwd, "docker-compose.yaml"))) {
-        parts.push("Docker: Dockerfile/docker-compose present. Container commands available.");
-    }
-    // Makefile
-    if (existsSync(join(cwd, "Makefile"))) {
-        try {
-            const { execSync: execS } = require("child_process");
-            const targets = execS("grep -E '^[a-zA-Z_-]+:' Makefile | head -10 | cut -d: -f1", { cwd, encoding: "utf8", timeout: 1000 }).trim();
-            if (targets)
-                parts.push(`Makefile targets: ${targets.split("\n").join(", ")}`);
-        }
-        catch { }
-    }
-    // Directory structure — so AI knows actual paths (not guessed ones)
-    try {
-        const { execSync } = require("child_process");
-        // Top-level dirs
-        const topLevel = execSync("ls -1", { cwd, encoding: "utf8", timeout: 2000 }).trim();
-        parts.push(`Top-level: ${topLevel.split("\n").join(", ")}`);
-        // Detect monorepo (packages/ or workspaces in package.json)
-        const isMonorepo = existsSync(join(cwd, "packages")) || existsSync(join(cwd, "apps"));
-        if (isMonorepo) {
-            const pkgDirs = execSync(`ls -d packages/*/src 2>/dev/null || ls -d apps/*/src 2>/dev/null || echo ""`, { cwd, encoding: "utf8", timeout: 2000 }).trim();
-            if (pkgDirs) {
-                parts.push(`MONOREPO: Source is in packages/*/src/, NOT src/. Search packages/ not src/.`);
-                parts.push(`Package sources:\n${pkgDirs}`);
-            }
-        }
-        // src/ structure — include FILES so AI knows exact filenames + extensions
-        for (const srcDir of isMonorepo ? ["packages"] : ["src", "lib", "app"]) {
-            if (existsSync(join(cwd, srcDir))) {
-                const tree = execSync(`find ${srcDir} -maxdepth ${isMonorepo ? 4 : 3} -not -path '*/node_modules/*' -not -path '*/dist/*' -not -name '*.test.*' -not -name '*.spec.*' 2>/dev/null | sort | head -80`, { cwd, encoding: "utf8", timeout: 3000 }).trim();
-                if (tree)
-                    parts.push(`Files in ${srcDir}/:\n${tree}`);
-                break;
-            }
-        }
-    }
-    catch { /* timeout or no exec — skip */ }
-    return parts.length > 0 ? `\n\nPROJECT CONTEXT:\n${parts.join("\n")}` : "";
-}
-// ── system prompt ─────────────────────────────────────────────────────────────
-function buildSystemPrompt(perms, sessionEntries) {
-    const restrictions = [];
-    if (!perms.destructive)
-        restrictions.push("- NEVER generate commands that delete, remove, or overwrite files/data");
-    if (!perms.network)
-        restrictions.push("- NEVER generate commands that make network requests (curl, wget, ssh, etc.)");
-    if (!perms.sudo)
-        restrictions.push("- NEVER generate commands requiring sudo");
-    if (!perms.write_outside_cwd)
-        restrictions.push("- NEVER write to paths outside the current working directory");
-    if (!perms.install)
-        restrictions.push("- NEVER install packages (brew, npm -g, pip, apt, etc.)");
-    const restrictionBlock = restrictions.length > 0
-        ? `\n\nRESTRICTIONS:\n${restrictions.join("\n")}\nIf restricted, output: BLOCKED: <reason>`
-        : "";
-    let contextBlock = "";
-    if (sessionEntries.length > 0) {
-        const lines = [];
-        for (const e of sessionEntries.slice(-5)) {
-            lines.push(`> ${e.nl}`);
-            lines.push(`$ ${e.cmd}`);
-            if (e.output)
-                lines.push(e.output);
-            if (e.error)
-                lines.push("(command failed)");
-        }
-        contextBlock = `\n\nSESSION HISTORY (user intent > command $ output):\n${lines.join("\n")}`;
-    }
-    const projectContext = detectProjectContext();
-    return `You are a terminal assistant. Output ONLY the exact shell command — no explanation, no markdown, no backticks.
-The user describes what they want in plain English. You translate to the exact shell command.
-
-RULES:
-- When user refers to items from previous output, use the EXACT names shown (e.g., "feature/auth" not "auth", "open-skills" not "open_skills")
-- When user says "the largest/smallest/first/second", look at the previous output to identify the correct item
-- When user says "them all" or "combine them", refer to items from the most recent command output
-- For "show who changed each line" use git blame, for "show remote urls" use git remote -v
-- For text search in code, use grep -rn, NOT nm or objdump (those are for compiled binaries)
-- On macOS: for memory use vm_stat or top -l 1, for disk use df -h, for processes use ps aux
-- macOS uses BSD tools, NOT GNU. Use: du -d 1 (not --max-depth), ls (not ls --color), sort -r (not sort --reverse), ps aux (not ps --sort)
-- NEVER invent commands that don't exist. Stick to standard Unix/macOS commands.
-- NEVER install packages (npx, npm install, pip install, brew install). This is a READ-ONLY terminal.
-- NEVER modify source code (sed -i, codemod, awk with redirect). Only observe, never change.
-- Search src/ directory, NOT dist/ or node_modules/ for code queries.
-- Use exact file paths from the project context below. Do NOT guess paths.
-- For "what would break if I deleted X": use grep -rn "from.*X\\|import.*X\\|require.*X" src/ to find all importers.
-- For "find where X is defined": use grep -rn "export.*function X\\|export.*class X\\|export.*const X" src/
-- For "show me the code of function X": use grep -A 20 "function X" src/ to show the function body.
-- For conceptual questions about what code does: use cat on the relevant file, the AI summary will explain it.
-
-COMPOUND QUESTIONS: For questions asking multiple things, prefer ONE command that captures all info. Extract multiple answers from a single output.
-- "how many tests and do they pass" → bun test (extract count AND pass/fail from output)
-- "what files changed and how many lines" → git log --stat -3 (shows files AND line counts)
-- "what version of node and bun" → node -v && bun -v (only use && for trivial non-failing commands)
-NEVER split into separate test runs or expensive commands chained with &&.
-
-BLOCKED ALTERNATIVES: If your preferred command would require installing packages (npx, npm install), ALWAYS try a READ-ONLY alternative:
-- Code quality analysis → grep -rn "TODO\\|FIXME\\|HACK\\|XXX" src/
-- Linting → check if "lint" or "typecheck" exists in package.json scripts, run that
-- Security scan → grep -rn "eval\\|exec\\|spawn\\|password\\|secret" src/
-- Dependency audit → cat package.json | grep -A 50 dependencies
-- Test coverage → bun test --coverage (or npm run test:coverage if available)
-NEVER give up. Always try a grep/find/cat read-only alternative.
-
-SEMANTIC MAPPING: When the user references a concept, search the file tree for RELATED terms:
-- Look at directory names: src/agent/ likely contains "agentic" code
-- Look at file names: lazy-executor.ts likely handles "lazy mode"
-- When uncertain: grep -rn "keyword" src/ --include="*.ts" -l (list matching files)
-
-ACTION vs CONCEPTUAL: If the prompt starts with "run", "execute", "check", "test", "build", "show output of" — ALWAYS generate an executable command. NEVER read README for action requests. Only read docs for "explain why", "what does X mean", "how was X designed".
-
-EXISTENCE CHECKS: If the prompt starts with "is there", "does this have", "do we have", "does X exist" — NEVER run/start/launch anything. Use ls, find, or test -d to CHECK existence. These are READ-ONLY questions.
-
-MONOREPO: If the project context says "MONOREPO", search packages/ or apps/ NOT src/. Use: grep -rn "pattern" packages/ --include="*.ts". For specific packages, use packages/PKGNAME/src/.
-cwd: ${process.cwd()}
-shell: zsh / macOS${projectContext}${restrictionBlock}${contextBlock}`;
-}
-// ── streaming translate ───────────────────────────────────────────────────────
-export async function translateToCommand(nl, perms, sessionEntries, onToken) {
-    // Only use cache when there's no session context (context makes same NL produce different commands)
-    if (sessionEntries.length === 0) {
-        const cached = cacheGet(nl);
-        if (cached) {
-            onToken?.(cached);
-            return cached;
-        }
-    }
-    const provider = getProvider();
-    const routing = pickModel(nl);
-    const model = routing.pick === "smart" ? routing.smart : routing.fast;
-    const system = buildSystemPrompt(perms, sessionEntries);
-    let text;
-    if (onToken) {
-        text = await provider.stream(nl, { model, maxTokens: 256, system }, {
-            onToken: (partial) => onToken(partial),
-        });
-    }
-    else {
-        text = await provider.complete(nl, { model, maxTokens: 256, system });
-    }
-    if (text.startsWith("BLOCKED:"))
-        throw new Error(text);
-    // Strip AI reasoning — extract ONLY the shell command (first line)
-    let cleaned = text.trim();
-    // Remove ALL markdown code blocks and their content markers
-    cleaned = cleaned.replace(/```(?:bash|sh|shell)?\n?/g, "").replace(/```/g, "");
-    // Split into lines and find the FIRST one that looks like a SHELL COMMAND
-    const lines = cleaned.split("\n");
-    let command = "";
-    for (const line of lines) {
-        const t = line.trim();
-        if (!t)
-            continue;
-        // Skip lines that are clearly English prose, not commands
-        if (/^(Based on|I |This |The |Let me|Here|Note:|Since|Looking|To |However|BLOCKED:|If |You |We |For |It |A |An |That )/.test(t))
-            continue;
-        if (/^[A-Z][a-z].*[.;:!?,]/.test(t))
-            continue; // English sentence with punctuation anywhere
-        if (t.split(" ").length > 15 && !/[|&;><$]/.test(t))
-            continue; // Long line without shell operators = prose
-        // Must start with a plausible command character (lowercase, /, ., $, or common tool)
-        if (/^[a-z./$~(]/.test(t) || /^[A-Z]+[_=]/.test(t)) {
-            command = t;
-            break;
-        }
-    }
-    cleaned = command || lines[0]?.trim() || cleaned;
-    cacheSet(nl, cleaned);
-    return cleaned;
-}
-// ── prefetch ──────────────────────────────────────────────────────────────────
-export function prefetchNext(lastNl, perms, sessionEntries) {
-    if (sessionEntries.length === 0 && cacheGet(lastNl))
-        return;
-    translateToCommand(lastNl, perms, sessionEntries).catch(() => { });
-}
-// ── explain ───────────────────────────────────────────────────────────────────
-export async function explainCommand(command) {
-    const provider = getProvider();
-    const routing = pickModel("explain"); // simple = fast model
-    return provider.complete(command, {
-        model: routing.fast,
-        maxTokens: 128,
-        system: "Explain what this shell command does in one plain English sentence. No markdown, no code blocks.",
-    });
-}
-// ── auto-fix ──────────────────────────────────────────────────────────────────
-export async function fixCommand(originalNl, failedCommand, errorOutput, perms, sessionEntries) {
-    const provider = getProvider();
-    const routing = pickModel(originalNl);
-    const text = await provider.complete(`I wanted to: ${originalNl}\nI ran: ${failedCommand}\nError:\n${errorOutput}\n\nGive me the corrected command only.`, {
-        model: routing.smart, // always use smart model for fixes
-        maxTokens: 256,
-        system: buildSystemPrompt(perms, sessionEntries),
-    });
-    if (text.startsWith("BLOCKED:"))
-        throw new Error(text);
-    return text;
-}
-// ── summarize output (for MCP/agent use) ──────────────────────────────────────
-export async function summarizeOutput(command, output, maxTokens = 200) {
-    const provider = getProvider();
-    const routing = pickModel("summarize");
-    return provider.complete(`Command: ${command}\nOutput:\n${output}\n\nSummarize this output concisely for an AI agent. Focus on: status, key results, errors. Be terse.`, {
-        model: routing.fast,
-        maxTokens,
-        system: "You summarize command output for AI agents. Be extremely concise. Return structured info. No prose.",
-    });
-}

package/dist/cache.js

@@ -1,41 +0,0 @@
-// In-memory LRU cache + disk persistence for command translations
-import { existsSync, readFileSync, writeFileSync } from "fs";
-import { homedir } from "os";
-import { join } from "path";
-const CACHE_FILE = join(homedir(), ".terminal", "cache.json");
-const MAX_ENTRIES = 500;
-let mem = {};
-export function loadCache() {
-    if (!existsSync(CACHE_FILE))
-        return;
-    try {
-        mem = JSON.parse(readFileSync(CACHE_FILE, "utf8"));
-    }
-    catch { }
-}
-function persistCache() {
-    try {
-        writeFileSync(CACHE_FILE, JSON.stringify(mem));
-    }
-    catch { }
-}
-/** Normalize a natural language query for cache lookup */
-export function normalizeNl(nl) {
-    return nl
-        .toLowerCase()
-        .trim()
-        .replace(/[^a-z0-9\s]/g, "") // strip punctuation
-        .replace(/\s+/g, " ");
-}
-export function cacheGet(nl) {
-    return mem[normalizeNl(nl)] ?? null;
-}
-export function cacheSet(nl, command) {
-    const key = normalizeNl(nl);
-    // evict oldest if full
-    const keys = Object.keys(mem);
-    if (keys.length >= MAX_ENTRIES)
-        delete mem[keys[0]];
-    mem[key] = command;
-    persistCache();
-}

package/dist/command-rewriter.js

@@ -1,64 +0,0 @@
-// Command rewriter — auto-optimize commands to produce less output
-// Only rewrites when semantic result is identical
-const rules = [
-    // find | grep -v node_modules → find -not -path
-    {
-        pattern: /find\s+(\S+)\s+(.*?)\|\s*grep\s+-v\s+node_modules/,
-        rewrite: (m, cmd) => cmd.replace(m[0], `find ${m[1]} ${m[2]}-not -path '*/node_modules/*'`),
-        reason: "avoid pipe, filter in-kernel",
-    },
-    // cat file | grep X → grep X file
-    {
-        pattern: /cat\s+(\S+)\s*\|\s*grep\s+(.*)/,
-        rewrite: (m) => `grep ${m[2]} ${m[1]}`,
-        reason: "useless cat",
-    },
-    // find without node_modules exclusion → add it
-    {
-        pattern: /^find\s+\.\s+(.*)(?!.*node_modules)/,
-        rewrite: (m, cmd) => {
-            if (cmd.includes("node_modules") || cmd.includes("-not -path"))
-                return cmd;
-            return cmd.replace(/^find\s+\.\s+/, "find . -not -path '*/node_modules/*' -not -path '*/.git/*' ");
-        },
-        reason: "auto-exclude node_modules and .git",
-    },
-    // git log without limit → add --oneline -20
-    {
-        pattern: /^git\s+log\s*$/,
-        rewrite: () => "git log --oneline -20",
-        reason: "prevent unbounded log output",
-    },
-    // git diff without stat → add --stat for overview
-    {
-        pattern: /^git\s+diff\s*$/,
-        rewrite: () => "git diff --stat",
-        reason: "stat overview is usually sufficient",
-    },
-    // npm ls without depth → add --depth=0
-    {
-        pattern: /^npm\s+ls\s*$/,
-        rewrite: () => "npm ls --depth=0",
-        reason: "full tree is massive, top-level usually enough",
-    },
-    // ps aux without filter → sort by memory and head (macOS compatible)
-    {
-        pattern: /^ps\s+aux\s*$/,
-        rewrite: () => "ps aux | sort -k4 -rn | head -20",
-        reason: "full process list is noise, show top consumers",
-    },
-];
-/** Rewrite a command to produce less output */
-export function rewriteCommand(cmd) {
-    const trimmed = cmd.trim();
-    for (const rule of rules) {
-        const match = trimmed.match(rule.pattern);
-        if (match) {
-            const rewritten = rule.rewrite(match, trimmed);
-            if (rewritten !== trimmed) {
-                return { original: trimmed, rewritten, changed: true, reason: rule.reason };
-            }
-        }
-    }
-    return { original: trimmed, rewritten: trimmed, changed: false };
-}

package/dist/command-validator.js

@@ -1,77 +0,0 @@
-// Command validator — catch invalid commands BEFORE executing
-// Prevents shell errors from hallucinated flags, wrong paths, bad syntax
-import { existsSync } from "fs";
-import { join } from "path";
-/** Extract file paths referenced in a command */
-function extractPaths(command) {
-    const paths = [];
-    // Match quoted paths
-    const quoted = command.match(/["']([^"']+\.\w+)["']/g);
-    if (quoted)
-        paths.push(...quoted.map(q => q.replace(/["']/g, "")));
-    // Match unquoted paths with extensions or directory separators
-    const tokens = command.split(/\s+/);
-    for (const t of tokens) {
-        if (t.includes("/") && !t.startsWith("-") && !t.startsWith("|") && !t.startsWith("&")) {
-            // Clean shell operators from end
-            const clean = t.replace(/[;|&>]+$/, "");
-            if (clean && !clean.startsWith("-"))
-                paths.push(clean);
-        }
-    }
-    return [...new Set(paths)];
-}
-/** Check for obviously broken shell syntax */
-function checkSyntax(command) {
-    const issues = [];
-    // Unmatched quotes
-    const singleQuotes = (command.match(/'/g) || []).length;
-    const doubleQuotes = (command.match(/"/g) || []).length;
-    if (singleQuotes % 2 !== 0)
-        issues.push("unmatched single quote");
-    if (doubleQuotes % 2 !== 0)
-        issues.push("unmatched double quote");
-    // Unmatched parentheses
-    const openParens = (command.match(/\(/g) || []).length;
-    const closeParens = (command.match(/\)/g) || []).length;
-    if (openParens !== closeParens)
-        issues.push("unmatched parentheses");
-    // Empty pipe targets
-    if (/\|\s*$/.test(command))
-        issues.push("pipe with no target");
-    if (/^\s*\|/.test(command))
-        issues.push("pipe with no source");
-    return issues;
-}
-/** Validate a command before execution */
-export function validateCommand(command, cwd) {
-    const issues = [];
-    // Check syntax
-    issues.push(...checkSyntax(command));
-    // Check file paths exist
-    const paths = extractPaths(command);
-    for (const p of paths) {
-        const fullPath = p.startsWith("/") ? p : join(cwd, p);
-        if (p.includes("*") || p.includes("?"))
-            continue; // skip globs
-        if (p.startsWith("-"))
-            continue; // skip flags
-        if ([".", "..", "/", "~"].includes(p))
-            continue; // skip special
-        if (!existsSync(fullPath) && !existsSync(p)) {
-            // Only flag source file paths, not output paths
-            if (/\.(ts|tsx|js|jsx|json|md|yaml|yml|py|go|rs)$/.test(p)) {
-                issues.push(`file not found: ${p}`);
-            }
-        }
-    }
-    // Check for common GNU flags on macOS
-    const gnuFlags = command.match(/--max-depth|--color=|--sort=|--field-type|--no-deps/g);
-    if (gnuFlags) {
-        issues.push(`GNU flag on macOS: ${gnuFlags.join(", ")}`);
-    }
-    return {
-        valid: issues.length === 0,
-        issues,
-    };
-}

package/dist/compression.js

@@ -1,107 +0,0 @@
-// Token compression engine — reduces CLI output to fit within token budgets
-import { parseOutput, estimateTokens, tokenSavings } from "./parsers/index.js";
-/** Strip ANSI escape codes from text */
-export function stripAnsi(text) {
-    // eslint-disable-next-line no-control-regex
-    return text.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, "").replace(/\x1b\][^\x07]*\x07/g, "");
-}
-/** Deduplicate consecutive similar lines (e.g., "Compiling X... Compiling Y...") */
-function deduplicateLines(lines) {
-    if (lines.length <= 3)
-        return lines;
-    const result = [];
-    let repeatCount = 0;
-    let repeatPattern = "";
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        // Extract a "pattern" — the line without numbers, paths, specific identifiers
-        const pattern = line.replace(/[0-9]+/g, "N").replace(/\/\S+/g, "/PATH").replace(/\s+/g, " ").trim();
-        if (pattern === repeatPattern) {
-            repeatCount++;
-        }
-        else {
-            if (repeatCount > 2) {
-                result.push(`  ... (${repeatCount} similar lines)`);
-            }
-            else if (repeatCount > 0) {
-                // Push the skipped lines back
-                for (let j = i - repeatCount; j < i; j++) {
-                    result.push(lines[j]);
-                }
-            }
-            result.push(line);
-            repeatPattern = pattern;
-            repeatCount = 0;
-        }
-    }
-    if (repeatCount > 2) {
-        result.push(`  ... (${repeatCount} similar lines)`);
-    }
-    else {
-        for (let j = lines.length - repeatCount; j < lines.length; j++) {
-            result.push(lines[j]);
-        }
-    }
-    return result;
-}
-/** Smart truncation: keep first N + last M lines */
-function smartTruncate(text, maxTokens) {
-    const lines = text.split("\n");
-    const currentTokens = estimateTokens(text);
-    if (currentTokens <= maxTokens)
-        return text;
-    // Keep proportional first/last, with first getting more
-    const targetLines = Math.floor((maxTokens * lines.length) / currentTokens);
-    const firstCount = Math.ceil(targetLines * 0.6);
-    const lastCount = Math.floor(targetLines * 0.4);
-    if (firstCount + lastCount >= lines.length)
-        return text;
-    const first = lines.slice(0, firstCount);
-    const last = lines.slice(-lastCount);
-    const hiddenCount = lines.length - firstCount - lastCount;
-    return [...first, `\n--- ${hiddenCount} lines hidden ---\n`, ...last].join("\n");
-}
-/** Compress command output to fit within a token budget */
-export function compress(command, output, options = {}) {
-    const { maxTokens, format = "text", stripAnsi: doStrip = true } = options;
-    const originalTokens = estimateTokens(output);
-    // Step 1: Strip ANSI codes
-    let text = doStrip ? stripAnsi(output) : output;
-    // Step 2: Try structured parsing (format=json or when it saves tokens)
-    if (format === "json" || format === "summary") {
-        const parsed = parseOutput(command, text);
-        if (parsed) {
-            const json = JSON.stringify(parsed.data, null, format === "summary" ? 0 : 2);
-            const savings = tokenSavings(output, parsed.data);
-            const compressedTokens = estimateTokens(json);
-            // ONLY use JSON if it actually saves tokens (never return larger output)
-            if (savings.saved > 0 && (!maxTokens || compressedTokens <= maxTokens)) {
-                return {
-                    content: json,
-                    format: "json",
-                    originalTokens,
-                    compressedTokens,
-                    tokensSaved: savings.saved,
-                    savingsPercent: savings.percent,
-                };
-            }
-        }
-    }
-    // Step 3: Deduplicate similar lines
-    const lines = text.split("\n");
-    const deduped = deduplicateLines(lines);
-    text = deduped.join("\n");
-    // Step 4: Smart truncation if over budget
-    if (maxTokens) {
-        text = smartTruncate(text, maxTokens);
-    }
-    const compressedTokens = estimateTokens(text);
-    return {
-        content: text,
-        format: "text",
-        originalTokens,
-        compressedTokens,
-        tokensSaved: Math.max(0, originalTokens - compressedTokens),
-        savingsPercent: originalTokens > 0 ? Math.round(((originalTokens - compressedTokens) / originalTokens) * 100) : 0,
-    };
-}