@modelstatus/cli 0.1.43 → 0.1.45

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelstatus/cli",
-  "version": "0.1.43",
+  "version": "0.1.45",
   "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/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/inventory.js

@@ -6,8 +6,8 @@ import React from "react";
 import path from "node:path";
 import { Box, Text, useInput } from "ink";
 import {
-  h, C, GLYPH, ListRow, StateLine, EmptyCard, healthColor, healthGlyph,
-  relativeTime, envTag, cell, cellE, snippetLines, SPINNER, useTick, useAsync, clampCursor,
+  h, C, GLYPH, ListRow, StateLine, EmptyCard, SearchBar, healthColor, healthGlyph,
+  relativeTime, envTag, cell, cellE, snippetLines, SPINNER, useTick, useAsync, useSearch, clampCursor,
 } from "../ui.js";
 import { readSnippet, findSourceFile } from "../snippet.js";
 import { sourceOf, SOURCE_META, sourceGlyph } from "../source-meta.js";
@@ -17,6 +17,7 @@ const ENV_ORDER = ["prod", "staging", "dev", "unknown"];
 export const meta = {
   keys: [
     { k: "↑↓", label: "nav" },
+    { k: "/", label: "search" },
     { k: "e", label: "env" },
     { k: "t", label: "tag untagged" },
     { k: "c", label: "critical" },
@@ -44,7 +45,27 @@ export function InventoryView({ client, ui, dir = ".", active, width = 78, heigh
   const usages = q.data?.usages || [];
   const projects = q.data?.projects || [];
   const projName = (id) => projects.find((p) => p.id === id)?.name || "—";
-  const cur = usages[clampCursor(cursor, usages.length)] || null;
+
+  // Filter (press / ) — matches the model, the SOURCE (badge + label + scheme),
+  // the project + env. So "vercel"/"supabase"/"aws"/"github"/"repo"/"manual"
+  // search BY SOURCE, while "gpt" / a project name still work. Reuses the Scan
+  // tab's search hook so the / + esc + type flow is identical everywhere.
+  const search = useSearch();
+  const query = search.query.trim().toLowerCase();
+  const haystack = (u) => {
+    const st = sourceOf(u.location_label, u.discovered_by);
+    const m = SOURCE_META[st] || {};
+    return [u.model_display, u.custom_model_name, u.canonical_id, m.badge, m.label, st, projName(u.project_id), u.environment]
+      .map((x) => String(x || "").toLowerCase())
+      .join(" ");
+  };
+  const filtered = query ? usages.filter((u) => haystack(u).includes(query)) : usages;
+  const cur = filtered[clampCursor(cursor, filtered.length)] || null;
+
+  // Keep the cursor in range as the filter narrows; let the shell route backspace
+  // to "clear filter" (not "previous tab") while a query is active.
+  React.useEffect(() => { setCursor(0); }, [query]);
+  React.useEffect(() => { ui?.setHandlesBack?.(!!search.query); }, [search.query, ui]);
 
   // Drill-down code preview for the highlighted usage's source location — same
   // syntax-highlighted snippet as the Here tab, shown below the list (the side
@@ -67,8 +88,8 @@ export function InventoryView({ client, ui, dir = ".", active, width = 78, heigh
   React.useEffect(() => {
     const counts = { ok: 0, deprecating: 0, retiring: 0, retired: 0, custom: 0 };
     for (const u of usages) if (counts[u.health] != null) counts[u.health] += 1;
-    ui?.reportStatus?.({ counts, context: `${usages.length} tracked` });
-  }, [usages, ui]);
+    ui?.reportStatus?.({ counts, context: query ? `${filtered.length} of ${usages.length}` : `${usages.length} tracked` });
+  }, [usages, ui, query, filtered.length]);
 
   async function patch(u, body, label) {
     try {
@@ -83,8 +104,18 @@ export function InventoryView({ client, ui, dir = ".", active, width = 78, heigh
   useInput(
     (input, key) => {
       if (!active) return;
-      if (key.downArrow || input === "j") return setCursor((c) => clampCursor(c + 1, usages.length));
-      if (key.upArrow || input === "k") return setCursor((c) => clampCursor(c - 1, usages.length));
+      // --- filter mode: type to search (matches model + SOURCE + project + env) ---
+      if (search.isSearchingNow()) {
+        if (key.escape) { search.clear(); setCursor(0); ui?.setCapturing?.(false); return; }
+        if (key.return) { search.confirm(); ui?.setCapturing?.(false); return; }
+        if (key.backspace || key.delete) return search.backspace();
+        if (input && !key.ctrl && !key.meta) return search.type(input);
+        return;
+      }
+      if (input === "/") { search.open(); ui?.setCapturing?.(true); return; }
+      if ((key.escape || key.backspace || key.delete) && search.query) { search.clear(); setCursor(0); return; }
+      if (key.downArrow || input === "j") return setCursor((c) => clampCursor(c + 1, filtered.length));
+      if (key.upArrow || input === "k") return setCursor((c) => clampCursor(c - 1, filtered.length));
       if (input === "g") return q.reload();
       if (input === "r") return ui.switchTo("scan");
       if (input === "n") return ui.switchTo("add");
@@ -135,7 +166,7 @@ export function InventoryView({ client, ui, dir = ".", active, width = 78, heigh
           .deleteUsage(cur.id)
           .then(() => {
             ui.showToast("deleted");
-            setCursor((c) => clampCursor(c, usages.length - 1));
+            setCursor((c) => clampCursor(c, filtered.length - 1));
             q.reload();
           })
           .catch((e) => ui.showToast(e.message, "red"));
@@ -184,10 +215,11 @@ export function InventoryView({ client, ui, dir = ".", active, width = 78, heigh
   const showNote = !showSnip && !!srcRef && height >= 14; // has a path but no local file
   const reserve = showSnip ? SNIP : showNote ? 2 : 0;
   const topH = height - reserve;
-  const VISIBLE = Math.max(3, topH - 2); // header + "…and N more" overhead
-  const c = clampCursor(cursor, usages.length);
-  const start = Math.max(0, Math.min(c - Math.floor(VISIBLE / 2), Math.max(0, usages.length - VISIBLE)));
-  const view = usages.slice(start, start + VISIBLE);
+  const searchRow = search.active ? 1 : 0; // the / search bar costs a row when shown
+  const VISIBLE = Math.max(3, topH - 2 - searchRow); // header + "…and N more" overhead
+  const c = clampCursor(cursor, filtered.length);
+  const start = Math.max(0, Math.min(c - Math.floor(VISIBLE / 2), Math.max(0, filtered.length - VISIBLE)));
+  const view = filtered.slice(start, start + VISIBLE);
 
   const header = h(
     Text,
@@ -215,13 +247,15 @@ export function InventoryView({ client, ui, dir = ".", active, width = 78, heigh
     return h(ListRow, { key: u.id, active: isCur, cells, width: leftWidth });
   });
 
+  const noMatches = query && filtered.length === 0;
   const list = h(
     Box,
     { flexDirection: "column", width: leftWidth },
+    search.active ? h(SearchBar, { searching: search.searching, query: search.query, count: filtered.length }) : null,
     header,
-    ...rowNodes,
-    usages.length > VISIBLE
-      ? h(Text, { color: C.FG_FAINT }, `  ${start + 1}-${Math.min(start + VISIBLE, usages.length)} of ${usages.length}`)
+    ...(noMatches ? [h(Text, { color: C.FG_DIM }, `  no matches for "${search.query}"`)] : rowNodes),
+    filtered.length > VISIBLE
+      ? h(Text, { color: C.FG_FAINT }, `  ${start + 1}-${Math.min(start + VISIBLE, filtered.length)} of ${filtered.length}`)
       : null,
   );
 

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([