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

package/gonext-repl.mjs

@@ -159,8 +159,46 @@ if (!workerKey || !apiBase) {
 // editing didn't work at all (user-reported). Giving readline the prompt makes its
 // redraw math correct — rl.prompt() resets the cursor state after every burst of our
 // output — and raw mode means backspace/arrows/↑-history all behave like a normal shell.
+// Single source of truth for the REPL's slash commands — drives Tab-completion, the
+// unknown-command guard, and /help, so they can never drift.
+const COMMANDS = [
+  { name: "/model", desc: "switch the coding model for this session" },
+  { name: "/revert", usage: "/revert [runId]", desc: "undo the agent's file edits (latest run)" },
+  { name: "/reset", aliases: ["/new"], desc: "forget this folder's saved conversation and start fresh" },
+  { name: "/help", desc: "list these commands" },
+  { name: "/exit", aliases: ["/quit"], desc: "quit" },
+];
+const COMMAND_NAMES = COMMANDS.flatMap((c) => [c.name, ...(c.aliases ?? [])]);
+// Tab-completion: when the line starts with "/", complete against the command names.
+function slashCompleter(line) {
+  if (!line.startsWith("/")) return [[], line];
+  const hits = COMMAND_NAMES.filter((n) => n.startsWith(line));
+  return [hits.length ? hits : COMMAND_NAMES, line];
+}
+function printCommands(prefix = "") {
+  const p = (prefix ?? "").trim();
+  const show = 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) {
+    const label = c.usage ?? c.name;
+    const alias = c.aliases?.length ? dim(` (${c.aliases.join(", ")})`) : "";
+    console.log(`   ${cyan(label)}${alias}${dim(" — " + c.desc)}`);
+  }
+  console.log("");
+}
+
 const IS_TTY = Boolean(process.stdin.isTTY && process.stdout.isTTY);
-const rl = createInterface({ input: process.stdin, output: process.stdout, terminal: IS_TTY });
+const rl = createInterface({
+  input: process.stdin,
+  output: process.stdout,
+  terminal: IS_TTY,
+  completer: slashCompleter,
+});
 const PROMPT = cyan(">> ");
 rl.setPrompt(PROMPT);
 // Side effect of terminal:false above: readline no longer intercepts arrow keys for
@@ -205,12 +243,27 @@ 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
 if (process.stdin.isTTY) {
   process.stdin.on("keypress", () => {
     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;
     }
   });
 }
@@ -916,7 +969,7 @@ async function main() {
     console.error(red(`gonext: ${err.message}`));
     process.exit(1);
   }
-  console.log(dim("Ask about this repo, or /help. 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);
@@ -979,14 +1032,8 @@ async function main() {
     if (lineRaw === null) break; // stdin closed
     const line = lineRaw.trim();
     if (line === "/exit" || line === "/quit") break;
-    if (line === "/help") {
-      console.log(
-        dim(
-          "  /exit — quit · /model — switch the coding model for this session · " +
-            "/revert [runId] — undo the agent's file edits (latest run) · " +
-            "/reset — forget this folder's saved conversation and start fresh"
-        )
-      );
+    if (line === "/" || line === "/help") {
+      printCommands();
       continue;
     }
     if (line === "/model") {
@@ -1012,6 +1059,13 @@ async function main() {
       });
       continue;
     }
+    // Any OTHER "/…" is a typo/unknown command — don't send it to the agent as a
+    // question; point the user at /help (all real commands were handled above).
+    if (line.startsWith("/")) {
+      const cmd = line.split(/\s+/)[0];
+      console.log(dim(`unknown command: ${cmd} — type /help (or / then Tab) to list commands\n`));
+      continue;
+    }
     history.push({ role: "user", content: line });
     try {
       const { text: answer, shown, cancelled } = await runAgentTurn(history);

package/package.json

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