@kraken-e2e/cli 0.1.0

package/dist/commands/doctor.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+export default class Doctor extends Command {
+    static description: string;
+    static examples: string[];
+    static enableJsonFlag: boolean;
+    static flags: {
+        cwd: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<unknown>;
+}
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAG7C,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,OAAO;IACzC,OAAgB,WAAW,SAC6E;IAExG,OAAgB,QAAQ,WAAmE;IAE3F,OAAgB,cAAc,UAAQ;IAEtC,OAAgB,KAAK;;MAEnB;IAEI,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;CAW9B"}

package/dist/commands/doctor.js

@@ -0,0 +1,24 @@
+import { renderDoctorText } from '@kraken-e2e/doctor';
+import { Command, Flags } from '@oclif/core';
+import { buildDoctorReport } from '../doctor-report.js';
+export default class Doctor extends Command {
+    static description = 'Diagnose the environment: host platform, toolchain, and per-driver readiness with actionable fixes.';
+    static examples = ['<%= config.bin %> doctor', '<%= config.bin %> doctor --json'];
+    static enableJsonFlag = true;
+    static flags = {
+        cwd: Flags.string({ description: 'project directory (defaults to the current one)' }),
+    };
+    async run() {
+        const { flags } = await this.parse(Doctor);
+        const report = await buildDoctorReport({
+            ...(flags.cwd !== undefined ? { cwd: flags.cwd } : {}),
+        });
+        if (!this.jsonEnabled()) {
+            this.log(renderDoctorText(report));
+            if (report.summary.fail > 0)
+                this.exit(1);
+        }
+        return report;
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,OAAO;IACzC,MAAM,CAAU,WAAW,GACzB,qGAAqG,CAAC;IAExG,MAAM,CAAU,QAAQ,GAAG,CAAC,0BAA0B,EAAE,iCAAiC,CAAC,CAAC;IAE3F,MAAM,CAAU,cAAc,GAAG,IAAI,CAAC;IAEtC,MAAM,CAAU,KAAK,GAAG;QACtB,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,iDAAiD,EAAE,CAAC;KACtF,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;YACrC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvD,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;YACnC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,7 @@
+import { Command } from '@oclif/core';
+export default class Init extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAItC,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,OAAO;IACvC,OAAgB,WAAW,SAC8D;IAEzF,OAAgB,QAAQ,WAA8B;IAEhD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAI3B"}

package/dist/commands/init.js

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+import { initProject } from '../init-project.js';
+export default class Init extends Command {
+    static description = 'Scaffold a Kraken test project (config, steps, features, VS Code Cucumber settings).';
+    static examples = ['<%= config.bin %> init'];
+    async run() {
+        const code = initProject({ cwd: process.cwd(), write: (line) => this.log(line) });
+        if (code !== 0)
+            this.exit(code);
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,OAAO;IACvC,MAAM,CAAU,WAAW,GACzB,sFAAsF,CAAC;IAEzF,MAAM,CAAU,QAAQ,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAEtD,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClF,IAAI,IAAI,KAAK,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC"}

package/dist/commands/plugins/install.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class PluginsInstall extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        package: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'skip-install': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=install.d.ts.map

package/dist/commands/plugins/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/commands/plugins/install.ts"],"names":[],"mappings":"AACA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAGnD,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;IACjD,OAAgB,WAAW,SAC+E;IAE1G,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;MAInB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAU3B"}

package/dist/commands/plugins/install.js

@@ -0,0 +1,30 @@
+import { systemHostProbe } from '@kraken-e2e/core';
+import { Args, Command, Flags } from '@oclif/core';
+import { installPlugin } from '../../plugins-install.js';
+export default class PluginsInstall extends Command {
+    static description = 'Install a Kraken driver as an exact-pinned project devDependency and register it in kraken.config.ts.';
+    static examples = [
+        '<%= config.bin %> plugins install @kraken-e2e/driver-ios',
+        '<%= config.bin %> plugins:install @kraken-e2e/driver-android',
+    ];
+    static args = {
+        package: Args.string({ description: 'driver package name', required: true }),
+    };
+    static flags = {
+        'skip-install': Flags.boolean({
+            description: 'validate and register an already-installed package only',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(PluginsInstall);
+        const result = await installPlugin({
+            packageName: args.package,
+            skipInstall: flags['skip-install'],
+            host: systemHostProbe.detect(),
+            write: (line) => this.log(line),
+        });
+        if (result.exitCode !== 0)
+            this.exit(result.exitCode);
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/plugins/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/commands/plugins/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;IACjD,MAAM,CAAU,WAAW,GACzB,uGAAuG,CAAC;IAE1G,MAAM,CAAU,QAAQ,GAAG;QACzB,0DAA0D;QAC1D,8DAA8D;KAC/D,CAAC;IAEF,MAAM,CAAU,IAAI,GAAG;QACrB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,qBAAqB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;KAC7E,CAAC;IAEF,MAAM,CAAU,KAAK,GAAG;QACtB,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC;YAC5B,WAAW,EAAE,yDAAyD;SACvE,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;YACjC,WAAW,EAAE,IAAI,CAAC,OAAO;YACzB,WAAW,EAAE,KAAK,CAAC,cAAc,CAAC;YAClC,IAAI,EAAE,eAAe,CAAC,MAAM,EAAE;YAC9B,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;SAChC,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxD,CAAC"}

package/dist/commands/run.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class Run extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        tags: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        plain: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAI7C,MAAM,CAAC,OAAO,OAAO,GAAI,SAAQ,OAAO;IACtC,OAAgB,WAAW,SAC6D;IAExF,OAAgB,QAAQ,WAItB;IAEF,OAAgB,KAAK;;;;;MASnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAiB3B"}

package/dist/commands/run.js

@@ -0,0 +1,38 @@
+import { Command, Flags } from '@oclif/core';
+import { runProject } from '../run-project.js';
+export default class Run extends Command {
+    static description = 'Compile the feature files (dry-run analysis) and execute the multi-actor scenarios.';
+    static examples = [
+        '<%= config.bin %> run',
+        '<%= config.bin %> run --dry-run',
+        '<%= config.bin %> run --tags "@smoke and not @wip"',
+    ];
+    static flags = {
+        config: Flags.string({ char: 'c', description: 'path to kraken.config.ts' }),
+        tags: Flags.string({ char: 't', description: 'tag expression, e.g. "@smoke and not @wip"' }),
+        'dry-run': Flags.boolean({
+            description: 'compile and statically analyze only — boot no sessions',
+        }),
+        plain: Flags.boolean({
+            description: 'force the plain line renderer (no live Ink UI)',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Run);
+        const result = await runProject({
+            ...(flags.config !== undefined ? { configPath: flags.config } : {}),
+            ...(flags.tags !== undefined ? { tags: flags.tags } : {}),
+            dryRun: flags['dry-run'],
+            plain: flags.plain,
+            write: (line) => this.log(line),
+        });
+        // ALWAYS exit explicitly: embedded Appium/WDIO leave keep-alive handles
+        // that keep the event loop from draining after a successful run
+        // (observed live: `kraken run` hung post-runFinished — ADR-0005).
+        // Drain piped stdout first: process.exit does not wait for pending writes
+        // (the CI `kraken run | tee` case would truncate the failure summary).
+        await new Promise((resolve) => process.stdout.write('', () => resolve()));
+        this.exit(result.exitCode);
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,CAAC,OAAO,OAAO,GAAI,SAAQ,OAAO;IACtC,MAAM,CAAU,WAAW,GACzB,qFAAqF,CAAC;IAExF,MAAM,CAAU,QAAQ,GAAG;QACzB,uBAAuB;QACvB,iCAAiC;QACjC,oDAAoD;KACrD,CAAC;IAEF,MAAM,CAAU,KAAK,GAAG;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAAC;QAC5E,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,4CAA4C,EAAE,CAAC;QAC5F,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;YACvB,WAAW,EAAE,wDAAwD;SACtE,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,WAAW,EAAE,gDAAgD;SAC9D,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;YAC9B,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;SAChC,CAAC,CAAC;QACH,wEAAwE;QACxE,gEAAgE;QAChE,kEAAkE;QAClE,0EAA0E;QAC1E,uEAAuE;QACvE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAChF,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC"}

package/dist/commands/serve.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+export default class Serve extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        port: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        host: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=serve.d.ts.map

package/dist/commands/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAI7C,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;IACxC,OAAgB,WAAW,SACuE;IAElG,OAAgB,QAAQ,WAAsE;IAE9F,OAAgB,KAAK;;;MAGnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAkB3B"}

package/dist/commands/serve.js

@@ -0,0 +1,31 @@
+import { join } from 'node:path';
+import { findConfigPath } from '@kraken-e2e/config';
+import { Command, Flags } from '@oclif/core';
+import { startServe } from '../serve.js';
+export default class Serve extends Command {
+    static description = 'Serve run results (event streams + artifacts) over HTTP/WebSocket — the GUI-ready projection.';
+    static examples = ['<%= config.bin %> serve', '<%= config.bin %> serve --port 4000'];
+    static flags = {
+        port: Flags.integer({ description: 'port (default: OS-assigned)', default: 0 }),
+        host: Flags.string({ description: 'bind host', default: '127.0.0.1' }),
+    };
+    async run() {
+        const { flags } = await this.parse(Serve);
+        const configPath = findConfigPath(process.cwd());
+        const projectRoot = configPath ? join(configPath, '..') : process.cwd();
+        const handle = await startServe({
+            runsDir: join(projectRoot, '.kraken', 'runs'),
+            port: flags.port,
+            host: flags.host,
+            log: (line) => this.log(line),
+        });
+        this.log(`Viewer: ${handle.url} — Ctrl-C to stop.`);
+        // Serve runs until interrupted; the CLI owns SIGINT (ADR-0005).
+        await new Promise((resolve) => {
+            process.once('SIGINT', () => {
+                void handle.close().then(resolve);
+            });
+        });
+    }
+}
+//# sourceMappingURL=serve.js.map

package/dist/commands/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;IACxC,MAAM,CAAU,WAAW,GACzB,+FAA+F,CAAC;IAElG,MAAM,CAAU,QAAQ,GAAG,CAAC,yBAAyB,EAAE,qCAAqC,CAAC,CAAC;IAE9F,MAAM,CAAU,KAAK,GAAG;QACtB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,6BAA6B,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAC/E,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;KACvE,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACxE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;YAC9B,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC;YAC7C,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;SAC9B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,GAAG,oBAAoB,CAAC,CAAC;QACpD,gEAAgE;QAChE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE;gBAC1B,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC"}

package/dist/doctor-report.d.ts

@@ -0,0 +1,5 @@
+import { type DoctorReport } from '@kraken-e2e/doctor';
+export declare function buildDoctorReport(options: {
+    cwd?: string;
+}): Promise<DoctorReport>;
+//# sourceMappingURL=doctor-report.d.ts.map

package/dist/doctor-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-report.d.ts","sourceRoot":"","sources":["../src/doctor-report.ts"],"names":[],"mappings":"AAcA,OAAO,EAEL,KAAK,YAAY,EAIlB,MAAM,oBAAoB,CAAC;AAyB5B,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAqBxF"}

package/dist/doctor-report.js

@@ -0,0 +1,54 @@
+/**
+ * The `kraken doctor` pipeline (ADR-0001 §5.13 composition): the CLI — the
+ * composition layer — injects HostContext (from core's probe), driver gate
+ * statuses (from core's registry), and driver-contributed checks into the
+ * pure @kraken-e2e/doctor engine.
+ */
+import { loadConfig } from '@kraken-e2e/config';
+import { createHostContext, DriverRegistry, systemHostProbe, } from '@kraken-e2e/core';
+import { builtInChecks, driverGateChecks, runDoctor, } from '@kraken-e2e/doctor';
+function toGateStatus(status) {
+    switch (status.state) {
+        case 'ready':
+            return { driverId: status.driver.manifest.id, state: 'ready' };
+        case 'unavailable-on-host':
+            return {
+                driverId: status.manifest.id,
+                state: 'unavailable-on-host',
+                detail: status.reason,
+                fix: status.fix,
+            };
+        case 'incompatible':
+            return {
+                driverId: status.id,
+                state: 'incompatible',
+                detail: `built against contract ${status.found.major}.${status.found.minor}, host supports ${status.supported.major}.${status.supported.minor}`,
+                fix: status.fix,
+            };
+        case 'invalid':
+            return { driverId: status.ref, state: 'invalid', detail: status.problems.join('; ') };
+    }
+}
+export async function buildDoctorReport(options) {
+    const host = systemHostProbe.detect();
+    const checks = [...builtInChecks()];
+    // Config is optional for doctor: without a project we still report the host.
+    try {
+        const config = await loadConfig({ ...(options.cwd !== undefined ? { cwd: options.cwd } : {}) });
+        const registry = await DriverRegistry.create({
+            registrations: config.drivers,
+            host,
+            projectRoot: config.projectRoot,
+        });
+        checks.push(...driverGateChecks(registry.statuses().map(toGateStatus)));
+        for (const driver of registry.readyDrivers()) {
+            checks.push(...(driver.doctor ?? []));
+        }
+        return runDoctor({ host: createHostContext(host, config.projectRoot), checks });
+    }
+    catch {
+        // No project found — run the host-level checks only.
+        return runDoctor({ host: createHostContext(host), checks });
+    }
+}
+//# sourceMappingURL=doctor-report.js.map

package/dist/doctor-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-report.js","sourceRoot":"","sources":["../src/doctor-report.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EACL,iBAAiB,EAEjB,cAAc,EAEd,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EAGb,gBAAgB,EAChB,SAAS,GACV,MAAM,oBAAoB,CAAC;AAE5B,SAAS,YAAY,CAAC,MAAoB;IACxC,QAAQ,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,KAAK,OAAO;YACV,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QACjE,KAAK,qBAAqB;YACxB,OAAO;gBACL,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;gBAC5B,KAAK,EAAE,qBAAqB;gBAC5B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,GAAG,EAAE,MAAM,CAAC,GAAG;aAChB,CAAC;QACJ,KAAK,cAAc;YACjB,OAAO;gBACL,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,KAAK,EAAE,cAAc;gBACrB,MAAM,EAAE,0BAA0B,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,mBAAmB,MAAM,CAAC,SAAS,CAAC,KAAK,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE;gBAC/I,GAAG,EAAE,MAAM,CAAC,GAAG;aAChB,CAAC;QACJ,KAAK,SAAS;YACZ,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAC1F,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAyB;IAC/D,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,CAAC,GAAG,aAAa,EAAE,CAAC,CAAC;IAEpC,6EAA6E;IAC7E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAChG,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC;YAC3C,aAAa,EAAE,MAAM,CAAC,OAAwC;YAC9D,IAAI;YACJ,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACxE,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,SAAS,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAClF,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;QACrD,OAAO,SAAS,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @kraken-e2e/cli — the `kraken` command (ADR-0001 §5.11). oclif v4, ESM,
+ * topicSeparator ' ' (colons remain aliases). Phase 1 ships `run` and
+ * `doctor` with the plain LineReporter; the Ink live UI and the
+ * Kraken-owned `plugins` topic arrive in Phase 2 (ADR-0001 §5.10/D15).
+ */
+export { buildDoctorReport } from './doctor-report.js';
+export { type RunProjectOptions, type RunProjectResult, runProject } from './run-project.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;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @kraken-e2e/cli — the `kraken` command (ADR-0001 §5.11). oclif v4, ESM,
+ * topicSeparator ' ' (colons remain aliases). Phase 1 ships `run` and
+ * `doctor` with the plain LineReporter; the Ink live UI and the
+ * Kraken-owned `plugins` topic arrive in Phase 2 (ADR-0001 §5.10/D15).
+ */
+export { buildDoctorReport } from './doctor-report.js';
+export { runProject } from './run-project.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;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAiD,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/init-project.d.ts

@@ -0,0 +1,9 @@
+export declare const VSCODE_PARAMETER_TYPES: {
+    name: string;
+    regexp: string;
+}[];
+export declare function initProject(options: {
+    readonly cwd: string;
+    readonly write: (line: string) => void;
+}): number;
+//# sourceMappingURL=init-project.d.ts.map

package/dist/init-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-project.d.ts","sourceRoot":"","sources":["../src/init-project.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,sBAAsB;;;GAGlC,CAAC;AAkDF,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC,GAAG,MAAM,CAiBT"}

package/dist/init-project.js

@@ -0,0 +1,77 @@
+/**
+ * `kraken init` scaffolding (ADR-0005): a runnable project skeleton plus the
+ * .vscode Cucumber settings that make {actor}/{duration} autocomplete work
+ * (the extension cannot see parameter types inside node_modules —
+ * ADR-0004 Appendix B). Never overwrites existing files.
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+// Kept byte-identical to @kraken-e2e/gherkin's ACTOR_REGEXP/DURATION_REGEXP
+// sources (ADR-0004 Appendix B) — the runtime matcher and the editor must
+// agree. There is a test pinning this.
+export const VSCODE_PARAMETER_TYPES = [
+    { name: 'actor', regexp: '[a-zA-Z][a-zA-Z0-9_-]*|"[^"]+"' },
+    { name: 'duration', regexp: '\\d+(?:\\.\\d+)?(?:ms|s|m)' },
+];
+const FILES = {
+    'kraken.config.ts': `import { defineConfig } from '@kraken-e2e/config';
+
+export default defineConfig({
+  actors: {
+    // The CLOSED actor set: steps naming anyone else are compile errors.
+    alice: { platform: 'android' },
+    bob: { platform: 'ios' },
+  },
+  drivers: [
+    // Install drivers with: kraken plugins install @kraken-e2e/driver-android
+  ],
+  features: 'features/**/*.feature',
+  steps: './steps/index.ts',
+});
+`,
+    'steps/index.ts': `import { createStepRegistry } from '@kraken-e2e/gherkin';
+
+// Destructure — bare Given/When/Then call sites are what the Cucumber VS Code
+// extension indexes (namespaced calls lose autocomplete).
+export const { Given, When, Then, defineParameterType, registry } = createStepRegistry();
+
+// Your app-domain steps live here. Example:
+// When('{actor} sends the message {string}', async ({ actor }, ...args) => {
+//   const [message] = args as unknown as [string];
+//   await actor.session.typeText({ by: 'testId', value: 'composer' }, message);
+//   await actor.session.tap({ by: 'testId', value: 'send' });
+// });
+`,
+    'features/example.feature': `Feature: My first choreography
+  Steps run in text order (the screenplay); signals and background tasks are
+  the escape hatches. See the Kraken docs for the built-in vocabulary.
+
+  Scenario: two users, one story
+    # When alice sends the message "hola"
+    # Then bob waits for the signal "message-sent" within 10s
+`,
+    '.vscode/settings.json': `${JSON.stringify({
+        'cucumber.features': ['features/**/*.feature'],
+        'cucumber.glue': ['steps/**/*.ts'],
+        'cucumber.parameterTypes': VSCODE_PARAMETER_TYPES,
+    }, null, 2)}\n`,
+};
+export function initProject(options) {
+    for (const [relative, content] of Object.entries(FILES)) {
+        const path = join(options.cwd, relative);
+        if (existsSync(path)) {
+            options.write(`skip (exists): ${relative}`);
+            continue;
+        }
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, content);
+        options.write(`created: ${relative}`);
+    }
+    options.write('\nNext steps:');
+    options.write('  1. kraken plugins install @kraken-e2e/driver-android   (and/or -ios, -web)');
+    options.write('  2. write steps in steps/index.ts and scenarios in features/');
+    options.write('  3. kraken doctor    (verify your environment)');
+    options.write('  4. kraken run');
+    return 0;
+}
+//# sourceMappingURL=init-project.js.map

package/dist/init-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-project.js","sourceRoot":"","sources":["../src/init-project.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,4EAA4E;AAC5E,0EAA0E;AAC1E,uCAAuC;AACvC,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,gCAAgC,EAAE;IAC3D,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,4BAA4B,EAAE;CAC3D,CAAC;AAEF,MAAM,KAAK,GAA2B;IACpC,kBAAkB,EAAE;;;;;;;;;;;;;;CAcrB;IACC,gBAAgB,EAAE;;;;;;;;;;;;CAYnB;IACC,0BAA0B,EAAE;;;;;;;CAO7B;IACC,uBAAuB,EAAE,GAAG,IAAI,CAAC,SAAS,CACxC;QACE,mBAAmB,EAAE,CAAC,uBAAuB,CAAC;QAC9C,eAAe,EAAE,CAAC,eAAe,CAAC;QAClC,yBAAyB,EAAE,sBAAsB;KAClD,EACD,IAAI,EACJ,CAAC,CACF,IAAI;CACN,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,OAG3B;IACC,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACzC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,kBAAkB,QAAQ,EAAE,CAAC,CAAC;YAC5C,SAAS;QACX,CAAC;QACD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,YAAY,QAAQ,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC/B,OAAO,CAAC,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAC9F,OAAO,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;IAC/E,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACjE,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACjC,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/plugins-install.d.ts

@@ -0,0 +1,17 @@
+import { type HostInfo } from '@kraken-e2e/contracts';
+export type PackageManager = 'pnpm' | 'npm' | 'yarn';
+export declare function detectPackageManager(projectRoot: string): PackageManager;
+export interface InstallPluginOptions {
+    readonly packageName: string;
+    readonly cwd?: string;
+    /** Validate+register only (tests; also useful after a manual install). */
+    readonly skipInstall?: boolean;
+    readonly host: HostInfo;
+    readonly write: (line: string) => void;
+}
+export interface InstallPluginResult {
+    readonly exitCode: number;
+    readonly registeredInConfig: boolean;
+}
+export declare function installPlugin(options: InstallPluginOptions): Promise<InstallPluginResult>;
+//# sourceMappingURL=plugins-install.d.ts.map

package/dist/plugins-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins-install.d.ts","sourceRoot":"","sources":["../src/plugins-install.ts"],"names":[],"mappings":"AAaA,OAAO,EAIL,KAAK,QAAQ,EAId,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAErD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAIxE;AAQD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;CACtC;AAID,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA4I/F"}

package/dist/plugins-install.js

@@ -0,0 +1,148 @@
+/**
+ * `kraken plugins install` (ADR-0001 §5.10/D15, ADR-0005): Kraken OWNS the
+ * plugins topic. Drivers are exact-pinned project devDependencies — installed
+ * by the project's own package manager, validated against the contract, and
+ * registered in kraken.config.ts. @oclif/plugin-plugins is deliberately not
+ * used (per-user dataDir state outside the lockfile).
+ */
+import { spawnSync } from 'node:child_process';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { findConfigPath } from '@kraken-e2e/config';
+import { CONTRACT_VERSION, checkHostRequirements, isContractCompatible, isKrakenDriver, KrakenError, } from '@kraken-e2e/contracts';
+export function detectPackageManager(projectRoot) {
+    if (existsSync(join(projectRoot, 'pnpm-lock.yaml')))
+        return 'pnpm';
+    if (existsSync(join(projectRoot, 'yarn.lock')))
+        return 'yarn';
+    return 'npm';
+}
+const INSTALL_ARGS = {
+    pnpm: ['add', '-D', '-E'],
+    npm: ['install', '--save-dev', '--save-exact'],
+    yarn: ['add', '--dev', '--exact'],
+};
+const NPM_NAME_GRAMMAR = /^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/;
+export async function installPlugin(options) {
+    const { packageName, write } = options;
+    const cwd = options.cwd ?? process.cwd();
+    // Never forward untrusted strings to a package manager: a name starting
+    // with '-' would be parsed as a FLAG (registry override, script injection).
+    if (!NPM_NAME_GRAMMAR.test(packageName)) {
+        write(`✗ "${packageName}" is not a valid npm package name.`);
+        return { exitCode: 1, registeredInConfig: false };
+    }
+    // 1 — Locate the project (never a silent global install — ADR-0001 §5.10).
+    const configPath = findConfigPath(cwd);
+    const projectRoot = configPath
+        ? join(configPath, '..')
+        : existsSync(join(cwd, 'package.json'))
+            ? cwd
+            : undefined;
+    if (!projectRoot) {
+        write('✗ No Kraken project found (no kraken.config.* upwards, no package.json here).');
+        write('  fix: run inside your test project, or create one with: kraken init');
+        return { exitCode: 1, registeredInConfig: false };
+    }
+    // 2 — Install through the project's OWN package manager (lockfile-governed).
+    if (options.skipInstall !== true) {
+        const pm = detectPackageManager(projectRoot);
+        write(`Installing ${packageName} with ${pm} (exact-pinned devDependency)…`);
+        const result = spawnSync(pm, [...INSTALL_ARGS[pm], packageName], {
+            cwd: projectRoot,
+            stdio: 'inherit',
+            // Windows package managers are .cmd shims — they need a shell there.
+            shell: process.platform === 'win32',
+        });
+        if (result.error) {
+            write(`✗ could not launch ${pm}: ${result.error.message}`);
+            return { exitCode: 1, registeredInConfig: false };
+        }
+        if (result.status !== 0) {
+            write(`✗ ${pm} exited with ${result.status ?? 'a signal'} — nothing was registered.`);
+            return { exitCode: 1, registeredInConfig: false };
+        }
+    }
+    // 3 — Pre-gate via /manifest FIRST (ADR-0001 §5.5, same rule as the
+    //     registry): on an unsupported host the MAIN ENTRY is never imported —
+    //     it may legitimately fail to load there.
+    const resolve = createRequire(join(projectRoot, 'package.json')).resolve;
+    let manifest;
+    try {
+        const manifestModule = (await import(pathToFileURL(resolve(`${packageName}/manifest`)).href));
+        const candidate = manifestModule.default ?? manifestModule.manifest;
+        if (!candidate)
+            throw new Error('no default (or named `manifest`) export');
+        manifest = candidate;
+    }
+    catch (cause) {
+        write(`✗ ${packageName}/manifest could not be loaded: ${cause instanceof Error ? cause.message : String(cause)}`);
+        write('  Kraken drivers must ship a /manifest subpath (ADR-0001 §5.5).');
+        return { exitCode: 1, registeredInConfig: false };
+    }
+    if (!isContractCompatible(manifest.contract, CONTRACT_VERSION)) {
+        write(`✗ ${packageName} was built against contract ` +
+            `${manifest.contract.major}.${manifest.contract.minor}; this Kraken supports ` +
+            `${CONTRACT_VERSION.major}.${CONTRACT_VERSION.minor}. Align the versions.`);
+        return { exitCode: 1, registeredInConfig: false };
+    }
+    // 4 — ADVISORY host gate (install is cross-platform; load/run is what gates).
+    const gate = checkHostRequirements(manifest.hostRequirements, options.host);
+    if (!gate.ok) {
+        write(`! ${manifest.platformLabel} is DISABLED on this host: ${gate.reason}.`);
+        write('  Installed and lockfile-pinned anyway (your teammates on supported hosts get it).');
+    }
+    else {
+        // Host is fine — the full brand validation can import the entry safely.
+        try {
+            const entry = (await import(pathToFileURL(resolve(packageName)).href));
+            if (typeof entry.default !== 'function' || !isKrakenDriver(entry.default())) {
+                throw new KrakenError('KRK-PLUGIN-INVALID', `${packageName}'s default export is not a defineDriver() factory.`);
+            }
+        }
+        catch (cause) {
+            write(`✗ ${packageName} could not be validated: ${cause instanceof Error ? cause.message : String(cause)}`);
+            write('  The package stays installed; fix it or remove it with your package manager.');
+            return { exitCode: 1, registeredInConfig: false };
+        }
+    }
+    // 5 — Config registration: append the string form when mechanically safe,
+    //     otherwise print the exact lines (never rewrite user code blindly).
+    let registered = false;
+    if (configPath) {
+        const source = readFileSync(configPath, 'utf8');
+        if (source.includes(`'${packageName}'`) || source.includes(`"${packageName}"`)) {
+            write(`✓ ${packageName} is already registered in ${configPath}.`);
+            registered = true;
+        }
+        else {
+            // Comment-aware: only append at a drivers:[ marker on a NON-comment line
+            // (a commented-out example above the real array must not swallow it).
+            const lines = source.split('\n');
+            const markerLine = lines.findIndex((line) => {
+                const match = /\bdrivers\s*:\s*\[/.exec(line);
+                return match !== null && !line.slice(0, match.index).includes('//');
+            });
+            if (markerLine !== -1) {
+                lines[markerLine] = lines[markerLine].replace(/(\bdrivers\s*:\s*\[)/, `$1\n    '${packageName}',`);
+                writeFileSync(configPath, lines.join('\n'));
+                write(`✓ registered '${packageName}' in ${configPath}.`);
+                registered = true;
+            }
+            else {
+                write(`Add it to your config's drivers array:\n    drivers: ['${packageName}', …],`);
+            }
+        }
+    }
+    else {
+        write(`No kraken.config.ts found — create one (kraken init) and register:\n    drivers: ['${packageName}'],`);
+    }
+    // 6 — Epilogue.
+    for (const hint of manifest.setupHints ?? []) {
+        write(`  next: ${hint}`);
+    }
+    return { exitCode: 0, registeredInConfig: registered };
+}
+//# sourceMappingURL=plugins-install.js.map