@tiens.nguyen/gu-cli 1.0.863 → 1.0.864

package/gu-repl.mjs

@@ -105,6 +105,8 @@ import {
   physicalRows,
   inputPhysicalRows,
   buildFooterRows,
+  buildFooter,
+  SUPPORT_LINK_TEXT,
   pasteHint,
   hintRows as questionHintRows,
   footerDrawSeq,
@@ -707,6 +709,33 @@ let openPresetsAtStart = false;
 // #132 follow-up: a hosted provider picked in first-run setup; its key and model are asked once the terminal exists.
 let addProviderAtStart = null;
 
+// #220: a gu that STOPS ON AN ERROR says where help is — a start that failed (exit 1 before the
+// prompt: no key, API unreachable, MongoDB down…) or a crash. One dim line, never during a session
+// that started fine, where /support is in the command list.
+let supportHintAtExit = true;
+const SUPPORT_HINT = "Need help? Run `gu support` — it sends the support team gu's logs (secrets masked).";
+process.on("exit", (code) => {
+  if (code !== 1 || !supportHintAtExit) return;
+  try {
+    process.stderr.write("\n" + dim(SUPPORT_HINT) + "\n");
+  } catch {
+    /* stderr gone: nothing to tell */
+  }
+});
+function crashed(e) {
+  try {
+    releaseScreenAtExit();
+  } catch {
+    /* the screen may not be ours yet */
+  }
+  console.error(e?.stack || String(e));
+  supportHintAtExit = true;
+  process.exit(1);
+}
+process.on("uncaughtException", crashed);
+process.on("unhandledRejection", crashed);
+
+
 if (!workerKey || !apiBase) {
   if (process.stdin.isTTY && process.stdout.isTTY) {
     try {
@@ -977,6 +1006,7 @@ const COMMANDS = [
   { name: "/shells", desc: "long commands the agent left running in the background — status, runtime, command, output; stop one" },
   { name: "/budget", desc: "short view of your API provider budgets and balances (Pro) — the same items as the web /providers page" },
   { name: "/tokens", desc: "break down the last prompt sent to the coding model — how much of it was RAG" },
+  { name: "/support", desc: "send the gu support team a request with gu's logs attached (secrets masked) — shows what goes first, then asks" },
   { name: "/clear-logs", desc: "show what gu's logs, RAG indexes and old API versions take on disk, then ask what to clear — the logs first" },
   { name: "/prices", usage: "/prices [update]", desc: "the price table and the cache table, and what the last turn and this session cost — \"update\" applies gu's newest published tables" },
   // ONE name, /new (user, #278). /reset and /clear still work (HIDDEN_COMMANDS) for habit and
@@ -1573,6 +1603,12 @@ function applyClick({ row, col }) {
     void runClearLogs();
     return;
   }
+  // The footer's "? support" link (#220): the footer is the last rows of the screen, so count from the bottom.
+  if (supportLinkTarget && !zonePanel && row === viewportRows() - supportLinkTarget.fromEnd + 1 &&
+      col - 1 >= supportLinkTarget.from && col - 1 < supportLinkTarget.to) {
+    void runSupport();
+    return;
+  }
   if (agentsRowTarget && row === updateRowAbs &&
       col - 1 >= agentsRowTarget.from && col - 1 < agentsRowTarget.to) {
     void showOtherAgents(); // async now — it offers stop / switch-to (task #211)
@@ -2868,8 +2904,12 @@ const compactLockNote = () =>
         at: lastPromptBreakdown?.compactedAt,
       })
     : "";
-const footerRows = () =>
-  buildFooterRows({
+// #220: where the footer's "? support" link is on screen (set by frozenZone, read by applyClick).
+let supportLinkTarget = null;
+const footerBuilt = () =>
+  buildFooter({
+    link: SUPPORT_LINK_TEXT,
+    linkPaint: (t) => dim("\x1b[4m" + t + "\x1b[24m"),
     width: process.stdout.columns || 80,
     gutter: GUTTER,
     rag: REPL_VERBOSE && (lastRagFile || lastRagState) ? ragLineText() : "",
@@ -2895,6 +2935,7 @@ const footerRows = () =>
     // where the red rows above mean something is not set up at all.
     missing: [...missingNoticeRows().map((r) => red(r)), ...fallbackNoticeRows().map((r) => yellow(r))],
   });
+const footerRows = () => footerBuilt().rows;
 // An ask()'s hint lines (#305), drawn in yellow under its input while it waits. Plain text.
 let askHint = [];
 const askHintRows = (width) => questionHintRows(askHint, { width, gutter: GUTTER, paint: yellow });
@@ -3008,9 +3049,11 @@ function zoneNotice(width) {
     const up = updateRow({ ...availableUpdates, width: 400 });
     if (up) items.push({ key: "update", clickable: true, paint: accent, text: up.text.slice(up.from) });
   }
-  if (priceUpdate) items.push({ key: "prices", clickable: true, paint: accent, text: `${priceUpdateText()} (click)` });
-  if (limitsUpdate) items.push({ key: "limits", clickable: true, paint: accent, text: `${limitsUpdate.label} (click)` });
-  if (tokenNotice?.text && !(tokenQuestionOpen && tokenNotice.kind === "over-limit")) items.push({ key: "token", paint: tokenNotice.urgent ? yellow : dim, text: tokenNotice.text });
+  // While the token question is open it is the ONLY thing on the screen (#222): the housekeeping
+  // notices (new prices, new token limits) wait, and the token notice would repeat the question.
+  if (priceUpdate && !tokenQuestionOpen) items.push({ key: "prices", clickable: true, paint: accent, text: `${priceUpdateText()} (click)` });
+  if (limitsUpdate && !tokenQuestionOpen) items.push({ key: "limits", clickable: true, paint: accent, text: `${limitsUpdate.label} (click)` });
+  if (tokenNotice?.text && !tokenQuestionOpen) items.push({ key: "token", paint: tokenNotice.urgent ? yellow : dim, text: tokenNotice.text });
   const agents = agentsIndicator(otherAgents);
   if (agents) items.push({ key: "agents", clickable: true, paint: accent, text: `${agents} running (click)` });
   const shells = shellsNotice(shellEntries, { cwd: process.cwd() });
@@ -3125,7 +3168,10 @@ function frozenZone() {
     selection: secretInput ? null : inputSelection,
     highlight: highlightRow,
   });
-  const rows = status.concat(notice ? [notice.row] : [], zone.rows, askHintRows(width), footerRows());
+  const footer = footerBuilt();
+  const rows = status.concat(notice ? [notice.row] : [], zone.rows, askHintRows(width), footer.rows);
+  // The footer is the LAST rows of the zone, so the link's row counts from the end.
+  supportLinkTarget = footer.link ? { fromEnd: footer.rows.length - footer.link.rowIndex, from: footer.link.from, to: footer.link.to } : null;
   // The separator is `status.length (+1 for the notice row)` rows down — everything that writes to
   // or hit-tests a row by index counts from here.
   const sep = status.length + (notice ? 1 : 0);
@@ -8587,6 +8633,83 @@ async function refreshLogsSize() {
   }
 }
 
+// /support (#220): gu's logs, masked and zipped, sent to the support team with a reference back.
+// What is collected and how it is sent is support-bundle.mjs; this is the terminal half only.
+let supportBusy = false;
+async function runSupport() {
+  if (following) {
+    console.log("\n" + GUTTER + dim("A turn is running - /support is available when it finishes (Ctrl-C stops it)."));
+    return;
+  }
+  if (supportBusy || listPickerActive || approvalActive || askWaiting) return;
+  supportBusy = true;
+  try {
+    const sb = await import("./support-bundle.mjs");
+    const width = Math.max(20, process.stdout.columns || 80);
+    const tilde = (p) => (p.startsWith(homedir()) ? "~" + p.slice(homedir().length) : p);
+    const note = (l) => console.log(GUTTER + l);
+    console.log("\n" + GUTTER + dim("Collecting gu's logs (secrets are masked)…"));
+    const bundle = await sb.prepareSupportBundle({ version: REPL_VERSION });
+    const where = tilde(bundle.file);
+    const fallback = (opts = {}) => sb.supportFallbackLines({ file: where, ...opts });
+    console.log("");
+    note(bold("What would be sent") + dim(`  · ${sb.bundleSize(bundle)} zip`));
+    for (const row of sb.bundleSummaryLines(bundle)) note("  " + dim(row));
+    note(dim("saved at ") + dim(where));
+    console.log("");
+    // The answers are typed in the input row, which empties after Enter: echo them so the
+    // scrollback still shows what was sent.
+    const typedMessage = (await ask("What went wrong? (Enter to skip): ")).trim();
+    const message = sb.supportMessage(typedMessage);
+    note(dim("what went wrong: ") + (typedMessage || dim("(not said)")));
+    let email = await sb.defaultReplyEmail();
+    const typed = (await ask(`Email for the answer${email ? ` [${email}]` : ""}: `)).trim();
+    if (typed) email = typed;
+    if (!sb.isEmail(email)) {
+      note(yellow("No reply email — the support team could not answer you. Nothing sent."));
+      for (const l of fallback()) note(dim(l));
+      console.log("");
+      return;
+    }
+    note(dim("answer to: ") + email);
+    // A question never wraps: at 80 columns over SSH the picker hint goes on a row of its own.
+    const q = `Send it to the gu support team (${sb.SUPPORT_EMAIL})?`;
+    const hint = `(${PICK_HINT}):`;
+    console.log("");
+    if (3 + q.length + 2 + hint.length < width) console.log(dim(`   ${q}  ${hint}`));
+    else console.log(dim(`   ${q}\n   ${hint}`));
+    const go = await pickFromList(["Yes — send the request and the logs", "No — keep the zip, I will email it myself"], 0);
+    if (go !== 0) {
+      for (const l of fallback()) note(dim(l));
+      console.log("");
+      return;
+    }
+    note(dim("Sending…"));
+    const r = await sb.sendSupportRequest({ base: sb.supportApiBase(), message, email, version: REPL_VERSION, zip: bundle.zip });
+    if (!r.ok) {
+      const [first, ...rest] = fallback({ why: r.why });
+      note(yellow(first));
+      for (const l of rest) note(l);
+      console.log("");
+      return;
+    }
+    note(accent(`✓ Sent — your reference is ${bold(r.ref)}`));
+    note(dim(`the answer goes to ${email}`));
+    if (r.uploaded) note(dim(`logs attached · to add more, email ${sb.SUPPORT_EMAIL} with ${r.ref}`));
+    else {
+      note(yellow(`The logs did not go with it (${r.uploadWhy}).`));
+      for (const l of fallback({ ref: r.ref })) note(l);
+    }
+    console.log("");
+  } catch (e) {
+    if (wasPromptCancelled(e)) console.log(dim("   (cancelled — nothing sent)\n"));
+    else console.log(GUTTER + red(`couldn't finish — ${e?.message ?? e}`) + "\n");
+  } finally {
+    supportBusy = false;
+    if (barPinned()) paintBar();
+  }
+}
+
 async function runClearLogs() {
   // ONE AT A TIME, and never over a turn or another picker — reached from a fire-and-forget click
   // (see showOtherAgents for what a second picker over the first one does).
@@ -11746,12 +11869,12 @@ async function localScaffoldState() {
 /** Print the startup scaffold line — deferred while a turn owns the transcript. */
 function announceScaffold() {
   if (!scaffoldNotice || following) return;
-  const { kind, text, steps } = scaffoldNotice;
+  const { kind, text } = scaffoldNotice;
   scaffoldNotice = null;
   if (kind === "link") {
     // A setup step, said calmly (#292): the headline, then the steps on their own lines.
+    // ONE yellow line (#222): the steps are the token question's own, behind "?" there.
     console.log(GUTTER + yellow("! " + text));
-    for (const s of steps ?? []) console.log(GUTTER + "  " + dim(s));
   } else {
     console.log(GUTTER + (kind === "ok" ? accent("✓ " + text) : kind === "warn" ? yellow("⚠ " + text) : red("✗ " + text)));
   }
@@ -14225,6 +14348,15 @@ async function main() {
     process.exit(1);
   }
   console.log(wrapGutter("Ask about this repo. Type / to see commands (Tab completes). Ctrl-C aborts a running turn.", dim) + "\n");
+  // #221: gu runs, but its own npm folder is not on PATH (npm skipped the postinstall that adds it).
+  try {
+    const { pathNoticeLine } = await import("./env-check.mjs");
+    const note = pathNoticeLine({ prefix: globalPrefixOf(DIR), pathEnv: process.env.PATH || "", ci: Boolean(process.env.CI) });
+    if (note) console.log(wrapGutter(note, yellow) + "\n");
+  } catch {
+    /* a hint, never a reason to fail to start */
+  }
+  supportHintAtExit = false; // started: from here /support is in the command list
   // Ask whether anything is newer — in the BACKGROUND, so a slow registry never delays the
   // prompt (task #181). The answer paints itself onto the separator row when it arrives, and
   // the interval keeps a long-lived session honest. unref'd: a pending timer must not be the
@@ -14793,6 +14925,10 @@ async function main() {
       await runClearLogs();
       continue;
     }
+    if (line === "/support") {
+      await runSupport();
+      continue;
+    }
     if (line === "/budget") {
       // #205: the short terminal version of web-v2's /providers budgets. The server judges Pro,
       // the account email and "has items" (api/src/providers/terminalBudget.ts).

package/install-path.mjs

@@ -30,6 +30,7 @@ import { appendFileSync, existsSync, readFileSync, chownSync, writeFileSync } fr
 import { homedir, platform, tmpdir } from "node:os";
 import { join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import { stableBinDir } from "./env-check.mjs";
 
 const BEGIN = "# >>> gu-cli PATH >>>";
 const END = "# <<< gu-cli PATH <<<";
@@ -121,12 +122,15 @@ function main() {
   const binDir = join(prefix, "bin");
   if (resolve(binDir).startsWith(resolve(tmpdir()))) return; // preflight's throwaway prefix
 
-  const onPath = (process.env.PATH || "").split(":").some((p) => p === binDir);
+  // On PATH under EITHER spelling: Homebrew's npm can report its prefix as the versioned Cellar
+  // folder while PATH holds the stable <brew prefix>/bin — the same folder (#221).
+  const stable = stableBinDir(binDir);
+  const onPath = (process.env.PATH || "").split(":").some((p) => p === binDir || p === stable);
   if (onPath) return;                                  // nothing to fix — most installs
 
   const home = realUserHome();
   const targets = rcFilesFor(home);
-  const block = `${BEGIN}\n# npm's global bin dir was not on PATH; added by @tiens.nguyen/gu-cli postinstall.\nexport PATH="${binDir}:$PATH"\n${END}\n`;
+  const block = `${BEGIN}\n# npm's global bin dir was not on PATH; added by @tiens.nguyen/gu-cli postinstall.\nexport PATH="${stable}:$PATH"\n${END}\n`;
 
   let wrote = null;
   for (const rc of targets) {
@@ -134,12 +138,12 @@ function main() {
   }
 
   if (wrote) {
-    console.log(`gu-cli: added ${binDir} to PATH in ${wrote}.`);
+    console.log(`gu-cli: added ${stable} to PATH in ${wrote}.`);
     console.log(`gu-cli: open a NEW terminal to use \`gu\`, or run this once in the current one:`);
-    console.log(`  export PATH="${binDir}:$PATH"`);
+    console.log(`  export PATH="${stable}:$PATH"`);
   } else if (targets.length === 0) {
-    console.log(`gu-cli: ${binDir} is not on your PATH and no shell profile was found to update.`);
-    console.log(`  export PATH="${binDir}:$PATH"`);
+    console.log(`gu-cli: ${stable} is not on your PATH and no shell profile was found to update.`);
+    console.log(`  export PATH="${stable}:$PATH"`);
   }
 }
 

package/mongo-native.mjs

@@ -246,6 +246,21 @@ export function captureOutput(cmd, args, timeoutMs = 10000) {
   });
 }
 
+/**
+ * Which of Homebrew's output lines are worth showing (#221). A MongoDB install prints ~100 lines
+ * (every library it pours, a mug per bottle) over several minutes; shown whole they bury the one
+ * that matters. Kept: the `==>` stage lines ("Installing mongodb-community", "Downloading…"), what
+ * gu itself prints (`$ brew …`), and anything that looks like a failure or warning.
+ */
+export function brewLineWorthShowing(line) {
+  const l = String(line ?? "").trim();
+  if (!l) return false;
+  if (l.startsWith("$ ")) return true;
+  if (/\b(error|fail(ed|ure)?|warning|cannot|denied|not found|conflict)\b/i.test(l)) return true;
+  if (l.startsWith("==>")) return !/^==> (Pouring|Fetching downloads? for)\b/.test(l);
+  return false;
+}
+
 /**
  * Homebrew steps, one after another, output shown. → true when all succeeded. HOMEBREW_NO_AUTO_UPDATE
  * keeps `brew install` from first updating every formula on the machine — minutes nobody asked for.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiens.nguyen/gu-cli",
-  "version": "1.0.863",
+  "version": "1.0.864",
   "description": "Gu CLI — the gu terminal plus the local worker that runs agent / OCR / PDF / embedding jobs on your Mac (Ollama / MLX / OpenAI-compatible).",
   "type": "module",
   "license": "MIT",
@@ -89,6 +89,9 @@
     "node-version.mjs",
     "clear-state.mjs",
     "support-report.mjs",
+    "env-check.mjs",
+    "support-bundle.mjs",
+    "support-command.mjs",
     "clear-logs.mjs",
     "platform-tools.mjs",
     "job-pools.mjs",