alepha 0.14.1 → 0.14.3

package/dist/cli/index.js

@@ -1,20 +1,20 @@
 import { createRequire } from "node:module";
-import { join } from "node:path";
-import { $atom, $env, $hook, $inject, $module, $use, Alepha, AlephaError, OPTIONS, t } from "alepha";
+import { $atom, $hook, $inject, $module, $use, Alepha, AlephaError, OPTIONS, t } from "alepha";
 import { FileSystemProvider } from "alepha/file";
-import { $command, CliProvider, EnvUtils } from "alepha/command";
-import { $logger } from "alepha/logger";
-import { exec, spawn } from "node:child_process";
 import { access, mkdir, readFile, readdir, unlink, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { $command, CliProvider, EnvUtils } from "alepha/command";
+import { $logger, ConsoleColorProvider } from "alepha/logger";
 import { boot, buildClient, buildServer, copyAssets, generateCloudflare, generateDocker, generateSitemap, generateVercel, prerenderPages } from "alepha/vite";
-import { tsImport } from "tsx/esm/api";
+import { exec, spawn } from "node:child_process";
 import { readFileSync } from "node:fs";
 import { promisify } from "node:util";
+import { ServerSwaggerProvider } from "alepha/server/swagger";
 import * as os from "node:os";
 
 //#region ../../src/cli/assets/appRouterTs.ts
 const appRouterTs = () => `
-import { $page } from "@alepha/react";
+import { $page } from "@alepha/react/router";
 
 export class AppRouter {
   home = $page({
@@ -174,6 +174,7 @@ var AlephaCliUtils = class {
 	log = $logger();
 	fs = $inject(FileSystemProvider);
 	envUtils = $inject(EnvUtils);
+	alepha = $inject(Alepha);
 	/**
 	* Execute a command using npx with inherited stdio.
 	*
@@ -235,6 +236,34 @@ var AlephaCliUtils = class {
 		this.log.debug(`Config file written: ${path}`);
 		return path;
 	}
+	async removeFiles(root, files) {
+		await Promise.all(files.map((file) => this.fs.rm(join(root, file), {
+			force: true,
+			recursive: true
+		})));
+	}
+	async removeYarn(root) {
+		await this.removeFiles(root, [
+			".yarn",
+			".yarnrc.yml",
+			".yarn"
+		]);
+	}
+	async removePnpm(root) {
+		await this.removeFiles(root, ["pnpm-lock.yaml", "pnpm-workspace.yaml"]);
+	}
+	async removeNpm(root) {
+		await this.removeFiles(root, ["package-lock.json"]);
+	}
+	async removeBun(root) {
+		await this.removeFiles(root, ["bun.lockb"]);
+	}
+	async removeAllPmFilesExcept(root, except) {
+		if (except !== "yarn") await this.removeYarn(root);
+		if (except !== "pnpm") await this.removePnpm(root);
+		if (except !== "npm") await this.removeNpm(root);
+		if (except !== "bun") await this.removeBun(root);
+	}
 	/**
 	* Ensure Yarn is configured in the project directory.
 	*
@@ -244,26 +273,16 @@ var AlephaCliUtils = class {
 	*/
 	async ensureYarn(root) {
 		await this.ensureFileExists(root, ".yarnrc.yml", "nodeLinker: node-modules", false);
-		await this.fs.rm(join(root, "package-lock.json"), { force: true });
-		await this.fs.rm(join(root, "pnpm-lock.yaml"), { force: true });
+		await this.removeAllPmFilesExcept(root, "yarn");
+	}
+	async ensureBun(root) {
+		await this.removeAllPmFilesExcept(root, "bun");
 	}
 	async ensurePnpm(root) {
-		await this.fs.rm(join(root, "package-lock.json"), { force: true });
-		await this.fs.rm(join(root, "yarn.lock"), { force: true });
-		await this.fs.rm(join(root, ".yarn"), {
-			force: true,
-			recursive: true
-		});
-		await this.fs.rm(join(root, ".yarnrc.yml"), { force: true });
+		await this.removeAllPmFilesExcept(root, "pnpm");
 	}
 	async ensureNpm(root) {
-		await this.fs.rm(join(root, "pnpm-lock.yaml"), { force: true });
-		await this.fs.rm(join(root, "yarn.lock"), { force: true });
-		await this.fs.rm(join(root, ".yarn"), {
-			force: true,
-			recursive: true
-		});
-		await this.fs.rm(join(root, ".yarnrc.yml"), { force: true });
+		await this.removeAllPmFilesExcept(root, "npm");
 	}
 	/**
 	* Generate package.json content with Alepha dependencies.
@@ -418,7 +437,8 @@ var AlephaCliUtils = class {
 	async loadAlephaFromServerEntryFile(rootDir, explicitEntry) {
 		process.env.ALEPHA_CLI_IMPORT = "true";
 		const entry = await boot.getServerEntry(rootDir, explicitEntry);
-		const mod = await tsImport(entry, { parentURL: import.meta.url });
+		delete global.__alepha;
+		const mod = await import(entry);
 		this.log.debug(`Load entry: ${entry}`);
 		if (mod.default instanceof Alepha) return {
 			alepha: mod.default,
@@ -470,6 +490,7 @@ ${models.map((it) => `export const ${it} = models["${it}"];`).join("\n")}
 		if (flags?.pnpm) return "pnpm";
 		if (flags?.npm) return "npm";
 		if (flags?.bun) return "bun";
+		if (this.alepha.isBun()) return "bun";
 		if (await this.checkFileExists(root, "yarn.lock", true)) return "yarn";
 		if (await this.checkFileExists(root, "pnpm-lock.yaml", true)) return "pnpm";
 		return "npm";
@@ -554,6 +575,23 @@ ${models.map((it) => `export const ${it} = models["${it}"];`).join("\n")}
 	async hasExpo(root) {
 		return this.hasDependency(root, "expo");
 	}
+	async getInstallCommand(root, packageName, dev = true) {
+		const pm = await this.getPackageManager(root);
+		let cmd;
+		switch (pm) {
+			case "yarn":
+				cmd = `yarn add ${dev ? "-D" : ""} ${packageName}`;
+				break;
+			case "pnpm":
+				cmd = `pnpm add ${dev ? "-D" : ""} ${packageName}`;
+				break;
+			case "bun":
+				cmd = `bun add ${dev ? "-d" : ""} ${packageName}`;
+				break;
+			default: cmd = `npm install ${dev ? "--save-dev" : ""} ${packageName}`;
+		}
+		return cmd.replace(/\s+/g, " ").trim();
+	}
 	/**
 	* Install a dependency if it's missing from the project.
 	*
@@ -566,18 +604,7 @@ ${models.map((it) => `export const ${it} = models["${it}"];`).join("\n")}
 			this.log.debug(`Dependency '${packageName}' is already installed`);
 			return;
 		}
-		const pm = await this.getPackageManager(root);
-		let cmd;
-		switch (pm) {
-			case "yarn":
-				cmd = `yarn add ${dev ? "-D" : ""} ${packageName}`;
-				break;
-			case "pnpm":
-				cmd = `pnpm add ${dev ? "-D" : ""} ${packageName}`;
-				break;
-			default: cmd = `npm install ${dev ? "--save-dev" : ""} ${packageName}`;
-		}
-		cmd = cmd.replace(/\s+/g, " ").trim();
+		const cmd = await this.getInstallCommand(root, packageName, dev);
 		if (options.run) await options.run(cmd, { alias: `installing ${packageName}` });
 		else {
 			this.log.debug(`Installing ${packageName}`);
@@ -587,337 +614,415 @@ ${models.map((it) => `export const ${it} = models["${it}"];`).join("\n")}
 };
 
 //#endregion
-//#region ../../src/cli/commands/BiomeCommands.ts
-var BiomeCommands = class {
+//#region ../../src/cli/commands/build.ts
+var BuildCommand = class {
 	log = $logger();
 	utils = $inject(AlephaCliUtils);
-	format = $command({
-		name: "format",
-		description: "Format the codebase using Biome",
-		handler: async ({ root }) => {
-			await this.utils.ensureConfig(root, { biomeJson: true });
-			await this.utils.ensureDependency(root, "@biomejs/biome");
-			await this.utils.exec(`biome format --fix`);
+	build = $command({
+		name: "build",
+		description: "Build the project for production",
+		args: t.optional(t.text({
+			title: "path",
+			description: "Filepath to build"
+		})),
+		flags: t.object({
+			stats: t.optional(t.boolean({ description: "Generate build stats report" })),
+			vercel: t.optional(t.boolean({ description: "Generate Vercel deployment configuration" })),
+			cloudflare: t.optional(t.boolean({ description: "Generate Cloudflare Workers configuration" })),
+			docker: t.optional(t.boolean({ description: "Generate Docker configuration" })),
+			sitemap: t.optional(t.text({ description: "Generate sitemap.xml with base URL" }))
+		}),
+		handler: async ({ flags, args, run, root }) => {
+			process.env.ALEPHA_BUILD_MODE = "cli";
+			process.env.NODE_ENV = "production";
+			if (await this.utils.hasExpo(root)) return;
+			await this.utils.ensureConfig(root, {
+				viteConfigTs: true,
+				tsconfigJson: true
+			});
+			const entry = await boot.getServerEntry(root, args);
+			this.log.trace("Entry file found", { entry });
+			const distDir = "dist";
+			const clientDir = "public";
+			await this.utils.ensureDependency(root, "vite", { run });
+			await run.rm("dist", { alias: "clean dist" });
+			const viteAlephaBuildOptions = (await createRequire(import.meta.url)("vite").resolveConfig({}, "build", "production")).plugins.find((it) => it.name === "alepha:build")?.[OPTIONS] || {};
+			await this.utils.loadEnv(root, [".env", ".env.production"]);
+			const stats = flags.stats ?? viteAlephaBuildOptions.stats ?? false;
+			const hasServer = viteAlephaBuildOptions.serverEntry !== false;
+			let hasClient = false;
+			try {
+				await access(join(root, "index.html"));
+				hasClient = true;
+			} catch {}
+			const clientOptions = typeof viteAlephaBuildOptions.client === "object" ? viteAlephaBuildOptions.client : {};
+			if (hasClient) await run({
+				name: "vite build client",
+				handler: () => buildClient({
+					silent: true,
+					dist: `${distDir}/${clientDir}`,
+					stats,
+					precompress: clientOptions.precompress
+				})
+			});
+			await run({
+				name: "vite build server",
+				handler: async () => {
+					let clientBuilt = false;
+					try {
+						await readFile(`${distDir}/${clientDir}/index.html`, "utf-8");
+						clientBuilt = true;
+					} catch {}
+					await buildServer({
+						silent: true,
+						entry,
+						distDir,
+						clientDir: clientBuilt ? clientDir : void 0,
+						stats
+					});
+					if (clientBuilt && hasServer) await unlink(`${distDir}/${clientDir}/index.html`);
+				}
+			});
+			await copyAssets({
+				root,
+				entry: `${distDir}/index.js`,
+				distDir,
+				run
+			});
+			if (hasClient) {
+				const sitemapBaseUrl = flags.sitemap ?? clientOptions.sitemap?.hostname;
+				if (sitemapBaseUrl) await run({
+					name: "add sitemap",
+					handler: async () => {
+						await writeFile(`${distDir}/${clientDir}/sitemap.xml`, await generateSitemap({
+							entry: `${distDir}/index.js`,
+							baseUrl: sitemapBaseUrl
+						}));
+					}
+				});
+				if (clientOptions.prerender) await run({
+					name: "pre-render pages",
+					handler: async () => {
+						await prerenderPages({
+							dist: `${distDir}/${clientDir}`,
+							entry: `${distDir}/index.js`,
+							compress: clientOptions.precompress
+						});
+					}
+				});
+			}
+			if (flags.vercel || viteAlephaBuildOptions.vercel) {
+				const config = typeof viteAlephaBuildOptions.vercel === "object" ? viteAlephaBuildOptions.vercel : {};
+				await run({
+					name: "add Vercel config",
+					handler: () => generateVercel({
+						distDir,
+						clientDir,
+						config
+					})
+				});
+			}
+			if (flags.cloudflare || viteAlephaBuildOptions.cloudflare) {
+				const config = typeof viteAlephaBuildOptions.cloudflare === "boolean" ? {} : viteAlephaBuildOptions.cloudflare;
+				await run({
+					name: "add Cloudflare config",
+					handler: () => generateCloudflare({
+						distDir,
+						config
+					})
+				});
+			}
+			if (flags.docker || viteAlephaBuildOptions.docker) {
+				const dockerConfig = typeof viteAlephaBuildOptions.docker === "object" ? viteAlephaBuildOptions.docker : {};
+				await run({
+					name: "add Docker config",
+					handler: () => generateDocker({
+						distDir,
+						...dockerConfig
+					})
+				});
+			}
 		}
 	});
-	lint = $command({
-		name: "lint",
-		description: "Run linter across the codebase using Biome",
-		handler: async ({ root }) => {
-			await this.utils.ensureConfig(root, { biomeJson: true });
-			await this.utils.ensureDependency(root, "@biomejs/biome");
-			await this.utils.exec(`biome check --formatter-enabled=false --fix`);
+};
+
+//#endregion
+//#region ../../src/cli/commands/clean.ts
+var CleanCommand = class {
+	/**
+	* Clean the project, removing the "dist" directory
+	*/
+	clean = $command({
+		name: "clean",
+		description: "Clean the project",
+		handler: async ({ run }) => {
+			await run.rm("./dist");
 		}
 	});
 };
 
 //#endregion
-//#region ../../src/cli/atoms/changelogOptions.ts
-/**
-* Default scopes to ignore in changelog generation.
-* Commits with these scopes won't appear in release notes.
-*/
-const DEFAULT_IGNORE = [
-	"project",
-	"release",
-	"starter",
-	"example",
-	"chore",
-	"ci",
-	"build",
-	"test",
-	"style"
-];
-/**
-* Changelog configuration atom.
-*
-* Configure in `alepha.config.ts`:
-* ```ts
-* import { changelogOptions } from "alepha/cli";
-*
-* alepha.set(changelogOptions, {
-*   ignore: ["project", "release", "chore", "docs"],
-* });
-* ```
-*/
-const changelogOptions = $atom({
-	name: "alepha.changelog",
-	schema: t.object({ ignore: t.optional(t.array(t.string())) }),
-	default: { ignore: DEFAULT_IGNORE }
+//#region ../../src/cli/commands/db.ts
+const drizzleCommandFlags = t.object({
+	provider: t.optional(t.text({ description: "Database provider name to target (e.g., 'postgres', 'sqlite')" })),
+	mode: t.optional(t.text({ description: "Environment variable file(s) to load (e.g., 'production' to load .env.production) https://vite.dev/guide/env-and-mode" }))
 });
-
-//#endregion
-//#region ../../src/cli/services/GitMessageParser.ts
-/**
-* Service for parsing git commit messages into structured format.
-*
-* Only parses **conventional commits with a scope**:
-* - `feat(scope): description` → feature
-* - `fix(scope): description` → bug fix
-* - `feat(scope)!: description` → breaking change
-*
-* Commits without scope are ignored, allowing developers to commit
-* work-in-progress changes without polluting release notes:
-* - `cli: work in progress` → ignored (no type)
-* - `fix: quick patch` → ignored (no scope)
-* - `feat(cli): add command` → included
-*/
-var GitMessageParser = class {
+var DbCommand = class {
 	log = $logger();
+	utils = $inject(AlephaCliUtils);
 	/**
-	* Parse a git commit line into a structured Commit object.
-	*
-	* **Format:** `type(scope): description` or `type(scope)!: description`
-	*
-	* **Supported types:** feat, fix, docs, refactor, perf, revert
-	*
-	* **Breaking changes:** Use `!` before `:` (e.g., `feat(api)!: remove endpoint`)
-	*
-	* @returns Commit object or null if not matching/ignored
+	* Check if database migrations are up to date.
 	*/
-	parseCommit(line, config) {
-		const match = line.match(/^([a-f0-9]+)\s+(.+)$/);
-		if (!match) return null;
-		const [, hash, message] = match;
-		const ignore = config.ignore ?? DEFAULT_IGNORE;
-		const conventionalMatch = message.match(/^(feat|fix|docs|refactor|perf|revert)\(([^)]+)\)(!)?:\s*(.+)$/i);
-		if (!conventionalMatch) return null;
-		const [, type, scope, breakingMark, description] = conventionalMatch;
-		const baseScope = scope.split("/")[0];
-		if (ignore.includes(baseScope) || ignore.includes(scope)) return null;
-		const breaking = breakingMark === "!" || description.toLowerCase().includes("breaking");
-		return {
-			hash: hash.substring(0, 8),
-			type: type.toLowerCase(),
-			scope,
-			description: description.trim(),
-			breaking
-		};
-	}
-};
-
-//#endregion
-//#region ../../src/cli/commands/ChangelogCommands.ts
-const execAsync = promisify(exec);
-/**
-* Git provider for executing git commands.
-* Can be substituted in tests with a mock implementation.
-*/
-var GitProvider = class {
-	async exec(cmd, cwd) {
-		const { stdout } = await execAsync(`git ${cmd}`, { cwd });
-		return stdout;
-	}
-};
-/**
-* Changelog command for generating release notes from git commits.
-*
-* Usage:
-* - `alepha changelog` - Show unreleased changes since latest tag to HEAD
-* - `alepha changelog --from=1.0.0` - Show changes from version to HEAD
-* - `alepha changelog --from=1.0.0 --to=1.1.0` - Show changes between two refs
-* - `alepha changelog | tee -a CHANGELOG.md` - Append to file
-*/
-var ChangelogCommands = class {
-	log = $logger();
-	git = $inject(GitProvider);
-	parser = $inject(GitMessageParser);
-	config = $use(changelogOptions);
-	/**
-	* Format a single commit line.
-	* Example: `- **cli**: add new command (\`abc1234\`)`
-	*/
-	formatCommit(commit) {
-		return `- **${commit.scope}**: ${commit.description} (\`${commit.hash}\`)`;
-	}
-	/**
-	* Format the changelog entry with sections.
-	*/
-	formatEntry(entry) {
-		const sections = [];
-		if (entry.breaking.length > 0) {
-			sections.push("### Breaking Changes\n");
-			for (const commit of entry.breaking) sections.push(this.formatCommit(commit));
-			sections.push("");
-		}
-		if (entry.features.length > 0) {
-			sections.push("### Features\n");
-			for (const commit of entry.features) sections.push(this.formatCommit(commit));
-			sections.push("");
-		}
-		if (entry.fixes.length > 0) {
-			sections.push("### Bug Fixes\n");
-			for (const commit of entry.fixes) sections.push(this.formatCommit(commit));
-			sections.push("");
+	check = $command({
+		name: "check-migrations",
+		description: "Check if database migration files are up to date",
+		args: t.optional(t.text({
+			title: "path",
+			description: "Path to the Alepha server entry file"
+		})),
+		flags: drizzleCommandFlags,
+		handler: async ({ args, root }) => {
+			const rootDir = root;
+			this.log.debug(`Using project root: ${rootDir}`);
+			const { alepha } = await this.utils.loadAlephaFromServerEntryFile(rootDir, args);
+			const repositoryProvider = alepha.inject("RepositoryProvider");
+			const drizzleKitProvider = alepha.inject("DrizzleKitProvider");
+			const accepted = /* @__PURE__ */ new Set([]);
+			for (const primitive of repositoryProvider.getRepositories()) {
+				const provider = primitive.provider;
+				const providerName = provider.name;
+				if (accepted.has(providerName)) continue;
+				accepted.add(providerName);
+				const migrationDir = join(rootDir, "migrations", providerName);
+				const journalFile = await readFile(`${migrationDir}/meta/_journal.json`, "utf-8").catch(() => null);
+				if (!journalFile) {
+					this.log.info("No migration journal found.");
+					return;
+				}
+				const journal = JSON.parse(journalFile);
+				const lastMigration = journal.entries[journal.entries.length - 1];
+				const lastSnapshot = JSON.parse(await readFile(`${migrationDir}/meta/${String(lastMigration.idx).padStart(4, "0")}_snapshot.json`, "utf-8"));
+				const models = drizzleKitProvider.getModels(provider);
+				const kit = drizzleKitProvider.importDrizzleKit();
+				const now = kit.generateDrizzleJson(models, lastSnapshot.id);
+				const migrationStatements = await new Promise((resolve) => {
+					(async () => {
+						const timer = setTimeout(() => {
+							resolve([{ message: "Migration generation timed out." }]);
+						}, 5e3);
+						const statements = await kit.generateMigration(lastSnapshot, now);
+						clearTimeout(timer);
+						resolve(statements);
+					})();
+				});
+				if (migrationStatements.length === 0) {
+					this.log.info("No changes detected.");
+					return;
+				}
+				this.log.info("");
+				this.log.info("Detected migration statements:");
+				this.log.info("");
+				for (const stmt of migrationStatements) this.log.info(stmt);
+				this.log.info("");
+				this.log.info(`At least ${migrationStatements.length} change(s) detected.`);
+				this.log.info("Please, run 'alepha db:generate' to update the migration files.");
+				this.log.info("");
+				throw new AlephaError("Database migrations are not up to date.");
+			}
 		}
-		return sections.join("\n");
-	}
+	});
 	/**
-	* Parse git log output into a changelog entry.
+	* Generate database migration files
 	*/
-	parseCommits(commitsOutput) {
-		const entry = {
-			features: [],
-			fixes: [],
-			breaking: []
-		};
-		for (const line of commitsOutput.trim().split("\n")) {
-			if (!line.trim()) continue;
-			const commit = this.parser.parseCommit(line, this.config);
-			if (!commit) {
-				this.log.trace("Skipping commit", { line });
-				continue;
-			}
-			this.log.trace("Parsed commit", { commit });
-			if (commit.breaking) entry.breaking.push(commit);
-			if (commit.type === "feat") entry.features.push(commit);
-			else if (commit.type === "fix") entry.fixes.push(commit);
+	generate = $command({
+		name: "generate",
+		description: "Generate migration files based on current database schema",
+		summary: false,
+		args: t.optional(t.text({
+			title: "path",
+			description: "Path to the Alepha server entry file"
+		})),
+		flags: t.extend(drizzleCommandFlags, { custom: t.optional(t.text({ description: "Custom migration name for drizzle-kit generate --custom" })) }),
+		handler: async ({ args, flags, root }) => {
+			const commandFlags = flags.custom ? `--custom=${flags.custom}` : void 0;
+			await this.runDrizzleKitCommand({
+				root,
+				args,
+				command: "generate",
+				commandFlags,
+				provider: flags.provider,
+				env: flags.mode,
+				logMessage: (providerName, dialect) => `Generate '${providerName}' migrations (${dialect}) ...`
+			});
 		}
-		return entry;
-	}
+	});
 	/**
-	* Check if entry has any public commits.
+	* Push database schema changes directly to the database
 	*/
-	hasChanges(entry) {
-		return entry.features.length > 0 || entry.fixes.length > 0 || entry.breaking.length > 0;
-	}
+	push = $command({
+		name: "push",
+		description: "Push database schema changes directly to the database",
+		summary: false,
+		args: t.optional(t.text({
+			title: "path",
+			description: "Path to the Alepha server entry file"
+		})),
+		flags: drizzleCommandFlags,
+		handler: async ({ root, args, flags }) => {
+			await this.runDrizzleKitCommand({
+				root,
+				args,
+				command: "push",
+				provider: flags.provider,
+				env: flags.mode,
+				logMessage: (providerName, dialect) => `Push '${providerName}' schema (${dialect}) ...`
+			});
+		}
+	});
 	/**
-	* Get the latest version tag.
+	* Apply pending database migrations
 	*/
-	async getLatestTag(git) {
-		return (await git("tag --sort=-version:refname")).trim().split("\n").filter((tag) => tag.match(/^\d+\.\d+\.\d+$/))[0] || null;
-	}
-	changelog = $command({
-		name: "changelog",
-		description: "Generate changelog from conventional commits (outputs to stdout)",
-		flags: t.object({
-			from: t.optional(t.string({
-				aliases: ["f"],
-				description: "Starting ref (default: latest tag)"
-			})),
-			to: t.optional(t.string({
-				aliases: ["t"],
-				description: "Ending ref (default: HEAD)"
-			}))
-		}),
-		handler: async ({ flags, root }) => {
-			const git = (cmd) => this.git.exec(cmd, root);
-			let fromRef;
-			if (flags.from) {
-				fromRef = flags.from;
-				this.log.debug("Using specified from ref", { from: fromRef });
-			} else {
-				const latestTag = await this.getLatestTag(git);
-				if (!latestTag) {
-					process.stdout.write("No version tags found in repository\n");
-					return;
-				}
-				fromRef = latestTag;
-				this.log.debug("Using latest tag", { from: fromRef });
-			}
-			const toRef = flags.to || "HEAD";
-			this.log.debug("Using to ref", { to: toRef });
-			const commitsOutput = await git(`log ${fromRef}..${toRef} --oneline`);
-			if (!commitsOutput.trim()) {
-				process.stdout.write(`No changes in range ${fromRef}..${toRef}\n`);
-				return;
-			}
-			const entry = this.parseCommits(commitsOutput);
-			if (!this.hasChanges(entry)) {
-				process.stdout.write(`No public changes in range ${fromRef}..${toRef}\n`);
-				return;
-			}
-			process.stdout.write(this.formatEntry(entry));
+	migrate = $command({
+		name: "migrate",
+		description: "Apply pending database migrations",
+		summary: false,
+		args: t.optional(t.text({
+			title: "path",
+			description: "Path to the Alepha server entry file"
+		})),
+		flags: drizzleCommandFlags,
+		handler: async ({ root, args, flags }) => {
+			await this.runDrizzleKitCommand({
+				root,
+				args,
+				command: "migrate",
+				provider: flags.provider,
+				env: flags.mode,
+				logMessage: (providerName, dialect) => `Migrate '${providerName}' database (${dialect}) ...`
+			});
 		}
 	});
-};
-
-//#endregion
-//#region ../../src/cli/commands/CoreCommands.ts
-var CoreCommands = class {
-	log = $logger();
-	cli = $inject(CliProvider);
-	utils = $inject(AlephaCliUtils);
 	/**
-	* Called when no command is provided
+	* Launch Drizzle Studio database browser
 	*/
-	root = $command({
-		root: true,
-		flags: t.object({ version: t.optional(t.boolean({
-			description: "Show Alepha CLI version",
-			aliases: ["v"]
-		})) }),
-		handler: async ({ flags }) => {
-			if (flags.version) {
-				this.log.info(version);
-				return;
-			}
-			this.cli.printHelp();
+	studio = $command({
+		name: "studio",
+		description: "Launch Drizzle Studio database browser",
+		summary: false,
+		args: t.optional(t.text({
+			title: "path",
+			description: "Path to the Alepha server entry file"
+		})),
+		flags: drizzleCommandFlags,
+		handler: async ({ root, args, flags }) => {
+			await this.runDrizzleKitCommand({
+				root,
+				args,
+				command: "studio",
+				provider: flags.provider,
+				env: flags.mode,
+				logMessage: (providerName, dialect) => `Launch Studio for '${providerName}' (${dialect}) ...`
+			});
 		}
 	});
 	/**
-	* Clean the project, removing the "dist" directory
+	* Parent command for database operations.
 	*/
-	clean = $command({
-		name: "clean",
-		description: "Clean the project",
-		handler: async ({ run }) => {
-			await run.rm("./dist");
+	db = $command({
+		name: "db",
+		description: "Database management commands",
+		children: [
+			this.check,
+			this.generate,
+			this.push,
+			this.migrate,
+			this.studio
+		],
+		handler: async ({ help }) => {
+			help();
 		}
 	});
 	/**
-	* Ensure the project has the necessary Alepha configuration files.
-	* Add the correct dependencies to package.json and install them.
+	* Run a drizzle-kit command for all database providers in an Alepha instance.
 	*/
-	init = $command({
-		name: "init",
-		description: "Add missing Alepha configuration files to the project",
-		flags: t.object({
-			yarn: t.optional(t.boolean({ description: "Use Yarn package manager" })),
-			pnpm: t.optional(t.boolean({ description: "Use pnpm package manager" })),
-			npm: t.optional(t.boolean({ description: "Use npm package manager" })),
-			bun: t.optional(t.boolean({ description: "Use Bun package manager" })),
-			react: t.optional(t.boolean({ description: "Include Alepha React dependencies" })),
-			ui: t.optional(t.boolean({ description: "Include Alepha UI dependencies" })),
-			test: t.optional(t.boolean({ description: "Include Vitest and create test directory" }))
-		}),
-		handler: async ({ run, flags, root }) => {
-			if (flags.ui) flags.react = true;
-			const isExpo = await this.utils.hasExpo(root);
-			await run({
-				name: "ensuring configuration files",
-				handler: async () => {
-					await this.utils.ensureConfig(root, {
-						tsconfigJson: true,
-						packageJson: flags,
-						biomeJson: true,
-						viteConfigTs: !isExpo,
-						editorconfig: true,
-						indexHtml: !!flags.react && !isExpo
-					});
-					if (!flags.react) await this.utils.ensureSrcMain(root);
-				}
-			});
-			const pm = await this.utils.getPackageManager(root, flags);
-			if (pm === "yarn") {
-				await this.utils.ensureYarn(root);
-				await run("yarn set version stable");
-			} else if (pm === "pnpm") await this.utils.ensurePnpm(root);
-			else await this.utils.ensureNpm(root);
-			await run(`${pm} install`, { alias: `installing dependencies with ${pm}` });
-			if (!isExpo) await this.utils.ensureDependency(root, "vite", { run });
-			await this.utils.ensureDependency(root, "@biomejs/biome", { run });
-			if (flags.test) {
-				await this.utils.ensureTestDir(root);
-				await run(`${pm} ${pm === "yarn" ? "add" : "install"} -D vitest`, { alias: "setup testing with Vitest" });
+	async runDrizzleKitCommand(options) {
+		const rootDir = options.root;
+		const envFiles = [".env"];
+		if (options.env) envFiles.push(`.env.${options.env}`);
+		await this.utils.loadEnv(rootDir, envFiles);
+		this.log.debug(`Using project root: ${rootDir}`);
+		const { alepha, entry } = await this.utils.loadAlephaFromServerEntryFile(rootDir, options.args);
+		const drizzleKitProvider = alepha.inject("DrizzleKitProvider");
+		const repositoryProvider = alepha.inject("RepositoryProvider");
+		const accepted = /* @__PURE__ */ new Set([]);
+		for (const primitive of repositoryProvider.getRepositories()) {
+			const provider = primitive.provider;
+			const providerName = provider.name;
+			const dialect = provider.dialect;
+			if (accepted.has(providerName)) continue;
+			accepted.add(providerName);
+			if (options.provider && options.provider !== providerName) {
+				this.log.debug(`Skipping provider '${providerName}' (filter: ${options.provider})`);
+				continue;
 			}
+			this.log.info("");
+			this.log.info(options.logMessage(providerName, dialect));
+			const drizzleConfigJsPath = await this.prepareDrizzleConfig({
+				kit: drizzleKitProvider,
+				provider,
+				providerName,
+				providerUrl: provider.url,
+				dialect,
+				entry,
+				rootDir
+			});
+			const flags = options.commandFlags ? ` ${options.commandFlags}` : "";
+			await this.utils.exec(`drizzle-kit ${options.command} --config=${drizzleConfigJsPath}${flags}`, { env: { NODE_OPTIONS: "--import tsx" } });
 		}
-	});
+	}
+	/**
+	* Prepare Drizzle configuration files for a database provider.
+	*/
+	async prepareDrizzleConfig(options) {
+		const models = Object.keys(options.kit.getModels(options.provider));
+		const entitiesJs = this.utils.generateEntitiesJs(options.entry, options.providerName, models);
+		const config = {
+			schema: await this.utils.writeConfigFile("entities.js", entitiesJs, options.rootDir),
+			out: `./migrations/${options.providerName}`,
+			dialect: options.dialect,
+			dbCredentials: { url: options.providerUrl }
+		};
+		if (options.provider.schema) config.schemaFilter = options.provider.schema;
+		if (options.providerName === "d1") config.driver = "d1-http";
+		if (options.providerName === "pglite") config.driver = "pglite";
+		if (options.dialect === "sqlite") if (options.providerName === "d1") {
+			const token = process.env.CLOUDFLARE_API_TOKEN;
+			if (!token) throw new AlephaError("CLOUDFLARE_API_TOKEN environment variable is not set. https://orm.drizzle.team/docs/guides/d1-http-with-drizzle-kit");
+			const accountId = process.env.CLOUDFLARE_ACCOUNT_ID;
+			if (!accountId) throw new AlephaError("CLOUDFLARE_ACCOUNT_ID environment variable is not set. https://orm.drizzle.team/docs/guides/d1-http-with-drizzle-kit");
+			const url = options.providerUrl;
+			if (!url.startsWith("cloudflare-d1://")) throw new AlephaError("D1 provider URL must start with 'cloudflare-d1://'.");
+			const [, databaseId] = url.replace("cloudflare-d1://", "").replace("cloudflare-d1:", "").split(":");
+			if (!databaseId) throw new AlephaError("Database ID is missing in the D1 provider URL. Cloudflare D1 URL format: cloudflare-d1://<database_name>:<database_id>");
+			config.dbCredentials = {
+				accountId,
+				databaseId,
+				token
+			};
+		} else {
+			let url = options.providerUrl;
+			url = url.replace("sqlite://", "").replace("file://", "");
+			url = join(options.rootDir, url);
+			config.dbCredentials = { url };
+		}
+		const drizzleConfigJs = `export default ${JSON.stringify(config, null, 2)}`;
+		return await this.utils.writeConfigFile("drizzle.config.js", drizzleConfigJs, options.rootDir);
+	}
 };
 
 //#endregion
-//#region ../../src/cli/commands/DeployCommands.ts
-var DeployCommands = class {
+//#region ../../src/cli/commands/deploy.ts
+var DeployCommand = class {
 	log = $logger();
 	utils = $inject(AlephaCliUtils);
 	/**
@@ -974,369 +1079,470 @@ var DeployCommands = class {
 				return;
 			}
 			if (await this.utils.exists(root, "dist/wrangler.jsonc")) {
-				if (flags.migrate) {
-					this.log.debug("Running database migrations before deployment...");
-					await this.utils.exec(`alepha db migrate --mode=${mode}`);
-				}
-				await this.utils.ensureDependency(root, "wrangler", { dev: true });
-				const command = `wrangler deploy ${mode === "production" ? "" : "--env preview"} --config=dist/wrangler.jsonc`.trim();
-				this.log.info(`Deploying to Cloudflare with command: ${command}`);
-				await this.utils.exec(command);
-				return;
-			}
-			if (await this.utils.exists(root, "dist/public/404.html")) {
-				await this.utils.ensureDependency(root, "surge", { dev: true });
-				const distPath = join(root, "dist/public");
-				this.log.debug(`Deploying to Surge from directory: ${distPath}`);
-				await this.utils.exec(`surge ${distPath}`);
-				return;
-			}
-			throw new AlephaError("No deployment configuration found in the dist folder.");
-		}
-	});
-};
-
-//#endregion
-//#region ../../src/cli/commands/DrizzleCommands.ts
-const drizzleCommandFlags = t.object({
-	provider: t.optional(t.text({ description: "Database provider name to target (e.g., 'postgres', 'sqlite')" })),
-	mode: t.optional(t.text({ description: "Environment variable file(s) to load (e.g., 'production' to load .env.production) https://vite.dev/guide/env-and-mode" }))
-});
-var DrizzleCommands = class {
-	log = $logger();
-	utils = $inject(AlephaCliUtils);
-	/**
-	* Check if database migrations are up to date.
-	*/
-	check = $command({
-		name: "check-migrations",
-		description: "Check if database migration files are up to date",
-		args: t.optional(t.text({
-			title: "path",
-			description: "Path to the Alepha server entry file"
-		})),
-		flags: drizzleCommandFlags,
-		handler: async ({ args, root }) => {
-			const rootDir = root;
-			this.log.debug(`Using project root: ${rootDir}`);
-			const { alepha } = await this.utils.loadAlephaFromServerEntryFile(rootDir, args);
-			const repositoryProvider = alepha.inject("RepositoryProvider");
-			const drizzleKitProvider = alepha.inject("DrizzleKitProvider");
-			const accepted = /* @__PURE__ */ new Set([]);
-			for (const primitive of repositoryProvider.getRepositories()) {
-				const provider = primitive.provider;
-				const providerName = provider.name;
-				if (accepted.has(providerName)) continue;
-				accepted.add(providerName);
-				const migrationDir = join(rootDir, "migrations", providerName);
-				const journalFile = await readFile(`${migrationDir}/meta/_journal.json`, "utf-8").catch(() => null);
-				if (!journalFile) {
-					this.log.info(`No migration journal found.`);
-					return;
-				}
-				const journal = JSON.parse(journalFile);
-				const lastMigration = journal.entries[journal.entries.length - 1];
-				const lastSnapshot = JSON.parse(await readFile(`${migrationDir}/meta/${String(lastMigration.idx).padStart(4, "0")}_snapshot.json`, "utf-8"));
-				const models = drizzleKitProvider.getModels(provider);
-				const kit = drizzleKitProvider.importDrizzleKit();
-				const now = kit.generateDrizzleJson(models, lastSnapshot.id);
-				const migrationStatements = await new Promise((resolve) => {
-					(async () => {
-						const timer = setTimeout(() => {
-							resolve([{ message: "Migration generation timed out." }]);
-						}, 5e3);
-						const statements = await kit.generateMigration(lastSnapshot, now);
-						clearTimeout(timer);
-						resolve(statements);
-					})();
-				});
-				if (migrationStatements.length === 0) {
-					this.log.info("No changes detected.");
-					return;
+				if (flags.migrate) {
+					this.log.debug("Running database migrations before deployment...");
+					await this.utils.exec(`alepha db migrate --mode=${mode}`);
 				}
-				this.log.info("");
-				this.log.info("Detected migration statements:");
-				this.log.info("");
-				for (const stmt of migrationStatements) this.log.info(stmt);
-				this.log.info("");
-				this.log.info(`At least ${migrationStatements.length} change(s) detected.`);
-				this.log.info("Please, run 'alepha db:generate' to update the migration files.");
-				this.log.info("");
-				throw new AlephaError("Database migrations are not up to date.");
+				await this.utils.ensureDependency(root, "wrangler", { dev: true });
+				const command = `wrangler deploy ${mode === "production" ? "" : "--env preview"} --config=dist/wrangler.jsonc`.trim();
+				this.log.info(`Deploying to Cloudflare with command: ${command}`);
+				await this.utils.exec(command);
+				return;
+			}
+			if (await this.utils.exists(root, "dist/public/404.html")) {
+				await this.utils.ensureDependency(root, "surge", { dev: true });
+				const distPath = join(root, "dist/public");
+				this.log.debug(`Deploying to Surge from directory: ${distPath}`);
+				await this.utils.exec(`surge ${distPath}`);
+				return;
 			}
+			throw new AlephaError("No deployment configuration found in the dist folder.");
 		}
 	});
+};
+
+//#endregion
+//#region ../../src/cli/commands/dev.ts
+var DevCommand = class {
+	log = $logger();
+	utils = $inject(AlephaCliUtils);
+	alepha = $inject(Alepha);
 	/**
-	* Generate database migration files
+	* Will run the project in watch mode.
 	*
-	* - Loads the Alepha instance from the specified entry file.
-	* - Retrieves all repository primitives to gather database models.
-	* - Creates temporary entity definitions based on the current database schema.
-	* - Writes these definitions to a temporary schema file. (node_modules/.db/entities.ts)
-	* - Invokes Drizzle Kit's CLI to generate migration files based on the current schema.
+	* - If an index.html file is found in the project root, it will run Vite in dev mode.
+	* - Otherwise, it will look for a server entry file and run it with tsx in watch mode.
 	*/
-	generate = $command({
-		name: "generate",
-		description: "Generate migration files based on current database schema",
-		summary: false,
+	dev = $command({
+		name: "dev",
+		description: "Run the project in development mode",
 		args: t.optional(t.text({
 			title: "path",
-			description: "Path to the Alepha server entry file"
+			description: "Filepath to run"
 		})),
-		flags: t.extend(drizzleCommandFlags, { custom: t.optional(t.text({ description: "Custom migration name for drizzle-kit generate --custom" })) }),
-		handler: async ({ args, flags, root }) => {
-			const commandFlags = flags.custom ? `--custom=${flags.custom}` : void 0;
-			await this.runDrizzleKitCommand({
-				root,
-				args,
-				command: "generate",
-				commandFlags,
-				provider: flags.provider,
-				env: flags.mode,
-				logMessage: (providerName, dialect) => `Generate '${providerName}' migrations (${dialect}) ...`
+		handler: async ({ args, root }) => {
+			const expo = await this.utils.hasExpo(root);
+			await this.utils.ensureConfig(root, {
+				viteConfigTs: !expo,
+				tsconfigJson: true
 			});
+			if (expo) {
+				await this.utils.exec("expo start");
+				return;
+			}
+			const entry = await boot.getServerEntry(root, args);
+			this.log.trace("Entry file found", { entry });
+			if (!await this.isFullstackProject(root)) {
+				const exe = this.alepha.isBun() ? "bun" : "tsx";
+				let cmd = `${exe} --watch`;
+				if (await this.utils.exists(root, ".env")) cmd += " --env-file=./.env";
+				cmd += ` ${entry}`;
+				await this.utils.exec(cmd, { global: exe === "bun" });
+				return;
+			}
+			await this.utils.ensureDependency(root, "vite");
+			await this.utils.exec("vite");
 		}
 	});
-	/**
-	* Push database schema changes directly to the database
-	*
-	* - Loads the Alepha instance from the specified entry file.
-	* - Retrieves all repository primitives to gather database models.
-	* - Creates temporary entity definitions and Drizzle config.
-	* - Invokes Drizzle Kit's push command to apply schema changes directly.
-	*/
-	push = $command({
-		name: "push",
-		description: "Push database schema changes directly to the database",
-		summary: false,
-		args: t.optional(t.text({
-			title: "path",
-			description: "Path to the Alepha server entry file"
-		})),
-		flags: drizzleCommandFlags,
-		handler: async ({ root, args, flags }) => {
-			await this.runDrizzleKitCommand({
-				root,
-				args,
-				command: "push",
-				provider: flags.provider,
-				env: flags.mode,
-				logMessage: (providerName, dialect) => `Push '${providerName}' schema (${dialect}) ...`
-			});
+	async isFullstackProject(root) {
+		try {
+			await access(join(root, "index.html"));
+			return true;
+		} catch {
+			return false;
 		}
-	});
-	/**
-	* Apply pending database migrations
-	*
-	* - Loads the Alepha instance from the specified entry file.
-	* - Retrieves all repository primitives to gather database models.
-	* - Creates temporary entity definitions and Drizzle config.
-	* - Invokes Drizzle Kit's migrate command to apply pending migrations.
-	*/
-	migrate = $command({
-		name: "migrate",
-		description: "Apply pending database migrations",
-		summary: false,
-		args: t.optional(t.text({
-			title: "path",
-			description: "Path to the Alepha server entry file"
-		})),
-		flags: drizzleCommandFlags,
-		handler: async ({ root, args, flags }) => {
-			await this.runDrizzleKitCommand({
-				root,
-				args,
-				command: "migrate",
-				provider: flags.provider,
-				env: flags.mode,
-				logMessage: (providerName, dialect) => `Migrate '${providerName}' database (${dialect}) ...`
-			});
+	}
+};
+
+//#endregion
+//#region ../../src/cli/commands/format.ts
+var FormatCommand = class {
+	utils = $inject(AlephaCliUtils);
+	format = $command({
+		name: "format",
+		description: "Format the codebase using Biome",
+		handler: async ({ root }) => {
+			await this.utils.ensureConfig(root, { biomeJson: true });
+			await this.utils.ensureDependency(root, "@biomejs/biome");
+			await this.utils.exec("biome format --fix");
 		}
 	});
+};
+
+//#endregion
+//#region ../../src/cli/atoms/changelogOptions.ts
+/**
+* Default scopes to ignore in changelog generation.
+* Commits with these scopes won't appear in release notes.
+*/
+const DEFAULT_IGNORE = [
+	"project",
+	"release",
+	"starter",
+	"example",
+	"chore",
+	"ci",
+	"build",
+	"test",
+	"style"
+];
+/**
+* Changelog configuration atom.
+*
+* Configure in `alepha.config.ts`:
+* ```ts
+* import { changelogOptions } from "alepha/cli";
+*
+* alepha.set(changelogOptions, {
+*   ignore: ["project", "release", "chore", "docs"],
+* });
+* ```
+*/
+const changelogOptions = $atom({
+	name: "alepha.changelog",
+	schema: t.object({ ignore: t.optional(t.array(t.string())) }),
+	default: { ignore: DEFAULT_IGNORE }
+});
+
+//#endregion
+//#region ../../src/cli/services/GitMessageParser.ts
+/**
+* Service for parsing git commit messages into structured format.
+*
+* Only parses **conventional commits with a scope**:
+* - `feat(scope): description` → feature
+* - `fix(scope): description` → bug fix
+* - `feat(scope)!: description` → breaking change
+*
+* Commits without scope are ignored, allowing developers to commit
+* work-in-progress changes without polluting release notes:
+* - `cli: work in progress` → ignored (no type)
+* - `fix: quick patch` → ignored (no scope)
+* - `feat(cli): add command` → included
+*/
+var GitMessageParser = class {
+	log = $logger();
 	/**
-	* Launch Drizzle Studio database browser
+	* Parse a git commit line into a structured Commit object.
+	*
+	* **Format:** `type(scope): description` or `type(scope)!: description`
+	*
+	* **Supported types:** feat, fix, docs, refactor, perf, revert
+	*
+	* **Breaking changes:** Use `!` before `:` (e.g., `feat(api)!: remove endpoint`)
 	*
-	* - Loads the Alepha instance from the specified entry file.
-	* - Retrieves all repository primitives to gather database models.
-	* - Creates temporary entity definitions and Drizzle config.
-	* - Invokes Drizzle Kit's studio command to launch the web-based database browser.
+	* @returns Commit object or null if not matching/ignored
 	*/
-	studio = $command({
-		name: "studio",
-		description: "Launch Drizzle Studio database browser",
-		summary: false,
-		args: t.optional(t.text({
-			title: "path",
-			description: "Path to the Alepha server entry file"
-		})),
-		flags: drizzleCommandFlags,
-		handler: async ({ root, args, flags }) => {
-			await this.runDrizzleKitCommand({
-				root,
-				args,
-				command: "studio",
-				provider: flags.provider,
-				env: flags.mode,
-				logMessage: (providerName, dialect) => `Launch Studio for '${providerName}' (${dialect}) ...`
-			});
-		}
-	});
+	parseCommit(line, config) {
+		const match = line.match(/^([a-f0-9]+)\s+(.+)$/);
+		if (!match) return null;
+		const [, hash, message] = match;
+		const ignore = config.ignore ?? DEFAULT_IGNORE;
+		const conventionalMatch = message.match(/^(feat|fix|docs|refactor|perf|revert)\(([^)]+)\)(!)?:\s*(.+)$/i);
+		if (!conventionalMatch) return null;
+		const [, type, scope, breakingMark, description] = conventionalMatch;
+		const baseScope = scope.split("/")[0];
+		if (ignore.includes(baseScope) || ignore.includes(scope)) return null;
+		const breaking = breakingMark === "!" || description.toLowerCase().includes("breaking");
+		return {
+			hash: hash.substring(0, 8),
+			type: type.toLowerCase(),
+			scope,
+			description: description.trim(),
+			breaking
+		};
+	}
+};
+
+//#endregion
+//#region ../../src/cli/commands/gen/changelog.ts
+const execAsync = promisify(exec);
+/**
+* Git provider for executing git commands.
+* Can be substituted in tests with a mock implementation.
+*/
+var GitProvider = class {
+	async exec(cmd, cwd) {
+		const { stdout } = await execAsync(`git ${cmd}`, { cwd });
+		return stdout;
+	}
+};
+/**
+* Changelog command for generating release notes from git commits.
+*
+* Usage:
+* - `alepha gen changelog` - Show unreleased changes since latest tag to HEAD
+* - `alepha gen changelog --from=1.0.0` - Show changes from version to HEAD
+* - `alepha gen changelog --from=1.0.0 --to=1.1.0` - Show changes between two refs
+* - `alepha gen changelog | tee -a CHANGELOG.md` - Append to file
+*/
+var ChangelogCommand = class {
+	log = $logger();
+	git = $inject(GitProvider);
+	parser = $inject(GitMessageParser);
+	config = $use(changelogOptions);
+	/**
+	* Format a single commit line.
+	* Example: `- **cli**: add new command (\`abc1234\`)`
+	* Breaking changes are flagged: `- **cli**: add new command [BREAKING] (\`abc1234\`)`
+	*/
+	formatCommit(commit) {
+		const breaking = commit.breaking ? " [BREAKING]" : "";
+		return `- **${commit.scope}**: ${commit.description}${breaking} (\`${commit.hash}\`)`;
+	}
 	/**
-	* Parent command for database operations.
+	* Format the changelog entry with sections.
 	*/
-	db = $command({
-		name: "db",
-		description: "Database management commands",
-		children: [
-			this.check,
-			this.generate,
-			this.push,
-			this.migrate,
-			this.studio
-		],
-		handler: async ({ help }) => {
-			help();
+	formatEntry(entry) {
+		const sections = [];
+		if (entry.features.length > 0) {
+			sections.push("### Features\n");
+			for (const commit of entry.features) sections.push(this.formatCommit(commit));
+			sections.push("");
 		}
-	});
+		if (entry.fixes.length > 0) {
+			sections.push("### Bug Fixes\n");
+			for (const commit of entry.fixes) sections.push(this.formatCommit(commit));
+			sections.push("");
+		}
+		return sections.join("\n");
+	}
 	/**
-	* Run a drizzle-kit command for all database providers in an Alepha instance.
-	*
-	* Iterates through all repository providers, prepares Drizzle config for each,
-	* and executes the specified drizzle-kit command.
-	*
-	* @param options - Configuration including command to run, flags, and logging
+	* Parse git log output into a changelog entry.
 	*/
-	async runDrizzleKitCommand(options) {
-		const rootDir = options.root;
-		const envFiles = [".env"];
-		if (options.env) envFiles.push(`.env.${options.env}`);
-		await this.utils.loadEnv(rootDir, envFiles);
-		this.log.debug(`Using project root: ${rootDir}`);
-		const { alepha, entry } = await this.utils.loadAlephaFromServerEntryFile(rootDir, options.args);
-		const drizzleKitProvider = alepha.inject("DrizzleKitProvider");
-		const repositoryProvider = alepha.inject("RepositoryProvider");
-		const accepted = /* @__PURE__ */ new Set([]);
-		for (const primitive of repositoryProvider.getRepositories()) {
-			const provider = primitive.provider;
-			const providerName = provider.name;
-			const dialect = provider.dialect;
-			if (accepted.has(providerName)) continue;
-			accepted.add(providerName);
-			if (options.provider && options.provider !== providerName) {
-				this.log.debug(`Skipping provider '${providerName}' (filter: ${options.provider})`);
+	parseCommits(commitsOutput) {
+		const entry = {
+			features: [],
+			fixes: []
+		};
+		for (const line of commitsOutput.trim().split("\n")) {
+			if (!line.trim()) continue;
+			const commit = this.parser.parseCommit(line, this.config);
+			if (!commit) {
+				this.log.trace("Skipping commit", { line });
 				continue;
 			}
-			this.log.info("");
-			this.log.info(options.logMessage(providerName, dialect));
-			const drizzleConfigJsPath = await this.prepareDrizzleConfig({
-				kit: drizzleKitProvider,
-				provider,
-				providerName,
-				providerUrl: provider.url,
-				dialect,
-				entry,
-				rootDir
-			});
-			const flags = options.commandFlags ? ` ${options.commandFlags}` : "";
-			await this.utils.exec(`drizzle-kit ${options.command} --config=${drizzleConfigJsPath}${flags}`, { env: { NODE_OPTIONS: "--import tsx" } });
+			this.log.trace("Parsed commit", { commit });
+			if (commit.type === "feat") entry.features.push(commit);
+			else if (commit.type === "fix") entry.fixes.push(commit);
 		}
+		return entry;
 	}
 	/**
-	* Prepare Drizzle configuration files for a database provider.
-	*
-	* Creates temporary entities.js and drizzle.config.js files needed
-	* for Drizzle Kit commands to run properly.
-	*
-	* @param options - Configuration options including kit, provider info, and paths
-	* @returns Path to the generated drizzle.config.js file
+	* Check if entry has any public commits.
 	*/
-	async prepareDrizzleConfig(options) {
-		const models = Object.keys(options.kit.getModels(options.provider));
-		const entitiesJs = this.utils.generateEntitiesJs(options.entry, options.providerName, models);
-		const config = {
-			schema: await this.utils.writeConfigFile("entities.js", entitiesJs, options.rootDir),
-			out: `./migrations/${options.providerName}`,
-			dialect: options.dialect,
-			dbCredentials: { url: options.providerUrl }
-		};
-		if (options.provider.schema) config.schemaFilter = options.provider.schema;
-		if (options.providerName === "d1") config.driver = "d1-http";
-		if (options.providerName === "pglite") config.driver = "pglite";
-		if (options.dialect === "sqlite") if (options.providerName === "d1") {
-			const token = process.env.CLOUDFLARE_API_TOKEN;
-			if (!token) throw new AlephaError("CLOUDFLARE_API_TOKEN environment variable is not set. https://orm.drizzle.team/docs/guides/d1-http-with-drizzle-kit");
-			const accountId = process.env.CLOUDFLARE_ACCOUNT_ID;
-			if (!accountId) throw new AlephaError("CLOUDFLARE_ACCOUNT_ID environment variable is not set. https://orm.drizzle.team/docs/guides/d1-http-with-drizzle-kit");
-			const url = options.providerUrl;
-			if (!url.startsWith("cloudflare-d1://")) throw new AlephaError("D1 provider URL must start with 'cloudflare-d1://'.");
-			const [, databaseId] = url.replace("cloudflare-d1://", "").replace("cloudflare-d1:", "").split(":");
-			if (!databaseId) throw new AlephaError("Database ID is missing in the D1 provider URL. Cloudflare D1 URL format: cloudflare-d1://<database_name>:<database_id>");
-			config.dbCredentials = {
-				accountId,
-				databaseId,
-				token
-			};
-		} else {
-			let url = options.providerUrl;
-			url = url.replace("sqlite://", "").replace("file://", "");
-			url = join(options.rootDir, url);
-			config.dbCredentials = { url };
-		}
-		const drizzleConfigJs = `export default ${JSON.stringify(config, null, 2)}`;
-		return await this.utils.writeConfigFile("drizzle.config.js", drizzleConfigJs, options.rootDir);
+	hasChanges(entry) {
+		return entry.features.length > 0 || entry.fixes.length > 0;
+	}
+	/**
+	* Get the latest version tag.
+	*/
+	async getLatestTag(git) {
+		return (await git("tag --sort=-version:refname")).trim().split("\n").filter((tag) => tag.match(/^\d+\.\d+\.\d+$/))[0] || null;
 	}
+	command = $command({
+		name: "changelog",
+		description: "Generate changelog from conventional commits (outputs to stdout)",
+		flags: t.object({
+			from: t.optional(t.string({
+				aliases: ["f"],
+				description: "Starting ref (default: latest tag)"
+			})),
+			to: t.optional(t.string({
+				aliases: ["t"],
+				description: "Ending ref (default: HEAD)"
+			}))
+		}),
+		handler: async ({ flags, root }) => {
+			const git = (cmd) => this.git.exec(cmd, root);
+			let fromRef;
+			if (flags.from) {
+				fromRef = flags.from;
+				this.log.debug("Using specified from ref", { from: fromRef });
+			} else {
+				const latestTag = await this.getLatestTag(git);
+				if (!latestTag) {
+					process.stdout.write("No version tags found in repository\n");
+					return;
+				}
+				fromRef = latestTag;
+				this.log.debug("Using latest tag", { from: fromRef });
+			}
+			const toRef = flags.to || "HEAD";
+			this.log.debug("Using to ref", { to: toRef });
+			const commitsOutput = await git(`log ${fromRef}..${toRef} --oneline`);
+			if (!commitsOutput.trim()) {
+				process.stdout.write(`No changes in range ${fromRef}..${toRef}\n`);
+				return;
+			}
+			const entry = this.parseCommits(commitsOutput);
+			if (!this.hasChanges(entry)) {
+				process.stdout.write(`No public changes in range ${fromRef}..${toRef}\n`);
+				return;
+			}
+			process.stdout.write(this.formatEntry(entry));
+		}
+	});
+};
+
+//#endregion
+//#region ../../src/cli/commands/gen/openapi.ts
+var OpenApiCommand = class {
+	log = $logger();
+	utils = $inject(AlephaCliUtils);
+	fs = $inject(FileSystemProvider);
+	command = $command({
+		name: "openapi",
+		description: "Generate OpenAPI specification from actions",
+		flags: t.object({ out: t.optional(t.text({
+			aliases: ["o"],
+			description: "Output file path"
+		})) }),
+		handler: async ({ root, flags }) => {
+			const { alepha } = await this.utils.loadAlephaFromServerEntryFile(root);
+			try {
+				const openapiProvider = alepha.inject(ServerSwaggerProvider);
+				await alepha.events.emit("configure", alepha);
+				let json = openapiProvider.json;
+				if (!json) json = openapiProvider.generateSwaggerDoc({ info: {
+					title: "API Documentation",
+					version: "1.0.0"
+				} });
+				if (!json) {
+					this.log.error("No actions found to generate OpenAPI specification.");
+					return;
+				}
+				if (flags.out) await this.fs.writeFile(this.fs.join(root, flags.out), JSON.stringify(json, null, 2));
+				else this.log.info(JSON.stringify(json, null, 2));
+			} catch (err) {
+				const message = err instanceof Error ? err.message : String(err);
+				if (message.includes("Service not found")) {
+					this.log.error("Missing $swagger() primitive in your server configuration.");
+					return;
+				}
+				this.log.error(`OpenAPI generation failed - ${message}`, { err });
+			}
+		}
+	});
+};
+
+//#endregion
+//#region ../../src/cli/commands/gen.ts
+var GenCommand = class {
+	changelog = $inject(ChangelogCommand);
+	openapi = $inject(OpenApiCommand);
+	gen = $command({
+		name: "gen",
+		description: "Generate code, documentation, ...",
+		children: [this.changelog.command, this.openapi.command],
+		handler: async ({ help }) => {
+			help();
+		}
+	});
 };
 
 //#endregion
-//#region ../../src/cli/commands/VerifyCommands.ts
-var VerifyCommands = class {
+//#region ../../src/cli/commands/init.ts
+var InitCommand = class {
 	utils = $inject(AlephaCliUtils);
 	/**
-	* Run a series of verification commands to ensure code quality and correctness.
-	*
-	* This command runs the following checks in order:
-	* - Clean the project
-	* - Format the code
-	* - Lint the code
-	* - Run tests (if Vitest is a dev dependency)
-	* - Check database migrations (if a migrations directory exists)
-	* - Type check the code
-	* - Build the project
-	* - Clean the project again
+	* Ensure the project has the necessary Alepha configuration files.
+	* Add the correct dependencies to package.json and install them.
 	*/
-	verify = $command({
-		name: "verify",
-		description: "Verify the Alepha project",
-		handler: async ({ root, run }) => {
-			await run("alepha clean");
-			await run("alepha format");
-			await run("alepha lint");
-			await run("alepha typecheck");
-			if ((await this.utils.readPackageJson(root)).devDependencies?.vitest) await run("alepha test");
-			if (await this.utils.exists(root, "migrations")) await run("alepha db:check-migrations");
-			if (!await this.utils.hasExpo(root)) await run("alepha build");
-			await run("alepha clean");
+	init = $command({
+		name: "init",
+		description: "Add missing Alepha configuration files to the project",
+		flags: t.object({
+			yarn: t.optional(t.boolean({ description: "Use Yarn package manager" })),
+			pnpm: t.optional(t.boolean({ description: "Use pnpm package manager" })),
+			npm: t.optional(t.boolean({ description: "Use npm package manager" })),
+			bun: t.optional(t.boolean({ description: "Use Bun package manager" })),
+			react: t.optional(t.boolean({ description: "Include Alepha React dependencies" })),
+			ui: t.optional(t.boolean({ description: "Include Alepha UI dependencies" })),
+			test: t.optional(t.boolean({ description: "Include Vitest and create test directory" }))
+		}),
+		handler: async ({ run, flags, root }) => {
+			if (flags.ui) flags.react = true;
+			const isExpo = await this.utils.hasExpo(root);
+			await run({
+				name: "ensuring configuration files",
+				handler: async () => {
+					await this.utils.ensureConfig(root, {
+						tsconfigJson: true,
+						packageJson: flags,
+						biomeJson: true,
+						viteConfigTs: !isExpo,
+						editorconfig: true,
+						indexHtml: !!flags.react && !isExpo
+					});
+					if (!flags.react) await this.utils.ensureSrcMain(root);
+				}
+			});
+			const pm = await this.utils.getPackageManager(root, flags);
+			if (pm === "yarn") {
+				await this.utils.ensureYarn(root);
+				await run("yarn set version stable");
+			} else if (pm === "bun") await this.utils.ensureBun(root);
+			else if (pm === "pnpm") await this.utils.ensurePnpm(root);
+			else await this.utils.ensureNpm(root);
+			await run(`${pm} install`, { alias: `installing dependencies with ${pm}` });
+			if (!isExpo) await this.utils.ensureDependency(root, "vite", { run });
+			await this.utils.ensureDependency(root, "@biomejs/biome", { run });
+			if (flags.test) {
+				await this.utils.ensureTestDir(root);
+				await run(`${pm} ${pm === "yarn" ? "add" : "install"} -D vitest`, { alias: "setup testing with Vitest" });
+			}
+		}
+	});
+};
+
+//#endregion
+//#region ../../src/cli/commands/lint.ts
+var LintCommand = class {
+	utils = $inject(AlephaCliUtils);
+	lint = $command({
+		name: "lint",
+		description: "Run linter across the codebase using Biome",
+		handler: async ({ root }) => {
+			await this.utils.ensureConfig(root, { biomeJson: true });
+			await this.utils.ensureDependency(root, "@biomejs/biome");
+			await this.utils.exec("biome check --formatter-enabled=false --fix");
 		}
 	});
+};
+
+//#endregion
+//#region ../../src/cli/commands/root.ts
+var RootCommand = class {
+	log = $logger();
+	cli = $inject(CliProvider);
+	alepha = $inject(Alepha);
+	color = $inject(ConsoleColorProvider);
 	/**
-	* Run TypeScript type checking across the codebase with no emit.
+	* Called when no command is provided
 	*/
-	typecheck = $command({
-		name: "typecheck",
-		description: "Check TypeScript types across the codebase",
-		handler: async ({ root }) => {
-			await this.utils.ensureDependency(root, "typescript");
-			await this.utils.exec("tsc --noEmit");
+	root = $command({
+		root: true,
+		flags: t.object({ version: t.optional(t.boolean({
+			description: "Show Alepha CLI version",
+			aliases: ["v"]
+		})) }),
+		handler: async ({ flags }) => {
+			if (flags.version) {
+				this.log.info(this.color.set("WHITE_BOLD", `Alepha v${version}`));
+				if (this.alepha.isBun()) this.log.info(this.color.set("GREY_DARK", `└─ Bun v${Bun.version}`));
+				else this.log.info(this.color.set("GREY_DARK", `└─ Node ${process.version}`));
+				return;
+			}
+			this.cli.printHelp();
 		}
 	});
 };
 
 //#endregion
-//#region ../../src/cli/commands/ViteCommands.ts
-var ViteCommands = class {
-	log = $logger();
+//#region ../../src/cli/commands/run.ts
+var RunCommand = class {
 	utils = $inject(AlephaCliUtils);
-	env = $env(t.object({ VITEST_ARGS: t.string({ default: "" }) }));
 	run = $command({
 		name: "run",
 		hide: true,
@@ -1355,171 +1561,12 @@ var ViteCommands = class {
 			await this.utils.exec(`tsx ${flags.watch ? "watch " : ""}${args}`);
 		}
 	});
-	/**
-	* Will run the project in watch mode.
-	*
-	* - If an index.html file is found in the project root, it will run Vite in dev mode.
-	* - Otherwise, it will look for a server entry file and run it with tsx in watch mode.
-	*/
-	dev = $command({
-		name: "dev",
-		description: "Run the project in development mode",
-		args: t.optional(t.text({
-			title: "path",
-			description: "Filepath to run"
-		})),
-		handler: async ({ args, root }) => {
-			const expo = await this.utils.hasExpo(root);
-			await this.utils.ensureConfig(root, {
-				viteConfigTs: !expo,
-				tsconfigJson: true
-			});
-			if (expo) {
-				await this.utils.exec(`expo start`);
-				return;
-			}
-			const entry = await boot.getServerEntry(root, args);
-			this.log.trace("Entry file found", { entry });
-			try {
-				await access(join(root, "index.html"));
-			} catch {
-				this.log.trace("No index.html found, running entry file with tsx");
-				let cmd = "tsx --watch";
-				if (await this.utils.exists(root, ".env")) cmd += ` --env-file=./.env`;
-				cmd += ` ${entry}`;
-				await this.utils.exec(cmd);
-				return;
-			}
-			await this.utils.ensureDependency(root, "vite");
-			await this.utils.exec(`vite`);
-		}
-	});
-	build = $command({
-		name: "build",
-		description: "Build the project for production",
-		args: t.optional(t.text({
-			title: "path",
-			description: "Filepath to build"
-		})),
-		flags: t.object({
-			stats: t.optional(t.boolean({ description: "Generate build stats report" })),
-			vercel: t.optional(t.boolean({ description: "Generate Vercel deployment configuration" })),
-			cloudflare: t.optional(t.boolean({ description: "Generate Cloudflare Workers configuration" })),
-			docker: t.optional(t.boolean({ description: "Generate Docker configuration" })),
-			sitemap: t.optional(t.text({ description: "Generate sitemap.xml with base URL" }))
-		}),
-		handler: async ({ flags, args, run, root }) => {
-			process.env.ALEPHA_BUILD_MODE = "cli";
-			process.env.NODE_ENV = "production";
-			if (await this.utils.hasExpo(root)) return;
-			await this.utils.ensureConfig(root, {
-				viteConfigTs: true,
-				tsconfigJson: true
-			});
-			const entry = await boot.getServerEntry(root, args);
-			this.log.trace("Entry file found", { entry });
-			const distDir = "dist";
-			const clientDir = "public";
-			await this.utils.ensureDependency(root, "vite", { run });
-			await run.rm("dist", { alias: "clean dist" });
-			const viteAlephaBuildOptions = (await createRequire(import.meta.url)("vite").resolveConfig({}, "build", "production")).plugins.find((it) => it.name === "alepha:build")?.[OPTIONS] || {};
-			await this.utils.loadEnv(root, [".env", ".env.production"]);
-			const stats = flags.stats ?? viteAlephaBuildOptions.stats ?? false;
-			const hasServer = viteAlephaBuildOptions.serverEntry !== false;
-			let hasClient = false;
-			try {
-				await access(join(root, "index.html"));
-				hasClient = true;
-			} catch {}
-			const clientOptions = typeof viteAlephaBuildOptions.client === "object" ? viteAlephaBuildOptions.client : {};
-			if (hasClient) await run({
-				name: "vite build client",
-				handler: () => buildClient({
-					silent: true,
-					dist: `${distDir}/${clientDir}`,
-					stats,
-					precompress: clientOptions.precompress
-				})
-			});
-			await run({
-				name: "vite build server",
-				handler: async () => {
-					let clientBuilt = false;
-					try {
-						await readFile(`${distDir}/${clientDir}/index.html`, "utf-8");
-						clientBuilt = true;
-					} catch {}
-					await buildServer({
-						silent: true,
-						entry,
-						distDir,
-						clientDir: clientBuilt ? clientDir : void 0,
-						stats
-					});
-					if (clientBuilt && hasServer) await unlink(`${distDir}/${clientDir}/index.html`);
-				}
-			});
-			await copyAssets({
-				root,
-				entry: `${distDir}/index.js`,
-				distDir,
-				run
-			});
-			if (hasClient) {
-				const sitemapBaseUrl = flags.sitemap ?? clientOptions.sitemap?.hostname;
-				if (sitemapBaseUrl) await run({
-					name: "add sitemap",
-					handler: async () => {
-						await writeFile(`${distDir}/${clientDir}/sitemap.xml`, await generateSitemap({
-							entry: `${distDir}/index.js`,
-							baseUrl: sitemapBaseUrl
-						}));
-					}
-				});
-				if (clientOptions.prerender) await run({
-					name: "pre-render pages",
-					handler: async () => {
-						await prerenderPages({
-							dist: `${distDir}/${clientDir}`,
-							entry: `${distDir}/index.js`,
-							compress: clientOptions.precompress
-						});
-					}
-				});
-			}
-			if (flags.vercel || viteAlephaBuildOptions.vercel) {
-				const config = typeof viteAlephaBuildOptions.vercel === "object" ? viteAlephaBuildOptions.vercel : {};
-				await run({
-					name: "add Vercel config",
-					handler: () => generateVercel({
-						distDir,
-						clientDir,
-						config
-					})
-				});
-			}
-			if (flags.cloudflare || viteAlephaBuildOptions.cloudflare) {
-				const config = typeof viteAlephaBuildOptions.cloudflare === "boolean" ? {} : viteAlephaBuildOptions.cloudflare;
-				await run({
-					name: "add Cloudflare config",
-					handler: () => generateCloudflare({
-						distDir,
-						config
-					})
-				});
-			}
-			if (flags.docker || viteAlephaBuildOptions.docker) {
-				const dockerConfig = typeof viteAlephaBuildOptions.docker === "object" ? viteAlephaBuildOptions.docker : {};
-				await run({
-					name: "add Docker config",
-					handler: () => generateDocker({
-						distDir,
-						...dockerConfig
-					})
-				});
-			}
-		}
-	});
+};
+
+//#endregion
+//#region ../../src/cli/commands/test.ts
+var TestCommand = class {
+	utils = $inject(AlephaCliUtils);
 	test = $command({
 		name: "test",
 		description: "Run tests using Vitest",
@@ -1543,15 +1590,82 @@ var ViteCommands = class {
 	});
 };
 
+//#endregion
+//#region ../../src/cli/commands/typecheck.ts
+var TypecheckCommand = class {
+	utils = $inject(AlephaCliUtils);
+	log = $logger();
+	/**
+	* Run TypeScript type checking across the codebase with no emit.
+	*/
+	typecheck = $command({
+		name: "typecheck",
+		aliases: ["tc"],
+		description: "Check TypeScript types across the codebase",
+		handler: async ({ root }) => {
+			this.log.info("Starting TypeScript type checking...");
+			await this.utils.ensureDependency(root, "typescript");
+			await this.utils.exec("tsc --noEmit");
+			this.log.info("TypeScript type checking completed successfully.");
+		}
+	});
+};
+
+//#endregion
+//#region ../../src/cli/commands/verify.ts
+var VerifyCommand = class {
+	utils = $inject(AlephaCliUtils);
+	/**
+	* Run a series of verification commands to ensure code quality and correctness.
+	*
+	* This command runs the following checks in order:
+	* - Clean the project
+	* - Format the code
+	* - Lint the code
+	* - Run tests (if Vitest is a dev dependency)
+	* - Check database migrations (if a migrations directory exists)
+	* - Type check the code
+	* - Build the project
+	* - Clean the project again
+	*/
+	verify = $command({
+		name: "verify",
+		description: "Verify the Alepha project",
+		handler: async ({ root, run }) => {
+			await run("alepha clean");
+			await run("alepha format");
+			await run("alepha lint");
+			await run("alepha typecheck");
+			if ((await this.utils.readPackageJson(root)).devDependencies?.vitest) await run("alepha test");
+			if (await this.utils.exists(root, "migrations")) await run("alepha db:check-migrations");
+			if (!await this.utils.hasExpo(root)) await run("alepha build");
+			await run("alepha clean");
+		}
+	});
+};
+
 //#endregion
 //#region ../../src/cli/apps/AlephaCli.ts
+/**
+* Register `tsx` when running in Node.js, ignore for Bun.
+*
+* It's required to have a full TypeScript support. (mostly .tsx files)
+*/
+if (typeof Bun === "undefined") {
+	const { register } = await import("tsx/esm/api");
+	register();
+}
+/**
+* Allow to extend Alepha CLI via `alepha.config.ts` file located in the project root.
+*/
 var AlephaCliExtension = class {
 	alepha = $inject(Alepha);
 	fs = $inject(FileSystemProvider);
 	onConfigure = $hook({
 		on: "configure",
 		handler: async () => {
-			const extensionPath = join(process.cwd(), "alepha.config.ts");
+			const root = process.cwd();
+			const extensionPath = this.fs.join(root, "alepha.config.ts");
 			if (!await this.fs.exists(extensionPath)) return;
 			const { default: Extension } = await import(extensionPath);
 			if (typeof Extension !== "function") return;
@@ -1563,13 +1677,21 @@ const AlephaCli = $module({
 	name: "alepha.cli",
 	services: [
 		AlephaCliExtension,
-		BiomeCommands,
-		ChangelogCommands,
-		CoreCommands,
-		DeployCommands,
-		DrizzleCommands,
-		VerifyCommands,
-		ViteCommands
+		BuildCommand,
+		CleanCommand,
+		DbCommand,
+		DeployCommand,
+		DevCommand,
+		FormatCommand,
+		InitCommand,
+		LintCommand,
+		RootCommand,
+		RunCommand,
+		TestCommand,
+		TypecheckCommand,
+		VerifyCommand,
+		GenCommand,
+		GitProvider
 	]
 });
 
@@ -1606,7 +1728,10 @@ var AlephaPackageBuilderCli = class {
 				pkgData.exports["./tsconfig.base"] = "./tsconfig.base.json";
 				pkgData.exports["./package.json"] = "./package.json";
 			}
-			if (packageName === "@alepha/ui") pkgData.exports["./styles"] = "./styles.css";
+			if (packageName === "@alepha/ui") {
+				pkgData.exports["./styles"] = "./src/core/styles.css";
+				pkgData.exports["./json/styles"] = "./src/json/styles.css";
+			}
 			await this.fs.writeFile("package.json", JSON.stringify(pkgData, null, 2));
 			const tmpDir = join(root, "node_modules/.alepha");
 			await this.fs.mkdir(tmpDir, { recursive: true }).catch(() => {});
@@ -1767,11 +1892,16 @@ async function analyzeModules(srcDir, packageName) {
 //#region ../../src/cli/defineConfig.ts
 const defineConfig = (config) => {
 	return (alepha) => {
-		const { commands } = config(alepha);
+		const { commands, services = [] } = config(alepha);
+		for (const it of services) alepha.with(it);
 		return { ...commands };
 	};
 };
+/**
+* @alias defineConfig
+*/
+const defineAlephaConfig = defineConfig;
 
 //#endregion
-export { AlephaCli, AlephaCliUtils, AlephaPackageBuilderCli, BiomeCommands, ChangelogCommands, CoreCommands, DEFAULT_IGNORE, DeployCommands, DrizzleCommands, GitMessageParser, GitProvider, VerifyCommands, ViteCommands, analyzeModules, changelogOptions, defineConfig, version };
+export { AlephaCli, AlephaCliUtils, AlephaPackageBuilderCli, BuildCommand, ChangelogCommand, CleanCommand, DEFAULT_IGNORE, DbCommand, DeployCommand, DevCommand, FormatCommand, GitMessageParser, GitProvider, InitCommand, LintCommand, OpenApiCommand, RootCommand, RunCommand, TestCommand, TypecheckCommand, VerifyCommand, analyzeModules, changelogOptions, defineAlephaConfig, defineConfig, version };
 //# sourceMappingURL=index.js.map