@reneturcios/greenlight 0.3.5 → 0.3.7

package/dist/prep-detail.d.ts

@@ -0,0 +1,125 @@
+import { type ServerSideDeps } from "./server-side.js";
+import type { Gate, RepoConventions } from "./types.js";
+/** One policy text: CONTRIBUTING variants, AGENTS.md, CLAUDE.md. */
+export interface PolicyText {
+    file: string;
+    text: string;
+}
+/**
+ * The exact signing path a repo demands. Named so the prep checklist can
+ * tell the contributor the real method with the real link or phrase:
+ * cla-assistant (standard phrase), a repo-specific CLA bot with its own
+ * signing page (the n8n pattern), or DCO instead of a CLA.
+ */
+export interface ClaPath {
+    kind: "cla-assistant" | "custom-cla-bot" | "dco" | "none";
+    /** One-line how-to for the checklist. */
+    method: string;
+    /** Signing page URL when one was found. */
+    link?: string;
+    /** Exact phrase to comment when the flow is comment-based. */
+    signaturePhrase?: string;
+    /** Policy files the call was drawn from. */
+    sources: string[];
+    /** Extra notes (e.g. "also requires DCO sign-off on every commit"). */
+    notes: string[];
+}
+export declare function detectClaPath(sources: PolicyText[], gates?: Gate[]): ClaPath;
+/** The release-note artifact a PR owes the repo. */
+export interface ChangesetConvention {
+    style: "changesets" | "changes-dir" | "towncrier" | "changelog-notes";
+    /** Path pattern, e.g. ".changeset/*.md". */
+    pattern: string;
+    /** Example filename built from the issue number. */
+    example: string;
+    /** What the file should contain. */
+    note: string;
+    /** Where it was detected: repo root listing or a policy file name. */
+    source: string;
+}
+/**
+ * Detect the release-note ritual: changesets (.changeset/), the reticle
+ * .changes/ pattern (one file per change, assembled into the changelog),
+ * towncrier fragments (towncrier.toml or [tool.towncrier] in pyproject),
+ * or a CONTRIBUTING instruction to update CHANGELOG by hand.
+ */
+export declare function detectChangesetConvention(args: {
+    rootNames: string[];
+    policyText: string;
+    policySource?: string;
+    pyprojectText?: string;
+    issueNumber: number;
+    slug: string;
+}): ChangesetConvention | undefined;
+/**
+ * Satellite-repo hint: the repo's own docs name a companion repo where the
+ * behavior actually lives (e.g. a label bot or CLI in a second repo).
+ * Only fires on tight textual evidence: a github.com/org/repo URL
+ * immediately preceded (within ~60 chars) by a relationship verb like
+ * "source lives at" or "enforced by", and which is not the repo being
+ * prepped. Never guesses.
+ */
+export declare function detectSatelliteRepo(owner: string, repo: string, policyText: string): {
+    candidate: string;
+    evidence: string;
+} | undefined;
+/** Warnings that the fix may not be buildable from this repo. */
+export interface FixLivesHereWarning {
+    /** "server-side" or "satellite". */
+    kind: string;
+    /** Prominent warning line for the prep checklist. */
+    line: string;
+}
+/**
+ * Combine the v0.3.4 server-side signal with the satellite hint into
+ * checklist warnings. Best-effort: code-search failures or empty policy
+ * text yield no warnings, never guesses.
+ */
+export declare function detectFixLivesHere(args: {
+    owner: string;
+    repo: string;
+    issueBody: string;
+    policyText: string;
+    deps?: ServerSideDeps;
+}): Promise<FixLivesHereWarning[]>;
+/**
+ * One-glance house rules at the top of the prep checklist: the required
+ * claim style, PR title conventions, draft-first norm, and the repo's test
+ * command. Every line names its source; absent rules are stated plainly
+ * instead of invented.
+ */
+export declare function buildHouseRulesSummary(args: {
+    gates: Gate[];
+    policyText: string;
+    policyFiles: string[];
+    conventions?: RepoConventions;
+}): string[];
+/** All four enhancements gathered for a prep run. */
+export interface PrepDetail {
+    claPath: ClaPath;
+    changeset?: ChangesetConvention;
+    fixLivesHereWarnings: FixLivesHereWarning[];
+    houseRulesSummary: string[];
+}
+export interface PrepDetailDeps extends ServerSideDeps {
+    /** Root names for the changeset/towncrier probes. */
+    rootNames?: () => Promise<string[]>;
+    /** pyproject.toml text for the towncrier probe, or undefined. */
+    pyprojectText?: () => Promise<string | undefined>;
+}
+/**
+ * Gather all four prep enhancements best-effort for a prep run. The
+ * snapshot's houseRules carry {file, text}; snapshot.contributing carries
+ * the joined text. Any failing probe degrades to "not detected".
+ */
+export declare function gatherPrepDetail(args: {
+    owner: string;
+    repo: string;
+    issueNumber: number;
+    slug: string;
+    policyTexts: PolicyText[];
+    contributing: string | undefined;
+    issueBody?: string;
+    conventions?: RepoConventions;
+    deps?: PrepDetailDeps;
+}): Promise<PrepDetail>;

package/dist/prep-detail.js

@@ -0,0 +1,316 @@
+/**
+ * Claim-to-PR prep hardening (v0.3.7).
+ *
+ * The `prep` command already learned fork/branch basics and the repo's
+ * ritual files. What it never answered: how do I actually sign what the
+ * repo demands, what release-note artifact do I owe, is the fix even in
+ * this repo, and what are the house rules in one glance.
+ *
+ * Every detector below is a pure function over injected text/data (offline
+ * tests), and prepIssue calls them best-effort against live probes. When
+ * evidence is thin the detectors say "not detected" instead of guessing.
+ */
+import { parseGatesFromSources } from "./gates.js";
+import { detectServerSideOnly } from "./server-side.js";
+function gateDetected(gates, kind) {
+    return gates.some((g) => g.kind === kind && g.detected);
+}
+function gateSource(gates, kind) {
+    return gates.find((g) => g.kind === kind && g.detected)?.source;
+}
+const CLA_SIGNATURE_PHRASE = "I have read the CLA Document and I hereby sign the CLA";
+/** Pull bare and markdown-link URLs out of a text. */
+function extractUrls(text) {
+    const out = [];
+    for (const m of text.matchAll(/https?:\/\/[^\s)"'>]+/g)) {
+        const url = m[0].replace(/[.,;:!?]+$/, "");
+        if (!out.includes(url))
+            out.push(url);
+    }
+    return out;
+}
+/**
+ * A repo-specific CLA bot leaves a signing-page URL in policy text:
+ * /webhook/cla paths, cla-bot subdomains/hostnames, or any URL in the
+ * same sentence as "CLA". Returns the first such URL found.
+ */
+function findCustomClaUrl(text) {
+    const urls = extractUrls(text);
+    // Strong patterns first: webhook/cla paths and cla bot hostnames.
+    const strong = urls.find((u) => /webhook\/cla|cla[-_]?bot/i.test(u));
+    if (strong)
+        return strong;
+    // Any URL in a line that mentions CLA signing.
+    for (const line of text.split("\n")) {
+        if (/cla/i.test(line) && /sign|accept|agree/i.test(line)) {
+            const m = line.match(/https?:\/\/[^\s)"'>]+/);
+            if (m)
+                return m[0].replace(/[.,;:!?]+$/, "");
+        }
+    }
+    return undefined;
+}
+export function detectClaPath(sources, gates) {
+    const resolvedGates = gates ?? parseGatesFromSources(sources);
+    const combined = sources.map((s) => s.text).join("\n");
+    const files = sources.map((s) => s.file);
+    const notes = [];
+    // (b) Repo-specific CLA bot with its own signing page, checked first
+    // because a cla_required gate is usually also detected underneath it.
+    const customUrl = findCustomClaUrl(combined);
+    const customUrlSource = customUrl
+        ? files.find((f, i) => sources[i].text.includes(customUrl))
+        : undefined;
+    if (customUrl) {
+        if (gateDetected(resolvedGates, "dco_required")) {
+            notes.push(`Also requires DCO sign-off on every commit (${gateSource(resolvedGates, "dco_required") ?? "house rules"}).`);
+        }
+        return {
+            kind: "custom-cla-bot",
+            method: `Sign this repo's own CLA at the signing page below (GitHub OAuth), then the CLA bot marks the PR.`,
+            link: customUrl,
+            sources: customUrlSource ? [customUrlSource] : files,
+            notes,
+        };
+    }
+    // (a) cla-assistant: explicit mention, or a bare cla_required gate.
+    const claAssistantMention = /cla[- ]?assistant(\.io)?/i.test(combined);
+    if (claAssistantMention || gateDetected(resolvedGates, "cla_required")) {
+        const explicit = claAssistantMention;
+        if (gateDetected(resolvedGates, "dco_required")) {
+            notes.push(`Also requires DCO sign-off on every commit (${gateSource(resolvedGates, "dco_required") ?? "house rules"}).`);
+        }
+        return {
+            kind: "cla-assistant",
+            method: explicit
+                ? "Sign via CLA Assistant: the CLA Assistant bot comments on the PR; reply with the signature phrase and it marks the check green."
+                : "A CLA is required (detected in house rules); the standard flow is CLA Assistant, which prompts on the PR.",
+            link: "https://cla-assistant.io",
+            signaturePhrase: CLA_SIGNATURE_PHRASE,
+            sources: files,
+            notes,
+        };
+    }
+    // (c) DCO instead of a CLA.
+    if (gateDetected(resolvedGates, "dco_required")) {
+        return {
+            kind: "dco",
+            method: "No CLA. Sign every commit with `git commit -s` (Signed-off-by trailer); the PR check verifies it.",
+            sources: gateSource(resolvedGates, "dco_required") ? [gateSource(resolvedGates, "dco_required")] : files,
+            notes,
+        };
+    }
+    // (d) Nothing detected.
+    return {
+        kind: "none",
+        method: "No CLA or DCO requirement detected in the repo's policy files.",
+        sources: files,
+        notes,
+    };
+}
+/**
+ * Detect the release-note ritual: changesets (.changeset/), the reticle
+ * .changes/ pattern (one file per change, assembled into the changelog),
+ * towncrier fragments (towncrier.toml or [tool.towncrier] in pyproject),
+ * or a CONTRIBUTING instruction to update CHANGELOG by hand.
+ */
+export function detectChangesetConvention(args) {
+    const { rootNames, policyText, policySource, pyprojectText, issueNumber, slug } = args;
+    const has = (n) => rootNames.some((r) => r.toLowerCase() === n);
+    if (has(".changeset")) {
+        return {
+            style: "changesets",
+            pattern: ".changeset/*.md",
+            example: `.changeset/${issueNumber}-${slug}.md`,
+            note: "changesets: one markdown file per change describing it for the changelog (frontmatter with semver bump, then prose).",
+            source: "repo root (.changeset/)",
+        };
+    }
+    if (has(".changes")) {
+        return {
+            style: "changes-dir",
+            pattern: ".changes/*.md",
+            example: `.changes/${issueNumber}-${slug}.md`,
+            note: "one file per issue in .changes/; the repo assembles its changelog from this directory, never edit CHANGELOG.md directly.",
+            source: "repo root (.changes/)",
+        };
+    }
+    const towncrierConfig = has("towncrier.toml") || /\[tool\.towncrier\]/i.test(pyprojectText ?? "");
+    if (towncrierConfig) {
+        // The fragment directory is project-specific; towncrier's own default
+        // is "newsfragments", overridden by the `directory` key. Without
+        // reading the config value, name the common candidates.
+        return {
+            style: "towncrier",
+            pattern: "<fragment-dir>/<issue>.<type>.md",
+            example: `newsfragments/${issueNumber}.bugfix.md`,
+            note: "towncrier: one news fragment named <issue-or-PR-number>.<type> (feature, bugfix, doc, removal, misc) in the fragment directory set by the `directory` key of [tool.towncrier]; common dirs: newsfragments/, changelog.d/, changes/.",
+            source: has("towncrier.toml") ? "towncrier.toml" : "pyproject.toml [tool.towncrier]",
+        };
+    }
+    if (/update (the )?changelog|changelog.{0,40}(entry|note|update)/i.test(policyText)) {
+        return {
+            style: "changelog-notes",
+            pattern: "CHANGELOG.md",
+            example: "an entry under the Unreleased section of CHANGELOG.md",
+            note: "add a changelog entry by hand; check the file's Unreleased section format first.",
+            source: policySource ?? "house rules",
+        };
+    }
+    return undefined;
+}
+/* ------------------------------------------------------------------ */
+/* 3. Fix-lives-here check                                             */
+/* ------------------------------------------------------------------ */
+/**
+ * Satellite-repo hint: the repo's own docs name a companion repo where the
+ * behavior actually lives (e.g. a label bot or CLI in a second repo).
+ * Only fires on tight textual evidence: a github.com/org/repo URL
+ * immediately preceded (within ~60 chars) by a relationship verb like
+ * "source lives at" or "enforced by", and which is not the repo being
+ * prepped. Never guesses.
+ */
+export function detectSatelliteRepo(owner, repo, policyText) {
+    const urlRe = /github\.com\/([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)/g;
+    const seen = new Set();
+    let m;
+    while ((m = urlRe.exec(policyText)) !== null) {
+        const candidate = `${m[1]}/${m[2]}`.replace(/[.]+$/, "");
+        if (candidate.toLowerCase() === `${owner}/${repo}`.toLowerCase() || seen.has(candidate))
+            continue;
+        seen.add(candidate);
+        // Code-location evidence in the ~60 chars before the URL: a phrase
+        // like "source lives at" or "enforced by our backend". Plain
+        // "documentation lives at" for a docs repo, or install
+        // instructions, deliberately do not count.
+        const before = policyText.slice(Math.max(0, m.index - 60), m.index).replace(/\s+/g, " ");
+        const codeLocated = /\b(source|code(base)?|implementation)\b.{0,40}\b(lives?|maintained|hosted|located|found)\b/i.test(before);
+        const enforcedBy = /\b(enforced|handled|maintained|implemented|hosted)\s+by\b/i.test(before);
+        if ((codeLocated || enforcedBy) && !/\b(install|download|uninstall)\b/i.test(before)) {
+            const evidence = policyText
+                .slice(Math.max(0, m.index - 160), Math.min(policyText.length, m.index + 40))
+                .replace(/\s+/g, " ");
+            return {
+                candidate,
+                evidence: `the behavior may live in ${candidate}: policy text names it near "...${evidence.trim()}..."`,
+            };
+        }
+    }
+    return undefined;
+}
+/**
+ * Combine the v0.3.4 server-side signal with the satellite hint into
+ * checklist warnings. Best-effort: code-search failures or empty policy
+ * text yield no warnings, never guesses.
+ */
+export async function detectFixLivesHere(args) {
+    const { owner, repo, issueBody, policyText, deps } = args;
+    const warnings = [];
+    const serverSide = await detectServerSideOnly(owner, repo, issueBody, deps ?? {});
+    if (serverSide) {
+        warnings.push({
+            kind: "server-side",
+            line: `WARNING: the fix may not be buildable from this repo. ${serverSide.evidence}. Check with the maintainers before building.`,
+        });
+    }
+    const satellite = detectSatelliteRepo(owner, repo, policyText);
+    if (satellite) {
+        warnings.push({
+            kind: "satellite",
+            line: `WARNING: ${satellite.evidence}.`,
+        });
+    }
+    return warnings;
+}
+/* ------------------------------------------------------------------ */
+/* 4. House-rules summary block                                        */
+/* ------------------------------------------------------------------ */
+/**
+ * One-glance house rules at the top of the prep checklist: the required
+ * claim style, PR title conventions, draft-first norm, and the repo's test
+ * command. Every line names its source; absent rules are stated plainly
+ * instead of invented.
+ */
+export function buildHouseRulesSummary(args) {
+    const { gates, policyText, policyFiles, conventions } = args;
+    const out = [];
+    const files = policyFiles.length > 0 ? ` (${policyFiles.join(", ")})` : "";
+    // Claim style.
+    if (gateDetected(gates, "assignment_required")) {
+        out.push(`Claim style: request assignment on the issue first (${gateSource(gates, "assignment_required") ?? "house rules"}).`);
+    }
+    else if (gateDetected(gates, "claim_first")) {
+        out.push(`Claim style: comment on the issue before starting (${gateSource(gates, "claim_first") ?? "house rules"}).`);
+    }
+    else {
+        out.push(`Claim style: none required${files}.`);
+    }
+    // PR title convention.
+    if (/conventional commits/i.test(policyText)) {
+        out.push(`PR titles: Conventional Commits${files}.`);
+    }
+    else if (/semantic (pr )?titles?/i.test(policyText)) {
+        out.push(`PR titles: semantic titles${files}.`);
+    }
+    // Draft-first norm.
+    if (/\bopen.{0,30}as (a )?draft/i.test(policyText) || /\bdraft.{0,30}(first|before)/i.test(policyText)) {
+        out.push(`Draft-first: open the PR as a draft${files}.`);
+    }
+    // Test command.
+    if (conventions) {
+        if (conventions.verifyCommands.length > 0) {
+            out.push(`Test command: \`${conventions.verifyCommands[0]}\`${files || " (house rules)"}.`);
+        }
+        else if (conventions.packageScripts.length > 0) {
+            out.push(`Before pushing: ${conventions.packageScripts.map((s) => `\`pnpm ${s}\``).join(", ")} (package.json).`);
+        }
+    }
+    return out;
+}
+/**
+ * Gather all four prep enhancements best-effort for a prep run. The
+ * snapshot's houseRules carry {file, text}; snapshot.contributing carries
+ * the joined text. Any failing probe degrades to "not detected".
+ */
+export async function gatherPrepDetail(args) {
+    const { owner, repo, issueNumber, slug, policyTexts, contributing, issueBody, conventions, deps } = args;
+    const policyText = [contributing ?? "", ...policyTexts.map((p) => p.text)].join("\n\n");
+    const policyFiles = policyTexts.map((p) => p.file).filter((f, i, a) => a.indexOf(f) === i);
+    const gates = parseGatesFromSources(policyTexts.length > 0 ? policyTexts : [{ file: "CONTRIBUTING.md", text: contributing ?? "" }]);
+    const claPath = detectClaPath(policyTexts.length > 0 ? policyTexts : [{ file: "CONTRIBUTING.md", text: contributing ?? "" }], gates);
+    let rootNames = [];
+    try {
+        if (deps?.rootNames)
+            rootNames = await deps.rootNames();
+    }
+    catch { /* root listing failed; skip */ }
+    let pyprojectText;
+    try {
+        if (deps?.pyprojectText)
+            pyprojectText = await deps.pyprojectText();
+    }
+    catch { /* no pyproject; skip */ }
+    const changeset = detectChangesetConvention({
+        rootNames,
+        policyText,
+        policySource: policyFiles[0],
+        pyprojectText,
+        issueNumber,
+        slug,
+    });
+    const fixLivesHereWarnings = await detectFixLivesHere({
+        owner,
+        repo,
+        issueBody: issueBody ?? "",
+        policyText,
+        deps,
+    });
+    const houseRulesSummary = buildHouseRulesSummary({
+        gates,
+        policyText,
+        policyFiles,
+        conventions,
+    });
+    return { claPath, changeset, fixLivesHereWarnings, houseRulesSummary };
+}
+//# sourceMappingURL=prep-detail.js.map

package/dist/prep-detail.js.map

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

package/dist/review-triage.d.ts

@@ -0,0 +1,129 @@
+export type ReviewFindingClass = "likely-real" | "likely-noise" | "needs-decision";
+export type ReviewTriageVerdict = "HAS LIKELY-REAL" | "NEEDS DECISIONS" | "ALL NOISE" | "NO FINDINGS";
+export type AuthorKind = "bot" | "human";
+export interface RawFinding {
+    /** Review-bot or human login, as GitHub reports it. */
+    author: string;
+    body: string;
+    /** File path the comment anchors to; absent for review-level comments. */
+    path?: string;
+    /** Right-side line the comment anchors to, when known. */
+    line?: number;
+    /** Diff hunk attached to the comment, when known. */
+    diffHunk?: string;
+    /** Parent review's state (APPROVED/CHANGES_REQUESTED/COMMENTED/DISMISSED). */
+    reviewState?: string;
+}
+export interface ClassifiedFinding {
+    author: string;
+    authorKind: AuthorKind;
+    path?: string;
+    line?: number;
+    summary: string;
+    class: ReviewFindingClass;
+    /** The deterministic signal that decided the class. */
+    reason: string;
+    /** A ready-to-adapt reply draft. Never posted by Greenlight. */
+    draft: string;
+}
+export interface ReviewCounts {
+    likelyReal: number;
+    likelyNoise: number;
+    needsDecision: number;
+    /** Skipped by rule: summaries, walkthroughs, praise. */
+    noise: number;
+    /** Skipped because the parent review was dismissed. */
+    resolved: number;
+}
+export interface ReviewTriageInput {
+    prUrl: string;
+    prTitle: string;
+    /** The PR author's login: their own comments are their replies, not incoming findings. */
+    prAuthor: string;
+    candidates: RawFinding[];
+}
+export interface ReviewTriageResult {
+    pr: string;
+    title: string;
+    findings: ClassifiedFinding[];
+    counts: ReviewCounts;
+    verdict: ReviewTriageVerdict;
+}
+export declare function authorKindOf(login: string): AuthorKind;
+export declare function isNoiseBody(body: string): boolean;
+/**
+ * Backticked and double-quoted code tokens in the finding body, in order.
+ * Used for anchor matching: the comment's claim against the hunk's code.
+ *
+ * Pairing note: the regex allows 1-char spans in *matching* so backtick
+ * pairing stays aligned (a skipped 1-char span would re-pair the
+ * surrounding backticks into phantom tokens like " uses "); tokens
+ * shorter than 2 chars are dropped after matching. Newlines are excluded
+ * so fenced code blocks are never swallowed into one token.
+ */
+export declare function quotedTokens(body: string): string[];
+/** First sentence, trimmed to a line. */
+export declare function oneLineSummary(body: string): string;
+/**
+ * Classify one actionable finding. Pure: all evidence comes from the
+ * candidate itself (author kind, body, anchor, hunk).
+ */
+export declare function classifyFinding(c: RawFinding): ClassifiedFinding;
+/** Roll up per-finding classes into the verdict line. */
+export declare function reviewVerdict(findings: ClassifiedFinding[]): ReviewTriageVerdict;
+/**
+ * The pure engine: split noise, the author's own comments, and resolved
+ * comments off, classify the rest, roll up. Noise bodies (summaries,
+ * walkthroughs, praise) and findings on dismissed reviews never become
+ * findings. The author's own comments count as noise: they are the
+ * author's replies, not incoming review feedback.
+ */
+export declare function classifyReviewTriage(input: ReviewTriageInput): ReviewTriageResult;
+interface ReviewApiItem {
+    id?: unknown;
+    user?: {
+        login?: unknown;
+    };
+    state?: unknown;
+    body?: unknown;
+    html_url?: unknown;
+    submitted_at?: unknown;
+}
+interface ReviewCommentApiItem {
+    id?: unknown;
+    user?: {
+        login?: unknown;
+    };
+    body?: unknown;
+    path?: unknown;
+    line?: unknown;
+    original_line?: unknown;
+    diff_hunk?: unknown;
+    pull_request_review_id?: unknown;
+    in_reply_to_id?: unknown;
+    html_url?: unknown;
+    created_at?: unknown;
+}
+interface IssueCommentApiItem {
+    id?: unknown;
+    user?: {
+        login?: unknown;
+    };
+    body?: unknown;
+    created_at?: unknown;
+}
+export interface ReviewTriageDeps {
+    fetchPull?: (owner: string, repo: string, number: number) => Promise<{
+        title: string;
+        author: string;
+    }>;
+    fetchReviews?: (owner: string, repo: string, number: number) => Promise<ReviewApiItem[]>;
+    fetchReviewComments?: (owner: string, repo: string, number: number) => Promise<ReviewCommentApiItem[]>;
+    fetchIssueComments?: (owner: string, repo: string, number: number) => Promise<IssueCommentApiItem[]>;
+}
+/**
+ * Full triage for a PR URL. Best-effort: a source that cannot be read
+ * degrades to "no findings from that source" rather than an error.
+ */
+export declare function triageReview(prUrl: string, deps?: ReviewTriageDeps): Promise<ReviewTriageResult>;
+export {};