@kud/gh 0.1.0

package/README.md

@@ -0,0 +1,64 @@
+# @kud/gh
+
+Surface-agnostic GitHub core. Shells out to the `gh` CLI and returns plain data —
+consumed by CLIs, Ink dashboards, and MCP servers alike. No UI, no framework.
+
+## Install
+
+```sh
+npm install @kud/gh
+```
+
+Requires the [`gh`](https://cli.github.com) CLI, authenticated (`gh auth login`).
+
+## API
+
+### Transport primitives
+
+```ts
+import { ghGraphql, ghRest } from "@kud/gh"
+
+const data = await ghGraphql<T>(query, { owner: "kud", name: "gh", number: 1 })
+const raw = await ghRest("repos/kud/gh/pulls/1/comments", {
+  method: "POST",
+  fields: { body: "hi", in_reply_to: 123 },
+})
+```
+
+`ghGraphql` returns the unwrapped `data` field; `ghRest` returns raw stdout.
+String fields pass as `-f`, numbers as `-F` (typed-field), matching `gh api`.
+
+### PR review comments
+
+```ts
+import {
+  fetchPrComments,
+  replyToThread,
+  resolveThread,
+  unresolveThread,
+} from "@kud/gh"
+
+const { headRef, conversation, threads } = await fetchPrComments("kud", "gh", 1)
+await replyToThread({
+  repo: "kud/gh",
+  pull: 1,
+  inReplyTo: 123,
+  body: "thanks!",
+})
+await resolveThread(thread.id) // → boolean isResolved
+await unresolveThread(thread.id)
+```
+
+Types: `PrComments`, `ReviewThread`, `Comment`, `ReplyToThreadOptions`.
+
+## Development
+
+```sh
+npm run typecheck
+npm run test
+npm run build
+```
+
+## Licence
+
+MIT © Erwann Mest

package/dist/actions.d.ts

@@ -0,0 +1,4 @@
+export declare const mergePr: (repo: string, number: number) => Promise<void>;
+export declare const rerunFailedRun: (repo: string, runId: string) => Promise<void>;
+export declare const reRequestReviewer: (repo: string, number: number, login: string) => Promise<void>;
+//# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,OAAO,GAAU,MAAM,MAAM,EAAE,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAExE,CAAA;AAGD,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,OAAO,MAAM,KACZ,OAAO,CAAC,IAAI,CAEd,CAAA;AAGD,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,QAAQ,MAAM,EACd,OAAO,MAAM,KACZ,OAAO,CAAC,IAAI,CAUd,CAAA"}

package/dist/actions.js

@@ -0,0 +1,25 @@
+import { execa } from "execa";
+// PR write-actions — the mutating gh operations a health panel offers. Kept in
+// the core (not the UI) so any surface can invoke them; they shell out to `gh`
+// and resolve when the command completes.
+// Merge a pull request with a merge commit.
+export const mergePr = async (repo, number) => {
+    await execa("gh", ["pr", "merge", String(number), "--repo", repo, "--merge"]);
+};
+// Re-run only the failed jobs of a GitHub Actions run.
+export const rerunFailedRun = async (repo, runId) => {
+    await execa("gh", ["run", "rerun", runId, "--repo", repo, "--failed"]);
+};
+// Re-request a review by adding the reviewer back onto the PR.
+export const reRequestReviewer = async (repo, number, login) => {
+    await execa("gh", [
+        "pr",
+        "edit",
+        String(number),
+        "--repo",
+        repo,
+        "--add-reviewer",
+        login,
+    ]);
+};
+//# sourceMappingURL=actions.js.map

package/dist/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAE7B,+EAA+E;AAC/E,+EAA+E;AAC/E,0CAA0C;AAE1C,4CAA4C;AAC5C,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,IAAY,EAAE,MAAc,EAAiB,EAAE;IAC3E,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAA;AAC/E,CAAC,CAAA;AAED,uDAAuD;AACvD,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,IAAY,EACZ,KAAa,EACE,EAAE;IACjB,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAA;AACxE,CAAC,CAAA;AAED,+DAA+D;AAC/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EACpC,IAAY,EACZ,MAAc,EACd,KAAa,EACE,EAAE;IACjB,MAAM,KAAK,CAAC,IAAI,EAAE;QAChB,IAAI;QACJ,MAAM;QACN,MAAM,CAAC,MAAM,CAAC;QACd,QAAQ;QACR,IAAI;QACJ,gBAAgB;QAChB,KAAK;KACN,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/gh.d.ts

@@ -0,0 +1,10 @@
+export type GhFieldValue = string | number;
+export type GhFields = Record<string, GhFieldValue>;
+export declare const ghGraphql: <T>(query: string, vars?: GhFields) => Promise<T>;
+export type GhRestMethod = "GET" | "POST" | "PATCH" | "DELETE";
+export type GhRestOptions = {
+    method?: GhRestMethod;
+    fields?: GhFields;
+};
+export declare const ghRest: (endpoint: string, options?: GhRestOptions) => Promise<string>;
+//# sourceMappingURL=gh.d.ts.map

package/dist/gh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gh.d.ts","sourceRoot":"","sources":["../src/gh.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAA;AAE1C,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;AASnD,eAAO,MAAM,SAAS,GAAU,CAAC,EAC/B,OAAO,MAAM,EACb,OAAM,QAAa,KAClB,OAAO,CAAC,CAAC,CAUX,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE9D,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,MAAM,CAAC,EAAE,QAAQ,CAAA;CAClB,CAAA;AAED,eAAO,MAAM,MAAM,GACjB,UAAU,MAAM,EAChB,UAAS,aAAkB,KAC1B,OAAO,CAAC,MAAM,CAYhB,CAAA"}

package/dist/gh.js

@@ -0,0 +1,26 @@
+import { execa } from "execa";
+const toFieldArgs = (fields) => Object.entries(fields).flatMap(([key, value]) => typeof value === "number"
+    ? ["-F", `${key}=${value}`]
+    : ["-f", `${key}=${value}`]);
+export const ghGraphql = async (query, vars = {}) => {
+    const { stdout } = await execa("gh", [
+        "api",
+        "graphql",
+        "-f",
+        `query=${query}`,
+        ...toFieldArgs(vars),
+    ]);
+    return JSON.parse(stdout).data;
+};
+export const ghRest = async (endpoint, options = {}) => {
+    const { method, fields = {} } = options;
+    const methodArgs = method ? ["-X", method] : [];
+    const { stdout } = await execa("gh", [
+        "api",
+        endpoint,
+        ...methodArgs,
+        ...toFieldArgs(fields),
+    ]);
+    return stdout;
+};
+//# sourceMappingURL=gh.js.map

package/dist/gh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gh.js","sourceRoot":"","sources":["../src/gh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAM7B,MAAM,WAAW,GAAG,CAAC,MAAgB,EAAY,EAAE,CACjD,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAC9C,OAAO,KAAK,KAAK,QAAQ;IACvB,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAC9B,CAAA;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAC5B,KAAa,EACb,OAAiB,EAAE,EACP,EAAE;IACd,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE;QACnC,KAAK;QACL,SAAS;QACT,IAAI;QACJ,SAAS,KAAK,EAAE;QAChB,GAAG,WAAW,CAAC,IAAI,CAAC;KACrB,CAAC,CAAA;IAEF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAS,CAAA;AACrC,CAAC,CAAA;AASD,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,EACzB,QAAgB,EAChB,UAAyB,EAAE,EACV,EAAE;IACnB,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,OAAO,CAAA;IACvC,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAE/C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE;QACnC,KAAK;QACL,QAAQ;QACR,GAAG,UAAU;QACb,GAAG,WAAW,CAAC,MAAM,CAAC;KACvB,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/dist/health.d.ts

@@ -0,0 +1,43 @@
+export type Health = "ci-fail" | "conflict" | "changes-req" | "threads" | "pending" | "approved" | "waiting" | "draft" | "merged" | "closed" | "none";
+export type PrCheck = {
+    name?: string;
+    context?: string;
+    status?: string;
+    conclusion?: string | null;
+    state?: string;
+    detailsUrl?: string;
+    targetUrl?: string;
+    workflowName?: string;
+    databaseId?: number;
+};
+export type PrReview = {
+    author: {
+        login: string;
+    } | null;
+    state: string;
+};
+export type PrHealthData = {
+    statusCheckRollup: PrCheck[];
+    reviews: PrReview[];
+    reviewDecision: string | null;
+    mergeable: string;
+    mergeStateStatus: string;
+    author: {
+        login: string;
+    } | null;
+};
+export declare const isFailCheck: (c: PrCheck) => boolean;
+export declare const isPendingCheck: (c: PrCheck) => boolean;
+export declare const isPassCheck: (c: PrCheck) => boolean;
+export declare const latestChecks: (checks: PrCheck[]) => PrCheck[];
+export type ComputeHealthInput = {
+    state?: string;
+    isDraft?: boolean;
+    checks: PrCheck[];
+    mergeable?: string;
+    reviewDecision?: string | null;
+    unresolvedThreads?: number;
+};
+export declare const computeHealth: (input: ComputeHealthInput) => Health;
+export declare const fetchHealth: (repo: string, number: number) => Promise<PrHealthData>;
+//# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,MAAM,GACd,SAAS,GACT,UAAU,GACV,aAAa,GACb,SAAS,GACT,SAAS,GACT,UAAU,GACV,SAAS,GACT,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,MAAM,CAAA;AAMV,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IAAE,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAI1E,MAAM,MAAM,YAAY,GAAG;IACzB,iBAAiB,EAAE,OAAO,EAAE,CAAA;IAC5B,OAAO,EAAE,QAAQ,EAAE,CAAA;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB,EAAE,MAAM,CAAA;IACxB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CACjC,CAAA;AAMD,eAAO,MAAM,WAAW,GAAI,GAAG,OAAO,KAAG,OAKpB,CAAA;AAErB,eAAO,MAAM,cAAc,GAAI,GAAG,OAAO,KAAG,OACS,CAAA;AAErD,eAAO,MAAM,WAAW,GAAI,GAAG,OAAO,KAAG,OAIf,CAAA;AAM1B,eAAO,MAAM,YAAY,GAAI,QAAQ,OAAO,EAAE,KAAG,OAAO,EAavD,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAE/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B,CAAA;AAMD,eAAO,MAAM,aAAa,GAAI,OAAO,kBAAkB,KAAG,MAkBzD,CAAA;AAID,eAAO,MAAM,WAAW,GACtB,MAAM,MAAM,EACZ,QAAQ,MAAM,KACb,OAAO,CAAC,YAAY,CAWtB,CAAA"}

package/dist/health.js

@@ -0,0 +1,75 @@
+import { execa } from "execa";
+// The canonical check classifiers — one source of truth, unifying the two
+// hand-maintained copies that had drifted (glance vs panel). A check is failing
+// on any terminal-bad conclusion or a bad StatusContext state; pending while it
+// is still running; passing otherwise (an explicit success signal).
+export const isFailCheck = (c) => ["FAILURE", "TIMED_OUT", "CANCELLED", "ACTION_REQUIRED"].includes(c.conclusion ?? "") ||
+    c.state === "FAILURE" ||
+    c.state === "ERROR";
+export const isPendingCheck = (c) => c.status === "IN_PROGRESS" || c.state === "PENDING";
+export const isPassCheck = (c) => !isFailCheck(c) &&
+    !isPendingCheck(c) &&
+    (["SUCCESS", "NEUTRAL", "SKIPPED"].includes(c.conclusion ?? "") ||
+        c.state === "SUCCESS");
+// Collapse a rollup to the latest run per check name and drop SKIPPED ones: a
+// re-run pushes a fresh CheckRun with a higher databaseId, so an older failure
+// must not outvote the current pass. StatusContexts (no databaseId) keep their
+// first occurrence.
+export const latestChecks = (checks) => {
+    const latestByKey = new Map();
+    for (const c of checks) {
+        const key = c.name ?? c.context ?? "";
+        const existing = latestByKey.get(key);
+        if (!existing ||
+            (c.databaseId != null &&
+                (existing.databaseId == null || c.databaseId > existing.databaseId)))
+            latestByKey.set(key, c);
+    }
+    return [...latestByKey.values()].filter((c) => c.conclusion !== "SKIPPED");
+};
+// Derive the single health token. Precedence is deliberate: terminal states
+// first, then the urgent actionable states, then unresolved threads (which
+// outrank the passive pending/approved/waiting — an otherwise-quiet PR with open
+// threads still needs your reply), then the passive states.
+export const computeHealth = (input) => {
+    if (input.state === "MERGED")
+        return "merged";
+    if (input.state === "CLOSED")
+        return "closed";
+    if (input.isDraft === undefined)
+        return "none";
+    if (input.isDraft)
+        return "draft";
+    const active = latestChecks(input.checks);
+    const hasFail = active.some(isFailCheck);
+    const hasPending = active.some(isPendingCheck);
+    const unresolvedThreads = input.unresolvedThreads ?? 0;
+    if (hasFail)
+        return "ci-fail";
+    if (input.mergeable === "CONFLICTING")
+        return "conflict";
+    if (input.reviewDecision === "CHANGES_REQUESTED")
+        return "changes-req";
+    if (unresolvedThreads > 0)
+        return "threads";
+    if (hasPending)
+        return "pending";
+    if (input.reviewDecision === "APPROVED")
+        return "approved";
+    return "waiting";
+};
+// Fetch the detail-panel payload for one PR via the gh CLI. Uses `gh pr view`
+// (not `gh api`) for the ready-shaped `--json` projection a panel renders.
+export const fetchHealth = async (repo, number) => {
+    const { stdout } = await execa("gh", [
+        "pr",
+        "view",
+        String(number),
+        "--repo",
+        repo,
+        "--json",
+        "statusCheckRollup,reviews,reviewDecision,mergeable,mergeStateStatus,author",
+    ]);
+    return JSON.parse(stdout);
+};
+//# sourceMappingURL=health.js.map

package/dist/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./gh.js";
+export * from "./pr.js";
+export * from "./pr-comments.js";
+export * from "./health.js";
+export * from "./actions.js";
+export * from "./webhook.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,20 @@
+// @kud/gh — surface-agnostic GitHub core. Per-concern domain modules over the
+// `gh` CLI. Every export is UI-agnostic: it shells out to `gh` and returns plain
+// data, so a CLI, an Ink dashboard, or an MCP server all consume it alike.
+//
+// Transport policy — two ways to reach GitHub through `gh`, chosen per need:
+//   • `gh <cmd> --json` (porcelain) for single-resource reads, branch→PR/repo
+//     resolution, and workflow actions (merge/rerun/re-request) — simpler, and
+//     gh already encapsulates the resolution and merge-method/branch logic.
+//   • `gh api` GraphQL/REST (ghGraphql/ghRest) when the query must be shaped or
+//     optimised — aggregations, precise nested selections, or operations with no
+//     porcelain equivalent (review-thread resolve/reply, webhook delivery replay).
+// The deciding test is "is there a query to optimise?": yes → gh api; no →
+// porcelain.
+export * from "./gh.js";
+export * from "./pr.js";
+export * from "./pr-comments.js";
+export * from "./health.js";
+export * from "./actions.js";
+export * from "./webhook.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,iFAAiF;AACjF,2EAA2E;AAC3E,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,+EAA+E;AAC/E,4EAA4E;AAC5E,gFAAgF;AAChF,iFAAiF;AACjF,mFAAmF;AACnF,2EAA2E;AAC3E,aAAa;AACb,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/dist/pr-comments.d.ts

@@ -0,0 +1,34 @@
+export type Comment = {
+    author: string;
+    body: string;
+    databaseId?: number;
+    url?: string;
+    path?: string | null;
+    diffHunk?: string;
+    createdAt?: string;
+};
+export type ReviewThread = {
+    id: string;
+    path: string | null;
+    line: number | null;
+    originalLine: number | null;
+    isResolved: boolean;
+    isOutdated: boolean;
+    comments: Comment[];
+};
+export type PrComments = {
+    headRef: string;
+    conversation: Comment[];
+    threads: ReviewThread[];
+};
+export type ReplyToThreadOptions = {
+    repo: string;
+    pull: number;
+    inReplyTo: number;
+    body: string;
+};
+export declare const fetchPrComments: (owner: string, name: string, number: number) => Promise<PrComments>;
+export declare const replyToThread: (options: ReplyToThreadOptions) => Promise<void>;
+export declare const resolveThread: (threadId: string) => Promise<boolean>;
+export declare const unresolveThread: (threadId: string) => Promise<boolean>;
+//# sourceMappingURL=pr-comments.d.ts.map

package/dist/pr-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-comments.d.ts","sourceRoot":"","sources":["../src/pr-comments.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,UAAU,EAAE,OAAO,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,OAAO,EAAE,CAAA;IACvB,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AA8GD,eAAO,MAAM,eAAe,GAC1B,OAAO,MAAM,EACb,MAAM,MAAM,EACZ,QAAQ,MAAM,KACb,OAAO,CAAC,UAAU,CAqBpB,CAAA;AAED,eAAO,MAAM,aAAa,GACxB,SAAS,oBAAoB,KAC5B,OAAO,CAAC,IAAI,CAId,CAAA;AAED,eAAO,MAAM,aAAa,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,OAAO,CAKrE,CAAA;AAED,eAAO,MAAM,eAAe,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,OAAO,CAMvE,CAAA"}

package/dist/pr-comments.js

@@ -0,0 +1,88 @@
+import { ghGraphql, ghRest } from "./gh.js";
+const FETCH_PR_COMMENTS_QUERY = `
+  query($owner:String!, $name:String!, $number:Int!) {
+    repository(owner:$owner, name:$name) {
+      pullRequest(number:$number) {
+        headRefName
+        comments(first: 50) { nodes { author { login } body } }
+        reviewThreads(first: 100) {
+          nodes {
+            id path line originalLine isResolved isOutdated
+            comments(first: 100) {
+              nodes { databaseId author { login } body bodyText url path diffHunk createdAt }
+            }
+          }
+        }
+      }
+    }
+  }
+`;
+const RESOLVE_THREAD_MUTATION = `
+  mutation($threadId: ID!) {
+    resolveReviewThread(input: { threadId: $threadId }) {
+      thread { isResolved }
+    }
+  }
+`;
+const UNRESOLVE_THREAD_MUTATION = `
+  mutation($threadId: ID!) {
+    unresolveReviewThread(input: { threadId: $threadId }) {
+      thread { isResolved }
+    }
+  }
+`;
+const authorLogin = (author) => author?.login ?? "ghost";
+const mapConversationComment = (node) => ({
+    author: authorLogin(node.author),
+    body: node.body.trim(),
+});
+const mapThreadComment = (node) => ({
+    author: authorLogin(node.author),
+    body: node.body.trim(),
+    databaseId: node.databaseId,
+    url: node.url,
+    path: node.path,
+    diffHunk: node.diffHunk,
+    createdAt: node.createdAt,
+});
+const mapReviewThread = (node) => ({
+    id: node.id,
+    path: node.path,
+    line: node.line,
+    originalLine: node.originalLine,
+    isResolved: node.isResolved,
+    isOutdated: node.isOutdated,
+    comments: node.comments.nodes.map(mapThreadComment),
+});
+export const fetchPrComments = async (owner, name, number) => {
+    const data = await ghGraphql(FETCH_PR_COMMENTS_QUERY, {
+        owner,
+        name,
+        number,
+    });
+    const pullRequest = data.repository?.pullRequest;
+    if (!pullRequest) {
+        throw new Error(`pull request not found: ${owner}/${name}#${number}`);
+    }
+    return {
+        headRef: pullRequest.headRefName ?? "HEAD",
+        conversation: pullRequest.comments.nodes.map(mapConversationComment),
+        threads: pullRequest.reviewThreads.nodes.map(mapReviewThread),
+    };
+};
+export const replyToThread = async (options) => {
+    await ghRest(`repos/${options.repo}/pulls/${options.pull}/comments`, {
+        fields: { body: options.body, in_reply_to: options.inReplyTo },
+    });
+};
+export const resolveThread = async (threadId) => {
+    const data = await ghGraphql(RESOLVE_THREAD_MUTATION, {
+        threadId,
+    });
+    return data.resolveReviewThread.thread.isResolved;
+};
+export const unresolveThread = async (threadId) => {
+    const data = await ghGraphql(UNRESOLVE_THREAD_MUTATION, { threadId });
+    return data.unresolveReviewThread.thread.isResolved;
+};
+//# sourceMappingURL=pr-comments.js.map

package/dist/pr-comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-comments.js","sourceRoot":"","sources":["../src/pr-comments.ts"],"names":[],"mappings":"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"}

package/dist/pr.d.ts

@@ -0,0 +1,10 @@
+export type CurrentPr = {
+    number: number;
+    repo: string;
+    url: string;
+    title: string;
+    branch: string;
+};
+export declare const resolveCurrentPr: () => Promise<CurrentPr>;
+export declare const resolveCurrentRepo: () => Promise<string>;
+//# sourceMappingURL=pr.d.ts.map

package/dist/pr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr.d.ts","sourceRoot":"","sources":["../src/pr.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAKD,eAAO,MAAM,gBAAgB,QAAa,OAAO,CAAC,SAAS,CAyB1D,CAAA;AAGD,eAAO,MAAM,kBAAkB,QAAa,OAAO,CAAC,MAAM,CAUzD,CAAA"}

package/dist/pr.js

@@ -0,0 +1,35 @@
+import { execa } from "execa";
+// Resolve the open PR for the branch checked out in the current directory. The
+// repo is taken from the PR url (canonical owner/name, robust to forks), falling
+// back to the head repository fields.
+export const resolveCurrentPr = async () => {
+    const { stdout } = await execa("gh", [
+        "pr",
+        "view",
+        "--json",
+        "number,title,url,headRefName,headRepository,headRepositoryOwner",
+    ]);
+    const pr = JSON.parse(stdout);
+    const repo = pr.url.match(/github\.com\/([^/]+\/[^/]+)\/pull\//)?.[1] ??
+        `${pr.headRepositoryOwner.login}/${pr.headRepository.name}`;
+    return {
+        number: pr.number,
+        repo,
+        url: pr.url,
+        title: pr.title,
+        branch: pr.headRefName,
+    };
+};
+// The `owner/name` of the repo in the current directory.
+export const resolveCurrentRepo = async () => {
+    const { stdout } = await execa("gh", [
+        "repo",
+        "view",
+        "--json",
+        "nameWithOwner",
+        "-q",
+        ".nameWithOwner",
+    ]);
+    return stdout.trim();
+};
+//# sourceMappingURL=pr.js.map

package/dist/pr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr.js","sourceRoot":"","sources":["../src/pr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAU7B,+EAA+E;AAC/E,iFAAiF;AACjF,sCAAsC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,IAAwB,EAAE;IAC7D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE;QACnC,IAAI;QACJ,MAAM;QACN,QAAQ;QACR,iEAAiE;KAClE,CAAC,CAAA;IACF,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAO3B,CAAA;IACD,MAAM,IAAI,GACR,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,qCAAqC,CAAC,EAAE,CAAC,CAAC,CAAC;QACxD,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,IAAI,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,CAAA;IAC7D,OAAO;QACL,MAAM,EAAE,EAAE,CAAC,MAAM;QACjB,IAAI;QACJ,GAAG,EAAE,EAAE,CAAC,GAAG;QACX,KAAK,EAAE,EAAE,CAAC,KAAK;QACf,MAAM,EAAE,EAAE,CAAC,WAAW;KACvB,CAAA;AACH,CAAC,CAAA;AAED,yDAAyD;AACzD,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,IAAqB,EAAE;IAC5D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE;QACnC,MAAM;QACN,MAAM;QACN,QAAQ;QACR,eAAe;QACf,IAAI;QACJ,gBAAgB;KACjB,CAAC,CAAA;IACF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAA;AACtB,CAAC,CAAA"}

package/dist/webhook.d.ts

@@ -0,0 +1,23 @@
+export type Hook = {
+    id: number;
+    name: string;
+    config: {
+        url: string;
+    };
+    events: string[];
+    active: boolean;
+};
+export declare const parsePrDeliveryId: (raw: string) => string | null;
+export declare const fetchHooks: (repo: string) => Promise<Hook[]>;
+export declare const fetchLatestPrDeliveryId: (repo: string, hookId: number) => Promise<string>;
+export declare const replayDelivery: (repo: string, hookId: number, deliveryId: string) => Promise<void>;
+export declare const findHook: (hooks: Hook[], pattern: string) => Hook | undefined;
+export declare const findJenkinsHook: (hooks: Hook[]) => Hook | undefined;
+export declare const fetchHookContexts: (repo: string, hookId: number) => Promise<string[]>;
+export type ReplayResult = {
+    hook: Hook;
+    deliveryId: string;
+};
+export declare const replayLatestPrDelivery: (repo: string, pattern: string) => Promise<ReplayResult>;
+export declare const retriggerJenkinsWebhook: (repo: string) => Promise<ReplayResult>;
+//# sourceMappingURL=webhook.d.ts.map

package/dist/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../src/webhook.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,IAAI,GAAG;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACvB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;CAChB,CAAA;AAOD,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,IAIxD,CAAA;AAED,eAAO,MAAM,UAAU,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,IAAI,EAAE,CACgB,CAAA;AAE9E,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,EACZ,QAAQ,MAAM,KACb,OAAO,CAAC,MAAM,CAQhB,CAAA;AAED,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,QAAQ,MAAM,EACd,YAAY,MAAM,KACjB,OAAO,CAAC,IAAI,CAKd,CAAA;AAGD,eAAO,MAAM,QAAQ,GAAI,OAAO,IAAI,EAAE,EAAE,SAAS,MAAM,KAAG,IAAI,GAAG,SACc,CAAA;AAG/E,eAAO,MAAM,eAAe,GAAI,OAAO,IAAI,EAAE,KAAG,IAAI,GAAG,SAIpD,CAAA;AAKH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,QAAQ,MAAM,KACb,OAAO,CAAC,MAAM,EAAE,CA0BlB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAA;AAI7D,eAAO,MAAM,sBAAsB,GACjC,MAAM,MAAM,EACZ,SAAS,MAAM,KACd,OAAO,CAAC,YAAY,CAOtB,CAAA;AAID,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,KACX,OAAO,CAAC,YAAY,CAOtB,CAAA"}

package/dist/webhook.js

@@ -0,0 +1,71 @@
+import { ghRest } from "./gh.js";
+// The id of the most recent `pull_request` delivery in a hook's deliveries
+// listing, or null if none. The listing is newest-first, so the first match is
+// the latest. Parses the JSON array — the old shell tools text-scanned for
+// `"pull_request"` and walked back to a nearby `"id"`, which silently depended
+// on pretty-printed output; parsing is equivalent and robust.
+export const parsePrDeliveryId = (raw) => {
+    const deliveries = JSON.parse(raw);
+    const pr = deliveries.find((d) => d.event === "pull_request");
+    return pr ? String(pr.id) : null;
+};
+export const fetchHooks = async (repo) => JSON.parse(await ghRest(`repos/${repo}/hooks`, { method: "GET" }));
+export const fetchLatestPrDeliveryId = async (repo, hookId) => {
+    const raw = await ghRest(`repos/${repo}/hooks/${hookId}/deliveries?per_page=20`, { method: "GET" });
+    const id = parsePrDeliveryId(raw);
+    if (!id)
+        throw new Error(`No pull_request delivery found for hook ${hookId}`);
+    return id;
+};
+export const replayDelivery = async (repo, hookId, deliveryId) => {
+    await ghRest(`repos/${repo}/hooks/${hookId}/deliveries/${deliveryId}/attempts`, { method: "POST" });
+};
+// Match a hook by url substring or exact numeric id (the CLI `--hook` pattern).
+export const findHook = (hooks, pattern) => hooks.find((h) => h.config.url.includes(pattern) || String(h.id) === pattern);
+// The Jenkins PR-builder hook, by its well-known url markers.
+export const findJenkinsHook = (hooks) => hooks.find((h) => h.config.url.includes("ghprbhook") || h.config.url.includes("jenkins"));
+// The status contexts a hook's latest pull_request delivery produced — derived
+// from the delivered head sha's commit statuses. Best-effort: returns [] rather
+// than throwing so a picker can still list the hook.
+export const fetchHookContexts = async (repo, hookId) => {
+    try {
+        const listing = await ghRest(`repos/${repo}/hooks/${hookId}/deliveries?per_page=5`, { method: "GET" });
+        const deliveryId = parsePrDeliveryId(listing);
+        if (!deliveryId)
+            return [];
+        const delivery = JSON.parse(await ghRest(`repos/${repo}/hooks/${hookId}/deliveries/${deliveryId}`, {
+            method: "GET",
+        }));
+        const sha = delivery?.request?.payload?.pull_request?.head?.sha;
+        if (!sha)
+            return [];
+        const statuses = JSON.parse(await ghRest(`repos/${repo}/commits/${sha}/statuses`, { method: "GET" }));
+        return [...new Set(statuses.map((s) => s.context))];
+    }
+    catch {
+        return [];
+    }
+};
+// Replay the latest pull_request delivery on the hook matching `pattern`
+// (gh-webhook-replay command mode).
+export const replayLatestPrDelivery = async (repo, pattern) => {
+    const hooks = await fetchHooks(repo);
+    const hook = findHook(hooks, pattern);
+    if (!hook)
+        throw new Error(`No webhook matching "${pattern}" on ${repo}`);
+    const deliveryId = await fetchLatestPrDeliveryId(repo, hook.id);
+    await replayDelivery(repo, hook.id, deliveryId);
+    return { hook, deliveryId };
+};
+// Re-fire the Jenkins PR-builder hook's latest pull_request delivery
+// (gh-pr-health --retrigger).
+export const retriggerJenkinsWebhook = async (repo) => {
+    const hooks = await fetchHooks(repo);
+    const hook = findJenkinsHook(hooks);
+    if (!hook)
+        throw new Error("No Jenkins webhook found");
+    const deliveryId = await fetchLatestPrDeliveryId(repo, hook.id);
+    await replayDelivery(repo, hook.id, deliveryId);
+    return { hook, deliveryId };
+};
+//# sourceMappingURL=webhook.js.map

package/dist/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../src/webhook.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@kud/gh",
+  "version": "0.1.0",
+  "description": "Surface-agnostic GitHub core — gh CLI primitives, PR review comments, health, and webhook logic.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "github",
+    "pull-request",
+    "code-review",
+    "gh-cli",
+    "graphql",
+    "core"
+  ],
+  "author": "Erwann Mest <m@kud.io>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kud/gh",
+    "directory": "packages/gh"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "execa": "9.6.1"
+  },
+  "devDependencies": {
+    "@types/node": "26.1.1",
+    "typescript": "5.9.3",
+    "vitest": "4.1.10"
+  }
+}