create-ragen-app 0.1.0

package/README.md

@@ -0,0 +1,49 @@
+# create-ragen-app
+
+Scaffolds a self-hosted [Ragen AI](https://github.com/webamigos/RagenAI)
+installation with one command.
+
+```bash
+npx create-ragen-app my-ragen-app
+```
+
+It clones the repo, generates every secret it safely can, lets you paste a
+plain OpenAI or Anthropic API key instead of configuring an enterprise model
+provider, starts the backing services (Postgres, Qdrant, Temporal, LiteLLM,
+Redis, …) in Docker, and runs the app's own first-run setup (Prisma client,
+migrations, seed data) — leaving `cd my-ragen-app && npm run web:dev` as the
+only remaining step.
+
+## Flags
+
+| Flag              | Effect                                             |
+| ----------------- | --------------------------------------------------- |
+| `--ref=<branch>`  | Clone a branch/tag other than `main`                 |
+| `--skip-docker`   | Write the `.env.local` files but don't start Docker  |
+| `--skip-install`  | Skip `npm install` / Prisma / seed                   |
+| `--yes`           | Accept every default without prompting               |
+
+Anything the wizard doesn't ask about (S3 storage, encryption at rest,
+Stripe, email, MCP connectors) ships exactly as documented in the repo's own
+`.env.example` files — see
+[docs/self-hosting](https://docs.ragen.ai/docs/self-hosting).
+
+## What it changes, and how it decides
+
+`src/manifest.ts` is the single list of which env vars get a generated
+secret or a corrected local-dev default, and which files receive them. It is
+deliberately an *overrides* list — anything not in it is left exactly as the
+cloned repo's own `.env.example` already has it. See the file's own comments
+for the sharing rules (some secrets are the same value in two files, most are
+independent).
+
+## Publishing (manual for now)
+
+There is no CI job wired up yet (see the project plan's non-goals). To cut a
+new version:
+
+```bash
+npm version <patch|minor|major> --workspace=create-ragen-app
+npm run build --workspace=create-ragen-app
+npm publish --workspace=create-ragen-app
+```

package/dist/args.d.ts

@@ -0,0 +1,11 @@
+export interface CliArgs {
+    /** Undefined when the user gave no positional argument — the CLI prompts. */
+    targetDir: string | undefined;
+    ref: string;
+    skipDocker: boolean;
+    skipInstall: boolean;
+    yes: boolean;
+}
+export declare const DEFAULT_TARGET_DIR = "./ragen-app";
+export declare function parseArgs(argv: string[]): CliArgs;
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAGhD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CA4BjD"}

package/dist/args.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TARGET_DIR = void 0;
+exports.parseArgs = parseArgs;
+exports.DEFAULT_TARGET_DIR = './ragen-app';
+const DEFAULT_REF = 'main';
+function parseArgs(argv) {
+    const positionals = argv.filter((arg) => !arg.startsWith('--'));
+    if (positionals.length > 1) {
+        // Every flag here takes `--name=value`, not a separate token — a second
+        // bare token (e.g. `--ref main`) would otherwise silently become
+        // targetDir instead of erroring.
+        throw new Error(`Unexpected extra arguments: ${positionals.slice(1).join(' ')}. Flag values must use --name=value.`);
+    }
+    const hasFlag = (name) => argv.includes(`--${name}`);
+    const valueOf = (name) => {
+        const prefix = `--${name}=`;
+        const value = argv
+            .find((arg) => arg.startsWith(prefix))
+            ?.slice(prefix.length);
+        return value || undefined;
+    };
+    return {
+        targetDir: positionals[0],
+        ref: valueOf('ref') ?? DEFAULT_REF,
+        skipDocker: hasFlag('skip-docker'),
+        skipInstall: hasFlag('skip-install'),
+        yes: hasFlag('yes'),
+    };
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":";;;AAYA,8BA4BC;AA/BY,QAAA,kBAAkB,GAAG,aAAa,CAAC;AAChD,MAAM,WAAW,GAAG,MAAM,CAAC;AAE3B,SAAgB,SAAS,CAAC,IAAc;IACtC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAChE,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,wEAAwE;QACxE,iEAAiE;QACjE,iCAAiC;QACjC,MAAM,IAAI,KAAK,CACb,+BAA+B,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,sCAAsC,CACpG,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAEtE,MAAM,OAAO,GAAG,CAAC,IAAY,EAAsB,EAAE;QACnD,MAAM,MAAM,GAAG,KAAK,IAAI,GAAG,CAAC;QAC5B,MAAM,KAAK,GAAG,IAAI;aACf,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YACtC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzB,OAAO,KAAK,IAAI,SAAS,CAAC;IAC5B,CAAC,CAAC;IAEF,OAAO;QACL,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;QACzB,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW;QAClC,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC;QAClC,WAAW,EAAE,OAAO,CAAC,cAAc,CAAC;QACpC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC;KACpB,CAAC;AACJ,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export declare function run(argv: string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAuDA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8FvD"}

package/dist/cli.js

@@ -0,0 +1,298 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const clack = __importStar(require("@clack/prompts"));
+const dotenv_1 = require("dotenv");
+const args_1 = require("./args");
+const clone_1 = require("./clone");
+const env_file_1 = require("./env-file");
+const litellm_config_1 = require("./litellm-config");
+const llm_provider_1 = require("./llm-provider");
+const manifest_1 = require("./manifest");
+const secrets_1 = require("./secrets");
+const tasks_1 = require("./tasks");
+const ENV_PATHS = {
+    root: { example: '.env.example', local: '.env.local' },
+    admin: { example: 'apps/admin/.env.example', local: 'apps/admin/.env.local' },
+};
+async function run(argv) {
+    const args = (0, args_1.parseArgs)(argv);
+    clack.intro('create-ragen-app');
+    const targetDir = await resolveTargetDir(args.targetDir, args.yes);
+    if (!targetDir) {
+        return;
+    }
+    const cloneSpinner = clack.spinner();
+    cloneSpinner.start(`Cloning Ragen into ${targetDir}`);
+    try {
+        await (0, clone_1.cloneRagenApp)(targetDir, args.ref);
+    }
+    catch (error) {
+        cloneSpinner.stop('Clone failed.', 1);
+        clack.cancel(`Could not download ${args.ref} from the Ragen repository: ${String(error)}`);
+        return;
+    }
+    cloneSpinner.stop('Cloned.');
+    const resolvedValues = resolveManifestValues();
+    const rootOverrides = overridesForTarget('root', resolvedValues);
+    const adminOverrides = overridesForTarget('admin', resolvedValues);
+    const llmPrompt = args.yes
+        ? { cancelled: false, choice: undefined }
+        : await promptLlmProvider();
+    if (llmPrompt.cancelled) {
+        clack.cancel('Cancelled.');
+        return;
+    }
+    const llmChoice = llmPrompt.choice;
+    if (llmChoice) {
+        Object.assign(rootOverrides, llmChoice.envUpdates);
+    }
+    const rootWrite = writeEnvFile(targetDir, 'root', rootOverrides);
+    const adminWrite = writeEnvFile(targetDir, 'admin', adminOverrides);
+    const missingKeys = [...rootWrite.missingKeys, ...adminWrite.missingKeys];
+    if (missingKeys.length > 0) {
+        clack.cancel([
+            `Wrote what could be matched, but these keys have no line in the cloned repo's .env.example: ${missingKeys.join(', ')}.`,
+            "That usually means create-ragen-app's manifest and the repo have drifted — fix them by hand in .env.local before starting the app. Stopping before Docker/migrations, since they'd run against an incomplete config.",
+        ].join('\n'));
+        return;
+    }
+    if (llmChoice) {
+        patchLiteLLMConfig(targetDir, llmChoice.liteLLMEntry);
+    }
+    else {
+        clack.log.warn('No LLM provider configured — chat will not work until infra/litellm/config.yaml has a model and a matching API key. See docs/model-routing.md.');
+    }
+    if (!args.skipDocker) {
+        if (!(await maybeStartDocker(targetDir, args.yes))) {
+            return;
+        }
+    }
+    if (!args.skipInstall) {
+        // prisma.config.ts reads DATABASE_URL from process.env directly, and
+        // unlike `npm run db:seed` (tsx --env-file=.env.local), plain
+        // `npm run generate:types` / `npx prisma migrate deploy` don't load
+        // .env.local themselves — so the values just written have to be passed
+        // through explicitly.
+        const rootEnv = (0, dotenv_1.parse)(rootWrite.content);
+        if (!(await maybeRunFirstTimeSetup(targetDir, args.yes, rootEnv))) {
+            return;
+        }
+    }
+    clack.outro([
+        'Done. Next steps:',
+        `  cd ${targetDir}`,
+        '  npm run web:dev',
+        '',
+        'App:   http://localhost:3000',
+        'Admin: http://localhost:3200  (npm run admin:dev)',
+        '',
+        'Anything skipped above (S3 storage, encryption, Stripe, email, MCP',
+        'connectors) is documented in docs/self-hosting.',
+    ].join('\n'));
+}
+async function resolveTargetDir(given, yes) {
+    let targetDir = given;
+    if (!targetDir) {
+        if (yes) {
+            targetDir = args_1.DEFAULT_TARGET_DIR;
+        }
+        else {
+            const answer = await clack.text({
+                message: 'Where should Ragen be created?',
+                placeholder: args_1.DEFAULT_TARGET_DIR,
+                defaultValue: args_1.DEFAULT_TARGET_DIR,
+            });
+            if (clack.isCancel(answer)) {
+                clack.cancel('Cancelled.');
+                return undefined;
+            }
+            targetDir = answer || args_1.DEFAULT_TARGET_DIR;
+        }
+    }
+    if ((0, node_fs_1.existsSync)(targetDir)) {
+        const stats = (0, node_fs_1.statSync)(targetDir);
+        if (!stats.isDirectory()) {
+            clack.cancel(`${targetDir} already exists and is not a directory.`);
+            return undefined;
+        }
+        if ((0, node_fs_1.readdirSync)(targetDir).length > 0) {
+            clack.cancel(`${targetDir} already exists and is not empty.`);
+            return undefined;
+        }
+    }
+    return targetDir;
+}
+/**
+ * Resolves each manifest entry once, so an entry listing more than one
+ * target (e.g. INTERNAL_API_SECRET, shared by root and apps/admin) writes
+ * the same value to all of them, while two independent entries for the same
+ * key (BETTER_AUTH_SECRET in root vs. admin) resolve independently.
+ */
+function resolveManifestValues() {
+    const resolved = new Map();
+    for (const entry of manifest_1.MANIFEST) {
+        resolved.set(entry, entry.strategy === 'generate-secret' ? (0, secrets_1.generateSecret)() : entry.value);
+    }
+    return resolved;
+}
+function overridesForTarget(target, resolved) {
+    const overrides = {};
+    for (const entry of (0, manifest_1.entriesForTarget)(target)) {
+        overrides[entry.key] = resolved.get(entry);
+    }
+    return overrides;
+}
+function writeEnvFile(targetDir, target, overrides) {
+    const paths = ENV_PATHS[target];
+    const examplePath = (0, node_path_1.join)(targetDir, paths.example);
+    const localPath = (0, node_path_1.join)(targetDir, paths.local);
+    const template = (0, node_fs_1.readFileSync)(examplePath, 'utf8');
+    const { content, missingKeys } = (0, env_file_1.applyEnvOverrides)(template, overrides);
+    // Holds every generated secret plus any pasted API key — owner-only.
+    (0, node_fs_1.writeFileSync)(localPath, content, { mode: 0o600 });
+    return { content, missingKeys };
+}
+async function promptLlmProvider() {
+    const choice = await clack.select({
+        message: 'Which LLM provider should power chat?',
+        options: [
+            { value: 'openai', label: llm_provider_1.LLM_PROVIDERS.openai.label },
+            { value: 'anthropic', label: llm_provider_1.LLM_PROVIDERS.anthropic.label },
+            { value: 'skip', label: "I'll configure LiteLLM myself" },
+        ],
+    });
+    if (clack.isCancel(choice)) {
+        return { cancelled: true };
+    }
+    if (choice === 'skip') {
+        return { cancelled: false, choice: undefined };
+    }
+    const apiKey = await clack.password({
+        message: `Paste your ${llm_provider_1.LLM_PROVIDERS[choice].label} API key`,
+    });
+    if (clack.isCancel(apiKey)) {
+        return { cancelled: true };
+    }
+    if (!apiKey) {
+        return { cancelled: false, choice: undefined };
+    }
+    return {
+        cancelled: false,
+        choice: (0, llm_provider_1.resolveLlmProviderChoice)(choice, apiKey),
+    };
+}
+function patchLiteLLMConfig(targetDir, entry) {
+    const configPath = (0, node_path_1.join)(targetDir, 'infra/litellm/config.yaml');
+    const original = (0, node_fs_1.readFileSync)(configPath, 'utf8');
+    (0, node_fs_1.writeFileSync)(configPath, (0, litellm_config_1.addLiteLLMModel)(original, entry));
+}
+async function confirmOrSkip(message, yes) {
+    if (yes) {
+        return true;
+    }
+    const answer = await clack.confirm({ message });
+    return !clack.isCancel(answer) && answer;
+}
+/**
+ * Runs one setup step under a spinner, turning a rejection into a stopped
+ * spinner plus a clean `clack.cancel()` instead of letting it reach
+ * `src/index.ts`'s generic catch — which would leave the spinner "running"
+ * forever and print a raw stack trace. Returns whether the caller should
+ * keep going.
+ */
+async function runStep(spinner, label, successMessage, task) {
+    spinner.start(label);
+    try {
+        await task();
+    }
+    catch (error) {
+        spinner.stop(`${label} — failed.`, 1);
+        clack.cancel(String(error));
+        return false;
+    }
+    spinner.stop(successMessage);
+    return true;
+}
+async function maybeStartDocker(targetDir, yes) {
+    const proceed = await confirmOrSkip('Start the backing services now? (Postgres, Qdrant, Temporal, LiteLLM, Redis, …)', yes);
+    if (!proceed) {
+        return true;
+    }
+    if (!(await (0, tasks_1.isDockerAvailable)())) {
+        clack.log.warn('Docker does not seem to be available — skipping. Install Docker and run `docker compose up -d` yourself.');
+        return true;
+    }
+    return runStep(clack.spinner(), 'Starting docker compose (Postgres, Qdrant, Temporal, LiteLLM, Redis, …)', 'Backing services started.', () => (0, tasks_1.startDockerServices)({ cwd: targetDir }));
+}
+async function maybeRunFirstTimeSetup(targetDir, yes, env) {
+    const proceed = await confirmOrSkip('Install dependencies and run first-time setup (prisma generate, migrate, seed)?', yes);
+    if (!proceed) {
+        return true;
+    }
+    const spinner = clack.spinner();
+    const steps = [
+        [
+            'npm install',
+            'Dependencies installed.',
+            () => (0, tasks_1.installDependencies)({ cwd: targetDir }),
+        ],
+        [
+            'Generating the Prisma client',
+            'Prisma client generated.',
+            () => (0, tasks_1.generatePrismaClient)({ cwd: targetDir, env }),
+        ],
+        [
+            'Applying database migrations',
+            'Migrations applied.',
+            () => (0, tasks_1.migrateDatabase)({ cwd: targetDir, env }),
+        ],
+        [
+            'Seeding the database',
+            'Database seeded.',
+            () => (0, tasks_1.seedDatabase)({ cwd: targetDir, env }),
+        ],
+    ];
+    for (const [label, successMessage, task] of steps) {
+        if (!(await runStep(spinner, label, successMessage, task))) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/clone.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Kept as one constant so the org/repo path is a one-line change if the
+ * public location differs from this by launch time — see the create-ragen-app
+ * plan's non-goals.
+ */
+export declare const RAGEN_APP_REPO = "webamigos/RagenAI";
+export declare function cloneRagenApp(targetDir: string, ref: string): Promise<void>;
+//# sourceMappingURL=clone.d.ts.map

package/dist/clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../src/clone.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAElD,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/clone.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RAGEN_APP_REPO = void 0;
+exports.cloneRagenApp = cloneRagenApp;
+const giget_1 = require("giget");
+/**
+ * Kept as one constant so the org/repo path is a one-line change if the
+ * public location differs from this by launch time — see the create-ragen-app
+ * plan's non-goals.
+ */
+exports.RAGEN_APP_REPO = 'webamigos/RagenAI';
+async function cloneRagenApp(targetDir, ref) {
+    await (0, giget_1.downloadTemplate)(`github:${exports.RAGEN_APP_REPO}#${ref}`, {
+        dir: targetDir,
+        forceClean: false,
+        install: false,
+    });
+}
+//# sourceMappingURL=clone.js.map

package/dist/clone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.js","sourceRoot":"","sources":["../src/clone.ts"],"names":[],"mappings":";;;AASA,sCASC;AAlBD,iCAAyC;AAEzC;;;;GAIG;AACU,QAAA,cAAc,GAAG,mBAAmB,CAAC;AAE3C,KAAK,UAAU,aAAa,CACjC,SAAiB,EACjB,GAAW;IAEX,MAAM,IAAA,wBAAgB,EAAC,UAAU,sBAAc,IAAI,GAAG,EAAE,EAAE;QACxD,GAAG,EAAE,SAAS;QACd,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/env-file.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Turns a `.env.example` template into a working `.env.local` by replacing
+ * only the `KEY=` lines named in `values`, leaving every comment, blank line
+ * and untouched default exactly as the cloned repo shipped it. Matches both
+ * commented (`# KEY=`) and uncommented (`KEY=...`) lines, so a generated
+ * secret also uncomments a line that started out disabled.
+ *
+ * `missingKeys` reports any requested key that never matched a line in the
+ * template — surfaced to the user rather than silently dropped, since it
+ * usually means the manifest and the cloned repo's `.env.example` have
+ * drifted.
+ *
+ * Only the first matching line per key is rewritten — some vars
+ * (`AWS_BEDROCK_REGION`, `S3_REGION`, `FEATURE_FLAG_RERANKING`, …) appear
+ * more than once in `.env.example`, documented in different sections, and a
+ * second rewrite would duplicate an active assignment or uncomment an
+ * example that was meant to stay a comment.
+ */
+export interface ApplyEnvOverridesResult {
+    content: string;
+    missingKeys: string[];
+}
+export declare function applyEnvOverrides(template: string, values: Record<string, string>): ApplyEnvOverridesResult;
+//# sourceMappingURL=env-file.d.ts.map

package/dist/env-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-file.d.ts","sourceRoot":"","sources":["../src/env-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,uBAAuB,CAazB"}

package/dist/env-file.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Turns a `.env.example` template into a working `.env.local` by replacing
+ * only the `KEY=` lines named in `values`, leaving every comment, blank line
+ * and untouched default exactly as the cloned repo shipped it. Matches both
+ * commented (`# KEY=`) and uncommented (`KEY=...`) lines, so a generated
+ * secret also uncomments a line that started out disabled.
+ *
+ * `missingKeys` reports any requested key that never matched a line in the
+ * template — surfaced to the user rather than silently dropped, since it
+ * usually means the manifest and the cloned repo's `.env.example` have
+ * drifted.
+ *
+ * Only the first matching line per key is rewritten — some vars
+ * (`AWS_BEDROCK_REGION`, `S3_REGION`, `FEATURE_FLAG_RERANKING`, …) appear
+ * more than once in `.env.example`, documented in different sections, and a
+ * second rewrite would duplicate an active assignment or uncomment an
+ * example that was meant to stay a comment.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyEnvOverrides = applyEnvOverrides;
+const ENV_LINE = /^#?\s*([A-Z][A-Z0-9_]*)=/;
+function applyEnvOverrides(template, values) {
+    const remaining = new Set(Object.keys(values));
+    const lines = template.split('\n').map((line) => {
+        const key = ENV_LINE.exec(line)?.[1];
+        if (!key || !remaining.has(key)) {
+            return line;
+        }
+        remaining.delete(key);
+        return `${key}=${values[key]}`;
+    });
+    return { content: lines.join('\n'), missingKeys: [...remaining] };
+}
+//# sourceMappingURL=env-file.js.map

package/dist/env-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-file.js","sourceRoot":"","sources":["../src/env-file.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;AASH,8CAgBC;AAvBD,MAAM,QAAQ,GAAG,0BAA0B,CAAC;AAO5C,SAAgB,iBAAiB,CAC/B,QAAgB,EAChB,MAA8B;IAE9B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAE/C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC9C,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC;AACpE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("./cli");
+(0, cli_1.run)(process.argv.slice(2)).catch((error) => {
+    console.error(error instanceof Error ? error.message : error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,+BAA4B;AAE5B,IAAA,SAAG,EAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAClD,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/litellm-config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Wires a plain OpenAI or Anthropic API key into `infra/litellm/config.yaml`
+ * by inserting a new `model_list` entry as text, not by parsing and
+ * re-serializing the YAML. The shipped config is heavily hand-commented
+ * (rationale for every model, dated notes, links) and a round-trip through a
+ * YAML library would collapse or reorder all of that — a text splice right
+ * after the `model_list:` key preserves everything else byte-for-byte.
+ */
+export interface LiteLLMModelEntry {
+    modelName: string;
+    /** LiteLLM provider-prefixed model id, e.g. "openai/gpt-4o-mini". */
+    model: string;
+    /** Name of the env var holding the API key, e.g. "OPENAI_API_KEY". */
+    apiKeyEnvVar: string;
+}
+export declare function addLiteLLMModel(configText: string, entry: LiteLLMModelEntry): string;
+//# sourceMappingURL=litellm-config.d.ts.map

package/dist/litellm-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"litellm-config.d.ts","sourceRoot":"","sources":["../src/litellm-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,iBAAiB,GACvB,MAAM,CAoBR"}

package/dist/litellm-config.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Wires a plain OpenAI or Anthropic API key into `infra/litellm/config.yaml`
+ * by inserting a new `model_list` entry as text, not by parsing and
+ * re-serializing the YAML. The shipped config is heavily hand-commented
+ * (rationale for every model, dated notes, links) and a round-trip through a
+ * YAML library would collapse or reorder all of that — a text splice right
+ * after the `model_list:` key preserves everything else byte-for-byte.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addLiteLLMModel = addLiteLLMModel;
+function addLiteLLMModel(configText, entry) {
+    const lines = configText.split('\n');
+    const anchorIndex = lines.findIndex((line) => line.trim() === 'model_list:');
+    if (anchorIndex === -1) {
+        throw new Error('infra/litellm/config.yaml has no `model_list:` key — cannot insert a model entry.');
+    }
+    const entryLines = [
+        `  - model_name: ${entry.modelName}`,
+        '    litellm_params:',
+        `      model: ${entry.model}`,
+        `      api_key: os.environ/${entry.apiKeyEnvVar}`,
+        '',
+    ];
+    lines.splice(anchorIndex + 1, 0, ...entryLines);
+    return lines.join('\n');
+}
+//# sourceMappingURL=litellm-config.js.map

package/dist/litellm-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"litellm-config.js","sourceRoot":"","sources":["../src/litellm-config.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAUH,0CAuBC;AAvBD,SAAgB,eAAe,CAC7B,UAAkB,EAClB,KAAwB;IAExB,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,aAAa,CAAC,CAAC;IAE7E,IAAI,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,mFAAmF,CACpF,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG;QACjB,mBAAmB,KAAK,CAAC,SAAS,EAAE;QACpC,qBAAqB;QACrB,gBAAgB,KAAK,CAAC,KAAK,EAAE;QAC7B,6BAA6B,KAAK,CAAC,YAAY,EAAE;QACjD,EAAE;KACH,CAAC;IAEF,KAAK,CAAC,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,UAAU,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/llm-provider.d.ts

@@ -0,0 +1,21 @@
+import type { LiteLLMModelEntry } from './litellm-config';
+/**
+ * The `infra/litellm/config.yaml` shipped in the repo only wires Azure
+ * OpenAI, AWS Bedrock, Google Vertex and Scaleway — none of which a new
+ * self-hoster can use in five minutes. These two entries let the wizard
+ * paste a plain OpenAI or Anthropic key and get a working model instead.
+ */
+export type LlmProviderChoice = 'openai' | 'anthropic';
+export interface LlmProviderConfig {
+    label: string;
+    apiKeyEnvVar: string;
+    modelName: string;
+    litellmModel: string;
+}
+export declare const LLM_PROVIDERS: Record<LlmProviderChoice, LlmProviderConfig>;
+export interface LlmProviderChoiceResult {
+    envUpdates: Record<string, string>;
+    liteLLMEntry: LiteLLMModelEntry;
+}
+export declare function resolveLlmProviderChoice(choice: LlmProviderChoice, apiKey: string): LlmProviderChoiceResult;
+//# sourceMappingURL=llm-provider.d.ts.map

package/dist/llm-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider.d.ts","sourceRoot":"","sources":["../src/llm-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,CAkBtE,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,YAAY,EAAE,iBAAiB,CAAC;CACjC;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,MAAM,GACb,uBAAuB,CAezB"}

package/dist/llm-provider.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLM_PROVIDERS = void 0;
+exports.resolveLlmProviderChoice = resolveLlmProviderChoice;
+exports.LLM_PROVIDERS = {
+    openai: {
+        label: 'OpenAI',
+        apiKeyEnvVar: 'OPENAI_API_KEY',
+        modelName: 'gpt-4o-mini',
+        litellmModel: 'openai/gpt-4o-mini',
+    },
+    anthropic: {
+        label: 'Anthropic',
+        apiKeyEnvVar: 'ANTHROPIC_API_KEY',
+        // Not "claude-haiku-4-5" — packages/platform-contracts/src/llm/model-catalog.ts
+        // already uses that name for the (commented) Bedrock deployment of the
+        // same model. Two model_list entries sharing a model_name become one
+        // load-balanced pool in LiteLLM, silently mixing direct-Anthropic and
+        // Bedrock traffic under Bedrock's catalog metadata.
+        modelName: 'claude-haiku-4-5-direct',
+        litellmModel: 'anthropic/claude-haiku-4-5-20251001',
+    },
+};
+function resolveLlmProviderChoice(choice, apiKey) {
+    const config = exports.LLM_PROVIDERS[choice];
+    return {
+        envUpdates: {
+            [config.apiKeyEnvVar]: apiKey,
+            DEFAULT_MODEL: config.modelName,
+            DEFAULT_MODEL_PROVIDER: 'litellm',
+        },
+        liteLLMEntry: {
+            modelName: config.modelName,
+            model: config.litellmModel,
+            apiKeyEnvVar: config.apiKeyEnvVar,
+        },
+    };
+}
+//# sourceMappingURL=llm-provider.js.map

package/dist/llm-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider.js","sourceRoot":"","sources":["../src/llm-provider.ts"],"names":[],"mappings":";;;AA0CA,4DAkBC;AA3CY,QAAA,aAAa,GAAiD;IACzE,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ;QACf,YAAY,EAAE,gBAAgB;QAC9B,SAAS,EAAE,aAAa;QACxB,YAAY,EAAE,oBAAoB;KACnC;IACD,SAAS,EAAE;QACT,KAAK,EAAE,WAAW;QAClB,YAAY,EAAE,mBAAmB;QACjC,gFAAgF;QAChF,uEAAuE;QACvE,qEAAqE;QACrE,sEAAsE;QACtE,oDAAoD;QACpD,SAAS,EAAE,yBAAyB;QACpC,YAAY,EAAE,qCAAqC;KACpD;CACF,CAAC;AAOF,SAAgB,wBAAwB,CACtC,MAAyB,EACzB,MAAc;IAEd,MAAM,MAAM,GAAG,qBAAa,CAAC,MAAM,CAAC,CAAC;IAErC,OAAO;QACL,UAAU,EAAE;YACV,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM;YAC7B,aAAa,EAAE,MAAM,CAAC,SAAS;YAC/B,sBAAsB,EAAE,SAAS;SAClC;QACD,YAAY,EAAE;YACZ,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,KAAK,EAAE,MAAM,CAAC,YAAY;YAC1B,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC;KACF,CAAC;AACJ,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,38 @@
+/**
+ * What create-ragen-app changes in the two `.env.example` templates it ships
+ * as `.env.local` (root and apps/admin) to turn a fresh clone into a working
+ * local install, without asking a question for every variable.
+ *
+ * This is deliberately an *overrides* list, not a full inventory of every env
+ * var: anything not listed here is left exactly as the cloned repo's own
+ * `.env.example` already has it (a comment, a blank, or a working default).
+ * Only vars that need a generated secret or a corrected local-dev value show
+ * up below.
+ *
+ * `targets` lists every `.env.local` file that must receive this key. When an
+ * entry has more than one target, the *same* generated value is written to
+ * each of them — that is what makes it "shared" rather than "this key exists
+ * in more than one file with independent values" (BETTER_AUTH_SECRET is the
+ * latter: root and apps/admin each get their own entry, each scoped to one
+ * target, so they resolve to different secrets).
+ *
+ * Keeping this file in sync with `packages/env/src/fragments.ts` and the two
+ * `.env.example` files is enforced by
+ * tests/architecture/create-ragen-app-manifest-is-current.test.ts.
+ */
+export type EnvTarget = 'root' | 'admin';
+export interface GenerateSecretEntry {
+    key: string;
+    strategy: 'generate-secret';
+    targets: EnvTarget[];
+}
+export interface LocalDefaultEntry {
+    key: string;
+    strategy: 'local-default';
+    targets: EnvTarget[];
+    value: string;
+}
+export type ManifestEntry = GenerateSecretEntry | LocalDefaultEntry;
+export declare const MANIFEST: ManifestEntry[];
+export declare function entriesForTarget(target: EnvTarget): ManifestEntry[];
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzC,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,aAAa,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAEpE,eAAO,MAAM,QAAQ,EAAE,aAAa,EAmDnC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,EAAE,CAEnE"}

package/dist/manifest.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * What create-ragen-app changes in the two `.env.example` templates it ships
+ * as `.env.local` (root and apps/admin) to turn a fresh clone into a working
+ * local install, without asking a question for every variable.
+ *
+ * This is deliberately an *overrides* list, not a full inventory of every env
+ * var: anything not listed here is left exactly as the cloned repo's own
+ * `.env.example` already has it (a comment, a blank, or a working default).
+ * Only vars that need a generated secret or a corrected local-dev value show
+ * up below.
+ *
+ * `targets` lists every `.env.local` file that must receive this key. When an
+ * entry has more than one target, the *same* generated value is written to
+ * each of them — that is what makes it "shared" rather than "this key exists
+ * in more than one file with independent values" (BETTER_AUTH_SECRET is the
+ * latter: root and apps/admin each get their own entry, each scoped to one
+ * target, so they resolve to different secrets).
+ *
+ * Keeping this file in sync with `packages/env/src/fragments.ts` and the two
+ * `.env.example` files is enforced by
+ * tests/architecture/create-ragen-app-manifest-is-current.test.ts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MANIFEST = void 0;
+exports.entriesForTarget = entriesForTarget;
+exports.MANIFEST = [
+    // --- Generated secrets, independent per target ---
+    { key: 'SECRET_KEY', strategy: 'generate-secret', targets: ['root'] },
+    { key: 'BETTER_AUTH_SECRET', strategy: 'generate-secret', targets: ['root'] },
+    {
+        key: 'PUBLIC_LINK_TOKEN_SECRET',
+        strategy: 'generate-secret',
+        targets: ['root'],
+    },
+    {
+        key: 'SESSION_AUTH_SECRET',
+        strategy: 'generate-secret',
+        targets: ['root'],
+    },
+    {
+        // Replaces the "worker-secret-key" placeholder that ships in
+        // .env.example — apps/worker reads the same var from the root env via
+        // scripts/load-root-env.mjs, so one value here is enough.
+        key: 'WORKER_SECRET_KEY',
+        strategy: 'generate-secret',
+        targets: ['root'],
+    },
+    {
+        key: 'BETTER_AUTH_SECRET',
+        strategy: 'generate-secret',
+        targets: ['admin'],
+    },
+    // --- Generated secrets, shared value across targets ---
+    {
+        // Read by apps/web, apps/api and apps/admin (apps/api gap-fills from the
+        // root .env.local when it has none of its own, per
+        // scripts/load-root-env.mjs, so it never needs a third copy of this
+        // value). apps/admin keeps a fully separate env file, so it needs its own
+        // copy of the same value.
+        key: 'INTERNAL_API_SECRET',
+        strategy: 'generate-secret',
+        targets: ['root', 'admin'],
+    },
+    // --- Local-dev defaults that correct a stale example value ---
+    {
+        // docker-compose.yml maps Postgres to host port 55432, not the 5432 that
+        // both .env.example files show — a native/other Postgres on 5432 would
+        // otherwise silently answer instead of the container. See
+        // docs/lessons.md.
+        key: 'DATABASE_URL',
+        strategy: 'local-default',
+        targets: ['root', 'admin'],
+        value: 'postgresql://postgres:pass123@localhost:55432/ragen',
+    },
+];
+function entriesForTarget(target) {
+    return exports.MANIFEST.filter((entry) => entry.targets.includes(target));
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAwEH,4CAEC;AAvDY,QAAA,QAAQ,GAAoB;IACvC,oDAAoD;IACpD,EAAE,GAAG,EAAE,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE;IACrE,EAAE,GAAG,EAAE,oBAAoB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE;IAC7E;QACE,GAAG,EAAE,0BAA0B;QAC/B,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,CAAC,MAAM,CAAC;KAClB;IACD;QACE,GAAG,EAAE,qBAAqB;QAC1B,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,CAAC,MAAM,CAAC;KAClB;IACD;QACE,6DAA6D;QAC7D,sEAAsE;QACtE,0DAA0D;QAC1D,GAAG,EAAE,mBAAmB;QACxB,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,CAAC,MAAM,CAAC;KAClB;IACD;QACE,GAAG,EAAE,oBAAoB;QACzB,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,CAAC,OAAO,CAAC;KACnB;IAED,yDAAyD;IACzD;QACE,yEAAyE;QACzE,mDAAmD;QACnD,oEAAoE;QACpE,0EAA0E;QAC1E,0BAA0B;QAC1B,GAAG,EAAE,qBAAqB;QAC1B,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;KAC3B;IAED,gEAAgE;IAChE;QACE,yEAAyE;QACzE,uEAAuE;QACvE,0DAA0D;QAC1D,mBAAmB;QACnB,GAAG,EAAE,cAAc;QACnB,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;QAC1B,KAAK,EAAE,qDAAqD;KAC7D;CACF,CAAC;AAEF,SAAgB,gBAAgB,CAAC,MAAiB;IAChD,OAAO,gBAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/secrets.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Matches every "Generate with: node -e ... randomBytes(32)" instruction
+ * scattered across .env.example — one helper instead of five copy-pasted
+ * one-liners.
+ */
+export declare function generateSecret(): string;
+//# sourceMappingURL=secrets.d.ts.map

package/dist/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/secrets.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSecret = generateSecret;
+const node_crypto_1 = require("node:crypto");
+/**
+ * Matches every "Generate with: node -e ... randomBytes(32)" instruction
+ * scattered across .env.example — one helper instead of five copy-pasted
+ * one-liners.
+ */
+function generateSecret() {
+    return (0, node_crypto_1.randomBytes)(32).toString('hex');
+}
+//# sourceMappingURL=secrets.js.map

package/dist/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":";;AAOA,wCAEC;AATD,6CAA0C;AAE1C;;;;GAIG;AACH,SAAgB,cAAc;IAC5B,OAAO,IAAA,yBAAW,EAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC"}

package/dist/tasks.d.ts

@@ -0,0 +1,27 @@
+export interface RunOptions {
+    cwd: string;
+    /**
+     * Extra env vars for the child process — needed for `generate:types` and
+     * `migrate deploy`, which read `DATABASE_URL` from `process.env` directly
+     * (see prisma.config.ts) and do not load `.env.local` themselves the way
+     * `npm run db:seed` does (`tsx --env-file=.env.local`). execa merges this
+     * with the parent's own `process.env` automatically.
+     */
+    env?: NodeJS.ProcessEnv;
+}
+export interface MigrateOptions {
+    retries?: number;
+    retryDelayMs?: number;
+}
+export declare function isDockerAvailable(): Promise<boolean>;
+export declare function startDockerServices({ cwd }: RunOptions): Promise<void>;
+export declare function installDependencies({ cwd }: RunOptions): Promise<void>;
+export declare function generatePrismaClient({ cwd, env, }: RunOptions): Promise<void>;
+export declare function seedDatabase({ cwd, env }: RunOptions): Promise<void>;
+/**
+ * Postgres needs a moment to accept connections right after
+ * `docker compose up -d`, so a first `migrate deploy` failing is expected —
+ * retry with a short backoff instead of surfacing that as a hard error.
+ */
+export declare function migrateDatabase({ cwd, env }: RunOptions, { retries, retryDelayMs }?: MigrateOptions): Promise<void>;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../src/tasks.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAU1D;AAED,wBAAsB,mBAAmB,CAAC,EAAE,GAAG,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5E;AAED,wBAAsB,mBAAmB,CAAC,EAAE,GAAG,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5E;AAED,wBAAsB,oBAAoB,CAAC,EACzC,GAAG,EACH,GAAG,GACJ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5B;AAED,wBAAsB,YAAY,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1E;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,UAAU,EACxB,EAAE,OAAW,EAAE,YAAmB,EAAE,GAAE,cAAmB,GACxD,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/tasks.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDockerAvailable = isDockerAvailable;
+exports.startDockerServices = startDockerServices;
+exports.installDependencies = installDependencies;
+exports.generatePrismaClient = generatePrismaClient;
+exports.seedDatabase = seedDatabase;
+exports.migrateDatabase = migrateDatabase;
+const execa_1 = require("execa");
+async function isDockerAvailable() {
+    try {
+        // A stuck `docker info` (e.g. Docker Desktop still starting up) would
+        // otherwise block forever instead of falling through to the "Docker not
+        // available" path.
+        await (0, execa_1.execa)('docker', ['info'], { timeout: 10_000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function startDockerServices({ cwd }) {
+    await (0, execa_1.execa)('docker', ['compose', 'up', '-d'], { cwd, stdio: 'inherit' });
+}
+async function installDependencies({ cwd }) {
+    await (0, execa_1.execa)('npm', ['install'], { cwd, stdio: 'inherit' });
+}
+async function generatePrismaClient({ cwd, env, }) {
+    await (0, execa_1.execa)('npm', ['run', 'generate:types'], { cwd, env, stdio: 'inherit' });
+}
+async function seedDatabase({ cwd, env }) {
+    await (0, execa_1.execa)('npm', ['run', 'db:seed'], { cwd, env, stdio: 'inherit' });
+}
+/**
+ * Postgres needs a moment to accept connections right after
+ * `docker compose up -d`, so a first `migrate deploy` failing is expected —
+ * retry with a short backoff instead of surfacing that as a hard error.
+ */
+async function migrateDatabase({ cwd, env }, { retries = 5, retryDelayMs = 3000 } = {}) {
+    let lastError;
+    for (let attempt = 1; attempt <= retries; attempt += 1) {
+        try {
+            await (0, execa_1.execa)('npx', ['prisma', 'migrate', 'deploy'], {
+                cwd,
+                env,
+                stdio: 'inherit',
+            });
+            return;
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt < retries) {
+                await delay(retryDelayMs);
+            }
+        }
+    }
+    throw new Error(`prisma migrate deploy failed after ${retries} attempts — is Postgres reachable? ${String(lastError)}`);
+}
+function delay(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+//# sourceMappingURL=tasks.js.map

package/dist/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../src/tasks.ts"],"names":[],"mappings":";;AAmBA,8CAUC;AAED,kDAEC;AAED,kDAEC;AAED,oDAKC;AAED,oCAEC;AAOD,0CAyBC;AAhFD,iCAA8B;AAmBvB,KAAK,UAAU,iBAAiB;IACrC,IAAI,CAAC;QACH,sEAAsE;QACtE,wEAAwE;QACxE,mBAAmB;QACnB,MAAM,IAAA,aAAK,EAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,mBAAmB,CAAC,EAAE,GAAG,EAAc;IAC3D,MAAM,IAAA,aAAK,EAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AAC5E,CAAC;AAEM,KAAK,UAAU,mBAAmB,CAAC,EAAE,GAAG,EAAc;IAC3D,MAAM,IAAA,aAAK,EAAC,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AAC7D,CAAC;AAEM,KAAK,UAAU,oBAAoB,CAAC,EACzC,GAAG,EACH,GAAG,GACQ;IACX,MAAM,IAAA,aAAK,EAAC,KAAK,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AAChF,CAAC;AAEM,KAAK,UAAU,YAAY,CAAC,EAAE,GAAG,EAAE,GAAG,EAAc;IACzD,MAAM,IAAA,aAAK,EAAC,KAAK,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AACzE,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,eAAe,CACnC,EAAE,GAAG,EAAE,GAAG,EAAc,EACxB,EAAE,OAAO,GAAG,CAAC,EAAE,YAAY,GAAG,IAAI,KAAqB,EAAE;IAEzD,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,IAAA,aAAK,EAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE;gBAClD,GAAG;gBACH,GAAG;gBACH,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAClB,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;gBACtB,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,sCAAsC,OAAO,sCAAsC,MAAM,CAAC,SAAS,CAAC,EAAE,CACvG,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "create-ragen-app",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Scaffold a self-hosted Ragen AI installation with one command",
+  "license": "Apache-2.0",
+  "bin": {
+    "create-ragen-app": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/webamigos/RagenAI.git",
+    "directory": "packages/create-ragen-app"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "prepare": "npm run build",
+    "lint": "eslint",
+    "typecheck": "tsc --noEmit --incremental --tsBuildInfoFile ./typecheck.tsbuildinfo"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.9.1",
+    "dotenv": "^17.4.2",
+    "execa": "^9.5.2",
+    "giget": "^1.2.3"
+  },
+  "devDependencies": {
+    "@ragenai/eslint-config": "*",
+    "@types/node": "^22.0.0",
+    "eslint": "^9.39.5",
+    "typescript": "~5.7.0"
+  },
+  "engines": {
+    "node": ">=24"
+  }
+}