acuvo-code 0.4.3 → 0.5.0

package/lib/colour.mjs

@@ -32,6 +32,21 @@ const CODES = {
   green: '\x1b[32m',   // it worked
   red: '\x1b[31m',     // it failed or was refused
   cyan: '\x1b[36m',    // a remote thing: MCP, a service
+  /**
+   * ── ⭐ THE BRAND GREEN, SAMPLED FROM THE MARK ITSELF ───────────────────────
+   *
+   * #C8E91E — the most common opaque pixel in
+   * `console/public/brand/acuvo-mark.png`, read rather than eyeballed, so the
+   * logo in a terminal is the same green as the one on the website.
+   *
+   * ⚠️ TRUECOLOR WITH A 256-COLOUR FALLBACK. `ESC[38;2;R;G;Bm` is exact and
+   * widely supported (Windows Terminal, iTerm2, kitty, modern VS Code) — but a
+   * terminal that does not speak it renders the sequence as LITERAL TEXT across
+   * the logo. Index 190 is the nearest lime in the 256-colour cube and is
+   * understood almost everywhere, so it ships unless truecolor is advertised.
+   */
+  brand: '\x1b[38;5;190m',
+  brandTrue: '\x1b[38;2;200;233;30m',
 };
 
 /**
@@ -66,6 +81,16 @@ export function createPainter(enabled = colourEnabled()) {
     green: wrap(CODES.green),
     red: wrap(CODES.red),
     cyan: wrap(CODES.cyan),
+    /**
+     * ⚠️ TRUECOLOR ONLY WHEN THE TERMINAL SAYS SO. `COLORTERM=truecolor` is the
+     * signal every emitter uses; without it a 24-bit sequence can print as raw
+     * text, which would smear escape codes across the first thing a user sees.
+     */
+    brand: wrap(
+      (process.env.COLORTERM === 'truecolor' || process.env.COLORTERM === '24bit')
+        ? CODES.brandTrue
+        : CODES.brand,
+    ),
   };
 }
 

package/lib/input-box.mjs

@@ -349,3 +349,61 @@ export function readBoxedLine({ input, output, history = [], onInterrupt = null,
     input.once('end', onEnd);
   });
 }
+
+/**
+ * ── ⭐⭐⭐ PINNING THE BOX TO THE BOTTOM OF THE SCREEN ───────────────────────
+ *
+ * Roman: *"we need that prompt box stuck down the bottom, it is professional."*
+ *
+ * A terminal can be told to scroll only PART of itself. `ESC[{top};{bottom}r`
+ * sets the scrolling region; everything printed scrolls inside it, and the rows
+ * below are left alone. Reserve the last three and the box never moves while
+ * output flows past above it.
+ *
+ * ── ⚠️⚠️ THE PART THAT MUST NEVER BE GOT WRONG ──────────────────────────────
+ *
+ * A process that exits WITHOUT releasing the region leaves the user with a
+ * terminal that scrolls inside a box forever, fixable only by typing `reset`
+ * blind. That is the same class of harm as leaving raw mode on, and it must be
+ * released on every path out — normal exit, Ctrl-C, SIGTERM, and an uncaught
+ * throw. `release()` is idempotent and safe to call from all of them.
+ *
+ * ⚠️ AND IT IS OPT-IN. A reserved region is a claim on somebody's whole screen;
+ * off a TTY, in CI, under a pipe or with ACUVO_NO_PIN=1 it is never set.
+ */
+export function pinRegion(output, { rows = 3, env = process.env } = {}) {
+  const height = output?.rows ?? process.stdout?.rows ?? 0;
+  const enabled = Boolean(output?.isTTY)
+    && height > rows + 4
+    && String(env.ACUVO_NO_PIN ?? '') !== '1'
+    && String(env.CI ?? '').toLowerCase() !== 'true';
+
+  if (!enabled) return { enabled: false, release() {}, rows: 0, bottom: 0 };
+
+  const bottom = height - rows;
+  let released = false;
+
+  /**
+   * ⚠️ THE CURSOR IS PARKED INSIDE THE SCROLL REGION BEFORE ANYTHING PRINTS.
+   * Setting a region moves the cursor to home (1,1) on most terminals, so
+   * without this the next line of output lands at the TOP of the screen and the
+   * transcript reads backwards.
+   */
+  output.write(`${CSI}1;${bottom}r${CSI}${bottom};1H`);
+
+  const release = () => {
+    if (released) return;
+    released = true;
+    /**
+     * ⚠️ `ESC[r` WITH NO ARGUMENTS RESETS TO THE FULL SCREEN. Then the cursor is
+     * moved below the reserved rows so the shell prompt does not land on top of
+     * our box — an exit that leaves the terminal technically correct and
+     * visually broken is still a bad exit.
+     */
+    try {
+      output.write(`${CSI}r${CSI}${height};1H\n`);
+    } catch { /* the stream may already be gone on a hard exit */ }
+  };
+
+  return { enabled: true, release, rows, bottom };
+}

package/package.json

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