@celljs/cli 3.9.0 → 4.0.0

package/lib/info/project-inspector.js

@@ -0,0 +1,244 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { basename, isAbsolute, join, relative } from 'node:path';
+import { ProjectLoader } from '@celljs/vite';
+import { ConfigResolver } from '../config/config-resolver.js';
+import { TextUtil } from '../utils/text-util.js';
+/**
+ * Describes a project from its resolved toolchain configuration and the project model. Reads
+ * package.json, cell*.yml and manifest.json only: no project code runs and nothing is built, so it
+ * returns quickly and is safe to call from agents and editors (docs/design/agent-first.md R2).
+ */
+export class ProjectInspector {
+    config;
+    preset;
+    presets;
+    contributions;
+    static COMMAND_MODES = ['production', 'development'];
+    static MODE_FILE = /^cell\.([\w-]+)\.yml$/;
+    /** What `cell info` warns about, with stable codes for `cell check`. */
+    issues = [];
+    get warnings() {
+        return this.issues.map(issue => issue.message);
+    }
+    warn(code, message, file) {
+        this.issues.push({ level: 'warning', code, message, ...(file ? { file } : {}) });
+    }
+    constructor(config, preset, presets, 
+    /** What toolchain modules contributed: project options (DI modules, entries) and their registrations. */
+    contributions = {}) {
+        this.config = config;
+        this.preset = preset;
+        this.presets = presets;
+        this.contributions = contributions;
+    }
+    inspect(options = {}) {
+        const { config, preset } = this;
+        const projectOptions = this.contributions.projectOptions ?? ConfigResolver.toProjectOptions(config, preset);
+        const model = new ProjectLoader({ ...projectOptions, env: options.env }).load();
+        const project = model.components[model.components.length - 1];
+        const info = {
+            root: config.root,
+            name: project.name,
+            version: project.version,
+            cellVersion: options.cellVersion ?? '',
+            ...(config.file ? { configFile: this.relative(config.file) } : {}),
+            preset: {
+                name: preset.name,
+                source: config.preset.source,
+                ...(preset.description ? { description: preset.description } : {}),
+                ...(preset.entry ? { entry: preset.entry } : {}),
+                ...(preset.format ? { format: preset.format } : {}),
+                ...(preset.runtime ? { runtime: preset.runtime } : {}),
+                ...(preset.deployer ? { deployer: preset.deployer } : {}),
+                available: this.presets,
+            },
+            mode: config.mode,
+            targets: model.targets,
+            targetSources: this.targetSources(model),
+            build: {
+                format: ConfigResolver.format(config, preset),
+                outDir: config.build.outDir,
+                external: config.build.external,
+                sourcemap: config.build.sourcemap,
+                single: config.build.single,
+                compile: config.build.compile,
+            },
+            components: model.components.map(c => this.component(c)),
+            hooks: { ...config.hooks },
+            modules: config.modules.map(spec => (spec.kind === 'local' ? { ...spec, path: this.relative(spec.path) } : spec)),
+            moduleOptions: Object.keys(config.options),
+            toolchainModules: (this.contributions.modules ?? []).map(m => ({ ...m, file: this.relative(m.file) })),
+            output: this.output(),
+        };
+        for (const target of model.targets) {
+            info[target] = this.target(model[target], options.appConfig ?? false);
+        }
+        this.check(model);
+        return info;
+    }
+    /** The human form of {@link ProjectInfo}: a short summary; `--json` has the details. */
+    static format(info) {
+        const rows = [
+            ['config', info.configFile ?? 'none (defaults)'],
+            ['preset', `${info.preset.name} (${info.preset.source})${info.preset.description ? `: ${info.preset.description}` : ''}, ${info.build.format}`],
+            ['mode', info.mode.join(', ')],
+            ['targets', info.targets.map(t => `${t} (${info.targetSources[t]?.join(', ')})`).join(', ')],
+        ];
+        for (const target of info.targets) {
+            const summary = info[target];
+            const count = summary.staticModules.length + summary.modules.length;
+            const entry = target === 'backend' && !summary.entryComponent ? `${summary.entry} (default entry)` : summary.entry;
+            rows.push([target, `${entry}, ${count} DI module${count === 1 ? '' : 's'}`]);
+        }
+        const overrides = info.targets.flatMap(target => info[target].envOverrides?.applied ?? []);
+        if (overrides.length > 0) {
+            rows.push(['env', overrides.map(({ variable, path }) => `${variable} → ${path}`).join(', ')]);
+        }
+        const hooks = Object.entries(info.hooks);
+        rows.push(['hooks', hooks.length > 0 ? hooks.map(([event, command]) => `${event} → ${command}`).join('; ') : 'none']);
+        if (info.modules.length > 0) {
+            rows.push(['modules', info.modules.map(spec => ProjectInspector.formatModule(spec)).join(', ')]);
+        }
+        if (info.toolchainModules.length > 0) {
+            rows.push(['toolchain', info.toolchainModules.map(m => ProjectInspector.formatToolchainModule(m)).join(', ')]);
+        }
+        const { output } = info;
+        rows.push([
+            'output',
+            output.built
+                ? `${output.dir} (built: ${output.preset ?? 'no preset'}, ${output.format}, ${output.targets?.join(' + ')})`
+                : `${output.dir} (not built)`,
+        ]);
+        rows.push(['components', String(info.components.length)]);
+        const width = Math.max(...rows.map(([label]) => label.length)) + 2;
+        return [
+            `${info.name} ${info.version}  ${info.root}`,
+            ...rows.map(([label, value]) => `  ${label.padEnd(width)}${value}`),
+            ...info.components.map(c => `    ${c.name} ${c.version}${c.root ? ' (project)' : ''}`),
+            '',
+            'Details: cell info --json (add --app-config for the merged cell.yml)',
+        ].join('\n');
+    }
+    static missingEntryWarning(preset) {
+        return `No component provides the '${preset.entry}' entry of the ${preset.name} preset, so the backend starts the application without a server. Add @celljs/express-adapter to dependencies for an HTTP server, or use the cli preset for a command-line application.`;
+    }
+    static envProblemWarning(target, problem) {
+        return `${problem.variable} is ignored${target === 'backend' ? ' by the server' : ''}: ${problem.message}`;
+    }
+    /** `@x/ui (2 vite plugins, 1 check)`: what a module registered, counted. */
+    static formatToolchainModule(module) {
+        const counts = [
+            [module.vitePlugins.length, 'vite plugin', 'vite plugins'],
+            [module.runtimeModules.length, 'DI module', 'DI modules'],
+            [module.virtualModules.length, 'virtual module', 'virtual modules'],
+            [Object.keys(module.entries).length, 'entry', 'entries'],
+            [module.devHandlers.length, 'dev handler', 'dev handlers'],
+            [module.presets.length, 'preset', 'presets'],
+            [module.outputFiles.length, 'output file', 'output files'],
+            [module.checks.length, 'check', 'checks'],
+            [module.mcpTools.length, 'MCP tool', 'MCP tools'],
+            [module.docs.length, 'docs dir', 'docs dirs'],
+            [module.events.length, 'event', 'events'],
+        ];
+        const parts = counts.filter(([n]) => n > 0).map(([n, one, many]) => `${n} ${n === 1 ? one : many}`);
+        return parts.length > 0 ? `${module.name} (${parts.join(', ')})` : module.name;
+    }
+    static formatModule(spec) {
+        switch (spec.kind) {
+            case 'local':
+                return spec.path;
+            case 'package':
+                return spec.name;
+            case 'disabled':
+                return `!${spec.name}`;
+            case 'filter':
+                return `${spec.name} (${[spec.runtime ? '' : 'runtime: false', spec.toolchain ? '' : 'toolchain: false'].filter(Boolean).join(', ')})`;
+        }
+    }
+    targetSources(model) {
+        const sources = {};
+        for (const target of model.targets) {
+            if (this.config.targets) {
+                sources[target] = [this.config.file ? basename(this.config.file) : 'cell.config.ts'];
+                continue;
+            }
+            const declaring = model.components.filter(c => c.targets.includes(target)).map(c => c.name);
+            sources[target] = target === 'backend' ? ['default', ...declaring] : declaring;
+        }
+        return sources;
+    }
+    component(component) {
+        const { name, version, dir, root, configFiles, targets, entries, toolchain, optionalDependencies } = component;
+        return {
+            name,
+            version,
+            dir: this.relative(dir) || '.',
+            ...(root ? { root: true } : {}),
+            configFiles: configFiles.map(file => this.relative(file)),
+            ...(targets.length > 0 ? { targets } : {}),
+            ...(Object.keys(entries).length > 0 ? { entries } : {}),
+            ...(toolchain ? { toolchain } : {}),
+            ...(optionalDependencies.length > 0 ? { optionalDependencies } : {}),
+        };
+    }
+    target(model, appConfig) {
+        const specifier = (s) => (isAbsolute(s) ? this.relative(s) : s);
+        return {
+            entry: specifier(model.entry),
+            ...(model.entryComponent ? { entryComponent: model.entryComponent } : {}),
+            staticModules: model.staticModules.map(m => specifier(m.specifier)),
+            modules: model.modules.map(m => specifier(m.specifier)),
+            ...(appConfig ? { config: model.config } : {}),
+            ...(model.envOverrides.applied.length + model.envOverrides.problems.length > 0 ? { envOverrides: model.envOverrides } : {}),
+        };
+    }
+    output() {
+        const dir = this.config.build.outDir;
+        const file = join(this.config.root, dir, 'manifest.json');
+        if (!existsSync(file)) {
+            return { dir, built: false };
+        }
+        try {
+            const { preset, format, targets, server, public: publicDir } = JSON.parse(readFileSync(file, 'utf8'));
+            return { dir, built: true, preset, format, targets, server, public: publicDir };
+        }
+        catch {
+            this.warn('CELL_OUTPUT_UNREADABLE', `${this.relative(file)} cannot be read; run \`cell build\` to write it again.`, file);
+            return { dir, built: false };
+        }
+    }
+    /** Settings that `cell build` would accept but that change nothing or fail: say so before the build does. */
+    check(model) {
+        if (model.backend && !model.backend.entryComponent && this.preset.entry) {
+            this.warn('CELL_ENTRY_MISSING', ProjectInspector.missingEntryWarning(this.preset), join(this.config.root, 'package.json'));
+        }
+        const available = this.availableModes(model);
+        for (const mode of this.config.mode) {
+            if (!ProjectInspector.COMMAND_MODES.includes(mode) && !available.includes(mode)) {
+                const suggestion = TextUtil.closest(mode, available);
+                this.warn('CELL_MODE_UNKNOWN', `Mode '${mode}' changes nothing: neither the project nor its components have cell.${mode}.yml.${suggestion ? ` Did you mean '${suggestion}'?` : ''}`);
+            }
+        }
+        for (const target of model.targets) {
+            const { applied, problems } = model[target].envOverrides;
+            for (const problem of problems) {
+                this.warn('CELL_ENV_OVERRIDE_IGNORED', ProjectInspector.envProblemWarning(target, problem));
+            }
+            for (const { variable, path, shadows } of applied) {
+                if (shadows) {
+                    const explicit = variable.replace(/^(CELL_[A-Z]+__)/, '$1CELL__');
+                    this.warn('CELL_ENV_OVERRIDE_SHADOWS', `${variable} sets ${path}, not ${shadows}: the top-level key comes first. Use ${explicit} for ${shadows}.`);
+                }
+            }
+        }
+    }
+    /** Modes with a `cell.<mode>.yml` in the project or any of its components, active or not. */
+    availableModes(model) {
+        const modes = model.components.flatMap(c => readdirSync(c.dir).flatMap(file => ProjectInspector.MODE_FILE.exec(file)?.[1] ?? []));
+        return [...new Set(modes)];
+    }
+    relative(path) {
+        return relative(this.config.root, path);
+    }
+}
+//# sourceMappingURL=project-inspector.js.map

package/lib/info/project-inspector.js.map

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

package/lib/init/project-initializer.d.ts

@@ -0,0 +1,44 @@
+export interface TemplateInfo {
+    name: string;
+    description: string;
+}
+export interface InitResult {
+    template: string;
+    name: string;
+    /** Absolute project directory. */
+    dir: string;
+    /** Files created, relative to the project directory. */
+    files: string[];
+    /** Commands to run next, from the current directory. */
+    next: string[];
+}
+/**
+ * `cell init`: copies a template of @celljs/cli into a new directory, with the project name and the
+ * Cell version filled in, and adds what coding agents need: AGENTS.md, the cell skill, a CLAUDE.md
+ * that includes AGENTS.md and an MCP configuration for `cell mcp` (docs/design/agent-first.md §3).
+ */
+export declare class ProjectInitializer {
+    protected readonly version: string;
+    static readonly TEMPLATES: string;
+    /** Files whose names npm would drop or rename when publishing. */
+    static readonly RENAMED: Record<string, string>;
+    static readonly MCP_CONFIG: {
+        mcpServers: {
+            cell: {
+                command: string;
+                args: string[];
+            };
+        };
+    };
+    constructor(version: string);
+    static templates(): TemplateInfo[];
+    /** npm package names are lowercase, without spaces, at most 214 characters. */
+    static packageName(dir: string): string;
+    init(template: string, dir: string, options?: {
+        name?: string;
+        force?: boolean;
+        cwd?: string;
+    }): InitResult;
+    protected static walk(dir: string): string[];
+}
+//# sourceMappingURL=project-initializer.d.ts.map

package/lib/init/project-initializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-initializer.d.ts","sourceRoot":"","sources":["../../src/init/project-initializer.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,wDAAwD;IACxD,IAAI,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,kBAAkB;IAMf,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM;IAL9C,MAAM,CAAC,QAAQ,CAAC,SAAS,SAA8D;IACvF,kEAAkE;IAClE,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAgC;IAC/E,MAAM,CAAC,QAAQ,CAAC,UAAU;QAAK,UAAU;YAAI,IAAI;gBAAI,OAAO;gBAAS,IAAI;;;MAAwB;IAEjG,YAA+B,OAAO,EAAE,MAAM,EAAI;IAElD,MAAM,CAAC,SAAS,IAAI,YAAY,EAAE,CAKjC;IAED,+EAA+E;IAC/E,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKtC;IAED,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,UAAU,CAsD9G;IAED,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAE3C;CACJ"}

package/lib/init/project-initializer.js

@@ -0,0 +1,90 @@
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, statSync, writeFileSync } from 'node:fs';
+import { basename, join, relative, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { CellError } from '@celljs/kit';
+import { AgentGuide } from '../agent/agent-guide.js';
+import { TextUtil } from '../utils/text-util.js';
+/**
+ * `cell init`: copies a template of @celljs/cli into a new directory, with the project name and the
+ * Cell version filled in, and adds what coding agents need: AGENTS.md, the cell skill, a CLAUDE.md
+ * that includes AGENTS.md and an MCP configuration for `cell mcp` (docs/design/agent-first.md §3).
+ */
+export class ProjectInitializer {
+    version;
+    static TEMPLATES = fileURLToPath(new URL('../../templates', import.meta.url));
+    /** Files whose names npm would drop or rename when publishing. */
+    static RENAMED = { _gitignore: '.gitignore' };
+    static MCP_CONFIG = { mcpServers: { cell: { command: 'npx', args: ['cell', 'mcp'] } } };
+    constructor(version) {
+        this.version = version;
+    }
+    static templates() {
+        return readdirSync(ProjectInitializer.TEMPLATES)
+            .filter(name => existsSync(join(ProjectInitializer.TEMPLATES, name, 'template.json')))
+            .sort()
+            .map(name => ({ name, description: JSON.parse(readFileSync(join(ProjectInitializer.TEMPLATES, name, 'template.json'), 'utf8')).description }));
+    }
+    /** npm package names are lowercase, without spaces, at most 214 characters. */
+    static packageName(dir) {
+        return basename(dir)
+            .toLowerCase()
+            .replace(/[^a-z0-9._~-]+/g, '-')
+            .replace(/^[._-]+|-+$/g, '');
+    }
+    init(template, dir, options = {}) {
+        const templates = ProjectInitializer.templates();
+        if (!templates.some(t => t.name === template)) {
+            const suggestion = TextUtil.closest(template, templates.map(t => t.name));
+            throw new CellError({
+                code: 'CELL_TEMPLATE_NOT_FOUND',
+                message: `Unknown template '${template}'.`,
+                hint: suggestion ? `Did you mean '${suggestion}'?` : `Templates: ${templates.map(t => t.name).join(', ')}.`,
+            });
+        }
+        const target = resolve(options.cwd ?? process.cwd(), dir);
+        const name = options.name ?? ProjectInitializer.packageName(target);
+        if (!/^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/.test(name) || name.length > 214) {
+            throw new CellError({
+                code: 'CELL_ARGUMENT_INVALID',
+                message: `'${name}' is not a valid package name.`,
+                hint: 'Pass --name with lowercase letters, digits, - and . (e.g. --name my-app).',
+            });
+        }
+        if (existsSync(target) && (!statSync(target).isDirectory() || readdirSync(target).length > 0) && !options.force) {
+            throw new CellError({
+                code: 'CELL_INIT_NOT_EMPTY',
+                message: `${target} exists and is not empty.`,
+                hint: 'Choose a new directory, or pass --force to write the template files into it (files with the same names are replaced).',
+            });
+        }
+        mkdirSync(target, { recursive: true });
+        const source = join(ProjectInitializer.TEMPLATES, template);
+        cpSync(source, target, { recursive: true, filter: file => basename(file) !== 'template.json' });
+        const files = [];
+        for (const file of ProjectInitializer.walk(source).filter(f => basename(f) !== 'template.json')) {
+            const rel = relative(source, file);
+            const renamed = join(target, ...rel.split(/[\\/]/).map(part => ProjectInitializer.RENAMED[part] ?? part));
+            if (renamed !== join(target, rel)) {
+                renameSync(join(target, rel), renamed);
+            }
+            writeFileSync(renamed, readFileSync(renamed, 'utf8').replaceAll('{{name}}', name).replaceAll('{{cellVersion}}', this.version));
+            files.push(relative(target, renamed));
+        }
+        files.push(...new AgentGuide(target, this.version).sync([]).files);
+        writeFileSync(join(target, 'CLAUDE.md'), '@AGENTS.md\n');
+        writeFileSync(join(target, '.mcp.json'), `${JSON.stringify(ProjectInitializer.MCP_CONFIG, null, 2)}\n`);
+        files.push('CLAUDE.md', '.mcp.json');
+        const cd = relative(options.cwd ?? process.cwd(), target) || '.';
+        return {
+            template,
+            name,
+            dir: target,
+            files: files.map(f => f.split('\\').join('/')).sort(),
+            next: [...(cd === '.' ? [] : [`cd ${cd}`]), 'npm install', 'npx cell agent sync', 'npx cell dev'],
+        };
+    }
+    static walk(dir) {
+        return readdirSync(dir, { recursive: true }).map(name => join(dir, name)).filter(file => statSync(file).isFile());
+    }
+}
+//# sourceMappingURL=project-initializer.js.map

package/lib/init/project-initializer.js.map

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

package/lib/init/project-initializer.spec.d.ts

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

package/lib/init/project-initializer.spec.d.ts.map

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

package/lib/init/project-initializer.spec.js

@@ -0,0 +1,88 @@
+import { afterAll, describe, expect, it } from 'bun:test';
+import { spawnSync } from 'node:child_process';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { CellCli } from '../cli/cell-cli.js';
+import { FixtureProject } from '../test/fixture-project.js';
+import { ProjectInitializer } from './project-initializer.js';
+async function cell(args) {
+    let stdout = '';
+    const code = await new CellCli({ stdout: { write: s => (stdout += s) }, stderr: { write: () => true }, env: process.env }).run(args);
+    return { code, stdout, json: args.includes('--json') ? JSON.parse(stdout) : undefined };
+}
+describe('cell init', () => {
+    // Inside the package, so that the new projects resolve @celljs/* from the repository.
+    const base = new FixtureProject('cli-init');
+    afterAll(() => base.dispose());
+    it('lists the templates', async () => {
+        const { json } = await cell(['init', '--json']);
+        expect(json.templates.map((t) => t.name)).toEqual(['backend', 'fullstack']);
+        expect((await cell(['init'])).stdout).toContain('backend    REST API');
+    });
+    for (const template of ['backend', 'fullstack']) {
+        it(`creates a ${template} project whose tests, cell check and build pass`, async () => {
+            const { code, json } = await cell(['init', template, `${template}-app`, '--root', base.root, '--json']);
+            expect(code).toBe(0);
+            const dir = base.path(`${template}-app`);
+            expect(json).toMatchObject({
+                template,
+                name: `${template}-app`,
+                dir,
+                next: [`cd ${template}-app`, 'npm install', 'npx cell agent sync', 'npx cell dev'],
+            });
+            expect(json.files).toEqual(expect.arrayContaining([
+                '.gitignore',
+                '.mcp.json',
+                'AGENTS.md',
+                'CLAUDE.md',
+                '.agents/skills/cell/SKILL.md',
+                'package.json',
+                'test/app.spec.ts',
+            ]));
+            const pkg = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+            expect(pkg.name).toBe(`${template}-app`);
+            expect(pkg.dependencies['@celljs/core']).toBe(`^${CellCli.version}`);
+            expect(readFileSync(join(dir, 'AGENTS.md'), 'utf8')).toContain(`This project uses Cell ${CellCli.version}`);
+            expect(JSON.parse(readFileSync(join(dir, '.mcp.json'), 'utf8'))).toEqual(ProjectInitializer.MCP_CONFIG);
+            expect(spawnSync('bun', ['test', './test'], { cwd: dir, encoding: 'utf8' }).status).toBe(0);
+            expect((await cell(['check', '--root', dir, '--json'])).json).toMatchObject({ passed: true });
+            expect((await cell(['build', '--root', dir, '--json'])).json).toMatchObject({ ok: true });
+        }, 120000);
+    }
+    it('refuses a directory that is not empty unless --force, and checks the template and the name', async () => {
+        base.file('taken/file.txt', 'x');
+        const taken = await cell(['init', 'backend', 'taken', '--root', base.root, '--json']);
+        expect(taken.json.error.code).toBe('CELL_INIT_NOT_EMPTY');
+        expect((await cell(['init', 'backend', 'taken', '--root', base.root, '--force', '--json'])).code).toBe(0);
+        expect(existsSync(base.path('taken/file.txt'))).toBe(true);
+        expect((await cell(['init', 'backnd', 'x', '--root', base.root, '--json'])).json.error).toMatchObject({
+            code: 'CELL_TEMPLATE_NOT_FOUND',
+            hint: "Did you mean 'backend'?",
+        });
+        expect((await cell(['init', 'backend', 'y', '--name', 'Bad Name', '--root', base.root, '--json'])).code).toBe(2);
+        expect(ProjectInitializer.packageName('/tmp/My App')).toBe('my-app');
+    });
+});
+describe('cell agent sync', () => {
+    const fixture = new FixtureProject('cli-agent')
+        .file('package.json', { name: 'cli-agent', dependencies: { '@x/orm': '*' } })
+        .dependency('@x/orm', { cell: {} }, { 'AGENTS.md': '# ORM\n\nUse @Transactional.\n' })
+        .file('AGENTS.md', '# My project\n\nKeep this.\n');
+    afterAll(() => fixture.dispose());
+    it('writes the guide between markers, keeps the rest of AGENTS.md, and adds the guides of components', async () => {
+        const { json } = await cell(['agent', 'sync', '--root', fixture.root, '--json']);
+        expect(json).toMatchObject({ files: ['AGENTS.md', '.agents/skills/cell/SKILL.md'], snippets: ['@x/orm'] });
+        const agents = readFileSync(fixture.path('AGENTS.md'), 'utf8');
+        expect(agents).toStartWith('# My project\n\nKeep this.\n\n<!-- cell:begin');
+        expect(agents).toContain('### @x/orm\n\n## ORM\n\nUse @Transactional.');
+        // Again: the block is replaced, not added twice.
+        writeFileSync(fixture.path('AGENTS.md'), `${agents}\nMore of mine.\n`);
+        await cell(['agent', 'sync', '--root', fixture.root]);
+        const again = readFileSync(fixture.path('AGENTS.md'), 'utf8');
+        expect(again.split('<!-- cell:begin')).toHaveLength(2);
+        expect(again).toEndWith('More of mine.\n');
+        expect(readFileSync(fixture.path('.agents/skills/cell/SKILL.md'), 'utf8')).toStartWith('---\nname: cell\n');
+        expect((await cell(['agent', 'pull', '--root', fixture.root])).code).toBe(2);
+    });
+});
+//# sourceMappingURL=project-initializer.spec.js.map

package/lib/init/project-initializer.spec.js.map

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

package/lib/mcp/dev-activity.d.ts

@@ -0,0 +1,34 @@
+import type { CellError } from '@celljs/kit';
+import type { DevRequestRecord } from '@celljs/vite';
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface DevLogRecord {
+    time: string;
+    level: LogLevel;
+    message: string;
+}
+export interface DevErrorRecord {
+    time: string;
+    /** Files whose change led to the failed reload; empty for a start. */
+    files: string[];
+    error: ReturnType<CellError['toJSON']>;
+}
+/**
+ * What happened in `cell dev`, for the dev MCP endpoint: backend requests, start errors and console
+ * output, each kept to the last few hundred entries. Lives across restarts of the dev server.
+ */
+export declare class DevActivity {
+    static readonly MAX_REQUESTS = 200;
+    static readonly MAX_ERRORS = 20;
+    static readonly MAX_LOGS = 1000;
+    static readonly LEVELS: LogLevel[];
+    readonly requests: DevRequestRecord[];
+    readonly errors: DevErrorRecord[];
+    readonly logs: DevLogRecord[];
+    recordRequest(record: DevRequestRecord): void;
+    recordError(error: CellError, files?: string[]): void;
+    recordLog(level: LogLevel, message: string): void;
+    /** Copies console output into {@link logs}, still printing it; returns the function that stops. */
+    captureConsole(): () => void;
+    protected static push<T>(list: T[], item: T, max: number): void;
+}
+//# sourceMappingURL=dev-activity.d.ts.map

package/lib/mcp/dev-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-activity.d.ts","sourceRoot":"","sources":["../../src/mcp/dev-activity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,qBAAa,WAAW;IACpB,MAAM,CAAC,QAAQ,CAAC,YAAY,OAAO;IACnC,MAAM,CAAC,QAAQ,CAAC,UAAU,MAAM;IAChC,MAAM,CAAC,QAAQ,CAAC,QAAQ,QAAQ;IAChC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAsC;IAExE,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAM;IAC3C,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,CAAM;IACvC,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,CAAM;IAEnC,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAE5C;IAED,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,GAAE,MAAM,EAAO,GAAG,IAAI,CAExD;IAED,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhD;IAED,mGAAmG;IACnG,cAAc,IAAI,MAAM,IAAI,CAgB3B;IAED,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAK9D;CACJ"}

package/lib/mcp/dev-activity.js

@@ -0,0 +1,46 @@
+import { format } from 'node:util';
+/**
+ * What happened in `cell dev`, for the dev MCP endpoint: backend requests, start errors and console
+ * output, each kept to the last few hundred entries. Lives across restarts of the dev server.
+ */
+export class DevActivity {
+    static MAX_REQUESTS = 200;
+    static MAX_ERRORS = 20;
+    static MAX_LOGS = 1000;
+    static LEVELS = ['debug', 'info', 'warn', 'error'];
+    requests = [];
+    errors = [];
+    logs = [];
+    recordRequest(record) {
+        DevActivity.push(this.requests, record, DevActivity.MAX_REQUESTS);
+    }
+    recordError(error, files = []) {
+        DevActivity.push(this.errors, { time: new Date().toISOString(), files, error: error.toJSON() }, DevActivity.MAX_ERRORS);
+    }
+    recordLog(level, message) {
+        DevActivity.push(this.logs, { time: new Date().toISOString(), level, message }, DevActivity.MAX_LOGS);
+    }
+    /** Copies console output into {@link logs}, still printing it; returns the function that stops. */
+    captureConsole() {
+        const original = { debug: console.debug, log: console.log, info: console.info, warn: console.warn, error: console.error };
+        const wrap = (level, print) => (...args) => {
+            this.recordLog(level, format(...args));
+            print.apply(console, args);
+        };
+        console.debug = wrap('debug', original.debug);
+        console.log = wrap('info', original.log);
+        console.info = wrap('info', original.info);
+        console.warn = wrap('warn', original.warn);
+        console.error = wrap('error', original.error);
+        return () => {
+            Object.assign(console, original);
+        };
+    }
+    static push(list, item, max) {
+        list.push(item);
+        if (list.length > max) {
+            list.splice(0, list.length - max);
+        }
+    }
+}
+//# sourceMappingURL=dev-activity.js.map

package/lib/mcp/dev-activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-activity.js","sourceRoot":"","sources":["../../src/mcp/dev-activity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAmBnC;;;GAGG;AACH,MAAM,OAAO,WAAW;IACpB,MAAM,CAAU,YAAY,GAAG,GAAG,CAAC;IACnC,MAAM,CAAU,UAAU,GAAG,EAAE,CAAC;IAChC,MAAM,CAAU,QAAQ,GAAG,IAAI,CAAC;IAChC,MAAM,CAAU,MAAM,GAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/D,QAAQ,GAAuB,EAAE,CAAC;IAClC,MAAM,GAAqB,EAAE,CAAC;IAC9B,IAAI,GAAmB,EAAE,CAAC;IAEnC,aAAa,CAAC,MAAwB;QAClC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IACtE,CAAC;IAED,WAAW,CAAC,KAAgB,EAAE,KAAK,GAAa,EAAE;QAC9C,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAC5H,CAAC;IAED,SAAS,CAAC,KAAe,EAAE,OAAe;QACtC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC1G,CAAC;IAED,mGAAmG;IACnG,cAAc;QACV,MAAM,QAAQ,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAC1H,MAAM,IAAI,GACN,CAAC,KAAe,EAAE,KAAmC,EAAE,EAAE,CACzD,CAAC,GAAG,IAAe,EAAE,EAAE;YACnB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;YACvC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC,CAAC;QACN,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;QACzC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,GAAG,EAAE;YACR,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACrC,CAAC,CAAC;IACN,CAAC;IAES,MAAM,CAAC,IAAI,CAAI,IAAS,EAAE,IAAO,EAAE,GAAW;QACpD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QACtC,CAAC;IACL,CAAC;CACJ"}