@kud/gh-ink 0.37.0 → 0.38.0

package/dist/index.d.ts

@@ -24,6 +24,58 @@ type HealthPanelProps = {
 };
 declare const HealthPanel: ({ repo, number, data, error, reload, onOpenCheck, onMerged, }: HealthPanelProps) => React.JSX.Element;
 
+/**
+ * One initiative in the rail — a container of work rather than a unit of it.
+ *
+ * Deliberately not a `TaskRow`. The list answers "what is in front of me today"
+ * and prices every row by stage; this answers "what am I building, over months",
+ * where a stage means nothing because an initiative's stage is only ever an
+ * aggregate of its children's. Sharing a shape would have meant carrying a
+ * `status` neither side agrees on.
+ */
+type SidebarRow = {
+    /** Stable identity, and the left column: a ticket key, an id, a slug. */
+    key: string;
+    /** What it is, in words. Never omitted — a key alone cannot be read. */
+    label: string;
+    /**
+     * How much is moving under it right now. Absent draws nothing rather than a
+     * zero: "no live work" and "we did not count" are different claims, and a
+     * hard 0 asserts the first from evidence for neither.
+     */
+    live?: number;
+    /** Something under it is waiting on you. */
+    wantsYou?: boolean;
+};
+type Sidebar = {
+    /** Heading for the rail. The host's vocabulary, never ours. */
+    title: string;
+    rows: SidebarRow[];
+};
+/**
+ * The rail's width, INCLUDING its one-column gutter. Exported because the list
+ * beside it has to shrink by exactly this much: every row in that list truncates
+ * against a budget, and a budget that does not know the rail is there overflows
+ * by the rail's whole width — which in a frame sized to fill the terminal
+ * scrolls the panel rather than clipping a row.
+ */
+declare const SIDEBAR_COLS = 30;
+/**
+ * A right-hand rail of initiatives, standing beside the list.
+ *
+ * Two lines per row rather than one, because both halves are load-bearing and
+ * neither survives the other being cut: a key with no words cannot be read at a
+ * glance, and words with no key cannot be opened. Thirty columns is not enough
+ * for both on one line, so they stack.
+ *
+ * Presentational, like every other row renderer here — it takes no keyboard and
+ * holds no cursor. Whether the rail is shown at all is the host's state.
+ */
+declare const SidePanel: ({ sidebar, height, }: {
+    sidebar: Sidebar;
+    height?: number;
+}) => React.JSX.Element;
+
 declare const renderMarkdown: (raw: string, width: number, fileLink?: (path: string, line?: number) => string) => StyledLine[];
 
 declare const healthDisplay: Record<Health, {
@@ -493,6 +545,15 @@ declare const App: ({ fetcher, cacheKey, title, detailFor, origin, jiraBase, jir
          * can decline to spend the last of it on a refresh nobody requested.
          */
         budget?: InboxBudget;
+        /**
+         * A rail of containers to stand beside the list — initiatives, epics,
+         * whatever this host groups its work under. Omit it and no rail exists: no
+         * key, no hint, no columns spent.
+         *
+         * Part of the fetch result rather than a static prop because it is data, and
+         * data that goes stale the same way the rows do.
+         */
+        sidebar?: Sidebar;
     }>;
     cacheKey?: string;
     title?: string;
@@ -615,4 +676,4 @@ declare const matchesFilter: (repo: string, filter: RepoFilter) => boolean;
  */
 declare const parsePatterns: (value: string) => string[];
 
-export { type Action, ActionMenu, type AnyItem, App, COLS, type CiStatus, CiStatusLine, type CiStatusState, CommentsPanel, type CommentsPanelProps, type DetailContext, type ExplainSection, type ExtensionTarget, type GHDetail, type GHItem, HealthPanel, type HealthPanelProps, type InboxBudget, type InboxConfig, type InboxExtension, type JiraTransition, type OriginSplit, PIN_MARK, type RepoFilter, type RepoHeader, type RepoProfile, type Section, type ShowLess, type ShowMore, type Standing, type SubgroupHeader, type TaskRow, budgetNotice, buildActions, buildCheckoutCmd, checkoutDirs, clipboard, configureInbox, drillCmd, explainGhAction, explainItem, filterByOrigin, filterByRepos, filterBySearch, fitCount, gapsAbove, healthColor, healthDisplay, healthGlyph, healthLegend, inboxConfig, insertRepoHeaders, itermRun, jumpToRepo, jumpToRepoPane, layoutGHItems, matchesFilter, maxViewStart, moveCursor, openInTab, parsePatterns, profileOf, readCache, relativeTime, renderMarkdown, repoPriority, reposInSections, resetInboxConfig, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, signatureOf, sortByRecency, sortItems, toCiStatusState, topLevelCount, truncate, useActionMenu, whoseMove, windowCount, withHeaders, withoutItem, writeCache };
+export { type Action, ActionMenu, type AnyItem, App, COLS, type CiStatus, CiStatusLine, type CiStatusState, CommentsPanel, type CommentsPanelProps, type DetailContext, type ExplainSection, type ExtensionTarget, type GHDetail, type GHItem, HealthPanel, type HealthPanelProps, type InboxBudget, type InboxConfig, type InboxExtension, type JiraTransition, type OriginSplit, PIN_MARK, type RepoFilter, type RepoHeader, type RepoProfile, SIDEBAR_COLS, type Section, type ShowLess, type ShowMore, SidePanel, type Sidebar, type SidebarRow, type Standing, type SubgroupHeader, type TaskRow, budgetNotice, buildActions, buildCheckoutCmd, checkoutDirs, clipboard, configureInbox, drillCmd, explainGhAction, explainItem, filterByOrigin, filterByRepos, filterBySearch, fitCount, gapsAbove, healthColor, healthDisplay, healthGlyph, healthLegend, inboxConfig, insertRepoHeaders, itermRun, jumpToRepo, jumpToRepoPane, layoutGHItems, matchesFilter, maxViewStart, moveCursor, openInTab, parsePatterns, profileOf, readCache, relativeTime, renderMarkdown, repoPriority, reposInSections, resetInboxConfig, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, signatureOf, sortByRecency, sortItems, toCiStatusState, topLevelCount, truncate, useActionMenu, whoseMove, windowCount, withHeaders, withoutItem, writeCache };

package/dist/index.js

@@ -583,6 +583,37 @@ var HealthPanel = ({
     ] }) }) : note ? /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(Text, { color: colors.success, children: "  " + note }) }) : null
   ] });
 };
+var ACCENT = "#FF8700";
+var SIDEBAR_COLS = 30;
+var GUTTER = 1;
+var CONTENT = SIDEBAR_COLS - GUTTER;
+var truncate = (text, max) => [...text].length <= max ? text : [...text].slice(0, Math.max(0, max - 1)).join("") + "\u2026";
+var SidePanel = ({
+  sidebar,
+  height
+}) => /* @__PURE__ */ jsxs(
+  Box,
+  {
+    flexDirection: "column",
+    width: SIDEBAR_COLS,
+    flexShrink: 0,
+    height,
+    children: [
+      /* @__PURE__ */ jsxs(Box, { marginBottom: 1, paddingLeft: GUTTER, children: [
+        /* @__PURE__ */ jsx(Text, { color: ACCENT, bold: true, children: "\xBB " }),
+        /* @__PURE__ */ jsx(Text, { bold: true, children: sidebar.title })
+      ] }),
+      sidebar.rows.length === 0 ? /* @__PURE__ */ jsx(Box, { paddingLeft: GUTTER + 2, children: /* @__PURE__ */ jsx(Text, { dimColor: true, children: "nothing open" }) }) : sidebar.rows.map((row) => /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [
+        /* @__PURE__ */ jsxs(Box, { paddingLeft: GUTTER, children: [
+          /* @__PURE__ */ jsx(Text, { color: ACCENT, bold: true, children: row.wantsYou ? "\u2190 " : "  " }),
+          /* @__PURE__ */ jsx(Text, { color: ACCENT, children: row.key }),
+          row.live !== void 0 ? /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  ${row.live} live` }) : null
+        ] }),
+        /* @__PURE__ */ jsx(Box, { paddingLeft: GUTTER + 2, children: /* @__PURE__ */ jsx(Text, { dimColor: true, children: truncate(row.label, CONTENT - 2) }) })
+      ] }, row.key))
+    ]
+  }
+);
 var healthDisplay = {
   none: { glyph: " ", color: colors.muted },
   draft: { glyph: "~", color: colors.muted },
@@ -1215,7 +1246,7 @@ var withHeaders = (items, idx) => {
     start--;
   return start;
 };
-var truncate = (str, max) => {
+var truncate2 = (str, max) => {
   if (str.length <= max) return str;
   const half = Math.floor((max - 1) / 2);
   return `${str.slice(0, half)}\u2026${str.slice(-half)}`;
@@ -1405,7 +1436,7 @@ var COLS = (process.stdout.columns ?? 120) - FRAME_CHROME_COLS;
 var MODAL_CHROME_COLS = 2 + 1 * 2;
 var OVERLAY_BG = "#22222e";
 var DimContext = createContext(false);
-var Text2 = ({ children, ...props }) => {
+var Text3 = ({ children, ...props }) => {
   const dimmed = useContext(DimContext);
   return dimmed ? /* @__PURE__ */ jsx(Text, { ...props, bold: false, dimColor: true, children }) : /* @__PURE__ */ jsx(Text, { ...props, children });
 };
@@ -1784,13 +1815,13 @@ var InboxHeader = ({
     COLS - brand.length - countSeg.length - userSeg.length - workLabel.length - budgetSeg.length - statusSeg.length
   );
   return /* @__PURE__ */ jsxs(Box, { marginBottom: 1, children: [
-    /* @__PURE__ */ jsx(Text2, { color: "#FF8700", bold: true, children: brand }),
-    /* @__PURE__ */ jsx(Text2, { dimColor: true, children: countSeg }),
-    userSeg ? /* @__PURE__ */ jsx(Text2, { children: userSeg }) : null,
-    scopeLabel ? /* @__PURE__ */ jsx(Text2, { dimColor: true, children: workLabel }) : null,
-    budgetLabel ? /* @__PURE__ */ jsx(Text2, { bold: true, color: budgetCritical ? "#FF5F5F" : "#FF8700", children: budgetSeg }) : null,
+    /* @__PURE__ */ jsx(Text3, { color: "#FF8700", bold: true, children: brand }),
+    /* @__PURE__ */ jsx(Text3, { dimColor: true, children: countSeg }),
+    userSeg ? /* @__PURE__ */ jsx(Text3, { children: userSeg }) : null,
+    scopeLabel ? /* @__PURE__ */ jsx(Text3, { dimColor: true, children: workLabel }) : null,
+    budgetLabel ? /* @__PURE__ */ jsx(Text3, { bold: true, color: budgetCritical ? "#FF5F5F" : "#FF8700", children: budgetSeg }) : null,
     statusText ? /* @__PURE__ */ jsx(
-      Text2,
+      Text3,
       {
         color: statusColor,
         dimColor: !statusColor,
@@ -1798,7 +1829,7 @@ var InboxHeader = ({
         children: statusSeg
       }
     ) : null,
-    /* @__PURE__ */ jsx(Text2, { color: "cyan", dimColor: true, children: "\u254C".repeat(fill) })
+    /* @__PURE__ */ jsx(Text3, { color: "cyan", dimColor: true, children: "\u254C".repeat(fill) })
   ] });
 };
 var toCiStatusState = (status) => status ? { kind: "ready", status } : { kind: "error" };
@@ -1821,24 +1852,24 @@ var CiStatusLine = ({
   const name = job ?? "ci";
   if (state.kind === "loading")
     return /* @__PURE__ */ jsxs(Box, { marginBottom: 1, children: [
-      /* @__PURE__ */ jsx(Text2, { dimColor: true, children: "  \xB7 " }),
-      /* @__PURE__ */ jsx(Text2, { dimColor: true, children: `${name}  loading\u2026` })
+      /* @__PURE__ */ jsx(Text3, { dimColor: true, children: "  \xB7 " }),
+      /* @__PURE__ */ jsx(Text3, { dimColor: true, children: `${name}  loading\u2026` })
     ] });
   if (state.kind === "error")
     return /* @__PURE__ */ jsxs(Box, { marginBottom: 1, children: [
-      /* @__PURE__ */ jsx(Text2, { color: "red", bold: true, children: "  \u2717 " }),
-      /* @__PURE__ */ jsx(Text2, { dimColor: true, children: `${name}  no build / not configured` })
+      /* @__PURE__ */ jsx(Text3, { color: "red", bold: true, children: "  \u2717 " }),
+      /* @__PURE__ */ jsx(Text3, { dimColor: true, children: `${name}  no build / not configured` })
     ] });
   const { status } = state;
   const [, color] = jenkinsResultDisplay(status.result, status.building);
   const label = status.building ? "BUILDING" : status.result;
   return /* @__PURE__ */ jsxs(Box, { marginBottom: 1, children: [
-    /* @__PURE__ */ jsx(Text2, { dimColor: true, children: "  " }),
-    /* @__PURE__ */ jsx(Text2, { color, bold: true, children: "\u25CF " }),
-    /* @__PURE__ */ jsx(Text2, { bold: true, children: status.job }),
-    /* @__PURE__ */ jsx(Text2, { dimColor: true, children: "  " + label }),
-    /* @__PURE__ */ jsx(Text2, { color: "#FF8700", children: "  #" + status.buildNumber }),
-    status.age ? /* @__PURE__ */ jsx(Text2, { dimColor: true, children: "  " + status.age }) : null
+    /* @__PURE__ */ jsx(Text3, { dimColor: true, children: "  " }),
+    /* @__PURE__ */ jsx(Text3, { color, bold: true, children: "\u25CF " }),
+    /* @__PURE__ */ jsx(Text3, { bold: true, children: status.job }),
+    /* @__PURE__ */ jsx(Text3, { dimColor: true, children: "  " + label }),
+    /* @__PURE__ */ jsx(Text3, { color: "#FF8700", children: "  #" + status.buildNumber }),
+    status.age ? /* @__PURE__ */ jsx(Text3, { dimColor: true, children: "  " + status.age }) : null
   ] });
 };
 var FENCE_COLS = 46;
@@ -1851,10 +1882,10 @@ var RepoHeaderRow = ({
   const fill = Math.max(4, FENCE_COLS - label.length);
   const rule = "\u2500".repeat(fill);
   return /* @__PURE__ */ jsxs(Box, { marginTop: gap ? 1 : 0, children: [
-    /* @__PURE__ */ jsx(Text2, { color: "cyan", children: active ? "\u276F " : "  " }),
-    /* @__PURE__ */ jsx(Text2, { dimColor: !active, children: "\u2500\u2500 " }),
-    /* @__PURE__ */ jsx(Text2, { dimColor: !active, bold: active, children: repo }),
-    /* @__PURE__ */ jsx(Text2, { dimColor: !active, children: " " + rule })
+    /* @__PURE__ */ jsx(Text3, { color: "cyan", children: active ? "\u276F " : "  " }),
+    /* @__PURE__ */ jsx(Text3, { dimColor: !active, children: "\u2500\u2500 " }),
+    /* @__PURE__ */ jsx(Text3, { dimColor: !active, bold: active, children: repo }),
+    /* @__PURE__ */ jsx(Text3, { dimColor: !active, children: " " + rule })
   ] });
 };
 var MERGED_HOLD_MS = 5e3;
@@ -1902,29 +1933,30 @@ var ItemRow = ({
   leaving,
   prefix = "",
   parent,
-  sparkFrame = 0
+  sparkFrame = 0,
+  cols = COLS
 }) => {
   const transient = leaving ? "out" : refreshMark;
   if (item.kind === "repo-header")
     return /* @__PURE__ */ jsx(RepoHeaderRow, { repo: item.repo, gap: gap ?? false, active });
   if (item.kind === "subgroup-header")
     return /* @__PURE__ */ jsxs(Box, { marginTop: gap ? 1 : 0, children: [
-      /* @__PURE__ */ jsx(Text2, { color: "#FF8700", bold: true, children: "  \xBB " }),
-      /* @__PURE__ */ jsx(Text2, { bold: true, children: item.label })
+      /* @__PURE__ */ jsx(Text3, { color: "#FF8700", bold: true, children: "  \xBB " }),
+      /* @__PURE__ */ jsx(Text3, { bold: true, children: item.label })
     ] });
   if (item.kind === "show-more")
     return /* @__PURE__ */ jsxs(Box, { children: [
-      /* @__PURE__ */ jsx(Text2, { color: "cyan", children: active ? "\u276F " : "  " }),
-      /* @__PURE__ */ jsx(Text2, { dimColor: true, children: prefix }),
-      /* @__PURE__ */ jsx(Text2, { dimColor: true, children: active ? "\u21B5 " : "  " }),
-      /* @__PURE__ */ jsx(Text2, { dimColor: true, children: `+${item.hidden.length} more` })
+      /* @__PURE__ */ jsx(Text3, { color: "cyan", children: active ? "\u276F " : "  " }),
+      /* @__PURE__ */ jsx(Text3, { dimColor: true, children: prefix }),
+      /* @__PURE__ */ jsx(Text3, { dimColor: true, children: active ? "\u21B5 " : "  " }),
+      /* @__PURE__ */ jsx(Text3, { dimColor: true, children: `+${item.hidden.length} more` })
     ] });
   if (item.kind === "show-less")
     return /* @__PURE__ */ jsxs(Box, { children: [
-      /* @__PURE__ */ jsx(Text2, { color: "cyan", children: active ? "\u276F " : "  " }),
-      /* @__PURE__ */ jsx(Text2, { dimColor: true, children: prefix }),
-      /* @__PURE__ */ jsx(Text2, { dimColor: true, children: active ? "\u21B5 " : "  " }),
-      /* @__PURE__ */ jsx(Text2, { dimColor: true, children: "show less" })
+      /* @__PURE__ */ jsx(Text3, { color: "cyan", children: active ? "\u276F " : "  " }),
+      /* @__PURE__ */ jsx(Text3, { dimColor: true, children: prefix }),
+      /* @__PURE__ */ jsx(Text3, { dimColor: true, children: active ? "\u21B5 " : "  " }),
+      /* @__PURE__ */ jsx(Text3, { dimColor: true, children: "show less" })
     ] });
   if (item.kind === "task") {
     const note = item.note ?? "";
@@ -1932,29 +1964,29 @@ var ItemRow = ({
     const transitLabel2 = transient ? TRANSIT_LABEL[transient] : "";
     const titleMax2 = Math.max(
       20,
-      COLS - item.key.length - note.length - (item.pill ? pillWidth(item.pill) + 1 : 0) - transitLabel2.length - prefix.length - 12
+      cols - item.key.length - note.length - (item.pill ? pillWidth(item.pill) + 1 : 0) - transitLabel2.length - prefix.length - 12
     );
     return /* @__PURE__ */ jsxs(Box, { marginTop: gap ? 1 : 0, children: [
-      /* @__PURE__ */ jsx(Text2, { color: "cyan", children: active ? "\u276F " : "  " }),
-      /* @__PURE__ */ jsx(Text2, { dimColor: true, children: prefix }),
-      /* @__PURE__ */ jsx(Text2, { dimColor: true, children: parent ? "\u252C " : "  " }),
-      /* @__PURE__ */ jsx(Text2, { bold: true, color: transient ? TRANSIT_COLOUR[transient] : void 0, children: transitIcon + " " }),
-      /* @__PURE__ */ jsx(Text2, { color: "#FF8700", bold: active, children: item.key + "  " }),
+      /* @__PURE__ */ jsx(Text3, { color: "cyan", children: active ? "\u276F " : "  " }),
+      /* @__PURE__ */ jsx(Text3, { dimColor: true, children: prefix }),
+      /* @__PURE__ */ jsx(Text3, { dimColor: true, children: parent ? "\u252C " : "  " }),
+      /* @__PURE__ */ jsx(Text3, { bold: true, color: transient ? TRANSIT_COLOUR[transient] : void 0, children: transitIcon + " " }),
+      /* @__PURE__ */ jsx(Text3, { color: "#FF8700", bold: active, children: item.key + "  " }),
       /* @__PURE__ */ jsx(
-        Text2,
+        Text3,
         {
           bold: active || !!transient && isArrival(transient),
           dimColor: !!transient && isDeparture(transient),
           strikethrough: transient === "out",
-          children: truncate(item.summary, titleMax2)
+          children: truncate2(item.summary, titleMax2)
         }
       ),
       item.pill ? /* @__PURE__ */ jsxs(Fragment, { children: [
-        /* @__PURE__ */ jsx(Text2, { children: " " }),
+        /* @__PURE__ */ jsx(Text3, { children: " " }),
         /* @__PURE__ */ jsx(Pill, { variant: item.pillVariant ?? "muted", children: item.pill })
       ] }) : null,
-      note ? /* @__PURE__ */ jsx(Text2, { dimColor: true, children: ` ${note}` }) : null,
-      transitLabel2 ? /* @__PURE__ */ jsx(Text2, { bold: true, color: TRANSIT_COLOUR[transient], children: "  " + transitLabel2 }) : null
+      note ? /* @__PURE__ */ jsx(Text3, { dimColor: true, children: ` ${note}` }) : null,
+      transitLabel2 ? /* @__PURE__ */ jsx(Text3, { bold: true, color: TRANSIT_COLOUR[transient], children: "  " + transitLabel2 }) : null
     ] });
   }
   const { glyph: healthIcon, color: healthColor2 } = healthDisplay[item.health];
@@ -1977,28 +2009,28 @@ var ItemRow = ({
   ].filter(Boolean).join("  ");
   const repoLabel = depthOf(item) > 0 ? item.repo : "";
   const fixedWidth = 2 + prefix.length + 2 + 2 + 7 + repoLabel.length + suffix.length + 6;
-  const titleMax = Math.max(20, COLS - fixedWidth);
+  const titleMax = Math.max(20, cols - fixedWidth);
   return /* @__PURE__ */ jsxs(Box, { children: [
-    /* @__PURE__ */ jsx(Text2, { color: "cyan", children: active ? "\u276F " : "  " }),
-    /* @__PURE__ */ jsx(Text2, { dimColor: true, children: prefix }),
-    /* @__PURE__ */ jsx(Text2, { color, bold: true, children: icon + " " }),
-    /* @__PURE__ */ jsx(Text2, { color: turnColor, bold: turnIcon === "\u2190", children: turnIcon + " " }),
-    /* @__PURE__ */ jsx(Text2, { color: "#FF8700", children: numStr }),
+    /* @__PURE__ */ jsx(Text3, { color: "cyan", children: active ? "\u276F " : "  " }),
+    /* @__PURE__ */ jsx(Text3, { dimColor: true, children: prefix }),
+    /* @__PURE__ */ jsx(Text3, { color, bold: true, children: icon + " " }),
+    /* @__PURE__ */ jsx(Text3, { color: turnColor, bold: turnIcon === "\u2190", children: turnIcon + " " }),
+    /* @__PURE__ */ jsx(Text3, { color: "#FF8700", children: numStr }),
     /* @__PURE__ */ jsx(
-      Text2,
+      Text3,
       {
         bold: active || !!transient && isArrival(transient),
         dimColor: !!transient && isDeparture(transient),
         strikethrough: transient === "out",
-        children: truncate(item.title, titleMax) + "  "
+        children: truncate2(item.title, titleMax) + "  "
       }
     ),
-    repoLabel ? /* @__PURE__ */ jsx(Text2, { dimColor: true, children: repoLabel }) : null,
-    unresolvedLabel ? /* @__PURE__ */ jsx(Text2, { bold: !spokeLast, color: spokeLast ? "#888888" : "#FF8700", children: "  " + unresolvedLabel }) : null,
-    showAuthor ? /* @__PURE__ */ jsx(Text2, { dimColor: true, italic: true, children: "  by " + item.author }) : null,
-    ageLabel ? /* @__PURE__ */ jsx(Text2, { dimColor: true, children: "  " + ageLabel }) : null,
-    mergedLabel ? /* @__PURE__ */ jsx(Text2, { bold: true, color: MERGED_COLOUR, children: "  " + mergedLabel }) : null,
-    transitLabel ? /* @__PURE__ */ jsx(Text2, { bold: true, color: TRANSIT_COLOUR[transient], children: "  " + transitLabel }) : null
+    repoLabel ? /* @__PURE__ */ jsx(Text3, { dimColor: true, children: repoLabel }) : null,
+    unresolvedLabel ? /* @__PURE__ */ jsx(Text3, { bold: !spokeLast, color: spokeLast ? "#888888" : "#FF8700", children: "  " + unresolvedLabel }) : null,
+    showAuthor ? /* @__PURE__ */ jsx(Text3, { dimColor: true, italic: true, children: "  by " + item.author }) : null,
+    ageLabel ? /* @__PURE__ */ jsx(Text3, { dimColor: true, children: "  " + ageLabel }) : null,
+    mergedLabel ? /* @__PURE__ */ jsx(Text3, { bold: true, color: MERGED_COLOUR, children: "  " + mergedLabel }) : null,
+    transitLabel ? /* @__PURE__ */ jsx(Text3, { bold: true, color: TRANSIT_COLOUR[transient], children: "  " + transitLabel }) : null
   ] });
 };
 var useActionMenu = () => {
@@ -2044,15 +2076,15 @@ var ActionMenu = ({
       paddingX: 1,
       marginTop: 1,
       children: [
-        /* @__PURE__ */ jsx(Text2, { color: "cyan", bold: true, children: title }),
-        /* @__PURE__ */ jsx(Text2, { dimColor: true, children: "\u2500".repeat(32) }),
+        /* @__PURE__ */ jsx(Text3, { color: "cyan", bold: true, children: title }),
+        /* @__PURE__ */ jsx(Text3, { dimColor: true, children: "\u2500".repeat(32) }),
         actions.map((a, i) => /* @__PURE__ */ jsxs(Box, { children: [
-          /* @__PURE__ */ jsx(Text2, { color: "cyan", children: i === cursor ? "\u276F " : "  " }),
-          /* @__PURE__ */ jsx(Text2, { bold: i === cursor, children: a.label }),
-          /* @__PURE__ */ jsx(Text2, { dimColor: true, children: "  " + a.hint })
+          /* @__PURE__ */ jsx(Text3, { color: "cyan", children: i === cursor ? "\u276F " : "  " }),
+          /* @__PURE__ */ jsx(Text3, { bold: i === cursor, children: a.label }),
+          /* @__PURE__ */ jsx(Text3, { dimColor: true, children: "  " + a.hint })
         ] }, a.label)),
-        /* @__PURE__ */ jsx(Text2, { dimColor: true, children: "\u2500".repeat(32) }),
-        /* @__PURE__ */ jsx(Text2, { dimColor: true, children: "\u2191\u2193 navigate \u21B5 confirm esc cancel" })
+        /* @__PURE__ */ jsx(Text3, { dimColor: true, children: "\u2500".repeat(32) }),
+        /* @__PURE__ */ jsx(Text3, { dimColor: true, children: "\u2191\u2193 navigate \u21B5 confirm esc cancel" })
       ]
     }
   );
@@ -2100,11 +2132,11 @@ var LegendGroup = ({
   width,
   marginRight
 }) => /* @__PURE__ */ jsxs(Box, { flexDirection: "column", width, marginRight, children: [
-  pinned !== void 0 ? /* @__PURE__ */ jsx(Text2, { bold: true, dimColor: true, children: pinned ?? " " }) : null,
+  pinned !== void 0 ? /* @__PURE__ */ jsx(Text3, { bold: true, dimColor: true, children: pinned ?? " " }) : null,
   lines.map(
-    (line, index) => line.kind === "gap" ? /* @__PURE__ */ jsx(Text2, { children: " " }, index) : line.kind === "title" ? /* @__PURE__ */ jsx(Text2, { bold: true, dimColor: true, children: line.text }, index) : /* @__PURE__ */ jsxs(Box, { children: [
-      /* @__PURE__ */ jsx(Text2, { color: line.row.color, bold: line.row.bold, children: line.row.cell.padEnd(line.cellWidth) }),
-      /* @__PURE__ */ jsx(Text2, { wrap: "truncate-end", children: line.row.label })
+    (line, index) => line.kind === "gap" ? /* @__PURE__ */ jsx(Text3, { children: " " }, index) : line.kind === "title" ? /* @__PURE__ */ jsx(Text3, { bold: true, dimColor: true, children: line.text }, index) : /* @__PURE__ */ jsxs(Box, { children: [
+      /* @__PURE__ */ jsx(Text3, { color: line.row.color, bold: line.row.bold, children: line.row.cell.padEnd(line.cellWidth) }),
+      /* @__PURE__ */ jsx(Text3, { wrap: "truncate-end", children: line.row.label })
     ] }, index)
   )
 ] });
@@ -2222,8 +2254,8 @@ var HelpModal = ({
       width: contentWidth + MODAL_CHROME_COLS,
       children: [
         /* @__PURE__ */ jsxs(Box, { children: [
-          /* @__PURE__ */ jsx(Text2, { color: "cyan", bold: true, children: "Legend" }),
-          scrollable ? /* @__PURE__ */ jsx(Text2, { dimColor: true, children: `   ${offset + 1}\u2013${offset + shown} of ${totalRows}` }) : null
+          /* @__PURE__ */ jsx(Text3, { color: "cyan", bold: true, children: "Legend" }),
+          scrollable ? /* @__PURE__ */ jsx(Text3, { dimColor: true, children: `   ${offset + 1}\u2013${offset + shown} of ${totalRows}` }) : null
         ] }),
         /* @__PURE__ */ jsx(Box, { marginTop: 1, width: contentWidth, children: groups.map((group, index) => /* @__PURE__ */ jsx(
           LegendGroup,
@@ -2235,8 +2267,8 @@ var HelpModal = ({
           },
           group[0]?.title ?? index
         )) }),
-        tabHelp && !scrollable ? /* @__PURE__ */ jsx(Text2, { dimColor: true, children: LEGEND_FOOTNOTE }) : null,
-        /* @__PURE__ */ jsx(Text2, { dimColor: true, children: scrollable ? "\u2191\u2193 scroll \xB7 esc \xB7 ? close" : "esc \xB7 ? close" })
+        tabHelp && !scrollable ? /* @__PURE__ */ jsx(Text3, { dimColor: true, children: LEGEND_FOOTNOTE }) : null,
+        /* @__PURE__ */ jsx(Text3, { dimColor: true, children: scrollable ? "\u2191\u2193 scroll \xB7 esc \xB7 ? close" : "esc \xB7 ? close" })
       ]
     }
   );
@@ -2251,13 +2283,13 @@ var ExplainModal = ({ item, login }) => /* @__PURE__ */ jsxs(
     paddingX: 1,
     width: Math.min(COLS, 78),
     children: [
-      /* @__PURE__ */ jsx(Text2, { color: "#FF8700", bold: true, children: `#${item.number} \xB7 ${item.repo}` }),
-      /* @__PURE__ */ jsx(Text2, { children: item.title }),
+      /* @__PURE__ */ jsx(Text3, { color: "#FF8700", bold: true, children: `#${item.number} \xB7 ${item.repo}` }),
+      /* @__PURE__ */ jsx(Text3, { children: item.title }),
       explainItem(item, login).map((section) => /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
-        /* @__PURE__ */ jsx(Text2, { bold: true, dimColor: true, children: section.heading }),
-        section.lines.map((line, i) => /* @__PURE__ */ jsx(Text2, { children: "  " + line }, i))
+        /* @__PURE__ */ jsx(Text3, { bold: true, dimColor: true, children: section.heading }),
+        section.lines.map((line, i) => /* @__PURE__ */ jsx(Text3, { children: "  " + line }, i))
       ] }, section.heading)),
-      /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(Text2, { dimColor: true, children: "esc \xB7 e close" }) })
+      /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(Text3, { dimColor: true, children: "esc \xB7 e close" }) })
     ]
   }
 );
@@ -2283,21 +2315,21 @@ var RepoPicker = ({
       paddingX: 1,
       minWidth: 42,
       children: [
-        /* @__PURE__ */ jsx(Text2, { color: "cyan", bold: true, children: `Filter by repo  (${selected.size} on)` }),
-        /* @__PURE__ */ jsx(Text2, { dimColor: true, children: "\u2500".repeat(36) }),
+        /* @__PURE__ */ jsx(Text3, { color: "cyan", bold: true, children: `Filter by repo  (${selected.size} on)` }),
+        /* @__PURE__ */ jsx(Text3, { dimColor: true, children: "\u2500".repeat(36) }),
         visible.map((repo, i) => {
           const idx = start + i;
           const on = selected.has(repo);
           const active = idx === cursor;
           return /* @__PURE__ */ jsxs(Box, { children: [
-            /* @__PURE__ */ jsx(Text2, { color: "cyan", children: active ? "\u276F " : "  " }),
-            /* @__PURE__ */ jsx(Text2, { color: on ? "green" : void 0, children: on ? "\u25C9 " : "\u25CB " }),
-            /* @__PURE__ */ jsx(Text2, { bold: active, children: repo })
+            /* @__PURE__ */ jsx(Text3, { color: "cyan", children: active ? "\u276F " : "  " }),
+            /* @__PURE__ */ jsx(Text3, { color: on ? "green" : void 0, children: on ? "\u25C9 " : "\u25CB " }),
+            /* @__PURE__ */ jsx(Text3, { bold: active, children: repo })
           ] }, repo);
         }),
-        repos.length > budget ? /* @__PURE__ */ jsx(Text2, { dimColor: true, children: `  \u2026 ${repos.length} repos total` }) : null,
-        /* @__PURE__ */ jsx(Text2, { dimColor: true, children: "\u2500".repeat(36) }),
-        /* @__PURE__ */ jsx(Text2, { dimColor: true, children: "space toggle \xB7 a clear all \xB7 \u21B5/esc done" })
+        repos.length > budget ? /* @__PURE__ */ jsx(Text3, { dimColor: true, children: `  \u2026 ${repos.length} repos total` }) : null,
+        /* @__PURE__ */ jsx(Text3, { dimColor: true, children: "\u2500".repeat(36) }),
+        /* @__PURE__ */ jsx(Text3, { dimColor: true, children: "space toggle \xB7 a clear all \xB7 \u21B5/esc done" })
       ]
     }
   );
@@ -2334,7 +2366,8 @@ var BrowseScreen = ({
   leavingUrls,
   onLeave,
   transients,
-  onTabChange
+  onTabChange,
+  sidebar
 }) => {
   const { rows } = useWindowSize();
   const applyWork = (secs) => origin ? filterByOrigin(secs, origin.show, origin.match) : secs;
@@ -2434,6 +2467,9 @@ var BrowseScreen = ({
         out.add(s.id);
     return out;
   }, [localSections, transients]);
+  const [railOpen, setRailOpen] = useState(false);
+  const showRail = railOpen && !!sidebar;
+  const listCols = showRail ? COLS - SIDEBAR_COLS : COLS;
   const [sparkFrame, setSparkFrame] = useState(0);
   const sparkling = (mergedUrls?.length ?? 0) > 0 || (leavingUrls?.length ?? 0) > 0 || !!transients?.size && section.items.some((item) => transientOf(transients, item, section.id));
   useEffect(() => {
@@ -2534,6 +2570,10 @@ var BrowseScreen = ({
       setRepoPicker(true);
       return;
     }
+    if (input === "i" && sidebar) {
+      setRailOpen((open) => !open);
+      return;
+    }
     if (key.escape && search != null) {
       setSearch(null);
       return;
@@ -2819,6 +2859,9 @@ var BrowseScreen = ({
     ["\u2190\u2192", "tab"],
     ["\u21B5/d", "open"],
     ["m", "actions"],
+    // Advertised only where it does something, and named for what it
+    // shows rather than for the furniture: nobody wants "a sidebar".
+    ...sidebar ? [["i", railOpen ? "hide" : sidebar.title.toLowerCase()]] : [],
     ["?", "help"],
     ["q", "quit"]
   ];
@@ -2871,8 +2914,8 @@ var BrowseScreen = ({
         ),
         ciStatusState ? /* @__PURE__ */ jsx(CiStatusLine, { state: ciStatusState, job: ciJob }) : null,
         skippedForBudget ? /* @__PURE__ */ jsxs(Box, { marginBottom: 1, children: [
-          /* @__PURE__ */ jsx(Text2, { bold: true, color: "#FF8700", children: "  \u26A1 auto-refresh paused to save API budget" }),
-          /* @__PURE__ */ jsx(Text2, { dimColor: true, children: "   r refreshes anyway" })
+          /* @__PURE__ */ jsx(Text3, { bold: true, color: "#FF8700", children: "  \u26A1 auto-refresh paused to save API budget" }),
+          /* @__PURE__ */ jsx(Text3, { dimColor: true, children: "   r refreshes anyway" })
         ] }) : null,
         /* @__PURE__ */ jsx(Box, { marginBottom: 1, children: /* @__PURE__ */ jsx(
           Tabs,
@@ -2886,52 +2929,65 @@ var BrowseScreen = ({
           }
         ) }),
         search != null ? /* @__PURE__ */ jsxs(Box, { marginBottom: 1, children: [
-          /* @__PURE__ */ jsx(Text2, { color: "cyan", children: "  / " }),
-          /* @__PURE__ */ jsx(Text2, { children: search }),
-          searchInput ? /* @__PURE__ */ jsx(Text2, { color: "cyan", children: "\u258F" }) : null,
-          /* @__PURE__ */ jsx(Text2, { dimColor: true, children: `   ${matchCount} match${matchCount !== 1 ? "es" : ""}${searchInput ? "  \u21B5 accept \xB7 esc clear" : "  esc clear"}` })
+          /* @__PURE__ */ jsx(Text3, { color: "cyan", children: "  / " }),
+          /* @__PURE__ */ jsx(Text3, { children: search }),
+          searchInput ? /* @__PURE__ */ jsx(Text3, { color: "cyan", children: "\u258F" }) : null,
+          /* @__PURE__ */ jsx(Text3, { dimColor: true, children: `   ${matchCount} match${matchCount !== 1 ? "es" : ""}${searchInput ? "  \u21B5 accept \xB7 esc clear" : "  esc clear"}` })
         ] }) : repoFilter.size > 0 ? /* @__PURE__ */ jsxs(Box, { marginBottom: 1, children: [
-          /* @__PURE__ */ jsx(Text2, { color: "#FF8700", children: "  \u25C9 " }),
-          /* @__PURE__ */ jsx(Text2, { children: `${repoFilter.size} repo${repoFilter.size !== 1 ? "s" : ""}` }),
-          /* @__PURE__ */ jsx(Text2, { dimColor: true, children: "   f edit \xB7 esc clear" })
+          /* @__PURE__ */ jsx(Text3, { color: "#FF8700", children: "  \u25C9 " }),
+          /* @__PURE__ */ jsx(Text3, { children: `${repoFilter.size} repo${repoFilter.size !== 1 ? "s" : ""}` }),
+          /* @__PURE__ */ jsx(Text3, { dimColor: true, children: "   f edit \xB7 esc clear" })
         ] }) : null,
-        /* @__PURE__ */ jsxs(Box, { flexDirection: "column", minHeight: listHeight, children: [
-          /* @__PURE__ */ jsxs(Backdrop, { dimmed: !!overlay, absolute: !!overlay, height: listHeight, children: [
-            /* @__PURE__ */ jsx(Box, { flexDirection: "column", flexGrow: 1, children: visibleItems.map((item, i) => /* @__PURE__ */ jsx(
-              ItemRow,
-              {
-                item,
-                active: viewStart + i === cursor,
-                login,
-                merged: (item.kind === "pr" || item.kind === "issue") && !!mergedUrls?.includes(item.url),
-                leaving: (item.kind === "pr" || item.kind === "issue") && !!leavingUrls?.includes(item.url),
-                transient: transientOf(transients, item, section.id),
-                prefix: treePrefix(section.items, viewStart + i),
-                parent: item.kind === "task" && depthOf(section.items[viewStart + i + 1]) > depthOf(item),
-                sparkFrame,
-                gap: i > 0 && gapsAbove(section.items, viewStart + i)
-              },
-              `${viewStart + i}:${item.kind === "task" ? item.instanceKey ?? item.key : item.kind === "repo-header" ? `header:${item.repo}` : item.kind === "subgroup-header" ? `subgroup:${item.label}` : item.kind === "show-more" ? `show-more:${item.hidden[0]?.repo ?? i}` : item.kind === "show-less" ? `show-less:${item.toHide[0]?.repo ?? i}` : `${item.repo}/${item.number}`}`
-            )) }),
-            hasMore && /* @__PURE__ */ jsxs(Text2, { dimColor: true, children: [
-              "  ",
-              "\u2193 ",
-              section.items.length - viewStart - visibleCount,
-              " more"
-            ] })
-          ] }),
-          overlay ? /* @__PURE__ */ jsx(
+        /* @__PURE__ */ jsxs(Box, { children: [
+          /* @__PURE__ */ jsxs(
             Box,
             {
-              flexGrow: 1,
               flexDirection: "column",
-              justifyContent: "center",
-              alignItems: "center",
-              children: overlay
+              minHeight: listHeight,
+              width: showRail ? listCols : void 0,
+              flexShrink: 0,
+              children: [
+                /* @__PURE__ */ jsxs(Backdrop, { dimmed: !!overlay, absolute: !!overlay, height: listHeight, children: [
+                  /* @__PURE__ */ jsx(Box, { flexDirection: "column", flexGrow: 1, children: visibleItems.map((item, i) => /* @__PURE__ */ jsx(
+                    ItemRow,
+                    {
+                      item,
+                      active: viewStart + i === cursor,
+                      login,
+                      merged: (item.kind === "pr" || item.kind === "issue") && !!mergedUrls?.includes(item.url),
+                      leaving: (item.kind === "pr" || item.kind === "issue") && !!leavingUrls?.includes(item.url),
+                      transient: transientOf(transients, item, section.id),
+                      prefix: treePrefix(section.items, viewStart + i),
+                      parent: item.kind === "task" && depthOf(section.items[viewStart + i + 1]) > depthOf(item),
+                      sparkFrame,
+                      cols: listCols,
+                      gap: i > 0 && gapsAbove(section.items, viewStart + i)
+                    },
+                    `${viewStart + i}:${item.kind === "task" ? item.instanceKey ?? item.key : item.kind === "repo-header" ? `header:${item.repo}` : item.kind === "subgroup-header" ? `subgroup:${item.label}` : item.kind === "show-more" ? `show-more:${item.hidden[0]?.repo ?? i}` : item.kind === "show-less" ? `show-less:${item.toHide[0]?.repo ?? i}` : `${item.repo}/${item.number}`}`
+                  )) }),
+                  hasMore && /* @__PURE__ */ jsxs(Text3, { dimColor: true, children: [
+                    "  ",
+                    "\u2193 ",
+                    section.items.length - viewStart - visibleCount,
+                    " more"
+                  ] })
+                ] }),
+                overlay ? /* @__PURE__ */ jsx(
+                  Box,
+                  {
+                    flexGrow: 1,
+                    flexDirection: "column",
+                    justifyContent: "center",
+                    alignItems: "center",
+                    children: overlay
+                  }
+                ) : null
+              ]
             }
-          ) : null
+          ),
+          showRail && sidebar ? /* @__PURE__ */ jsx(SidePanel, { sidebar, height: listHeight }) : null
         ] }),
-        /* @__PURE__ */ jsx(Box, { marginTop: 1, children: flash ? /* @__PURE__ */ jsx(Text2, { color: "green", children: flash }) : /* @__PURE__ */ jsx(FooterHints, { hints }) })
+        /* @__PURE__ */ jsx(Box, { marginTop: 1, children: flash ? /* @__PURE__ */ jsx(Text3, { color: "green", children: flash }) : /* @__PURE__ */ jsx(FooterHints, { hints }) })
       ]
     }
   );
@@ -2947,7 +3003,7 @@ var NoRowsScreen = ({
   });
   return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
     /* @__PURE__ */ jsx(StatusMessage, { variant: reason === "empty" ? "info" : "error", children: reason === "empty" ? "Nothing open." : `Fetch failed \u2014 ${detail ?? "no reason reported"}` }),
-    reason === "empty" && detail ? /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(Text2, { dimColor: true, children: detail }) }) : null,
+    reason === "empty" && detail ? /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(Text3, { dimColor: true, children: detail }) }) : null,
     /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(
       FooterHints,
       {
@@ -3112,6 +3168,7 @@ var App = ({
     if (manual) setRefreshing(true);
     fetcher().then((fresh) => {
       if (fresh.budget) setBudget(fresh.budget);
+      if (fresh.sidebar !== void 0) setSidebar(fresh.sidebar);
       if (cacheKey) writeCache(cacheKey, fresh);
       setRefreshing(false);
       setFetchedAt(Date.now());
@@ -3222,6 +3279,7 @@ var App = ({
   const [budget, setBudget] = useState(
     () => cacheKey ? readCache(cacheKey)?.budget ?? null : null
   );
+  const [sidebar, setSidebar] = useState(void 0);
   const [skippedForBudget, setSkippedForBudget] = useState(false);
   const [mergedUrls, setMergedUrls] = useState([]);
   const [leavingUrls, setLeavingUrls] = useState([]);
@@ -3328,6 +3386,7 @@ var App = ({
         onLeave: markLeaving,
         transients,
         onTabChange: setVisibleTab,
+        sidebar,
         ciStatusState: hasCiStatus ? ciStatusState : void 0,
         ciJob,
         tabHelp,
@@ -3380,4 +3439,4 @@ var matchesFilter = (repo, filter) => {
 };
 var parsePatterns = (value) => value.split(",").map((p) => p.trim()).filter(Boolean);
 
-export { ActionMenu, App, COLS, CiStatusLine, CommentsPanel, HealthPanel, PIN_MARK, budgetNotice, buildActions, buildCheckoutCmd, checkoutDirs, clipboard, configureInbox, drillCmd, explainGhAction, explainItem, filterByOrigin, filterByRepos, filterBySearch, fitCount, gapsAbove, healthColor, healthDisplay, healthGlyph, healthLegend, inboxConfig, insertRepoHeaders, itermRun, jumpToRepo, jumpToRepoPane, layoutGHItems, matchesFilter, maxViewStart, moveCursor, openInTab, parsePatterns, profileOf, readCache, relativeTime, renderMarkdown, repoPriority, reposInSections, resetInboxConfig, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, signatureOf, sortByRecency, sortItems, toCiStatusState, topLevelCount, truncate, useActionMenu, whoseMove, windowCount, withHeaders, withoutItem, writeCache };
+export { ActionMenu, App, COLS, CiStatusLine, CommentsPanel, HealthPanel, PIN_MARK, SIDEBAR_COLS, SidePanel, budgetNotice, buildActions, buildCheckoutCmd, checkoutDirs, clipboard, configureInbox, drillCmd, explainGhAction, explainItem, filterByOrigin, filterByRepos, filterBySearch, fitCount, gapsAbove, healthColor, healthDisplay, healthGlyph, healthLegend, inboxConfig, insertRepoHeaders, itermRun, jumpToRepo, jumpToRepoPane, layoutGHItems, matchesFilter, maxViewStart, moveCursor, openInTab, parsePatterns, profileOf, readCache, relativeTime, renderMarkdown, repoPriority, reposInSections, resetInboxConfig, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, signatureOf, sortByRecency, sortItems, toCiStatusState, topLevelCount, truncate2 as truncate, useActionMenu, whoseMove, windowCount, withHeaders, withoutItem, writeCache };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kud/gh-ink",
-  "version": "0.37.0",
+  "version": "0.38.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",