alepha 0.18.2 → 0.18.3

package/dist/cli/core/index.js

@@ -5,8 +5,8 @@ import { $logger, ConsoleColorProvider } from "alepha/logger";
 import { FileSystemProvider, ShellProvider } from "alepha/system";
 import { createHash } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { readFile } from "node:fs/promises";
+import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { analyzer } from "vite-bundle-analyzer";
 import { KV_DEFAULT_BINDING } from "alepha/cache";
@@ -16,6 +16,18 @@ import { brotliCompress, gzip } from "node:zlib";
 import { exec } from "node:child_process";
 import { ServerSwaggerProvider } from "alepha/server/swagger";
 
+//#region ../../src/cli/core/atoms/appEntryOptions.ts
+const appEntryOptions = $atom({
+	name: "alepha.cli.appEntry.options",
+	schema: t.object({
+		server: t.optional(t.text()),
+		browser: t.optional(t.text()),
+		style: t.optional(t.text())
+	}),
+	default: {}
+});
+
+//#endregion
 //#region ../../src/cli/core/atoms/buildOptions.ts
 /**
 * Build options atom for CLI build command.
@@ -70,13 +82,19 @@ const buildOptions = $atom({
 });
 
 //#endregion
-//#region ../../src/cli/core/atoms/appEntryOptions.ts
-const appEntryOptions = $atom({
-	name: "alepha.cli.appEntry.options",
+//#region ../../src/cli/core/atoms/devOptions.ts
+/**
+* Dev options atom for CLI dev command.
+*
+* Defines the available dev configuration options with their defaults.
+* Options can be overridden via alepha.config.ts or CLI flags.
+*/
+const devOptions = $atom({
+	name: "alepha.cli.dev.options",
+	description: "Dev configuration options",
 	schema: t.object({
-		server: t.optional(t.text()),
-		browser: t.optional(t.text()),
-		style: t.optional(t.text())
+		noDevtools: t.optional(t.boolean({ default: false })),
+		noViteReactPlugin: t.optional(t.boolean({ default: false }))
 	}),
 	default: {}
 });
@@ -265,6 +283,45 @@ var ViteUtils = class {
 		};
 	}
 	/**
+	* Vite plugin that reads tsconfig.json `compilerOptions.paths` and converts
+	* them to Vite `resolve.alias` entries. Enables `@/*` → `src/*` style imports
+	* with zero config beyond tsconfig.json.
+	*/
+	createTsconfigPathsPlugin() {
+		return {
+			name: "alepha-tsconfig-paths",
+			async config(config) {
+				const root = config.root || process.cwd();
+				const tsconfigPath = join(root, "tsconfig.json");
+				let content;
+				try {
+					content = await readFile(tsconfigPath, "utf-8");
+				} catch {
+					return;
+				}
+				const clean = content.replace(/\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "");
+				let tsconfig;
+				try {
+					tsconfig = JSON.parse(clean);
+				} catch {
+					return;
+				}
+				const paths = tsconfig?.compilerOptions?.paths;
+				if (!paths || typeof paths !== "object") return;
+				const alias = {};
+				for (const [pattern, targets] of Object.entries(paths)) {
+					if (!Array.isArray(targets) || targets.length === 0) continue;
+					const target = targets[0];
+					const aliasKey = pattern.replace(/\*$/, "");
+					const resolved = resolve(root, target.replace(/\*$/, "").replace(/^\.\//, ""));
+					alias[aliasKey] = aliasKey.endsWith("/") ? `${resolved}/` : resolved;
+				}
+				if (Object.keys(alias).length === 0) return;
+				return { resolve: { alias } };
+			}
+		};
+	}
+	/**
 	* Vite plugin that generates a preload manifest for SSR module preloading.
 	*
 	* Collects lazy import paths from $page definitions during transform,
@@ -399,6 +456,7 @@ ${style ? `<link rel="stylesheet" href="/${style}" />` : ""}
 		process.env.NODE_ENV = opts.mode;
 		process.env.ALEPHA_CLI_IMPORT = "true";
 		process.env.LOG_LEVEL ??= "warn";
+		process.env.APP_SECRET ??= "123456";
 		/**
 		* 01/26 Vite 7
 		* "runnerImport" doesn't work as expected here. (e.g. build docs fail)
@@ -408,7 +466,8 @@ ${style ? `<link rel="stylesheet" href="/${style}" />` : ""}
 		this.viteDevServer = await createServer({
 			server: { middlewareMode: true },
 			appType: "custom",
-			logLevel: "silent"
+			logLevel: "silent",
+			plugins: [this.createTsconfigPathsPlugin()]
 		});
 		await this.viteDevServer.ssrLoadModule(opts.entry.server);
 		delete process.env.ALEPHA_CLI_IMPORT;
@@ -538,12 +597,12 @@ var AlephaCliUtils = class {
 //#endregion
 //#region ../../package.json
 var devDependencies = {
-	"@biomejs/biome": "^2.4.4",
+	"@biomejs/biome": "^2.4.5",
 	"@electric-sql/pglite": "^0.3.15",
 	"@faker-js/faker": "^10.3.0",
 	"@testing-library/dom": "^10.4.1",
 	"@testing-library/react": "^16.3.2",
-	"@types/node": "^25.3.0",
+	"@types/node": "^25.3.3",
 	"@types/nodemailer": "^7.0.11",
 	"@types/react": "^19.2.14",
 	"@types/react-dom": "^19.2.3",
@@ -558,7 +617,7 @@ var devDependencies = {
 	"prom-client": "^15.1.3",
 	"react": "^19.2.4",
 	"react-dom": "^19.2.4",
-	"swagger-ui-dist": "^5.31.2",
+	"swagger-ui-dist": "^5.32.0",
 	"tsdown": "^0.20.3",
 	"vite": "^7.3.1",
 	"vitest": "^4.0.18"
@@ -602,35 +661,57 @@ var PackageManagerUtils = class {
 	/**
 	* Detect workspace context when inside a monorepo package.
 	*
-	* Checks if we're inside a workspace package (e.g., packages/my-pkg or apps/my-app)
-	* by looking 2 levels up for workspace indicators like lockfiles and config files.
+	* Checks if we're inside a workspace package by walking up to 3 levels
+	* for workspace indicators like lockfiles and config files.
+	* This covers both standard layouts (packages/my-pkg) and deeper nesting
+	* (packages/scope/my-pkg).
 	*
 	* @param root - The current package directory
 	* @returns Workspace context with root path, PM, and config presence
 	*/
 	async getWorkspaceContext(root) {
-		const workspaceRoot = this.fs.join(root, "..", "..");
+		const noContext = {
+			isPackage: false,
+			workspaceRoot: null,
+			packageManager: null,
+			config: {
+				biomeJson: false,
+				editorconfig: false,
+				tsconfigJson: false
+			}
+		};
+		for (let depth = 2; depth <= 3; depth++) {
+			const segments = Array.from({ length: depth }, () => "..");
+			const candidate = this.fs.join(root, ...segments);
+			if (candidate === root) break;
+			const result = await this.checkWorkspaceRoot(candidate);
+			if (result) return result;
+		}
+		return noContext;
+	}
+	async checkWorkspaceRoot(candidate) {
 		const [hasYarnLock, hasPnpmLock, hasNpmLock, hasBunLock] = await Promise.all([
-			this.fs.exists(this.fs.join(workspaceRoot, "yarn.lock")),
-			this.fs.exists(this.fs.join(workspaceRoot, "pnpm-lock.yaml")),
-			this.fs.exists(this.fs.join(workspaceRoot, "package-lock.json")),
-			this.fs.exists(this.fs.join(workspaceRoot, "bun.lock"))
+			this.fs.exists(this.fs.join(candidate, "yarn.lock")),
+			this.fs.exists(this.fs.join(candidate, "pnpm-lock.yaml")),
+			this.fs.exists(this.fs.join(candidate, "package-lock.json")),
+			this.fs.exists(this.fs.join(candidate, "bun.lock"))
 		]);
-		const [hasBiome, hasEditorConfig, hasTsConfig, hasWorkspacePackageJson] = await Promise.all([
-			this.fs.exists(this.fs.join(workspaceRoot, "biome.json")),
-			this.fs.exists(this.fs.join(workspaceRoot, ".editorconfig")),
-			this.fs.exists(this.fs.join(workspaceRoot, "tsconfig.json")),
-			this.fs.exists(this.fs.join(workspaceRoot, "package.json"))
+		if (!(hasYarnLock || hasPnpmLock || hasNpmLock || hasBunLock)) return null;
+		const [hasBiome, hasEditorConfig, hasTsConfig, hasPackageJson] = await Promise.all([
+			this.fs.exists(this.fs.join(candidate, "biome.json")),
+			this.fs.exists(this.fs.join(candidate, ".editorconfig")),
+			this.fs.exists(this.fs.join(candidate, "tsconfig.json")),
+			this.fs.exists(this.fs.join(candidate, "package.json"))
 		]);
-		const isPackage = (hasYarnLock || hasPnpmLock || hasNpmLock || hasBunLock) && hasWorkspacePackageJson;
+		if (!hasPackageJson) return null;
 		let packageManager = null;
 		if (hasYarnLock) packageManager = "yarn";
 		else if (hasPnpmLock) packageManager = "pnpm";
 		else if (hasBunLock) packageManager = "bun";
 		else if (hasNpmLock) packageManager = "npm";
 		return {
-			isPackage,
-			workspaceRoot: isPackage ? workspaceRoot : null,
+			isPackage: true,
+			workspaceRoot: candidate,
 			packageManager,
 			config: {
 				biomeJson: hasBiome,
@@ -887,7 +968,7 @@ alepha build     # Build
 * Template for alepha.config.ts with documented options.
 */
 const alephaConfigTs = () => {
-	return `import { defineConfig } from "alepha/cli";
+	return `import { defineConfig } from "alepha/cli/config";
 
 export default defineConfig({
   //
@@ -931,12 +1012,9 @@ export class AppSecurity {
 
       // Registration & login options
       registrationAllowed: true,
-      emailEnabled: true,
-      emailRequired: true,
-      usernameEnabled: false,
-      usernameRequired: false,
-      phoneEnabled: false,
-      phoneRequired: false,
+      email: "required",
+      username: "none",
+      phoneNumber: "none",
 
       // Verification (requires notifications feature)
       verifyEmailRequired: false,
@@ -948,8 +1026,8 @@ export class AppSecurity {
       notifications: false,
       audits: false,
       apiKeys: false,
-      jobs: false,
-      files: false,
+      sessionPurge: false,
+      avatars: false,
       parameters: false,
     },
     identities: {
@@ -1216,7 +1294,12 @@ run(alepha);
 //#region ../../src/cli/core/templates/tsconfigJson.ts
 const tsconfigJson = () => `
 {
-  "extends": "alepha/tsconfig.base"
+  "extends": "alepha/tsconfig.base",
+  "compilerOptions": {
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  }
 }
 `.trim();
 
@@ -1325,6 +1408,7 @@ export const WebModule = $module({
 */
 var ProjectScaffolder = class {
 	log = $logger();
+	colors = $inject(ConsoleColorProvider);
 	fs = $inject(FileSystemProvider);
 	pm = $inject(PackageManagerUtils);
 	utils = $inject(AlephaCliUtils);
@@ -1473,6 +1557,105 @@ var ProjectScaffolder = class {
 		if ((await this.fs.ls(testDir)).length === 0) await this.fs.writeFile(dummyPath, dummySpecTs());
 	}
 	/**
+	* Full project init — scaffolds files, installs deps, sets up PM and git.
+	*/
+	async init({ run, root, flags, args }) {
+		if (args) {
+			root = this.fs.join(root, args);
+			await this.fs.mkdir(root, { force: true });
+		}
+		if (flags.admin) flags.auth = true;
+		if (flags.auth) {
+			flags.api = true;
+			flags.ui = true;
+		}
+		if (flags.ui) flags.react = true;
+		if (flags.tailwind) flags.react = true;
+		if ((flags.admin || flags.auth || flags.api || flags.ui || flags.react || flags.tailwind) && !flags.force) {
+			if ((await this.fs.ls(root)).filter((f) => f !== "package.json").length > 0) throw new AlephaError(`Target directory is not empty (${root}). Use --force to overwrite existing files.`);
+		}
+		const workspace = await this.pm.getWorkspaceContext(root);
+		let agentType = false;
+		if (!workspace.isPackage) agentType = await this.utils.isInstalledAsync("claude") ? "claude" : "agents";
+		const isExpo = await this.pm.hasExpo(root);
+		const adminEmail = flags.auth ? await this.utils.getGitEmail() : void 0;
+		const force = !!flags.force;
+		await run({
+			name: "ensuring configuration files",
+			handler: async () => {
+				await this.ensureConfig(root, {
+					force,
+					packageJson: {
+						...flags,
+						isPackage: workspace.isPackage
+					},
+					tsconfigJson: !workspace.config.tsconfigJson,
+					biomeJson: !workspace.config.biomeJson,
+					editorconfig: !workspace.config.editorconfig,
+					agentMd: agentType ? { type: agentType } : false
+				});
+				await this.ensureAlephaConfig(root, { force });
+				await this.ensureMainServerTs(root, {
+					api: !!flags.api,
+					react: !!flags.react && !isExpo,
+					force
+				});
+				if (flags.api) await this.ensureApiProject(root, {
+					auth: !!flags.auth,
+					adminEmail,
+					force
+				});
+				if (flags.react && !isExpo) await this.ensureWebProject(root, {
+					api: !!flags.api,
+					ui: !!flags.ui,
+					auth: !!flags.auth,
+					admin: !!flags.admin,
+					tailwind: !!flags.tailwind,
+					force
+				});
+			}
+		});
+		const pmName = await this.pm.getPackageManager(workspace.workspaceRoot ?? root, flags.pm ?? workspace.packageManager ?? void 0);
+		if (!workspace.isPackage) if (pmName === "yarn") {
+			await this.pm.ensureYarn(root);
+			await run("yarn set version stable", { root });
+		} else if (pmName === "bun") await this.pm.ensureBun(root);
+		else if (pmName === "pnpm") await this.pm.ensurePnpm(root);
+		else await this.pm.ensureNpm(root);
+		const installRoot = workspace.workspaceRoot ?? root;
+		await run(`${pmName} install`, {
+			alias: `installing dependencies with ${pmName}`,
+			root: installRoot
+		});
+		if (flags.test) await this.ensureTestDir(root);
+		await run(`${pmName} run lint`, {
+			alias: "running linter",
+			root: installRoot
+		});
+		if (!workspace.isPackage) {
+			if (await this.ensureGitRepo(root, { force })) await run("git add .", {
+				alias: "staging generated files",
+				root
+			});
+		}
+		if (!args) return;
+		run.end();
+		const projectName = args || ".";
+		const pmRun = pmName === "npm" ? "npm run" : pmName;
+		const c = this.colors;
+		this.log.info("");
+		this.log.info(`  ${c.set("GREEN", "✓")} Project ready!`);
+		this.log.info("");
+		this.log.info(`  ${c.set("GREY_DARK", "$")} cd ${c.set("CYAN", projectName)}`);
+		this.log.info(`  ${c.set("GREY_DARK", "$")} ${c.set("CYAN", `${pmRun} dev`)}`);
+		if (adminEmail) {
+			this.log.info("");
+			this.log.info(`  Admin email: ${c.set("GREEN", adminEmail)}`);
+			this.log.info(`  ${c.set("GREY_DARK", "(from git config, change in src/api/AppSecurity.ts)")}`);
+		}
+		this.log.info("");
+	}
+	/**
 	* Write a file, optionally overriding if it exists.
 	*/
 	async ensureFile(root, relativePath, content, force) {
@@ -1578,6 +1761,7 @@ var BuildClientTask = class extends BuildTask {
 		const plugins = [];
 		const viteReact = await this.viteUtils.importViteReact();
 		if (viteReact) plugins.push(viteReact());
+		plugins.push(this.viteUtils.createTsconfigPathsPlugin());
 		plugins.push(this.viteUtils.createSsrPreloadPlugin());
 		if (opts.stats) plugins.push(analyzer({ analyzerMode: "static" }));
 		const logger = opts.silent ? this.viteUtils.createBufferedLogger() : void 0;
@@ -1595,7 +1779,8 @@ var BuildClientTask = class extends BuildTask {
 					output: {
 						entryFileNames: "entry.[hash].js",
 						chunkFileNames: "chunk.[hash].js",
-						assetFileNames: "asset.[hash][extname]"
+						assetFileNames: "asset.[hash][extname]",
+						experimentalMinChunkSize: 5e3
 					}
 				}
 			},
@@ -2082,6 +2267,7 @@ var BuildServerTask = class extends BuildTask {
 		const plugins = [];
 		const viteReact = await this.viteUtils.importViteReact();
 		if (viteReact && opts.clientDir) plugins.push(viteReact());
+		plugins.push(this.viteUtils.createTsconfigPathsPlugin());
 		plugins.push(this.viteUtils.createSsrPreloadPlugin());
 		if (opts.stats) plugins.push(analyzer({ analyzerMode: "static" }));
 		const logger = opts.silent ? this.viteUtils.createBufferedLogger() : void 0;
@@ -2117,7 +2303,8 @@ var BuildServerTask = class extends BuildTask {
 						entryFileNames: "[hash].js",
 						chunkFileNames: "[hash].js",
 						assetFileNames: "[hash][extname]",
-						format: "esm"
+						format: "esm",
+						experimentalMinChunkSize: 1e4
 					}
 				}
 			},
@@ -2717,8 +2904,45 @@ var DbCommand = class {
 			title: "path",
 			description: "Path to the Alepha server entry file"
 		})),
-		flags: drizzleCommandFlags,
+		flags: t.extend(drizzleCommandFlags, { dryRun: t.optional(t.boolean({ description: "Preview SQL statements without executing them" })) }),
 		handler: async ({ root, args, flags }) => {
+			if (flags.dryRun) {
+				const entry = await this.entryProvider.getAppEntry(root);
+				const alepha = await this.utils.loadAlephaFromServerEntryFile({
+					mode: "development",
+					entry
+				});
+				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;
+					if (accepted.has(providerName)) continue;
+					accepted.add(providerName);
+					if (flags.provider && flags.provider !== providerName) continue;
+					this.log.info("");
+					this.log.info(`Dry run for '${providerName}' (${provider.dialect}) ...`);
+					await provider.connect();
+					try {
+						const result = await drizzleKitProvider.dryRunPush(provider);
+						if (result.statements.length === 0) this.log.info("No changes detected.");
+						else {
+							if (result.hasDataLoss) {
+								this.log.warn("WARNING: These changes would cause data loss!");
+								for (const warning of result.warnings) this.log.warn(`  ${warning}`);
+							}
+							this.log.info("");
+							this.log.info(`${result.statements.length} statement(s) would be executed:`);
+							this.log.info("");
+							for (const stmt of result.statements) this.log.info(stmt);
+						}
+					} finally {
+						await provider.close();
+					}
+				}
+				return;
+			}
 			await this.runDrizzleKitCommand({
 				root,
 				args,
@@ -2921,24 +3145,6 @@ ${models.map((it) => `export const ${it} = models["${it}"];`).join("\n")}
 	}
 };
 
-//#endregion
-//#region ../../src/cli/core/atoms/devOptions.ts
-/**
-* Dev options atom for CLI dev command.
-*
-* Defines the available dev configuration options with their defaults.
-* Options can be overridden via alepha.config.ts or CLI flags.
-*/
-const devOptions = $atom({
-	name: "alepha.cli.dev.options",
-	description: "Dev configuration options",
-	schema: t.object({
-		noDevtools: t.optional(t.boolean({ default: false })),
-		noViteReactPlugin: t.optional(t.boolean({ default: false }))
-	}),
-	default: {}
-});
-
 //#endregion
 //#region ../../src/cli/core/providers/ViteDevServerProvider.ts
 /**
@@ -2969,6 +3175,7 @@ var ViteDevServerProvider = class {
 	reloadDebounceTimer = null;
 	isReloading = false;
 	needsBrowserReload = false;
+	currentReloadPromise = null;
 	/**
 	* Initialize the dev server and load Alepha.
 	*/
@@ -3025,6 +3232,7 @@ var ViteDevServerProvider = class {
 		const viteReact = await this.viteUtils.importViteReact();
 		const plugins = [];
 		if (viteReact && !this.options.noViteReactPlugin) plugins.push(viteReact());
+		plugins.push(this.viteUtils.createTsconfigPathsPlugin());
 		plugins.push(this.viteUtils.createSsrPreloadPlugin());
 		plugins.push(this.createAlephaPlugin());
 		let port;
@@ -3096,6 +3304,9 @@ var ViteDevServerProvider = class {
 						next();
 					}
 				});
+				server.hot.on("connection", () => {
+					if (this.currentError) setTimeout(() => this.sendErrorOverlay(this.currentError), 50);
+				});
 				return () => {
 					server.middlewares.use(async (req, res, next) => {
 						const url = req.url || "/";
@@ -3104,6 +3315,11 @@ var ViteDevServerProvider = class {
 							return;
 						}
 						if (this.hasError && !this.alepha) {
+							if (req.headers.accept?.includes("text/html")) {
+								res.writeHead(200, { "content-type": "text/html" });
+								res.end("<!DOCTYPE html><html><head><script type=\"module\" src=\"/@vite/client\"><\/script></head><body></body></html>");
+								return;
+							}
 							next();
 							return;
 						}
@@ -3131,7 +3347,11 @@ var ViteDevServerProvider = class {
 				if (firstModule && !firstModule._ssrModule) return;
 				this.changedFiles.add(ctx.file);
 				if (/\.(tsx|jsx)$/.test(ctx.file)) {
-					this.scheduleReload();
+					if (this.reloadDebounceTimer) {
+						clearTimeout(this.reloadDebounceTimer);
+						this.reloadDebounceTimer = null;
+					}
+					await this.performReload();
 					return;
 				}
 				this.needsBrowserReload = true;
@@ -3174,13 +3394,24 @@ var ViteDevServerProvider = class {
 		}, 100);
 	}
 	/**
-	* Perform the actual reload after debounce.
+	* Perform the actual reload.
+	* Returns a promise that callers can await to know when reload is done.
+	* If a reload is already in progress, returns that promise.
+	*/
+	performReload() {
+		if (this.changedFiles.size === 0) return this.currentReloadPromise ?? Promise.resolve();
+		if (this.isReloading) return this.currentReloadPromise ?? Promise.resolve();
+		this.currentReloadPromise = this.executeReload();
+		return this.currentReloadPromise;
+	}
+	/**
+	* Execute the reload work.
 	*/
-	async performReload() {
-		if (this.isReloading || this.changedFiles.size === 0) return;
+	async executeReload() {
 		this.isReloading = true;
 		const filesToInvalidate = new Set(this.changedFiles);
 		const sendReload = this.needsBrowserReload;
+		const wasInError = this.hasError;
 		this.changedFiles.clear();
 		this.needsBrowserReload = false;
 		console.log();
@@ -3190,7 +3421,7 @@ var ViteDevServerProvider = class {
 			await this.loadAlepha(false, filesToInvalidate);
 			await this.alepha?.start();
 			this.currentError = null;
-			if (sendReload) this.sendBrowserReload();
+			if (sendReload || wasInError) this.sendBrowserReload();
 		} catch (err) {
 			this.hasError = true;
 			this.currentError = err instanceof Error ? err : new Error(String(err));
@@ -3199,6 +3430,7 @@ var ViteDevServerProvider = class {
 			this.sendErrorOverlay(this.currentError);
 		} finally {
 			this.isReloading = false;
+			this.currentReloadPromise = null;
 			if (this.changedFiles.size > 0) this.scheduleReload();
 		}
 	}
@@ -3331,6 +3563,8 @@ var ViteDevServerProvider = class {
 					this.waitingForRetry = false;
 					this.currentError = null;
 					this.server.watcher.off("change", onFileChange);
+					this.server.watcher.off("add", onFileChange);
+					this.sendBrowserReload();
 					resolve(alepha);
 				} catch (err) {
 					this.hasError = true;
@@ -3341,6 +3575,7 @@ var ViteDevServerProvider = class {
 				}
 			};
 			this.server.watcher.on("change", onFileChange);
+			this.server.watcher.on("add", onFileChange);
 		});
 	}
 	/**
@@ -3378,12 +3613,10 @@ var ViteDevServerProvider = class {
 	/**
 	* Log a formatted error with stack trace.
 	*/
-	logError(title, err) {
+	logError(title, _err) {
 		const c = this.colors;
 		console.log();
 		console.log(c.set("RED", `  ✗ ${title}`));
-		this.logErrorWithCause(err);
-		console.log();
 		console.log(c.set("GREY_DARK", "    Waiting for file changes to retry..."));
 		console.log();
 	}
@@ -3766,12 +3999,7 @@ var GenCommand = class {
 //#endregion
 //#region ../../src/cli/core/commands/init.ts
 var InitCommand = class {
-	log = $logger();
-	colors = $inject(ConsoleColorProvider);
-	utils = $inject(AlephaCliUtils);
-	pm = $inject(PackageManagerUtils);
 	scaffolder = $inject(ProjectScaffolder);
-	fs = $inject(FileSystemProvider);
 	/**
 	* Ensure the project has the necessary Alepha configuration files.
 	* Add the correct dependencies to package.json and install them.
@@ -3807,100 +4035,12 @@ var InitCommand = class {
 			}))
 		}),
 		handler: async ({ run, flags, root, args }) => {
-			if (args) {
-				root = this.fs.join(root, args);
-				await this.fs.mkdir(root, { force: true });
-			}
-			if (flags.admin) flags.auth = true;
-			if (flags.auth) {
-				flags.api = true;
-				flags.ui = true;
-			}
-			if (flags.ui) flags.react = true;
-			if (flags.tailwind) flags.react = true;
-			if ((flags.admin || flags.auth || flags.api || flags.ui || flags.react || flags.tailwind) && !flags.force) {
-				if ((await this.fs.ls(root)).filter((f) => f !== "package.json").length > 0) throw new AlephaError(`Target directory is not empty (${root}). Use --force to overwrite existing files.`);
-			}
-			const workspace = await this.pm.getWorkspaceContext(root);
-			let agentType = false;
-			if (!workspace.isPackage) agentType = await this.utils.isInstalledAsync("claude") ? "claude" : "agents";
-			const isExpo = await this.pm.hasExpo(root);
-			const adminEmail = flags.auth ? await this.utils.getGitEmail() : void 0;
-			const force = !!flags.force;
-			await run({
-				name: "ensuring configuration files",
-				handler: async () => {
-					await this.scaffolder.ensureConfig(root, {
-						force,
-						packageJson: {
-							...flags,
-							isPackage: workspace.isPackage
-						},
-						tsconfigJson: !workspace.config.tsconfigJson,
-						biomeJson: !workspace.config.biomeJson,
-						editorconfig: !workspace.config.editorconfig,
-						agentMd: agentType ? { type: agentType } : false
-					});
-					await this.scaffolder.ensureAlephaConfig(root, { force });
-					await this.scaffolder.ensureMainServerTs(root, {
-						api: !!flags.api,
-						react: !!flags.react && !isExpo,
-						force
-					});
-					if (flags.api) await this.scaffolder.ensureApiProject(root, {
-						auth: !!flags.auth,
-						adminEmail,
-						force
-					});
-					if (flags.react && !isExpo) await this.scaffolder.ensureWebProject(root, {
-						api: !!flags.api,
-						ui: !!flags.ui,
-						auth: !!flags.auth,
-						admin: !!flags.admin,
-						tailwind: !!flags.tailwind,
-						force
-					});
-				}
-			});
-			const pmName = await this.pm.getPackageManager(workspace.workspaceRoot ?? root, flags.pm ?? workspace.packageManager ?? void 0);
-			if (!workspace.isPackage) if (pmName === "yarn") {
-				await this.pm.ensureYarn(root);
-				await run("yarn set version stable", { root });
-			} else if (pmName === "bun") await this.pm.ensureBun(root);
-			else if (pmName === "pnpm") await this.pm.ensurePnpm(root);
-			else await this.pm.ensureNpm(root);
-			const installRoot = workspace.workspaceRoot ?? root;
-			await run(`${pmName} install`, {
-				alias: `installing dependencies with ${pmName}`,
-				root: installRoot
-			});
-			if (flags.test) await this.scaffolder.ensureTestDir(root);
-			await run(`${pmName} run lint`, {
-				alias: "running linter",
-				root: installRoot
+			await this.scaffolder.init({
+				run,
+				flags,
+				root,
+				args
 			});
-			if (!workspace.isPackage) {
-				if (await this.scaffolder.ensureGitRepo(root, { force })) await run("git add .", {
-					alias: "staging generated files",
-					root
-				});
-			}
-			if (!args) return;
-			run.end();
-			const projectName = args || ".";
-			const pmRun = pmName === "npm" ? "npm run" : pmName;
-			const c = this.colors;
-			this.log.info("");
-			this.log.info(`  ${c.set("GREEN", "✓")} Project ready!`);
-			this.log.info("");
-			this.log.info(`  ${c.set("GREY_DARK", "$")} cd ${c.set("CYAN", projectName)}`);
-			this.log.info(`  ${c.set("GREY_DARK", "$")} ${c.set("CYAN", `${pmRun} dev`)}`);
-			if (adminEmail) {
-				this.log.info("");
-				this.log.info(`  Admin email: ${c.set("GREEN", adminEmail)}`);
-				this.log.info(`  ${c.set("GREY_DARK", "(from git config, change in src/api/AppSecurity.ts)")}`);
-			}
-			this.log.info("");
 		}
 	});
 };
@@ -4062,39 +4202,38 @@ var AlephaCliExtensionProvider = class {
 };
 
 //#endregion
-//#region ../../src/cli/core/defineConfig.ts
-const configProcessors = [];
+//#region ../../src/cli/core/index.ts
 /**
-* Register a processor that runs during config resolution.
-*
-* Used by submodules (e.g. platform) to handle their own config keys
-* without core needing to know about them.
+* Services, providers, and build tasks — no commands.
+* Use this module when you need CLI utilities without registering commands.
 */
-function registerConfigProcessor(processor) {
-	configProcessors.push(processor);
-}
-const defineConfig = (runConfig) => {
-	return (alepha) => {
-		const config = typeof runConfig === "function" ? runConfig(alepha) : runConfig;
-		if (config.services) for (const it of config.services) alepha.with(it);
-		if (config.env) for (const [key, value] of Object.entries(config.env)) process.env[key] = String(value);
-		if (config.build) alepha.set(buildOptions, config.build);
-		if (config.dev) alepha.set(devOptions, config.dev);
-		if (config.entry) alepha.set(appEntryOptions, config.entry);
-		for (const processor of configProcessors) processor(alepha, config);
-		return { ...config.commands };
-	};
-};
-
-//#endregion
-//#region ../../src/cli/core/index.ts
-const AlephaCli = $module({
-	name: "alepha.cli",
+const AlephaCliServices = $module({
+	name: "alepha.cli.services",
 	services: [
 		AlephaCliUtils,
 		PackageManagerUtils,
 		ViteUtils,
 		ProjectScaffolder,
+		AppEntryProvider,
+		GitMessageParser,
+		GitProvider,
+		ViteDevServerProvider,
+		ViteBuildProvider
+	]
+});
+/**
+* Full CLI module — all services and commands.
+*/
+const AlephaCli = $module({
+	name: "alepha.cli",
+	atoms: [
+		appEntryOptions,
+		buildOptions,
+		changelogOptions,
+		devOptions
+	],
+	services: [
+		AlephaCliExtensionProvider,
 		BuildCommand,
 		CleanCommand,
 		DbCommand,
@@ -4106,12 +4245,6 @@ const AlephaCli = $module({
 		TypecheckCommand,
 		VerifyCommand,
 		GenCommand,
-		AlephaCliExtensionProvider,
-		AppEntryProvider,
-		GitMessageParser,
-		GitProvider,
-		ViteDevServerProvider,
-		ViteBuildProvider,
 		BuildAssetsTask,
 		BuildClientTask,
 		BuildCloudflareTask,
@@ -4126,5 +4259,5 @@ const AlephaCli = $module({
 });
 
 //#endregion
-export { AlephaCli, AlephaCliExtensionProvider, AlephaCliUtils, AppEntryProvider, BuildAssetsTask, BuildClientTask, BuildCloudflareTask, BuildCommand, BuildCompressTask, BuildDockerTask, BuildPrerenderTask, BuildServerTask, BuildSitemapTask, BuildStaticTask, BuildTask, BuildVercelTask, ChangelogCommand, CleanCommand, DEFAULT_IGNORE, DbCommand, DevCommand, GitMessageParser, GitProvider, InitCommand, LintCommand, OpenApiCommand, PackageManagerUtils, RootCommand, TestCommand, TypecheckCommand, VerifyCommand, ViteBuildProvider, ViteDevServerProvider, ViteUtils, appEntryOptions, buildOptions, changelogOptions, defineConfig, devOptions, registerConfigProcessor, version };
+export { AlephaCli, AlephaCliExtensionProvider, AlephaCliServices, AlephaCliUtils, AppEntryProvider, BuildAssetsTask, BuildClientTask, BuildCloudflareTask, BuildCommand, BuildCompressTask, BuildDockerTask, BuildPrerenderTask, BuildServerTask, BuildSitemapTask, BuildStaticTask, BuildTask, BuildVercelTask, ChangelogCommand, CleanCommand, DEFAULT_IGNORE, DbCommand, DevCommand, GitMessageParser, GitProvider, InitCommand, LintCommand, OpenApiCommand, PackageManagerUtils, ProjectScaffolder, RootCommand, TestCommand, TypecheckCommand, VerifyCommand, ViteBuildProvider, ViteDevServerProvider, ViteUtils, appEntryOptions, buildOptions, changelogOptions, devOptions, version };
 //# sourceMappingURL=index.js.map