kirograph 0.13.1 → 0.14.1

package/dist/bin/commands/exec.js

@@ -0,0 +1,107 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var exec_exports = {};
+__export(exec_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(exec_exports);
+var import_child_process = require("child_process");
+var import_compression = require("../../compression/index");
+var import_tracker = require("../../compression/tracker");
+var import_config = require("../../config");
+var import_ui = require("../ui");
+function register(program) {
+  program.command("exec").description("Run a shell command and return token-optimized output").option("-l, --level <level>", "Compression level: normal, aggressive, ultra").option("-t, --timeout <seconds>", "Timeout in seconds", "60").option("--raw", "Also print the raw output for comparison").option("--json", "Output result as JSON").allowUnknownOption(true).allowExcessArguments(true).action(async (opts, cmd) => {
+    const args = cmd.args;
+    if (args.length === 0) {
+      console.error("  Usage: kirograph exec <command...>");
+      console.error("  Example: kirograph exec git status");
+      process.exit(1);
+    }
+    const shellCommand = args.join(" ");
+    const cwd = process.cwd();
+    const timeout = (parseInt(opts.timeout || "60", 10) || 60) * 1e3;
+    let defaultLevel = "normal";
+    try {
+      const config = await (0, import_config.loadConfig)(cwd);
+      if (config.shellCompressionLevel && config.shellCompressionLevel !== "off") {
+        defaultLevel = config.shellCompressionLevel;
+      }
+    } catch {
+    }
+    const level = opts.level || defaultLevel;
+    const validLevels = ["normal", "aggressive", "ultra"];
+    if (!validLevels.includes(level)) {
+      console.error(`  Unknown level: ${level}. Choose from: normal, aggressive, ultra`);
+      process.exit(1);
+    }
+    let rawOutput;
+    let exitCode = 0;
+    try {
+      rawOutput = (0, import_child_process.execSync)(shellCommand, {
+        cwd,
+        timeout,
+        encoding: "utf8",
+        stdio: ["pipe", "pipe", "pipe"],
+        maxBuffer: 10 * 1024 * 1024
+      });
+    } catch (err) {
+      rawOutput = (err.stdout || "") + (err.stderr || "");
+      exitCode = err.status ?? 1;
+    }
+    const result = (0, import_compression.compress)(shellCommand, rawOutput, { level, preserveErrors: exitCode !== 0 });
+    const tracker = new import_tracker.TokenTracker(cwd);
+    tracker.record(shellCommand, result.originalTokens, result.compressedTokens, result.strategy);
+    if (opts.json) {
+      console.log(JSON.stringify({
+        command: shellCommand,
+        exitCode,
+        level,
+        strategy: result.strategy,
+        commandFamily: result.commandFamily,
+        originalTokens: result.originalTokens,
+        compressedTokens: result.compressedTokens,
+        savings: result.savings,
+        output: result.output
+      }, null, 2));
+      process.exit(exitCode);
+      return;
+    }
+    if (opts.raw) {
+      console.log(`${import_ui.dim}\u2500\u2500 raw (${result.originalTokens} tokens) \u2500\u2500${import_ui.reset}`);
+      console.log(rawOutput);
+      console.log(`${import_ui.dim}\u2500\u2500 compressed (${result.compressedTokens} tokens) \u2500\u2500${import_ui.reset}`);
+    }
+    if (exitCode !== 0) {
+      process.stderr.write(result.output + "\n");
+    } else {
+      console.log(result.output);
+    }
+    if (result.savings > 5) {
+      console.log(`
+${import_ui.dim}[${import_ui.green}${result.savings}% saved${import_ui.reset}${import_ui.dim} | ${result.originalTokens}\u2192${result.compressedTokens} tokens | ${import_ui.violet}${result.strategy}${import_ui.reset}${import_ui.dim}]${import_ui.reset}`);
+    }
+    process.exit(exitCode);
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=exec.js.map

package/dist/bin/commands/exec.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/exec.ts"],
+  "sourcesContent": ["/**\n * kirograph exec <command...> \u2014 Run a shell command with token-optimized output\n *\n * Examples:\n *   kirograph exec git status\n *   kirograph exec --level aggressive npm test\n *   kirograph exec -l ultra ls -la src/\n */\n\nimport { Command } from 'commander';\nimport { execSync } from 'child_process';\nimport { compress } from '../../compression/index';\nimport { TokenTracker } from '../../compression/tracker';\nimport { loadConfig } from '../../config';\nimport { dim, green, reset, violet } from '../ui';\n\nexport function register(program: Command): void {\n  program\n    .command('exec')\n    .description('Run a shell command and return token-optimized output')\n    .option('-l, --level <level>', 'Compression level: normal, aggressive, ultra')\n    .option('-t, --timeout <seconds>', 'Timeout in seconds', '60')\n    .option('--raw', 'Also print the raw output for comparison')\n    .option('--json', 'Output result as JSON')\n    .allowUnknownOption(true)\n    .allowExcessArguments(true)\n    .action(async (opts: { level?: string; timeout?: string; raw?: boolean; json?: boolean }, cmd: Command) => {\n      // Everything after \"exec\" and known options is the command to run\n      const args = cmd.args;\n      if (args.length === 0) {\n        console.error('  Usage: kirograph exec <command...>');\n        console.error('  Example: kirograph exec git status');\n        process.exit(1);\n      }\n\n      const shellCommand = args.join(' ');\n      const cwd = process.cwd();\n      const timeout = (parseInt(opts.timeout || '60', 10) || 60) * 1000;\n\n      // Read default level from config\n      let defaultLevel: 'normal' | 'aggressive' | 'ultra' = 'normal';\n      try {\n        const config = await loadConfig(cwd);\n        if (config.shellCompressionLevel && config.shellCompressionLevel !== 'off') {\n          defaultLevel = config.shellCompressionLevel as 'normal' | 'aggressive' | 'ultra';\n        }\n      } catch { /* no config */ }\n\n      const level = (opts.level as 'normal' | 'aggressive' | 'ultra') || defaultLevel;\n      const validLevels = ['normal', 'aggressive', 'ultra'];\n      if (!validLevels.includes(level)) {\n        console.error(`  Unknown level: ${level}. Choose from: normal, aggressive, ultra`);\n        process.exit(1);\n      }\n\n      // Execute the command\n      let rawOutput: string;\n      let exitCode = 0;\n      try {\n        rawOutput = execSync(shellCommand, {\n          cwd,\n          timeout,\n          encoding: 'utf8',\n          stdio: ['pipe', 'pipe', 'pipe'],\n          maxBuffer: 10 * 1024 * 1024,\n        });\n      } catch (err: any) {\n        rawOutput = (err.stdout || '') + (err.stderr || '');\n        exitCode = err.status ?? 1;\n      }\n\n      // Compress\n      const result = compress(shellCommand, rawOutput, { level, preserveErrors: exitCode !== 0 });\n\n      // Track savings\n      const tracker = new TokenTracker(cwd);\n      tracker.record(shellCommand, result.originalTokens, result.compressedTokens, result.strategy);\n\n      // Output\n      if (opts.json) {\n        console.log(JSON.stringify({\n          command: shellCommand,\n          exitCode,\n          level,\n          strategy: result.strategy,\n          commandFamily: result.commandFamily,\n          originalTokens: result.originalTokens,\n          compressedTokens: result.compressedTokens,\n          savings: result.savings,\n          output: result.output,\n        }, null, 2));\n        process.exit(exitCode);\n        return;\n      }\n\n      if (opts.raw) {\n        console.log(`${dim}\u2500\u2500 raw (${result.originalTokens} tokens) \u2500\u2500${reset}`);\n        console.log(rawOutput);\n        console.log(`${dim}\u2500\u2500 compressed (${result.compressedTokens} tokens) \u2500\u2500${reset}`);\n      }\n\n      // Print compressed output\n      if (exitCode !== 0) {\n        process.stderr.write(result.output + '\\n');\n      } else {\n        console.log(result.output);\n      }\n\n      // Print savings footer\n      if (result.savings > 5) {\n        console.log(`\\n${dim}[${green}${result.savings}% saved${reset}${dim} | ${result.originalTokens}\u2192${result.compressedTokens} tokens | ${violet}${result.strategy}${reset}${dim}]${reset}`);\n      }\n\n      process.exit(exitCode);\n    });\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAUA,2BAAyB;AACzB,yBAAyB;AACzB,qBAA6B;AAC7B,oBAA2B;AAC3B,gBAA0C;AAEnC,SAAS,SAAS,SAAwB;AAC/C,UACG,QAAQ,MAAM,EACd,YAAY,uDAAuD,EACnE,OAAO,uBAAuB,8CAA8C,EAC5E,OAAO,2BAA2B,sBAAsB,IAAI,EAC5D,OAAO,SAAS,0CAA0C,EAC1D,OAAO,UAAU,uBAAuB,EACxC,mBAAmB,IAAI,EACvB,qBAAqB,IAAI,EACzB,OAAO,OAAO,MAA2E,QAAiB;AAEzG,UAAM,OAAO,IAAI;AACjB,QAAI,KAAK,WAAW,GAAG;AACrB,cAAQ,MAAM,sCAAsC;AACpD,cAAQ,MAAM,sCAAsC;AACpD,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,UAAM,eAAe,KAAK,KAAK,GAAG;AAClC,UAAM,MAAM,QAAQ,IAAI;AACxB,UAAM,WAAW,SAAS,KAAK,WAAW,MAAM,EAAE,KAAK,MAAM;AAG7D,QAAI,eAAkD;AACtD,QAAI;AACF,YAAM,SAAS,UAAM,0BAAW,GAAG;AACnC,UAAI,OAAO,yBAAyB,OAAO,0BAA0B,OAAO;AAC1E,uBAAe,OAAO;AAAA,MACxB;AAAA,IACF,QAAQ;AAAA,IAAkB;AAE1B,UAAM,QAAS,KAAK,SAA+C;AACnE,UAAM,cAAc,CAAC,UAAU,cAAc,OAAO;AACpD,QAAI,CAAC,YAAY,SAAS,KAAK,GAAG;AAChC,cAAQ,MAAM,oBAAoB,KAAK,0CAA0C;AACjF,cAAQ,KAAK,CAAC;AAAA,IAChB;AAGA,QAAI;AACJ,QAAI,WAAW;AACf,QAAI;AACF,sBAAY,+BAAS,cAAc;AAAA,QACjC;AAAA,QACA;AAAA,QACA,UAAU;AAAA,QACV,OAAO,CAAC,QAAQ,QAAQ,MAAM;AAAA,QAC9B,WAAW,KAAK,OAAO;AAAA,MACzB,CAAC;AAAA,IACH,SAAS,KAAU;AACjB,mBAAa,IAAI,UAAU,OAAO,IAAI,UAAU;AAChD,iBAAW,IAAI,UAAU;AAAA,IAC3B;AAGA,UAAM,aAAS,6BAAS,cAAc,WAAW,EAAE,OAAO,gBAAgB,aAAa,EAAE,CAAC;AAG1F,UAAM,UAAU,IAAI,4BAAa,GAAG;AACpC,YAAQ,OAAO,cAAc,OAAO,gBAAgB,OAAO,kBAAkB,OAAO,QAAQ;AAG5F,QAAI,KAAK,MAAM;AACb,cAAQ,IAAI,KAAK,UAAU;AAAA,QACzB,SAAS;AAAA,QACT;AAAA,QACA;AAAA,QACA,UAAU,OAAO;AAAA,QACjB,eAAe,OAAO;AAAA,QACtB,gBAAgB,OAAO;AAAA,QACvB,kBAAkB,OAAO;AAAA,QACzB,SAAS,OAAO;AAAA,QAChB,QAAQ,OAAO;AAAA,MACjB,GAAG,MAAM,CAAC,CAAC;AACX,cAAQ,KAAK,QAAQ;AACrB;AAAA,IACF;AAEA,QAAI,KAAK,KAAK;AACZ,cAAQ,IAAI,GAAG,aAAG,qBAAW,OAAO,cAAc,wBAAc,eAAK,EAAE;AACvE,cAAQ,IAAI,SAAS;AACrB,cAAQ,IAAI,GAAG,aAAG,4BAAkB,OAAO,gBAAgB,wBAAc,eAAK,EAAE;AAAA,IAClF;AAGA,QAAI,aAAa,GAAG;AAClB,cAAQ,OAAO,MAAM,OAAO,SAAS,IAAI;AAAA,IAC3C,OAAO;AACL,cAAQ,IAAI,OAAO,MAAM;AAAA,IAC3B;AAGA,QAAI,OAAO,UAAU,GAAG;AACtB,cAAQ,IAAI;AAAA,EAAK,aAAG,IAAI,eAAK,GAAG,OAAO,OAAO,UAAU,eAAK,GAAG,aAAG,MAAM,OAAO,cAAc,SAAI,OAAO,gBAAgB,aAAa,gBAAM,GAAG,OAAO,QAAQ,GAAG,eAAK,GAAG,aAAG,IAAI,eAAK,EAAE;AAAA,IACzL;AAEA,YAAQ,KAAK,QAAQ;AAAA,EACvB,CAAC;AACL;",
+  "names": []
+}

package/dist/bin/commands/gain.js

@@ -0,0 +1,119 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var gain_exports = {};
+__export(gain_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(gain_exports);
+function register(program) {
+  program.command("gain").description("Show token savings from kirograph_exec compression").option("--graph", "Show ASCII graph of daily savings").option("--history", "Show recent command history").option("--daily", "Show day-by-day breakdown").option("--period <period>", "Time period: session, today, week, all", "all").option("--json", "Output as JSON").action(async (opts) => {
+    const { TokenTracker } = await Promise.resolve().then(() => require("../../compression/tracker.js"));
+    const tracker = new TokenTracker(process.cwd());
+    if (opts.history) {
+      const history = tracker.getHistory(20);
+      if (history.length === 0) {
+        console.log("  No commands recorded yet. Use kirograph_exec to run commands with compression.");
+        return;
+      }
+      if (opts.json) {
+        console.log(JSON.stringify(history, null, 2));
+        return;
+      }
+      console.log("  Recent compressed commands:\n");
+      for (const r of history) {
+        const date = new Date(r.timestamp).toLocaleString();
+        const savings = r.originalTokens > 0 ? Math.round((r.originalTokens - r.compressedTokens) / r.originalTokens * 100) : 0;
+        const cmd = r.command.length > 50 ? r.command.slice(0, 47) + "..." : r.command;
+        console.log(`  ${date}  ${cmd.padEnd(50)}  ${savings}% saved  (${r.strategy})`);
+      }
+      return;
+    }
+    if (opts.daily || opts.graph) {
+      const daily = tracker.getDailyBreakdown(30);
+      if (daily.length === 0) {
+        console.log("  No data yet.");
+        return;
+      }
+      if (opts.json) {
+        console.log(JSON.stringify(daily, null, 2));
+        return;
+      }
+      if (opts.graph) {
+        console.log("  Token savings (last 30 days):\n");
+        const maxSaved = Math.max(...daily.map((d) => d.saved), 1);
+        const barWidth = 40;
+        for (const day of daily) {
+          const bar = "\u2588".repeat(Math.round(day.saved / maxSaved * barWidth));
+          const label = day.date.slice(5);
+          console.log(`  ${label} ${bar} ${day.saved.toLocaleString()} tokens (${day.commands} cmds)`);
+        }
+        return;
+      }
+      console.log("  Daily breakdown:\n");
+      console.log("  Date        Commands  Tokens Saved");
+      console.log("  " + "\u2500".repeat(40));
+      for (const day of daily) {
+        console.log(`  ${day.date}  ${String(day.commands).padStart(8)}  ${day.saved.toLocaleString().padStart(12)}`);
+      }
+      return;
+    }
+    const period = opts.period;
+    const stats = tracker.getStats(period);
+    if (stats.totalCommands === 0) {
+      console.log("  No savings recorded yet.");
+      console.log("  Use kirograph tools and kirograph exec . Savings are tracked automatically.");
+      return;
+    }
+    if (opts.json) {
+      console.log(JSON.stringify(stats, null, 2));
+      return;
+    }
+    console.log(`
+  Token Savings (${period}):`);
+    console.log(`  ${"\u2500".repeat(50)}`);
+    console.log(`  Total calls:              ${stats.totalCommands}`);
+    console.log(`  Tokens without KiroGraph: ~${stats.totalOriginal.toLocaleString()}`);
+    console.log(`  Tokens with KiroGraph:    ~${stats.totalCompressed.toLocaleString()}`);
+    console.log(`  Saved:                    ~${stats.totalSaved.toLocaleString()} (${stats.savingsPercent}%)`);
+    if (stats.bySource.exec.count > 0 || stats.bySource.graph.count > 0) {
+      console.log(`
+  By source:`);
+      if (stats.bySource.graph.count > 0) {
+        console.log(`    \u{1F4CA} Graph tools:  ${String(stats.bySource.graph.count).padStart(4)} calls  ~${stats.bySource.graph.saved.toLocaleString()} tokens saved (vs file reads/grep)`);
+      }
+      if (stats.bySource.exec.count > 0) {
+        console.log(`    \u26A1 Compression:  ${String(stats.bySource.exec.count).padStart(4)} calls  ~${stats.bySource.exec.saved.toLocaleString()} tokens saved (vs raw output)`);
+      }
+    }
+    if (Object.keys(stats.byFamily).length > 0) {
+      console.log(`
+  By family:`);
+      for (const [family, data] of Object.entries(stats.byFamily)) {
+        const icon = family.startsWith("graph") ? "\u{1F4CA}" : "\u26A1";
+        console.log(`    ${icon} ${family.padEnd(20)} ${String(data.count).padStart(4)} calls  ${data.savings}% avg savings`);
+      }
+    }
+    console.log();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=gain.js.map

package/dist/bin/commands/gain.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/gain.ts"],
+  "sourcesContent": ["/**\n * kirograph gain \u2014 Token savings analytics CLI command\n */\n\nimport { Command } from 'commander';\n\nexport function register(program: Command): void {\n  program\n    .command('gain')\n    .description('Show token savings from kirograph_exec compression')\n    .option('--graph', 'Show ASCII graph of daily savings')\n    .option('--history', 'Show recent command history')\n    .option('--daily', 'Show day-by-day breakdown')\n    .option('--period <period>', 'Time period: session, today, week, all', 'all')\n    .option('--json', 'Output as JSON')\n    .action(async (opts: { graph?: boolean; history?: boolean; daily?: boolean; period: string; json?: boolean }) => {\n      const { TokenTracker } = await Promise.resolve().then(() => require('../../compression/tracker.js'));\n      const tracker = new TokenTracker(process.cwd());\n\n      if (opts.history) {\n        const history = tracker.getHistory(20);\n        if (history.length === 0) {\n          console.log('  No commands recorded yet. Use kirograph_exec to run commands with compression.');\n          return;\n        }\n\n        if (opts.json) {\n          console.log(JSON.stringify(history, null, 2));\n          return;\n        }\n\n        console.log('  Recent compressed commands:\\n');\n        for (const r of history) {\n          const date = new Date(r.timestamp).toLocaleString();\n          const savings = r.originalTokens > 0\n            ? Math.round(((r.originalTokens - r.compressedTokens) / r.originalTokens) * 100)\n            : 0;\n          const cmd = r.command.length > 50 ? r.command.slice(0, 47) + '...' : r.command;\n          console.log(`  ${date}  ${cmd.padEnd(50)}  ${savings}% saved  (${r.strategy})`);\n        }\n        return;\n      }\n\n      if (opts.daily || opts.graph) {\n        const daily = tracker.getDailyBreakdown(30);\n        if (daily.length === 0) {\n          console.log('  No data yet.');\n          return;\n        }\n\n        if (opts.json) {\n          console.log(JSON.stringify(daily, null, 2));\n          return;\n        }\n\n        if (opts.graph) {\n          console.log('  Token savings (last 30 days):\\n');\n          const maxSaved = Math.max(...daily.map(d => d.saved), 1);\n          const barWidth = 40;\n\n          for (const day of daily) {\n            const bar = '\u2588'.repeat(Math.round((day.saved / maxSaved) * barWidth));\n            const label = day.date.slice(5); // MM-DD\n            console.log(`  ${label} ${bar} ${day.saved.toLocaleString()} tokens (${day.commands} cmds)`);\n          }\n          return;\n        }\n\n        console.log('  Daily breakdown:\\n');\n        console.log('  Date        Commands  Tokens Saved');\n        console.log('  ' + '\u2500'.repeat(40));\n        for (const day of daily) {\n          console.log(`  ${day.date}  ${String(day.commands).padStart(8)}  ${day.saved.toLocaleString().padStart(12)}`);\n        }\n        return;\n      }\n\n      // Default: summary stats\n      const period = opts.period as 'session' | 'today' | 'week' | 'all';\n      const stats = tracker.getStats(period);\n\n      if (stats.totalCommands === 0) {\n        console.log('  No savings recorded yet.');\n        console.log('  Use kirograph tools and kirograph exec . Savings are tracked automatically.');\n        return;\n      }\n\n      if (opts.json) {\n        console.log(JSON.stringify(stats, null, 2));\n        return;\n      }\n\n      console.log(`\\n  Token Savings (${period}):`);\n      console.log(`  ${'\u2500'.repeat(50)}`);\n      console.log(`  Total calls:              ${stats.totalCommands}`);\n      console.log(`  Tokens without KiroGraph: ~${stats.totalOriginal.toLocaleString()}`);\n      console.log(`  Tokens with KiroGraph:    ~${stats.totalCompressed.toLocaleString()}`);\n      console.log(`  Saved:                    ~${stats.totalSaved.toLocaleString()} (${stats.savingsPercent}%)`);\n\n      // Source breakdown\n      if (stats.bySource.exec.count > 0 || stats.bySource.graph.count > 0) {\n        console.log(`\\n  By source:`);\n        if (stats.bySource.graph.count > 0) {\n          console.log(`    \uD83D\uDCCA Graph tools:  ${String(stats.bySource.graph.count).padStart(4)} calls  ~${stats.bySource.graph.saved.toLocaleString()} tokens saved (vs file reads/grep)`);\n        }\n        if (stats.bySource.exec.count > 0) {\n          console.log(`    \u26A1 Compression:  ${String(stats.bySource.exec.count).padStart(4)} calls  ~${stats.bySource.exec.saved.toLocaleString()} tokens saved (vs raw output)`);\n        }\n      }\n\n      if (Object.keys(stats.byFamily).length > 0) {\n        console.log(`\\n  By family:`);\n        for (const [family, data] of Object.entries(stats.byFamily)) {\n          const icon = family.startsWith('graph') ? '\uD83D\uDCCA' : '\u26A1';\n          console.log(`    ${icon} ${family.padEnd(20)} ${String(data.count).padStart(4)} calls  ${data.savings}% avg savings`);\n        }\n      }\n\n      console.log();\n    });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/bin/commands/help.js

@@ -89,6 +89,9 @@ function printColoredHelp() {
       title: "\u2699\uFE0F Agent & Configuration",
       commands: [
         { name: "caveman", args: "[mode]", desc: "Set agent communication style (off | lite | full | ultra)" },
+        { name: "compression", args: "[level]", desc: "Set shell compression level (off | normal | aggressive | ultra)" },
+        { name: "exec", args: "<command...>", desc: "Run a shell command with token-optimized output", opts: ["-l, --level <l>  normal | aggressive | ultra", "-t, --timeout <s> Timeout in seconds (default 60)", "--raw         Show raw + compressed for comparison", "--json        Output as JSON"] },
+        { name: "gain", desc: "Show token savings from compressed command outputs", opts: ["--graph       ASCII graph (last 30 days)", "--history     Recent command history", "--daily       Day-by-day breakdown", "--period <p>  session | today | week | all"] },
         { name: "serve", desc: "Start the MCP server", opts: ["--mcp        Run as MCP stdio server", "--path <p>   Project path"] },
         { name: "dashboard", desc: "Manage the Qdrant or Typesense dashboard server", opts: ["start [path]  Start server and open dashboard", "stop [path]   Stop the running server"] }
       ]
@@ -113,7 +116,7 @@ ${c.bold}${c.paleLavender}USAGE${c.reset}`);
       console.log(`${prefix}${namePart}${pad}${c.gray}${cmd.desc}${c.reset}`);
       if (isCaveman) {
         const inspiredPad = " ".repeat(3 + nameWidth);
-        console.log(`${inspiredPad}${c.dim}Inspired by Caveman \u2014 original idea by github.com/JuliusBrussee/caveman${c.reset}`);
+        console.log(`${inspiredPad}${c.dim}Inspired by Caveman , original idea by github.com/JuliusBrussee/caveman${c.reset}`);
         console.log();
       }
       if (cmd.opts) {
@@ -184,6 +187,12 @@ ${c.bold}${c.paleLavender}USAGE${c.reset}`);
       examples: [
         ["kirograph caveman full", "Enable full caveman mode for the agent"],
         ["kirograph caveman off", "Disable caveman mode"],
+        ["kirograph compression aggressive", "Set compression to aggressive level"],
+        ["kirograph compression off", "Disable compression hook (tool still available)"],
+        ["kirograph exec git status", "Run git status with compression"],
+        ["kirograph exec --level ultra npm test", "Run tests with ultra compression"],
+        ["kirograph exec --raw cargo build", "Show raw vs compressed comparison"],
+        ["kirograph gain --graph", "Show token savings graph"],
         ["kirograph serve --mcp", "Start the MCP server"]
       ]
     }

package/dist/bin/commands/help.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/bin/commands/help.ts"],
-  "sourcesContent": ["import { Command } from 'commander';\nimport { printBanner } from '../banner';\n\ntype CommandEntry = { name: string; args?: string; desc: string; opts?: string[] };\ntype Group = { title: string; commands: CommandEntry[] };\n\nexport function printColoredHelp(): void {\n  const c = {\n    reset:        '\\x1b[0m',\n    bold:         '\\x1b[1m',\n    dim:          '\\x1b[2m',\n    violet:       '\\x1b[38;5;99m',\n    purple:       '\\x1b[38;5;135m',\n    lavender:     '\\x1b[38;5;141m',\n    paleLavender: '\\x1b[38;5;183m',\n    gray:         '\\x1b[90m',\n    brown:        '\\x1b[38;5;130m',\n  };\n\n  const groups: Group[] = [\n    {\n      title: '\uD83D\uDD27 Workspace Setup',\n      commands: [\n        { name: 'install',       desc: 'Wire up MCP/instructions for an agent workspace', opts: ['--target <t>  kiro | claude | codex'] },\n        { name: 'init',          args: '[path]', desc: 'Initialize KiroGraph in a project', opts: ['-i, --index  Index immediately after init'] },\n        { name: 'uninit',        args: '[path]', desc: 'Remove KiroGraph from a project',   opts: ['--force      Skip confirmation', '--target <t>  kiro | claude | codex | all'] },\n        { name: 'uninstall',     args: '[path]', desc: 'Alias for uninit',                  opts: ['--force      Skip confirmation', '--target <t>  kiro | claude | codex | all'] },\n      ],\n    },\n    {\n      title: '\uD83D\uDCE6 Indexing',\n      commands: [\n        { name: 'index',         args: '[path]', desc: 'Full re-index of a project',             opts: ['--force     Force re-index all files'] },\n        { name: 'sync',          args: '[path]', desc: 'Incremental sync of changed files',       opts: ['--files <f> Specific files to sync'] },\n        { name: 'sync-if-dirty', args: '[path]', desc: 'Sync only if a dirty marker is present', opts: ['-q, --quiet  Suppress output'] },\n        { name: 'mark-dirty',    args: '[path]', desc: 'Write a dirty marker for deferred sync' },\n        { name: 'unlock',        args: '[path]', desc: 'Force-release a stale lock file' },\n      ],\n    },\n    {\n      title: '\uD83D\uDD0D Search & Exploration',\n      commands: [\n        { name: 'status',   args: '[path]',    desc: 'Show index statistics and health' },\n        { name: 'query',    args: '<search>',  desc: 'Search for symbols by name',          opts: ['--kind <k>      Filter by kind', '--limit <n>     Max results (default 10)'] },\n        { name: 'context',  args: '<task>',    desc: 'Build relevant code context for a task', opts: ['--max-nodes <n>  Max symbols (default 20)', '--no-code        Exclude code snippets', '--format <fmt>   markdown | json'] },\n        { name: 'files',    args: '[path]',    desc: 'Show project file structure from the index', opts: ['--format <fmt>   tree | flat | grouped', '--filter <path>  Filter by directory prefix', '--pattern <glob> Filter by glob', '--max-depth <n>  Limit tree depth', '--json           Output as JSON'] },\n        { name: 'path',     args: '<from> <to>', desc: 'Find the shortest path between two symbols',         opts: ['--format <fmt>   table | json'] },\n        { name: 'export build', args: '[path]', desc: 'Generate the interactive graph dashboard (.kirograph/export/)', opts: ['-o, --output <dir>  Custom output directory', '--include-contains  Include structural contains edges'] },\n        { name: 'export start', args: '[path]', desc: 'Generate and open the dashboard in the browser',               opts: ['-o, --output <dir>  Custom output directory', '--include-contains  Include structural contains edges'] },\n        { name: 'affected', args: '[files...]', desc: 'Find test files affected by changed source files', opts: ['--stdin          Read file list from stdin', '-d, --depth <n>  Max traversal depth (default 5)', '-f, --filter <g> Custom test file glob', '-j, --json       Output as JSON', '-q, --quiet      File paths only'] },\n      ],\n    },\n    {\n      title: '\uD83D\uDCCA Graph Insights',\n      commands: [\n        { name: 'hotspots',   args: '[path]', desc: 'Find most-connected symbols by edge degree',          opts: ['--limit <n>    Max results (default 20)', '--format <f>  table | json'] },\n        { name: 'surprising', args: '[path]', desc: 'Find non-obvious cross-file connections',             opts: ['--limit <n>    Max results (default 20)', '--format <f>  table | json'] },\n        { name: 'dead-code',  args: '[path]', desc: 'Find unexported symbols with no incoming references', opts: ['--limit <n>    Max results (default 50)', '--format <f>  table | json'] },\n        { name: 'snapshot',   desc:           'Save or list graph snapshots for structural diffing',       opts: ['save [label]  Save current graph state', 'list          List saved snapshots', 'diff [label]  Diff current graph vs a snapshot  --format summary|full|json'] },\n      ],\n    },\n    {\n      title: '\uD83C\uDFDB\uFE0F Architecture Analysis',\n      commands: [\n        { name: 'architecture', args: '[path]', desc: 'Show package graph and layer map',          opts: ['--packages     Show packages only', '--layers       Show layers only', '--format <f>   json'] },\n        { name: 'coupling',     args: '[path]', desc: 'Show coupling metrics per package',         opts: ['--sort <s>     instability | ca | ce | name', '--package <n>  Detail view for one package', '--format <f>   json'] },\n        { name: 'package',      args: '<name>', desc: 'Inspect a package: deps, files, metrics',  opts: ['--no-files     Omit file list', '--format <f>   json'] },\n      ],\n    },\n    {\n      title: '\u2699\uFE0F Agent & Configuration',\n      commands: [\n        { name: 'caveman', args: '[mode]', desc: 'Set agent communication style (off | lite | full | ultra)' },\n        { name: 'serve',   desc: 'Start the MCP server', opts: ['--mcp        Run as MCP stdio server', '--path <p>   Project path'] },\n        { name: 'dashboard', desc: 'Manage the Qdrant or Typesense dashboard server', opts: ['start [path]  Start server and open dashboard', 'stop [path]   Stop the running server'] },\n      ],\n    },\n  ];\n\n  console.log(`\\n${c.bold}${c.paleLavender}USAGE${c.reset}`);\n  console.log(`  ${c.lavender}kirograph${c.reset} ${c.gray}<command>${c.reset} ${c.dim}[options]${c.reset}\\n`);\n\n  // Compute max name+args width across ALL groups for alignment\n  const allCmds = groups.flatMap(g => g.commands);\n  const nameWidth = Math.max(...allCmds.map(cmd => (cmd.name + (cmd.args ? ' ' + cmd.args : '')).length)) + 2;\n\n  for (const group of groups) {\n    console.log(`${c.bold}${c.paleLavender}${group.title.toUpperCase()}${c.reset}\\n`);\n    for (const cmd of group.commands) {\n      const signature = cmd.name + (cmd.args ? ' ' + cmd.args : '');\n      const isCaveman = cmd.name === 'caveman';\n      const nameColor = isCaveman ? c.brown : c.lavender;\n      const prefix = isCaveman ? '\uD83E\uDEA8 ' : '  ';\n      const namePart = `${nameColor}${cmd.name}${c.reset}${cmd.args ? ' ' + c.dim + cmd.args + c.reset : ''}`;\n      const pad = ' '.repeat(Math.max(0, nameWidth - signature.length));\n      console.log(`${prefix}${namePart}${pad}${c.gray}${cmd.desc}${c.reset}`);\n      if (isCaveman) {\n        // desc starts at: emoji prefix (3 display cols: \uD83E\uDEA8 + space) + nameWidth\n        const inspiredPad = ' '.repeat(3 + nameWidth);\n        console.log(`${inspiredPad}${c.dim}Inspired by Caveman \u2014 original idea by github.com/JuliusBrussee/caveman${c.reset}`);\n        console.log();\n      }\n      if (cmd.opts) {\n        for (const opt of cmd.opts) {\n          const [flag, ...rest] = opt.split(/  +/);\n          const optPad = ' '.repeat(nameWidth + 2);\n          console.log(`  ${optPad}${c.purple}${flag}${c.reset}${rest.length ? '  ' + c.dim + rest.join('  ') + c.reset : ''}`);\n        }\n        console.log();\n      }\n    }\n    if (!groups[groups.length - 1].commands.includes(group.commands[group.commands.length - 1])) {\n      // extra spacing between groups handled by opts blank line; add one if no opts\n      const lastHasOpts = group.commands[group.commands.length - 1].opts;\n      if (!lastHasOpts) console.log();\n    }\n  }\n\n  console.log(`${c.bold}${c.paleLavender}GLOBAL FLAGS${c.reset}\\n`);\n  console.log(`  ${c.purple}-h, --help${c.reset}     ${c.gray}Show this help${c.reset}`);\n  console.log(`  ${c.purple}-V, --version${c.reset}  ${c.gray}Show version number${c.reset}\\n`);\n\n  console.log(`${c.bold}${c.paleLavender}EXAMPLES${c.reset}\\n`);\n\n  const exampleGroups: Array<{ title: string; examples: [string, string][] }> = [\n    {\n      title: '\uD83D\uDD27 Setup & indexing',\n      examples: [\n        ['kirograph install',                              'Wire up Kiro MCP + hooks + steering for the current workspace'],\n        ['kirograph install --target claude',              'Wire up Claude Code MCP + project memory'],\n        ['kirograph install --target codex',               'Install Codex project instructions and print MCP config'],\n        ['kirograph init --index',                         'Init and immediately index the project'],\n        ['kirograph sync',                                 'Incremental sync of changed files'],\n      ],\n    },\n    {\n      title: '\uD83D\uDD0D Search & exploration',\n      examples: [\n        ['kirograph query useState',                       'Find all symbols named useState'],\n        ['kirograph context \"add dark mode\"',              'Get relevant code context for a task'],\n        ['kirograph files --format grouped',               'Show files grouped by directory'],\n        ['kirograph path LoginController DatabasePool',     'Find how two symbols are connected'],\n        ['kirograph affected src/auth.ts',                 'Find tests affected by a change'],\n        ['git diff --name-only | kirograph affected --stdin', 'Affected tests from a git diff'],\n        ['kirograph export start',                         'Open the interactive graph dashboard in the browser'],\n        ['kirograph export build -o /tmp/graph',           'Export the dashboard to a custom directory'],\n      ],\n    },\n    {\n      title: '\uD83D\uDCCA Graph insights',\n      examples: [\n        ['kirograph hotspots --limit 10',                  'Top 10 most-connected symbols'],\n        ['kirograph surprising',                           'Find unexpected cross-module connections'],\n        ['kirograph dead-code',                            'Find unreferenced unexported symbols'],\n        ['kirograph snapshot save pre-refactor',           'Save a named snapshot before a refactor'],\n        ['kirograph snapshot diff pre-refactor',           'Diff current graph vs the named snapshot'],\n      ],\n    },\n    {\n      title: '\uD83C\uDFDB\uFE0F Architecture',\n      examples: [\n        ['kirograph architecture --packages',              'List all detected packages'],\n        ['kirograph coupling --sort instability',          'Show packages ranked by instability'],\n        ['kirograph package src/auth',                     'Inspect the auth package'],\n      ],\n    },\n    {\n      title: '\u2699\uFE0F Agent',\n      examples: [\n        ['kirograph caveman full',                         'Enable full caveman mode for the agent'],\n        ['kirograph caveman off',                          'Disable caveman mode'],\n        ['kirograph serve --mcp',                          'Start the MCP server'],\n      ],\n    },\n  ];\n\n  for (const eg of exampleGroups) {\n    console.log(`  ${c.dim}${eg.title}${c.reset}`);\n    for (const [ex, desc] of eg.examples) {\n      console.log(`  ${c.violet}$${c.reset} ${c.lavender}${ex}${c.reset}`);\n      console.log(`    ${c.dim}${desc}${c.reset}`);\n    }\n    console.log();\n  }\n}\n\nexport function register(program: Command): void {\n  program.configureHelp({ formatHelp: () => '' });\n  program.addHelpText('afterAll', '');\n  program.helpInformation = () => {\n    printBanner();\n    printColoredHelp();\n    return '';\n  };\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,oBAA4B;AAKrB,SAAS,mBAAyB;AACvC,QAAM,IAAI;AAAA,IACR,OAAc;AAAA,IACd,MAAc;AAAA,IACd,KAAc;AAAA,IACd,QAAc;AAAA,IACd,QAAc;AAAA,IACd,UAAc;AAAA,IACd,cAAc;AAAA,IACd,MAAc;AAAA,IACd,OAAc;AAAA,EAChB;AAEA,QAAM,SAAkB;AAAA,IACtB;AAAA,MACE,OAAO;AAAA,MACP,UAAU;AAAA,QACR,EAAE,MAAM,WAAiB,MAAM,mDAAmD,MAAM,CAAC,qCAAqC,EAAE;AAAA,QAChI,EAAE,MAAM,QAAiB,MAAM,UAAU,MAAM,qCAAqC,MAAM,CAAC,2CAA2C,EAAE;AAAA,QACxI,EAAE,MAAM,UAAiB,MAAM,UAAU,MAAM,mCAAqC,MAAM,CAAC,kCAAkC,2CAA2C,EAAE;AAAA,QAC1K,EAAE,MAAM,aAAiB,MAAM,UAAU,MAAM,oBAAqC,MAAM,CAAC,kCAAkC,2CAA2C,EAAE;AAAA,MAC5K;AAAA,IACF;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,UAAU;AAAA,QACR,EAAE,MAAM,SAAiB,MAAM,UAAU,MAAM,8BAA0C,MAAM,CAAC,sCAAsC,EAAE;AAAA,QACxI,EAAE,MAAM,QAAiB,MAAM,UAAU,MAAM,qCAA2C,MAAM,CAAC,oCAAoC,EAAE;AAAA,QACvI,EAAE,MAAM,iBAAiB,MAAM,UAAU,MAAM,0CAA0C,MAAM,CAAC,8BAA8B,EAAE;AAAA,QAChI,EAAE,MAAM,cAAiB,MAAM,UAAU,MAAM,yCAAyC;AAAA,QACxF,EAAE,MAAM,UAAiB,MAAM,UAAU,MAAM,kCAAkC;AAAA,MACnF;AAAA,IACF;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,UAAU;AAAA,QACR,EAAE,MAAM,UAAY,MAAM,UAAa,MAAM,mCAAmC;AAAA,QAChF,EAAE,MAAM,SAAY,MAAM,YAAa,MAAM,8BAAuC,MAAM,CAAC,kCAAkC,0CAA0C,EAAE;AAAA,QACzK,EAAE,MAAM,WAAY,MAAM,UAAa,MAAM,0CAA0C,MAAM,CAAC,6CAA6C,0CAA0C,kCAAkC,EAAE;AAAA,QACzN,EAAE,MAAM,SAAY,MAAM,UAAa,MAAM,8CAA8C,MAAM,CAAC,0CAA0C,+CAA+C,mCAAmC,qCAAqC,iCAAiC,EAAE;AAAA,QACtS,EAAE,MAAM,QAAY,MAAM,eAAe,MAAM,8CAAsD,MAAM,CAAC,+BAA+B,EAAE;AAAA,QAC7I,EAAE,MAAM,gBAAgB,MAAM,UAAU,MAAM,iEAAiE,MAAM,CAAC,+CAA+C,uDAAuD,EAAE;AAAA,QAC9N,EAAE,MAAM,gBAAgB,MAAM,UAAU,MAAM,kDAAgE,MAAM,CAAC,+CAA+C,uDAAuD,EAAE;AAAA,QAC7N,EAAE,MAAM,YAAY,MAAM,cAAc,MAAM,oDAAoD,MAAM,CAAC,8CAA8C,oDAAoD,0CAA0C,mCAAmC,kCAAkC,EAAE;AAAA,MAC9T;AAAA,IACF;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,UAAU;AAAA,QACR,EAAE,MAAM,YAAc,MAAM,UAAU,MAAM,8CAAuD,MAAM,CAAC,2CAA2C,4BAA4B,EAAE;AAAA,QACnL,EAAE,MAAM,cAAc,MAAM,UAAU,MAAM,2CAAuD,MAAM,CAAC,2CAA2C,4BAA4B,EAAE;AAAA,QACnL,EAAE,MAAM,aAAc,MAAM,UAAU,MAAM,uDAAuD,MAAM,CAAC,2CAA2C,4BAA4B,EAAE;AAAA,QACnL,EAAE,MAAM,YAAc,MAAgB,uDAA6D,MAAM,CAAC,0CAA0C,sCAAsC,4EAA4E,EAAE;AAAA,MAC1Q;AAAA,IACF;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,UAAU;AAAA,QACR,EAAE,MAAM,gBAAgB,MAAM,UAAU,MAAM,oCAA6C,MAAM,CAAC,qCAAqC,mCAAmC,qBAAqB,EAAE;AAAA,QACjM,EAAE,MAAM,YAAgB,MAAM,UAAU,MAAM,qCAA6C,MAAM,CAAC,+CAA+C,8CAA8C,qBAAqB,EAAE;AAAA,QACtN,EAAE,MAAM,WAAgB,MAAM,UAAU,MAAM,2CAA4C,MAAM,CAAC,iCAAiC,qBAAqB,EAAE;AAAA,MAC3J;AAAA,IACF;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,UAAU;AAAA,QACR,EAAE,MAAM,WAAW,MAAM,UAAU,MAAM,4DAA4D;AAAA,QACrG,EAAE,MAAM,SAAW,MAAM,wBAAwB,MAAM,CAAC,wCAAwC,2BAA2B,EAAE;AAAA,QAC7H,EAAE,MAAM,aAAa,MAAM,mDAAmD,MAAM,CAAC,iDAAiD,uCAAuC,EAAE;AAAA,MACjL;AAAA,IACF;AAAA,EACF;AAEA,UAAQ,IAAI;AAAA,EAAK,EAAE,IAAI,GAAG,EAAE,YAAY,QAAQ,EAAE,KAAK,EAAE;AACzD,UAAQ,IAAI,KAAK,EAAE,QAAQ,YAAY,EAAE,KAAK,IAAI,EAAE,IAAI,YAAY,EAAE,KAAK,IAAI,EAAE,GAAG,YAAY,EAAE,KAAK;AAAA,CAAI;AAG3G,QAAM,UAAU,OAAO,QAAQ,OAAK,EAAE,QAAQ;AAC9C,QAAM,YAAY,KAAK,IAAI,GAAG,QAAQ,IAAI,UAAQ,IAAI,QAAQ,IAAI,OAAO,MAAM,IAAI,OAAO,KAAK,MAAM,CAAC,IAAI;AAE1G,aAAW,SAAS,QAAQ;AAC1B,YAAQ,IAAI,GAAG,EAAE,IAAI,GAAG,EAAE,YAAY,GAAG,MAAM,MAAM,YAAY,CAAC,GAAG,EAAE,KAAK;AAAA,CAAI;AAChF,eAAW,OAAO,MAAM,UAAU;AAChC,YAAM,YAAY,IAAI,QAAQ,IAAI,OAAO,MAAM,IAAI,OAAO;AAC1D,YAAM,YAAY,IAAI,SAAS;AAC/B,YAAM,YAAY,YAAY,EAAE,QAAQ,EAAE;AAC1C,YAAM,SAAS,YAAY,eAAQ;AACnC,YAAM,WAAW,GAAG,SAAS,GAAG,IAAI,IAAI,GAAG,EAAE,KAAK,GAAG,IAAI,OAAO,MAAM,EAAE,MAAM,IAAI,OAAO,EAAE,QAAQ,EAAE;AACrG,YAAM,MAAM,IAAI,OAAO,KAAK,IAAI,GAAG,YAAY,UAAU,MAAM,CAAC;AAChE,cAAQ,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,GAAG,GAAG,EAAE,IAAI,GAAG,IAAI,IAAI,GAAG,EAAE,KAAK,EAAE;AACtE,UAAI,WAAW;AAEb,cAAM,cAAc,IAAI,OAAO,IAAI,SAAS;AAC5C,gBAAQ,IAAI,GAAG,WAAW,GAAG,EAAE,GAAG,+EAA0E,EAAE,KAAK,EAAE;AACrH,gBAAQ,IAAI;AAAA,MACd;AACA,UAAI,IAAI,MAAM;AACZ,mBAAW,OAAO,IAAI,MAAM;AAC1B,gBAAM,CAAC,MAAM,GAAG,IAAI,IAAI,IAAI,MAAM,KAAK;AACvC,gBAAM,SAAS,IAAI,OAAO,YAAY,CAAC;AACvC,kBAAQ,IAAI,KAAK,MAAM,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,EAAE,KAAK,GAAG,KAAK,SAAS,OAAO,EAAE,MAAM,KAAK,KAAK,IAAI,IAAI,EAAE,QAAQ,EAAE,EAAE;AAAA,QACrH;AACA,gBAAQ,IAAI;AAAA,MACd;AAAA,IACF;AACA,QAAI,CAAC,OAAO,OAAO,SAAS,CAAC,EAAE,SAAS,SAAS,MAAM,SAAS,MAAM,SAAS,SAAS,CAAC,CAAC,GAAG;AAE3F,YAAM,cAAc,MAAM,SAAS,MAAM,SAAS,SAAS,CAAC,EAAE;AAC9D,UAAI,CAAC,YAAa,SAAQ,IAAI;AAAA,IAChC;AAAA,EACF;AAEA,UAAQ,IAAI,GAAG,EAAE,IAAI,GAAG,EAAE,YAAY,eAAe,EAAE,KAAK;AAAA,CAAI;AAChE,UAAQ,IAAI,KAAK,EAAE,MAAM,aAAa,EAAE,KAAK,QAAQ,EAAE,IAAI,iBAAiB,EAAE,KAAK,EAAE;AACrF,UAAQ,IAAI,KAAK,EAAE,MAAM,gBAAgB,EAAE,KAAK,KAAK,EAAE,IAAI,sBAAsB,EAAE,KAAK;AAAA,CAAI;AAE5F,UAAQ,IAAI,GAAG,EAAE,IAAI,GAAG,EAAE,YAAY,WAAW,EAAE,KAAK;AAAA,CAAI;AAE5D,QAAM,gBAAwE;AAAA,IAC5E;AAAA,MACE,OAAO;AAAA,MACP,UAAU;AAAA,QACR,CAAC,qBAAkD,+DAA+D;AAAA,QAClH,CAAC,qCAAkD,0CAA0C;AAAA,QAC7F,CAAC,oCAAkD,yDAAyD;AAAA,QAC5G,CAAC,0BAAkD,wCAAwC;AAAA,QAC3F,CAAC,kBAAkD,mCAAmC;AAAA,MACxF;AAAA,IACF;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,UAAU;AAAA,QACR,CAAC,4BAAkD,iCAAiC;AAAA,QACpF,CAAC,qCAAkD,sCAAsC;AAAA,QACzF,CAAC,oCAAkD,iCAAiC;AAAA,QACpF,CAAC,+CAAmD,oCAAoC;AAAA,QACxF,CAAC,kCAAkD,iCAAiC;AAAA,QACpF,CAAC,qDAAqD,gCAAgC;AAAA,QACtF,CAAC,0BAAkD,qDAAqD;AAAA,QACxG,CAAC,wCAAkD,4CAA4C;AAAA,MACjG;AAAA,IACF;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,UAAU;AAAA,QACR,CAAC,iCAAkD,+BAA+B;AAAA,QAClF,CAAC,wBAAkD,0CAA0C;AAAA,QAC7F,CAAC,uBAAkD,sCAAsC;AAAA,QACzF,CAAC,wCAAkD,yCAAyC;AAAA,QAC5F,CAAC,wCAAkD,0CAA0C;AAAA,MAC/F;AAAA,IACF;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,UAAU;AAAA,QACR,CAAC,qCAAkD,4BAA4B;AAAA,QAC/E,CAAC,yCAAkD,qCAAqC;AAAA,QACxF,CAAC,8BAAkD,0BAA0B;AAAA,MAC/E;AAAA,IACF;AAAA,IACA;AAAA,MACE,OAAO;AAAA,MACP,UAAU;AAAA,QACR,CAAC,0BAAkD,wCAAwC;AAAA,QAC3F,CAAC,yBAAkD,sBAAsB;AAAA,QACzE,CAAC,yBAAkD,sBAAsB;AAAA,MAC3E;AAAA,IACF;AAAA,EACF;AAEA,aAAW,MAAM,eAAe;AAC9B,YAAQ,IAAI,KAAK,EAAE,GAAG,GAAG,GAAG,KAAK,GAAG,EAAE,KAAK,EAAE;AAC7C,eAAW,CAAC,IAAI,IAAI,KAAK,GAAG,UAAU;AACpC,cAAQ,IAAI,KAAK,EAAE,MAAM,IAAI,EAAE,KAAK,IAAI,EAAE,QAAQ,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE;AACnE,cAAQ,IAAI,OAAO,EAAE,GAAG,GAAG,IAAI,GAAG,EAAE,KAAK,EAAE;AAAA,IAC7C;AACA,YAAQ,IAAI;AAAA,EACd;AACF;AAEO,SAAS,SAAS,SAAwB;AAC/C,UAAQ,cAAc,EAAE,YAAY,MAAM,GAAG,CAAC;AAC9C,UAAQ,YAAY,YAAY,EAAE;AAClC,UAAQ,kBAAkB,MAAM;AAC9B,mCAAY;AACZ,qBAAiB;AACjB,WAAO;AAAA,EACT;AACF;",
+  "sourcesContent": ["import { Command } from 'commander';\nimport { printBanner } from '../banner';\n\ntype CommandEntry = { name: string; args?: string; desc: string; opts?: string[] };\ntype Group = { title: string; commands: CommandEntry[] };\n\nexport function printColoredHelp(): void {\n  const c = {\n    reset:        '\\x1b[0m',\n    bold:         '\\x1b[1m',\n    dim:          '\\x1b[2m',\n    violet:       '\\x1b[38;5;99m',\n    purple:       '\\x1b[38;5;135m',\n    lavender:     '\\x1b[38;5;141m',\n    paleLavender: '\\x1b[38;5;183m',\n    gray:         '\\x1b[90m',\n    brown:        '\\x1b[38;5;130m',\n  };\n\n  const groups: Group[] = [\n    {\n      title: '\uD83D\uDD27 Workspace Setup',\n      commands: [\n        { name: 'install',       desc: 'Wire up MCP/instructions for an agent workspace', opts: ['--target <t>  kiro | claude | codex'] },\n        { name: 'init',          args: '[path]', desc: 'Initialize KiroGraph in a project', opts: ['-i, --index  Index immediately after init'] },\n        { name: 'uninit',        args: '[path]', desc: 'Remove KiroGraph from a project',   opts: ['--force      Skip confirmation', '--target <t>  kiro | claude | codex | all'] },\n        { name: 'uninstall',     args: '[path]', desc: 'Alias for uninit',                  opts: ['--force      Skip confirmation', '--target <t>  kiro | claude | codex | all'] },\n      ],\n    },\n    {\n      title: '\uD83D\uDCE6 Indexing',\n      commands: [\n        { name: 'index',         args: '[path]', desc: 'Full re-index of a project',             opts: ['--force     Force re-index all files'] },\n        { name: 'sync',          args: '[path]', desc: 'Incremental sync of changed files',       opts: ['--files <f> Specific files to sync'] },\n        { name: 'sync-if-dirty', args: '[path]', desc: 'Sync only if a dirty marker is present', opts: ['-q, --quiet  Suppress output'] },\n        { name: 'mark-dirty',    args: '[path]', desc: 'Write a dirty marker for deferred sync' },\n        { name: 'unlock',        args: '[path]', desc: 'Force-release a stale lock file' },\n      ],\n    },\n    {\n      title: '\uD83D\uDD0D Search & Exploration',\n      commands: [\n        { name: 'status',   args: '[path]',    desc: 'Show index statistics and health' },\n        { name: 'query',    args: '<search>',  desc: 'Search for symbols by name',          opts: ['--kind <k>      Filter by kind', '--limit <n>     Max results (default 10)'] },\n        { name: 'context',  args: '<task>',    desc: 'Build relevant code context for a task', opts: ['--max-nodes <n>  Max symbols (default 20)', '--no-code        Exclude code snippets', '--format <fmt>   markdown | json'] },\n        { name: 'files',    args: '[path]',    desc: 'Show project file structure from the index', opts: ['--format <fmt>   tree | flat | grouped', '--filter <path>  Filter by directory prefix', '--pattern <glob> Filter by glob', '--max-depth <n>  Limit tree depth', '--json           Output as JSON'] },\n        { name: 'path',     args: '<from> <to>', desc: 'Find the shortest path between two symbols',         opts: ['--format <fmt>   table | json'] },\n        { name: 'export build', args: '[path]', desc: 'Generate the interactive graph dashboard (.kirograph/export/)', opts: ['-o, --output <dir>  Custom output directory', '--include-contains  Include structural contains edges'] },\n        { name: 'export start', args: '[path]', desc: 'Generate and open the dashboard in the browser',               opts: ['-o, --output <dir>  Custom output directory', '--include-contains  Include structural contains edges'] },\n        { name: 'affected', args: '[files...]', desc: 'Find test files affected by changed source files', opts: ['--stdin          Read file list from stdin', '-d, --depth <n>  Max traversal depth (default 5)', '-f, --filter <g> Custom test file glob', '-j, --json       Output as JSON', '-q, --quiet      File paths only'] },\n      ],\n    },\n    {\n      title: '\uD83D\uDCCA Graph Insights',\n      commands: [\n        { name: 'hotspots',   args: '[path]', desc: 'Find most-connected symbols by edge degree',          opts: ['--limit <n>    Max results (default 20)', '--format <f>  table | json'] },\n        { name: 'surprising', args: '[path]', desc: 'Find non-obvious cross-file connections',             opts: ['--limit <n>    Max results (default 20)', '--format <f>  table | json'] },\n        { name: 'dead-code',  args: '[path]', desc: 'Find unexported symbols with no incoming references', opts: ['--limit <n>    Max results (default 50)', '--format <f>  table | json'] },\n        { name: 'snapshot',   desc:           'Save or list graph snapshots for structural diffing',       opts: ['save [label]  Save current graph state', 'list          List saved snapshots', 'diff [label]  Diff current graph vs a snapshot  --format summary|full|json'] },\n      ],\n    },\n    {\n      title: '\uD83C\uDFDB\uFE0F Architecture Analysis',\n      commands: [\n        { name: 'architecture', args: '[path]', desc: 'Show package graph and layer map',          opts: ['--packages     Show packages only', '--layers       Show layers only', '--format <f>   json'] },\n        { name: 'coupling',     args: '[path]', desc: 'Show coupling metrics per package',         opts: ['--sort <s>     instability | ca | ce | name', '--package <n>  Detail view for one package', '--format <f>   json'] },\n        { name: 'package',      args: '<name>', desc: 'Inspect a package: deps, files, metrics',  opts: ['--no-files     Omit file list', '--format <f>   json'] },\n      ],\n    },\n    {\n      title: '\u2699\uFE0F Agent & Configuration',\n      commands: [\n        { name: 'caveman', args: '[mode]', desc: 'Set agent communication style (off | lite | full | ultra)' },\n        { name: 'compression', args: '[level]', desc: 'Set shell compression level (off | normal | aggressive | ultra)' },\n        { name: 'exec', args: '<command...>', desc: 'Run a shell command with token-optimized output', opts: ['-l, --level <l>  normal | aggressive | ultra', '-t, --timeout <s> Timeout in seconds (default 60)', '--raw         Show raw + compressed for comparison', '--json        Output as JSON'] },\n        { name: 'gain', desc: 'Show token savings from compressed command outputs', opts: ['--graph       ASCII graph (last 30 days)', '--history     Recent command history', '--daily       Day-by-day breakdown', '--period <p>  session | today | week | all'] },\n        { name: 'serve',   desc: 'Start the MCP server', opts: ['--mcp        Run as MCP stdio server', '--path <p>   Project path'] },\n        { name: 'dashboard', desc: 'Manage the Qdrant or Typesense dashboard server', opts: ['start [path]  Start server and open dashboard', 'stop [path]   Stop the running server'] },\n      ],\n    },\n  ];\n\n  console.log(`\\n${c.bold}${c.paleLavender}USAGE${c.reset}`);\n  console.log(`  ${c.lavender}kirograph${c.reset} ${c.gray}<command>${c.reset} ${c.dim}[options]${c.reset}\\n`);\n\n  // Compute max name+args width across ALL groups for alignment\n  const allCmds = groups.flatMap(g => g.commands);\n  const nameWidth = Math.max(...allCmds.map(cmd => (cmd.name + (cmd.args ? ' ' + cmd.args : '')).length)) + 2;\n\n  for (const group of groups) {\n    console.log(`${c.bold}${c.paleLavender}${group.title.toUpperCase()}${c.reset}\\n`);\n    for (const cmd of group.commands) {\n      const signature = cmd.name + (cmd.args ? ' ' + cmd.args : '');\n      const isCaveman = cmd.name === 'caveman';\n      const nameColor = isCaveman ? c.brown : c.lavender;\n      const prefix = isCaveman ? '\uD83E\uDEA8 ' : '  ';\n      const namePart = `${nameColor}${cmd.name}${c.reset}${cmd.args ? ' ' + c.dim + cmd.args + c.reset : ''}`;\n      const pad = ' '.repeat(Math.max(0, nameWidth - signature.length));\n      console.log(`${prefix}${namePart}${pad}${c.gray}${cmd.desc}${c.reset}`);\n      if (isCaveman) {\n        // desc starts at: emoji prefix (3 display cols: \uD83E\uDEA8 + space) + nameWidth\n        const inspiredPad = ' '.repeat(3 + nameWidth);\n        console.log(`${inspiredPad}${c.dim}Inspired by Caveman , original idea by github.com/JuliusBrussee/caveman${c.reset}`);\n        console.log();\n      }\n      if (cmd.opts) {\n        for (const opt of cmd.opts) {\n          const [flag, ...rest] = opt.split(/  +/);\n          const optPad = ' '.repeat(nameWidth + 2);\n          console.log(`  ${optPad}${c.purple}${flag}${c.reset}${rest.length ? '  ' + c.dim + rest.join('  ') + c.reset : ''}`);\n        }\n        console.log();\n      }\n    }\n    if (!groups[groups.length - 1].commands.includes(group.commands[group.commands.length - 1])) {\n      // extra spacing between groups handled by opts blank line; add one if no opts\n      const lastHasOpts = group.commands[group.commands.length - 1].opts;\n      if (!lastHasOpts) console.log();\n    }\n  }\n\n  console.log(`${c.bold}${c.paleLavender}GLOBAL FLAGS${c.reset}\\n`);\n  console.log(`  ${c.purple}-h, --help${c.reset}     ${c.gray}Show this help${c.reset}`);\n  console.log(`  ${c.purple}-V, --version${c.reset}  ${c.gray}Show version number${c.reset}\\n`);\n\n  console.log(`${c.bold}${c.paleLavender}EXAMPLES${c.reset}\\n`);\n\n  const exampleGroups: Array<{ title: string; examples: [string, string][] }> = [\n    {\n      title: '\uD83D\uDD27 Setup & indexing',\n      examples: [\n        ['kirograph install',                              'Wire up Kiro MCP + hooks + steering for the current workspace'],\n        ['kirograph install --target claude',              'Wire up Claude Code MCP + project memory'],\n        ['kirograph install --target codex',               'Install Codex project instructions and print MCP config'],\n        ['kirograph init --index',                         'Init and immediately index the project'],\n        ['kirograph sync',                                 'Incremental sync of changed files'],\n      ],\n    },\n    {\n      title: '\uD83D\uDD0D Search & exploration',\n      examples: [\n        ['kirograph query useState',                       'Find all symbols named useState'],\n        ['kirograph context \"add dark mode\"',              'Get relevant code context for a task'],\n        ['kirograph files --format grouped',               'Show files grouped by directory'],\n        ['kirograph path LoginController DatabasePool',     'Find how two symbols are connected'],\n        ['kirograph affected src/auth.ts',                 'Find tests affected by a change'],\n        ['git diff --name-only | kirograph affected --stdin', 'Affected tests from a git diff'],\n        ['kirograph export start',                         'Open the interactive graph dashboard in the browser'],\n        ['kirograph export build -o /tmp/graph',           'Export the dashboard to a custom directory'],\n      ],\n    },\n    {\n      title: '\uD83D\uDCCA Graph insights',\n      examples: [\n        ['kirograph hotspots --limit 10',                  'Top 10 most-connected symbols'],\n        ['kirograph surprising',                           'Find unexpected cross-module connections'],\n        ['kirograph dead-code',                            'Find unreferenced unexported symbols'],\n        ['kirograph snapshot save pre-refactor',           'Save a named snapshot before a refactor'],\n        ['kirograph snapshot diff pre-refactor',           'Diff current graph vs the named snapshot'],\n      ],\n    },\n    {\n      title: '\uD83C\uDFDB\uFE0F Architecture',\n      examples: [\n        ['kirograph architecture --packages',              'List all detected packages'],\n        ['kirograph coupling --sort instability',          'Show packages ranked by instability'],\n        ['kirograph package src/auth',                     'Inspect the auth package'],\n      ],\n    },\n    {\n      title: '\u2699\uFE0F Agent',\n      examples: [\n        ['kirograph caveman full',                         'Enable full caveman mode for the agent'],\n        ['kirograph caveman off',                          'Disable caveman mode'],\n        ['kirograph compression aggressive',              'Set compression to aggressive level'],\n        ['kirograph compression off',                      'Disable compression hook (tool still available)'],\n        ['kirograph exec git status',                      'Run git status with compression'],\n        ['kirograph exec --level ultra npm test',          'Run tests with ultra compression'],\n        ['kirograph exec --raw cargo build',               'Show raw vs compressed comparison'],\n        ['kirograph gain --graph',                         'Show token savings graph'],\n        ['kirograph serve --mcp',                          'Start the MCP server'],\n      ],\n    },\n  ];\n\n  for (const eg of exampleGroups) {\n    console.log(`  ${c.dim}${eg.title}${c.reset}`);\n    for (const [ex, desc] of eg.examples) {\n      console.log(`  ${c.violet}$${c.reset} ${c.lavender}${ex}${c.reset}`);\n      console.log(`    ${c.dim}${desc}${c.reset}`);\n    }\n    console.log();\n  }\n}\n\nexport function register(program: Command): void {\n  program.configureHelp({ formatHelp: () => '' });\n  program.addHelpText('afterAll', '');\n  program.helpInformation = () => {\n    printBanner();\n    printColoredHelp();\n    return '';\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }