@pretorian-worx/runclaudia-core 0.12.0

package/dist/llm.js

@@ -0,0 +1,135 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { PlanSchema } from "./types.js";
+import { SYSTEM_PROMPT } from "./prompt.js";
+const WRAPPER_KEYS = ["plan", "result", "output", "data", "emit_plan"];
+function unwrapCandidates(input) {
+    const out = [input];
+    if (input && typeof input === "object" && !Array.isArray(input)) {
+        const obj = input;
+        const keys = Object.keys(obj);
+        if (keys.length === 1) {
+            const only = obj[keys[0]];
+            if (only && typeof only === "object")
+                out.push(only);
+        }
+        for (const k of WRAPPER_KEYS) {
+            if (k in obj && obj[k] && typeof obj[k] === "object")
+                out.push(obj[k]);
+        }
+    }
+    return out;
+}
+export class PlannerError extends Error {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.name = "PlannerError";
+        this.details = details;
+    }
+}
+const PLAN_TOOL = {
+    name: "emit_plan",
+    description: "Emit the structured test plan. Always call this exactly once. The tool input MUST be a flat object with the fields verdict, summary, flows, unmappedFiles, coverageGaps at the top level — DO NOT nest them under a 'plan' or other wrapper key.",
+    input_schema: {
+        type: "object",
+        required: ["verdict", "summary", "flows", "unmappedFiles", "coverageGaps"],
+        properties: {
+            verdict: { type: "string", enum: ["test", "skip"] },
+            skipReason: { type: "string" },
+            summary: { type: "string" },
+            flows: {
+                type: "array",
+                items: {
+                    type: "object",
+                    required: ["name", "routes", "risk", "reasoning", "suggestedChecks"],
+                    properties: {
+                        name: { type: "string" },
+                        routes: { type: "array", items: { type: "string" } },
+                        risk: { type: "string", enum: ["low", "medium", "high"] },
+                        reasoning: { type: "string" },
+                        suggestedChecks: { type: "array", items: { type: "string" } },
+                    },
+                },
+            },
+            unmappedFiles: { type: "array", items: { type: "string" } },
+            coverageGaps: { type: "array", items: { type: "string" } },
+        },
+    },
+};
+export async function callPlanner(opts) {
+    const apiKey = opts.apiKey ?? process.env.ANTHROPIC_API_KEY;
+    if (!apiKey)
+        throw new Error("ANTHROPIC_API_KEY is not set");
+    const client = new Anthropic({ apiKey });
+    const model = opts.model ?? "claude-sonnet-4-6";
+    const response = await client.messages.create({
+        model,
+        max_tokens: opts.maxTokens ?? 4096,
+        system: [
+            {
+                type: "text",
+                text: opts.systemPrompt ?? SYSTEM_PROMPT,
+                cache_control: { type: "ephemeral" },
+            },
+        ],
+        tools: [PLAN_TOOL],
+        tool_choice: { type: "tool", name: "emit_plan" },
+        messages: [
+            {
+                role: "user",
+                content: [
+                    {
+                        type: "text",
+                        text: opts.mapBlock,
+                        cache_control: { type: "ephemeral" },
+                    },
+                    { type: "text", text: opts.diffBlock },
+                ],
+            },
+        ],
+    });
+    const toolUses = response.content.filter((b) => b.type === "tool_use" && b.name === "emit_plan");
+    if (toolUses.length === 0) {
+        const textPreview = response.content
+            .filter((b) => b.type === "text")
+            .map((b) => b.text)
+            .join("\n")
+            .slice(0, 2000);
+        throw new PlannerError("Model did not call emit_plan tool", {
+            stopReason: response.stop_reason,
+            contentTypes: response.content.map((b) => b.type),
+            textPreview,
+        });
+    }
+    const last = toolUses[toolUses.length - 1];
+    const candidates = unwrapCandidates(last.input);
+    let plan;
+    let lastIssues;
+    for (const c of candidates) {
+        const parsed = PlanSchema.safeParse(c);
+        if (parsed.success) {
+            plan = parsed.data;
+            break;
+        }
+        lastIssues = parsed.error.issues;
+    }
+    if (!plan) {
+        throw new PlannerError("emit_plan tool input did not match schema", {
+            stopReason: response.stop_reason,
+            rawInput: last.input,
+            zodIssues: lastIssues,
+        });
+    }
+    const usage = response.usage;
+    return {
+        plan,
+        model,
+        usage: {
+            inputTokens: usage.input_tokens,
+            outputTokens: usage.output_tokens,
+            cacheCreationTokens: usage.cache_creation_input_tokens ?? 0,
+            cacheReadTokens: usage.cache_read_input_tokens ?? 0,
+        },
+    };
+}
+//# sourceMappingURL=llm.js.map

package/dist/llm.js.map

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

package/dist/map.d.ts

@@ -0,0 +1,9 @@
+import type { AppMap } from "./types.js";
+export interface MapOptions {
+    rootDir: string;
+    cachePath?: string;
+    refresh?: boolean;
+}
+export declare function loadOrBuildMap(opts: MapOptions): AppMap;
+export declare function readMap(path: string): AppMap | null;
+export declare function writeMap(path: string, map: AppMap): void;

package/dist/map.js

@@ -0,0 +1,55 @@
+import { mkdirSync, readFileSync, writeFileSync, existsSync, statSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { buildNextMap } from "./adapters/nextjs.js";
+export function loadOrBuildMap(opts) {
+    const rootDir = resolve(opts.rootDir);
+    const cachePath = opts.cachePath ?? join(rootDir, ".claudia", "map.json");
+    if (!opts.refresh && existsSync(cachePath)) {
+        const cached = readMap(cachePath);
+        // Force a rebuild if the cache predates the latest map schema (endpoints,
+        // fileToEndpoints, infra, fileToInfra).
+        const hasNewerFields = cached &&
+            Array.isArray(cached.endpoints) &&
+            Array.isArray(cached.infra) &&
+            Array.isArray(cached.dbModels) &&
+            Array.isArray(cached.specs) &&
+            cached.fileToEndpoints !== undefined &&
+            cached.fileToInfra !== undefined &&
+            cached.fileToTables !== undefined &&
+            cached.fileToSpecs !== undefined;
+        if (hasNewerFields && cached && isFresh(cached, rootDir))
+            return cached;
+    }
+    const map = buildNextMap({ rootDir });
+    writeMap(cachePath, map);
+    return map;
+}
+export function readMap(path) {
+    try {
+        const raw = readFileSync(path, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export function writeMap(path, map) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(map, null, 2) + "\n", "utf8");
+}
+function isFresh(map, rootDir) {
+    const generatedAt = Date.parse(map.generatedAt);
+    if (Number.isNaN(generatedAt))
+        return false;
+    const tracked = new Set(Object.keys(map.fileToRoutes));
+    for (const file of tracked) {
+        const abs = join(rootDir, file);
+        if (!existsSync(abs))
+            return false;
+        const mtime = statSync(abs).mtimeMs;
+        if (mtime > generatedAt)
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=map.js.map

package/dist/map.js.map

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

package/dist/plan-format.d.ts

@@ -0,0 +1,3 @@
+import type { PlanRunResult } from "./plan.js";
+export declare function formatPlanMarkdown(result: PlanRunResult): string;
+export declare function formatPlanJson(result: PlanRunResult): string;

package/dist/plan-format.js

@@ -0,0 +1,71 @@
+// Renderers live here, alongside the plan logic, so consumers (CLI,
+// GitHub Action) can import them from @pretorian-worx/runclaudia-core without reaching into
+// the CLI package's internals.
+const RISK_BADGE = {
+    high: "🔴 high",
+    medium: "🟡 medium",
+    low: "🟢 low",
+};
+export function formatPlanMarkdown(result) {
+    const { plan, diff, usage, model, skipped } = result;
+    const lines = [];
+    lines.push("## claudia — test plan");
+    lines.push("");
+    lines.push(`Diff: \`${diff.base}..${diff.head}\` — ${diff.files.length} file${diff.files.length === 1 ? "" : "s"} changed.`);
+    lines.push("");
+    if (skipped || plan.verdict === "skip") {
+        lines.push(`**Skipped.** ${plan.skipReason ?? plan.summary}`);
+        return lines.join("\n");
+    }
+    lines.push(plan.summary);
+    lines.push("");
+    if (plan.flows.length === 0) {
+        lines.push("_No user-facing flows inferred._");
+    }
+    else {
+        lines.push("### Flows to verify");
+        for (const f of plan.flows) {
+            lines.push("");
+            lines.push(`**${f.name}** — ${RISK_BADGE[f.risk]}  ·  ${f.routes.length > 0 ? f.routes.map((r) => `\`${r}\``).join(", ") : "_no route_"}`);
+            lines.push("");
+            lines.push(f.reasoning);
+            if (f.suggestedChecks.length > 0) {
+                lines.push("");
+                for (const c of f.suggestedChecks)
+                    lines.push(`- [ ] ${c}`);
+            }
+        }
+    }
+    if (plan.unmappedFiles.length > 0) {
+        lines.push("");
+        lines.push("### Unmapped files");
+        for (const f of plan.unmappedFiles)
+            lines.push(`- \`${f}\``);
+    }
+    if (plan.coverageGaps.length > 0) {
+        lines.push("");
+        lines.push("### Coverage gaps");
+        for (const g of plan.coverageGaps)
+            lines.push(`- ${g}`);
+    }
+    if (usage && model) {
+        lines.push("");
+        lines.push(`<sub>${model} · in ${usage.inputTokens} (cache write ${usage.cacheCreationTokens} / cache read ${usage.cacheReadTokens}) · out ${usage.outputTokens}</sub>`);
+    }
+    lines.push("");
+    lines.push("---");
+    lines.push("");
+    lines.push("<sub>Was this plan useful? React with 👍 or 👎 on this comment. Other reactions are ignored. Run `claudia ratings` to aggregate over time.</sub>");
+    return lines.join("\n");
+}
+export function formatPlanJson(result) {
+    return JSON.stringify({
+        diff: { base: result.diff.base, head: result.diff.head, files: result.diff.files.map((f) => f.path) },
+        plan: result.plan,
+        skipped: result.skipped,
+        skipReason: result.skipReason,
+        usage: result.usage,
+        model: result.model,
+    }, null, 2);
+}
+//# sourceMappingURL=plan-format.js.map

package/dist/plan-format.js.map

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

package/dist/plan.d.ts

@@ -0,0 +1,21 @@
+import { type LlmResult } from "./llm.js";
+import type { AppMap, Diff, Plan } from "./types.js";
+export interface PlanRunOptions {
+    rootDir: string;
+    base: string;
+    head: string;
+    targetUrl?: string;
+    refreshMap?: boolean;
+    apiKey?: string;
+    model?: string;
+}
+export interface PlanRunResult {
+    diff: Diff;
+    map: AppMap;
+    plan: Plan;
+    skipped: boolean;
+    skipReason?: string;
+    usage?: LlmResult["usage"];
+    model?: string;
+}
+export declare function runPlan(opts: PlanRunOptions): Promise<PlanRunResult>;

package/dist/plan.js

@@ -0,0 +1,44 @@
+import { classifySkip, readDiff } from "./diff.js";
+import { loadOrBuildMap } from "./map.js";
+import { buildUserMessage } from "./prompt.js";
+import { callPlanner } from "./llm.js";
+export async function runPlan(opts) {
+    const diff = readDiff({ base: opts.base, head: opts.head, cwd: opts.rootDir });
+    const map = loadOrBuildMap({ rootDir: opts.rootDir, refresh: opts.refreshMap });
+    const skip = classifySkip(diff);
+    if (skip.skip) {
+        return {
+            diff,
+            map,
+            plan: {
+                verdict: "skip",
+                skipReason: skip.reason,
+                summary: skip.reason ?? "No testable changes.",
+                flows: [],
+                unmappedFiles: [],
+                coverageGaps: [],
+            },
+            skipped: true,
+            skipReason: skip.reason,
+        };
+    }
+    const userMessage = buildUserMessage({ diff, map, targetUrl: opts.targetUrl });
+    const splitIdx = userMessage.indexOf("\n# Diff ");
+    const mapBlock = splitIdx >= 0 ? userMessage.slice(0, splitIdx) : userMessage;
+    const diffBlock = splitIdx >= 0 ? userMessage.slice(splitIdx + 1) : "";
+    const result = await callPlanner({
+        apiKey: opts.apiKey,
+        model: opts.model,
+        mapBlock,
+        diffBlock,
+    });
+    return {
+        diff,
+        map,
+        plan: result.plan,
+        skipped: false,
+        usage: result.usage,
+        model: result.model,
+    };
+}
+//# sourceMappingURL=plan.js.map

package/dist/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAkB,MAAM,UAAU,CAAC;AAuBvD,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAoB;IAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/E,MAAM,GAAG,GAAG,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAEhF,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO;YACL,IAAI;YACJ,GAAG;YACH,IAAI,EAAE;gBACJ,OAAO,EAAE,MAAM;gBACf,UAAU,EAAE,IAAI,CAAC,MAAM;gBACvB,OAAO,EAAE,IAAI,CAAC,MAAM,IAAI,sBAAsB;gBAC9C,KAAK,EAAE,EAAE;gBACT,aAAa,EAAE,EAAE;gBACjB,YAAY,EAAE,EAAE;aACjB;YACD,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,IAAI,CAAC,MAAM;SACxB,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,gBAAgB,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAE/E,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;IAC9E,MAAM,SAAS,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;QAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ;QACR,SAAS;KACV,CAAC,CAAC;IAEH,OAAO;QACL,IAAI;QACJ,GAAG;QACH,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;AACJ,CAAC"}

package/dist/prompt.d.ts

@@ -0,0 +1,40 @@
+import type { AppMap, DbModelEntry, Diff, EndpointEntry, InfraEntry, RouteEntry, SpecEntry } from "./types.js";
+export declare const SYSTEM_PROMPT = "You are claudia, a diff-aware test planner.\n\nYour job: read a code diff plus a map of the app's routes and API endpoints, then output a structured plan describing which user-facing flows a human tester should exercise to validate the change. You DO NOT execute tests. You produce a plan a reviewer or downstream tool will act on.\n\nRules:\n- Be specific. Cite changed file paths in your reasoning.\n- Map every changed file to the routes AND endpoints it reaches. If a file is not in the map, list it under unmappedFiles and explain why it might still matter.\n- Distinguish API changes from UI changes:\n  - A changed page/component implies a flow on its route(s) \u2014 write checks as user actions.\n  - A changed endpoint (route.ts) implies an API contract change \u2014 call out the method + path, the request body shape (json/formData/text/etc), and recommend exercising it via the UI flow that hits it OR directly (curl/API client) when no UI flow is implicated.\n  - A changed component that *calls* an endpoint (statically detected \u2014 see \"Endpoints called by changed files\" below) implies a full-stack flow: the UI change AND the contract between UI and that endpoint. Verify the end-to-end roundtrip, not just the rendered output.\n- The flow.routes field can contain either page paths (\"/checkout\") or method-prefixed endpoint paths (\"POST /api/bugs/move\"). Use whichever fits the change.\n- Risk levels: \"high\" = auth, payments, data-mutation, schema changes, or many routes/endpoints affected; \"medium\" = single-route behavior change or additive endpoint; \"low\" = cosmetic, copy, isolated UI.\n- Suggested checks must be concrete user actions (\"complete checkout with a saved card\", not \"test the checkout flow\") or concrete API checks (\"POST /api/bugs/move with a valid payload; expect 200 + new bug ref\").\n- Set verdict to \"skip\" only if the diff genuinely cannot affect runtime behavior (already-filtered cases shouldn't reach you, so prefer \"test\").\n- coverageGaps captures *unmapped risk* \u2014 changes you can see have impact but no flow or endpoint in the map covers them.\n- Treat infrastructure changes as production-impact risk. If the diff includes Terraform/CDK resources and any endpoint in the diff touches the same service (per the endpoint's \"services\" annotation), call out the coordinated risk \u2014 e.g. \"S3 bucket policy changed AND POST /api/attachments writes to S3, verify the write still succeeds end-to-end.\"\n- Treat database-schema changes as high-risk by default. Endpoints carry a \"tables\" annotation listing the DB models they touch (e.g. a Prisma call like prisma.bug.create(...) maps to [\"Bug\"]). When the diff changes the schema for a model AND an endpoint in the diff (or called by the diff) touches that model, call out the read/write contract explicitly \u2014 \"the Bug model gained a non-null column; POST /api/bugs writes to Bug, verify the new column is populated.\"\n- When the prompt's \"Existing test coverage\" section lists specs that already cover the affected routes/endpoints, reference them by file:name in your suggestedChecks \u2014 e.g. \"Run e2e/checkout.spec.ts:'completes checkout' against the deploy.\" Recommending existing specs is cheaper for the team than writing new ones and is preferred when coverage exists.\n- coverageGaps should call out flows the diff implicates that have NO existing spec \u2014 that's a concrete signal to the team to add one.\n- Be terse. The output is read by humans on a PR.";
+/**
+ * Reduce the map to only the routes that the diff actually touches.
+ * Massively cuts prompt token cost on large repos; the brain only needs the
+ * route information for places the diff implicates.
+ *
+ * A route is "implicated" if any of its tracked files appears in the diff
+ * (matching either the post-image path or, for renames, the pre-image path).
+ */
+export interface EndpointCallSite {
+    endpoint: EndpointEntry;
+    /** Files in the diff that statically call this endpoint. */
+    callerFiles: string[];
+}
+export declare function filterMapForDiff(map: AppMap, diff: Diff): {
+    implicated: RouteEntry[];
+    omittedCount: number;
+    implicatedEndpoints: EndpointEntry[];
+    omittedEndpointCount: number;
+    /** Endpoints that aren't directly changed, but are called from files in the diff. */
+    endpointsCalledByDiff: EndpointCallSite[];
+    /** Infrastructure resources whose declaration file is in the diff. */
+    implicatedInfra: InfraEntry[];
+    omittedInfraCount: number;
+    /** Database models whose schema file is in the diff. */
+    implicatedDbModels: DbModelEntry[];
+    omittedDbModelCount: number;
+    /** Specs whose coverage intersects with implicated routes or endpoints. */
+    coveringSpecs: SpecEntry[];
+    /** Routes implicated by the diff that have NO covering spec. */
+    uncoveredRoutes: string[];
+    /** Endpoints implicated by the diff that have NO covering spec. */
+    uncoveredEndpoints: string[];
+};
+export declare function buildUserMessage(args: {
+    diff: Diff;
+    map: AppMap;
+    targetUrl?: string;
+}): string;