@kud/gh-ink 0.20.0 → 0.21.0

package/dist/index.d.ts

@@ -350,6 +350,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 +379,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

@@ -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 });
@@ -2955,4 +2956,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.21.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",