alchemy 2.0.0-beta.25 → 2.0.0-beta.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alchemy",
-  "version": "2.0.0-beta.25",
+  "version": "2.0.0-beta.27",
   "homepage": "https://alchemy.run",
   "license": "Apache-2.0",
   "author": "Sam Goodwin <sam@alchemy.run>",
@@ -21,7 +21,7 @@
   "sideEffects": false,
   "scripts": {
     "dev": "tsdown --watch",
-    "build": "tsc -b && bun bundle",
+    "build": "bun bundle",
     "bundle": "tsdown",
     "bundle:watch": "tsdown --watch",
     "publish:npm": "cp ../README.md . && bun publish && rm README.md",
@@ -29,204 +29,218 @@
   },
   "exports": {
     ".": {
-      "types": "./src/index.ts",
+      "types": "./lib/index.d.ts",
       "bun": "./src/index.ts",
       "worker": "./src/index.ts",
       "import": "./lib/index.js"
     },
     "./*": {
-      "types": "./src/*.ts",
+      "types": "./lib/*.d.ts",
       "bun": "./src/*.ts",
       "worker": "./src/*.ts",
       "import": "./lib/*.js"
     },
     "./Agent": {
-      "types": "./src/Agent/index.ts",
+      "types": "./lib/Agent/index.d.ts",
       "bun": "./src/Agent/index.ts",
       "worker": "./src/Agent/index.ts",
       "import": "./lib/Agent/index.js"
     },
     "./Auth": {
-      "types": "./src/Auth/index.ts",
+      "types": "./lib/Auth/index.d.ts",
       "bun": "./src/Auth/index.ts",
       "worker": "./src/Auth/index.ts",
       "import": "./lib/Auth/index.js"
     },
     "./AWS": {
-      "types": "./src/AWS/index.ts",
+      "types": "./lib/AWS/index.d.ts",
       "bun": "./src/AWS/index.ts",
       "worker": "./src/AWS/index.ts",
       "import": "./lib/AWS/index.js"
     },
     "./AWS/*": {
-      "types": "./src/AWS/*/index.ts",
+      "types": "./lib/AWS/*/index.d.ts",
       "bun": "./src/AWS/*/index.ts",
       "worker": "./src/AWS/*/index.ts",
       "import": "./lib/AWS/*/index.js"
     },
     "./AWS/Credentials": {
-      "types": "./src/AWS/Credentials/index.ts",
+      "types": "./lib/AWS/Credentials/index.d.ts",
       "bun": "./src/AWS/Credentials/index.ts",
       "worker": "./src/AWS/Credentials/index.ts",
       "import": "./lib/AWS/Credentials/index.js"
     },
     "./AWS/Endpoint": {
-      "types": "./src/AWS/Endpoint/index.ts",
+      "types": "./lib/AWS/Endpoint/index.d.ts",
       "bun": "./src/AWS/Endpoint/index.ts",
       "worker": "./src/AWS/Endpoint/index.ts",
       "import": "./lib/AWS/Endpoint/index.js"
     },
     "./AWS/Region": {
-      "types": "./src/AWS/Region/index.ts",
+      "types": "./lib/AWS/Region/index.d.ts",
       "bun": "./src/AWS/Region/index.ts",
       "worker": "./src/AWS/Region/index.ts",
       "import": "./lib/AWS/Region/index.js"
     },
     "./AWS/Profile": {
-      "types": "./src/AWS/Profile/index.ts",
+      "types": "./lib/AWS/Profile/index.d.ts",
       "bun": "./src/AWS/Profile/index.ts",
       "worker": "./src/AWS/Profile/index.ts",
       "import": "./lib/AWS/Profile/index.js"
     },
     "./AWS/Lambda/*": {
-      "types": "./src/AWS/Lambda/*.ts",
+      "types": "./lib/AWS/Lambda/*.d.ts",
       "bun": "./src/AWS/Lambda/*.ts",
       "worker": "./src/AWS/Lambda/*.ts",
       "import": "./lib/AWS/Lambda/*.js"
     },
     "./Build": {
-      "types": "./src/Build/index.ts",
+      "types": "./lib/Build/index.d.ts",
       "bun": "./src/Build/index.ts",
       "worker": "./src/Build/index.ts",
       "import": "./lib/Build/index.js"
     },
     "./Construct": {
-      "types": "./src/Construct/index.ts",
+      "types": "./lib/Construct/index.d.ts",
       "bun": "./src/Construct/index.ts",
       "worker": "./src/Construct/index.ts",
       "import": "./lib/Construct/index.js"
     },
     "./Bundle": {
-      "types": "./src/Bundle/index.ts",
+      "types": "./lib/Bundle/index.d.ts",
       "bun": "./src/Bundle/index.ts",
       "worker": "./src/Bundle/index.ts",
       "import": "./lib/Bundle/index.js"
     },
     "./ContentType": {
-      "types": "./src/ContentType.ts",
+      "types": "./lib/ContentType.d.ts",
       "bun": "./src/ContentType.ts",
       "worker": "./src/ContentType.ts",
       "import": "./lib/ContentType.js"
     },
+    "./Cli": {
+      "types": "./lib/Cli/index.d.ts",
+      "bun": "./src/Cli/index.ts",
+      "worker": "./src/Cli/index.ts",
+      "import": "./lib/Cli/index.js"
+    },
+    "./Cli/InkCLI": {
+      "types": "./lib/Cli/InkCLI.d.ts",
+      "bun": "./src/Cli/InkCLI.tsx",
+      "worker": "./src/Cli/InkCLI.tsx",
+      "import": "./lib/Cli/InkCLI.js"
+    },
     "./Cloudflare": {
-      "types": "./src/Cloudflare/index.ts",
+      "types": "./lib/Cloudflare/index.d.ts",
       "bun": "./src/Cloudflare/index.ts",
       "worker": "./src/Cloudflare/index.ts",
       "import": "./lib/Cloudflare/index.js"
     },
     "./Cloudflare/Live": {
-      "types": "./src/Cloudflare/Live.ts",
+      "types": "./lib/Cloudflare/Live.d.ts",
       "bun": "./src/Cloudflare/Live.ts",
       "worker": "./src/Cloudflare/Live.ts",
       "import": "./lib/Cloudflare/Live.js"
     },
     "./Cloudflare/*": {
-      "types": "./src/Cloudflare/*/index.ts",
+      "types": "./lib/Cloudflare/*/index.d.ts",
       "bun": "./src/Cloudflare/*/index.ts",
       "worker": "./src/Cloudflare/*/index.ts",
       "import": "./lib/Cloudflare/*/index.js"
     },
     "./Axiom": {
-      "types": "./src/Axiom/index.ts",
+      "types": "./lib/Axiom/index.d.ts",
       "bun": "./src/Axiom/index.ts",
       "worker": "./src/Axiom/index.ts",
       "import": "./lib/Axiom/index.js"
     },
     "./GitHub": {
-      "types": "./src/GitHub/index.ts",
+      "types": "./lib/GitHub/index.d.ts",
       "bun": "./src/GitHub/index.ts",
       "worker": "./src/GitHub/index.ts",
       "import": "./lib/GitHub/index.js"
     },
     "./Endpoint": {
-      "types": "./src/Endpoint/index.ts",
+      "types": "./lib/Endpoint/index.d.ts",
       "bun": "./src/Endpoint/index.ts",
       "worker": "./src/Endpoint/index.ts",
       "import": "./lib/Endpoint/index.js"
     },
     "./Kubernetes": {
-      "types": "./src/Kubernetes/index.ts",
+      "types": "./lib/Kubernetes/index.d.ts",
       "bun": "./src/Kubernetes/index.ts",
       "worker": "./src/Kubernetes/index.ts",
       "import": "./lib/Kubernetes/index.js"
     },
     "./Output": {
-      "types": "./src/Output.ts",
+      "types": "./lib/Output.d.ts",
       "bun": "./src/Output.ts",
       "worker": "./src/Output.ts",
       "import": "./lib/Output.js"
     },
     "./Process": {
-      "types": "./src/Process/index.ts",
+      "types": "./lib/Process/index.d.ts",
       "bun": "./src/Process/index.ts",
       "worker": "./src/Process/index.ts",
       "import": "./lib/Process/index.js"
     },
     "./SQLite": {
-      "types": "./src/SQLite/index.ts",
+      "types": "./lib/SQLite/index.d.ts",
       "bun": "./src/SQLite/index.ts",
       "worker": "./src/SQLite/index.ts",
       "import": "./lib/SQLite/index.js"
     },
     "./TUI": {
-      "types": "./src/TUI/index.ts",
+      "types": "./lib/TUI/index.d.ts",
       "bun": "./src/TUI/index.ts",
       "worker": "./src/TUI/index.ts",
       "import": "./lib/TUI/index.js"
     },
     "./Server": {
-      "types": "./src/Server/index.ts",
+      "types": "./lib/Server/index.d.ts",
       "bun": "./src/Server/index.ts",
       "worker": "./src/Server/index.ts",
       "import": "./lib/Server/index.js"
     },
     "./Stack": {
-      "types": "./src/Stack.ts",
+      "types": "./lib/Stack.d.ts",
       "bun": "./src/Stack.ts",
       "worker": "./src/Stack.ts",
       "import": "./lib/Stack.js"
     },
     "./State": {
-      "types": "./src/State/index.ts",
+      "types": "./lib/State/index.d.ts",
       "bun": "./src/State/index.ts",
       "worker": "./src/State/index.ts",
       "import": "./lib/State/index.js"
     },
     "./State/*": {
-      "types": "./src/State/*.ts",
+      "types": "./lib/State/*.d.ts",
       "bun": "./src/State/*.ts",
       "worker": "./src/State/*.ts",
       "import": "./lib/State/*.js"
     },
     "./Test/Bun": {
-      "types": "./src/Test/Bun.ts",
+      "types": "./lib/Test/Bun.d.ts",
       "bun": "./src/Test/Bun.ts",
       "worker": "./src/Test/Bun.ts",
       "import": "./lib/Test/Bun.js"
     },
     "./Util": {
-      "types": "./src/Util/index.ts",
+      "types": "./lib/Util/index.d.ts",
       "bun": "./src/Util/index.ts",
       "worker": "./src/Util/index.ts",
       "import": "./lib/Util/index.js"
     },
     "./Util/Clank": {
-      "types": "./src/Util/Clank.ts",
+      "types": "./lib/Util/Clank.d.ts",
       "bun": "./src/Util/Clank.ts",
       "worker": "./src/Util/Clank.ts",
       "import": "./lib/Util/Clank.js"
     },
-    "./bin/alchemy.js": "./bin/alchemy.js"
+    "./bin/alchemy.js": "./bin/alchemy.js",
+    "./bin/exec.ts": "./bin/exec.ts",
+    "./bin/exec.js": "./bin/exec.js"
   },
   "publishConfig": {
     "access": "public"
@@ -237,14 +251,14 @@
     "@ai-sdk/provider": "^3.0.8",
     "@aws-sdk/credential-providers": "^3.0.0",
     "@clack/prompts": "^0.11.0",
-    "@distilled.cloud/aws": "^0.13.1",
-    "@distilled.cloud/axiom": "^0.13.1",
-    "@distilled.cloud/cloudflare": "^0.13.1",
+    "@distilled.cloud/aws": "^0.15.2",
+    "@distilled.cloud/axiom": "^0.15.2",
+    "@distilled.cloud/cloudflare": "^0.15.2",
     "@distilled.cloud/cloudflare-rolldown-plugin": "0.3.0",
     "@distilled.cloud/cloudflare-runtime": "0.1.1",
     "@distilled.cloud/cloudflare-vite-plugin": "0.2.0",
-    "@distilled.cloud/core": "^0.13.1",
-    "@effect/vitest": "4.0.0-beta.58",
+    "@distilled.cloud/core": "^0.15.2",
+    "@effect/vitest": ">=4.0.0-beta.58 || >=4.0.0",
     "@libsql/client": "^0.17.0",
     "@octokit/rest": "^22.0.1",
     "@smithy/node-config-provider": "^4.0.0",
@@ -261,10 +275,14 @@
     "fast-xml-parser": "^5.3.4",
     "foreground-child": "^4.0.3",
     "ignore": "^7.0.5",
+    "ink": "^6.3.1",
     "jszip": "^3.10.1",
     "libsodium-wrappers": "^0.8.3",
     "magic-string": "^0.30.21",
+    "pathe": "^2.0.3",
     "picomatch": "^4.0.4",
+    "proper-lockfile": "^4.1.2",
+    "react": "^19.2.0",
     "rolldown": "1.0.0-rc.17",
     "sonda": "^0.11.1",
     "web-tree-sitter": "0.25.10",
@@ -274,31 +292,29 @@
   "devDependencies": {
     "@clack/prompts": "^0.11.0",
     "@cloudflare/workers-types": "^4.20250805.0",
-    "@effect/platform-bun": "4.0.0-beta.58",
-    "@effect/platform-node": "4.0.0-beta.58",
-    "@effect/platform-node-shared": "4.0.0-beta.58",
+    "@effect/platform-bun": ">=4.0.0-beta.58 || >=4.0.0",
+    "@effect/platform-node": ">=4.0.0-beta.58 || >=4.0.0",
+    "@effect/platform-node-shared": ">=4.0.0-beta.58 || >=4.0.0",
     "@oxc-project/types": "^0.127.0",
     "@types/aws-lambda": "^8.10.152",
     "@types/bun": "latest",
     "@types/node": "latest",
     "@types/picomatch": "^4.0.0",
+    "@types/proper-lockfile": "^4.1.4",
     "@types/react": "^19.2.2",
     "better-auth": "^1.6.2",
-    "effect": "4.0.0-beta.58",
-    "ink": "^6.3.1",
-    "pathe": "^2.0.3",
-    "react": "^19.2.0",
+    "effect": ">=4.0.0-beta.58 || >=4.0.0",
     "react-devtools-core": "^7.0.1",
     "solid-js": "latest",
     "tsconfig-paths": "^4.2.0",
     "tsdown": "^0.15.4",
     "tsx": "^4.20.6",
-    "typescript": "^5.9.3"
+    "typescript": "^6.0.3"
   },
   "peerDependencies": {
-    "@effect/platform-bun": "4.0.0-beta.58",
-    "@effect/platform-node": "4.0.0-beta.58",
-    "effect": "4.0.0-beta.58",
+    "@effect/platform-bun": ">=4.0.0-beta.58 || >=4.0.0",
+    "@effect/platform-node": ">=4.0.0-beta.58 || >=4.0.0",
+    "effect": ">=4.0.0-beta.58 || >=4.0.0",
     "vite": "^8.0.7"
   },
   "peerDependenciesMeta": {

package/src/Auth/AuthProvider.ts

@@ -2,6 +2,17 @@ import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Schema from "effect/Schema";
+import { withLock } from "./Lock.ts";
+
+/**
+ * Methods on an {@link AuthProviderImpl} that mutate (or could trigger
+ * mutation of) on-disk credentials. The factory wraps these in a
+ * cross-process file lock keyed by `(profileName, providerName)` so that
+ * concurrent processes never refresh / write credentials simultaneously.
+ *
+ * `prettyPrint` is intentionally excluded: it's read-only display.
+ */
+const LOCKED_METHODS = new Set(["read", "login", "logout", "configure"]);
 
 export class AuthError extends Schema.TaggedErrorClass<AuthError>()(
   "AuthError",
@@ -129,10 +140,17 @@ export const AuthProvider =
             kind: "AuthProvider",
             name,
             ...Object.fromEntries(
-              Object.entries(service).map(([name, fn]) => [
-                name,
-                (...args: Parameters<typeof fn>) =>
-                  fn(...args).pipe(Effect.provideContext(ctx)),
+              Object.entries(service).map(([methodName, fn]) => [
+                methodName,
+                (...args: Parameters<typeof fn>) => {
+                  const eff = (fn as any)(...args).pipe(
+                    Effect.provideContext(ctx),
+                  );
+                  if (!LOCKED_METHODS.has(methodName)) return eff;
+                  // First positional arg is always `profileName`.
+                  const profileName = args[0] as string;
+                  return withLock(`${profileName}-${name}`, eff);
+                },
               ]),
             ),
           } as AuthProvider<Config, Credentials>),

package/src/Auth/Lock.ts

@@ -0,0 +1,35 @@
+import * as Effect from "effect/Effect";
+import * as fs from "node:fs/promises";
+import * as path from "pathe";
+import lockfile from "proper-lockfile";
+import { rootDir } from "./Profile.ts";
+
+const lockDir = path.join(rootDir, "lock");
+
+/**
+ * Serialise execution of `effect` so no two callers ever run inside the
+ * critical section concurrently for the same `key`, both within this
+ * process and across other processes on the same machine.
+ *
+ * Uses `proper-lockfile` for both: it tracks in-process holders by path
+ * (so same-process callers wait via `retries`) and uses an OS file lock
+ * for cross-process coordination, with stale-lock detection at 60s.
+ */
+export const withLock = <A, E, R>(
+  key: string,
+  effect: Effect.Effect<A, E, R>,
+): Effect.Effect<A, E, R> => {
+  const lockPath = path.join(lockDir, `${key}.lock`);
+  return Effect.acquireUseRelease(
+    Effect.promise(async () => {
+      await fs.mkdir(lockDir, { recursive: true });
+      await fs.writeFile(lockPath, "", { flag: "a" });
+      return await lockfile.lock(lockPath, {
+        retries: { retries: 600, minTimeout: 50, maxTimeout: 50 },
+        stale: 5_000,
+      });
+    }),
+    () => effect,
+    (release) => Effect.promise(() => release().catch(() => {})),
+  );
+};

package/{bin → src/Cli}/commands/_shared.ts

@@ -9,10 +9,10 @@ import * as Argument from "effect/unstable/cli/Argument";
 import * as CliError from "effect/unstable/cli/CliError";
 import * as Flag from "effect/unstable/cli/Flag";
 
-import { AuthError } from "../../src/Auth/AuthProvider.ts";
-import type * as Stack from "../../src/Stack.ts";
-import { recordCli } from "../../src/Telemetry/Metrics.ts";
-import { PromptCancelled } from "../../src/Util/Clank.ts";
+import { AuthError } from "../../Auth/AuthProvider";
+import type * as Stack from "../../Stack";
+import { recordCli } from "../../Telemetry/Metrics";
+import { PromptCancelled } from "../../Util/Clank";
 
 export const USER = Config.string("USER").pipe(
   Config.orElse(() => Config.string("USERNAME")),
@@ -131,7 +131,7 @@ export const force = Flag.boolean("force").pipe(
   Flag.withDefault(false),
 );
 
-export const main = Argument.file("main", {
+export const script = Argument.file("main", {
   mustExist: true,
 }).pipe(
   Argument.withDescription("Main file to deploy, defaults to alchemy.run.ts"),

package/{bin → src/Cli}/commands/bootstrap.ts

@@ -14,18 +14,18 @@ import type { HttpClient } from "effect/unstable/http/HttpClient";
 import {
   bootstrap as bootstrapAws,
   destroyBootstrap as destroyBootstrapAws,
-} from "../../src/AWS/Bootstrap.ts";
-import * as AWSCredentials from "../../src/AWS/Credentials.ts";
-import * as AWSEnvironment from "../../src/AWS/Environment.ts";
-import * as AWSRegion from "../../src/AWS/Region.ts";
-import { AuthProviders } from "../../src/Auth/AuthProvider.ts";
-import { withProfileOverride } from "../../src/Auth/Profile.ts";
-import { CloudflareAuth } from "../../src/Cloudflare/Auth/AuthProvider.ts";
-import * as CloudflareCredentials from "../../src/Cloudflare/Credentials.ts";
-import * as CloudflareEnvironment from "../../src/Cloudflare/CloudflareEnvironment.ts";
-import { bootstrap as bootstrapCloudflare } from "../../src/Cloudflare/StateStore/State.ts";
-import { loadConfigProvider } from "../../src/Util/ConfigProvider.ts";
-import { fileLogger } from "../../src/Util/FileLogger.ts";
+} from "../../AWS/Bootstrap";
+import * as AWSCredentials from "../../AWS/Credentials";
+import * as AWSEnvironment from "../../AWS/Environment";
+import * as AWSRegion from "../../AWS/Region";
+import { AuthProviders } from "../../Auth/AuthProvider";
+import { withProfileOverride } from "../../Auth/Profile";
+import { CloudflareAuth } from "../../Cloudflare/Auth/AuthProvider";
+import * as CloudflareEnvironment from "../../Cloudflare/CloudflareEnvironment";
+import * as CloudflareCredentials from "../../Cloudflare/Credentials";
+import { bootstrap as bootstrapCloudflare } from "../../Cloudflare/StateStore/State";
+import { loadConfigProvider } from "../../Util/ConfigProvider";
+import { fileLogger } from "../../Util/FileLogger";
 
 import { envFile, instrumentCommand, profile } from "./_shared.ts";
 
@@ -65,7 +65,9 @@ const bootstrapAwsCommand = Command.make(
     }),
   )(
     Effect.fnUntraced(function* ({ envFile, profile, region, destroy }) {
-      const logger = Logger.layer([fileLogger("bootstrap.txt")]);
+      const logger = Logger.layer([fileLogger("bootstrap.txt")], {
+        mergeWithExisting: true,
+      });
 
       return yield* Effect.gen(function* () {
         const ssoProfile = yield* Auth.loadProfile(profile);
@@ -168,7 +170,9 @@ const bootstrapCloudflareCommand = Command.make(
     }),
   )(
     Effect.fnUntraced(function* ({ envFile, profile, force, workerName }) {
-      const logger = Logger.layer([fileLogger("bootstrap.txt")]);
+      const logger = Logger.layer([fileLogger("bootstrap.txt")], {
+        mergeWithExisting: true,
+      });
 
       // Wire up the same Cloudflare auth chain that
       // `Cloudflare.state(...)` uses internally. CloudflareAuth is an

package/{bin → src/Cli}/commands/deploy.ts

@@ -8,17 +8,17 @@ import * as Schema from "effect/Schema";
 import * as Command from "effect/unstable/cli/Command";
 import * as Flag from "effect/unstable/cli/Flag";
 
-import { AdoptPolicy } from "../../src/AdoptPolicy.ts";
-import { AlchemyContext } from "../../src/AlchemyContext.ts";
-import { apply } from "../../src/Apply.ts";
-import { ArtifactStore, createArtifactStore } from "../../src/Artifacts.ts";
-import { AuthProviders } from "../../src/Auth/AuthProvider.ts";
-import { withProfileOverride } from "../../src/Auth/Profile.ts";
-import * as CLI from "../../src/Cli/index.ts";
-import * as Plan from "../../src/Plan.ts";
-import { Stage } from "../../src/Stage.ts";
-import { loadConfigProvider } from "../../src/Util/ConfigProvider.ts";
-import { fileLogger } from "../../src/Util/FileLogger.ts";
+import { AdoptPolicy } from "../../AdoptPolicy";
+import { AlchemyContext } from "../../AlchemyContext";
+import { apply } from "../../Apply";
+import { ArtifactStore, createArtifactStore } from "../../Artifacts";
+import { AuthProviders } from "../../Auth/AuthProvider";
+import { withProfileOverride } from "../../Auth/Profile";
+import * as CLI from "../../Cli/Cli.ts";
+import * as Plan from "../../Plan";
+import { Stage } from "../../Stage";
+import { loadConfigProvider } from "../../Util/ConfigProvider";
+import { fileLogger } from "../../Util/FileLogger";
 
 import {
   dryRun as dryRunFlag,
@@ -26,8 +26,8 @@ import {
   force,
   importStack,
   instrumentCommand,
-  main,
   profile,
+  script,
   stage,
   yes,
 } from "./_shared.ts";
@@ -106,7 +106,7 @@ export const execStack = Effect.fn(function* ({
     ConfigProvider.layer(
       withProfileOverride(yield* loadConfigProvider(envFile), profile),
     ),
-    Logger.layer([fileLogger("out")]),
+    Logger.layer([fileLogger("out")], { mergeWithExisting: true }),
     Layer.succeed(Stage, stage),
   );
 
@@ -163,7 +163,7 @@ export const deployCommand = Command.make(
   {
     dryRun: dryRunFlag,
     force,
-    main,
+    main: script,
     envFile,
     stage,
     yes,
@@ -177,7 +177,7 @@ export const destroyCommand = Command.make(
   "destroy",
   {
     dryRun: dryRunFlag,
-    main,
+    main: script,
     envFile,
     stage,
     yes,
@@ -197,7 +197,7 @@ export const destroyCommand = Command.make(
 export const planCommand = Command.make(
   "plan",
   {
-    main,
+    main: script,
     envFile,
     stage,
     profile,

package/{bin → src/Cli}/commands/dev.ts

@@ -3,14 +3,24 @@ import * as Schema from "effect/Schema";
 import * as Command from "effect/unstable/cli/Command";
 import * as ChildProcess from "effect/unstable/process/ChildProcess";
 import { fileURLToPath } from "node:url";
-import { envFile, force, main, profile, stage } from "./_shared.ts";
+import { envFile, force, profile, script, stage } from "./_shared.ts";
 import { ExecStackOptions } from "./deploy.ts";
 
+// Source iteration uses unbundled exec.ts so --watch sees source-file changes;
+// published installs use the bundled exec.js so react/ink/pathe stay
+// devDependencies (matching the CLI bundle's intent). Detect which world we're
+// in by whether dev.ts (or the alchemy.js bundle that contains it) lives
+// inside a node_modules tree — same heuristic as bin/cli.js.
+const selfPath = fileURLToPath(import.meta.url);
+const isInstalled =
+  selfPath.includes("/node_modules/") || selfPath.includes("\\node_modules\\");
+const execEntry = isInstalled ? "alchemy/bin/exec.js" : "alchemy/bin/exec.ts";
+
 export const devCommand = Command.make(
   "dev",
   {
     force,
-    main,
+    main: script,
     envFile,
     stage,
     profile,
@@ -28,7 +38,7 @@ export const devCommand = Command.make(
         "run",
         "--watch",
         "--no-clear-screen",
-        fileURLToPath(import.meta.resolve("../exec.ts")),
+        fileURLToPath(import.meta.resolve(execEntry)),
       ],
       {
         stdin: "inherit",