alepha 0.19.1 → 0.19.3

package/dist/cli/core/index.js

@@ -1,11 +1,11 @@
 import { createRequire } from "node:module";
-import { $atom, $hook, $inject, $module, $use, Alepha, AlephaError, __alephaRef, t } from "alepha";
+import { $atom, $hook, $inject, $module, $state, Alepha, AlephaError, __alephaRef, t } from "alepha";
 import { $command, CliProvider, EnvUtils, Runner } from "alepha/command";
 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 { readFile } from "node:fs/promises";
+import { readFile, readdir, stat } 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";
@@ -13,7 +13,7 @@ import { KV_DEFAULT_BINDING } from "alepha/cache";
 import { QUEUE_DEFAULT_BINDING } from "alepha/queue";
 import { promisify } from "node:util";
 import { brotliCompress, gzip } from "node:zlib";
-import { exec } from "node:child_process";
+import { exec, spawn } from "node:child_process";
 import { ServerSwaggerProvider } from "alepha/server/swagger";
 //#region ../../src/cli/core/atoms/appEntryOptions.ts
 const appEntryOptions = $atom({
@@ -89,10 +89,7 @@ const buildOptions = $atom({
 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 }))
-	}),
+	schema: t.object({ noViteReactPlugin: t.optional(t.boolean({ default: false })) }),
 	default: {}
 });
 //#endregion
@@ -104,7 +101,7 @@ const devOptions = $atom({
 */
 var AppEntryProvider = class {
 	fs = $inject(FileSystemProvider);
-	options = $use(appEntryOptions);
+	options = $state(appEntryOptions);
 	serverEntries = [
 		"main.server.ts",
 		"main.server.tsx",
@@ -589,13 +586,13 @@ var AlephaCliUtils = class {
 //#endregion
 //#region ../../package.json
 var devDependencies = {
-	"@biomejs/biome": "^2.4.8",
-	"@electric-sql/pglite": "^0.4.0",
-	"@faker-js/faker": "^10.3.0",
+	"@biomejs/biome": "^2.4.10",
+	"@electric-sql/pglite": "^0.4.3",
+	"@faker-js/faker": "^10.4.0",
 	"@testing-library/dom": "^10.4.1",
 	"@testing-library/react": "^16.3.2",
 	"@types/bun": "^1.3.11",
-	"@types/node": "^25.5.0",
+	"@types/node": "^25.5.2",
 	"@types/nodemailer": "^7.0.11",
 	"@types/react": "^19.2.14",
 	"@types/react-dom": "^19.2.3",
@@ -603,15 +600,16 @@ var devDependencies = {
 	"cron-schedule": "^6.0.0",
 	"drizzle-kit": "^0.31.10",
 	"jose": "^6.2.2",
-	"jsdom": "^29.0.0",
-	"nodemailer": "^8.0.3",
+	"jsdom": "^29.0.1",
+	"nodemailer": "^8.0.4",
 	"openid-client": "^6.8.2",
 	"prom-client": "^15.1.3",
 	"react": "^19.2.4",
 	"react-dom": "^19.2.4",
 	"swagger-ui-dist": "^5.32.1",
-	"tsdown": "^0.21.4",
-	"vitest": "^4.1.0"
+	"tsdown": "^0.21.7",
+	"vite": "^8.0.3",
+	"vitest": "^4.1.2"
 };
 const version = JSON.parse(readFileSync(new URL("../../../package.json", import.meta.url), "utf-8")).version;
 //#endregion
@@ -864,7 +862,8 @@ var PackageManagerUtils = class {
 	generatePackageJsonContent(modes) {
 		const alephaDeps = devDependencies;
 		const dependencies = { alepha: `^${version}` };
-		const devDependencies$1 = { "drizzle-kit": alephaDeps["drizzle-kit"] };
+		const devDependencies$1 = { vite: alephaDeps.vite };
+		if (!(modes.react && !modes.ui)) devDependencies$1["drizzle-kit"] = alephaDeps["drizzle-kit"];
 		if (!modes.isPackage) {
 			devDependencies$1["@biomejs/biome"] = alephaDeps["@biomejs/biome"];
 			if (modes.test) devDependencies$1.vitest = alephaDeps.vitest;
@@ -907,8 +906,12 @@ var PackageManagerUtils = class {
 const cliAssets = { logo: join(join(fileURLToPath(import.meta.url), "../../../.."), "assets/logo.svg") };
 //#endregion
 //#region ../../src/cli/core/templates/agentMd.ts
-const agentMd = (type) => {
-	return `${type === "claude" ? `# CLAUDE.md` : `# AGENTS.md`}
+const agentMd = (options) => {
+	const header = options.type === "claude" ? `# CLAUDE.md` : `# AGENTS.md`;
+	const docs = [`- Framework source: \`node_modules/alepha/src/\``];
+	if (options.ui) docs.push(`- UI components: \`node_modules/@alepha/ui/src/\``);
+	docs.push(`- Docs: https://alepha.dev/llms.txt`);
+	return `${header}
 
 This is an **Alepha** project.
 
@@ -930,9 +933,7 @@ alepha build     # Build
 
 ## Documentation
 
-- Framework source: \`node_modules/alepha/src/\`
-- UI components: \`node_modules/@alepha/ui/src/\`
-- Docs: https://alepha.dev/llms.txt
+${docs.join("\n")}
 `.trim();
 };
 //#endregion
@@ -956,12 +957,6 @@ export default defineConfig({
   //   runtime: "node",
   // },
   //
-  // platform: {
-  //   environments: {
-  //     production: { adapter: "cloudflare" },
-  //   },
-  // },
-  //
   // env: {
   //   VITE_BUILD_DATE: new Date().toISOString(),
   //   VITE_VERSION: pkg.version,
@@ -1275,13 +1270,45 @@ export default defineConfig({
 `;
 };
 //#endregion
+//#region ../../src/cli/core/templates/webAdminDashboardTsx.ts
+const webAdminDashboardTsx = () => {
+	return `import { Flex, Text } from "@alepha/ui";
+
+const AdminDashboard = () => {
+  return (
+    <Flex direction="column" align="center" justify="center" mih="60vh" gap="md">
+      <Text size="xl" fw={600}>
+        Admin Panel
+      </Text>
+      <Text c="dimmed">Welcome to the admin panel.</Text>
+    </Flex>
+  );
+};
+
+export default AdminDashboard;
+`;
+};
+//#endregion
 //#region ../../src/cli/core/templates/webAppRouterTs.ts
 const webAppRouterTs = (options) => {
 	const imports = [];
 	const classMembers = [];
 	if (options.ui) imports.push("import { $ui } from \"@alepha/ui\";");
 	if (options.auth) imports.push("import { $uiAuth } from \"@alepha/ui/auth\";");
-	if (options.admin) imports.push("import { $uiAdmin } from \"@alepha/ui/admin\";");
+	if (options.admin) {
+		imports.push("import { $uiAdmin } from \"@alepha/ui/admin\";");
+		imports.push("import { AdminUserRouter } from \"@alepha/ui/admin-users\";");
+		imports.push("import { AdminSessionRouter } from \"@alepha/ui/admin-sessions\";");
+		imports.push("import { AdminAuditRouter } from \"@alepha/ui/admin-audits\";");
+		imports.push("import { AdminFileRouter } from \"@alepha/ui/admin-files\";");
+		imports.push("import { AdminParameterRouter } from \"@alepha/ui/admin-parameters\";");
+		imports.push("import { AdminJobRouter } from \"@alepha/ui/admin-jobs\";");
+		imports.push("import { AdminApiKeyRouter } from \"@alepha/ui/admin-keys\";");
+		imports.push("import { AdminNotificationRouter } from \"@alepha/ui/admin-notifications\";");
+		imports.push("import { AdminBillingRouter } from \"@alepha/ui/admin-billing\";");
+		imports.push("import { $inject } from \"alepha\";");
+		imports.push("import { IconLayoutDashboard, IconLockPassword, IconCreditCard } from \"@tabler/icons-react\";");
+	}
 	imports.push("import { $page } from \"alepha/react/router\";");
 	if (options.api) {
 		imports.push("import { $client } from \"alepha/server/links\";");
@@ -1291,7 +1318,69 @@ const webAppRouterTs = (options) => {
 	if (options.ui) {
 		classMembers.push("  ui = $ui();");
 		if (options.auth) classMembers.push("  uiAuth = $uiAuth();");
-		if (options.admin) classMembers.push("  uiAdmin = $uiAdmin();");
+		if (options.admin) classMembers.push(`  // ── Admin Domain Routers ──────────────────────────
+  protected users = $inject(AdminUserRouter);
+  protected sessions = $inject(AdminSessionRouter);
+  protected audits = $inject(AdminAuditRouter);
+  protected files = $inject(AdminFileRouter);
+  protected parameters = $inject(AdminParameterRouter);
+  protected jobs = $inject(AdminJobRouter);
+  protected apiKeys = $inject(AdminApiKeyRouter);
+  protected notifications = $inject(AdminNotificationRouter);
+  protected billing = $inject(AdminBillingRouter);
+
+  // ── Admin Panel ─────────────────────────────────
+  admin = $uiAdmin({
+    pages: [
+      this.users.adminUsers,
+      this.sessions.adminSessions,
+      this.audits.adminAudits,
+      this.files.adminFiles,
+      this.parameters.adminParameters,
+      this.jobs.adminJobs,
+      this.apiKeys.adminApiKeys,
+      this.notifications.adminNotifications,
+      this.billing.adminBilling,
+    ],
+    sidebarItems: [
+      {
+        label: "Security",
+        children: [
+          { label: "Identity", icon: IconLockPassword, children: [
+            this.users.adminUsers,
+            this.sessions.adminSessions,
+            this.apiKeys.adminApiKeys,
+          ]},
+          this.audits.adminAudits,
+        ],
+      },
+      {
+        label: "System",
+        children: [
+          this.files.adminFiles,
+          this.jobs.adminJobs,
+          this.notifications.adminNotifications,
+          this.parameters.adminParameters,
+        ],
+      },
+      {
+        label: "Commerce",
+        icon: IconCreditCard,
+        children: [
+          this.billing.adminBilling,
+        ],
+      },
+    ],
+  });
+
+  // ── Admin Dashboard ─────────────────────────────
+  adminDashboard = $page({
+    parent: this.admin.adminLayout,
+    path: "/",
+    label: "Dashboard",
+    icon: IconLayoutDashboard,
+    lazy: () => import("./components/AdminDashboard.tsx"),
+  });`);
 		classMembers.push(`  layout = $page({
       parent: this.ui.root,
       children: () => [this.home],
@@ -1432,7 +1521,7 @@ var ProjectScaffolder = class {
 	}
 	async ensureAgentMd(root, options) {
 		const filename = options.type === "claude" ? "CLAUDE.md" : "AGENTS.md";
-		await this.ensureFile(root, filename, agentMd(options.type), options.force);
+		await this.ensureFile(root, filename, agentMd(options), options.force);
 	}
 	/**
 	* Ensure alepha.config.ts exists with documented options.
@@ -1497,6 +1586,7 @@ var ProjectScaffolder = class {
 			admin: opts.admin
 		}), opts.force);
 		await this.ensureFile(root, "src/web/components/Home.tsx", webHomeComponentTsx({ api: opts.api }), opts.force);
+		if (opts.admin) await this.ensureFile(root, "src/web/components/AdminDashboard.tsx", webAdminDashboardTsx(), opts.force);
 		await this.ensureFile(root, "src/main.browser.ts", mainBrowserTs(), opts.force);
 	}
 	/**
@@ -1520,21 +1610,20 @@ var ProjectScaffolder = class {
 			root = this.fs.join(root, args);
 			await this.fs.mkdir(root, { force: true });
 		}
-		if (flags.admin) flags.auth = true;
-		if (flags.auth) {
+		if (flags.saas) {
 			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 ((flags.saas || 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 adminEmail = flags.saas ? await this.utils.getGitEmail() : void 0;
 		const force = !!flags.force;
 		await run({
 			name: "ensuring configuration files",
@@ -1548,7 +1637,10 @@ var ProjectScaffolder = class {
 					tsconfigJson: !workspace.config.tsconfigJson,
 					biomeJson: true,
 					editorconfig: !workspace.config.editorconfig,
-					agentMd: agentType ? { type: agentType } : false
+					agentMd: agentType ? {
+						type: agentType,
+						ui: !!flags.ui
+					} : false
 				});
 				await this.ensureAlephaConfig(root, { force });
 				await this.ensureMainServerTs(root, {
@@ -1557,15 +1649,15 @@ var ProjectScaffolder = class {
 					force
 				});
 				if (flags.api) await this.ensureApiProject(root, {
-					auth: !!flags.auth,
+					auth: !!flags.saas,
 					adminEmail,
 					force
 				});
 				if (flags.react && !isExpo) await this.ensureWebProject(root, {
 					api: !!flags.api,
 					ui: !!flags.ui,
-					auth: !!flags.auth,
-					admin: !!flags.admin,
+					auth: !!flags.saas,
+					admin: !!flags.saas,
 					tailwind: !!flags.tailwind,
 					force
 				});
@@ -1722,6 +1814,12 @@ var BuildClientTask = class extends BuildTask {
 			mode: "production",
 			logLevel: opts.silent ? "silent" : void 0,
 			define: { "process.env.NODE_ENV": "\"production\"" },
+			resolve: { dedupe: [
+				"react",
+				"react-dom",
+				"react/jsx-runtime",
+				"react/jsx-dev-runtime"
+			] },
 			publicDir: "public",
 			build: {
 				outDir: opts.dist,
@@ -2193,6 +2291,7 @@ var BuildServerTask = class extends BuildTask {
 			name: "build server",
 			handler: async () => {
 				await this.buildServer({
+					root: ctx.root,
 					entry: ctx.entry.server,
 					distDir,
 					clientDir: clientBuilt ? publicDir : void 0,
@@ -2225,6 +2324,12 @@ var BuildServerTask = class extends BuildTask {
 			mode: "production",
 			logLevel: opts.silent ? "silent" : void 0,
 			define: { "process.env.NODE_ENV": "\"production\"" },
+			resolve: { dedupe: [
+				"react",
+				"react-dom",
+				"react/jsx-runtime",
+				"react/jsx-dev-runtime"
+			] },
 			publicDir: false,
 			ssr: {
 				noExternal: true,
@@ -2267,7 +2372,7 @@ var BuildServerTask = class extends BuildTask {
 		const externals = [];
 		if (Array.isArray(resolvedConfig?.ssr?.external)) externals.push(...resolvedConfig.ssr.external);
 		await this.generateExternals(opts.distDir, externals);
-		const entryFile = this.extractEntryFromBundle(opts.entry, result);
+		const entryFile = this.extractEntryFromBundle(opts.root, opts.entry, result);
 		let manifest = "";
 		let manifestData;
 		if (opts.clientDir) {
@@ -2340,8 +2445,8 @@ var BuildServerTask = class extends BuildTask {
 		};
 		return stripped;
 	}
-	extractEntryFromBundle(entry, result) {
-		const entryFilePath = isAbsolute(entry) ? entry : join(process.cwd(), entry);
+	extractEntryFromBundle(root, entry, result) {
+		const entryFilePath = isAbsolute(entry) ? entry : join(root, entry);
 		const normalizedEntryPath = entryFilePath.replace(/\\/g, "/");
 		const entryFile = (Array.isArray(result) ? result[0] : result).output.find((it) => "facadeModuleId" in it && it.facadeModuleId === normalizedEntryPath)?.fileName;
 		if (!entryFile) throw new AlephaError(`Could not find the entry file "${entryFilePath}" in the build output. Please check your entry file and try again.`);
@@ -2608,7 +2713,7 @@ var BuildCommand = class {
 	scaffolder = $inject(ProjectScaffolder);
 	boot = $inject(AppEntryProvider);
 	viteBuildProvider = $inject(ViteBuildProvider);
-	options = $use(buildOptions);
+	options = $state(buildOptions);
 	/**
 	* Build pipeline: tasks run sequentially in this order.
 	* Each task self-guards (checks target, hasClient, etc.).
@@ -3114,7 +3219,30 @@ var ViteDevServerProvider = class {
 	isReloading = false;
 	needsBrowserReload = false;
 	currentReloadPromise = null;
-	devtoolsAssetsPath;
+	extraVitePlugins = [];
+	alephaLoadedHooks = [];
+	/**
+	* Register an additional Vite plugin.
+	* Must be called before init().
+	*/
+	addVitePlugin(plugin) {
+		this.extraVitePlugins.push(plugin);
+	}
+	/**
+	* Register a hook called after Alepha is loaded/reloaded.
+	*/
+	onAlephaLoaded(hook) {
+		this.alephaLoadedHooks.push(hook);
+	}
+	/**
+	* Trigger a full Alepha reload programmatically.
+	*/
+	reload() {
+		this.hasError = true;
+		this.needsBrowserReload = true;
+		this.changedFiles.add("__manual_reload__");
+		this.scheduleReload();
+	}
 	/**
 	* Initialize the dev server and load Alepha.
 	*/
@@ -3138,10 +3266,8 @@ var ViteDevServerProvider = class {
 		try {
 			await this.alepha?.start();
 			await this.listen();
-			console.log("");
-			this.server.printUrls();
-			this.server.bindCLIShortcuts({ print: true });
-			console.log("");
+			const url = `http://localhost:${this.server.config.server.port ?? 5173}/`;
+			(this.alepha?.log ?? this.log).info(`Listening on ${this.colors.set("CYAN", url)}`);
 		} catch (err) {
 			this.hasError = true;
 			this.currentError = err instanceof Error ? err : new Error(String(err));
@@ -3173,6 +3299,7 @@ var ViteDevServerProvider = class {
 		if (viteReact && !this.options.noViteReactPlugin) plugins.push(viteReact());
 		plugins.push(this.viteUtils.createTsconfigPathsPlugin());
 		plugins.push(this.viteUtils.createSsrPreloadPlugin());
+		plugins.push(...this.extraVitePlugins);
 		plugins.push(this.createAlephaPlugin());
 		let port;
 		if (process.env.SERVER_PORT) port = Number(process.env.SERVER_PORT);
@@ -3184,6 +3311,12 @@ var ViteDevServerProvider = class {
 			root: this.options.root,
 			plugins,
 			appType: "custom",
+			resolve: { dedupe: [
+				"react",
+				"react-dom",
+				"react/jsx-runtime",
+				"react/jsx-dev-runtime"
+			] },
 			server: { port },
 			optimizeDeps: { entries: [...this.options.entry.browser ? [this.options.entry.browser] : []] }
 		});
@@ -3230,31 +3363,23 @@ var ViteDevServerProvider = class {
 		return {
 			name: "alepha",
 			configureServer: (server) => {
-				if (!this.options.noDevtools) try {
-					this.devtoolsAssetsPath = join(dirname(createRequire(import.meta.url).resolve("@alepha/devtools/package.json")), "assets/ui");
-					process.env.VITE_ALEPHA_DEVTOOLS = "true";
-				} catch {
-					this.log.debug("@alepha/devtools not installed, skipping devtools");
-				}
-				if (this.devtoolsAssetsPath) {
-					const assetsPath = this.devtoolsAssetsPath;
-					server.middlewares.use(async (req, res, next) => {
-						if (!(req.url || "/").startsWith("/__devtools") || !req.headers.accept?.includes("text/html")) return next();
-						const indexPath = join(assetsPath, "index.html");
-						try {
-							let html = await readFile(indexPath, "utf-8");
-							html = html.replace("<head>", `<head><script type="module" src="/@vite/client"><\/script>`);
-							res.writeHead(200, { "content-type": "text/html" });
-							res.end(html);
-						} catch (err) {
-							this.log.error("Failed to serve devtools UI", err);
-							next();
-						}
-					});
-				}
 				server.hot.on("connection", () => {
 					if (this.currentError) setTimeout(() => this.sendErrorOverlay(this.currentError), 50);
 				});
+				server.middlewares.use(async (req, res, next) => {
+					if (req.url !== "/__alepha/ready") {
+						next();
+						return;
+					}
+					if (this.currentReloadPromise) await this.currentReloadPromise;
+					if (this.alepha?.isReady()) {
+						res.writeHead(200, { "content-type": "text/plain" });
+						res.end("ok");
+					} else {
+						res.writeHead(503, { "content-type": "text/plain" });
+						res.end("not ready");
+					}
+				});
 				return () => {
 					server.middlewares.use(async (req, res, next) => {
 						const url = req.url || "/";
@@ -3262,6 +3387,7 @@ var ViteDevServerProvider = class {
 							next();
 							return;
 						}
+						if (this.currentReloadPromise) await this.currentReloadPromise;
 						if (this.hasError && !this.alepha) {
 							if (req.headers.accept?.includes("text/html")) {
 								res.writeHead(200, { "content-type": "text/html" });
@@ -3310,9 +3436,10 @@ var ViteDevServerProvider = class {
 	}
 	/**
 	* Send full browser reload via Vite's HMR.
+	* Uses a custom event so the client can poll for readiness before reloading.
 	*/
 	sendBrowserReload() {
-		this.server.hot.send({ type: "full-reload" });
+		this.server.hot.send("alepha:reload", {});
 	}
 	/**
 	* Send error to Vite's native error overlay.
@@ -3401,12 +3528,7 @@ var ViteDevServerProvider = class {
 		}
 		const alepha = this.getLoadedAlepha();
 		alepha.store.set("alepha.vite.server", this.server);
-		if (this.devtoolsAssetsPath) try {
-			const mod = await this.server.ssrLoadModule("@alepha/devtools");
-			alepha.with(mod.AlephaDevtools);
-		} catch (err) {
-			this.log.warn("Failed to load @alepha/devtools", err);
-		}
+		for (const hook of this.alephaLoadedHooks) await hook(alepha, this.server);
 		this.alepha = alepha;
 		await this.setupAlepha();
 		this.hasError = false;
@@ -3459,6 +3581,20 @@ var ViteDevServerProvider = class {
 		const preamble = (await this.server.transformIndexHtml("/", "<!DOCTYPE html><html><head></head><body></body></html>")).match(/<head>([\s\S]*?)<\/head>/i)?.[1]?.trim() ?? "";
 		const tags = [];
 		if (preamble) tags.push(preamble);
+		tags.push(`<script type="module">
+if (import.meta.hot) {
+  import.meta.hot.on("alepha:reload", async () => {
+    for (let i = 0; i < 50; i++) {
+      try {
+        const res = await fetch("/__alepha/ready");
+        if (res.ok) { window.location.reload(); return; }
+      } catch {}
+      await new Promise(r => setTimeout(r, 200));
+    }
+    window.location.reload();
+  });
+}
+<\/script>`);
 		if (style) tags.push(`<link rel="stylesheet" href="/${style}">`);
 		if (browser) tags.push(`<script type="module" src="/${browser}"><\/script>`);
 		return tags.join("\n");
@@ -3563,10 +3699,12 @@ 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();
 	}
@@ -3601,32 +3739,122 @@ var DevCommand = class {
 	alepha = $inject(Alepha);
 	viteDevServer = $inject(ViteDevServerProvider);
 	boot = $inject(AppEntryProvider);
-	options = $use(devOptions);
+	options = $state(devOptions);
 	/**
 	* Will run the project in watch mode.
+	*
+	* When run from a workspace root (with apps/ directory), spawns all apps in parallel.
+	* When run from an app directory, starts a single Vite dev server.
 	*/
 	dev = $command({
 		name: "dev",
 		mode: true,
 		description: "Run the project in development mode",
-		flags: t.object({
-			"no-devtools": t.optional(t.boolean({ description: "Disable devtools" })),
-			"no-vite-react-plugin": t.optional(t.boolean({ description: "Disable Vite React plugin" }))
-		}),
+		flags: t.object({ only: t.optional(t.string({ description: "Run only specific apps (comma-separated: --only api,companion)" })) }),
 		handler: async ({ root, flags }) => {
-			await this.scaffolder.ensureConfig(root, { tsconfigJson: true });
-			const entry = await this.boot.getAppEntry(root);
-			this.log.debug("Entry file found", { entry });
-			const options = this.options;
-			await this.viteDevServer.init({
-				root,
-				entry,
-				noDevtools: flags["no-devtools"] ?? options.noDevtools ?? false,
-				noViteReactPlugin: flags["no-vite-react-plugin"] ?? options.noViteReactPlugin ?? false
-			});
-			await this.viteDevServer.start();
+			const apps = await this.discoverApps(root);
+			if (apps.length > 0) await this.runMultiple(root, apps, flags);
+			else await this.runSingle(root);
 		}
 	});
+	/**
+	* Discover apps in the workspace root.
+	*
+	* Looks for directories under apps/ that contain a package.json.
+	* Supports scoped directories (e.g., apps/@passeo/api).
+	* Returns empty array if not in a workspace root.
+	*/
+	async discoverApps(root) {
+		const appsDir = join(root, "apps");
+		if (!await this.fs.exists(appsDir)) return [];
+		const entries = await readdir(appsDir);
+		const apps = [];
+		for (const entry of entries) {
+			const appPath = join(appsDir, entry);
+			const pkgPath = join(appPath, "package.json");
+			if (await this.fs.exists(pkgPath)) {
+				apps.push({
+					name: entry,
+					path: appPath
+				});
+				continue;
+			}
+			if ((await stat(appPath).catch(() => null))?.isDirectory()) {
+				const scopedEntries = await readdir(appPath);
+				for (const scopedEntry of scopedEntries) {
+					const scopedPath = join(appPath, scopedEntry);
+					const scopedPkgPath = join(scopedPath, "package.json");
+					if (await this.fs.exists(scopedPkgPath)) apps.push({
+						name: scopedEntry,
+						path: scopedPath
+					});
+				}
+			}
+		}
+		return apps;
+	}
+	/**
+	* Run a single app (existing behavior).
+	*/
+	async runSingle(root) {
+		await this.scaffolder.ensureConfig(root, { tsconfigJson: true });
+		const entry = await this.boot.getAppEntry(root);
+		this.log.debug("Entry file found", { entry });
+		const options = this.options;
+		await this.viteDevServer.init({
+			root,
+			entry,
+			noViteReactPlugin: options.noViteReactPlugin ?? false
+		});
+		await this.viteDevServer.start();
+	}
+	/**
+	* Run multiple apps in parallel with colored prefixed output.
+	*/
+	async runMultiple(_root, apps, flags) {
+		const only = flags.only;
+		if (only) {
+			const filter = only.split(",").map((s) => s.trim().toLowerCase());
+			apps = apps.filter((app) => filter.includes(app.name.toLowerCase()));
+		}
+		if (apps.length === 0) {
+			this.log.warn("No apps found to run");
+			return;
+		}
+		this.log.debug(`Starting ${apps.length} apps: ${apps.map((a) => a.name).join(", ")}`);
+		const basePort = 5173;
+		const processes = apps.map((app, i) => this.spawnApp(app, basePort + i));
+		const cleanup = () => {
+			for (const proc of processes) proc.kill("SIGTERM");
+		};
+		process.once("SIGINT", cleanup);
+		process.once("SIGTERM", cleanup);
+		await Promise.allSettled(processes.map((proc) => new Promise((resolve) => {
+			proc.on("exit", () => resolve());
+		})));
+	}
+	/**
+	* Spawn a single app process with inherited stdio.
+	*
+	* Each child process gets APP_NAME set, so the Alepha logger
+	* handles prefixing automatically.
+	*/
+	spawnApp(app, port) {
+		const proc = spawn("yarn", ["alepha", "dev"], {
+			cwd: app.path,
+			stdio: "inherit",
+			env: {
+				...process.env,
+				APP_NAME: app.name.toUpperCase(),
+				SERVER_PORT: String(port),
+				FORCE_COLOR: "1"
+			}
+		});
+		proc.on("exit", (code) => {
+			if (code !== 0 && code !== null) this.log.error(`${app.name} exited with code ${code}`);
+		});
+		return proc;
+	}
 };
 //#endregion
 //#region ../../src/cli/core/atoms/changelogOptions.ts
@@ -3737,7 +3965,7 @@ var ChangelogCommand = class {
 	log = $logger();
 	git = $inject(GitProvider);
 	parser = $inject(GitMessageParser);
-	config = $use(changelogOptions);
+	config = $state(changelogOptions);
 	/**
 	* Format a single commit line.
 	* Example: `- **cli**: add new command (\`abc1234\`)`
@@ -3967,8 +4195,7 @@ var InitCommand = class {
 				description: "Include React dependencies and web module (src/web/)"
 			})),
 			ui: t.optional(t.boolean({ description: "Include @alepha/ui (components, auth portal, admin portal)" })),
-			auth: t.optional(t.boolean({ description: "Include authentication (AppSecurity, $uiAuth). Implies --api --ui --react" })),
-			admin: t.optional(t.boolean({ description: "Include admin portal ($uiAdmin). Implies --auth" })),
+			saas: t.optional(t.boolean({ description: "Include authentication, admin portal, API, UI, and React. Everything you need for a SaaS app." })),
 			tailwind: t.optional(t.boolean({ description: "Include Tailwind CSS with Vite plugin. Implies --react" })),
 			test: t.optional(t.boolean({ description: "Include Vitest and create test directory" })),
 			force: t.optional(t.boolean({
@@ -4109,7 +4336,6 @@ var VerifyCommand = class {
 		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.pm.readPackageJson(root)).devDependencies?.vitest) await run("alepha test");