@reneturcios/greenlight 0.5.0 → 0.7.0

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":"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"}

package/dist/guard.d.ts

@@ -1,14 +1,32 @@
 import type { CommentSignal, LinkedPR } from "./types.js";
 import { type ProtocolFetchResult } from "./protocol-fetch.js";
-export declare const GUARD_VERSION = "0.5.0";
+export declare const GUARD_VERSION = "0.6.0";
 /** The hidden marker the GitHub Action uses to find its own comment and update it. */
 export declare const GUARD_COMMENT_MARKER = "<!-- greenlight-guard -->";
 /** Check ids, also the keys of .greenlight-guard.json. */
 export declare const GUARD_CHECKS: readonly ["competing-fix", "other-claim", "missing-artifact", "first-time", "protocol-claim"];
 export type GuardCheckId = (typeof GUARD_CHECKS)[number];
-export type GuardConfig = Record<GuardCheckId, boolean>;
+export interface AutopilotConfig {
+    /**
+     * Machine check id (e.g. "competing-fix", "protocol-claim",
+     * "changeset-missing") -> label name to apply. Only findings with
+     * severity "flag" can earn a label; notes never do.
+     */
+    labels: Record<string, string>;
+    /**
+     * When true, the guard comment includes ready-to-copy stale-claim nudge
+     * lines for the maintainer. The guard never posts them anywhere itself.
+     */
+    nudge: boolean;
+}
+export interface GuardConfig extends Record<GuardCheckId, boolean> {
+    /** Autopilot is off when absent: the default. Maintainer opts in. */
+    autopilot?: AutopilotConfig | null;
+}
 export declare function defaultGuardConfig(): GuardConfig;
-/** Read .greenlight-guard.json from a directory (default cwd). Best-effort: anything unreadable means all checks on. */
+/** Parse the autopilot section of a raw config object. Anything malformed means off. */
+export declare function parseAutopilotConfig(raw: unknown): AutopilotConfig | null;
+/** Read .greenlight-guard.json from a directory (default cwd). Best-effort: anything unreadable means all checks on and autopilot off. */
 export declare function readGuardConfig(dir?: string): GuardConfig;
 export interface GuardLinkedIssue {
     number: number;
@@ -61,6 +79,21 @@ export interface GuardResult {
     summary: string;
     /** True when at least one finding has severity "flag". */
     hasFindings: boolean;
+    /**
+     * Autopilot label decisions: label names to apply, computed from the
+     * config's label map over severity-"flag" findings only. Empty unless
+     * the maintainer enabled autopilot in .greenlight-guard.json. The guard
+     * never applies these itself; the bundled Action does.
+     */
+    autopilotLabels: string[];
+    /** The check-by-check decisions behind autopilotLabels (for dry-run display). */
+    autopilotLabelDecisions: AutopilotLabelDecision[];
+    /**
+     * Ready-to-copy stale-claim nudge lines for the maintainer, included in
+     * the guard comment when autopilot.nudge is on. The guard never posts
+     * them anywhere itself.
+     */
+    staleClaimNudges: string[];
     /** The comment-ready markdown. */
     markdown: string;
 }
@@ -154,6 +187,28 @@ export declare function checkMissingArtifacts(args: {
     prAuthor: string;
     prComments: CommentSignal[];
 }): GuardFinding[];
+/** A claim is stale when it is 14+ days old and no open PR has appeared on its issue. */
+export declare const STALE_CLAIM_NUDGE_DAYS = 14;
+export interface AutopilotLabelDecision {
+    check: string;
+    title: string;
+    label: string;
+}
+/**
+ * Decide autopilot labels: the config's label map over severity-"flag"
+ * findings only. Pure, so fixtures can prove the mapping and the default-off.
+ * Notes never earn labels.
+ */
+export declare function decideAutopilotLabels(findings: GuardFinding[], autopilot: AutopilotConfig | null | undefined): AutopilotLabelDecision[];
+/**
+ * Build ready-to-copy nudge lines for stale foreign claims: 14+ days old
+ * with no OTHER open PR on the same issue (the guarded PR is the new
+ * arrival; another open PR means the claim is not stale). The maintainer
+ * copies and posts them on the issue; the guard never posts on the issue
+ * itself (sovereignty). Pure over the guard's own claims and competing
+ * PRs.
+ */
+export declare function buildStaleClaimNudges(claims: GuardClaim[], competingPRs: GuardCompetingPR[], guardedPrNumber: number): string[];
 /** Light author-history signal. Null means the lookup failed: no finding. */
 export declare function checkFirstTime(author: string, priorMerged: number | null): GuardFinding | null;
 export declare function renderGuardMarkdown(result: Omit<GuardResult, "markdown">): string;
@@ -175,3 +230,8 @@ export interface GuardDeps {
  * be read degrades to "no evidence" and its check is skipped.
  */
 export declare function guardPr(prUrl: string, deps?: GuardDeps, config?: GuardConfig): Promise<GuardResult>;
+/**
+ * The `--labels-dry-run` rendering: what autopilot WOULD do, in plain
+ * text, without touching anything. Never posts, never labels.
+ */
+export declare function renderLabelsDryRun(result: GuardResult): string;

package/dist/guard.js

@@ -44,6 +44,22 @@
  * "other-claim", "missing-artifact", "first-time", "protocol-claim");
  * unknown keys are ignored, a missing or unreadable file means every
  * check is on.
+ *
+ * Autopilot (check 6, maintainer-side action, off by default): the same
+ * config file may carry an "autopilot" section with a label map and a
+ * nudge toggle:
+ *
+ *   { "autopilot": { "labels": { "protocol-claim": "claim-conflict",
+ *                                "competing-fix": "duplicate-effort",
+ *                                "changeset-missing": "needs-changeset" },
+ *                    "nudge": true } }
+ *
+ * When enabled, the guard COMPUTES label decisions (check id -> label
+ * name, flags only) and ready-to-copy stale-claim nudge lines. It never
+ * applies labels or posts comments itself: the bundled GitHub Action
+ * reads the decisions from the guard JSON and applies the labels with
+ * the Actions token. The CLI reports the decisions with
+ * --labels-dry-run.
  */
 import { readFileSync } from "node:fs";
 import { apiGet, parsePullUrl, fetchLinkedPRs, fetchComments } from "./github.js";
@@ -53,15 +69,35 @@ import { detectClaPath, detectChangesetConvention } from "./prep-detail.js";
 import { titleSlug } from "./automate.js";
 import { parseGates } from "./gates.js";
 import { fetchProtocolState } from "./protocol-fetch.js";
-export const GUARD_VERSION = "0.5.0";
+export const GUARD_VERSION = "0.6.0";
 /** The hidden marker the GitHub Action uses to find its own comment and update it. */
 export const GUARD_COMMENT_MARKER = "<!-- greenlight-guard -->";
 /** Check ids, also the keys of .greenlight-guard.json. */
 export const GUARD_CHECKS = ["competing-fix", "other-claim", "missing-artifact", "first-time", "protocol-claim"];
 export function defaultGuardConfig() {
-    return { "competing-fix": true, "other-claim": true, "missing-artifact": true, "first-time": true, "protocol-claim": true };
+    return { "competing-fix": true, "other-claim": true, "missing-artifact": true, "first-time": true, "protocol-claim": true, autopilot: null };
+}
+/** Parse the autopilot section of a raw config object. Anything malformed means off. */
+export function parseAutopilotConfig(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const obj = raw;
+    const ap = obj["autopilot"];
+    if (!ap || typeof ap !== "object")
+        return null;
+    const apObj = ap;
+    const labels = {};
+    const rawLabels = apObj["labels"];
+    if (rawLabels && typeof rawLabels === "object") {
+        for (const [k, v] of Object.entries(rawLabels)) {
+            if (typeof k === "string" && k.trim() && typeof v === "string" && v.trim()) {
+                labels[k.trim()] = v.trim();
+            }
+        }
+    }
+    return { labels, nudge: apObj["nudge"] === true };
 }
-/** Read .greenlight-guard.json from a directory (default cwd). Best-effort: anything unreadable means all checks on. */
+/** Read .greenlight-guard.json from a directory (default cwd). Best-effort: anything unreadable means all checks on and autopilot off. */
 export function readGuardConfig(dir = process.cwd()) {
     const config = defaultGuardConfig();
     try {
@@ -70,9 +106,10 @@ export function readGuardConfig(dir = process.cwd()) {
             if (typeof raw[id] === "boolean")
                 config[id] = raw[id];
         }
+        config.autopilot = parseAutopilotConfig(raw);
     }
     catch {
-        // Missing or broken config: all checks stay on.
+        // Missing or broken config: all checks stay on, autopilot stays off.
     }
     return config;
 }
@@ -279,6 +316,57 @@ export function checkMissingArtifacts(args) {
     }
     return findings;
 }
+/** A claim is stale when it is 14+ days old and no open PR has appeared on its issue. */
+export const STALE_CLAIM_NUDGE_DAYS = 14;
+/**
+ * Decide autopilot labels: the config's label map over severity-"flag"
+ * findings only. Pure, so fixtures can prove the mapping and the default-off.
+ * Notes never earn labels.
+ */
+export function decideAutopilotLabels(findings, autopilot) {
+    if (!autopilot)
+        return [];
+    const seen = new Set();
+    const decisions = [];
+    for (const f of findings) {
+        if (f.severity !== "flag")
+            continue;
+        const label = autopilot.labels[f.check];
+        if (typeof label !== "string" || label.trim().length === 0)
+            continue;
+        const key = label.trim();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        decisions.push({ check: f.check, title: f.title, label: key });
+    }
+    return decisions;
+}
+/**
+ * Build ready-to-copy nudge lines for stale foreign claims: 14+ days old
+ * with no OTHER open PR on the same issue (the guarded PR is the new
+ * arrival; another open PR means the claim is not stale). The maintainer
+ * copies and posts them on the issue; the guard never posts on the issue
+ * itself (sovereignty). Pure over the guard's own claims and competing
+ * PRs.
+ */
+export function buildStaleClaimNudges(claims, competingPRs, guardedPrNumber) {
+    const nudges = [];
+    for (const c of claims) {
+        if (c.claimedByAuthor)
+            continue;
+        if (c.ageDays < STALE_CLAIM_NUDGE_DAYS)
+            continue;
+        const ref = c.issueRef ?? undefined;
+        const hasCompeting = competingPRs.some((p) => p.issueNumber === c.issueNumber && (p.issueRef ?? undefined) === ref);
+        if (hasCompeting)
+            continue;
+        const label = c.issueRef ?? `#${c.issueNumber}`;
+        nudges.push(`@${c.author} claimed ${label} ${c.ageDays} days ago and never opened a PR. ` +
+            `This PR (#${guardedPrNumber}) now addresses it — if you're still working on it, reply to keep your claim; otherwise the claim lapses.`);
+    }
+    return nudges;
+}
 /** Light author-history signal. Null means the lookup failed: no finding. */
 export function checkFirstTime(author, priorMerged) {
     if (priorMerged === null)
@@ -326,6 +414,13 @@ export function renderGuardMarkdown(result) {
         }
         lines.push("");
     }
+    if (result.staleClaimNudges.length > 0) {
+        lines.push("For the maintainer (autopilot nudge lines — copy and paste onto the issue; the guard never posts these itself):");
+        for (const n of result.staleClaimNudges) {
+            lines.push(`> ${n}`);
+        }
+        lines.push("");
+    }
     lines.push("---");
     lines.push(`_Checked with [Greenlight guard](https://github.com/CloudCorpRecords/greenlight) v${GUARD_VERSION}; findings are signals, verify before acting._`);
     return lines.join("\n");
@@ -644,6 +739,12 @@ export async function guardPr(prUrl, deps = {}, config = defaultGuardConfig()) {
             findings.push(f);
     }
     const { summary, hasFindings } = buildGuardSummary(findings);
+    // Autopilot: computed, never applied, here. Labels come from the
+    // maintainer's label map over severity-"flag" findings; nudge lines are
+    // ready-to-copy text the maintainer posts on the issue themselves.
+    const autopilot = config.autopilot ?? null;
+    const labelDecisions = decideAutopilotLabels(findings, autopilot);
+    const staleClaimNudges = autopilot?.nudge ? buildStaleClaimNudges(claims, competingPRs, number) : [];
     const result = {
         pr: prUrl,
         number,
@@ -656,9 +757,35 @@ export async function guardPr(prUrl, deps = {}, config = defaultGuardConfig()) {
         findings,
         summary,
         hasFindings,
+        autopilotLabels: labelDecisions.map((d) => d.label),
+        autopilotLabelDecisions: labelDecisions,
+        staleClaimNudges,
         markdown: "",
     };
     result.markdown = renderGuardMarkdown(result);
     return result;
 }
+/**
+ * The `--labels-dry-run` rendering: what autopilot WOULD do, in plain
+ * text, without touching anything. Never posts, never labels.
+ */
+export function renderLabelsDryRun(result) {
+    const lines = [`Autopilot label dry run for ${result.repo}#${result.number}`];
+    const decisions = result.autopilotLabelDecisions;
+    if (decisions.length === 0) {
+        lines.push("No autopilot labels: the maintainer has not enabled autopilot, or no mapped flag fired.");
+    }
+    else {
+        lines.push(`Would apply ${decisions.length} label${decisions.length === 1 ? "" : "s"}: ${decisions.map((d) => d.label).join(", ")}`);
+        for (const d of decisions) {
+            lines.push(`  "${d.check}" (${d.title}) -> "${d.label}"`);
+        }
+    }
+    if (result.staleClaimNudges.length > 0) {
+        lines.push("Stale-claim nudge lines (for the maintainer to post on the issue):");
+        for (const n of result.staleClaimNudges)
+            lines.push(`  > ${n}`);
+    }
+    return lines.join("\n");
+}
 //# sourceMappingURL=guard.js.map