@nxuss/lemma 0.5.1 → 0.5.2

package/dist/cjs/utils/SavingsLedger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SavingsLedger.d.ts","sourceRoot":"","sources":["../../../src/utils/SavingsLedger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,gBAAgB,GAAG,cAAc,GAAG,mBAAmB,GAAG,OAAO,CAAC;AAE5G,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,WAAW,CAAC;IACvB,cAAc,EAAE,WAAW,CAAC;IAC5B,YAAY,EAAE,WAAW,CAAC;IAC1B,iBAAiB,EAAE,WAAW,CAAC;IAC/B,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAKD,cAAM,aAAa;IACjB,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;;IAa1C;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAY5E;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAQ9D,wDAAwD;IACxD,WAAW,IAAI,eAAe;IAgB9B,8CAA8C;IAC9C,kBAAkB,IAAI,MAAM;IA+B5B,gDAAgD;IAChD,KAAK,IAAI,IAAI;CAKd;AAED,gDAAgD;AAChD,eAAO,MAAM,aAAa,eAAsB,CAAC;AACjD,eAAe,aAAa,CAAC"}

package/dist/cjs/utils/SavingsLedger.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * SavingsLedger — Singleton accumulator for token savings across all Lemma modules.
+ *
+ * Every module (ClipboardWatcher, ContextSqueezer, ComplexityRouter, SemanticCache)
+ * calls `ledger.record(source, charsBefore, charsAfter)` — no one knows about the dashboard.
+ *
+ * The proxy exposes the ledger via GET /api/savings-breakdown for the dashboard to consume.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.savingsLedger = void 0;
+/** Average blended cost per input token across GPT-4o / Claude Sonnet / Gemini Pro */
+const AVG_COST_PER_TOKEN = 0.000008; // $0.008 per 1K tokens
+class SavingsLedger {
+    constructor() {
+        this.sessionStartedAt = new Date().toISOString();
+        this.sources = {
+            clipboard: { events: 0, tokensSaved: 0, costSaved: 0 },
+            contextSqueeze: { events: 0, tokensSaved: 0, costSaved: 0 },
+            historyPrune: { events: 0, tokensSaved: 0, costSaved: 0 },
+            complexityRouting: { events: 0, tokensSaved: 0, costSaved: 0 },
+            cache: { events: 0, tokensSaved: 0, costSaved: 0 },
+        };
+    }
+    /**
+     * Record a savings event by char counts (automatically converts to token estimate).
+     * @param source  Which module recorded the savings
+     * @param charsBefore  Original char count before compression/routing
+     * @param charsAfter   Resulting char count after compression/routing
+     */
+    record(source, charsBefore, charsAfter) {
+        const charsSaved = Math.max(0, charsBefore - charsAfter);
+        if (charsSaved === 0)
+            return;
+        const tokensSaved = Math.floor(charsSaved / 4);
+        const costSaved = tokensSaved * AVG_COST_PER_TOKEN;
+        this.sources[source].events++;
+        this.sources[source].tokensSaved += tokensSaved;
+        this.sources[source].costSaved += costSaved;
+    }
+    /**
+     * Record a savings event directly in tokens (for sources that already know their token count).
+     */
+    recordTokens(source, tokensSaved) {
+        if (tokensSaved <= 0)
+            return;
+        const costSaved = tokensSaved * AVG_COST_PER_TOKEN;
+        this.sources[source].events++;
+        this.sources[source].tokensSaved += tokensSaved;
+        this.sources[source].costSaved += costSaved;
+    }
+    /** Returns a full snapshot including computed totals */
+    getSnapshot() {
+        const total = { events: 0, tokensSaved: 0, costSaved: 0 };
+        for (const src of Object.values(this.sources)) {
+            total.events += src.events;
+            total.tokensSaved += src.tokensSaved;
+            total.costSaved += src.costSaved;
+        }
+        return {
+            ...this.sources,
+            total,
+            sessionStartedAt: this.sessionStartedAt,
+        };
+    }
+    /** Returns a pretty terminal summary block */
+    getTerminalSummary() {
+        const snap = this.getSnapshot();
+        const fmt = (n) => n.toLocaleString('en-US');
+        const fmtUSD = (n) => new Intl.NumberFormat('en-US', { style: 'currency', currency: 'USD', minimumFractionDigits: 4 }).format(n);
+        const rows = [
+            ['📋 Clipboard Squeeze', snap.clipboard.tokensSaved, snap.clipboard.costSaved],
+            ['🗜️  Context Squeeze  ', snap.contextSqueeze.tokensSaved, snap.contextSqueeze.costSaved],
+            ['📜 History Prune    ', snap.historyPrune.tokensSaved, snap.historyPrune.costSaved],
+            ['🔀 Model Routing    ', snap.complexityRouting.tokensSaved, snap.complexityRouting.costSaved],
+            ['⚡ Semantic Cache   ', snap.cache.tokensSaved, snap.cache.costSaved],
+        ];
+        const lines = [
+            '┌──────────────────────────────────────────────────────┐',
+            '│          💰 Lemma Savings Report (this session)      │',
+            '├──────────────────────────────────────────────────────┤',
+            ...rows
+                .filter(([, tokens]) => tokens > 0)
+                .map(([label, tokens, cost]) => `│  ${label}   ${fmt(tokens).padStart(7)} tokens   ${fmtUSD(cost).padStart(10)}  │`),
+            '│  ──────────────────────────────────────────────────  │',
+            `│  TOTAL                       ${fmt(snap.total.tokensSaved).padStart(7)} tokens   ${fmtUSD(snap.total.costSaved).padStart(10)}  │`,
+            '└──────────────────────────────────────────────────────┘',
+        ];
+        return lines.join('\n');
+    }
+    /** Reset all counters (e.g., on cache clear) */
+    reset() {
+        for (const key of Object.keys(this.sources)) {
+            this.sources[key] = { events: 0, tokensSaved: 0, costSaved: 0 };
+        }
+    }
+}
+/** Global singleton — import this everywhere */
+exports.savingsLedger = new SavingsLedger();
+exports.default = exports.savingsLedger;
+//# sourceMappingURL=SavingsLedger.js.map

package/dist/cjs/utils/SavingsLedger.js.map

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

package/dist/cjs/utils/reportSavings.d.ts

@@ -0,0 +1,24 @@
+/**
+ * reportSavings — Fire-and-forget helper to report token savings to the proxy's SavingsLedger.
+ *
+ * Used by processes that run separately from the proxy (e.g., MCP server, CLI tools).
+ * The proxy accumulates all savings in its in-memory SavingsLedger and serves them to the dashboard.
+ */
+type SavingsSource = 'clipboard' | 'contextSqueeze' | 'historyPrune' | 'complexityRouting' | 'cache';
+interface ReportByChars {
+    source: SavingsSource;
+    charsBefore: number;
+    charsAfter: number;
+}
+interface ReportByTokens {
+    source: SavingsSource;
+    tokens: number;
+}
+type ReportPayload = ReportByChars | ReportByTokens;
+/**
+ * Report savings to the proxy's SavingsLedger via HTTP POST.
+ * Fire-and-forget — never throws, never blocks.
+ */
+export declare function reportSavings(payload: ReportPayload): void;
+export {};
+//# sourceMappingURL=reportSavings.d.ts.map

package/dist/cjs/utils/reportSavings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportSavings.d.ts","sourceRoot":"","sources":["../../../src/utils/reportSavings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,KAAK,aAAa,GAAG,WAAW,GAAG,gBAAgB,GAAG,cAAc,GAAG,mBAAmB,GAAG,OAAO,CAAC;AAErG,UAAU,aAAa;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,cAAc;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,aAAa,GAAG,aAAa,GAAG,cAAc,CAAC;AAapD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAsB1D"}

package/dist/cjs/utils/reportSavings.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * reportSavings — Fire-and-forget helper to report token savings to the proxy's SavingsLedger.
+ *
+ * Used by processes that run separately from the proxy (e.g., MCP server, CLI tools).
+ * The proxy accumulates all savings in its in-memory SavingsLedger and serves them to the dashboard.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reportSavings = reportSavings;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const http_1 = __importDefault(require("http"));
+function getProxyPort() {
+    try {
+        const HOME = process.env.HOME || process.env.USERPROFILE || '~';
+        const portFile = path_1.default.join(HOME, '.lemma-cache/proxy.port');
+        if (fs_1.default.existsSync(portFile)) {
+            return fs_1.default.readFileSync(portFile, 'utf8').trim();
+        }
+    }
+    catch { }
+    return '8081';
+}
+/**
+ * Report savings to the proxy's SavingsLedger via HTTP POST.
+ * Fire-and-forget — never throws, never blocks.
+ */
+function reportSavings(payload) {
+    try {
+        const port = getProxyPort();
+        const body = JSON.stringify(payload);
+        const req = http_1.default.request({
+            hostname: '127.0.0.1',
+            port: parseInt(port),
+            path: '/api/savings-record',
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(body),
+            },
+        });
+        req.on('error', () => { }); // Silently ignore if proxy isn't running
+        req.write(body);
+        req.end();
+    }
+    catch {
+        // Never throw — savings reporting is non-critical
+    }
+}
+//# sourceMappingURL=reportSavings.js.map

package/dist/cjs/utils/reportSavings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportSavings.js","sourceRoot":"","sources":["../../../src/utils/reportSavings.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;AAoCH,sCAsBC;AAxDD,4CAAoB;AACpB,gDAAwB;AACxB,gDAAwB;AAiBxB,SAAS,YAAY;IACnB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC;QAChE,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC;QAC5D,IAAI,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IACV,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,OAAsB;IAClD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAErC,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC;YACvB,QAAQ,EAAE,WAAW;YACrB,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;YACpB,IAAI,EAAE,qBAAqB;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;aAC1C;SACF,CAAC,CAAC;QAEH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,yCAAyC;QACpE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChB,GAAG,CAAC,GAAG,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;IACpD,CAAC;AACH,CAAC"}

package/dist/esm/cli/lemma-proxy.d.ts

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+export declare function autoConfigureAll(projectName?: string): void;
+export declare function startBackgroundClipboardWatcher(): void;
 export declare function performAutoHeal(apply: boolean): Promise<{
     success: boolean;
     message: string;

package/dist/esm/cli/lemma-proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lemma-proxy.d.ts","sourceRoot":"","sources":["../../../src/cli/lemma-proxy.ts"],"names":[],"mappings":";AAw3CA,wBAAsB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA6KhL"}
+{"version":3,"file":"lemma-proxy.d.ts","sourceRoot":"","sources":["../../../src/cli/lemma-proxy.ts"],"names":[],"mappings":";AAoNA,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CA0I3D;AAED,wBAAgB,+BAA+B,IAAI,IAAI,CAyCtD;AAmsCD,wBAAsB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA6KhL"}

package/dist/esm/cli/lemma-proxy.js

@@ -24,7 +24,7 @@ function getVersion() {
             catch { }
         }
     }
-    return '0.4.6';
+    return '0.5.2';
 }
 const VERSION = getVersion();
 import ComplexityRouter from '../proxy/ComplexityRouter';
@@ -32,6 +32,7 @@ import SemanticScrubber from '../security/SemanticScrubber';
 import CloudSyncClient from '../cloud/CloudSyncClient';
 import { pruneHistoryMessages, squeezePrompt } from '../utils/ContextSqueezer';
 import { AgentMultiplexer } from '../proxy/AgentMultiplexer';
+import { savingsLedger } from '../utils/SavingsLedger';
 const chroma = new ChromaClient({ host: 'localhost', port: 8000 });
 const dummyEmbeddingFunction = { generate: (texts) => Promise.resolve([]) };
 const complexityRouter = new ComplexityRouter();
@@ -53,6 +54,13 @@ function logEvent(event) {
     EVENT_LOG.push(ev);
     if (EVENT_LOG.length > MAX_EVENTS)
         EVENT_LOG.shift();
+    // Print a terminal savings summary every 10 events
+    if (EVENT_LOG.length > 0 && EVENT_LOG.length % 10 === 0) {
+        const snap = savingsLedger.getSnapshot();
+        if (snap.total.tokensSaved > 0) {
+            console.log('\n' + savingsLedger.getTerminalSummary() + '\n');
+        }
+    }
 }
 const FREE_LIMIT = 500;
 const WARN_PCT = 0.8;
@@ -193,6 +201,182 @@ function ensureGitIgnore() {
     catch { }
     return added;
 }
+const CLIPBOARD_PID_FILE = path.join(CACHE_DIR, 'clipboard.pid');
+export function autoConfigureAll(projectName) {
+    const project = projectName || detectProject();
+    const HOME = process.env.HOME || process.env.USERPROFILE || '~';
+    // 1. Claude Desktop Config
+    try {
+        const isWin = process.platform === 'win32';
+        const claudePath = isWin
+            ? path.join(process.env.APPDATA || '', 'Claude/claude_desktop_config.json')
+            : path.join(HOME, 'Library/Application Support/Claude/claude_desktop_config.json');
+        if (fs.existsSync(path.dirname(claudePath))) {
+            let config = { mcpServers: {} };
+            if (fs.existsSync(claudePath)) {
+                try {
+                    config = JSON.parse(fs.readFileSync(claudePath, 'utf8'));
+                }
+                catch { }
+            }
+            if (!config.mcpServers)
+                config.mcpServers = {};
+            config.mcpServers.lemma = {
+                command: 'npx',
+                args: ['-y', '@nxuss/lemma', 'mcp'],
+                env: { LEMMA_PROJECT: project }
+            };
+            fs.writeFileSync(claudePath, JSON.stringify(config, null, 2));
+            console.log(`✅ [Claude Desktop] Configured automatically! (Restart Claude to activate)`);
+        }
+    }
+    catch (e) {
+        console.log(`⚠️  Could not auto-configure Claude Desktop: ${e.message}`);
+    }
+    // 2. Shell Profiles Environment Override
+    try {
+        const profiles = [
+            path.join(HOME, '.zshrc'),
+            path.join(HOME, '.bashrc'),
+            path.join(HOME, '.bash_profile'),
+            path.join(HOME, '.profile')
+        ];
+        const lines = [
+            '',
+            '# Lemma AI Gateway Overrides',
+            'export OPENAI_BASE_URL="http://localhost:8081/v1"',
+            'export ANTHROPIC_BASE_URL="http://localhost:8081"',
+            'export LEMMA_PROJECT="' + project + '"',
+            ''
+        ].join('\n');
+        for (const profile of profiles) {
+            if (fs.existsSync(profile)) {
+                try {
+                    const content = fs.readFileSync(profile, 'utf8');
+                    if (!content.includes('OPENAI_BASE_URL') && !content.includes('LEMMA_PROJECT')) {
+                        fs.appendFileSync(profile, lines);
+                        console.log(`✅ [Shell Profile] Configured ${path.basename(profile)} with local redirect variables!`);
+                    }
+                }
+                catch { }
+            }
+        }
+    }
+    catch (e) {
+        console.log(`⚠️  Could not auto-configure shell profiles: ${e.message}`);
+    }
+    // 3. Cursor & Windsurf settings.json updates
+    try {
+        const isWin = process.platform === 'win32';
+        const isMac = process.platform === 'darwin';
+        const candidates = [];
+        if (isMac) {
+            candidates.push({
+                name: 'Cursor',
+                path: path.join(HOME, 'Library/Application Support/Cursor/User/settings.json')
+            });
+            candidates.push({
+                name: 'Windsurf',
+                path: path.join(HOME, 'Library/Application Support/Windsurf/User/settings.json')
+            });
+        }
+        else if (isWin) {
+            const appData = process.env.APPDATA || '';
+            candidates.push({
+                name: 'Cursor',
+                path: path.join(appData, 'Cursor/User/settings.json')
+            });
+            candidates.push({
+                name: 'Windsurf',
+                path: path.join(appData, 'Windsurf/User/settings.json')
+            });
+        }
+        else {
+            candidates.push({
+                name: 'Cursor',
+                path: path.join(HOME, '.config/Cursor/User/settings.json')
+            });
+            candidates.push({
+                name: 'Windsurf',
+                path: path.join(HOME, '.config/Windsurf/User/settings.json')
+            });
+        }
+        for (const cand of candidates) {
+            const dir = path.dirname(cand.path);
+            if (fs.existsSync(dir)) {
+                let settings = {};
+                if (fs.existsSync(cand.path)) {
+                    try {
+                        settings = JSON.parse(fs.readFileSync(cand.path, 'utf8'));
+                    }
+                    catch { }
+                }
+                let updated = false;
+                // Settings configuration to route custom openai/anthropic models through the proxy
+                const updates = {
+                    "openai.baseURL": "http://localhost:8081/v1",
+                    "openai.apiKey": "dummy-key-for-lemma",
+                    "anthropic.baseURL": "http://localhost:8081",
+                    "anthropic.apiKey": "dummy-key-for-lemma"
+                };
+                for (const [key, value] of Object.entries(updates)) {
+                    if (settings[key] !== value) {
+                        settings[key] = value;
+                        updated = true;
+                    }
+                }
+                if (updated) {
+                    fs.writeFileSync(cand.path, JSON.stringify(settings, null, 2));
+                    console.log(`✅ [${cand.name}] Configured editor settings to route via local gateway!`);
+                }
+            }
+        }
+    }
+    catch (e) {
+        console.log(`⚠️  Could not auto-configure editor settings: ${e.message}`);
+    }
+}
+export function startBackgroundClipboardWatcher() {
+    try {
+        if (fs.existsSync(CLIPBOARD_PID_FILE)) {
+            const oldPid = fs.readFileSync(CLIPBOARD_PID_FILE, 'utf8');
+            try {
+                process.kill(parseInt(oldPid, 10), 0); // Check if process is still alive
+                console.log(`✅ [Clipboard] Watcher is already running in background (PID: ${oldPid})`);
+                return;
+            }
+            catch {
+                // Process is dead, clean up pid file
+                try {
+                    fs.unlinkSync(CLIPBOARD_PID_FILE);
+                }
+                catch { }
+            }
+        }
+        console.log(`🔄 Starting Clipboard Watcher in background...`);
+        const { spawn } = require('child_process');
+        // Resolve path of lemma command or script
+        const scriptPath = fs.existsSync(path.join(__dirname, 'dist', 'cjs', 'cli', 'lemma-proxy.js'))
+            ? path.join(__dirname, 'dist', 'cjs', 'cli', 'lemma-proxy.js')
+            : (fs.existsSync(path.join(__dirname, 'lemma-proxy.ts')) ? path.join(__dirname, 'lemma-proxy.ts') : __filename);
+        const isTs = scriptPath.endsWith('.ts');
+        const cmd = isTs ? 'npx' : 'node';
+        const args = isTs ? ['tsx', scriptPath, 'clipboard'] : [scriptPath, 'clipboard'];
+        const cp = spawn(cmd, args, {
+            stdio: 'ignore',
+            detached: true,
+            env: { ...process.env }
+        });
+        cp.unref();
+        if (cp.pid) {
+            fs.writeFileSync(CLIPBOARD_PID_FILE, String(cp.pid));
+            console.log(`✅ [Clipboard] Watcher has been started (PID: ${cp.pid})`);
+        }
+    }
+    catch (err) {
+        console.error(`❌ Failed to automatically start Clipboard Watcher in background: ${err.message}`);
+    }
+}
 // ── License helpers ────────────────────────────────────────────────────────────
 async function loadLicense() {
     return readJson(LICENSE_FILE, { isPro: false });
@@ -697,6 +881,7 @@ class LemmaServer {
                 const count = CACHE.size;
                 CACHE.clear();
                 EVENT_LOG.length = 0; // Clear live event log
+                savingsLedger.reset(); // Reset savings counters
                 // Reset and persist statistics for the current project
                 if (this.stats[this.projectName]) {
                     this.stats[this.projectName] = {
@@ -711,6 +896,25 @@ class LemmaServer {
                 }
                 res.json({ success: true, clearedEntries: count });
             });
+            // Savings breakdown by source for the dashboard
+            this.app.get('/api/savings-breakdown', (req, res) => {
+                res.json(savingsLedger.getSnapshot());
+            });
+            // Cross-process savings reporter — MCP and other processes POST here
+            this.app.post('/api/savings-record', (req, res) => {
+                const { source, charsBefore, charsAfter, tokens } = req.body || {};
+                const validSources = ['clipboard', 'contextSqueeze', 'historyPrune', 'complexityRouting', 'cache'];
+                if (!source || !validSources.includes(source)) {
+                    return res.status(400).json({ error: 'Invalid source' });
+                }
+                if (typeof tokens === 'number' && tokens > 0) {
+                    savingsLedger.recordTokens(source, tokens);
+                }
+                else if (typeof charsBefore === 'number' && typeof charsAfter === 'number') {
+                    savingsLedger.record(source, charsBefore, charsAfter);
+                }
+                res.json({ ok: true, snapshot: savingsLedger.getSnapshot().total });
+            });
             this.app.get('/dashboard/*', (req, res) => res.sendFile(path.join(this.dashboardPath, 'index.html')));
         }
     }
@@ -738,6 +942,13 @@ class LemmaServer {
         const model = routingDecision.model;
         if (req.body.model)
             req.body.model = model;
+        // Record complexity routing savings when model is downgraded
+        if (routingDecision.complexity === 'low' && model !== originalModel) {
+            // Estimated token savings: cheap model costs ~5x less, so avg prompt of ~800 tokens saves ~640 tokens
+            const estimatedPromptTokens = Math.floor(prompt.length / 4);
+            const routingSavings = Math.floor(estimatedPromptTokens * 0.8); // conservative 80% cost reduction
+            savingsLedger.recordTokens('complexityRouting', routingSavings);
+        }
         // Apply the Agent Multiplexer to local-verify the prompt in parallel
         const enrichedPrompt = await agentMultiplexer.multiplexPrompt(prompt, model);
         // Resolve conversation session key and retrieve/create the fileHistory map
@@ -760,6 +971,7 @@ class LemmaServer {
         const squeezedPrompt = squeezeResult.squeezed;
         const compressionSavings = squeezeResult.originalSize - squeezeResult.squeezedSize;
         if (compressionSavings > 0) {
+            savingsLedger.record('contextSqueeze', squeezeResult.originalSize, squeezeResult.squeezedSize);
             console.log(`⚡ [Squeezer] Compressed prompt from ${squeezeResult.originalSize} to ${squeezeResult.squeezedSize} chars (Saved ${(squeezeResult.compressionRatio * 100).toFixed(1)}% context tokens!)`);
         }
         if (provider === 'openai' || provider === 'anthropic') {
@@ -769,6 +981,9 @@ class LemmaServer {
                 const pruneResult = pruneHistoryMessages(req.body.messages);
                 req.body.messages = pruneResult.messages;
                 historyTokensSaved = pruneResult.tokensSavedEstimate + Math.floor(compressionSavings / 4);
+                if (pruneResult.tokensSavedEstimate > 0) {
+                    savingsLedger.recordTokens('historyPrune', pruneResult.tokensSavedEstimate);
+                }
             }
         }
         else if (provider === 'gemini') {
@@ -781,7 +996,9 @@ class LemmaServer {
         }
         const hit = cacheGet(provider, prompt);
         if (hit) {
-            await recordStat(this.stats, this.projectName, true, Date.now() - t0, provider, 2000 + historyTokensSaved);
+            const cacheTokensSaved = 2000 + historyTokensSaved;
+            savingsLedger.recordTokens('cache', cacheTokensSaved);
+            await recordStat(this.stats, this.projectName, true, Date.now() - t0, provider, cacheTokensSaved);
             const unmaskedData = semanticScrubber.unmask(hit.data, tokenMap);
             if (isStream)
                 return simulateHitStream(res, unmaskedData, provider, model, tier, 1.0);
@@ -1046,10 +1263,17 @@ program.command('start')
         if (resp.data && resp.data.status === 'ok') {
             console.log(`\n⚠️  Lemma Proxy is already running on port ${port} (Project: ${resp.data.project})`);
             console.log(`💡 Use 'lemma status' for details or 'lemma stop' to restart.\n`);
+            // Keep configurations up to date even if server was already started
+            const runningProject = resp.data.project || detectProject();
+            autoConfigureAll(runningProject);
+            startBackgroundClipboardWatcher();
             process.exit(0);
         }
     }
     catch { }
+    const startProject = opts.project || detectProject();
+    autoConfigureAll(startProject);
+    startBackgroundClipboardWatcher();
     // Automatically enable autopilot if stack is enabled and user is Pro
     const runAutopilot = opts.autopilot || opts.stack;
     if (runAutopilot) {
@@ -1148,6 +1372,19 @@ program.command('stop')
     }
     if (fs.existsSync(PID_FILE))
         fs.unlinkSync(PID_FILE);
+    // Stop background Clipboard Watcher if active
+    try {
+        if (fs.existsSync(CLIPBOARD_PID_FILE)) {
+            const cbPid = fs.readFileSync(CLIPBOARD_PID_FILE, 'utf8');
+            try {
+                process.kill(parseInt(cbPid, 10), 'SIGTERM');
+                console.log(`✅ Stopped background Clipboard Watcher (PID: ${cbPid})`);
+            }
+            catch { }
+            fs.unlinkSync(CLIPBOARD_PID_FILE);
+        }
+    }
+    catch { }
 });
 program.command('status')
     .description('Check proxy status')
@@ -1241,41 +1478,8 @@ program.command('init')
         fs.writeFileSync(envFile, lemmaConfig);
         console.log('✅ Created .env with Lemma configuration');
     }
-    console.log('\n🧠 \x1b[35mAuto-Setup MCP for AI IDEs?\x1b[0m');
-    console.log('   Lemma can automatically configure Claude Desktop and open settings for Cursor/Windsurf.');
-    const { exec } = require('child_process');
-    const isWin = process.platform === 'win32';
-    const claudePath = isWin
-        ? path.join(process.env.APPDATA || '', 'Claude/claude_desktop_config.json')
-        : path.join(process.env.HOME || '~', 'Library/Application Support/Claude/claude_desktop_config.json');
-    if (fs.existsSync(path.dirname(claudePath))) {
-        try {
-            let config = { mcpServers: {} };
-            if (fs.existsSync(claudePath)) {
-                config = JSON.parse(fs.readFileSync(claudePath, 'utf8'));
-            }
-            if (!config.mcpServers)
-                config.mcpServers = {};
-            config.mcpServers.lemma = {
-                command: 'npx',
-                args: ['-y', '@nxuss/lemma', 'mcp'],
-                env: { LEMMA_PROJECT: project }
-            };
-            fs.writeFileSync(claudePath, JSON.stringify(config, null, 2));
-            console.log(`✅ \x1b[32mClaude Desktop configured automatically!\x1b[0m (Restart Claude to activate)`);
-        }
-        catch (e) {
-            console.log('⚠️  Could not auto-configure Claude Desktop. No worries, you can do it manually.');
-        }
-    }
-    console.log('🚀 Opening IDE configuration pages...');
-    const urls = [
-        'https://docs.anthropic.com/en/docs/agents-and-tools/mcp#using-mcp-in-claude-desktop',
-        'https://cursor.com',
-        'https://codeium.com/windsurf'
-    ];
-    const opener = process.platform === 'darwin' ? 'open' : (process.platform === 'win32' ? 'start' : 'xdg-open');
-    urls.forEach(url => exec(`${opener} ${url}`));
+    console.log('\n🧠 \x1b[35mAuto-Setup MCP and redirection overrides for AI IDEs...\x1b[0m');
+    autoConfigureAll(project);
     console.log('\n✨ Project initialized for the Agentic Era!');
     console.log('🚀 Run "lemma start" to begin.\n');
 });