@kud/gh-ink 0.20.0 → 0.22.0

package/dist/index.d.ts

@@ -268,7 +268,7 @@ declare const ActionMenu: ({ item, actions, cursor, }: {
     actions: Action[];
     cursor: number;
 }) => React.JSX.Element;
-declare const App: ({ fetcher, cacheKey, title, detailFor, isWorkRepo, initialIncludeWork, jiraBase, jiraKeyRe, jiraTransitions, workToggle, hasCiStatus, ciJob, ciFetcher, ciPollMs, watchPath, watchDebounceMs, extensions, tabHelp, emptyHint, }: {
+declare const App: ({ fetcher, cacheKey, title, detailFor, isWorkRepo, includeWork, jiraBase, jiraKeyRe, jiraTransitions, hasCiStatus, ciJob, ciFetcher, ciPollMs, watchPath, watchDebounceMs, extensions, tabHelp, emptyHint, }: {
     fetcher: () => Promise<{
         sections: Section[];
         login: string;
@@ -278,13 +278,21 @@ declare const App: ({ fetcher, cacheKey, title, detailFor, isWorkRepo, initialIn
     title?: string;
     detailFor?: (ctx: DetailContext) => React.ReactNode;
     isWorkRepo?: (repo: string) => boolean;
-    initialIncludeWork?: boolean;
+    /**
+     * Which side of the split to show, chosen ONCE by the host at launch — there
+     * is no in-app toggle. `undefined` means no split: every row stands.
+     *
+     * The host decides from where the command was run, so the answer is settled
+     * before the first paint and cannot change under the reader. A `w` key used to
+     * flip it mid-session, which meant the inbox could disagree with the scope the
+     * command had been started in, with nothing on screen explaining why.
+     */
+    includeWork?: boolean;
     tabHelp?: [string, string][];
     emptyHint?: string;
     jiraBase?: string;
     jiraKeyRe?: RegExp;
     jiraTransitions?: JiraTransition[];
-    workToggle?: boolean;
     hasCiStatus?: boolean;
     ciJob?: string;
     ciFetcher?: () => Promise<CiStatus | null>;
@@ -350,6 +358,19 @@ type InboxConfig = {
      * one machine would otherwise share a cache keyed only by section name.
      */
     cacheNamespace: string;
+    /**
+     * How long a cached inbox is trusted before a launch refetches. Every launch
+     * past it pays the full query — eight searches with check rollups — so this is
+     * the single knob between "always current" and "always slow, and drawing 502s
+     * from the API".
+     *
+     * It can be generous because staleness is bounded from the other end: acting
+     * on a row drops the entry outright, and `r` refetches on demand. What the TTL
+     * actually governs is how long a change made ELSEWHERE — someone approving
+     * your PR while you were not looking — can go unseen, which is a glance
+     * arriving late, not a wrong action taken.
+     */
+    cacheTtlMs: number;
 };
 /** Supply the host's opinions. Call once, before rendering. */
 declare const configureInbox: (config: Partial<InboxConfig>) => void;
@@ -366,4 +387,23 @@ declare const profileOf: (repo: string) => RepoProfile | null;
  */
 declare const checkoutDirs: () => 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 InboxConfig, type InboxExtension, type JiraTransition, type RepoHeader, type RepoProfile, type Section, type ShowLess, type ShowMore, type Standing, type SubgroupHeader, type TaskRow, buildActions, buildCheckoutCmd, checkoutDirs, clipboard, configureInbox, drillCmd, explainItem, filterByOrigin, filterByRepos, filterBySearch, fitCount, healthColor, healthDisplay, healthGlyph, healthLegend, inboxConfig, insertRepoHeaders, itermRun, jumpToRepo, jumpToRepoPane, layoutGHItems, maxViewStart, moveCursor, openInTab, profileOf, readCache, relativeTime, renderMarkdown, repoPriority, reposInSections, resetInboxConfig, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, sortByRecency, sortItems, toCiStatusState, topLevelCount, truncate, useActionMenu, whoseMove, windowCount, withHeaders, withoutItem, writeCache };
+type RepoFilter = {
+    /** Show only repos matching one of these. Empty or absent means show all. */
+    include?: readonly string[];
+    /** Hide repos matching one of these. Applied after include, and wins. */
+    exclude?: readonly string[];
+};
+/**
+ * Whether a repo survives the filter. No include list means everything is in;
+ * exclude is applied afterwards and always wins, so a reader can take a whole
+ * org and drop one repo from it without listing the rest.
+ */
+declare const matchesFilter: (repo: string, filter: RepoFilter) => boolean;
+/**
+ * Parse a comma-separated pattern list, as a flag supplies it. Blank entries and
+ * surrounding whitespace are dropped, so a trailing comma or a quoted list with
+ * spaces after the commas both behave.
+ */
+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 InboxConfig, type InboxExtension, type JiraTransition, type RepoFilter, type RepoHeader, type RepoProfile, type Section, type ShowLess, type ShowMore, type Standing, type SubgroupHeader, type TaskRow, buildActions, buildCheckoutCmd, checkoutDirs, clipboard, configureInbox, drillCmd, explainItem, filterByOrigin, filterByRepos, filterBySearch, fitCount, 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, sortByRecency, sortItems, toCiStatusState, topLevelCount, truncate, useActionMenu, whoseMove, windowCount, withHeaders, withoutItem, writeCache };

package/dist/index.js

@@ -1,6 +1,6 @@
 import React2, { createContext, useState, useRef, useEffect, useMemo, useContext } from 'react';
 import { useWindowSize, useInput, Text, Box } from 'ink';
-import { colors, ScrollView, TextInput, LoadingScreen, Switch, StatusMessage, FooterHints, useListCursor, Tabs } from '@kud/ink-ui';
+import { colors, ScrollView, TextInput, LoadingScreen, StatusMessage, FooterHints, useListCursor, Tabs } from '@kud/ink-ui';
 import { isPassCheck, isFailCheck, resolveThread, unresolveThread, replyToThread, rerunFailedRun, mergePr, reRequestReviewer } from '@kud/gh';
 import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
 import { $ } from 'zx';
@@ -611,7 +611,8 @@ var healthLegend = [
 var EMPTY = {
   repoPriority: [],
   profiles: [],
-  cacheNamespace: "gh-ink"
+  cacheNamespace: "gh-ink",
+  cacheTtlMs: 6e5
 };
 var current = EMPTY;
 var configureInbox = (config) => {
@@ -630,7 +631,7 @@ var checkoutDirs = () => [
 ];
 
 // src/inbox/cache.ts
-var CACHE_TTL_MS = 12e4;
+var cacheTtlMs = () => inboxConfig().cacheTtlMs;
 var CACHE_VERSION = 2;
 var cacheDir = () => join(
   process.env.XDG_CACHE_HOME || join(homedir(), ".cache"),
@@ -647,7 +648,7 @@ var readCache = (key) => {
     return null;
   }
 };
-var isFresh = (cached, now = Date.now()) => !!cached && now - cached.at < CACHE_TTL_MS;
+var isFresh = (cached, now = Date.now()) => !!cached && now - cached.at < cacheTtlMs();
 var writeCache = (key, data) => {
   try {
     mkdirSync(cacheDir(), { recursive: true });
@@ -1284,6 +1285,20 @@ var drillLabel = (item) => {
   if (item.kind === "pr") return "Open PR";
   return "Drill in";
 };
+var UNSUBSCRIBE_MUTATION = `
+  mutation($id: ID!) {
+    updateSubscription(input: { subscribableId: $id, state: UNSUBSCRIBED }) {
+      subscribable { viewerSubscription }
+    }
+  }
+`;
+var unsubscribeFrom = async (item) => {
+  const view = item.kind === "pr" ? "pr" : "issue";
+  const found = await quietly`gh ${view} view ${item.number} --repo ${item.repo} --json id --jq .id`;
+  const id = found.stdout.trim();
+  if (!id) throw new Error(`no node id for ${item.repo}#${item.number}`);
+  await quietly`gh api graphql -f query=${UNSUBSCRIBE_MUTATION} -f id=${id}`;
+};
 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 [];
@@ -1369,6 +1384,14 @@ var buildActions = (item, login, showFlash, jiraBase, jiraKeyRe, jiraTransitions
       showFlash(`\u2713 Copied ${item.repo}`);
     }
   });
+  actions.push({
+    label: "Unsubscribe",
+    hint: "u",
+    run: () => {
+      showFlash(`\u22EF Unsubscribing from #${item.number}\u2026`);
+      void unsubscribeFrom(item).then(() => showFlash(`\u2713 Unsubscribed from #${item.number}`)).catch(() => showFlash(`\u2717 Unsubscribe failed for #${item.number}`));
+    }
+  });
   if (item.kind === "pr" && item.branch) {
     actions.push({
       label: "Copy branch name",
@@ -1556,7 +1579,7 @@ var InboxHeader = ({
   const total = sections.reduce((n, s) => n + topLevelCount(s), 0);
   const countSeg = loading ? "      loading\u2026  " : quiet ? "  " : `  ${String(total).padStart(3)} item${total !== 1 ? "s" : ""}  \xB7  `;
   const userSeg = loading || quiet ? "" : `@${login}  `;
-  const workLabel = work === void 0 ? "" : " w work \u25CF\u2500\u25CB home  ";
+  const workLabel = work === void 0 ? "" : `  ${work ? "work" : "home"}  `;
   const [statusText, statusColor] = hasPending ? [`\u25CF ${pendingSummary || "new"} \xB7 r apply`, "#FF8700"] : refreshing ? ["\u21BB refreshing\u2026", "cyan"] : fetchedAt ? [`updated ${agoText(fetchedAt)}`, void 0] : ["", void 0];
   const statusSeg = statusText ? statusText + "  " : "";
   const fill = Math.max(
@@ -1567,11 +1590,7 @@ var InboxHeader = ({
     /* @__PURE__ */ jsx(Text2, { color: "#FF8700", bold: true, children: brand }),
     /* @__PURE__ */ jsx(Text2, { dimColor: true, children: countSeg }),
     userSeg ? /* @__PURE__ */ jsx(Text2, { children: userSeg }) : null,
-    work !== void 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [
-      /* @__PURE__ */ jsx(Text2, { dimColor: true, children: " w " }),
-      /* @__PURE__ */ jsx(Switch, { left: "work", right: "home", value: work ? "left" : "right" }),
-      /* @__PURE__ */ jsx(Text2, { dimColor: true, children: "  " })
-    ] }) : null,
+    work !== void 0 ? /* @__PURE__ */ jsx(Text2, { dimColor: true, children: workLabel }) : null,
     statusText ? /* @__PURE__ */ jsx(
       Text2,
       {
@@ -1857,7 +1876,6 @@ var LegendGroup = ({
 ] });
 var LEGEND_FOOTNOTE = "Each item lands in the FIRST tab that claims it, so counts are residuals rather than totals.";
 var HelpModal = ({
-  workToggle,
   extensions,
   hasJira,
   tabHelp,
@@ -1882,11 +1900,11 @@ var HelpModal = ({
     ["s", "switch to branch here"],
     ["j", "open repo in new tab"],
     ["p", "open repo in new pane"],
+    ["u", "unsubscribe from this item"],
     ...hasJira ? [["t", "Jira: move / open ticket"]] : [],
     ["/", "search"],
     ["f", "filter by repo"],
     ["r", "refresh"],
-    ...workToggle ? [["w", "toggle work / home"]] : [],
     ...extensionLegend(extensions),
     ["?", "this help"],
     ["q", "quit"]
@@ -2063,7 +2081,6 @@ var BrowseScreen = ({
   pendingSummary,
   fetchedAt,
   refreshError,
-  workToggle,
   hidden,
   onOpenPr,
   onOpenIssue,
@@ -2073,18 +2090,15 @@ var BrowseScreen = ({
   ciJob,
   tabHelp,
   isWorkRepo,
-  initialIncludeWork,
+  includeWork,
   brand,
   mergedUrls,
   transients,
   onTabChange
 }) => {
   const { rows } = useWindowSize();
-  const [includeWork, setIncludeWork] = useState(
-    () => workToggle ? initialIncludeWork ?? true : true
-  );
-  const applyWork = (secs, include) => !workToggle || !isWorkRepo ? secs : filterByOrigin(secs, include ? "work" : "home", isWorkRepo);
-  const initialSections = applyWork(sections, includeWork);
+  const applyWork = (secs) => includeWork === void 0 || !isWorkRepo ? secs : filterByOrigin(secs, includeWork ? "work" : "home", isWorkRepo);
+  const initialSections = applyWork(sections);
   const [localSections, setLocalSections] = useState(initialSections);
   const [tabIdx, setTabIdx] = useState(0);
   const [cursors, setCursors] = useState(
@@ -2120,7 +2134,7 @@ var BrowseScreen = ({
     setViewStarts((p) => ({ ...p, [activeId]: 0 }));
   }, [search]);
   useEffect(() => {
-    setLocalSections(applyWork(sections, includeWork));
+    setLocalSections(applyWork(sections));
   }, [sections]);
   useEffect(() => {
     setTabIdx((prev) => Math.min(prev, Math.max(0, localSections.length - 1)));
@@ -2314,15 +2328,6 @@ var BrowseScreen = ({
       onRefresh?.();
       return;
     }
-    if (workToggle && input === "w") {
-      const next = !includeWork;
-      const nextSections = applyWork(sections, next);
-      const keptIdx = nextSections.findIndex((s) => s.id === activeId);
-      setIncludeWork(next);
-      setLocalSections(nextSections);
-      if (keptIdx >= 0) setTabIdx(keptIdx);
-      return;
-    }
     const ext = extensionFor(input, extensions);
     if (ext) {
       onOpenExt?.(ext.id, {
@@ -2413,6 +2418,11 @@ var BrowseScreen = ({
       }
       return;
     }
+    if (input === "u" && (activeItem.kind === "pr" || activeItem.kind === "issue")) {
+      showFlash(`\u22EF Unsubscribing from #${activeItem.number}\u2026`);
+      void unsubscribeFrom(activeItem).then(() => showFlash(`\u2713 Unsubscribed from #${activeItem.number}`)).catch(() => showFlash(`\u2717 Unsubscribe failed for #${activeItem.number}`));
+      return;
+    }
     if (input === "b" && activeItem.kind === "pr" && activeItem.branch) {
       clipboard(activeItem.branch);
       showFlash(`\u2713 Copied ${activeItem.branch}`);
@@ -2494,7 +2504,6 @@ var BrowseScreen = ({
   const overlay = help ? /* @__PURE__ */ jsx(
     HelpModal,
     {
-      workToggle,
       extensions,
       hasJira: !!jiraBase,
       tabHelp,
@@ -2526,7 +2535,7 @@ var BrowseScreen = ({
             brand,
             sections: localSections,
             login,
-            work: workToggle ? includeWork : void 0,
+            work: includeWork,
             refreshing,
             hasPending,
             pendingSummary,
@@ -2638,11 +2647,10 @@ var App = ({
   title = "inbox",
   detailFor,
   isWorkRepo,
-  initialIncludeWork,
+  includeWork,
   jiraBase,
   jiraKeyRe,
   jiraTransitions,
-  workToggle,
   hasCiStatus,
   ciJob,
   ciFetcher,
@@ -2851,7 +2859,7 @@ var App = ({
               brand: brandOf(title),
               sections: [],
               login: "",
-              work: workToggle && state.phase === "loading" ? initialIncludeWork ?? true : void 0,
+              work: state.phase === "loading" ? includeWork : void 0,
               loading: state.phase === "loading",
               quiet: state.phase !== "loading"
             }
@@ -2910,9 +2918,8 @@ var App = ({
         pendingSummary,
         fetchedAt,
         refreshError: refreshError ?? void 0,
-        workToggle,
         isWorkRepo,
-        initialIncludeWork,
+        includeWork,
         hidden: overlay !== null,
         mergedUrls,
         transients,
@@ -2955,4 +2962,18 @@ var App = ({
   ] });
 };
 
-export { ActionMenu, App, COLS, CiStatusLine, CommentsPanel, HealthPanel, buildActions, buildCheckoutCmd, checkoutDirs, clipboard, configureInbox, drillCmd, explainItem, filterByOrigin, filterByRepos, filterBySearch, fitCount, healthColor, healthDisplay, healthGlyph, healthLegend, inboxConfig, insertRepoHeaders, itermRun, jumpToRepo, jumpToRepoPane, layoutGHItems, maxViewStart, moveCursor, openInTab, profileOf, readCache, relativeTime, renderMarkdown, repoPriority, reposInSections, resetInboxConfig, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, sortByRecency, sortItems, toCiStatusState, topLevelCount, truncate, useActionMenu, whoseMove, windowCount, withHeaders, withoutItem, writeCache };
+// src/inbox/filter.ts
+var toRegExp = (pattern) => {
+  const full = pattern.includes("/") ? pattern : `${pattern}/*`;
+  const escaped = full.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+  return new RegExp(`^${escaped.replace(/\*/g, "[^/]*")}$`, "i");
+};
+var matchesAny = (repo, patterns) => patterns.some((p) => toRegExp(p).test(repo));
+var matchesFilter = (repo, filter) => {
+  const { include = [], exclude = [] } = filter;
+  if (include.length > 0 && !matchesAny(repo, include)) return false;
+  return !matchesAny(repo, exclude);
+};
+var parsePatterns = (value) => value.split(",").map((p) => p.trim()).filter(Boolean);
+
+export { ActionMenu, App, COLS, CiStatusLine, CommentsPanel, HealthPanel, buildActions, buildCheckoutCmd, checkoutDirs, clipboard, configureInbox, drillCmd, explainItem, filterByOrigin, filterByRepos, filterBySearch, fitCount, 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, sortByRecency, sortItems, toCiStatusState, topLevelCount, truncate, useActionMenu, whoseMove, windowCount, withHeaders, withoutItem, writeCache };

package/package.json

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