@reneturcios/greenlight 0.4.0 → 0.6.0

package/dist/doctor.js

@@ -0,0 +1,158 @@
+/**
+ * `greenlight doctor`: first-run setup check.
+ *
+ * Answers the three questions behind most "it doesn't work" reports: is my
+ * Node new enough, is my GitHub quota usable, and can Greenlight write its
+ * cache. Every check carries its fix, so the output is actionable without
+ * opening the docs. All inputs are injectable so the suite stays offline.
+ */
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { mkdirSync, writeFileSync, rmSync, readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+export const MIN_NODE_MAJOR = 20;
+export function nodeMajor(version) {
+    const m = /^v?(\d+)/.exec(version.trim());
+    return m ? Number(m[1]) : 0;
+}
+export function defaultCacheDir() {
+    return join(homedir(), ".cache", "greenlight");
+}
+export function defaultPackageVersion() {
+    try {
+        // src/doctor.ts in dev, dist/doctor.js built: package.json is one up either way.
+        const pkg = JSON.parse(readFileSync(fileURLToPath(new URL("../package.json", import.meta.url)), "utf8"));
+        return pkg.version ?? "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+/** One unauthenticated-capable call: GET /rate_limit shows quota either way. */
+export async function defaultFetchRateLimit(token) {
+    try {
+        const headers = {
+            Accept: "application/vnd.github+json",
+            "User-Agent": "greenlight-cli",
+        };
+        if (token)
+            headers["Authorization"] = `Bearer ${token}`;
+        const res = await fetch("https://api.github.com/rate_limit", {
+            headers,
+            signal: AbortSignal.timeout(15000),
+        });
+        if (!res.ok) {
+            return { ok: false, error: `GitHub API ${res.status}` };
+        }
+        const body = (await res.json());
+        const core = body.resources?.core ?? {};
+        return {
+            ok: true,
+            remaining: core.remaining,
+            limit: core.limit,
+            resetAt: typeof core.reset === "number"
+                ? new Date(core.reset * 1000).toISOString()
+                : undefined,
+        };
+    }
+    catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+function checkCacheWritable(cacheDir) {
+    try {
+        mkdirSync(cacheDir, { recursive: true });
+        const probe = join(cacheDir, ".doctor-write-test");
+        writeFileSync(probe, "ok", "utf8");
+        rmSync(probe, { force: true });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function runDoctor(deps = {}) {
+    const nodeVersion = deps.nodeVersion ?? process.version;
+    const env = deps.env ?? process.env;
+    const cacheDir = deps.cacheDir ?? defaultCacheDir();
+    const version = deps.packageVersion ?? defaultPackageVersion();
+    const fetchRateLimit = deps.fetchRateLimit ?? defaultFetchRateLimit;
+    const checks = [];
+    const major = nodeMajor(nodeVersion);
+    checks.push(major >= MIN_NODE_MAJOR
+        ? { name: "node", status: "pass", detail: `${nodeVersion} (>= v${MIN_NODE_MAJOR} required)` }
+        : {
+            name: "node",
+            status: "fail",
+            detail: `${nodeVersion} is older than the required v${MIN_NODE_MAJOR}`,
+            fix: "Install Node 20+ from https://nodejs.org and re-run doctor.",
+        });
+    const tokenVar = env.GITHUB_TOKEN ? "GITHUB_TOKEN" : env.GH_TOKEN ? "GH_TOKEN" : undefined;
+    const token = tokenVar ? env[tokenVar] : undefined;
+    checks.push(tokenVar
+        ? { name: "github token", status: "pass", detail: `${tokenVar} is set` }
+        : {
+            name: "github token",
+            status: "warn",
+            detail: "no token set; sharing the 60 req/hr anonymous quota",
+            fix: "Create a classic personal access token (no scopes needed for public repos) and export GITHUB_TOKEN=<token>.",
+        });
+    const rate = await fetchRateLimit(token);
+    if (!rate.ok) {
+        checks.push({
+            name: "github api",
+            status: "fail",
+            detail: `unreachable: ${rate.error ?? "unknown error"}`,
+            fix: "Check your network connection or proxy, then re-run doctor.",
+        });
+    }
+    else if (rate.remaining === 0) {
+        checks.push({
+            name: "github api",
+            status: "warn",
+            detail: `quota exhausted${rate.resetAt ? `; resets at ${rate.resetAt}` : ""}`,
+            fix: tokenVar
+                ? "Wait for the reset time; the cache under ~/.cache/greenlight keeps repeat checks cheap."
+                : "Set GITHUB_TOKEN for the 5000 req/hr limit, or wait for the reset time.",
+        });
+    }
+    else {
+        checks.push({
+            name: "github api",
+            status: "pass",
+            detail: rate.remaining !== undefined && rate.limit !== undefined
+                ? `reachable, ${rate.remaining}/${rate.limit} requests remaining`
+                : "reachable",
+        });
+    }
+    checks.push(checkCacheWritable(cacheDir)
+        ? { name: "cache", status: "pass", detail: `${cacheDir} is writable` }
+        : {
+            name: "cache",
+            status: "fail",
+            detail: `${cacheDir} is not writable`,
+            fix: `Make ${cacheDir} writable (it caches GitHub responses so repeat checks stay cheap).`,
+        });
+    return { version, checks };
+}
+/** Human-readable report; one line per check plus the fix for anything off. */
+export function formatDoctorHuman(report) {
+    const lines = [`greenlight ${report.version}: setup check`];
+    for (const c of report.checks) {
+        const tag = c.status === "pass" ? "[PASS]" : c.status === "warn" ? "[WARN]" : "[FAIL]";
+        lines.push(`  ${tag} ${c.name}: ${c.detail}`);
+        if (c.fix)
+            lines.push(`        fix: ${c.fix}`);
+    }
+    if (report.checks.some((c) => c.status === "fail")) {
+        lines.push("Result: NOT READY — fix the FAIL lines above, then re-run doctor.");
+    }
+    else if (report.checks.some((c) => c.status === "warn")) {
+        lines.push("Result: READY with warnings — greenlight works, but see the WARN lines.");
+    }
+    else {
+        lines.push("Result: READY — everything looks good.");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/evidence.d.ts

@@ -0,0 +1,48 @@
+import { type GuardResult } from "./guard.js";
+import { type CiTriageResult } from "./ci-triage.js";
+import { type ReviewTriageResult } from "./review-triage.js";
+import { type ProtocolFetchResult } from "./protocol-fetch.js";
+import type { VerifyResult } from "./verify.js";
+export interface EvidenceDeps {
+    guard?: (prUrl: string) => Promise<GuardResult>;
+    triageCi?: (prUrl: string) => Promise<CiTriageResult>;
+    triageReview?: (prUrl: string) => Promise<ReviewTriageResult>;
+    fetchPrMeta?: (owner: string, repo: string, number: number) => Promise<{
+        createdAt: string;
+        headSha: string;
+    }>;
+    protocolStatus?: (owner: string, repo: string, number: number) => Promise<ProtocolFetchResult | null>;
+    readVerifyJson?: (path: string) => Promise<VerifyResult | null>;
+}
+export interface EvidenceIssueProtocol {
+    issue: string;
+    url: string;
+    activeClaim: {
+        claimant: string;
+        state: string;
+        claimedAt: string;
+        expiresAt: string;
+        commentUrl: string | null;
+    } | null;
+    queue: string[];
+}
+export interface EvidencePack {
+    pr: string;
+    title: string;
+    author: string;
+    assembledAt: string;
+    version: string;
+    markdown: string;
+    json: Record<string, unknown>;
+}
+export interface EvidenceOptions {
+    verifyJsonPath?: string;
+    deps?: EvidenceDeps;
+    now?: Date;
+}
+/**
+ * Assemble the evidence pack. Best-effort throughout: a source that
+ * cannot be read becomes an explicit "could not be read" line, never a
+ * silent gap and never invented content.
+ */
+export declare function buildEvidencePack(prUrl: string, opts?: EvidenceOptions): Promise<EvidencePack>;

package/dist/evidence.js

@@ -0,0 +1,254 @@
+/**
+ * The Verified PR evidence pack. One markdown document per PR that a
+ * reader can check without trusting Greenlight's word: every claim in
+ * it cites its source (the check run, the review anchor, the claim
+ * comment URL).
+ *
+ * Assembled from the existing engines: the guard, CI triage, review
+ * triage, and the Claim Protocol state of the PR's linked issues. The
+ * test-suite delta is included only when the caller passes a prior
+ * `greenlight verify --json` report via --verify-json: the pack never
+ * runs suites itself (they take minutes and belong where the code is).
+ */
+import { apiGet, parsePullUrl, parseIssueUrl } from "./github.js";
+import { guardPr } from "./guard.js";
+import { triagePr } from "./ci-triage.js";
+import { triageReview as defaultTriageReview } from "./review-triage.js";
+import { fetchProtocolState } from "./protocol-fetch.js";
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+const GREENLIGHT_VERSION = (() => {
+    try {
+        return createRequire(import.meta.url)("../package.json").version;
+    }
+    catch {
+        return "unknown";
+    }
+})();
+async function defaultFetchPrMeta(owner, repo, number) {
+    const p = (await apiGet(`/repos/${owner}/${repo}/pulls/${number}`));
+    return {
+        createdAt: String(p.created_at ?? ""),
+        headSha: String(p.head?.sha ?? ""),
+    };
+}
+async function defaultReadVerifyJson(path) {
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        if (parsed && typeof parsed === "object" && typeof parsed.outcome === "string")
+            return parsed;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function cite(url) {
+    return url && url.length > 0 ? url : "(no link recorded)";
+}
+/**
+ * Assemble the evidence pack. Best-effort throughout: a source that
+ * cannot be read becomes an explicit "could not be read" line, never a
+ * silent gap and never invented content.
+ */
+export async function buildEvidencePack(prUrl, opts = {}) {
+    const deps = opts.deps ?? {};
+    const now = opts.now ?? new Date();
+    const { owner, repo, number } = parsePullUrl(prUrl);
+    const guard = deps.guard ?? guardPr;
+    const triageCi = deps.triageCi ?? triagePr;
+    const triageReview = deps.triageReview ?? defaultTriageReview;
+    const fetchPrMeta = deps.fetchPrMeta ?? defaultFetchPrMeta;
+    const protocolStatus = deps.protocolStatus ?? fetchProtocolState;
+    const readVerifyJson = deps.readVerifyJson ?? defaultReadVerifyJson;
+    const [guardRes, ciRes, reviewRes, meta] = await Promise.all([
+        guard(prUrl).catch((e) => ({ error: e instanceof Error ? e.message : String(e) })),
+        triageCi(prUrl).catch((e) => ({ error: e instanceof Error ? e.message : String(e) })),
+        triageReview(prUrl).catch((e) => ({ error: e instanceof Error ? e.message : String(e) })),
+        fetchPrMeta(owner, repo, number).catch(() => ({ createdAt: "", headSha: "" })),
+    ]);
+    const guardOk = (r) => typeof r === "object" && r !== null && !("error" in r);
+    const ciOk = (r) => typeof r === "object" && r !== null && !("error" in r);
+    const reviewOk = (r) => typeof r === "object" && r !== null && !("error" in r);
+    // Protocol status for each linked issue the guard found.
+    const issueProtocols = [];
+    if (guardOk(guardRes)) {
+        for (const li of guardRes.linkedIssues) {
+            try {
+                const { owner: iOwner, repo: iRepo, number: iNumber } = parseIssueUrl(li.url);
+                const proto = await protocolStatus(iOwner, iRepo, iNumber).catch(() => null);
+                const active = proto?.computation.active ?? null;
+                issueProtocols.push({
+                    issue: `${iOwner}/${iRepo}#${iNumber}`,
+                    url: li.url,
+                    activeClaim: active
+                        ? {
+                            claimant: active.claimant,
+                            state: active.state,
+                            claimedAt: active.claimedAt,
+                            expiresAt: active.expiresAt,
+                            commentUrl: active.commentUrl,
+                        }
+                        : null,
+                    queue: (proto?.computation.queue ?? []).map((q) => q.claimant),
+                });
+            }
+            catch {
+                issueProtocols.push({ issue: li.url, url: li.url, activeClaim: null, queue: [] });
+            }
+        }
+    }
+    let verifySection;
+    let verifyJson = null;
+    if (opts.verifyJsonPath) {
+        const vr = await readVerifyJson(opts.verifyJsonPath).catch(() => null);
+        if (vr && vr.delta) {
+            verifyJson = { outcome: vr.outcome, delta: vr.delta };
+            const d = vr.delta;
+            verifySection =
+                `Outcome: **${vr.outcome}** (from the provided verify report; the pack does not run suites itself).\n\n` +
+                    `- newly failing (yours): ${d.newlyFailing.length > 0 ? d.newlyFailing.join(", ") : "none"}\n` +
+                    `- newly passing (fixed by this PR): ${d.newlyPassing.length > 0 ? d.newlyPassing.join(", ") : "none"}\n` +
+                    `- still failing (pre-existing): ${d.stillFailing.length > 0 ? d.stillFailing.join(", ") : "none"}\n` +
+                    `- base ${d.baseTotal.passed}/${d.baseTotal.failed} passed/failed; head ${d.headTotal.passed}/${d.headTotal.failed} passed/failed`;
+        }
+        else {
+            verifySection = `No usable verify report at \`${opts.verifyJsonPath}\` (unreadable or not a verify result). Run \`greenlight verify --json\` where the code lives and pass it with --verify-json.`;
+        }
+    }
+    else {
+        verifySection = "Not included. Run `greenlight verify --json` where the code lives and pass the report with --verify-json to add the honest red-green delta.";
+    }
+    const lines = [];
+    const title = guardOk(guardRes) ? guardRes.title : "(title unavailable)";
+    const author = guardOk(guardRes) ? guardRes.author : "(unknown)";
+    lines.push(`# Evidence pack: ${owner}/${repo}#${number}`);
+    lines.push("");
+    lines.push(`"${title}" by @${author}. PR opened ${meta.createdAt ? meta.createdAt.slice(0, 10) : "(date unavailable)"}, head ${meta.headSha ? meta.headSha.slice(0, 7) : "(unknown)"}.`);
+    lines.push(`Assembled ${now.toISOString().slice(0, 10)} by Greenlight v${GREENLIGHT_VERSION}. Every claim below cites its source.`);
+    lines.push("");
+    // Guard section
+    lines.push("## Guard verdict");
+    if (guardOk(guardRes)) {
+        lines.push(guardRes.summary);
+        const flags = guardRes.findings.filter((f) => f.severity === "flag");
+        if (flags.length === 0) {
+            lines.push("No flags. Source: the guard's five checks (competing fix, prior claims, artifacts, first-time, protocol claims).");
+        }
+        else {
+            lines.push("");
+            lines.push("| Finding | Evidence |");
+            lines.push("|---|---|");
+            for (const f of flags) {
+                lines.push(`| ${f.title} | ${f.evidence.join(" ")} |`);
+            }
+        }
+        const notes = guardRes.findings.filter((f) => f.severity === "note");
+        if (notes.length > 0) {
+            lines.push("");
+            lines.push("Notes: " + notes.map((f) => f.evidence.join(" ")).join(" "));
+        }
+    }
+    else {
+        lines.push(`Could not be read this run: ${guardRes.error}`);
+    }
+    lines.push("");
+    // CI section
+    lines.push("## CI triage");
+    if (ciOk(ciRes)) {
+        lines.push(`Verdict: **${ciRes.verdict}**.`);
+        if (ciRes.checks.length === 0) {
+            lines.push("No failing checks on the PR head. Source: the check runs on the PR head.");
+        }
+        else {
+            lines.push("");
+            lines.push("| Check | Class | Evidence | Source |");
+            lines.push("|---|---|---|---|");
+            for (const c of ciRes.checks) {
+                lines.push(`| \`${c.name}\` | ${c.class}${c.lean ? ` (lean: ${c.lean})` : ""} | ${c.evidence} | ${cite(c.detailsUrl)} |`);
+            }
+        }
+    }
+    else {
+        lines.push(`Could not be read this run: ${ciRes.error}`);
+    }
+    lines.push("");
+    // Review section
+    lines.push("## Review triage");
+    if (reviewOk(reviewRes)) {
+        const c = reviewRes.counts;
+        lines.push(`Verdict: **${reviewRes.verdict}** (${c.likelyReal} likely-real, ${c.needsDecision} needs-decision, ${c.likelyNoise} likely-noise).`);
+        const actionable = reviewRes.findings.filter((f) => f.class === "likely-real" || f.class === "needs-decision");
+        if (actionable.length === 0) {
+            lines.push("No actionable findings. Source: review and issue comments on the PR.");
+        }
+        else {
+            lines.push("");
+            lines.push("| Finding | Class | Reviewer | Source |");
+            lines.push("|---|---|---|---|");
+            for (const f of actionable) {
+                const anchor = f.path ? `${f.path}${f.line ? `:${f.line}` : ""}` : "(review-level)";
+                lines.push(`| ${f.summary} | ${f.class} | @${f.author} (${f.authorKind}) | ${anchor} |`);
+            }
+            lines.push("");
+            lines.push("Reply drafts for each finding are in the review triage output; this pack records the findings, not the replies.");
+        }
+    }
+    else {
+        lines.push(`Could not be read this run: ${reviewRes.error}`);
+    }
+    lines.push("");
+    // Protocol section
+    lines.push("## Claim Protocol status of linked issues");
+    if (issueProtocols.length === 0) {
+        lines.push("No linked issues with readable protocol state.");
+    }
+    else {
+        for (const ip of issueProtocols) {
+            if (!ip.activeClaim) {
+                lines.push(`- ${ip.issue}: no protocol claims. Source: ${cite(ip.url)}`);
+            }
+            else {
+                const a = ip.activeClaim;
+                lines.push(`- ${ip.issue}: **${a.state}** claim held by @${a.claimant}, claimed ${a.claimedAt.slice(0, 10)}, expires ${a.expiresAt.slice(0, 10)}. Source: ${cite(a.commentUrl)}`);
+                if (ip.queue.length > 0)
+                    lines.push(`  Queue: ${ip.queue.map((q) => `@${q}`).join(", ")}`);
+            }
+        }
+    }
+    lines.push("");
+    // Verify section
+    lines.push("## Test-suite delta");
+    lines.push(verifySection);
+    lines.push("");
+    // Sources
+    lines.push("## Sources");
+    lines.push(`- PR: ${cite(prUrl)}`);
+    if (guardOk(guardRes)) {
+        for (const li of guardRes.linkedIssues)
+            lines.push(`- Linked issue: ${cite(li.url)}`);
+    }
+    lines.push(`- Pack generator: Greenlight v${GREENLIGHT_VERSION} (guard + ci_triage + review_triage + protocol engines).`);
+    lines.push("");
+    const markdown = lines.join("\n");
+    return {
+        pr: `${owner}/${repo}#${number}`,
+        title,
+        author,
+        assembledAt: now.toISOString(),
+        version: GREENLIGHT_VERSION,
+        markdown,
+        json: {
+            pr: `${owner}/${repo}#${number}`,
+            title,
+            author,
+            version: GREENLIGHT_VERSION,
+            guard: guardOk(guardRes) ? { summary: guardRes.summary, flags: guardRes.findings.filter((f) => f.severity === "flag").map((f) => ({ check: f.check, title: f.title, evidence: f.evidence })) } : { error: guardRes.error },
+            ci: ciOk(ciRes) ? { verdict: ciRes.verdict, checks: ciRes.checks } : { error: ciRes.error },
+            review: reviewOk(reviewRes) ? { verdict: reviewRes.verdict, counts: reviewRes.counts, findings: reviewRes.findings } : { error: reviewRes.error },
+            protocol: issueProtocols,
+            verify: verifyJson,
+        },
+    };
+}
+//# sourceMappingURL=evidence.js.map

package/dist/evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.js","sourceRoot":"","sources":["../src/evidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,OAAO,EAAoB,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAuB,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,YAAY,IAAI,mBAAmB,EAA2B,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAA4B,MAAM,qBAAqB,CAAC;AAEnF,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,kBAAkB,GAAW,CAAC,GAAG,EAAE;IACvC,IAAI,CAAC;QACH,OAAQ,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC;IAC5F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC,EAAE,CAAC;AAgBL,KAAK,UAAU,kBAAkB,CAAC,KAAa,EAAE,IAAY,EAAE,MAAc;IAC3E,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,UAAU,KAAK,IAAI,IAAI,UAAU,MAAM,EAAE,CAAC,CAAgB,CAAC;IACnF,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC;QACrC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;KACnC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,qBAAqB,CAAC,IAAY;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAiB,CAAC;QACtE,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC;QAC9F,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAyBD,SAAS,IAAI,CAAC,GAA8B;IAC1C,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,oBAAoB,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAa,EAAE,OAAwB,EAAE;IAC/E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACnC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC;IAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,mBAAmB,CAAC;IAC9D,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,kBAAkB,CAAC;IAC3D,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,kBAAkB,CAAC;IACjE,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,qBAAqB,CAAC;IAEpE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC3D,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClF,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACrF,YAAY,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzF,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;KAC/E,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,CAAC,CAAU,EAAoB,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IACzG,MAAM,IAAI,GAAG,CAAC,CAAU,EAAuB,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IACzG,MAAM,QAAQ,GAAG,CAAC,CAAU,EAA2B,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IAEjH,yDAAyD;IACzD,MAAM,cAAc,GAA4B,EAAE,CAAC;IACnD,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtB,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;gBAC9E,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;gBAC7E,MAAM,MAAM,GAAG,KAAK,EAAE,WAAW,CAAC,MAAM,IAAI,IAAI,CAAC;gBACjD,cAAc,CAAC,IAAI,CAAC;oBAClB,KAAK,EAAE,GAAG,MAAM,IAAI,KAAK,IAAI,OAAO,EAAE;oBACtC,GAAG,EAAE,EAAE,CAAC,GAAG;oBACX,WAAW,EAAE,MAAM;wBACjB,CAAC,CAAC;4BACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;4BACzB,KAAK,EAAE,MAAM,CAAC,KAAK;4BACnB,SAAS,EAAE,MAAM,CAAC,SAAS;4BAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;4BAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;yBAC9B;wBACH,CAAC,CAAC,IAAI;oBACR,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;iBAC/D,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,cAAc,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YACpF,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,aAAqB,CAAC;IAC1B,IAAI,UAAU,GAAmC,IAAI,CAAC;IACtD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,EAAE,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACvE,IAAI,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;YACnB,UAAU,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC;YACtD,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC;YACnB,aAAa;gBACX,cAAc,EAAE,CAAC,OAAO,gFAAgF;oBACxG,4BAA4B,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI;oBAC9F,uCAAuC,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI;oBACzG,mCAAmC,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI;oBACrG,UAAU,CAAC,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,wBAAwB,CAAC,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,gBAAgB,CAAC;QACvI,CAAC;aAAM,CAAC;YACN,aAAa,GAAG,gCAAgC,IAAI,CAAC,cAAc,+HAA+H,CAAC;QACrM,CAAC;IACH,CAAC;SAAM,CAAC;QACN,aAAa,GAAG,6IAA6I,CAAC;IAChK,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,qBAAqB,CAAC;IACzE,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;IACjE,KAAK,CAAC,IAAI,CAAC,oBAAoB,KAAK,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,MAAM,eAAe,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,oBAAoB,UAAU,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC;IACzL,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,kBAAkB,uCAAuC,CAAC,CAAC;IACpI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,gBAAgB;IAChB,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/B,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC;QACrE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,kHAAkH,CAAC,CAAC;QACjI,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC;QACrE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,+BAAgC,QAA8B,CAAC,KAAK,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,aAAa;IACb,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;QAC7C,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;QACzF,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAChC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC7B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,MAAM,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC5H,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,+BAAgC,KAA2B,CAAC,KAAK,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,iBAAiB;IACjB,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/B,IAAI,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,cAAc,SAAS,CAAC,OAAO,OAAO,CAAC,CAAC,UAAU,iBAAiB,CAAC,CAAC,aAAa,oBAAoB,CAAC,CAAC,WAAW,iBAAiB,CAAC,CAAC;QACjJ,MAAM,UAAU,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,aAAa,IAAI,CAAC,CAAC,KAAK,KAAK,gBAAgB,CAAC,CAAC;QAC/G,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;QACrF,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAChC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;gBAC3B,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC;gBACpF,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,UAAU,OAAO,MAAM,IAAI,CAAC,CAAC;YAC3F,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,iHAAiH,CAAC,CAAC;QAChI,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,+BAAgC,SAA+B,CAAC,KAAK,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,mBAAmB;IACnB,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IACxD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC/D,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,EAAE,IAAI,cAAc,EAAE,CAAC;YAChC,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;gBACpB,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,iCAAiC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3E,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC;gBACzB,KAAK,CAAC,IAAI,CACR,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,KAAK,qBAAqB,CAAC,CAAC,QAAQ,aAAa,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CACtK,CAAC;gBACF,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7F,CAAC;QACH,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,iBAAiB;IACjB,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,UAAU;IACV,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnC,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtB,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,YAAY;YAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,iCAAiC,kBAAkB,0DAA0D,CAAC,CAAC;IAC1H,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO;QACL,EAAE,EAAE,GAAG,KAAK,IAAI,IAAI,IAAI,MAAM,EAAE;QAChC,KAAK;QACL,MAAM;QACN,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE;QAC9B,OAAO,EAAE,kBAAkB;QAC3B,QAAQ;QACR,IAAI,EAAE;YACJ,EAAE,EAAE,GAAG,KAAK,IAAI,IAAI,IAAI,MAAM,EAAE;YAChC,KAAK;YACL,MAAM;YACN,OAAO,EAAE,kBAAkB;YAC3B,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAG,QAA8B,CAAC,KAAK,EAAE;YACjP,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAG,KAA2B,CAAC,KAAK,EAAE;YAClH,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAG,SAA+B,CAAC,KAAK,EAAE;YACxK,QAAQ,EAAE,cAAc;YACxB,MAAM,EAAE,UAAU;SACnB;KACF,CAAC;AACJ,CAAC"}

package/dist/github.js

@@ -133,14 +133,14 @@ async function paginate(path, perPage = 100, maxPages = 5) {
 export function parseIssueUrl(url) {
     const m = /github\.com\/([^/]+)\/([^/]+)\/(?:issues|pull)\/(\d+)/.exec(url);
     if (!m)
-        throw new Error(`Not a GitHub issue URL: ${url}`);
+        throw new Error(`Not a GitHub issue URL: ${url} (expected https://github.com/<owner>/<repo>/issues/<number>)`);
     return { owner: m[1], repo: m[2], number: Number(m[3]) };
 }
 /** Strict parser for PR URLs (ci triage only accepts /pull/ URLs). */
 export function parsePullUrl(url) {
     const m = /github\.com\/([^/]+)\/([^/]+)\/pull\/(\d+)/.exec(url);
     if (!m)
-        throw new Error(`Not a GitHub pull request URL: ${url}`);
+        throw new Error(`Not a GitHub pull request URL: ${url} (expected https://github.com/<owner>/<repo>/pull/<number>)`);
     return { owner: m[1], repo: m[2], number: Number(m[3]) };
 }
 /** Fetch issue comments for claim detection. */