@kud/gh-ink 0.73.0 → 0.75.0

package/README.md

@@ -61,6 +61,31 @@ codepoints; sibling host verbs should match them rather than invent neighbours:
 | Unsubscribe / Mute / Remove reviewer | U+F478 / U+F466 / U+F468 |
 | Close PR / and delete / issue  | U+F4DC / U+F48E / U+F41D |
 
+## Inbox focus slot and tab icons
+
+`App` draws one standing row directly above the tab strip for whatever the
+reader should look at next. The fetch result carries it as
+`focus?: FocusSlot | null`: absent means the host has no focus feature and no
+row is drawn; `null` means nothing to point at and draws the dim empty line.
+It rides the fetch (and the cache beside the rows) because it goes stale the
+same way they do.
+
+| Prop / field       | What                                                                                                |
+| ------------------ | --------------------------------------------------------------------------------------------------- |
+| `focusLabel`       | What to call the row (default `focus`). Passing this or `focusEmpty` reserves the row from first paint. |
+| `focusEmpty`       | The empty sentence, drawn dim after the label when focus comes back `null`.                         |
+| `FocusSlot`        | `label`, `ref` (a ticket key, or a PR-style `#427`), `title`, `reason`, optional `marker` (the host's priority glyph), `mark`/`markColor`/`refColor` overrides, and `target: { tab, url }`. |
+| `g`                | Jumps to `focus.target`: switches to that tab and lands the cursor on that row, opening a collapsed tail it is folded into. Listed in the `?` legend only while a focus is on screen. |
+
+A row whose url matches the target draws the mark in a fixed gutter between
+the tree glyph and the marker cell; every other row holds two blanks there, so
+the mark moves nothing sideways. Without a focus the rows draw what they
+always drew.
+
+Tabs take an optional `Section.icon`, passed through to ink-ui's
+`TabItem.icon`: one glyph naming the tab beside its label, which is also what
+an inactive tab folds down to when the strip does not fit its width.
+
 ## Development
 
 ```sh

package/dist/index.d.ts

@@ -179,6 +179,94 @@ declare const SidePanel: ({ sidebar, liveLabel, width, height, focused, cursor,
     cursor?: number;
 }) => React.JSX.Element;
 
+/**
+ * The one thing the reader should look at next, in the host's words.
+ *
+ * Data, not vocabulary: `label` is the host's word for the row ("focus"), but
+ * everything else arrived over the wire — which ticket, what it says, where it
+ * lives — and goes stale the same way the rows do. That is why it rides the
+ * fetch result (and the cache beside the rows) rather than arriving as props.
+ *
+ * `undefined` (the field absent) means the host has no focus feature and draws
+ * no row at all; `null` means there is one and it currently has nothing to
+ * point at, which draws the dim empty line. The distinction matters because a
+ * host that never wired the feature must keep byte-identical output, while a
+ * host whose feature came back empty still owes the reader one line saying so.
+ */
+type FocusSlot = {
+    /** The mark in front of the row, accent by default. */
+    mark?: string;
+    /** The mark's colour. Defaults to the accent. */
+    markColor?: string;
+    /** What the row is a slot OF, in the host's words: `focus`, say. */
+    label: string;
+    /** The thing to look at: a ticket key, or a PR-style `#427`. */
+    ref: string;
+    /** The ref's colour. A `#` ref takes the accent, anything else the ticket. */
+    refColor?: string;
+    /** The row's own title, bold. Truncated to keep the line to one row. */
+    title: string;
+    /** Why this is the focus, dim, three spaces after the title. */
+    reason: string;
+    /** The host's priority glyph for the row, drawn in the default foreground. */
+    marker?: string;
+    /** Where `g` goes: the tab id and the row url. */
+    target: {
+        tab: string;
+        url: string;
+    };
+};
+declare const FOCUS_MARK = "\uDB81\uDCFE";
+declare const DEFAULT_FOCUS_LABEL = "focus";
+declare const DEFAULT_FOCUS_EMPTY = "nothing to focus on";
+/**
+ * What one row draws in the focus gutter, resolved by the list. `undefined`
+ * means no focus is on screen and the row draws nothing — the branch is
+ * absent, not blank, so output without the feature is byte-identical. `null`
+ * holds two blank columns on a row the focus is not pointing at, so the one
+ * row that carries the mark does not shift its neighbours.
+ */
+type FocusGutter = {
+    mark: string;
+    color?: string;
+} | null;
+/**
+ * The gutter cell for a row url: the mark when this is the row `g` would land
+ * on, a blank holder on every other row while a focus is on screen, nothing at
+ * all without one. One function so the task rows and the PR rows cannot
+ * disagree about which row is marked.
+ */
+declare const focusCellFor: (focus: FocusSlot | null | undefined, url: string | undefined) => FocusGutter | undefined;
+/**
+ * The ref's colour, for the one decision the frame cannot show. A `#427` is a
+ * pull request and takes the accent — the same orange the PR rows number
+ * themselves in — while a ticket key takes the ticket yellow. An explicit
+ * `refColor` wins over both, for a host whose refs follow another vocabulary.
+ *
+ * Exported pure because the test frame carries no escape codes: a colour that
+ * lived only in a tint would be a colour nobody can test for.
+ */
+declare const focusRefColor: (focus: Pick<FocusSlot, "ref" | "refColor">) => string;
+/**
+ * One standing single-line row, the same height across loading / ready / empty
+ * so the tab strip below it never jumps — the same contract `StatusStripLine`
+ * keeps, and drawn in the same place, directly above the tabs.
+ *
+ * `undefined` while the first answer is out; `null` when the host answered
+ * with nothing to point at. Either prop (`label`/`empty`) reserves the row;
+ * with neither and no focus value the caller draws nothing at all.
+ */
+declare const FocusSlotLine: ({ focus, label, empty, width, }: {
+    /** `undefined` while the first answer is out; `null` when it came back empty. */
+    focus: FocusSlot | null | undefined;
+    /** What to call the row. The host's word; defaults to `focus`. */
+    label?: string;
+    /** The empty sentence, drawn dim after the label when focus is null. */
+    empty?: string;
+    /** Columns the row may use. */
+    width: number;
+}) => React.JSX.Element;
+
 /**
  * How this row is moving through the list right now.
  *
@@ -270,6 +358,15 @@ type PrRowProps = {
      * to the title rather than standing empty.
      */
     gutter?: boolean;
+    /**
+     * The focus gutter, resolved by the list — see `focusCellFor`. `undefined`
+     * draws nothing at all (no focus feature, byte-identical to before); `null`
+     * holds two blank columns so the marked row does not shift its neighbours;
+     * a mark draws the focus glyph there in its colour. A fixed cell either way,
+     * for the same reason the cursor gutter is one: a mark that moved the title
+     * of exactly the row being watched would defeat its own purpose.
+     */
+    focusCell?: FocusGutter;
 };
 /**
  * The trailing block, in reading order: whose, how contested, how big, how
@@ -313,7 +410,9 @@ declare const trailingColumnsOf: (items: readonly GHItem[]) => TrailingColumns;
  * three, and a six-digit number would have run straight into its title.
  */
 declare const numberColumnsOf: (items: readonly GHItem[]) => number;
-type LayoutInput = Pick<PrRowProps, "item" | "login" | "cols" | "prefix" | "uniformLabels" | "announcements" | "columns" | "shed" | "numberCols" | "gutter">;
+type LayoutInput = Pick<PrRowProps, "item" | "login" | "cols" | "prefix" | "uniformLabels" | "announcements" | "columns" | "shed" | "numberCols" | "gutter"> & {
+    focusGutter?: boolean;
+};
 /**
  * Which trailing columns the section has to give up, so that every row gives up
  * the same ones. Each row is laid out alone and the drops are unioned: if any
@@ -339,7 +438,7 @@ declare const sectionShedOf: (rows: readonly Pick<LayoutInput, "item" | "prefix"
  * arrival, merge and departure belongs to whoever owns the list, and reaches
  * the row as `icon`, `motion` and `announcements` after the decisions are made.
  */
-declare const PrRow: ({ item, active, login, cols, selectionBg, icon: iconOverride, prefix, uniformLabels, motion, announcements, columns, shed, numberCols, gutter, }: PrRowProps) => React.JSX.Element;
+declare const PrRow: ({ item, active, login, cols, selectionBg, icon: iconOverride, prefix, uniformLabels, motion, announcements, columns, shed, numberCols, gutter, focusCell, }: PrRowProps) => React.JSX.Element;
 
 /**
  * One state per thing, from a closed set the strip knows how to draw. The host
@@ -517,6 +616,16 @@ type CachedCockpit = {
      * refresh — `i` did nothing and the footer did not even offer it.
      */
     sidebar?: Rails;
+    /**
+     * The focus slot, when the host supplied one. Cached beside the rows because
+     * it is painted beside them: a launch that trusts the cache never refetches,
+     * so a focus left out of the file is a slot that stays on `loading…` until
+     * the next refresh — or never fills in at all.
+     *
+     * Absent reads as `undefined`: no focus feature, no row. `null` is a real
+     * answer ("nothing to focus on") and round-trips as one.
+     */
+    focus?: FocusSlot | null;
 };
 declare const readCache: (key: string) => CachedCockpit | null;
 declare const writeCache: (key: string, data: {
@@ -524,8 +633,30 @@ declare const writeCache: (key: string, data: {
     login: string;
     budget?: InboxBudget;
     sidebar?: Rails;
+    focus?: FocusSlot | null;
 }) => void;
 
+/**
+ * What an action did to a row, said before the server has agreed to it.
+ *
+ * Three shapes cover every action the inbox takes on a row: it leaves the list
+ * (close, done), it changes tab (a Jira move), or it changes in place (labels,
+ * assignee, read). A patch names the END STATE rather than the step that gets
+ * there, which is what lets it be reapplied on top of every fetch: "SHOP-1234
+ * belongs in review, wearing In Review" is as true on the third fetch as on the
+ * first, where "move it one tab right" would walk it off the board.
+ */
+type Patch = {
+    kind: "remove";
+} | {
+    kind: "move";
+    toSection: string;
+    fields?: Record<string, unknown>;
+} | {
+    kind: "mutate";
+    fields: Record<string, unknown>;
+};
+
 type DetailContext = {
     item: GHItem;
     kind: "pr" | "issue";
@@ -629,6 +760,25 @@ type TabForStatus = (to: {
     name: string;
     category?: string;
 }) => string | null;
+/**
+ * What a move hands back when the screen took it optimistically: the request's
+ * two possible answers, reported so the pending patch can stop showing `◌` or
+ * be marked failed. Absent when the move was not taken optimistically, and the
+ * caller falls back to its own flashes.
+ */
+type OptimisticHandle = {
+    settled: () => void;
+    failed: (err: unknown) => void;
+};
+/**
+ * A row action said ahead of the server: the end state it leaves the row in,
+ * and the verb the failure line names it by — `close` reads back as
+ * "Couldn't close #412".
+ */
+type OptimisticChange = {
+    patch: Patch;
+    action: string;
+};
 /**
  * Resolve the live transitions for a ticket, called lazily when its move
  * submenu opens — never at board fetch, where one call per visible ticket
@@ -766,6 +916,15 @@ declare const buildActions: (item: AnyItem, login: string, showFlash: (msg: stri
      * the settlement signal.
      */
     onSettled?: (item: GHItem, result: SettledResult) => void;
+    /**
+     * Take the row's action ahead of the server — see `OptimisticChange`. A
+     * handle back means the row is already where the action puts it, so the
+     * request's answer goes to the handle and a failure goes ONLY there: the
+     * failed patch has its own sticky line with `w` beside it, and a flash
+     * naming the same failure would be a second voice saying it less well.
+     * Absent, every action keeps the pessimistic shape it had.
+     */
+    optimistic?: (item: AnyItem, change: OptimisticChange) => OptimisticHandle | undefined;
     /**
      * Open the ticket's move submenu through the live-transitions hook. Passed
      * by the browse screen (which owns the menu the rows open into) only when
@@ -831,7 +990,7 @@ declare const ActionMenu: ({ item, actions, cursor, cols, }: {
     cols?: number;
 }) => React.JSX.Element;
 declare const signatureOf: (sections: Section[]) => string;
-declare const App: ({ fetcher, cacheKey, title, detailFor, origin, jiraBase, jiraKeyRe, jiraSetupHint, jiraTransitions, jiraTransitionsFor, tabForStatus, hasCiStatus, ciJob, ciFetcher, ciPollMs, stripFetcher, stripLabel, stripPollMs, watchPath, watchDebounceMs, watchJitterMs, extensions, tabHelp, emptyHint, liveLabel, onSettled, }: {
+declare const App: ({ fetcher, cacheKey, title, detailFor, origin, jiraBase, jiraKeyRe, jiraSetupHint, jiraTransitions, jiraTransitionsFor, tabForStatus, hasCiStatus, ciJob, ciFetcher, ciPollMs, stripFetcher, stripLabel, stripPollMs, focusLabel, focusEmpty, watchPath, watchDebounceMs, watchJitterMs, extensions, tabHelp, emptyHint, liveLabel, onSettled, }: {
     fetcher: () => Promise<{
         sections: Section[];
         login: string;
@@ -852,6 +1011,15 @@ declare const App: ({ fetcher, cacheKey, title, detailFor, origin, jiraBase, jir
          * data that goes stale the same way the rows do.
          */
         sidebar?: Rails;
+        /**
+         * What the reader should look at next, in the host's words — see
+         * `FocusSlot`. Part of the fetch result for the same reason the rail is:
+         * it goes stale with the rows, and the cache paints it beside them.
+         *
+         * Absent means the host has no focus feature and no row is drawn; `null`
+         * means nothing to point at and draws the dim empty line.
+         */
+        focus?: FocusSlot | null;
     }>;
     cacheKey?: string;
     /**
@@ -894,6 +1062,16 @@ declare const App: ({ fetcher, cacheKey, title, detailFor, origin, jiraBase, jir
     /** What to call the row before its first answer arrives with a title. */
     stripLabel?: string;
     stripPollMs?: number;
+    /**
+     * What to call the focus row. Passing this (or `focusEmpty`) reserves the
+     * row from the first paint — `loading…` until the fetch lands — while a
+     * host that never wires the feature passes neither and draws nothing.
+     * Vocabulary, not data: it never goes stale, so it is a prop rather than
+     * part of the fetch result.
+     */
+    focusLabel?: string;
+    /** The empty sentence, drawn dim after the label when focus comes back null. */
+    focusEmpty?: string;
     /**
      * A file something else touches when it has changed GitHub on your behalf —
      * a Claude session closing an issue, a script merging a PR. Touching it makes
@@ -946,4 +1124,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, 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 TabForStatus, 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, DEFAULT_FOCUS_EMPTY, DEFAULT_FOCUS_LABEL, type DetailContext, type ExplainSection, type ExtensionTarget, FOCUS_MARK, type FocusGutter, type FocusSlot, FocusSlotLine, 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 TabForStatus, type TrailingColumns, type TrailingShed, ageLabel, budgetNotice, buildActions, buildCheckoutCmd, clipboard, counts, drillCmd, explainGhAction, explainItem, fitCount, focusCellFor, focusRefColor, 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

@@ -876,7 +876,8 @@ var layoutOf = ({
   columns,
   shed = {},
   numberCols,
-  gutter = true
+  gutter = true,
+  focusGutter = false
 }) => {
   const numCols = numberCols ?? numberColumnsOf([item]);
   const numStr = `#${item.number}`.padEnd(numCols);
@@ -923,7 +924,7 @@ var layoutOf = ({
     );
     const pills = announcements.reduce((w, a) => w + 2 + a.label.length, 0);
     const cell = labelCell();
-    return (gutter ? 2 : 0) + prefix.length + 2 + 2 + numCols + (cell ? 2 + cell.length + 1 : 0) + (givingUp.repo ? 0 : repoLabel.length) + block + pills + pillCaps + 4;
+    return (gutter ? 2 : 0) + prefix.length + (focusGutter ? 2 : 0) + 2 + 2 + numCols + (cell ? 2 + cell.length + 1 : 0) + (givingUp.repo ? 0 : repoLabel.length) + block + pills + pillCaps + 4;
   };
   const MIN_TITLE = 24;
   for (const give of [
@@ -969,7 +970,8 @@ var PrRow = ({
   columns,
   shed,
   numberCols,
-  gutter = true
+  gutter = true,
+  focusCell
 }) => {
   const backdropped = useBackdropped();
   const { glyph: healthIcon, color: healthColor2 } = displayFor(item.health);
@@ -1002,7 +1004,8 @@ var PrRow = ({
     columns,
     shed,
     numberCols,
-    gutter
+    gutter,
+    focusGutter: focusCell !== void 0
   });
   return (
     // The wash paints every cell of the fixed-width row — an Ink Box's
@@ -1010,6 +1013,7 @@ var PrRow = ({
     /* @__PURE__ */ jsxs(Box, { width: cols, backgroundColor: selectionBg, children: [
       gutter ? /* @__PURE__ */ jsx(Text3, { color: colors.info, children: active ? "\u276F " : "  " }) : null,
       /* @__PURE__ */ jsx(Text3, { dimColor: true, children: prefix }),
+      focusCell !== void 0 ? focusCell ? /* @__PURE__ */ jsx(Text3, { color: focusCell.color, bold: true, children: `${focusCell.mark} ` }) : /* @__PURE__ */ jsx(Text3, { children: "  " }) : null,
       /* @__PURE__ */ jsx(Text3, { color, bold: true, children: icon + " " }),
       /* @__PURE__ */ jsx(Text3, { color: turnColor, bold: turnIcon === "\u2190", children: turnIcon + " " }),
       /* @__PURE__ */ jsx(Text3, { color: colors.accent, children: numStr }),
@@ -1054,9 +1058,9 @@ var PrRow = ({
           justifyContent: "flex-end",
           flexShrink: 0,
           children: sizeParts ? /* @__PURE__ */ jsxs(Text3, { children: [
-            /* @__PURE__ */ jsx(Text3, { color: colors.success, children: sizeParts.added }),
+            /* @__PURE__ */ jsx(Text3, { color: colors.added, children: sizeParts.added }),
             " ",
-            /* @__PURE__ */ jsx(Text3, { color: colors.error, children: sizeParts.removed })
+            /* @__PURE__ */ jsx(Text3, { color: colors.removed, children: sizeParts.removed })
           ] }) : null
         }
       ) : null,
@@ -1335,20 +1339,12 @@ var lookupRows = (claim, lookup, query, start, openUrl) => {
   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
-        }
-      ]
+      rows: [],
+      message: {
+        text: `couldn't look up ${claim.label} \xB7 ${lookup.message} \xB7 \u21B5 retry`,
+        tone: "error",
+        onSubmit: () => start(query, claim)
+      }
     };
   const rows = [
     {
@@ -1380,7 +1376,7 @@ var lookupRows = (claim, lookup, query, start, openUrl) => {
 
 // src/inbox/cache.ts
 var cacheTtlMs = () => inboxConfig().cacheTtlMs;
-var CACHE_VERSION = 5;
+var CACHE_VERSION = 6;
 var cacheDir = () => join(
   process.env.XDG_CACHE_HOME || join(homedir(), ".cache"),
   inboxConfig().cacheNamespace
@@ -1391,11 +1387,14 @@ var readCache = (key) => {
     const raw = JSON.parse(readFileSync(cacheFile(key), "utf8"));
     if (raw?.version !== CACHE_VERSION) return null;
     if (!Array.isArray(raw?.sections)) return null;
+    const focusOk = raw.focus === void 0 || raw.focus === null || typeof raw.focus?.target?.tab === "string" && typeof raw.focus?.target?.url === "string";
+    if (!focusOk) return null;
     return {
       sections: raw.sections,
       login: raw.login ?? "",
       at: raw.at ?? 0,
       budget: raw.budget,
+      ...raw.focus !== void 0 ? { focus: raw.focus } : {},
       ...railsOf(raw.sidebar).every((s) => Array.isArray(s?.rows)) && raw.sidebar !== void 0 ? { sidebar: raw.sidebar } : {}
     };
   } catch {
@@ -1694,8 +1693,59 @@ var failureNotice = (failed) => {
   const more = failed.length > 1 ? `  +${failed.length - 1} more` : "";
   return `\u2717 Couldn't ${newest.action} ${newest.label}: ${newest.failure?.reason ?? "no reason reported"}${more}  w restore`;
 };
+var FOCUS_MARK = "\u{F04FE}";
+var DEFAULT_FOCUS_LABEL = "focus";
+var DEFAULT_FOCUS_EMPTY = "nothing to focus on";
+var focusCellFor = (focus, url) => {
+  if (focus === void 0) return void 0;
+  if (!focus || url !== focus.target.url) return null;
+  return { mark: focus.mark ?? FOCUS_MARK, color: focus.markColor ?? colors.accent };
+};
+var focusRefColor = (focus) => focus.refColor ?? (focus.ref.startsWith("#") ? colors.accent : colors.ticket);
+var cells = (s) => [...s].length;
+var titleBudgetOf = (focus, label, width) => {
+  const mark = focus.mark ?? FOCUS_MARK;
+  const head = 2 + cells(mark) + 1 + cells(label) + 2 + (focus.marker ? cells(focus.marker) + 1 : 0) + cells(focus.ref) + 2;
+  const tail = 3 + cells(focus.reason);
+  const titleMax = width - head - tail;
+  if (titleMax >= 1)
+    return { title: truncate(focus.title, titleMax), reason: focus.reason };
+  return {
+    title: "",
+    reason: truncate(focus.reason, Math.max(0, width - head - 3 - 1))
+  };
+};
+var FocusSlotLine = ({
+  focus,
+  label = DEFAULT_FOCUS_LABEL,
+  empty = DEFAULT_FOCUS_EMPTY,
+  width
+}) => {
+  if (focus === void 0)
+    return /* @__PURE__ */ jsxs(Box, { marginBottom: 1, children: [
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: "  \xB7 " }),
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: `${label}  loading\u2026` })
+    ] });
+  if (focus === null)
+    return /* @__PURE__ */ jsxs(Box, { marginBottom: 1, children: [
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  ${FOCUS_MARK} ` }),
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: `${label}  ${empty}` })
+    ] });
+  const mark = focus.mark ?? FOCUS_MARK;
+  const { title, reason } = titleBudgetOf(focus, label, width);
+  return /* @__PURE__ */ jsxs(Box, { marginBottom: 1, children: [
+    /* @__PURE__ */ jsx(Text, { children: "  " }),
+    /* @__PURE__ */ jsx(Text, { color: focus.markColor ?? colors.accent, bold: true, children: `${mark} ` }),
+    /* @__PURE__ */ jsx(Text, { dimColor: true, children: `${label}  ` }),
+    focus.marker ? /* @__PURE__ */ jsx(Text, { children: `${focus.marker} ` }) : null,
+    /* @__PURE__ */ jsx(Text, { color: focusRefColor(focus), bold: true, children: `${focus.ref}  ` }),
+    /* @__PURE__ */ jsx(Text, { bold: true, children: title }),
+    /* @__PURE__ */ jsx(Text, { dimColor: true, children: `   ${reason}` })
+  ] });
+};
 var quietly = $({ quiet: true });
 var isMenuGap = (row) => "gap" in row;
+var rowLabelOf = (item) => item.kind === "task" ? item.ticket ?? item.key : item.kind === "pr" || item.kind === "issue" ? `#${item.number}` : "";
 var jiraMovesCache = /* @__PURE__ */ new Map();
 var cachedJiraMoves = (ticket, status) => {
   const entry = jiraMovesCache.get(ticket);
@@ -2297,6 +2347,19 @@ var workCount = (s) => {
   }
   return n;
 };
+var countedSections = (sections, departing) => {
+  if (!departing?.size) return sections;
+  const sent = new Set(sections.map((s) => s.id));
+  return sections.map((s) => {
+    const items = s.items.filter((item) => {
+      const key = keyOf(item);
+      if (!key || !departing.has(key)) return true;
+      const to = departing.get(key);
+      return to != null && (to === s.id || !sent.has(to));
+    });
+    return items.length === s.items.length ? s : { ...s, items };
+  });
+};
 var drillCmd = (item) => {
   if (item.kind === "task")
     return item.ticket ? `jira issue view ${item.ticket}` : null;
@@ -2360,6 +2423,7 @@ var openInJira = (jiraBase, key, showFlash) => {
   });
   showFlash(`\u2197 Opened ${key} in Jira`);
 };
+var REMOVE_ME_AS_REVIEWER = "Remove me as reviewer";
 var buildActions = (item, login, showFlash, jiraBase, jiraKeyRe, jiraTransitions, onRefresh, onRemove, onOpenView, ext) => {
   if (item.kind === "repo-header" || item.kind === "subgroup-header" || item.kind === "show-more" || item.kind === "show-less")
     return [];
@@ -2464,6 +2528,32 @@ var buildActions = (item, login, showFlash, jiraBase, jiraKeyRe, jiraTransitions
   }
   const actions = drillAction ? [drillAction, open, copyUrl] : [open, copyUrl];
   const closing = [];
+  const removeAhead = (opts) => {
+    const row = item;
+    const held = ext?.optimistic?.(row, {
+      patch: { kind: "remove" },
+      action: opts.action
+    });
+    onRemove?.(row);
+    showFlash(opts.taking);
+    void opts.request().then(
+      () => {
+        held?.settled();
+        if (opts.done) showFlash(opts.done);
+        if (held || opts.refreshes) ext?.onActed?.();
+        if (opts.settles) ext?.onSettled?.(row, { ok: true });
+      },
+      (e) => {
+        if (held) held.failed(e);
+        else {
+          showFlash(opts.refused(e));
+          onRefresh?.();
+        }
+        if (opts.settles)
+          ext?.onSettled?.(row, { ok: false, reason: firstLine(e) });
+      }
+    );
+  };
   actions.push({
     label: "Copy repo name",
     hint: "r",
@@ -2486,7 +2576,7 @@ var buildActions = (item, login, showFlash, jiraBase, jiraKeyRe, jiraTransitions
   });
   if (item.kind === "pr" && item.standing === "queued" && login) {
     actions.push({
-      label: "Remove me as reviewer",
+      label: REMOVE_ME_AS_REVIEWER,
       hint: "x",
       // Quiet, beside Unsubscribe: both are "less of this PR for me" — no more
       // review requests, no more notifications. Guarded by the caller's own
@@ -2494,25 +2584,17 @@ var buildActions = (item, login, showFlash, jiraBase, jiraKeyRe, jiraTransitions
       // review request there is no such row, and none is invented here.
       group: "quiet",
       icon: "\uF468",
-      run: () => {
-        onRemove?.(item);
-        showFlash(`\u22EF Removing you from #${item.number}\u2026`);
-        void quietly`gh pr edit ${item.number} --repo ${item.repo} --remove-reviewer ${login}`.then(
-          () => {
-            showFlash(`\u2713 Removed you as reviewer on #${item.number}`);
-            ext?.onActed?.();
-            ext?.onSettled?.(item, { ok: true });
-          },
-          (e) => {
-            showFlash(`\u2717 #${item.number}: ${explainGhAction(e)}`);
-            onRefresh?.();
-            ext?.onSettled?.(item, {
-              ok: false,
-              reason: firstLine(e)
-            });
-          }
-        );
-      }
+      // Optimistic, the same shape Close uses. A row that lingers for a round
+      // trip reads as a broken keypress.
+      run: () => removeAhead({
+        action: "remove you from",
+        request: () => quietly`gh pr edit ${item.number} --repo ${item.repo} --remove-reviewer ${login}`,
+        taking: `\u22EF Removing you from #${item.number}\u2026`,
+        done: `\u2713 Removed you as reviewer on #${item.number}`,
+        refused: (e) => `\u2717 #${item.number}: ${explainGhAction(e)}`,
+        settles: true,
+        refreshes: true
+      })
     });
   }
   if (item.kind === "pr" && item.branch) {
@@ -2584,23 +2666,13 @@ var buildActions = (item, login, showFlash, jiraBase, jiraKeyRe, jiraTransitions
           label: `Close #${item.number}`,
           hint: "",
           group: "confirm",
-          run: () => {
-            onRemove?.(item);
-            showFlash(`\u2713 Closed #${item.number}`);
-            void quietly`gh issue close ${item.number} --repo ${item.repo}`.then(
-              () => {
-                ext?.onSettled?.(item, { ok: true });
-              },
-              (e) => {
-                showFlash(`\u2717 Close failed \u2014 restoring #${item.number}`);
-                onRefresh?.();
-                ext?.onSettled?.(item, {
-                  ok: false,
-                  reason: firstLine(e)
-                });
-              }
-            );
-          }
+          run: () => removeAhead({
+            action: "close",
+            request: () => quietly`gh issue close ${item.number} --repo ${item.repo}`,
+            taking: `\u2713 Closed #${item.number}`,
+            refused: () => `\u2717 Close failed \u2014 restoring #${item.number}`,
+            settles: true
+          })
         },
         { label: "Cancel", hint: "", group: "confirm", run: () => {
         } }
@@ -2651,23 +2723,13 @@ var buildActions = (item, login, showFlash, jiraBase, jiraKeyRe, jiraTransitions
           label: `Close #${item.number}`,
           hint: "",
           group: "confirm",
-          run: () => {
-            onRemove?.(item);
-            showFlash(`\u2713 Closed #${item.number}`);
-            void quietly`gh pr close ${item.number} --repo ${item.repo}`.then(
-              () => {
-                ext?.onSettled?.(item, { ok: true });
-              },
-              (e) => {
-                showFlash(`\u2717 Close failed \u2014 restoring #${item.number}`);
-                onRefresh?.();
-                ext?.onSettled?.(item, {
-                  ok: false,
-                  reason: firstLine(e)
-                });
-              }
-            );
-          }
+          run: () => removeAhead({
+            action: "close",
+            request: () => quietly`gh pr close ${item.number} --repo ${item.repo}`,
+            taking: `\u2713 Closed #${item.number}`,
+            refused: () => `\u2717 Close failed \u2014 restoring #${item.number}`,
+            settles: true
+          })
         },
         { label: "Cancel", hint: "", group: "confirm", run: () => {
         } }
@@ -2688,16 +2750,23 @@ var buildActions = (item, login, showFlash, jiraBase, jiraKeyRe, jiraTransitions
             label: `Close #${item.number} and delete ${item.branch}`,
             hint: "",
             group: "confirm",
-            run: () => {
-              onRemove?.(item);
-              showFlash(`\u2713 Closed #${item.number} and deleted ${item.branch}`);
-              void quietly`gh pr close ${item.number} --repo ${item.repo}`.then(
-                () => quietly`gh api -X DELETE ${`repos/${item.repo}/git/refs/heads/${item.branch}`}`
-              ).catch(() => {
-                showFlash(`\u2717 Close + delete failed \u2014 restoring`);
-                onRefresh?.();
-              });
-            }
+            // The patch covers the close and nothing else. A branch that will
+            // not delete leaves a PR that IS closed, so reporting "Couldn't
+            // close #412" and offering `w` would restore a row the server no
+            // longer has; the branch gets its own flash instead.
+            run: () => removeAhead({
+              action: "close",
+              request: async () => {
+                await quietly`gh pr close ${item.number} --repo ${item.repo}`;
+                void quietly`gh api -X DELETE ${`repos/${item.repo}/git/refs/heads/${item.branch}`}`.catch(
+                  () => showFlash(
+                    `\u2717 Closed #${item.number}, but couldn't delete ${item.branch}`
+                  )
+                );
+              },
+              taking: `\u2713 Closed #${item.number} and deleted ${item.branch}`,
+              refused: () => `\u2717 Close + delete failed \u2014 restoring`
+            })
           },
           { label: "Cancel", hint: "", group: "confirm", run: () => {
           } }
@@ -2899,7 +2968,8 @@ var ItemRow = ({
   uniformLabels = [],
   columns,
   shed,
-  numberCols
+  numberCols,
+  focus
 }) => {
   const backdropped = useBackdropped();
   const selBg = selectionBackground(active, backdropped);
@@ -2943,12 +3013,16 @@ var ItemRow = ({
     const transitIcon = pending ? PENDING_GLYPH : !transient ? " " : isDeparture(transient) ? TRANSIT_OUT_FRAMES[rampAt(TRANSIT_OUT_FRAMES.length)] : isArrival(transient) ? TRANSIT_IN_FRAMES[rampAt(TRANSIT_IN_FRAMES.length)] : "\u25C9";
     const titleMax = Math.max(
       1,
-      cols - item.key.length - note.length - (item.pill ? pillWidth(item.pill) + 1 : 0) - (farewellLabel ? pillWidth(farewellLabel) + 2 : 0) - prefix.length - (markerCols > 0 ? markerCols + 1 : 0) - 12
+      cols - item.key.length - note.length - (item.pill ? pillWidth(item.pill) + 1 : 0) - (farewellLabel ? pillWidth(farewellLabel) + 2 : 0) - prefix.length - (markerCols > 0 ? markerCols + 1 : 0) - // The focus gutter, priced only when it is drawn: two columns on every
+      // url-bearing row while a focus is on screen, none at all without one.
+      (focus !== void 0 ? 2 : 0) - 12
     );
+    const focusCell = focusCellFor(focus, item.url);
     return /* @__PURE__ */ jsxs(Box, { marginTop: gap ? 1 : 0, width: cols, backgroundColor: selBg, children: [
       /* @__PURE__ */ jsx(Text3, { color: colors.info, children: active ? "\u276F " : "  " }),
       /* @__PURE__ */ jsx(Text3, { dimColor: true, children: prefix }),
       /* @__PURE__ */ jsx(Text3, { dimColor: true, children: parent ? "\u252C " : "  " }),
+      focusCell !== void 0 ? focusCell ? /* @__PURE__ */ jsx(Text3, { color: focusCell.color, bold: true, children: `${focusCell.mark} ` }) : /* @__PURE__ */ jsx(Text3, { children: "  " }) : null,
       pending ? /* @__PURE__ */ jsx(Text3, { dimColor: true, children: transitIcon + " " }) : /* @__PURE__ */ jsx(Text3, { bold: true, color: transient ? TRANSIT_COLOUR[transient] : void 0, children: transitIcon + " " }),
       markerCols > 0 ? /* @__PURE__ */ jsx(Text3, { color: item.markerColor, children: (item.marker ?? "").padEnd(markerCols) + " " }) : null,
       /* @__PURE__ */ jsx(Text3, { ...taskKeyStyle(), children: item.key + "  " }),
@@ -2983,7 +3057,7 @@ var ItemRow = ({
   const icon = merged ? {
     glyph: MERGED_FRAMES[sparkFrame % MERGED_FRAMES.length],
     color: MERGED_COLOUR
-  } : transient ? {
+  } : pending ? { glyph: PENDING_GLYPH, color: colors.muted } : transient ? {
     glyph: isDeparture(transient) ? TRANSIT_OUT_FRAMES[rampAt(TRANSIT_OUT_FRAMES.length)] : isArrival(transient) ? TRANSIT_IN_FRAMES[rampAt(TRANSIT_IN_FRAMES.length)] : displayFor(item.health).glyph,
     color: TRANSIT_COLOUR[transient]
   } : void 0;
@@ -3007,7 +3081,11 @@ var ItemRow = ({
       numberCols,
       icon,
       motion,
-      announcements
+      announcements,
+      focusCell: focusCellFor(
+        focus,
+        "url" in item ? item.url : void 0
+      )
     }
   );
 };
@@ -3043,17 +3121,18 @@ var useActionMenu = () => {
   };
   const handleKey = (key) => {
     if (!actions) return false;
+    const live = (n) => n >= 0 && n < actions.length && !isMenuGap(actions[n]);
     if (key.upArrow)
       setCursor((c) => {
         let n = c - 1;
         while (n > 0 && isMenuGap(actions[n])) n -= 1;
-        return isMenuGap(actions[n]) ? c : n;
+        return live(n) ? n : c;
       });
     if (key.downArrow)
       setCursor((c) => {
         let n = c + 1;
         while (n < actions.length - 1 && isMenuGap(actions[n])) n += 1;
-        return isMenuGap(actions[n]) ? c : n;
+        return live(n) ? n : c;
       });
     if (key.return) {
       const row = actions[cursor];
@@ -3210,6 +3289,7 @@ var LEGEND_FOOTNOTE = "Each item lands in the FIRST tab that claims it, so count
 var HelpModal = ({
   extensions,
   hasJira,
+  hasFocus,
   tabHelp,
   maxRows,
   scroll = 0,
@@ -3244,6 +3324,7 @@ var HelpModal = ({
     ["f", "filter by repo"],
     ["r", "refresh"],
     ["w", "restore a change that failed"],
+    ...hasFocus ? [["g", "jump to focus"]] : [],
     ...extensionLegend(extensions),
     ["?", "this help"],
     ["q", "quit"]
@@ -3439,6 +3520,9 @@ var BrowseScreen = ({
   ciJob,
   stripState,
   stripLabel,
+  focus,
+  focusLabel,
+  focusEmpty,
   tabHelp,
   origin,
   budget,
@@ -3453,6 +3537,8 @@ var BrowseScreen = ({
   sidebar,
   liveLabel,
   optimisticMove,
+  optimistic,
+  departing,
   pendingKeys,
   failure,
   onRestore
@@ -3488,12 +3574,13 @@ var BrowseScreen = ({
   const filterActive = search != null || repoFilter.size > 0;
   const reserveCiRow = ciStatusState != null;
   const reserveStripRow = stripState != null;
+  const reserveFocusRow = focusLabel !== void 0 || focusEmpty !== void 0 || focus !== void 0;
   const ciStatus = ciStatusState?.kind === "ready" ? ciStatusState.status : null;
   const listHeight = Math.max(
     5,
     // -10 rather than -8: the extra 2 are the frame's top and bottom border
     // rows, so the tree never grows taller than the terminal inside the frame.
-    rows - 10 - (filterActive ? 2 : 0) - (reserveCiRow ? 2 : 0) - (reserveStripRow ? 2 : 0)
+    rows - 10 - (filterActive ? 2 : 0) - (reserveCiRow ? 2 : 0) - (reserveStripRow ? 2 : 0) - (reserveFocusRow ? 2 : 0)
   );
   useEffect(() => {
     setLocalSections(applyWork(sections));
@@ -3578,6 +3665,14 @@ var BrowseScreen = ({
     const timer = setTimeout(() => setDismissedSeq(seq), FAILURE_NOTICE_MS);
     return () => clearTimeout(timer);
   }, [failure?.seq]);
+  const counted = useMemo(
+    () => countedSections(localSections, departing),
+    [localSections, departing]
+  );
+  const countOf = (id) => {
+    const s = counted.find((c) => c.id === id);
+    return s ? workCount(s) : 0;
+  };
   const markedTabs = useMemo(() => {
     const out = /* @__PURE__ */ new Set();
     if (!transients?.size) return out;
@@ -3631,7 +3726,10 @@ var BrowseScreen = ({
       cols: rowCols,
       uniformLabels,
       columns: trailingColumns,
-      numberCols
+      numberCols,
+      // Presence only: every row holds the same two gutter columns while a
+      // focus is on screen, so the shed ladder prices the cost once for all.
+      focusGutter: focus !== void 0
     }
   );
   const [sparkFrame, setSparkFrame] = useState(0);
@@ -3713,31 +3811,34 @@ var BrowseScreen = ({
       optimistic: optimisticMove ? (to) => optimisticMove(task, to) : void 0
     });
   };
+  const actionsFor = (item, flash2) => buildActions(
+    item,
+    login,
+    flash2,
+    jiraBase,
+    jiraKeyRe,
+    jiraTransitions,
+    onRefresh,
+    dismissItem,
+    openDrillView,
+    {
+      extensions,
+      onOpenExt,
+      onActed,
+      onSettled,
+      optimistic,
+      onOpenMove: jiraTransitionsFor ? openMoveFor : void 0
+    }
+  );
   const openMenu = () => {
     if (!activeItem || activeItem.kind === "repo-header" || activeItem.kind === "subgroup-header")
       return;
-    const actions = buildActions(
-      activeItem,
-      login,
-      (msg) => {
+    menu.open(
+      actionsFor(activeItem, (msg) => {
         menu.close();
         showFlash(msg);
-      },
-      jiraBase,
-      jiraKeyRe,
-      jiraTransitions,
-      onRefresh,
-      dismissItem,
-      openDrillView,
-      {
-        extensions,
-        onOpenExt,
-        onActed,
-        onSettled,
-        onOpenMove: jiraTransitionsFor ? openMoveFor : void 0
-      }
+      })
     );
-    menu.open(actions);
   };
   useInput((input, key) => {
     const idleFor = Date.now() - lastKeyAt.current;
@@ -3868,6 +3969,56 @@ var BrowseScreen = ({
       onRefresh?.();
       return;
     }
+    if (input === "g" && focus) {
+      const tabId = focus.target.tab;
+      const at = localSections.findIndex((s) => s.id === tabId);
+      if (at === -1) return;
+      const drawn = (s) => {
+        const one = search != null ? filterBySearch([s], search, login) : [s];
+        const two = repoFilter.size > 0 ? filterByRepos(one, repoFilter, login) : one;
+        return filterActive ? two[0]?.items ?? [] : s.items;
+      };
+      const urlOf = (i) => "url" in i ? i.url : void 0;
+      let items = localSections[at].items;
+      if (!items.some((i) => urlOf(i) === focus.target.url)) {
+        const tail = items.find(
+          (i) => i.kind === "show-more" && i.hidden.some((h) => h.url === focus.target.url)
+        );
+        if (!tail) {
+          setTabIdx(at);
+          return;
+        }
+        items = [
+          ...items.slice(0, items.indexOf(tail)),
+          ...tail.hidden,
+          {
+            kind: "show-less",
+            toHide: tail.hidden,
+            // The depth of the row it replaces, never a constant — a collapsed
+            // row under a story sits deeper than 1, and pinning it breaks the
+            // `treeUrls` walk exactly as the comment there warns.
+            depth: depthOf(tail)
+          },
+          ...items.slice(items.indexOf(tail) + 1)
+        ];
+        const expanded = items;
+        setLocalSections(
+          (prev) => prev.map((s) => s.id === tabId ? { ...s, items: expanded } : s)
+        );
+        prevItems.current = { ...prevItems.current, [tabId]: expanded };
+      }
+      setTabIdx(at);
+      const shown = drawn({ ...localSections[at], items });
+      const dit = shown.findIndex((i) => urlOf(i) === focus.target.url);
+      if (dit === -1) return;
+      setCursors((p) => ({ ...p, [tabId]: dit }));
+      setViewStarts((p) => {
+        let vs = Math.min(p[tabId] ?? 0, withHeaders(shown, dit));
+        while (dit >= vs + windowCount(shown, vs, listHeight)) vs++;
+        return { ...p, [tabId]: vs };
+      });
+      return;
+    }
     const ext = extensionFor(input, extensions);
     if (ext) {
       onOpenExt?.(ext.id, extensionTargetFor(activeItem));
@@ -4029,20 +4180,7 @@ var BrowseScreen = ({
       return;
     }
     if (input === "x" && activeItem.kind === "pr" && activeItem.standing === "queued" && login) {
-      dismissItem(activeItem);
-      showFlash(`\u22EF Removing you from #${activeItem.number}\u2026`);
-      void quietly`gh pr edit ${activeItem.number} --repo ${activeItem.repo} --remove-reviewer ${login}`.then(
-        () => {
-          showFlash(`\u2713 Removed you as reviewer on #${activeItem.number}`);
-          onActed?.();
-          onSettled?.(activeItem, { ok: true });
-        },
-        (e) => {
-          showFlash(`\u2717 #${activeItem.number}: ${explainGhAction(e)}`);
-          onRefresh?.();
-          onSettled?.(activeItem, { ok: false, reason: firstLine(e) });
-        }
-      );
+      actionsFor(activeItem, showFlash).find((a) => a.label === REMOVE_ME_AS_REVIEWER)?.run();
       return;
     }
     if (input === "b" && activeItem.kind === "pr" && activeItem.branch) {
@@ -4296,6 +4434,7 @@ var BrowseScreen = ({
     {
       extensions,
       hasJira: !!jiraBase,
+      hasFocus: focus != null,
       tabHelp,
       maxRows: listHeight,
       scroll: helpScroll,
@@ -4331,7 +4470,7 @@ var BrowseScreen = ({
           InboxHeader,
           {
             brand,
-            sections: localSections,
+            sections: counted,
             login,
             scopeLabel: overlayOpen ? chrome?.scope ?? origin?.label : origin?.label,
             budgetLabel: budgetNotice(budget)?.label,
@@ -4352,6 +4491,15 @@ var BrowseScreen = ({
             width: COLS
           }
         ) : null,
+        reserveFocusRow ? /* @__PURE__ */ jsx(
+          FocusSlotLine,
+          {
+            focus,
+            label: focusLabel,
+            empty: focusEmpty,
+            width: COLS
+          }
+        ) : null,
         skippedForBudget ? /* @__PURE__ */ jsxs(Box, { marginBottom: 1, children: [
           /* @__PURE__ */ jsx(Text3, { bold: true, color: colors.accent, children: "  \u26A1 auto-refresh paused to save API budget" }),
           /* @__PURE__ */ jsx(Text3, { dimColor: true, children: "   r refreshes anyway" })
@@ -4360,10 +4508,12 @@ var BrowseScreen = ({
           Tabs,
           {
             active: section.id,
+            width: COLS,
             items: localSections.map((s) => ({
               value: s.id,
               label: s.label,
-              count: workCount(s),
+              icon: s.icon,
+              count: countOf(s.id),
               /*
                * The denominator, and only where it can still be true.
                *
@@ -4448,6 +4598,7 @@ var BrowseScreen = ({
                           columns: trailingColumns,
                           shed: trailingShed,
                           numberCols,
+                          focus,
                           gap: i > 0 && gapsAbove(section.items, viewStart + i)
                         },
                         `${viewStart + i}:${rowKey(item)}`
@@ -4543,6 +4694,8 @@ var App = ({
   stripFetcher,
   stripLabel,
   stripPollMs = 3e5,
+  focusLabel,
+  focusEmpty,
   watchPath,
   watchDebounceMs = 400,
   // Zero by default, deliberately. A package that adds randomness to its own
@@ -4725,6 +4878,7 @@ var App = ({
         )
       };
       if (fresh.budget) setBudget(fresh.budget);
+      if (fresh.focus !== void 0) setFocus(fresh.focus);
       if (fresh.sidebar !== void 0) setSidebar(fresh.sidebar);
       if (cacheKey) writeCache(cacheKey, fresh);
       setRefreshing(false);
@@ -4835,6 +4989,26 @@ var App = ({
       phase: "inflight"
     });
   } : void 0;
+  const optimistic = (item, change) => {
+    const key = keyOf(item);
+    if (!key) return void 0;
+    return hold(key, {
+      patch: change.patch,
+      action: change.action,
+      label: rowLabelOf(item),
+      since: Date.now(),
+      phase: "inflight"
+    });
+  };
+  const departing = useMemo(
+    () => new Map(
+      [...overrides.current].flatMap(
+        ([key, { patch }]) => patch.kind === "remove" ? [[key, null]] : patch.kind === "move" ? [[key, patch.toSection]] : []
+      )
+    ),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [overrideRev]
+  );
   const restore = () => {
     const newest = failedOverrides(overrides.current)[0];
     if (!newest) return;
@@ -4857,6 +5031,7 @@ var App = ({
       displayedSections.current = cached.sections;
       setFetchedAt(cached.at);
       if (cached.sidebar) setSidebar(cached.sidebar);
+      if (cached.focus !== void 0) setFocus(cached.focus);
       setState({
         phase: "browse",
         sections: cached.sections,
@@ -4919,6 +5094,7 @@ var App = ({
           if (shared && shared.at > firedAt) {
             receive({ sections: shared.sections, login: shared.login });
             if (shared.sidebar) setSidebar(shared.sidebar);
+            if (shared.focus !== void 0) setFocus(shared.focus);
             setFetchedAt(shared.at);
             return;
           }
@@ -4939,6 +5115,7 @@ var App = ({
   );
   const [appliedSummary, setAppliedSummary] = useState("");
   const [sidebar, setSidebar] = useState(void 0);
+  const [focus, setFocus] = useState(void 0);
   const [skippedForBudget, setSkippedForBudget] = useState(false);
   const [mergedUrls, setMergedUrls] = useState([]);
   const [leavingUrls, setLeavingUrls] = useState([]);
@@ -4991,6 +5168,15 @@ var App = ({
               width: COLS
             }
           ) : null,
+          focusLabel !== void 0 || focusEmpty !== void 0 ? /* @__PURE__ */ jsx(
+            FocusSlotLine,
+            {
+              focus: void 0,
+              label: focusLabel,
+              empty: focusEmpty,
+              width: COLS
+            }
+          ) : null,
           /* @__PURE__ */ jsx(
             Box,
             {
@@ -5070,6 +5256,8 @@ var App = ({
       jiraTransitions,
       jiraTransitionsFor,
       optimisticMove,
+      optimistic,
+      departing,
       pendingKeys,
       failure,
       onRestore: restore,
@@ -5101,6 +5289,9 @@ var App = ({
       ciJob,
       stripState: hasStrip ? stripState : void 0,
       stripLabel,
+      focus,
+      focusLabel,
+      focusEmpty,
       tabHelp,
       onOpenPr: (item) => {
         setChromeSpec({});
@@ -5149,4 +5340,4 @@ var matchesFilter = (repo, filter) => {
 };
 var parsePatterns = (value) => value.split(",").map((p) => p.trim()).filter(Boolean);
 
-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 };
+export { ActionMenu, App, COLS, CiStatusLine, CommentsPanel, DEFAULT_FOCUS_EMPTY, DEFAULT_FOCUS_LABEL, FOCUS_MARK, FocusSlotLine, HealthPanel, LookupMiss, MIN_SIDEBAR_COLS, PrRow, SIDEBAR_COLS, SidePanel, StatusStripLine, ageLabel, budgetNotice, buildActions, buildCheckoutCmd, clipboard, counts, drillCmd, explainGhAction, explainItem, fitCount, focusCellFor, focusRefColor, 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.73.0",
+  "version": "0.75.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",
@@ -44,17 +44,17 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@kud/ink-ui": ">=0.36.0 <1",
+    "@kud/ink-ui": ">=0.39.0 <1",
     "ink": ">=7",
     "react": ">=19"
   },
   "dependencies": {
     "@kud/gh": "0.21.0",
-    "@kud/gh-workflow": "0.16.0",
+    "@kud/gh-workflow": "0.17.0",
     "zx": "8.8.5"
   },
   "devDependencies": {
-    "@kud/ink-ui": "0.36.0",
+    "@kud/ink-ui": "0.39.0",
     "@types/node": "22.20.1",
     "@types/react": "19.2.17",
     "ink": "7.1.0",