@reneturcios/greenlight 0.4.0 → 0.5.0

package/dist/init.js

@@ -0,0 +1,298 @@
+/**
+ * `greenlight init`: one-command agent setup.
+ *
+ * Before this, onboarding an agent meant cloning the repo and hand-copying
+ * MCP configs plus instruction snippets from integrations/ per tool. Init
+ * does that from the installed package: it copies (or JSON-merges) the MCP
+ * server config into the current project and installs the tool's instruction
+ * snippet, then prints the restart + verify steps.
+ *
+ * Safety rules: existing configs are merged (other servers are preserved),
+ * instruction appends are marker-guarded and idempotent, nothing is
+ * overwritten unless --force is given, and --dry-run only reports.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+export const INIT_TOOLS = [
+    {
+        id: "claude-code",
+        label: "Claude Code",
+        configSrc: "claude-code/.mcp.json",
+        configDest: ".mcp.json",
+        serverMapKey: "mcpServers",
+        instructionsSrc: "claude-code/CLAUDE.snippet.md",
+        instructionsDest: "CLAUDE.md",
+        instructionsMode: "append-markers",
+        detectMarkers: [".mcp.json", "CLAUDE.md"],
+        restartNote: "Restart Claude Code, then ask it to list its MCP tools.",
+    },
+    {
+        id: "cursor",
+        label: "Cursor",
+        configSrc: "cursor/.cursor/mcp.json",
+        configDest: ".cursor/mcp.json",
+        serverMapKey: "mcpServers",
+        instructionsSrc: "cursor/greenlight.mdc",
+        instructionsDest: ".cursor/rules/greenlight.mdc",
+        instructionsMode: "copy",
+        detectMarkers: [".cursor"],
+        restartNote: "Restart Cursor, then ask the agent to list its MCP tools.",
+    },
+    {
+        id: "copilot",
+        label: "VS Code / Copilot",
+        configSrc: "copilot/.vscode/mcp.json",
+        configDest: ".vscode/mcp.json",
+        serverMapKey: "servers",
+        instructionsSrc: "copilot/copilot-instructions.snippet.md",
+        instructionsDest: ".github/copilot-instructions.md",
+        instructionsMode: "append-markers",
+        detectMarkers: [".vscode", ".github/copilot-instructions.md"],
+        restartNote: "Reload VS Code, then check the MCP server list.",
+    },
+    {
+        id: "windsurf",
+        label: "Windsurf",
+        configSrc: "windsurf/mcp_config.json",
+        configDest: ".codeium/windsurf/mcp_config.json",
+        homeDest: true,
+        serverMapKey: "mcpServers",
+        detectMarkers: [],
+        restartNote: "Restart Windsurf, then open Manage MCP Servers to confirm greenlight is listed.",
+    },
+    {
+        id: "cline",
+        label: "Cline",
+        configSrc: "cline/cline_mcp_settings.json",
+        configDest: ".cline/mcp_settings.json",
+        serverMapKey: "mcpServers",
+        detectMarkers: [".cline"],
+        restartNote: "Restart your editor, then check Cline's MCP Servers list.",
+    },
+    {
+        id: "generic",
+        label: "Any other MCP client",
+        configSrc: "mcp.json",
+        configDest: "greenlight.mcp.json",
+        serverMapKey: null,
+        detectMarkers: [],
+        restartNote: "Point your MCP client at greenlight.mcp.json (command npx, args -y @reneturcios/greenlight mcp).",
+    },
+];
+/** Markers guarding an appended instruction block; presence means "already installed". */
+export const INIT_BEGIN_MARKER = "<!-- greenlight:init:begin -->";
+export const INIT_END_MARKER = "<!-- greenlight:init:end -->";
+/** The integrations pack ships inside the npm package next to dist/. */
+export function defaultPackDir() {
+    return fileURLToPath(new URL("../integrations/", import.meta.url));
+}
+export function findTool(id) {
+    return INIT_TOOLS.find((t) => t.id === id.toLowerCase());
+}
+/** Split --agent values on commas, lowercase, dedupe, drop empties. */
+export function parseAgentList(values) {
+    const out = [];
+    for (const v of values) {
+        for (const part of v.split(",")) {
+            const id = part.trim().toLowerCase();
+            if (id && !out.includes(id))
+                out.push(id);
+        }
+    }
+    return out;
+}
+/** Tool ids whose marker files exist in the project (a hint, never auto-applied). */
+export function detectTools(projectDir) {
+    return INIT_TOOLS.filter((t) => t.detectMarkers.length > 0 && t.detectMarkers.some((m) => existsSync(join(projectDir, m)))).map((t) => t.id);
+}
+function sameJson(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+function writeFileEnsured(path, content, dryRun) {
+    if (dryRun)
+        return;
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, content, "utf8");
+}
+/**
+ * Install one tool's MCP config. Existing JSON configs are merged (the
+ * greenlight server is added, everything else preserved). Returns the file
+ * result; throws only when the destination is unparseable and --force was
+ * not given, since silently dropping a broken config would hide user data.
+ */
+function installConfig(tool, destPath, packContent, force, dryRun) {
+    if (tool.serverMapKey === null) {
+        if (!existsSync(destPath)) {
+            writeFileEnsured(destPath, packContent, dryRun);
+            return { path: destPath, action: "created", detail: "config copied" };
+        }
+        const existing = readFileSync(destPath, "utf8");
+        if (existing === packContent) {
+            return { path: destPath, action: "skipped", detail: "already set up" };
+        }
+        if (!force) {
+            return {
+                path: destPath,
+                action: "skipped",
+                detail: "exists with different content; re-run with --force to overwrite",
+            };
+        }
+        writeFileEnsured(destPath, packContent, dryRun);
+        return { path: destPath, action: "overwritten", detail: "overwritten with --force" };
+    }
+    const packDoc = JSON.parse(packContent);
+    const packEntry = packDoc[tool.serverMapKey]?.greenlight;
+    if (!existsSync(destPath)) {
+        writeFileEnsured(destPath, packContent.endsWith("\n") ? packContent : packContent + "\n", dryRun);
+        return { path: destPath, action: "created", detail: "config copied" };
+    }
+    let destDoc;
+    try {
+        destDoc = JSON.parse(readFileSync(destPath, "utf8"));
+    }
+    catch {
+        if (!force) {
+            throw new Error(`${destPath} exists but is not valid JSON; fix it or re-run with --force to overwrite it`);
+        }
+        writeFileEnsured(destPath, packContent.endsWith("\n") ? packContent : packContent + "\n", dryRun);
+        return { path: destPath, action: "overwritten", detail: "invalid JSON overwritten with --force" };
+    }
+    if (typeof destDoc !== "object" || destDoc === null || Array.isArray(destDoc)) {
+        if (!force) {
+            throw new Error(`${destPath} exists but is not a JSON object; fix it or re-run with --force to overwrite it`);
+        }
+        writeFileEnsured(destPath, packContent.endsWith("\n") ? packContent : packContent + "\n", dryRun);
+        return { path: destPath, action: "overwritten", detail: "non-object JSON overwritten with --force" };
+    }
+    if (typeof destDoc[tool.serverMapKey] !== "object" || destDoc[tool.serverMapKey] === null) {
+        destDoc[tool.serverMapKey] = {};
+    }
+    const map = destDoc[tool.serverMapKey];
+    if ("greenlight" in map && sameJson(map.greenlight, packEntry)) {
+        return { path: destPath, action: "skipped", detail: "greenlight server already configured" };
+    }
+    const hadEntry = "greenlight" in map;
+    map.greenlight = packEntry;
+    writeFileEnsured(destPath, JSON.stringify(destDoc, null, 2) + "\n", dryRun);
+    return {
+        path: destPath,
+        action: hadEntry ? "updated" : "merged",
+        detail: hadEntry ? "greenlight server entry refreshed, other servers kept" : "greenlight server added, other servers kept",
+    };
+}
+/** Install one tool's instruction snippet (append-with-markers or whole copy). */
+function installInstructions(tool, destPath, snippet, force, dryRun) {
+    if (tool.instructionsMode === "copy") {
+        if (!existsSync(destPath)) {
+            writeFileEnsured(destPath, snippet, dryRun);
+            return { path: destPath, action: "created", detail: "rule file copied" };
+        }
+        if (readFileSync(destPath, "utf8") === snippet) {
+            return { path: destPath, action: "skipped", detail: "already set up" };
+        }
+        if (!force) {
+            return {
+                path: destPath,
+                action: "skipped",
+                detail: "exists with different content; re-run with --force to overwrite",
+            };
+        }
+        writeFileEnsured(destPath, snippet, dryRun);
+        return { path: destPath, action: "overwritten", detail: "overwritten with --force" };
+    }
+    // append-markers: idempotent by marker presence; never touches user text.
+    if (existsSync(destPath) && readFileSync(destPath, "utf8").includes(INIT_BEGIN_MARKER)) {
+        return { path: destPath, action: "skipped", detail: "instructions already installed" };
+    }
+    const block = `${INIT_BEGIN_MARKER}\n${snippet.trim()}\n${INIT_END_MARKER}\n`;
+    if (!existsSync(destPath)) {
+        writeFileEnsured(destPath, block, dryRun);
+        return { path: destPath, action: "created", detail: "instructions installed" };
+    }
+    const existing = readFileSync(destPath, "utf8");
+    const joined = existing + (existing.endsWith("\n") ? "\n" : "\n\n") + block;
+    writeFileEnsured(destPath, joined, dryRun);
+    return { path: destPath, action: "updated", detail: "instructions appended, existing content kept" };
+}
+/**
+ * Set up the given tools. Throws on unknown tool ids or a missing pack so
+ * the CLI can show the tool list instead of half-writing.
+ */
+export function initTools(toolIds, opts = {}) {
+    const projectDir = opts.projectDir ?? process.cwd();
+    const homeDir = opts.homeDir ?? homedir();
+    const packDir = opts.packDir ?? defaultPackDir();
+    const force = opts.force ?? false;
+    const includeInstructions = opts.includeInstructions ?? true;
+    const dryRun = opts.dryRun ?? false;
+    const tools = toolIds.map((id) => {
+        const tool = findTool(id);
+        if (!tool) {
+            throw new Error(`Unknown agent "${id}". Run 'greenlight init --list' to see the supported tools.`);
+        }
+        return tool;
+    });
+    // Read every pack file up front so a missing pack fails before writing.
+    const packFiles = new Map();
+    const readPack = (rel) => {
+        const cached = packFiles.get(rel);
+        if (cached !== undefined)
+            return cached;
+        const abs = join(packDir, rel);
+        if (!existsSync(abs)) {
+            throw new Error(`Pack file missing: ${rel} (looked in ${packDir})`);
+        }
+        const content = readFileSync(abs, "utf8");
+        packFiles.set(rel, content);
+        return content;
+    };
+    for (const tool of tools) {
+        readPack(tool.configSrc);
+        if (includeInstructions && tool.instructionsSrc)
+            readPack(tool.instructionsSrc);
+    }
+    return tools.map((tool) => {
+        const notes = [];
+        const files = [];
+        const base = tool.homeDest ? homeDir : projectDir;
+        const configDest = join(base, tool.configDest);
+        files.push(installConfig(tool, configDest, readPack(tool.configSrc), force, dryRun));
+        if (includeInstructions && tool.instructionsSrc && tool.instructionsDest) {
+            const snippetDest = join(projectDir, tool.instructionsDest);
+            files.push(installInstructions(tool, snippetDest, readPack(tool.instructionsSrc), force, dryRun));
+        }
+        else if (tool.instructionsSrc && !includeInstructions) {
+            notes.push("instructions skipped (--no-instructions)");
+        }
+        notes.push(tool.restartNote);
+        return { id: tool.id, label: tool.label, files, notes };
+    });
+}
+/** Human-readable report of an init run (file actions plus next steps). */
+export function formatInitHuman(results, dryRun) {
+    const verb = {
+        created: "create",
+        merged: "merge into",
+        updated: "update",
+        overwritten: "overwrite",
+        skipped: "skip",
+    };
+    const lines = [];
+    if (dryRun)
+        lines.push("Dry run: nothing was written. Re-run without --dry-run to apply.");
+    for (const r of results) {
+        lines.push(`${r.label}:`);
+        for (const f of r.files) {
+            const action = dryRun ? `would ${verb[f.action]}` : f.action;
+            lines.push(`  ${action}: ${f.path} (${f.detail})`);
+        }
+        for (const n of r.notes)
+            lines.push(`  next: ${n}`);
+    }
+    lines.push("Verify: ask your agent to list its MCP tools; greenlight should appear with 12 tools.");
+    lines.push("Tip: set GITHUB_TOKEN (classic PAT, no scopes needed for public repos) for the 5000 req/hr limit.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/verify-comment.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Verified-comment mode.
+ *
+ * Some repos take no outside PRs at all. The proven examples are
+ * modelcontextprotocol/inspector ("Pull requests against this repo are
+ * opened by the repo maintainers only") and modelcontextprotocol/servers
+ * ("We accept issues, not pull requests"): outside PRs are closed on
+ * sight, and the contribution that lands is a detailed, verified issue
+ * comment instead — a reproduced problem, a located root cause, a
+ * fix sketch, and honest notes on what was actually run.
+ *
+ * This module assembles that comment from contributor-supplied inputs.
+ * It never posts anything (there is no post path), and it never invents
+ * facts: any section the contributor did not fill renders as an explicit
+ * gap marker ("not yet run", "not yet isolated", "not recorded") so a
+ * maintainer can see exactly what is verified and what is not. A
+ * plausible-looking filled-in section would be a lie; a labeled gap is
+ * the product.
+ */
+import type { Gate } from "./types.js";
+export interface VerifiedCommentFields {
+    /** One-line claim of the problem (usually the issue title restated). */
+    claim: string;
+    /** Environment: repo, ref/commit, date, platform. */
+    environment: string;
+    /** Reproduction steps, in order, exact commands. */
+    reproduction: string[];
+    /** What was observed when the repro ran. */
+    observed: string;
+    /** What should have happened instead. */
+    expected: string;
+    /** Root cause: file paths and line refs when known. */
+    rootCause: string;
+    /** Proposed fix sketch, not a code dump. */
+    fixSketch: string;
+    /** What was actually run (commands, counts). */
+    ran: string;
+    /** Who ran it. */
+    verifiedBy: string;
+}
+export type VerifiedCommentInput = Partial<VerifiedCommentFields>;
+export interface BuiltComment {
+    markdown: string;
+    /** Names of sections that rendered as gap markers. */
+    gaps: string[];
+}
+/**
+ * Assemble the verified comment. Everything comes from the contributor's
+ * inputs (or the --from-file parse); nothing is fetched and nothing is
+ * invented. The greenlight version in the footer is a real fact about the
+ * tool that assembled the comment, not a fact about the bug.
+ */
+export declare function buildVerifiedComment(issueUrl: string, fields: VerifiedCommentInput, greenlightVersion: string): BuiltComment;
+/**
+ * True when the repo class is maintainer-only PRs: outside PRs are
+ * refused on sight, so the useful contribution is a verified comment.
+ * That is Greenlight's `collaborators_only` gate (inspector and servers
+ * both land there: their policy text is matched by the gate parser).
+ */
+export declare function suggestsVerifiedComment(gates: Gate[]): boolean;
+/** The suggestion line check_issue prints for maintainer-only repos. */
+export declare function verifiedCommentSuggestion(issueUrl: string): string;
+export interface ParsedNoteFile {
+    fields: VerifiedCommentInput;
+    /** Sections that did not map to a known field, kept verbatim. */
+    additionalNotes: string;
+}
+/**
+ * Parse a markdown notes file into comment fields. Lines under a heading
+ * map to that section; unmapped headings are preserved under
+ * "Additional notes" instead of being dropped, so contributor content is
+ * never silently lost. Unheaded text at the top of the file becomes the
+ * claim.
+ */
+export declare function parseNoteFile(text: string): ParsedNoteFile;

package/dist/verify-comment.js

@@ -0,0 +1,149 @@
+const GAP = (label) => `*${label}: not recorded*`;
+function section(title, body, gaps, gapName) {
+    if (body.trim().length === 0)
+        gaps.push(gapName);
+    return `## ${title}\n\n${body.trim().length > 0 ? body.trim() : GAP("not yet filled in")}\n`;
+}
+/**
+ * Assemble the verified comment. Everything comes from the contributor's
+ * inputs (or the --from-file parse); nothing is fetched and nothing is
+ * invented. The greenlight version in the footer is a real fact about the
+ * tool that assembled the comment, not a fact about the bug.
+ */
+export function buildVerifiedComment(issueUrl, fields, greenlightVersion) {
+    const gaps = [];
+    const f = (k) => fields[k] instanceof Array
+        ? fields[k].join("\n")
+        : (fields[k] ?? "").trim();
+    const parts = [];
+    parts.push(`<!-- greenlight-verified-comment v1 -->`);
+    parts.push(`# Verified finding for ${issueUrl}`);
+    parts.push(``);
+    parts.push(section("Claim of the problem", f("claim"), gaps, "claim"));
+    parts.push(section("Environment", f("environment"), gaps, "environment"));
+    const repro = fields.reproduction ?? [];
+    const reproBody = repro.length > 0
+        ? repro.map((s, i) => `${i + 1}. ${s.trim()}`).join("\n")
+        : `*Repro: not yet run*`;
+    if (repro.length === 0)
+        gaps.push("reproduction");
+    parts.push(`## Reproduction\n\n${reproBody}\n`);
+    parts.push(section("Observed vs expected", [f("observed"), f("expected")].some((s) => s.length > 0)
+        ? `**Observed:** ${f("observed") || "*not recorded*"}\n\n**Expected:** ${f("expected") || "*not recorded*"}`
+        : "", gaps, "observed/expected"));
+    parts.push(section("Root cause", f("rootCause"), gaps, "root-cause").replace("not yet filled in", "not yet isolated"));
+    parts.push(section("Proposed fix", f("fixSketch"), gaps, "fix-sketch").replace("not yet filled in", "not sketched yet"));
+    const ran = f("ran");
+    if (ran.length === 0)
+        gaps.push("verification");
+    const by = f("verifiedBy");
+    parts.push(`## Verification\n\n` +
+        `What was actually run: ${ran.length > 0 ? ran : "*not yet run*"}\n\n` +
+        `Verified by: ${by.length > 0 ? by : "*contributor not stated*"}\n\n` +
+        `---\n` +
+        `*Comment drafted with Greenlight v${greenlightVersion} (verified-comment mode). ` +
+        `Assembled locally from the contributor's notes; nothing here was posted automatically.*\n`);
+    return { markdown: parts.join("\n"), gaps };
+}
+/**
+ * True when the repo class is maintainer-only PRs: outside PRs are
+ * refused on sight, so the useful contribution is a verified comment.
+ * That is Greenlight's `collaborators_only` gate (inspector and servers
+ * both land there: their policy text is matched by the gate parser).
+ */
+export function suggestsVerifiedComment(gates) {
+    return gates.some((g) => g.detected && g.kind === "collaborators_only");
+}
+/** The suggestion line check_issue prints for maintainer-only repos. */
+export function verifiedCommentSuggestion(issueUrl) {
+    return `This repo takes verified comments instead of PRs: draft one with greenlight verify-comment ${issueUrl}`;
+}
+// ---------------------------------------------------------------------------
+// --from-file parsing: headings map onto sections, everything else is kept.
+// ---------------------------------------------------------------------------
+const HEADING_MAP = [
+    { match: /^(claim|problem|summary|title)$/i, field: "claim" },
+    { match: /^(environment|env|setup|context)$/i, field: "environment" },
+    { match: /^(repro|reproduction|reproduction steps|steps|how to reproduce)$/i, field: "reproduction" },
+    { match: /^(observed)$/i, field: "observed" },
+    { match: /^(expected)$/i, field: "expected" },
+    { match: /^(observed vs expected|observed\/expected|behavior)$/i, field: "observed" },
+    { match: /^(root cause|cause|analysis)$/i, field: "rootCause" },
+    { match: /^(fix|proposed fix|fix sketch|proposal|solution)$/i, field: "fixSketch" },
+    { match: /^(ran|verification|what was run|testing|test results)$/i, field: "ran" },
+    { match: /^(by|verified by|author|contributor)$/i, field: "verifiedBy" },
+];
+/**
+ * Parse a markdown notes file into comment fields. Lines under a heading
+ * map to that section; unmapped headings are preserved under
+ * "Additional notes" instead of being dropped, so contributor content is
+ * never silently lost. Unheaded text at the top of the file becomes the
+ * claim.
+ */
+export function parseNoteFile(text) {
+    const fields = {};
+    const extras = [];
+    const lines = text.split("\n");
+    let current = {
+        field: null,
+        extraTitle: null,
+    };
+    const buffers = new Map();
+    const push = (key, line) => {
+        const b = buffers.get(key) ?? [];
+        b.push(line);
+        buffers.set(key, b);
+    };
+    const flushExtra = () => {
+        if (current.extraTitle) {
+            const b = buffers.get(`extra:${current.extraTitle}`) ?? [];
+            if (b.join("\n").trim().length > 0) {
+                extras.push(`### ${current.extraTitle}\n\n${b.join("\n").trim()}`);
+            }
+            current.extraTitle = null;
+        }
+    };
+    for (const line of lines) {
+        const m = /^(#{1,3})\s+(.+?)\s*$/.exec(line);
+        if (m) {
+            flushExtra();
+            const title = m[2].trim();
+            const hit = HEADING_MAP.find((h) => h.match.test(title));
+            current = hit
+                ? { field: hit.field, extraTitle: null }
+                : { field: null, extraTitle: title };
+            if (!hit)
+                buffers.set(`extra:${title}`, []);
+            continue;
+        }
+        if (current.field) {
+            push(current.field, line);
+        }
+        else if (current.extraTitle) {
+            push(`extra:${current.extraTitle}`, line);
+        }
+        else {
+            // Unheaded leading text: treat as the claim of the problem.
+            push("claim", line);
+        }
+    }
+    flushExtra();
+    for (const [k, b] of buffers) {
+        if (k.startsWith("extra:"))
+            continue;
+        const value = b.join("\n").trim();
+        if (value.length === 0)
+            continue;
+        if (k === "reproduction") {
+            fields.reproduction = value
+                .split("\n")
+                .map((s) => s.replace(/^\s*(?:\d+[.)]|[-*])\s+/, "").trim())
+                .filter((s) => s.length > 0);
+        }
+        else {
+            fields[k] = value;
+        }
+    }
+    return { fields, additionalNotes: extras.join("\n\n") };
+}
+//# sourceMappingURL=verify-comment.js.map

package/dist/verify-comment.js.map

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

package/dist/verify-parsers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Test-output parsers for `greenlight verify`.
+ *
+ * The delta (base vs head) is only honest if it is derived from parsed
+ * test identities, never from raw log lines. Each parser turns one
+ * runner's output into the same shape: named passing tests and named
+ * failing tests. Runners slot in by implementing TestRunnerParser; the
+ * pipeline picks the first parser whose canParse matches the test
+ * command.
+ */
+export interface ParsedTests {
+    passed: string[];
+    failed: string[];
+}
+export interface TestRunnerParser {
+    /** Human name, e.g. "node:test". */
+    name: string;
+    /** True when this parser claims the given test command. */
+    canParse(command: string): boolean;
+    /** Parse one full run's stdout+stderr. */
+    parse(output: string): ParsedTests;
+}
+export declare const RUNNER_PARSERS: TestRunnerParser[];
+/** Pick the parser for a test command, or null when none claims it. */
+export declare function parserForCommand(command: string): TestRunnerParser | null;

package/dist/verify-parsers.js

@@ -0,0 +1,56 @@
+function dedupe(xs) {
+    return [...new Set(xs)];
+}
+const nodeTest = {
+    name: "node:test",
+    canParse: (cmd) => /(^|\s)(node\s+--test|tsx?\s+--test)/.test(cmd) || /\bvitest\b/.test(cmd),
+    parse(output) {
+        const passed = [];
+        const failed = [];
+        for (const line of output.split("\n")) {
+            // node --test: "✔ name (1.23ms)" / "✖ name (1.23ms)"; leading spaces ok.
+            // The summary headers "✖ failing tests:" / "✔ passing tests:" are not
+            // tests (the live greenlight-verify run on 2026-10-16 caught "failing
+            // tests:" being counted as a failure).
+            const ok = /^\s*✔\s+(.+?)(?:\s+\(\d[\d.,]*m?s\))?\s*$/.exec(line);
+            if (ok && !/^(passing|failing) tests:?$/i.test(ok[1].trim())) {
+                passed.push(ok[1].trim());
+                continue;
+            }
+            const bad = /^\s*✖\s+(.+?)(?:\s+\(\d[\d.,]*m?s\))?\s*$/.exec(line);
+            if (bad && !/^(passing|failing) tests:?$/i.test(bad[1].trim())) {
+                failed.push(bad[1].trim());
+                continue;
+            }
+            // vitest run: "✓ src/foo.test.ts (3 tests)" is file-level; real
+            // per-test lines come from node --test above. Skip to avoid mixing
+            // granularities.
+        }
+        return { passed: dedupe(passed), failed: dedupe(failed) };
+    },
+};
+const pytest = {
+    name: "pytest",
+    canParse: (cmd) => /(^|\s)pytest(\s|$)/.test(cmd),
+    parse(output) {
+        const passed = [];
+        const failed = [];
+        for (const line of output.split("\n")) {
+            // -v output: "tests/x.py::TestY::test_z PASSED" / FAILED / ERROR
+            const m = /^(\S+::\S+)\s+(PASSED|FAILED|ERROR)\b/.exec(line.trim());
+            if (!m)
+                continue;
+            if (m[2] === "PASSED")
+                passed.push(m[1]);
+            else
+                failed.push(m[1]);
+        }
+        return { passed: dedupe(passed), failed: dedupe(failed) };
+    },
+};
+export const RUNNER_PARSERS = [nodeTest, pytest];
+/** Pick the parser for a test command, or null when none claims it. */
+export function parserForCommand(command) {
+    return RUNNER_PARSERS.find((p) => p.canParse(command)) ?? null;
+}
+//# sourceMappingURL=verify-parsers.js.map

package/dist/verify-parsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-parsers.js","sourceRoot":"","sources":["../src/verify-parsers.ts"],"names":[],"mappings":"AAwBA,SAAS,MAAM,CAAC,EAAY;IAC1B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,QAAQ,GAAqB;IACjC,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,qCAAqC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC;IAC5F,KAAK,CAAC,MAAM;QACV,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,yEAAyE;YACzE,sEAAsE;YACtE,sEAAsE;YACtE,uCAAuC;YACvC,MAAM,EAAE,GAAG,2CAA2C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClE,IAAI,EAAE,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC7D,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC1B,SAAS;YACX,CAAC;YACD,MAAM,GAAG,GAAG,2CAA2C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnE,IAAI,GAAG,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC/D,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC3B,SAAS;YACX,CAAC;YACD,gEAAgE;YAChE,mEAAmE;YACnE,iBAAiB;QACnB,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IAC5D,CAAC;CACF,CAAC;AAEF,MAAM,MAAM,GAAqB;IAC/B,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC;IACjD,KAAK,CAAC,MAAM;QACV,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,iEAAiE;YACjE,MAAM,CAAC,GAAG,uCAAuC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACpE,IAAI,CAAC,CAAC;gBAAE,SAAS;YACjB,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ;gBAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;;gBACpC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IAC5D,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAuB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAErE,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,IAAI,CAAC;AACjE,CAAC"}