@reneturcios/greenlight 0.13.0 → 0.15.0

package/dist/brief.d.ts

@@ -0,0 +1,94 @@
+import { type CiTriageDeps, type CiTriageResult } from "./ci-triage.js";
+import { type ReviewTriageDeps, type ReviewTriageResult } from "./review-triage.js";
+export type BriefFileArea = "source" | "tests" | "config" | "docs" | "generated" | "other";
+export interface BriefFile {
+    filename: string;
+    status: "added" | "modified" | "removed" | "renamed" | "other";
+    additions: number;
+    deletions: number;
+    area: BriefFileArea;
+}
+export interface BriefResult {
+    pr: string;
+    number: number;
+    title: string;
+    author: string;
+    state: string;
+    merged: boolean;
+    draft: boolean;
+    url: string;
+    createdAt: string;
+    ageDays: number;
+    baseRef: string;
+    size: {
+        additions: number;
+        deletions: number;
+        filesChanged: number;
+    };
+    areas: Array<{
+        area: BriefFileArea;
+        files: string[];
+    }>;
+    ci: CiTriageResult;
+    review: ReviewTriageResult;
+    testEvidence: {
+        newOrChangedTestFiles: string[];
+        /** Plain statement: what test evidence exists, or that none does. */
+        note: string;
+    };
+    /** Concrete merge blockers found, each with evidence. */
+    blockers: string[];
+    /** Things not verified, stated plainly. */
+    unverified: string[];
+    /** One line: what the reviewer should look at first. */
+    lookFirst: string;
+    /** API calls consumed (measured, for budget honesty). */
+    apiCalls: number;
+}
+export interface BriefDeps {
+    /** Test seam / alternate PR detail fetch. */
+    fetchPullDetail?: (owner: string, repo: string, number: number) => Promise<PullDetailFull>;
+    /** Test seam / alternate file list fetch. */
+    fetchPullFiles?: (owner: string, repo: string, number: number) => Promise<BriefFile[]>;
+    /** Test seam / alternate reviews fetch (for change-request blockers). */
+    fetchReviews?: (owner: string, repo: string, number: number) => Promise<ReviewStateItem[]>;
+    /** Test seam / alternate contributing-text fetch (changeset signal). */
+    fetchContributingText?: (owner: string, repo: string) => Promise<string | undefined>;
+    /** Forwarded to the CI triage engine. */
+    ciDeps?: CiTriageDeps;
+    /** Forwarded to the review triage engine. */
+    reviewDeps?: ReviewTriageDeps;
+}
+export interface PullDetailFull {
+    title: string;
+    author: string;
+    state: string;
+    merged: boolean;
+    draft: boolean;
+    url: string;
+    createdAt: string;
+    baseRef: string;
+    mergeable: boolean | null;
+    mergeableState: string;
+}
+export interface ReviewStateItem {
+    state: string;
+    author: string;
+    dismissed: boolean;
+}
+/**
+ * Parse a PR target: full /pull/ URL, or owner/repo#N shorthand.
+ * Throws a usage error otherwise.
+ */
+export declare function parseBriefTarget(target: string): {
+    owner: string;
+    repo: string;
+    number: number;
+};
+/** Area classification for a file path. Pure. */
+export declare function fileArea(path: string): BriefFileArea;
+/**
+ * The brief pipeline. Best-effort per source: a failed fetch degrades to
+ * an "unverified" note, never to silence or a fabricated verdict.
+ */
+export declare function briefPR(target: string, deps?: BriefDeps): Promise<BriefResult>;

package/dist/brief.js

@@ -0,0 +1,283 @@
+/**
+ * PR Brief: a verified review brief for ANY pull request.
+ *
+ * Generalizes the existing review/CI triage (built for our own PRs) into a
+ * one-screen brief any reviewer — or maintainer — can read before opening
+ * the diff. This is the overlap into review tooling (CodeRabbit/Greptile
+ * territory) done Greenlight's way: every claim carries quoted evidence
+ * or a link, classifications come from the existing deterministic triage
+ * engines, and anything unverified is marked as such. No generic praise,
+ * no invented findings.
+ *
+ * Sections:
+ *   1. What changed: files grouped by area/risk (source, tests, config,
+ *      docs, generated, other), plus size and shape.
+ *   2. CI: the existing ci_triage base-vs-head classification, reused.
+ *   3. Review findings: the existing review-triage classification, reused
+ *      (real vs false-positive vs already-addressed, each with evidence).
+ *   4. Test evidence present in the PR (new/changed test files), or
+ *      explicitly marked absent.
+ *   5. Merge-readiness blockers: conflicts, unresolved change requests,
+ *      missing changeset where the repo requires one.
+ *   6. A one-line "look at this first" for the reviewer.
+ *
+ * Budget: PR detail (1) + files (1-2) + reviews (1-2) + the triage
+ * engines' own fetches + house-rules (cached, 24h TTL) for the changeset
+ * signal. All reads ride the existing file cache.
+ */
+import { apiCallsUsed, apiGet, cacheGet, cacheSet, fetchContributing, parsePullUrl, } from "./github.js";
+import { triagePr } from "./ci-triage.js";
+import { triageReview } from "./review-triage.js";
+/**
+ * Parse a PR target: full /pull/ URL, or owner/repo#N shorthand.
+ * Throws a usage error otherwise.
+ */
+export function parseBriefTarget(target) {
+    const t = target.trim();
+    try {
+        return parsePullUrl(t);
+    }
+    catch {
+        const m = /^([^/]+)\/([^/#]+)#(\d+)$/.exec(t);
+        if (!m) {
+            throw new Error(`Not a PR target: ${target} (expected a pull-request URL or owner/repo#N)`);
+        }
+        return { owner: m[1], repo: m[2], number: Number(m[3]) };
+    }
+}
+/** Area classification for a file path. Pure. */
+export function fileArea(path) {
+    const p = path.toLowerCase();
+    if (/\/tests?\/|\/__tests__\/|\.test\.|\.spec\.|_test\.|-test\.|test_\b/.test(p) ||
+        p.startsWith("test/") ||
+        p.startsWith("tests/")) {
+        return "tests";
+    }
+    if (p.startsWith(".github/") ||
+        p.endsWith("package-lock.json") ||
+        p.endsWith("yarn.lock") ||
+        p.endsWith("pnpm-lock.yaml") ||
+        p.endsWith(".lock") ||
+        /(^|\/)dist\//.test(p) ||
+        p.endsWith(".min.js") ||
+        p.endsWith(".map") ||
+        /\/generated\//.test(p)) {
+        return "generated";
+    }
+    if (p.startsWith(".") ||
+        /(^|\/)(config|conf|settings?|scripts?|tools?|tooling|build|ci|infra|docker|k8s|kubernetes)\//.test(p) ||
+        /\.(ya?ml|toml|ini|cfg|env|example)$/.test(p) ||
+        p === "package.json" ||
+        p === "tsconfig.json" ||
+        p === "dockerfile") {
+        return "config";
+    }
+    if (p.endsWith(".md") || p.endsWith(".mdx") || p.startsWith("docs/") || p.startsWith("doc/")) {
+        return "docs";
+    }
+    if (/\.(ts|tsx|js|jsx|mjs|cjs|py|go|rs|rb|php|java|kt|swift|c|cpp|h|hpp|cs|vue|svelte)$/.test(p)) {
+        return "source";
+    }
+    return "other";
+}
+function toBriefFile(item) {
+    const filename = String(item.filename ?? "");
+    const rawStatus = String(item.status ?? "other").toLowerCase();
+    const status = rawStatus === "added" || rawStatus === "modified" || rawStatus === "removed" || rawStatus === "renamed"
+        ? rawStatus
+        : "other";
+    return {
+        filename,
+        status,
+        additions: typeof item.additions === "number" ? item.additions : 0,
+        deletions: typeof item.deletions === "number" ? item.deletions : 0,
+        area: fileArea(filename),
+    };
+}
+async function defaultFetchPullDetail(owner, repo, number) {
+    const key = [owner, repo, String(number), "brief-detail"];
+    const cached = cacheGet("issue", key);
+    if (cached)
+        return cached;
+    const p = (await apiGet(`/repos/${owner}/${repo}/pulls/${number}`));
+    const detail = {
+        title: String(p.title ?? ""),
+        author: String(p.user?.login ?? "unknown"),
+        state: String(p.state ?? "open"),
+        merged: p.merged_at != null,
+        draft: Boolean(p.draft),
+        url: String(p.html_url ?? `https://github.com/${owner}/${repo}/pull/${number}`),
+        createdAt: String(p.created_at ?? ""),
+        baseRef: String(p.base?.ref ?? ""),
+        mergeable: p.mergeable ?? null,
+        mergeableState: String(p.mergeable_state ?? "unknown"),
+    };
+    cacheSet("issue", key, detail);
+    return detail;
+}
+async function defaultFetchPullFiles(owner, repo, number) {
+    const key = [owner, repo, String(number), "brief-files"];
+    const cached = cacheGet("issue", key);
+    if (cached)
+        return cached;
+    const files = [];
+    for (let page = 1; page <= 5; page++) {
+        const data = (await apiGet(`/repos/${owner}/${repo}/pulls/${number}/files?per_page=100&page=${page}`));
+        for (const item of data ?? [])
+            files.push(toBriefFile(item));
+        if ((data ?? []).length < 100)
+            break;
+    }
+    cacheSet("issue", key, files);
+    return files;
+}
+async function defaultFetchReviews(owner, repo, number) {
+    const data = (await apiGet(`/repos/${owner}/${repo}/pulls/${number}/reviews?per_page=100`));
+    return (data ?? []).map((r) => ({
+        state: String(r.state ?? ""),
+        author: String(r.user?.login ?? "unknown"),
+        dismissed: String(r.state ?? "") === "DISMISSED",
+    }));
+}
+const ageDays = (iso) => {
+    const t = Date.parse(iso);
+    if (!Number.isFinite(t))
+        return 0;
+    return Math.floor((Date.now() - t) / (24 * 60 * 60 * 1000));
+};
+/**
+ * The brief pipeline. Best-effort per source: a failed fetch degrades to
+ * an "unverified" note, never to silence or a fabricated verdict.
+ */
+export async function briefPR(target, deps = {}) {
+    const callsBefore = apiCallsUsed();
+    const { owner, repo, number } = parseBriefTarget(target);
+    const prUrl = `https://github.com/${owner}/${repo}/pull/${number}`;
+    const unverified = [];
+    const blockers = [];
+    const fetchPullDetail = deps.fetchPullDetail ?? defaultFetchPullDetail;
+    const fetchPullFiles = deps.fetchPullFiles ?? defaultFetchPullFiles;
+    const fetchReviews = deps.fetchReviews ?? defaultFetchReviews;
+    let detail;
+    try {
+        detail = await fetchPullDetail(owner, repo, number);
+    }
+    catch (err) {
+        throw new Error(`could not fetch PR ${prUrl}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    let files;
+    try {
+        files = await fetchPullFiles(owner, repo, number);
+    }
+    catch {
+        files = [];
+        unverified.push("changed-file list unavailable; area breakdown is empty");
+    }
+    // Reviews for change-request blockers (independent of the triage engine).
+    let reviews = [];
+    try {
+        reviews = await fetchReviews(owner, repo, number);
+    }
+    catch {
+        unverified.push("review list unavailable; change-request blocker check skipped");
+    }
+    const openChangeRequests = reviews.filter((r) => r.state === "CHANGES_REQUESTED" && !r.dismissed && r.author !== detail.author);
+    for (const r of openChangeRequests) {
+        blockers.push(`unresolved change request from @${r.author}`);
+    }
+    // Merge conflicts.
+    if (detail.mergeable === false || detail.mergeableState === "dirty") {
+        blockers.push("merge conflicts (mergeable_state=dirty)");
+    }
+    else if (detail.mergeable === null && detail.mergeableState === "unknown") {
+        unverified.push("mergeable state not reported by GitHub yet");
+    }
+    // CI classification: reuse the existing triage engine (base vs head).
+    let ci;
+    try {
+        ci = await triagePr(prUrl, deps.ciDeps ?? {});
+    }
+    catch {
+        ci = {
+            pr: prUrl, title: detail.title, baseRef: detail.baseRef, baseSha: "",
+            headSha: "", verdict: "NO FAILURES", checks: [],
+        };
+        unverified.push("CI triage unavailable");
+    }
+    // Review findings: reuse the existing deterministic review triage.
+    let review;
+    try {
+        review = await triageReview(prUrl, deps.reviewDeps ?? {});
+    }
+    catch {
+        review = {
+            pr: prUrl, title: detail.title, verdict: "NO FINDINGS",
+            findings: [], counts: { likelyReal: 0, likelyNoise: 0, needsDecision: 0, noise: 0, resolved: 0 },
+        };
+        unverified.push("review triage unavailable");
+    }
+    // Changeset convention (remote variant of ci-prep's signal): repo
+    // mentions changesets in its policy files, but the PR ships no
+    // .changeset file -> blocker.
+    try {
+        const contributing = deps.fetchContributingText
+            ? await deps.fetchContributingText(owner, repo)
+            : await fetchContributing(owner, repo);
+        if (contributing && /changeset/i.test(contributing)) {
+            const hasChangeset = files.some((f) => /(^|\/)\.changeset\//.test(f.filename));
+            if (!hasChangeset)
+                blockers.push("repo requires changesets (CONTRIBUTING), none in this PR");
+        }
+    }
+    catch {
+        unverified.push("changeset convention check skipped (policy fetch failed)");
+    }
+    // Area breakdown.
+    const areaOrder = ["source", "tests", "config", "docs", "generated", "other"];
+    const areas = areaOrder
+        .map((area) => ({ area, files: files.filter((f) => f.area === area).map((f) => f.filename) }))
+        .filter((g) => g.files.length > 0);
+    const additions = files.reduce((s, f) => s + f.additions, 0);
+    const deletions = files.reduce((s, f) => s + f.deletions, 0);
+    // Test evidence: new or changed test-area files, stated plainly.
+    const testFiles = files.filter((f) => f.area === "tests").map((f) => f.filename);
+    const testEvidenceNote = testFiles.length > 0
+        ? `${testFiles.length} test file${testFiles.length === 1 ? "" : "s"} touched — verification is visible in the PR`
+        : "no test files touched — verification is not visible in this PR";
+    // Look-first: blockers first, then real findings, then CI, else shape.
+    const firstReal = review.findings?.find((f) => f.class === "likely-real");
+    const firstFailing = ci.checks?.find((c) => c.class === "likely-yours");
+    const biggestArea = areas.reduce((best, g) => (best === undefined || g.files.length > best.count ? { area: g.area, count: g.files.length } : best), undefined);
+    const lookFirst = blockers.length > 0
+        ? `Start here: ${blockers[0]}.`
+        : firstReal !== undefined
+            ? `Start here: ${firstReal.author}'s ${firstReal.class} finding${firstReal.path ? ` on ${firstReal.path}` : ""}: ${firstReal.summary}.`
+            : firstFailing !== undefined
+                ? `Start here: CI check "${firstFailing.name}" classified ${firstFailing.class}: ${firstFailing.evidence}.`
+                : biggestArea !== undefined
+                    ? `No blockers or real findings. Start here: ${biggestArea.count} ${biggestArea.area} file${biggestArea.count === 1 ? "" : "s"} carry the change.`
+                    : "No blockers, findings, or files visible. Nothing to review.";
+    return {
+        pr: prUrl,
+        number,
+        title: detail.title,
+        author: detail.author,
+        state: detail.merged ? "merged" : detail.state,
+        merged: detail.merged,
+        draft: detail.draft,
+        url: detail.url,
+        createdAt: detail.createdAt,
+        ageDays: ageDays(detail.createdAt),
+        baseRef: detail.baseRef,
+        size: { additions, deletions, filesChanged: files.length },
+        areas,
+        ci,
+        review,
+        testEvidence: { newOrChangedTestFiles: testFiles, note: testEvidenceNote },
+        blockers,
+        unverified,
+        lookFirst,
+        apiCalls: apiCallsUsed() - callsBefore,
+    };
+}
+//# sourceMappingURL=brief.js.map

package/dist/brief.js.map

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

package/dist/ci-prep.d.ts

@@ -0,0 +1,109 @@
+/**
+ * CI Pre-flight (`greenlight ci-prep` / MCP `ci_prep`).
+ *
+ * Answers one question with evidence, BEFORE a PR is pushed: would this
+ * repo's own pull_request workflows pass on the current tree?
+ *
+ * Pipeline:
+ *   1. DISCOVER: parse .github/workflows/*.yml for workflows triggered on
+ *      pull_request / pull_request_target; extract jobs and steps.
+ *   2. MAP + RUN (native mode): translate each step into a local check.
+ *      Steps that map to package scripts or common binaries (test, lint,
+ *      typecheck, build) are EXECUTED with a per-step timeout. Steps that
+ *      cannot run locally (deploys, secrets, external services, publishes)
+ *      are SKIPPED with the reason named. A check is never reported PASS
+ *      unless it actually ran.
+ *   3. CONVENTIONS: changeset requirement, conventional-commit subjects,
+ *      and DCO sign-off are checked against git history when the repo
+ *      signals that it requires them.
+ *   4. ACT MODE (--act): when `act` and a working docker daemon are both
+ *      present, the discovered PR workflows run through `act` for real;
+ *      otherwise the tool says so plainly and falls back to native mode.
+ *
+ * Honesty contract (same as verify.ts): this would rather say SKIPPED with
+ * a reason than report a verdict it cannot defend. Verdict is GO only
+ * when zero checks FAIL.
+ */
+export type CiPrepStatus = "PASS" | "FAIL" | "SKIPPED";
+export interface CiPrepCheck {
+    /** e.g. "test (workflow ci, job build)" or "convention: changesets". */
+    name: string;
+    kind: "workflow-step" | "convention" | "act";
+    status: CiPrepStatus;
+    /** One-line evidence: exit code, timing, or the skip reason. */
+    detail: string;
+    /** Last ~30 lines of captured output when the step was executed. */
+    outputTail?: string;
+}
+export interface CiPrepResult {
+    repoDir: string;
+    base: string | null;
+    verdict: "GO" | "NO-GO";
+    actMode: "used" | "unavailable" | "not-requested";
+    checks: CiPrepCheck[];
+    markdown: string;
+}
+export interface CiPrepOptions {
+    /** Base ref for convention checks (changesets/commits/DCO). */
+    base?: string;
+    /** Per-step execution timeout in seconds (default 300). */
+    timeoutSecs?: number;
+    /** Try act+docker; fall back to native mode when unavailable. */
+    useAct?: boolean;
+    /** Test seam: override the detected package manager. */
+    packageManager?: string;
+    /** Test seam: override act/docker detection. */
+    actAvailable?: boolean;
+}
+type YamlNode = string | number | boolean | null | YamlNode[] | {
+    [k: string]: YamlNode;
+};
+/** Parse a GitHub Actions workflow file into a plain object tree. Throws on structural problems. */
+export declare function parseWorkflowYaml(text: string): Record<string, YamlNode>;
+export interface WorkflowStep {
+    name: string;
+    uses?: string;
+    run?: string;
+    if?: string;
+    workingDirectory?: string;
+}
+export interface WorkflowJob {
+    id: string;
+    name: string;
+    steps: WorkflowStep[];
+    matrix?: string;
+}
+export interface DiscoveredWorkflow {
+    file: string;
+    jobs: WorkflowJob[];
+    /** Why this workflow was skipped entirely (unparseable, no PR trigger). */
+    skipReason?: string;
+}
+/** Does this workflow run on pull_request / pull_request_target? */
+export declare function triggersOnPullRequest(doc: Record<string, YamlNode>): boolean;
+export declare function discoverWorkflows(dir: string): DiscoveredWorkflow[];
+export type StepMapping = {
+    kind: "execute";
+    script: string;
+} | {
+    kind: "skip";
+    reason: string;
+};
+/**
+ * Decide what to do with a `run:` step. Conservative by design: anything
+ * that is not clearly a local test/lint/build invocation, or that touches
+ * secrets/publishes/deploys, becomes SKIPPED with a named reason.
+ */
+export declare function mapRunStep(script: string): StepMapping;
+export declare function mapUsesStep(uses: string): StepMapping;
+/** Push-only / main-only `if:` conditions make a step irrelevant to PRs. */
+export declare function isPushOnlyCondition(ifExpr: string): boolean;
+export declare function detectPackageManager(dir: string, override?: string): string | null;
+export declare function actAvailable(): boolean;
+export declare function runCiPrep(targetDir: string, opts?: CiPrepOptions): Promise<CiPrepResult>;
+export declare function renderCiPrepMarkdown(r: CiPrepResult): string;
+/** Human-readable console rendering (the --json flag prints the raw result). */
+export declare function formatCiPrepHuman(r: CiPrepResult): string;
+/** Ensure the tmp fixture helper can create scratch dirs outside the repo. */
+export declare function scratchDir(prefix: string): string;
+export {};