agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/core/attention-native.js

@@ -3,8 +3,19 @@
  *
  * Properly wraps @ruvector/attention native Rust implementations
  * with TypedArray conversions and proper error handling
+ *
+ * Note: @ruvector/attention is optional - falls back gracefully
  */
-import * as nativeAttention from '@ruvector/attention';
+let nativeAttention = null;
+let attentionAvailable = false;
+try {
+    nativeAttention = await import('@ruvector/attention');
+    attentionAvailable = true;
+}
+catch {
+    console.warn('[attention-native] @ruvector/attention not available');
+}
+export { attentionAvailable };
 /**
  * Convert regular array to Float32Array if needed
  */
@@ -190,7 +201,8 @@ export class MoEAttention {
         this.hiddenDim = config.hiddenDim;
         this.numExperts = config.numExperts || 4;
         try {
-            this.nativeInstance = new nativeAttention.MoEAttention(this.hiddenDim, this.numExperts);
+            // MoEAttention constructor may have different signature in different versions
+            this.nativeInstance = new nativeAttention.MoEAttention(this.hiddenDim);
         }
         catch (error) {
             throw new Error(`Failed to initialize native MoEAttention: ${error.message}`);

package/dist/core/attention-native.js.map

@@ -1 +1 @@
-{"version":3,"file":"attention-native.js","sourceRoot":"","sources":["../../src/core/attention-native.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Native Attention Wrappers\n *\n * Properly wraps @ruvector/attention native Rust implementations\n * with TypedArray conversions and proper error handling\n */\n\nimport * as nativeAttention from '@ruvector/attention';\n\nexport interface AttentionConfig {\n  hiddenDim: number;\n  numHeads?: number;\n  dropoutRate?: number;\n  useFlash?: boolean;\n}\n\n/**\n * Convert regular array to Float32Array if needed\n */\nfunction toFloat32Array(input: number[] | Float32Array): Float32Array {\n  if (input instanceof Float32Array) {\n    return input;\n  }\n  return new Float32Array(input);\n}\n\n/**\n * Convert Float32Array to regular array for JS compatibility\n */\nfunction toArray(input: Float32Array): number[] {\n  return Array.from(input);\n}\n\n/**\n * Native Multi-Head Attention (uses Rust implementation)\n *\n * This wrapper properly converts between JavaScript arrays and TypedArrays\n * required by the native Rust implementation.\n */\nexport class MultiHeadAttention {\n  private nativeInstance: any;\n  private hiddenDim: number;\n  private numHeads: number;\n\n  constructor(config: AttentionConfig) {\n    this.hiddenDim = config.hiddenDim;\n    this.numHeads = config.numHeads || 8;\n\n    try {\n      // Create native Rust instance\n      this.nativeInstance = new nativeAttention.MultiHeadAttention(\n        this.hiddenDim,\n        this.numHeads\n      );\n    } catch (error: any) {\n      throw new Error(`Failed to initialize native MultiHeadAttention: ${error.message}`);\n    }\n  }\n\n  /**\n   * Forward pass using native Rust implementation\n   */\n  forward(\n    query: number[] | Float32Array,\n    key: number[] | Float32Array,\n    value: number[] | Float32Array,\n    mask?: number[] | Float32Array\n  ): { output: number[]; attentionWeights: number[][] } {\n    try {\n      // Convert to Float32Array for native code\n      const q = toFloat32Array(query);\n      const k = toFloat32Array(key);\n      const v = toFloat32Array(value);\n      const m = mask ? toFloat32Array(mask) : undefined;\n\n      // Call native compute method\n      const result = this.nativeInstance.compute(q, k, v, m);\n\n      // Convert result back to regular arrays\n      return {\n        output: toArray(result),\n        attentionWeights: [[]] // Native doesn't return weights separately\n      };\n    } catch (error: any) {\n      throw new Error(`MultiHeadAttention forward failed: ${error.message}`);\n    }\n  }\n\n  /**\n   * Get dimensions\n   */\n  get dim(): number {\n    return this.nativeInstance.dim;\n  }\n\n  get headDim(): number {\n    return this.nativeInstance.headDim;\n  }\n}\n\n/**\n * Native Flash Attention (uses Rust implementation)\n *\n * Memory-efficient attention with tiling/chunking\n */\nexport class FlashAttention {\n  private nativeInstance: any;\n  private hiddenDim: number;\n\n  constructor(config: AttentionConfig) {\n    this.hiddenDim = config.hiddenDim;\n\n    try {\n      this.nativeInstance = new nativeAttention.FlashAttention(this.hiddenDim);\n    } catch (error: any) {\n      throw new Error(`Failed to initialize native FlashAttention: ${error.message}`);\n    }\n  }\n\n  /**\n   * Forward pass with batch support\n   */\n  forward(\n    query: number[][] | Float32Array[],\n    key: number[][] | Float32Array[],\n    value: number[][] | Float32Array[],\n    numHeads: number = 8\n  ): { output: number[][]; attentionScores: number[][] } {\n    try {\n      // Convert batch to Float32Array\n      const q = query.map(toFloat32Array);\n      const k = key.map(toFloat32Array);\n      const v = value.map(toFloat32Array);\n\n      // Call native compute\n      const result = this.nativeInstance.compute(q, k, v, numHeads);\n\n      // Convert result back\n      return {\n        output: result.map((r: Float32Array) => toArray(r)),\n        attentionScores: [[]]\n      };\n    } catch (error: any) {\n      throw new Error(`FlashAttention forward failed: ${error.message}`);\n    }\n  }\n}\n\n/**\n * Native Linear Attention (uses Rust implementation)\n *\n * O(n) complexity approximation of attention\n */\nexport class LinearAttention {\n  private nativeInstance: any;\n  private hiddenDim: number;\n\n  constructor(config: AttentionConfig) {\n    this.hiddenDim = config.hiddenDim;\n\n    try {\n      // LinearAttention constructor: (hiddenDim, seqLen)\n      // We'll use hiddenDim for both since seqLen varies per forward call\n      this.nativeInstance = new nativeAttention.LinearAttention(\n        this.hiddenDim,\n        this.hiddenDim\n      );\n    } catch (error: any) {\n      throw new Error(`Failed to initialize native LinearAttention: ${error.message}`);\n    }\n  }\n\n  forward(\n    query: number[][] | Float32Array[],\n    key: number[][] | Float32Array[],\n    value: number[][] | Float32Array[]\n  ): { output: number[][] } {\n    try {\n      const q = query.map(toFloat32Array);\n      const k = key.map(toFloat32Array);\n      const v = value.map(toFloat32Array);\n\n      const result = this.nativeInstance.compute(q, k, v);\n\n      return {\n        output: result.map((r: Float32Array) => toArray(r))\n      };\n    } catch (error: any) {\n      throw new Error(`LinearAttention forward failed: ${error.message}`);\n    }\n  }\n}\n\n/**\n * Native Hyperbolic Attention (uses Rust implementation)\n */\nexport class HyperbolicAttention {\n  private nativeInstance: any;\n  private hiddenDim: number;\n\n  constructor(config: AttentionConfig) {\n    this.hiddenDim = config.hiddenDim;\n\n    try {\n      this.nativeInstance = new nativeAttention.HyperbolicAttention(this.hiddenDim);\n    } catch (error: any) {\n      throw new Error(`Failed to initialize native HyperbolicAttention: ${error.message}`);\n    }\n  }\n\n  forward(\n    query: number[] | Float32Array,\n    key: number[] | Float32Array,\n    value: number[] | Float32Array\n  ): { output: number[]; distance: number } {\n    try {\n      const q = toFloat32Array(query);\n      const k = toFloat32Array(key);\n      const v = toFloat32Array(value);\n\n      const result = this.nativeInstance.compute(q, k, v);\n\n      return {\n        output: toArray(result.output),\n        distance: result.distance\n      };\n    } catch (error: any) {\n      throw new Error(`HyperbolicAttention forward failed: ${error.message}`);\n    }\n  }\n}\n\n/**\n * Native MoE Attention (uses Rust implementation)\n *\n * Mixture of Experts with top-k routing\n */\nexport class MoEAttention {\n  private nativeInstance: any;\n  private hiddenDim: number;\n  private numExperts: number;\n\n  constructor(config: AttentionConfig & { numExperts?: number }) {\n    this.hiddenDim = config.hiddenDim;\n    this.numExperts = config.numExperts || 4;\n\n    try {\n      this.nativeInstance = new nativeAttention.MoEAttention(\n        this.hiddenDim,\n        this.numExperts\n      );\n    } catch (error: any) {\n      throw new Error(`Failed to initialize native MoEAttention: ${error.message}`);\n    }\n  }\n\n  forward(\n    query: number[] | Float32Array,\n    key: number[] | Float32Array,\n    value: number[] | Float32Array,\n    topK: number = 2\n  ): { output: number[]; expertWeights: number[] } {\n    try {\n      const q = toFloat32Array(query);\n      const k = toFloat32Array(key);\n      const v = toFloat32Array(value);\n\n      const result = this.nativeInstance.compute(q, k, v, topK);\n\n      return {\n        output: toArray(result.output),\n        expertWeights: toArray(result.expertWeights)\n      };\n    } catch (error: any) {\n      throw new Error(`MoEAttention forward failed: ${error.message}`);\n    }\n  }\n}\n\n/**\n * Scaled Dot-Product Attention (pure JavaScript, always works)\n */\nexport function scaledDotProductAttention(\n  query: number[],\n  key: number[],\n  value: number[],\n  mask?: number[]\n): { output: number[]; weights: number[] } {\n  const dk = query.length;\n\n  // Compute attention scores: Q · K^T / sqrt(dk)\n  let score = 0;\n  for (let i = 0; i < dk; i++) {\n    score += query[i] * key[i];\n  }\n  score /= Math.sqrt(dk);\n\n  // Apply mask if provided\n  if (mask && mask[0] === 0) {\n    score = -Infinity;\n  }\n\n  // Softmax (single score version)\n  const expScore = Math.exp(score);\n  const weight = expScore;\n\n  // Weighted value\n  const output = value.map(v => v * weight);\n\n  return { output, weights: [weight] };\n}\n\n/**\n * Check if native attention is available\n */\nexport function isNativeAttentionAvailable(): boolean {\n  try {\n    const test = new nativeAttention.MultiHeadAttention(128, 4);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Factory function to create appropriate attention module\n */\nexport function createAttention(\n  type: 'multi-head' | 'flash' | 'linear' | 'hyperbolic' | 'moe',\n  config: AttentionConfig\n): MultiHeadAttention | FlashAttention | LinearAttention | HyperbolicAttention | MoEAttention {\n  switch (type) {\n    case 'multi-head':\n      return new MultiHeadAttention(config);\n    case 'flash':\n      return new FlashAttention(config);\n    case 'linear':\n      return new LinearAttention(config);\n    case 'hyperbolic':\n      return new HyperbolicAttention(config);\n    case 'moe':\n      return new MoEAttention(config);\n    default:\n      return new MultiHeadAttention(config);\n  }\n}\n"]}
+{"version":3,"file":"attention-native.js","sourceRoot":"","sources":["../../src/core/attention-native.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Native Attention Wrappers\n *\n * Properly wraps @ruvector/attention native Rust implementations\n * with TypedArray conversions and proper error handling\n *\n * Note: @ruvector/attention is optional - falls back gracefully\n */\n\nlet nativeAttention: any = null;\nlet attentionAvailable = false;\n\ntry {\n  nativeAttention = await import('@ruvector/attention');\n  attentionAvailable = true;\n} catch {\n  console.warn('[attention-native] @ruvector/attention not available');\n}\n\nexport { attentionAvailable };\n\nexport interface AttentionConfig {\n  hiddenDim: number;\n  numHeads?: number;\n  dropoutRate?: number;\n  useFlash?: boolean;\n}\n\n/**\n * Convert regular array to Float32Array if needed\n */\nfunction toFloat32Array(input: number[] | Float32Array): Float32Array {\n  if (input instanceof Float32Array) {\n    return input;\n  }\n  return new Float32Array(input);\n}\n\n/**\n * Convert Float32Array to regular array for JS compatibility\n */\nfunction toArray(input: Float32Array): number[] {\n  return Array.from(input);\n}\n\n/**\n * Native Multi-Head Attention (uses Rust implementation)\n *\n * This wrapper properly converts between JavaScript arrays and TypedArrays\n * required by the native Rust implementation.\n */\nexport class MultiHeadAttention {\n  private nativeInstance: any;\n  private hiddenDim: number;\n  private numHeads: number;\n\n  constructor(config: AttentionConfig) {\n    this.hiddenDim = config.hiddenDim;\n    this.numHeads = config.numHeads || 8;\n\n    try {\n      // Create native Rust instance\n      this.nativeInstance = new nativeAttention.MultiHeadAttention(\n        this.hiddenDim,\n        this.numHeads\n      );\n    } catch (error: any) {\n      throw new Error(`Failed to initialize native MultiHeadAttention: ${error.message}`);\n    }\n  }\n\n  /**\n   * Forward pass using native Rust implementation\n   */\n  forward(\n    query: number[] | Float32Array,\n    key: number[] | Float32Array,\n    value: number[] | Float32Array,\n    mask?: number[] | Float32Array\n  ): { output: number[]; attentionWeights: number[][] } {\n    try {\n      // Convert to Float32Array for native code\n      const q = toFloat32Array(query);\n      const k = toFloat32Array(key);\n      const v = toFloat32Array(value);\n      const m = mask ? toFloat32Array(mask) : undefined;\n\n      // Call native compute method\n      const result = this.nativeInstance.compute(q, k, v, m);\n\n      // Convert result back to regular arrays\n      return {\n        output: toArray(result),\n        attentionWeights: [[]] // Native doesn't return weights separately\n      };\n    } catch (error: any) {\n      throw new Error(`MultiHeadAttention forward failed: ${error.message}`);\n    }\n  }\n\n  /**\n   * Get dimensions\n   */\n  get dim(): number {\n    return this.nativeInstance.dim;\n  }\n\n  get headDim(): number {\n    return this.nativeInstance.headDim;\n  }\n}\n\n/**\n * Native Flash Attention (uses Rust implementation)\n *\n * Memory-efficient attention with tiling/chunking\n */\nexport class FlashAttention {\n  private nativeInstance: any;\n  private hiddenDim: number;\n\n  constructor(config: AttentionConfig) {\n    this.hiddenDim = config.hiddenDim;\n\n    try {\n      this.nativeInstance = new nativeAttention.FlashAttention(this.hiddenDim);\n    } catch (error: any) {\n      throw new Error(`Failed to initialize native FlashAttention: ${error.message}`);\n    }\n  }\n\n  /**\n   * Forward pass with batch support\n   */\n  forward(\n    query: number[][] | Float32Array[],\n    key: number[][] | Float32Array[],\n    value: number[][] | Float32Array[],\n    numHeads: number = 8\n  ): { output: number[][]; attentionScores: number[][] } {\n    try {\n      // Convert batch to Float32Array\n      const q = query.map(toFloat32Array);\n      const k = key.map(toFloat32Array);\n      const v = value.map(toFloat32Array);\n\n      // Call native compute\n      const result = this.nativeInstance.compute(q, k, v, numHeads);\n\n      // Convert result back\n      return {\n        output: result.map((r: Float32Array) => toArray(r)),\n        attentionScores: [[]]\n      };\n    } catch (error: any) {\n      throw new Error(`FlashAttention forward failed: ${error.message}`);\n    }\n  }\n}\n\n/**\n * Native Linear Attention (uses Rust implementation)\n *\n * O(n) complexity approximation of attention\n */\nexport class LinearAttention {\n  private nativeInstance: any;\n  private hiddenDim: number;\n\n  constructor(config: AttentionConfig) {\n    this.hiddenDim = config.hiddenDim;\n\n    try {\n      // LinearAttention constructor: (hiddenDim, seqLen)\n      // We'll use hiddenDim for both since seqLen varies per forward call\n      this.nativeInstance = new nativeAttention.LinearAttention(\n        this.hiddenDim,\n        this.hiddenDim\n      );\n    } catch (error: any) {\n      throw new Error(`Failed to initialize native LinearAttention: ${error.message}`);\n    }\n  }\n\n  forward(\n    query: number[][] | Float32Array[],\n    key: number[][] | Float32Array[],\n    value: number[][] | Float32Array[]\n  ): { output: number[][] } {\n    try {\n      const q = query.map(toFloat32Array);\n      const k = key.map(toFloat32Array);\n      const v = value.map(toFloat32Array);\n\n      const result = this.nativeInstance.compute(q, k, v);\n\n      return {\n        output: result.map((r: Float32Array) => toArray(r))\n      };\n    } catch (error: any) {\n      throw new Error(`LinearAttention forward failed: ${error.message}`);\n    }\n  }\n}\n\n/**\n * Native Hyperbolic Attention (uses Rust implementation)\n */\nexport class HyperbolicAttention {\n  private nativeInstance: any;\n  private hiddenDim: number;\n\n  constructor(config: AttentionConfig) {\n    this.hiddenDim = config.hiddenDim;\n\n    try {\n      this.nativeInstance = new nativeAttention.HyperbolicAttention(this.hiddenDim);\n    } catch (error: any) {\n      throw new Error(`Failed to initialize native HyperbolicAttention: ${error.message}`);\n    }\n  }\n\n  forward(\n    query: number[] | Float32Array,\n    key: number[] | Float32Array,\n    value: number[] | Float32Array\n  ): { output: number[]; distance: number } {\n    try {\n      const q = toFloat32Array(query);\n      const k = toFloat32Array(key);\n      const v = toFloat32Array(value);\n\n      const result = this.nativeInstance.compute(q, k, v);\n\n      return {\n        output: toArray(result.output),\n        distance: result.distance\n      };\n    } catch (error: any) {\n      throw new Error(`HyperbolicAttention forward failed: ${error.message}`);\n    }\n  }\n}\n\n/**\n * Native MoE Attention (uses Rust implementation)\n *\n * Mixture of Experts with top-k routing\n */\nexport class MoEAttention {\n  private nativeInstance: any;\n  private hiddenDim: number;\n  private numExperts: number;\n\n  constructor(config: AttentionConfig & { numExperts?: number }) {\n    this.hiddenDim = config.hiddenDim;\n    this.numExperts = config.numExperts || 4;\n\n    try {\n      // MoEAttention constructor may have different signature in different versions\n      this.nativeInstance = new (nativeAttention.MoEAttention as any)(\n        this.hiddenDim\n      );\n    } catch (error: any) {\n      throw new Error(`Failed to initialize native MoEAttention: ${error.message}`);\n    }\n  }\n\n  forward(\n    query: number[] | Float32Array,\n    key: number[] | Float32Array,\n    value: number[] | Float32Array,\n    topK: number = 2\n  ): { output: number[]; expertWeights: number[] } {\n    try {\n      const q = toFloat32Array(query);\n      const k = toFloat32Array(key);\n      const v = toFloat32Array(value);\n\n      const result = this.nativeInstance.compute(q, k, v, topK);\n\n      return {\n        output: toArray(result.output),\n        expertWeights: toArray(result.expertWeights)\n      };\n    } catch (error: any) {\n      throw new Error(`MoEAttention forward failed: ${error.message}`);\n    }\n  }\n}\n\n/**\n * Scaled Dot-Product Attention (pure JavaScript, always works)\n */\nexport function scaledDotProductAttention(\n  query: number[],\n  key: number[],\n  value: number[],\n  mask?: number[]\n): { output: number[]; weights: number[] } {\n  const dk = query.length;\n\n  // Compute attention scores: Q · K^T / sqrt(dk)\n  let score = 0;\n  for (let i = 0; i < dk; i++) {\n    score += query[i] * key[i];\n  }\n  score /= Math.sqrt(dk);\n\n  // Apply mask if provided\n  if (mask && mask[0] === 0) {\n    score = -Infinity;\n  }\n\n  // Softmax (single score version)\n  const expScore = Math.exp(score);\n  const weight = expScore;\n\n  // Weighted value\n  const output = value.map(v => v * weight);\n\n  return { output, weights: [weight] };\n}\n\n/**\n * Check if native attention is available\n */\nexport function isNativeAttentionAvailable(): boolean {\n  try {\n    const test = new nativeAttention.MultiHeadAttention(128, 4);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Factory function to create appropriate attention module\n */\nexport function createAttention(\n  type: 'multi-head' | 'flash' | 'linear' | 'hyperbolic' | 'moe',\n  config: AttentionConfig\n): MultiHeadAttention | FlashAttention | LinearAttention | HyperbolicAttention | MoEAttention {\n  switch (type) {\n    case 'multi-head':\n      return new MultiHeadAttention(config);\n    case 'flash':\n      return new FlashAttention(config);\n    case 'linear':\n      return new LinearAttention(config);\n    case 'hyperbolic':\n      return new HyperbolicAttention(config);\n    case 'moe':\n      return new MoEAttention(config);\n    default:\n      return new MultiHeadAttention(config);\n  }\n}\n"]}

package/dist/dashboard/demo.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env tsx
+/**
+ * Explainability Dashboard Demo
+ *
+ * Interactive demonstration of the explainability dashboard features.
+ */
+export {};
+//# sourceMappingURL=demo.d.ts.map

package/dist/dashboard/demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.d.ts","sourceRoot":"","sources":["../../src/dashboard/demo.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/dashboard/demo.js

@@ -0,0 +1,222 @@
+#!/usr/bin/env tsx
+/**
+ * Explainability Dashboard Demo
+ *
+ * Interactive demonstration of the explainability dashboard features.
+ */
+import { ExplainabilityService } from '../services/explainability-service.js';
+import { ExplainabilityDashboard } from './explainability-dashboard.js';
+async function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+async function demo() {
+    const service = ExplainabilityService.getInstance();
+    const dashboard = new ExplainabilityDashboard();
+    console.log('╔════════════════════════════════════════════════════════════════════════════════╗');
+    console.log('║ Explainability Dashboard Demo - ADR-066 Phase P2-4                            ║');
+    console.log('╚════════════════════════════════════════════════════════════════════════════════╝');
+    console.log('');
+    console.log('This demo showcases:');
+    console.log('  • Real-time trace collection with <5% overhead');
+    console.log('  • Attention visualization');
+    console.log('  • Decision tree explanations');
+    console.log('  • Performance profiling');
+    console.log('  • Compliance reporting');
+    console.log('');
+    console.log('Press Ctrl+C to exit at any time');
+    console.log('');
+    await sleep(2000);
+    // Demo 1: Create sample traces
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('Demo 1: Creating sample execution traces...');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('');
+    // Trace 1: Simple task (agent-booster)
+    service.startTrace('demo-trace-1');
+    service.addTraceStep('demo-trace-1', {
+        type: 'input',
+        description: 'Simple variable rename: var to const',
+    });
+    await sleep(10);
+    service.addTraceStep('demo-trace-1', {
+        type: 'decision',
+        description: 'Complexity: 10/100 - Using Agent Booster',
+    });
+    service.addTraceStep('demo-trace-1', {
+        type: 'output',
+        description: 'Completed in 1ms (free)',
+    });
+    service.endTrace('demo-trace-1', 'agent-booster', 0, true);
+    // Trace 2: Medium task (Haiku)
+    service.startTrace('demo-trace-2');
+    service.addTraceStep('demo-trace-2', {
+        type: 'input',
+        description: 'Generate API documentation',
+    });
+    await sleep(20);
+    service.addTraceStep('demo-trace-2', {
+        type: 'decision',
+        description: 'Complexity: 40/100 - Using claude-haiku-4',
+    });
+    service.addTraceStep('demo-trace-2', {
+        type: 'processing',
+        description: 'Analyzing code structure',
+    });
+    await sleep(50);
+    service.addTraceStep('demo-trace-2', {
+        type: 'output',
+        description: 'Generated documentation',
+    });
+    service.endTrace('demo-trace-2', 'claude-haiku-4', 0.002, true);
+    // Trace 3: Complex task (Sonnet)
+    service.startTrace('demo-trace-3');
+    service.addTraceStep('demo-trace-3', {
+        type: 'input',
+        description: 'Refactor authentication system',
+    });
+    await sleep(30);
+    service.addTraceStep('demo-trace-3', {
+        type: 'decision',
+        description: 'Complexity: 75/100 - Using claude-sonnet-4',
+    });
+    service.addTraceStep('demo-trace-3', {
+        type: 'processing',
+        description: 'Analyzing security patterns',
+    });
+    await sleep(100);
+    service.addTraceStep('demo-trace-3', {
+        type: 'output',
+        description: 'Refactored with security improvements',
+    });
+    service.endTrace('demo-trace-3', 'claude-sonnet-4', 0.015, true);
+    console.log('✓ Created 3 sample traces');
+    console.log('');
+    await sleep(1500);
+    // Demo 2: Overview
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('Demo 2: Dashboard Overview');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('');
+    dashboard.setView('overview');
+    console.log(dashboard.render());
+    console.log('');
+    await sleep(3000);
+    // Demo 3: Trace Detail
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('Demo 3: Trace Detail View');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('');
+    dashboard.setSelectedTrace('demo-trace-3');
+    dashboard.setView('trace');
+    console.log(dashboard.render());
+    console.log('');
+    await sleep(3000);
+    // Demo 4: Attention Visualization
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('Demo 4: Attention Visualization');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('');
+    // Add attention visualization
+    service.captureAttention('demo-trace-3', 'Refactor authentication system with JWT and OAuth2', 'Implemented secure authentication with JWT tokens and OAuth2 integration', [
+        {
+            headId: 0,
+            layer: 0,
+            weights: [
+                { token: 'authentication', weight: 0.95, position: 0 },
+                { token: 'JWT', weight: 0.85, position: 1 },
+                { token: 'OAuth2', weight: 0.75, position: 2 },
+                { token: 'secure', weight: 0.65, position: 3 },
+                { token: 'tokens', weight: 0.55, position: 4 },
+            ],
+            topK: ['authentication', 'JWT', 'OAuth2', 'secure', 'tokens'],
+        },
+    ]);
+    dashboard.setView('attention');
+    console.log(dashboard.render());
+    console.log('');
+    await sleep(3000);
+    // Demo 5: Decision Tree
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('Demo 5: Decision Tree Explanation');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('');
+    // Build decision tree
+    service.buildDecisionTree('demo-trace-3', {
+        nodeId: 'root',
+        decision: 'Analyze task: "Refactor authentication system"',
+        reasoning: 'High-level routing decision',
+        confidence: 1.0,
+        alternatives: [],
+        children: [
+            {
+                nodeId: 'complexity',
+                decision: 'Calculate complexity: 75/100',
+                reasoning: 'Security + Architecture + Integration = High',
+                confidence: 0.9,
+                alternatives: [
+                    { decision: 'Low complexity (30)', confidence: 0.1, reasoning: 'Too complex for simple handling' },
+                ],
+                children: [
+                    {
+                        nodeId: 'model',
+                        decision: 'Select claude-sonnet-4',
+                        reasoning: 'Balance of quality and cost for security work',
+                        confidence: 0.85,
+                        alternatives: [
+                            { decision: 'Use claude-opus-4', confidence: 0.6, reasoning: 'Higher quality but 5x cost' },
+                            { decision: 'Use claude-haiku-4', confidence: 0.3, reasoning: 'May miss security issues' },
+                        ],
+                        children: [],
+                    },
+                ],
+            },
+        ],
+    });
+    dashboard.setView('decision');
+    console.log(dashboard.render());
+    console.log('');
+    await sleep(3000);
+    // Demo 6: Performance Profile
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('Demo 6: Performance Profile');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('');
+    dashboard.setView('performance');
+    console.log(dashboard.render());
+    console.log('');
+    await sleep(3000);
+    // Demo 7: Compliance Report
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('Demo 7: Compliance Report');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('');
+    dashboard.setView('compliance');
+    console.log(dashboard.render());
+    console.log('');
+    await sleep(3000);
+    // Demo 8: Metrics
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('Demo 8: Explainability Metrics');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('');
+    const metrics = service.getMetrics();
+    console.log('Final Metrics:');
+    console.log(`  Traces Collected:     ${metrics.tracesCollected}`);
+    console.log(`  Average Overhead:     ${metrics.averageOverheadMs.toFixed(2)}ms`);
+    console.log(`  Overhead Percentage:  ${metrics.overheadPercentage.toFixed(2)}%`);
+    console.log(`  Storage Used:         ${metrics.storageUsedMB.toFixed(2)} MB`);
+    console.log('');
+    if (metrics.overheadPercentage < 5) {
+        console.log('✓ SUCCESS: Overhead is under 5% target!');
+    }
+    else {
+        console.log('⚠ WARNING: Overhead exceeds 5% target');
+    }
+    console.log('');
+    console.log('╔════════════════════════════════════════════════════════════════════════════════╗');
+    console.log('║ Demo Complete!                                                                 ║');
+    console.log('╚════════════════════════════════════════════════════════════════════════════════╝');
+}
+// Run demo
+demo().catch(console.error);
+//# sourceMappingURL=demo.js.map

package/dist/dashboard/demo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.js","sourceRoot":"","sources":["../../src/dashboard/demo.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env tsx\n/**\n * Explainability Dashboard Demo\n *\n * Interactive demonstration of the explainability dashboard features.\n */\n\nimport { ExplainabilityService } from '../services/explainability-service.js';\nimport { ExplainabilityDashboard } from './explainability-dashboard.js';\n\nasync function sleep(ms: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, ms));\n}\n\nasync function demo() {\n  const service = ExplainabilityService.getInstance();\n  const dashboard = new ExplainabilityDashboard();\n\n  console.log('╔════════════════════════════════════════════════════════════════════════════════╗');\n  console.log('║ Explainability Dashboard Demo - ADR-066 Phase P2-4                            ║');\n  console.log('╚════════════════════════════════════════════════════════════════════════════════╝');\n  console.log('');\n  console.log('This demo showcases:');\n  console.log('  • Real-time trace collection with <5% overhead');\n  console.log('  • Attention visualization');\n  console.log('  • Decision tree explanations');\n  console.log('  • Performance profiling');\n  console.log('  • Compliance reporting');\n  console.log('');\n  console.log('Press Ctrl+C to exit at any time');\n  console.log('');\n\n  await sleep(2000);\n\n  // Demo 1: Create sample traces\n  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');\n  console.log('Demo 1: Creating sample execution traces...');\n  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');\n  console.log('');\n\n  // Trace 1: Simple task (agent-booster)\n  service.startTrace('demo-trace-1');\n  service.addTraceStep('demo-trace-1', {\n    type: 'input',\n    description: 'Simple variable rename: var to const',\n  });\n  await sleep(10);\n  service.addTraceStep('demo-trace-1', {\n    type: 'decision',\n    description: 'Complexity: 10/100 - Using Agent Booster',\n  });\n  service.addTraceStep('demo-trace-1', {\n    type: 'output',\n    description: 'Completed in 1ms (free)',\n  });\n  service.endTrace('demo-trace-1', 'agent-booster', 0, true);\n\n  // Trace 2: Medium task (Haiku)\n  service.startTrace('demo-trace-2');\n  service.addTraceStep('demo-trace-2', {\n    type: 'input',\n    description: 'Generate API documentation',\n  });\n  await sleep(20);\n  service.addTraceStep('demo-trace-2', {\n    type: 'decision',\n    description: 'Complexity: 40/100 - Using claude-haiku-4',\n  });\n  service.addTraceStep('demo-trace-2', {\n    type: 'processing',\n    description: 'Analyzing code structure',\n  });\n  await sleep(50);\n  service.addTraceStep('demo-trace-2', {\n    type: 'output',\n    description: 'Generated documentation',\n  });\n  service.endTrace('demo-trace-2', 'claude-haiku-4', 0.002, true);\n\n  // Trace 3: Complex task (Sonnet)\n  service.startTrace('demo-trace-3');\n  service.addTraceStep('demo-trace-3', {\n    type: 'input',\n    description: 'Refactor authentication system',\n  });\n  await sleep(30);\n  service.addTraceStep('demo-trace-3', {\n    type: 'decision',\n    description: 'Complexity: 75/100 - Using claude-sonnet-4',\n  });\n  service.addTraceStep('demo-trace-3', {\n    type: 'processing',\n    description: 'Analyzing security patterns',\n  });\n  await sleep(100);\n  service.addTraceStep('demo-trace-3', {\n    type: 'output',\n    description: 'Refactored with security improvements',\n  });\n  service.endTrace('demo-trace-3', 'claude-sonnet-4', 0.015, true);\n\n  console.log('✓ Created 3 sample traces');\n  console.log('');\n  await sleep(1500);\n\n  // Demo 2: Overview\n  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');\n  console.log('Demo 2: Dashboard Overview');\n  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');\n  console.log('');\n  dashboard.setView('overview');\n  console.log(dashboard.render());\n  console.log('');\n  await sleep(3000);\n\n  // Demo 3: Trace Detail\n  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');\n  console.log('Demo 3: Trace Detail View');\n  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');\n  console.log('');\n  dashboard.setSelectedTrace('demo-trace-3');\n  dashboard.setView('trace');\n  console.log(dashboard.render());\n  console.log('');\n  await sleep(3000);\n\n  // Demo 4: Attention Visualization\n  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');\n  console.log('Demo 4: Attention Visualization');\n  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');\n  console.log('');\n\n  // Add attention visualization\n  service.captureAttention('demo-trace-3', 'Refactor authentication system with JWT and OAuth2', 'Implemented secure authentication with JWT tokens and OAuth2 integration', [\n    {\n      headId: 0,\n      layer: 0,\n      weights: [\n        { token: 'authentication', weight: 0.95, position: 0 },\n        { token: 'JWT', weight: 0.85, position: 1 },\n        { token: 'OAuth2', weight: 0.75, position: 2 },\n        { token: 'secure', weight: 0.65, position: 3 },\n        { token: 'tokens', weight: 0.55, position: 4 },\n      ],\n      topK: ['authentication', 'JWT', 'OAuth2', 'secure', 'tokens'],\n    },\n  ]);\n\n  dashboard.setView('attention');\n  console.log(dashboard.render());\n  console.log('');\n  await sleep(3000);\n\n  // Demo 5: Decision Tree\n  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');\n  console.log('Demo 5: Decision Tree Explanation');\n  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');\n  console.log('');\n\n  // Build decision tree\n  service.buildDecisionTree('demo-trace-3', {\n    nodeId: 'root',\n    decision: 'Analyze task: \"Refactor authentication system\"',\n    reasoning: 'High-level routing decision',\n    confidence: 1.0,\n    alternatives: [],\n    children: [\n      {\n        nodeId: 'complexity',\n        decision: 'Calculate complexity: 75/100',\n        reasoning: 'Security + Architecture + Integration = High',\n        confidence: 0.9,\n        alternatives: [\n          { decision: 'Low complexity (30)', confidence: 0.1, reasoning: 'Too complex for simple handling' },\n        ],\n        children: [\n          {\n            nodeId: 'model',\n            decision: 'Select claude-sonnet-4',\n            reasoning: 'Balance of quality and cost for security work',\n            confidence: 0.85,\n            alternatives: [\n              { decision: 'Use claude-opus-4', confidence: 0.6, reasoning: 'Higher quality but 5x cost' },\n              { decision: 'Use claude-haiku-4', confidence: 0.3, reasoning: 'May miss security issues' },\n            ],\n            children: [],\n          },\n        ],\n      },\n    ],\n  });\n\n  dashboard.setView('decision');\n  console.log(dashboard.render());\n  console.log('');\n  await sleep(3000);\n\n  // Demo 6: Performance Profile\n  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');\n  console.log('Demo 6: Performance Profile');\n  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');\n  console.log('');\n\n  dashboard.setView('performance');\n  console.log(dashboard.render());\n  console.log('');\n  await sleep(3000);\n\n  // Demo 7: Compliance Report\n  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');\n  console.log('Demo 7: Compliance Report');\n  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');\n  console.log('');\n\n  dashboard.setView('compliance');\n  console.log(dashboard.render());\n  console.log('');\n  await sleep(3000);\n\n  // Demo 8: Metrics\n  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');\n  console.log('Demo 8: Explainability Metrics');\n  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');\n  console.log('');\n\n  const metrics = service.getMetrics();\n  console.log('Final Metrics:');\n  console.log(`  Traces Collected:     ${metrics.tracesCollected}`);\n  console.log(`  Average Overhead:     ${metrics.averageOverheadMs.toFixed(2)}ms`);\n  console.log(`  Overhead Percentage:  ${metrics.overheadPercentage.toFixed(2)}%`);\n  console.log(`  Storage Used:         ${metrics.storageUsedMB.toFixed(2)} MB`);\n  console.log('');\n\n  if (metrics.overheadPercentage < 5) {\n    console.log('✓ SUCCESS: Overhead is under 5% target!');\n  } else {\n    console.log('⚠ WARNING: Overhead exceeds 5% target');\n  }\n  console.log('');\n\n  console.log('╔════════════════════════════════════════════════════════════════════════════════╗');\n  console.log('║ Demo Complete!                                                                 ║');\n  console.log('╚════════════════════════════════════════════════════════════════════════════════╝');\n}\n\n// Run demo\ndemo().catch(console.error);\n"]}

package/dist/dashboard/explainability-dashboard.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Explainability Dashboard - CLI-based TUI for transparency and debugging
+ *
+ * Features:
+ * - Real-time trace visualization
+ * - Attention heatmaps
+ * - Decision tree rendering
+ * - Performance profiling
+ * - Compliance reports
+ */
+import { ExecutionTrace } from '../services/explainability-service.js';
+export interface DashboardOptions {
+    refreshRate?: number;
+    theme?: 'light' | 'dark';
+    showAttention?: boolean;
+    showDecisionTree?: boolean;
+    showPerformance?: boolean;
+}
+export interface DashboardState {
+    selectedTraceId: string | null;
+    traces: ExecutionTrace[];
+    currentView: 'overview' | 'trace' | 'attention' | 'decision' | 'performance' | 'compliance';
+}
+export declare class ExplainabilityDashboard {
+    private service;
+    private options;
+    private state;
+    constructor(options?: DashboardOptions);
+    render(): string;
+    private renderOverview;
+    private renderTraceDetail;
+    private renderAttentionView;
+    private renderDecisionTreeView;
+    private renderDecisionNode;
+    private renderPerformanceView;
+    private renderComplianceView;
+    private renderHeader;
+    private renderSection;
+    private renderTable;
+    private renderHeatmap;
+    setSelectedTrace(traceId: string): void;
+    setView(view: DashboardState['currentView']): void;
+    exportToConsole(): void;
+}
+//# sourceMappingURL=explainability-dashboard.d.ts.map

package/dist/dashboard/explainability-dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainability-dashboard.d.ts","sourceRoot":"","sources":["../../src/dashboard/explainability-dashboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAyB,cAAc,EAA4D,MAAM,uCAAuC,CAAC;AAMxJ,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,WAAW,EAAE,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,GAAG,YAAY,CAAC;CAC7F;AAMD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,KAAK,CAAiB;gBAElB,OAAO,GAAE,gBAAqB;IAqB1C,MAAM,IAAI,MAAM;IAyBhB,OAAO,CAAC,cAAc;IAwDtB,OAAO,CAAC,iBAAiB;IA+CzB,OAAO,CAAC,mBAAmB;IA+C3B,OAAO,CAAC,sBAAsB;IA0B9B,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,qBAAqB;IA2C7B,OAAO,CAAC,oBAAoB;IA8C5B,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,WAAW;IAsBnB,OAAO,CAAC,aAAa;IAUrB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIvC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,aAAa,CAAC,GAAG,IAAI;IAQlD,eAAe,IAAI,IAAI;CAIxB"}