tribunal-kit 9.2.6 → 9.2.8

package/src/tui/panel.js

@@ -0,0 +1,55 @@
+'use strict';
+
+const { isTTY, hasColor, RGB, GLYPHS, color, bold, dim, getColumns } = require('./theme');
+
+/**
+ * Render a bordered panel with an optional title and content.
+ * Follows the Pro-Max high-density aesthetic with subtle borders.
+ * 
+ * @param {string} title The title of the panel
+ * @param {string[]} lines Array of strings to render inside the panel
+ * @param {object} options
+ * @param {string} options.accessory Right-aligned text in the header
+ * @param {number} options.width Max width of the panel (defaults to terminal width or 100)
+ */
+function renderPanel(title, lines, options = {}) {
+  const g = GLYPHS;
+  const cols = getColumns();
+  const width = Math.min(options.width || 100, Math.max(64, cols));
+  const innerWidth = width - 4;
+
+  const topBorder = color(RGB.SLATE_700, g.boxTl + g.boxH.repeat(innerWidth + 2) + g.boxTr);
+  const bottomBorder = color(RGB.SLATE_700, g.boxBl + g.boxH.repeat(innerWidth + 2) + g.boxBr);
+  const pipe = color(RGB.SLATE_700, g.boxV);
+
+  console.log();
+
+  if (title) {
+    const boldTitle = bold(color(RGB.WHITE, title));
+    const accessory = options.accessory ? dim(options.accessory) : '';
+    // Strip ANSI codes to calculate actual text length for padding
+    const titleLen = title.replace(/\x1b\[[0-9;]*m/g, '').length;
+    const accessoryLen = options.accessory ? options.accessory.replace(/\x1b\[[0-9;]*m/g, '').length : 0;
+    const spaceCount = Math.max(1, innerWidth - titleLen - accessoryLen);
+    
+    console.log(`  ${topBorder}`);
+    console.log(`  ${pipe} ${boldTitle}${' '.repeat(spaceCount)}${accessory} ${pipe}`);
+    console.log(`  ${color(RGB.SLATE_700, g.treeMid + g.boxH.repeat(innerWidth + 2) + '┤')}`);
+  } else {
+    console.log(`  ${topBorder}`);
+  }
+
+  lines.forEach(line => {
+    // Strip ANSI to find visual length
+    const visualLength = line.replace(/\x1b\[[0-9;]*m/g, '').length;
+    const padding = Math.max(0, innerWidth - visualLength + 1);
+    console.log(`  ${pipe} ${line}${' '.repeat(padding)}${pipe}`);
+  });
+
+  console.log(`  ${bottomBorder}`);
+  console.log();
+}
+
+module.exports = {
+  renderPanel,
+};

package/src/tui/progress.js

@@ -0,0 +1,42 @@
+'use strict';
+
+const { isTTY, hasColor, RGB, GLYPHS, color, bold, dim, getColumns } = require('./theme');
+
+/**
+ * Render a progress bar or metric visualization.
+ */
+function renderProgressBar(label, percentage, options = {}) {
+  const cols = getColumns();
+  const maxBarWidth = options.width || 30;
+  
+  const g = GLYPHS;
+  const pct = Math.max(0, Math.min(100, percentage));
+  const filledCount = Math.round((pct / 100) * maxBarWidth);
+  const emptyCount = maxBarWidth - filledCount;
+
+  const filledColor = options.color || RGB.CYAN;
+  
+  let filledChars = '';
+  if (filledCount > 0) {
+    filledChars = color(filledColor, g.barFill.repeat(filledCount));
+  }
+  const emptyChars = color(RGB.SLATE_700, g.barEmpty.repeat(emptyCount));
+  
+  const labelText = color(RGB.ZINC_200, label.padEnd(options.labelWidth || 15));
+  const pctText = dim(`${pct.toFixed(options.decimals || 0)}%`.padStart(5));
+  
+  return `  ${labelText} ${filledChars}${emptyChars}  ${pctText}`;
+}
+
+function renderMetric(label, value, options = {}) {
+  const labelText = dim(label.padEnd(options.labelWidth || 15));
+  const valColor = options.color || RGB.WHITE;
+  const valText = bold(color(valColor, String(value)));
+  
+  return `  ${labelText} ${valText}`;
+}
+
+module.exports = {
+  renderProgressBar,
+  renderMetric,
+};

package/src/tui/reviewer-grid.js

@@ -5,7 +5,8 @@
  * Animates all 28 Tribunal reviewers running concurrently.
  */
 
-const { isTTY, hasColor, RGB, GLYPHS, color, bold, getColumns } = require('./theme');
+const { isTTY, hasColor, RGB, GLYPHS, color, bold, dim, getColumns } = require('./theme');
+const { renderProgressBar } = require('./progress');
 
 const ALL_REVIEWERS = [
   ['logic-auditor', 'Logic & Correctness'],
@@ -40,19 +41,19 @@ const ALL_REVIEWERS = [
 
 function renderReviewerGrid(completedCount = 28) {
   if (!isTTY && !hasColor) {
-    console.log('  ✔ 28/28 Reviewers passed verification gates.');
+    console.log(`  ✔ ${completedCount}/${ALL_REVIEWERS.length} Reviewers passed verification gates.`);
     return;
   }
 
   const g = GLYPHS;
   const cols = getColumns();
-  const numCols = cols >= 100 ? 3 : cols >= 68 ? 2 : 1;
-  const colWidth = Math.floor(Math.max(20, cols - 6) / numCols);
+  const numCols = cols >= 110 ? 3 : cols >= 72 ? 2 : 1;
+  const colWidth = Math.floor(Math.max(25, cols - 6) / numCols);
 
   console.log();
-  const headerTitle = `  🛡️  Tribunal Parallel Reviewer Swarm (28 Reviewers)`;
-  console.log(bold(headerTitle));
-  console.log(`  ${color(RGB.SLATE_700, g.boxH.repeat(Math.min(84, cols - 4)))}`);
+  const pct = (completedCount / ALL_REVIEWERS.length) * 100;
+  console.log(renderProgressBar('Tribunal Swarm', pct, { width: 30, color: RGB.CYAN, labelWidth: 16 }));
+  console.log();
 
   for (let r = 0; r < Math.ceil(ALL_REVIEWERS.length / numCols); r++) {
     let line = '  ';
@@ -64,8 +65,7 @@ function renderReviewerGrid(completedCount = 28) {
       const isDone = idx < completedCount;
 
       const icon = isDone ? color(RGB.EMERALD, g.success) : color(RGB.FLAME, '⠋');
-
-      const nameColored = isDone ? color(RGB.WHITE, name) : color(RGB.ZINC_500, name);
+      const nameColored = isDone ? color(RGB.ZINC_200, name) : dim(name);
 
       const itemStr = `${icon} ${nameColored}`;
       const rawLen = 2 + name.length;
@@ -76,7 +76,6 @@ function renderReviewerGrid(completedCount = 28) {
     console.log(line);
   }
 
-  console.log(`  ${color(RGB.SLATE_700, g.boxH.repeat(Math.min(84, cols - 4)))}`);
   console.log();
 }
 

package/src/tui/theme.js

@@ -27,26 +27,32 @@ const isUtf8 =
     process.platform !== 'win32');
 
 const RGB = {
-  SLATE_900: [13, 13, 15],
-  SLATE_800: [30, 30, 34],
-  SLATE_700: [47, 47, 51],
-  ZINC_600: [86, 95, 137],
-  ZINC_500: [122, 122, 122],
+  // Pro-Max Deep Dark Theme
+  SLATE_950: [9, 9, 11],
+  SLATE_900: [15, 15, 20],
+  SLATE_800: [28, 28, 35],
+  SLATE_700: [45, 45, 55],
+  
+  ZINC_600: [82, 82, 91],
+  ZINC_500: [113, 113, 122],
   ZINC_400: [161, 161, 170],
   ZINC_200: [228, 228, 231],
-  WHITE: [237, 237, 237],
+  WHITE: [250, 250, 250],
+  PURE_WHITE: [255, 255, 255],
 
-  // Accents (Flame / Amber / Coral)
-  FLAME: [205, 105, 74], // #cd694a
-  CORAL_BRIGHT: [231, 148, 117], // #e79475
-  AMBER: [245, 158, 11], // #f59e0b
-  GOLD: [255, 215, 0], // #ffd700
+  // Accents
+  FLAME: [225, 75, 45],       // Punchier Orange-Red
+  FLAME_MUTED: [180, 60, 40],
+  CORAL_BRIGHT: [245, 120, 95], 
+  AMBER: [245, 158, 11], 
+  GOLD: [255, 215, 0], 
 
   // Status
-  EMERALD: [78, 169, 111], // #4ea96f
-  CYAN: [125, 207, 255], // #7dcfff
-  ROSE: [244, 63, 94], // #f43f5e
-  PURPLE: [177, 167, 255], // #b1a7ff
+  EMERALD: [35, 195, 105],    // Sharper Green
+  EMERALD_DIM: [20, 90, 50],
+  CYAN: [56, 189, 248], 
+  ROSE: [244, 63, 94], 
+  PURPLE: [168, 85, 247],
 };
 
 const UTF8_GLYPHS = {
@@ -68,6 +74,9 @@ const UTF8_GLYPHS = {
   dot: '·',
   check: '[✔]',
   uncheck: '[ ]',
+  barEmpty: '░',
+  barFill: '█',
+  pointer: '➜',
 };
 
 const ASCII_GLYPHS = {
@@ -89,6 +98,9 @@ const ASCII_GLYPHS = {
   dot: '.',
   check: '[x]',
   uncheck: '[ ]',
+  barEmpty: '-',
+  barFill: '=',
+  pointer: '->',
 };
 
 const GLYPHS = isUtf8 ? UTF8_GLYPHS : ASCII_GLYPHS;
@@ -98,10 +110,17 @@ function color(rgb, text) {
   if (hasTrueColor && Array.isArray(rgb)) {
     return `\x1b[38;2;${rgb[0]};${rgb[1]};${rgb[2]}m${text}\x1b[0m`;
   }
-  // Fallback ANSI 16-color
   return `\x1b[96m${text}\x1b[0m`;
 }
 
+function bg(rgb, text) {
+  if (!hasColor) return String(text);
+  if (hasTrueColor && Array.isArray(rgb)) {
+    return `\x1b[48;2;${rgb[0]};${rgb[1]};${rgb[2]}m${text}\x1b[0m`;
+  }
+  return `\x1b[106m${text}\x1b[0m`;
+}
+
 function bold(text) {
   if (!hasColor) return String(text);
   return `\x1b[1m${text}\x1b[0m`;
@@ -112,10 +131,30 @@ function dim(text) {
   return `\x1b[90m${text}\x1b[0m`;
 }
 
+function inverse(text) {
+  if (!hasColor) return String(text);
+  return `\x1b[7m${text}\x1b[0m`;
+}
+
+function italic(text) {
+  if (!hasColor) return String(text);
+  return `\x1b[3m${text}\x1b[0m`;
+}
+
 function getColumns() {
   return (process.stdout && process.stdout.columns) || 80;
 }
 
+const cursor = {
+  up: (n = 1) => (isTTY ? `\x1b[${n}A` : ''),
+  down: (n = 1) => (isTTY ? `\x1b[${n}B` : ''),
+  right: (n = 1) => (isTTY ? `\x1b[${n}C` : ''),
+  left: (n = 1) => (isTTY ? `\x1b[${n}D` : ''),
+  clearLine: () => (isTTY ? '\x1b[2K' : ''),
+  hide: () => (isTTY ? '\x1b[?25l' : ''),
+  show: () => (isTTY ? '\x1b[?25h' : ''),
+};
+
 module.exports = {
   isTTY,
   hasColor,
@@ -124,7 +163,11 @@ module.exports = {
   RGB,
   GLYPHS,
   color,
+  bg,
   bold,
   dim,
+  inverse,
+  italic,
   getColumns,
+  cursor,
 };

package/src/tui/tree.js

@@ -1,14 +1,16 @@
 'use strict';
 
 /**
- * Hierarchical action tree nodes (⏺ / ⎿) matching the Brainless agent specification.
+ * Hierarchical action tree nodes matching the Pro-Max design system.
+ * Uses connected timeline visuals to group steps contextually.
  */
 
-const { isTTY, RGB, GLYPHS, color, bold } = require('./theme');
+const { isTTY, RGB, GLYPHS, color, bold, dim } = require('./theme');
 
 class ActionTree {
   constructor(options = {}) {
     this.staggerMs = isTTY ? (options.staggerMs ?? 15) : 0;
+    this.inProgress = false;
   }
 
   sleep(ms) {
@@ -16,18 +18,33 @@ class ActionTree {
     return new Promise(resolve => setTimeout(resolve, ms));
   }
 
+  _drawConnector(glyph, itemColor, indent = '  ') {
+    return `${indent}${color(itemColor, glyph)}`;
+  }
+
+  _printLine(line) {
+    if (line === undefined) {
+      console.log();
+    } else {
+      console.log(line);
+    }
+  }
+
   async action(verb, target = null) {
-    const g = GLYPHS;
-    const bullet = color(RGB.EMERALD, g.bullet);
-    const coloredVerb = color(RGB.WHITE, bold(verb));
+    if (this.inProgress) {
+      // Close previous action visually if it was left open
+      this._printLine(`  ${color(RGB.SLATE_700, GLYPHS.boxV)}`);
+    }
+    this.inProgress = true;
+    
+    const bullet = color(RGB.EMERALD, GLYPHS.bullet);
+    const coloredVerb = bold(color(RGB.WHITE, verb));
 
     if (target) {
-      const openParen = color(RGB.ZINC_600, '(');
       const coloredTarget = color(RGB.CYAN, target);
-      const closeParen = color(RGB.ZINC_600, ')');
-      console.log(`  ${bullet} ${coloredVerb}${openParen}${coloredTarget}${closeParen}`);
+      this._printLine(`  ${bullet} ${coloredVerb} ${dim('➜')} ${coloredTarget}`);
     } else {
-      console.log(`  ${bullet} ${coloredVerb}`);
+      this._printLine(`  ${bullet} ${coloredVerb}`);
     }
 
     if (this.staggerMs > 0) {
@@ -36,10 +53,12 @@ class ActionTree {
   }
 
   async branch(message) {
-    const g = GLYPHS;
-    const branchGlyph = color(RGB.ZINC_600, g.branch);
+    const pipe = color(RGB.SLATE_700, GLYPHS.boxV);
+    const branchGlyph = color(RGB.ZINC_600, GLYPHS.treeMid);
     const coloredMsg = color(RGB.ZINC_400, message);
-    console.log(`    ${branchGlyph} ${coloredMsg}`);
+    
+    this._printLine(`  ${pipe}`);
+    this._printLine(`  ${pipe} ${branchGlyph} ${coloredMsg}`);
 
     if (this.staggerMs > 0) {
       await this.sleep(this.staggerMs);
@@ -47,15 +66,17 @@ class ActionTree {
   }
 
   async itemSuccess(title, detail = null) {
-    const g = GLYPHS;
-    const check = color(RGB.EMERALD, g.success);
+    const pipe = color(RGB.SLATE_700, GLYPHS.boxV);
+    const check = color(RGB.EMERALD, GLYPHS.success);
     const coloredTitle = color(RGB.WHITE, title);
+    const connector = color(RGB.ZINC_600, GLYPHS.treeMid);
 
+    this._printLine(`  ${pipe}`);
     if (detail) {
       const coloredDetail = color(RGB.ZINC_500, detail);
-      console.log(`    ${check} ${coloredTitle} ${coloredDetail}`);
+      this._printLine(`  ${pipe} ${connector} ${check} ${coloredTitle} ${coloredDetail}`);
     } else {
-      console.log(`    ${check} ${coloredTitle}`);
+      this._printLine(`  ${pipe} ${connector} ${check} ${coloredTitle}`);
     }
 
     if (this.staggerMs > 0) {
@@ -64,27 +85,34 @@ class ActionTree {
   }
 
   itemWarning(message) {
-    const g = GLYPHS;
-    const warn = color(RGB.AMBER, g.warning);
+    const pipe = color(RGB.SLATE_700, GLYPHS.boxV);
+    const warn = color(RGB.AMBER, GLYPHS.warning);
     const coloredMsg = color(RGB.AMBER, message);
-    console.log(`    ${warn} ${coloredMsg}`);
+    const connector = color(RGB.ZINC_600, GLYPHS.treeMid);
+    this._printLine(`  ${pipe}`);
+    this._printLine(`  ${pipe} ${connector} ${warn} ${coloredMsg}`);
   }
 
   itemError(message) {
-    const g = GLYPHS;
-    const err = color(RGB.ROSE, g.failure);
+    const pipe = color(RGB.SLATE_700, GLYPHS.boxV);
+    const err = color(RGB.ROSE, GLYPHS.failure);
     const coloredMsg = color(RGB.ROSE, message);
-    console.log(`    ${err} ${coloredMsg}`);
+    const connector = color(RGB.ZINC_600, GLYPHS.treeEnd);
+    this._printLine(`  ${pipe}`);
+    this._printLine(`  ${pipe} ${connector} ${err} ${coloredMsg}`);
+    this.inProgress = false;
   }
 
   complete(message) {
-    const g = GLYPHS;
-    const check = color(RGB.EMERALD, g.success);
-    const boldMsg = bold(message);
-    const colored = color(RGB.WHITE, boldMsg);
-    console.log();
-    console.log(`  ${check} ${colored}`);
-    console.log();
+    this.inProgress = false;
+    const check = color(RGB.EMERALD, GLYPHS.success);
+    const colored = bold(color(RGB.PURE_WHITE, message));
+    
+    // Cap off the timeline
+    this._printLine(`  ${color(RGB.SLATE_700, GLYPHS.treeEnd)}`);
+    this._printLine();
+    this._printLine(`  ${check} ${colored}`);
+    this._printLine();
   }
 }
 

package/src/tui/wizard.js

@@ -3,23 +3,26 @@
 /**
  * Zero-dependency interactive terminal multi-select wizard.
  * Handles keyboard navigation, space-to-toggle, and non-TTY fallback.
+ * Upgraded for Pro-Max design.
  */
 
 const readline = require('readline');
-const { isTTY, RGB, GLYPHS, color, bold } = require('./theme');
+const { isTTY, RGB, GLYPHS, color, bold, bg, inverse } = require('./theme');
 
 class WizardPrompt {
   displaySummary(question, options) {
     const g = GLYPHS;
     const prefix = color(RGB.AMBER, '?');
-    const boldQ = bold(question);
+    const boldQ = bold(color(RGB.WHITE, question));
+    console.log();
     console.log(`  ${prefix} ${boldQ}`);
+    console.log();
 
     for (const opt of options) {
       const check = opt.selected ? color(RGB.EMERALD, g.check) : color(RGB.ZINC_600, g.uncheck);
 
       const labelColored = opt.selected
-        ? color(RGB.WHITE, opt.label)
+        ? color(RGB.PURE_WHITE, opt.label)
         : color(RGB.ZINC_500, opt.label);
 
       const detailColored = color(RGB.ZINC_600, opt.detail || '');
@@ -28,8 +31,7 @@ class WizardPrompt {
     }
 
     const hint = '[Space] Toggle · [Enter] Confirm · [A] Select All';
-    console.log(`  ${color(RGB.ZINC_600, hint)}`);
-    console.log();
+    console.log(`\n  ${color(RGB.ZINC_600, hint)}\n`);
   }
 
   async selectMultiple(question, initialOptions) {
@@ -53,34 +55,36 @@ class WizardPrompt {
       process.stdout.write('\x1b[?25l');
 
       const render = (isFinal = false) => {
-        // Move back up lines if not initial render
-        const totalLines = options.length + 3;
-
         let out = '';
         const prefix = color(RGB.AMBER, '?');
-        out += `  ${prefix} ${bold(question)}\n`;
+        out += `\n  ${prefix} ${bold(color(RGB.WHITE, question))}\n\n`;
 
         options.forEach((opt, idx) => {
           const isCursor = idx === cursor;
-          const pointer = isCursor ? color(RGB.FLAME, g.chevron) : ' ';
+          const pointer = isCursor ? color(RGB.FLAME, g.pointer) : '  ';
           const check = opt.selected ? color(RGB.EMERALD, g.check) : color(RGB.ZINC_600, g.uncheck);
 
-          const labelColored = opt.selected
-            ? color(RGB.WHITE, bold(opt.label))
-            : color(RGB.ZINC_400, opt.label);
+          let labelColored = opt.label;
+          if (isCursor) {
+             labelColored = inverse(bold(` ${labelColored} `));
+          } else if (opt.selected) {
+             labelColored = color(RGB.PURE_WHITE, ` ${labelColored} `);
+          } else {
+             labelColored = color(RGB.ZINC_500, ` ${labelColored} `);
+          }
 
           const detailColored = color(RGB.ZINC_600, opt.detail || '');
           out += `  ${pointer} ${check} ${labelColored} ${detailColored}\n`;
         });
 
         if (isFinal) {
-          out += `  ${color(RGB.EMERALD, '✔ Configuration selected.')}\n`;
+          out += `\n  ${color(RGB.EMERALD, '✔ Configuration locked.')}\n`;
         } else {
           const hint = '[Space] Toggle · [Enter] Confirm · [A] All · [↑/↓] Move';
-          out += `  ${color(RGB.ZINC_600, hint)}\n`;
+          out += `\n  ${color(RGB.ZINC_600, hint)}\n`;
         }
 
-        return { out, totalLines };
+        return { out };
       };
 
       let renderedOnce = false;
@@ -88,8 +92,8 @@ class WizardPrompt {
       const draw = (isFinal = false) => {
         const { out } = render(isFinal);
         if (renderedOnce) {
-          // Clear and rewrite lines
-          process.stdout.write(`\x1b[${options.length + 2}A\r`);
+          // Clear and rewrite lines (options length + 5 lines of headers/footers)
+          process.stdout.write(`\x1b[${options.length + 5}A\r`);
         }
         process.stdout.write(out);
         renderedOnce = true;

package/src/utils/fs.js

@@ -8,6 +8,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 exports.copyDir = copyDir;
 exports.countDir = countDir;
 exports.isSelfInstall = isSelfInstall;
+exports.writeFileSyncAtomic = writeFileSyncAtomic;
 const fs_1 = __importDefault(require('fs'));
 const path_1 = __importDefault(require('path'));
 const logger_1 = require('./logger');
@@ -101,3 +102,29 @@ function isSelfInstall(targetDir, pkgName, kitRoot) {
   }
   return false;
 }
+
+/**
+ * Atomically writes data to a file by writing to a temporary file in the same directory
+ * and renaming it into place. Handles cross-platform and Windows locking cleanly.
+ */
+function writeFileSyncAtomic(filePath, data, encoding = 'utf8') {
+  const dir = path_1.default.dirname(filePath);
+  if (!fs_1.default.existsSync(dir)) fs_1.default.mkdirSync(dir, { recursive: true });
+  const tmpPath = path_1.default.join(
+    dir,
+    `.${path_1.default.basename(filePath)}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2, 6)}.tmp`,
+  );
+  fs_1.default.writeFileSync(tmpPath, data, encoding);
+  try {
+    fs_1.default.renameSync(tmpPath, filePath);
+  } catch (err) {
+    if (process.platform === 'win32' && (err.code === 'EEXIST' || err.code === 'EPERM')) {
+      try {
+        fs_1.default.unlinkSync(filePath);
+      } catch (_) {}
+      fs_1.default.renameSync(tmpPath, filePath);
+    } else {
+      throw err;
+    }
+  }
+}