@great-arrow/cli 0.1.26 → 0.1.32

package/dist/index.js

@@ -9399,7 +9399,7 @@ function isNodeError(value) {
 
 // src/lib/version.ts
 var CLI_PACKAGE_NAME = "@great-arrow/cli";
-var CLI_VERSION = "0.1.26";
+var CLI_VERSION = "0.1.32";
 var GAD_INSTALL_VERSION = "2026.08.08";
 var GAD_INSTALL_MIN_VERSION = "2026.06.22";
 var GAD_INSTALL_HEADER = "X-GAD-Install-Version";
@@ -11741,13 +11741,30 @@ function requireGit(args, cwd) {
 function isAncestor(ancestor, ref, cwd) {
   return git(["merge-base", "--is-ancestor", ancestor, ref], cwd).status === 0;
 }
+var AHEAD_BEHIND_FIELD = "%(ahead-behind:origin/main)";
+var RICH_BRANCH_FORMAT = [
+  "%(refname:short)",
+  "%(objectname)",
+  "%(upstream:short)",
+  "%(upstream:track)",
+  "%(committerdate:iso-strict)",
+  AHEAD_BEHIND_FIELD
+].join("%09");
+var LEGACY_BRANCH_FORMAT = [
+  "%(refname:short)",
+  "%(objectname)",
+  "%(upstream:short)",
+  "%(upstream:track)",
+  "%(committerdate:iso-strict)"
+].join("%09");
 function auditLocalBranches(root) {
-  const raw = requireGit(
-    [
-      "for-each-ref",
-      "--format=%(refname:short)%09%(objectname)%09%(upstream:short)%09%(upstream:track)",
-      "refs/heads"
-    ],
+  const rich = git(
+    ["for-each-ref", `--format=${RICH_BRANCH_FORMAT}`, "refs/heads"],
+    root
+  );
+  const exact = rich.status === 0;
+  const raw = exact ? rich.stdout.trim() : requireGit(
+    ["for-each-ref", `--format=${LEGACY_BRANCH_FORMAT}`, "refs/heads"],
     root
   );
   const unmerged = new Set(
@@ -11762,23 +11779,32 @@ function auditLocalBranches(root) {
     ).split("\n").filter(Boolean)
   );
   return raw.split("\n").filter(Boolean).flatMap((line) => {
-    const [branch, head, upstreamRaw, tracking] = line.split("	");
-    if (!branch || !head) return [];
-    const mergedToMain = !unmerged.has(branch);
-    return [
-      {
-        branch,
-        head,
-        upstream: upstreamRaw || null,
-        upstreamGone: tracking?.includes("gone") ?? false,
-        aheadMain: mergedToMain ? 0 : 1,
-        behindMain: 0,
-        countsExact: false,
-        mergedToMain
-      }
-    ];
+    const parsed = parseLocalBranchLine(line, exact, unmerged);
+    return parsed ? [parsed] : [];
   });
 }
+function parseLocalBranchLine(line, exact, unmerged) {
+  const [branch, head, upstreamRaw, tracking, committedAt, aheadBehind] = line.split("	");
+  if (!branch || !head) return null;
+  const mergedToMain = !unmerged.has(branch);
+  const [aheadRaw, behindRaw] = (aheadBehind ?? "").trim().split(/\s+/);
+  const ahead = Number(aheadRaw);
+  const behind = Number(behindRaw);
+  const countsExact = exact && Number.isFinite(ahead) && Number.isFinite(behind);
+  return {
+    branch,
+    head,
+    upstream: upstreamRaw || null,
+    upstreamGone: tracking?.includes("gone") ?? false,
+    // Fall back to the old boolean ONLY when the exact count is genuinely
+    // unavailable, so a stale git degrades instead of lying.
+    aheadMain: countsExact ? ahead : mergedToMain ? 0 : 1,
+    behindMain: countsExact ? behind : 0,
+    countsExact,
+    mergedToMain,
+    committedAt: committedAt || null
+  };
+}
 function parseWorktrees(raw) {
   const worktrees = [];
   let current = {};
@@ -11851,13 +11877,32 @@ async function auditWorktrees(root, localBranches) {
 }
 function auditDetachedLocalBranches(localBranches, checkedOutBranches) {
   return localBranches.filter(({ branch }) => !checkedOutBranches.has(branch)).map(
-    ({ branch, head, mergedToMain, behindMain, aheadMain, countsExact }) => ({
+    ({
       branch,
       head,
       mergedToMain,
       behindMain,
       aheadMain,
-      countsExact
+      countsExact,
+      upstream,
+      upstreamGone,
+      committedAt
+    }) => ({
+      branch,
+      head,
+      mergedToMain,
+      behindMain,
+      aheadMain,
+      countsExact,
+      // `upstream` is what separates "never left this disk" from "pushed,
+      // just has no PR yet" — the single bit that decides whether work can
+      // actually be lost. It was computed and then dropped here, so the
+      // server classified both as one undifferentiated "stranded".
+      upstream,
+      upstreamGone,
+      // Without this the grace window read `ageMs = Infinity` for every
+      // branch, so a branch was "stranded" from its first second.
+      committedAt
     })
   );
 }
@@ -14853,12 +14898,18 @@ function handleSyncResponse(fmt, kind, response) {
   }
   fmt.success(`Sync triggered successfully for "${kind}".`);
   const syncedAtStr = formatTimestamp(
-    response.lastSynced ?? response.last_synced
+    response.lastSyncAt ?? response.lastSynced ?? response.last_synced
   );
   if (syncedAtStr) {
     fmt.info(`  Last synced: ${syncedAtStr}`);
   }
 }
+function normalizeIntegrationRow(item) {
+  return {
+    ...item,
+    lastSynced: item.lastSyncAt ?? item.lastSynced ?? item.last_synced ?? item.lastSyncedAt ?? null
+  };
+}
 var listCommand3 = new Command("list").description("List all connected integrations with sync status").option("--json", "Output as JSON").action(async (options) => {
   const jsonFlag = Boolean(
     options.json || listCommand3.optsWithGlobals().json
@@ -14878,10 +14929,7 @@ var listCommand3 = new Command("list").description("List all connected integrati
   } else if (typeof data === "object" && data !== null && "integrations" in data) {
     integrations = data.integrations;
   }
-  const normalized = integrations.map((item) => ({
-    ...item,
-    lastSynced: item.lastSynced ?? item.last_synced ?? item.lastSyncedAt ?? null
-  }));
+  const normalized = integrations.map(normalizeIntegrationRow);
   fmt.table(normalized, integrationListColumns);
   if (!jsonFlag) {
     displayFailedIntegrations(fmt, normalized);
@@ -17151,14 +17199,102 @@ function localCommand() {
   return new Command("local").description("Answer with a model running on this computer").addCommand(checkCommand()).addCommand(askHereCommand());
 }
 
+// src/lib/hyperlink.ts
+var SUPPORTED_TERM_PROGRAMS = /* @__PURE__ */ new Set([
+  "ghostty",
+  "iterm.app",
+  "wezterm",
+  "vscode",
+  "hyper",
+  "warpterminal",
+  "rio",
+  "contour",
+  "tabby"
+]);
+var SUPPORTED_TERMS = /* @__PURE__ */ new Set([
+  "xterm-kitty",
+  "alacritty",
+  "foot",
+  "contour"
+]);
+var UNSUPPORTED_TERM_PROGRAMS = /* @__PURE__ */ new Set(["apple_terminal"]);
+var MIN_VTE_VERSION = 5e3;
+function isTruthyFlag(value) {
+  if (value === void 0) return false;
+  const v = value.trim().toLowerCase();
+  return v !== "" && v !== "0" && v !== "false";
+}
+function supportsHyperlinks(env4, isTTY2) {
+  if (isTruthyFlag(env4.FORCE_HYPERLINK)) return true;
+  if (env4.NO_COLOR !== void 0 && env4.NO_COLOR !== "") return false;
+  if (!isTTY2) return false;
+  if (isTruthyFlag(env4.CI)) return false;
+  const term = (env4.TERM ?? "").trim().toLowerCase();
+  if (term === "" || term === "dumb") return false;
+  if (term.startsWith("screen") || term.startsWith("tmux")) return false;
+  const program3 = (env4.TERM_PROGRAM ?? "").trim().toLowerCase();
+  if (UNSUPPORTED_TERM_PROGRAMS.has(program3)) return false;
+  if (SUPPORTED_TERM_PROGRAMS.has(program3)) return true;
+  if (SUPPORTED_TERMS.has(term)) return true;
+  if (isTruthyFlag(env4.WT_SESSION)) return true;
+  if (isTruthyFlag(env4.KONSOLE_VERSION)) return true;
+  if (env4.TERMINAL_EMULATOR === "JetBrains-JediTerm") return true;
+  const vte = Number.parseInt(env4.VTE_VERSION ?? "", 10);
+  if (Number.isFinite(vte) && vte >= MIN_VTE_VERSION) return true;
+  return false;
+}
+var OSC = "\x1B]8;;";
+var ST = "\x1B\\";
+function hyperlink(text2, url, opts) {
+  if (!opts.enabled) return text2 === url ? url : `${text2} (${url})`;
+  return `${OSC}${url}${ST}${text2}${OSC}${ST}`;
+}
+
 // src/lib/glance-footer.ts
 import { readFile as readFile4, writeFile as writeFile4, mkdir as mkdir4 } from "node:fs/promises";
 import { homedir as homedir4 } from "node:os";
 import { join as join6, dirname as dirname5 } from "node:path";
+
+// src/lib/seen.ts
+var SEEN_TIMEOUT_MS = 1e3;
+var MAX_KEYS = 50;
+async function reportSeen(opts) {
+  const keys = [
+    ...new Set(
+      opts.keys.filter((k) => typeof k === "string" && k !== "")
+    )
+  ].slice(0, MAX_KEYS);
+  if (keys.length === 0) return 0;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), SEEN_TIMEOUT_MS);
+  try {
+    const response = await fetch(
+      `${opts.apiUrl.replace(/\/$/, "")}/api/attention/seen`,
+      {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${opts.token}`
+        },
+        body: JSON.stringify({ keys }),
+        signal: controller.signal
+      }
+    );
+    if (!response.ok) return 0;
+    const data = await response.json().catch(() => null);
+    return typeof data?.seen === "number" ? data.seen : 0;
+  } catch {
+    return 0;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+// src/lib/glance-footer.ts
 var FETCH_TIMEOUT_MS = 1500;
 var THROTTLE_INTERVAL_MS = 4 * 60 * 60 * 1e3;
 var URGENT_THRESHOLD = 15;
-var SKIP_COMMANDS = /* @__PURE__ */ new Set(["status", "login", "logout", "help"]);
+var SKIP_COMMANDS = /* @__PURE__ */ new Set(["status", "needs", "login", "logout", "help"]);
 async function maybeShowGlanceFooter(argv) {
   try {
     if (!shouldRunGlanceFooter(argv)) return;
@@ -17178,9 +17314,14 @@ async function maybeShowGlanceFooter(argv) {
     })) {
       return;
     }
-    renderFooter(payload, auth.apiUrl);
+    const printed = renderFooter(payload, auth.apiUrl);
     state[workspaceKey] = { lastShownAt: now, lastTopItemId: signature };
     await saveGlanceState(state);
+    await reportSeen({
+      apiUrl: auth.apiUrl,
+      token: auth.token,
+      keys: printed
+    });
   } catch (err) {
     debugSwallow("glance-footer", err);
   }
@@ -17247,7 +17388,28 @@ function normalizeGlance(raw) {
         title: it.title,
         action: typeof it.action === "string" ? it.action : null,
         href: typeof it.href === "string" && it.href !== "" ? it.href : null,
-        ...typeof it.rank === "number" ? { rank: it.rank } : {}
+        ...typeof it.rank === "number" ? { rank: it.rank } : {},
+        signalKey: typeof it.signalKey === "string" && it.signalKey !== "" ? it.signalKey : null,
+        workspace: typeof it.workspace === "string" && it.workspace !== "" ? it.workspace : null,
+        // Parsed like every other field: a non-string is dropped rather than
+        // coerced, so a malformed payload cannot render as a currency claim.
+        freshness: typeof it.freshness === "string" && it.freshness !== "" ? it.freshness : null,
+        meta: typeof it.meta === "string" && it.meta !== "" ? it.meta : null
+      }
+    ];
+  });
+  const atRisk = asArray2(obj.atRisk).flatMap((item) => {
+    if (typeof item !== "object" || item === null) return [];
+    const it = item;
+    if (typeof it.title !== "string") return [];
+    return [
+      {
+        classification: typeof it.classification === "string" ? it.classification : null,
+        riskLevel: typeof it.riskLevel === "string" ? it.riskLevel : "high",
+        title: it.title,
+        branch: typeof it.branch === "string" ? it.branch : null,
+        aheadMain: typeof it.aheadMain === "number" ? it.aheadMain : null,
+        recommendedAction: typeof it.recommendedAction === "string" ? it.recommendedAction : null
       }
     ];
   });
@@ -17301,11 +17463,29 @@ function normalizeGlance(raw) {
   }
   return {
     workspace: typeof obj.workspace === "string" && obj.workspace !== "" ? obj.workspace : null,
+    // An older server sends no `reads` at all, so this normalizes to an empty
+    // list rather than inventing the pinned workspace as the read set — the
+    // CLI then renders no breadth cue, which is honest, instead of a claim it
+    // was never told.
+    reads: Array.isArray(obj.reads) ? obj.reads.flatMap((r) => {
+      if (typeof r !== "object" || r === null) return [];
+      const row = r;
+      return typeof row.id === "string" && typeof row.name === "string" ? [{ id: row.id, name: row.name }] : [];
+    }) : [],
     needsYou,
+    atRisk,
     topGoal,
     integrations,
     agents,
     warRoom,
+    // Parsed like every other field: both halves must be the right type or the
+    // whole line is dropped, so a malformed payload cannot render as a dollar.
+    spend: (() => {
+      const raw2 = obj.spend;
+      if (typeof raw2 !== "object" || raw2 === null) return null;
+      const sp = raw2;
+      return typeof sp.line === "string" && sp.line !== "" && typeof sp.totalCostUsd === "number" && Number.isFinite(sp.totalCostUsd) ? { line: sp.line, totalCostUsd: sp.totalCostUsd } : null;
+    })(),
     urgency: typeof obj.urgency === "number" ? obj.urgency : null,
     generatedAt: typeof obj.generatedAt === "string" ? obj.generatedAt : (/* @__PURE__ */ new Date()).toISOString()
   };
@@ -17362,14 +17542,33 @@ function glanceItemUrl(href, apiUrl) {
 function renderFooter(payload, apiUrl) {
   const c = createColor(false);
   const lines = [];
+  const printed = [];
   const wr = payload.warRoom;
   if (wr && wr.priorityCount > 0) {
     lines.push(
       `${c.yellow("!")} ${wr.priorityCount} war-room message${wr.priorityCount === 1 ? "" : "s"} for you${wr.newestSender ? ` \u2014 ${wr.newestSender}` : ""}`
     );
   }
+  const unpushed = (payload.atRisk ?? []).filter(
+    (item) => item.classification === "unpushed"
+  );
+  if (unpushed.length > 0) {
+    const commits = unpushed.reduce(
+      (sum, item) => sum + (item.aheadMain ?? 0),
+      0
+    );
+    const scale = commits > 0 ? `${commits} commit${commits === 1 ? "" : "s"} on ${unpushed.length} branch${unpushed.length === 1 ? "" : "es"}` : `${unpushed.length} branch${unpushed.length === 1 ? "" : "es"}`;
+    lines.push(`${c.yellow("!")} ${scale} exist on this machine only`);
+    const first = unpushed[0];
+    if (first?.branch) {
+      lines.push(
+        `    ${c.dim("\u2192")} ${c.cyan(`git push -u origin ${first.branch}`)}`
+      );
+    }
+  }
   for (const item of payload.needsYou.slice(0, 2)) {
     lines.push(`${c.yellow("!")} ${item.title}`);
+    if (item.signalKey) printed.push(item.signalKey);
     if (item.action) {
       lines.push(`    ${c.dim("\u2192")} ${c.cyan(item.action)}`);
     } else {
@@ -17387,21 +17586,21 @@ function renderFooter(payload, apiUrl) {
       }
     }
   }
-  if (lines.length === 0) return;
+  if (lines.length === 0) return [];
   lines.push(`${c.dim("\u2192")} ${c.cyan("gad status")} for the full picture.`);
   process.stderr.write("\n" + brandedBlock("needs you", lines) + "\n");
+  return printed;
 }
-var GAD_LOGO = `<img src="https://www.greatarrow.ai/icon.svg" width="16" alt="Great Arrow" style="vertical-align:middle;display:inline-block;margin-right:4px;" />`;
+var GAD_MARK = "\u{1F3F9}";
 function brandedBlock(title, lines) {
-  const header = `${GAD_LOGO} **Great Arrow** \xB7 ${title}`;
-  const visualLength = header.replace(GAD_LOGO, "  ").length;
-  const rule = "\u2500".repeat(Math.min(60, visualLength));
-  return [header, rule, ...lines].join("\\n");
+  const header = `${GAD_MARK} Great Arrow \xB7 ${title}`;
+  const rule = "\u2500".repeat(Math.min(60, [...header].length));
+  return [header, rule, ...lines].join("\n");
 }
 
 // src/commands/status.ts
 function statusCommand2() {
-  const cmd = new Command("status").description(
+  const cmd = new Command("status").alias("needs").description(
     "Show what needs you: blockers, Goal progress, stale data, agents"
   ).option("--json", "Output the raw glance payload as JSON").option("--quiet", "Suppress decorative output").option("--no-color", "Disable color output").action(async (options, command) => {
     const g = globalOutputOpts(command);
@@ -17437,11 +17636,18 @@ function statusCommand2() {
       return;
     }
     renderStatus(payload, g.noColor || g.quiet, auth.apiUrl);
+    await reportSeen({
+      apiUrl: auth.apiUrl,
+      token: auth.token,
+      keys: payload.needsYou.map((item) => item.signalKey)
+    });
   });
   return cmd;
 }
 function renderStatus(payload, plain, apiUrl) {
   const c = createColor(plain);
+  const links = supportsHyperlinks(process.env, isTTY());
+  const link = (text2, url) => c.cyan(hyperlink(text2, url, { enabled: links }));
   const lines = [];
   if (payload.workspace) {
     lines.push(c.badge(` ${payload.workspace} `));
@@ -17464,18 +17670,23 @@ function renderStatus(payload, plain, apiUrl) {
     if (wr.newestPreview) {
       lines.push(`      ${c.dim(wr.newestPreview)}`);
     }
-    lines.push(
-      `      ${c.dim("\u2192")} ${c.cyan(glanceItemUrl("/team?tab=war-room", apiUrl) ?? "")}`
-    );
+    const warRoomUrl = glanceItemUrl("/team?tab=war-room", apiUrl);
+    if (warRoomUrl) {
+      lines.push(
+        `      ${c.dim("\u2192")} ${link("Open the war room", warRoomUrl)}`
+      );
+    }
     lines.push("");
   }
   if (payload.needsYou.length > 0) {
     lines.push(c.bold("Needs you"));
     for (const item of payload.needsYou) {
-      lines.push(`  ${c.yellow("!")} ${item.title}`);
+      const from = item.workspace ? ` ${c.dim(`(${item.workspace})`)}` : "";
+      lines.push(`  ${c.yellow("!")} ${item.title}${from}`);
+      if (item.freshness) lines.push(`      ${c.dim(item.freshness)}`);
       if (item.action) lines.push(`      ${c.dim("\u2192")} ${c.cyan(item.action)}`);
       const url = glanceItemUrl(item.href, apiUrl);
-      if (url) lines.push(`      ${c.dim("\u2192")} ${c.cyan(url)}`);
+      if (url) lines.push(`      ${c.dim("\u2192")} ${link(item.title, url)}`);
     }
     lines.push("");
   }
@@ -17678,6 +17889,65 @@ function nextCommand() {
   });
 }
 
+// src/commands/discover.ts
+var DISCOVER_COLUMNS = [
+  { key: "category", header: "Area", width: 20 },
+  { key: "text", header: "Did you know", width: 78 },
+  { key: "url", header: "Open" }
+];
+var AREA_LABELS = {
+  feature_discovery: "Capability",
+  workflow: "Workflow",
+  integration_health: "Connections",
+  memory: "Memory",
+  meetings: "Meetings",
+  models: "Models",
+  opportunity: "Setup"
+};
+function discoverRow(item) {
+  const category = typeof item.category === "string" ? item.category : "";
+  return {
+    category: AREA_LABELS[category] ?? category,
+    text: typeof item.text === "string" ? item.text : "",
+    url: typeof item.url === "string" ? item.url : ""
+  };
+}
+function discoverCommand() {
+  return new Command("discover").description("Show what Great Arrow can do that you're not using yet").option("--limit <n>", "How many suggestions to show").option("--json", "Output as JSON").action(async (opts, command) => {
+    const g = globalOutputOpts(command);
+    const fmt = createFormatter({
+      json: g.json,
+      quiet: g.quiet,
+      isTTY: isTTY(),
+      noColor: g.noColor
+    });
+    const auth = await resolveAuth();
+    const client = new GadClient({ token: auth.token, apiUrl: auth.apiUrl });
+    const parsed = opts.limit ? Number.parseInt(opts.limit, 10) : NaN;
+    const args = Number.isFinite(parsed) && parsed > 0 ? { limit: parsed } : {};
+    const result = await client.mcpCall("did_you_know", args);
+    const items = Array.isArray(result?.items) ? result.items : [];
+    if (items.length === 0) {
+      if (!g.json) {
+        fmt.info(
+          "Nothing new to suggest \u2014 this workspace already uses what its connected tools support. Connect another tool with 'gad integrations' to unlock more."
+        );
+      } else {
+        fmt.table([], DISCOVER_COLUMNS);
+      }
+      return;
+    }
+    fmt.table(items.map(discoverRow), DISCOVER_COLUMNS);
+    if (!g.json) {
+      const using = Number(result?.alreadyUsingCount ?? 0);
+      const total = Number(result?.totalCount ?? 0);
+      if (Number.isFinite(using) && Number.isFinite(total) && total > 0) {
+        fmt.info(`You're already using ${using} of ${total} capabilities.`);
+      }
+    }
+  });
+}
+
 // src/lib/completions.ts
 var COMMANDS = [
   "login",
@@ -20187,8 +20457,8 @@ import process10 from "node:process";
 
 // node_modules/.pnpm/ansi-regex@6.2.2/node_modules/ansi-regex/index.js
 function ansiRegex({ onlyFirst = false } = {}) {
-  const ST = "(?:\\u0007|\\u001B\\u005C|\\u009C)";
-  const osc = `(?:\\u001B\\][\\s\\S]*?${ST})`;
+  const ST2 = "(?:\\u0007|\\u001B\\u005C|\\u009C)";
+  const osc = `(?:\\u001B\\][\\s\\S]*?${ST2})`;
   const csi = "[\\u001B\\u009B][[\\]()#;?]*(?:\\d{1,4}(?:[;:]\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]";
   const pattern = `${osc}|${csi}`;
   return new RegExp(pattern, onlyFirst ? void 0 : "g");
@@ -21318,6 +21588,7 @@ program2.addCommand(memoryCommand);
 program2.addCommand(workspace_default);
 program2.addCommand(todo_default);
 program2.addCommand(nextCommand());
+program2.addCommand(discoverCommand());
 program2.addCommand(claim_default);
 program2.addCommand(work_default());
 program2.addCommand(worktree_default);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@great-arrow/cli",
-  "version": "0.1.26",
+  "version": "0.1.32",
   "description": "GreatArrow.ai CLI tool",
   "type": "module",
   "bin": {
@@ -38,7 +38,7 @@
   "license": "SEE LICENSE IN LICENSE",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Clapptastic/great-arrow-digital.git",
+    "url": "git+https://github.com/GreatArrow-ai/great-arrow-digital.git",
     "directory": "packages/cli"
   },
   "homepage": "https://www.greatarrow.ai",