@kraken-e2e/core 0.1.0

package/dist/ctk.d.ts

@@ -0,0 +1,57 @@
+import { type CoreOperation, type TargetLocator, type UserSession } from '@kraken-e2e/contracts';
+export interface CtkFixture {
+    /** An element that can be tapped without navigating away. */
+    readonly tappable: TargetLocator;
+    /** A text input to type into. */
+    readonly typable: TargetLocator;
+    /**
+     * Where the typed value can be read back. Defaults to `typable`; real apps
+     * often mirror input into a label (platforms differ on reading TextField
+     * values directly — e.g. native-demo-app's '~input-text-result').
+     */
+    readonly typableEcho?: TargetLocator;
+    /** A visible element with known text. */
+    readonly readable: {
+        readonly target: TargetLocator;
+        readonly expected: string;
+    };
+    /** Destination for navigate() (URL / deep link / fake route). */
+    readonly navigateTo?: string;
+}
+export type CtkOperationOutcome = {
+    readonly status: 'supported';
+} | {
+    readonly status: 'unsupported';
+    readonly reason: string;
+} | {
+    readonly status: 'failing';
+    readonly error: string;
+};
+export interface ParityReport {
+    readonly driver: string;
+    readonly generatedAt: string;
+    readonly operations: Readonly<Record<CoreOperation, CtkOperationOutcome>>;
+}
+export interface CtkOptions {
+    readonly name: string;
+    /** Fresh session per operation; the CTK disposes it. */
+    readonly createSession: () => Promise<UserSession>;
+    readonly fixture: CtkFixture;
+    /** Where parity-report.json is written (the C3 artifact). */
+    readonly reportPath: string;
+    /** Reasons for ops the driver declares unsupported (rendered in the report). */
+    readonly unsupportedReasons?: Partial<Record<CoreOperation, string>>;
+    /**
+     * Runs after each createSession, before the operation is exercised — e.g.
+     * navigate to the screen holding the fixture elements ('tap the Forms tab').
+     */
+    readonly prepare?: (session: UserSession) => Promise<void>;
+}
+export declare function describeDriverConformance(options: CtkOptions): void;
+/**
+ * The M1 exit-gate comparison (ADR-0001 §5.4): zero failing entries on both
+ * sides and an empty diff between supported-op sets. Returns human-readable
+ * problems; empty array = parity.
+ */
+export declare function compareParityReports(a: ParityReport, b: ParityReport): readonly string[];
+//# sourceMappingURL=ctk.d.ts.map

package/dist/ctk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ctk.d.ts","sourceRoot":"","sources":["../src/ctk.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,aAAa,EAElB,KAAK,aAAa,EAClB,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,UAAU;IACzB,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;IACrC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACjF,iEAAiE;IACjE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAChC;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC;CAC3E;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;IACrE;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAoDD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAyDnE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAqBxF"}

package/dist/ctk.js

@@ -0,0 +1,137 @@
+/**
+ * Conformance Test Kit (ADR-0001 §5.4 guardrail 2, ADR-0002 D8): exercises
+ * every core operation against a driver + fixture and emits parity-report.json.
+ * Parity is a GENERATED artifact: M1 closes only with zero `failing` entries
+ * on both mobile platforms AND an empty diff between their supported-op sets
+ * (symmetric unsupported(reason) allowed; asymmetric needs recorded sign-off).
+ *
+ * Uses vitest (optional peer — same pattern as @kraken-e2e/signaling/conformance).
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { CORE_OPERATIONS, KrakenError, } from '@kraken-e2e/contracts';
+import { afterAll, describe, expect, it } from 'vitest';
+async function exercise(op, session, fixture) {
+    switch (op) {
+        case 'tap':
+            return session.tap(fixture.tappable);
+        case 'typeText': {
+            await session.typeText(fixture.typable, 'kraken-ctk');
+            const echoed = await session.readText(fixture.typableEcho ?? fixture.typable);
+            expect(echoed).toBe('kraken-ctk');
+            return;
+        }
+        case 'readText': {
+            const text = await session.readText(fixture.readable.target);
+            expect(text).toBe(fixture.readable.expected);
+            return;
+        }
+        case 'waitFor':
+            return session.waitFor(fixture.readable.target, 'visible', { timeoutMs: 5_000 });
+        case 'isDisplayed': {
+            expect(await session.isDisplayed(fixture.readable.target)).toBe(true);
+            return;
+        }
+        case 'scrollIntoView':
+            return session.scrollIntoView(fixture.readable.target);
+        case 'pressKey':
+            return session.pressKey('enter');
+        case 'navigate':
+            return session.navigate(fixture.navigateTo ?? 'ctk://noop');
+        case 'screenshot': {
+            const artifact = await session.screenshot();
+            expect(artifact.kind).toBe('screenshot');
+            expect(existsSync(artifact.path)).toBe(true);
+            return;
+        }
+        case 'source': {
+            const source = await session.source();
+            expect(source.length).toBeGreaterThan(0);
+            return;
+        }
+        case 'dispose': {
+            await session.dispose();
+            await session.dispose(); // idempotency is part of the contract
+            return;
+        }
+    }
+}
+export function describeDriverConformance(options) {
+    const outcomes = new Map();
+    describe(`Driver conformance (CTK): ${options.name}`, () => {
+        for (const op of CORE_OPERATIONS) {
+            it(`operation: ${op}`, async () => {
+                const session = await options.createSession();
+                try {
+                    await options.prepare?.(session);
+                    if (session.capabilities[op] === 'unsupported') {
+                        // A declared-unsupported op must throw the canonical error — visible
+                        // parity, never silent absence (ADR-0001 §5.4).
+                        const reason = options.unsupportedReasons?.[op] ?? 'declared unsupported (no reason given)';
+                        if (op !== 'dispose') {
+                            await expect(exercise(op, session, options.fixture)).rejects.toSatisfy((error) => KrakenError.is(error) && error.code === 'KRK-SESSION-OP-UNSUPPORTED');
+                        }
+                        outcomes.set(op, { status: 'unsupported', reason });
+                        return;
+                    }
+                    await exercise(op, session, options.fixture);
+                    outcomes.set(op, { status: 'supported' });
+                }
+                catch (error) {
+                    outcomes.set(op, {
+                        status: 'failing',
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                    throw error; // an op must pass OR be declared unsupported — never fail silently
+                }
+                finally {
+                    try {
+                        await session.dispose();
+                    }
+                    catch {
+                        // dispose problems surface in the dispose op's own test
+                    }
+                }
+            });
+        }
+        afterAll(() => {
+            const operations = Object.fromEntries(CORE_OPERATIONS.map((op) => [
+                op,
+                outcomes.get(op) ?? { status: 'failing', error: 'not exercised' },
+            ]));
+            const report = {
+                driver: options.name,
+                generatedAt: new Date().toISOString(),
+                operations,
+            };
+            mkdirSync(dirname(options.reportPath), { recursive: true });
+            writeFileSync(options.reportPath, `${JSON.stringify(report, null, 2)}\n`);
+        });
+    });
+}
+/**
+ * The M1 exit-gate comparison (ADR-0001 §5.4): zero failing entries on both
+ * sides and an empty diff between supported-op sets. Returns human-readable
+ * problems; empty array = parity.
+ */
+export function compareParityReports(a, b) {
+    const problems = [];
+    for (const op of CORE_OPERATIONS) {
+        const left = a.operations[op];
+        const right = b.operations[op];
+        if (left.status === 'failing')
+            problems.push(`${a.driver}: ${op} is failing (${left.error})`);
+        if (right.status === 'failing')
+            problems.push(`${b.driver}: ${op} is failing (${right.error})`);
+        const leftSupported = left.status === 'supported';
+        const rightSupported = right.status === 'supported';
+        if (leftSupported !== rightSupported &&
+            left.status !== 'failing' &&
+            right.status !== 'failing') {
+            problems.push(`asymmetric support for ${op}: ${a.driver}=${left.status}, ${b.driver}=${right.status} ` +
+                '(requires recorded human sign-off — ADR-0001 §5.4)');
+        }
+    }
+    return problems;
+}
+//# sourceMappingURL=ctk.js.map

package/dist/ctk.js.map

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

package/dist/event-bus.d.ts

@@ -0,0 +1,21 @@
+import type { KrakenEvent, KrakenEventInput, Reporter } from '@kraken-e2e/contracts';
+export interface EventSink {
+    emit(input: KrakenEventInput): KrakenEvent;
+}
+/**
+ * Stamps the envelope ({ts, runId, seq} — seq monotonic per run) and fans out
+ * to reporters (ADR-0002 D5). Reporter errors are contained: reported once via
+ * onReporterError, never allowed to fail the run.
+ */
+export declare class EventBus implements EventSink {
+    #private;
+    readonly runId: string;
+    constructor(runId: string, options?: {
+        onReporterError?: (reporterId: string, error: unknown) => void;
+    });
+    subscribe(reporter: Reporter): void;
+    emit(input: KrakenEventInput): KrakenEvent;
+    /** Awaits every reporter's chain and flush() — call once at run end. */
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAIrF,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAAC;CAC5C;AAQD;;;;GAIG;AACH,qBAAa,QAAS,YAAW,SAAS;;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAOrB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;KAAO;IAMlF,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAInC,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW;IAuB1C,wEAAwE;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAY7B"}

package/dist/event-bus.js

@@ -0,0 +1,55 @@
+import { validateEvent } from './event-schemas.js';
+/**
+ * Stamps the envelope ({ts, runId, seq} — seq monotonic per run) and fans out
+ * to reporters (ADR-0002 D5). Reporter errors are contained: reported once via
+ * onReporterError, never allowed to fail the run.
+ */
+export class EventBus {
+    runId;
+    #seq = 0;
+    #subscriptions = [];
+    #onReporterError;
+    #failed = new Set();
+    constructor(runId, options = {}) {
+        this.runId = runId;
+        this.#onReporterError = options.onReporterError ?? (() => { });
+    }
+    subscribe(reporter) {
+        this.#subscriptions.push({ reporter, chain: Promise.resolve() });
+    }
+    emit(input) {
+        this.#seq += 1;
+        const event = {
+            ...input,
+            ts: Date.now(),
+            runId: this.runId,
+            seq: this.#seq,
+        };
+        validateEvent(event);
+        for (const subscription of this.#subscriptions) {
+            subscription.chain = subscription.chain
+                .then(() => subscription.reporter.onEvent(event))
+                .catch((error) => {
+                // Report each reporter's first failure once; keep the stream flowing.
+                if (!this.#failed.has(subscription.reporter.id)) {
+                    this.#failed.add(subscription.reporter.id);
+                    this.#onReporterError(subscription.reporter.id, error);
+                }
+            });
+        }
+        return event;
+    }
+    /** Awaits every reporter's chain and flush() — call once at run end. */
+    async flush() {
+        await Promise.all(this.#subscriptions.map((subscription) => subscription.chain));
+        await Promise.all(this.#subscriptions.map(async (subscription) => {
+            try {
+                await subscription.reporter.flush?.();
+            }
+            catch (error) {
+                this.#onReporterError(subscription.reporter.id, error);
+            }
+        }));
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAYnD;;;;GAIG;AACH,MAAM,OAAO,QAAQ;IACV,KAAK,CAAS;IACvB,IAAI,GAAG,CAAC,CAAC;IACA,cAAc,GAAmB,EAAE,CAAC;IACpC,gBAAgB,CAA+C;IAC/D,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAErC,YACE,KAAa,EACb,UAA8E,EAAE;QAEhF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,eAAe,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,SAAS,CAAC,QAAkB;QAC1B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,CAAC,KAAuB;QAC1B,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;QACf,MAAM,KAAK,GAAG;YACZ,GAAG,KAAK;YACR,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,IAAI,CAAC,IAAI;SACA,CAAC;QACjB,aAAa,CAAC,KAAK,CAAC,CAAC;QACrB,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC/C,YAAY,CAAC,KAAK,GAAG,YAAY,CAAC,KAAK;iBACpC,IAAI,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;iBAChD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACf,sEAAsE;gBACtE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;oBAChD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;oBAC3C,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC,CAAC,CAAC;QACP,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,KAAK;QACT,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;QACjF,MAAM,OAAO,CAAC,GAAG,CACf,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE;YAC7C,IAAI,CAAC;gBACH,MAAM,YAAY,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;YACxC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACzD,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF"}

package/dist/event-schemas.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Runtime validation of the KrakenEvent stream (ADR-0002 D5). zod lives HERE,
+ * inside core, and never appears in any public .d.ts (ADR-0001 §5.3): the
+ * public surface is the plain TS types in @kraken-e2e/contracts plus the generated
+ * JSON Schema. The committed JSON-Schema snapshot test is the additive-only
+ * evolution guard (ADR-0001 §5.12).
+ */
+import { type KrakenEvent } from '@kraken-e2e/contracts';
+/** Throws with a precise message when core emits a malformed event (a core bug). */
+export declare function validateEvent(event: KrakenEvent): void;
+/** The public, consumer-facing schema (future GUI, external tooling). */
+export declare function krakenEventJsonSchema(): Record<string, unknown>;
+//# sourceMappingURL=event-schemas.d.ts.map

package/dist/event-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-schemas.d.ts","sourceRoot":"","sources":["../src/event-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA8LtE,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAStD;AAED,yEAAyE;AACzE,wBAAgB,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE/D"}

package/dist/event-schemas.js

@@ -0,0 +1,202 @@
+/**
+ * Runtime validation of the KrakenEvent stream (ADR-0002 D5). zod lives HERE,
+ * inside core, and never appears in any public .d.ts (ADR-0001 §5.3): the
+ * public surface is the plain TS types in @kraken-e2e/contracts plus the generated
+ * JSON Schema. The committed JSON-Schema snapshot test is the additive-only
+ * evolution guard (ADR-0001 §5.12).
+ */
+import { KrakenError } from '@kraken-e2e/contracts';
+import { z } from 'zod';
+const base = {
+    ts: z.number(),
+    runId: z.string().min(1),
+    seq: z.number().int().positive(),
+};
+const serializedError = z
+    .object({
+    code: z.string(),
+    message: z.string(),
+    fix: z.string().optional(),
+    data: z.record(z.string(), z.unknown()).optional(),
+})
+    .strict();
+const stepStatus = z.enum(['passed', 'failed', 'skipped']);
+const actorSummary = z
+    .object({ id: z.string(), platform: z.string(), driverId: z.string() })
+    .strict();
+const artifactKind = z.enum(['screenshot', 'log', 'video', 'source']);
+const logLevel = z.enum(['debug', 'info', 'warn', 'error']);
+// One schema per event type. Additive-only: new OPTIONAL fields at most; a
+// semantic change is a NEW event type (cucumber-messages model).
+// Module-private: zod must never leak into a public surface (ADR-0001 §5.3).
+const krakenEventSchema = z.discriminatedUnion('type', [
+    z
+        .object({
+        type: z.literal('runStarted'),
+        ...base,
+        protocol: z.literal(1),
+        scenarioCount: z.number().int().nonnegative(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('runFinished'),
+        ...base,
+        status: z.enum(['passed', 'failed']),
+        durationMs: z.number().nonnegative(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('scenarioStarted'),
+        ...base,
+        scenarioId: z.string(),
+        name: z.string(),
+        featureUri: z.string().optional(),
+        actors: z.array(actorSummary),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('scenarioFinished'),
+        ...base,
+        scenarioId: z.string(),
+        status: stepStatus,
+        durationMs: z.number().nonnegative(),
+        error: serializedError.optional(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('stepStarted'),
+        ...base,
+        scenarioId: z.string(),
+        stepId: z.string(),
+        actorId: z.string(),
+        text: z.string(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('stepFinished'),
+        ...base,
+        scenarioId: z.string(),
+        stepId: z.string(),
+        actorId: z.string(),
+        text: z.string(),
+        status: stepStatus,
+        durationMs: z.number().nonnegative(),
+        error: serializedError.optional(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('actorSessionStarted'),
+        ...base,
+        scenarioId: z.string(),
+        actorId: z.string(),
+        driverId: z.string(),
+        platformLabel: z.string(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('actorSessionFinished'),
+        ...base,
+        scenarioId: z.string(),
+        actorId: z.string(),
+        status: z.enum(['ok', 'failed']),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('signalSent'),
+        ...base,
+        scenarioId: z.string(),
+        signal: z.string(),
+        from: z.string(),
+        recordSeq: z.number().int().positive(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('signalWaitStarted'),
+        ...base,
+        scenarioId: z.string(),
+        signal: z.string(),
+        actorId: z.string(),
+        timeoutMs: z.number().positive(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('signalReceived'),
+        ...base,
+        scenarioId: z.string(),
+        signal: z.string(),
+        by: z.string(),
+        from: z.string(),
+        latencyMs: z.number().nonnegative(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('signalTimedOut'),
+        ...base,
+        scenarioId: z.string(),
+        signal: z.string(),
+        actorId: z.string(),
+        timeoutMs: z.number().positive(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('driverRegistered'),
+        ...base,
+        driverId: z.string(),
+        version: z.string(),
+        platforms: z.array(z.string()),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('driverDisabled'),
+        ...base,
+        driverId: z.string(),
+        code: z.string(),
+        reason: z.string(),
+        fix: z.string(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('artifactCaptured'),
+        ...base,
+        kind: artifactKind,
+        path: z.string(),
+        scenarioId: z.string().optional(),
+        actorId: z.string().optional(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('driverLog'),
+        ...base,
+        source: z.string(),
+        level: logLevel,
+        message: z.string(),
+    })
+        .strict(),
+]);
+/** Throws with a precise message when core emits a malformed event (a core bug). */
+export function validateEvent(event) {
+    const result = krakenEventSchema.safeParse(event);
+    if (!result.success) {
+        throw new KrakenError('KRK-RUN-ABORTED', `Internal error: core emitted a malformed "${event.type}" event: ${result.error.message}`, { data: { issues: JSON.parse(JSON.stringify(result.error.issues)) } });
+    }
+}
+/** The public, consumer-facing schema (future GUI, external tooling). */
+export function krakenEventJsonSchema() {
+    return z.toJSONSchema(krakenEventSchema);
+}
+//# sourceMappingURL=event-schemas.js.map

package/dist/event-schemas.js.map

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

package/dist/host.d.ts

@@ -0,0 +1,10 @@
+import type { HostContext, HostInfo, HostProbe } from '@kraken-e2e/contracts';
+/**
+ * THE single place in the entire codebase that reads process.platform/arch
+ * (ADR-0001 §5.5 / constraint C4b). Everything downstream receives injected
+ * HostInfo values, which is what makes the non-darwin branch unit-testable.
+ */
+export declare const systemHostProbe: HostProbe;
+/** What drivers receive at start(): host facts plus environment access. */
+export declare function createHostContext(host: HostInfo, projectRoot?: string): HostContext;
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,SAQ7B,CAAC;AAEF,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAMnF"}

package/dist/host.js

@@ -0,0 +1,23 @@
+/**
+ * THE single place in the entire codebase that reads process.platform/arch
+ * (ADR-0001 §5.5 / constraint C4b). Everything downstream receives injected
+ * HostInfo values, which is what makes the non-darwin branch unit-testable.
+ */
+export const systemHostProbe = {
+    detect() {
+        return {
+            platform: process.platform,
+            arch: process.arch,
+            nodeVersion: process.versions.node,
+        };
+    },
+};
+/** What drivers receive at start(): host facts plus environment access. */
+export function createHostContext(host, projectRoot) {
+    return {
+        ...host,
+        ...(projectRoot !== undefined ? { projectRoot } : {}),
+        env: process.env,
+    };
+}
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAc;IACxC,MAAM;QACJ,OAAO;YACL,QAAQ,EAAE,OAAO,CAAC,QAAgC;YAClD,IAAI,EAAE,OAAO,CAAC,IAAwB;YACtC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;SACnC,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAAC,IAAc,EAAE,WAAoB;IACpE,OAAO;QACL,GAAG,IAAI;QACP,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @kraken-e2e/core — orchestrator (ADR-0001 §5.3, ADR-0002).
+ *
+ * Session manager, DAG step scheduler, plugin registry, host detection, and
+ * the event bus. Knows NOTHING about Appium/WDIO/ADB/browsers (constraint C2):
+ * platform knowledge arrives exclusively through @kraken-e2e/contracts drivers.
+ *
+ * Subpaths: `@kraken-e2e/core/ctk` (driver Conformance Test Kit) and
+ * `@kraken-e2e/core/testing` (FakeDriver + FakeAppWorld).
+ */
+export { EventBus, type EventSink } from './event-bus.js';
+export { krakenEventJsonSchema } from './event-schemas.js';
+export { createHostContext, systemHostProbe } from './host.js';
+export { createLogger, type LogLevel, type LogLine, silentLogger } from './logger.js';
+export { type DriverRegistration, DriverRegistry, type DriverStatus } from './registry.js';
+export { type RunnerDependencies, type RunOptions, type RunResult, runScenarios, type ScenarioResult, ScenarioRunner, SESSION_DISPOSE_TIMEOUT_MS, } from './runner.js';
+export { ScenarioBuilder, scenario } from './scenario.js';
+export { type ActorRuntime, executePlan, type PlanExecutionResult, type PlanNode, type PlanNodeKind, type ScenarioPlan, type StepRunContext, TaskRegistry, } from './scheduler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,KAAK,kBAAkB,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,YAAY,EACZ,KAAK,cAAc,EACnB,cAAc,EACd,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EACL,KAAK,YAAY,EACjB,WAAW,EACX,KAAK,mBAAmB,EACxB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,YAAY,GACb,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * @kraken-e2e/core — orchestrator (ADR-0001 §5.3, ADR-0002).
+ *
+ * Session manager, DAG step scheduler, plugin registry, host detection, and
+ * the event bus. Knows NOTHING about Appium/WDIO/ADB/browsers (constraint C2):
+ * platform knowledge arrives exclusively through @kraken-e2e/contracts drivers.
+ *
+ * Subpaths: `@kraken-e2e/core/ctk` (driver Conformance Test Kit) and
+ * `@kraken-e2e/core/testing` (FakeDriver + FakeAppWorld).
+ */
+export { EventBus } from './event-bus.js';
+export { krakenEventJsonSchema } from './event-schemas.js';
+export { createHostContext, systemHostProbe } from './host.js';
+export { createLogger, silentLogger } from './logger.js';
+export { DriverRegistry } from './registry.js';
+export { runScenarios, ScenarioRunner, SESSION_DISPOSE_TIMEOUT_MS, } from './runner.js';
+export { ScenarioBuilder, scenario } from './scenario.js';
+export { executePlan, TaskRegistry, } from './scheduler.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;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAkB,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,YAAY,EAA+B,YAAY,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAA2B,cAAc,EAAqB,MAAM,eAAe,CAAC;AAC3F,OAAO,EAIL,YAAY,EAEZ,cAAc,EACd,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAEL,WAAW,EAMX,YAAY,GACb,MAAM,gBAAgB,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,16 @@
+import type { Logger } from '@kraken-e2e/contracts';
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogLine {
+    readonly level: LogLevel;
+    readonly scope: string;
+    readonly message: string;
+    readonly meta?: Readonly<Record<string, unknown>> | undefined;
+}
+/**
+ * Loggers are sink-based: core never writes to stdout itself (ADR-0001 §5.11
+ * stdout discipline). The CLI wires the sink to its renderer; tests wire it to
+ * an array.
+ */
+export declare function createLogger(scope: string, sink: (line: LogLine) => void): Logger;
+export declare const silentLogger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CAC/D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,CAOjF;AAED,eAAO,MAAM,YAAY,EAAE,MAAyC,CAAC"}