acuvo-code 0.5.4 → 0.6.0

package/lib/input-box.mjs

@@ -66,7 +66,14 @@ export function visibleWidth(s) {
  *
  * @returns {{lines: string[], cursorColumn: number}} 1-based cursor column
  */
-export function renderBox({ value = '', cursor = 0, columns = 80, prompt = '› ' } = {}) {
+/**
+ * The names offered by the slash menu. Passed in rather than imported so this
+ * module keeps no opinion about what commands exist — `slash.mjs` owns that
+ * list, and a second copy here would drift the first time one is added.
+ */
+export const DEFAULT_COMMANDS = Object.freeze(['help', 'skills', 'mcp', 'cost', 'model', 'clear']);
+
+export function renderBox({ value = '', cursor = 0, columns = 80, prompt = '› ', commands = DEFAULT_COMMANDS } = {}) {
   /**
    * ── ⚠️ FULL WIDTH. THE 100-COLUMN CAP WAS WRONG AND IT LOOKED WRONG ────────
    *
@@ -113,13 +120,48 @@ export function renderBox({ value = '', cursor = 0, columns = 80, prompt = '›
    * ⚠️ Two rows, not three — so the reserved region shrinks with it and the
    * transcript gets a row back.
    */
+  /**
+   * ── ⭐⭐⭐ THE SLASH MENU — WHAT YOU CAN DO, AT THE MOMENT YOU ASK ───────────
+   *
+   * Roman: *"when users do a special Acuvo command it changes the colour and
+   * also shows you your options in a dropdown."*
+   *
+   * ⭐ THIS IS THE DISCOVERABILITY FIX, NOT DECORATION. 28 skills, 7 commands,
+   * MCP in both directions — all built, and nothing on screen ever mentioned
+   * any of it. A capability nobody is shown is worth zero, which is the same
+   * defect as the toolbox and the whiteboard. Typing one character is the
+   * cheapest possible moment to answer "what can this thing do".
+   *
+   * ⚠️ IT REPLACES THE RULE RATHER THAN ADDING A ROW. The input lives in a
+   * reserved region of fixed height; growing it would mean resizing the scroll
+   * region mid-keystroke, and a region that changes size while a transcript is
+   * scrolling through it is how the display gets corrupted. The rule is already
+   * a full-width line doing nothing — so it becomes the menu while a command is
+   * being typed, and goes back to being a rule the moment it is not.
+   */
+  const slash = /^\/(\S*)$/.exec(value);
+  let rule = '─'.repeat(width);
+  if (slash) {
+    const typed = slash[1].toLowerCase();
+    const matches = commands.filter((c) => c.startsWith(typed));
+    /**
+     * ⚠️ NO MATCHES IS ITS OWN ANSWER. Falling back to the full list would tell
+     * somebody who mistyped that everything is fine; saying so is what lets them
+     * fix it.
+     */
+    const shown = matches.length ? matches.map((c) => `/${c}`).join('  ') : 'no command starts with that';
+    const label = `  ${shown}  `;
+    rule = visibleWidth(label) >= width
+      ? label.slice(0, width)
+      : `${label}${'─'.repeat(width - visibleWidth(label))}`;
+  }
+
   return {
-    lines: [
-      '─'.repeat(width),
-      `${body}${pad}`,
-    ],
+    lines: [rule, `${body}${pad}`],
     // 1-based, and there is no left border to skip any more.
     cursorColumn: 1 + promptWidth + (cursor - start),
+    /** True while a slash command is being typed — the caller paints it. */
+    isCommand: Boolean(slash),
   };
 }
 
@@ -238,8 +280,23 @@ export function splitKeys(chunk) {
  * to the end of each border as it is written — which reads as a flicker and is
  * the difference between a rendered box and a drawn one.
  */
-export function paint(output, state, { first = false, atRow = 0 } = {}) {
-  const { lines, cursorColumn } = renderBox(state);
+export function paint(output, state, { first = false, atRow = 0, paintFn = null } = {}) {
+  const r = renderBox(state);
+  const { cursorColumn } = r;
+  /**
+   * ── ⭐ THE INPUT TURNS BRAND GREEN WHILE A COMMAND IS BEING TYPED ──────────
+   *
+   * Roman: *"it changes the colour and also shows you your options."* The colour
+   * is the faster half of that — it says "you are in a different mode" before
+   * anyone has read a single menu entry.
+   *
+   * ⚠️ THE PAINTER IS INJECTED and colour is applied AFTER layout, never before:
+   * escape codes have no width, so colouring a string and then padding it aligns
+   * the text against invisible bytes. `renderBox` stays pure and returns plain
+   * text; this is the only place that knows about colour.
+   */
+  const brand = (paintFn && r.isCommand) ? paintFn : null;
+  const lines = brand ? r.lines.map((l) => brand(l)) : r.lines;
 
   /**
    * ── ⭐⭐⭐ PINNED: DRAW AT AN ABSOLUTE ROW, NOT WHEREVER THE CURSOR IS ───────
@@ -311,7 +368,7 @@ export function paint(output, state, { first = false, atRow = 0 } = {}) {
  *
  * @returns {Promise<{value: string|null, reason: 'submit'|'cancel'|'eof'}>}
  */
-export function readBoxedLine({ input, output, history = [], onInterrupt = null, prompt = '› ', atRow = 0 }) {
+export function readBoxedLine({ input, output, history = [], onInterrupt = null, prompt = '› ', atRow = 0, commands = DEFAULT_COMMANDS, paintFn = null }) {
   return new Promise((resolve) => {
     let state = { value: '', cursor: 0, history, historyIndex: history.length, draft: '' };
     const columns = () => output.columns ?? process.stdout.columns ?? 80;
@@ -346,7 +403,7 @@ export function readBoxedLine({ input, output, history = [], onInterrupt = null,
          * instead of on top of it.
          */
         output.write(`${CSI}${atRow - 1};1H\n${prompt}${value ?? ''}\n`);
-        paint(output, { value: '', cursor: 0, columns: output.columns ?? 80 }, { atRow });
+        paint(output, { value: '', cursor: 0, columns: output.columns ?? 80, commands }, { atRow, paintFn });
         output.write(`${CSI}${atRow - 1};1H`);
       } else {
         /**
@@ -370,7 +427,7 @@ export function readBoxedLine({ input, output, history = [], onInterrupt = null,
         if (next.done === 'submit') {
           state = next;
           // Repaint once so the committed line is what stays on screen.
-          paint(output, { ...state, columns: columns() }, { atRow });
+          paint(output, { ...state, columns: columns(), commands }, { atRow, paintFn });
           return finish(state.value, 'submit');
         }
         if (next.done === 'cancel') {
@@ -392,18 +449,18 @@ export function readBoxedLine({ input, output, history = [], onInterrupt = null,
            */
           state = { ...state, value: '', cursor: 0, historyIndex: history.length, draft: '' };
           onInterrupt?.();
-          paint(output, { ...state, columns: columns() }, { atRow });
+          paint(output, { ...state, columns: columns(), commands }, { atRow, paintFn });
           continue;
         }
         if (next.done === 'eof') return finish(null, 'eof');
         state = next;
-        paint(output, { ...state, columns: columns() }, { atRow });
+        paint(output, { ...state, columns: columns(), commands }, { atRow, paintFn });
       }
     };
 
     try { input.setRawMode?.(true); } catch { /* not a TTY */ }
     input.resume?.();
-    paint(output, { ...state, columns: columns() }, { first: true, atRow });
+    paint(output, { ...state, columns: columns(), commands }, { first: true, atRow, paintFn });
     input.on('data', onData);
     input.once('end', onEnd);
   });

package/package.json

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