@great-arrow/cli 0.1.36 → 0.1.37

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.36";
+var CLI_VERSION = "0.1.37";
 var GAD_INSTALL_VERSION = "2026.08.08";
 var GAD_INSTALL_MIN_VERSION = "2026.06.22";
 var GAD_INSTALL_HEADER = "X-GAD-Install-Version";
@@ -16304,29 +16304,35 @@ async function reportSeen(opts) {
 // src/lib/glance-footer.ts
 var FETCH_TIMEOUT_MS = 1500;
 var THROTTLE_INTERVAL_MS = 4 * 60 * 60 * 1e3;
+var TIP_THROTTLE_INTERVAL_MS = 20 * 60 * 60 * 1e3;
 var URGENT_THRESHOLD = 15;
 var SKIP_COMMANDS = /* @__PURE__ */ new Set(["status", "needs", "login", "logout", "help"]);
 async function maybeShowGlanceFooter(argv) {
   try {
     if (!shouldRunGlanceFooter(argv)) return;
     const auth = await resolveAuth();
-    const payload = await fetchGlance(auth.apiUrl, auth.token);
-    if (!payload) return;
-    if (payload.urgency === null) return;
     const workspaceKey = auth.activeWorkspace ?? "default";
-    const signature = topSignature(payload);
     const state = await loadGlanceState();
+    const entry = state[workspaceKey] ?? {};
     const now = Date.now();
-    if (!shouldShowGlance({
+    const askForTip = shouldRequestTip({ state: entry, now });
+    const payload = await fetchGlance(auth.apiUrl, auth.token, askForTip);
+    if (!payload) return;
+    const showNeedsYou = payload.urgency !== null && shouldShowGlance({
       urgency: payload.urgency,
-      topItemId: signature,
-      state: state[workspaceKey] ?? {},
+      topItemId: topSignature(payload),
+      state: entry,
       now
-    })) {
-      return;
-    }
-    const printed = renderFooter(payload, auth.apiUrl);
-    state[workspaceKey] = { lastShownAt: now, lastTopItemId: signature };
+    });
+    const tip = payload.tip;
+    if (!showNeedsYou && !tip) return;
+    const printed = showNeedsYou ? renderFooter(payload, auth.apiUrl) : [];
+    if (tip) renderTip(tip, auth.apiUrl);
+    state[workspaceKey] = {
+      ...entry,
+      ...showNeedsYou ? { lastShownAt: now, lastTopItemId: topSignature(payload) } : {},
+      ...tip ? { lastTipAt: now } : {}
+    };
     await saveGlanceState(state);
     await reportSeen({
       apiUrl: auth.apiUrl,
@@ -16356,7 +16362,7 @@ function firstCommand(argv) {
   }
   return null;
 }
-async function fetchGlance(apiUrl, token) {
+async function fetchGlance(apiUrl, token, includeTip) {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
   try {
@@ -16370,7 +16376,12 @@ async function fetchGlance(apiUrl, token) {
         jsonrpc: "2.0",
         id: `cli-glance-${Date.now()}`,
         method: "tools/call",
-        params: { name: "glance", arguments: {} }
+        params: {
+          name: "glance",
+          // Omitted entirely rather than sent as `false`, so an older server
+          // that does not know this argument sees the request it always saw.
+          arguments: includeTip ? { include_tip: true } : {}
+        }
       }),
       signal: controller.signal
     });
@@ -16472,7 +16483,20 @@ function normalizeGlance(raw) {
       newestPreview: typeof w.newestPreview === "string" ? w.newestPreview : null
     };
   }
+  let tip = null;
+  if (typeof obj.tip === "object" && obj.tip !== null) {
+    const t = obj.tip;
+    if (typeof t.text === "string" && t.text.trim() !== "") {
+      tip = {
+        id: typeof t.id === "string" ? t.id : "",
+        text: t.text,
+        deepLink: typeof t.deepLink === "string" ? t.deepLink : null,
+        whySeen: typeof t.whySeen === "string" ? t.whySeen : null
+      };
+    }
+  }
   return {
+    tip,
     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
@@ -16524,6 +16548,11 @@ function shouldShowGlance(input) {
   if (state.lastTopItemId !== topItemId) return true;
   return now - state.lastShownAt >= THROTTLE_INTERVAL_MS;
 }
+function shouldRequestTip(input) {
+  const { state, now } = input;
+  if (state.lastTipAt === void 0) return true;
+  return now - state.lastTipAt >= TIP_THROTTLE_INTERVAL_MS;
+}
 function getGlanceStatePath() {
   return join6(homedir4(), ".gad", "glance-state.json");
 }
@@ -16602,6 +16631,14 @@ function renderFooter(payload, apiUrl) {
   process.stderr.write("\n" + brandedBlock("needs you", lines) + "\n");
   return printed;
 }
+function renderTip(tip, apiUrl) {
+  const c = createColor(false);
+  const lines = [`${c.yellow("\u{1F4A1}")} ${tip.text}`];
+  if (tip.whySeen) lines.push(`    ${c.dim(tip.whySeen)}`);
+  const url = glanceItemUrl(tip.deepLink, apiUrl);
+  if (url) lines.push(`    ${c.dim("\u2192")} ${c.cyan(url)}`);
+  process.stderr.write("\n" + brandedBlock("tip", lines) + "\n");
+}
 var GAD_MARK = "\u{1F3F9}";
 function brandedBlock(title, lines) {
   const header = `${GAD_MARK} Great Arrow \xB7 ${title}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@great-arrow/cli",
-  "version": "0.1.36",
+  "version": "0.1.37",
   "description": "GreatArrow.ai CLI tool",
   "type": "module",
   "bin": {