@kud/gh-ink 0.18.0 → 0.20.0

package/dist/index.d.ts

@@ -172,8 +172,20 @@ type Action = {
     subActions?: Action[];
 };
 type JiraTransition = {
+    /** What the action menu shows. Yours to word; nothing matches on it. */
     label: string;
-    state: string;
+    /**
+     * The TRANSITION name, passed verbatim to `jira issue move`. Not the
+     * destination status, and the two are routinely different strings — jira-cli
+     * matches `t.name.toLowerCase() === wanted`, so a status name here matches no
+     * transition, the move silently does nothing, and the row simply does not
+     * budge. This field was called `state`, which is what invited exactly that:
+     * cockpit had `{ label: "UAT", state: "UAT" }` against an ACC workflow whose
+     * transition is named "Ready for QA" and whose status is "In Testing (QA)" —
+     * no "UAT" anywhere, and no error either.
+     */
+    transition: string;
+    /** Offered as a second step when the transition asks for a resolution. */
     resolutions?: string[];
 };
 declare const relativeTime: (iso: string) => string;
@@ -299,4 +311,59 @@ 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;
+};
+/** 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[];
+
+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 };

package/dist/index.js

@@ -606,9 +606,36 @@ var healthLegend = [
   ["merged", "Merged"],
   ["closed", "Closed"]
 ];
+
+// src/inbox/config.ts
+var EMPTY = {
+  repoPriority: [],
+  profiles: [],
+  cacheNamespace: "gh-ink"
+};
+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 CACHE_TTL_MS = 12e4;
 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 {
@@ -840,14 +867,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 +1020,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 +1073,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 +1129,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;
@@ -1309,7 +1328,7 @@ var buildActions = (item, login, showFlash, jiraBase, jiraKeyRe, jiraTransitions
         run: () => {
         },
         subActions: jiraTransitions.map(
-          ({ label, state, resolutions }) => resolutions && resolutions.length > 0 ? {
+          ({ label, transition, resolutions }) => resolutions && resolutions.length > 0 ? {
             label,
             hint: "",
             run: () => {
@@ -1319,7 +1338,7 @@ var buildActions = (item, login, showFlash, jiraBase, jiraKeyRe, jiraTransitions
               hint: "",
               run: () => {
                 showFlash(`\u22EF ${label} \xB7 ${resolution}\u2026`);
-                void quietly`jira issue move ${item.ticket} ${state} --resolution ${resolution}`.then(() => {
+                void quietly`jira issue move ${item.ticket} ${transition} --resolution ${resolution}`.then(() => {
                   showFlash(`\u2713 ${label} \xB7 ${resolution}`);
                   ext?.onActed?.();
                 }).catch(() => showFlash(`\u2717 Move to ${label} failed`));
@@ -1330,7 +1349,7 @@ var buildActions = (item, login, showFlash, jiraBase, jiraKeyRe, jiraTransitions
             hint: "",
             run: () => {
               showFlash(`\u22EF Moving to ${label}\u2026`);
-              void quietly`jira issue move ${item.ticket} ${state}`.then(() => {
+              void quietly`jira issue move ${item.ticket} ${transition}`.then(() => {
                 showFlash(`\u2713 Moved to ${label}`);
                 ext?.onActed?.();
               }).catch(() => showFlash(`\u2717 Move to ${label} failed`));
@@ -2427,7 +2446,7 @@ var BrowseScreen = ({
     if (input === "t" && activeItem && activeItem.kind === "task" && activeItem.ticket && jiraTransitions && jiraTransitions.length > 0) {
       const jiraKey = activeItem.ticket;
       const actions = jiraTransitions.map(
-        ({ label, state, resolutions }) => resolutions && resolutions.length > 0 ? {
+        ({ label, transition, resolutions }) => resolutions && resolutions.length > 0 ? {
           label,
           hint: "",
           run: () => {
@@ -2438,7 +2457,7 @@ var BrowseScreen = ({
             run: () => {
               menu.close();
               showFlash(`\u22EF ${label} \xB7 ${resolution}\u2026`);
-              quietly`jira issue move ${jiraKey} ${state} --resolution ${resolution}`.then(() => {
+              quietly`jira issue move ${jiraKey} ${transition} --resolution ${resolution}`.then(() => {
                 showFlash(`\u2713 ${label} \xB7 ${resolution}`);
                 onActed?.();
               }).catch(() => showFlash(`\u2717 Move to ${label} failed`));
@@ -2450,7 +2469,7 @@ var BrowseScreen = ({
           run: () => {
             menu.close();
             showFlash(`\u22EF Moving to ${label}\u2026`);
-            quietly`jira issue move ${jiraKey} ${state}`.then(() => {
+            quietly`jira issue move ${jiraKey} ${transition}`.then(() => {
               showFlash(`\u2713 Moved to ${label}`);
               onActed?.();
             }).catch(() => showFlash(`\u2717 Move to ${label} failed`));
@@ -2936,4 +2955,4 @@ 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 };
+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 };

package/package.json

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