@pretorian-worx/runclaudia-core 0.12.0

package/dist/adapters/specs.d.ts

@@ -0,0 +1,13 @@
+import type { SpecEntry } from "../types.js";
+export interface SpecDiscoveryOptions {
+    rootDir: string;
+    maxDepth?: number;
+}
+/**
+ * Walk known E2E test directories and parse each spec file. Returns the per-test
+ * coverage map plus a reverse index.
+ */
+export declare function discoverSpecs(opts: SpecDiscoveryOptions): {
+    specs: SpecEntry[];
+    fileToSpecs: Record<string, string[]>;
+};

package/dist/adapters/specs.js

@@ -0,0 +1,126 @@
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+// Conventional E2E/integration locations. We intentionally don't index unit
+// tests (e.g. *.test.ts next to source files) — they don't carry route or
+// endpoint coverage information that's useful here.
+const SPEC_DIRS = [
+    "e2e",
+    "tests/e2e",
+    "test/e2e",
+    "playwright",
+    "playwright/tests",
+    "cypress/e2e",
+    "cypress/integration",
+];
+const SPEC_FILE_RE = /\.(?:spec|test|cy)\.(?:[jt]sx?)$/i;
+const TEST_BLOCK_RE = /\b(?:test|it)(?:\.\w+)?\s*\(\s*['"`]([^'"`\n]+)['"`]/g;
+const PAGE_GOTO_RE = /\bpage\s*\.\s*goto\s*\(\s*['"`]([^'"`\n]+)['"`]/g;
+const PAGE_REQUEST_RE = /\bpage\s*\.\s*request\s*\.\s*(get|post|put|patch|delete|head|options)\s*\(\s*['"`]([^'"`\n]+)['"`]/gi;
+const CY_VISIT_RE = /\bcy\s*\.\s*visit\s*\(\s*['"`]([^'"`\n]+)['"`]/g;
+const CY_REQUEST_RE = /\bcy\s*\.\s*request\s*\(\s*['"`](GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)['"`]\s*,\s*['"`]([^'"`\n]+)['"`]/gi;
+const CY_REQUEST_OBJ_RE = /\bcy\s*\.\s*request\s*\(\s*\{\s*method\s*:\s*['"`](GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)['"`]\s*,\s*url\s*:\s*['"`]([^'"`\n]+)['"`]/gi;
+const FLOW_ANNOTATION_RE = /\/\/\s*@claudia\s+flow\s*:\s*([^\n]+)/gi;
+const SHARED_SETUP_RE = /\b(?:beforeAll|before)\s*\(/;
+/**
+ * Walk known E2E test directories and parse each spec file. Returns the per-test
+ * coverage map plus a reverse index.
+ */
+export function discoverSpecs(opts) {
+    const { rootDir } = opts;
+    const maxDepth = opts.maxDepth ?? 8;
+    const specs = [];
+    const fileToSpecs = {};
+    for (const candidate of SPEC_DIRS) {
+        const abs = join(rootDir, candidate);
+        if (!existsSync(abs))
+            continue;
+        if (!statSync(abs).isDirectory())
+            continue;
+        walkSpecDir(abs, rootDir, maxDepth, specs, fileToSpecs);
+    }
+    specs.sort((a, b) => (a.file === b.file ? a.name.localeCompare(b.name) : a.file.localeCompare(b.file)));
+    for (const k of Object.keys(fileToSpecs)) {
+        fileToSpecs[k] = Array.from(new Set(fileToSpecs[k])).sort();
+    }
+    return { specs, fileToSpecs };
+}
+function walkSpecDir(dir, rootDir, depthLeft, specs, fileToSpecs) {
+    if (depthLeft <= 0)
+        return;
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.name.startsWith("."))
+            continue;
+        if (entry.name === "node_modules")
+            continue;
+        const abs = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            walkSpecDir(abs, rootDir, depthLeft - 1, specs, fileToSpecs);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        if (!SPEC_FILE_RE.test(entry.name))
+            continue;
+        parseSpecFile(abs, rootDir, specs, fileToSpecs);
+    }
+}
+function parseSpecFile(abs, rootDir, specs, fileToSpecs) {
+    let src;
+    try {
+        src = readFileSync(abs, "utf8");
+    }
+    catch {
+        return;
+    }
+    const relFile = relative(rootDir, abs).split(sep).join("/");
+    const framework = inferFramework(src, relFile);
+    const hasSharedSetup = SHARED_SETUP_RE.test(src);
+    const routesCovered = uniqSorted(matchAll(PAGE_GOTO_RE, src, (m) => m[1]).concat(matchAll(CY_VISIT_RE, src, (m) => m[1])));
+    const endpointsCovered = uniqSorted(matchAll(PAGE_REQUEST_RE, src, (m) => `${m[1].toUpperCase()} ${m[2]}`)
+        .concat(matchAll(CY_REQUEST_RE, src, (m) => `${m[1].toUpperCase()} ${m[2]}`))
+        .concat(matchAll(CY_REQUEST_OBJ_RE, src, (m) => `${m[1].toUpperCase()} ${m[2]}`)));
+    const flowAnnotations = uniqSorted(matchAll(FLOW_ANNOTATION_RE, src, (m) => m[1].trim()));
+    const testNames = matchAll(TEST_BLOCK_RE, src, (m) => m[1]);
+    // Filter out files that look like specs by name but have no actual `test()` /
+    // `it()` blocks (e.g. helper modules in an e2e folder).
+    if (testNames.length === 0)
+        return;
+    for (const name of testNames) {
+        specs.push({
+            framework,
+            file: relFile,
+            name,
+            routesCovered,
+            endpointsCovered,
+            hasSharedSetup,
+            flowAnnotations,
+        });
+        (fileToSpecs[relFile] ??= []).push(name);
+    }
+}
+function inferFramework(src, file) {
+    if (file.includes("cypress/") || file.endsWith(".cy.ts") || file.endsWith(".cy.js"))
+        return "cypress";
+    if (/\bcy\s*\./.test(src) && !/from\s+['"]@playwright/.test(src))
+        return "cypress";
+    return "playwright";
+}
+function matchAll(re, src, take) {
+    const out = [];
+    re.lastIndex = 0;
+    let m;
+    while ((m = re.exec(src)))
+        out.push(take(m));
+    return out;
+}
+function uniqSorted(xs) {
+    return Array.from(new Set(xs)).sort();
+}
+//# sourceMappingURL=specs.js.map

package/dist/adapters/specs.js.map

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

package/dist/adapters/terraform.d.ts

@@ -0,0 +1,17 @@
+import type { InfraEntry } from "../types.js";
+export interface TerraformDiscoveryOptions {
+    rootDir: string;
+    /** Directories to ignore while walking. */
+    ignore?: string[];
+    /** Max recursion depth. */
+    maxDepth?: number;
+}
+/**
+ * Walk the project root looking for *.tf files and extract resource declarations.
+ * Regex-based — does not parse HCL fully. Handles 95% of vanilla resource blocks;
+ * misses dynamic blocks, for_each, count, modules, locals, etc.
+ */
+export declare function discoverTerraformResources(opts: TerraformDiscoveryOptions): {
+    infra: InfraEntry[];
+    fileToInfra: Record<string, string[]>;
+};

package/dist/adapters/terraform.js

@@ -0,0 +1,82 @@
+import { readdirSync, readFileSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+const DEFAULT_IGNORE = new Set([
+    "node_modules",
+    ".git",
+    ".next",
+    "dist",
+    "build",
+    ".terraform",
+    ".turbo",
+    "coverage",
+]);
+// `resource "aws_s3_bucket" "attachments" {`  (block opener; we don't parse the body).
+const RESOURCE_RE = /resource\s+"([^"]+)"\s+"([^"]+)"\s*\{/g;
+/**
+ * Walk the project root looking for *.tf files and extract resource declarations.
+ * Regex-based — does not parse HCL fully. Handles 95% of vanilla resource blocks;
+ * misses dynamic blocks, for_each, count, modules, locals, etc.
+ */
+export function discoverTerraformResources(opts) {
+    const rootDir = opts.rootDir;
+    const ignore = new Set([...DEFAULT_IGNORE, ...(opts.ignore ?? [])]);
+    const maxDepth = opts.maxDepth ?? 8;
+    const infra = [];
+    const fileToInfra = {};
+    walk(rootDir, rootDir, ignore, maxDepth, infra, fileToInfra);
+    // Stable order — easier to diff cached maps + nicer prompt output.
+    infra.sort((a, b) => a.address.localeCompare(b.address));
+    for (const k of Object.keys(fileToInfra)) {
+        fileToInfra[k] = Array.from(new Set(fileToInfra[k])).sort();
+    }
+    return { infra, fileToInfra };
+}
+function walk(dir, rootDir, ignore, depthLeft, infra, fileToInfra) {
+    if (depthLeft <= 0)
+        return;
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        // Skip dotfiles/dirs entirely. .terraform/.git/etc. are also in DEFAULT_IGNORE
+        // but this catches anything else (.idea, .vscode, etc.).
+        if (entry.name.startsWith("."))
+            continue;
+        const abs = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (ignore.has(entry.name))
+                continue;
+            walk(abs, rootDir, ignore, depthLeft - 1, infra, fileToInfra);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        if (!entry.name.endsWith(".tf"))
+            continue;
+        const relFile = toRel(rootDir, abs);
+        let src;
+        try {
+            src = readFileSync(abs, "utf8");
+        }
+        catch {
+            continue;
+        }
+        RESOURCE_RE.lastIndex = 0;
+        let m;
+        while ((m = RESOURCE_RE.exec(src))) {
+            const type = m[1];
+            const name = m[2];
+            const address = `${type}.${name}`;
+            infra.push({ tool: "terraform", type, name, address, file: relFile });
+            (fileToInfra[relFile] ??= []).push(address);
+        }
+    }
+}
+function toRel(rootDir, p) {
+    return relative(rootDir, p).split(sep).join("/");
+}
+//# sourceMappingURL=terraform.js.map

package/dist/adapters/terraform.js.map

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

package/dist/diff.d.ts

@@ -0,0 +1,13 @@
+import type { Diff } from "./types.js";
+export interface DiffOptions {
+    base: string;
+    head: string;
+    cwd?: string;
+}
+export declare function readDiff(opts: DiffOptions): Diff;
+interface SkipDecision {
+    skip: boolean;
+    reason?: string;
+}
+export declare function classifySkip(diff: Diff): SkipDecision;
+export {};

package/dist/diff.js

@@ -0,0 +1,187 @@
+import { execFileSync } from "node:child_process";
+export function readDiff(opts) {
+    const { base, head, cwd } = opts;
+    const range = `${base}..${head}`;
+    const numstat = run(["git", "diff", "--numstat", "-z", range], cwd);
+    const nameStatus = run(["git", "diff", "--name-status", "-z", range], cwd);
+    const patch = run(["git", "diff", "--unified=3", range], cwd);
+    const statusByPath = parseNameStatus(nameStatus);
+    const numByPath = parseNumstat(numstat);
+    const hunksByPath = parsePatch(patch);
+    const paths = new Set([
+        ...Object.keys(statusByPath),
+        ...Object.keys(numByPath),
+        ...Object.keys(hunksByPath),
+    ]);
+    const files = [];
+    for (const path of paths) {
+        const s = statusByPath[path];
+        const n = numByPath[path];
+        files.push({
+            path,
+            status: s?.status ?? "modified",
+            oldPath: s?.oldPath,
+            additions: n?.additions ?? 0,
+            deletions: n?.deletions ?? 0,
+            binary: n?.binary ?? false,
+            hunks: hunksByPath[path] ?? [],
+        });
+    }
+    files.sort((a, b) => a.path.localeCompare(b.path));
+    return { base, head, files };
+}
+const DOC_PATTERNS = [/\.md$/i, /\.mdx$/i, /^docs\//i, /^README/i, /^CHANGELOG/i, /^LICENSE/i];
+const LOCK_PATTERNS = [
+    /^pnpm-lock\.yaml$/,
+    /^package-lock\.json$/,
+    /^yarn\.lock$/,
+    /^bun\.lockb?$/,
+    /^Cargo\.lock$/,
+    /^poetry\.lock$/,
+    /^Pipfile\.lock$/,
+];
+const CI_PATTERNS = [/^\.github\//, /^\.circleci\//, /^\.gitlab-ci\.yml$/];
+const TEST_PATTERNS = [
+    /\.test\.[tj]sx?$/,
+    /\.spec\.[tj]sx?$/,
+    /(^|\/)__tests__\//,
+    /(^|\/)tests?\//,
+    /(^|\/)e2e\//,
+    /(^|\/)cypress\//,
+    /(^|\/)playwright\//,
+];
+const INFRA_PATTERNS = [
+    /\.tf$/,
+    /\.tfvars$/,
+    /(^|\/)terraform\//,
+    /(^|\/)infra\//,
+    /(^|\/)deploy\//,
+    /(^|\/)k8s\//,
+    /(^|\/)helm\//,
+    /^Dockerfile$/,
+    /^docker-compose\.ya?ml$/,
+];
+const ASSET_PATTERNS = [
+    /\.(png|jpe?g|gif|webp|avif|svg|ico)$/i,
+    /\.(woff2?|ttf|otf|eot)$/i,
+    /\.(mp4|webm|mov|m4v)$/i,
+    /^public\//,
+];
+const TRIVIAL_PATTERN_GROUPS = [
+    { name: "documentation", patterns: DOC_PATTERNS },
+    { name: "lockfile", patterns: LOCK_PATTERNS },
+    { name: "CI config", patterns: CI_PATTERNS },
+    { name: "test", patterns: TEST_PATTERNS },
+    { name: "infrastructure", patterns: INFRA_PATTERNS },
+    { name: "asset", patterns: ASSET_PATTERNS },
+];
+export function classifySkip(diff) {
+    if (diff.files.length === 0) {
+        return { skip: true, reason: "No file changes between base and head." };
+    }
+    // Single-category short-circuits give a clearer reason string.
+    for (const group of TRIVIAL_PATTERN_GROUPS) {
+        if (diff.files.every((f) => matches(f.path, group.patterns))) {
+            return { skip: true, reason: `Diff is ${group.name}-only.` };
+        }
+    }
+    // Mixed-trivial — still no runtime risk.
+    const allTrivial = diff.files.every((f) => TRIVIAL_PATTERN_GROUPS.some((g) => matches(f.path, g.patterns)));
+    if (allTrivial) {
+        return { skip: true, reason: "Diff contains only non-runtime changes (docs, lockfiles, CI, tests, infra, assets)." };
+    }
+    return { skip: false };
+}
+function matches(path, patterns) {
+    return patterns.some((p) => p.test(path));
+}
+function run(args, cwd) {
+    return execFileSync(args[0], args.slice(1), {
+        cwd,
+        encoding: "utf8",
+        maxBuffer: 64 * 1024 * 1024,
+    });
+}
+function parseNameStatus(out) {
+    const result = {};
+    const tokens = out.split("\0").filter(Boolean);
+    let i = 0;
+    while (i < tokens.length) {
+        const code = tokens[i];
+        i++;
+        const letter = code[0];
+        if (letter === "R" || letter === "C") {
+            const oldPath = tokens[i];
+            const newPath = tokens[i + 1];
+            i += 2;
+            result[newPath] = { status: "renamed", oldPath };
+        }
+        else {
+            const path = tokens[i];
+            i++;
+            const status = letter === "A" ? "added" : letter === "D" ? "deleted" : "modified";
+            result[path] = { status };
+        }
+    }
+    return result;
+}
+function parseNumstat(out) {
+    const result = {};
+    const tokens = out.split("\0").filter(Boolean);
+    let i = 0;
+    while (i < tokens.length) {
+        const line = tokens[i];
+        i++;
+        const parts = line.split("\t");
+        if (parts.length < 3)
+            continue;
+        const [a, d, maybePath] = parts;
+        let path;
+        if (maybePath === "") {
+            const oldPath = tokens[i];
+            const newPath = tokens[i + 1];
+            i += 2;
+            path = newPath;
+            void oldPath;
+        }
+        else {
+            path = maybePath;
+        }
+        const binary = a === "-" || d === "-";
+        result[path] = {
+            additions: binary ? 0 : parseInt(a, 10) || 0,
+            deletions: binary ? 0 : parseInt(d, 10) || 0,
+            binary,
+        };
+    }
+    return result;
+}
+function parsePatch(out) {
+    const result = {};
+    const lines = out.split("\n");
+    let currentPath = null;
+    let currentHunk = null;
+    const flush = () => {
+        if (currentPath && currentHunk && currentHunk.length > 0) {
+            (result[currentPath] ??= []).push(currentHunk.join("\n"));
+        }
+        currentHunk = null;
+    };
+    for (const line of lines) {
+        if (line.startsWith("diff --git ")) {
+            flush();
+            const m = /diff --git a\/(.+?) b\/(.+)$/.exec(line);
+            currentPath = m ? m[2] : null;
+        }
+        else if (line.startsWith("@@")) {
+            flush();
+            currentHunk = [line];
+        }
+        else if (currentHunk) {
+            currentHunk.push(line);
+        }
+    }
+    flush();
+    return result;
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

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

package/dist/gating.d.ts

@@ -0,0 +1,29 @@
+import type { Plan, PlanFlow } from "./types.js";
+export type GatingMode = "shadow" | "advisory" | "gating";
+export type RiskLevel = PlanFlow["risk"];
+export interface GatingDecision {
+    /** Whether to post a check at all (false in shadow mode). */
+    postCheck: boolean;
+    /** Final conclusion of the check, when posted. */
+    conclusion: "success" | "failure" | "neutral";
+    /** Short summary line that goes into the check's title field. */
+    title: string;
+    /** Flows that triggered a failure, for human-facing detail. */
+    failingFlows: PlanFlow[];
+}
+export interface GatingOptions {
+    mode: GatingMode;
+    /** Minimum risk level that causes a `gating`-mode failure. Default `high`. */
+    blockingRisk?: RiskLevel;
+}
+/**
+ * Pure decision function — takes the plan and the user's gating config and
+ * tells the action what check (if any) to post.
+ *
+ * Rules:
+ *   shadow   → never post a check
+ *   advisory → post a neutral check unconditionally
+ *   gating   → post a check; fails if any flow has risk >= blockingRisk;
+ *              skip-verdict plans always pass (nothing to verify)
+ */
+export declare function decideGating(plan: Plan, opts: GatingOptions): GatingDecision;

package/dist/gating.js

@@ -0,0 +1,59 @@
+const RISK_ORDER = { low: 0, medium: 1, high: 2 };
+/**
+ * Pure decision function — takes the plan and the user's gating config and
+ * tells the action what check (if any) to post.
+ *
+ * Rules:
+ *   shadow   → never post a check
+ *   advisory → post a neutral check unconditionally
+ *   gating   → post a check; fails if any flow has risk >= blockingRisk;
+ *              skip-verdict plans always pass (nothing to verify)
+ */
+export function decideGating(plan, opts) {
+    if (opts.mode === "shadow") {
+        return { postCheck: false, conclusion: "success", title: "", failingFlows: [] };
+    }
+    if (opts.mode === "advisory") {
+        return {
+            postCheck: true,
+            conclusion: "neutral",
+            title: summarizeForCheck(plan, "advisory"),
+            failingFlows: [],
+        };
+    }
+    // mode === "gating"
+    const threshold = opts.blockingRisk ?? "high";
+    const thresholdLevel = RISK_ORDER[threshold];
+    if (plan.verdict === "skip") {
+        return {
+            postCheck: true,
+            conclusion: "success",
+            title: `claudia: skipped (${plan.skipReason ?? "no testable changes"})`,
+            failingFlows: [],
+        };
+    }
+    const failing = plan.flows.filter((f) => RISK_ORDER[f.risk] >= thresholdLevel);
+    if (failing.length === 0) {
+        return {
+            postCheck: true,
+            conclusion: "success",
+            title: summarizeForCheck(plan, "gating-pass"),
+            failingFlows: [],
+        };
+    }
+    return {
+        postCheck: true,
+        conclusion: "failure",
+        title: `${failing.length} flow${failing.length === 1 ? "" : "s"} at or above risk threshold "${threshold}"`,
+        failingFlows: failing,
+    };
+}
+function summarizeForCheck(plan, kind) {
+    if (plan.verdict === "skip")
+        return `claudia: skipped (${plan.skipReason ?? "no testable changes"})`;
+    const flows = plan.flows.length;
+    if (kind === "gating-pass")
+        return `claudia: ${flows} flow${flows === 1 ? "" : "s"} to verify — no blocking risk`;
+    return `claudia: ${flows} flow${flows === 1 ? "" : "s"} to verify`;
+}
+//# sourceMappingURL=gating.js.map

package/dist/gating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gating.js","sourceRoot":"","sources":["../src/gating.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,GAA8B,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAmB7E;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,IAAU,EAAE,IAAmB;IAC1D,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAClF,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC7B,OAAO;YACL,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,SAAS;YACrB,KAAK,EAAE,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC;YAC1C,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;IAED,oBAAoB;IACpB,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC;IAC9C,MAAM,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IAE7C,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO;YACL,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,SAAS;YACrB,KAAK,EAAE,qBAAqB,IAAI,CAAC,UAAU,IAAI,qBAAqB,GAAG;YACvE,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,CAAC;IAC/E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,SAAS;YACrB,KAAK,EAAE,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC;YAC7C,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,SAAS;QACrB,KAAK,EAAE,GAAG,OAAO,CAAC,MAAM,QAAQ,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,gCAAgC,SAAS,GAAG;QAC3G,YAAY,EAAE,OAAO;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAU,EAAE,IAAgC;IACrE,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM;QAAE,OAAO,qBAAqB,IAAI,CAAC,UAAU,IAAI,qBAAqB,GAAG,CAAC;IACrG,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAChC,IAAI,IAAI,KAAK,aAAa;QAAE,OAAO,YAAY,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,+BAA+B,CAAC;IAClH,OAAO,YAAY,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC;AACrE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export * from "./types.js";
+export { readDiff, classifySkip } from "./diff.js";
+export { buildNextMap } from "./adapters/nextjs.js";
+export { loadOrBuildMap, readMap, writeMap } from "./map.js";
+export { buildUserMessage, SYSTEM_PROMPT } from "./prompt.js";
+export { callPlanner, PlannerError } from "./llm.js";
+export { runPlan } from "./plan.js";
+export type { PlanRunOptions, PlanRunResult } from "./plan.js";
+export { formatPlanMarkdown, formatPlanJson } from "./plan-format.js";
+export { decideGating } from "./gating.js";
+export type { GatingDecision, GatingMode, GatingOptions, RiskLevel } from "./gating.js";
+export { runSelect, formatSelectionMarkdown } from "./select.js";
+export type { SelectOptions, SelectionResult, SelectedSpec } from "./select.js";
+export { buildPlaywrightCommand, parsePlaywrightReport, formatRunMarkdown } from "./runner.js";
+export type { RunCommandOptions, PlaywrightCommand, PlaywrightReport, FailedTest, } from "./runner.js";

package/dist/index.js

@@ -0,0 +1,12 @@
+export * from "./types.js";
+export { readDiff, classifySkip } from "./diff.js";
+export { buildNextMap } from "./adapters/nextjs.js";
+export { loadOrBuildMap, readMap, writeMap } from "./map.js";
+export { buildUserMessage, SYSTEM_PROMPT } from "./prompt.js";
+export { callPlanner, PlannerError } from "./llm.js";
+export { runPlan } from "./plan.js";
+export { formatPlanMarkdown, formatPlanJson } from "./plan-format.js";
+export { decideGating } from "./gating.js";
+export { runSelect, formatSelectionMarkdown } from "./select.js";
+export { buildPlaywrightCommand, parsePlaywrightReport, formatRunMarkdown } from "./runner.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/llm.d.ts

@@ -0,0 +1,24 @@
+import { type Plan } from "./types.js";
+export declare class PlannerError extends Error {
+    readonly details: Record<string, unknown>;
+    constructor(message: string, details: Record<string, unknown>);
+}
+export interface LlmCallOptions {
+    apiKey?: string;
+    model?: string;
+    systemPrompt?: string;
+    mapBlock: string;
+    diffBlock: string;
+    maxTokens?: number;
+}
+export interface LlmResult {
+    plan: Plan;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheCreationTokens: number;
+        cacheReadTokens: number;
+    };
+    model: string;
+}
+export declare function callPlanner(opts: LlmCallOptions): Promise<LlmResult>;