@kud/gh-ink 0.70.0 → 0.72.0

package/dist/index.d.ts

@@ -468,6 +468,16 @@ interface InboxExtension {
     drills?: AnyItem["kind"][];
     body: (onExit: () => void, target?: ExtensionTarget) => ReactNode;
     commands?: (target: ExtensionTarget) => Command[];
+    resolve?: (input: string) => (() => Promise<AnyItem>) | null;
+}
+/**
+ * How a `resolve` thunk says "nothing by that name": the launcher draws its
+ * message muted, the way it draws a query that matched nothing, and keeps the
+ * input open. Any other rejection is a failure and is drawn in the error tone —
+ * the difference a reader needs between "you typed it wrong" and "try again".
+ */
+declare class LookupMiss extends Error {
+    constructor(message: string);
 }
 
 /**
@@ -909,4 +919,4 @@ declare const matchesFilter: (repo: string, filter: RepoFilter) => boolean;
  */
 declare const parsePatterns: (value: string) => string[];
 
-export { type Action, type ActionGroup, ActionMenu, App, COLS, type ChromeHints, type ChromeSpec, type ChromeState, CiStatusLine, type CiStatusState, type Command, CommentsPanel, type CommentsPanelProps, type DetailContext, type ExplainSection, type ExtensionTarget, HealthPanel, type HealthPanelProps, type InboxBudget, type InboxExtension, type JiraAvailableTransition, type JiraTransition, type JiraTransitionsFor, type LiveLabel, MIN_SIDEBAR_COLS, type MenuGap, type MenuRow, PrRow, type PrRowProps, type Rails, type RepoFilter, type RowAnnouncement, type RowMotion, SIDEBAR_COLS, type SettledResult, SidePanel, type Sidebar, type SidebarRow, type StatusStrip, StatusStripLine, type StripItem, type StripState, type StripStatusState, type TrailingColumns, type TrailingShed, ageLabel, budgetNotice, buildActions, buildCheckoutCmd, clipboard, counts, drillCmd, explainGhAction, explainItem, fitCount, gapsAbove, healthColor, healthDisplay, healthGlyph, healthLegend, isMenuGap, itermRun, jumpToRepo, jumpToRepoPane, matchesFilter, maxViewStart, menuRowsOf, menuTone, moveCursor, numberColumnsOf, openInTab, parsePatterns, railCapacity, railHeights, railRowsOf, railWidth, railsOf, readCache, renderMarkdown, reposInSections, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, sectionShedOf, signatureOf, stripGlyph, stripLayout, stripSignature, toCiStatusState, trailingColumnsOf, truncate, useActionMenu, useChrome, windowCount, withHeaders, withoutItem, workCount, writeCache };
+export { type Action, type ActionGroup, ActionMenu, App, COLS, type ChromeHints, type ChromeSpec, type ChromeState, CiStatusLine, type CiStatusState, type Command, CommentsPanel, type CommentsPanelProps, type DetailContext, type ExplainSection, type ExtensionTarget, HealthPanel, type HealthPanelProps, type InboxBudget, type InboxExtension, type JiraAvailableTransition, type JiraTransition, type JiraTransitionsFor, type LiveLabel, LookupMiss, MIN_SIDEBAR_COLS, type MenuGap, type MenuRow, PrRow, type PrRowProps, type Rails, type RepoFilter, type RowAnnouncement, type RowMotion, SIDEBAR_COLS, type SettledResult, SidePanel, type Sidebar, type SidebarRow, type StatusStrip, StatusStripLine, type StripItem, type StripState, type StripStatusState, type TrailingColumns, type TrailingShed, ageLabel, budgetNotice, buildActions, buildCheckoutCmd, clipboard, counts, drillCmd, explainGhAction, explainItem, fitCount, gapsAbove, healthColor, healthDisplay, healthGlyph, healthLegend, isMenuGap, itermRun, jumpToRepo, jumpToRepoPane, matchesFilter, maxViewStart, menuRowsOf, menuTone, moveCursor, numberColumnsOf, openInTab, parsePatterns, railCapacity, railHeights, railRowsOf, railWidth, railsOf, readCache, renderMarkdown, reposInSections, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, sectionShedOf, signatureOf, stripGlyph, stripLayout, stripSignature, toCiStatusState, trailingColumnsOf, truncate, useActionMenu, useChrome, windowCount, withHeaders, withoutItem, workCount, writeCache };

package/dist/index.js

@@ -1,9 +1,9 @@
 import React2, { createContext, useState, useRef, useContext, useEffect, useCallback, useMemo } from 'react';
 import { useWindowSize, useInput, Text, Box } from 'ink';
 import { colors, ScrollView, TextInput, Pill, getIconMode, FooterHints, useAppKeys, LoadingScreen, StatusMessage, useFilterMode, useListCursor, CommandPalette, Tabs, ProgressBar, pillWidth } from '@kud/ink-ui';
-import { isPassCheck, isFailCheck, isInconclusiveCheck, resolveThread, unresolveThread, replyToThread, rerunFailedRun, mergePr, reRequestReviewer } from '@kud/gh';
+import { isPassCheck, isFailCheck, isInconclusiveCheck, resolveThread, unresolveThread, replyToThread, rerunFailedRun, mergePr, reRequestReviewer, parseRef, formatRef, fetchItemNode } from '@kud/gh';
 import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
-import { PIN_MARK, sizeOf, sizePartsOf, depthOf, impliedLabels, labelPriority, checkoutDirs, profileOf, inboxConfig, relativeTime, filterBySearch, filterByRepos, filterByOrigin } from '@kud/gh-workflow';
+import { PIN_MARK, sizeOf, sizePartsOf, depthOf, impliedLabels, labelPriority, checkoutDirs, profileOf, inboxConfig, relativeTime, filterBySearch, filterByRepos, filterByOrigin, refCandidates, resolveRef } from '@kud/gh-workflow';
 export { NEEDS_YOU_SECTION, PIN_MARK, bandOf, checkoutDirs, configureInbox, filterByOrigin, filterByRepos, filterBySearch, impliedLabels, inboxConfig, insertRepoHeaders, labelPriority, layoutGHItems, profileOf, relativeTime, repoPriority, resetInboxConfig, sortByRecency, sortItems, whoseMove } from '@kud/gh-workflow';
 import { $ } from 'zx';
 import { spawn } from 'child_process';
@@ -1194,6 +1194,189 @@ var useChrome = (spec) => {
   }, [setChrome, scope, hintsKey]);
   return chrome !== null;
 };
+var LookupMiss = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "LookupMiss";
+  }
+};
+var isGH = (item) => item.kind === "pr" || item.kind === "issue";
+var listedAt = (sections, repo, number) => {
+  const want = repo.toLowerCase();
+  for (const section of sections)
+    for (const item of section.items)
+      if (isGH(item) && item.number === number && item.repo.toLowerCase() === want)
+        return item;
+  return void 0;
+};
+var listedCopy = (sections, item) => {
+  if (isGH(item)) return listedAt(sections, item.repo, item.number);
+  const url = "url" in item ? item.url : void 0;
+  if (!url) return void 0;
+  for (const section of sections)
+    for (const row of section.items)
+      if (row.kind === item.kind && "url" in row && row.url === url) return row;
+  return void 0;
+};
+var settle = (sections, item) => listedCopy(sections, item) ?? (isGH(item) ? { ...item, notInInbox: true } : item);
+var githubClaim = (query, { activeRepo, repos, sections }) => {
+  const ref = parseRef(query);
+  if (!ref) return null;
+  const near = ref.repo ? listedAt(sections, ref.repo, ref.number) : activeRepo ? listedAt(sections, activeRepo, ref.number) : void 0;
+  const label = near ? `${near.repo}#${near.number}` : formatRef(ref);
+  const repo = ref.repo ?? refCandidates(activeRepo, repos)[0];
+  const text = query.trim();
+  const browserUrl = near?.url ?? (/^https?:/i.test(text) ? text : repo ? `https://github.com/${repo}/issues/${ref.number}` : void 0);
+  return {
+    label,
+    browser: browserUrl ? {
+      label: near || !repo ? label : `${repo}#${ref.number}`,
+      url: browserUrl
+    } : void 0,
+    fetch: async () => {
+      if (near) return near;
+      const item = await resolveRef(text, {
+        fetchNode: (r, n) => fetchItemNode(r, n),
+        activeRepo,
+        repos
+      });
+      if (!item) throw new LookupMiss(`nothing matches "${label}"`);
+      return item;
+    }
+  };
+};
+var claimFor = (query, context, extensions = []) => {
+  if (!query.trim()) return null;
+  const github = githubClaim(query, context);
+  if (github) return github;
+  for (const ext of extensions) {
+    const fetch = ext.resolve?.(query);
+    if (fetch) return { label: query.trim(), fetch };
+  }
+  return null;
+};
+var reasonOf = (error) => {
+  const e = error;
+  const text = typeof e?.stderr === "string" && e.stderr.trim() || typeof e?.message === "string" && e.message || String(error);
+  const line = text.split("\n").find((l) => l.trim()) ?? text;
+  return line.replace(/^gh:\s*/, "").trim();
+};
+var useLauncherLookup = (palette, open) => {
+  const [lookup, setLookup] = useState(null);
+  const seq = useRef(0);
+  const latest = useRef({ palette, open });
+  latest.current = { palette, open };
+  const start = (query, claim) => {
+    const id = ++seq.current;
+    const live = () => id === seq.current && latest.current.palette === query;
+    setLookup({ query, phase: "loading", label: claim.label });
+    claim.fetch().then(
+      (item) => {
+        if (!live()) return;
+        setLookup(null);
+        if (!latest.current.open(item))
+          setLookup({
+            query,
+            phase: "failed",
+            label: claim.label,
+            message: `nothing here can open ${claim.label}`
+          });
+      },
+      (error) => {
+        if (!live()) return;
+        setLookup(
+          error instanceof LookupMiss ? {
+            query,
+            phase: "missed",
+            label: claim.label,
+            message: error.message
+          } : {
+            query,
+            phase: "failed",
+            label: claim.label,
+            message: reasonOf(error)
+          }
+        );
+      }
+    );
+  };
+  const reset = () => {
+    seq.current++;
+    setLookup(null);
+  };
+  return {
+    lookup: lookup && lookup.query === palette ? lookup : null,
+    start,
+    reset
+  };
+};
+var lookupRows = (claim, lookup, query, start, openUrl) => {
+  const ref = (s) => /* @__PURE__ */ jsx(Text3, { color: colors.accent, children: s });
+  if (lookup?.phase === "loading")
+    return {
+      exclusive: true,
+      rows: [
+        {
+          id: "launcher:lookup",
+          title: `Looking up ${claim.label}\u2026`,
+          label: /* @__PURE__ */ jsxs(Text3, { dimColor: true, children: [
+            "Looking up ",
+            ref(claim.label),
+            "\u2026"
+          ] }),
+          run: () => {
+          },
+          keepOpen: true
+        }
+      ]
+    };
+  if (lookup?.phase === "missed")
+    return { exclusive: true, rows: [], message: lookup.message };
+  if (lookup?.phase === "failed")
+    return {
+      exclusive: true,
+      rows: [
+        {
+          id: "launcher:retry",
+          title: `Couldn't look up ${claim.label}: ${lookup.message}`,
+          label: /* @__PURE__ */ jsxs(Text3, { color: colors.error, children: [
+            "\u2717 couldn't look up ",
+            claim.label,
+            " \xB7 ",
+            lookup.message
+          ] }),
+          run: () => start(query, claim),
+          keepOpen: true
+        }
+      ]
+    };
+  const rows = [
+    {
+      id: "launcher:open",
+      title: `\u21B5 opens ${claim.label}`,
+      label: /* @__PURE__ */ jsxs(Text3, { children: [
+        "\u21B5 opens ",
+        ref(claim.label)
+      ] }),
+      run: () => start(query, claim),
+      keepOpen: true
+    }
+  ];
+  const browser = claim.browser;
+  if (browser)
+    rows.push({
+      id: "launcher:browser",
+      title: `Open ${browser.label} in browser`,
+      label: /* @__PURE__ */ jsxs(Text3, { children: [
+        "Open ",
+        ref(browser.label),
+        " ",
+        /* @__PURE__ */ jsx(Text3, { color: colors.info, children: "in browser" })
+      ] }),
+      run: () => openUrl(browser.url, browser.label)
+    });
+  return { exclusive: false, rows };
+};
 
 // src/inbox/cache.ts
 var cacheTtlMs = () => inboxConfig().cacheTtlMs;
@@ -2011,7 +2194,7 @@ var ROW_MAX_COLS = 140;
 var OVERLAY_BG = "#22222e";
 var SELECTION_BG = "#16161f";
 var selectionBackground = (active, backdropped) => active && !backdropped ? SELECTION_BG : void 0;
-var TICKET_KEY_COLOUR = "#C792EA";
+var TICKET_KEY_COLOUR = "#FFCB6B";
 var taskKeyStyle = () => ({
   color: TICKET_KEY_COLOUR,
   bold: true
@@ -2970,9 +3153,9 @@ var HelpModal = ({
     ["u", "unsubscribe from this item"],
     ["x", "remove yourself as reviewer"],
     ...hasJira ? [
-      ["t", "Jira: move / open ticket"],
-      ["\u2303K", "launch \xB7 jump to a ticket by key"]
+      ["t", "Jira: move / open ticket"]
     ] : [],
+    ["\u2303K", "launch \xB7 open a ticket or PR by name"],
     ["/", "search"],
     ["f", "filter by repo"],
     ["r", "refresh"],
@@ -3861,9 +4044,10 @@ var BrowseScreen = ({
     ["\u2190\u2192", "tab"],
     ["\u21B5/d", "open"],
     ["m", "actions"],
-    // Only where Jira is configured: without it the launcher can only say
-    // so, and a footer key that opens an apology is a broken feature.
-    ...jiraBase ? [["\u2303K", "launch"]] : [],
+    // Always, now that the launcher opens a pasted PR or issue too. It was
+    // shown only where Jira was configured, when a ticket key was all it
+    // could take and without one it could only apologise.
+    ["\u2303K", "launch"],
     // Advertised only where it does something, and named for what it
     // shows rather than for the furniture: nobody wants "a sidebar".
     ...showRail ? [["\u21E5", railTitle]] : hasRail ? [["i", railTitle]] : [],
@@ -3877,10 +4061,16 @@ var BrowseScreen = ({
     typing: searchInput,
     nerd: getIconMode() === "nerd"
   });
+  const launcherLookup = useLauncherLookup(palette, (item) => {
+    if (!openDrillView(settle(localSections, item))) return false;
+    setPalette(null);
+    return true;
+  });
   const launcher = useMemo(() => {
     const run = /* @__PURE__ */ new Map();
+    const keepOpen = /* @__PURE__ */ new Set();
     if (palette === null)
-      return { items: [], run, message: void 0 };
+      return { items: [], run, keepOpen, message: void 0 };
     const query = palette.trim();
     const ticketKey = jiraKeyRe ? query.toUpperCase().match(jiraKeyRe)?.[0] : void 0;
     const commands = [];
@@ -3891,6 +4081,31 @@ var BrowseScreen = ({
       /* @__PURE__ */ jsx(Text3, { color: colors.info, children: where })
     ] });
     const labels = /* @__PURE__ */ new Map();
+    const claim = claimFor(
+      query,
+      {
+        activeRepo: activeItem?.kind === "pr" || activeItem?.kind === "issue" ? activeItem.repo : void 0,
+        repos: reposInSections(localSections),
+        sections: localSections
+      },
+      extensions
+    );
+    const claimed = claim ? lookupRows(
+      claim,
+      launcherLookup.lookup,
+      palette,
+      launcherLookup.start,
+      (url, label) => {
+        quietly`open ${url}`.catch(() => {
+        });
+        showFlash(`\u2197 Opened ${label} in browser`);
+      }
+    ) : void 0;
+    for (const row of claimed?.rows ?? []) {
+      commands.push({ id: row.id, title: row.title, run: row.run });
+      labels.set(row.id, row.label);
+      if (row.keepOpen) keepOpen.add(row.id);
+    }
     if (ticketKey && jiraBase) {
       const row = {
         kind: "task",
@@ -3926,16 +4141,26 @@ var BrowseScreen = ({
         commands.push({ ...command, id: `${ext.id}:${command.id}` });
       }
     }
+    if (claimed?.exclusive) commands.splice(claimed.rows.length);
     for (const command of commands) run.set(command.id, command.run);
-    const message = !jiraBase ? `Jira not configured${jiraSetupHint ? ` \xB7 ${jiraSetupHint}` : ""}` : query && !ticketKey ? `no ticket matches "${query}"` : void 0;
+    const message = claimed ? claimed.message : !jiraBase ? `Jira not configured${jiraSetupHint ? ` \xB7 ${jiraSetupHint}` : ""}` : query && !ticketKey ? `nothing matches "${query}"` : void 0;
     const items = commands.map((command) => ({
       id: command.id,
       title: command.title,
       group: command.group,
       label: labels.get(command.id)
     }));
-    return { items, run, message };
-  }, [palette, activeItem, extensions, jiraBase, jiraKeyRe, jiraSetupHint]);
+    return { items, run, keepOpen, message };
+  }, [
+    palette,
+    activeItem,
+    extensions,
+    jiraBase,
+    jiraKeyRe,
+    jiraSetupHint,
+    localSections,
+    launcherLookup.lookup
+  ]);
   const chrome = useContext(InboxChromeContext);
   const overlayOpen = overlayBody != null;
   const overlay = palette !== null ? /* @__PURE__ */ jsx(
@@ -3943,15 +4168,18 @@ var BrowseScreen = ({
     {
       items: launcher.items,
       query: palette,
-      onQueryChange: setPalette,
+      onQueryChange: (query) => {
+        launcherLookup.reset();
+        setPalette(query);
+      },
       onSelect: (id) => {
         const run = launcher.run.get(id);
-        setPalette(null);
+        if (!launcher.keepOpen.has(id)) setPalette(null);
         void run?.();
       },
       onClose: () => setPalette(null),
       message: launcher.message,
-      placeholder: "ticket key\u2026",
+      placeholder: "ticket, PR, owner/repo#N or URL\u2026",
       width: Math.min(60, Math.max(30, listCols - 2)),
       maxRows: Math.max(3, listHeight - 6),
       hints: [
@@ -4054,7 +4282,8 @@ var BrowseScreen = ({
                 s.id,
                 pulseSettled ? PULSE_SETTLED_FRAME : sparkFrame
               ),
-              markerColor: colors.accent
+              markerColor: colors.accent,
+              group: s.group
             }))
           }
         ) }),
@@ -4727,4 +4956,4 @@ var matchesFilter = (repo, filter) => {
 };
 var parsePatterns = (value) => value.split(",").map((p) => p.trim()).filter(Boolean);
 
-export { ActionMenu, App, COLS, CiStatusLine, CommentsPanel, HealthPanel, MIN_SIDEBAR_COLS, PrRow, SIDEBAR_COLS, SidePanel, StatusStripLine, ageLabel, budgetNotice, buildActions, buildCheckoutCmd, clipboard, counts, drillCmd, explainGhAction, explainItem, fitCount, gapsAbove, healthColor, healthDisplay, healthGlyph, healthLegend, isMenuGap, itermRun, jumpToRepo, jumpToRepoPane, matchesFilter, maxViewStart, menuRowsOf, menuTone, moveCursor, numberColumnsOf, openInTab, parsePatterns, railCapacity, railHeights, railRowsOf, railWidth, railsOf, readCache, renderMarkdown, reposInSections, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, sectionShedOf, signatureOf, stripGlyph, stripLayout, stripSignature, toCiStatusState, trailingColumnsOf, truncate, useActionMenu, useChrome, windowCount, withHeaders, withoutItem, workCount, writeCache };
+export { ActionMenu, App, COLS, CiStatusLine, CommentsPanel, HealthPanel, LookupMiss, MIN_SIDEBAR_COLS, PrRow, SIDEBAR_COLS, SidePanel, StatusStripLine, ageLabel, budgetNotice, buildActions, buildCheckoutCmd, clipboard, counts, drillCmd, explainGhAction, explainItem, fitCount, gapsAbove, healthColor, healthDisplay, healthGlyph, healthLegend, isMenuGap, itermRun, jumpToRepo, jumpToRepoPane, matchesFilter, maxViewStart, menuRowsOf, menuTone, moveCursor, numberColumnsOf, openInTab, parsePatterns, railCapacity, railHeights, railRowsOf, railWidth, railsOf, readCache, renderMarkdown, reposInSections, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, sectionShedOf, signatureOf, stripGlyph, stripLayout, stripSignature, toCiStatusState, trailingColumnsOf, truncate, useActionMenu, useChrome, windowCount, withHeaders, withoutItem, workCount, writeCache };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kud/gh-ink",
-  "version": "0.70.0",
+  "version": "0.72.0",
   "description": "Ink components for rendering GitHub PR review comments and health — controlled, presentation-only, built on @kud/ink-ui and fed by @kud/gh.",
   "type": "module",
   "main": "dist/index.js",
@@ -49,12 +49,12 @@
     "react": ">=19"
   },
   "dependencies": {
-    "@kud/gh": "0.20.0",
-    "@kud/gh-workflow": "0.14.1",
+    "@kud/gh": "0.21.0",
+    "@kud/gh-workflow": "0.16.0",
     "zx": "8.8.5"
   },
   "devDependencies": {
-    "@kud/ink-ui": "0.34.0",
+    "@kud/ink-ui": "0.35.0",
     "@types/node": "22.20.1",
     "@types/react": "19.2.17",
     "ink": "7.1.0",