@celljs/cli 3.9.0 → 4.0.0

package/lib/check/project-checker.js

@@ -0,0 +1,332 @@
+import { spawn } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { CellError } from '@celljs/kit';
+import { CellDevServer, ProjectLoader } from '@celljs/vite';
+import { ProjectInspector } from '../info/project-inspector.js';
+/** Shapes of inversify errors and the codes `cell check` gives them (docs/design/agent-first.md R5). */
+const DI_ERRORS = [
+    [
+        /^No matching bindings found for serviceIdentifier: (.+)/,
+        'CELL_DI_NO_BINDING',
+        'Bind the identifier in a DI module (@Component), or mark the injection @Optional().',
+    ],
+    [
+        /^Ambiguous match found for serviceIdentifier: (.+)/,
+        'CELL_DI_AMBIGUOUS',
+        'Inject all of them with @Autowired(...) on an array, give one rebind: true, or name them.',
+    ],
+    [/^Circular dependency found: (.+)/, 'CELL_DI_CIRCULAR', 'Break the cycle: inject lazily, or move the shared part into another component.'],
+    [/^Missing required @inject or @multiInject annotation/, 'CELL_DI_MISSING_INJECT', 'Add @Autowired(...) to the constructor parameter or property.'],
+];
+/**
+ * `cell check` (docs/design/agent-first.md R4): the checks that tell before running whether the
+ * project works: configuration, TypeScript types, decorator settings, DI bindings of the backend,
+ * and the checks of toolchain modules. Every finding is a CheckIssue with a stable code.
+ */
+export class ProjectChecker {
+    toolchain;
+    options;
+    static BUILTIN = ['config', 'types', 'decorators', 'di'];
+    constructor(toolchain, options = {}) {
+        this.toolchain = toolchain;
+        this.options = options;
+    }
+    get root() {
+        return this.toolchain.config.root;
+    }
+    /** Names of the checks that `--skip` accepts. */
+    get names() {
+        return this.checks().map(check => check.name);
+    }
+    async run() {
+        const skip = new Set(this.options.skip ?? []);
+        const unknown = [...skip].filter(name => !this.names.includes(name));
+        if (unknown.length > 0) {
+            throw new CellError({
+                code: 'CELL_ARGUMENT_INVALID',
+                message: `Unknown check '${unknown[0]}'. Checks: ${this.names.join(', ')}.`,
+                hint: 'Pass a check name to --skip.',
+            });
+        }
+        const reports = [];
+        for (const check of this.checks()) {
+            const started = performance.now();
+            const base = { name: check.name, description: check.description, ...(check.source ? { source: check.source } : {}) };
+            if (skip.has(check.name)) {
+                reports.push({ ...base, durationMs: 0, issues: [], skipped: '--skip' });
+                continue;
+            }
+            let outcome;
+            try {
+                outcome = await check.run();
+            }
+            catch (error) {
+                const failure = CellError.is(error) ? error : undefined;
+                outcome = [
+                    {
+                        level: 'error',
+                        code: failure?.code ?? 'CELL_CHECK_FAILED',
+                        message: failure?.message ?? `The ${check.name} check failed: ${error?.message ?? String(error)}`,
+                        ...(failure?.file ? { file: failure.file } : {}),
+                        ...(failure?.line ? { line: failure.line } : {}),
+                        ...(failure?.hint ? { hint: failure.hint } : {}),
+                    },
+                ];
+            }
+            const durationMs = Math.round(performance.now() - started);
+            reports.push(Array.isArray(outcome) ? { ...base, durationMs, issues: outcome } : { ...base, durationMs, issues: [], skipped: outcome.skipped });
+        }
+        return reports;
+    }
+    checks() {
+        const builtin = [
+            { name: 'config', description: 'cell.config.ts, cell*.yml, modes, entries and environment overrides', run: async () => this.config() },
+            { name: 'types', description: 'TypeScript types (tsc --noEmit)', run: () => this.types() },
+            { name: 'decorators', description: 'tsconfig settings the DI decorators need', run: async () => this.decorators() },
+            { name: 'di', description: 'every DI binding of the backend resolves', run: () => this.di() },
+        ];
+        const modules = this.toolchain.modules.checks.map(({ source, value }) => ({
+            name: value.name,
+            description: value.description,
+            source,
+            run: async () => value.run({ root: this.root, mode: this.toolchain.config.mode, project: this.project() }),
+        }));
+        return [...builtin, ...modules];
+    }
+    project() {
+        return new ProjectLoader({ ...this.toolchain.projectOptions(), env: this.options.env }).load();
+    }
+    config() {
+        const { config, preset, presets, modules } = this.toolchain;
+        const inspector = new ProjectInspector(config, preset, presets.names, { projectOptions: this.toolchain.projectOptions(), modules: modules.loaded });
+        inspector.inspect({ env: this.options.env });
+        return inspector.issues;
+    }
+    /** The nearest tsconfig.json of the project, with `extends` of relative files merged. */
+    tsconfig() {
+        const file = join(this.root, 'tsconfig.json');
+        if (!existsSync(file)) {
+            return undefined;
+        }
+        const read = (path, seen) => {
+            const json = ProjectChecker.parseJsonc(readFileSync(path, 'utf8'));
+            const bases = [json.extends ?? []].flat().filter(base => base.startsWith('.') || isAbsolute(base));
+            let options = {};
+            for (const base of bases) {
+                const target = resolve(dirname(path), base.endsWith('.json') ? base : `${base}.json`);
+                if (existsSync(target) && !seen.has(target)) {
+                    seen.add(target);
+                    options = { ...options, ...read(target, seen) };
+                }
+            }
+            return { ...options, ...(json.compilerOptions ?? {}) };
+        };
+        return { file, compilerOptions: read(file, new Set([file])) };
+    }
+    decorators() {
+        const tsconfig = this.tsconfig();
+        if (!tsconfig) {
+            return { skipped: 'no tsconfig.json' };
+        }
+        const missing = ['experimentalDecorators', 'emitDecoratorMetadata'].filter(option => tsconfig.compilerOptions[option] !== true);
+        return missing.map(option => ({
+            level: 'warning',
+            code: 'CELL_TSCONFIG_DECORATORS',
+            message: `tsconfig.json does not set ${option}: true. Cell builds with legacy decorators and their metadata, so tsc and editors check a different program.`,
+            file: tsconfig.file,
+            hint: `Set "${option}": true in compilerOptions.`,
+        }));
+    }
+    async types() {
+        const tsconfig = this.tsconfig();
+        if (!tsconfig) {
+            return { skipped: 'no tsconfig.json' };
+        }
+        let tsc;
+        try {
+            const require = createRequire(join(this.root, 'package.json'));
+            const manifest = require.resolve('typescript/package.json');
+            const bin = JSON.parse(readFileSync(manifest, 'utf8')).bin?.tsc;
+            if (!bin) {
+                return { skipped: 'the installed typescript has no tsc' };
+            }
+            tsc = join(dirname(manifest), bin);
+        }
+        catch {
+            return { skipped: 'typescript is not installed' };
+        }
+        const output = await new Promise((resolvePromise, reject) => {
+            const child = spawn(process.execPath.includes('bun') ? 'node' : process.execPath, [tsc, '--noEmit', '--pretty', 'false', '-p', tsconfig.file], {
+                cwd: this.root,
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let text = '';
+            child.stdout.on('data', chunk => {
+                text += chunk;
+            });
+            child.stderr.on('data', chunk => {
+                text += chunk;
+            });
+            child.on('error', reject);
+            child.on('close', () => resolvePromise(text));
+        });
+        return ProjectChecker.parseTsc(output, this.root);
+    }
+    /** `file(line,col): error TS1234: message`, with indented continuation lines. */
+    static parseTsc(output, root) {
+        const issues = [];
+        for (const line of output.split(/\r?\n/)) {
+            const match = /^(.+?)\((\d+),(\d+)\): (error|warning) (TS\d+): (.*)$/.exec(line);
+            if (match) {
+                issues.push({
+                    level: match[4] === 'error' ? 'error' : 'warning',
+                    code: match[5],
+                    message: match[6],
+                    file: resolve(root, match[1]),
+                    line: Number(match[2]),
+                    column: Number(match[3]),
+                });
+            }
+            else if (/^\s+\S/.test(line) && issues.length > 0) {
+                issues[issues.length - 1].message += `\n${line.trim()}`;
+            }
+            else if (/^error (TS\d+): (.*)$/.test(line)) {
+                const [, tsCode, message] = /^error (TS\d+): (.*)$/.exec(line) ?? [];
+                issues.push({ level: 'error', code: tsCode, message });
+            }
+        }
+        return issues;
+    }
+    /** Loads the backend's container (not the application) and resolves every binding. */
+    async di() {
+        const options = this.toolchain.projectOptions();
+        const server = new CellDevServer({
+            ...options,
+            mode: this.toolchain.config.mode,
+            env: this.options.env,
+            vite: this.toolchain.config.vite,
+            plugins: this.toolchain.modules.vitePlugins(),
+            listen: false,
+            backend: false,
+            logLevel: 'silent',
+        });
+        await server.start();
+        try {
+            if (!server.project.backend) {
+                return { skipped: 'no backend target' };
+            }
+            let container;
+            try {
+                container = await (await server.import('@celljs/core/lib/common/container/dynamic-container'))
+                    .container;
+                // Components look the container up through ContainerProvider, as the entry sets it.
+                const { ContainerProvider } = await server.import('@celljs/core/lib/common/container/container-provider');
+                ContainerProvider.set(container);
+            }
+            catch (error) {
+                throw CellDevServer.toCellError(error, 'CELL_DI_MODULE_FAILED');
+            }
+            return ProjectChecker.resolveAll(container);
+        }
+        finally {
+            await server.close();
+        }
+    }
+    /**
+     * Resolves every binding. One cause (a missing binding, a cycle) breaks every binding that depends
+     * on it: it is reported once, from the binding that needs it, with the count of the others.
+     */
+    static async resolveAll(container) {
+        const causes = new Map();
+        for (const id of container._bindingDictionary.getMap().keys()) {
+            try {
+                await container.getAllAsync(id);
+            }
+            catch (error) {
+                const issue = ProjectChecker.diIssue(id, error);
+                const { cause, requester } = ProjectChecker.diCause(error);
+                const found = causes.get(cause);
+                if (!found) {
+                    causes.set(cause, { issue, requester, count: 1 });
+                }
+                else {
+                    found.count++;
+                    if (requester && ProjectChecker.identifierName(id) === requester) {
+                        found.issue = issue;
+                    }
+                }
+            }
+        }
+        return [...causes.values()].map(({ issue, count }) => count === 1 ? issue : { ...issue, message: `${issue.message}; ${count - 1} other binding${count === 2 ? '' : 's'} fail because of it` });
+    }
+    /** What failed, without the binding it was resolved from; and the binding that needs it. */
+    static diCause(error) {
+        const text = String(error?.message ?? error);
+        const path = /Trying to resolve bindings for "([^"]+)"/.exec(text)?.[1];
+        return { cause: `${text.split('\n')[0].trim()}\0${path ?? ''}`, requester: path?.split(' --> ').pop()?.trim() };
+    }
+    static identifierName(id) {
+        if (typeof id === 'symbol') {
+            return id.description ?? id.toString();
+        }
+        if (typeof id === 'function') {
+            return id.name || '(anonymous class)';
+        }
+        return String(id);
+    }
+    static diIssue(id, error) {
+        const text = String(error?.message ?? error);
+        const first = text.split('\n')[0];
+        const known = DI_ERRORS.find(([pattern]) => pattern.test(first));
+        // inversify appends "Trying to resolve bindings for 'A --> B'" and the registered bindings.
+        const path = /Trying to resolve bindings for "([^"]+)"/.exec(text)?.[1];
+        const message = `Resolving ${ProjectChecker.identifierName(id)}: ${first.trim()}${path ? ` (${path})` : ''}`;
+        return known
+            ? { level: 'error', code: known[1], message, hint: known[2] }
+            : {
+                // Bindings made for an injection point (`@Value`) or a request cannot be created on their own; not a finding.
+                level: 'info',
+                code: 'CELL_DI_CONSTRUCT_FAILED',
+                message,
+                hint: 'Creating it on its own failed; that is expected for bindings that need an injection point, a request or a started application.',
+            };
+    }
+    /** JSON with comments and trailing commas, as tsconfig.json allows. */
+    static parseJsonc(text) {
+        let out = '';
+        let inString = false;
+        for (let i = 0; i < text.length; i++) {
+            const char = text[i];
+            if (inString) {
+                out += char;
+                if (char === '\\') {
+                    out += text[++i] ?? '';
+                }
+                else if (char === '"') {
+                    inString = false;
+                }
+            }
+            else if (char === '"') {
+                inString = true;
+                out += char;
+            }
+            else if (char === '/' && text[i + 1] === '/') {
+                while (i < text.length && text[i] !== '\n') {
+                    i++;
+                }
+                out += '\n';
+            }
+            else if (char === '/' && text[i + 1] === '*') {
+                i = text.indexOf('*/', i + 2);
+                i = i < 0 ? text.length : i + 1;
+            }
+            else {
+                out += char;
+            }
+        }
+        return JSON.parse(out.replace(/,(\s*[}\]])/g, '$1'));
+    }
+}
+//# sourceMappingURL=project-checker.js.map

package/lib/check/project-checker.js.map

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

package/lib/check/project-checker.spec.d.ts

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

package/lib/check/project-checker.spec.d.ts.map

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

package/lib/check/project-checker.spec.js

@@ -0,0 +1,147 @@
+import { afterAll, describe, expect, it } from 'bun:test';
+import { CellCli } from '../cli/cell-cli.js';
+import { FixtureProject } from '../test/fixture-project.js';
+import { ProjectChecker } from './project-checker.js';
+const DEPENDENCIES = { '@celljs/core': '*', '@celljs/http': '*', '@celljs/web': '*', '@celljs/mvc': '*', '@celljs/express-adapter': '*' };
+const TSCONFIG = {
+    compilerOptions: {
+        experimentalDecorators: true,
+        emitDecoratorMetadata: true,
+        module: 'nodenext',
+        target: 'es2022',
+        strict: false,
+        skipLibCheck: true,
+        types: [],
+    },
+    include: ['src'],
+};
+function project(name, controller, config = 'export default {};\n') {
+    return new FixtureProject(name)
+        .file('package.json', { name, dependencies: DEPENDENCIES })
+        .file('tsconfig.json', TSCONFIG)
+        .file('cell.config.ts', config)
+        .file('src/node/home.ts', controller)
+        .file('src/node/module.ts', "import './home';\nimport { autoBind } from '@celljs/core';\nexport default autoBind();\n");
+}
+const GOOD = [
+    "import { Controller, Get, Text } from '@celljs/mvc/lib/node';",
+    '@Controller()',
+    'export class HomeController {',
+    '    @Get() @Text()',
+    "    home(): string { return 'ok'; }",
+    '}',
+].join('\n');
+async function check(root, args = []) {
+    let stdout = '';
+    const code = await new CellCli({ stdout: { write: s => (stdout += s) }, stderr: { write: () => true }, env: { PATH: process.env.PATH } }).run([
+        'check',
+        '--root',
+        root,
+        '--json',
+        ...args,
+    ]);
+    return { code, json: JSON.parse(stdout) };
+}
+describe('cell check', () => {
+    const fixtures = [];
+    const track = (fixture) => {
+        fixtures.push(fixture);
+        return fixture;
+    };
+    afterAll(() => {
+        for (const fixture of fixtures) {
+            fixture.dispose();
+        }
+    });
+    it('passes a sound project and reports every check it ran', async () => {
+        const { code, json } = await check(track(project('check-ok', GOOD)).root);
+        expect(code).toBe(0);
+        expect(json).toMatchObject({ command: 'check', ok: true, passed: true, summary: { errors: 0, warnings: 0 }, warnings: [] });
+        expect(json.checks.map((c) => c.name)).toEqual(['config', 'types', 'decorators', 'di']);
+        expect(json.issues.filter((i) => i.level !== 'info')).toEqual([]);
+    }, 60000);
+    it('reports a missing DI binding with a stable code, and fails', async () => {
+        const fixture = track(project('check-di', [
+            "import { Autowired } from '@celljs/core';",
+            "import { Controller, Get, Text } from '@celljs/mvc/lib/node';",
+            "export const Mailer = Symbol('Mailer');",
+            '@Controller()',
+            'export class HomeController {',
+            '    @Autowired(Mailer) protected readonly mailer: unknown;',
+            '    @Get() @Text()',
+            "    home(): string { return 'ok'; }",
+            '}',
+        ].join('\n')));
+        const { code, json } = await check(fixture.root, ['--skip', 'types']);
+        expect(code).toBe(1);
+        expect(json.passed).toBe(false);
+        const issue = json.issues.find((i) => i.code === 'CELL_DI_NO_BINDING');
+        expect(issue).toMatchObject({ check: 'di', level: 'error', hint: expect.stringContaining('Bind the identifier') });
+        expect(issue.message).toContain('Mailer');
+        // One missing binding breaks every binding that depends on it: reported once, from the controller.
+        expect(json.issues.filter((i) => i.code === 'CELL_DI_NO_BINDING')).toHaveLength(1);
+        expect(issue.message).toMatch(/^Resolving HomeController: No matching bindings found for serviceIdentifier: Symbol\(Mailer\) \(HomeController\); \d+ other bindings fail because of it$/);
+        expect(json.checks.find((c) => c.name === 'types')).toMatchObject({ skipped: '--skip' });
+    }, 60000);
+    it('reports type errors with file and position, config warnings and missing decorator settings', async () => {
+        const fixture = track(project('check-types', `${GOOD}\nexport const n: number = 'one';\n`));
+        fixture.file('tsconfig.json', { ...TSCONFIG, compilerOptions: { ...TSCONFIG.compilerOptions, emitDecoratorMetadata: undefined } });
+        const { code, json } = await check(fixture.root, ['-m', 'databse', '--skip', 'di']);
+        expect(code).toBe(1);
+        const byCode = Object.fromEntries(json.issues.map((i) => [i.code, i]));
+        expect(byCode.TS2322).toMatchObject({ check: 'types', level: 'error', file: fixture.path('src/node/home.ts'), line: 7 });
+        expect(byCode.CELL_MODE_UNKNOWN).toMatchObject({ check: 'config', level: 'warning' });
+        expect(byCode.CELL_TSCONFIG_DECORATORS).toMatchObject({ check: 'decorators', file: fixture.path('tsconfig.json') });
+    }, 60000);
+    it('runs the checks of toolchain modules and lets --skip name them', async () => {
+        const fixture = track(project('check-module', GOOD, "export default { modules: ['./audit.mjs'] };\n"));
+        fixture.file('audit.mjs', "export default cell => cell.addCheck({ name: 'audit:todo', description: 'no TODO', run: ({ project }) => [{ level: 'error', code: 'AUDIT_TODO', message: 'TODO in ' + project.components.length + ' components' }] });\n");
+        const { code, json } = await check(fixture.root, ['--skip', 'types', '--skip', 'di']);
+        expect(code).toBe(1);
+        expect(json.checks.at(-1)).toMatchObject({ name: 'audit:todo', source: 'audit.mjs', issues: 1 });
+        expect(json.issues.at(-1)).toMatchObject({ check: 'audit:todo', code: 'AUDIT_TODO' });
+        expect((await check(fixture.root, ['--skip', 'types', '--skip', 'di', '--skip', 'audit:todo'])).code).toBe(0);
+        const unknown = await check(fixture.root, ['--skip', 'typo']);
+        expect(unknown.code).toBe(2);
+        expect(unknown.json.error.message).toContain('Checks: config, types, decorators, di, audit:todo.');
+    }, 60000);
+    it('prints compiler-style lines without --json', async () => {
+        const fixture = track(project('check-text', `${GOOD}\nexport const n: number = 'one';\n`));
+        let stdout = '';
+        const code = await new CellCli({ stdout: { write: s => (stdout += s) }, stderr: { write: () => true } }).run([
+            'check',
+            '--root',
+            fixture.root,
+            '--skip',
+            'di',
+        ]);
+        expect(code).toBe(1);
+        expect(stdout).toContain("src/node/home.ts:7:14 error TS2322 Type 'string' is not assignable to type 'number'.");
+        expect(stdout).toMatch(/Failed: 1 error, 0 warnings \(config, types, decorators\) in \d+ms/);
+    }, 60000);
+});
+describe('ProjectChecker helpers', () => {
+    it('parses tsc output, with continuation lines and global errors', () => {
+        const issues = ProjectChecker.parseTsc(["src/a.ts(1,2): error TS2322: Type 'x' is not assignable.", "  Type 'x' is a string.", 'error TS5083: Cannot read file tsconfig.json.'].join('\n'), '/app');
+        expect(issues).toEqual([
+            { level: 'error', code: 'TS2322', message: "Type 'x' is not assignable.\nType 'x' is a string.", file: '/app/src/a.ts', line: 1, column: 2 },
+            { level: 'error', code: 'TS5083', message: 'Cannot read file tsconfig.json.' },
+        ]);
+    });
+    it('reads tsconfig.json with comments and trailing commas', () => {
+        expect(ProjectChecker.parseJsonc('{ // c\n "a": "// not a comment", /* b */ "c": [1,], }')).toEqual({ a: '// not a comment', c: [1] });
+    });
+    it('maps inversify errors to codes', () => {
+        expect(ProjectChecker.diIssue(Symbol('A'), new Error('Ambiguous match found for serviceIdentifier: A'))).toMatchObject({
+            level: 'error',
+            code: 'CELL_DI_AMBIGUOUS',
+        });
+        expect(ProjectChecker.diIssue(class B {
+        }, new Error('Circular dependency found: B --> C --> B'))).toMatchObject({
+            code: 'CELL_DI_CIRCULAR',
+            message: expect.stringContaining('Resolving B'),
+        });
+        expect(ProjectChecker.diIssue('x', new Error('boom'))).toMatchObject({ level: 'info', code: 'CELL_DI_CONSTRUCT_FAILED' });
+    });
+});
+//# sourceMappingURL=project-checker.spec.js.map

package/lib/check/project-checker.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-checker.spec.js","sourceRoot":"","sources":["../../src/check/project-checker.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,YAAY,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,yBAAyB,EAAE,GAAG,EAAE,CAAC;AAC1I,MAAM,QAAQ,GAAG;IACb,eAAe,EAAE;QACb,sBAAsB,EAAE,IAAI;QAC5B,qBAAqB,EAAE,IAAI;QAC3B,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,KAAK;QACb,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,EAAE;KACZ;IACD,OAAO,EAAE,CAAC,KAAK,CAAC;CACnB,CAAC;AAEF,SAAS,OAAO,CAAC,IAAY,EAAE,UAAkB,EAAE,MAAM,GAAG,sBAAsB;IAC9E,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC;SAC1B,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;SAC1D,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC;SAC/B,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC;SAC9B,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC;SACpC,IAAI,CAAC,oBAAoB,EAAE,0FAA0F,CAAC,CAAC;AAChI,CAAC;AAED,MAAM,IAAI,GAAG;IACT,+DAA+D;IAC/D,eAAe;IACf,+BAA+B;IAC/B,oBAAoB;IACpB,qCAAqC;IACrC,GAAG;CACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,KAAK,UAAU,KAAK,CAAC,IAAY,EAAE,IAAI,GAAa,EAAE;IAClD,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,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC;QAC1I,OAAO;QACP,QAAQ;QACR,IAAI;QACJ,QAAQ;QACR,GAAG,IAAI;KACV,CAAC,CAAC;IACH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IACxB,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,CAAC,OAAuB,EAAkB,EAAE;QACtD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,OAAO,CAAC;IACnB,CAAC,CAAC;IAEF,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,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1E,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5H,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1G,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAoB,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC,EAAE,KAAK,CAAC,CAAC;IAEV,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,OAAO,GAAG,KAAK,CACjB,OAAO,CACH,UAAU,EACV;YACI,2CAA2C;YAC3C,+DAA+D;YAC/D,yCAAyC;YACzC,eAAe;YACf,+BAA+B;YAC/B,4DAA4D;YAC5D,oBAAoB;YACpB,qCAAqC;YACrC,GAAG;SACN,CAAC,IAAI,CAAC,IAAI,CAAC,CACf,CACJ,CAAC;QACF,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QACtE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC;QACzF,MAAM,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;QACnH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC1C,mGAAmG;QACnG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACrG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,CACzB,0JAA0J,CAC7J,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/G,CAAC,EAAE,KAAK,CAAC,CAAC;IAEV,EAAE,CAAC,4FAA4F,EAAE,KAAK,IAAI,EAAE;QACxG,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,IAAI,qCAAqC,CAAC,CAAC,CAAC;QAC5F,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,GAAG,QAAQ,EAAE,eAAe,EAAE,EAAE,GAAG,QAAQ,CAAC,eAAe,EAAE,qBAAqB,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;QACnI,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QACpF,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACzF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACzH,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACtF,MAAM,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IACxH,CAAC,EAAE,KAAK,CAAC,CAAC;IAEV,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,EAAE,gDAAgD,CAAC,CAAC,CAAC;QACvG,OAAO,CAAC,IAAI,CACR,WAAW,EACX,0NAA0N,CAC7N,CAAC;QACF,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QACtF,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QACjG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QACtF,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9G,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,oDAAoD,CAAC,CAAC;IACvG,CAAC,EAAE,KAAK,CAAC,CAAC;IAEV,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,IAAI,qCAAqC,CAAC,CAAC,CAAC;QAC3F,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,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,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC;YACzG,OAAO;YACP,QAAQ;YACR,OAAO,CAAC,IAAI;YACZ,QAAQ;YACR,IAAI;SACP,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,sFAAsF,CAAC,CAAC;QACjH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,oEAAoE,CAAC,CAAC;IACjG,CAAC,EAAE,KAAK,CAAC,CAAC;AACd,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACpE,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAClC,CAAC,0DAA0D,EAAE,yBAAyB,EAAE,+CAA+C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EACnJ,MAAM,CACT,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACnB,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,oDAAoD,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;YAC5I,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,iCAAiC,EAAE;SACjF,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,wDAAwD,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3I,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YACnH,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,mBAAmB;SAC5B,CAAC,CAAC;QACH,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC;SAAG,EAAE,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAC5G,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,MAAM,CAAC,gBAAgB,CAAC,aAAa,CAAC;SAClD,CAAC,CAAC;QACH,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC,CAAC;IAC9H,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,15 @@
+import { Command, type CommandContext } from './command.js';
+/**
+ * `cell agent sync`: writes the agent guide of the installed versions into AGENTS.md (between
+ * markers) and `.agents/skills/cell/SKILL.md`: the Cell guide of this CLI and the AGENTS.md of
+ * every component and toolchain module (docs/design/agent-first.md R7).
+ */
+export declare class AgentCommand extends Command {
+    protected readonly version: () => string;
+    readonly name = "agent";
+    readonly description = "Write AGENTS.md and the cell skill for the installed versions";
+    readonly arguments = "sync";
+    constructor(version: () => string);
+    run({ values, positionals, reporter, env }: CommandContext): Promise<number>;
+}
+//# sourceMappingURL=agent-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-command.d.ts","sourceRoot":"","sources":["../../src/cli/agent-command.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE5D;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,OAAO;IAKzB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,MAAM;IAJpD,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,WAAW,mEAAmE;IACvF,SAAkB,SAAS,UAAU;IAErC,YAA+B,OAAO,EAAE,MAAM,MAAM,EAEnD;IAEK,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBjF;CACJ"}

package/lib/cli/agent-command.js

@@ -0,0 +1,42 @@
+import { CellError } from '@celljs/kit';
+import { AgentGuide } from '../agent/agent-guide.js';
+import { Toolchain } from '../toolchain/toolchain.js';
+import { Command } from './command.js';
+/**
+ * `cell agent sync`: writes the agent guide of the installed versions into AGENTS.md (between
+ * markers) and `.agents/skills/cell/SKILL.md`: the Cell guide of this CLI and the AGENTS.md of
+ * every component and toolchain module (docs/design/agent-first.md R7).
+ */
+export class AgentCommand extends Command {
+    version;
+    name = 'agent';
+    description = 'Write AGENTS.md and the cell skill for the installed versions';
+    arguments = 'sync';
+    constructor(version) {
+        super();
+        this.version = version;
+    }
+    async run({ values, positionals, reporter, env }) {
+        if (positionals.length !== 1 || positionals[0] !== 'sync') {
+            throw new CellError({
+                code: 'CELL_ARGUMENT_INVALID',
+                message: `Unknown agent action '${positionals.join(' ')}'.`,
+                hint: 'Use cell agent sync.',
+            });
+        }
+        const toolchain = await Toolchain.create({
+            root: values.root,
+            command: 'info',
+            env,
+            quiet: reporter.json,
+            runHooks: false,
+            logger: reporter,
+        });
+        await toolchain.close();
+        const snippets = AgentGuide.snippets(toolchain.modules.components, toolchain.modules.docs);
+        const result = new AgentGuide(toolchain.config.root, this.version()).sync(snippets);
+        reporter.result('agent', { root: toolchain.config.root, ...result }, `Wrote ${result.files.join(', ')}${result.snippets.length > 0 ? ` with the guides of ${result.snippets.join(', ')}` : ''}`);
+        return 0;
+    }
+}
+//# sourceMappingURL=agent-command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-command.js","sourceRoot":"","sources":["../../src/cli/agent-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,OAAO,EAAuB,MAAM,cAAc,CAAC;AAE5D;;;;GAIG;AACH,MAAM,OAAO,YAAa,SAAQ,OAAO;IAKN,OAAO;IAJ7B,IAAI,GAAG,OAAO,CAAC;IACf,WAAW,GAAG,+DAA+D,CAAC;IACrE,SAAS,GAAG,MAAM,CAAC;IAErC,YAA+B,OAAqB;QAChD,KAAK,EAAE,CAAC;uBADmB,OAAO;IAEtC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,EAAkB;QAC5D,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;YACxD,MAAM,IAAI,SAAS,CAAC;gBAChB,IAAI,EAAE,uBAAuB;gBAC7B,OAAO,EAAE,yBAAyB,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI;gBAC3D,IAAI,EAAE,sBAAsB;aAC/B,CAAC,CAAC;QACP,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC;YACrC,IAAI,EAAE,MAAM,CAAC,IAA0B;YACvC,OAAO,EAAE,MAAM;YACf,GAAG;YACH,KAAK,EAAE,QAAQ,CAAC,IAAI;YACpB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,QAAQ;SACnB,CAAC,CAAC;QACH,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3F,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpF,QAAQ,CAAC,MAAM,CACX,OAAO,EACP,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,MAAM,EAAE,EAC1C,SAAS,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,uBAAuB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC7H,CAAC;QACF,OAAO,CAAC,CAAC;IACb,CAAC;CACJ"}