@claude-flow/cli 3.10.46 → 3.12.0

package/dist/src/commands/eject.js

@@ -0,0 +1,195 @@
+/**
+ * V3 CLI Eject Command — ADR-150 Phase-2 differentiator.
+ *
+ * Lifts the calling ruflo/claude-flow project into a renamed standalone
+ * harness using `metaharness --from-existing <dir>`. Attribution to
+ * ruflo is preserved via the upstream's `<!-- ruflo-attribution-block -->`
+ * convention.
+ *
+ *   npx ruflo eject --name my-harness                  # dry-run plan
+ *   npx ruflo eject --name my-harness --confirm        # actually eject
+ *   npx ruflo eject --name my-harness --target /abs/out --confirm
+ *
+ * SAFETY GATES (load-bearing)
+ *   1. Dry-run by default. `--confirm` required for any disk write.
+ *   2. `--target` MUST resolve OUTSIDE the calling repo root. Default
+ *      is `/tmp/ruflo-eject-<ts>-<name>/`. Writing to the calling repo
+ *      is refused with exit 2 — protects the user from `cwd: $ruflo`
+ *      eject accidents.
+ *   3. Refuses existing target dirs (no overwrites).
+ *   4. Subprocess + 10-minute hard timeout. No library import; no
+ *      static `@metaharness/*` dependency.
+ *
+ * ADR-150 ARCHITECTURAL CONSTRAINT
+ *   When metaharness is unavailable (offline, no network), the command
+ *   exits 0 with a structured "feature not available" message. Ruflo
+ *   continues to function — rule #3 (graceful degradation).
+ *
+ * Created with ruv.io
+ */
+import { output } from '../output.js';
+import { spawnSync } from 'child_process';
+import { existsSync } from 'fs';
+import { resolve as resolvePath } from 'path';
+import { tmpdir } from 'os';
+function parseArgs(args) {
+    const o = { name: null, target: null, confirm: false, format: 'table' };
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === '--name')
+            o.name = args[++i] || null;
+        else if (a === '--target')
+            o.target = args[++i] || null;
+        else if (a === '--confirm')
+            o.confirm = true;
+        else if (a === '--format')
+            o.format = (args[++i] || 'table');
+    }
+    return o;
+}
+function runEject(targetDir, name) {
+    const r = spawnSync('npx', ['-y', 'metaharness@latest', '--from-existing', process.cwd(), '--name', name, '--target', targetDir, '--yes'], {
+        stdio: 'inherit',
+        env: process.env,
+        timeout: 10 * 60 * 1000,
+        shell: process.platform === 'win32',
+    });
+    const stderr = ''; // stdio: inherit — captured by terminal not by us
+    if (r.status === null) {
+        return { exitCode: 124, stderr: 'subprocess timed out after 10 minutes', degraded: false };
+    }
+    if (r.error && /ENOENT|spawn/.test(String(r.error.message || ''))) {
+        return { exitCode: 127, stderr: 'metaharness binary unavailable', degraded: true };
+    }
+    return { exitCode: r.status, stderr };
+}
+export const ejectCommand = {
+    name: 'eject',
+    description: 'Lift the calling ruflo project into a renamed standalone harness via metaharness --from-existing (ADR-150 Phase 2). Dry-run by default; --confirm required to write.',
+    options: [
+        {
+            name: 'name',
+            description: 'Name for the ejected harness (required)',
+            type: 'string',
+            required: false,
+        },
+        {
+            name: 'target',
+            description: 'Absolute output dir (default: /tmp/ruflo-eject-<ts>-<name>/); refused if inside the calling repo',
+            type: 'string',
+        },
+        {
+            name: 'confirm',
+            description: 'Actually write the eject. Without this flag the command prints a dry-run plan and exits.',
+            type: 'boolean',
+            default: false,
+        },
+        {
+            name: 'format',
+            description: 'Output format: table | json',
+            type: 'string',
+            default: 'table',
+        },
+    ],
+    examples: [
+        { command: 'npx ruflo eject --name my-harness', description: 'Dry-run; prints what would happen' },
+        {
+            command: 'npx ruflo eject --name my-harness --confirm',
+            description: 'Eject to /tmp/ruflo-eject-<ts>-my-harness/',
+        },
+        {
+            command: 'npx ruflo eject --name my-harness --target /abs/out --confirm',
+            description: 'Eject to a specific dir (must be outside the calling repo)',
+        },
+    ],
+    async action(context) {
+        // iter 128 — flags declared on the Command get parsed by the CLI parser
+        // and land in context.flags (NOT context.options or context.args).
+        // Fall back to parseArgs(context.args) for programmatic invocations
+        // where the parser wasn't used (e.g. unit tests).
+        const ctx = context;
+        const parsedArgs = parseArgs(ctx.args || []);
+        const flagName = ctx.flags?.name;
+        const flagTarget = ctx.flags?.target;
+        const flagConfirm = ctx.flags?.confirm;
+        const flagFormat = ctx.flags?.format;
+        const opts = {
+            name: flagName || parsedArgs.name,
+            target: flagTarget || parsedArgs.target,
+            confirm: typeof flagConfirm === 'boolean' ? flagConfirm : parsedArgs.confirm,
+            format: (flagFormat || parsedArgs.format),
+        };
+        if (!opts.name) {
+            output.writeln(output.error('eject: --name is required'));
+            output.writeln('');
+            output.writeln('Example: npx ruflo eject --name my-harness');
+            return { success: false, exitCode: 2, data: { error: 'name-required' } };
+        }
+        // Safety: resolve target, refuse calling-repo paths.
+        const repoRoot = resolvePath(process.cwd());
+        const target = opts.target
+            ? resolvePath(opts.target)
+            : resolvePath(tmpdir(), `ruflo-eject-${Date.now()}-${opts.name}`);
+        if (target === repoRoot || target.startsWith(repoRoot + '/')) {
+            output.writeln(output.error(`eject: refusing to write to ${target}`));
+            output.writeln(output.error(`This is inside the calling repo (${repoRoot}). Pick a --target OUTSIDE the repo.`));
+            return { success: false, exitCode: 2, data: { error: 'target-inside-repo', target, repoRoot } };
+        }
+        if (existsSync(target)) {
+            output.writeln(output.error(`eject: target ${target} already exists — refusing to overwrite`));
+            return { success: false, exitCode: 2, data: { error: 'target-exists', target } };
+        }
+        const plan = {
+            name: opts.name,
+            sourceRepo: repoRoot,
+            target,
+            confirm: opts.confirm,
+            command: `npx -y metaharness@latest --from-existing ${repoRoot} --name ${opts.name} --target ${target} --yes`,
+        };
+        if (!opts.confirm) {
+            if (opts.format === 'json') {
+                output.writeln(JSON.stringify({ ...plan, dryRun: true }, null, 2));
+            }
+            else {
+                output.writeln(output.bold('# ruflo eject (dry-run)'));
+                output.writeln('');
+                output.writeln(`name:       ${plan.name}`);
+                output.writeln(`sourceRepo: ${plan.sourceRepo}`);
+                output.writeln(`target:     ${plan.target}`);
+                output.writeln('');
+                output.writeln(output.dim('Would execute:'));
+                output.writeln(output.dim(`  ${plan.command}`));
+                output.writeln('');
+                output.writeln('Re-run with --confirm to actually eject.');
+            }
+            return { success: true, exitCode: 0, data: { ...plan, dryRun: true } };
+        }
+        // Actually run.
+        output.writeln(output.bold('# ruflo eject — running'));
+        output.writeln('');
+        output.writeln(`Ejecting ${repoRoot} → ${target} as "${opts.name}"...`);
+        output.writeln('');
+        const r = runEject(target, opts.name);
+        if (r.degraded) {
+            output.writeln(output.warning('eject: metaharness binary unavailable — feature degraded'));
+            output.writeln(output.dim('(ADR-150 graceful degradation: ruflo runs without it; install with `npm i -D metaharness`.)'));
+            return { success: true, exitCode: 0, data: { ...plan, degraded: true, reason: 'metaharness-not-available' } };
+        }
+        if (r.exitCode !== 0) {
+            output.writeln(output.error(`eject: metaharness exited ${r.exitCode}`));
+            if (r.stderr)
+                output.writeln(output.dim(r.stderr.slice(0, 400)));
+            return { success: false, exitCode: r.exitCode, data: { ...plan, exitCode: r.exitCode } };
+        }
+        output.writeln('');
+        output.writeln(output.bold(`✓ Ejected to ${target}`));
+        output.writeln('');
+        output.writeln(output.dim('Next steps:'));
+        output.writeln(output.dim(`  cd ${target}`));
+        output.writeln(output.dim('  npm install'));
+        output.writeln(output.dim('  npx harness doctor'));
+        return { success: true, exitCode: 0, data: { ...plan, ejected: true } };
+    },
+};
+export default ejectCommand;
+//# sourceMappingURL=eject.js.map

package/dist/src/commands/eject.js.map

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

package/dist/src/commands/embeddings.js

@@ -147,13 +147,13 @@ const searchCommand = {
             // Get all entries with embeddings from database
             // Parameterized query to prevent SQL injection (CRIT-01)
             const embeddingSql = namespace !== 'all'
-                ? `SELECT id, key, namespace, content, embedding, embedding_dimensions
-           FROM memory_entries
-           WHERE status = 'active' AND embedding IS NOT NULL AND namespace = ?
+                ? `SELECT id, key, namespace, content, embedding, embedding_dimensions
+           FROM memory_entries
+           WHERE status = 'active' AND embedding IS NOT NULL AND namespace = ?
            LIMIT 1000`
-                : `SELECT id, key, namespace, content, embedding, embedding_dimensions
-           FROM memory_entries
-           WHERE status = 'active' AND embedding IS NOT NULL
+                : `SELECT id, key, namespace, content, embedding, embedding_dimensions
+           FROM memory_entries
+           WHERE status = 'active' AND embedding IS NOT NULL
            LIMIT 1000`;
             const embeddingStmt = db.prepare(embeddingSql);
             if (namespace !== 'all') {
@@ -192,16 +192,16 @@ const searchCommand = {
                 const likePattern = `%${query}%`;
                 const remainingLimit = Math.max(0, limit - results.length);
                 const keywordSql = namespace !== 'all'
-                    ? `SELECT id, key, namespace, content
-             FROM memory_entries
-             WHERE status = 'active'
-               AND (content LIKE ? OR key LIKE ?)
-               AND namespace = ?
+                    ? `SELECT id, key, namespace, content
+             FROM memory_entries
+             WHERE status = 'active'
+               AND (content LIKE ? OR key LIKE ?)
+               AND namespace = ?
              LIMIT ?`
-                    : `SELECT id, key, namespace, content
-             FROM memory_entries
-             WHERE status = 'active'
-               AND (content LIKE ? OR key LIKE ?)
+                    : `SELECT id, key, namespace, content
+             FROM memory_entries
+             WHERE status = 'active'
+               AND (content LIKE ? OR key LIKE ?)
              LIMIT ?`;
                 const keywordStmt = db.prepare(keywordSql);
                 if (namespace !== 'all') {
@@ -408,17 +408,17 @@ const collectionsCommand = {
             const fileBuffer = fs.readFileSync(fullDbPath);
             const db = new SQL.Database(fileBuffer);
             // Get collection stats from database
-            const statsQuery = db.exec(`
-        SELECT
-          namespace,
-          COUNT(*) as total_entries,
-          SUM(CASE WHEN embedding IS NOT NULL THEN 1 ELSE 0 END) as with_embeddings,
-          AVG(embedding_dimensions) as avg_dimensions,
-          SUM(LENGTH(content)) as total_content_size
-        FROM memory_entries
-        WHERE status = 'active'
-        GROUP BY namespace
-        ORDER BY total_entries DESC
+            const statsQuery = db.exec(`
+        SELECT
+          namespace,
+          COUNT(*) as total_entries,
+          SUM(CASE WHEN embedding IS NOT NULL THEN 1 ELSE 0 END) as with_embeddings,
+          AVG(embedding_dimensions) as avg_dimensions,
+          SUM(LENGTH(content)) as total_content_size
+        FROM memory_entries
+        WHERE status = 'active'
+        GROUP BY namespace
+        ORDER BY total_entries DESC
       `);
             // Get vector index info
             const indexQuery = db.exec(`SELECT name, dimensions, hnsw_m FROM vector_indexes`);

package/dist/src/commands/hive-mind.js

@@ -51,103 +51,103 @@ function generateHiveMindPrompt(swarmId, swarmName, objective, workers, workerGr
     const queenType = flags.queenType || 'strategic';
     const consensusAlgorithm = flags.consensus || 'byzantine';
     const topology = flags.topology || 'hierarchical-mesh';
-    return `🧠 HIVE MIND COLLECTIVE INTELLIGENCE SYSTEM
-═══════════════════════════════════════════════
-
-You are the Queen coordinator of a Hive Mind swarm with collective intelligence capabilities.
-
-HIVE MIND CONFIGURATION:
-📌 Swarm ID: ${swarmId}
-📌 Swarm Name: ${swarmName}
-🎯 Objective: ${objective}
-👑 Queen Type: ${queenType}
-🐝 Worker Count: ${workers.length}
-🔗 Topology: ${topology}
-🤝 Consensus Algorithm: ${consensusAlgorithm}
-⏰ Initialized: ${currentTime}
-
-WORKER DISTRIBUTION:
-${workerTypes.map(type => `• ${type}: ${workerGroups[type].length} agents`).join('\n')}
-
-🔧 AVAILABLE MCP TOOLS FOR HIVE MIND COORDINATION:
-
-1️⃣ **COLLECTIVE INTELLIGENCE**
-   mcp__ruflo__hive-mind_consensus    - Democratic decision making
-   mcp__ruflo__hive-mind_memory       - Share knowledge across the hive
-   mcp__ruflo__hive-mind_broadcast    - Broadcast to all workers
-   mcp__ruflo__neural_patterns        - Neural pattern recognition
-
-2️⃣ **QUEEN COORDINATION**
-   mcp__ruflo__hive-mind_status       - Monitor swarm health
-   mcp__ruflo__task_create            - Create and delegate tasks
-   mcp__ruflo__coordination_orchestrate - Orchestrate task distribution
-   mcp__ruflo__agent_spawn            - Spawn additional workers
-
-3️⃣ **WORKER MANAGEMENT**
-   mcp__ruflo__agent_list             - List all active agents
-   mcp__ruflo__agent_status           - Check agent status
-   mcp__ruflo__agent_health           - Check worker health
-   mcp__ruflo__hive-mind_join         - Add agent to hive
-   mcp__ruflo__hive-mind_leave        - Remove agent from hive
-
-4️⃣ **TASK ORCHESTRATION**
-   mcp__ruflo__task_assign            - Assign tasks to workers
-   mcp__ruflo__task_status            - Track task progress
-   mcp__ruflo__task_complete          - Mark tasks complete
-   mcp__ruflo__workflow_create        - Create workflows
-
-5️⃣ **MEMORY & LEARNING**
-   mcp__ruflo__memory_store           - Store collective knowledge
-   mcp__ruflo__memory_retrieve        - Access shared memory
-   mcp__ruflo__memory_search          - Search memory patterns
-   mcp__ruflo__neural_train           - Learn from experiences
-   mcp__ruflo__hooks_intelligence_pattern-store - Store patterns
-
-📋 HIVE MIND EXECUTION PROTOCOL:
-
-1. **INITIALIZATION PHASE**
-   - Verify all workers are online and responsive
-   - Establish communication channels
-   - Load previous session state if available
-   - Initialize shared memory space
-
-2. **TASK DISTRIBUTION PHASE**
-   - Analyze the objective and decompose into subtasks
-   - Assign tasks based on worker specializations
-   - Set up task dependencies and ordering
-   - Monitor parallel execution
-
-3. **COORDINATION PHASE**
-   - Use consensus for critical decisions
-   - Aggregate results from workers
-   - Resolve conflicts using ${consensusAlgorithm} consensus
-   - Share learnings across the hive
-
-4. **COMPLETION PHASE**
-   - Verify all subtasks are complete
-   - Consolidate results
-   - Store learnings in collective memory
-   - Report final status
-
-🎯 YOUR OBJECTIVE:
-${objective}
-
-⚠️ CRITICAL — TOOL PREFERENCE RULES (#1422):
-• You MUST use Ruflo MCP tools (mcp__ruflo__*) for ALL orchestration tasks
-• Do NOT use Claude native Task/Agent tools for swarm coordination — use mcp__ruflo__agent_spawn, mcp__ruflo__task_assign, etc.
-• Native Claude tools (Read, Write, Edit, Bash, Grep, Glob) should ONLY be used for file operations and shell commands
-• All agent spawning, task assignment, memory, and coordination MUST go through mcp__ruflo__* tools
-• If a Ruflo MCP tool exists for an operation, always prefer it over any native equivalent
-
-💡 COORDINATION TIPS:
-• Use mcp__ruflo__hive-mind_broadcast for swarm-wide announcements
-• Check worker status regularly with mcp__ruflo__hive-mind_status
-• Store important decisions in shared memory for persistence
-• Use consensus for any decisions affecting multiple workers
-• Use mcp__ruflo__task_assign to assign tasks to workers, then mcp__ruflo__task_complete when done
-
-🚀 BEGIN HIVE MIND COORDINATION NOW!
-Start by checking the current hive status and then proceed with the objective.
+    return `🧠 HIVE MIND COLLECTIVE INTELLIGENCE SYSTEM
+═══════════════════════════════════════════════
+
+You are the Queen coordinator of a Hive Mind swarm with collective intelligence capabilities.
+
+HIVE MIND CONFIGURATION:
+📌 Swarm ID: ${swarmId}
+📌 Swarm Name: ${swarmName}
+🎯 Objective: ${objective}
+👑 Queen Type: ${queenType}
+🐝 Worker Count: ${workers.length}
+🔗 Topology: ${topology}
+🤝 Consensus Algorithm: ${consensusAlgorithm}
+⏰ Initialized: ${currentTime}
+
+WORKER DISTRIBUTION:
+${workerTypes.map(type => `• ${type}: ${workerGroups[type].length} agents`).join('\n')}
+
+🔧 AVAILABLE MCP TOOLS FOR HIVE MIND COORDINATION:
+
+1️⃣ **COLLECTIVE INTELLIGENCE**
+   mcp__ruflo__hive-mind_consensus    - Democratic decision making
+   mcp__ruflo__hive-mind_memory       - Share knowledge across the hive
+   mcp__ruflo__hive-mind_broadcast    - Broadcast to all workers
+   mcp__ruflo__neural_patterns        - Neural pattern recognition
+
+2️⃣ **QUEEN COORDINATION**
+   mcp__ruflo__hive-mind_status       - Monitor swarm health
+   mcp__ruflo__task_create            - Create and delegate tasks
+   mcp__ruflo__coordination_orchestrate - Orchestrate task distribution
+   mcp__ruflo__agent_spawn            - Spawn additional workers
+
+3️⃣ **WORKER MANAGEMENT**
+   mcp__ruflo__agent_list             - List all active agents
+   mcp__ruflo__agent_status           - Check agent status
+   mcp__ruflo__agent_health           - Check worker health
+   mcp__ruflo__hive-mind_join         - Add agent to hive
+   mcp__ruflo__hive-mind_leave        - Remove agent from hive
+
+4️⃣ **TASK ORCHESTRATION**
+   mcp__ruflo__task_assign            - Assign tasks to workers
+   mcp__ruflo__task_status            - Track task progress
+   mcp__ruflo__task_complete          - Mark tasks complete
+   mcp__ruflo__workflow_create        - Create workflows
+
+5️⃣ **MEMORY & LEARNING**
+   mcp__ruflo__memory_store           - Store collective knowledge
+   mcp__ruflo__memory_retrieve        - Access shared memory
+   mcp__ruflo__memory_search          - Search memory patterns
+   mcp__ruflo__neural_train           - Learn from experiences
+   mcp__ruflo__hooks_intelligence_pattern-store - Store patterns
+
+📋 HIVE MIND EXECUTION PROTOCOL:
+
+1. **INITIALIZATION PHASE**
+   - Verify all workers are online and responsive
+   - Establish communication channels
+   - Load previous session state if available
+   - Initialize shared memory space
+
+2. **TASK DISTRIBUTION PHASE**
+   - Analyze the objective and decompose into subtasks
+   - Assign tasks based on worker specializations
+   - Set up task dependencies and ordering
+   - Monitor parallel execution
+
+3. **COORDINATION PHASE**
+   - Use consensus for critical decisions
+   - Aggregate results from workers
+   - Resolve conflicts using ${consensusAlgorithm} consensus
+   - Share learnings across the hive
+
+4. **COMPLETION PHASE**
+   - Verify all subtasks are complete
+   - Consolidate results
+   - Store learnings in collective memory
+   - Report final status
+
+🎯 YOUR OBJECTIVE:
+${objective}
+
+⚠️ CRITICAL — TOOL PREFERENCE RULES (#1422):
+• You MUST use Ruflo MCP tools (mcp__ruflo__*) for ALL orchestration tasks
+• Do NOT use Claude native Task/Agent tools for swarm coordination — use mcp__ruflo__agent_spawn, mcp__ruflo__task_assign, etc.
+• Native Claude tools (Read, Write, Edit, Bash, Grep, Glob) should ONLY be used for file operations and shell commands
+• All agent spawning, task assignment, memory, and coordination MUST go through mcp__ruflo__* tools
+• If a Ruflo MCP tool exists for an operation, always prefer it over any native equivalent
+
+💡 COORDINATION TIPS:
+• Use mcp__ruflo__hive-mind_broadcast for swarm-wide announcements
+• Check worker status regularly with mcp__ruflo__hive-mind_status
+• Store important decisions in shared memory for persistence
+• Use consensus for any decisions affecting multiple workers
+• Use mcp__ruflo__task_assign to assign tasks to workers, then mcp__ruflo__task_complete when done
+
+🚀 BEGIN HIVE MIND COORDINATION NOW!
+Start by checking the current hive status and then proceed with the objective.
 `;
 }
 /**

package/dist/src/commands/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,aAAa,CAAC;AA8nK1E,eAAO,MAAM,YAAY,EAAE,OA0G1B,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,aAAa,CAAC;AA+nK1E,eAAO,MAAM,YAAY,EAAE,OA0G1B,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/src/commands/hooks.js

@@ -2262,7 +2262,8 @@ const workerDispatchCommand = {
         const background = !ctx.flags['sync'];
         if (!trigger) {
             output.printError('--trigger is required');
-            output.writeln('Available triggers: ultralearn, optimize, consolidate, predict, audit, map, preload, deepdive, document, refactor, benchmark, testgaps');
+            output.writeln('Available triggers: ultralearn, optimize, consolidate, predict, audit, map, preload, deepdive, document, refactor, benchmark, testgaps, oia-audit');
+            output.writeln(output.dim('Tip: `oia-audit` (ADR-150) also runs as `ruflo metaharness oia-audit` for direct invocation.'));
             return { success: false, exitCode: 1 };
         }
         const spinner = output.createSpinner({ text: `Dispatching ${trigger} worker...`, spinner: 'dots' });
@@ -3963,15 +3964,15 @@ const tokenOptimizeCommand = {
                 const total = stats.cacheHits + stats.cacheMisses;
                 const hitRate = total > 0 ? (stats.cacheHits / total * 100).toFixed(1) : '0';
                 const savings = (stats.totalTokensSaved / 1000 * 0.01).toFixed(2);
-                output.writeln(`## Token Optimization Report
-
-| Metric | Value |
-|--------|-------|
-| Tokens Saved | ${stats.totalTokensSaved.toLocaleString()} |
-| Edits Optimized | ${stats.editsOptimized} |
-| Cache Hit Rate | ${hitRate}% |
-| Memories Retrieved | ${stats.memoriesRetrieved} |
-| Est. Monthly Savings | $${savings} |
+                output.writeln(`## Token Optimization Report
+
+| Metric | Value |
+|--------|-------|
+| Tokens Saved | ${stats.totalTokensSaved.toLocaleString()} |
+| Edits Optimized | ${stats.editsOptimized} |
+| Cache Hit Rate | ${hitRate}% |
+| Memories Retrieved | ${stats.memoriesRetrieved} |
+| Est. Monthly Savings | $${savings} |
 | Agentic-Flow Active | ${agenticFlowAvailable ? '✓' : '✗'} |`);
             }
             return { success: true, data: { config, stats: { ...stats, agenticFlowAvailable } } };