@kraken-e2e/core 0.1.0

package/dist/logger.js

@@ -0,0 +1,13 @@
+/**
+ * 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 function createLogger(scope, sink) {
+    const log = (level) => (message, meta) => {
+        sink({ level, scope, message, ...(meta !== undefined ? { meta } : {}) });
+    };
+    return { debug: log('debug'), info: log('info'), warn: log('warn'), error: log('error') };
+}
+export const silentLogger = createLogger('silent', () => { });
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,IAA6B;IACvE,MAAM,GAAG,GACP,CAAC,KAAe,EAAE,EAAE,CACpB,CAAC,OAAe,EAAE,IAAwC,EAAQ,EAAE;QAClE,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC,CAAC;IACJ,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;AAC5F,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAW,YAAY,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,50 @@
+import { type ContractVersion, type DriverManifest, type HostInfo, type KrakenDriver } from '@kraken-e2e/contracts';
+import type { EventSink } from './event-bus.js';
+/** Config-facing registration forms (ADR-0001 §5.10): values, names, or tuples. */
+export type DriverRegistration = KrakenDriver | string | readonly [packageName: string, options?: unknown];
+export type DriverStatus = {
+    readonly state: 'ready';
+    readonly driver: KrakenDriver;
+} | {
+    readonly state: 'unavailable-on-host';
+    readonly manifest: DriverManifest;
+    readonly code: `KRK-HOST-${string}-UNSUPPORTED`;
+    readonly reason: string;
+    readonly fix: string;
+} | {
+    readonly state: 'incompatible';
+    readonly id: string;
+    readonly platforms: readonly string[];
+    readonly found: ContractVersion;
+    readonly supported: ContractVersion;
+    readonly fix: string;
+} | {
+    readonly state: 'invalid';
+    readonly ref: string;
+    readonly problems: readonly string[];
+};
+/**
+ * Loads, validates, version-checks, and host-gates drivers (ADR-0002 D3/D4).
+ * Check order per driver: brand → manifest shape → contract compatibility →
+ * host requirements. Every failure is a status with remediation, surfaced via
+ * events and `kraken doctor` — never a bare stack trace.
+ */
+export declare class DriverRegistry {
+    #private;
+    private constructor();
+    static create(options: {
+        registrations: readonly DriverRegistration[];
+        host: HostInfo;
+        events?: EventSink;
+        /** Required for string-form registrations (resolution anchor — pnpm-safe). */
+        projectRoot?: string;
+    }): Promise<DriverRegistry>;
+    statuses(): readonly DriverStatus[];
+    readyDrivers(): readonly KrakenDriver[];
+    /**
+     * Fails FAST and explicitly (constraint C4b): binding an actor to a
+     * host-disabled platform is an error before any session boots.
+     */
+    driverFor(platform: string): KrakenDriver;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,cAAc,EACnB,KAAK,QAAQ,EAGb,KAAK,YAAY,EAElB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,mFAAmF;AACnF,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,MAAM,GACN,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AAEtD,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAC1D;IACE,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,MAAM,cAAc,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,GACD;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AA6B9F;;;;;GAKG;AACH,qBAAa,cAAc;;IAIzB,OAAO;WAEM,MAAM,CAAC,OAAO,EAAE;QAC3B,aAAa,EAAE,SAAS,kBAAkB,EAAE,CAAC;QAC7C,IAAI,EAAE,QAAQ,CAAC;QACf,MAAM,CAAC,EAAE,SAAS,CAAC;QACnB,8EAA8E;QAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,cAAc,CAAC;IAyL3B,QAAQ,IAAI,SAAS,YAAY,EAAE;IAInC,YAAY,IAAI,SAAS,YAAY,EAAE;IAIvC;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;CAoC1C"}

package/dist/registry.js

@@ -0,0 +1,244 @@
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { CONTRACT_VERSION, checkHostRequirements, isContractCompatible, isKrakenDriver, KrakenError, } from '@kraken-e2e/contracts';
+function manifestProblems(manifest) {
+    const problems = [];
+    if (typeof manifest !== 'object' || manifest === null) {
+        return ['manifest is not an object'];
+    }
+    const m = manifest;
+    if (m.kind !== 'kraken-driver')
+        problems.push(`manifest.kind must be 'kraken-driver'`);
+    if (typeof m.id !== 'string' || m.id.length === 0)
+        problems.push('manifest.id must be a non-empty string');
+    if (!Array.isArray(m.platforms) || m.platforms.length === 0)
+        problems.push('manifest.platforms must be a non-empty array');
+    if (typeof m.version !== 'string')
+        problems.push('manifest.version must be a string');
+    if (typeof m.platformLabel !== 'string')
+        problems.push('manifest.platformLabel must be a string');
+    const contract = m.contract;
+    if (typeof contract !== 'object' ||
+        contract === null ||
+        typeof contract.major !== 'number' ||
+        typeof contract.minor !== 'number') {
+        problems.push('manifest.contract must be { major, minor } (use defineDriver — never hand-write it)');
+    }
+    return problems;
+}
+/**
+ * Loads, validates, version-checks, and host-gates drivers (ADR-0002 D3/D4).
+ * Check order per driver: brand → manifest shape → contract compatibility →
+ * host requirements. Every failure is a status with remediation, surfaced via
+ * events and `kraken doctor` — never a bare stack trace.
+ */
+export class DriverRegistry {
+    #statuses = [];
+    #byPlatform = new Map();
+    constructor() { }
+    static async create(options) {
+        const registry = new DriverRegistry();
+        for (const registration of options.registrations) {
+            const status = await registry.#load(registration, options);
+            registry.#statuses.push(status);
+            registry.#index(status);
+            registry.#announce(status, options.events);
+        }
+        return registry;
+    }
+    async #load(registration, options) {
+        if (typeof registration === 'string' || Array.isArray(registration)) {
+            const [packageName, driverOptions] = typeof registration === 'string'
+                ? [registration, undefined]
+                : registration;
+            return this.#loadFromPackage(packageName, driverOptions, options);
+        }
+        return this.#validate(registration, options.host, '(value registration)');
+    }
+    /**
+     * String form: import `<pkg>/manifest` (zero heavy imports) and host-gate
+     * BEFORE importing the main entry (ADR-0001 §5.5) — importing driver-ios on
+     * Linux must never crash on missing native deps before a friendly error.
+     */
+    async #loadFromPackage(packageName, driverOptions, options) {
+        if (!options.projectRoot) {
+            return {
+                state: 'invalid',
+                ref: packageName,
+                problems: [
+                    'string-form driver registration requires a projectRoot to resolve from ' +
+                        '(pass registered driver VALUES instead, or provide projectRoot)',
+                ],
+            };
+        }
+        const resolve = createRequire(join(options.projectRoot, 'package.json')).resolve;
+        let manifest;
+        try {
+            const manifestPath = resolve(`${packageName}/manifest`);
+            const manifestModule = (await import(pathToFileURL(manifestPath).href));
+            const candidate = manifestModule.default ?? manifestModule.manifest;
+            if (!candidate) {
+                return {
+                    state: 'invalid',
+                    ref: packageName,
+                    problems: [`${packageName}/manifest has no default (or named 'manifest') export`],
+                };
+            }
+            manifest = candidate;
+        }
+        catch (cause) {
+            return {
+                state: 'invalid',
+                ref: packageName,
+                problems: [
+                    `could not resolve ${packageName}/manifest from ${options.projectRoot}: ` +
+                        `${cause instanceof Error ? cause.message : String(cause)}`,
+                    `Is the driver installed? Try: kraken plugins install ${packageName}`,
+                ],
+            };
+        }
+        const problems = manifestProblems(manifest);
+        if (problems.length > 0)
+            return { state: 'invalid', ref: packageName, problems };
+        const gate = checkHostRequirements(manifest.hostRequirements, options.host);
+        if (!gate.ok)
+            return this.#disabled(manifest, gate.reason, gate.fix);
+        // Host OK — now (and only now) import the real entry and build the driver.
+        try {
+            const entryPath = resolve(packageName);
+            const entryModule = (await import(pathToFileURL(entryPath).href));
+            if (typeof entryModule.default !== 'function') {
+                return {
+                    state: 'invalid',
+                    ref: packageName,
+                    problems: [`${packageName} default export is not a defineDriver() factory`],
+                };
+            }
+            return this.#validate(entryModule.default(driverOptions), options.host, packageName);
+        }
+        catch (cause) {
+            return {
+                state: 'invalid',
+                ref: packageName,
+                problems: [
+                    `failed to load ${packageName}: ${cause instanceof Error ? cause.message : String(cause)}`,
+                ],
+            };
+        }
+    }
+    #validate(candidate, host, ref) {
+        if (!isKrakenDriver(candidate)) {
+            return {
+                state: 'invalid',
+                ref,
+                problems: [
+                    'value is not a Kraken driver (missing brand). Drivers must be created with ' +
+                        "defineDriver() from '@kraken-e2e/contracts'.",
+                ],
+            };
+        }
+        const problems = manifestProblems(candidate.manifest);
+        if (problems.length > 0)
+            return { state: 'invalid', ref, problems };
+        const manifest = candidate.manifest;
+        if (!isContractCompatible(manifest.contract, CONTRACT_VERSION)) {
+            return {
+                state: 'incompatible',
+                id: manifest.id,
+                platforms: manifest.platforms,
+                found: manifest.contract,
+                supported: CONTRACT_VERSION,
+                fix: manifest.contract.major === CONTRACT_VERSION.major
+                    ? `The driver was built against contract ${manifest.contract.major}.${manifest.contract.minor}, newer than this core supports (${CONTRACT_VERSION.major}.${CONTRACT_VERSION.minor}). Upgrade @kraken-e2e/core.`
+                    : `Contract majors differ (driver ${manifest.contract.major}.x vs core ${CONTRACT_VERSION.major}.x). Align the driver and @kraken-e2e/core major versions.`,
+            };
+        }
+        const gate = checkHostRequirements(manifest.hostRequirements, host);
+        if (!gate.ok)
+            return this.#disabled(manifest, gate.reason, gate.fix);
+        return { state: 'ready', driver: candidate };
+    }
+    #disabled(manifest, reason, fallbackFix) {
+        return {
+            state: 'unavailable-on-host',
+            manifest,
+            code: `KRK-HOST-${manifest.id.toUpperCase()}-UNSUPPORTED`,
+            reason: `${manifest.platformLabel} ${reason}`,
+            fix: manifest.disabledFix ?? fallbackFix,
+        };
+    }
+    #index(status) {
+        const platforms = status.state === 'ready'
+            ? status.driver.manifest.platforms
+            : status.state === 'unavailable-on-host'
+                ? status.manifest.platforms
+                : status.state === 'incompatible'
+                    ? status.platforms
+                    : [];
+        for (const platform of platforms) {
+            if (!this.#byPlatform.has(platform))
+                this.#byPlatform.set(platform, status);
+        }
+    }
+    #announce(status, events) {
+        if (!events)
+            return;
+        if (status.state === 'ready') {
+            events.emit({
+                type: 'driverRegistered',
+                driverId: status.driver.manifest.id,
+                version: status.driver.manifest.version,
+                platforms: status.driver.manifest.platforms,
+            });
+        }
+        else if (status.state === 'unavailable-on-host') {
+            events.emit({
+                type: 'driverDisabled',
+                driverId: status.manifest.id,
+                code: status.code,
+                reason: status.reason,
+                fix: status.fix,
+            });
+        }
+    }
+    statuses() {
+        return this.#statuses;
+    }
+    readyDrivers() {
+        return this.#statuses.flatMap((status) => (status.state === 'ready' ? [status.driver] : []));
+    }
+    /**
+     * Fails FAST and explicitly (constraint C4b): binding an actor to a
+     * host-disabled platform is an error before any session boots.
+     */
+    driverFor(platform) {
+        const status = this.#byPlatform.get(platform);
+        if (!status) {
+            const known = [...this.#byPlatform.keys()];
+            throw new KrakenError('KRK-DRIVER-UNKNOWN-PLATFORM', `No registered driver provides platform "${platform}".` +
+                (known.length > 0
+                    ? ` Known platforms: ${known.join(', ')}.`
+                    : ' No drivers are registered.'), { fix: 'Register the driver in kraken.config.ts (drivers: [...]).' });
+        }
+        if (status.state === 'unavailable-on-host') {
+            throw new KrakenError(status.code, status.reason, {
+                fix: status.fix,
+                data: { driverId: status.manifest.id, platform },
+            });
+        }
+        if (status.state === 'incompatible') {
+            throw new KrakenError('KRK-PLUGIN-INCOMPATIBLE', `Driver "${status.id}" was built against contract ` +
+                `${status.found.major}.${status.found.minor}; this core supports ` +
+                `${status.supported.major}.${status.supported.minor}.`, { fix: status.fix });
+        }
+        if (status.state === 'invalid') {
+            throw new KrakenError('KRK-PLUGIN-INVALID', `Driver "${status.ref}" failed validation.`, {
+                data: { problems: status.problems },
+                fix: status.problems.join(' | '),
+            });
+        }
+        return status.driver;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,60 @@
+import type { HostContext, Logger, Reporter } from '@kraken-e2e/contracts';
+import { type SignalBus } from '@kraken-e2e/signaling';
+import { EventBus } from './event-bus.js';
+import { type LogLine } from './logger.js';
+import type { DriverRegistry } from './registry.js';
+import { type ScenarioPlan } from './scheduler.js';
+export interface ScenarioResult {
+    readonly scenarioId: string;
+    readonly name: string;
+    readonly status: 'passed' | 'failed';
+    readonly durationMs: number;
+    readonly error?: unknown;
+}
+export interface RunnerDependencies {
+    readonly registry: DriverRegistry;
+    readonly signalBus: SignalBus;
+    readonly events: EventBus;
+    readonly hostContext: HostContext;
+    readonly artifactsDir: string;
+    readonly logger?: Logger;
+    readonly logSink?: (line: LogLine) => void;
+}
+/**
+ * Runs one scenario end to end (ADR-0002 D7): boot all actor sessions
+ * (allSettled + rollback — never leak a booted device), open the signal scope,
+ * execute the plan, capture artifacts from ALL actors on failure, and tear
+ * everything down in finally with timeout guards.
+ */
+export declare class ScenarioRunner {
+    #private;
+    private readonly deps;
+    constructor(deps: RunnerDependencies);
+    run(plan: ScenarioPlan): Promise<ScenarioResult>;
+}
+export interface RunOptions {
+    readonly plans: readonly ScenarioPlan[];
+    readonly registry: DriverRegistry;
+    readonly signalBus: SignalBus;
+    readonly hostContext: HostContext;
+    readonly reporters?: readonly Reporter[];
+    readonly artifactsDir?: string;
+    readonly runId?: string;
+    readonly logSink?: (line: LogLine) => void;
+    readonly onReporterError?: (reporterId: string, error: unknown) => void;
+}
+export interface RunResult {
+    readonly runId: string;
+    readonly status: 'passed' | 'failed';
+    readonly scenarios: readonly ScenarioResult[];
+}
+/**
+ * The run coordinator: starts each involved driver once, runs scenarios
+ * sequentially, stops drivers and flushes reporters in finally
+ * (ADR-0002 D7; Phase 1 runs scenarios serially — parallel scenario
+ * scheduling is a later concern).
+ */
+export declare function runScenarios(options: RunOptions): Promise<RunResult>;
+/** Boot-failure sessions and similar cleanup share this constant. */
+export declare const SESSION_DISPOSE_TIMEOUT_MS = 15000;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,WAAW,EAEX,MAAM,EACN,QAAQ,EACT,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAEL,KAAK,SAAS,EAMf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,QAAQ,EAAkB,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAgB,KAAK,OAAO,EAAgB,MAAM,aAAa,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AA0FnF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CAC5C;AAqDD;;;;;GAKG;AACH,qBAAa,cAAc;;IACb,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,kBAAkB;IAE/C,GAAG,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;CAuLvD;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACzE;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;CAC/C;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CA8E1E;AAED,qEAAqE;AACrE,eAAO,MAAM,0BAA0B,QAAqB,CAAC"}