@kud/gh-ink 0.19.0 → 0.21.0

package/dist/index.d.ts

@@ -311,4 +311,91 @@ declare const writeCache: (key: string, data: {
     login: string;
 }) => void;
 
-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 InboxExtension, type JiraTransition, type RepoHeader, type Section, type ShowLess, type ShowMore, type Standing, type SubgroupHeader, type TaskRow, buildActions, buildCheckoutCmd, clipboard, drillCmd, explainItem, filterByOrigin, filterByRepos, filterBySearch, fitCount, healthColor, healthDisplay, healthGlyph, healthLegend, insertRepoHeaders, itermRun, jumpToRepo, jumpToRepoPane, layoutGHItems, maxViewStart, moveCursor, openInTab, readCache, relativeTime, renderMarkdown, repoPriority, reposInSections, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, sortByRecency, sortItems, toCiStatusState, topLevelCount, truncate, useActionMenu, whoseMove, windowCount, withHeaders, withoutItem, writeCache };
+/**
+ * A named slice of the reader's repos. Two or more turn on the in-app toggle;
+ * one or none means an undivided set and no toggle at all.
+ *
+ * Named rather than boolean because the distinction was never a property of a
+ * repo — it is whatever separation the reader actually keeps, and a boolean
+ * leaves a third slice nowhere to go.
+ */
+type RepoProfile = {
+    /** Stable id — what `--profile=<name>` selects. */
+    name: string;
+    /** Shown on the toggle. Defaults to `name`. */
+    label?: string;
+    /** Which repos belong to this profile. */
+    match: (repo: string) => boolean;
+    /** Where this profile's checkouts live, if it keeps its own directory. */
+    checkoutDir?: string;
+};
+type InboxConfig = {
+    /**
+     * Repo ranking, best first. An entry ending in `/` matches by owner prefix,
+     * anything else must equal `owner/name` exactly — so a single repo can outrank
+     * the owner that contains it. Repos matching nothing sort last, together.
+     */
+    repoPriority: readonly string[];
+    profiles: readonly RepoProfile[];
+    /**
+     * Fallback directory holding checkouts, for repos in no profile that names one
+     * of its own. Unset means local checkouts are not resolved at all, which is
+     * correct for a host that only ever opens things in a browser.
+     */
+    checkoutDir?: string;
+    /**
+     * Directory name the on-disk cache lives under, inside the platform cache
+     * root. Defaults to this package's name — a library has no business claiming a
+     * directory named after whichever tool happens to embed it, and two hosts on
+     * 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;
+declare const inboxConfig: () => InboxConfig;
+/** Test seam — restores the empty defaults. */
+declare const resetInboxConfig: () => void;
+/** The profile a repo belongs to, or null when none claims it. */
+declare const profileOf: (repo: string) => RepoProfile | null;
+/**
+ * Where checkouts are searched, in order: every profile that names its own
+ * directory, then the fallback. Deduped, since the ordinary single-directory
+ * case points them all at the same place. Empty when nothing is configured —
+ * callers treat that as "not checked out locally", which it truthfully is.
+ */
+declare const checkoutDirs: () => string[];
+
+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

@@ -606,9 +606,37 @@ var healthLegend = [
   ["merged", "Merged"],
   ["closed", "Closed"]
 ];
-var CACHE_TTL_MS = 12e4;
+
+// src/inbox/config.ts
+var EMPTY = {
+  repoPriority: [],
+  profiles: [],
+  cacheNamespace: "gh-ink",
+  cacheTtlMs: 6e5
+};
+var current = EMPTY;
+var configureInbox = (config) => {
+  current = { ...EMPTY, ...config };
+};
+var inboxConfig = () => current;
+var resetInboxConfig = () => {
+  current = EMPTY;
+};
+var profileOf = (repo) => current.profiles.find((p) => p.match(repo)) ?? null;
+var checkoutDirs = () => [
+  .../* @__PURE__ */ new Set([
+    ...current.profiles.flatMap((p) => p.checkoutDir ?? []),
+    ...current.checkoutDir ? [current.checkoutDir] : []
+  ])
+];
+
+// src/inbox/cache.ts
+var cacheTtlMs = () => inboxConfig().cacheTtlMs;
 var CACHE_VERSION = 2;
-var cacheDir = () => join(process.env.XDG_CACHE_HOME || join(homedir(), ".cache"), "ambre");
+var cacheDir = () => join(
+  process.env.XDG_CACHE_HOME || join(homedir(), ".cache"),
+  inboxConfig().cacheNamespace
+);
 var cacheFile = (key) => join(cacheDir(), `${key.replace(/[^a-z0-9._-]/gi, "-")}.json`);
 var readCache = (key) => {
   try {
@@ -620,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 });
@@ -840,14 +868,11 @@ var explainItem = (item, login) => {
   ];
 };
 var repoPriority = (repo) => {
-  const profile = process.env.OS_PROFILE ?? "";
-  if (profile === "work") {
-    if (repo === "theorchard/orchardgo") return 0;
-    if (repo.startsWith("theorchard/")) return 1;
-    if (repo.startsWith("kud/")) return 2;
-    return 3;
-  }
-  return repo.startsWith("kud/") ? 0 : 1;
+  const order = inboxConfig().repoPriority;
+  const i = order.findIndex(
+    (p) => p.endsWith("/") ? repo.startsWith(p) : repo === p
+  );
+  return i === -1 ? order.length : i;
 };
 var sortItems = (items) => [...items].sort((a, b) => {
   const pd = repoPriority(a.repo) - repoPriority(b.repo);
@@ -996,11 +1021,11 @@ var reposInSections = (sections) => [
     sections.flatMap((s) => s.items).filter((i) => i.kind === "pr" || i.kind === "issue").map((i) => i.repo)
   )
 ].sort();
-var moveCursor = (items, current, dir) => {
-  let next = current + dir;
+var moveCursor = (items, current2, dir) => {
+  let next = current2 + dir;
   while (next >= 0 && next < items.length && (items[next].kind === "repo-header" || items[next].kind === "subgroup-header"))
     next += dir;
-  if (next < 0 || next >= items.length) return current;
+  if (next < 0 || next >= items.length) return current2;
   return next;
 };
 var itemLines = (item, isFirst) => (item.kind === "repo-header" || item.kind === "subgroup-header") && !isFirst ? 2 : 1;
@@ -1049,11 +1074,8 @@ var clipboard = (text) => {
 };
 var buildCheckoutCmd = async (repoFull, branch, login) => {
   const [repoOwner, repoName] = repoFull.split("/");
-  const projects = process.env.PROJECTS_DIR ?? `${process.env.HOME}/Projects`;
-  const profile = process.env.OS_PROFILE ?? "";
-  const isWorkRepo = profile === "work" && (repoFull.startsWith("theorchard/") || repoFull.startsWith("kud/") && (repoName ?? "").startsWith("theorchard-"));
-  const cloneBase = profile === "work" ? `${projects}/${isWorkRepo ? "work" : "home"}` : projects;
-  const searchDirs = profile === "work" ? [`${projects}/work`, `${projects}/home`] : [projects];
+  const searchDirs = checkoutDirs();
+  const cloneBase = profileOf(repoFull)?.checkoutDir ?? inboxConfig().checkoutDir ?? "";
   let repoPath = "";
   outer: for (const searchDir of searchDirs) {
     if (!existsSync(searchDir)) continue;
@@ -1108,9 +1130,7 @@ var buildCheckoutCmd = async (repoFull, branch, login) => {
   return cmd;
 };
 var resolveRepoPath = async (repoFull) => {
-  const projects = process.env.PROJECTS_DIR ?? `${process.env.HOME}/Projects`;
-  const profile = process.env.OS_PROFILE ?? "";
-  const searchDirs = profile === "work" ? [`${projects}/work`, `${projects}/home`] : [projects];
+  const searchDirs = checkoutDirs();
   for (const searchDir of searchDirs) {
     if (!existsSync(searchDir)) continue;
     let entries;
@@ -2936,4 +2956,18 @@ var App = ({
   ] });
 };
 
-export { ActionMenu, App, COLS, CiStatusLine, CommentsPanel, HealthPanel, buildActions, buildCheckoutCmd, clipboard, drillCmd, explainItem, filterByOrigin, filterByRepos, filterBySearch, fitCount, healthColor, healthDisplay, healthGlyph, healthLegend, insertRepoHeaders, itermRun, jumpToRepo, jumpToRepoPane, layoutGHItems, maxViewStart, moveCursor, openInTab, readCache, relativeTime, renderMarkdown, repoPriority, reposInSections, 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.19.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",