@modelstatus/cli 0.1.44 → 0.1.46

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelstatus/cli",
-  "version": "0.1.44",
+  "version": "0.1.46",
   "description": "Track which AI models you use, where, and never get surprised by a retirement. Free offline model-health for any repo (mm status), browser sign-in for cloud inventory + alerts.",
   "keywords": [
     "llm",

package/src/index.js

@@ -98,7 +98,9 @@ function parseArgs(argv) {
       const name = a.slice(2);
       if (valueFlags.has(name)) flags[name] = argv[++i];
       else flags[name] = true;
-    } else positional.push(a);
+    } else if (a === "-h") flags.help = true;
+    else if (a === "-v") flags.version = true;
+    else positional.push(a);
   }
   if (flags.ci) {
     flags.yes = true;
@@ -556,6 +558,12 @@ function cmdIntegrations(positional, flags) {
   const id = positional[2];
   const known = (x) => INTEGRATION_IDS.includes(x);
 
+  // Missing id → a clear usage line (not `Unknown integration "undefined"`).
+  if ((sub === "enable" || sub === "disable" || sub === "env") && !id) {
+    console.error(`Usage: mm integrations ${sub} <id>${sub === "env" ? " <prod|staging|dev|unknown>" : ""}   (id: ${INTEGRATION_IDS.join(", ")})`);
+    process.exit(1);
+  }
+
   if (sub === "enable" || sub === "disable") {
     if (!known(id)) {
       console.error(`Unknown integration "${id}". One of: ${INTEGRATION_IDS.join(", ")}`);
@@ -730,6 +738,13 @@ async function main() {
     return;
   }
 
+  // --help / -h / help: print usage + exit. MUST come before the no-arg → TUI
+  // fallthrough below (a bare `mm` launches the TUI, but `mm --help` must not).
+  if (cmd === "help" || flags.help || flags.h) {
+    console.log(HELP);
+    return;
+  }
+
   // Anonymous, opt-out usage analytics (one-time disclosure, then a single
   // event per invocation). No-op without a baked key / when opted out.
   maybeAnalyticsNotice();

package/src/tui/app.js

@@ -86,6 +86,11 @@ export function App({ apiBase, apiKey, dir, initialView, onSignedIn, fresh }) {
   const [prompt, setPrompt] = React.useState(null);
   const [capturing, setCapturing] = React.useState(false); // a view is capturing text (e.g. / search)
   const [status, setStatus] = React.useState(null); // { forKey, counts, context }
+  // A view can publish a CONTEXTUAL keybar for its current sub-state (a tab, a
+  // drill-in) via ui.setKeys(); it overrides the static meta.keys until the view
+  // changes (reset below). Keeps the keybar honest for tabbed views (What's New,
+  // Alerts) where the active keys depend on which sub-tab you're on.
+  const [dynKeys, setDynKeys] = React.useState(null);
   const me = useAsync(async () => (apiKey ? client.me() : null), [apiKey]);
 
   const { outer, termRows } = useTermDims();
@@ -97,6 +102,9 @@ export function App({ apiBase, apiKey, dir, initialView, onSignedIn, fresh }) {
   curKeyRef.current = current.key;
   // Anonymous: which tab is being viewed (no content, just the view name).
   React.useEffect(() => { track("tui_view", { view: current.key }); }, [current.key]);
+  // Drop any contextual keybar when the top-level view changes (the new view
+  // re-publishes its own if it wants one).
+  React.useEffect(() => { setDynKeys(null); }, [idx]);
 
   const showToast = React.useCallback((msg, color = "#16a34a") => {
     setToast({ msg, color });
@@ -168,7 +176,7 @@ export function App({ apiBase, apiKey, dir, initialView, onSignedIn, fresh }) {
     { isActive: !!prompt },
   );
 
-  const ui = { showToast, askPrompt, reportStatus, setCapturing, setHandlesBack, switchTo: (k) => setIdx(VIEWS.findIndex((v) => v.key === k)) };
+  const ui = { showToast, askPrompt, reportStatus, setCapturing, setHandlesBack, setKeys: setDynKeys, switchTo: (k) => setIdx(VIEWS.findIndex((v) => v.key === k)) };
   const current2 = current;
   const View = current2.Comp;
   const account = me.data?.account ?? null;
@@ -195,7 +203,7 @@ export function App({ apiBase, apiKey, dir, initialView, onSignedIn, fresh }) {
     keys = GATE_KEYS;
   } else {
     body = h(View, { client, me: account, refreshMe: me.reload, dir, apiBase, ui, width: W, height: bodyRows, active: !prompt, fresh });
-    keys = (current2.meta && current2.meta.keys) || [];
+    keys = dynKeys || (current2.meta && current2.meta.keys) || [];
   }
 
   // Status bar segments.

package/src/tui/game/launch.js

@@ -73,7 +73,15 @@ export async function playGameInTui({ dir, width, height, initialView = "scan",
       try { if (cacheFile) fs.unlinkSync(cacheFile); } catch { /* ignore */ }
     }
 
-    // (4) Remount the TUI where the player was (so quitting returns you there).
+    // (4) Reset the terminal to a clean full screen BEFORE remounting. The game
+    // left the alternate screen (\x1b[?1049l), which restores the PRE-game main
+    // buffer + cursor — i.e. wherever Ink sat when it unmounted (below the old
+    // frame). Ink renders its first frame from that cursor, so without this the
+    // TUI comes back shifted down / not full-height until the next resize. Reset
+    // the scroll region (\x1b[r), clear the screen, and home the cursor so the
+    // remounted tree fills the whole terminal from the top (same as Ctrl-L).
+    try { process.stdout.write("\x1b[r\x1b[2J\x1b[3J\x1b[H"); } catch { /* ignore */ }
+    await new Promise((r) => setImmediate(r)); // let the reset flush before Ink mounts
     appController.remount({ initialView, fresh: false });
   } catch (e) {
     if (onError) onError(e); else throw e;

package/src/tui/views/alerts.js

@@ -23,10 +23,19 @@ const KIND_COLOR = {
   webhook: C.FG_DIM,
 };
 
+// Per-section keybars — Rules and Channels have different actions, so the keybar
+// follows the active sub-tab (published via ui.setKeys) rather than advertising
+// Rules keys while you're on Channels.
+const ALERTS_TAB_KEYS = [
+  [{ k: "←→", label: "section" }, { k: "↑↓", label: "nav" }, { k: "n", label: "new rule" }, { k: "space", label: "enable" }, { k: "c", label: "cadence" }, { k: "d", label: "delete" }, { k: "g", label: "refresh" }],
+  [{ k: "←→", label: "section" }, { k: "↑↓", label: "nav" }, { k: "n", label: "add channel" }, { k: "t", label: "test" }, { k: "g", label: "refresh" }],
+];
+
 export function AlertsView({ client, ui, active, width = 78, height = 14 }) {
   const ROWS = Math.max(3, height - 4); // subtabs + blank + footer overhead
   const [tab, setTab] = React.useState(0); // 0 rules, 1 channels
   const [cursor, setCursor] = React.useState(0);
+  React.useEffect(() => { ui?.setKeys?.(ALERTS_TAB_KEYS[tab]); }, [tab, ui]);
   const rules = useAsync(async () => (await client.listRules()).data || [], []);
   const channels = useAsync(async () => (await client.listChannels()).data || [], []);
 
@@ -36,6 +45,7 @@ export function AlertsView({ client, ui, active, width = 78, height = 14 }) {
   const cur = list[clampCursor(cursor, list.length)] || null;
 
   const loading = tab === 0 ? rules.loading : channels.loading;
+  const err = tab === 0 ? rules.error : channels.error;
   const tick = useTick(80, loading);
 
   React.useEffect(
@@ -133,6 +143,9 @@ export function AlertsView({ client, ui, active, width = 78, height = 14 }) {
   let body;
   if (loading) {
     body = h(StateLine, { kind: "loading", spin: SPINNER[tick % SPINNER.length], text: tab === 0 ? "loading rules…" : "loading channels…" });
+  } else if (err) {
+    // Don't let a network/API error masquerade as "no rules" (a false empty).
+    body = h(StateLine, { kind: "error", text: `couldn't load ${tab === 0 ? "rules" : "channels"} — ${err}. Press g to retry.` });
   } else if (tab === 0) {
     if (!ruleList.length) {
       body = h(EmptyCard, { title: "No alert rules yet", lines: ["Stay ahead of your model timeline — a heads-up 90, 30, 7, and 1 day before anything you use is deprecated or retired.", "Press n to set the sensible default (your models · in-app + email · those lead times)."], width });

package/src/tui/views/whatsnew.js

@@ -22,10 +22,20 @@ export const meta = {
   ],
 };
 
+// Per-section keybars — the active actions differ by tab (Registry: mark seen ·
+// Notifications: mark read · Drift: rescan + archive). Published via ui.setKeys()
+// so the keybar never advertises a key that's dead on the current section.
+const TAB_KEYS = [
+  [{ k: "←→", label: "section" }, { k: "↑↓", label: "scroll" }, { k: "m", label: "mark all seen" }],
+  [{ k: "←→", label: "section" }, { k: "↑↓", label: "scroll" }, { k: "o", label: "mark read" }],
+  [{ k: "←→", label: "section" }, { k: "↑↓", label: "scroll" }, { k: "r", label: "rescan" }, { k: "a", label: "archive" }],
+];
+
 export function WhatsNewView({ client, dir, ui, active, width = 78, height = 14 }) {
   const [tab, setTab] = React.useState(0);
   const [cursor, setCursor] = React.useState(0);
   const lastSeen = loadConfig().lastEventsSeenAt || null;
+  React.useEffect(() => { ui?.setKeys?.(TAB_KEYS[tab]); }, [tab, ui]);
 
   const reg = useAsync(async () => {
     const [ev, m, p] = await Promise.all([