@celljs/cli 3.9.0 → 4.0.0

package/lib/cli/deploy-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-command.d.ts","sourceRoot":"","sources":["../../src/cli/deploy-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAI/F,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtD,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE5D;;;GAGG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACtC,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,+DAA+D;IACnF,SAAkB,OAAO;iBACrB,MAAM;;;iBACN,IAAI;;;;;iBACJ,SAAS;;;iBACT,SAAS;;;iBACT,SAAS;qBAAI,IAAI,EAAE,SAAS;;iBAC5B,YAAY;qBAAI,IAAI,EAAE,SAAS;;MACxB;IACX,SAAkB,KAAK,WAOrB;IAEI,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA2DpE;IAED,qFAAqF;IACrF,SAAS,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAY7E;IAED,+CAA+C;IAC/C,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE,CAEhD;IAED,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM,CAMjE;CACJ"}

package/lib/cli/deploy-command.js

@@ -0,0 +1,114 @@
+import { relative, resolve } from 'node:path';
+import { CellError } from '@celljs/kit';
+import { ConfigResolver } from '../config/config-resolver.js';
+import { DeployerRegistry } from '../deploy/deployer-registry.js';
+import { PresetOutput } from '../preset/preset-output.js';
+import { Toolchain } from '../toolchain/toolchain.js';
+import { BuildCommand } from './build-command.js';
+import { Command } from './command.js';
+/**
+ * `cell deploy`: build with the preset, then publish the output with the preset's deployer. The
+ * deployer plans first; `--dry-run` prints the plan and changes nothing (docs/design/agent-first.md R9).
+ */
+export class DeployCommand extends Command {
+    name = 'deploy';
+    description = 'Build and deploy the application (--dry-run to only plan)';
+    options = {
+        preset: BuildCommand.OPTIONS.preset,
+        mode: BuildCommand.OPTIONS.mode,
+        sourcemap: BuildCommand.OPTIONS.sourcemap,
+        'out-dir': BuildCommand.OPTIONS['out-dir'],
+        'dry-run': { type: 'boolean' },
+        'skip-build': { type: 'boolean' },
+    };
+    usage = [
+        '--preset <name>      platform: cloudflare, fc, scf, lambda or vercel',
+        '-m, --mode <mode>    extra mode, reads cell.<mode>.yml (repeatable)',
+        '--dry-run            build and plan only; nothing is deployed',
+        '--skip-build         deploy the existing output in --out-dir',
+        '--sourcemap          emit source maps',
+        '--out-dir <dir>      output directory (default: .cell/output)',
+    ];
+    async run({ values, reporter, env }) {
+        const started = performance.now();
+        const dryRun = values['dry-run'] === true;
+        const toolchain = await Toolchain.create({
+            root: values.root,
+            command: 'deploy',
+            flags: BuildCommand.flags(values),
+            env,
+            quiet: reporter.json,
+            logger: reporter,
+        });
+        const { config, events } = toolchain;
+        const outDir = resolve(config.root, config.build.outDir);
+        const existing = values['skip-build'] ? this.existingOutput(toolchain, outDir) : undefined;
+        // Checked before building: a preset without a deployer fails fast.
+        const preset = existing ? toolchain.presets.resolve(existing.preset ?? ConfigResolver.DEFAULT_PRESET) : toolchain.preset;
+        if (!preset.deployer) {
+            throw new CellError({
+                code: 'CELL_DEPLOY_UNSUPPORTED',
+                message: `The ${preset.name} preset has no deployer; its output in ${relative(process.cwd(), outDir) || '.'} runs wherever you start it.`,
+                file: config.preset.source === 'config' ? config.file : undefined,
+                hint: `Deploy with a preset that has a deployer: --preset ${DeployCommand.deployable(toolchain).join(', --preset ')}.`,
+            });
+        }
+        const deployer = DeployerRegistry.builtin().get(preset.deployer);
+        const manifest = existing ?? (await BuildCommand.build(toolchain, reporter, env)).manifest;
+        const context = {
+            root: config.root,
+            outDir,
+            manifest,
+            env,
+            options: toolchain.presetOptions(preset.name),
+            info: (message) => reporter.info(message),
+            warn: (message) => reporter.warn(message),
+            relay: (chunk, stream) => reporter.relay(chunk, stream),
+        };
+        const cancelled = await events.gate('deploy:before', { config, preset, manifest, dryRun });
+        if (cancelled) {
+            throw new CellError({
+                code: 'CELL_DEPLOY_CANCELLED',
+                message: `The deployment was cancelled: ${cancelled.reason}.`,
+                hint: 'Fix the reported hook or module, then deploy again.',
+            });
+        }
+        const { plan } = await events.emit('deploy:plan', { config, preset, plan: await deployer.plan(context) });
+        let deployment;
+        if (!dryRun) {
+            reporter.info(`Deploying with ${deployer.name}…`);
+            deployment = await deployer.apply(context, plan);
+            await events.emit('deploy:done', { config, preset, plan, deployment });
+        }
+        await toolchain.close();
+        const durationMs = Math.round(performance.now() - started);
+        reporter.result('deploy', { root: config.root, preset: preset.name, deployer: deployer.name, dryRun, plan, ...(deployment ? { deployment } : {}), durationMs }, DeployCommand.describe(plan, deployment));
+        return 0;
+    }
+    /** `--skip-build`: the output must exist and come from the preset this run chose. */
+    existingOutput(toolchain, outDir) {
+        const manifest = PresetOutput.read(outDir);
+        const chosen = toolchain.config.preset;
+        if (chosen.source !== 'default' && manifest.preset !== chosen.name) {
+            throw new CellError({
+                code: 'CELL_DEPLOY_OUTPUT_MISMATCH',
+                message: `The output in ${outDir} was built with the ${manifest.preset ?? 'unknown'} preset, not ${chosen.name}.`,
+                file: toolchain.config.file,
+                hint: `Run cell deploy without --skip-build, or cell build --preset ${chosen.name} first.`,
+            });
+        }
+        return manifest;
+    }
+    /** Presets that have a deployer, for hints. */
+    static deployable(toolchain) {
+        return toolchain.presets.names.filter(name => toolchain.presets.resolve(name).deployer);
+    }
+    static describe(plan, deployment) {
+        const lines = plan.resources.map(r => `  ${r.action} ${r.type} ${r.name}${r.details ? ` ${JSON.stringify(r.details)}` : ''}`);
+        if (!deployment) {
+            return [`Plan (${plan.deployer}):`, ...lines, 'Nothing was deployed (--dry-run).'].join('\n');
+        }
+        return [`Deployed (${plan.deployer}):`, ...lines, ...(deployment.url ? [`URL: ${deployment.url}`] : [])].join('\n');
+    }
+}
+//# sourceMappingURL=deploy-command.js.map

package/lib/cli/deploy-command.js.map

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

package/lib/cli/dev-command.d.ts

@@ -0,0 +1,47 @@
+import type { Logger } from 'vite';
+import { Command, type CommandContext, type ParsedValues } from './command.js';
+import type { Reporter } from './reporter.js';
+type Outcome = {
+    kind: 'restart';
+    files: string[];
+} | {
+    kind: 'exit';
+};
+/**
+ * `cell dev`: frontend and backend on one port with the `development` mode. The frontend has
+ * Vite's HMR, the backend reloads when one of its files changes, and a change of cell*.yml,
+ * package.json or cell.config.* restarts everything with a new toolchain. Runs until SIGINT/SIGTERM.
+ */
+export declare class DevCommand extends Command {
+    readonly name = "dev";
+    readonly description = "Run the application for development: one port, frontend HMR, backend reload";
+    readonly options: {
+        readonly preset: {
+            readonly type: 'string';
+        };
+        readonly mode: {
+            readonly type: 'string';
+            readonly short: 'm';
+            readonly multiple: true;
+        };
+        readonly port: {
+            readonly type: 'string';
+            readonly short: 'p';
+        };
+        readonly host: {
+            readonly type: 'string';
+        };
+    };
+    readonly usage: string[];
+    run({ values, reporter, env }: CommandContext): Promise<number>;
+    static port(values: ParsedValues): number | undefined;
+    /** Resolves once on SIGINT or SIGTERM; returns the function that stops listening. */
+    protected static onSignal(handler: () => void): () => void;
+    protected static waitForConfigChange(root?: string): Promise<Outcome>;
+    /** `--json`: stdout carries only the result line, so the application's console output goes to stderr. */
+    protected static consoleToStderr(): () => void;
+    static format(error: unknown): string;
+    protected static stderrLogger(reporter: Reporter): Logger;
+}
+export {};
+//# sourceMappingURL=dev-command.d.ts.map

package/lib/cli/dev-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-command.d.ts","sourceRoot":"","sources":["../../src/cli/dev-command.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAMnC,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,KAAK,OAAO,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,OAAO;IACnC,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,WAAW,iFAAiF;IACrG,SAAkB,OAAO;iBACrB,MAAM;;;iBACN,IAAI;;;;;iBACJ,IAAI;qBAAI,IAAI,EAAE,QAAQ;qBAAE,KAAK,EAAE,GAAG;;iBAClC,IAAI;qBAAI,IAAI,EAAE,QAAQ;;MACf;IACX,SAAkB,KAAK,WAKrB;IAEI,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAmHpE;IAED,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAMpD;IAED,qFAAqF;IACrF,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAOzD;IAED,SAAS,CAAC,MAAM,CAAC,mBAAmB,CAAC,IAAI,SAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAe3E;IAED,yGAAyG;IACzG,SAAS,CAAC,MAAM,CAAC,eAAe,IAAI,MAAM,IAAI,CAO7C;IAED,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUpC;IAED,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAoBxD;CACJ"}

package/lib/cli/dev-command.js

@@ -0,0 +1,219 @@
+import { watch } from 'node:fs';
+import { relative } from 'node:path';
+import { CellError } from '@celljs/kit';
+import { CellDevServer } from '@celljs/vite';
+import { ConfigResolver } from '../config/config-resolver.js';
+import { DevActivity } from '../mcp/dev-activity.js';
+import { DevMcpEndpoint } from '../mcp/dev-mcp-endpoint.js';
+import { Toolchain } from '../toolchain/toolchain.js';
+import { BuildCommand } from './build-command.js';
+import { Command } from './command.js';
+/**
+ * `cell dev`: frontend and backend on one port with the `development` mode. The frontend has
+ * Vite's HMR, the backend reloads when one of its files changes, and a change of cell*.yml,
+ * package.json or cell.config.* restarts everything with a new toolchain. Runs until SIGINT/SIGTERM.
+ */
+export class DevCommand extends Command {
+    name = 'dev';
+    description = 'Run the application for development: one port, frontend HMR, backend reload';
+    options = {
+        preset: BuildCommand.OPTIONS.preset,
+        mode: BuildCommand.OPTIONS.mode,
+        port: { type: 'string', short: 'p' },
+        host: { type: 'string' },
+    };
+    usage = [
+        '--preset <name>      preset whose entry runs the backend (default: node)',
+        '-m, --mode <mode>    extra mode, reads cell.<mode>.yml (repeatable); development is always on',
+        '-p, --port <port>    port (default: cell.server.port, else 3000)',
+        '--host <host>        interface to listen on (default: cell.server.host, else 127.0.0.1)',
+    ];
+    async run({ values, reporter, env }) {
+        const port = DevCommand.port(values);
+        const restore = reporter.json ? DevCommand.consoleToStderr() : undefined;
+        const activity = new DevActivity();
+        const stopCapture = activity.captureConsole();
+        let current;
+        const { CellCli } = await import('./cell-cli.js');
+        const mcp = new DevMcpEndpoint(() => current, activity, CellCli.version);
+        let first = true;
+        let address;
+        try {
+            for (;;) {
+                const started = performance.now();
+                let toolchain;
+                let server;
+                let settle;
+                const outcome = new Promise(resolve => {
+                    settle = resolve;
+                });
+                try {
+                    toolchain = await Toolchain.create({
+                        root: values.root,
+                        command: 'dev',
+                        flags: { preset: values.preset, mode: values.mode },
+                        env,
+                        quiet: reporter.json,
+                        logger: reporter,
+                        // A failing module handler is reported; development goes on (docs/design/modules.md §3.4).
+                        onNotifyError: error => reporter.info(error.format()),
+                    });
+                    const { config, preset, events } = toolchain;
+                    server = await new CellDevServer({
+                        ...toolchain.projectOptions(),
+                        plugins: toolchain.modules.vitePlugins(),
+                        devHandlers: [{ path: DevMcpEndpoint.PATH, handler: mcp.handler }, ...toolchain.modules.devHandlerList],
+                        watchFiles: toolchain.modules.watchFileList,
+                        env,
+                        preset: preset.name,
+                        format: ConfigResolver.format(config, preset),
+                        outDir: config.build.outDir,
+                        vite: config.vite,
+                        // A restart keeps the address the first start got.
+                        port: address?.port ?? port,
+                        host: address?.host ?? values.host,
+                        logLevel: reporter.json ? 'warn' : 'info',
+                        logger: reporter.json ? DevCommand.stderrLogger(reporter) : undefined,
+                        onRestart: files => settle({ kind: 'restart', files }),
+                        onRequest: record => activity.recordRequest(record),
+                        onReload: (files, error) => {
+                            if (error) {
+                                activity.recordError(error, files);
+                                reporter.info(error.format());
+                            }
+                            else {
+                                reporter.info(`Reloaded the backend (${files.map(file => relative(config.root, file)).join(', ')})`);
+                            }
+                            void events.emit('dev:reload', { files, error: error?.toJSON() }).catch(e => reporter.info(DevCommand.format(e)));
+                        },
+                    }).start();
+                }
+                catch (error) {
+                    if (first) {
+                        throw error;
+                    }
+                    // A broken cell.config.ts or cell.yml: report it and try again on the next change.
+                    reporter.info(DevCommand.format(error));
+                    const next = await DevCommand.waitForConfigChange(values.root);
+                    if (next.kind === 'exit') {
+                        return 0;
+                    }
+                    continue;
+                }
+                const { config, preset, events } = toolchain;
+                current = server;
+                address = server.address;
+                const stopOnSignal = DevCommand.onSignal(() => settle({ kind: 'exit' }));
+                await events.emit('dev:ready', { url: server.url, port: address.port });
+                if (server.error) {
+                    activity.recordError(server.error);
+                    reporter.info(server.error.format());
+                }
+                const mcpUrl = `${server.url}${DevMcpEndpoint.PATH}`;
+                const durationMs = Math.round(performance.now() - started);
+                if (first) {
+                    reporter.result('dev', {
+                        root: config.root,
+                        url: server.url,
+                        port: address.port,
+                        preset: preset.name,
+                        mode: config.mode,
+                        targets: server.project.targets,
+                        mcp: mcpUrl,
+                        durationMs,
+                        ...(server.error ? { backendError: server.error.toJSON() } : {}),
+                    }, `Ready at ${server.url} (${server.project.targets.join(' + ')}, mode ${config.mode.join(', ')}) in ${durationMs}ms\n  MCP endpoint for agents: ${mcpUrl}`);
+                    first = false;
+                }
+                else {
+                    reporter.info(`Restarted at ${server.url} in ${durationMs}ms`);
+                }
+                const result = await outcome;
+                stopOnSignal();
+                current = undefined;
+                await server.close();
+                await toolchain.close(result.kind);
+                if (result.kind === 'exit') {
+                    return 0;
+                }
+                reporter.info(`${result.files.map(file => relative(config.root, file)).join(', ')} changed, restarting…`);
+            }
+        }
+        finally {
+            stopCapture();
+            restore?.();
+        }
+    }
+    static port(values) {
+        const port = values.port;
+        if (port !== undefined && !/^\d+$/.test(port)) {
+            throw new CellError({ code: 'CELL_ARGUMENT_INVALID', message: `Invalid --port '${port}'.`, hint: 'Pass a port number, e.g. --port 3000.' });
+        }
+        return port === undefined ? undefined : Number(port);
+    }
+    /** Resolves once on SIGINT or SIGTERM; returns the function that stops listening. */
+    static onSignal(handler) {
+        process.once('SIGINT', handler);
+        process.once('SIGTERM', handler);
+        return () => {
+            process.off('SIGINT', handler);
+            process.off('SIGTERM', handler);
+        };
+    }
+    static waitForConfigChange(root = process.cwd()) {
+        return new Promise(resolve => {
+            let watcher;
+            const done = (outcome) => {
+                watcher?.close();
+                stop();
+                resolve(outcome);
+            };
+            const stop = DevCommand.onSignal(() => done({ kind: 'exit' }));
+            watcher = watch(root, (_event, file) => {
+                if (file && CellDevServer.CONFIG_FILE.test(file)) {
+                    done({ kind: 'restart', files: [file] });
+                }
+            });
+        });
+    }
+    /** `--json`: stdout carries only the result line, so the application's console output goes to stderr. */
+    static consoleToStderr() {
+        const { log, info, debug, error } = console;
+        // The stderr function of now: a later wrapper of console.error must not see these twice.
+        console.log = console.info = console.debug = (...args) => error.apply(console, args);
+        return () => {
+            Object.assign(console, { log, info, debug });
+        };
+    }
+    static format(error) {
+        return (CellError.is(error)
+            ? error
+            : new CellError({
+                code: 'CELL_INTERNAL_ERROR',
+                message: String(error?.message ?? error),
+                hint: 'Rerun with CELL_DEBUG=1 and report it.',
+            })).format();
+    }
+    static stderrLogger(reporter) {
+        const warned = new Set();
+        const logger = {
+            hasWarned: false,
+            info: message => reporter.info(message),
+            warn: message => {
+                logger.hasWarned = true;
+                reporter.info(message);
+            },
+            warnOnce: message => {
+                if (!warned.has(message)) {
+                    warned.add(message);
+                    logger.warn(message);
+                }
+            },
+            error: message => reporter.info(message),
+            clearScreen: () => { },
+            hasErrorLogged: () => false,
+        };
+        return logger;
+    }
+}
+//# sourceMappingURL=dev-command.js.map

package/lib/cli/dev-command.js.map

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

package/lib/cli/dev-command.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dev-command.spec.d.ts.map

package/lib/cli/dev-command.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-command.spec.d.ts","sourceRoot":"","sources":["../../src/cli/dev-command.spec.ts"],"names":[],"mappings":""}

package/lib/cli/dev-command.spec.js

@@ -0,0 +1,149 @@
+import { afterAll, beforeAll, describe, expect, it } from 'bun:test';
+import { spawn } from 'node:child_process';
+import { readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { FixtureProject } from '../test/fixture-project.js';
+import { CellCli } from './cell-cli.js';
+const BIN = join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'bin', 'cell.js');
+async function eventually(read, check, tries = 150) {
+    let value = await read();
+    for (let i = 0; i < tries && !check(value); i++) {
+        await new Promise(r => setTimeout(r, 100));
+        value = await read();
+    }
+    return value;
+}
+const text = (url) => fetch(url).then(r => r.text(), () => '(down)');
+describe('cell dev', () => {
+    const fixture = new FixtureProject('cli-dev')
+        .file('package.json', {
+        name: 'cli-dev',
+        dependencies: { '@celljs/core': '*', '@celljs/mvc': '*', '@celljs/web': '*', '@celljs/http': '*', '@celljs/express-adapter': '*' },
+    })
+        .file('src/node/module.ts', [
+        "import { autoBind, Value } from '@celljs/core';",
+        "import { Controller, Get, Text } from '@celljs/mvc/lib/node';",
+        '@Controller()',
+        'export class HomeController {',
+        "    @Value('cell.greeting') protected readonly greeting: string;",
+        '    @Get() @Text()',
+        '    home(): string {',
+        "        console.log('home called');",
+        '        return this.greeting;',
+        '    }',
+        '}',
+        'export default autoBind();',
+    ].join('\n'))
+        .file('cell.yml', 'backend:\n  cell:\n    greeting: Hello dev\n')
+        .file('cell.development.yml', 'backend:\n  cell:\n    mode: development\n')
+        .file('extra.json', '{}\n')
+        .file('dev-module.mjs', [
+        'export default cell => {',
+        "    cell.addDevHandler('/_hello', (_req, res) => res.end('hello from a module'));",
+        "    cell.addWatchFile('extra.json');",
+        "    cell.on('dev:ready', () => { throw new Error('flaky module'); });",
+        '};',
+    ].join('\n'))
+        .file('cell.config.ts', "export default { modules: ['./dev-module.mjs'], hooks: { 'dev:ready': 'echo ready >> ready.txt' } };\n");
+    let child;
+    let stdout = '';
+    let stderr = '';
+    let result;
+    let exit;
+    beforeAll(async () => {
+        child = spawn('node', [BIN, 'dev', '--json', '--port', '0'], { cwd: fixture.root, env: { ...process.env, CELL_DEBUG: '1' } });
+        child.stdout?.on('data', chunk => {
+            stdout += chunk;
+        });
+        child.stderr?.on('data', chunk => {
+            stderr += chunk;
+        });
+        exit = new Promise(resolve => child.on('exit', code => resolve(code ?? -1)));
+        await eventually(async () => stdout, out => out.includes('\n'), 300);
+        result = JSON.parse(stdout.split('\n')[0]);
+    }, 60000);
+    afterAll(() => {
+        child?.kill('SIGKILL');
+        fixture.dispose();
+    });
+    it('prints one JSON result when ready, in the development mode', () => {
+        expect(result).toMatchObject({ command: 'dev', ok: true, mode: ['development'], targets: ['backend'] });
+        expect(result.port).toBeGreaterThan(0);
+        expect(result.url).toBe(`http://127.0.0.1:${result.port}`);
+    });
+    it('serves the backend and runs dev:ready hooks', async () => {
+        expect(await text(result.url)).toBe('Hello dev');
+        expect(readFileSync(fixture.path('ready.txt'), 'utf8')).toBe('ready\n');
+    });
+    it('answers MCP on /_cell/mcp with routes, configuration, requests and logs of the running backend', async () => {
+        expect(result.mcp).toBe(`${result.url}/_cell/mcp`);
+        const mcp = async (name, args = {}) => {
+            const response = await fetch(result.mcp, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', Accept: 'application/json, text/event-stream' },
+                body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'tools/call', params: { name, arguments: args } }),
+            });
+            expect(response.headers.get('content-type')).toBe('application/json');
+            return (await response.json()).result.structuredContent;
+        };
+        expect((await mcp('list_routes')).routes).toEqual([{ method: 'GET', path: '/', controller: 'HomeController', handler: 'home' }]);
+        expect(await mcp('get_config', { key: 'cell.greeting' })).toEqual({ key: 'cell.greeting', value: 'Hello dev' });
+        expect((await mcp('list_bindings', { filter: 'HomeController' })).bindings[0]).toMatchObject({
+            id: 'HomeController',
+            implementation: 'HomeController',
+        });
+        expect((await mcp('recent_requests')).requests).toContainEqual(expect.objectContaining({ method: 'GET', url: '/', status: 200 }));
+        expect((await mcp('logs', { filter: 'home called' })).total).toBeGreaterThan(0);
+        expect(await mcp('get_errors')).toMatchObject({ backend: null, running: true });
+        const notification = await fetch(result.mcp, { method: 'POST', body: '{"jsonrpc":"2.0","method":"notifications/initialized"}' });
+        expect(notification.status).toBe(202);
+        expect((await fetch(result.mcp)).status).toBe(405);
+        expect((await fetch(result.mcp, { method: 'POST', headers: { Origin: 'https://evil.example' }, body: '{}' })).status).toBe(403);
+    });
+    it('restarts on the same port when cell.yml changes', async () => {
+        writeFileSync(fixture.path('cell.yml'), 'backend:\n  cell:\n    greeting: Hello again\n');
+        expect(await eventually(() => text(result.url), body => body === 'Hello again')).toBe('Hello again');
+        // dev:ready runs once the server listens, so it may finish just after the first response.
+        const ready = () => Promise.resolve(readFileSync(fixture.path('ready.txt'), 'utf8'));
+        expect(await eventually(ready, lines => lines === 'ready\nready\n')).toBe('ready\nready\n');
+    });
+    it('reports a broken cell.yml and starts again once it is fixed', async () => {
+        writeFileSync(fixture.path('cell.yml'), 'backend:\n  cell:\n    greeting: [\n');
+        await eventually(async () => stderr, err => err.includes('[CELL_CONFIG_PARSE]'));
+        expect(stderr).toContain('[CELL_CONFIG_PARSE]');
+        writeFileSync(fixture.path('cell.yml'), 'backend:\n  cell:\n    greeting: Hello fixed\n');
+        expect(await eventually(() => text(result.url), body => body === 'Hello fixed')).toBe('Hello fixed');
+    });
+    it('serves dev handlers of modules, restarts on their watch files, and reports their failing handlers without stopping', async () => {
+        expect(await text(`${result.url}/_hello`)).toBe('hello from a module');
+        expect(stderr).toContain('flaky module');
+        const ready = () => Promise.resolve(readFileSync(fixture.path('ready.txt'), 'utf8').split('\n').length);
+        const before = await ready();
+        writeFileSync(fixture.path('extra.json'), '{"changed":true}\n');
+        expect(await eventually(ready, count => count > before)).toBe(before + 1);
+    });
+    it('keeps stdout to the result line: application output goes to stderr', () => {
+        expect(stderr).toContain('home called');
+        expect(stdout.trim().split('\n')).toHaveLength(1);
+    });
+    it('stops on SIGINT with exit code 0', async () => {
+        child.kill('SIGINT');
+        expect(await exit).toBe(0);
+        expect(await text(result.url)).toBe('(down)');
+    });
+    it('rejects a --port that is not a number', async () => {
+        let out = '';
+        const code = await new CellCli({ stdout: { write: s => (out += s) }, stderr: { write: () => true } }).run([
+            'dev',
+            '--port',
+            'x',
+            '--json',
+            '--root',
+            fixture.root,
+        ]);
+        expect(code).toBe(2);
+        expect(JSON.parse(out).error.code).toBe('CELL_ARGUMENT_INVALID');
+    });
+});
+//# sourceMappingURL=dev-command.spec.js.map

package/lib/cli/dev-command.spec.js.map

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

package/lib/cli/docs-command.d.ts

@@ -0,0 +1,19 @@
+import { Command, type CommandContext } from './command.js';
+/**
+ * `cell docs <query>`: searches the README.md and docs/ of the installed components and the docs
+ * of toolchain modules, the versions this project uses. Read-only; prints the best sections.
+ */
+export declare class DocsCommand extends Command {
+    readonly name = "docs";
+    readonly description = "Search the docs of the installed components and modules";
+    readonly arguments = "<query...>";
+    readonly options: {
+        readonly limit: {
+            readonly type: 'string';
+        };
+    };
+    readonly usage: string[];
+    run({ values, positionals, reporter, env }: CommandContext): Promise<number>;
+    static limit(value: string | undefined): number;
+}
+//# sourceMappingURL=docs-command.d.ts.map

package/lib/cli/docs-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-command.d.ts","sourceRoot":"","sources":["../../src/cli/docs-command.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE5D;;;GAGG;AACH,qBAAa,WAAY,SAAQ,OAAO;IACpC,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,WAAW,6DAA6D;IACjF,SAAkB,SAAS,gBAAgB;IAC3C,SAAkB,OAAO;iBAAK,KAAK;qBAAI,IAAI,EAAE,QAAQ;;MAAc;IACnE,SAAkB,KAAK,WAA4D;IAE7E,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBjF;IAED,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQ9C;CACJ"}