acuvo-code 0.3.2 → 0.3.4

package/ENTERPRISE.md

@@ -188,8 +188,8 @@ copy, but it *is* a place a process starts, and this is a list of those. Six and
 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 **118 files — 116 in `lib/`, 2 in
-`bin/` — about 77,339 lines**, with **233 test files** beside them (counted 2026-08-22).
+one went stale in turn.** The package ships **119 files — 117 in `lib/`, 2 in
+`bin/` — about 77552 lines**, with **234 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

@@ -1482,17 +1482,21 @@ ${formatBoard(listed)}
     }
   })();
 
-  const row = (k, v) => `  ${k.padEnd(11)}${v}`;
-  const banner = [
-    '',
-    `  ▌ACUVO CODE${pkgVersion ? `  ${pkgVersion}` : ''}`,
-    '',
-    row('workspace', shortenRoot(executor.root)),
-    row('model', config.model),
-    row('billing', billing),
-    row('can run', mode),
-    '',
-  ].join('\n');
+  /**
+   * ⚠️ `interactive: false` EVEN IN THE REPL, because `runChat` prints its own
+   * "Type what you want done" line. Setting it here as well produced the
+   * instruction twice, three lines apart — the banner owns the identity, the
+   * chat loop owns the invitation, and neither should own both.
+   */
+  const { openingScreen } = await import('../lib/banner.mjs');
+  const banner = openingScreen({
+    version: pkgVersion,
+    workspace: shortenRoot(executor.root),
+    model: config.model,
+    billing,
+    canRun: mode,
+    interactive: false,
+  });
   if (opts.json) process.stderr.write(banner);
   else process.stdout.write(banner);
 

package/lib/banner.mjs

@@ -0,0 +1,125 @@
+/**
+ * ── ⭐⭐⭐ 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');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acuvo-code",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Acuvo Code — the terminal client for the Acuvo capability registry. Zero dependencies, by design.",
   "type": "module",
   "bin": {