@tiens.nguyen/gonext-local-worker 1.0.209 → 1.0.211

package/gonext-repl.mjs

@@ -175,13 +175,26 @@ function slashCompleter(line) {
   const hits = COMMAND_NAMES.filter((n) => n.startsWith(line));
   return [hits.length ? hits : COMMAND_NAMES, line];
 }
-function printCommands() {
-  console.log(dim("  commands (type / then Tab to complete):"));
-  for (const c of COMMANDS) {
+function commandRows(prefix = "") {
+  const p = (prefix ?? "").trim();
+  const show = COMMANDS.filter(
+    (c) =>
+      !p ||
+      p === "/" ||
+      [c.name, ...(c.aliases ?? [])].some((n) => n.startsWith(p))
+  );
+  const list = show.length ? show : COMMANDS;
+  const rows = [dim("  commands (Tab completes):")];
+  for (const c of list) {
     const label = c.usage ?? c.name;
     const alias = c.aliases?.length ? dim(` (${c.aliases.join(", ")})`) : "";
-    console.log(`   ${cyan(label)}${alias}${dim(" — " + c.desc)}`);
+    rows.push(`   ${cyan(label)}${alias}${dim(" — " + c.desc)}`);
   }
+  return rows;
+}
+// Permanent print (used by /help and a lone-"/" submit — scrolls with history).
+function printCommands(prefix = "") {
+  for (const r of commandRows(prefix)) console.log(r);
   console.log("");
 }
 
@@ -214,6 +227,7 @@ 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)
 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
@@ -223,6 +237,12 @@ rl.on("line", (l) => {
     rl.cursor = 0;
     return;
   }
+  // 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 (slashHintRows > 0) {
+    process.stdout.write("\x1b[J");
+    slashHintRows = 0;
+  }
   const clean = stripAnsiEscapes(l);
   if (_lineWaiter) {
     const w = _lineWaiter;
@@ -236,13 +256,38 @@ 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).
+// Live command hint = an EPHEMERAL overlay drawn BELOW the prompt while the line starts
+// with "/", so it redraws as you type (narrowing) and DISAPPEARS when you clear the slash
+// (instead of stacking permanent copies in scrollback). Rendered with relative cursor
+// moves (down to draw, back up to the input line) so it survives terminal scrolling.
+const inputCol = () => 4 + rl.cursor; // ">> " is 3 cols; content starts at col 4 (1-based)
+function clearSlashHint() {
+  if (slashHintRows === 0) return;
+  // Cursor is on the input line. Drop into the hint region, erase to end of screen, return.
+  process.stdout.write("\n\x1b[J" + `\x1b[1A\x1b[${inputCol()}G`);
+  slashHintRows = 0;
+}
+function drawSlashHint(line) {
+  const rows = commandRows(line);
+  // Repaint in place: erase the old block, draw the new one, move the cursor back up.
+  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 the input line + column
+  process.stdout.write(out);
+  slashHintRows = rows.length;
+}
 if (process.stdin.isTTY) {
   process.stdin.on("keypress", () => {
     if (following) {
       rl.line = "";
       rl.cursor = 0;
       rl.historyIndex = -1;
+      return;
     }
+    if (rl.line.startsWith("/")) drawSlashHint(rl.line);
+    else clearSlashHint();
   });
 }
 rl.on("close", () => {
@@ -947,7 +992,7 @@ async function main() {
     console.error(red(`gonext: ${err.message}`));
     process.exit(1);
   }
-  console.log(dim("Ask about this repo. Type / (or /help) to list commands — Tab completes. Ctrl-C aborts a running turn.\n"));
+  console.log(dim("Ask about this repo. Type / to see commands (Tab completes). Ctrl-C aborts a running turn.\n"));
 
   const cwd = resolve(process.cwd());
   const history = await loadSession(cwd);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiens.nguyen/gonext-local-worker",
-  "version": "1.0.209",
+  "version": "1.0.211",
   "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",