thurview 0.8.2 → 0.9.0

package/dist/forge/gitlab.js

@@ -0,0 +1,226 @@
+import { AxiError } from "axi-sdk-js";
+import { runJson, ok } from "./run.js";
+import { parseRemote } from "./github.js";
+/**
+ * GitLab, through `glab api`. Every parameter goes through `--raw-field`, the
+ * literal-string flag, so a comment body starting with `@` is sent as text
+ * rather than read as a file path.
+ * Three things differ from GitHub beyond the
+ * nouns, and each one is answered here rather than papered over:
+ *
+ *   - There is no atomic review. A pass is N discussions plus one note, so a
+ *     failure part-way through leaves the comments already posted. `submit`
+ *     posts the inline comments first and the summary last, so a partial pass
+ *     is one the author can still read.
+ *   - There is no CHANGES_REQUESTED. `request-changes` removes this account's
+ *     approval and says so in the summary note; it cannot block a merge the
+ *     way GitHub's state does, and `notes` says that out loud.
+ *   - A comment anchors to one line. A range is anchored at its last line and
+ *     reported in `notes`; the range itself belongs in the comment's own
+ *     permalink.
+ */
+/**
+ * Job statuses, mapped once and here. `manual` is a job that exists and has
+ * not run, which is the exact case a "no failures" reading gets wrong.
+ */
+const JOB = {
+    success: "passed",
+    failed: "failed",
+    canceled: "cancelled",
+    cancelled: "cancelled",
+    skipped: "skipped",
+    manual: "skipped",
+    running: "running",
+    pending: "running",
+    created: "running",
+    preparing: "running",
+    waiting_for_resource: "running",
+    scheduled: "running",
+};
+function iidOf(ref) {
+    const m = /^(?:.*\/merge_requests\/)?!?(\d+)\/?$/.exec(ref.trim());
+    if (!m)
+        throw new AxiError(`${ref} is not a merge request number or URL`, "VALIDATION_ERROR", [
+            "Pass --change 123 or the full merge request URL",
+        ]);
+    return m[1];
+}
+export class GitLabForge {
+    id = "gitlab";
+    cli = "glab";
+    api(repo, endpoint, args = []) {
+        return ["api", "--hostname", repo.host, endpoint, ...args];
+    }
+    project(repo) {
+        return encodeURIComponent(repo.path);
+    }
+    async owns(host) {
+        if (host === "gitlab.com" || host === process.env["GITLAB_HOST"])
+            return true;
+        return ok("glab", ["auth", "status", "--hostname", host]);
+    }
+    async whoami(repo) {
+        const me = await runJson("glab", this.api(repo, "user"));
+        return me.username;
+    }
+    repoFromRemote(url) {
+        return parseRemote(url);
+    }
+    async get(repo, ref) {
+        const iid = iidOf(ref);
+        const mr = await runJson("glab", this.api(repo, `projects/${this.project(repo)}/merge_requests/${iid}`));
+        return {
+            number: String(mr.iid),
+            title: mr.title,
+            url: mr.web_url,
+            state: mr.state === "merged" ? "merged" : mr.state === "opened" ? "open" : "closed",
+            author: mr.author?.username ?? "unknown",
+            head: mr.diff_refs?.head_sha ?? mr.sha,
+            headBranch: mr.source_branch,
+            base: mr.diff_refs?.base_sha ?? "",
+            baseBranch: mr.target_branch,
+            fromFork: mr.source_project_id !== mr.target_project_id,
+            draft: Boolean(mr.draft ?? mr.work_in_progress),
+            body: mr.description ?? "",
+        };
+    }
+    fetchRef(cr) {
+        return `refs/merge-requests/${cr.number}/head`;
+    }
+    async checks(repo, cr) {
+        const pipelines = await runJson("glab", this.api(repo, `projects/${this.project(repo)}/merge_requests/${cr.number}/pipelines`));
+        return this.jobsOf(repo, pipelines[0]);
+    }
+    async baseline(repo, branch) {
+        const pipelines = await runJson("glab", this.api(repo, `projects/${this.project(repo)}/pipelines?ref=${encodeURIComponent(branch)}&per_page=1`));
+        return this.jobsOf(repo, pipelines[0]);
+    }
+    /** Jobs live in the pipeline's own project, which for a fork is not `repo`. */
+    async jobsOf(repo, pipeline) {
+        if (!pipeline)
+            return [];
+        const jobs = await runJson("glab", this.api(repo, `projects/${pipeline.project_id}/pipelines/${pipeline.id}/jobs?per_page=100`));
+        return jobs.map((j) => ({
+            name: j.name,
+            state: JOB[j.status] ?? "unknown",
+            raw: j.status,
+            ...(j.web_url ? { url: j.web_url } : {}),
+        }));
+    }
+    async prior(repo, cr) {
+        const discussions = await runJson("glab", this.api(repo, `projects/${this.project(repo)}/merge_requests/${cr.number}/discussions?per_page=100`));
+        const threads = [];
+        const passes = [];
+        for (const d of discussions) {
+            const notes = d.notes.filter((n) => !n.system);
+            const first = notes[0];
+            if (!first)
+                continue;
+            // A discussion with no position and no resolvable flag is a plain note
+            // on the merge request, which is what a summary pass looks like here.
+            if (!first.position && !first.resolvable) {
+                passes.push({
+                    id: d.id,
+                    author: first.author?.username ?? "unknown",
+                    verdict: "comment",
+                    at: "",
+                    body: first.body,
+                });
+                continue;
+            }
+            threads.push({
+                id: d.id,
+                author: first.author?.username ?? "unknown",
+                ...(first.position?.new_path ? { path: first.position.new_path } : {}),
+                ...(first.position?.new_line ? { line: first.position.new_line } : {}),
+                side: first.position?.new_line ? "head" : "base",
+                resolved: notes.some((n) => n.resolvable) && notes.every((n) => !n.resolvable || n.resolved),
+                // GitLab reports no per-comment staleness; the head it was written
+                // against is the only signal, and `prior` compares it in the CLI.
+                outdated: false,
+                ...(first.position?.head_sha ? { commit: first.position.head_sha } : {}),
+                messages: notes.map((n) => ({ author: n.author?.username ?? "unknown", body: n.body })),
+            });
+        }
+        const approvals = await runJson("glab", this.api(repo, `projects/${this.project(repo)}/merge_requests/${cr.number}/approvals`));
+        for (const a of approvals.approved_by ?? [])
+            passes.push({
+                id: `approval:${a.user.username}`,
+                author: a.user.username,
+                verdict: "approve",
+                at: "",
+                body: "",
+            });
+        return { passes, threads };
+    }
+    async submit(repo, cr, s) {
+        const mr = await runJson("glab", this.api(repo, `projects/${this.project(repo)}/merge_requests/${cr.number}`));
+        const refs = mr.diff_refs;
+        if (!refs && s.comments.length)
+            throw new AxiError("this merge request reports no diff refs", "FORGE_ERROR", [
+                "Post the summary alone with an empty comments array, or retry once the merge request has a diff",
+            ]);
+        const notes = [];
+        let posted = 0;
+        for (const c of s.comments) {
+            if (c.startLine && c.startLine < c.line)
+                notes.push(`${c.path}:${c.startLine}-${c.line} anchored at line ${c.line}`);
+            await runJson("glab", this.api(repo, `projects/${this.project(repo)}/merge_requests/${cr.number}/discussions`, [
+                "--method",
+                "POST",
+                "--raw-field",
+                `body=${c.body}`,
+                "--raw-field",
+                "position[position_type]=text",
+                "--raw-field",
+                `position[base_sha]=${refs.base_sha}`,
+                "--raw-field",
+                `position[start_sha]=${refs.start_sha}`,
+                "--raw-field",
+                `position[head_sha]=${refs.head_sha}`,
+                "--raw-field",
+                `position[new_path]=${c.path}`,
+                "--raw-field",
+                `position[old_path]=${c.path}`,
+                "--raw-field",
+                c.side === "base" ? `position[old_line]=${c.line}` : `position[new_line]=${c.line}`,
+            ]));
+            posted++;
+        }
+        if (s.verdict === "approve") {
+            await runJson("glab", this.api(repo, `projects/${this.project(repo)}/merge_requests/${cr.number}/approve`, [
+                "--method",
+                "POST",
+            ]));
+        }
+        else if (s.verdict === "request-changes") {
+            notes.push("GitLab has no changes-requested state; this account's approval was removed and the summary says changes are requested");
+            await runJson("glab", this.api(repo, `projects/${this.project(repo)}/merge_requests/${cr.number}/unapprove`, [
+                "--method",
+                "POST",
+            ])).catch(() => notes.push("no approval by this account to remove"));
+        }
+        await runJson("glab", this.api(repo, `projects/${this.project(repo)}/merge_requests/${cr.number}/notes`, [
+            "--method",
+            "POST",
+            "--raw-field",
+            `body=${s.body}`,
+        ]));
+        return { verdict: s.verdict, posted, url: cr.url, notes };
+    }
+    async reply(repo, cr, threadId, body, resolve) {
+        const base = `projects/${this.project(repo)}/merge_requests/${cr.number}/discussions/${threadId}`;
+        if (body !== undefined)
+            await runJson("glab", this.api(repo, `${base}/notes`, ["--method", "POST", "--raw-field", `body=${body}`]));
+        if (resolve)
+            await runJson("glab", this.api(repo, base, ["--method", "PUT", "--raw-field", "resolved=true"]));
+        return { replied: body !== undefined, resolved: resolve, notes: [] };
+    }
+    permalink(repo, sha, path, from, to) {
+        const base = `https://${repo.host}/${repo.path}/-/blob/${sha}/${path}`;
+        if (!from)
+            return base;
+        return to && to > from ? `${base}#L${from}-${to}` : `${base}#L${from}`;
+    }
+}
+//# sourceMappingURL=gitlab.js.map

package/dist/forge/gitlab.js.map

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

package/dist/forge/index.js

@@ -0,0 +1,110 @@
+import { AxiError } from "axi-sdk-js";
+import * as g from "../git.js";
+import { GitHubForge, parseRemote } from "./github.js";
+import { GitLabForge } from "./gitlab.js";
+export * from "./types.js";
+export { parseRemote };
+const BUILTIN = [new GitHubForge(), new GitLabForge()];
+export function forgeById(id) {
+    const f = BUILTIN.find((x) => x.id === id);
+    if (!f)
+        throw new AxiError(`unknown forge ${id}`, "VALIDATION_ERROR", [
+            `--forge takes ${BUILTIN.map((x) => x.id).join(" or ")}`,
+        ]);
+    return f;
+}
+/**
+ * Which adapter owns a host. `github.com` and `gitlab.com` are decided by
+ * name; every other host is asked of the machine, because a self-hosted
+ * instance is the normal case and its name says nothing. A host no adapter
+ * claims is REFUSED rather than guessed at - guessing wrong means posting a
+ * review on somebody else's repository.
+ */
+export async function forgeFor(host, explicit) {
+    if (explicit)
+        return forgeById(explicit);
+    for (const f of BUILTIN)
+        if (await f.owns(host))
+            return f;
+    throw new AxiError(`no forge configured for ${host}`, "FORGE_ERROR", [
+        `Authenticate the host (\`gh auth login --hostname ${host}\` or \`glab auth login --hostname ${host}\`)`,
+        `Or pass --forge ${BUILTIN.map((x) => x.id).join("|")} to name it`,
+    ]);
+}
+/** The repository this worktree's `origin` points at. */
+export async function repoOf(worktree, explicit) {
+    if (explicit) {
+        const parts = explicit.split("/").filter(Boolean);
+        if (parts.length < 2)
+            throw new AxiError(`${explicit} is not a host-qualified repository`, "VALIDATION_ERROR", [
+                "--repo takes host/path, as in github.com/owner/repo",
+            ]);
+        return { host: parts[0], path: parts.slice(1).join("/") };
+    }
+    const url = (await g.git(worktree, ["remote", "get-url", "origin"]).catch(() => "")).trim();
+    const repo = url ? parseRemote(url) : null;
+    if (!repo)
+        throw new AxiError("could not read a forge repository from `origin`", "FORGE_ERROR", [
+            "Pass --repo host/path, as in github.com/owner/repo",
+        ]);
+    return repo;
+}
+function count(checks, state) {
+    return checks.filter((c) => c.state === state).length;
+}
+/**
+ * What CI actually established, in one sentence the review can quote.
+ *
+ * Two failures this answers, both of which shipped bugs before it existed: a
+ * change request from a fork runs a fraction of the checks an internal branch
+ * runs, and a cancelled job reads as "no failures" in every summary view. So
+ * the count that matters is not "did anything fail" but "how much ran here
+ * against how much runs on the branch this would merge into".
+ */
+export function summariseCi(checks, baseline, baselineBranch) {
+    const s = {
+        trustworthy: false,
+        verdict: "",
+        ran: checks.length,
+        passed: count(checks, "passed"),
+        failed: count(checks, "failed"),
+        cancelled: count(checks, "cancelled"),
+        skipped: count(checks, "skipped"),
+        running: count(checks, "running"),
+        unknown: count(checks, "unknown"),
+        baselineRan: baseline ? baseline.length : null,
+        baselineBranch,
+    };
+    const missing = s.baselineRan === null ? null : s.baselineRan - s.ran;
+    const parts = [];
+    if (!s.ran)
+        parts.push("No check ran on this head");
+    else
+        parts.push(`${s.passed} of ${s.ran} checks passed`);
+    if (s.failed)
+        parts.push(`${s.failed} failed`);
+    if (s.cancelled)
+        parts.push(`${s.cancelled} were cancelled, so they asserted nothing`);
+    if (s.skipped)
+        parts.push(`${s.skipped} never ran`);
+    if (s.running)
+        parts.push(`${s.running} are still running`);
+    if (s.unknown)
+        parts.push(`${s.unknown} could not be read`);
+    if (missing === null)
+        parts.push(`what ${baselineBranch} itself runs could not be read, so nothing here says how much CI is missing`);
+    else if (missing > 0)
+        parts.push(`${baselineBranch} runs ${s.baselineRan}, so ${missing} of them are absent here`);
+    s.trustworthy =
+        s.ran > 0 &&
+            s.failed === 0 &&
+            s.cancelled === 0 &&
+            s.running === 0 &&
+            s.unknown === 0 &&
+            missing !== null &&
+            missing <= 0;
+    parts.push(s.trustworthy ? "CI is a real gate on this change" : "CI is not a gate here; the review is");
+    s.verdict = parts.join("; ") + ".";
+    return s;
+}
+//# sourceMappingURL=index.js.map

package/dist/forge/index.js.map

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

package/dist/forge/run.js

@@ -0,0 +1,55 @@
+import { AxiError } from "axi-sdk-js";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileP = promisify(execFile);
+/** 8 MB: a busy change request's discussions exceed the 1 MB default. */
+const MAX_OUTPUT = 8 * 1024 * 1024;
+/**
+ * Drive a forge CLI. A missing binary and a failed call both become an
+ * AxiError naming the command, so the agent is told which tool to install or
+ * authenticate rather than seeing a decoded empty answer.
+ */
+export async function run(cli, args, opts = {}) {
+    try {
+        const child = execFileP(cli, args, { cwd: opts.cwd, maxBuffer: MAX_OUTPUT });
+        if (opts.input !== undefined) {
+            child.child.stdin?.end(opts.input);
+        }
+        const { stdout } = await child;
+        return stdout;
+    }
+    catch (e) {
+        const err = e;
+        if (err.code === "ENOENT")
+            throw new AxiError(`${cli} is not on PATH`, "FORGE_ERROR", [
+                `Install ${cli} and authenticate it, or pass --forge to name the other forge`,
+            ]);
+        const detail = (err.stderr || err.message || "").trim().split("\n").slice(0, 3).join("; ");
+        throw new AxiError(`${cli} ${args[0] ?? ""} failed: ${detail}`, "FORGE_ERROR", [
+            `Check \`${cli} auth status\``,
+            "Check the change request number and that the account can read the repository",
+        ]);
+    }
+}
+export async function runJson(cli, args, opts = {}) {
+    const out = await run(cli, args, opts);
+    try {
+        return JSON.parse(out);
+    }
+    catch {
+        throw new AxiError(`${cli} returned output that is not JSON`, "FORGE_ERROR", [
+            `Run \`${cli} ${args.join(" ")}\` by hand to see what it answered`,
+        ]);
+    }
+}
+/** True when the CLI exists and exits 0 for `args`; used for host discovery. */
+export async function ok(cli, args) {
+    try {
+        await execFileP(cli, args, { maxBuffer: MAX_OUTPUT });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/forge/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/forge/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAEtC,yEAAyE;AACzE,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAQnC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,GAAW,EAAE,IAAc,EAAE,IAAI,GAAe,EAAE;IAC1E,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;QAC7E,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAAgD,CAAC;QAC7D,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;YACvB,MAAM,IAAI,QAAQ,CAAC,GAAG,GAAG,iBAAiB,EAAE,aAAa,EAAE;gBACzD,WAAW,GAAG,+DAA+D;aAC9E,CAAC,CAAC;QACL,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3F,MAAM,IAAI,QAAQ,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,YAAY,MAAM,EAAE,EAAE,aAAa,EAAE;YAC7E,WAAW,GAAG,gBAAgB;YAC9B,8EAA8E;SAC/E,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAI,GAAW,EAAE,IAAc,EAAE,IAAI,GAAe,EAAE;IACjF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAAC,GAAG,GAAG,mCAAmC,EAAE,aAAa,EAAE;YAC3E,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,oCAAoC;SACnE,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC,GAAW,EAAE,IAAc;IAClD,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/forge/submission.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { AxiError } from "axi-sdk-js";
+/**
+ * The file `thurview forge submit` takes. One pass of a review: a summary, the
+ * inline comments, and a verdict. It is a file rather than flags because a
+ * review comment is prose with newlines in it, and because the file is the
+ * thing a human can read before it is posted on their behalf.
+ */
+const Schema = z.object({
+    verdict: z.enum(["comment", "approve", "request-changes"]),
+    body: z.string().min(1),
+    comments: z
+        .array(z.object({
+        path: z.string().min(1),
+        line: z.number().int().positive(),
+        startLine: z.number().int().positive().optional(),
+        side: z.enum(["head", "base"]).optional(),
+        body: z.string().min(1),
+    }))
+        .default([]),
+});
+export function parseSubmission(text, file) {
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch (e) {
+        throw new AxiError(`${file} is not valid JSON: ${e.message}`, "VALIDATION_ERROR", [
+            'The file holds {"verdict": "comment", "body": "...", "comments": []}',
+        ]);
+    }
+    const parsed = Schema.safeParse(raw);
+    if (!parsed.success)
+        throw new AxiError(`${file} is not a submission: ${parsed.error.issues
+            .map((i) => `${i.path.join(".") || "(root)"} ${i.message}`)
+            .join("; ")}`, "VALIDATION_ERROR", [
+            "verdict is comment, approve or request-changes; body is the summary; comments[] each need path, line and body",
+        ]);
+    for (const c of parsed.data.comments)
+        if (c.startLine && c.startLine > c.line)
+            throw new AxiError(`${c.path}: startLine ${c.startLine} is after line ${c.line}`, "VALIDATION_ERROR", ["line is the LAST line of the range and startLine the first"]);
+    return parsed.data;
+}
+/**
+ * Comments long enough that the author will skim them. A finding that does
+ * not fit is two findings, or a claim plus one suggestion with the evidence
+ * behind a permalink - never a wall of prose on a line of someone's diff.
+ */
+export function longComments(s, max) {
+    return s.comments
+        .map((c, i) => ({ c, i, lines: c.body.trimEnd().split("\n").length }))
+        .filter((x) => x.lines > max)
+        .map((x) => `comments[${x.i}] on ${x.c.path}:${x.c.line} is ${x.lines} lines (max ${max})`);
+}
+//# sourceMappingURL=submission.js.map

package/dist/forge/submission.js.map

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

package/dist/forge/types.js

@@ -0,0 +1,37 @@
+/**
+ * The FORGE seam - what a review needs to know about a proposed change, and
+ * nothing about which forge answers it.
+ *
+ * THE WORD. GitHub calls it a pull request, GitLab a merge request. They are
+ * the same thing to this code, which says CHANGE REQUEST throughout and never
+ * picks a side. Prose that is genuinely about GitHub still says "pull
+ * request", because there it is describing GitHub.
+ *
+ * THE QUESTIONS. Each method exists because a review step needs it, not
+ * because a forge happens to offer it:
+ *
+ *   get       the change request itself - the head a review is written
+ *             against, the branch it is open from, whether it comes from a
+ *             fork
+ *   checks    what CI did on that head, one row per job
+ *   baseline  what CI does on the target branch's own tip, which is the only
+ *             way to see that a fork change request ran almost nothing
+ *   prior     every earlier review pass and every review thread, with who
+ *             wrote it, whether it is resolved and which commit it was
+ *             written against
+ *   submit    one pass - a summary, inline comments, a verdict
+ *   reply     answer one thread, and resolve it when its point is verified
+ *   permalink a file and line range at a pinned commit, as a URL the author
+ *             can open
+ *
+ * WHAT IS NOT HERE, deliberately: merge, close, push. A review comments; the
+ * maintainer merges. A seam with no merge method cannot be talked into one.
+ *
+ * A CHECK THAT COULD NOT BE READ IS `unknown`, NEVER `passed`. Every mapping
+ * below is explicit about which forge state becomes which verdict, because a
+ * cancelled job that reads as a pass is how two real bugs shipped.
+ */
+export function qualified(repo) {
+    return `${repo.host}/${repo.path}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/forge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/forge/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AASH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;AACrC,CAAC"}

package/dist/presence.js

@@ -0,0 +1,34 @@
+import { rm } from "node:fs/promises";
+import { agentFile, readJson, writeJson, now } from "./store.js";
+/** A heartbeat older than this is a dead `wait`, not a listening agent. */
+const TTL_MS = 15_000;
+const BEAT_MS = 3_000;
+export const NOBODY = { attached: false, lastSeen: null };
+export async function presenceOf(reviewId) {
+    const rec = await readJson(agentFile(reviewId));
+    if (!rec)
+        return NOBODY;
+    const at = Date.parse(rec.at);
+    if (!Number.isFinite(at))
+        return NOBODY;
+    return { attached: Date.now() - at < TTL_MS, lastSeen: rec.at };
+}
+/** Announce that this process is waiting on the review until `stop()` is called. */
+export function attach(reviewId) {
+    let stopped = false;
+    const beat = () => writeJson(agentFile(reviewId), { at: now(), pid: process.pid }).catch(() => { });
+    void beat();
+    const timer = setInterval(() => {
+        if (!stopped)
+            void beat();
+    }, BEAT_MS);
+    timer.unref();
+    return {
+        stop: async () => {
+            stopped = true;
+            clearInterval(timer);
+            await rm(agentFile(reviewId), { force: true });
+        },
+    };
+}
+//# sourceMappingURL=presence.js.map

package/dist/presence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.js","sourceRoot":"","sources":["../src/presence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAcjE,2EAA2E;AAC3E,MAAM,MAAM,GAAG,MAAM,CAAC;AACtB,MAAM,OAAO,GAAG,KAAK,CAAC;AAEtB,MAAM,CAAC,MAAM,MAAM,GAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAA8B,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7E,IAAI,CAAC,GAAG;QAAE,OAAO,MAAM,CAAC;IACxB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,MAAM,CAAC;IACxC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;AAClE,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,MAAM,CAAC,QAAgB;IACrC,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,IAAI,GAAG,GAAG,EAAE,CAChB,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAClF,KAAK,IAAI,EAAE,CAAC;IACZ,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,CAAC,OAAO;YAAE,KAAK,IAAI,EAAE,CAAC;IAC5B,CAAC,EAAE,OAAO,CAAC,CAAC;IACZ,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,OAAO;QACL,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,OAAO,GAAG,IAAI,CAAC;YACf,aAAa,CAAC,KAAK,CAAC,CAAC;YACrB,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server/server.js

@@ -11,6 +11,7 @@ import { symbolIndex } from "../symbols.js";
 import { registerTheme } from "../highlight.js";
 import { listReviews, readReview, writeReview, readThreads, readJson, reviewDir, revisionDir, deleteReview, writeJson, serverStateFile, } from "../store.js";
 import { createThread, replyThread, setThreadStatus, submitReview, deleteThread, } from "../threads.js";
+import { presenceOf } from "../presence.js";
 const UI_DIR = join(dirname(fileURLToPath(import.meta.url)), "..", "ui");
 class HttpError extends Error {
     status;
@@ -167,11 +168,14 @@ export async function startServer(opts = {}) {
                 ...data,
                 threads: threads.threads,
                 decisions: threads.decisions,
+                agent: await presenceOf(id),
             };
         }
         if (sub === "events") {
             throw new HttpError(500, "handled elsewhere");
         }
+        if (sub === "presence")
+            return (await presenceOf(id));
         if (sub === "revisions") {
             const out = [];
             for (let n = 1; n <= review.revision; n++)