@genfeedai/create 0.1.3 → 0.3.0

package/README.md

@@ -1,27 +1,55 @@
-# genfeedai
+# @genfeedai/create
 
-Bootstrap a self-hosted Genfeed Core project from the official template.
+Install a checksummed Genfeed.ai Community release with Docker Compose.
 
-## Usage
+## Quick Start
 
 ```bash
-npx genfeedai init my-app
+npx @genfeedai/create my-genfeed
 ```
 
-This command:
+The installer resolves the latest GitHub release, downloads its public
+self-hosted bundle, verifies the SHA-256 checksum and release manifest, then
+starts the exact GHCR image associated with that release. The app is available
+at `http://localhost:3000` by default. The wizard asks for an OpenRouter key
+(hidden input) and a domain you own (blank for localhost). It writes the final
+`.env` with owner-only permissions and generated encryption/session secrets
+before starting Docker.
 
-- downloads the latest `genfeedai/core` template
-- copies `.env.example` to `.env` when present
-- installs dependencies with `bun install` when Bun is available, otherwise `npm install`
+Install a specific release reproducibly:
 
-## Example
+```bash
+npx @genfeedai/create my-genfeed --release v0.5.0
+```
+
+Prepare and validate the installation without starting containers:
 
 ```bash
-npx genfeedai init my-app
-cd my-app
-bun run dev
+npx @genfeedai/create my-genfeed --release v0.5.0 --no-start
 ```
 
+Node.js 24 (`>=24 <25`; other versions exit with an error), Docker Compose v2, and `tar` must be installed. The generated directory
+contains the release manifest, pinned environment, Compose file, and
+installation guide.
+
+## First sign-up and first generation
+
+Sign-up is enabled by default. Supply a real key from
+[openrouter.ai/keys](https://openrouter.ai/keys) during setup: missing or
+placeholder keys stop installation/startup. Format checks do not prove provider
+access or available provider credit.
+
+For automation, pass `--yes` and securely provide `OPENROUTER_API_KEY` in the
+environment. `SELFHOSTED_DOMAIN` and the three `SELFHOSTED_*_PORT` variables
+override the defaults; no secret CLI argument is supported. Non-terminal input
+requires `--yes` and a key, rather than silently copying an unusable template.
+
+A domain such as `studio.example.com` derives HTTPS app/API/auth URLs and trusted
+origins. You must configure DNS, TLS and reverse-proxy routing separately; the
+release bundle README describes it. Existing installs upgrading to 0.2.15 must
+configure a key before restarting and remove conflicting localhost auth URLs
+when setting a domain.
+
 ## License
 
 AGPL-3.0

package/dist/index.d.ts

@@ -1,24 +1,27 @@
 #!/usr/bin/env node
-interface InstallCommand {
-    command: string;
-    args: string[];
-    label: string;
+interface CliOptions {
+    release?: string;
+    start: boolean;
+    yes?: boolean;
 }
-export declare function commandExists(command: string): boolean;
-export declare function getInstallCommand(hasCommand?: (command: string) => boolean): InstallCommand;
-export declare function writeDefaultEnv(projectDirectory: string): Promise<void>;
-/**
- * Open a URL in the system default browser.
- * Supports macOS, Linux (xdg-open), and Windows.
- */
+interface ReleaseManifest {
+    schemaVersion: number;
+    releaseTag: string;
+    image: string;
+}
+interface ReleaseAssetUrls {
+    archive: string;
+    checksum: string;
+}
+type FetchImplementation = typeof fetch;
+export declare function normalizeReleaseTag(value: string): string;
+export declare function imageTagFromReleaseTag(releaseTag: string): string;
+export declare function getReleaseAssetUrls(releaseTag: string, downloadBaseUrl?: string): ReleaseAssetUrls;
+export declare function resolveReleaseTag(requestedRelease?: string, fetchImplementation?: FetchImplementation): Promise<string>;
+export declare function readPackageVersion(packageJsonUrl?: URL): string;
+export declare function verifyReleaseChecksum(archivePath: string, checksumPath: string): Promise<void>;
+export declare function parseReleaseManifest(content: string, expectedReleaseTag: string): ReleaseManifest;
+export declare function assertSupportedNodeVersion(nodeVersion?: string): void;
 export declare function openBrowser(url: string): void;
-/**
- * Ask the user whether to use managed MongoDB or provide their own URI,
- * then update the project's .env file accordingly.
- *
- * - Managed path: downloads the mongod binary (cached after first run),
- *   sets MONGODB_URI + GENFEED_MANAGED_MONGO=true.
- * - Custom path: prompts for a URI and sets only MONGODB_URI.
- */
-export declare function setupMongoDB(projectDirectory: string): Promise<void>;
+export declare function installRelease(projectName: string, options: CliOptions, fetchImplementation?: FetchImplementation): Promise<void>;
 export {};

package/dist/index.js

@@ -1,240 +1,293 @@
 #!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.commandExists = commandExists;
-exports.getInstallCommand = getInstallCommand;
-exports.writeDefaultEnv = writeDefaultEnv;
-exports.openBrowser = openBrowser;
-exports.setupMongoDB = setupMongoDB;
-const commander_1 = require("commander");
-const consola_1 = require("consola");
-const giget_1 = require("giget");
-const mongodb_memory_server_1 = require("mongodb-memory-server");
-const node_child_process_1 = require("node:child_process");
-const promises_1 = require("node:fs/promises");
-const node_path_1 = require("node:path");
-const TEMPLATE_REPOSITORY = 'github:genfeedai/core#master';
-const MANAGED_MONGO_URI = 'mongodb://127.0.0.1:27017/genfeed';
-const ONBOARDING_URL = 'http://localhost:3000/onboarding';
-function commandExists(command) {
-    const result = (0, node_child_process_1.spawnSync)(command, ['--version'], { stdio: 'ignore' });
-    return result.status === 0;
-}
-function getInstallCommand(hasCommand = commandExists) {
-    if (hasCommand('bun')) {
-        return {
-            args: ['install'],
-            command: 'bun',
-            label: 'bun install',
-        };
+import { spawn, spawnSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { readFileSync, realpathSync } from 'node:fs';
+import { access, mkdir, mkdtemp, readFile, rm, writeFile, } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { consola } from 'consola';
+import { configureEnvironment } from './wizard.js';
+const REPOSITORY = 'genfeedai/genfeed.ai';
+const RELEASE_API_URL = `https://api.github.com/repos/${REPOSITORY}/releases/latest`;
+const DEFAULT_DOWNLOAD_BASE_URL = `https://github.com/${REPOSITORY}/releases/download`;
+const RELEASE_ARCHIVE_NAME = 'genfeed-selfhosted.tar.gz';
+const RELEASE_CHECKSUM_NAME = `${RELEASE_ARCHIVE_NAME}.sha256`;
+const RELEASE_MANIFEST_NAME = 'release.json';
+const EXPECTED_IMAGE_REPOSITORY = 'ghcr.io/genfeedai/genfeed.ai';
+// Keep in sync with "engines.node" (>=24 <25) in package.json.
+const MIN_NODE_MAJOR = 24;
+const MAX_NODE_MAJOR_EXCLUSIVE = 25;
+function isNonNullObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+export function normalizeReleaseTag(value) {
+    const trimmed = value.trim();
+    const releaseTag = trimmed.startsWith('v') ? trimmed : `v${trimmed}`;
+    if (!/^v\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(releaseTag)) {
+        throw new Error(`Invalid release "${value}". Expected vX.Y.Z (for example, v0.5.0).`);
     }
+    return releaseTag;
+}
+export function imageTagFromReleaseTag(releaseTag) {
+    return normalizeReleaseTag(releaseTag).slice(1);
+}
+export function getReleaseAssetUrls(releaseTag, downloadBaseUrl = process.env.GENFEED_RELEASE_DOWNLOAD_BASE_URL ??
+    DEFAULT_DOWNLOAD_BASE_URL) {
+    const normalizedTag = normalizeReleaseTag(releaseTag);
+    const baseUrl = downloadBaseUrl.replace(/\/$/, '');
     return {
-        args: ['install'],
-        command: 'npm',
-        label: 'npm install',
+        archive: `${baseUrl}/${normalizedTag}/${RELEASE_ARCHIVE_NAME}`,
+        checksum: `${baseUrl}/${normalizedTag}/${RELEASE_CHECKSUM_NAME}`,
     };
 }
-async function fileExists(filePath) {
-    try {
-        await (0, promises_1.access)(filePath);
-        return true;
+export async function resolveReleaseTag(requestedRelease, fetchImplementation = fetch) {
+    if (requestedRelease) {
+        return normalizeReleaseTag(requestedRelease);
     }
-    catch {
-        return false;
+    const response = await fetchImplementation(RELEASE_API_URL, {
+        headers: {
+            Accept: 'application/vnd.github+json',
+            'User-Agent': '@genfeedai/create',
+        },
+        signal: AbortSignal.timeout(30_000),
+    });
+    if (!response.ok) {
+        throw new Error(`Could not resolve the latest Genfeed.ai release (HTTP ${response.status}).`);
+    }
+    const payload = await response.json();
+    if (!isNonNullObject(payload)) {
+        throw new Error('GitHub returned invalid latest-release metadata.');
     }
+    const tagName = payload.tag_name;
+    if (typeof tagName !== 'string') {
+        throw new Error('GitHub latest release did not include a release tag.');
+    }
+    return normalizeReleaseTag(tagName);
 }
-const DEFAULT_ENV = `# ─── Required ───────────────────────────────────────────────────────
-MONGODB_URI=mongodb://127.0.0.1:27017/genfeed
-
-# ─── API Server ─────────────────────────────────────────────────────
-PORT=3001
-CORS_ORIGIN=http://localhost:3000
-API_BASE_URL=http://localhost:3001
-
-# ─── Redis (BullMQ job queue) ──────────────────────────────────────
-REDIS_HOST=localhost
-REDIS_PORT=6379
-# REDIS_PASSWORD=
-
-# ─── AI Providers (add your keys during onboarding) ────────────────
-# REPLICATE_API_TOKEN=
-# FAL_API_KEY=
-# ELEVENLABS_API_KEY=
-# HF_API_TOKEN=
-
-# ─── Ollama (local LLM — optional) ────────────────────────────────
-# OLLAMA_ENABLED=false
-# OLLAMA_BASE_URL=http://localhost:11434
-# OLLAMA_DEFAULT_MODEL=llama3.1
-
-# ─── Frontend ──────────────────────────────────────────────────────
-NEXT_PUBLIC_API_URL=http://localhost:3001/api
-# NEXT_PUBLIC_URL=http://localhost:3000
-# NEXT_PUBLIC_TTS_ENABLED=false
-`;
-const ENV_LOCATIONS = ['.env', 'apps/api/.env'];
-async function writeDefaultEnv(projectDirectory) {
-    for (const location of ENV_LOCATIONS) {
-        const envPath = (0, node_path_1.join)(projectDirectory, location);
-        const hasEnv = await fileExists(envPath);
-        if (!hasEnv) {
-            await (0, promises_1.mkdir)((0, node_path_1.dirname)(envPath), { recursive: true });
-            await (0, promises_1.writeFile)(envPath, DEFAULT_ENV, 'utf-8');
-        }
+export function readPackageVersion(packageJsonUrl = new URL('../package.json', import.meta.url)) {
+    const manifest = JSON.parse(readFileSync(fileURLToPath(packageJsonUrl), 'utf8'));
+    if (!isNonNullObject(manifest) || typeof manifest.version !== 'string') {
+        throw new Error('Could not read the @genfeedai/create package version.');
     }
-    consola_1.consola.success('Created .env with working defaults');
+    return manifest.version;
 }
-/**
- * Open a URL in the system default browser.
- * Supports macOS, Linux (xdg-open), and Windows.
- */
-function openBrowser(url) {
-    const platform = process.platform;
-    if (platform === 'darwin') {
-        (0, node_child_process_1.execFile)('open', [url]);
+async function downloadFile(url, destination, fetchImplementation) {
+    const response = await fetchImplementation(url, {
+        headers: { 'User-Agent': '@genfeedai/create' },
+        redirect: 'follow',
+        signal: AbortSignal.timeout(120_000),
+    });
+    if (!response.ok) {
+        throw new Error(`Download failed (HTTP ${response.status}): ${url}`);
     }
-    else if (platform === 'linux') {
-        (0, node_child_process_1.execFile)('xdg-open', [url]);
+    await writeFile(destination, new Uint8Array(await response.arrayBuffer()));
+}
+export async function verifyReleaseChecksum(archivePath, checksumPath) {
+    const checksumContent = await readFile(checksumPath, 'utf8');
+    const match = checksumContent.match(/^([a-fA-F0-9]{64})\s+/);
+    if (!match) {
+        throw new Error('Release checksum file is malformed.');
     }
-    else if (platform === 'win32') {
-        (0, node_child_process_1.execFile)('cmd', ['/c', 'start', '', url]);
+    const archive = await readFile(archivePath);
+    const actualChecksum = createHash('sha256').update(archive).digest('hex');
+    const expectedChecksum = match[1].toLowerCase();
+    if (actualChecksum !== expectedChecksum) {
+        throw new Error(`Release checksum mismatch: expected ${expectedChecksum}, received ${actualChecksum}.`);
     }
 }
-async function waitForServer(url, timeoutMs = 120_000) {
-    const start = Date.now();
-    while (Date.now() - start < timeoutMs) {
-        try {
-            const response = await fetch(url, { signal: AbortSignal.timeout(2000) });
-            if (response.ok || response.status === 404) {
-                return true;
-            }
-        }
-        catch {
-            // Server not ready yet
-        }
-        await new Promise((r) => setTimeout(r, 1500));
+export function parseReleaseManifest(content, expectedReleaseTag) {
+    const parsed = JSON.parse(content);
+    if (!isNonNullObject(parsed)) {
+        throw new Error('Release manifest is not an object.');
     }
-    return false;
+    const normalizedTag = normalizeReleaseTag(expectedReleaseTag);
+    const expectedImage = `${EXPECTED_IMAGE_REPOSITORY}:${imageTagFromReleaseTag(normalizedTag)}`;
+    const schemaVersion = parsed.schemaVersion;
+    const releaseTag = parsed.releaseTag;
+    const image = parsed.image;
+    if (schemaVersion !== 1 ||
+        releaseTag !== normalizedTag ||
+        image !== expectedImage) {
+        throw new Error(`Release manifest does not match ${normalizedTag} and ${expectedImage}.`);
+    }
+    return {
+        image,
+        releaseTag,
+        schemaVersion,
+    };
+}
+function commandExists(command, args = ['--version']) {
+    return spawnSync(command, args, { stdio: 'ignore' }).status === 0;
 }
-async function runInstall(projectDirectory) {
-    const installCommand = getInstallCommand();
+async function runCommand(command, args, options = {}) {
     await new Promise((resolvePromise, rejectPromise) => {
-        const child = (0, node_child_process_1.spawn)(installCommand.command, installCommand.args, {
-            cwd: projectDirectory,
-            env: {
-                ...process.env,
-                HUSKY: '0',
-            },
-            stdio: 'inherit',
+        const child = spawn(command, args, {
+            cwd: options.cwd,
+            stdio: options.stdio ?? 'inherit',
         });
-        child.on('error', (error) => {
-            rejectPromise(error);
-        });
-        child.on('close', (code) => {
+        child.once('error', rejectPromise);
+        child.once('close', (code, signal) => {
             if (code === 0) {
                 resolvePromise();
                 return;
             }
-            rejectPromise(new Error(`${installCommand.label} failed with exit code ${code ?? 'unknown'}`));
+            rejectPromise(new Error(`${command} ${args.join(' ')} failed with ${code ?? signal ?? 'an unknown error'}.`));
         });
     });
-    return installCommand;
-}
-async function replaceEnvValue(projectDirectory, key, value) {
-    const pattern = new RegExp(`^${key}=.*$`, 'm');
-    for (const location of ENV_LOCATIONS) {
-        const envPath = (0, node_path_1.join)(projectDirectory, location);
-        const exists = await fileExists(envPath);
-        if (!exists) {
-            continue;
-        }
-        const content = await (0, promises_1.readFile)(envPath, 'utf-8');
-        if (pattern.test(content)) {
-            await (0, promises_1.writeFile)(envPath, content.replace(pattern, `${key}=${value}`), 'utf-8');
+}
+export function assertSupportedNodeVersion(nodeVersion = process.versions.node) {
+    const major = Number.parseInt(nodeVersion.split('.')[0] ?? '', 10);
+    if (!Number.isInteger(major) ||
+        major < MIN_NODE_MAJOR ||
+        major >= MAX_NODE_MAJOR_EXCLUSIVE) {
+        throw new Error(`Node.js ${MIN_NODE_MAJOR} is required (supported range: >=${MIN_NODE_MAJOR} <${MAX_NODE_MAJOR_EXCLUSIVE}); found ${nodeVersion}. Install Node.js ${MIN_NODE_MAJOR} and run again.`);
+    }
+}
+function assertInstallPrerequisites() {
+    if (!commandExists('tar')) {
+        throw new Error('tar is required to extract the Genfeed.ai release bundle.');
+    }
+    if (!commandExists('docker', ['compose', 'version'])) {
+        throw new Error('Docker Compose is required. Install Docker Desktop or the Docker Compose plugin.');
+    }
+}
+async function waitForApp(fetchImplementation, appUrl, timeoutMs = 180_000) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        try {
+            const response = await fetchImplementation(appUrl, {
+                redirect: 'manual',
+                signal: AbortSignal.timeout(2_000),
+            });
+            if (response.ok || (response.status >= 300 && response.status < 400)) {
+                return true;
+            }
         }
-        else {
-            await (0, promises_1.appendFile)(envPath, `\n${key}=${value}`, 'utf-8');
+        catch {
+            // The container is still starting.
         }
+        await new Promise((resolvePromise) => setTimeout(resolvePromise, 2_000));
     }
+    return false;
 }
-/**
- * Ask the user whether to use managed MongoDB or provide their own URI,
- * then update the project's .env file accordingly.
- *
- * - Managed path: downloads the mongod binary (cached after first run),
- *   sets MONGODB_URI + GENFEED_MANAGED_MONGO=true.
- * - Custom path: prompts for a URI and sets only MONGODB_URI.
- */
-async function setupMongoDB(projectDirectory) {
-    const hasOwnMongo = await consola_1.consola.prompt('Do you have an existing MongoDB instance? (press Enter to use managed MongoDB)', {
-        initial: false,
-        type: 'confirm',
-    });
-    if (hasOwnMongo) {
-        const uri = await consola_1.consola.prompt('Enter your MongoDB URI:', {
-            initial: MANAGED_MONGO_URI,
-            type: 'text',
-        });
-        await replaceEnvValue(projectDirectory, 'MONGODB_URI', String(uri));
-        consola_1.consola.success('MongoDB URI saved to .env');
+export function openBrowser(url) {
+    let command;
+    let args = [];
+    if (process.platform === 'darwin') {
+        command = 'open';
+        args = [url];
+    }
+    else if (process.platform === 'linux') {
+        command = 'xdg-open';
+        args = [url];
+    }
+    else if (process.platform === 'win32') {
+        command = 'cmd';
+        args = ['/c', 'start', '', url];
+    }
+    if (!command) {
         return;
     }
-    consola_1.consola.start('Downloading MongoDB binary (cached after first run)…');
-    await mongodb_memory_server_1.MongoBinary.getPath({});
-    consola_1.consola.success('MongoDB binary ready');
-    await replaceEnvValue(projectDirectory, 'MONGODB_URI', MANAGED_MONGO_URI);
-    await replaceEnvValue(projectDirectory, 'GENFEED_MANAGED_MONGO', 'true');
-    consola_1.consola.success('Managed MongoDB configured — will auto-start on `bun run dev`');
-}
-async function scaffoldProject(projectName) {
-    const projectDirectory = (0, node_path_1.resolve)(process.cwd(), projectName);
-    consola_1.consola.start(`Scaffolding ${projectName} from ${TEMPLATE_REPOSITORY}`);
-    await (0, giget_1.downloadTemplate)(TEMPLATE_REPOSITORY, {
-        dir: projectDirectory,
-        force: false,
-    });
-    consola_1.consola.success(`Downloaded template into ${projectDirectory}`);
-    await writeDefaultEnv(projectDirectory);
-    const installCommand = await runInstall(projectDirectory);
-    consola_1.consola.success(`Dependencies installed with ${installCommand.label}`);
-    await setupMongoDB(projectDirectory);
-    const devCommand = installCommand.command === 'bun' ? 'bun' : 'npm';
-    const child = (0, node_child_process_1.spawn)(devCommand, ['run', 'dev'], {
-        cwd: projectDirectory,
-        stdio: 'inherit',
+    const child = spawn(command, args, { detached: true, stdio: 'ignore' });
+    child.once('error', () => {
+        // Opening a browser is a convenience; the installation is already ready.
     });
-    consola_1.consola.start('Waiting for dev servers to start…');
-    const [apiReady, webReady] = await Promise.all([
-        waitForServer('http://localhost:3001/api'),
-        waitForServer('http://localhost:3000'),
-    ]);
-    if (apiReady && webReady) {
-        consola_1.consola.box([
-            `Genfeed Core is running.`,
-            '',
-            `Opening ${ONBOARDING_URL}`,
-        ].join('\n'));
-        openBrowser(ONBOARDING_URL);
-    }
-    else {
-        consola_1.consola.warn('Servers did not start in time. Open manually:');
-        consola_1.consola.info(ONBOARDING_URL);
-    }
-    await new Promise((resolvePromise) => {
-        child.on('close', (code) => {
-            process.exitCode = code ?? 0;
-            resolvePromise();
+    child.unref();
+}
+export async function installRelease(projectName, options, fetchImplementation = fetch) {
+    assertInstallPrerequisites();
+    const projectDirectory = resolve(process.cwd(), projectName);
+    try {
+        await access(projectDirectory);
+        throw new Error(`Destination already exists: ${projectDirectory}`);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.startsWith('Destination')) {
+            throw error;
+        }
+    }
+    const releaseTag = await resolveReleaseTag(options.release, fetchImplementation);
+    const assetUrls = getReleaseAssetUrls(releaseTag);
+    const temporaryDirectory = await mkdtemp(join(tmpdir(), 'genfeed-create-release-'));
+    const archivePath = join(temporaryDirectory, RELEASE_ARCHIVE_NAME);
+    const checksumPath = join(temporaryDirectory, RELEASE_CHECKSUM_NAME);
+    let createdProjectDirectory = false;
+    let startAttempted = false;
+    consola.start(`Downloading Genfeed.ai ${releaseTag}`);
+    try {
+        await Promise.all([
+            downloadFile(assetUrls.archive, archivePath, fetchImplementation),
+            downloadFile(assetUrls.checksum, checksumPath, fetchImplementation),
+        ]);
+        await verifyReleaseChecksum(archivePath, checksumPath);
+        await mkdir(projectDirectory);
+        createdProjectDirectory = true;
+        await runCommand('tar', ['-xzf', archivePath, '-C', projectDirectory, '--strip-components=1'], { stdio: 'ignore' });
+        const releaseManifest = parseReleaseManifest(await readFile(join(projectDirectory, RELEASE_MANIFEST_NAME), 'utf8'), releaseTag);
+        const setup = await configureEnvironment(await readFile(join(projectDirectory, '.env.example'), 'utf8'), options.yes);
+        await writeFile(join(projectDirectory, '.env'), setup.content, {
+            flag: 'wx',
+            mode: 0o600,
         });
-    });
+        await runCommand('docker', [
+            'compose',
+            '--env-file',
+            '.env',
+            '-f',
+            'compose.yml',
+            'config',
+            '--quiet',
+        ], { cwd: projectDirectory, stdio: 'ignore' });
+        consola.success(`Installed ${releaseManifest.releaseTag} (${releaseManifest.image}) in ${projectDirectory}`);
+        if (!options.start) {
+            consola.info(`Start later with: cd ${projectName} && docker compose --env-file .env -f compose.yml up -d`);
+            return;
+        }
+        startAttempted = true;
+        await runCommand('docker', ['compose', '--env-file', '.env', '-f', 'compose.yml', 'up', '-d'], { cwd: projectDirectory });
+        consola.start('Waiting for Genfeed.ai to become ready…');
+        if (await waitForApp(fetchImplementation, setup.appUrl)) {
+            consola.success(`Genfeed.ai is running at ${setup.appUrl}`);
+            openBrowser(setup.appUrl);
+        }
+        else {
+            consola.warn(`The containers started, but ${setup.appUrl} is not ready yet.`);
+        }
+    }
+    catch (error) {
+        if (createdProjectDirectory && !startAttempted) {
+            await rm(projectDirectory, { force: true, recursive: true });
+        }
+        else if (startAttempted) {
+            consola.warn(`Startup failed. Installation files were preserved at ${projectDirectory} for inspection or recovery.`);
+        }
+        throw error;
+    }
+    finally {
+        await rm(temporaryDirectory, { force: true, recursive: true });
+    }
 }
 async function main() {
-    const program = new commander_1.Command()
+    try {
+        assertSupportedNodeVersion();
+    }
+    catch (error) {
+        consola.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+        return;
+    }
+    const { Command } = await import('commander');
+    const program = new Command()
         .name('genfeedai')
-        .description('Genfeed Core — AI workflow engine. Self-host for free.')
-        .version('0.1.3')
-        .argument('<project-name>', 'Directory name for the new project')
-        .action(async (projectName) => {
-        await scaffoldProject(projectName);
+        .description('Install a public Genfeed.ai Community release.')
+        .version(readPackageVersion())
+        .argument('<project-name>', 'Directory for the self-hosted installation')
+        .option('--release <tag>', 'Install an exact release (for example, v0.5.0)')
+        .option('--yes', 'Use OPENROUTER_API_KEY and optional SELFHOSTED_DOMAIN without prompts')
+        .option('--no-start', 'Prepare and verify the installation without starting it')
+        .action(async (projectName, options) => {
+        await installRelease(projectName, options);
     })
         .showHelpAfterError();
     try {
@@ -242,11 +295,22 @@ async function main() {
     }
     catch (error) {
         const normalizedError = error instanceof Error ? error : new Error('Unknown CLI error');
-        consola_1.consola.error(normalizedError.message);
+        consola.error(normalizedError.message);
         process.exitCode = 1;
     }
 }
-if (require.main === module) {
+function isMainModule() {
+    if (!process.argv[1]) {
+        return false;
+    }
+    try {
+        return realpathSync(process.argv[1]) === fileURLToPath(import.meta.url);
+    }
+    catch {
+        return false;
+    }
+}
+if (isMainModule()) {
     void main();
 }
 //# sourceMappingURL=index.js.map