alepha 0.19.2 → 0.19.4

package/src/cli/core/providers/ViteDevServerProvider.ts

@@ -248,6 +248,26 @@ export class ViteDevServerProvider {
           }
         });
 
+        // Readiness endpoint: responds only when Alepha is fully loaded
+        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 function to run AFTER Vite's built-in middleware
         return () => {
           server.middlewares.use(async (req, res, next) => {
@@ -258,6 +278,11 @@ export class ViteDevServerProvider {
               return;
             }
 
+            // Wait for in-progress reload to complete before serving
+            if (this.currentReloadPromise) {
+              await this.currentReloadPromise;
+            }
+
             // In error state, serve a minimal HTML shell so the browser
             // can connect to Vite's HMR and display the error overlay
             if (this.hasError && !this.alepha) {
@@ -332,11 +357,10 @@ export class ViteDevServerProvider {
 
   /**
    * Send full browser reload via Vite's HMR.
+   * Uses a custom event so the client can poll for readiness before reloading.
    */
   protected sendBrowserReload(): void {
-    this.server.hot.send({
-      type: "full-reload",
-    });
+    this.server.hot.send("alepha:reload", {});
   }
 
   /**
@@ -551,6 +575,24 @@ export class ViteDevServerProvider {
     if (preamble) {
       tags.push(preamble);
     }
+
+    // Reload handler: polls /__alepha/ready before reloading to avoid
+    // hitting the server while it's still restarting.
+    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}">`);
     }

package/src/cli/core/services/PackageManagerUtils.ts

@@ -398,7 +398,9 @@ export class PackageManagerUtils {
       alepha: `^${version}`,
     };
 
-    const devDependencies: Record<string, string> = {};
+    const devDependencies: Record<string, string> = {
+      vite: alephaDeps.vite,
+    };
 
     // Only include drizzle-kit when the project uses a database.
     // React-only projects (--react without --api/--saas) don't need it.

package/src/cli/core/services/ProjectScaffolder.ts

@@ -5,7 +5,7 @@ import type { RunnerMethod } from "alepha/command";
 import { $logger, ConsoleColorProvider } from "alepha/logger";
 import { FileSystemProvider } from "alepha/system";
 import { cliAssets } from "../assets.ts";
-import { type AgentMdType, agentMd } from "../templates/agentMd.ts";
+import { type AgentMdOptions, agentMd } from "../templates/agentMd.ts";
 import { alephaConfigTs } from "../templates/alephaConfigTs.ts";
 import { apiAppSecurityTs } from "../templates/apiAppSecurityTs.ts";
 import { apiHelloControllerTs } from "../templates/apiHelloControllerTs.ts";
@@ -75,7 +75,7 @@ export class ProjectScaffolder {
       tsconfigJson?: boolean;
       biomeJson?: boolean;
       editorconfig?: boolean;
-      agentMd?: false | { type: AgentMdType };
+      agentMd?: false | AgentMdOptions;
     },
   ): Promise<void> {
     const tasks: Promise<void>[] = [];
@@ -187,10 +187,10 @@ export class ProjectScaffolder {
 
   public async ensureAgentMd(
     root: string,
-    options: { type: AgentMdType; force?: boolean },
+    options: AgentMdOptions & { force?: boolean },
   ): Promise<void> {
     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);
   }
 
   /**
@@ -481,7 +481,7 @@ export class ProjectScaffolder {
           tsconfigJson: !workspace.config.tsconfigJson,
           biomeJson: true,
           editorconfig: !workspace.config.editorconfig,
-          agentMd: agentType ? { type: agentType } : false,
+          agentMd: agentType ? { type: agentType, ui: !!flags.ui } : false,
         });
 
         // Create alepha.config.ts with documented options

package/src/cli/core/templates/agentMd.ts

@@ -1,7 +1,18 @@
 export type AgentMdType = "claude" | "agents";
 
-export const agentMd = (type: AgentMdType): string => {
-  const header = type === "claude" ? `# CLAUDE.md` : `# AGENTS.md`;
+export interface AgentMdOptions {
+  type: AgentMdType;
+  ui?: boolean;
+}
+
+export const agentMd = (options: AgentMdOptions): string => {
+  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}
 
@@ -25,8 +36,6 @@ 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();
 };

package/src/cli/core/templates/webAppRouterTs.ts

@@ -24,23 +24,8 @@ export const webAppRouterTs = (options: {
     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 { IconLayoutDashboard } from "@tabler/icons-react";');
   }
 
   // Page import
@@ -67,61 +52,23 @@ export const webAppRouterTs = (options: {
       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.users.adminUserLayout,
       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,
-        ],
-      },
+      this.users.adminUsers,
+      this.sessions.adminSessions,
     ],
   });
 
   // ── Admin Dashboard ─────────────────────────────
   adminDashboard = $page({
-    parent: this.admin.adminLayout,
+    parent: this.admin,
     path: "/",
     label: "Dashboard",
     icon: IconLayoutDashboard,

package/src/cli/devtools/index.ts

@@ -3,7 +3,19 @@ import { createRequire } from "node:module";
 import { dirname, join } from "node:path";
 import { $module, AlephaError } from "alepha";
 import { ViteDevServerProvider } from "alepha/cli";
-import { devtoolsOptions } from "./atoms/devtoolsOptions.ts";
+import { cliConfigPlugins } from "alepha/cli/config";
+import {
+  type DevtoolsOptions,
+  devtoolsOptions,
+} from "./atoms/devtoolsOptions.ts";
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+declare module "alepha/cli/config" {
+  interface AlephaCliConfig {
+    devtools?: DevtoolsOptions;
+  }
+}
 
 // ---------------------------------------------------------------------------------------------------------------------
 
@@ -191,4 +203,12 @@ export const AlephaCliDevtoolsPlugin = $module({
 
 // ---------------------------------------------------------------------------------------------------------------------
 
+cliConfigPlugins.push((config, alepha) => {
+  if (config.devtools) {
+    alepha.set(devtoolsOptions, config.devtools);
+  }
+});
+
+// ---------------------------------------------------------------------------------------------------------------------
+
 export * from "./atoms/devtoolsOptions.ts";

package/src/cli/platform/index.ts

@@ -1,7 +1,12 @@
 import { $module } from "alepha";
 import { AlephaCli } from "alepha/cli";
+import { cliConfigPlugins } from "alepha/cli/config";
 import { CloudflareAdapter } from "./adapters/CloudflareAdapter.ts";
 import { VercelAdapter } from "./adapters/VercelAdapter.ts";
+import {
+  type PlatformOptions,
+  platformOptions,
+} from "./atoms/platformOptions.ts";
 import { PlatformCommand } from "./commands/platform.ts";
 import { SecretsCommand } from "./commands/SecretsCommand.ts";
 import { GitHubSecretStore } from "./providers/GitHubSecretStore.ts";
@@ -18,6 +23,14 @@ import { WranglerApi } from "./services/WranglerApi.ts";
 
 // ---------------------------------------------------------------------------
 
+declare module "alepha/cli/config" {
+  interface AlephaCliConfig {
+    platform?: PlatformOptions;
+  }
+}
+
+// ---------------------------------------------------------------------------
+
 /**
  * CLI plugin for multi-cloud deployment orchestration.
  *
@@ -38,10 +51,10 @@ import { WranglerApi } from "./services/WranglerApi.ts";
  * Configuration in `alepha.config.ts`:
  *
  * ```typescript
- * import { AlephaCliPlatform } from "alepha/cli/platform";
+ * import { AlephaCliPlatformPlugin } from "alepha/cli/platform";
  *
  * export default defineConfig({
- *   services: [AlephaCliPlatform],
+ *   services: [AlephaCliPlatformPlugin],
  *   platform: {
  *     environments: {
  *       production: { adapter: "cloudflare", domain: "myapp.com" },
@@ -74,6 +87,14 @@ export const AlephaCliPlatformPlugin = $module({
 
 // ---------------------------------------------------------------------------
 
+cliConfigPlugins.push((config, alepha) => {
+  if (config.platform) {
+    alepha.set(platformOptions, config.platform);
+  }
+});
+
+// ---------------------------------------------------------------------------
+
 export * from "./adapters/CloudflareAdapter.ts";
 export * from "./adapters/PlatformAdapter.ts";
 export * from "./adapters/VercelAdapter.ts";