@cogitator-ai/cli 0.5.19 → 0.6.0

package/dist/commands/eval.d.ts

@@ -0,0 +1,12 @@
+import { Command } from 'commander';
+interface EvalFlags {
+    json?: boolean;
+    report?: string;
+    maxCases?: string;
+    skipWithoutKey?: boolean;
+}
+/** Runs the eval suites and resolves with the exit code. */
+export declare function runEvals(files: readonly string[], flags: EvalFlags): Promise<number>;
+export declare const evalCommand: Command;
+export {};
+//# sourceMappingURL=eval.d.ts.map

package/dist/commands/eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.d.ts","sourceRoot":"","sources":["../../src/commands/eval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,UAAU,SAAS;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAUD,4DAA4D;AAC5D,wBAAsB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAwD1F;AAED,eAAO,MAAM,WAAW,SA4BpB,CAAC"}

package/dist/commands/eval.js

@@ -0,0 +1,90 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { join, relative } from 'node:path';
+import { loadConfig } from '@cogitator-ai/config';
+import { CommandError, examplesHelp, reportFailure, UsageError } from '../utils/cli.js';
+import { loadProjectEnv } from '../utils/doctor.js';
+import { isEvalSuite, missingCredential, outcomeOf, resolveEvalFiles, } from '../utils/evals.js';
+import { importUserModule } from '../utils/module-loader.js';
+function positiveInteger(value) {
+    if (value === undefined)
+        return undefined;
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1)
+        throw new UsageError('--max-cases takes a positive integer');
+    return parsed;
+}
+/** Runs the eval suites and resolves with the exit code. */
+export async function runEvals(files, flags) {
+    const projectDir = process.cwd();
+    loadProjectEnv(projectDir);
+    const print = (line) => {
+        if (!flags.json)
+            console.log(line);
+    };
+    if (flags.skipWithoutKey) {
+        const missing = missingCredential(loadConfig());
+        if (missing) {
+            if (flags.json)
+                console.log(JSON.stringify({ ok: true, skipped: true, reason: `${missing} is not set` }));
+            else
+                print(chalk.yellow(`Skipping evals: ${missing} is not set`));
+            return 0;
+        }
+    }
+    const paths = resolveEvalFiles(projectDir, files);
+    if (paths.length === 0) {
+        throw new CommandError('No eval files found: add evals/<name>.eval.ts exporting an EvalSuite as default');
+    }
+    const outcomes = [];
+    for (const path of paths) {
+        const module = await importUserModule(path, projectDir);
+        const suite = module.default;
+        if (!isEvalSuite(suite)) {
+            throw new CommandError(`${path} must export an EvalSuite as its default export`);
+        }
+        print(chalk.bold(`\n${relative(projectDir, path)}`));
+        const result = await suite.run({ maxCases: positiveInteger(flags.maxCases) });
+        if (!flags.json)
+            result.report('console');
+        if (flags.report) {
+            const target = paths.length === 1 ? flags.report : join(flags.report, `${outcomes.length}.json`);
+            result.report('json', { path: target });
+        }
+        outcomes.push(outcomeOf(projectDir, path, result));
+    }
+    const ok = outcomes.every((outcome) => outcome.passed);
+    if (flags.json) {
+        console.log(JSON.stringify({ ok, skipped: false, suites: outcomes }, null, 2));
+    }
+    else {
+        const failed = outcomes.filter((outcome) => !outcome.passed);
+        print(failed.length === 0
+            ? chalk.green(`\n${outcomes.length} eval suite${outcomes.length === 1 ? '' : 's'} passed`)
+            : chalk.red(`\n${failed.length} of ${outcomes.length} eval suites failed: ${failed.map((f) => f.file).join(', ')}`));
+    }
+    return ok ? 0 : 1;
+}
+export const evalCommand = new Command('eval')
+    .description('Run the eval suites in evals/ (or the files given) and fail when an assertion fails')
+    .argument('[files...]', 'eval files or directories, default: every *.eval.ts under evals/')
+    .option('--json', 'print the results as JSON')
+    .option('--report <path>', 'also write a JSON report to this path')
+    .option('--max-cases <n>', 'run only the first n cases of each suite')
+    .option('--skip-without-key', 'exit 0 without running when the model has no API key, for CI on forks')
+    .addHelpText('after', examplesHelp([
+    ['cogitator eval', 'run every evals/*.eval.ts'],
+    ['cogitator eval evals/answers.eval.ts --max-cases 5', 'a quick subset'],
+    ['cogitator eval --json --report eval-report.json', 'results for CI'],
+]))
+    .action(async (files, flags) => {
+    let code;
+    try {
+        code = await runEvals(files, flags);
+    }
+    catch (error) {
+        code = reportFailure(error, { json: flags.json === true });
+    }
+    process.exit(code);
+});
+//# sourceMappingURL=eval.js.map

package/dist/commands/eval.js.map

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

package/dist/commands/init.d.ts

@@ -1,12 +1,13 @@
 import { Command } from 'commander';
+import { validateProjectName, type ProjectSpecInput } from 'create-cogitator-app';
 import { type SetupProvider } from '../utils/provider-models.js';
 export type InitChannel = 'telegram' | 'discord' | 'slack' | 'webchat';
 export type InitMemory = 'memory' | 'sqlite' | 'postgres';
-export type PackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun';
 export interface InitAnswers {
     projectName: string;
     provider: SetupProvider;
     apiKey: string;
+    /** `provider/model`, as the model prompt offers it. */
     model: string;
     channels: InitChannel[];
     telegramToken?: string;
@@ -17,39 +18,15 @@ export interface InitAnswers {
     memory: InitMemory;
     databaseUrl?: string;
 }
-export interface ScaffoldOptions {
-    dependencyVersions: Record<string, string>;
-    /** When `pnpm`, a pnpm-workspace.yaml allowing the native dependency builds is generated */
-    packageManager?: PackageManager;
-}
+export declare const DEFAULT_POSTGRES_URL = "postgresql://cogitator:cogitator@localhost:5432/cogitator";
+export { validateProjectName };
 /**
- * pnpm 10.26+ skips dependency build scripts unless they are allowed, and pnpm 11 fails the
- * install instead. These are the native/binary packages a Cogitator project pulls in.
+ * The project `cogitator init` creates: the `channels` preset of
+ * create-cogitator-app with the answers, so both commands generate the same
+ * code from the same engine.
  */
-export declare const PNPM_ALLOWED_BUILDS: readonly ["better-sqlite3", "esbuild", "sharp"];
-export declare const DEFAULT_POSTGRES_URL = "postgresql://cogitator:cogitator@localhost:5432/cogitator";
-export declare function validateProjectName(name: string): string | undefined;
-export declare function resolveDependencyVersions(cliPackageJson?: string): Record<string, string>;
-export declare function detectPackageManager(userAgent?: string | undefined): PackageManager;
-export declare function buildPackageJson(answers: InitAnswers, options: ScaffoldOptions): string;
-export declare function buildEnvFile(answers: InitAnswers): string | null;
-export declare function buildGatewayFile(answers: InitAnswers): string;
-export declare function buildAgentFile(answers: InitAnswers): string;
-export declare function buildGitignore(answers: InitAnswers): string;
-export declare const TSCONFIG: {
-    compilerOptions: {
-        target: string;
-        module: string;
-        moduleResolution: string;
-        strict: boolean;
-        esModuleInterop: boolean;
-        skipLibCheck: boolean;
-        outDir: string;
-        rootDir: string;
-    };
-    include: string[];
-};
-export declare function buildProjectFiles(answers: InitAnswers, options: ScaffoldOptions): Record<string, string>;
-export declare function writeProjectFiles(projectPath: string, files: Record<string, string>): void;
+export declare function initSpec(answers: InitAnswers, packageManager?: "pnpm" | "npm" | "yarn" | "bun"): ProjectSpecInput;
+/** What `cogitator init` writes to `.env`: the provider key, the channel tokens and a custom database URL. */
+export declare function initSecrets(answers: InitAnswers): Record<string, string>;
 export declare const initCommand: Command;
 //# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AAErC,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AACvE,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7D,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,4FAA4F;IAC5F,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,iDAAkD,CAAC;AAEnF,eAAO,MAAM,oBAAoB,8DAA8D,CAAC;AAIhG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQpE;AAED,wBAAgB,yBAAyB,CACvC,cAAc,GAAE,MAA4E,GAC3F,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsBxB;AAED,wBAAgB,oBAAoB,CAClC,SAAS,qBAAoC,GAC5C,cAAc,CAIhB;AAMD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAyCvF;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAkBhE;AAyBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CA0F7D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAyB3D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAI3D;AAED,eAAO,MAAM,QAAQ;;;;;;;;;;;;CAYpB,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,eAAe,GACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBxB;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAM1F;AAuID,eAAO,MAAM,WAAW,SAsEpB,CAAC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EASL,mBAAmB,EACnB,KAAK,gBAAgB,EAEtB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AAErC,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AACvE,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,oBAAoB,8DAA8D,CAAC;AAEhG,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,WAAW,EACpB,cAAc,kCAAyB,GACtC,gBAAgB,CAalB;AAED,8GAA8G;AAC9G,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBxE;AAiJD,eAAO,MAAM,WAAW,SA6ErB,CAAC"}

package/dist/commands/init.js

@@ -1,297 +1,55 @@
 import { Command } from 'commander';
-import { writeFileSync, mkdirSync, existsSync, readFileSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { execFileSync } from 'node:child_process';
+import { resolve } from 'node:path';
 import * as p from '@clack/prompts';
 import chalk from 'chalk';
+import { detectPackageManager, detectPackageManagerSpec, firstRunNotice, parseSpec, payloadFor, scaffold, sendTelemetry, telemetryDisabledReason, validateProjectName, } from 'create-cogitator-app';
 import { printBanner } from '../utils/logger.js';
-import { formatEnvLine } from '../utils/env.js';
-import { DEFAULT_OLLAMA_URL, resolveOllamaUrl } from '../utils/ollama.js';
+import { errorMessage, EXIT, examplesHelp } from '../utils/cli.js';
+import { resolveOllamaUrl } from '../utils/ollama.js';
 import { API_KEY_ENV, fetchOllamaModelOptions, fetchProviderModels, isSetupProvider, } from '../utils/provider-models.js';
+export const DEFAULT_POSTGRES_URL = 'postgresql://cogitator:cogitator@localhost:5432/cogitator';
+export { validateProjectName };
 /**
- * pnpm 10.26+ skips dependency build scripts unless they are allowed, and pnpm 11 fails the
- * install instead. These are the native/binary packages a Cogitator project pulls in.
+ * The project `cogitator init` creates: the `channels` preset of
+ * create-cogitator-app with the answers, so both commands generate the same
+ * code from the same engine.
  */
-export const PNPM_ALLOWED_BUILDS = ['better-sqlite3', 'esbuild', 'sharp'];
-export const DEFAULT_POSTGRES_URL = 'postgresql://cogitator:cogitator@localhost:5432/cogitator';
-const PROJECT_NAME = /^[a-z0-9][a-z0-9._-]*$/;
-const COGITATOR_PACKAGES = ['@cogitator-ai/core', '@cogitator-ai/channels', '@cogitator-ai/memory'];
-export function validateProjectName(name) {
-    const trimmed = name.trim();
-    if (!trimmed)
-        return 'Name is required';
-    if (trimmed.length > 214)
-        return 'Name must be 214 characters or fewer';
-    if (!PROJECT_NAME.test(trimmed)) {
-        return 'Use lowercase letters, digits, ".", "_" or "-" (must start with a letter or digit)';
-    }
-    return undefined;
-}
-export function resolveDependencyVersions(cliPackageJson = join(dirname(fileURLToPath(import.meta.url)), '../../package.json')) {
-    const versions = {};
-    let deps = {};
-    try {
-        const parsed = JSON.parse(readFileSync(cliPackageJson, 'utf-8'));
-        if (typeof parsed === 'object' && parsed !== null && 'dependencies' in parsed) {
-            const value = parsed.dependencies;
-            if (typeof value === 'object' && value !== null)
-                deps = Object.fromEntries(Object.entries(value));
-        }
-    }
-    catch {
-        deps = {};
-    }
-    for (const name of COGITATOR_PACKAGES) {
-        const range = deps[name];
-        versions[name] =
-            typeof range === 'string' && /^\^?~?\d/.test(range)
-                ? `^${range.replace(/^[\^~]/, '')}`
-                : 'latest';
-    }
-    return versions;
-}
-export function detectPackageManager(userAgent = process.env.npm_config_user_agent) {
-    const name = userAgent?.split('/')[0];
-    if (name === 'npm' || name === 'yarn' || name === 'bun' || name === 'pnpm')
-        return name;
-    return 'pnpm';
-}
-function runScript(pm, script) {
-    return pm === 'npm' ? `npm run ${script}` : `${pm} ${script}`;
-}
-export function buildPackageJson(answers, options) {
-    const deps = {
-        ...options.dependencyVersions,
-        zod: '^4.0.0',
-    };
-    if (answers.channels.includes('telegram'))
-        deps.grammy = '^1.20.0';
-    if (answers.channels.includes('discord'))
-        deps['discord.js'] = '^14.0.0';
-    if (answers.channels.includes('slack'))
-        deps['@slack/bolt'] = '^4.0.0';
-    if (answers.channels.includes('webchat'))
-        deps.ws = '^8.18.0';
-    if (answers.memory === 'sqlite')
-        deps['better-sqlite3'] = '^11.6.0';
-    if (answers.memory === 'postgres')
-        deps.pg = '^8.18.0';
-    const sortedDeps = Object.fromEntries(Object.entries(deps).sort(([a], [b]) => a.localeCompare(b)));
-    return (JSON.stringify({
+export function initSpec(answers, packageManager = detectPackageManager()) {
+    const prefix = `${answers.provider}/`;
+    return {
         name: answers.projectName,
-        version: '0.1.0',
-        private: true,
-        type: 'module',
-        engines: { node: '>=22.12.0' },
-        scripts: {
-            dev: 'tsx watch src/agent.ts',
-            start: 'tsx src/agent.ts',
-            build: 'tsc',
-        },
-        dependencies: sortedDeps,
-        devDependencies: {
-            '@types/node': '^22.0.0',
-            tsx: '^4.21.0',
-            typescript: '^5.3.0',
-        },
-    }, null, 2) + '\n');
+        preset: 'channels',
+        app: 'channels',
+        channels: answers.channels,
+        memory: answers.memory,
+        features: [],
+        provider: answers.provider,
+        model: answers.model.startsWith(prefix) ? answers.model.slice(prefix.length) : answers.model,
+        packageManager,
+    };
 }
-export function buildEnvFile(answers) {
-    const lines = [];
+/** What `cogitator init` writes to `.env`: the provider key, the channel tokens and a custom database URL. */
+export function initSecrets(answers) {
+    const secrets = {};
     if (answers.provider !== 'ollama' && answers.apiKey) {
-        lines.push(formatEnvLine(API_KEY_ENV[answers.provider], answers.apiKey));
+        secrets[API_KEY_ENV[answers.provider]] = answers.apiKey;
     }
     if (answers.telegramToken)
-        lines.push(formatEnvLine('TELEGRAM_BOT_TOKEN', answers.telegramToken));
+        secrets.TELEGRAM_BOT_TOKEN = answers.telegramToken;
     if (answers.discordToken)
-        lines.push(formatEnvLine('DISCORD_BOT_TOKEN', answers.discordToken));
+        secrets.DISCORD_BOT_TOKEN = answers.discordToken;
     if (answers.slackToken)
-        lines.push(formatEnvLine('SLACK_BOT_TOKEN', answers.slackToken));
-    if (answers.slackSigningSecret) {
-        lines.push(formatEnvLine('SLACK_SIGNING_SECRET', answers.slackSigningSecret));
-    }
+        secrets.SLACK_BOT_TOKEN = answers.slackToken;
+    if (answers.slackSigningSecret)
+        secrets.SLACK_SIGNING_SECRET = answers.slackSigningSecret;
     if (answers.slackAppToken)
-        lines.push(formatEnvLine('SLACK_APP_TOKEN', answers.slackAppToken));
-    if (answers.memory === 'postgres') {
-        lines.push(formatEnvLine('DATABASE_URL', answers.databaseUrl ?? DEFAULT_POSTGRES_URL));
-    }
-    return lines.length > 0 ? lines.join('\n') + '\n' : null;
-}
-function memorySetup(memory) {
-    switch (memory) {
-        case 'sqlite':
-            return {
-                importName: 'SQLiteAdapter',
-                code: `const memory = new SQLiteAdapter({ provider: 'sqlite', path: './data/memory.db' });`,
-            };
-        case 'postgres':
-            return {
-                importName: 'PostgresAdapter',
-                code: `const memory = new PostgresAdapter({
-  provider: 'postgres',
-  connectionString: requireEnv('DATABASE_URL'),
-});`,
-            };
-        case 'memory':
-            return {
-                importName: 'InMemoryAdapter',
-                code: `const memory = new InMemoryAdapter({ provider: 'memory' });`,
-            };
-    }
-}
-export function buildGatewayFile(answers) {
-    const channelImports = [];
-    const channelSetup = [];
-    for (const ch of answers.channels) {
-        switch (ch) {
-            case 'telegram':
-                channelImports.push('telegramChannel');
-                channelSetup.push(`    telegramChannel({ token: requireEnv('TELEGRAM_BOT_TOKEN') }),`);
-                break;
-            case 'discord':
-                channelImports.push('discordChannel');
-                channelSetup.push(`    discordChannel({ token: requireEnv('DISCORD_BOT_TOKEN'), mentionOnly: true }),`);
-                break;
-            case 'slack':
-                channelImports.push('slackChannel');
-                channelSetup.push(`    slackChannel({\n      token: requireEnv('SLACK_BOT_TOKEN'),\n      signingSecret: requireEnv('SLACK_SIGNING_SECRET'),\n      appToken: process.env.SLACK_APP_TOKEN,\n    }),`);
-                break;
-            case 'webchat':
-                channelImports.push('webchatChannel');
-                channelSetup.push(`    webchatChannel({ port: 18789 }),`);
-                break;
-        }
-    }
-    const providerConfig = answers.provider === 'ollama'
-        ? `      ollama: { baseUrl: process.env.OLLAMA_URL ?? '${DEFAULT_OLLAMA_URL}' },`
-        : `      ${answers.provider}: { apiKey: requireEnv('${API_KEY_ENV[answers.provider]}') },`;
-    const memory = memorySetup(answers.memory);
-    return `import { existsSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { Cogitator, Agent } from '@cogitator-ai/core';
-import { Gateway, ${channelImports.join(', ')} } from '@cogitator-ai/channels';
-import { ${memory.importName} } from '@cogitator-ai/memory';
-
-const envFile = fileURLToPath(new URL('../.env', import.meta.url));
-if (existsSync(envFile)) process.loadEnvFile(envFile);
-
-function requireEnv(name: string): string {
-  const value = process.env[name];
-  if (!value) throw new Error(\`Missing environment variable \${name} (see .env)\`);
-  return value;
-}
-
-const agent = new Agent({
-  name: 'assistant',
-  model: '${answers.model}',
-  instructions: \`You are a helpful personal AI assistant.
-Be concise and friendly. Use tools when available.\`,
-});
-
-const cogitator = new Cogitator({
-  llm: {
-    defaultProvider: '${answers.provider}',
-    providers: {
-${providerConfig}
-    },
-  },
-});
-
-${memory.code}
-
-const connected = await memory.connect();
-if (!connected.success) {
-  throw new Error(\`Failed to connect memory: \${connected.error}\`);
-}
-
-export const gateway = new Gateway({
-  agent,
-  cogitator,
-  channels: [
-${channelSetup.join('\n')}
-  ],
-  memory,
-  session: {
-    compaction: { strategy: 'hybrid', threshold: 50, keepRecent: 10 },
-  },
-  stream: { flushInterval: 500, minChunkSize: 20 },
-  onError: (err, msg) => {
-    console.error(\`[error] \${msg.channelType}:\${msg.userId} — \${err.message}\`);
-  },
-});
-`;
-}
-export function buildAgentFile(answers) {
-    const webchatLine = answers.channels.includes('webchat')
-        ? `  console.log('WebChat: ws://localhost:18789/ws');\n`
-        : '';
-    return `import { gateway } from './gateway.js';
-
-let stopping = false;
-
-async function shutdown(signal: string) {
-  if (stopping) return;
-  stopping = true;
-  console.log(\`\\nReceived \${signal}, shutting down...\`);
-  await gateway.stop();
-  process.exit(0);
-}
-
-process.once('SIGINT', () => void shutdown('SIGINT'));
-process.once('SIGTERM', () => void shutdown('SIGTERM'));
-
-await gateway.start();
-
-console.log('Assistant is running!');
-console.log('Connected channels:', gateway.stats.connectedChannels.join(', '));
-${webchatLine}`;
-}
-export function buildGitignore(answers) {
-    const lines = ['node_modules/', 'dist/', '.env', '*.log', '.cogitator/'];
-    if (answers.memory === 'sqlite')
-        lines.push('data/');
-    return lines.join('\n') + '\n';
-}
-export const TSCONFIG = {
-    compilerOptions: {
-        target: 'ES2022',
-        module: 'NodeNext',
-        moduleResolution: 'NodeNext',
-        strict: true,
-        esModuleInterop: true,
-        skipLibCheck: true,
-        outDir: './dist',
-        rootDir: './src',
-    },
-    include: ['src/**/*'],
-};
-export function buildProjectFiles(answers, options) {
-    const files = {
-        'package.json': buildPackageJson(answers, options),
-        'tsconfig.json': JSON.stringify(TSCONFIG, null, 2) + '\n',
-        'src/gateway.ts': buildGatewayFile(answers),
-        'src/agent.ts': buildAgentFile(answers),
-        '.gitignore': buildGitignore(answers),
-    };
-    const env = buildEnvFile(answers);
-    if (env)
-        files['.env'] = env;
-    if (options.packageManager === 'pnpm') {
-        files['pnpm-workspace.yaml'] = [
-            'allowBuilds:',
-            ...PNPM_ALLOWED_BUILDS.map((name) => `  ${name}: true`),
-            '',
-        ].join('\n');
-    }
-    return files;
-}
-export function writeProjectFiles(projectPath, files) {
-    for (const [relativePath, content] of Object.entries(files)) {
-        const fullPath = join(projectPath, relativePath);
-        mkdirSync(dirname(fullPath), { recursive: true });
-        writeFileSync(fullPath, content, relativePath === '.env' ? { mode: 0o600 } : undefined);
+        secrets.SLACK_APP_TOKEN = answers.slackAppToken;
+    if (answers.memory === 'postgres' &&
+        answers.databaseUrl &&
+        answers.databaseUrl !== DEFAULT_POSTGRES_URL) {
+        secrets.DATABASE_URL = answers.databaseUrl;
     }
+    return secrets;
 }
 function cancelled() {
     p.cancel('Setup cancelled');
@@ -367,7 +125,7 @@ async function collectAnswers(nameArg) {
         options: [
             { value: 'sqlite', label: 'SQLite (recommended)', hint: 'zero config, file-based' },
             { value: 'memory', label: 'In-memory', hint: 'no persistence, for testing' },
-            { value: 'postgres', label: 'PostgreSQL', hint: 'production-grade' },
+            { value: 'postgres', label: 'PostgreSQL', hint: 'production-grade, runs in Docker' },
         ],
     }));
     const memory = memoryChoice === 'memory' || memoryChoice === 'postgres' ? memoryChoice : 'sqlite';
@@ -393,63 +151,73 @@ async function collectAnswers(nameArg) {
         databaseUrl,
     };
 }
+function clackLogger() {
+    const spinner = p.spinner();
+    return {
+        start: (message) => spinner.start(message),
+        done: (message) => spinner.stop(message),
+        fail: (message) => spinner.error(message),
+        warn: (message) => p.log.warn(message),
+    };
+}
 export const initCommand = new Command('init')
-    .description('Create a new Cogitator AI assistant project')
+    .description('Create a messaging assistant project (Telegram, Discord, Slack, WebChat)')
     .argument('[name]', 'Project name')
     .option('--no-install', 'Skip dependency installation')
+    .option('--no-git', 'Skip creating a git repository')
+    .option('--no-telemetry', 'Send no anonymous usage event')
+    .addHelpText('after', examplesHelp([
+    ['cogitator init my-bot', 'a messaging assistant, asked step by step'],
+    ['cogitator init my-bot --no-install', 'write the files, install later'],
+]))
     .action(async (nameArg, options) => {
     printBanner();
     p.intro(chalk.bgCyan(chalk.black(' cogitator init ')));
+    const telemetry = telemetryDisabledReason({ flag: options.telemetry }) === undefined;
+    if (telemetry) {
+        const notice = firstRunNotice();
+        if (notice)
+            p.log.info(chalk.dim(notice));
+    }
     if (nameArg !== undefined) {
         const error = validateProjectName(nameArg);
         if (error) {
             p.cancel(`Invalid project name "${nameArg}": ${error}`);
-            process.exit(1);
+            process.exitCode = EXIT.usage;
+            return;
         }
     }
     const answers = await collectAnswers(nameArg?.trim());
-    const projectPath = resolve(process.cwd(), answers.projectName);
-    if (existsSync(projectPath)) {
-        p.cancel(`Directory "${answers.projectName}" already exists`);
-        process.exit(1);
+    const directory = resolve(process.cwd(), answers.projectName);
+    const spec = initSpec(answers);
+    let result;
+    try {
+        result = await scaffold(spec, {
+            directory,
+            secrets: initSecrets(answers),
+            packageManagerSpec: detectPackageManagerSpec(detectPackageManager()),
+            install: options.install,
+            git: options.git,
+            log: clackLogger(),
+        });
+    }
+    catch (error) {
+        if (telemetry)
+            await sendTelemetry(payloadFor(parseSpec(spec), 'failure'));
+        p.cancel(errorMessage(error));
+        process.exitCode = EXIT.failed;
+        return;
+    }
+    if (telemetry) {
+        await sendTelemetry(payloadFor(result.plan.spec, result.install.status === 'failed' ? 'failure' : 'success'));
     }
-    const pm = detectPackageManager();
-    const files = buildProjectFiles(answers, {
-        dependencyVersions: resolveDependencyVersions(),
-        packageManager: pm,
+    const steps = result.plan.nextSteps({
+        directory: answers.projectName,
+        installed: result.install.status === 'done',
+        keyWritten: true,
+        modelReady: answers.provider !== 'ollama',
     });
-    let installed = false;
-    await p.tasks([
-        {
-            title: 'Creating project structure',
-            task: () => {
-                writeProjectFiles(projectPath, files);
-                return 'Project files created';
-            },
-        },
-        {
-            title: `Installing dependencies with ${pm}`,
-            enabled: options.install,
-            task: () => {
-                try {
-                    execFileSync(pm, ['install'], { cwd: projectPath, stdio: 'pipe' });
-                    installed = true;
-                    return 'Dependencies installed';
-                }
-                catch {
-                    return `Install failed — run "${pm} install" manually`;
-                }
-            },
-        },
-    ]);
-    p.note([
-        `cd ${answers.projectName}`,
-        installed ? '' : `${pm} install`,
-        `${runScript(pm, 'dev')}        # start with hot reload`,
-        `cogitator assistant   # or run with the live dashboard`,
-    ]
-        .filter(Boolean)
-        .join('\n'), 'Next steps', { format: (line) => chalk.dim(line) });
+    p.note(steps.map((step) => `${step.command}${step.note ? `  # ${step.note}` : ''}`).join('\n'), 'Next steps', { format: (line) => chalk.dim(line) });
     p.outro(`${chalk.green('Your assistant is ready!')} Channels: ${chalk.cyan(answers.channels.join(', '))}`);
 });
 //# sourceMappingURL=init.js.map