kodelyth-ecc 1.8.6 → 1.9.0

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 All notable changes to Kodelyth ECC are documented here.
 
+## v1.9.0 — RTK integration + revived dashboard (July 2026)
+
+ECC now auto-installs [RTK](https://github.com/rtk-ai/rtk) (Rust Token Killer) and wires its transparent command filter into whichever IDE ECC was installed for. Real token savings (60-90% on shell commands) show up in the dashboard, pulled straight from RTK's own ledger — no synthetic numbers.
+
+### Added
+
+- `scripts/rtk/index.js` — RTK integration module: `install()`, `enableFor(target)`, `disableFor(target)`, `status()`, `savings()`
+- `kodelyth-ecc rtk <install|enable|disable|status|gain>` — CLI subcommands to manage RTK from ECC
+- Post-install auto-hook: after `npx kodelyth-ecc --target <ide>` succeeds, ECC auto-installs the RTK binary (Homebrew on macOS, curl script elsewhere) and runs `rtk init` for the target IDE. Opt out with `--no-rtk`
+- Target map covers 10 install targets: `claude-code`, `cursor`, `cursor-project`, `windsurf-home`, `windsurf-project`, `antigravity`, `codex-home`, `opencode`, `cline`, `gemini-cli`
+- `/api/rtk` + `/api/rtk/status` dashboard endpoints — surface RTK's live ledger
+- New **RTK Savings** tab in the dashboard: total tokens saved, raw tokens seen, avg reduction %, active IDE integrations, 30-day daily bar chart
+
+### Changed
+
+- Dashboard nav order: `Overview → RTK Savings → Memory → Evolve → Catalog → Sessions`
+
+### Notes
+
+- Windows auto-install is skipped (RTK requires manual .zip download on native Windows); WSL follows the Linux path
+- RTK setup is best-effort — if brew/curl aren't available, install fails gracefully with a hint to run `kodelyth-ecc rtk install` later
+- Existing RTK installs are detected and reused; no double-install
+
 ## v1.8.6 — Memory path rename + auto-migration (July 2026)
 
 Renamed the on-disk memory root from `~/.kodelyth/` to `~/.kodelythecc/` across every runtime path. Existing installs auto-migrate on first CLI invocation or hook fire — idempotent, non-destructive, keeps a dated backup of the old directory.

package/bin/kodelyth-ecc.js

@@ -177,6 +177,59 @@ if (args[0] && args[0].startsWith('mcp-')) {
   return;
 }
 
+// ── Subcommand: rtk (Rust Token Killer integration) ──────────────────────────
+// Usage:
+//   kodelyth-ecc rtk install                install rtk binary (brew or curl)
+//   kodelyth-ecc rtk enable [--target X]    wire rtk into an IDE (default: claude-code)
+//   kodelyth-ecc rtk disable [--target X]   remove rtk hook from an IDE
+//   kodelyth-ecc rtk status                 show binary version + active integrations
+//   kodelyth-ecc rtk gain                   thin wrapper around `rtk gain`
+if (args[0] === 'rtk') {
+  const rtk = require(path.join(ROOT, 'scripts', 'rtk', 'index.js'));
+  const sub = args[1] || 'status';
+  const rest = args.slice(2);
+  function flag(name, dflt) {
+    const i = rest.indexOf(name);
+    return i >= 0 && rest[i + 1] ? rest[i + 1] : dflt;
+  }
+  const log = (m) => process.stdout.write(m + '\n');
+  try {
+    if (sub === 'install') {
+      const r = rtk.install({ log });
+      log(JSON.stringify(r, null, 2));
+      process.exit(r.installed || r.skipped ? 0 : 1);
+    }
+    if (sub === 'enable') {
+      const target = flag('--target', 'claude-code');
+      const inst = rtk.install({ log });
+      if (!rtk.isInstalled()) { log(JSON.stringify(inst, null, 2)); process.exit(1); }
+      const r = rtk.enableFor(target, { log });
+      log(JSON.stringify(r, null, 2));
+      process.exit(r.enabled ? 0 : 1);
+    }
+    if (sub === 'disable') {
+      const target = flag('--target', 'claude-code');
+      const r = rtk.disableFor(target, { log });
+      log(JSON.stringify(r, null, 2));
+      process.exit(r.disabled ? 0 : 1);
+    }
+    if (sub === 'status') {
+      log(JSON.stringify(rtk.status(), null, 2));
+      process.exit(0);
+    }
+    if (sub === 'gain') {
+      const r = spawnSync('rtk', ['gain', ...rest], { stdio: 'inherit' });
+      process.exit(r.status ?? 1);
+    }
+    process.stderr.write('unknown rtk subcommand. try: install | enable | disable | status | gain\n');
+    process.exit(2);
+  } catch (e) {
+    process.stderr.write(`[rtk] ${e.message}\n`);
+    process.exit(1);
+  }
+  return;
+}
+
 // ── Subcommand: route (cost-aware model tier recommendation) ──────────────────
 // Usage: npx kodelyth-ecc route "<task description>" [--files N] [--agent <name>] [--current <model-id>]
 if (args[0] === 'route') {
@@ -1023,5 +1076,33 @@ if (isWin) {
   }
   fs.chmodSync(sh, 0o755);
   const result = spawnSync('bash', [sh, ...args], { stdio: 'inherit', shell: false });
+
+  // Post-install: auto-install + wire RTK for the target IDE (opt-out via --no-rtk).
+  if (result.status === 0 && !args.includes('--no-rtk')) {
+    try {
+      const rtk = require(path.join(ROOT, 'scripts', 'rtk', 'index.js'));
+      const targetIdx = args.indexOf('--target');
+      const target = targetIdx >= 0 && args[targetIdx + 1] ? args[targetIdx + 1] : 'claude-code';
+      if (rtk.TARGET_MAP[target]) {
+        process.stdout.write('\n' + '─'.repeat(60) + '\n');
+        process.stdout.write('[rtk] setting up token savings (60-90% on shell commands)\n');
+        const inst = rtk.install({ log: (m) => process.stdout.write(m + '\n') });
+        if (inst.installed || inst.reason === 'already installed') {
+          const en = rtk.enableFor(target, { log: (m) => process.stdout.write(m + '\n') });
+          if (en.enabled) {
+            process.stdout.write(`[rtk] enabled for ${target} — restart your AI tool to activate\n`);
+          } else {
+            process.stdout.write(`[rtk] enable skipped: ${en.reason}\n`);
+          }
+        } else {
+          process.stdout.write(`[rtk] install skipped: ${inst.reason}\n`);
+          process.stdout.write('[rtk] you can retry later with: kodelyth-ecc rtk enable --target ' + target + '\n');
+        }
+      }
+    } catch (e) {
+      process.stderr.write(`[rtk] setup skipped: ${e.message}\n`);
+    }
+  }
+
   process.exit(result.status ?? 1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kodelyth-ecc",
-  "version": "1.8.6",
+  "version": "1.9.0",
   "description": "Production-grade AI coding toolkit — 70 agents (incl. devil-mode adversarial crew), 194 skills, 97 commands, parallel multi-agent commands, semantic intent routing, self-learning memory, and a built-in MCP server (16 tools / 6 prompts / 377 resources) that bridges to Claude Desktop, LangGraph, AutoGen, CrewAI, and OpenAI Agents SDK. Works with Claude Code, Windsurf, Cursor, Codex, Antigravity, OpenCode, Cline, RooCode, Aider, Kimi, and Gemini CLI.",
   "author": "Kodelyth <github.com/sifxprime>",
   "license": "MIT",

package/scripts/dashboard/server.js

@@ -279,6 +279,25 @@ function handleRequest(req, res) {
       return jsonResponse(res, 200, data.tokenBudgetSnapshot());
     }
 
+    if (p === '/api/rtk/status') {
+      const rtk = require('../rtk/index.js');
+      return jsonResponse(res, 200, rtk.status());
+    }
+
+    if (p === '/api/rtk') {
+      const rtk = require('../rtk/index.js');
+      const st  = rtk.status();
+      if (!st.installed) {
+        return jsonResponse(res, 200, {
+          ok: false,
+          installed: false,
+          install_hint: 'Run: kodelyth-ecc rtk install',
+        });
+      }
+      const s = rtk.savings({ days: Number(q.get('days')) || 30 });
+      return jsonResponse(res, 200, { ok: true, installed: true, version: st.version, active: st.active, ...s });
+    }
+
     if (p.startsWith('/api/')) return notFound(res);
 
     // ── static fallback ───────────────────────────────────────────────────

package/scripts/dashboard/static/index.html

@@ -220,6 +220,7 @@
       <button id="refreshBtn" class="btn-ghost" title="Refresh active tab  (R key)">Refresh</button>
       <nav class="tabs">
         <button data-tab="overview" class="active">Overview</button>
+        <button data-tab="rtk">RTK Savings</button>
         <button data-tab="memory">Memory</button>
         <button data-tab="evolve">Evolve</button>
         <button data-tab="catalog">Catalog</button>
@@ -245,6 +246,27 @@
       </div>
     </section>
 
+    <!-- ───────── RTK SAVINGS ───────── -->
+    <section data-panel="rtk" hidden>
+      <div class="grid" id="rtkCards"></div>
+      <hr class="sep">
+      <div class="row">
+        <div class="card">
+          <h2>Top saving commands</h2>
+          <div id="rtkTopCmds">loading…</div>
+        </div>
+        <div class="card">
+          <h2>Active integrations</h2>
+          <div id="rtkActive">loading…</div>
+        </div>
+      </div>
+      <hr class="sep">
+      <div class="card">
+        <h2>Daily savings (last 30 days)</h2>
+        <div id="rtkDaily">loading…</div>
+      </div>
+    </section>
+
     <!-- ───────── MEMORY ───────── -->
     <section data-panel="memory" hidden>
       <div class="grid" id="memoryCards"></div>
@@ -630,9 +652,76 @@
     }
   }
 
+  // ───── RTK loader ─────
+  async function loadRtk() {
+    try {
+      const r = await fetch('/api/rtk').then(r => r.json());
+      const cards = $('#rtkCards');
+      if (!r.installed) {
+        cards.innerHTML = `<div class="empty">RTK not installed. Install with:
+          <code>kodelyth-ecc rtk install</code>
+          <br><br>${escapeHtml(r.install_hint || '')}</div>`;
+        $('#rtkTopCmds').innerHTML = '';
+        $('#rtkActive').innerHTML  = '';
+        $('#rtkDaily').innerHTML   = '';
+        return;
+      }
+      if (!r.ok || !r.gain) {
+        cards.innerHTML = `<div class="empty">RTK installed (${escapeHtml(r.version || '')}) but no savings data yet. Use your AI tool with RTK enabled and refresh.</div>`;
+        $('#rtkTopCmds').innerHTML = '';
+        $('#rtkActive').innerHTML  = (r.active || []).map(a => `<div class="muted">• ${escapeHtml(a)}</div>`).join('') || '<div class="empty">none</div>';
+        $('#rtkDaily').innerHTML   = '';
+        return;
+      }
+      const g = r.gain || {};
+      const s = g.summary || {};
+      const totalSaved = s.total_saved   ?? 0;
+      const totalInput = s.total_input   ?? 0;
+      const percent    = s.avg_savings_pct != null ? Math.round(s.avg_savings_pct) : 0;
+      const cmdCount   = s.total_commands ?? 0;
+      cards.innerHTML = [
+        statCard(fmtN(totalSaved), 'Tokens saved (all-time)',  `${percent}% avg reduction`),
+        statCard(fmtN(cmdCount),   'Commands filtered',        'through RTK'),
+        statCard(fmtN(totalInput), 'Raw tokens seen',          'before RTK compression'),
+        statCard(escapeHtml((r.version || '—').replace(/^rtk\s+/,'')), 'RTK version', 'active binary'),
+      ].join('');
+      // Per-command breakdown — RTK's `gain` JSON does not expose this today.
+      $('#rtkTopCmds').innerHTML = `<div class="muted" style="font-size:12.5px;">
+        Per-command breakdown lives in <code>rtk discover</code>. Run it in your terminal for missed savings opportunities.
+      </div>`;
+      // Active integrations
+      $('#rtkActive').innerHTML = (r.active && r.active.length)
+        ? r.active.map(a => `<div class="muted" style="font-family:monospace;font-size:12px;">${escapeHtml(a)}</div>`).join('')
+        : '<div class="empty">no active IDE integrations detected</div>';
+      // Daily graph — simple ascii-style bars, RTK schema: g.daily[].saved_tokens
+      const daily = g.daily || [];
+      if (Array.isArray(daily) && daily.length) {
+        const max = Math.max(...daily.map(d => d.saved_tokens || 0));
+        $('#rtkDaily').innerHTML = daily.slice(-30).map(d => {
+          const saved = d.saved_tokens || 0;
+          const pct = max ? (saved / max) * 100 : 0;
+          return `<div style="display:flex;gap:8px;align-items:center;margin:3px 0;font-size:12px;">
+            <span class="muted" style="width:90px;font-family:monospace;">${escapeHtml(d.date || '')}</span>
+            <div style="flex:1;background:#f1f5f9;border-radius:3px;height:14px;overflow:hidden;">
+              <div style="background:#34d399;height:100%;width:${pct}%;"></div>
+            </div>
+            <span style="width:110px;text-align:right;font-family:monospace;">${fmtN(saved)}</span>
+          </div>`;
+        }).join('');
+      } else {
+        $('#rtkDaily').innerHTML = '<div class="empty">no daily data yet</div>';
+      }
+      setLastUpdated();
+    } catch (e) {
+      $('#rtkCards').innerHTML = `<div class="empty">failed: ${escapeHtml(e.message)}</div>`;
+    }
+  }
+  function fmtN(n) { return Number(n || 0).toLocaleString(); }
+
   // ───── tab dispatcher ─────
   function onTabShown(tab) {
     if (tab === 'overview') loadOverview();
+    if (tab === 'rtk')      loadRtk();
     if (tab === 'memory')   loadMemory();
     if (tab === 'evolve')   loadEvolve();
     if (tab === 'catalog')  loadCatalog();

package/scripts/rtk/index.js

@@ -0,0 +1,160 @@
+// scripts/rtk/index.js
+// RTK (Rust Token Killer) integration — auto-installs and wires RTK into the IDE
+// that ECC was installed for, so shell commands run through RTK's filter for
+// 60-90% token savings.
+//
+// Public API:
+//   isInstalled()          → boolean
+//   install({ log })       → { installed, method, version } | { skipped, reason }
+//   enableFor(target,{log})→ { enabled, target, agent, output } | { skipped, reason }
+//   status()               → { installed, version, agents: [...] }
+//   savings({ days })      → parsed `rtk gain --format json` snapshot or null
+'use strict';
+
+const { execFileSync, spawnSync } = require('child_process');
+const os   = require('os');
+const path = require('path');
+const fs   = require('fs');
+
+// ── ECC install target → RTK agent flag ──────────────────────────────────────
+// Reference: `rtk init --help` and RTK README "Supported AI Tools" table.
+const TARGET_MAP = {
+  'claude-code':      ['init', '-g'],
+  'cursor':           ['init', '-g', '--agent', 'cursor'],
+  'cursor-project':   ['init',       '--agent', 'cursor'],
+  'windsurf-home':    ['init', '-g', '--agent', 'windsurf'],
+  'windsurf-project': ['init',       '--agent', 'windsurf'],
+  'antigravity':      ['init',       '--agent', 'antigravity'],
+  'codex-home':       ['init', '-g', '--codex'],
+  'opencode':         ['init', '-g', '--opencode'],
+  'cline':            ['init',       '--agent', 'cline'],
+  'gemini-cli':       ['init', '-g', '--gemini'],
+};
+
+function isInstalled() {
+  try {
+    execFileSync('rtk', ['--version'], { stdio: 'ignore' });
+    return true;
+  } catch { return false; }
+}
+
+function getVersion() {
+  try {
+    return execFileSync('rtk', ['--version'], { encoding: 'utf8' }).trim();
+  } catch { return null; }
+}
+
+// ── Install RTK binary ───────────────────────────────────────────────────────
+// Mac: prefer `brew install rtk` if brew is on PATH (fastest, cached).
+// Otherwise: pipe the official install script through sh (installs to ~/.local/bin).
+// Windows: skipped (needs manual .zip download from releases).
+function install({ log = () => {} } = {}) {
+  if (isInstalled()) {
+    return { installed: false, skipped: true, reason: 'already installed', version: getVersion() };
+  }
+  if (os.platform() === 'win32') {
+    return { installed: false, skipped: true, reason: 'windows requires manual install: https://github.com/rtk-ai/rtk/releases' };
+  }
+
+  // Try Homebrew first on macOS.
+  if (os.platform() === 'darwin') {
+    try {
+      execFileSync('brew', ['--version'], { stdio: 'ignore' });
+      log('[rtk] installing via Homebrew…');
+      const r = spawnSync('brew', ['install', 'rtk'], { stdio: 'inherit' });
+      if (r.status === 0 && isInstalled()) {
+        return { installed: true, method: 'brew', version: getVersion() };
+      }
+      log('[rtk] brew install did not complete; falling back to curl script');
+    } catch { /* brew not present */ }
+  }
+
+  // Fall back to the official install script.
+  log('[rtk] installing via curl script (installs to ~/.local/bin)…');
+  const script = 'curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh';
+  const r = spawnSync('sh', ['-c', script], { stdio: 'inherit' });
+  if (r.status !== 0) {
+    return { installed: false, skipped: true, reason: 'install script failed — install rtk manually: https://github.com/rtk-ai/rtk#installation' };
+  }
+
+  // Make sure ~/.local/bin is on PATH for this process so isInstalled() succeeds.
+  const localBin = path.join(os.homedir(), '.local', 'bin');
+  if (fs.existsSync(path.join(localBin, 'rtk')) && !process.env.PATH.split(':').includes(localBin)) {
+    process.env.PATH = `${localBin}:${process.env.PATH}`;
+  }
+
+  if (!isInstalled()) {
+    return { installed: false, skipped: true, reason: 'installed to ~/.local/bin but not on PATH — add "export PATH=$HOME/.local/bin:$PATH" to your shell rc' };
+  }
+  return { installed: true, method: 'curl', version: getVersion() };
+}
+
+// ── Enable RTK for a specific IDE ────────────────────────────────────────────
+function enableFor(target, { log = () => {} } = {}) {
+  if (!isInstalled()) {
+    return { enabled: false, skipped: true, reason: 'rtk binary not on PATH' };
+  }
+  const rtkArgs = TARGET_MAP[target];
+  if (!rtkArgs) {
+    return { enabled: false, skipped: true, reason: `no RTK mapping for target "${target}"` };
+  }
+
+  log(`[rtk] wiring RTK into ${target} …`);
+  const r = spawnSync('rtk', [...rtkArgs, '--auto-patch'], { encoding: 'utf8' });
+  const output = (r.stdout || '') + (r.stderr || '');
+  if (r.status !== 0) {
+    return { enabled: false, skipped: true, reason: 'rtk init failed', output };
+  }
+  return { enabled: true, target, agent: rtkArgs.join(' '), output: output.trim() };
+}
+
+// ── Disable RTK for a specific IDE (removes hook + RTK.md) ───────────────────
+function disableFor(target, { log = () => {} } = {}) {
+  if (!isInstalled()) return { disabled: false, skipped: true, reason: 'rtk not installed' };
+  const rtkArgs = TARGET_MAP[target];
+  if (!rtkArgs) return { disabled: false, skipped: true, reason: `no RTK mapping for target "${target}"` };
+  log(`[rtk] removing RTK from ${target} …`);
+  const r = spawnSync('rtk', [...rtkArgs, '--uninstall'], { encoding: 'utf8' });
+  return { disabled: r.status === 0, output: ((r.stdout || '') + (r.stderr || '')).trim() };
+}
+
+// ── Status: what's installed, what's active ──────────────────────────────────
+function status() {
+  const installed = isInstalled();
+  if (!installed) return { installed: false, version: null, active: [] };
+  const version = getVersion();
+  const active  = [];
+  try {
+    const r = execFileSync('rtk', ['init', '--show'], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+    // Only surface the '[ok]' status rows — skip the usage help RTK prints below.
+    for (const line of r.split('\n')) {
+      const t = line.trim();
+      if (t.startsWith('[ok]') || t.startsWith('[--]')) active.push(t);
+    }
+  } catch { /* older rtk versions may not have --show */ }
+  return { installed: true, version, active };
+}
+
+// ── Savings: read `rtk gain --format json` for dashboard ─────────────────────
+function savings({ days = 30 } = {}) {
+  if (!isInstalled()) return null;
+  try {
+    const r = execFileSync('rtk', ['gain', '--all', '--format', 'json'], {
+      encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], maxBuffer: 16 * 1024 * 1024,
+    });
+    return { ok: true, days, gain: JSON.parse(r) };
+  } catch (e) {
+    return { ok: false, error: e.message };
+  }
+}
+
+module.exports = {
+  TARGET_MAP,
+  isInstalled,
+  getVersion,
+  install,
+  enableFor,
+  disableFor,
+  status,
+  savings,
+};