@celljs/cli 3.9.0 → 4.0.0

package/lib/cli/cell-cli.spec.js

@@ -0,0 +1,195 @@
+import { afterAll, beforeAll, describe, expect, it } from 'bun:test';
+import { execFile, spawn } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { createServer } from 'node:net';
+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');
+const BACKEND_DEPENDENCIES = { '@celljs/core': '*', '@celljs/http': '*', '@celljs/web': '*', '@celljs/mvc': '*' };
+/** Runs the real executable: `node bin/cell.js ...`. */
+function cell(args, cwd) {
+    return new Promise(resolve => {
+        execFile('node', [BIN, ...args], { cwd }, (error, stdout, stderr) => resolve({ code: error ? Number(error.code) : 0, stdout, stderr }));
+    });
+}
+/** Runs the command line in-process and captures what it prints. */
+async function inProcess(args, env) {
+    let stdout = '';
+    let stderr = '';
+    const code = await new CellCli({ stdout: { write: s => (stdout += s) }, stderr: { write: s => (stderr += s) }, env }).run(args);
+    return { code, stdout, stderr };
+}
+/** Fetches `url` until the server answers, at most 5s. */
+async function waitFor(url) {
+    for (let i = 0; i < 50; i++) {
+        try {
+            return await (await fetch(url)).text();
+        }
+        catch {
+            await new Promise(r => setTimeout(r, 100));
+        }
+    }
+    return '';
+}
+function freePort() {
+    return new Promise(resolve => {
+        const server = createServer().listen(0, () => {
+            const { port } = server.address();
+            server.close(() => resolve(port));
+        });
+    });
+}
+function backendProject(name, dependencies, config = '') {
+    const fixture = new FixtureProject(name)
+        .file('package.json', { name, dependencies })
+        .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 {',
+        '        return this.greeting;',
+        '    }',
+        '}',
+        'export default autoBind();',
+    ].join('\n'))
+        .file('cell.yml', 'backend:\n  cell:\n    greeting: "Hello ${env.WHO ?: \'nobody\'}"\n');
+    return config ? fixture.file('cell.config.ts', config) : fixture;
+}
+describe('cell build and cell preview', () => {
+    let fixture;
+    let build;
+    const previews = [];
+    beforeAll(async () => {
+        fixture = backendProject('cli-app', { ...BACKEND_DEPENDENCIES, '@celljs/express-adapter': '*' }, "import { defineConfig } from '@celljs/cli';\nexport default defineConfig({ hooks: { 'build:before': 'echo before > before.txt', 'output:done': 'echo $CELL_PRESET > done.txt' } });\n");
+        build = await cell(['build', '--json'], fixture.root);
+    }, 60000);
+    afterAll(() => {
+        for (const preview of previews) {
+            preview.kill();
+        }
+        fixture?.dispose();
+    });
+    it('prints one JSON result describing the build', () => {
+        expect(build.code).toBe(0);
+        const result = JSON.parse(build.stdout);
+        expect(result).toMatchObject({
+            schemaVersion: 1,
+            command: 'build',
+            ok: true,
+            preset: 'node',
+            format: 'esm',
+            mode: ['production'],
+            targets: ['backend'],
+            outDir: '.cell/output',
+            entry: '@celljs/express-adapter/lib/node/http-application-entry',
+            warnings: [],
+        });
+        expect(build.stdout.trim().split('\n')).toHaveLength(1);
+    });
+    it('runs the project hooks around the build', () => {
+        expect(readFileSync(fixture.path('before.txt'), 'utf8').trim()).toBe('before');
+        expect(readFileSync(fixture.path('done.txt'), 'utf8').trim()).toBe('node');
+    });
+    it('previews the output on the --port, which wins over CELL_BACKEND__SERVER__PORT', async () => {
+        const [port, other] = [await freePort(), await freePort()];
+        const env = { ...process.env, WHO: 'agent', CELL_BACKEND__SERVER__PORT: String(other) };
+        previews.push(spawn('node', [BIN, 'preview', '--port', String(port)], { cwd: fixture.root, env, stdio: 'ignore' }));
+        expect(await waitFor(`http://127.0.0.1:${port}`)).toBe('Hello agent');
+        expect(await fetch(`http://127.0.0.1:${other}`).then(() => true, () => false)).toBe(false);
+    });
+    it('passes CELL_BACKEND__ variables of the environment to the server', async () => {
+        const port = await freePort();
+        const env = { ...process.env, CELL_BACKEND__SERVER__PORT: String(port), CELL_BACKEND__GREETING: 'Hi from env' };
+        previews.push(spawn('node', [BIN, 'preview'], { cwd: fixture.root, env, stdio: 'ignore' }));
+        expect(await waitFor(`http://127.0.0.1:${port}`)).toBe('Hi from env');
+    });
+    it('rejects a --port that is not a number', async () => {
+        const { code, stdout } = await inProcess(['preview', '--root', fixture.root, '--port', '80a', '--json']);
+        expect(code).toBe(2);
+        expect(JSON.parse(stdout).error).toMatchObject({ code: 'CELL_ARGUMENT_INVALID', message: "Invalid --port '80a'." });
+    });
+});
+describe('cell build warnings and failures', () => {
+    const fixtures = [];
+    afterAll(() => {
+        for (const fixture of fixtures) {
+            fixture.dispose();
+        }
+    });
+    it('warns when no component provides the entry of the preset', async () => {
+        const fixture = backendProject('cli-no-server', BACKEND_DEPENDENCIES);
+        fixtures.push(fixture);
+        const { code, stdout, stderr } = await inProcess(['build', '--root', fixture.root, '--json']);
+        expect(code).toBe(0);
+        const result = JSON.parse(stdout);
+        expect(result.entry).toBe('@celljs/core/lib/common/application/application-entry');
+        expect(result.warnings[0]).toContain('@celljs/express-adapter');
+        expect(stderr).toContain('warning:');
+    }, 60000);
+    it('applies CELL_FRONTEND__ variables to the built frontend and warns about the ones that do not apply', async () => {
+        const fixture = new FixtureProject('cli-frontend-env')
+            .file('package.json', { name: 'cli-frontend-env', dependencies: { '@celljs/core': '*' } })
+            .file('cell.config.ts', "export default { targets: ['frontend'] };\n")
+            .file('cell.yml', 'cell:\n  name: Fixture\n');
+        fixtures.push(fixture);
+        const env = { PATH: process.env.PATH, CELL_FRONTEND__NAME: 'Shop', CELL_FRONTEND__NAEM: 'x', CELL_BACKEND__NOPE: 'x' };
+        const { code, stdout, stderr } = await inProcess(['build', '--root', fixture.root, '--json'], env);
+        expect(code).toBe(0);
+        const result = JSON.parse(stdout);
+        expect(result.targets).toEqual(['frontend']);
+        // Backend variables are for the server at runtime; cell build only checks the frontend ones.
+        expect(result.warnings).toEqual([
+            expect.stringContaining("CELL_FRONTEND__NAEM is ignored: no key 'NAEM' at the top level (keys: cell, mode) or under cell (keys: "),
+        ]);
+        expect(stderr).toContain('warning: CELL_FRONTEND__NAEM is ignored');
+        expect(readFileSync(fixture.path('.cell/output/public/index.html'), 'utf8')).toContain('<title>Shop</title>');
+    }, 60000);
+    it('stops when a build:before hook fails', async () => {
+        const fixture = backendProject('cli-cancel', BACKEND_DEPENDENCIES, "export default { hooks: { 'build:before': 'exit 4' } };\n");
+        fixtures.push(fixture);
+        const { code, stdout } = await inProcess(['build', '--root', fixture.root, '--json']);
+        expect(code).toBe(1);
+        expect(JSON.parse(stdout)).toMatchObject({ ok: false, error: { code: 'CELL_BUILD_CANCELLED' } });
+        expect(existsSync(fixture.path('.cell/output'))).toBe(false);
+    });
+    it('reports an unknown preset with a suggestion', async () => {
+        const fixture = backendProject('cli-preset', BACKEND_DEPENDENCIES);
+        fixtures.push(fixture);
+        const { code, stderr } = await inProcess(['build', '--root', fixture.root, '--preset', 'nod']);
+        expect(code).toBe(1);
+        expect(stderr).toContain('[CELL_PRESET_NOT_FOUND]');
+        expect(stderr).toContain("Did you mean 'node'?");
+    });
+    it('requires a build before preview', async () => {
+        const fixture = new FixtureProject('cli-preview').file('package.json', { name: 'p' });
+        fixtures.push(fixture);
+        const { code, stdout } = await inProcess(['preview', '--root', fixture.root, '--json']);
+        expect(code).toBe(1);
+        expect(JSON.parse(stdout).error).toMatchObject({ code: 'CELL_OUTPUT_NOT_FOUND', hint: 'Run `cell build` first.' });
+    });
+});
+describe('cell usage', () => {
+    it('suggests the intended command or option and exits with 2', async () => {
+        const command = await inProcess(['biuld', '--json']);
+        expect(command.code).toBe(2);
+        expect(JSON.parse(command.stdout).error).toMatchObject({ code: 'CELL_ARGUMENT_INVALID', hint: "Did you mean 'cell build'?" });
+        const option = await inProcess(['build', '--presett', 'node']);
+        expect(option.code).toBe(2);
+        expect(option.stderr).toContain("Did you mean '--preset'?");
+        expect((await inProcess(['build', '--format', 'umd'])).code).toBe(2);
+    });
+    it('prints help and version', async () => {
+        const help = await inProcess(['--help']);
+        expect(help.code).toBe(0);
+        expect(help.stdout).toContain('build');
+        expect(help.stdout).toContain('preview');
+        expect((await inProcess(['build', '--help'])).stdout).toContain('--preset <name>');
+        expect((await inProcess(['--version'])).stdout.trim()).toBe(CellCli.version);
+    });
+});
+//# sourceMappingURL=cell-cli.spec.js.map

package/lib/cli/cell-cli.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-cli.spec.js","sourceRoot":"","sources":["../../src/cli/cell-cli.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAqB,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AACxF,MAAM,oBAAoB,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC;AAElH,wDAAwD;AACxD,SAAS,IAAI,CAAC,IAAc,EAAE,GAAW;IACrC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;QACzB,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5I,CAAC,CAAC,CAAC;AACP,CAAC;AAED,oEAAoE;AACpE,KAAK,UAAU,SAAS,CAAC,IAAc,EAAE,GAAuB;IAC5D,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChI,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACpC,CAAC;AAED,0DAA0D;AAC1D,KAAK,UAAU,OAAO,CAAC,GAAW;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1B,IAAI,CAAC;YACD,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACL,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC;IACD,OAAO,EAAE,CAAC;AACd,CAAC;AAED,SAAS,QAAQ;IACb,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;QACzB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE;YACzC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,EAAsB,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,YAAoC,EAAE,MAAM,GAAG,EAAE;IACnF,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC;SACnC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;SAC5C,IAAI,CACD,oBAAoB,EACpB;QACI,iDAAiD;QACjD,+DAA+D;QAC/D,eAAe;QACf,+BAA+B;QAC/B,kEAAkE;QAClE,oBAAoB;QACpB,sBAAsB;QACtB,+BAA+B;QAC/B,OAAO;QACP,GAAG;QACH,4BAA4B;KAC/B,CAAC,IAAI,CAAC,IAAI,CAAC,CACf;SACA,IAAI,CAAC,UAAU,EAAE,qEAAqE,CAAC,CAAC;IAC7F,OAAO,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACrE,CAAC;AAED,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IACzC,IAAI,OAAuB,CAAC;IAC5B,IAAI,KAAuD,CAAC;IAC5D,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,SAAS,CAAC,KAAK,IAAI,EAAE;QACjB,OAAO,GAAG,cAAc,CACpB,SAAS,EACT,EAAE,GAAG,oBAAoB,EAAE,yBAAyB,EAAE,GAAG,EAAE,EAC3D,uLAAuL,CAC1L,CAAC;QACF,KAAK,GAAG,MAAM,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC,EAAE,KAAK,CAAC,CAAC;IAEV,QAAQ,CAAC,GAAG,EAAE;QACV,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,EAAE,CAAC;QACnB,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;YACzB,aAAa,EAAE,CAAC;YAChB,OAAO,EAAE,OAAO;YAChB,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,CAAC,YAAY,CAAC;YACpB,OAAO,EAAE,CAAC,SAAS,CAAC;YACpB,MAAM,EAAE,cAAc;YACtB,KAAK,EAAE,yDAAyD;YAChE,QAAQ,EAAE,EAAE;SACf,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/E,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+EAA+E,EAAE,KAAK,IAAI,EAAE;QAC3F,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,QAAQ,EAAE,EAAE,MAAM,QAAQ,EAAE,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,0BAA0B,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACxF,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QACpH,MAAM,CAAC,MAAM,OAAO,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACtE,MAAM,CACF,MAAM,KAAK,CAAC,oBAAoB,KAAK,EAAE,CAAC,CAAC,IAAI,CACzC,GAAG,EAAE,CAAC,IAAI,EACV,GAAG,EAAE,CAAC,KAAK,CACd,CACJ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,IAAI,GAAG,MAAM,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,0BAA0B,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,sBAAsB,EAAE,aAAa,EAAE,CAAC;QAChH,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC5F,MAAM,CAAC,MAAM,OAAO,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;QACzG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC,CAAC;IACxH,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAC9C,MAAM,QAAQ,GAAqB,EAAE,CAAC;IAEtC,QAAQ,CAAC,GAAG,EAAE;QACV,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC7B,OAAO,CAAC,OAAO,EAAE,CAAC;QACtB,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,OAAO,GAAG,cAAc,CAAC,eAAe,EAAE,oBAAoB,CAAC,CAAC;QACtE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9F,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;QACnF,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QAChE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC,EAAE,KAAK,CAAC,CAAC;IAEV,EAAE,CAAC,oGAAoG,EAAE,KAAK,IAAI,EAAE;QAChH,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,kBAAkB,CAAC;aACjD,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,YAAY,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,EAAE,CAAC;aACzF,IAAI,CAAC,gBAAgB,EAAE,6CAA6C,CAAC;aACrE,IAAI,CAAC,UAAU,EAAE,0BAA0B,CAAC,CAAC;QAClD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,MAAM,GAAG,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,mBAAmB,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,CAAC;QACvH,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC;QACnG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAC7C,6FAA6F;QAC7F,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YAC5B,MAAM,CAAC,gBAAgB,CAAC,yGAAyG,CAAC;SACrI,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,yCAAyC,CAAC,CAAC;QACpE,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,gCAAgC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IAClH,CAAC,EAAE,KAAK,CAAC,CAAC;IAEV,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,OAAO,GAAG,cAAc,CAAC,YAAY,EAAE,oBAAoB,EAAE,2DAA2D,CAAC,CAAC;QAChI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QACtF,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;QACjG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,OAAO,GAAG,cAAc,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC;QACnE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QAC/F,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QACtF,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QACxF,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,yBAAyB,EAAE,CAAC,CAAC;IACvH,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,4BAA4B,EAAE,CAAC,CAAC;QAC9H,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC;QAC5D,MAAM,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;QACrC,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACnF,MAAM,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { CheckIssue } from '@celljs/kit';
+import { Command, type CommandContext } from './command.js';
+/**
+ * `cell check`: configuration, types, decorator settings, DI bindings and module checks in one run.
+ * Exits with 1 when an error-level issue is found; `--json` lists every issue with a stable code.
+ */
+export declare class CheckCommand extends Command {
+    readonly name = "check";
+    readonly description = "Check configuration, types, decorators and DI bindings";
+    readonly options: {
+        readonly preset: {
+            readonly type: 'string';
+        };
+        readonly mode: {
+            readonly type: 'string';
+            readonly short: 'm';
+            readonly multiple: true;
+        };
+        readonly skip: {
+            readonly type: 'string';
+            readonly multiple: true;
+        };
+    };
+    readonly usage: string[];
+    run({ values, reporter, env }: CommandContext): Promise<number>;
+    /** `src/a.ts:3:5 error TS2322 message`, like compilers print. */
+    static formatIssue(issue: CheckIssue & {
+        check: string;
+    }, root: string): string;
+}
+//# sourceMappingURL=check-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check-command.d.ts","sourceRoot":"","sources":["../../src/cli/check-command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE5D;;;GAGG;AACH,qBAAa,YAAa,SAAQ,OAAO;IACrC,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,WAAW,4DAA4D;IAChF,SAAkB,OAAO;iBACrB,MAAM;;;iBACN,IAAI;;;;;iBACJ,IAAI;qBAAI,IAAI,EAAE,QAAQ;qBAAE,QAAQ;;MACzB;IACX,SAAkB,KAAK,WAIrB;IAEI,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAuCpE;IAED,iEAAiE;IACjE,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9E;CACJ"}

package/lib/cli/check-command.js

@@ -0,0 +1,67 @@
+import { relative } from 'node:path';
+import { ProjectChecker } from '../check/project-checker.js';
+import { Toolchain } from '../toolchain/toolchain.js';
+import { BuildCommand } from './build-command.js';
+import { Command } from './command.js';
+/**
+ * `cell check`: configuration, types, decorator settings, DI bindings and module checks in one run.
+ * Exits with 1 when an error-level issue is found; `--json` lists every issue with a stable code.
+ */
+export class CheckCommand extends Command {
+    name = 'check';
+    description = 'Check configuration, types, decorators and DI bindings';
+    options = {
+        preset: BuildCommand.OPTIONS.preset,
+        mode: BuildCommand.OPTIONS.mode,
+        skip: { type: 'string', multiple: true },
+    };
+    usage = [
+        '--preset <name>      preset whose entry the backend uses (default: node)',
+        '-m, --mode <mode>    extra mode, reads cell.<mode>.yml (repeatable)',
+        '--skip <check>       skip a check: config, types, decorators, di or a module check (repeatable)',
+    ];
+    async run({ values, reporter, env }) {
+        const started = performance.now();
+        const toolchain = await Toolchain.create({
+            root: values.root,
+            command: 'check',
+            flags: { preset: values.preset, mode: values.mode },
+            env,
+            quiet: reporter.json,
+            runHooks: false,
+            logger: reporter,
+        });
+        const reports = await new ProjectChecker(toolchain, { env, skip: values.skip }).run();
+        await toolchain.close();
+        const issues = reports.flatMap(report => report.issues.map(issue => ({ check: report.name, ...issue })));
+        const errors = issues.filter(issue => issue.level === 'error').length;
+        const warnings = issues.filter(issue => issue.level === 'warning').length;
+        const durationMs = Math.round(performance.now() - started);
+        const root = toolchain.config.root;
+        reporter.result('check', {
+            root,
+            passed: errors === 0,
+            // `warnings` of the result are those of the command itself; the findings are in `issues`.
+            summary: { errors, warnings, info: issues.length - errors - warnings },
+            issues,
+            checks: reports.map(({ issues: found, ...report }) => ({ ...report, issues: found.length })),
+            durationMs,
+        }, [
+            ...issues.filter(issue => issue.level !== 'info').map(issue => CheckCommand.formatIssue(issue, root)),
+            ...reports.filter(report => report.skipped).map(report => `skipped ${report.name}: ${report.skipped}`),
+            `${errors === 0 ? 'Passed' : 'Failed'}: ${errors} error${errors === 1 ? '' : 's'}, ${warnings} warning${warnings === 1 ? '' : 's'} (${reports
+                .filter(r => !r.skipped)
+                .map(r => r.name)
+                .join(', ')}) in ${durationMs}ms`,
+        ].join('\n'));
+        return errors === 0 ? 0 : 1;
+    }
+    /** `src/a.ts:3:5 error TS2322 message`, like compilers print. */
+    static formatIssue(issue, root) {
+        const where = issue.file
+            ? `${relative(root, issue.file) || issue.file}${issue.line ? `:${issue.line}${issue.column ? `:${issue.column}` : ''}` : ''} `
+            : '';
+        return `${where}${issue.level} ${issue.code} ${issue.message}${issue.hint ? `\n  fix: ${issue.hint}` : ''}`;
+    }
+}
+//# sourceMappingURL=check-command.js.map

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

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

package/lib/cli/command.d.ts

@@ -0,0 +1,24 @@
+import type { ParseArgsConfig } from 'node:util';
+export type ParseArgsOptions = NonNullable<ParseArgsConfig['options']>;
+import type { Reporter } from './reporter.js';
+export type ParsedValues = Record<string, string | boolean | string[] | undefined>;
+export interface CommandContext {
+    values: ParsedValues;
+    positionals: string[];
+    reporter: Reporter;
+    env: NodeJS.ProcessEnv;
+}
+/** One `cell <name>` command. Options are parsed with node:util `parseArgs`. */
+export declare abstract class Command {
+    abstract readonly name: string;
+    abstract readonly description: string;
+    /** Options of this command in addition to the common ones (`--root`, `--json`, `--help`). */
+    readonly options: ParseArgsOptions;
+    /** One line per option for `--help`. */
+    readonly usage: string[];
+    /** Positional arguments for `--help`, e.g. `get <key>`; commands without them reject positionals. */
+    readonly arguments: string;
+    /** Returns the process exit code. */
+    abstract run(context: CommandContext): Promise<number>;
+}
+//# sourceMappingURL=command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/cli/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;AAEvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;AAEnF,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CAC1B;AAED,gFAAgF;AAChF,8BAAsB,OAAO;IACzB,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,6FAA6F;IAC7F,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAM;IACxC,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;IAC9B,qGAAqG;IACrG,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAM;IAEhC,qCAAqC;IACrC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1D"}

package/lib/cli/command.js

@@ -0,0 +1,10 @@
+/** One `cell <name>` command. Options are parsed with node:util `parseArgs`. */
+export class Command {
+    /** Options of this command in addition to the common ones (`--root`, `--json`, `--help`). */
+    options = {};
+    /** One line per option for `--help`. */
+    usage = [];
+    /** Positional arguments for `--help`, e.g. `get <key>`; commands without them reject positionals. */
+    arguments = '';
+}
+//# sourceMappingURL=command.js.map

package/lib/cli/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/cli/command.ts"],"names":[],"mappings":"AAeA,gFAAgF;AAChF,MAAM,OAAgB,OAAO;IAGzB,6FAA6F;IACpF,OAAO,GAAqB,EAAE,CAAC;IACxC,wCAAwC;IAC/B,KAAK,GAAa,EAAE,CAAC;IAC9B,qGAAqG;IAC5F,SAAS,GAAW,EAAE,CAAC;CAInC"}

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

@@ -0,0 +1,29 @@
+import { type ConfigValue } from '../config/config-explainer.js';
+import { Command, type CommandContext } from './command.js';
+/**
+ * `cell config get <key>`: one value of the merged application configuration (cell*.yml of every
+ * component and the active modes, then `CELL_<TARGET>__*` variables), with the files and variables
+ * that set it. Read-only, like `cell info`.
+ */
+export declare class ConfigCommand extends Command {
+    readonly name = "config";
+    readonly description = "Show a configuration value and where it comes from";
+    readonly arguments = "get <key>";
+    readonly options: {
+        readonly mode: {
+            readonly type: 'string';
+            readonly short: 'm';
+            readonly multiple: true;
+        };
+        readonly target: {
+            readonly type: 'string';
+        };
+        readonly why: {
+            readonly type: 'boolean';
+        };
+    };
+    readonly usage: string[];
+    run({ values, positionals, reporter, env }: CommandContext): Promise<number>;
+    static format(result: ConfigValue, why: boolean): string;
+}
+//# sourceMappingURL=config-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-command.d.ts","sourceRoot":"","sources":["../../src/cli/config-command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAGlF,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE5D;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACtC,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,wDAAwD;IAC5E,SAAkB,SAAS,eAAe;IAC1C,SAAkB,OAAO;iBACrB,IAAI;;;;;iBACJ,MAAM;qBAAI,IAAI,EAAE,QAAQ;;iBACxB,GAAG;qBAAI,IAAI,EAAE,SAAS;;MACf;IACX,SAAkB,KAAK,WAIrB;IAEI,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA+BjF;IAED,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAWvD;CACJ"}

package/lib/cli/config-command.js

@@ -0,0 +1,71 @@
+import { CellError } from '@celljs/kit';
+import { ProjectLoader } from '@celljs/vite';
+import { ConfigExplainer } from '../config/config-explainer.js';
+import { Toolchain } from '../toolchain/toolchain.js';
+import { BuildCommand } from './build-command.js';
+import { Command } from './command.js';
+/**
+ * `cell config get <key>`: one value of the merged application configuration (cell*.yml of every
+ * component and the active modes, then `CELL_<TARGET>__*` variables), with the files and variables
+ * that set it. Read-only, like `cell info`.
+ */
+export class ConfigCommand extends Command {
+    name = 'config';
+    description = 'Show a configuration value and where it comes from';
+    arguments = 'get <key>';
+    options = {
+        mode: BuildCommand.OPTIONS.mode,
+        target: { type: 'string' },
+        why: { type: 'boolean' },
+    };
+    usage = [
+        '-m, --mode <mode>    extra mode, reads cell.<mode>.yml (repeatable)',
+        '--target <target>    backend or frontend (default: backend, else frontend)',
+        '--why                list the files and variables that set the value',
+    ];
+    async run({ values, positionals, reporter, env }) {
+        const [action, key, ...rest] = positionals;
+        if (action !== 'get' || key === undefined || rest.length > 0) {
+            throw new CellError({
+                code: 'CELL_ARGUMENT_INVALID',
+                message: action === 'get' ? 'cell config get takes one key.' : `Unknown config action '${action ?? ''}'.`,
+                hint: 'Use cell config get <key>, e.g. cell config get cell.server.port.',
+            });
+        }
+        const target = values.target;
+        if (target !== undefined && target !== 'backend' && target !== 'frontend') {
+            throw new CellError({
+                code: 'CELL_ARGUMENT_INVALID',
+                message: `Invalid --target '${target}'.`,
+                hint: 'Use --target backend or --target frontend.',
+            });
+        }
+        const toolchain = await Toolchain.create({
+            root: values.root,
+            command: 'config',
+            flags: { mode: values.mode },
+            env,
+            quiet: reporter.json,
+            runHooks: false,
+            logger: reporter,
+        });
+        await toolchain.close();
+        const model = new ProjectLoader({ ...toolchain.projectOptions(), env }).load();
+        const result = new ConfigExplainer(model, env).explain(key, target);
+        reporter.result('config', { ...result }, ConfigCommand.format(result, values.why === true));
+        return 0;
+    }
+    static format(result, why) {
+        const value = typeof result.value === 'string' ? result.value : JSON.stringify(result.value, null, 2);
+        if (!why) {
+            return value;
+        }
+        return [
+            `${result.key} (${result.target}) = ${value}`,
+            ...result.layers.map(layer => `  ${layer.file}${layer.section === 'shared' ? '' : ` [${layer.section}]`}: ${JSON.stringify(layer.value)}`),
+            ...result.env.map(({ variable, path }) => `  ${variable} → ${path}`),
+            ...(result.expressions ? ['  ${...} is evaluated by the server at startup'] : []),
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=config-command.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,79 @@
+import { afterAll, describe, expect, it } from 'bun:test';
+import { FixtureProject } from '../test/fixture-project.js';
+import { CellCli } from './cell-cli.js';
+async function cell(args, env = {}) {
+    let stdout = '';
+    let stderr = '';
+    const code = await new CellCli({
+        stdout: { write: s => (stdout += s) },
+        stderr: { write: s => (stderr += s) },
+        env: { PATH: process.env.PATH, ...env },
+    }).run(args);
+    return { code, stdout, stderr, json: args.includes('--json') ? JSON.parse(stdout) : undefined };
+}
+describe('cell config get', () => {
+    const fixture = new FixtureProject('cli-config')
+        .file('package.json', { name: 'cli-config', dependencies: { '@x/server': '*', '@x/ui': '*' } })
+        .dependency('@x/server', { cell: {} }, { 'cell.yml': 'cell:\n  server:\n    port: 3000\n    host: 0.0.0.0\n' })
+        .dependency('@x/ui', { cell: { targets: ['frontend'] } }, { 'cell.yml': 'frontend:\n  cell:\n    title: UI\n' })
+        .file('cell.yml', 'backend:\n  cell:\n    server:\n      port: 8080\n    secret: "${env.SECRET}"\n    items:\n      - name: a\n')
+        .file('cell.staging.yml', 'cell:\n  server:\n    port: 9090\n');
+    const root = ['--root', fixture.root];
+    afterAll(() => fixture.dispose());
+    it('prints the merged value and, with --why, the files that set it in merge order', async () => {
+        expect((await cell(['config', 'get', 'cell.server.port', ...root])).stdout).toBe('8080\n');
+        const { stdout } = await cell(['config', 'get', 'cell.server.port', '--why', '-m', 'staging', ...root]);
+        expect(stdout).toBe([
+            // The backend section wins over shared keys of any file, as the merge does.
+            'cell.server.port (backend) = 8080',
+            '  node_modules/@x/server/cell.yml: 3000',
+            '  cell.staging.yml: 9090',
+            '  cell.yml [backend]: 8080',
+            '',
+        ].join('\n'));
+    });
+    it('reports layers, environment variables and unevaluated expressions as JSON', async () => {
+        const { code, json } = await cell(['config', 'get', 'cell.server', '--json', ...root], { CELL_BACKEND__SERVER__PORT: '7000' });
+        expect(code).toBe(0);
+        expect(json).toMatchObject({
+            command: 'config',
+            ok: true,
+            key: 'cell.server',
+            target: 'backend',
+            value: { port: 7000, host: '0.0.0.0' },
+            layers: [
+                { file: 'node_modules/@x/server/cell.yml', component: '@x/server', section: 'shared', value: { port: 3000, host: '0.0.0.0' } },
+                { file: 'cell.yml', component: 'cli-config', section: 'backend', value: { port: 8080 } },
+            ],
+            env: [{ variable: 'CELL_BACKEND__SERVER__PORT', path: 'cell.server.port' }],
+            expressions: false,
+        });
+        expect((await cell(['config', 'get', 'cell.secret', '--json', ...root])).json).toMatchObject({ value: '${env.SECRET}', expressions: true });
+        expect((await cell(['config', 'get', 'cell.items[0].name', '--json', ...root])).json).toMatchObject({ key: 'cell.items.0.name', value: 'a' });
+    });
+    it('reads the frontend with --target frontend, with its expressions evaluated', async () => {
+        const { json } = await cell(['config', 'get', 'cell.title', '--target', 'frontend', '--json', ...root], { CELL_FRONTEND__TITLE: 'Shop' });
+        expect(json).toMatchObject({
+            target: 'frontend',
+            value: 'Shop',
+            layers: [{ file: 'node_modules/@x/ui/cell.yml', section: 'frontend', value: 'UI' }],
+            env: [{ variable: 'CELL_FRONTEND__TITLE' }],
+        });
+    });
+    it('suggests the nearest key when one is missing', async () => {
+        const typo = await cell(['config', 'get', 'cell.server.prot', '--json', ...root]);
+        expect(typo.code).toBe(1);
+        expect(typo.json.error).toMatchObject({ code: 'CELL_CONFIG_KEY_NOT_FOUND', hint: "Did you mean 'cell.server.port'?" });
+        const deep = await cell(['config', 'get', 'cell.nothing.here', '--json', ...root]);
+        expect(deep.json.error.message).toBe("No key 'cell.nothing.here' in the backend configuration: 'nothing' is not under cell.");
+        expect(deep.json.error.hint).toStartWith('Keys under cell: ');
+    });
+    it('rejects invalid usage with exit code 2', async () => {
+        expect((await cell(['config', 'set', 'a', ...root])).code).toBe(2);
+        expect((await cell(['config', 'get', ...root])).code).toBe(2);
+        expect((await cell(['config', 'get', 'a', '--target', 'mobile', ...root])).code).toBe(2);
+        expect((await cell(['info', 'extra', ...root])).code).toBe(2);
+        expect((await cell(['config', '--help'])).stdout).toStartWith('Usage: cell config get <key> [options]');
+    });
+});
+//# sourceMappingURL=config-command.spec.js.map

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

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

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

@@ -0,0 +1,41 @@
+import { type Deployment, type DeployPlan, type OutputManifest } from '@celljs/kit';
+import { Toolchain } from '../toolchain/toolchain.js';
+import { Command, type CommandContext } 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 declare class DeployCommand extends Command {
+    readonly name = "deploy";
+    readonly description = "Build and deploy the application (--dry-run to only plan)";
+    readonly options: {
+        readonly preset: {
+            readonly type: 'string';
+        };
+        readonly mode: {
+            readonly type: 'string';
+            readonly short: 'm';
+            readonly multiple: true;
+        };
+        readonly sourcemap: {
+            readonly type: 'boolean';
+        };
+        readonly 'out-dir': {
+            readonly type: 'string';
+        };
+        readonly 'dry-run': {
+            readonly type: 'boolean';
+        };
+        readonly 'skip-build': {
+            readonly type: 'boolean';
+        };
+    };
+    readonly usage: string[];
+    run({ values, reporter, env }: CommandContext): Promise<number>;
+    /** `--skip-build`: the output must exist and come from the preset this run chose. */
+    protected existingOutput(toolchain: Toolchain, outDir: string): OutputManifest;
+    /** Presets that have a deployer, for hints. */
+    static deployable(toolchain: Toolchain): string[];
+    static describe(plan: DeployPlan, deployment?: Deployment): string;
+}
+//# sourceMappingURL=deploy-command.d.ts.map