@pretorian-worx/runclaudia-core 0.12.0

package/dist/types.d.ts

@@ -0,0 +1,176 @@
+import { z } from "zod";
+export interface FileChange {
+    path: string;
+    status: "added" | "modified" | "deleted" | "renamed";
+    oldPath?: string;
+    additions: number;
+    deletions: number;
+    hunks: string[];
+    binary: boolean;
+}
+export interface Diff {
+    base: string;
+    head: string;
+    files: FileChange[];
+}
+export interface RouteEntry {
+    route: string;
+    files: string[];
+}
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+export interface EndpointEntry {
+    /** URL path including the method prefix, e.g. "POST /api/bugs/move" */
+    route: string;
+    /** Bare URL path, e.g. "/api/bugs/move" */
+    path: string;
+    method: HttpMethod;
+    /** Source file that defines this handler. */
+    file: string;
+    /** Best-effort guess at the request body shape, e.g. "json", "formData", "text", or null if no body parsing detected. */
+    bodyShape: "json" | "formData" | "text" | "arrayBuffer" | null;
+    /** Files statically detected to call this endpoint (fetch/axios/SWR). Best-effort. */
+    callers: string[];
+    /**
+     * Cloud services this endpoint touches, inferred from `@aws-sdk/client-*`
+     * imports in the handler source. E.g. ["s3", "dynamodb"]. Best-effort.
+     */
+    services: string[];
+    /**
+     * Database model/table names this endpoint touches, inferred from ORM
+     * client usage in the handler source (e.g. `prisma.bug.create(...)` →
+     * `["Bug"]`). Names are the canonical schema-side names. Best-effort.
+     */
+    tables: string[];
+}
+export interface DbModelEntry {
+    /** ORM that owns this model. */
+    orm: "prisma";
+    /** Canonical model name as declared in the schema (PascalCase for Prisma). */
+    name: string;
+    /** Schema file that declares this model. */
+    file: string;
+}
+export interface SpecEntry {
+    /** Test framework this spec was written for. */
+    framework: "playwright" | "cypress";
+    /** Spec file (relative to rootDir). */
+    file: string;
+    /** Test name from `test("name", ...)` / `it("name", ...)`. */
+    name: string;
+    /** URL paths the spec visits (page.goto, cy.visit). */
+    routesCovered: string[];
+    /** Method-prefixed endpoint routes the spec calls directly (e.g. "POST /api/bugs"). */
+    endpointsCovered: string[];
+    /**
+     * True if the spec lives inside a describe block with a beforeAll / before()
+     * hook — selecting one test from such a block requires running the whole
+     * describe to honor the setup. Flagged for downstream Stage C selection logic.
+     */
+    hasSharedSetup: boolean;
+    /** Explicit `// @claudia flow: <name>` annotation overriding heuristic coverage. */
+    flowAnnotations: string[];
+}
+export interface InfraEntry {
+    /** IaC tool that defines this resource. */
+    tool: "terraform";
+    /** Terraform resource type, e.g. "aws_s3_bucket". */
+    type: string;
+    /** Local name from the resource declaration, e.g. "attachments". */
+    name: string;
+    /** Address-style identifier, e.g. "aws_s3_bucket.attachments". */
+    address: string;
+    /** File that declares this resource. */
+    file: string;
+}
+export interface AppMap {
+    framework: "nextjs-app" | "unknown";
+    generatedAt: string;
+    rootDir: string;
+    routes: RouteEntry[];
+    endpoints: EndpointEntry[];
+    infra: InfraEntry[];
+    dbModels: DbModelEntry[];
+    specs: SpecEntry[];
+    fileToRoutes: Record<string, string[]>;
+    /** Reverse index: file path → endpoint route strings (e.g. "POST /api/bugs") that file calls. */
+    fileToEndpoints: Record<string, string[]>;
+    /** Reverse index: file path → infra resource addresses declared in that file. */
+    fileToInfra: Record<string, string[]>;
+    /** Reverse index: file path → DB model names declared in that file. */
+    fileToTables: Record<string, string[]>;
+    /** Reverse index: spec file path → list of test names declared in that file. */
+    fileToSpecs: Record<string, string[]>;
+}
+export declare const PlanFlowSchema: z.ZodObject<{
+    name: z.ZodString;
+    routes: z.ZodArray<z.ZodString, "many">;
+    risk: z.ZodEnum<["low", "medium", "high"]>;
+    reasoning: z.ZodString;
+    suggestedChecks: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    routes: string[];
+    risk: "low" | "medium" | "high";
+    reasoning: string;
+    suggestedChecks: string[];
+}, {
+    name: string;
+    routes: string[];
+    risk: "low" | "medium" | "high";
+    reasoning: string;
+    suggestedChecks: string[];
+}>;
+export declare const PlanSchema: z.ZodObject<{
+    verdict: z.ZodEnum<["test", "skip"]>;
+    skipReason: z.ZodOptional<z.ZodString>;
+    summary: z.ZodString;
+    flows: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        routes: z.ZodArray<z.ZodString, "many">;
+        risk: z.ZodEnum<["low", "medium", "high"]>;
+        reasoning: z.ZodString;
+        suggestedChecks: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        routes: string[];
+        risk: "low" | "medium" | "high";
+        reasoning: string;
+        suggestedChecks: string[];
+    }, {
+        name: string;
+        routes: string[];
+        risk: "low" | "medium" | "high";
+        reasoning: string;
+        suggestedChecks: string[];
+    }>, "many">;
+    unmappedFiles: z.ZodArray<z.ZodString, "many">;
+    coverageGaps: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    verdict: "test" | "skip";
+    summary: string;
+    flows: {
+        name: string;
+        routes: string[];
+        risk: "low" | "medium" | "high";
+        reasoning: string;
+        suggestedChecks: string[];
+    }[];
+    unmappedFiles: string[];
+    coverageGaps: string[];
+    skipReason?: string | undefined;
+}, {
+    verdict: "test" | "skip";
+    summary: string;
+    flows: {
+        name: string;
+        routes: string[];
+        risk: "low" | "medium" | "high";
+        reasoning: string;
+        suggestedChecks: string[];
+    }[];
+    unmappedFiles: string[];
+    coverageGaps: string[];
+    skipReason?: string | undefined;
+}>;
+export type PlanFlow = z.infer<typeof PlanFlowSchema>;
+export type Plan = z.infer<typeof PlanSchema>;

package/dist/types.js

@@ -0,0 +1,17 @@
+import { z } from "zod";
+export const PlanFlowSchema = z.object({
+    name: z.string().describe("Short user-facing name of the flow, e.g. 'Checkout' or 'Sign-in'"),
+    routes: z.array(z.string()).describe("URL paths the flow exercises"),
+    risk: z.enum(["low", "medium", "high"]),
+    reasoning: z.string().describe("Why this flow is implicated by the diff. Cite specific files."),
+    suggestedChecks: z.array(z.string()).describe("Concrete checks a tester should perform"),
+});
+export const PlanSchema = z.object({
+    verdict: z.enum(["test", "skip"]),
+    skipReason: z.string().optional(),
+    summary: z.string().describe("One-paragraph summary of what changed and what to test"),
+    flows: z.array(PlanFlowSchema),
+    unmappedFiles: z.array(z.string()).describe("Changed files not associated with any known flow"),
+    coverageGaps: z.array(z.string()).describe("Risks not covered by any inferred flow"),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiHxB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kEAAkE,CAAC;IAC7F,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACpE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;IAC/F,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;CACzF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;IACtF,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;IAC9B,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC/F,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;CACrF,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@pretorian-worx/runclaudia-core",
+  "version": "0.12.0",
+  "description": "Core library for claudia — diff parser, framework adapters (Next.js / Terraform / Prisma / Playwright), prompt builder, Anthropic SDK wrapper, plan + selection + gating + runner primitives. Consumed by @pretorian-worx/runclaudia-cli and the runclaudia GitHub Action.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Paul Schneider",
+  "homepage": "https://github.com/pretorian-worx/runclaudia#readme",
+  "bugs": {
+    "url": "https://github.com/pretorian-worx/runclaudia/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pretorian-worx/runclaudia.git",
+    "directory": "packages/core"
+  },
+  "keywords": [
+    "ci",
+    "testing",
+    "playwright",
+    "post-deploy",
+    "diff",
+    "qa",
+    "claude",
+    "anthropic"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.40.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0",
+    "@types/node": "^22.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}