alepha 0.20.3 → 0.20.5

package/src/bucket/providers/NodeS3BucketProvider.ts

@@ -0,0 +1,218 @@
+import { Buffer } from "node:buffer";
+import {
+  $env,
+  $hook,
+  $inject,
+  Alepha,
+  AlephaError,
+  type FileLike,
+  type Static,
+  t,
+} from "alepha";
+import { $logger } from "alepha/logger";
+import { FileDetector, FileSystemProvider } from "alepha/system";
+import { S3mini } from "s3mini";
+import { FileNotFoundError } from "../errors/FileNotFoundError.ts";
+import { $bucket } from "../primitives/$bucket.ts";
+import type { FileStorageProvider } from "./FileStorageProvider.ts";
+
+const envSchema = t.object({
+  /**
+   * S3 endpoint URL. The bucket name is appended (path-style) per request.
+   *
+   * Examples:
+   * - AWS S3: `https://s3.us-east-1.amazonaws.com`
+   * - Cloudflare R2: `https://<account-id>.r2.cloudflarestorage.com`
+   * - MinIO: `http://localhost:9000`
+   * - DigitalOcean Spaces: `https://<region>.digitaloceanspaces.com`
+   */
+  S3_ENDPOINT: t.string(),
+
+  /**
+   * AWS region or "auto" for R2.
+   *
+   * @default "auto"
+   */
+  S3_REGION: t.optional(t.string()),
+
+  /**
+   * Access key ID for S3 authentication.
+   */
+  S3_ACCESS_KEY_ID: t.string(),
+
+  /**
+   * Secret access key for S3 authentication.
+   */
+  S3_SECRET_ACCESS_KEY: t.string(),
+});
+
+declare module "alepha" {
+  interface Env extends Partial<Static<typeof envSchema>> {}
+}
+
+/**
+ * S3-compatible file storage provider for Node.js.
+ *
+ * Backed by `s3mini` (zero-dep, ~20 KB). Works with AWS S3, Cloudflare R2,
+ * MinIO, DigitalOcean Spaces, Backblaze B2, and any other S3-compatible service.
+ *
+ * Uses path-style addressing (`<endpoint>/<bucket>`).
+ */
+export class NodeS3BucketProvider implements FileStorageProvider {
+  protected readonly log = $logger();
+  protected readonly env = $env(envSchema);
+  protected readonly alepha = $inject(Alepha);
+  protected readonly fileSystem = $inject(FileSystemProvider);
+  protected readonly fileDetector = $inject(FileDetector);
+  protected readonly clients: Map<string, S3mini> = new Map();
+
+  /**
+   * Convert bucket name to S3-compatible format.
+   * S3 bucket names must be lowercase, 3-63 characters, no underscores.
+   */
+  public convertName(name: string): string {
+    return name.replaceAll("/", "-").replaceAll("_", "-").toLowerCase();
+  }
+
+  protected getClient(bucketName: string): S3mini {
+    const name = this.convertName(bucketName);
+    let client = this.clients.get(name);
+    if (!client) {
+      const endpoint = this.env.S3_ENDPOINT.replace(/\/+$/, "");
+      client = new S3mini({
+        accessKeyId: this.env.S3_ACCESS_KEY_ID,
+        secretAccessKey: this.env.S3_SECRET_ACCESS_KEY,
+        region: this.env.S3_REGION || "auto",
+        endpoint: `${endpoint}/${name}`,
+      });
+      this.clients.set(name, client);
+    }
+    return client;
+  }
+
+  protected readonly onStart = $hook({
+    on: "start",
+    handler: async () => {
+      for (const bucket of this.alepha.primitives($bucket)) {
+        if (bucket.provider !== this) {
+          continue;
+        }
+
+        const name = this.convertName(bucket.name);
+        const client = this.getClient(bucket.name);
+
+        this.log.debug(`Preparing S3 bucket '${name}'...`);
+
+        const exists = await client.bucketExists();
+        if (!exists) {
+          this.log.debug(`Creating S3 bucket '${name}'...`);
+          const created = await client.createBucket();
+          if (!created) {
+            throw new AlephaError(`Failed to create S3 bucket '${name}'`);
+          }
+        }
+
+        this.log.info(`S3 bucket '${bucket.name}' OK`);
+      }
+    },
+  });
+
+  protected createId(mimeType: string): string {
+    const ext = this.fileDetector.getExtensionFromMimeType(mimeType);
+    return `${crypto.randomUUID()}.${ext}`;
+  }
+
+  public async upload(
+    bucketName: string,
+    file: FileLike,
+    fileId?: string,
+  ): Promise<string> {
+    fileId ??= this.createId(file.type);
+
+    this.log.trace(
+      `Uploading file '${file.name}' to bucket '${bucketName}' with id '${fileId}'...`,
+    );
+
+    const client = this.getClient(bucketName);
+
+    try {
+      const buffer = new Uint8Array(await file.arrayBuffer());
+      await client.putObject(
+        fileId,
+        buffer,
+        file.type || "application/octet-stream",
+        undefined,
+        { "x-amz-meta-name": encodeURIComponent(file.name) },
+        file.size,
+      );
+
+      this.log.trace(`File uploaded successfully: ${fileId}`);
+      return fileId;
+    } catch (error) {
+      this.log.error(`Failed to upload file: ${error}`);
+      if (error instanceof Error) {
+        throw new AlephaError(`Upload failed: ${error.message}`, {
+          cause: error,
+        });
+      }
+      throw error;
+    }
+  }
+
+  public async download(bucketName: string, fileId: string): Promise<FileLike> {
+    this.log.trace(
+      `Downloading file '${fileId}' from bucket '${bucketName}'...`,
+    );
+
+    const client = this.getClient(bucketName);
+    const response = await client.getObjectResponse(fileId);
+
+    if (!response) {
+      throw new FileNotFoundError(
+        `File '${fileId}' not found in bucket '${bucketName}'`,
+      );
+    }
+
+    const buffer = Buffer.from(await response.arrayBuffer());
+
+    const mimeType =
+      response.headers.get("content-type") ||
+      this.fileDetector.getContentType(fileId);
+
+    const metaName = response.headers.get("x-amz-meta-name");
+    const name = metaName ? decodeURIComponent(metaName) : fileId;
+
+    return this.fileSystem.createFile({
+      buffer,
+      name,
+      type: mimeType,
+      size: buffer.length,
+    });
+  }
+
+  public async exists(bucketName: string, fileId: string): Promise<boolean> {
+    this.log.trace(
+      `Checking existence of file '${fileId}' in bucket '${bucketName}'...`,
+    );
+
+    const client = this.getClient(bucketName);
+    const result = await client.objectExists(fileId);
+    return result === true;
+  }
+
+  public async delete(bucketName: string, fileId: string): Promise<void> {
+    this.log.trace(`Deleting file '${fileId}' from bucket '${bucketName}'...`);
+
+    const client = this.getClient(bucketName);
+
+    try {
+      await client.deleteObject(fileId);
+    } catch (error) {
+      this.log.error(`Failed to delete file: ${error}`);
+      if (error instanceof Error) {
+        throw new FileNotFoundError("Error deleting file", { cause: error });
+      }
+      throw error;
+    }
+  }
+}

package/src/cache/core/index.ts

@@ -12,6 +12,35 @@ export * from "./providers/MemoryCacheProvider.ts";
 
 // ---------------------------------------------------------------------------------------------------------------------
 
+declare module "alepha" {
+  interface Hooks {
+    /**
+     * Fires when a cache lookup finds a value.
+     */
+    "cache:hit": {
+      container: string;
+      key: string;
+    };
+    /**
+     * Fires when a cache lookup does not find a value.
+     */
+    "cache:miss": {
+      container: string;
+      key: string;
+    };
+    /**
+     * Fires when a value is written to the cache.
+     */
+    "cache:set": {
+      container: string;
+      key: string;
+      ttlMs?: number;
+    };
+  }
+}
+
+// ---------------------------------------------------------------------------------------------------------------------
+
 /**
  * Type-safe caching with TTL support.
  *

package/src/cache/core/primitives/$cache.ts

@@ -239,6 +239,12 @@ export class CachePrimitive<
       ttl: px > 0 ? px : undefined,
       compress: this.options.compress,
     });
+
+    await this.alepha.events.emit("cache:set", {
+      container: this.container,
+      key,
+      ttlMs: px > 0 ? px : undefined,
+    });
   }
 
   public async get(key: string): Promise<TReturn | undefined> {
@@ -250,7 +256,14 @@ export class CachePrimitive<
       return undefined;
     }
 
-    return this.provider.getTyped<TReturn>(this.container, key);
+    const value = await this.provider.getTyped<TReturn>(this.container, key);
+
+    await this.alepha.events.emit(
+      value === undefined ? "cache:miss" : "cache:hit",
+      { container: this.container, key },
+    );
+
+    return value;
   }
 
   protected $provider(): CacheProvider {

package/src/cli/config/defineConfig.ts

@@ -1,4 +1,4 @@
-import type { Alepha } from "alepha";
+import type { Alepha, Service } from "alepha";
 import {
   type AppEntryOptions,
   appEntryOptions,
@@ -10,15 +10,6 @@ import {
 
 // ---------------------------------------------------------------------------------------------------------------------
 
-export type AlephaCliConfigPlugin = (
-  config: AlephaCliConfig,
-  alepha: Alepha,
-) => void;
-
-export const cliConfigPlugins: AlephaCliConfigPlugin[] = [];
-
-// ---------------------------------------------------------------------------------------------------------------------
-
 export interface AlephaCliConfig {
   /**
    * Override entry paths.
@@ -28,7 +19,12 @@ export interface AlephaCliConfig {
   /**
    * Register more services to the Alepha CLI (enhancements, commands, etc.).
    */
-  services?: Array<any>;
+  services?: Array<Service>;
+
+  /**
+   * @alias services Register more services to the Alepha CLI (enhancements, commands, etc.).
+   */
+  plugins?: Array<Service>;
 
   /**
    * Configure Alepha build command.
@@ -58,6 +54,12 @@ export const defineConfig = (config: AlephaCliConfig) => {
       }
     }
 
+    if (config.plugins) {
+      for (const it of config.plugins) {
+        alepha.with(it);
+      }
+    }
+
     if (config.env) {
       for (const [key, value] of Object.entries(config.env)) {
         process.env[key] = String(value);
@@ -76,10 +78,6 @@ export const defineConfig = (config: AlephaCliConfig) => {
       alepha.set(appEntryOptions, config.entry);
     }
 
-    for (const plugin of cliConfigPlugins) {
-      plugin(config, alepha);
-    }
-
     return {};
   };
 };

package/src/cli/core/__tests__/init.spec.ts

@@ -98,25 +98,24 @@ describe("alepha init", () => {
   // ─────────────────────────────────────────────────────────────────────────────
 
   describe("AI agent files", () => {
-    it("should create CLAUDE.md when claude CLI is installed", async () => {
-      const { fs, shell, cli, cmd, json } = createTestEnv();
+    it("should create both AGENTS.md and CLAUDE.md", async () => {
+      const { fs, cli, cmd, json } = createTestEnv();
       await setupProject(fs, json);
-      shell.installedCommands.add("claude");
 
       await cli.run(cmd.init, { root: "/project" });
 
+      expect(fs.wasWritten("/project/AGENTS.md")).toBe(true);
       expect(fs.wasWritten("/project/CLAUDE.md")).toBe(true);
-      expect(fs.wasWritten("/project/AGENTS.md")).toBe(false);
     });
 
-    it("should create AGENTS.md when claude CLI is not installed", async () => {
+    it("should write CLAUDE.md as a stub importing AGENTS.md", async () => {
       const { fs, cli, cmd, json } = createTestEnv();
       await setupProject(fs, json);
 
       await cli.run(cmd.init, { root: "/project" });
 
-      expect(fs.wasWritten("/project/AGENTS.md")).toBe(true);
-      expect(fs.wasWritten("/project/CLAUDE.md")).toBe(false);
+      const claude = await fs.readTextFile("/project/CLAUDE.md");
+      expect(claude.trim()).toBe("@AGENTS.md");
     });
 
     it("should include Alepha instructions in agent file", async () => {

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

@@ -3,7 +3,7 @@ import { $inject, AlephaError } from "alepha";
 import type { RunnerMethod } from "alepha/command";
 import { $logger, ConsoleColorProvider } from "alepha/logger";
 import { FileSystemProvider, ShellProvider } from "alepha/system";
-import { type AgentMdOptions, agentMd } from "../templates/agentMd.ts";
+import { agentMd } from "../templates/agentMd.ts";
 import { alephaConfigTs } from "../templates/alephaConfigTs.ts";
 import { apiHelloControllerTs } from "../templates/apiHelloControllerTs.ts";
 import { apiHelloResponseSchemaTs } from "../templates/apiHelloResponseSchemaTs.ts";
@@ -94,7 +94,7 @@ export class ProjectScaffolder {
       tsconfigJson?: boolean | "local";
       biomeJson?: boolean;
       editorconfig?: boolean;
-      agentMd?: false | AgentMdOptions;
+      agentMd?: boolean;
     },
   ): Promise<void> {
     const tasks: Promise<void>[] = [];
@@ -126,7 +126,7 @@ export class ProjectScaffolder {
       tasks.push(this.ensureEditorConfig(root, { force, checkWorkspace }));
     }
     if (opts.agentMd) {
-      tasks.push(this.ensureAgentMd(root, { ...opts.agentMd, force }));
+      tasks.push(this.ensureAgentMd(root, { force }));
     }
 
     await Promise.all(tasks);
@@ -214,12 +214,19 @@ export class ProjectScaffolder {
     return true;
   }
 
+  /**
+   * Ensure AGENTS.md (cross-tool standard, canonical source) exists, with a
+   * CLAUDE.md stub that imports it via Claude Code's `@` syntax. Single
+   * source of truth, cross-platform, no symlink needed.
+   */
   public async ensureAgentMd(
     root: string,
-    options: AgentMdOptions & { force?: boolean },
+    options: { force?: boolean } = {},
   ): Promise<void> {
-    const filename = options.type === "claude" ? "CLAUDE.md" : "AGENTS.md";
-    await this.ensureFile(root, filename, agentMd(options), options.force);
+    await Promise.all([
+      this.ensureFile(root, "AGENTS.md", agentMd(), options.force),
+      this.ensureFile(root, "CLAUDE.md", "@AGENTS.md\n", options.force),
+    ]);
   }
 
   /**
@@ -602,12 +609,9 @@ export class ProjectScaffolder {
     // Detect workspace context (are we inside packages/ or apps/ of a monorepo?)
     const workspace = await this.pm.getWorkspaceContext(root);
 
-    // Detect agent type: claude CLI → CLAUDE.md, else → AGENTS.md
-    let agentType: "claude" | "agents" | false = false;
-    if (!workspace.isPackage) {
-      const hasClaudeCli = await this.utils.isInstalledAsync("claude");
-      agentType = hasClaudeCli ? "claude" : "agents";
-    }
+    // Always emit both AGENTS.md and CLAUDE.md at project roots (skip for
+    // monorepo sub-packages where agent files live at workspace root).
+    const writeAgentMd = !workspace.isPackage;
 
     const isExpo = await this.pm.hasExpo(root);
 
@@ -626,7 +630,7 @@ export class ProjectScaffolder {
           tsconfigJson: f.shadcn ? "local" : !workspace.config.tsconfigJson,
           biomeJson: true,
           editorconfig: !workspace.config.editorconfig,
-          agentMd: agentType ? { type: agentType } : false,
+          agentMd: writeAgentMd,
         });
 
         // Create alepha.config.ts with documented options
@@ -729,7 +733,7 @@ export class ProjectScaffolder {
     // pulls its peer primitives + dependencies (sonner, etc.).
     if (flags.saas) {
       // Pull the public SaaS bundle in one shot — it aggregates control,
-      // auto-form, alepha-table, use-confirm, app-shell, every auth-*, and
+      // auto-form, alepha-table, use-dialog, app-shell, every auth-*, and
       // every admin-* block. Definition lives at
       // https://alepha.dev/r/saas.json (see @alepha/ui-registry).
       // `--yes --overwrite` is the only combo that works non-interactively

package/src/cli/core/tasks/BuildCloudflareTask.ts

@@ -73,6 +73,11 @@ export class BuildCloudflareTask extends BuildTask {
       };
     }
 
+    wrangler.observability ??= {
+      enabled: true,
+      head_sampling_rate: 1,
+    };
+
     this.enhanceDomain(wrangler);
     this.enhanceCron(ctx, wrangler);
     this.enhanceDatabase(wrangler);

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

@@ -1,13 +1,5 @@
-export type AgentMdType = "claude" | "agents";
-
-export interface AgentMdOptions {
-  type: AgentMdType;
-}
-
-export const agentMd = (options: AgentMdOptions): string => {
-  const header = options.type === "claude" ? `# CLAUDE.md` : `# AGENTS.md`;
-
-  return `${header}
+export const agentMd = (): string => {
+  return `# AGENTS.md
 
 This is an **Alepha** project.
 

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

@@ -11,7 +11,7 @@ export const saasAdminLayoutTsx = () =>
   `import { AppShell } from "@/components/app-shell";
 import { Toaster } from "@/components/ui/sonner";
 import { TooltipProvider } from "@/components/ui/tooltip";
-import { ConfirmProvider } from "@/components/use-confirm";
+import { DialogProvider } from "@/components/use-dialog";
 import { NestedView, useRouterState } from "alepha/react/router";
 import { ShieldCheck, Users } from "lucide-react";
 
@@ -39,7 +39,7 @@ const AdminLayout = () => {
 
   return (
     <TooltipProvider>
-      <ConfirmProvider>
+      <DialogProvider>
         <AppShell
           brand={
             <a
@@ -68,7 +68,7 @@ const AdminLayout = () => {
           <NestedView />
         </AppShell>
         <Toaster />
-      </ConfirmProvider>
+      </DialogProvider>
     </TooltipProvider>
   );
 };

package/src/cli/devtools/index.ts

@@ -1,9 +1,8 @@
 import { readFile } from "node:fs/promises";
 import { createRequire } from "node:module";
 import { dirname, join } from "node:path";
-import { $module, AlephaError } from "alepha";
+import { $context, $module, AlephaError } from "alepha";
 import { ViteDevServerProvider } from "alepha/cli";
-import { cliConfigPlugins } from "alepha/cli/config";
 import {
   type DevtoolsOptions,
   devtoolsOptions,
@@ -11,14 +10,6 @@ import {
 
 // ---------------------------------------------------------------------------------------------------------------------
 
-declare module "alepha/cli/config" {
-  interface AlephaCliConfig {
-    devtools?: DevtoolsOptions;
-  }
-}
-
-// ---------------------------------------------------------------------------------------------------------------------
-
 const DEVTOOLS_OVERLAY_SCRIPT = `
 (function () {
   if (window.__alepha_devtools_injected) return;
@@ -29,23 +20,19 @@ const DEVTOOLS_OVERLAY_SCRIPT = `
   // Button
   const btn = document.createElement("button");
   btn.id = "alepha-devtools-btn";
-  btn.innerHTML = \`<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 22c5.523 0 10-4.477 10-10S17.523 2 12 2 2 6.477 2 12s4.477 10 10 10z"/><path d="m14.7 6.3-5.4 5.4a2.1 2.1 0 1 0 3 3l5.4-5.4a2.1 2.1 0 1 0-3-3z"/><path d="m8 16 1.5-1.5"/></svg>\`;
+  btn.innerHTML = \`<svg width="28" height="28" viewBox="0 0 300 300" xmlns="http://www.w3.org/2000/svg"><defs><linearGradient id="adb" x1="142.3" x2="159.6" y1="123.3" y2="176.7" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#33a72c"/><stop offset="1" stop-color="#2d8d40"/></linearGradient><linearGradient id="adc" x1="61.6" x2="100.7" y1="218.5" y2="174" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#298e35"/><stop offset="1" stop-color="#327952"/></linearGradient><linearGradient id="add" x1="262.7" x2="242.2" y1="178.4" y2="220.1" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#32a62d"/><stop offset="1" stop-color="#2d8d40"/></linearGradient><linearGradient id="ade" x1="81.2" x2="69.1" y1="126.7" y2="92.3" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#299a2c"/><stop offset="1" stop-color="#51be40"/></linearGradient><clipPath id="ada"><path fill="none" d="M0 0h300v241H0z"/></clipPath></defs><g fill="none" stroke-miterlimit="10" clip-path="url(#ada)"><path fill="url(#adb)" d="M54 174a182 182 0 0 1 106-51c19-2 37-6 54-15l16-11 3-4 1 1 1 4 1 6v9c0 6-2 12-5 18l-1 4-7 8c-5 7-12 14-19 19l-4 2-11 7v1l-1-1-3 2a120 120 0 0 1-30 8l-8 1-20-1c-21-3-44-10-64 0-5 2-9 4-12 8l-9 9h1l14-9c7-4 15-6 23-7h7l25 3 3 1-2 5-3 5c-4 7-10 14-15 18l-4 3c-12 8-25 12-39 13h-5l-5 1h-8l-7-1H15c0-3 4-7 5-9l7-11 5-8c6-10 14-19 22-28z"/><path fill="#1d524a" d="M178 141c9-1 17-4 24-8l8-4-6 4c-9 7-20 11-32 13l-39 5h-5l-15 3 16 13 18 15-20-1c-21-3-44-10-64 0-5 2-9 4-12 8l-9 9h1l14-9c7-4 15-6 23-7h7l25 3 3 1-2 5-3 5c-4 7-10 14-15 18l-4 3c-12 8-25 12-39 13h-5l-5 1h-8l-7-1H15c0-3 4-7 5-9l7-11 5-8c6-10 14-19 22-28l4-2 23-14 11-5c21-7 43-9 65-9l21-3z"/><path fill="url(#adc)" d="M57 189c7-4 15-6 23-7h7l25 3 3 1-2 5-3 5c-4 7-10 14-15 18l-4 3c-12 8-25 12-39 13h-5l-4-9-2-5 5-2 9-4 10-5 10-4c5-2 10-3 14-6l3-1h-1a1136 1136 0 0 0-43 14c1-6 6-14 9-19 1 0 0 0 0 0z"/><path fill="#2d6f4d" d="m41 216 5-2 9-4 5 3c9 4 18 6 27 4h4c-12 8-25 12-39 13h-5l-4-9-2-5zm16-27s1 0 0 0c-3 5-8 13-9 19l-15 8c0-3 1-9 3-11l3-3 4-4 14-9z"/><path fill="#49b63b" d="M42 198h1l-4 4 3-4z"/><path fill="#2d6f4d" d="m113 154 15-3 11 2 18 8c11 6 23 8 35 5l8-2-11 7v1l-1-1-3 2a120 120 0 0 1-30 8l-8 1-18-15-16-13z"/><path fill="#49b63b" d="M81 158c2-4 11-7 15-8 18-6 36-7 55-8l12-1h15l-21 3c-22 0-44 2-65 9l-11 5z"/><path fill="#2d913b" d="m110 52 2-5 9-14c7-8 19-14 29-18l10-3 12-6 1-1 1 1 1 5v6l6 12 5 10 12 26 2 5 4 10 7 17 4 8c-9 5-20 9-30 12l-16 3-7-14-6-14-5-10-1-3-4 7-13 27-6 11-6 2-24 9 2-4c11-16 14-36 11-56l-3 1-9 5 1-3 9-21 2-5z"/><path fill="#2d6f4d" d="m175 17 6 12 5 10 12 26 2 5 4 10 7 17 4 8c-9 5-20 9-30 12l-16 3-7-14-6-14-5-10-1-3c0-2 5-8 6-10l1-2c9-13 17-28 18-45v-5z"/><path fill="#1d524a" d="m175 17 6 12 5 10 12 26 2 5-3-1-13-8-7 4 3 7-4 1-2-3-5-12-5 7a136 136 0 0 1-10 15l-3 2-1-3c0-2 5-8 6-10l1-2c9-13 17-28 18-45v-5z"/><path fill="#2d6f4d" d="m186 39 12 26 2 5-3-1-13-8-7 4-6-12 8-7 7-7z"/><path fill="#2d913b" d="m177 65 7-4 13 8 3 1 4 10-3 7-7 14-2 8-1-4-6-19a99 99 0 0 0-8-21zm-3 5 2 3 12 32h-1l-8 5c-4 1-9 0-13-2l-1-1c-1-8 2-15 4-22 1-5 2-10 5-15z"/><path fill="#1d524a" d="m110 52 2-5 9-14c7-8 19-14 29-18l10-3 12-6 1-1 1 1c-3 1-3 2-4 4l-11 14-5 5v1c-11 11-22 24-31 37l-5 6-6 11h1l6 12c3 7 8 13 14 17l-6 11-6 2-24 9 2-4c11-16 14-36 11-56l-3 1-9 5 1-3 9-21 2-5z"/><path fill="#49b63b" d="m110 52 2-5 9-14c7-8 19-14 29-18l10-3 12-6 1-1 1 1c-3 1-3 2-4 4l-11 14-5 5-8 7-13 11-5 6c-5-2-10-5-15-3l-3 2z"/><path fill="#2d913b" d="m110 52 3-2c5-2 10 1 15 3l-12 13-6 9-3 1-9 5 1-3 9-21 2-5z"/><path fill="#2d6f4d" d="M121 92c10-5 19-9 28-17l7-6c-1 2-6 8-6 10l-4 7-13 27c-6-4-11-10-14-17l-6-12 4-5 4 13z"/><path fill="#49b63b" d="m154 30-1 11c0 4-3 9-6 12-6 9-19 10-25 19-1 0-3 2-4 1l5-6c9-13 20-26 31-37z"/><path fill="url(#add)" d="m230 135 3 6 11 17 2 5 4 5 3 6 9 14 19 36 4 5c-2 2-19 2-22 2l-5-1h-2c-12 0-25-4-35-10l-4-3c-10-8-15-16-21-27l-7-18v-1l11-7 4-2c7-5 14-12 19-19l7-8z"/><path fill="#1d524a" d="m230 135 3 6 11 17 2 5 4 5 3 6h-1c-10-8-20-9-32-4l23 23 13 12 1 2-20-14-13-12-4-3-5-6c-2 0-2 3-2 5l-1 10c-1 8-2 11 1 19l2 6 2 5c-10-8-15-16-21-27l-7-18v-1l11-7 4-2c7-5 14-12 19-19l7-8z"/><path fill="#2d6f4d" d="m233 141 11 17 2 5 4 5 3 6h-1c-10-8-20-9-32-4l-7-9 15-15 5-5zm-16 76-2-5-2-6c-3-8-2-11-1-19l1-10c0-2 0-5 2-5l5 6 4 3h-1c0 4 8 22 11 26 6 10 15 18 25 22 2 0 3 0 4 2l-5-1h-2c-12 0-25-4-35-10l-4-3z"/><path fill="#2d913b" d="M110 75c3 20 0 40-11 56l-2 4a145 145 0 0 0-43 31l-5 4-11 15v-7l-1-10a143 143 0 0 1 5-29l9-20c13-18 32-29 52-37l4-3 3-4z"/><path fill="url(#ade)" d="m42 139 9-20c13-18 32-29 52-37l4-3-3 7c-4 5-8 11-13 15l-3 3c-6 6-13 12-18 19l-8 11-20 5z"/><path fill="#1d524a" d="M91 101c0 2-4 6-6 8-5 5-10 11-14 18l-9 13-4 9 5 1c4 0 16-9 19-7-10 7-20 14-28 23l-5 4-11 15v-7l-1-10a143 143 0 0 1 5-29l20-5 8-11c5-7 12-13 18-19l3-3z"/><path fill="#2d6f4d" d="m62 134-9 16-3 7-2 4c-3 3-8 5-10 8l-1-1a143 143 0 0 1 5-29l20-5zm0 6 11-5 7-4c5-1 14-2 19 0l-2 4-15 8c-3-2-15 7-19 7l-5-1 4-9z"/></g></svg>\`;
   Object.assign(btn.style, {
-    position: "fixed", bottom: "16px", right: "16px", zIndex: "99998",
+    position: "fixed", bottom: "16px", left: "16px", zIndex: "99998",
     width: "40px", height: "40px", borderRadius: "50%",
-    background: "#1a1a2e", color: "#a0a0c0", border: "1px solid #2a2a4a",
+    background: "#fff", border: "1px solid #2a2a4a",
     cursor: "pointer", display: "flex", alignItems: "center", justifyContent: "center",
     boxShadow: "0 2px 8px rgba(0,0,0,0.3)", transition: "all 0.2s",
     padding: "0", fontSize: "0",
   });
   btn.addEventListener("mouseenter", () => {
-    btn.style.background = "#2a2a4e";
-    btn.style.color = "#c0c0e0";
     btn.style.transform = "scale(1.1)";
   });
   btn.addEventListener("mouseleave", () => {
-    btn.style.background = "#1a1a2e";
-    btn.style.color = "#a0a0c0";
     btn.style.transform = "scale(1)";
   });
 
@@ -110,10 +97,10 @@ const DEVTOOLS_OVERLAY_SCRIPT = `
  *
  * Usage in `alepha.config.ts`:
  * ```ts
- * import { AlephaCliDevtoolsPlugin } from "alepha/devtools/plugin";
+ * import { devtools } from "alepha/cli/devtools";
  *
  * export default defineConfig({
- *   services: [AlephaCliDevtoolsPlugin],
+ *   plugins: [devtools()],
  * });
  * ```
  *
@@ -201,13 +188,12 @@ export const AlephaCliDevtoolsPlugin = $module({
   },
 });
 
-// ---------------------------------------------------------------------------------------------------------------------
-
-cliConfigPlugins.push((config, alepha) => {
-  if (config.devtools) {
-    alepha.set(devtoolsOptions, config.devtools);
-  }
-});
+export const devtools = (options: DevtoolsOptions = {}) => {
+  return () => {
+    const { alepha } = $context();
+    alepha.with(AlephaCliDevtoolsPlugin).set(devtoolsOptions, options);
+  };
+};
 
 // ---------------------------------------------------------------------------------------------------------------------
 

package/src/cli/platform/index.ts

@@ -1,6 +1,5 @@
-import { $module } from "alepha";
+import { $context, $module } from "alepha";
 import { AlephaCli } from "alepha/cli";
-import { cliConfigPlugins } from "alepha/cli/config";
 import { CloudflareAdapter } from "./adapters/CloudflareAdapter.ts";
 import { VercelAdapter } from "./adapters/VercelAdapter.ts";
 import {
@@ -23,14 +22,6 @@ import { WranglerApi } from "./services/WranglerApi.ts";
 
 // ---------------------------------------------------------------------------
 
-declare module "alepha/cli/config" {
-  interface AlephaCliConfig {
-    platform?: PlatformOptions;
-  }
-}
-
-// ---------------------------------------------------------------------------
-
 /**
  * CLI plugin for multi-cloud deployment orchestration.
  *
@@ -51,15 +42,16 @@ declare module "alepha/cli/config" {
  * Configuration in `alepha.config.ts`:
  *
  * ```typescript
- * import { AlephaCliPlatformPlugin } from "alepha/cli/platform";
+ * import { platform } from "alepha/cli/platform";
  *
  * export default defineConfig({
- *   services: [AlephaCliPlatformPlugin],
- *   platform: {
- *     environments: {
- *       production: { adapter: "cloudflare", domain: "myapp.com" },
- *     },
- *   },
+ *   plugins: [
+ *     platform({
+ *       environments: {
+ *         production: { adapter: "cloudflare", domain: "myapp.com" },
+ *       },
+ *     }),
+ *   ],
  * });
  * ```
  */
@@ -85,13 +77,12 @@ export const AlephaCliPlatformPlugin = $module({
   ],
 });
 
-// ---------------------------------------------------------------------------
-
-cliConfigPlugins.push((config, alepha) => {
-  if (config.platform) {
-    alepha.set(platformOptions, config.platform);
-  }
-});
+export const platform = (options: PlatformOptions) => {
+  return () => {
+    const { alepha } = $context();
+    alepha.with(AlephaCliPlatformPlugin).set(platformOptions, options);
+  };
+};
 
 // ---------------------------------------------------------------------------