alepha 0.23.0 → 0.24.0

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

@@ -1,5 +1,5 @@
 import { Alepha, Static } from "alepha";
-import { CliProvider, EnvUtils, Runner, RunnerMethod } from "alepha/command";
+import { CliProvider, EnvUtils, RunnerMethod } from "alepha/command";
 import { ConsoleColorProvider } from "alepha/logger";
 import { FileSystemProvider, ShellProvider } from "alepha/system";
 import { BrotliOptions, ZlibOptions, brotliCompress, gzip } from "node:zlib";
@@ -7,7 +7,6 @@ import { spawn } from "node:child_process";
 import * as vite from "vite";
 import { Logger, Plugin, ViteDevServer } from "vite";
 import { DatabaseProvider } from "alepha/orm";
-
 //#region ../../src/cli/core/alephaPackageJson.d.ts
 declare const alephaPackageJson: {
   name: string;
@@ -26,7 +25,6 @@ declare const alephaPackageJson: {
   files: string[];
   dependencies: {
     "@biomejs/biome": string;
-    "@cloudflare/containers": string;
     "@redis/client": string;
     "@vitejs/plugin-react": string;
     dayjs: string;
@@ -35,11 +33,11 @@ declare const alephaPackageJson: {
     postgres: string;
     s3mini: string;
     tsx: string;
-    typebox: string;
     typescript: string;
     vite: string;
     "vite-bundle-analyzer": string;
     vitest: string;
+    zod: string;
   };
   devDependencies: {
     "@cloudflare/workers-types": string;
@@ -254,12 +252,6 @@ declare const alephaPackageJson: {
       import: string;
       default: string;
     };
-    "./container": {
-      types: string;
-      workerd: string;
-      import: string;
-      default: string;
-    };
     ".": {
       types: string;
       "react-native": string;
@@ -696,12 +688,6 @@ declare const alephaPackageJson: {
         import: string;
         default: string;
       };
-      "./container": {
-        types: string;
-        workerd: string;
-        import: string;
-        default: string;
-      };
       ".": {
         types: string;
         "react-native": string;
@@ -979,11 +965,11 @@ declare const alephaPackageJson: {
 declare const version: string;
 //#endregion
 //#region ../../src/cli/core/atoms/appEntryOptions.d.ts
-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">;
+declare const appEntryOptions: import("alepha").Atom<import("zod").ZodObject<{
+  server: import("zod").ZodOptional<import("zod").ZodString>;
+  browser: import("zod").ZodOptional<import("zod").ZodString>;
+  style: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, "alepha.cli.appEntry.options">;
 type AppEntryOptions = Static<typeof appEntryOptions.schema>;
 //#endregion
 //#region ../../src/cli/core/atoms/buildOptions.d.ts
@@ -1009,247 +995,72 @@ 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: import("alepha").Atom<import("typebox").TObject<{
-  /**
-   * Generate build stats report.
-   *
-   * - `true` - Generate a static HTML report
-   * - `"json"` - Generate a JSON report
-   */
-  stats: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TBoolean, import("typebox").TUnsafe<"json">]>>;
-  /**
-   * Deployment target for the build output.
-   *
-   * - `docker` - Generate Dockerfile for containerized deployment
-   * - `vercel` - Generate Vercel deployment configuration (forces node runtime)
-   * - `cloudflare` - Generate Cloudflare Workers configuration (forces workerd runtime)
-   */
-  target: import("typebox").TOptional<import("typebox").TUnsafe<"bare" | "docker" | "vercel" | "cloudflare" | "static">>;
-  /**
-   * JavaScript runtime for the build output.
-   *
-   * - `node` - Node.js runtime (default)
-   * - `bun` - Bun runtime (uses bun export conditions)
-   * - `workerd` - Cloudflare Workers runtime (auto-set with cloudflare target)
-   *
-   * Note: Some targets force a specific runtime:
-   * - `cloudflare` always uses `workerd`
-   * - `vercel` always uses `node`
-   */
-  runtime: import("typebox").TOptional<import("typebox").TUnsafe<"node" | "bun" | "workerd">>;
-  /**
-   * Output directory configuration.
-   */
-  output: import("typebox").TOptional<import("typebox").TObject<{
-    /**
-     * Root dist directory.
-     *
-     * @default "dist"
-     */
-    dist: import("typebox").TOptional<import("typebox").TString>;
-    /**
-     * Public/client subdirectory.
-     *
-     * @default "public"
-     */
-    public: import("typebox").TOptional<import("typebox").TString>;
+declare const buildOptions: import("alepha").Atom<import("zod").ZodObject<{
+  stats: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodBoolean, import("zod").ZodEnum<{
+    json: "json";
+  }>]>>;
+  target: import("zod").ZodOptional<import("zod").ZodEnum<{
+    bare: "bare";
+    cloudflare: "cloudflare";
+    docker: "docker";
+    static: "static";
+    vercel: "vercel";
   }>>;
-  /**
-   * Vercel-specific deployment configuration.
-   *
-   * Note: Set `target: "vercel"` to enable Vercel deployment.
-   * This object is only for additional configuration.
-   */
-  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;
-      }>>>;
-    }>>;
+  runtime: import("zod").ZodOptional<import("zod").ZodEnum<{
+    bun: "bun";
+    node: "node";
+    workerd: "workerd";
   }>>;
-  /**
-   * Cloudflare-specific deployment configuration.
-   *
-   * Note: Set `target: "cloudflare"` to enable Cloudflare deployment.
-   * This object is only for additional configuration.
-   */
-  cloudflare: import("typebox").TOptional<import("typebox").TObject<{
-    config: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
-  }>>;
-  /**
-   * Docker-specific deployment configuration.
-   *
-   * Note: Set `target: "docker"` to enable Docker deployment.
-   * This object is only for additional configuration.
-   */
-  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: import("typebox").TOptional<import("typebox").TString>;
-    /**
-     * Command to run in the Docker container.
-     *
-     * @default "node" for node runtime
-     * @default "bun" for bun runtime
-     */
-    command: import("typebox").TOptional<import("typebox").TString>;
-    /**
-     * Extra packages to install globally in the generated image.
-     *
-     * Each entry becomes a `RUN npm install --global --no-fund
-     * --no-audit <pkg> …` line inserted after `FROM` and before the
-     * app `COPY`. Use it for CLI tools the running app shells out to
-     * — typical example is `wrangler` for a service that deploys to
-     * Cloudflare on someone else's behalf.
-     *
-     * Ignored in `compile` mode (the distroless base has no `npm`).
-     *
-     * @example install: ["wrangler"]
-     */
-    install: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
-    /**
-     * Docker build options (used when --image flag is passed).
-     */
-    image: import("typebox").TOptional<import("typebox").TObject<{
-      /**
-       * Default image tag (name without version).
-       *
-       * Used when --image is provided without a full override:
-       * - `--image` → `tag:latest`
-       * - `--image=1.3.4` → `tag:1.3.4`
-       * - `--image=other/img:v1` → `other/img:v1` (full override)
-       *
-       * @example "myproject/myapp"
-       * @example "ghcr.io/myorg/myapp"
-       */
-      tag: import("typebox").TString;
-      /**
-       * Additional arguments to pass to `docker build`.
-       *
-       * @example '--platform linux/amd64 --no-cache'
-       */
-      args: import("typebox").TOptional<import("typebox").TString>;
-      /**
-       * Auto-add OCI standard labels (revision, created, version).
-       *
-       * Adds:
-       * - org.opencontainers.image.revision (git commit SHA)
-       * - org.opencontainers.image.created (build timestamp)
-       * - org.opencontainers.image.version (from image tag)
-       */
-      oci: import("typebox").TOptional<import("typebox").TBoolean>;
+  output: import("zod").ZodOptional<import("zod").ZodObject<{
+    dist: import("zod").ZodOptional<import("zod").ZodDefault<import("zod").ZodString>>;
+    public: import("zod").ZodOptional<import("zod").ZodDefault<import("zod").ZodString>>;
+  }, import("zod/v4/core").$strip>>;
+  vercel: import("zod").ZodOptional<import("zod").ZodObject<{
+    projectName: import("zod").ZodOptional<import("zod").ZodString>;
+    orgId: import("zod").ZodOptional<import("zod").ZodString>;
+    projectId: import("zod").ZodOptional<import("zod").ZodString>;
+    config: import("zod").ZodOptional<import("zod").ZodObject<{
+      crons: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+        path: import("zod").ZodString;
+        schedule: import("zod").ZodString;
+      }, import("zod/v4/core").$strip>>>;
+    }, import("zod/v4/core").$strip>>;
+  }, import("zod/v4/core").$strip>>;
+  cloudflare: import("zod").ZodOptional<import("zod").ZodObject<{
+    config: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>>;
+  }, import("zod/v4/core").$strip>>;
+  docker: import("zod").ZodOptional<import("zod").ZodObject<{
+    from: import("zod").ZodOptional<import("zod").ZodString>;
+    command: import("zod").ZodOptional<import("zod").ZodString>;
+    install: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    image: import("zod").ZodOptional<import("zod").ZodObject<{
+      tag: import("zod").ZodString;
+      args: import("zod").ZodOptional<import("zod").ZodString>;
+      oci: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    }, import("zod/v4/core").$strip>>;
+    compile: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodBoolean, import("zod").ZodObject<{
+      target: import("zod").ZodOptional<import("zod").ZodString>;
+      base: import("zod").ZodOptional<import("zod").ZodString>;
+      minify: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    }, import("zod/v4/core").$strip>]>>;
+  }, import("zod/v4/core").$strip>>;
+  static: import("zod").ZodOptional<import("zod").ZodObject<{
+    domain: import("zod").ZodOptional<import("zod").ZodString>;
+  }, import("zod/v4/core").$strip>>;
+  pwa: import("zod").ZodOptional<import("zod").ZodObject<{
+    name: import("zod").ZodString;
+    shortName: import("zod").ZodOptional<import("zod").ZodString>;
+    themeColor: import("zod").ZodOptional<import("zod").ZodString>;
+    backgroundColor: import("zod").ZodOptional<import("zod").ZodString>;
+    display: import("zod").ZodOptional<import("zod").ZodEnum<{
+      browser: "browser";
+      fullscreen: "fullscreen";
+      "minimal-ui": "minimal-ui";
+      standalone: "standalone";
     }>>;
-    /**
-     * Compile the server entry to a single static binary using
-     * `bun build --compile`, then package it inside a minimal base image
-     * (distroless by default). Requires `runtime: "bun"`.
-     *
-     * When enabled:
-     * - the binary is produced at `<dist>/app` and the original `dist/server/`,
-     *   `dist/index.js` and `dist/package.json` are removed
-     * - the generated Dockerfile uses a distroless base image and does not
-     *   run `bun install` (everything is embedded in the binary)
-     * - any non-empty `dependencies` in the externals manifest causes the
-     *   task to fail loudly (compile requires fully-bundled output)
-     *
-     * Pass `true` to enable with defaults, or an object to override.
-     */
-    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`
-       * (AVX2 required).
-       *
-       * @default derived from host arch — always linux-musl.
-       */
-      target: import("typebox").TOptional<import("typebox").TString>;
-      /**
-       * Base image for the generated Dockerfile.
-       *
-       * @default "gcr.io/distroless/static-debian12"
-       */
-      base: import("typebox").TOptional<import("typebox").TString>;
-      /**
-       * Minify the compiled output.
-       *
-       * @default true
-       */
-      minify: import("typebox").TOptional<import("typebox").TBoolean>;
-    }>]>>;
-  }>>;
-  /**
-   * Static site deployment configuration.
-   *
-   * Note: Set `target: "static"` to enable static site generation.
-   */
-  static: import("typebox").TOptional<import("typebox").TObject<{
-    /**
-     * Surge domain for deployment.
-     *
-     * If set, a CNAME file is written to dist/public/.
-     * If not set, a domain is auto-generated from package.json name.
-     *
-     * @example "my-app.surge.sh"
-     * @example "my-custom-domain.com"
-     */
-    domain: import("typebox").TOptional<import("typebox").TString>;
-  }>>;
-  /**
-   * PWA (Progressive Web App) configuration.
-   *
-   * Generates a web app manifest and enables installability.
-   * Requires a client-side bundle (React).
-   */
-  pwa: import("typebox").TOptional<import("typebox").TObject<{
-    /**
-     * Full application name displayed on the splash screen
-     * and in the OS app switcher.
-     */
-    name: import("typebox").TString;
-    /**
-     * Short name displayed on the home screen icon.
-     * Falls back to `name` if omitted.
-     */
-    shortName: import("typebox").TOptional<import("typebox").TString>;
-    /**
-     * Theme color used for the browser toolbar and OS chrome.
-     *
-     * @default "#ffffff"
-     */
-    themeColor: import("typebox").TOptional<import("typebox").TString>;
-    /**
-     * Background color for the splash screen.
-     *
-     * @default "#ffffff"
-     */
-    backgroundColor: import("typebox").TOptional<import("typebox").TString>;
-    /**
-     * Display mode for the installed PWA.
-     *
-     * - `standalone` - Looks like a native app (default)
-     * - `fullscreen` - Uses entire screen (games, immersive)
-     * - `minimal-ui` - Like standalone with minimal browser UI
-     * - `browser` - Standard browser tab
-     *
-     * @default "standalone"
-     */
-    display: import("typebox").TOptional<import("typebox").TUnsafe<"standalone" | "fullscreen" | "minimal-ui" | "browser">>;
-    /**
-     * Enable offline support via service worker.
-     *
-     * TODO: Not yet implemented.
-     */
-    offline: import("typebox").TOptional<import("typebox").TBoolean>;
-  }>>;
-}>, "alepha.cli.build.options">;
+    offline: import("zod").ZodOptional<import("zod").ZodBoolean>;
+  }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, "alepha.cli.build.options">;
 /**
  * Type for build options.
  */
@@ -1273,13 +1084,9 @@ declare const DEFAULT_IGNORE: string[];
  * });
  * ```
  */
-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: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
-}>, "alepha.cli.changelog.options">;
+declare const changelogOptions: import("alepha").Atom<import("zod").ZodObject<{
+  ignore: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+}, import("zod/v4/core").$strip>, "alepha.cli.changelog.options">;
 type ChangelogOptions = Static<typeof changelogOptions.schema>;
 //#endregion
 //#region ../../src/cli/core/atoms/devOptions.d.ts
@@ -1289,12 +1096,9 @@ 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: import("alepha").Atom<import("typebox").TObject<{
-  /**
-   * Disable Vite React plugin.
-   */
-  noViteReactPlugin: import("typebox").TOptional<import("typebox").TBoolean>;
-}>, "alepha.cli.dev.options">;
+declare const devOptions: import("alepha").Atom<import("zod").ZodObject<{
+  noViteReactPlugin: import("zod").ZodOptional<import("zod").ZodDefault<import("zod").ZodBoolean>>;
+}, import("zod/v4/core").$strip>, "alepha.cli.dev.options">;
 /**
  * Type for dev options.
  */
@@ -1309,8 +1113,8 @@ type DevOptions = Static<typeof devOptions.schema>;
 declare class AppEntryProvider {
   protected readonly fs: FileSystemProvider;
   protected readonly options: Readonly<{
-    browser?: string | undefined;
     server?: string | undefined;
+    browser?: string | undefined;
     style?: string | undefined;
   }>;
   protected readonly serverEntries: readonly ["main.server.ts", "main.server.tsx", "main.ts", "main.tsx"];
@@ -1749,12 +1553,7 @@ declare class ProjectScaffolder {
   /**
    * Full project init — scaffolds files, installs deps, sets up PM and git.
    */
-  init({
-    run,
-    root,
-    flags,
-    args
-  }: {
+  init({ run, root, flags, args }: {
     run: RunnerMethod;
     root: string;
     flags: {
@@ -1841,21 +1640,6 @@ interface BuildManifest {
   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
@@ -1886,7 +1670,9 @@ declare class BuildCloudflareTask extends BuildTask {
    * 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 writeManifest(ctx: BuildTaskContext, root: string, distDir: string, name: string): Promise<void>;
+  /** Worker-to-worker service bindings, from CLOUDFLARE_SERVICES (JSON). */
+  protected enhanceServices(wrangler: WranglerConfig): void;
   protected enhanceDomain(wrangler: WranglerConfig): void;
   protected enhanceCron(ctx: BuildTaskContext, wrangler: WranglerConfig): void;
   protected discoverCrons(ctx: BuildTaskContext): string[];
@@ -1898,57 +1684,7 @@ declare class BuildCloudflareTask extends BuildTask {
   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>;
+  protected writeWorkerEntryPoint(root: string, distDir: string): Promise<void>;
 }
 //#endregion
 //#region ../../src/cli/core/tasks/BuildTask.d.ts
@@ -2376,22 +2112,12 @@ declare class BuildCommand {
   protected readonly boot: AppEntryProvider;
   protected readonly viteBuildProvider: ViteBuildProvider;
   protected readonly options: Readonly<{
-    stats?: boolean | "json" | undefined;
-    target?: "bare" | "docker" | "vercel" | "cloudflare" | "static" | undefined;
-    docker?: {
-      from?: string | undefined;
-      command?: string | undefined;
-      install?: string[] | undefined;
-      image?: {
-        args?: string | undefined;
-        oci?: boolean | undefined;
-        tag: string;
-      } | undefined;
-      compile?: boolean | {
-        target?: string | undefined;
-        base?: string | undefined;
-        minify?: boolean | undefined;
-      } | undefined;
+    stats?: "json" | boolean | undefined;
+    target?: "bare" | "cloudflare" | "docker" | "static" | "vercel" | undefined;
+    runtime?: "bun" | "node" | "workerd" | undefined;
+    output?: {
+      dist?: string | undefined;
+      public?: string | undefined;
     } | undefined;
     vercel?: {
       projectName?: string | undefined;
@@ -2407,21 +2133,31 @@ declare class BuildCommand {
     cloudflare?: {
       config?: Record<string, any> | undefined;
     } | undefined;
+    docker?: {
+      from?: string | undefined;
+      command?: string | undefined;
+      install?: string[] | undefined;
+      image?: {
+        tag: string;
+        args?: string | undefined;
+        oci?: boolean | undefined;
+      } | undefined;
+      compile?: boolean | {
+        target?: string | undefined;
+        base?: string | undefined;
+        minify?: boolean | undefined;
+      } | undefined;
+    } | undefined;
     static?: {
       domain?: string | undefined;
     } | undefined;
-    runtime?: "node" | "bun" | "workerd" | undefined;
-    output?: {
-      dist?: string | undefined;
-      public?: string | undefined;
-    } | undefined;
     pwa?: {
+      name: string;
       shortName?: string | undefined;
       themeColor?: string | undefined;
       backgroundColor?: string | undefined;
-      display?: "standalone" | "fullscreen" | "minimal-ui" | "browser" | undefined;
+      display?: "browser" | "fullscreen" | "minimal-ui" | "standalone" | undefined;
       offline?: boolean | undefined;
-      name: string;
     } | undefined;
   }>;
   /**
@@ -2429,7 +2165,7 @@ declare class BuildCommand {
    * Each task self-guards (checks target, hasClient, etc.).
    * Order matters — compress must be last.
    */
-  protected readonly pipeline: (BuildClientTask | BuildServerTask | BuildAssetsTask | BuildPwaTask | BuildPrerenderTask | BuildVercelTask | BuildCloudflareTask | BuildDockerTask | BuildStaticTask | BuildCompressTask)[];
+  protected readonly pipeline: (BuildAssetsTask | BuildClientTask | BuildCloudflareTask | BuildCompressTask | BuildDockerTask | BuildPrerenderTask | BuildPwaTask | BuildServerTask | BuildStaticTask | BuildVercelTask)[];
   /**
    * Value aliases accepted for `--target`.
    *
@@ -2455,14 +2191,27 @@ 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: 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>>;
+  readonly build: import("alepha/command").CommandPrimitive<import("zod").ZodObject<{
+    stats: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodBoolean, import("zod").ZodEnum<{
+      json: "json";
+    }>]>>;
+    target: import("zod").ZodOptional<import("zod").ZodEnum<{
+      bare: "bare";
+      cf: "cf";
+      cloudflare: "cloudflare";
+      docker: "docker";
+      static: "static";
+      vercel: "vercel";
+    }>>;
+    runtime: import("zod").ZodOptional<import("zod").ZodEnum<{
+      bun: "bun";
+      node: "node";
+      workerd: "workerd";
+    }>>;
+    image: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodBoolean, import("zod").ZodString]>>;
+    compile: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    prebuilt: import("zod").ZodOptional<import("zod").ZodBoolean>;
+  }, import("zod/v4/core").$strip>, import("alepha").ZType, import("alepha").TObject>;
   /**
    * Read `dist/manifest.json` produced by a previous `alepha build`.
    * Returns null when absent or unparseable — caller falls back to the
@@ -2476,7 +2225,7 @@ declare class CleanCommand {
   /**
    * Clean the project, removing the "dist" directory
    */
-  readonly clean: import("alepha/command").CommandPrimitive<import("typebox").TObject<import("typebox").TProperties>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
+  readonly clean: import("alepha/command").CommandPrimitive<import("alepha").TObject, import("alepha").ZType, import("alepha").TObject>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/db.d.ts
@@ -2487,48 +2236,47 @@ declare class DbCommand {
   protected readonly pm: PackageManagerUtils;
   protected readonly entryProvider: AppEntryProvider;
   protected readonly viteUtil: ViteUtils;
-  protected readonly runner: Runner;
   /**
    * Check if database migrations are up to date.
    */
-  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>>;
+  protected readonly check: import("alepha/command").CommandPrimitive<import("zod").ZodObject<{
+    provider: import("zod").ZodOptional<import("zod").ZodString>;
+  }, import("zod/v4/core").$strip>, import("zod").ZodOptional<import("zod").ZodString>, import("alepha").TObject>;
   /**
    * Generate database migration files
    */
-  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>>;
+  protected readonly create: import("alepha/command").CommandPrimitive<import("zod").ZodObject<{
+    provider: import("zod").ZodOptional<import("zod").ZodString>;
+    custom: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    name: import("zod").ZodOptional<import("zod").ZodString>;
+  }, import("zod/v4/core").$strip>, import("zod").ZodOptional<import("zod").ZodString>, import("alepha").TObject>;
   /**
    * Push database schema changes directly to the database
    */
-  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>>;
+  protected readonly push: import("alepha/command").CommandPrimitive<import("zod").ZodObject<{
+    provider: import("zod").ZodOptional<import("zod").ZodString>;
+    dryRun: import("zod").ZodOptional<import("zod").ZodBoolean>;
+  }, import("zod/v4/core").$strip>, import("zod").ZodOptional<import("zod").ZodString>, import("alepha").TObject>;
   /**
    * Apply pending database migrations
    */
-  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>>;
+  protected readonly apply: import("alepha/command").CommandPrimitive<import("zod").ZodObject<{
+    provider: import("zod").ZodOptional<import("zod").ZodString>;
+  }, import("zod/v4/core").$strip>, import("zod").ZodOptional<import("zod").ZodString>, import("alepha").TObject>;
   /**
    * Launch Drizzle Studio database browser
    */
-  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>>;
+  protected readonly studio: import("alepha/command").CommandPrimitive<import("zod").ZodObject<{
+    provider: import("zod").ZodOptional<import("zod").ZodString>;
+  }, import("zod/v4/core").$strip>, import("zod").ZodOptional<import("zod").ZodString>, import("alepha").TObject>;
   /**
    * Parent command for migration operations.
    */
-  protected readonly migrations: import("alepha/command").CommandPrimitive<import("typebox").TObject<import("typebox").TProperties>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
+  protected readonly migrations: import("alepha/command").CommandPrimitive<import("alepha").TObject, import("alepha").ZType, import("alepha").TObject>;
   /**
    * Parent command for database operations.
    */
-  readonly db: import("alepha/command").CommandPrimitive<import("typebox").TObject<import("typebox").TProperties>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
+  readonly db: import("alepha/command").CommandPrimitive<import("alepha").TObject, import("alepha").ZType, import("alepha").TObject>;
   /**
    * Run a drizzle-kit command for all database providers in an Alepha instance.
    */
@@ -2547,6 +2295,26 @@ declare class DbCommand {
    * models. This breaks when deploying to a non-public schema via search_path.
    */
   protected stripPublicSchemaFromMigrations(migrationsDir: string): Promise<void>;
+  /**
+   * Refuse a freshly generated migration that drops a table.
+   *
+   * Drizzle rebuilds a SQLite table by dropping and recreating it. On
+   * Cloudflare D1 that is a data-loss bomb: D1 ignores `PRAGMA
+   * foreign_keys=OFF`, so dropping a table that other tables reference with
+   * `ON DELETE CASCADE` silently wipes every child row — with no error, on
+   * deploy, in production.
+   *
+   * The generated file is left on disk on purpose: the point is to force a
+   * human to read it. If the drop really is intended, keep the file and move
+   * on (a re-run detects no schema diff, so nothing is regenerated and this
+   * guard stays quiet).
+   */
+  protected assertNoDestructiveMigrations(migrationsDir: string, files: string[]): Promise<void>;
+  /**
+   * Extract `DROP TABLE` statements from a SQL migration, skipping any that sit
+   * inside a `--` line comment.
+   */
+  protected findDropTableStatements(sql: string): string[];
   /**
    * Prepare Drizzle configuration files for a database provider.
    */
@@ -2785,9 +2553,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: import("alepha/command").CommandPrimitive<import("typebox").TObject<{
-    only: import("typebox").TOptional<import("typebox").TString>;
-  }>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
+  readonly dev: import("alepha/command").CommandPrimitive<import("zod").ZodObject<{
+    only: import("zod").ZodOptional<import("zod").ZodString>;
+  }, import("zod/v4/core").$strip>, import("alepha").ZType, import("alepha").TObject>;
   /**
    * Discover apps in the workspace root.
    *
@@ -2910,20 +2678,10 @@ declare class ChangelogCommand {
    * Get the latest version tag.
    */
   protected getLatestTag(git: (cmd: string) => Promise<string>): Promise<string | null>;
-  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: import("typebox").TOptional<import("typebox").TString>;
-    /**
-     * Show changes up to this ref (tag, commit, branch).
-     * Defaults to HEAD.
-     * Example: --to=main
-     */
-    to: import("typebox").TOptional<import("typebox").TString>;
-  }>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
+  readonly command: import("alepha/command").CommandPrimitive<import("zod").ZodObject<{
+    from: import("zod").ZodOptional<import("zod").ZodString>;
+    to: import("zod").ZodOptional<import("zod").ZodString>;
+  }, import("zod/v4/core").$strip>, import("alepha").ZType, import("alepha").TObject>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/gen/openapi.d.ts
@@ -2931,9 +2689,9 @@ declare class OpenApiCommand {
   protected readonly log: import("alepha/logger").Logger;
   protected readonly utils: AlephaCliUtils;
   protected readonly fs: FileSystemProvider;
-  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>>;
+  readonly command: import("alepha/command").CommandPrimitive<import("zod").ZodObject<{
+    out: import("zod").ZodOptional<import("zod").ZodString>;
+  }, import("zod/v4/core").$strip>, import("alepha").ZType, import("alepha").TObject>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/init.d.ts
@@ -2943,20 +2701,25 @@ declare class InitCommand {
    * Ensure the project has the necessary Alepha configuration files.
    * Add the correct dependencies to package.json and install them.
    */
-  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>>;
+  readonly init: import("alepha/command").CommandPrimitive<import("zod").ZodObject<{
+    pm: import("zod").ZodOptional<import("zod").ZodEnum<{
+      bun: "bun";
+      npm: "npm";
+      pnpm: "pnpm";
+      yarn: "yarn";
+    }>>;
+    api: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    react: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    tailwind: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    force: import("zod").ZodOptional<import("zod").ZodBoolean>;
+  }, import("zod/v4/core").$strip>, import("zod").ZodOptional<import("zod").ZodString>, import("alepha").TObject>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/lint.d.ts
 declare class LintCommand {
   protected readonly utils: AlephaCliUtils;
   protected readonly scaffolder: ProjectScaffolder;
-  readonly lint: import("alepha/command").CommandPrimitive<import("typebox").TObject<import("typebox").TProperties>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
+  readonly lint: import("alepha/command").CommandPrimitive<import("alepha").TObject, import("alepha").ZType, import("alepha").TObject>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/pack.d.ts
@@ -2984,10 +2747,10 @@ 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>>;
+  readonly pack: import("alepha/command").CommandPrimitive<import("zod").ZodObject<{
+    tag: import("zod").ZodOptional<import("zod").ZodString>;
+    output: import("zod").ZodOptional<import("zod").ZodString>;
+  }, import("zod/v4/core").$strip>, import("alepha").ZType, import("alepha").TObject>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/root.d.ts
@@ -2999,20 +2762,20 @@ declare class RootCommand {
   /**
    * Called when no command is provided
    */
-  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>>;
+  readonly root: import("alepha/command").CommandPrimitive<import("zod").ZodObject<{
+    version: import("zod").ZodOptional<import("zod").ZodBoolean>;
+  }, import("zod/v4/core").$strip>, import("alepha").ZType, import("alepha").TObject>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/test.d.ts
 declare class TestCommand {
   protected readonly utils: AlephaCliUtils;
   protected readonly scaffolder: ProjectScaffolder;
-  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>;
-  }>>;
+  readonly test: import("alepha/command").CommandPrimitive<import("zod").ZodObject<{
+    config: import("zod").ZodOptional<import("zod").ZodString>;
+  }, import("zod/v4/core").$strip>, import("zod").ZodOptional<import("zod").ZodString>, import("zod").ZodObject<{
+    VITEST_ARGS: import("zod").ZodOptional<import("zod").ZodDefault<import("zod").ZodString>>;
+  }, import("zod/v4/core").$strip>>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/typecheck.d.ts
@@ -3022,7 +2785,7 @@ declare class TypecheckCommand {
   /**
    * Run TypeScript type checking across the codebase with no emit.
    */
-  readonly typecheck: import("alepha/command").CommandPrimitive<import("typebox").TObject<import("typebox").TProperties>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
+  readonly typecheck: import("alepha/command").CommandPrimitive<import("alepha").TObject, import("alepha").ZType, import("alepha").TObject>;
 }
 //#endregion
 //#region ../../src/cli/core/commands/verify.d.ts
@@ -3042,7 +2805,7 @@ declare class VerifyCommand {
    * - Build the project
    * - Clean the project again
    */
-  readonly verify: import("alepha/command").CommandPrimitive<import("typebox").TObject<import("typebox").TProperties>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
+  readonly verify: import("alepha/command").CommandPrimitive<import("alepha").TObject, import("alepha").ZType, import("alepha").TObject>;
 }
 //#endregion
 //#region ../../src/cli/core/providers/AlephaCliExtensionProvider.d.ts