acuvo-code 0.4.3 → 0.5.0

package/ENTERPRISE.md

@@ -189,7 +189,7 @@ are the numbers to quote. Counting is the first thing a reviewer does.
 
 ⚠️ **This said "18 shipped files", then "41", then "90", then "101", then "108", and every
 one went stale in turn.** The package ships **120 files — 118 in `lib/`, 2 in
-`bin/` — about 78091 lines**, with **237 test files** beside them (counted 2026-08-22).
+`bin/` — about 78245 lines**, with **237 test files** beside them (counted 2026-08-22).
 
 ⭐ **AND THE 108 WENT STALE IN THE MOST INSTRUCTIVE WAY POSSIBLE: THREE OF THE FILES IT
 MISSED WERE REACHABLE FROM NOTHING.** `wiring-reach.test.mjs` was naming

package/bin/acuvo.mjs

@@ -1511,6 +1511,13 @@ ${formatBoard(listed)}
     billing,
     canRun: mode,
     interactive: false,
+    /**
+     * ⚠️ THE PAINTER IS BUILT HERE, WHERE THE STREAM IS KNOWN. `colourEnabled`
+     * owns NO_COLOR, FORCE_COLOR, TERM=dumb and TTY detection — so a redirected
+     * run gets a plain banner and nobody has to remember an `if` at the call
+     * site.
+     */
+    paint: createPainter(colourEnabled()),
   });
   if (opts.json) process.stderr.write(banner);
   else process.stdout.write(banner);

package/lib/banner.mjs

@@ -1,125 +1,155 @@
-/**
- * ── ⭐⭐⭐ WHAT YOU SEE WHEN YOU TYPE `acuvo` ────────────────────────────────
- *
- * Roman, 2026-08-22, having typed it: *"it's not opening as a typable terminal,
- * with acuvo logo top left and details up top etc, like how claude code opens.
- * have you actually designed the page?"* — and then: *"no we want OUR logo"*.
- *
- * So this is the real mark, not letters spelling the name. It is
- * `console/public/brand/acuvo-mark.png` — the angular A — resampled to
- * half-blocks at 14x14 and embedded as text.
- *
- * ── ⚠️ WHY IT IS EMBEDDED RATHER THAN DECODED AT RUNTIME ────────────────────
- *
- * This package has ZERO dependencies, deliberately, and Node cannot decode a
- * PNG without one. Converting at build time and pasting the result keeps that
- * promise and costs nothing at startup. If the mark ever changes, re-run the
- * conversion — the logo is DERIVED from the brand asset, not drawn by hand, so
- * it stays honest to it.
- *
- * ── ⚠️ THE CONSTRAINTS, WHICH ARE NOT PREFERENCES ───────────────────────────
- *
- * · **Half-block glyphs only** (▀ ▄ █). Braille and box-drawing render as tofu
- *   in cmd.exe and in many CI log viewers, and a logo that renders as question
- *   marks is worse than no logo — on the exact platform this is developed on.
- * · **No colour escapes here.** The caller owns colour and honours NO_COLOR; a
- *   module that hard-codes them emits garbage the moment output is piped.
- * · **Every line under 80 columns.** The narrowest terminal in real use is 80,
- *   and a wrapped banner does not read as dense, it reads as broken.
- *
- * ⭐ A NOTE ON DOING BETTER: `lib/terminal-graphics.mjs` can send a real PNG
- * inline on Kitty and iTerm2. It is deliberately NOT used here — Windows
- * Terminal speaks neither protocol, so the block art is what most users would
- * see anyway, and one rendering that is the same everywhere beats two that
- * disagree.
- */
-
-/**
- * The Acuvo mark, resampled from the brand PNG. Seven rows: tall enough to be
- * the mark rather than a smudge, short enough for something run forty times a
- * day rather than opened once.
- */
-const MARK = [
-  '      ▄█',
-  '     ▄███',
-  '    ▄█▀▀██',
-  '   ▄█▀  ▀██',
-  '  ▄█▀ ██ ▀██',
-  ' ▄████▀▀█████',
-  '█▀      █▀  ▀█',
-];
-
-const MARK_WIDTH = Math.max(...MARK.map((l) => l.length));
-const GUTTER = 2;
-export const MAX_BANNER_COLUMNS = 80;
-
-/** Columns left for the detail rows once the mark and gutter are placed. */
-const TEXT_COLUMNS = MAX_BANNER_COLUMNS - MARK_WIDTH - GUTTER;
-
-/**
- * Build the opening screen: mark on the left, facts on the right.
- *
- * @param {object} o
- * @param {string} o.version
- * @param {string} o.workspace   already shortened by the caller
- * @param {string} o.model
- * @param {string} o.billing     who this run will charge
- * @param {string} o.canRun      what it may execute, or that it may not
- * @param {boolean} [o.interactive] whether a prompt follows
- * @returns {string}
- */
-export function openingScreen({ version, workspace, model, billing, canRun, interactive = false }) {
-  /**
-   * ── ⚠️⚠️ ELIDED, BECAUSE THE VALUES ARE NOT OURS ────────────────────────────
-   *
-   * Every value arrives at runtime: a deep monorepo path, a long model id, the
-   * shell-mode warning. The first version assumed they would be short and its
-   * own test caught it wrapping at 80 columns on ordinary inputs.
-   *
-   * ⭐ ELIDED IN THE MIDDLE, NOT THE END. The informative parts of a path are
-   * the drive and the leaf; chopping the tail leaves
-   * `C:\Users\somebody\Projects\a-`, which identifies nothing. Same for a model
-   * id, where the family is at the front and the variant at the back.
-   */
-  const room = TEXT_COLUMNS - 11;
-  const fit = (v) => {
-    const s = String(v ?? '');
-    if (s.length <= room) return s;
-    const head = Math.ceil((room - 1) / 2);
-    return `${s.slice(0, head)}…${s.slice(s.length - (room - 1 - head))}`;
-  };
-
-  const right = [
-    `ACUVO CODE${version ? `  ${version}` : ''}`,
-    '',
-    `workspace  ${fit(workspace)}`,
-    `model      ${fit(model)}`,
-    `billing    ${fit(billing)}`,
-    `can run    ${fit(canRun)}`,
-    '',
-  ];
-
-  /**
-   * ⚠️ THE TWO COLUMNS ARE ZIPPED, NOT CONCATENATED, and the row counts are
-   * allowed to differ — whichever is shorter simply runs out. Assuming they
-   * match would break the layout the first time a row is added to either side.
-   */
-  const rows = Math.max(MARK.length, right.length);
-  const lines = [''];
-  for (let i = 0; i < rows; i += 1) {
-    const mark = (MARK[i] ?? '').padEnd(MARK_WIDTH + GUTTER);
-    const text = right[i] ?? '';
-    lines.push(`${mark}${text}`.trimEnd());
-  }
-  lines.push('');
-
-  /**
-   * ⚠️ ONLY WHEN A PROMPT ACTUALLY FOLLOWS. Printing "type what you want done"
-   * above a one-shot run that has already been given its task is an instruction
-   * for something the user cannot do, on the screen of a thing already working.
-   */
-  if (interactive) {
-    lines.push('  Type what you want done.   /help for commands  ·  exit to leave', '');
-  }
-  return lines.join('\n');
-}
+/**
+ * ── ⭐⭐⭐ WHAT YOU SEE WHEN YOU TYPE `acuvo` ────────────────────────────────
+ *
+ * Roman, 2026-08-22, having typed it: *"it's not opening as a typable terminal,
+ * with acuvo logo top left and details up top etc, like how claude code opens.
+ * have you actually designed the page?"* — and then: *"no we want OUR logo"*.
+ *
+ * So this is the real mark, not letters spelling the name. It is
+ * `console/public/brand/acuvo-mark.png` — the angular A — resampled to
+ * half-blocks at 14x14 and embedded as text.
+ *
+ * ── ⚠️ WHY IT IS EMBEDDED RATHER THAN DECODED AT RUNTIME ────────────────────
+ *
+ * This package has ZERO dependencies, deliberately, and Node cannot decode a
+ * PNG without one. Converting at build time and pasting the result keeps that
+ * promise and costs nothing at startup. If the mark ever changes, re-run the
+ * conversion — the logo is DERIVED from the brand asset, not drawn by hand, so
+ * it stays honest to it.
+ *
+ * ── ⚠️ THE CONSTRAINTS, WHICH ARE NOT PREFERENCES ───────────────────────────
+ *
+ * · **Half-block glyphs only** (▀ ▄ █). Braille and box-drawing render as tofu
+ *   in cmd.exe and in many CI log viewers, and a logo that renders as question
+ *   marks is worse than no logo — on the exact platform this is developed on.
+ * · **No colour escapes here.** The caller owns colour and honours NO_COLOR; a
+ *   module that hard-codes them emits garbage the moment output is piped.
+ * · **Every line under 80 columns.** The narrowest terminal in real use is 80,
+ *   and a wrapped banner does not read as dense, it reads as broken.
+ *
+ * ⭐ A NOTE ON DOING BETTER: `lib/terminal-graphics.mjs` can send a real PNG
+ * inline on Kitty and iTerm2. It is deliberately NOT used here — Windows
+ * Terminal speaks neither protocol, so the block art is what most users would
+ * see anyway, and one rendering that is the same everywhere beats two that
+ * disagree.
+ */
+
+/**
+ * The Acuvo mark, resampled from the brand PNG. Seven rows: tall enough to be
+ * the mark rather than a smudge, short enough for something run forty times a
+ * day rather than opened once.
+ */
+const MARK = [
+  '      ▄█',
+  '     ▄███',
+  '    ▄█▀▀██',
+  '   ▄█▀  ▀██',
+  '  ▄█▀ ██ ▀██',
+  ' ▄████▀▀█████',
+  '█▀      █▀  ▀█',
+];
+
+const MARK_WIDTH = Math.max(...MARK.map((l) => l.length));
+const GUTTER = 2;
+export const MAX_BANNER_COLUMNS = 80;
+
+/** Columns left for the detail rows once the mark and gutter are placed. */
+const TEXT_COLUMNS = MAX_BANNER_COLUMNS - MARK_WIDTH - GUTTER;
+
+/**
+ * Build the opening screen: mark on the left, facts on the right.
+ *
+ * @param {object} o
+ * @param {string} o.version
+ * @param {string} o.workspace   already shortened by the caller
+ * @param {string} o.model
+ * @param {string} o.billing     who this run will charge
+ * @param {string} o.canRun      what it may execute, or that it may not
+ * @param {boolean} [o.interactive] whether a prompt follows
+ * @returns {string}
+ */
+export function openingScreen({ version, workspace, model, billing, canRun, interactive = false, paint = null }) {
+  /**
+   * ── ⭐ THE MARK IS BRAND GREEN, AND ONLY THE MARK ────────────────────────────
+   *
+   * Roman: *"can you colour our logo green in the terminal?"* #C8E91E, sampled
+   * from the brand PNG rather than picked by eye.
+   *
+   * ⚠️ THE PAINTER IS INJECTED, NOT IMPORTED. The caller already decided whether
+   * this stream can take colour — it owns NO_COLOR, FORCE_COLOR, TERM=dumb and
+   * TTY detection. A module that reaches for colour itself will eventually
+   * disagree with that decision and write escapes into somebody's redirected
+   * file.
+   *
+   * ⚠️ AND ONLY THE LOGO. Colouring the detail rows would make the one line that
+   * must be read as a warning — `billing: YOUR OWN OpenRouter key` — compete
+   * with decoration.
+   */
+  const brand = paint?.brand ?? ((s) => s);
+  /**
+   * ── ⚠️⚠️ ELIDED, BECAUSE THE VALUES ARE NOT OURS ────────────────────────────
+   *
+   * Every value arrives at runtime: a deep monorepo path, a long model id, the
+   * shell-mode warning. The first version assumed they would be short and its
+   * own test caught it wrapping at 80 columns on ordinary inputs.
+   *
+   * ⭐ ELIDED IN THE MIDDLE, NOT THE END. The informative parts of a path are
+   * the drive and the leaf; chopping the tail leaves
+   * `C:\Users\somebody\Projects\a-`, which identifies nothing. Same for a model
+   * id, where the family is at the front and the variant at the back.
+   */
+  const room = TEXT_COLUMNS - 11;
+  const fit = (v) => {
+    const s = String(v ?? '');
+    if (s.length <= room) return s;
+    const head = Math.ceil((room - 1) / 2);
+    return `${s.slice(0, head)}…${s.slice(s.length - (room - 1 - head))}`;
+  };
+
+  const right = [
+    `ACUVO CODE${version ? `  ${version}` : ''}`,
+    '',
+    `workspace  ${fit(workspace)}`,
+    `model      ${fit(model)}`,
+    `billing    ${fit(billing)}`,
+    `can run    ${fit(canRun)}`,
+    '',
+  ];
+
+  /**
+   * ⚠️ THE TWO COLUMNS ARE ZIPPED, NOT CONCATENATED, and the row counts are
+   * allowed to differ — whichever is shorter simply runs out. Assuming they
+   * match would break the layout the first time a row is added to either side.
+   */
+  const rows = Math.max(MARK.length, right.length);
+  const lines = [''];
+  for (let i = 0; i < rows; i += 1) {
+    const text = right[i] ?? '';
+    /**
+     * ⚠️ PADDED FIRST, PAINTED SECOND — escape codes have no width, so padding a
+     * coloured string aligns the text against invisible bytes and the whole
+     * right-hand column drifts.
+     *
+     * ⚠️⚠️ AND PADDED ONLY WHEN SOMETHING FOLLOWS. On a mark-only row the
+     * padding sits INSIDE the colour, before the reset, where the `trimEnd`
+     * below cannot reach it — so the coloured banner carried trailing
+     * whitespace the plain one did not. Invisible, but it means colour changed
+     * the layout, which is exactly what the guard forbids.
+     */
+    const rawMark = MARK[i] ?? '';
+    const padded = text ? rawMark.padEnd(MARK_WIDTH + GUTTER) : rawMark;
+    const mark = MARK[i] ? brand(padded) : padded;
+    lines.push(`${mark}${text}`.trimEnd());
+  }
+  lines.push('');
+
+  /**
+   * ⚠️ ONLY WHEN A PROMPT ACTUALLY FOLLOWS. Printing "type what you want done"
+   * above a one-shot run that has already been given its task is an instruction
+   * for something the user cannot do, on the screen of a thing already working.
+   */
+  if (interactive) {
+    lines.push('  Type what you want done.   /help for commands  ·  exit to leave', '');
+  }
+  return lines.join('\n');
+}