@plumbus/core 0.1.0

package/dist/cli/commands/dev.js

@@ -0,0 +1,178 @@
+// ── plumbus dev ──
+// Development server command: starts API server + workers
+// with auto-reload awareness and dev-friendly defaults.
+import { PromptRegistry } from '../../ai/prompt-registry.js';
+import { loadConfig, validateConfig } from '../../config/loader.js';
+import { EntityRegistry } from '../../data/registry.js';
+import { ConsumerRegistry } from '../../events/consumer-registry.js';
+import { EventRegistry } from '../../events/registry.js';
+import { CapabilityRegistry } from '../../execution/capability-registry.js';
+import { FlowRegistry } from '../../flows/registry.js';
+import { createServer } from '../../server/bootstrap.js';
+import { discoverResources } from '../discover.js';
+import { info, error as logError, warn } from '../utils.js';
+/**
+ * Run the development server config validation (sync).
+ *
+ * This:
+ * 1. Loads config from env variables with dev defaults
+ * 2. Validates the config
+ * 3. Prints server info
+ *
+ * Returns config and validation result. Call startDevServer() to start the actual server.
+ */
+export function runDev(options) {
+    const config = loadConfig({ environment: 'development' });
+    const validation = validateConfig(config);
+    const port = parseInt(options.port ?? '3000', 10);
+    const host = options.host ?? 'localhost';
+    const serverUrl = `http://${host}:${port}`;
+    if (!options.json) {
+        info('Plumbus Development Server');
+        info(`Environment: ${config.environment}`);
+        info(`Server URL: ${serverUrl}`);
+        info(`Database: ${config.database.host}:${config.database.port}/${config.database.database}`);
+        info(`Queue: ${config.queue.host}:${config.queue.port}`);
+        if (config.ai) {
+            info(`AI Provider: ${config.ai.provider}`);
+        }
+        else {
+            warn('AI provider not configured (set AI_PROVIDER and AI_API_KEY)');
+        }
+        if (validation.errors.length > 0) {
+            logError('Config errors:');
+            for (const err of validation.errors) {
+                logError(`  - ${err}`);
+            }
+        }
+        if (validation.warnings.length > 0) {
+            for (const w of validation.warnings) {
+                warn(w);
+            }
+        }
+        if (validation.valid) {
+            info('Config valid — ready to start');
+        }
+    }
+    return { config, validation, serverUrl };
+}
+/**
+ * Start the actual development server (async).
+ * Discovers resources from app/, populates registries, connects to DB,
+ * and starts the Fastify server. Sets up graceful shutdown on SIGINT/SIGTERM.
+ */
+export async function startDevServer(options) {
+    const { config, validation, serverUrl } = runDev(options);
+    if (!validation.valid) {
+        throw new Error(`Config validation failed: ${validation.errors.join(', ')}`);
+    }
+    const port = parseInt(options.port ?? '3000', 10);
+    const host = options.host ?? '0.0.0.0';
+    // Auto-discover resources from app/ directory
+    info('Discovering resources from app/ ...');
+    const resources = await discoverResources();
+    info(`Found ${resources.capabilities.length} capabilities, ${resources.entities.length} entities, ` +
+        `${resources.flows.length} flows, ${resources.events.length} events, ${resources.prompts.length} prompts`);
+    // Populate registries
+    const capabilities = new CapabilityRegistry();
+    capabilities.registerAll(resources.capabilities);
+    const entities = new EntityRegistry();
+    entities.registerAll(resources.entities);
+    const events = new EventRegistry();
+    events.registerAll(resources.events);
+    const flows = new FlowRegistry();
+    flows.registerAll(resources.flows);
+    const consumers = new ConsumerRegistry();
+    const promptRegistry = new PromptRegistry();
+    for (const prompt of resources.prompts) {
+        promptRegistry.register(prompt);
+    }
+    // Connect to database (caller can override via options.db)
+    let db = options.db;
+    if (!db) {
+        try {
+            const { drizzle } = await import('drizzle-orm/postgres-js');
+            const postgres = (await import('postgres')).default;
+            const sql = postgres({
+                host: config.database.host,
+                port: config.database.port,
+                database: config.database.database,
+                username: config.database.user,
+                password: config.database.password,
+            });
+            db = drizzle(sql);
+            info('Database connected');
+        }
+        catch (err) {
+            throw new Error(`Database connection failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    const server = createServer({
+        config,
+        db: db,
+        capabilities,
+        entities,
+        events,
+        consumers,
+        flows,
+        promptRegistry,
+        host,
+        port,
+    });
+    // Graceful shutdown handler
+    let shuttingDown = false;
+    const shutdown = async () => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        info('Graceful shutdown initiated...');
+        await server.stop();
+        info('Server stopped');
+    };
+    const onSignal = () => {
+        void shutdown();
+    };
+    process.on('SIGINT', onSignal);
+    process.on('SIGTERM', onSignal);
+    // Start listening
+    const address = await server.start();
+    info(`Server listening on ${address}`);
+    info(`Health check: ${serverUrl}/health`);
+    info('Press Ctrl+C to stop');
+    return { server, shutdown };
+}
+export function registerDevCommand(program) {
+    program
+        .command('dev')
+        .description('Start development server with hot-reload')
+        .option('-p, --port <port>', 'Server port', '3000')
+        .option('-H, --host <host>', 'Server host', 'localhost')
+        .option('--json', 'Output JSON')
+        .action(async (opts) => {
+        const result = runDev(opts);
+        if (opts.json) {
+            console.log(JSON.stringify({
+                config: {
+                    environment: result.config.environment,
+                    database: `${result.config.database.host}:${result.config.database.port}/${result.config.database.database}`,
+                    queue: `${result.config.queue.host}:${result.config.queue.port}`,
+                    ai: result.config.ai?.provider ?? null,
+                },
+                validation: result.validation,
+                serverUrl: result.serverUrl,
+            }, null, 2));
+            return;
+        }
+        // Start the actual server if config is valid
+        if (result.validation.valid) {
+            try {
+                await startDevServer(opts);
+            }
+            catch (err) {
+                logError(`Failed to start server: ${err instanceof Error ? err.message : String(err)}`);
+                info('Ensure the database is running and config is correct.');
+            }
+        }
+    });
+}
+//# sourceMappingURL=dev.js.map

package/dist/cli/commands/dev.js.map

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

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

@@ -0,0 +1,31 @@
+import type { Command } from 'commander';
+export interface DoctorCheck {
+    name: string;
+    status: 'ok' | 'warn' | 'fail';
+    message: string;
+}
+export interface DoctorOptions {
+    json?: boolean;
+}
+/** Check Node.js version */
+export declare function checkNodeVersion(): DoctorCheck;
+/** Check TypeScript availability */
+export declare function checkTypeScript(): DoctorCheck;
+/** Check @plumbus/core availability */
+export declare function checkPlumbusCore(): DoctorCheck;
+/** Check config file exists */
+export declare function checkConfig(): DoctorCheck;
+/** Check app directory structure */
+export declare function checkAppStructure(): DoctorCheck;
+/** Check package.json exists */
+export declare function checkPackageJson(): DoctorCheck;
+/** Check PostgreSQL connectivity */
+export declare function checkPostgreSQL(): Promise<DoctorCheck>;
+/** Check Redis connectivity */
+export declare function checkRedis(): Promise<DoctorCheck>;
+/** Run all doctor checks (sync checks only) */
+export declare function runDoctorChecks(): DoctorCheck[];
+/** Run all doctor checks including async connectivity tests */
+export declare function runFullDoctorChecks(): Promise<DoctorCheck[]>;
+export declare function registerDoctorCommand(program: Command): void;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,4BAA4B;AAC5B,wBAAgB,gBAAgB,IAAI,WAAW,CAU9C;AAED,oCAAoC;AACpC,wBAAgB,eAAe,IAAI,WAAW,CAW7C;AAED,uCAAuC;AACvC,wBAAgB,gBAAgB,IAAI,WAAW,CAe9C;AAED,+BAA+B;AAC/B,wBAAgB,WAAW,IAAI,WAAW,CAMzC;AAED,oCAAoC;AACpC,wBAAgB,iBAAiB,IAAI,WAAW,CAkB/C;AAED,gCAAgC;AAChC,wBAAgB,gBAAgB,IAAI,WAAW,CAM9C;AAED,oCAAoC;AACpC,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC,CAkD5D;AAED,+BAA+B;AAC/B,wBAAsB,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC,CAyCvD;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,IAAI,WAAW,EAAE,CAS/C;AAED,+DAA+D;AAC/D,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAIlE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuC5D"}

package/dist/cli/commands/doctor.js

@@ -0,0 +1,233 @@
+// ── plumbus doctor ──
+// Check environment readiness
+import * as fs from 'node:fs';
+import { info, error as logError, resolvePath, success, warn } from '../utils.js';
+/** Check Node.js version */
+export function checkNodeVersion() {
+    const version = process.versions.node ?? '';
+    const major = parseInt(version.split('.')[0] ?? '0', 10);
+    if (major >= 20) {
+        return { name: 'node', status: 'ok', message: `Node.js v${version}` };
+    }
+    if (major >= 18) {
+        return { name: 'node', status: 'warn', message: `Node.js v${version} (v20+ recommended)` };
+    }
+    return { name: 'node', status: 'fail', message: `Node.js v${version} (v20+ required)` };
+}
+/** Check TypeScript availability */
+export function checkTypeScript() {
+    try {
+        const pkgPath = resolvePath('node_modules', 'typescript', 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+            return { name: 'typescript', status: 'ok', message: `TypeScript v${pkg.version}` };
+        }
+        return { name: 'typescript', status: 'fail', message: 'TypeScript not installed' };
+    }
+    catch {
+        return { name: 'typescript', status: 'fail', message: 'TypeScript not installed' };
+    }
+}
+/** Check @plumbus/core availability */
+export function checkPlumbusCore() {
+    try {
+        const pkgPath = resolvePath('node_modules', '@plumbus/core', 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+            return { name: '@plumbus/core', status: 'ok', message: `@plumbus/core v${pkg.version}` };
+        }
+        return {
+            name: '@plumbus/core',
+            status: 'warn',
+            message: '@plumbus/core not found in node_modules (may be workspace root)',
+        };
+    }
+    catch {
+        return { name: '@plumbus/core', status: 'warn', message: '@plumbus/core not accessible' };
+    }
+}
+/** Check config file exists */
+export function checkConfig() {
+    const configPath = resolvePath('config', 'app.config.ts');
+    if (fs.existsSync(configPath)) {
+        return { name: 'config', status: 'ok', message: 'config/app.config.ts found' };
+    }
+    return { name: 'config', status: 'warn', message: 'config/app.config.ts not found' };
+}
+/** Check app directory structure */
+export function checkAppStructure() {
+    const dirs = ['app/capabilities', 'app/entities', 'app/flows', 'app/events', 'app/prompts'];
+    const existing = dirs.filter((d) => fs.existsSync(resolvePath(d)));
+    if (existing.length === dirs.length) {
+        return { name: 'app-structure', status: 'ok', message: 'All app/ directories present' };
+    }
+    if (existing.length > 0) {
+        return {
+            name: 'app-structure',
+            status: 'warn',
+            message: `Missing: ${dirs.filter((d) => !existing.includes(d)).join(', ')}`,
+        };
+    }
+    return {
+        name: 'app-structure',
+        status: 'fail',
+        message: 'app/ directory not found — run `plumbus create`',
+    };
+}
+/** Check package.json exists */
+export function checkPackageJson() {
+    const pkgPath = resolvePath('package.json');
+    if (fs.existsSync(pkgPath)) {
+        return { name: 'package.json', status: 'ok', message: 'package.json found' };
+    }
+    return { name: 'package.json', status: 'fail', message: 'package.json not found' };
+}
+/** Check PostgreSQL connectivity */
+export async function checkPostgreSQL() {
+    try {
+        const configPath = resolvePath('config', 'app.config.ts');
+        if (!fs.existsSync(configPath)) {
+            return {
+                name: 'postgresql',
+                status: 'warn',
+                message: 'Config not found — cannot test PostgreSQL',
+            };
+        }
+        // Attempt a TCP connection to the configured host:port
+        const { loadConfig } = await import('../../config/loader.js');
+        const config = loadConfig();
+        const net = await import('node:net');
+        return await new Promise((resolve) => {
+            const socket = new net.Socket();
+            const timeout = setTimeout(() => {
+                socket.destroy();
+                resolve({
+                    name: 'postgresql',
+                    status: 'fail',
+                    message: `PostgreSQL not reachable at ${config.database.host}:${config.database.port}`,
+                });
+            }, 3000);
+            socket.connect(config.database.port, config.database.host, () => {
+                clearTimeout(timeout);
+                socket.destroy();
+                resolve({
+                    name: 'postgresql',
+                    status: 'ok',
+                    message: `PostgreSQL reachable at ${config.database.host}:${config.database.port}`,
+                });
+            });
+            socket.on('error', () => {
+                clearTimeout(timeout);
+                socket.destroy();
+                resolve({
+                    name: 'postgresql',
+                    status: 'fail',
+                    message: `PostgreSQL not reachable at ${config.database.host}:${config.database.port}`,
+                });
+            });
+        });
+    }
+    catch {
+        return {
+            name: 'postgresql',
+            status: 'warn',
+            message: 'Could not check PostgreSQL connectivity',
+        };
+    }
+}
+/** Check Redis connectivity */
+export async function checkRedis() {
+    try {
+        const configPath = resolvePath('config', 'app.config.ts');
+        if (!fs.existsSync(configPath)) {
+            return { name: 'redis', status: 'warn', message: 'Config not found — cannot test Redis' };
+        }
+        const { loadConfig } = await import('../../config/loader.js');
+        const config = loadConfig();
+        const net = await import('node:net');
+        return await new Promise((resolve) => {
+            const socket = new net.Socket();
+            const timeout = setTimeout(() => {
+                socket.destroy();
+                resolve({
+                    name: 'redis',
+                    status: 'fail',
+                    message: `Redis not reachable at ${config.queue.host}:${config.queue.port}`,
+                });
+            }, 3000);
+            socket.connect(config.queue.port, config.queue.host, () => {
+                clearTimeout(timeout);
+                socket.destroy();
+                resolve({
+                    name: 'redis',
+                    status: 'ok',
+                    message: `Redis reachable at ${config.queue.host}:${config.queue.port}`,
+                });
+            });
+            socket.on('error', () => {
+                clearTimeout(timeout);
+                socket.destroy();
+                resolve({
+                    name: 'redis',
+                    status: 'fail',
+                    message: `Redis not reachable at ${config.queue.host}:${config.queue.port}`,
+                });
+            });
+        });
+    }
+    catch {
+        return { name: 'redis', status: 'warn', message: 'Could not check Redis connectivity' };
+    }
+}
+/** Run all doctor checks (sync checks only) */
+export function runDoctorChecks() {
+    return [
+        checkNodeVersion(),
+        checkTypeScript(),
+        checkPlumbusCore(),
+        checkPackageJson(),
+        checkConfig(),
+        checkAppStructure(),
+    ];
+}
+/** Run all doctor checks including async connectivity tests */
+export async function runFullDoctorChecks() {
+    const syncChecks = runDoctorChecks();
+    const [pgCheck, redisCheck] = await Promise.all([checkPostgreSQL(), checkRedis()]);
+    return [...syncChecks, pgCheck, redisCheck];
+}
+export function registerDoctorCommand(program) {
+    program
+        .command('doctor')
+        .description('Check environment readiness')
+        .option('--json', 'Output as JSON')
+        .action(async (opts) => {
+        const checks = await runFullDoctorChecks();
+        if (opts.json) {
+            console.log(JSON.stringify({ checks }, null, 2));
+            return;
+        }
+        console.log('\nPlumbus Doctor\n');
+        for (const check of checks) {
+            switch (check.status) {
+                case 'ok':
+                    success(`${check.name}: ${check.message}`);
+                    break;
+                case 'warn':
+                    warn(`${check.name}: ${check.message}`);
+                    break;
+                case 'fail':
+                    logError(`${check.name}: ${check.message}`);
+                    break;
+            }
+        }
+        const fails = checks.filter((c) => c.status === 'fail');
+        const warns = checks.filter((c) => c.status === 'warn');
+        console.log(`\n${checks.length - fails.length - warns.length} passed, ${warns.length} warnings, ${fails.length} failures`);
+        if (fails.length > 0) {
+            info('Fix the failures above before starting development.');
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/commands/doctor.js.map

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

package/dist/cli/commands/e2e.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerE2ECommand(program: Command): void;
+//# sourceMappingURL=e2e.d.ts.map

package/dist/cli/commands/e2e.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2e.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/e2e.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgEzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuHzD"}

package/dist/cli/commands/e2e.js

@@ -0,0 +1,165 @@
+// ── plumbus e2e ──
+// Runs end-to-end browser tests with automatic frontend server lifecycle.
+// Starts the frontend dev server, waits for it to be ready, runs vitest
+// with the e2e config, and shuts down the server.
+import { execFileSync, spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join, resolve } from 'node:path';
+import { info, error as logError, warn } from '../utils.js';
+/**
+ * Resolve the vitest binary and its parent node_modules from within the framework.
+ */
+function resolveVitest() {
+    const require = createRequire(import.meta.url);
+    const vitestPkg = require.resolve('vitest/package.json');
+    return {
+        bin: vitestPkg.replace('package.json', 'vitest.mjs'),
+        nodeModulesDir: dirname(dirname(vitestPkg)),
+    };
+}
+/**
+ * Wait for the server to respond to HTTP requests.
+ */
+async function waitForServer(url, timeoutMs) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        try {
+            const response = await fetch(url);
+            if (response.ok || response.status < 500) {
+                return true;
+            }
+        }
+        catch {
+            // Server not ready yet
+        }
+        await new Promise((r) => setTimeout(r, 500));
+    }
+    return false;
+}
+/**
+ * Detect the e2e vitest config file (convention-based).
+ */
+function findE2EConfig(cwd) {
+    const candidates = [
+        'frontend/e2e/vitest.config.e2e.ts',
+        'e2e/vitest.config.e2e.ts',
+        'vitest.config.e2e.ts',
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(join(cwd, candidate))) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+export function registerE2ECommand(program) {
+    program
+        .command('e2e')
+        .description('Run end-to-end browser tests (auto-starts frontend server)')
+        .option('--frontend-dir <dir>', 'Frontend directory with package.json', 'frontend')
+        .option('--port <port>', 'Port for the frontend dev server', '3001')
+        .option('--base-url <url>', 'Base URL for the frontend server')
+        .option('--config <path>', 'Vitest e2e config file path')
+        .option('--skip-server', 'Skip starting the frontend server (assume already running)')
+        .allowUnknownOption()
+        .action(async (options, cmd) => {
+        const cwd = process.cwd();
+        const port = options.port ?? '3001';
+        const baseUrl = options.baseUrl ?? `http://localhost:${port}`;
+        const frontendDir = resolve(cwd, options.frontendDir ?? 'frontend');
+        const configPath = options.config ?? findE2EConfig(cwd);
+        if (!configPath) {
+            logError('No e2e config found. Expected one of: frontend/e2e/vitest.config.e2e.ts, e2e/vitest.config.e2e.ts, vitest.config.e2e.ts');
+            logError('Specify one with --config <path>');
+            process.exitCode = 1;
+            return;
+        }
+        if (!options.skipServer && !existsSync(join(frontendDir, 'package.json'))) {
+            logError(`Frontend directory not found: ${frontendDir}`);
+            logError('Specify the frontend directory with --frontend-dir <dir> or use --skip-server');
+            process.exitCode = 1;
+            return;
+        }
+        let serverProcess;
+        try {
+            // ── Start frontend server ──
+            if (!options.skipServer) {
+                info(`Starting frontend dev server on port ${port}...`);
+                serverProcess = spawn('npx', ['next', 'dev', '--port', port], {
+                    cwd: frontendDir,
+                    stdio: ['ignore', 'pipe', 'pipe'],
+                    env: { ...process.env, PORT: port },
+                });
+                // Log server output for debugging
+                serverProcess.stderr?.on('data', (data) => {
+                    const msg = data.toString().trim();
+                    if (msg) {
+                        warn(`[frontend] ${msg}`);
+                    }
+                });
+                // Wait for the server to be ready
+                info('Waiting for frontend server to be ready...');
+                const ready = await waitForServer(baseUrl, 60_000);
+                if (!ready) {
+                    logError(`Frontend server did not start within 60s at ${baseUrl}`);
+                    process.exitCode = 1;
+                    return;
+                }
+                info('Frontend server is ready.');
+            }
+            else {
+                info(`Skipping server start — using ${baseUrl}`);
+            }
+            // ── Run e2e tests ──
+            const { bin, nodeModulesDir } = resolveVitest();
+            // Collect extra vitest args (anything after known options)
+            const extraArgs = cmd.args.filter((a) => a !== options.config);
+            const vitestArgs = [
+                'run',
+                '--config',
+                configPath,
+                '--configLoader',
+                'runner',
+                ...extraArgs,
+            ];
+            info(`Running e2e tests: vitest ${vitestArgs.join(' ')}`);
+            const existingNodePath = process.env.NODE_PATH ?? '';
+            const nodePath = existingNodePath
+                ? `${nodeModulesDir}:${existingNodePath}`
+                : nodeModulesDir;
+            execFileSync('node', [bin, ...vitestArgs], {
+                stdio: 'inherit',
+                cwd,
+                env: {
+                    ...process.env,
+                    NODE_PATH: nodePath,
+                    E2E_BASE_URL: baseUrl,
+                },
+            });
+            info('E2E tests passed.');
+        }
+        catch (err) {
+            if (err && typeof err === 'object' && 'status' in err && typeof err.status === 'number') {
+                process.exitCode = err.status;
+            }
+            else {
+                logError('E2E test run failed');
+                process.exitCode = 1;
+            }
+        }
+        finally {
+            // ── Shut down server ──
+            if (serverProcess) {
+                info('Shutting down frontend server...');
+                serverProcess.kill('SIGTERM');
+                // Give it a moment to shut down gracefully
+                await new Promise((r) => setTimeout(r, 1000));
+                if (!serverProcess.killed) {
+                    serverProcess.kill('SIGKILL');
+                }
+            }
+        }
+    });
+}
+//# sourceMappingURL=e2e.js.map

package/dist/cli/commands/e2e.js.map

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