task-summary-extractor 8.3.0 → 9.0.0

package/src/utils/colors.js

@@ -0,0 +1,83 @@
+'use strict';
+
+// ---------------------------------------------------------------------------
+// ANSI color utility – zero dependencies
+// Auto-detects color support via NO_COLOR / FORCE_COLOR / isTTY.
+// ---------------------------------------------------------------------------
+
+const env = process.env;
+const enabled =
+  env.FORCE_COLOR !== undefined
+    ? env.FORCE_COLOR !== '0'
+    : !env.NO_COLOR && (process.stdout.isTTY === true);
+
+/** Whether ANSI colors are currently active. */
+const isColorEnabled = () => enabled;
+
+// -- helpers ----------------------------------------------------------------
+
+const esc = (open, close) =>
+  enabled ? (s) => `\x1b[${open}m${s}\x1b[${close}m` : (s) => String(s);
+
+const noop = (s) => String(s);
+
+// -- ANSI escape code regex (for stripping) ---------------------------------
+
+// eslint-disable-next-line no-control-regex
+const ANSI_RE = /\x1b\[[0-9;]*m/g;
+
+/** Remove all ANSI escape codes from a string. */
+const strip = (s) => String(s).replace(ANSI_RE, '');
+
+// -- style / color functions ------------------------------------------------
+
+const bold      = esc(1, 22);
+const dim       = esc(2, 22);
+const italic    = esc(3, 23);
+const underline = esc(4, 24);
+
+const red       = esc(31, 39);
+const green     = esc(32, 39);
+const yellow    = esc(33, 39);
+const blue      = esc(34, 39);
+const magenta   = esc(35, 39);
+const cyan      = esc(36, 39);
+const white     = esc(97, 39);
+const gray      = esc(90, 39);
+
+const bgRed     = esc(41, 49);
+const bgGreen   = esc(42, 49);
+const bgYellow  = esc(43, 49);
+const bgBlue    = esc(44, 49);
+
+// -- semantic aliases -------------------------------------------------------
+
+const compose = (...fns) =>
+  enabled ? (s) => fns.reduce((v, fn) => fn(v), s) : noop;
+
+const success   = enabled ? (s) => green(`✓ ${s}`)  : (s) => `✓ ${s}`;
+const error     = enabled ? (s) => red(`✗ ${s}`)    : (s) => `✗ ${s}`;
+const warn      = enabled ? (s) => yellow(`⚠ ${s}`) : (s) => `⚠ ${s}`;
+const info      = enabled ? (s) => blue(`ℹ ${s}`)   : (s) => `ℹ ${s}`;
+
+const heading   = compose(bold, cyan);
+const muted     = dim;
+const highlight = compose(bold, yellow);
+const link      = compose(underline, blue);
+
+// -- public API -------------------------------------------------------------
+
+/** Colour helper object – every function is a safe no-op when colours are off. */
+const c = {
+  // styles
+  bold, dim, italic, underline,
+  // foreground
+  red, green, yellow, blue, cyan, magenta, gray, white,
+  // background
+  bgRed, bgGreen, bgYellow, bgBlue,
+  // semantic
+  success, error, warn, info,
+  heading, muted, highlight, link,
+};
+
+module.exports = { c, isColorEnabled, strip };

package/src/utils/confidence-filter.js

@@ -0,0 +1,138 @@
+/**
+ * Confidence Filter — filters extracted items below a confidence threshold.
+ *
+ * Confidence hierarchy: HIGH (3) > MEDIUM (2) > LOW (1).
+ *
+ * Usage:
+ *   const { filterByConfidence } = require('./utils/confidence-filter');
+ *   const filtered = filterByConfidence(compiledAnalysis, 'MEDIUM');
+ *   // → keeps only HIGH + MEDIUM items; LOW items removed
+ *
+ * @module confidence-filter
+ */
+
+'use strict';
+
+// ======================== CONSTANTS ========================
+
+const LEVELS = { HIGH: 3, MEDIUM: 2, LOW: 1 };
+const VALID_LEVELS = new Set(['HIGH', 'MEDIUM', 'LOW']);
+
+// ======================== HELPERS ========================
+
+/**
+ * Count items across all filterable arrays.
+ * @param {object} data - compiled analysis object
+ * @returns {{ tickets: number, action_items: number, change_requests: number, blockers: number, scope_changes: number, your_tasks: number, total: number }}
+ */
+function countItems(data) {
+  const tickets = (data.tickets || []).length;
+  const action_items = (data.action_items || []).length;
+  const change_requests = (data.change_requests || []).length;
+  const blockers = (data.blockers || []).length;
+  const scope_changes = (data.scope_changes || []).length;
+
+  let your_tasks = 0;
+  if (data.your_tasks) {
+    your_tasks += (data.your_tasks.tasks_todo || []).length;
+    your_tasks += (data.your_tasks.tasks_waiting_on_others || []).length;
+    your_tasks += (data.your_tasks.decisions_needed || []).length;
+    your_tasks += (data.your_tasks.completed_in_call || []).length;
+  }
+
+  return {
+    tickets,
+    action_items,
+    change_requests,
+    blockers,
+    scope_changes,
+    your_tasks,
+    total: tickets + action_items + change_requests + blockers + scope_changes + your_tasks,
+  };
+}
+
+// ======================== MAIN FILTER ========================
+
+/**
+ * Filter a compiled analysis, removing items below the confidence threshold.
+ *
+ * Items without a `confidence` field are treated as LOW.
+ * Non-array fields (summary, file_references, etc.) are passed through untouched.
+ *
+ * @param {object} compiled     - Compiled analysis object
+ * @param {string} [minLevel='LOW'] - Minimum confidence: 'HIGH', 'MEDIUM', or 'LOW'
+ * @returns {object} Filtered copy with _filterMeta attached
+ */
+function filterByConfidence(compiled, minLevel = 'LOW') {
+  if (!compiled || typeof compiled !== 'object') return compiled;
+
+  const normalised = (minLevel || 'LOW').toUpperCase();
+  const threshold = LEVELS[normalised] || 1;
+
+  // If threshold is LOW (1), everything passes — return with meta only
+  const originalCounts = countItems(compiled);
+
+  if (threshold <= 1) {
+    return {
+      ...compiled,
+      _filterMeta: {
+        minConfidence: normalised,
+        originalCounts,
+        filteredCounts: { ...originalCounts },
+        removed: 0,
+      },
+    };
+  }
+
+  const filterArr = (items) =>
+    (items || []).filter(item => (LEVELS[item.confidence] || 1) >= threshold);
+
+  const filtered = {
+    ...compiled,
+    tickets: filterArr(compiled.tickets),
+    action_items: filterArr(compiled.action_items),
+    change_requests: filterArr(compiled.change_requests),
+    blockers: filterArr(compiled.blockers),
+    scope_changes: filterArr(compiled.scope_changes),
+  };
+
+  // Filter your_tasks sub-arrays if present
+  if (compiled.your_tasks && typeof compiled.your_tasks === 'object') {
+    filtered.your_tasks = {
+      ...compiled.your_tasks,
+      tasks_todo: filterArr(compiled.your_tasks.tasks_todo),
+      tasks_waiting_on_others: filterArr(compiled.your_tasks.tasks_waiting_on_others),
+      decisions_needed: filterArr(compiled.your_tasks.decisions_needed),
+      completed_in_call: filterArr(compiled.your_tasks.completed_in_call),
+    };
+  }
+
+  const filteredCounts = countItems(filtered);
+
+  filtered._filterMeta = {
+    minConfidence: normalised,
+    originalCounts,
+    filteredCounts,
+    removed: originalCounts.total - filteredCounts.total,
+  };
+
+  return filtered;
+}
+
+/**
+ * Validate a min-confidence level string.
+ * @param {string} level
+ * @returns {{ valid: boolean, normalised: string|null, error: string|null }}
+ */
+function validateConfidenceLevel(level) {
+  if (!level || typeof level !== 'string') {
+    return { valid: false, normalised: null, error: 'Confidence level must be a string: high, medium, or low' };
+  }
+  const normalised = level.toUpperCase();
+  if (!VALID_LEVELS.has(normalised)) {
+    return { valid: false, normalised: null, error: `Invalid confidence level "${level}". Must be: high, medium, or low` };
+  }
+  return { valid: true, normalised, error: null };
+}
+
+module.exports = { filterByConfidence, validateConfidenceLevel, countItems, LEVELS };

package/src/utils/diff-engine.js

@@ -10,6 +10,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const { c } = require('./colors');
 
 // ======================== PREVIOUS RUN LOADING ========================
 
@@ -61,7 +62,7 @@ function loadPreviousCompilation(targetDir, currentRunTs = null) {
       }
     }
   } catch (err) {
-    console.warn(`  ⚠ Could not load previous compilation: ${err.message}`);
+    console.warn(`  ${c.warn(`Could not load previous compilation: ${err.message}`)}`);
   }
 
   return null;

package/src/utils/global-config.js

@@ -21,6 +21,7 @@
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
+const { c } = require('./colors');
 
 // ── Config file path ──────────────────────────────────────────────────────
 const CONFIG_FILE = path.join(os.homedir(), '.taskexrc');
@@ -53,7 +54,7 @@ function loadGlobalConfig() {
   } catch (err) {
     // Warn if file exists but is corrupt (not just missing)
     if (fs.existsSync(CONFIG_FILE)) {
-      process.stderr.write(`  ⚠ Could not parse ${CONFIG_FILE}: ${err.message}\n`);
+      process.stderr.write(`  ${c.warn(`Could not parse ${CONFIG_FILE}: ${err.message}`)}\n`);
       process.stderr.write(`    Run \`taskex config\` to reconfigure, or delete the file.\n`);
     }
     return {};
@@ -155,7 +156,7 @@ async function interactiveSetup({ showOnly = false, clear = false, onlyMissing =
   if (clear) {
     const removed = clearGlobalConfig();
     if (removed) {
-      console.log('\n  ✓ Global config cleared (~/.taskexrc deleted)\n');
+      console.log(`\n  ${c.success('Global config cleared (~/.taskexrc deleted)')}\n`);
     } else {
       console.log('\n  No global config to clear.\n');
     }
@@ -233,7 +234,7 @@ async function interactiveSetup({ showOnly = false, clear = false, onlyMissing =
 
   if (Object.keys(updates).length > 0) {
     saveGlobalConfig(updates);
-    console.log(`  ✓ Saved ${Object.keys(updates).length} value(s) to ${CONFIG_FILE}`);
+    console.log(`  ${c.success(`Saved ${Object.keys(updates).length} value(s) to ${CONFIG_FILE}`)}`);
     console.log('');
 
     // Also inject into current process so the pipeline can proceed
@@ -260,7 +261,7 @@ async function promptForKey(key) {
   const readline = require('readline');
 
   console.log('');
-  console.log(`  ⚠ ${meta.label} is not configured.`);
+  console.log(`  ${c.warn(`${meta.label} is not configured.`)}`);
   if (meta.hint) console.log(`    ${meta.hint}`);
   console.log('');
 
@@ -292,7 +293,7 @@ async function promptForKey(key) {
 
   if (save) {
     saveGlobalConfig({ [key]: value });
-    console.log(`  ✓ Saved to ${CONFIG_FILE}`);
+    console.log(`  ${c.success(`Saved to ${CONFIG_FILE}`)}`);
   }
 
   // Inject into current process

package/src/utils/health-dashboard.js

@@ -13,6 +13,8 @@
 
 'use strict';
 
+const { c } = require('./colors');
+
 // ======================== HEALTH REPORT ========================
 
 /**
@@ -133,7 +135,7 @@ function buildHealthReport(params) {
  * @param {object} report - From buildHealthReport
  */
 function printHealthDashboard(report) {
-  const { summary: s, extraction: e, retry: r, efficiency: eff, compilation: c } = report;
+  const { summary: s, extraction: e, retry: r, efficiency: eff, compilation: comp } = report;
 
   console.log('');
   console.log('╔══════════════════════════════════════════════╗');
@@ -145,7 +147,7 @@ function printHealthDashboard(report) {
   console.log('  Quality Scores:');
   console.log(`    Average : ${s.avgQualityScore}/100`);
   console.log(`    Range   : ${s.minQualityScore}–${s.maxQualityScore}`);
-  console.log(`    Grades  : ✓ ${s.grades.PASS} PASS | ⚠ ${s.grades.WARN} WARN | ✗ ${s.grades.FAIL} FAIL`);
+  console.log(`    Grades  : ${c.success(`${s.grades.PASS} PASS`)} | ${c.warn(`${s.grades.WARN} WARN`)} | ${c.error(`${s.grades.FAIL} FAIL`)}`);
   console.log(`    Parse   : ${s.parseSuccessRate}% success rate`);
   console.log('');
 
@@ -186,14 +188,14 @@ function printHealthDashboard(report) {
   console.log(`    Cost        : $${eff.totalCost.toFixed(4)}`);
 
   // Compilation quality
-  if (c) {
+  if (comp) {
     console.log('');
     console.log('  Compilation:');
-    console.log(`    Score : ${c.score}/100 (${c.grade})`);
-    if (c.issues.length > 0) {
-      console.log(`    Issues: ${c.issues.length}`);
-      c.issues.slice(0, 3).forEach(issue => console.log(`      • ${issue}`));
-      if (c.issues.length > 3) console.log(`      ... +${c.issues.length - 3} more`);
+    console.log(`    Score : ${comp.score}/100 (${comp.grade})`);
+    if (comp.issues.length > 0) {
+      console.log(`    Issues: ${comp.issues.length}`);
+      comp.issues.slice(0, 3).forEach(issue => console.log(`      • ${issue}`));
+      if (comp.issues.length > 3) console.log(`      ... +${comp.issues.length - 3} more`);
     }
   }
 
@@ -203,7 +205,7 @@ function printHealthDashboard(report) {
   );
   if (criticalIssues.length > 0) {
     console.log('');
-    console.log('  ⚠ Critical Issues:');
+    console.log(`  ${c.warn('Critical Issues:')}`);
     criticalIssues.slice(0, 5).forEach(i => console.log(`    ${i.segment}: ${i.issue}`));
   }
 

package/src/utils/json-parser.js

@@ -6,6 +6,8 @@
 
 'use strict';
 
+const { c } = require('./colors');
+
 /**
  * Gemini sometimes produces invalid JSON escape sequences (e.g. \d, \s, \w from regex patterns).
  * Fix them by double-escaping backslashes that aren't valid JSON escapes.
@@ -228,14 +230,14 @@ function extractJson(rawText) {
   // This is common for large compilation outputs (safest repair, stack-based)
   parsed = repairTruncatedJson(rawText);
   if (parsed !== undefined) {
-    console.warn('  ⚠ JSON was truncated — recovered partial data by closing open structures');
+    console.warn(`  ${c.warn('JSON was truncated — recovered partial data by closing open structures')}`);
     return parsed;
   }
 
   // Strategy 5: Fix doubled closers and mid-output structural errors (aggressive, last resort)
   parsed = repairDoubledClosers(rawText);
   if (parsed !== undefined) {
-    console.warn('  ⚠ JSON had structural errors (doubled braces/commas) — repaired');
+    console.warn(`  ${c.warn('JSON had structural errors (doubled braces/commas) — repaired')}`);
     return parsed;
   }
 

package/src/utils/learning-loop.js

@@ -13,6 +13,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const { c } = require('./colors');
 
 const HISTORY_FILE = 'history.json';
 const MAX_HISTORY_ENTRIES = 50; // Keep last 50 runs
@@ -33,7 +34,7 @@ function loadHistory(projectRoot) {
       return Array.isArray(data) ? data : [];
     }
   } catch (err) {
-    console.warn(`  ⚠ Could not load history: ${err.message}`);
+    console.warn(`  ${c.warn(`Could not load history: ${err.message}`)}`);
   }
   return [];
 }
@@ -54,7 +55,7 @@ function saveHistory(projectRoot, entry) {
     const trimmed = history.slice(-MAX_HISTORY_ENTRIES);
     fs.writeFileSync(historyPath, JSON.stringify(trimmed, null, 2), 'utf8');
   } catch (err) {
-    console.warn(`  ⚠ Could not save history: ${err.message}`);
+    console.warn(`  ${c.warn(`Could not save history: ${err.message}`)}`);
   }
 }
 

package/src/utils/progress-bar.js

@@ -0,0 +1,286 @@
+/**
+ * Progress Bar — visual progress display for pipeline phases.
+ *
+ * Features:
+ *  - Real-time bar with phase name, percentage, and ETA
+ *  - Segment-level sub-progress during media processing
+ *  - Live cost display via CostTracker integration
+ *  - Non-TTY fallback: one line per event (CI-friendly)
+ *  - Writes to stderr to avoid polluting piped stdout
+ *
+ * @module progress-bar
+ */
+
+'use strict';
+
+const { fmtDuration } = require('./format');
+
+// ======================== PHASE DEFINITIONS ========================
+
+const PHASES = [
+  { key: 'init',       label: 'Init',         index: 1 },
+  { key: 'discover',   label: 'Discover',     index: 2 },
+  { key: 'services',   label: 'Services',     index: 3 },
+  { key: 'compress',   label: 'Compress',     index: 4 },
+  { key: 'upload',     label: 'Upload',       index: 5 },
+  { key: 'analyze',    label: 'Analyze',      index: 6 },
+  { key: 'compile',    label: 'Compile',      index: 7 },
+  { key: 'output',     label: 'Output',       index: 8 },
+  { key: 'summary',    label: 'Summary',      index: 9 },
+  { key: 'deep-dive',  label: 'Deep Dive',    index: 10 },
+];
+
+const PHASE_MAP = Object.fromEntries(PHASES.map(p => [p.key, p]));
+const TOTAL_PHASES = PHASES.length;
+
+// ======================== BAR CHARACTERS ========================
+
+const BAR_FILLED = '\u2501';   // ━
+const BAR_EMPTY  = '\u2500';   // ─
+const BAR_LEFT   = '';
+const BAR_RIGHT  = '';
+
+// ======================== PROGRESS BAR CLASS ========================
+
+class ProgressBar {
+  /**
+   * @param {object} [opts]
+   * @param {number} [opts.width=40]          - Bar width in characters
+   * @param {NodeJS.WriteStream} [opts.stream] - Output stream (default: stderr)
+   * @param {boolean} [opts.enabled]          - Force enable/disable (default: auto-detect TTY)
+   * @param {object} [opts.costTracker]       - CostTracker instance for live cost display
+   * @param {string} [opts.callName]          - Name of the current call/project
+   */
+  constructor(opts = {}) {
+    this.width = opts.width || 40;
+    this.stream = opts.stream || process.stderr;
+    this.enabled = opts.enabled !== undefined ? opts.enabled : (this.stream.isTTY === true);
+    this.costTracker = opts.costTracker || null;
+    this.callName = opts.callName || '';
+
+    // Phase tracking
+    this.phaseKey = 'init';
+    this.phaseLabel = 'Init';
+    this.phaseIndex = 1;
+
+    // Item tracking within a phase
+    this.total = 0;
+    this.current = 0;
+    this.itemLabel = '';
+
+    // Time tracking
+    this.startTime = Date.now();
+    this.phaseStartTime = Date.now();
+
+    // Sub-status for long operations
+    this.subStatus = '';
+
+    // Track if we need to restore cursor
+    this._lastLineLength = 0;
+    this._rendered = false;
+  }
+
+  // ======================== PUBLIC API ========================
+
+  /**
+   * Set the current pipeline phase.
+   * @param {string} key    - Phase key (e.g. 'compress', 'analyze')
+   * @param {number} [total] - Total items in this phase
+   */
+  setPhase(key, total) {
+    const phase = PHASE_MAP[key];
+    if (phase) {
+      this.phaseKey = key;
+      this.phaseLabel = phase.label;
+      this.phaseIndex = phase.index;
+    } else {
+      this.phaseKey = key;
+      this.phaseLabel = key;
+    }
+
+    this.total = total || 0;
+    this.current = 0;
+    this.itemLabel = '';
+    this.subStatus = '';
+    this.phaseStartTime = Date.now();
+
+    if (this.enabled) {
+      this._clearLine();
+      this.render();
+    } else {
+      this._logEvent(`[Phase ${this.phaseIndex}/${TOTAL_PHASES}] ${this.phaseLabel}`);
+    }
+  }
+
+  /**
+   * Set total items for the current phase.
+   * @param {number} n
+   */
+  setTotal(n) {
+    this.total = n;
+    if (this.enabled) this.render();
+  }
+
+  /**
+   * Increment progress by 1 and update the item label.
+   * @param {string} [label] - Current item description (e.g. "segment_01.mp4")
+   */
+  tick(label) {
+    this.current = Math.min(this.current + 1, Math.max(this.total, this.current + 1));
+    if (label) this.itemLabel = label;
+    this.subStatus = '';
+
+    if (this.enabled) {
+      this.render();
+    } else if (label) {
+      this._logEvent(`  ${label} (${this.current}/${this.total})`);
+    }
+  }
+
+  /**
+   * Update the sub-status text without incrementing.
+   * @param {string} text - Status text (e.g. "Uploading to Storage...")
+   */
+  status(text) {
+    this.subStatus = text;
+    if (this.enabled) this.render();
+  }
+
+  /**
+   * Finish the progress bar — print a final newline and clear.
+   */
+  finish() {
+    if (this.enabled && this._rendered) {
+      this._clearLine();
+      const elapsed = fmtDuration((Date.now() - this.startTime) / 1000);
+      const cost = this._getCostString();
+      const line = `  Done in ${elapsed}${cost ? ` | ${cost}` : ''}`;
+      this.stream.write(line + '\n');
+    }
+    this._rendered = false;
+  }
+
+  /**
+   * Cleanup — restore terminal state.
+   */
+  cleanup() {
+    if (this._rendered) {
+      this._clearLine();
+    }
+  }
+
+  // ======================== RENDERING ========================
+
+  /**
+   * Render the progress bar to the stream.
+   */
+  render() {
+    if (!this.enabled) return;
+
+    const pct = this.total > 0 ? Math.min(100, Math.round((this.current / this.total) * 100)) : 0;
+    const filledWidth = this.total > 0
+      ? Math.min(this.width, Math.round((this.current / this.total) * this.width))
+      : 0;
+    const emptyWidth = Math.max(0, this.width - filledWidth);
+
+    // Build bar
+    const bar = BAR_LEFT +
+      BAR_FILLED.repeat(filledWidth) +
+      BAR_EMPTY.repeat(emptyWidth) +
+      BAR_RIGHT;
+
+    // Phase info
+    const phaseStr = `Phase ${this.phaseIndex}/${TOTAL_PHASES}: ${this.phaseLabel}`;
+
+    // ETA
+    const eta = this._eta();
+    const etaStr = eta ? ` | ETA: ${eta}` : '';
+
+    // Cost
+    const costStr = this._getCostString();
+    const costPart = costStr ? ` | ${costStr}` : '';
+
+    // Item label or sub-status
+    const detail = this.subStatus || this.itemLabel;
+    const detailStr = detail ? ` ${detail}` : '';
+
+    // Progress counts
+    const countStr = this.total > 0 ? ` ${this.current}/${this.total}` : '';
+
+    // Build line
+    const line = `  ${bar} ${pct}% | ${phaseStr}${countStr}${detailStr}${etaStr}${costPart}`;
+
+    // Write with \r to overwrite
+    this._clearLine();
+    this.stream.write('\r' + line);
+    this._lastLineLength = line.length;
+    this._rendered = true;
+  }
+
+  // ======================== INTERNAL ========================
+
+  /**
+   * Calculate ETA based on elapsed time and progress.
+   * @returns {string|null}
+   */
+  _eta() {
+    if (this.total <= 0 || this.current <= 0) return null;
+
+    const elapsed = Date.now() - this.phaseStartTime;
+    if (elapsed < 2000) return null; // Don't show ETA for first 2s (unreliable)
+
+    const msPerItem = elapsed / this.current;
+    const remaining = (this.total - this.current) * msPerItem;
+
+    if (remaining < 1000) return null;
+    return fmtDuration(remaining / 1000);
+  }
+
+  /**
+   * Get formatted cost string from CostTracker.
+   * @returns {string}
+   */
+  _getCostString() {
+    if (!this.costTracker) return '';
+    try {
+      const summary = this.costTracker.getSummary();
+      if (summary.totalCost > 0) {
+        return `$${summary.totalCost.toFixed(4)}`;
+      }
+    } catch {
+      // CostTracker not ready
+    }
+    return '';
+  }
+
+  /**
+   * Clear the current line.
+   */
+  _clearLine() {
+    if (this._lastLineLength > 0) {
+      this.stream.write('\r' + ' '.repeat(this._lastLineLength + 2) + '\r');
+    }
+  }
+
+  /**
+   * Non-TTY fallback: print a simple log line.
+   * @param {string} msg
+   */
+  _logEvent(msg) {
+    this.stream.write(msg + '\n');
+  }
+}
+
+// ======================== FACTORY ========================
+
+/**
+ * Create a ProgressBar instance with sensible defaults.
+ *
+ * @param {object} [opts] - Same as ProgressBar constructor
+ * @returns {ProgressBar}
+ */
+function createProgressBar(opts = {}) {
+  return new ProgressBar(opts);
+}
+
+module.exports = { ProgressBar, createProgressBar, PHASES, PHASE_MAP };