alepha 0.21.2 → 0.23.0

package/dist/cli/core/index.d.ts

@@ -1,14 +1,10 @@
-import * as _$alepha from "alepha";
 import { Alepha, Static } from "alepha";
-import * as _$alepha_command0 from "alepha/command";
 import { CliProvider, EnvUtils, Runner, RunnerMethod } from "alepha/command";
-import * as _$alepha_logger0 from "alepha/logger";
 import { ConsoleColorProvider } from "alepha/logger";
 import { FileSystemProvider, ShellProvider } from "alepha/system";
 import { BrotliOptions, ZlibOptions, brotliCompress, gzip } from "node:zlib";
 import { spawn } from "node:child_process";
-import * as _$typebox from "typebox";
-import * as _$vite from "vite";
+import * as vite from "vite";
 import { Logger, Plugin, ViteDevServer } from "vite";
 import { DatabaseProvider } from "alepha/orm";
 
@@ -30,6 +26,7 @@ declare const alephaPackageJson: {
   files: string[];
   dependencies: {
     "@biomejs/biome": string;
+    "@cloudflare/containers": string;
     "@redis/client": string;
     "@vitejs/plugin-react": string;
     dayjs: string;
@@ -64,7 +61,6 @@ declare const alephaPackageJson: {
     "prom-client": string;
     react: string;
     "react-dom": string;
-    shadcn: string;
     "swagger-ui-dist": string;
     tailwindcss: string;
     tsdown: string;
@@ -175,6 +171,12 @@ declare const alephaPackageJson: {
       import: string;
       default: string;
     };
+    "./background": {
+      types: string;
+      workerd: string;
+      import: string;
+      default: string;
+    };
     "./batch": {
       types: string;
       import: string;
@@ -237,6 +239,11 @@ declare const alephaPackageJson: {
       import: string;
       default: string;
     };
+    "./cli/platform-lib": {
+      types: string;
+      import: string;
+      default: string;
+    };
     "./cli/vendor": {
       types: string;
       import: string;
@@ -247,7 +254,7 @@ declare const alephaPackageJson: {
       import: string;
       default: string;
     };
-    "./containers": {
+    "./container": {
       types: string;
       workerd: string;
       import: string;
@@ -385,6 +392,13 @@ declare const alephaPackageJson: {
       import: string;
       default: string;
     };
+    "./react/sitemap": {
+      types: string;
+      "react-native": string;
+      browser: string;
+      import: string;
+      default: string;
+    };
     "./react/testing": {
       types: string;
       import: string;
@@ -599,6 +613,12 @@ declare const alephaPackageJson: {
         import: string;
         default: string;
       };
+      "./background": {
+        types: string;
+        workerd: string;
+        import: string;
+        default: string;
+      };
       "./batch": {
         types: string;
         import: string;
@@ -661,6 +681,11 @@ declare const alephaPackageJson: {
         import: string;
         default: string;
       };
+      "./cli/platform-lib": {
+        types: string;
+        import: string;
+        default: string;
+      };
       "./cli/vendor": {
         types: string;
         import: string;
@@ -671,7 +696,7 @@ declare const alephaPackageJson: {
         import: string;
         default: string;
       };
-      "./containers": {
+      "./container": {
         types: string;
         workerd: string;
         import: string;
@@ -809,6 +834,13 @@ declare const alephaPackageJson: {
         import: string;
         default: string;
       };
+      "./react/sitemap": {
+        types: string;
+        "react-native": string;
+        browser: string;
+        import: string;
+        default: string;
+      };
       "./react/testing": {
         types: string;
         import: string;
@@ -947,10 +979,10 @@ declare const alephaPackageJson: {
 declare const version: string;
 //#endregion
 //#region ../../src/cli/core/atoms/appEntryOptions.d.ts
-declare const appEntryOptions: _$alepha.Atom<_$typebox.TObject<{
-  server: _$typebox.TOptional<_$typebox.TString>;
-  browser: _$typebox.TOptional<_$typebox.TString>;
-  style: _$typebox.TOptional<_$typebox.TString>;
+declare const appEntryOptions: import("alepha").Atom<import("typebox").TObject<{
+  server: import("typebox").TOptional<import("typebox").TString>;
+  browser: import("typebox").TOptional<import("typebox").TString>;
+  style: import("typebox").TOptional<import("typebox").TString>;
 }>, "alepha.cli.appEntry.options">;
 type AppEntryOptions = Static<typeof appEntryOptions.schema>;
 //#endregion
@@ -977,14 +1009,14 @@ type BuildRuntime = "node" | "bun" | "workerd";
  * Defines the available build configuration options with their defaults.
  * Options can be overridden via alepha.config.ts or CLI flags.
  */
-declare const buildOptions: _$alepha.Atom<_$typebox.TObject<{
+declare const buildOptions: import("alepha").Atom<import("typebox").TObject<{
   /**
    * Generate build stats report.
    *
    * - `true` - Generate a static HTML report
    * - `"json"` - Generate a JSON report
    */
-  stats: _$typebox.TOptional<_$typebox.TUnion<[_$typebox.TBoolean, _$typebox.TUnsafe<"json">]>>;
+  stats: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TBoolean, import("typebox").TUnsafe<"json">]>>;
   /**
    * Deployment target for the build output.
    *
@@ -992,7 +1024,7 @@ declare const buildOptions: _$alepha.Atom<_$typebox.TObject<{
    * - `vercel` - Generate Vercel deployment configuration (forces node runtime)
    * - `cloudflare` - Generate Cloudflare Workers configuration (forces workerd runtime)
    */
-  target: _$typebox.TOptional<_$typebox.TUnsafe<"bare" | "docker" | "vercel" | "cloudflare" | "static">>;
+  target: import("typebox").TOptional<import("typebox").TUnsafe<"bare" | "docker" | "vercel" | "cloudflare" | "static">>;
   /**
    * JavaScript runtime for the build output.
    *
@@ -1004,23 +1036,23 @@ declare const buildOptions: _$alepha.Atom<_$typebox.TObject<{
    * - `cloudflare` always uses `workerd`
    * - `vercel` always uses `node`
    */
-  runtime: _$typebox.TOptional<_$typebox.TUnsafe<"node" | "bun" | "workerd">>;
+  runtime: import("typebox").TOptional<import("typebox").TUnsafe<"node" | "bun" | "workerd">>;
   /**
    * Output directory configuration.
    */
-  output: _$typebox.TOptional<_$typebox.TObject<{
+  output: import("typebox").TOptional<import("typebox").TObject<{
     /**
      * Root dist directory.
      *
      * @default "dist"
      */
-    dist: _$typebox.TOptional<_$typebox.TString>;
+    dist: import("typebox").TOptional<import("typebox").TString>;
     /**
      * Public/client subdirectory.
      *
      * @default "public"
      */
-    public: _$typebox.TOptional<_$typebox.TString>;
+    public: import("typebox").TOptional<import("typebox").TString>;
   }>>;
   /**
    * Vercel-specific deployment configuration.
@@ -1028,14 +1060,14 @@ declare const buildOptions: _$alepha.Atom<_$typebox.TObject<{
    * Note: Set `target: "vercel"` to enable Vercel deployment.
    * This object is only for additional configuration.
    */
-  vercel: _$typebox.TOptional<_$typebox.TObject<{
-    projectName: _$typebox.TOptional<_$typebox.TString>;
-    orgId: _$typebox.TOptional<_$typebox.TString>;
-    projectId: _$typebox.TOptional<_$typebox.TString>;
-    config: _$typebox.TOptional<_$typebox.TObject<{
-      crons: _$typebox.TOptional<_$typebox.TArray<_$typebox.TObject<{
-        path: _$typebox.TString;
-        schedule: _$typebox.TString;
+  vercel: import("typebox").TOptional<import("typebox").TObject<{
+    projectName: import("typebox").TOptional<import("typebox").TString>;
+    orgId: import("typebox").TOptional<import("typebox").TString>;
+    projectId: import("typebox").TOptional<import("typebox").TString>;
+    config: import("typebox").TOptional<import("typebox").TObject<{
+      crons: import("typebox").TOptional<import("typebox").TArray<import("typebox").TObject<{
+        path: import("typebox").TString;
+        schedule: import("typebox").TString;
       }>>>;
     }>>;
   }>>;
@@ -1045,8 +1077,8 @@ declare const buildOptions: _$alepha.Atom<_$typebox.TObject<{
    * Note: Set `target: "cloudflare"` to enable Cloudflare deployment.
    * This object is only for additional configuration.
    */
-  cloudflare: _$typebox.TOptional<_$typebox.TObject<{
-    config: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
+  cloudflare: import("typebox").TOptional<import("typebox").TObject<{
+    config: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
   }>>;
   /**
    * Docker-specific deployment configuration.
@@ -1054,21 +1086,21 @@ declare const buildOptions: _$alepha.Atom<_$typebox.TObject<{
    * Note: Set `target: "docker"` to enable Docker deployment.
    * This object is only for additional configuration.
    */
-  docker: _$typebox.TOptional<_$typebox.TObject<{
+  docker: import("typebox").TOptional<import("typebox").TObject<{
     /**
      * Base image for the Dockerfile (FROM instruction).
      *
      * @default "node:24-alpine" for node runtime
      * @default "oven/bun:alpine" for bun runtime
      */
-    from: _$typebox.TOptional<_$typebox.TString>;
+    from: import("typebox").TOptional<import("typebox").TString>;
     /**
      * Command to run in the Docker container.
      *
      * @default "node" for node runtime
      * @default "bun" for bun runtime
      */
-    command: _$typebox.TOptional<_$typebox.TString>;
+    command: import("typebox").TOptional<import("typebox").TString>;
     /**
      * Extra packages to install globally in the generated image.
      *
@@ -1082,11 +1114,11 @@ declare const buildOptions: _$alepha.Atom<_$typebox.TObject<{
      *
      * @example install: ["wrangler"]
      */
-    install: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
+    install: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
     /**
      * Docker build options (used when --image flag is passed).
      */
-    image: _$typebox.TOptional<_$typebox.TObject<{
+    image: import("typebox").TOptional<import("typebox").TObject<{
       /**
        * Default image tag (name without version).
        *
@@ -1098,13 +1130,13 @@ declare const buildOptions: _$alepha.Atom<_$typebox.TObject<{
        * @example "myproject/myapp"
        * @example "ghcr.io/myorg/myapp"
        */
-      tag: _$typebox.TString;
+      tag: import("typebox").TString;
       /**
        * Additional arguments to pass to `docker build`.
        *
        * @example '--platform linux/amd64 --no-cache'
        */
-      args: _$typebox.TOptional<_$typebox.TString>;
+      args: import("typebox").TOptional<import("typebox").TString>;
       /**
        * Auto-add OCI standard labels (revision, created, version).
        *
@@ -1113,7 +1145,7 @@ declare const buildOptions: _$alepha.Atom<_$typebox.TObject<{
        * - org.opencontainers.image.created (build timestamp)
        * - org.opencontainers.image.version (from image tag)
        */
-      oci: _$typebox.TOptional<_$typebox.TBoolean>;
+      oci: import("typebox").TOptional<import("typebox").TBoolean>;
     }>>;
     /**
      * Compile the server entry to a single static binary using
@@ -1130,7 +1162,7 @@ declare const buildOptions: _$alepha.Atom<_$typebox.TObject<{
      *
      * Pass `true` to enable with defaults, or an object to override.
      */
-    compile: _$typebox.TOptional<_$typebox.TUnion<[_$typebox.TBoolean, _$typebox.TObject<{
+    compile: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TBoolean, import("typebox").TObject<{
       /**
        * Bun target triple, e.g. `bun-linux-x64-musl`,
        * `bun-linux-arm64-musl`, or `bun-linux-x64-modern-musl`
@@ -1138,19 +1170,19 @@ declare const buildOptions: _$alepha.Atom<_$typebox.TObject<{
        *
        * @default derived from host arch — always linux-musl.
        */
-      target: _$typebox.TOptional<_$typebox.TString>;
+      target: import("typebox").TOptional<import("typebox").TString>;
       /**
        * Base image for the generated Dockerfile.
        *
        * @default "gcr.io/distroless/static-debian12"
        */
-      base: _$typebox.TOptional<_$typebox.TString>;
+      base: import("typebox").TOptional<import("typebox").TString>;
       /**
        * Minify the compiled output.
        *
        * @default true
        */
-      minify: _$typebox.TOptional<_$typebox.TBoolean>;
+      minify: import("typebox").TOptional<import("typebox").TBoolean>;
     }>]>>;
   }>>;
   /**
@@ -1158,7 +1190,7 @@ declare const buildOptions: _$alepha.Atom<_$typebox.TObject<{
    *
    * Note: Set `target: "static"` to enable static site generation.
    */
-  static: _$typebox.TOptional<_$typebox.TObject<{
+  static: import("typebox").TOptional<import("typebox").TObject<{
     /**
      * Surge domain for deployment.
      *
@@ -1168,7 +1200,7 @@ declare const buildOptions: _$alepha.Atom<_$typebox.TObject<{
      * @example "my-app.surge.sh"
      * @example "my-custom-domain.com"
      */
-    domain: _$typebox.TOptional<_$typebox.TString>;
+    domain: import("typebox").TOptional<import("typebox").TString>;
   }>>;
   /**
    * PWA (Progressive Web App) configuration.
@@ -1176,29 +1208,29 @@ declare const buildOptions: _$alepha.Atom<_$typebox.TObject<{
    * Generates a web app manifest and enables installability.
    * Requires a client-side bundle (React).
    */
-  pwa: _$typebox.TOptional<_$typebox.TObject<{
+  pwa: import("typebox").TOptional<import("typebox").TObject<{
     /**
      * Full application name displayed on the splash screen
      * and in the OS app switcher.
      */
-    name: _$typebox.TString;
+    name: import("typebox").TString;
     /**
      * Short name displayed on the home screen icon.
      * Falls back to `name` if omitted.
      */
-    shortName: _$typebox.TOptional<_$typebox.TString>;
+    shortName: import("typebox").TOptional<import("typebox").TString>;
     /**
      * Theme color used for the browser toolbar and OS chrome.
      *
      * @default "#ffffff"
      */
-    themeColor: _$typebox.TOptional<_$typebox.TString>;
+    themeColor: import("typebox").TOptional<import("typebox").TString>;
     /**
      * Background color for the splash screen.
      *
      * @default "#ffffff"
      */
-    backgroundColor: _$typebox.TOptional<_$typebox.TString>;
+    backgroundColor: import("typebox").TOptional<import("typebox").TString>;
     /**
      * Display mode for the installed PWA.
      *
@@ -1209,22 +1241,13 @@ declare const buildOptions: _$alepha.Atom<_$typebox.TObject<{
      *
      * @default "standalone"
      */
-    display: _$typebox.TOptional<_$typebox.TUnsafe<"browser" | "standalone" | "fullscreen" | "minimal-ui">>;
+    display: import("typebox").TOptional<import("typebox").TUnsafe<"standalone" | "fullscreen" | "minimal-ui" | "browser">>;
     /**
      * Enable offline support via service worker.
      *
      * TODO: Not yet implemented.
      */
-    offline: _$typebox.TOptional<_$typebox.TBoolean>;
-  }>>;
-  /**
-   * Sitemap generation configuration.
-   */
-  sitemap: _$typebox.TOptional<_$typebox.TObject<{
-    /**
-     * Base URL for sitemap entries.
-     */
-    hostname: _$typebox.TString;
+    offline: import("typebox").TOptional<import("typebox").TBoolean>;
   }>>;
 }>, "alepha.cli.build.options">;
 /**
@@ -1250,12 +1273,12 @@ declare const DEFAULT_IGNORE: string[];
  * });
  * ```
  */
-declare const changelogOptions: _$alepha.Atom<_$typebox.TObject<{
+declare const changelogOptions: import("alepha").Atom<import("typebox").TObject<{
   /**
    * Scopes to ignore (e.g., "project", "release", "chore").
    * Commits like `feat(chore): ...` will be excluded from changelog.
    */
-  ignore: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
+  ignore: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
 }>, "alepha.cli.changelog.options">;
 type ChangelogOptions = Static<typeof changelogOptions.schema>;
 //#endregion
@@ -1266,11 +1289,11 @@ type ChangelogOptions = Static<typeof changelogOptions.schema>;
  * Defines the available dev configuration options with their defaults.
  * Options can be overridden via alepha.config.ts or CLI flags.
  */
-declare const devOptions: _$alepha.Atom<_$typebox.TObject<{
+declare const devOptions: import("alepha").Atom<import("typebox").TObject<{
   /**
    * Disable Vite React plugin.
    */
-  noViteReactPlugin: _$typebox.TOptional<_$typebox.TBoolean>;
+  noViteReactPlugin: import("typebox").TOptional<import("typebox").TBoolean>;
 }>, "alepha.cli.dev.options">;
 /**
  * Type for dev options.
@@ -1286,8 +1309,8 @@ type DevOptions = Static<typeof devOptions.schema>;
 declare class AppEntryProvider {
   protected readonly fs: FileSystemProvider;
   protected readonly options: Readonly<{
-    server?: string | undefined;
     browser?: string | undefined;
+    server?: string | undefined;
     style?: string | undefined;
   }>;
   protected readonly serverEntries: readonly ["main.server.ts", "main.server.tsx", "main.ts", "main.tsx"];
@@ -1351,7 +1374,7 @@ declare class ViteUtils {
   /**
    * Lazy-load Vite (with rolldown-vite fallback).
    */
-  importVite(): Promise<typeof _$vite>;
+  importVite(): Promise<typeof import("vite")>;
   /**
    * Lazy-load @vitejs/plugin-react (optional).
    */
@@ -1381,8 +1404,8 @@ declare class ViteUtils {
   /**
    * We need to close the Vite dev server after build is done.
    */
-  protected onReady: _$alepha.HookPrimitive<"ready">;
-  protected onStop: _$alepha.HookPrimitive<"stop">;
+  protected onReady: import("alepha").HookPrimitive<"ready">;
+  protected onStop: import("alepha").HookPrimitive<"stop">;
   runAlepha(opts: {
     entry: AppEntry;
     mode: "production" | "development";
@@ -1411,7 +1434,7 @@ declare class ViteBuildProvider {
  * - Environment loading
  */
 declare class AlephaCliUtils {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly fs: FileSystemProvider;
   protected readonly envUtils: EnvUtils;
   protected readonly boot: AppEntryProvider;
@@ -1514,7 +1537,7 @@ interface WorkspaceContext {
  * - Bun
  */
 declare class PackageManagerUtils {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly fs: FileSystemProvider;
   protected readonly alepha: Alepha;
   /**
@@ -1592,12 +1615,6 @@ interface DependencyModes {
   react?: boolean;
   expo?: boolean;
   tailwind?: boolean;
-  shadcn?: boolean;
-  /**
-   * SaaS starter: implies `shadcn` + adds the alepha auth + admin registry
-   * components on top via `shadcn add @alepha/...`.
-   */
-  saas?: boolean;
   /**
    * Whether the project is a workspace package inside a monorepo.
    */
@@ -1615,10 +1632,9 @@ interface DependencyModes {
  * - Example code (HelloController, Home component)
  */
 declare class ProjectScaffolder {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly colors: ConsoleColorProvider;
   protected readonly fs: FileSystemProvider;
-  protected readonly shell: ShellProvider;
   protected readonly pm: PackageManagerUtils;
   protected readonly utils: AlephaCliUtils;
   /**
@@ -1640,13 +1656,7 @@ declare class ProjectScaffolder {
      */
     checkWorkspace?: boolean;
     packageJson?: boolean | DependencyModes;
-    /**
-     * `true` writes a tsconfig.json if one doesn't already exist (parent
-     * dirs included). `"local"` writes one when none exists *in this
-     * directory* — used by shadcn since the CLI reads the local
-     * tsconfig directly for import-alias detection.
-     */
-    tsconfigJson?: boolean | "local";
+    tsconfigJson?: boolean;
     biomeJson?: boolean;
     editorconfig?: boolean;
     agentMd?: boolean;
@@ -1658,7 +1668,6 @@ declare class ProjectScaffolder {
   }): Promise<void>;
   ensureTsConfig(root: string, opts?: {
     force?: boolean;
-    localOnly?: boolean;
   }): Promise<void>;
   ensureBiomeConfig(root: string, opts?: {
     force?: boolean;
@@ -1716,16 +1725,8 @@ declare class ProjectScaffolder {
    * - src/api/controllers/HelloController.ts (example controller)
    */
   ensureApiProject(root: string, opts?: {
-    saas?: boolean;
     force?: boolean;
   }): Promise<void>;
-  /**
-   * Best-effort lookup for the developer's git email — seeded as
-   * `ADMIN_EMAILS` in the SaaS project's `.env`. Returns undefined if git
-   * isn't available or `user.email` isn't configured; the caller then falls
-   * back to the neutral `admin@alepha.dev`.
-   */
-  protected detectGitEmail(): Promise<string | undefined>;
   /**
    * Ensure web/React project structure exists.
    *
@@ -1737,8 +1738,6 @@ declare class ProjectScaffolder {
   ensureWebProject(root: string, opts?: {
     api?: boolean;
     tailwind?: boolean;
-    shadcn?: boolean;
-    saas?: boolean;
     force?: boolean;
   }): Promise<void>;
   /**
@@ -1762,9 +1761,7 @@ declare class ProjectScaffolder {
       pm?: "yarn" | "npm" | "pnpm" | "bun";
       api?: boolean;
       react?: boolean;
-      tailwind?: boolean; /** boolean toggle, or a string preset id (default `b0` when bare). */
-      shadcn?: boolean | string; /** boolean toggle, or a string preset id (default `b0` when bare). */
-      saas?: boolean | string;
+      tailwind?: boolean;
       force?: boolean;
     };
     args?: string;
@@ -1779,6 +1776,181 @@ declare class ProjectScaffolder {
   protected existsInParents(root: string, filename: string): Promise<boolean>;
 }
 //#endregion
+//#region ../../src/cli/core/tasks/BuildCloudflareTask.d.ts
+interface WranglerConfig {
+  [key: string]: any;
+}
+/**
+ * Build-time snapshot describing what the workspace needs at deploy
+ * time. Written to `dist/manifest.json` alongside `wrangler.jsonc`.
+ *
+ * Lets `alepha platform up --prebuilt` skip the Vite-based
+ * introspection step on the deploy side — and lets Alepha Rocket skip
+ * the workspace's runtime `npm install` because no app source is
+ * booted at deploy time. The manifest captures the bits of primitive
+ * data that the deploy steps (provision, secrets, hooks) need to
+ * know.
+ */
+interface BuildManifest {
+  version: 1;
+  project: string;
+  /**
+   * Default environment when `--env` is omitted at deploy time.
+   * Captured from `platformOptions.default` (defaults to `"production"`).
+   */
+  defaultEnv: string;
+  /**
+   * Multi-tenancy mode (`none` | `optional` | `required`). Captured from
+   * `platformOptions.tenancy` so the prebuilt deploy side (Rocket) can
+   * validate `--tenant` without re-evaluating `alepha.config.ts`.
+   */
+  tenancy?: "none" | "optional" | "required";
+  /**
+   * Resolved `platform({ environments: ... })` map. Captured at build
+   * time from the workspace's `alepha.config.ts` so the deploy side
+   * doesn't need to re-evaluate the config. Each value is the same
+   * `EnvironmentConfig` shape consumed by the orchestrator (adapter,
+   * domain, zone, jurisdiction, accountId).
+   */
+  environments: Record<string, {
+    adapter: "cloudflare" | "vercel";
+    domain?: string;
+    zone?: string;
+    jurisdiction?: "eu" | "fedramp";
+    accountId?: string;
+  }>;
+  resources: {
+    hasDatabase: boolean;
+    hasBucket: boolean;
+    hasKV: boolean;
+    hasQueue: boolean;
+    hasCron: boolean;
+  };
+  /**
+   * All distinct cron expressions registered by `$scheduler`
+   * primitives. Empty when `hasCron` is false.
+   */
+  crons: string[];
+  /**
+   * Cloudflare email binding, captured when the app registers
+   * `CloudflareEmailProvider` at artifact-build time. The prebuilt/manifest
+   * deploy path (Alepha Rocket `--prebuilt`) has no Vite introspection, so it
+   * reads this to re-emit the `send_email` wrangler binding. Absent when the
+   * app doesn't use Cloudflare email.
+   */
+  email?: {
+    binding: string;
+  };
+  /**
+   * `$container()` descriptors — image, port, lifecycle settings.
+   * Used both to populate Cloudflare Containers bindings in
+   * wrangler.jsonc and (in future) to know which images Rocket should
+   * pull on the deploy side.
+   */
+  containers: Array<{
+    name: string;
+    className: string;
+    image: string;
+    port: number;
+    sleepAfter: string;
+    instanceType: string;
+    maxInstances: number;
+  }>;
+  /**
+   * Every env var the app declares via `$env`, captured from
+   * `alepha.dump().env` at build time. The deploy `secrets` step uses this
+   * as the worker-secret allowlist (minus build/binding vars) so CI can
+   * deliver secrets straight from `process.env` without a `.env` file —
+   * `platform.secrets.keys` overrides it when set. Empty when introspection
+   * was unavailable (older artifacts / prebuilt mode).
+   */
+  env: string[];
+}
+/**
+ * Generate Cloudflare Workers deployment configuration.
+ *
+ * Creates:
+ * - wrangler.jsonc with worker configuration
+ * - main.cloudflare.js entry point for Cloudflare Workers
+ */
+declare class BuildCloudflareTask extends BuildTask {
+  protected readonly fs: FileSystemProvider;
+  protected readonly viteUtils: ViteUtils;
+  protected readonly warningComment: string;
+  run(ctx: BuildTaskContext): Promise<void>;
+  protected generateCloudflare(ctx: BuildTaskContext, distDir: string): Promise<void>;
+  /**
+   * Write `dist/manifest.json` — a build-time snapshot of everything
+   * downstream tooling needs to know about the app without re-booting
+   * it. Used by `alepha platform up --prebuilt` (and Alepha Rocket) so
+   * the deploy path can skip the Vite-based introspection step and the
+   * workspace's runtime npm install.
+   */
+  protected writeManifest(ctx: BuildTaskContext, root: string, distDir: string, name: string, containers: ContainerDescriptor[]): Promise<void>;
+  protected enhanceDomain(wrangler: WranglerConfig): void;
+  protected enhanceCron(ctx: BuildTaskContext, wrangler: WranglerConfig): void;
+  protected discoverCrons(ctx: BuildTaskContext): string[];
+  protected enhanceDatabase(wrangler: WranglerConfig): void;
+  protected static readonly D1_BINDING = "DB";
+  protected enhanceD1(wrangler: WranglerConfig): void;
+  protected enhanceHyperdrive(wrangler: WranglerConfig): void;
+  protected enhanceR2(wrangler: WranglerConfig): void;
+  protected enhanceKV(wrangler: WranglerConfig): void;
+  protected enhanceQueue(wrangler: WranglerConfig): void;
+  protected enhanceEmail(ctx: BuildTaskContext, wrangler: WranglerConfig): void;
+  /**
+   * Discover `$container` primitives and emit the matching Cloudflare
+   * Containers bindings, Durable Object bindings, and migrations into
+   * `wrangler.jsonc`. The DO class declarations are added later, when
+   * the worker entry point is written.
+   *
+   * Returns the list of container descriptors so
+   * `writeWorkerEntryPoint` can emit `export class <NAME> extends
+   * Container` declarations referencing them.
+   */
+  protected discoverContainers(ctx: BuildTaskContext): ContainerDescriptor[];
+  /**
+   * Expand a short image ref (e.g. `alepha-rocket:0.1.0`) into the
+   * fully-qualified `registry.cloudflare.com/<account>/<image>:<tag>`
+   * URL that wrangler validates at deploy time.
+   *
+   * Cloudflare Containers only pulls from `registry.cloudflare.com`;
+   * wrangler accepts either a Dockerfile path or a fully-qualified
+   * registry URL in the `image` field — not a bare DockerHub-style
+   * name. We let `$container({ image })` callers write the short
+   * form (it matches what `wrangler containers push <local>` accepts
+   * + matches the local docker tag) and rewrite to the CF registry
+   * URL here.
+   *
+   * Pass-through cases:
+   *   - already a full URL: starts with `registry.cloudflare.com/`
+   *     or contains a scheme/`://`
+   *   - looks like a Dockerfile path: starts with `./` or `/`
+   */
+  protected resolveContainerImage(image: string): string;
+  protected enhanceContainers(ctx: BuildTaskContext, wrangler: WranglerConfig): ContainerDescriptor[];
+  protected writeWorkerEntryPoint(root: string, distDir: string, containers?: ContainerDescriptor[]): Promise<void>;
+}
+interface ContainerDescriptor {
+  name: string;
+  className: string;
+  image: string;
+  port: number;
+  sleepAfter: string;
+  /**
+   * Cloudflare Containers instance class.
+   *
+   * `dev` is the wrangler-pre-GA name; the platform accepts it but
+   * emits a deprecation warning telling you to use `lite`. We
+   * silently translate at write time (see `discoverContainers`
+   * default + `enhanceContainers` write) so older
+   * `$container({ instanceType: "dev" })` declarations keep working.
+   */
+  instanceType: "dev" | "lite" | "basic" | "standard";
+  maxInstances: number;
+  envVars?: Record<string, string>;
+}
+//#endregion
 //#region ../../src/cli/core/tasks/BuildTask.d.ts
 interface BuildTaskContext {
   /**
@@ -1814,6 +1986,34 @@ interface BuildTaskContext {
    * Raw CLI flags passed through from the command.
    * Tasks can read flags relevant to their domain.
    */
+  /**
+   * Build-time snapshot of primitive data, read from
+   * `dist/manifest.json`. Populated only in `--prebuilt` mode when a
+   * previous build's manifest is present — lets BuildCloudflareTask
+   * regenerate `wrangler.jsonc` without re-booting the workspace.
+   * `null` when introspection (`ctx.alepha`) is the source of truth.
+   */
+  manifest: BuildManifest | null;
+  /**
+   * Resolved `platform({ default, environments, ... })` options from
+   * the workspace's `alepha.config.ts`. Populated by `BuildCommand`
+   * from the CLI's Alepha instance (where alepha.config.ts ran) —
+   * BuildCloudflareTask uses these to write the corresponding fields
+   * into `dist/manifest.json` so the deploy side doesn't need to
+   * re-load `alepha.config.ts`. `null` when no platform options were
+   * declared.
+   */
+  platformOptions: {
+    default?: string;
+    tenancy?: "none" | "optional" | "required";
+    environments?: Record<string, {
+      adapter: "cloudflare" | "vercel";
+      domain?: string;
+      zone?: string;
+      jurisdiction?: "eu" | "fedramp";
+      accountId?: string;
+    }>;
+  } | null;
   flags?: {
     image?: boolean | string;
     /**
@@ -1874,57 +2074,6 @@ declare class BuildClientTask extends BuildTask {
   postBuildCleanUpForIndexHtml(dist?: string): Promise<void>;
 }
 //#endregion
-//#region ../../src/cli/core/tasks/BuildCloudflareTask.d.ts
-interface WranglerConfig {
-  [key: string]: any;
-}
-/**
- * Generate Cloudflare Workers deployment configuration.
- *
- * Creates:
- * - wrangler.jsonc with worker configuration
- * - main.cloudflare.js entry point for Cloudflare Workers
- */
-declare class BuildCloudflareTask extends BuildTask {
-  protected readonly fs: FileSystemProvider;
-  protected readonly viteUtils: ViteUtils;
-  protected readonly warningComment: string;
-  run(ctx: BuildTaskContext): Promise<void>;
-  protected generateCloudflare(ctx: BuildTaskContext, distDir: string): Promise<void>;
-  protected enhanceDomain(wrangler: WranglerConfig): void;
-  protected enhanceCron(ctx: BuildTaskContext, wrangler: WranglerConfig): void;
-  protected enhanceDatabase(wrangler: WranglerConfig): void;
-  protected static readonly D1_BINDING = "DB";
-  protected enhanceD1(wrangler: WranglerConfig): void;
-  protected enhanceHyperdrive(wrangler: WranglerConfig): void;
-  protected enhanceR2(wrangler: WranglerConfig): void;
-  protected enhanceKV(wrangler: WranglerConfig): void;
-  protected enhanceQueue(wrangler: WranglerConfig): void;
-  protected enhanceEmail(ctx: BuildTaskContext, wrangler: WranglerConfig): void;
-  /**
-   * Discover `$container` primitives and emit the matching Cloudflare
-   * Containers bindings, Durable Object bindings, and migrations into
-   * `wrangler.jsonc`. The DO class declarations are added later, when
-   * the worker entry point is written.
-   *
-   * Returns the list of container descriptors so
-   * `writeWorkerEntryPoint` can emit `export class <NAME> extends
-   * Container` declarations referencing them.
-   */
-  protected enhanceContainers(ctx: BuildTaskContext, wrangler: WranglerConfig): ContainerDescriptor[];
-  protected writeWorkerEntryPoint(root: string, distDir: string, containers?: ContainerDescriptor[]): Promise<void>;
-}
-interface ContainerDescriptor {
-  name: string;
-  className: string;
-  image: string;
-  port: number;
-  sleepAfter: string;
-  instanceType: "dev" | "basic" | "standard";
-  maxInstances: number;
-  envVars?: Record<string, string>;
-}
-//#endregion
 //#region ../../src/cli/core/tasks/BuildCompressTask.d.ts
 interface CompressOptions {
   /**
@@ -2028,6 +2177,14 @@ declare class BuildDockerTask extends BuildTask {
    */
   protected cleanupPreCompileArtifacts(root: string, distDir: string): Promise<void>;
   protected copyMigrations(root: string, distDir: string): Promise<boolean>;
+  /**
+   * Whether the produced `dist/package.json` declares any runtime
+   * dependencies. Alepha apps normally bundle everything into the
+   * server entry via Vite, leaving `dependencies: {}` — in which case
+   * the generated Dockerfile's `RUN npm install` is wasted work
+   * (and emits deprecation noise). Skip the line when empty.
+   */
+  protected hasRuntimeDeps(root: string, distDir: string): Promise<boolean>;
   protected writeDockerfile(root: string, distDir: string, opts: {
     compile: ResolvedCompile | null;
     standard: {
@@ -2035,6 +2192,7 @@ declare class BuildDockerTask extends BuildTask {
       command: string;
     };
     hasMigrations: boolean;
+    hasDeps: boolean;
     install: string[];
   }): Promise<void>;
   protected buildDockerImage(ctx: BuildTaskContext, distDir: string): Promise<void>;
@@ -2042,17 +2200,30 @@ declare class BuildDockerTask extends BuildTask {
 //#endregion
 //#region ../../src/cli/core/tasks/BuildPrerenderTask.d.ts
 /**
- * Pre-render static pages defined in the Alepha application.
+ * Pre-render static pages and routes defined in the Alepha application.
+ *
+ * Two passes, both writing into `dist/public`:
+ * - **pages** — every `$page` with `static: true` is rendered to an HTML file
+ *   (supports parameterized routes via `static.entries`).
+ * - **routes** — every `static` route primitive (a `$route({ static: true })`
+ *   or a `$sitemap`) is invoked in-process and its body written verbatim to
+ *   `{path}` (e.g. `sitemap.xml`, `robots.txt`).
  *
- * Queries all page primitives with `static: true` and generates
- * static HTML files for each page. Supports pages with parameterized
- * routes via `static.entries` configuration.
+ * Both passes read the primitive registry and call a method on the already
+ * created primitive instances — no provider is re-injected, so this works in
+ * the build's configured-but-not-started container.
  */
 declare class BuildPrerenderTask extends BuildTask {
   protected readonly fs: FileSystemProvider;
   run(ctx: BuildTaskContext): Promise<void>;
   protected getStaticPages(ctx: BuildTaskContext): any[];
+  /**
+   * Static route primitives to snapshot: `$route({ static: true })` and every
+   * `$sitemap`. Both expose an async `prerender(): { path, body }`.
+   */
+  protected getStaticRoutePrimitives(ctx: BuildTaskContext): any[];
   protected prerenderFromAlepha(pages: any[], dist: string): Promise<number>;
+  protected prerenderRoutes(primitives: any[], dist: string): Promise<void>;
   protected renderFile(page: any, options: any, dist: string): Promise<void>;
 }
 //#endregion
@@ -2088,7 +2259,7 @@ declare class BuildPwaTask extends BuildTask {
  */
 declare class BuildServerTask extends BuildTask {
   protected readonly alepha: Alepha;
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly fs: FileSystemProvider;
   protected readonly viteUtils: ViteUtils;
   run(ctx: BuildTaskContext): Promise<void>;
@@ -2110,24 +2281,7 @@ declare class BuildServerTask extends BuildTask {
   protected generateExternals(distDir: string, externals: string[]): Promise<void>;
   protected loadJsonFile(path: string): Promise<any>;
   protected stripClientManifest(manifest: Record<string, any> | undefined): Record<string, any> | undefined;
-  protected extractEntryFromBundle(root: string, entry: string, result: _$vite.Rollup.RollupOutput | _$vite.Rollup.RollupOutput[] | _$vite.Rollup.RollupWatcher): string;
-}
-//#endregion
-//#region ../../src/cli/core/tasks/BuildSitemapTask.d.ts
-/**
- * Generate sitemap.xml from Alepha page primitives.
- *
- * Queries all page primitives and generates a sitemap.xml
- * containing URLs for all accessible pages.
- */
-declare class BuildSitemapTask extends BuildTask {
-  protected readonly fs: FileSystemProvider;
-  run(ctx: BuildTaskContext): Promise<void>;
-  protected getSitemapPages(ctx: BuildTaskContext): any[];
-  protected generateSitemapFromPages(pages: any[], baseUrl: string): string;
-  protected buildPathFromParams(pathPattern: string, params: Record<string, any>): string;
-  protected buildSitemapXml(urls: string[]): string;
-  protected escapeXml(str: string): string;
+  protected extractEntryFromBundle(root: string, entry: string, result: vite.Rollup.RollupOutput | vite.Rollup.RollupOutput[] | vite.Rollup.RollupWatcher): string;
 }
 //#endregion
 //#region ../../src/cli/core/tasks/BuildStaticTask.d.ts
@@ -2215,7 +2369,7 @@ declare class BuildVercelTask extends BuildTask {
 //#region ../../src/cli/core/commands/build.d.ts
 declare class BuildCommand {
   protected readonly alepha: Alepha;
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly utils: AlephaCliUtils;
   protected readonly pm: PackageManagerUtils;
   protected readonly scaffolder: ProjectScaffolder;
@@ -2265,20 +2419,31 @@ declare class BuildCommand {
       shortName?: string | undefined;
       themeColor?: string | undefined;
       backgroundColor?: string | undefined;
-      display?: "browser" | "standalone" | "fullscreen" | "minimal-ui" | undefined;
+      display?: "standalone" | "fullscreen" | "minimal-ui" | "browser" | undefined;
       offline?: boolean | undefined;
       name: string;
     } | undefined;
-    sitemap?: {
-      hostname: string;
-    } | undefined;
   }>;
   /**
    * Build pipeline: tasks run sequentially in this order.
    * Each task self-guards (checks target, hasClient, etc.).
    * Order matters — compress must be last.
    */
-  protected readonly pipeline: (BuildVercelTask | BuildClientTask | BuildServerTask | BuildAssetsTask | BuildSitemapTask | BuildPwaTask | BuildPrerenderTask | BuildCloudflareTask | BuildDockerTask | BuildStaticTask | BuildCompressTask)[];
+  protected readonly pipeline: (BuildClientTask | BuildServerTask | BuildAssetsTask | BuildPwaTask | BuildPrerenderTask | BuildVercelTask | BuildCloudflareTask | BuildDockerTask | BuildStaticTask | BuildCompressTask)[];
+  /**
+   * Value aliases accepted for `--target`.
+   *
+   * These let the CLI accept short forms (e.g. `--target cf`) that are
+   * canonicalized to a real {@link BuildTarget} before they flow into the
+   * pipeline. The enum in `flags.target` must also list the alias so it
+   * passes schema validation.
+   */
+  protected readonly targetAliases: Record<string, BuildTarget>;
+  /**
+   * Canonicalize a raw `--target` value, mapping any known alias
+   * (e.g. `cf` → `cloudflare`) to its real {@link BuildTarget}.
+   */
+  protected resolveTarget(target: string | undefined): BuildTarget | undefined;
   /**
    * Resolve the effective runtime based on target and explicit runtime flag.
    *
@@ -2290,15 +2455,20 @@ declare class BuildCommand {
    * @throws {AlephaError} If an incompatible runtime is specified for a target
    */
   protected resolveRuntime(target: BuildTarget | undefined, runtime: BuildRuntime | undefined): BuildRuntime;
-  readonly build: _$alepha_command0.CommandPrimitive<_$typebox.TObject<{
-    stats: _$typebox.TOptional<_$typebox.TUnion<[_$typebox.TBoolean, _$typebox.TUnsafe<"json">]>>;
-    target: _$typebox.TOptional<_$typebox.TUnsafe<"bare" | "docker" | "vercel" | "cloudflare" | "static">>;
-    runtime: _$typebox.TOptional<_$typebox.TUnsafe<"node" | "bun" | "workerd">>;
-    image: _$typebox.TOptional<_$typebox.TUnion<[_$typebox.TBoolean, _$typebox.TString]>>;
-    compile: _$typebox.TOptional<_$typebox.TBoolean>;
-    prebuilt: _$typebox.TOptional<_$typebox.TBoolean>;
-    sitemap: _$typebox.TOptional<_$typebox.TString>;
-  }>, _$typebox.TSchema, _$typebox.TObject<_$typebox.TProperties>>;
+  readonly build: import("alepha/command").CommandPrimitive<import("typebox").TObject<{
+    stats: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TBoolean, import("typebox").TUnsafe<"json">]>>;
+    target: import("typebox").TOptional<import("typebox").TUnsafe<"bare" | "docker" | "vercel" | "cloudflare" | "static" | "cf">>;
+    runtime: import("typebox").TOptional<import("typebox").TUnsafe<"node" | "bun" | "workerd">>;
+    image: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TBoolean, import("typebox").TString]>>;
+    compile: import("typebox").TOptional<import("typebox").TBoolean>;
+    prebuilt: import("typebox").TOptional<import("typebox").TBoolean>;
+  }>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
+  /**
+   * Read `dist/manifest.json` produced by a previous `alepha build`.
+   * Returns null when absent or unparseable — caller falls back to the
+   * Vite-introspection path.
+   */
+  protected loadManifest(root: string): Promise<BuildManifest | null>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/clean.d.ts
@@ -2306,12 +2476,12 @@ declare class CleanCommand {
   /**
    * Clean the project, removing the "dist" directory
    */
-  readonly clean: _$alepha_command0.CommandPrimitive<_$typebox.TObject<_$typebox.TProperties>, _$typebox.TSchema, _$typebox.TObject<_$typebox.TProperties>>;
+  readonly clean: import("alepha/command").CommandPrimitive<import("typebox").TObject<import("typebox").TProperties>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/db.d.ts
 declare class DbCommand {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly fs: FileSystemProvider;
   protected readonly utils: AlephaCliUtils;
   protected readonly pm: PackageManagerUtils;
@@ -2321,44 +2491,44 @@ declare class DbCommand {
   /**
    * Check if database migrations are up to date.
    */
-  protected readonly check: _$alepha_command0.CommandPrimitive<_$typebox.TObject<{
-    provider: _$typebox.TOptional<_$typebox.TString>;
-  }>, _$typebox.TOptional<_$typebox.TString>, _$typebox.TObject<_$typebox.TProperties>>;
+  protected readonly check: import("alepha/command").CommandPrimitive<import("typebox").TObject<{
+    provider: import("typebox").TOptional<import("typebox").TString>;
+  }>, import("typebox").TOptional<import("typebox").TString>, import("typebox").TObject<import("typebox").TProperties>>;
   /**
    * Generate database migration files
    */
-  protected readonly create: _$alepha_command0.CommandPrimitive<_$typebox.TObject<{
-    provider: _$typebox.TOptional<_$typebox.TString>;
-    custom: _$typebox.TOptional<_$typebox.TBoolean>;
-    name: _$typebox.TOptional<_$typebox.TString>;
-  }>, _$typebox.TOptional<_$typebox.TString>, _$typebox.TObject<_$typebox.TProperties>>;
+  protected readonly create: import("alepha/command").CommandPrimitive<import("typebox").TObject<{
+    provider: import("typebox").TOptional<import("typebox").TString>;
+    custom: import("typebox").TOptional<import("typebox").TBoolean>;
+    name: import("typebox").TOptional<import("typebox").TString>;
+  }>, import("typebox").TOptional<import("typebox").TString>, import("typebox").TObject<import("typebox").TProperties>>;
   /**
    * Push database schema changes directly to the database
    */
-  protected readonly push: _$alepha_command0.CommandPrimitive<_$typebox.TObject<{
-    provider: _$typebox.TOptional<_$typebox.TString>;
-    dryRun: _$typebox.TOptional<_$typebox.TBoolean>;
-  }>, _$typebox.TOptional<_$typebox.TString>, _$typebox.TObject<_$typebox.TProperties>>;
+  protected readonly push: import("alepha/command").CommandPrimitive<import("typebox").TObject<{
+    provider: import("typebox").TOptional<import("typebox").TString>;
+    dryRun: import("typebox").TOptional<import("typebox").TBoolean>;
+  }>, import("typebox").TOptional<import("typebox").TString>, import("typebox").TObject<import("typebox").TProperties>>;
   /**
    * Apply pending database migrations
    */
-  protected readonly apply: _$alepha_command0.CommandPrimitive<_$typebox.TObject<{
-    provider: _$typebox.TOptional<_$typebox.TString>;
-  }>, _$typebox.TOptional<_$typebox.TString>, _$typebox.TObject<_$typebox.TProperties>>;
+  protected readonly apply: import("alepha/command").CommandPrimitive<import("typebox").TObject<{
+    provider: import("typebox").TOptional<import("typebox").TString>;
+  }>, import("typebox").TOptional<import("typebox").TString>, import("typebox").TObject<import("typebox").TProperties>>;
   /**
    * Launch Drizzle Studio database browser
    */
-  protected readonly studio: _$alepha_command0.CommandPrimitive<_$typebox.TObject<{
-    provider: _$typebox.TOptional<_$typebox.TString>;
-  }>, _$typebox.TOptional<_$typebox.TString>, _$typebox.TObject<_$typebox.TProperties>>;
+  protected readonly studio: import("alepha/command").CommandPrimitive<import("typebox").TObject<{
+    provider: import("typebox").TOptional<import("typebox").TString>;
+  }>, import("typebox").TOptional<import("typebox").TString>, import("typebox").TObject<import("typebox").TProperties>>;
   /**
    * Parent command for migration operations.
    */
-  protected readonly migrations: _$alepha_command0.CommandPrimitive<_$typebox.TObject<_$typebox.TProperties>, _$typebox.TSchema, _$typebox.TObject<_$typebox.TProperties>>;
+  protected readonly migrations: import("alepha/command").CommandPrimitive<import("typebox").TObject<import("typebox").TProperties>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
   /**
    * Parent command for database operations.
    */
-  readonly db: _$alepha_command0.CommandPrimitive<_$typebox.TObject<_$typebox.TProperties>, _$typebox.TSchema, _$typebox.TObject<_$typebox.TProperties>>;
+  readonly db: import("alepha/command").CommandPrimitive<import("typebox").TObject<import("typebox").TProperties>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
   /**
    * Run a drizzle-kit command for all database providers in an Alepha instance.
    */
@@ -2433,7 +2603,7 @@ type OnAlephaLoadedHook = (alepha: Alepha, server: ViteDevServer) => Promise<voi
  * - Shared changes → Reload Alepha → Let HMR propagate
  */
 declare class ViteDevServerProvider {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly fs: FileSystemProvider;
   protected readonly colors: ConsoleColorProvider;
   protected readonly viteUtils: ViteUtils;
@@ -2553,7 +2723,17 @@ declare class ViteDevServerProvider {
    */
   protected setupEnvironment(): Promise<void>;
   /**
-   * Invalidate modules and all their importers.
+   * Invalidate modules and all their importers, across both client and
+   * SSR module graphs.
+   *
+   * Vite registers a file under multiple module ids (one per query
+   * variant — e.g. `?v=…`, `?import` and the bare path), and `getModuleById`
+   * only matches one. For workspace-linked source files (`@alepha/ui/...`)
+   * the SSR-graph entry is keyed by the absolute path while the client
+   * may use the package-qualified id. `getModulesByFile` returns every
+   * variant Vite knows about for a given absolute path — invalidating
+   * each catches both halves of the dual graph and prevents stale SSR
+   * compiled exports from surviving across edits.
    */
   protected invalidateModulesWithImporters(changedFiles: Set<string>): void;
   /**
@@ -2588,7 +2768,7 @@ declare class ViteDevServerProvider {
 //#endregion
 //#region ../../src/cli/core/commands/dev.d.ts
 declare class DevCommand {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly fs: FileSystemProvider;
   protected readonly utils: AlephaCliUtils;
   protected readonly pm: PackageManagerUtils;
@@ -2605,9 +2785,9 @@ declare class DevCommand {
    * 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.
    */
-  readonly dev: _$alepha_command0.CommandPrimitive<_$typebox.TObject<{
-    only: _$typebox.TOptional<_$typebox.TString>;
-  }>, _$typebox.TSchema, _$typebox.TObject<_$typebox.TProperties>>;
+  readonly dev: import("alepha/command").CommandPrimitive<import("typebox").TObject<{
+    only: import("typebox").TOptional<import("typebox").TString>;
+  }>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
   /**
    * Discover apps in the workspace root.
    *
@@ -2658,7 +2838,7 @@ declare class DevCommand {
  * - `feat(cli): add command` → included
  */
 declare class GitMessageParser {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   /**
    * Parse a git commit line into a structured Commit object.
    *
@@ -2702,7 +2882,7 @@ interface ChangelogEntry {
  * - `alepha gen changelog | tee -a CHANGELOG.md` - Append to file
  */
 declare class ChangelogCommand {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly git: GitProvider;
   protected readonly parser: GitMessageParser;
   protected readonly config: Readonly<{
@@ -2730,30 +2910,30 @@ declare class ChangelogCommand {
    * Get the latest version tag.
    */
   protected getLatestTag(git: (cmd: string) => Promise<string>): Promise<string | null>;
-  readonly command: _$alepha_command0.CommandPrimitive<_$typebox.TObject<{
+  readonly command: import("alepha/command").CommandPrimitive<import("typebox").TObject<{
     /**
      * Show changes from this ref (tag, commit, branch).
      * Defaults to the latest version tag.
      * Example: --from=1.0.0
      */
-    from: _$typebox.TOptional<_$typebox.TString>;
+    from: import("typebox").TOptional<import("typebox").TString>;
     /**
      * Show changes up to this ref (tag, commit, branch).
      * Defaults to HEAD.
      * Example: --to=main
      */
-    to: _$typebox.TOptional<_$typebox.TString>;
-  }>, _$typebox.TSchema, _$typebox.TObject<_$typebox.TProperties>>;
+    to: import("typebox").TOptional<import("typebox").TString>;
+  }>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/gen/openapi.d.ts
 declare class OpenApiCommand {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly utils: AlephaCliUtils;
   protected readonly fs: FileSystemProvider;
-  readonly command: _$alepha_command0.CommandPrimitive<_$typebox.TObject<{
-    out: _$typebox.TOptional<_$typebox.TString>;
-  }>, _$typebox.TSchema, _$typebox.TObject<_$typebox.TProperties>>;
+  readonly command: import("alepha/command").CommandPrimitive<import("typebox").TObject<{
+    out: import("typebox").TOptional<import("typebox").TString>;
+  }>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/init.d.ts
@@ -2763,46 +2943,75 @@ declare class InitCommand {
    * Ensure the project has the necessary Alepha configuration files.
    * Add the correct dependencies to package.json and install them.
    */
-  readonly init: _$alepha_command0.CommandPrimitive<_$typebox.TObject<{
-    pm: _$typebox.TOptional<_$typebox.TUnsafe<"bun" | "yarn" | "npm" | "pnpm">>;
-    api: _$typebox.TOptional<_$typebox.TBoolean>;
-    react: _$typebox.TOptional<_$typebox.TBoolean>;
-    tailwind: _$typebox.TOptional<_$typebox.TBoolean>;
-    shadcn: _$typebox.TOptional<_$typebox.TUnion<[_$typebox.TBoolean, _$typebox.TString]>>;
-    saas: _$typebox.TOptional<_$typebox.TUnion<[_$typebox.TBoolean, _$typebox.TString]>>;
-    force: _$typebox.TOptional<_$typebox.TBoolean>;
-  }>, _$typebox.TOptional<_$typebox.TString>, _$typebox.TObject<_$typebox.TProperties>>;
+  readonly init: import("alepha/command").CommandPrimitive<import("typebox").TObject<{
+    pm: import("typebox").TOptional<import("typebox").TUnsafe<"bun" | "yarn" | "npm" | "pnpm">>;
+    api: import("typebox").TOptional<import("typebox").TBoolean>;
+    react: import("typebox").TOptional<import("typebox").TBoolean>;
+    tailwind: import("typebox").TOptional<import("typebox").TBoolean>;
+    force: import("typebox").TOptional<import("typebox").TBoolean>;
+  }>, import("typebox").TOptional<import("typebox").TString>, import("typebox").TObject<import("typebox").TProperties>>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/lint.d.ts
 declare class LintCommand {
   protected readonly utils: AlephaCliUtils;
   protected readonly scaffolder: ProjectScaffolder;
-  readonly lint: _$alepha_command0.CommandPrimitive<_$typebox.TObject<_$typebox.TProperties>, _$typebox.TSchema, _$typebox.TObject<_$typebox.TProperties>>;
+  readonly lint: import("alepha/command").CommandPrimitive<import("typebox").TObject<import("typebox").TProperties>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
+}
+//#endregion
+//#region ../../src/cli/core/commands/pack.d.ts
+/**
+ * Pack the workspace into a deployable `tar.gz`.
+ *
+ * The tar contains everything a remote runner (Alepha Rocket, or any
+ * `alepha platform <op> --prebuilt` consumer) needs to deploy the app:
+ *
+ *   dist/                 pre-built output (incl. manifest.json)
+ *   migrations/           SQL files (if present)
+ *
+ * No source, no `alepha.config.ts`, no `package.json` — the deploy
+ * side reads everything from `dist/manifest.json` and never touches
+ * source. Excludes: `node_modules`, `.DS_Store`, macOS AppleDouble
+ * (`._*`), `.alepha` build cache, `e2e`, `playwright-report`,
+ * `coverage`.
+ *
+ * Output name: `<project-name>-<tag>.tar.gz` (default tag
+ * "latest"). Project name comes from `package.json.name`. Naming
+ * mirrors Docker tags — same artifact, different tag = different
+ * file.
+ */
+declare class PackCommand {
+  protected readonly log: import("alepha/logger").Logger;
+  protected readonly fs: FileSystemProvider;
+  protected readonly shell: ShellProvider;
+  readonly pack: import("alepha/command").CommandPrimitive<import("typebox").TObject<{
+    tag: import("typebox").TOptional<import("typebox").TString>;
+    output: import("typebox").TOptional<import("typebox").TString>;
+  }>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/root.d.ts
 declare class RootCommand {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly cli: CliProvider;
   protected readonly alepha: Alepha;
   protected readonly color: ConsoleColorProvider;
   /**
    * Called when no command is provided
    */
-  readonly root: _$alepha_command0.CommandPrimitive<_$typebox.TObject<{
-    version: _$typebox.TOptional<_$typebox.TBoolean>;
-  }>, _$typebox.TSchema, _$typebox.TObject<_$typebox.TProperties>>;
+  readonly root: import("alepha/command").CommandPrimitive<import("typebox").TObject<{
+    version: import("typebox").TOptional<import("typebox").TBoolean>;
+  }>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/test.d.ts
 declare class TestCommand {
   protected readonly utils: AlephaCliUtils;
   protected readonly scaffolder: ProjectScaffolder;
-  readonly test: _$alepha_command0.CommandPrimitive<_$typebox.TObject<{
-    config: _$typebox.TOptional<_$typebox.TString>;
-  }>, _$typebox.TOptional<_$typebox.TString>, _$typebox.TObject<{
-    VITEST_ARGS: _$typebox.TOptional<_$typebox.TString>;
+  readonly test: import("alepha/command").CommandPrimitive<import("typebox").TObject<{
+    config: import("typebox").TOptional<import("typebox").TString>;
+  }>, import("typebox").TOptional<import("typebox").TString>, import("typebox").TObject<{
+    VITEST_ARGS: import("typebox").TOptional<import("typebox").TString>;
   }>>;
 }
 //#endregion
@@ -2813,7 +3022,7 @@ declare class TypecheckCommand {
   /**
    * Run TypeScript type checking across the codebase with no emit.
    */
-  readonly typecheck: _$alepha_command0.CommandPrimitive<_$typebox.TObject<_$typebox.TProperties>, _$typebox.TSchema, _$typebox.TObject<_$typebox.TProperties>>;
+  readonly typecheck: import("alepha/command").CommandPrimitive<import("typebox").TObject<import("typebox").TProperties>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/verify.d.ts
@@ -2833,14 +3042,14 @@ declare class VerifyCommand {
    * - Build the project
    * - Clean the project again
    */
-  readonly verify: _$alepha_command0.CommandPrimitive<_$typebox.TObject<_$typebox.TProperties>, _$typebox.TSchema, _$typebox.TObject<_$typebox.TProperties>>;
+  readonly verify: import("alepha/command").CommandPrimitive<import("typebox").TObject<import("typebox").TProperties>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
 }
 //#endregion
 //#region ../../src/cli/core/providers/AlephaCliExtensionProvider.d.ts
 declare class AlephaCliExtensionProvider {
   protected readonly alepha: Alepha;
   protected readonly fs: FileSystemProvider;
-  protected readonly onConfigure: _$alepha.HookPrimitive<"configure">;
+  protected readonly onConfigure: import("alepha").HookPrimitive<"configure">;
 }
 //#endregion
 //#region ../../src/cli/core/index.d.ts
@@ -2848,11 +3057,11 @@ declare class AlephaCliExtensionProvider {
  * Services, providers, and build tasks — no commands.
  * Use this module when you need CLI utilities without registering commands.
  */
-declare const AlephaCliServices: _$alepha.Service<_$alepha.Module>;
+declare const AlephaCliServices: import("alepha").Service<import("alepha").Module>;
 /**
  * Full CLI module — all services and commands.
  */
-declare const AlephaCli: _$alepha.Service<_$alepha.Module>;
+declare const AlephaCli: import("alepha").Service<import("alepha").Module>;
 //#endregion
-export { AlephaCli, AlephaCliExtensionProvider, AlephaCliServices, AlephaCliUtils, AppEntry, AppEntryOptions, AppEntryProvider, BufferedLogger, BuildAssetsTask, BuildClientTask, BuildCloudflareTask, BuildCommand, BuildCompressTask, BuildDockerTask, BuildOptions, BuildPrerenderTask, BuildRuntime, BuildServerTask, BuildSitemapTask, BuildStaticTask, BuildTarget, BuildTask, BuildTaskContext, BuildVercelTask, ChangelogCommand, type ChangelogOptions, CleanCommand, Commit, CompressOptions, DEFAULT_IGNORE, DbCommand, DependencyModes, DevCommand, DevOptions, DevServerOptions, GitMessageParser, GitProvider, InitCommand, LintCommand, OnAlephaLoadedHook, OpenApiCommand, PackageManagerUtils, PreloadManifest, ProjectScaffolder, RootCommand, TestCommand, TypecheckCommand, VerifyCommand, ViteBuildProvider, ViteDevServerProvider, ViteUtils, WorkspaceContext, alephaPackageJson, appEntryOptions, buildOptions, changelogOptions, devOptions, version };
+export { AlephaCli, AlephaCliExtensionProvider, AlephaCliServices, AlephaCliUtils, AppEntry, AppEntryOptions, AppEntryProvider, BufferedLogger, BuildAssetsTask, BuildClientTask, BuildCloudflareTask, BuildCommand, BuildCompressTask, BuildDockerTask, BuildManifest, BuildOptions, BuildPrerenderTask, BuildRuntime, BuildServerTask, BuildStaticTask, BuildTarget, BuildTask, BuildTaskContext, BuildVercelTask, ChangelogCommand, ChangelogOptions, CleanCommand, Commit, CompressOptions, DEFAULT_IGNORE, DbCommand, DependencyModes, DevCommand, DevOptions, DevServerOptions, GitMessageParser, GitProvider, InitCommand, LintCommand, OnAlephaLoadedHook, OpenApiCommand, PackCommand, PackageManagerUtils, PreloadManifest, ProjectScaffolder, RootCommand, TestCommand, TypecheckCommand, VerifyCommand, ViteBuildProvider, ViteDevServerProvider, ViteUtils, WorkspaceContext, alephaPackageJson, appEntryOptions, buildOptions, changelogOptions, devOptions, version };
 //# sourceMappingURL=index.d.ts.map