vektor-slipstream 1.4.4 → 2.0.0

package/token.js

@@ -1,322 +0,0 @@
-/**
- * cloak_token.js
- * Token ledger — aggregates context budget consumption per session.
- * Writes ONE summary node per session end (via cloak_axon integration).
- * Detects waste patterns: repeated reads, oversized context injections.
- *
- * Design principles:
- *   - Aggregated, not per-operation. Never writes on every read/write.
- *   - Session total written ONCE at Stop (passed to cloak_axon's tokenCount).
- *   - Waste patterns flagged at session end, not in real time.
- *   - Uses character-to-token ratios (OpenWolf method, ±15% accurate).
- *
- * Architecture: CLOAK layer → Vektor temporal graph
- * Research: OpenWolf token-ledger pattern
- */
-
-'use strict';
-
-// ---------------------------------------------------------------------------
-// Token estimation ratios (same as cortex.js for consistency)
-// ---------------------------------------------------------------------------
-const TOKEN_RATIOS = {
-  code : 3.5,
-  prose: 4.0,
-  mixed: 3.75,
-};
-
-const CODE_EXTS = new Set(['.js','.ts','.jsx','.tsx','.py','.go','.rs','.rb','.java','.c','.cpp']);
-
-function estimateTokens(content, filePath = '') {
-  if (!content) return 0;
-  const ext   = (filePath.match(/\.[^.]+$/) || [''])[0].toLowerCase();
-  const bytes = Buffer.byteLength(String(content), 'utf8');
-  if (CODE_EXTS.has(ext)) return Math.round(bytes / TOKEN_RATIOS.code);
-  return Math.round(bytes / TOKEN_RATIOS.mixed);
-}
-
-// ---------------------------------------------------------------------------
-// In-RAM session ledger
-// ---------------------------------------------------------------------------
-const _ledger = {
-  sessionId    : null,
-  reads        : [],   // { file, tokens, ts }
-  writes       : [],   // { file, tokens, ts }
-  wasteEvents  : [],   // { type, description, tokens_wasted }
-  totalReadTokens : 0,
-  totalWriteTokens: 0,
-};
-
-function _resetLedger() {
-  _ledger.sessionId          = null;
-  _ledger.reads              = [];
-  _ledger.writes             = [];
-  _ledger.wasteEvents        = [];
-  _ledger.totalReadTokens    = 0;
-  _ledger.totalWriteTokens   = 0;
-}
-
-// ---------------------------------------------------------------------------
-// Waste detection thresholds
-// ---------------------------------------------------------------------------
-const WASTE_RULES = {
-  REPEATED_READ_THRESHOLD  : 2,      // same file read > 2x = waste
-  LARGE_READ_THRESHOLD     : 2000,   // reading >2000 tokens when anatomy would suffice
-  REPEATED_READ_PENALTY    : 0.8,    // assume 80% of repeated read tokens are wasted
-};
-
-// ---------------------------------------------------------------------------
-// Session lifecycle
-// ---------------------------------------------------------------------------
-
-/**
- * startSession(sessionId)
- * Called from cloak_axon onSessionStart. Resets ledger for new session.
- */
-function startSession(sessionId) {
-  _resetLedger();
-  _ledger.sessionId = sessionId;
-}
-
-// ---------------------------------------------------------------------------
-// Event tracking — called from hook integration
-// ---------------------------------------------------------------------------
-
-/**
- * trackRead({ filePath, content })
- * Record a file read. Detects repeated reads and large reads.
- */
-function trackRead({ filePath, content } = {}) {
-  if (!_ledger.sessionId) return;
-
-  const tokens = estimateTokens(content, filePath);
-  const file   = filePath || 'unknown';
-  const ts     = Date.now();
-
-  _ledger.reads.push({ file, tokens, ts });
-  _ledger.totalReadTokens += tokens;
-
-  // Detect repeated reads of same file this session
-  const readCount = _ledger.reads.filter(r => r.file === file).length;
-  if (readCount > WASTE_RULES.REPEATED_READ_THRESHOLD) {
-    const wastedTokens = Math.round(tokens * WASTE_RULES.REPEATED_READ_PENALTY);
-    _ledger.wasteEvents.push({
-      type           : 'repeated_read',
-      description    : `${file} read ${readCount}x this session`,
-      tokens_wasted  : wastedTokens,
-      recommendation : 'Use cloak_cortex anatomy to check file before re-reading',
-    });
-  }
-
-  // Detect large reads that cortex anatomy could have avoided
-  if (tokens > WASTE_RULES.LARGE_READ_THRESHOLD) {
-    _ledger.wasteEvents.push({
-      type           : 'large_read',
-      description    : `${file} read at ~${tokens} tokens`,
-      tokens_wasted  : Math.round(tokens * 0.5), // assume 50% avoidable
-      recommendation : 'Check cloak_cortex anatomy description first',
-    });
-  }
-}
-
-/**
- * trackWrite({ filePath, content })
- * Record a file write.
- */
-function trackWrite({ filePath, content } = {}) {
-  if (!_ledger.sessionId) return;
-
-  const tokens = estimateTokens(content, filePath);
-  _ledger.writes.push({ file: filePath || 'unknown', tokens, ts: Date.now() });
-  _ledger.totalWriteTokens += tokens;
-}
-
-// ---------------------------------------------------------------------------
-// Session summary — called at session end, returns total for cloak_axon
-// ---------------------------------------------------------------------------
-
-/**
- * getSessionSummary()
- * Returns aggregated stats for the current session.
- * This is passed as tokenCount to cloak_axon.onSessionStop().
- */
-function getSessionSummary() {
-  if (!_ledger.sessionId) return null;
-
-  const totalTokens    = _ledger.totalReadTokens + _ledger.totalWriteTokens;
-  const totalWasted    = _ledger.wasteEvents.reduce((sum, e) => sum + (e.tokens_wasted || 0), 0);
-  const wasteRate      = totalTokens > 0 ? Math.round((totalWasted / totalTokens) * 100) : 0;
-
-  // Top files by token consumption
-  const fileTotals = {};
-  [..._ledger.reads, ..._ledger.writes].forEach(({ file, tokens }) => {
-    fileTotals[file] = (fileTotals[file] || 0) + tokens;
-  });
-  const topFiles = Object.entries(fileTotals)
-    .sort((a, b) => b[1] - a[1])
-    .slice(0, 5)
-    .map(([file, tokens]) => `${file}:~${tokens}t`);
-
-  return {
-    sessionId        : _ledger.sessionId,
-    totalTokens,
-    readTokens       : _ledger.totalReadTokens,
-    writeTokens      : _ledger.totalWriteTokens,
-    wastedTokens     : totalWasted,
-    wasteRate        : `${wasteRate}%`,
-    wasteEvents      : _ledger.wasteEvents.length,
-    topFiles,
-    readCount        : _ledger.reads.length,
-    writeCount       : _ledger.writes.length,
-    uniqueFilesRead  : new Set(_ledger.reads.map(r => r.file)).size,
-    uniqueFilesWritten: new Set(_ledger.writes.map(w => w.file)).size,
-  };
-}
-
-// ---------------------------------------------------------------------------
-// Temporal graph node builder — ONE write per session
-// This is called by cloak_axon at session stop, not by token.js directly.
-// ---------------------------------------------------------------------------
-
-/**
- * buildTokenNode(summary)
- * Builds the Vektor memory string for the temporal graph.
- * cloak_axon calls this and includes it in the MemCell, OR it can be
- * written as a standalone temporal node. Either way: one write per session.
- */
-function buildTokenNode(summary) {
-  if (!summary) return null;
-
-  return [
-    `[CLOAK_TOKEN_LEDGER]`,
-    `session:${summary.sessionId}`,
-    `total_tokens:~${summary.totalTokens}`,
-    `read_tokens:~${summary.readTokens}`,
-    `write_tokens:~${summary.writeTokens}`,
-    `wasted_tokens:~${summary.wastedTokens}`,
-    `waste_rate:${summary.wasteRate}`,
-    `waste_events:${summary.wasteEvents}`,
-    `top_files:${summary.topFiles.join(',')}`,
-    `logged_at:${new Date().toISOString()}`,
-  ].join(' | ');
-}
-
-// ---------------------------------------------------------------------------
-// Lifetime waste report — queries Vektor for historical patterns
-// ---------------------------------------------------------------------------
-
-/**
- * getWasteReport({ memory, days })
- * Queries Vektor temporal graph for token waste patterns over N days.
- * Returns actionable recommendations. Read-only — no writes.
- *
- * @param {object} memory  - Vektor memory instance
- * @param {number} days    - Lookback window (default: 30)
- */
-async function getWasteReport({ memory, days = 30 } = {}) {
-  if (!memory) throw new Error('cloak_token: memory instance is required');
-
-  let nodes;
-  try {
-    nodes = await memory.recall(
-      `[CLOAK_TOKEN_LEDGER]`,
-      days
-    );
-  } catch (err) {
-    return { error: err.message, sessions: [] };
-  }
-
-  if (!nodes || nodes.length === 0) {
-    return { sessions: [], totalTokens: 0, totalWasted: 0, recommendations: [] };
-  }
-
-  // Parse historical nodes
-  const sessions = nodes.map(n => {
-    const parts  = n.content.split(' | ');
-    const get    = key => {
-      const p = parts.find(p => p.startsWith(`${key}:`));
-      return p ? p.slice(key.length + 1) : null;
-    };
-    return {
-      sessionId    : get('session'),
-      totalTokens  : parseInt(get('total_tokens')?.replace('~','') || '0'),
-      wastedTokens : parseInt(get('wasted_tokens')?.replace('~','') || '0'),
-      wasteRate    : get('waste_rate'),
-      wasteEvents  : parseInt(get('waste_events') || '0'),
-    };
-  });
-
-  const totalTokens = sessions.reduce((s, n) => s + n.totalTokens, 0);
-  const totalWasted = sessions.reduce((s, n) => s + n.wastedTokens, 0);
-  const avgWasteRate = totalTokens > 0 ? Math.round((totalWasted / totalTokens) * 100) : 0;
-
-  const recommendations = [];
-  if (avgWasteRate > 30) {
-    recommendations.push(`High waste rate (${avgWasteRate}%) — run cloak_cortex scan to refresh anatomy index`);
-  }
-  if (sessions.filter(s => s.wasteEvents > 3).length > 3) {
-    recommendations.push('Repeated waste events — check most-read files and add to anatomy');
-  }
-
-  return {
-    sessions : sessions.slice(0, 10),
-    totalTokens,
-    totalWasted,
-    avgWasteRate : `${avgWasteRate}%`,
-    recommendations,
-  };
-}
-
-// ---------------------------------------------------------------------------
-// Claude Code hook integration
-// ---------------------------------------------------------------------------
-
-/**
- * handleHookPayload({ payload, sessionId })
- * Routes Claude Code hook events to trackRead / trackWrite.
- * Called from the main MCP server hook handler.
- */
-function handleHookPayload({ payload, sessionId } = {}) {
-  if (!payload) return null;
-
-  const hookName = payload?.hook_event_name || payload?.event;
-  const tool     = payload?.tool_name;
-  const input    = payload?.tool_input;
-
-  // Start ledger if we receive a session ID and haven't started yet
-  if (sessionId && !_ledger.sessionId) {
-    startSession(sessionId);
-  }
-
-  switch (hookName) {
-    case 'PostToolUse':
-    case 'post_tool_use': {
-      if (tool === 'Read') {
-        trackRead({
-          filePath: input?.file_path || input?.path,
-          content : payload?.tool_response?.content || '',
-        });
-      } else if (['Write','Edit','MultiEdit'].includes(tool)) {
-        trackWrite({
-          filePath: input?.file_path || input?.path,
-          content : input?.new_string || input?.content || '',
-        });
-      }
-      break;
-    }
-  }
-
-  return null; // token tracking never returns hook responses
-}
-
-module.exports = {
-  startSession,
-  trackRead,
-  trackWrite,
-  getSessionSummary,
-  buildTokenNode,
-  getWasteReport,
-  handleHookPayload,
-  estimateTokens,
-  _ledger, // exported for testing and cloak_axon integration
-};

package/types/index.d.ts

@@ -1,269 +0,0 @@
-/**
- * vektor-slipstream — TypeScript declarations
- * v1.3.7
- */
-
-// ─── Core types ──────────────────────────────────────────────────────────────
-
-export interface VektorMemory {
-  id: string;
-  content: string;
-  summary?: string;
-  importance: number;
-  score?: number;
-  pinned: boolean;
-  namespace: string;
-  created_at: number;
-  updated_at?: number;
-  metadata?: Record<string, unknown>;
-}
-
-export interface GraphNode {
-  id: string;
-  content: string;
-  summary?: string;
-  importance: number;
-  edges: GraphEdge[];
-}
-
-export interface GraphEdge {
-  id: string;
-  source_id: string;
-  target_id: string;
-  edge_type: 'semantic' | 'causal' | 'temporal' | 'entity';
-  weight: number;
-}
-
-export interface DeltaResult {
-  added: VektorMemory[];
-  updated: VektorMemory[];
-  deleted: string[];
-  summary: string;
-}
-
-export interface BriefingResult {
-  period: string;
-  memoryCount: number;
-  pinnedCount: number;
-  pinned: VektorMemory[];
-  memories: VektorMemory[];
-  summary: string;
-}
-
-export interface InspectResult {
-  agent_id: string;
-  namespace: string;
-  snapshot_at: string;
-  counts: {
-    memories: number;
-    pinned: number;
-    edges: number;
-    namespaces: number;
-  };
-  graph: {
-    edgeTypes: Array<{ edge_type: string; n: number }>;
-    topNodes: Array<{
-      id: string;
-      preview: string;
-      importance: number;
-      connections: number;
-      pinned: boolean;
-    }>;
-  };
-  timeline: {
-    oldest: { id: string; preview: string; at: number } | null;
-    newest: { id: string; preview: string; at: number } | null;
-  };
-  recent: Array<{
-    id: string;
-    preview: string;
-    importance: number;
-    pinned: boolean;
-    at: number;
-  }>;
-  importance: {
-    avg: number | null;
-    distribution: Array<{ bucket: number; n: number }>;
-  };
-  rem: {
-    totalDreams: number;
-    lastRun: number | null;
-    compressionRatio: string | null;
-    fragmentsProcessed: number;
-  };
-  audn: {
-    added: number;
-    updated: number;
-    deleted: number;
-    skipped: number;
-  } | null;
-  namespaces: Array<{ namespace: string; memories: number }>;
-}
-
-export interface AudnLogEntry {
-  id: number;
-  action: 'ADD' | 'UPDATE' | 'DELETE' | 'NO_OP';
-  memory_id: string | null;
-  content: string | null;
-  reason: string | null;
-  similarity: number | null;
-  ran_at: number;
-}
-
-export interface ExportBundle {
-  _vektor: {
-    version: string;
-    exported_at: string;
-    agent_id: string;
-    namespace: string;
-    checksum: string;
-    counts: { memories: number; edges: number; entities: number };
-  };
-  memories: VektorMemory[];
-  edges: GraphEdge[];
-  entities: EntityRecord[];
-  entityMentions: Array<{ memory_id: string; entity_id: string }>;
-  audnLog: AudnLogEntry[];
-}
-
-export interface EntityRecord {
-  id: string;
-  canonical: string;
-  type: 'person' | 'org' | 'project' | 'concept' | 'unknown';
-  confidence: number;
-  aliases: string[];
-  created_at: number;
-}
-
-export interface NamespaceRecord {
-  namespace: string;
-  memories: number;
-  last_active: number;
-  pinned: number;
-}
-
-// ─── Error types ─────────────────────────────────────────────────────────────
-
-export type VektorErrorCode =
-  | 'ERR_LICENCE_MISSING'
-  | 'ERR_LICENCE_INVALID'
-  | 'ERR_LICENCE_EXPIRED'
-  | 'ERR_MEMORY_NOT_FOUND'
-  | 'ERR_MEMORY_WRITE_FAILED'
-  | 'ERR_MEMORY_READ_FAILED'
-  | 'ERR_MEMORY_DELETE_FAILED'
-  | 'ERR_GRAPH_NODE_NOT_FOUND'
-  | 'ERR_GRAPH_CORRUPTED'
-  | 'ERR_PROVIDER_NOT_SUPPORTED'
-  | 'ERR_EMBED_FAILED'
-  | 'ERR_PROVIDER_RATE_LIMIT'
-  | 'ERR_PROVIDER_AUTH'
-  | 'ERR_AGENT_ID_MISSING'
-  | 'ERR_DB_INIT_FAILED'
-  | 'ERR_EXPORT_FAILED'
-  | 'ERR_IMPORT_FAILED'
-  | 'ERR_IMPORT_SCHEMA_MISMATCH'
-  | 'ERR_NAMESPACE_INVALID';
-
-export declare class VektorError extends Error {
-  code: VektorErrorCode;
-  detail: unknown;
-}
-
-// ─── createMemory options ────────────────────────────────────────────────────
-
-export type Provider = 'gemini' | 'openai' | 'groq' | 'ollama';
-
-export interface CreateMemoryOptions {
-  agentId: string;
-  licenceKey?: string;
-  provider: Provider;
-  apiKey?: string | string[];   // string[] for Gemini key pooling
-  dbPath?: string;
-  namespace?: string;           // default: 'default'
-  ollamaModel?: string;
-  ollamaHost?: string;
-}
-
-// ─── Memory instance ─────────────────────────────────────────────────────────
-
-export interface Memory {
-  readonly agentId: string;
-  readonly namespace: string;
-
-  // Core
-  remember(content: string, opts?: { metadata?: Record<string, unknown> }): Promise<{ id: string; action: 'ADD' | 'UPDATE' | 'NO_OP' }>;
-  recall(query: string, k?: number): Promise<VektorMemory[]>;
-  graph(query: string, opts?: { hops?: number; edgeTypes?: GraphEdge['edge_type'][] }): Promise<GraphNode[]>;
-  delta(query: string, days?: number): Promise<DeltaResult>;
-  briefing(opts?: {
-    since?: string | number;
-    limit?: number;
-    minImportance?: number;
-    raw?: boolean;
-  }): Promise<BriefingResult>;
-
-  // v1.3.7
-  forget(id: string): Promise<{ deleted: boolean; edgesRemoved: number }>;
-  forgetWhere(query: string, opts?: {
-    limit?: number;
-    minScore?: number;
-    dryRun?: boolean;
-  }): Promise<{ deleted: number; candidates: VektorMemory[] }>;
-
-  pin(id: string): Promise<{ id: string; pinned: true; content: string }>;
-  unpin(id: string): Promise<{ id: string; pinned: false; content: string }>;
-  listPinned(): Promise<VektorMemory[]>;
-
-  inspect(): InspectResult;
-
-  auditLog(opts?: {
-    limit?: number;
-    action?: 'ADD' | 'UPDATE' | 'DELETE' | 'NO_OP';
-    since?: string | number;
-  }): AudnLogEntry[];
-
-  export(opts?: {
-    includeEmbeddings?: boolean;
-    since?: string | number;
-  }): ExportBundle;
-
-  import(bundle: ExportBundle, opts?: {
-    namespace?: string;
-    mode?: 'merge' | 'replace';
-    dryRun?: boolean;
-  }): { imported: number; skipped: number; edgesAdded: number };
-
-  listNamespaces(): NamespaceRecord[];
-  deleteNamespace(namespace: string, confirm: string): { deleted: number; namespace: string };
-}
-
-// ─── Factory ─────────────────────────────────────────────────────────────────
-
-export declare function createMemory(opts: CreateMemoryOptions): Promise<Memory>;
-
-// ─── Entity resolver (separate import) ───────────────────────────────────────
-
-export interface EntityResolverOptions {
-  dbPath?: string;
-}
-
-export declare class EntityResolver {
-  constructor(memory: Memory, dbPath?: string);
-  remember(text: string, opts?: Record<string, unknown>): Promise<{
-    normalised: string;
-    entityIds: string[];
-    result: unknown;
-  }>;
-  resolve(ref: string, threshold?: number): Promise<EntityRecord | null>;
-  addEntity(canonical: string, type?: EntityRecord['type'], aliases?: string[]): string;
-  addAlias(alias: string, entityId: string, source?: string): void;
-  getEntity(id: string): EntityRecord | null;
-  listEntities(): EntityRecord[];
-  mergeEntities(sourceId: string, targetId: string): EntityRecord | null;
-  findDuplicateCandidates(threshold?: number): Promise<Array<{
-    entity_a: EntityRecord;
-    entity_b: EntityRecord;
-    score: number;
-  }>>;
-}

package/vektor-banner-loader.js

@@ -1,109 +0,0 @@
-'use strict';
-
-/**
- * vektor-banner-loader.js
- * Prints the VEKTOR ASCII banner with a real animated progress bar.
- * Bar animates while the process boots, resolves when ready.
- * Works on Windows (no ANSI cursor tricks that break cmd.exe).
- */
-
-const PKG   = require('./package.json');
-const start = Date.now();
-
-// ── Colours ───────────────────────────────────────────────────────────────────
-const ESC    = '\x1b[';
-const RESET  = '\x1b[0m';
-const ORANGE = '\x1b[38;5;214m';
-const DIM    = '\x1b[2m';
-const BOLD   = '\x1b[1m';
-const CYAN   = '\x1b[36m';
-
-// ── Banner lines (stored as plain ASCII — encoding-safe) ──────────────────────
-const BANNER = [
-  '  ██╗   ██╗███████╗██╗  ██╗████████╗ ██████╗ ██████╗ ',
-  '  ██║   ██║██╔════╝██║ ██╔╝╚══██╔══╝██╔═══██╗██╔══██╗',
-  '  ██║   ██║█████╗  █████╔╝    ██║   ██║   ██║██████╔╝',
-  '  ╚██╗ ██╔╝██╔══╝  ██╔═██╗    ██║   ██║   ██║██╔══██╗',
-  '   ╚████╔╝ ███████╗██║  ██╗   ██║   ╚██████╔╝██║  ██║',
-  "    ╚═══╝  ╚══════╝╚═╝  ╚═╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝",
-];
-
-// ── Print banner immediately ───────────────────────────────────────────────────
-process.stderr.write('\n');
-BANNER.forEach(l => process.stderr.write(ORANGE + l + RESET + '\n'));
-process.stderr.write('\n');
-process.stderr.write(DIM + '  SLIPSTREAM v' + PKG.version + '  ·  Sovereign Agent Memory' + RESET + '\n');
-process.stderr.write('\n');
-
-// ── Progress bar state ────────────────────────────────────────────────────────
-const BAR_WIDTH = 20;
-let   _pct      = 0;
-let   _label    = 'Initialising';
-let   _done     = false;
-let   _timer    = null;
-
-function renderBar(pct, label) {
-  const filled = Math.round((pct / 100) * BAR_WIDTH);
-  const empty  = BAR_WIDTH - filled;
-  const bar    = '█'.repeat(filled) + '░'.repeat(empty);
-  const pctStr = String(pct).padStart(3) + '%';
-  // \r moves to start of line, overwrites in place — works on Windows
-  // Pad label to 20 chars to fully overwrite any previous longer label on \r
-  const paddedLabel = (label + '                    ').slice(0, 20);
-  process.stderr.write(
-    '\r  ' + DIM + '└─ ' + RESET +
-    CYAN + '[' + bar + ']' + RESET + ' ' +
-    DIM + pctStr + '  ' + paddedLabel + RESET
-  );
-}
-
-// Animate: slowly tick up to 85% while waiting for real completion
-function startAnimation() {
-  const ticks = [
-    { at: 100,  pct: 10, label: 'Initialising'   },
-    { at: 200,  pct: 25, label: 'Loading core'   },
-    { at: 400,  pct: 40, label: 'Opening DB'     },
-    { at: 700,  pct: 55, label: 'Warming cache'  },
-    { at: 1000, pct: 70, label: 'Ready'          },
-    { at: 1400, pct: 82, label: 'Ready'          },
-  ];
-
-  renderBar(0, 'Initialising');
-
-  ticks.forEach(({ at, pct, label }) => {
-    setTimeout(() => {
-      if (_done) return;
-      _pct   = pct;
-      _label = label;
-      renderBar(_pct, _label);
-    }, at);
-  });
-}
-
-function completeBar(label) {
-  if (_done) return;
-  _done = true;
-  if (_timer) clearInterval(_timer);
-  renderBar(100, label || 'Ready');
-  process.stderr.write('\n\n');
-}
-
-// ── Auto-complete on process ready ────────────────────────────────────────────
-// If nothing calls complete() explicitly, finish bar when event loop drains
-_timer = setTimeout(() => {
-  if (!_done) completeBar('Ready');
-}, 2000);
-
-// Don't let this timer keep the process alive
-if (_timer.unref) _timer.unref();
-
-// ── Exports ───────────────────────────────────────────────────────────────────
-module.exports = {
-  loadedAt:    start,
-  progress:    (pct, label) => { if (!_done) { _pct = pct; _label = label; renderBar(pct, label); } },
-  complete:    completeBar,
-  fail:        (msg) => { completeBar('Error'); process.stderr.write('\n  ' + msg + '\n'); },
-};
-
-// Start animation
-startAnimation();