@kud/gh-cockpit 0.0.0

package/dist/index.js

@@ -0,0 +1,624 @@
+import { __export, withRetry, toGHItem, signalPath, computeHealth, buildInboxQuery, lib_exports, AiLauncher, seedPromptFor, CopyPromptNotice, DrillView, __reExport } from './chunk-A3NXVFEI.js';
+export { buildInboxQuery, computeHealth, signalPath, toGHItem, withRetry } from './chunk-A3NXVFEI.js';
+import { parsePatterns, HealthPanel, CommentsPanel, inboxConfig } from '@kud/gh-ink';
+import { $ } from 'zx';
+import { useState, useEffect } from 'react';
+import { useInput, Box, Text } from 'ink';
+import { useTabs, Tabs, useListCursor, colors, ScrollView } from '@kud/ink-ui';
+import { fetchHealth, fetchPrComments } from '@kud/gh';
+import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
+import { readFileSync, mkdirSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  IssueView: () => IssueView,
+  PrView: () => PrView,
+  buildInboxQuery: () => buildInboxQuery,
+  checkDrillFor: () => checkDrillFor,
+  computeHealth: () => computeHealth,
+  defineCockpit: () => defineCockpit,
+  detailFor: () => detailFor,
+  hasPatterns: () => hasPatterns,
+  parseArgs: () => parseArgs,
+  registerCheckDrills: () => registerCheckDrills,
+  signalPath: () => signalPath,
+  toGHItem: () => toGHItem,
+  withRetry: () => withRetry
+});
+
+// src/config.ts
+var defineCockpit = (config) => config;
+var parseArgs = (argv) => {
+  const include = [];
+  const exclude = [];
+  let here = false;
+  let named;
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--here") {
+      here = true;
+      continue;
+    }
+    const eq = arg.match(/^--(include|exclude)=(.*)$/);
+    if (eq) {
+      (eq[1] === "include" ? include : exclude).push(...parsePatterns(eq[2]));
+      continue;
+    }
+    if (arg === "--include" || arg === "--exclude") {
+      const next = argv[i + 1];
+      if (next === void 0 || next.startsWith("-")) continue;
+      i++;
+      (arg === "--include" ? include : exclude).push(...parsePatterns(next));
+      continue;
+    }
+    if (!arg.startsWith("-") && !named) named = arg;
+  }
+  return {
+    here,
+    named,
+    filter: { include, exclude }
+  };
+};
+var hasPatterns = (f) => (f.include?.length ?? 0) > 0 || (f.exclude?.length ?? 0) > 0;
+
+// src/views/check-drill.tsx
+var registered = [];
+var registerCheckDrills = (drills) => {
+  registered = drills;
+};
+var checkDrillFor = (url) => registered.find((d) => d.match(url)) ?? null;
+var fetchComments = async (repo, number, kind = "pr") => {
+  if (kind === "issue") return fetchIssueConversation(repo, number);
+  const [owner, name] = repo.split("/");
+  return fetchPrComments(owner, name, number);
+};
+var ISSUE_QUERY = `query($owner: String!, $name: String!, $number: Int!) {
+  repository(owner: $owner, name: $name) {
+    issue(number: $number) {
+      comments(first: 50) { nodes { author { login } body createdAt url } }
+    }
+  }
+}`;
+var fetchIssueConversation = async (repo, number) => {
+  const [owner, name] = repo.split("/");
+  const [body, rest] = await Promise.all([
+    fetchBody("issue", repo, number),
+    $`gh api graphql -f query=${ISSUE_QUERY} -f owner=${owner} -f name=${name} -F number=${number}`.quiet()
+  ]);
+  const nodes = JSON.parse(rest.stdout).data.repository.issue.comments.nodes;
+  const comments = nodes.map((c) => ({
+    author: c.author?.login ?? "ghost",
+    body: (c.body ?? "").trim(),
+    createdAt: c.createdAt,
+    url: c.url
+  }));
+  return {
+    headRef: "",
+    conversation: body ? [body, ...comments] : comments,
+    threads: []
+  };
+};
+var fetchBody = async (kind, repo, number) => {
+  try {
+    const { stdout } = await $`gh ${kind} view ${number} --repo ${repo} --json body,author,createdAt`.quiet();
+    const node = JSON.parse(stdout);
+    const text = (node.body ?? "").trim();
+    return text ? {
+      author: node.author?.login ?? "",
+      body: text,
+      createdAt: node.createdAt
+    } : null;
+  } catch {
+    return null;
+  }
+};
+var jobIdOf = (url) => url?.match(/\/job\/(\d+)/)?.[1] ?? null;
+var stripTimestamp = (line) => line.replace(/^\d{4}-\d\d-\d\dT[\d:.]+Z\s?/, "").replace(/\s+$/, "");
+var colorFor = (clean) => {
+  const lower = clean.toLowerCase();
+  if (/(^|\W)(error|fail(ed|ure)?)\b/.test(lower)) return colors.error;
+  if (/(^|\W)warn(ing)?\b/.test(lower)) return colors.warning;
+  return void 0;
+};
+var processLog = (raw) => {
+  const lines = [];
+  let firstError = -1;
+  for (const l of raw) {
+    const clean = stripTimestamp(l);
+    const cmd = clean.match(/^##\[(\w+)\](.*)$/);
+    if (cmd) {
+      const [, kind, rest] = cmd;
+      if (kind === "endgroup") continue;
+      if (kind === "group") {
+        lines.push({ text: "\u25B8 " + rest, dim: true, bold: true });
+      } else if (kind === "error") {
+        if (firstError < 0) firstError = lines.length;
+        lines.push({ text: rest, color: colors.error });
+      } else if (kind === "warning") {
+        lines.push({ text: rest, color: colors.warning });
+      } else {
+        lines.push({ text: rest, dim: true });
+      }
+      continue;
+    }
+    lines.push({ text: clean, color: colorFor(clean) });
+  }
+  const jumpTo = firstError >= 0 ? Math.max(0, firstError - 3) : Math.max(0, lines.length - 1);
+  return { lines, jumpTo };
+};
+var CheckLogView = ({
+  repo,
+  jobId,
+  name,
+  url,
+  onBack
+}) => {
+  const [state, setState] = useState({ phase: "loading" });
+  useEffect(() => {
+    let live = true;
+    $`gh api repos/${repo}/actions/jobs/${jobId}/logs`.quiet().then(
+      (r) => live && setState({ phase: "ready", lines: r.stdout.split("\n") })
+    ).catch(
+      (e) => live && setState({ phase: "error", message: e.message })
+    );
+    return () => {
+      live = false;
+    };
+  }, [repo, jobId]);
+  useInput((input, key) => {
+    if (key.escape || input === "q") return onBack();
+    if (input === "o" && url) $`open ${url}`.catch(() => {
+    });
+  });
+  let lines = [];
+  let jumpTo = 0;
+  if (state.phase === "loading")
+    lines = [{ text: "Fetching log\u2026", color: colors.info }];
+  else if (state.phase === "error")
+    lines = [{ text: `Error: ${state.message}`, color: colors.error }];
+  else ({ lines, jumpTo } = processLog(state.lines));
+  return /* @__PURE__ */ jsx(
+    DrillView,
+    {
+      title: `${name}  \u2014 log`,
+      subtitle: state.phase === "ready" ? `${state.lines.length} lines` : void 0,
+      hints: [
+        ["\u2191\u2193/space", "scroll"],
+        ["g/G", "top/tail"],
+        ["o", "open"],
+        ["q/esc", "back"]
+      ],
+      children: /* @__PURE__ */ jsx(ScrollView, { lines, initialStart: jumpTo })
+    }
+  );
+};
+var QUERY = `query($owner: String!, $name: String!, $number: Int!) {
+  repository(owner: $owner, name: $name) {
+    pullRequest(number: $number) {
+      reviewThreads(first: 100) { nodes { path line } }
+    }
+  }
+}`;
+var fetchFiles = async (repo, number) => {
+  const [owner, name] = repo.split("/");
+  const out = await $`gh api graphql -f query=${QUERY} -f owner=${owner} -f name=${name} -F number=${number}`.quiet();
+  const nodes = JSON.parse(out.stdout).data.repository.pullRequest.reviewThreads.nodes ?? [];
+  const seen = /* @__PURE__ */ new Map();
+  for (const n of nodes)
+    if (n.path && !seen.has(n.path))
+      seen.set(n.path, { path: n.path, line: n.line });
+  return [...seen.values()];
+};
+var openInEditor = async (repoPath, file) => {
+  const target = file.line ? `${file.path}:${file.line}` : file.path;
+  for (const ed of ["cursor", "code"]) {
+    if ((await $({ nothrow: true, quiet: true })`command -v ${ed}`).exitCode === 0) {
+      void $({
+        nothrow: true,
+        quiet: true
+      })`${ed} -g ${repoPath}/${target}`.catch(() => {
+      });
+      return ed;
+    }
+  }
+  const editor = process.env.EDITOR || "vi";
+  await (0, lib_exports.openInTab)(
+    `cd ${repoPath} && ${editor} ${file.line ? `+${file.line} ` : ""}${file.path}`
+  );
+  return editor;
+};
+var FilePicker = ({
+  repo,
+  number,
+  onBack
+}) => {
+  const [files, setFiles] = useState(null);
+  const [note, setNote] = useState(null);
+  useEffect(() => {
+    let live = true;
+    fetchFiles(repo, number).then((f) => live && setFiles(f)).catch((e) => live && setNote(e.message));
+    return () => {
+      live = false;
+    };
+  }, [repo, number]);
+  const list = files ?? [];
+  const { cursor } = useListCursor(list.length);
+  const safeCursor = Math.min(cursor, Math.max(0, list.length - 1));
+  const open = async (f) => {
+    setNote(`\u22EF resolving ${repo}\u2026`);
+    const repoPath = await (0, lib_exports.resolveRepoPath)(repo);
+    if (!repoPath) {
+      setNote(`\u2717 ${repo} isn't checked out locally`);
+      return;
+    }
+    const ed = await openInEditor(repoPath, f);
+    setNote(`\u2197 ${f.path}${f.line ? `:${f.line}` : ""} \u2014 ${ed}`);
+  };
+  useInput((input, key) => {
+    if (key.escape || input === "q") return onBack();
+    if (key.return && list[safeCursor]) void open(list[safeCursor]);
+  });
+  return /* @__PURE__ */ jsxs(
+    DrillView,
+    {
+      title: `Files \xB7 #${number} \xB7 ${repo}`,
+      subtitle: "files touched by review comments",
+      hints: [
+        ["\u2191\u2193", "nav"],
+        ["\u21B5", "open in editor"],
+        ["q/esc", "back"]
+      ],
+      children: [
+        !files ? /* @__PURE__ */ jsx(Text, { color: colors.info, children: "Fetching files\u2026" }) : list.length === 0 ? /* @__PURE__ */ jsx(Text, { dimColor: true, children: "No files referenced in review comments." }) : /* @__PURE__ */ jsx(Box, { flexDirection: "column", children: list.map((f, i) => /* @__PURE__ */ jsxs(Box, { children: [
+          /* @__PURE__ */ jsx(Text, { color: colors.info, children: i === safeCursor ? "  \u276F " : "    " }),
+          /* @__PURE__ */ jsx(Text, { bold: i === safeCursor, children: f.path }),
+          f.line ? /* @__PURE__ */ jsx(Text, { dimColor: true, children: `:${f.line}` }) : null
+        ] }, f.path)) }),
+        note ? /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(Text, { color: colors.success, children: "  " + note }) }) : null
+      ]
+    }
+  );
+};
+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 readJson = (key) => {
+  try {
+    return JSON.parse(readFileSync(cacheFile(key), "utf8")).v;
+  } catch {
+    return null;
+  }
+};
+var writeJson = (key, v) => {
+  try {
+    mkdirSync(cacheDir(), { recursive: true });
+    writeFileSync(cacheFile(key), JSON.stringify({ v, at: Date.now() }));
+  } catch {
+  }
+};
+var useCachedResource = (key, fetcher) => {
+  const [data, setData] = useState(() => readJson(key));
+  const [error, setError] = useState(null);
+  const [tick, setTick] = useState(0);
+  useEffect(() => {
+    let live = true;
+    fetcher().then((fresh) => {
+      if (!live) return;
+      writeJson(key, fresh);
+      setData(fresh);
+      setError(null);
+    }).catch((e) => live && setError(e.message));
+    return () => {
+      live = false;
+    };
+  }, [key, tick]);
+  return {
+    data,
+    error,
+    loading: data === null && error === null,
+    reload: () => setTick((t) => t + 1)
+  };
+};
+var PrView = ({
+  item,
+  login,
+  onBack,
+  defaultTab,
+  onRefresh,
+  onRemove,
+  onMerged
+}) => {
+  const [log, setLog] = useState(null);
+  const [ai, setAi] = useState(false);
+  const [files, setFiles] = useState(false);
+  const [copy, setCopy] = useState(false);
+  const [replying, setReplying] = useState(false);
+  const menu = (0, lib_exports.useActionMenu)();
+  const comments = useCachedResource(
+    `pr-comments-${item.repo}-${item.number}`,
+    () => fetchComments(item.repo, item.number, "pr")
+  );
+  const unresolvedCount = (comments.data?.threads ?? []).filter(
+    (t) => !t.isResolved
+  ).length;
+  const conversationLabel = unresolvedCount ? `Conversation (${unresolvedCount} unresolved)` : "Conversation";
+  const tabItems = [
+    { value: "health", label: "Health" },
+    { value: "conversation", label: conversationLabel }
+  ];
+  const inputActive = log === null && !ai && !files && !replying && !copy;
+  const menuOpen = menu.actions !== null;
+  const { active, setActive } = useTabs(tabItems, {
+    initial: defaultTab ?? "health",
+    isActive: inputActive && !menuOpen
+  });
+  const tab = active ?? "health";
+  const health = useCachedResource(
+    `pr-health-${item.repo}-${item.number}`,
+    () => fetchHealth(item.repo, item.number)
+  );
+  const checkLabel = (c) => c.workflowName ? `${c.workflowName} / ${c.context ?? c.name}` : c.context ?? c.name ?? "";
+  const onOpenCheck = (c) => {
+    const url = c.detailsUrl ?? c.targetUrl ?? "";
+    const jobId = jobIdOf(url);
+    if (jobId || checkDrillFor(url))
+      setLog({ repo: item.repo, jobId: jobId ?? "", name: checkLabel(c), url });
+    else if (url) $`open ${url}`.catch(() => {
+    });
+  };
+  useInput(
+    (input, key) => {
+      if (menu.handleKey(key)) return;
+      if (key.escape || input === "q") return onBack();
+      if (input === "M") {
+        menu.open([
+          ...(0, lib_exports.buildActions)(
+            item,
+            login,
+            () => {
+            },
+            void 0,
+            void 0,
+            void 0,
+            onRefresh,
+            // onRemove navigates back itself, having stripped the row. Calling
+            // onBack() as well would re-set state from a closure captured
+            // before the removal, putting the row straight back.
+            (removed) => onRemove ? onRemove(removed) : onBack()
+          ),
+          // Appended here rather than via gh-ink's extension seam: on this screen
+          // the launcher is mounted directly by `a` below, not opened as an overlay
+          // through onOpenExt, so there is no extension for buildActions to list.
+          // The browse screen gets the same entry the other way, from delegate's
+          // scope: "item" — same action, two hosts, two routes to it.
+          {
+            label: "Delegate to an agent",
+            hint: "a",
+            run: () => setAi(true)
+          },
+          {
+            label: "Copy prompt to clipboard",
+            hint: "y",
+            run: () => setCopy(true)
+          }
+        ]);
+        return;
+      }
+      if (input === "o") {
+        $`open ${item.url}`.catch(() => {
+        });
+        return;
+      }
+      if (input === "a") {
+        setAi(true);
+        return;
+      }
+      if (input === "y") {
+        setCopy(true);
+        return;
+      }
+      if (input === "e") {
+        setFiles(true);
+        return;
+      }
+      if (key.leftArrow || key.rightArrow)
+        setActive((t) => t === "health" ? "conversation" : "health");
+    },
+    { isActive: inputActive }
+  );
+  if (files)
+    return /* @__PURE__ */ jsx(
+      FilePicker,
+      {
+        repo: item.repo,
+        number: item.number,
+        onBack: () => setFiles(false)
+      }
+    );
+  if (ai)
+    return /* @__PURE__ */ jsx(
+      AiLauncher,
+      {
+        item,
+        login,
+        prompt: seedPromptFor(item),
+        onBack: () => setAi(false)
+      }
+    );
+  if (copy)
+    return /* @__PURE__ */ jsx(CopyPromptNotice, { item, onBack: () => setCopy(false) });
+  if (log) {
+    const drill = checkDrillFor(log.url);
+    return drill ? /* @__PURE__ */ jsx(Fragment, { children: drill.render({
+      repo: log.repo,
+      url: log.url,
+      name: log.name,
+      onBack: () => setLog(null)
+    }) }) : /* @__PURE__ */ jsx(
+      CheckLogView,
+      {
+        repo: log.repo,
+        jobId: log.jobId,
+        name: log.name,
+        url: log.url,
+        onBack: () => setLog(null)
+      }
+    );
+  }
+  const hints = tab === "health" ? [
+    ["\u2191\u2193", "nav"],
+    ["\u21B5/l", "log"],
+    ["r", "retrigger"],
+    ["m", "merge"],
+    ["a", "AI"],
+    ["y", "copy prompt"],
+    ["e", "files"],
+    ["M", "actions"],
+    ["\u2190\u2192", "tab"],
+    ["o", "open PR"],
+    ["q", "back"]
+  ] : [
+    ["\u2191\u2193", "thread"],
+    ["x", "resolve"],
+    ["r", "reply"],
+    ["R", "show resolved"],
+    ["M", "actions"],
+    ["a", "AI"],
+    ["y", "copy prompt"],
+    ["\u2190\u2192", "tab"],
+    ["q", "back"]
+  ];
+  return /* @__PURE__ */ jsxs(
+    DrillView,
+    {
+      title: `#${item.number} \xB7 ${item.repo}`,
+      subtitle: item.title,
+      hints,
+      children: [
+        /* @__PURE__ */ jsx(Box, { marginBottom: 1, children: /* @__PURE__ */ jsx(Tabs, { active: tab, items: tabItems }) }),
+        menu.actions ? /* @__PURE__ */ jsx(lib_exports.ActionMenu, { item, actions: menu.actions, cursor: menu.cursor }) : tab === "health" ? /* @__PURE__ */ jsx(
+          HealthPanel,
+          {
+            repo: item.repo,
+            number: item.number,
+            data: health.data,
+            error: health.error,
+            reload: health.reload,
+            onOpenCheck,
+            onMerged: onMerged ? () => onMerged(item) : void 0
+          }
+        ) : /* @__PURE__ */ jsx(
+          CommentsPanel,
+          {
+            repo: item.repo,
+            number: item.number,
+            data: comments.data,
+            error: comments.error,
+            reload: comments.reload,
+            onReplyingChange: setReplying,
+            showConversationHeading: false
+          }
+        )
+      ]
+    }
+  );
+};
+var IssueView = ({
+  item,
+  login,
+  onBack
+}) => {
+  const [replying, setReplying] = useState(false);
+  const [ai, setAi] = useState(false);
+  const [copy, setCopy] = useState(false);
+  const comments = useCachedResource(
+    `issue-comments-${item.repo}-${item.number}`,
+    () => fetchComments(item.repo, item.number, "issue")
+  );
+  const tabItems = [
+    { value: "conversation", label: "Conversation" }
+  ];
+  useInput(
+    (input, key) => {
+      if (key.escape || input === "q") return onBack();
+      if (input === "o") $`open ${item.url}`.catch(() => {
+      });
+      if (input === "a") setAi(true);
+      if (input === "y") setCopy(true);
+    },
+    { isActive: !replying && !ai && !copy }
+  );
+  if (ai)
+    return /* @__PURE__ */ jsx(
+      AiLauncher,
+      {
+        item,
+        login,
+        prompt: seedPromptFor({ ...item, kind: "issue" }),
+        onBack: () => setAi(false)
+      }
+    );
+  if (copy)
+    return /* @__PURE__ */ jsx(
+      CopyPromptNotice,
+      {
+        item: { ...item, kind: "issue" },
+        onBack: () => setCopy(false)
+      }
+    );
+  return /* @__PURE__ */ jsxs(
+    DrillView,
+    {
+      title: `#${item.number} \xB7 ${item.repo}`,
+      subtitle: item.title,
+      hints: [
+        ["\u2191\u2193", "scroll"],
+        ["a", "AI"],
+        ["y", "copy prompt"],
+        ["o", "open in browser"],
+        ["q/esc", "back"]
+      ],
+      children: [
+        /* @__PURE__ */ jsx(Box, { marginBottom: 1, children: /* @__PURE__ */ jsx(Tabs, { active: "conversation", items: tabItems }) }),
+        /* @__PURE__ */ jsx(
+          CommentsPanel,
+          {
+            repo: item.repo,
+            number: item.number,
+            data: comments.data,
+            error: comments.error,
+            reload: comments.reload,
+            onReplyingChange: setReplying,
+            showConversationHeading: false
+          }
+        )
+      ]
+    }
+  );
+};
+var detailFor = (ctx) => ctx.kind === "pr" ? /* @__PURE__ */ jsx(
+  PrView,
+  {
+    item: ctx.item,
+    login: ctx.login,
+    onBack: ctx.onBack,
+    onRefresh: ctx.onRefresh,
+    onRemove: ctx.onRemove,
+    onMerged: ctx.onMerged
+  }
+) : (
+  // No refresh/remove/merged: IssueView has no action menu to hang them off,
+  // so passing them would type-check into a handler nothing ever calls. They
+  // belong here the day it grows the `M` menu PrView has.
+  /* @__PURE__ */ jsx(IssueView, { item: ctx.item, login: ctx.login, onBack: ctx.onBack })
+);
+
+// src/index.ts
+__reExport(index_exports, lib_exports);
+
+export { IssueView, PrView, checkDrillFor, defineCockpit, detailFor, hasPatterns, parseArgs, registerCheckDrills };

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@kud/gh-cockpit",
+  "version": "0.0.0",
+  "description": "A configurable GitHub cockpit for the terminal \u2014 your PRs, reviews and issues in one Ink TUI, grouped by whose move it is.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./extensions": {
+      "types": "./dist/extensions/index.d.ts",
+      "import": "./dist/extensions/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "github",
+    "pull-request",
+    "cli",
+    "ink",
+    "react",
+    "terminal",
+    "tui",
+    "cockpit",
+    "inbox"
+  ],
+  "author": "Erwann Mest <m@kud.io>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kud/gh",
+    "directory": "packages/gh-cockpit"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "ink": ">=7",
+    "react": ">=19"
+  },
+  "dependencies": {
+    "@kud/gh": "0.5.1",
+    "@kud/gh-ink": "0.21.0",
+    "@kud/ink-ui": "0.14.0",
+    "zx": "8.8.5"
+  },
+  "devDependencies": {
+    "@types/node": "22.20.1",
+    "@types/react": "19.2.17",
+    "ink": "7.1.0",
+    "ink-testing-library": "4.0.0",
+    "react": "19.2.7",
+    "tsup": "8.5.1",
+    "typescript": "5.9.3",
+    "vitest": "4.1.10"
+  }
+}