cairn-engine 0.1.0

package/dist/core/pipeline.js

@@ -0,0 +1,49 @@
+async function executeStep(driver, step) {
+    try {
+        switch (step.kind) {
+            case "goto":
+                await driver.goto(step.url);
+                break;
+            case "click":
+                await driver.click(step.target);
+                break;
+            case "type":
+                await driver.type(step.target, step.text);
+                break;
+        }
+        return { step, ok: true };
+    }
+    catch (err) {
+        return { step, ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+export async function runHarness(harness, task) {
+    const { context, planner, driver, critic, reporter } = harness;
+    const ctx = await context.provide(task);
+    const scenario = await planner.plan(ctx);
+    // Drive steps; stop on the first failure but still observe the resulting state.
+    const actions = [];
+    try {
+        for (const step of scenario.steps) {
+            const result = await executeStep(driver, step);
+            actions.push(result);
+            if (!result.ok)
+                break;
+        }
+        // Auto-wait for network idle so evidence captures late subresources, not a race (design §3).
+        await driver.settle();
+        const observed = await driver.observe();
+        const evidence = {
+            ...observed,
+            execution: { ...observed.execution, actions, blocked: actions.some((a) => !a.ok) },
+        };
+        const verdict = await critic.judge(evidence, scenario.assertions);
+        const out = { scenario: scenario.name, context: ctx, evidence, verdict };
+        await reporter.emit(out);
+        return out;
+    }
+    finally {
+        await driver.close();
+    }
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/core/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":"AAQA,KAAK,UAAU,WAAW,CAAC,MAAyB,EAAE,IAAU;IAC9D,IAAI,CAAC;QACH,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,MAAM;gBACT,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC5B,MAAM;YACR,KAAK,OAAO;gBACV,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAChC,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1C,MAAM;QACV,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACtF,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAgB,EAAE,IAAY;IAC7D,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE/D,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEzC,gFAAgF;IAChF,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,EAAE;gBAAE,MAAM;QACxB,CAAC;QAED,6FAA6F;QAC7F,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;QAEtB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAa;YACzB,GAAG,QAAQ;YACX,SAAS,EAAE,EAAE,GAAG,QAAQ,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;SACnF,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QAClE,MAAM,GAAG,GAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QACjF,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,OAAO,GAAG,CAAC;IACb,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/core/ports.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The ports of the cairn engine (invariant #2: add behavior by implementing one of these,
+ * never by branching inside a stage). Core depends only on these; `../adapters` implement them.
+ */
+import type { Assertion, Context, Evidence, PageElement, Result, Scenario, SettleOptions, Target, Verdict } from "./types.js";
+/** Grounding from any source (NL, git diff, ticket, RAG). */
+export interface ContextProvider {
+    provide(task: string): Promise<Context>;
+}
+/** Intent → ordered Scenario. Frozen-replay planning uses no LLM (invariant #4); discovery is a separate LLM planner. */
+export interface Planner {
+    plan(ctx: Context): Promise<Scenario>;
+}
+/** Drives a browser. Replaceable without touching core (invariant #5); resolves targets from intent, not handles. */
+export interface Driver {
+    goto(url: string): Promise<void>;
+    click(target: Target): Promise<void>;
+    type(target: Target, text: string): Promise<void>;
+    snapshot(): Promise<PageElement[]>;
+    /** Execute-stage auto-wait for network idle (design §3). Best-effort, time-bounded, never throws. */
+    settle(options?: SettleOptions): Promise<void>;
+    observe(): Promise<Evidence>;
+    close(): Promise<void>;
+}
+export interface Skill {
+    name: string;
+    scenario: Scenario;
+}
+export interface SkillStore {
+    resolve(name: string): Promise<Skill | undefined>;
+}
+/** Judges evidence against assertions (mechanical, baseline, or LLM). */
+export interface Critic {
+    judge(evidence: Evidence, assertions: Assertion[]): Promise<Verdict>;
+}
+/** Emits a result anywhere — console, json, an arbitrary tracker. */
+export interface Reporter {
+    emit(result: Result): Promise<void>;
+}
+export interface Harness {
+    context: ContextProvider;
+    planner: Planner;
+    driver: Driver;
+    critic: Critic;
+    reporter: Reporter;
+    skills?: SkillStore;
+}
+/** Model-agnostic LLM seam (invariant #5); `createLlmClient` picks the implementation. */
+export interface LlmClient {
+    readonly id: string;
+    complete(prompt: string, opts?: CompleteOptions): Promise<string>;
+}
+export interface CompleteOptions {
+    system?: string;
+    maxTokens?: number;
+}

package/dist/core/ports.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/core/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/core/ports.ts"],"names":[],"mappings":""}

package/dist/core/types.d.ts

@@ -0,0 +1,102 @@
+/** Domain types for the pipeline (Context → Plan → Execute → Judge → Report). App-agnostic by invariant #1. */
+export interface Context {
+    intent: string;
+    baseUrl?: string;
+    notes?: string[];
+}
+export type Step = {
+    kind: "goto";
+    url: string;
+} | {
+    kind: "click";
+    target: Target;
+} | {
+    kind: "type";
+    target: Target;
+    text: string;
+};
+/** Locate an element by intent, not a driver handle: `text` = accessible name, `selector` = CSS fallback. */
+export interface Target {
+    text?: string;
+    selector?: string;
+}
+/**
+ * `expect` is the only kind an LLM judges; a scenario with only mechanical kinds replays
+ * deterministically (invariant #4).
+ */
+export type Assertion = {
+    kind: "navigated";
+    to?: string;
+} | {
+    kind: "no-console-errors";
+} | {
+    kind: "no-failed-requests";
+} | {
+    kind: "request-status";
+    urlIncludes: string;
+    status: number;
+} | {
+    kind: "expect";
+    criterion: string;
+};
+export interface Scenario {
+    name: string;
+    steps: Step[];
+    assertions: Assertion[];
+}
+/** An interactive element the discover loop perceives and acts on. */
+export interface PageElement {
+    role: string;
+    name: string;
+}
+export interface SettleOptions {
+    idleMs?: number;
+    timeoutMs?: number;
+    pollMs?: number;
+}
+export interface NetworkRequest {
+    method: string;
+    url: string;
+    status: number;
+    resourceType?: string;
+}
+/** Three observable layers the Critic judges on — never "the screen looked right". */
+export interface Evidence {
+    execution: {
+        actions: ExecutedAction[];
+        navigated: boolean;
+        finalUrl?: string;
+        blocked: boolean;
+    };
+    perception: {
+        screenshot?: string;
+    };
+    logic: {
+        requests: NetworkRequest[];
+        console: ConsoleMessage[];
+    };
+}
+export interface ExecutedAction {
+    step: Step;
+    ok: boolean;
+    error?: string;
+}
+export interface ConsoleMessage {
+    type: string;
+    text: string;
+}
+export interface AssertionResult {
+    assertion: Assertion;
+    passed: boolean;
+    detail?: string;
+}
+export interface Verdict {
+    passed: boolean;
+    results: AssertionResult[];
+}
+export interface Result {
+    scenario: string;
+    context: Context;
+    evidence: Evidence;
+    verdict: Verdict;
+}

package/dist/core/types.js

@@ -0,0 +1,3 @@
+/** Domain types for the pipeline (Context → Plan → Execute → Judge → Report). App-agnostic by invariant #1. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,+GAA+G"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/** Public surface of cairn-engine. */
+export * from "./core/types.js";
+export * from "./core/ports.js";
+export { runHarness } from "./core/pipeline.js";
+export { runScenario, needsLlmCritic, applyHeals } from "./run.js";
+export type { RunScenarioOptions, RunScenarioResult } from "./run.js";
+export { InlineContextProvider } from "./adapters/context/inline.js";
+export { StaticPlanner } from "./adapters/planners/static.js";
+export { AssertionCritic, checkAssertion } from "./adapters/critics/assertion.js";
+export { LlmCritic, summarizeEvidence } from "./adapters/critics/llm.js";
+export { ConsoleReporter } from "./adapters/reporters/console.js";
+export { JsonReporter } from "./adapters/reporters/json.js";
+export { FakeDriver } from "./adapters/drivers/fake.js";
+export { ChromeDevToolsDriver } from "./adapters/drivers/chrome.js";
+export { SelfHealingDriver, parseHealChoice } from "./adapters/drivers/self-heal.js";
+export type { Heal, SelfHealOptions } from "./adapters/drivers/self-heal.js";
+export { ClaudeCodeLlmClient } from "./adapters/llm/claude-code.js";
+export { AnthropicLlmClient } from "./adapters/llm/anthropic.js";
+export { createLlmClient } from "./adapters/llm/factory.js";
+export { FileSkillStore, loadSkillFile } from "./adapters/skills/file-store.js";
+export { discover, parseDecision } from "./core/discover.js";
+export type { DiscoverOptions, Decision } from "./core/discover.js";

package/dist/index.js

@@ -0,0 +1,20 @@
+/** Public surface of cairn-engine. */
+export * from "./core/types.js";
+export * from "./core/ports.js";
+export { runHarness } from "./core/pipeline.js";
+export { runScenario, needsLlmCritic, applyHeals } from "./run.js";
+export { InlineContextProvider } from "./adapters/context/inline.js";
+export { StaticPlanner } from "./adapters/planners/static.js";
+export { AssertionCritic, checkAssertion } from "./adapters/critics/assertion.js";
+export { LlmCritic, summarizeEvidence } from "./adapters/critics/llm.js";
+export { ConsoleReporter } from "./adapters/reporters/console.js";
+export { JsonReporter } from "./adapters/reporters/json.js";
+export { FakeDriver } from "./adapters/drivers/fake.js";
+export { ChromeDevToolsDriver } from "./adapters/drivers/chrome.js";
+export { SelfHealingDriver, parseHealChoice } from "./adapters/drivers/self-heal.js";
+export { ClaudeCodeLlmClient } from "./adapters/llm/claude-code.js";
+export { AnthropicLlmClient } from "./adapters/llm/anthropic.js";
+export { createLlmClient } from "./adapters/llm/factory.js";
+export { FileSkillStore, loadSkillFile } from "./adapters/skills/file-store.js";
+export { discover, parseDecision } from "./core/discover.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,sCAAsC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEhF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/run.d.ts

@@ -0,0 +1,25 @@
+import type { ContextProvider, Critic, Driver, LlmClient, Reporter } from "./core/ports.js";
+import type { Heal } from "./adapters/drivers/self-heal.js";
+import type { Result, Scenario } from "./core/types.js";
+export interface RunScenarioOptions {
+    driver?: Driver;
+    /** Default: LlmCritic if the scenario has `expect`, else AssertionCritic. */
+    critic?: Critic;
+    context?: ContextProvider;
+    reporter?: Reporter;
+    llm?: LlmClient;
+    /** Wrap the driver so broken steps are repaired by the LLM and retried. */
+    heal?: boolean;
+    model?: string;
+}
+export interface RunScenarioResult {
+    result: Result;
+    /** Substitutions self-heal made (empty unless `heal` was set and a step broke). */
+    heals: Heal[];
+    /** Scenario rewritten with healed targets, ready to re-freeze. Undefined if no heals. */
+    healedScenario?: Scenario;
+}
+export declare function needsLlmCritic(scenario: Scenario): boolean;
+/** Rewrite a scenario's targets with the names self-heal substituted, for re-freezing. */
+export declare function applyHeals(scenario: Scenario, heals: Heal[]): Scenario;
+export declare function runScenario(scenario: Scenario, opts?: RunScenarioOptions): Promise<RunScenarioResult>;

package/dist/run.js

@@ -0,0 +1,53 @@
+/**
+ * High-level entry point: run/replay a Scenario with sensible defaults (the CLI, a desktop
+ * app, or CI all go through here). No LLM is constructed unless an `expect` critic or
+ * `heal` needs one, so a plain mechanical replay stays deterministic (invariant #4).
+ */
+import { runHarness } from "./core/pipeline.js";
+import { InlineContextProvider } from "./adapters/context/inline.js";
+import { StaticPlanner } from "./adapters/planners/static.js";
+import { AssertionCritic } from "./adapters/critics/assertion.js";
+import { LlmCritic } from "./adapters/critics/llm.js";
+import { ChromeDevToolsDriver } from "./adapters/drivers/chrome.js";
+import { SelfHealingDriver } from "./adapters/drivers/self-heal.js";
+import { ConsoleReporter } from "./adapters/reporters/console.js";
+import { createLlmClient } from "./adapters/llm/factory.js";
+export function needsLlmCritic(scenario) {
+    return scenario.assertions.some((a) => a.kind === "expect");
+}
+/** Rewrite a scenario's targets with the names self-heal substituted, for re-freezing. */
+export function applyHeals(scenario, heals) {
+    if (!heals.length)
+        return scenario;
+    const byOriginal = new Map(heals.map((h) => [h.original.text, h.healedText]));
+    return {
+        ...scenario,
+        steps: scenario.steps.map((step) => {
+            if ((step.kind === "click" || step.kind === "type") && step.target.text) {
+                const healed = byOriginal.get(step.target.text);
+                if (healed)
+                    return { ...step, target: { ...step.target, text: healed } };
+            }
+            return step;
+        }),
+    };
+}
+export async function runScenario(scenario, opts = {}) {
+    // Build the LLM lazily and once — only if the critic or heal needs it.
+    let llmCache = opts.llm;
+    const getLlm = () => (llmCache ??= createLlmClient(opts.model ? { model: opts.model } : {}));
+    const critic = opts.critic ?? (needsLlmCritic(scenario) ? new LlmCritic(getLlm()) : new AssertionCritic());
+    const baseDriver = opts.driver ?? new ChromeDevToolsDriver();
+    let healer;
+    const driver = opts.heal ? (healer = new SelfHealingDriver(baseDriver, getLlm())) : baseDriver;
+    const result = await runHarness({
+        context: opts.context ?? new InlineContextProvider(),
+        planner: new StaticPlanner(scenario),
+        driver,
+        critic,
+        reporter: opts.reporter ?? new ConsoleReporter(),
+    }, scenario.name);
+    const heals = healer?.heals ?? [];
+    return { result, heals, healedScenario: heals.length ? applyHeals(scenario, heals) : undefined };
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "cairn-engine",
+  "version": "0.1.0",
+  "description": "An engine for self-healing E2E browser tests — discovered once by an AI, replayed deterministically.",
+  "keywords": [
+    "e2e",
+    "testing",
+    "browser",
+    "qa",
+    "self-healing",
+    "deterministic",
+    "llm",
+    "ai",
+    "chrome-devtools",
+    "mcp",
+    "automation"
+  ],
+  "license": "MIT",
+  "author": "team-poem (https://github.com/team-poem)",
+  "homepage": "https://github.com/team-poem/cairn#readme",
+  "bugs": "https://github.com/team-poem/cairn/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/team-poem/cairn.git",
+    "directory": "packages/harness"
+  },
+  "type": "module",
+  "bin": {
+    "cairn": "./dist/cli.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "dev": "tsx src/cli.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  }
+}