@tiens.nguyen/gonext-local-worker 1.0.210 → 1.0.212

package/gonext-repl.mjs

@@ -175,20 +175,31 @@ function slashCompleter(line) {
   const hits = COMMAND_NAMES.filter((n) => n.startsWith(line));
   return [hits.length ? hits : COMMAND_NAMES, line];
 }
-function printCommands(prefix = "") {
+// Commands whose name/alias matches the typed prefix (all when prefix is "" or "/").
+function filteredCommands(prefix = "") {
   const p = (prefix ?? "").trim();
-  const show = COMMANDS.filter(
+  const m = COMMANDS.filter(
     (c) =>
       !p ||
       p === "/" ||
       [c.name, ...(c.aliases ?? [])].some((n) => n.startsWith(p))
   );
-  console.log(dim("  commands (Tab completes):"));
-  for (const c of show.length ? show : COMMANDS) {
+  return m.length ? m : COMMANDS;
+}
+// Display rows for a filtered command set; row `sel` (if >=0) is highlighted (❯ + bold).
+function hintRows(cmds, sel) {
+  const rows = [dim("  commands  (↑/↓ select · Enter run · Tab complete):")];
+  cmds.forEach((c, i) => {
     const label = c.usage ?? c.name;
     const alias = c.aliases?.length ? dim(` (${c.aliases.join(", ")})`) : "";
-    console.log(`   ${cyan(label)}${alias}${dim(" — " + c.desc)}`);
-  }
+    const body = `${cyan(label)}${alias}${dim(" — " + c.desc)}`;
+    rows.push(i === sel ? `${green("❯")} ${bold(body)}` : `  ${body}`);
+  });
+  return rows;
+}
+// Permanent print (used by /help and a lone-"/" submit — scrolls with history).
+function printCommands(prefix = "") {
+  for (const r of hintRows(filteredCommands(prefix), -1)) console.log(r);
   console.log("");
 }
 
@@ -221,6 +232,10 @@ const isNetworkError = (e) =>
 const _lineQueue = [];
 let _lineWaiter = null;
 let _stdinClosed = false;
+let slashHintRows = 0; // live slash-command hint rows drawn below the prompt (0 = none)
+let slashSel = -1; // highlighted row in the current filtered list (-1 = none)
+let slashNames = []; // command names in the current filtered list (for Enter → run)
+let slashPrefix = ""; // the "/…" text the user typed (restored when ↑/↓ recall history)
 rl.on("line", (l) => {
   // While a turn is running, IGNORE typed input entirely — no type-ahead, no queued
   // next question. Only Ctrl+C (handled via SIGINT) does anything mid-turn. Clear the
@@ -230,7 +245,18 @@ rl.on("line", (l) => {
     rl.cursor = 0;
     return;
   }
-  const clean = stripAnsiEscapes(l);
+  // Enter left the cursor on the row where the live slash-hint started — erase it so the
+  // command's own output doesn't print over/under a stale hint block. If a menu item was
+  // highlighted (↑/↓), RUN that command instead of the raw typed line.
+  let submitted = l;
+  if (slashHintRows > 0) {
+    if (slashSel >= 0 && slashNames[slashSel]) submitted = slashNames[slashSel];
+    process.stdout.write("\x1b[J");
+    slashHintRows = 0;
+    slashSel = -1;
+    slashNames = [];
+  }
+  const clean = stripAnsiEscapes(submitted);
   if (_lineWaiter) {
     const w = _lineWaiter;
     _lineWaiter = null;
@@ -243,27 +269,63 @@ rl.on("line", (l) => {
 // turn: echo is already muted, but readline still recalls history into the invisible
 // buffer on ↑/↓ — reset the line state after every keypress so nothing accumulates or
 // moves. Ctrl+C is unaffected (readline emits its SIGINT before this handler runs).
-let slashHintShown = false; // the live command hint is currently displayed for a "/…" line
+// Live command hint = an EPHEMERAL, SELECTABLE overlay drawn BELOW the prompt while the
+// line starts with "/". It redraws as you type (narrowing), ↑/↓ move a highlight, Enter
+// runs the highlighted command, and it DISAPPEARS when you clear the slash — no permanent
+// scrollback copies. Relative cursor moves so it survives terminal scrolling.
+// (slashSel / slashNames / slashPrefix are declared above, near rl.on("line").)
+const inputCol = () => 4 + rl.cursor; // ">> " is 3 cols; content starts at col 4 (1-based)
+function clearSlashHint() {
+  if (slashHintRows === 0) return;
+  process.stdout.write("\n\x1b[J" + `\x1b[1A\x1b[${inputCol()}G`);
+  slashHintRows = 0;
+  slashSel = -1;
+  slashNames = [];
+}
+function drawSlashHint(prefix, sel) {
+  const cmds = filteredCommands(prefix);
+  slashNames = cmds.map((c) => c.name);
+  if (sel >= cmds.length) sel = cmds.length - 1;
+  slashSel = sel;
+  const rows = hintRows(cmds, sel);
+  const body = rows.map((r) => "\x1b[K" + r).join("\n");
+  let out = "";
+  if (slashHintRows > 0) out += "\n\x1b[J\x1b[1A"; // wipe previous block, back to input row
+  out += "\n" + body; // draw below the input line
+  out += `\x1b[${rows.length}A\x1b[${inputCol()}G`; // back up to input line + column
+  process.stdout.write(out);
+  slashHintRows = rows.length;
+}
 if (process.stdin.isTTY) {
-  process.stdin.on("keypress", () => {
+  process.stdin.on("keypress", (_ch, key) => {
     if (following) {
       rl.line = "";
       rl.cursor = 0;
       rl.historyIndex = -1;
       return;
     }
-    // Live command hint: the moment the line starts with "/", pop the command list ABOVE
-    // the prompt (once) so the user sees /model etc. without typing the whole thing or
-    // pressing Tab. Shown once per "/…" run; cleared/reset when the line stops being a
-    // slash command (so a fresh "/" shows it again).
-    const l = rl.line;
-    if (l.startsWith("/") && !slashHintShown) {
-      slashHintShown = true;
-      process.stdout.write("\r\x1b[K"); // wipe the ">> /" input row
-      printCommands(l); // list where the prompt was + below
-      rl._refreshLine(); // redraw ">> /" (with cursor) beneath the list
-    } else if (!l.startsWith("/")) {
-      slashHintShown = false;
+    // Enter is handled by rl.on("line") — don't redraw the hint on the way out.
+    if (key && (key.name === "return" || key.name === "enter")) return;
+    // ↑/↓ while the menu is up = move the highlight, NOT recall shell history. readline
+    // already ran history-nav (may have changed the line); restore the typed "/…" prefix
+    // and redraw with the new selection.
+    if (slashHintRows > 0 && key && (key.name === "up" || key.name === "down")) {
+      rl.line = slashPrefix;
+      rl.cursor = slashPrefix.length;
+      const n = slashNames.length;
+      if (n > 0) {
+        slashSel =
+          key.name === "down" ? (slashSel + 1 + n) % n : (slashSel - 1 + n) % n;
+      }
+      rl._refreshLine();
+      drawSlashHint(slashPrefix, slashSel);
+      return;
+    }
+    if (rl.line.startsWith("/")) {
+      slashPrefix = rl.line;
+      drawSlashHint(rl.line, -1); // typing resets the selection to none
+    } else {
+      clearSlashHint();
     }
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiens.nguyen/gonext-local-worker",
-  "version": "1.0.210",
+  "version": "1.0.212",
   "description": "Polls GoNext cloud API for async local LLM jobs and runs them against Ollama/OpenAI-compatible servers on this Mac",
   "type": "module",
   "license": "MIT",