gigadrive 2.2.0 → 2.3.0

package/dist/index.cjs

@@ -24,15 +24,15 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/index.ts
-var import_cli14 = require("@effect/cli");
+var import_cli15 = require("@effect/cli");
 var import_platform_node = require("@effect/platform-node");
 var import_network_config2 = require("@gigadrive/network-config");
-var import_effect25 = require("effect");
+var import_effect29 = require("effect");
 
 // package.json
 var package_default = {
   name: "gigadrive",
-  version: "2.2.0",
+  version: "2.3.0",
   repository: {
     type: "git",
     url: "https://github.com/Gigadrive/sdk.git",
@@ -158,6 +158,31 @@ var ApplicationNotFoundError = class extends import_effect.Schema.TaggedError()(
   }
 ) {
 };
+var EnvFileReadError = class extends import_effect.Schema.TaggedError()("EnvFileReadError", {
+  message: import_effect.Schema.String,
+  cause: import_effect.Schema.optional(import_effect.Schema.String)
+}) {
+};
+var EnvFileWriteError = class extends import_effect.Schema.TaggedError()("EnvFileWriteError", {
+  message: import_effect.Schema.String,
+  cause: import_effect.Schema.optional(import_effect.Schema.String)
+}) {
+};
+var DevCredentialsStoreReadError = class extends import_effect.Schema.TaggedError()(
+  "DevCredentialsStoreReadError",
+  {
+    message: import_effect.Schema.String
+  }
+) {
+};
+var DevCredentialsStoreWriteError = class extends import_effect.Schema.TaggedError()(
+  "DevCredentialsStoreWriteError",
+  {
+    message: import_effect.Schema.String,
+    cause: import_effect.Schema.optional(import_effect.Schema.String)
+  }
+) {
+};
 var ConfigNotFoundError = class extends import_effect.Schema.TaggedError()("ConfigNotFoundError", {
   message: import_effect.Schema.String,
   directory: import_effect.Schema.String
@@ -323,6 +348,10 @@ var ProjectLink = import_effect2.Schema.Struct({
   applicationId: import_effect2.Schema.String,
   organizationId: import_effect2.Schema.optional(import_effect2.Schema.String)
 });
+var DevKeyEntry = import_effect2.Schema.Struct({
+  apiKeyId: import_effect2.Schema.String
+});
+var DevKeyStore = import_effect2.Schema.Record({ key: import_effect2.Schema.String, value: DevKeyEntry });
 
 // src/services/auth-storage.ts
 var AuthStorageService = class extends import_effect3.Effect.Service()("AuthStorageService", {
@@ -403,7 +432,11 @@ var AuthStorageService = class extends import_effect3.Effect.Service()("AuthStor
 var import_effect4 = require("effect");
 var OAuthEnvConfig = import_effect4.Config.all({
   issuerUrl: import_effect4.Config.string("GIGADRIVE_NETWORK_OAUTH_ISSUER_URL").pipe(import_effect4.Config.withDefault("https://idp.gigadrive.de")),
-  clientId: import_effect4.Config.string("GIGADRIVE_NETWORK_OAUTH_CLIENT_ID").pipe(import_effect4.Config.withDefault("todo_add_client_id"))
+  // Default is the first-party CLI's public OAuth client (seeded in the Network
+  // repo). Override with GIGADRIVE_NETWORK_OAUTH_CLIENT_ID per environment.
+  clientId: import_effect4.Config.string("GIGADRIVE_NETWORK_OAUTH_CLIENT_ID").pipe(
+    import_effect4.Config.withDefault("0195c11c-0000-7000-8000-000000000001")
+  )
 });
 var OpenIdDiscoveryDocument = import_effect4.Schema.Struct({
   issuer: import_effect4.Schema.optional(import_effect4.Schema.String),
@@ -411,7 +444,33 @@ var OpenIdDiscoveryDocument = import_effect4.Schema.Struct({
   token_endpoint: import_effect4.Schema.optional(import_effect4.Schema.String),
   userinfo_endpoint: import_effect4.Schema.optional(import_effect4.Schema.String)
 });
-var DEFAULT_SCOPE = "offline_access openid profile email";
+var CLI_SCOPES = [
+  // Identity / OIDC
+  "offline_access",
+  "openid",
+  "profile",
+  "email",
+  // Network API capabilities
+  "network:applications:read",
+  "network:env_vars:read",
+  "network:env_vars:write",
+  "network:env_vars:delete",
+  "network:deployments:read",
+  "network:deployments:write",
+  "network:deployments:trigger",
+  "network:ai_gateway:chat",
+  "network:ai_gateway:models",
+  "network:ai_gateway:usage:read",
+  "network:ai_gateway:budgets:read",
+  "network:ai_gateway:budgets:write",
+  "network:ai_gateway:policies:read",
+  "network:ai_gateway:policies:write",
+  // Provisioning local-dev API credentials
+  "platform:api_keys:read",
+  "platform:api_keys:write",
+  "platform:api_keys:delete"
+];
+var DEFAULT_SCOPE = CLI_SCOPES.join(" ");
 var OAuthConfigService = class extends import_effect4.Effect.Service()("OAuthConfigService", {
   accessors: true,
   effect: import_effect4.Effect.gen(function* () {
@@ -1555,7 +1614,230 @@ var deploymentsCommand = deploymentsBase.pipe(
 
 // src/commands/env/index.ts
 var import_cli7 = require("@effect/cli");
+var import_effect19 = require("effect");
+
+// src/services/env-file.ts
+var import_platform6 = require("@effect/platform");
 var import_effect16 = require("effect");
+
+// src/lib/dotenv.ts
+var DEFAULT_ENV_HEADER = "# Generated by `gigadrive env pull` \u2014 do not edit by hand.";
+var UNQUOTED_SAFE = /^[A-Za-z0-9_.\-/@:+]*$/;
+var formatEnvValue = (value) => {
+  if (UNQUOTED_SAFE.test(value)) {
+    return value;
+  }
+  const escaped = value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t");
+  return `"${escaped}"`;
+};
+var serializeEnv = (entries, opts) => {
+  const header = opts?.header ?? DEFAULT_ENV_HEADER;
+  if (entries.length === 0) {
+    return `${header}
+`;
+  }
+  const body = entries.map((e) => `${e.key}=${formatEnvValue(e.value)}`).join("\n");
+  return `${header}
+${body}
+`;
+};
+var parseEnv = (content) => {
+  const result = {};
+  for (const rawLine of content.split("\n")) {
+    const line = rawLine.trim();
+    if (line.length === 0 || line.startsWith("#")) {
+      continue;
+    }
+    const eq = line.indexOf("=");
+    if (eq <= 0) {
+      continue;
+    }
+    const key = line.slice(0, eq).trim();
+    let value = line.slice(eq + 1).trim();
+    if (value.length >= 2 && value.startsWith('"') && value.endsWith('"')) {
+      value = value.slice(1, -1).replace(/\\(\\|"|n|r|t)/g, (_, ch) => {
+        switch (ch) {
+          case "n":
+            return "\n";
+          case "r":
+            return "\r";
+          case "t":
+            return "	";
+          case '"':
+            return '"';
+          default:
+            return "\\";
+        }
+      });
+    }
+    result[key] = value;
+  }
+  return result;
+};
+
+// src/services/env-file.ts
+var EnvFileService = class extends import_effect16.Effect.Service()("EnvFileService", {
+  accessors: true,
+  effect: import_effect16.Effect.gen(function* () {
+    const fs = yield* import_platform6.FileSystem.FileSystem;
+    const pathService = yield* import_platform6.Path.Path;
+    const exists = import_effect16.Effect.fn("EnvFileService.exists")(function* (filePath) {
+      return yield* fs.exists(filePath).pipe(import_effect16.Effect.mapError(() => new EnvFileReadError({ message: `Failed to check whether ${filePath} exists` })));
+    });
+    const read = import_effect16.Effect.fn("EnvFileService.read")(function* (filePath) {
+      const present = yield* exists(filePath);
+      if (!present) return import_effect16.Option.none();
+      const contents = yield* fs.readFileString(filePath, "utf8").pipe(import_effect16.Effect.mapError(() => new EnvFileReadError({ message: `Failed to read ${filePath}` })));
+      return import_effect16.Option.some(contents);
+    });
+    const write = import_effect16.Effect.fn("EnvFileService.write")(function* (filePath, entries, opts) {
+      const dir = pathService.dirname(filePath);
+      yield* fs.makeDirectory(dir, { recursive: true }).pipe(
+        import_effect16.Effect.mapError(
+          (error) => new EnvFileWriteError({ message: `Failed to create directory for ${filePath}`, cause: String(error) })
+        )
+      );
+      yield* fs.writeFileString(filePath, serializeEnv(entries, opts), { mode: 384 }).pipe(
+        import_effect16.Effect.mapError(
+          (error) => new EnvFileWriteError({ message: `Failed to write ${filePath}`, cause: String(error) })
+        )
+      );
+      yield* fs.chmod(filePath, 384).pipe(
+        import_effect16.Effect.mapError(
+          (error) => new EnvFileWriteError({ message: `Failed to secure ${filePath}`, cause: String(error) })
+        )
+      );
+    });
+    const ensureGitignored = import_effect16.Effect.fn("EnvFileService.ensureGitignored")(function* (dir, entry) {
+      const gitignorePath = pathService.join(dir, ".gitignore");
+      const existing = yield* read(gitignorePath);
+      const current = import_effect16.Option.getOrElse(existing, () => "");
+      const alreadyIgnored = current.split("\n").some((line) => line.trim() === entry);
+      if (alreadyIgnored) {
+        return false;
+      }
+      const separator = current.length > 0 && !current.endsWith("\n") ? "\n" : "";
+      yield* fs.writeFileString(gitignorePath, `${current}${separator}${entry}
+`).pipe(
+        import_effect16.Effect.mapError(
+          (error) => new EnvFileWriteError({ message: "Failed to update .gitignore", cause: String(error) })
+        )
+      );
+      return true;
+    });
+    return { exists, read, write, ensureGitignored };
+  })
+}) {
+};
+
+// src/services/local-credentials.ts
+var import_effect18 = require("effect");
+var os3 = __toESM(require("os"), 1);
+
+// src/services/dev-credentials-store.ts
+var import_platform7 = require("@effect/platform");
+var import_effect17 = require("effect");
+var os2 = __toESM(require("os"), 1);
+var DevCredentialsStore = class extends import_effect17.Effect.Service()("DevCredentialsStore", {
+  accessors: true,
+  effect: import_effect17.Effect.gen(function* () {
+    const fs = yield* import_platform7.FileSystem.FileSystem;
+    const pathService = yield* import_platform7.Path.Path;
+    const homeDir = os2.homedir();
+    const storeDir = pathService.join(homeDir, ".gigadrive");
+    const storeFile = pathService.join(storeDir, "dev-keys.json");
+    const ensureDirectory = import_effect17.Effect.gen(function* () {
+      yield* fs.makeDirectory(storeDir, { recursive: true }).pipe(
+        import_effect17.Effect.mapError(
+          (error) => new DevCredentialsStoreWriteError({ message: "Failed to create ~/.gigadrive", cause: String(error) })
+        )
+      );
+      yield* fs.chmod(storeDir, 448).pipe(
+        import_effect17.Effect.mapError(
+          (error) => new DevCredentialsStoreWriteError({
+            message: "Failed to set ~/.gigadrive permissions",
+            cause: String(error)
+          })
+        )
+      );
+    });
+    const load = import_effect17.Effect.gen(function* () {
+      const present = yield* fs.exists(storeFile).pipe(import_effect17.Effect.mapError(() => new DevCredentialsStoreReadError({ message: "Failed to check dev-keys.json" })));
+      if (!present) return {};
+      const data = yield* fs.readFileString(storeFile, "utf8").pipe(import_effect17.Effect.mapError(() => new DevCredentialsStoreReadError({ message: "Failed to read dev-keys.json" })));
+      const json = yield* import_effect17.Effect.try({
+        try: () => JSON.parse(data),
+        catch: () => new DevCredentialsStoreReadError({ message: "dev-keys.json contains invalid JSON" })
+      });
+      return yield* import_effect17.Schema.decodeUnknown(DevKeyStore)(json).pipe(
+        import_effect17.Effect.mapError(() => new DevCredentialsStoreReadError({ message: "dev-keys.json has an invalid schema" }))
+      );
+    });
+    const get = import_effect17.Effect.fn("DevCredentialsStore.get")(function* (applicationId) {
+      const store = yield* load;
+      const entry = store[applicationId];
+      return entry ? import_effect17.Option.some(entry) : import_effect17.Option.none();
+    });
+    const set = import_effect17.Effect.fn("DevCredentialsStore.set")(function* (applicationId, entry) {
+      const store = yield* load;
+      const next = { ...store, [applicationId]: entry };
+      yield* ensureDirectory;
+      yield* fs.writeFileString(storeFile, `${JSON.stringify(next, null, 2)}
+`, { mode: 384 }).pipe(
+        import_effect17.Effect.mapError(
+          (error) => new DevCredentialsStoreWriteError({ message: "Failed to write dev-keys.json", cause: String(error) })
+        )
+      );
+    });
+    return { get, set };
+  })
+}) {
+};
+
+// src/services/local-credentials.ts
+var DEV_KEY_SCOPES = ["network:env_vars:read"];
+var ApiBaseUrl2 = import_effect18.Config.string("GIGADRIVE_API_BASE_URL").pipe(import_effect18.Config.withDefault("https://api.gigadrive.network"));
+var credentialEntries = (clientId, clientSecret, baseUrl) => [
+  { key: "GIGADRIVE_CLIENT_ID", value: clientId },
+  { key: "GIGADRIVE_CLIENT_SECRET", value: clientSecret },
+  { key: "GIGADRIVE_API_BASE_URL", value: baseUrl }
+];
+var LocalCredentialsService = class extends import_effect18.Effect.Service()("LocalCredentialsService", {
+  accessors: true,
+  dependencies: [ApiClientService.Default, DevCredentialsStore.Default],
+  effect: import_effect18.Effect.gen(function* () {
+    const apiClient = yield* ApiClientService;
+    const store = yield* DevCredentialsStore;
+    const baseUrl = yield* ApiBaseUrl2;
+    const keyName = (applicationId) => `cli-dev:${os3.hostname()}:${applicationId}`;
+    const provision = import_effect18.Effect.fn("LocalCredentialsService.provision")(function* (input) {
+      const stored = yield* store.get(input.applicationId);
+      const existing = input.existingContent ? parseEnv(input.existingContent) : {};
+      const existingClientId = existing["GIGADRIVE_CLIENT_ID"];
+      const existingClientSecret = existing["GIGADRIVE_CLIENT_SECRET"];
+      const canReuse = !input.rotate && existingClientId !== void 0 && existingClientSecret !== void 0 && import_effect18.Option.isSome(stored) && stored.value.apiKeyId === existingClientId;
+      if (canReuse) {
+        return credentialEntries(existingClientId, existingClientSecret, baseUrl);
+      }
+      if (import_effect18.Option.isSome(stored)) {
+        yield* apiClient.request((client) => client.apiKeys.delete(stored.value.apiKeyId)).pipe(import_effect18.Effect.catchTag("ApiRequestError", () => import_effect18.Effect.void));
+      }
+      const created = yield* apiClient.request(
+        (client) => client.apiKeys.create({
+          name: keyName(input.applicationId),
+          applicationId: input.applicationId,
+          scopes: DEV_KEY_SCOPES
+        })
+      );
+      yield* store.set(input.applicationId, { apiKeyId: created.id });
+      return credentialEntries(created.id, created.secret, baseUrl);
+    });
+    return { provision };
+  })
+}) {
+};
+
+// src/commands/env/index.ts
 var appOption3 = import_cli7.Options.text("app").pipe(
   import_cli7.Options.withAlias("a"),
   import_cli7.Options.withDescription("Operate on this application (overrides the linked application)"),
@@ -1578,51 +1860,70 @@ var keyValueArg = import_cli7.Args.text({ name: "key=value" }).pipe(
   import_cli7.Args.withDescription("Variable assignment, e.g. DATABASE_URL=postgres://user:pass@host/db")
 );
 var keyOrIdArg = import_cli7.Args.text({ name: "key-or-id" }).pipe(import_cli7.Args.withDescription("Variable key or ID to remove"));
-var resolveScope = (app, org) => import_effect16.Effect.gen(function* () {
-  if (import_effect16.Option.isSome(org)) {
+var fileArg = import_cli7.Args.text({ name: "file" }).pipe(
+  import_cli7.Args.withDescription("Output file to write (default: .env.local)"),
+  import_cli7.Args.optional
+);
+var environmentOption = import_cli7.Options.text("environment").pipe(
+  import_cli7.Options.withAlias("e"),
+  import_cli7.Options.withDescription("Environment slug to resolve overrides for (e.g. preview). Omit for the local baseline"),
+  import_cli7.Options.optional
+);
+var yesOption = import_cli7.Options.boolean("yes").pipe(
+  import_cli7.Options.withAlias("y"),
+  import_cli7.Options.withDescription("Overwrite an existing file without confirmation")
+);
+var withCredentialsOption = import_cli7.Options.boolean("with-credentials").pipe(
+  import_cli7.Options.withDescription("Also provision API-key credentials so the local app can call the API as this application")
+);
+var rotateOption = import_cli7.Options.boolean("rotate").pipe(
+  import_cli7.Options.withDescription("Force a fresh API key when provisioning credentials, revoking the previous one")
+);
+var resolveScope = (app, org) => import_effect19.Effect.gen(function* () {
+  if (import_effect19.Option.isSome(org)) {
     return { kind: "organization", id: org.value };
   }
   const projectLink = yield* ProjectLinkService;
-  const id = yield* import_effect16.Option.match(app, {
-    onSome: (value) => import_effect16.Effect.succeed(value),
-    onNone: () => projectLink.resolve(process.cwd()).pipe(import_effect16.Effect.map((link) => link.applicationId))
+  const id = yield* import_effect19.Option.match(app, {
+    onSome: (value) => import_effect19.Effect.succeed(value),
+    onNone: () => projectLink.resolve(process.cwd()).pipe(import_effect19.Effect.map((link) => link.applicationId))
   });
   return { kind: "application", id };
 });
 var envListCommand = import_cli7.Command.make(
   "list",
   { app: appOption3, org: orgOption4 },
-  ({ app, org }) => import_effect16.Effect.gen(function* () {
+  ({ app, org }) => import_effect19.Effect.gen(function* () {
     const apiClient = yield* ApiClientService;
     const scope = yield* resolveScope(app, org);
     const { items } = yield* apiClient.request(
       (client) => scope.kind === "organization" ? client.organizations.envVars.list(scope.id) : client.applications.envVars.list(scope.id)
     );
     if (items.length === 0) {
-      yield* import_effect16.Console.log("No environment variables set.");
+      yield* import_effect19.Console.log("No environment variables set.");
       return;
     }
     for (const v of items) {
-      yield* import_effect16.Console.log(`${v.key}=${v.sensitive ? "***" : v.value ?? ""}`);
+      yield* import_effect19.Console.log(`${v.key}=${v.sensitive ? "***" : v.value ?? ""}`);
     }
   }).pipe(
-    import_effect16.Effect.catchTags({
-      NotAuthenticatedError: (err) => import_effect16.Console.error('You are not logged in. Run "gigadrive login" to authenticate.').pipe(
-        import_effect16.Effect.andThen(import_effect16.Effect.fail(err))
+    import_effect19.Effect.catchTags({
+      NotAuthenticatedError: (err) => import_effect19.Console.error('You are not logged in. Run "gigadrive login" to authenticate.').pipe(
+        import_effect19.Effect.andThen(import_effect19.Effect.fail(err))
       ),
-      ApiRequestError: (err) => import_effect16.Console.error(`Failed to list environment variables: ${err.message}`).pipe(import_effect16.Effect.andThen(import_effect16.Effect.fail(err))),
-      ProjectNotLinkedError: (err) => import_effect16.Console.error(err.message).pipe(import_effect16.Effect.andThen(import_effect16.Effect.fail(err))),
-      ProjectLinkReadError: (err) => import_effect16.Console.error(err.message).pipe(import_effect16.Effect.andThen(import_effect16.Effect.fail(err)))
+      ApiRequestError: (err) => import_effect19.Console.error(`Failed to list environment variables: ${err.message}`).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err))),
+      ProjectNotLinkedError: (err) => import_effect19.Console.error(err.message).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err))),
+      ProjectLinkReadError: (err) => import_effect19.Console.error(err.message).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err)))
     })
   )
 );
 var envSetCommand = import_cli7.Command.make(
   "set",
   { keyValue: keyValueArg, app: appOption3, org: orgOption4, sensitive: sensitiveOption, env: envIdOption },
-  ({ keyValue, app, org, sensitive, env }) => import_effect16.Effect.gen(function* () {
+  ({ keyValue, app, org, sensitive, env }) => import_effect19.Effect.gen(function* () {
     const separator = keyValue.indexOf("=");
     if (separator <= 0) {
-      return yield* import_effect16.Effect.fail(
+      return yield* import_effect19.Effect.fail(
         new InvalidEnvVarFormatError({
           message: 'Invalid format. Use KEY=VALUE, e.g. "gigadrive env set DATABASE_URL=postgres://...".'
         })
@@ -1632,27 +1933,27 @@ var envSetCommand = import_cli7.Command.make(
     const value = keyValue.slice(separator + 1);
     const apiClient = yield* ApiClientService;
     const scope = yield* resolveScope(app, org);
-    const environmentId = import_effect16.Option.getOrUndefined(env);
+    const environmentId = import_effect19.Option.getOrUndefined(env);
     const created = yield* apiClient.request(
       (client) => scope.kind === "organization" ? client.organizations.envVars.create(scope.id, { key, value, sensitive }) : client.applications.envVars.create(scope.id, { key, value, sensitive, environmentId })
     );
-    yield* import_effect16.Console.log(`Set ${created.key}.`);
+    yield* import_effect19.Console.log(`Set ${created.key}.`);
   }).pipe(
-    import_effect16.Effect.catchTags({
-      InvalidEnvVarFormatError: (err) => import_effect16.Console.error(err.message).pipe(import_effect16.Effect.andThen(import_effect16.Effect.fail(err))),
-      NotAuthenticatedError: (err) => import_effect16.Console.error('You are not logged in. Run "gigadrive login" to authenticate.').pipe(
-        import_effect16.Effect.andThen(import_effect16.Effect.fail(err))
+    import_effect19.Effect.catchTags({
+      InvalidEnvVarFormatError: (err) => import_effect19.Console.error(err.message).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err))),
+      NotAuthenticatedError: (err) => import_effect19.Console.error('You are not logged in. Run "gigadrive login" to authenticate.').pipe(
+        import_effect19.Effect.andThen(import_effect19.Effect.fail(err))
       ),
-      ApiRequestError: (err) => import_effect16.Console.error(`Failed to set environment variable: ${err.message}`).pipe(import_effect16.Effect.andThen(import_effect16.Effect.fail(err))),
-      ProjectNotLinkedError: (err) => import_effect16.Console.error(err.message).pipe(import_effect16.Effect.andThen(import_effect16.Effect.fail(err))),
-      ProjectLinkReadError: (err) => import_effect16.Console.error(err.message).pipe(import_effect16.Effect.andThen(import_effect16.Effect.fail(err)))
+      ApiRequestError: (err) => import_effect19.Console.error(`Failed to set environment variable: ${err.message}`).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err))),
+      ProjectNotLinkedError: (err) => import_effect19.Console.error(err.message).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err))),
+      ProjectLinkReadError: (err) => import_effect19.Console.error(err.message).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err)))
     })
   )
 );
 var envRmCommand = import_cli7.Command.make(
   "rm",
   { keyOrId: keyOrIdArg, app: appOption3, org: orgOption4 },
-  ({ keyOrId, app, org }) => import_effect16.Effect.gen(function* () {
+  ({ keyOrId, app, org }) => import_effect19.Effect.gen(function* () {
     const apiClient = yield* ApiClientService;
     const scope = yield* resolveScope(app, org);
     const { items } = yield* apiClient.request(
@@ -1660,32 +1961,106 @@ var envRmCommand = import_cli7.Command.make(
     );
     const target = items.find((v) => v.id === keyOrId || v.key === keyOrId);
     if (target === void 0) {
-      return yield* import_effect16.Effect.fail(
+      return yield* import_effect19.Effect.fail(
         new EnvVarNotFoundError({ message: `No environment variable matching "${keyOrId}".` })
       );
     }
     yield* apiClient.request(
       (client) => scope.kind === "organization" ? client.organizations.envVars.delete(scope.id, target.id) : client.applications.envVars.delete(scope.id, target.id)
     );
-    yield* import_effect16.Console.log(`Removed ${target.key}.`);
+    yield* import_effect19.Console.log(`Removed ${target.key}.`);
+  }).pipe(
+    import_effect19.Effect.catchTags({
+      EnvVarNotFoundError: (err) => import_effect19.Console.error(err.message).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err))),
+      NotAuthenticatedError: (err) => import_effect19.Console.error('You are not logged in. Run "gigadrive login" to authenticate.').pipe(
+        import_effect19.Effect.andThen(import_effect19.Effect.fail(err))
+      ),
+      ApiRequestError: (err) => import_effect19.Console.error(`Failed to remove environment variable: ${err.message}`).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err))),
+      ProjectNotLinkedError: (err) => import_effect19.Console.error(err.message).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err))),
+      ProjectLinkReadError: (err) => import_effect19.Console.error(err.message).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err)))
+    })
+  )
+);
+var envPullCommand = import_cli7.Command.make(
+  "pull",
+  {
+    file: fileArg,
+    app: appOption3,
+    environment: environmentOption,
+    yes: yesOption,
+    withCredentials: withCredentialsOption,
+    rotate: rotateOption
+  },
+  ({ file, app, environment, yes, withCredentials, rotate }) => import_effect19.Effect.gen(function* () {
+    const apiClient = yield* ApiClientService;
+    const projectLink = yield* ProjectLinkService;
+    const envFile = yield* EnvFileService;
+    const applicationId = yield* import_effect19.Option.match(app, {
+      onSome: (value) => import_effect19.Effect.succeed(value),
+      onNone: () => projectLink.resolve(process.cwd()).pipe(import_effect19.Effect.map((link) => link.applicationId))
+    });
+    const target = import_effect19.Option.getOrElse(file, () => ".env.local");
+    const environmentSlug = import_effect19.Option.getOrUndefined(environment);
+    const { items, omittedSensitive } = yield* apiClient.request(
+      (client) => client.applications.envVars.pull(applicationId, environmentSlug ? { environment: environmentSlug } : void 0)
+    );
+    const existing = yield* envFile.read(target);
+    if (import_effect19.Option.isSome(existing) && !yes) {
+      const overwrite = yield* import_cli7.Prompt.run(
+        import_cli7.Prompt.confirm({ message: `${target} already exists. Overwrite?`, initial: false })
+      );
+      if (!overwrite) {
+        return yield* import_effect19.Console.log("Cancelled.");
+      }
+    }
+    let credentialEntries2 = [];
+    if (withCredentials) {
+      const localCredentials = yield* LocalCredentialsService;
+      credentialEntries2 = yield* localCredentials.provision({
+        applicationId,
+        rotate,
+        existingContent: import_effect19.Option.getOrUndefined(existing)
+      });
+    }
+    const entries = [...items.map((v) => ({ key: v.key, value: v.value })), ...credentialEntries2];
+    yield* envFile.write(target, entries);
+    const gitignored = yield* envFile.ensureGitignored(process.cwd(), target);
+    yield* import_effect19.Console.log(
+      `Pulled ${items.length} environment variable(s)${withCredentials ? " and API credentials" : ""} to ${target}.`
+    );
+    if (omittedSensitive > 0) {
+      yield* import_effect19.Console.log(
+        `Skipped ${omittedSensitive} sensitive variable(s); secrets live only in production/preview environments.`
+      );
+    }
+    if (gitignored) {
+      yield* import_effect19.Console.log(`Added ${target} to .gitignore.`);
+    }
   }).pipe(
-    import_effect16.Effect.catchTags({
-      EnvVarNotFoundError: (err) => import_effect16.Console.error(err.message).pipe(import_effect16.Effect.andThen(import_effect16.Effect.fail(err))),
-      NotAuthenticatedError: (err) => import_effect16.Console.error('You are not logged in. Run "gigadrive login" to authenticate.').pipe(
-        import_effect16.Effect.andThen(import_effect16.Effect.fail(err))
+    import_effect19.Effect.catchTags({
+      // Ctrl+C during the overwrite prompt is a deliberate cancel — exit 0.
+      QuitException: () => import_effect19.Console.log("Cancelled."),
+      NotAuthenticatedError: (err) => import_effect19.Console.error('You are not logged in. Run "gigadrive login" to authenticate.').pipe(
+        import_effect19.Effect.andThen(import_effect19.Effect.fail(err))
       ),
-      ApiRequestError: (err) => import_effect16.Console.error(`Failed to remove environment variable: ${err.message}`).pipe(import_effect16.Effect.andThen(import_effect16.Effect.fail(err))),
-      ProjectNotLinkedError: (err) => import_effect16.Console.error(err.message).pipe(import_effect16.Effect.andThen(import_effect16.Effect.fail(err))),
-      ProjectLinkReadError: (err) => import_effect16.Console.error(err.message).pipe(import_effect16.Effect.andThen(import_effect16.Effect.fail(err)))
+      ApiRequestError: (err) => import_effect19.Console.error(`Failed to pull environment variables: ${err.message}`).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err))),
+      ProjectNotLinkedError: (err) => import_effect19.Console.error(err.message).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err))),
+      ProjectLinkReadError: (err) => import_effect19.Console.error(err.message).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err))),
+      EnvFileReadError: (err) => import_effect19.Console.error(err.message).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err))),
+      EnvFileWriteError: (err) => import_effect19.Console.error(err.message).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err))),
+      DevCredentialsStoreReadError: (err) => import_effect19.Console.error(err.message).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err))),
+      DevCredentialsStoreWriteError: (err) => import_effect19.Console.error(err.message).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err)))
     })
   )
 );
-var envBase = import_cli7.Command.make("env", {}, () => import_effect16.Effect.void);
-var envCommand = envBase.pipe(import_cli7.Command.withSubcommands([envListCommand, envSetCommand, envRmCommand]));
+var envBase = import_cli7.Command.make("env", {}, () => import_effect19.Effect.void);
+var envCommand = envBase.pipe(
+  import_cli7.Command.withSubcommands([envListCommand, envSetCommand, envRmCommand, envPullCommand])
+);
 
 // src/commands/link/index.ts
 var import_cli8 = require("@effect/cli");
-var import_effect17 = require("effect");
+var import_effect20 = require("effect");
 var appOption4 = import_cli8.Options.text("app").pipe(
   import_cli8.Options.withAlias("a"),
   import_cli8.Options.withDescription("Application ID to link (skips the interactive picker)"),
@@ -1699,26 +2074,26 @@ var orgOption5 = import_cli8.Options.text("org").pipe(
 var linkCommand = import_cli8.Command.make(
   "link",
   { app: appOption4, org: orgOption5 },
-  ({ app, org }) => import_effect17.Effect.gen(function* () {
+  ({ app, org }) => import_effect20.Effect.gen(function* () {
     const apiClient = yield* ApiClientService;
     const projectLink = yield* ProjectLinkService;
     const cwd = process.cwd();
-    const organizationId = import_effect17.Option.getOrUndefined(org);
+    const organizationId = import_effect20.Option.getOrUndefined(org);
     const { items: apps } = yield* apiClient.request((client) => client.applications.list({ organizationId }));
     if (apps.length === 0) {
-      return yield* import_effect17.Effect.fail(
+      return yield* import_effect20.Effect.fail(
         new NoApplicationsFoundError({
           message: 'No applications found. Create one in the Gigadrive console, then run "gigadrive link" again.'
         })
       );
     }
-    const explicitAppId = import_effect17.Option.getOrUndefined(app);
+    const explicitAppId = import_effect20.Option.getOrUndefined(app);
     let applicationId;
     let linkedOrganizationId;
     if (explicitAppId !== void 0) {
       const match = apps.find((a) => a.id === explicitAppId);
       if (match === void 0) {
-        return yield* import_effect17.Effect.fail(
+        return yield* import_effect20.Effect.fail(
           new ApplicationNotFoundError({
             message: `Application "${explicitAppId}" was not found among your applications.`
           })
@@ -1740,106 +2115,106 @@ var linkCommand = import_cli8.Command.make(
       linkedOrganizationId = chosen.organization.id;
     }
     yield* projectLink.save(cwd, { applicationId, organizationId: linkedOrganizationId });
-    yield* import_effect17.Console.log(`Linked this directory to application ${applicationId}.`);
-    yield* import_effect17.Console.log('Tip: add ".gigadrive/" to your .gitignore.');
+    yield* import_effect20.Console.log(`Linked this directory to application ${applicationId}.`);
+    yield* import_effect20.Console.log('Tip: add ".gigadrive/" to your .gitignore.');
   }).pipe(
-    import_effect17.Effect.catchTags({
+    import_effect20.Effect.catchTags({
       // Ctrl+C during the picker is a deliberate cancel — exit 0.
-      QuitException: () => import_effect17.Console.log("Cancelled."),
-      NotAuthenticatedError: (err) => import_effect17.Console.error('You are not logged in. Run "gigadrive login" to authenticate.').pipe(
-        import_effect17.Effect.andThen(import_effect17.Effect.fail(err))
+      QuitException: () => import_effect20.Console.log("Cancelled."),
+      NotAuthenticatedError: (err) => import_effect20.Console.error('You are not logged in. Run "gigadrive login" to authenticate.').pipe(
+        import_effect20.Effect.andThen(import_effect20.Effect.fail(err))
       ),
-      ApiRequestError: (err) => import_effect17.Console.error(`Failed to list applications: ${err.message}`).pipe(import_effect17.Effect.andThen(import_effect17.Effect.fail(err))),
-      NoApplicationsFoundError: (err) => import_effect17.Console.error(err.message).pipe(import_effect17.Effect.andThen(import_effect17.Effect.fail(err))),
-      ApplicationNotFoundError: (err) => import_effect17.Console.error(err.message).pipe(import_effect17.Effect.andThen(import_effect17.Effect.fail(err))),
-      ProjectLinkWriteError: (err) => import_effect17.Console.error(err.message).pipe(import_effect17.Effect.andThen(import_effect17.Effect.fail(err)))
+      ApiRequestError: (err) => import_effect20.Console.error(`Failed to list applications: ${err.message}`).pipe(import_effect20.Effect.andThen(import_effect20.Effect.fail(err))),
+      NoApplicationsFoundError: (err) => import_effect20.Console.error(err.message).pipe(import_effect20.Effect.andThen(import_effect20.Effect.fail(err))),
+      ApplicationNotFoundError: (err) => import_effect20.Console.error(err.message).pipe(import_effect20.Effect.andThen(import_effect20.Effect.fail(err))),
+      ProjectLinkWriteError: (err) => import_effect20.Console.error(err.message).pipe(import_effect20.Effect.andThen(import_effect20.Effect.fail(err)))
     })
   )
 );
 var unlinkCommand = import_cli8.Command.make(
   "unlink",
   {},
-  () => import_effect17.Effect.gen(function* () {
+  () => import_effect20.Effect.gen(function* () {
     const projectLink = yield* ProjectLinkService;
     yield* projectLink.remove(process.cwd());
-    yield* import_effect17.Console.log("Unlinked this directory.");
+    yield* import_effect20.Console.log("Unlinked this directory.");
   }).pipe(
-    import_effect17.Effect.catchTags({
-      ProjectLinkWriteError: (err) => import_effect17.Console.error(err.message).pipe(import_effect17.Effect.andThen(import_effect17.Effect.fail(err)))
+    import_effect20.Effect.catchTags({
+      ProjectLinkWriteError: (err) => import_effect20.Console.error(err.message).pipe(import_effect20.Effect.andThen(import_effect20.Effect.fail(err)))
     })
   )
 );
 
 // src/commands/login/index.ts
 var import_cli9 = require("@effect/cli");
-var import_effect18 = require("effect");
+var import_effect21 = require("effect");
 var loginCommand = import_cli9.Command.make(
   "login",
   {},
-  () => import_effect18.Effect.gen(function* () {
-    yield* import_effect18.Console.log("Initiating login...");
+  () => import_effect21.Effect.gen(function* () {
+    yield* import_effect21.Console.log("Initiating login...");
     const auth = yield* AuthService;
     yield* auth.login;
-    const info = yield* auth.getUserInfo.pipe(import_effect18.Effect.catchAll(() => import_effect18.Effect.succeed({})));
+    const info = yield* auth.getUserInfo.pipe(import_effect21.Effect.catchAll(() => import_effect21.Effect.succeed({})));
     const name = auth.inferUserName(info);
-    yield* import_effect18.Console.log(`You are now logged in as ${name}.`);
+    yield* import_effect21.Console.log(`You are now logged in as ${name}.`);
   }).pipe(
-    import_effect18.Effect.catchTags({
-      LoginFlowError: (err) => import_effect18.Console.error(`Login failed: ${err.message}`),
-      TokenExchangeError: (err) => import_effect18.Console.error(`Login failed: ${err.message}`),
-      OAuthDiscoveryError: (err) => import_effect18.Console.error(`Login failed: ${err.message}`),
-      AuthStorageWriteError: (err) => import_effect18.Console.error(`Failed to save credentials: ${err.message}`)
+    import_effect21.Effect.catchTags({
+      LoginFlowError: (err) => import_effect21.Console.error(`Login failed: ${err.message}`),
+      TokenExchangeError: (err) => import_effect21.Console.error(`Login failed: ${err.message}`),
+      OAuthDiscoveryError: (err) => import_effect21.Console.error(`Login failed: ${err.message}`),
+      AuthStorageWriteError: (err) => import_effect21.Console.error(`Failed to save credentials: ${err.message}`)
     })
   )
 );
 
 // src/commands/logout/index.ts
 var import_cli10 = require("@effect/cli");
-var import_effect19 = require("effect");
+var import_effect22 = require("effect");
 var logoutCommand = import_cli10.Command.make(
   "logout",
   {},
-  () => import_effect19.Effect.gen(function* () {
+  () => import_effect22.Effect.gen(function* () {
     const auth = yield* AuthService;
     yield* auth.logout;
-    yield* import_effect19.Console.log("Logged out.");
+    yield* import_effect22.Console.log("Logged out.");
   }).pipe(
-    import_effect19.Effect.catchTags({
-      AuthStorageWriteError: (err) => import_effect19.Console.error(`Failed to log out: ${err.message}`).pipe(import_effect19.Effect.andThen(import_effect19.Effect.fail(err)))
+    import_effect22.Effect.catchTags({
+      AuthStorageWriteError: (err) => import_effect22.Console.error(`Failed to log out: ${err.message}`).pipe(import_effect22.Effect.andThen(import_effect22.Effect.fail(err)))
     })
   )
 );
 
 // src/commands/platform/index.ts
 var import_cli12 = require("@effect/cli");
-var import_effect23 = require("effect");
+var import_effect26 = require("effect");
 
 // src/commands/platform/deploy/index.ts
 var import_cli11 = require("@effect/cli");
-var import_platform7 = require("@effect/platform");
+var import_platform9 = require("@effect/platform");
 var import_commons = require("@gigadrive/commons");
-var import_effect22 = require("effect");
-var os2 = __toESM(require("os"), 1);
+var import_effect25 = require("effect");
+var os4 = __toESM(require("os"), 1);
 
 // src/services/archive.ts
-var import_platform6 = require("@effect/platform");
+var import_platform8 = require("@effect/platform");
 var import_build_utils3 = require("@gigadrive/build-utils");
 var import_archiver = __toESM(require("archiver"), 1);
-var import_effect20 = require("effect");
+var import_effect23 = require("effect");
 var import_ignore = __toESM(require("ignore"), 1);
 var nodeFs = __toESM(require("fs"), 1);
 var nodeFsPromises = __toESM(require("fs/promises"), 1);
 var IGNORE_FILE_NAMES = [".gigadriveignore", ".vercelignore", ".dockerignore", ".nowignore"];
 var readIgnoreFile = (fs, ignorePath) => fs.readFileString(ignorePath, "utf8").pipe(
-  import_effect20.Effect.map((content) => content.split("\n").filter((line) => line.trim() !== "")),
-  import_effect20.Effect.catchAll(() => import_effect20.Effect.succeed([]))
+  import_effect23.Effect.map((content) => content.split("\n").filter((line) => line.trim() !== "")),
+  import_effect23.Effect.catchAll(() => import_effect23.Effect.succeed([]))
 );
-var collectIgnorePatterns = (fs, pathService, dir, baseDir, ignoreRules) => import_effect20.Effect.gen(function* () {
-  const items = yield* fs.readDirectory(dir).pipe(import_effect20.Effect.mapError(() => new ArchiveCreateError({ message: `Failed to read directory: ${dir}` })));
+var collectIgnorePatterns = (fs, pathService, dir, baseDir, ignoreRules) => import_effect23.Effect.gen(function* () {
+  const items = yield* fs.readDirectory(dir).pipe(import_effect23.Effect.mapError(() => new ArchiveCreateError({ message: `Failed to read directory: ${dir}` })));
   for (const item of items) {
     const fullPath = pathService.join(dir, item);
     const relativePath = pathService.relative(baseDir, fullPath);
-    const stat = yield* import_effect20.Effect.tryPromise({
+    const stat = yield* import_effect23.Effect.tryPromise({
       try: () => nodeFsPromises.lstat(fullPath),
       catch: () => new ArchiveCreateError({ message: `Failed to stat: ${fullPath}` })
     });
@@ -1859,8 +2234,8 @@ var collectIgnorePatterns = (fs, pathService, dir, baseDir, ignoreRules) => impo
       yield* collectIgnorePatterns(fs, pathService, fullPath, baseDir, ignoreRules);
     }
   }
-}).pipe(import_effect20.Effect.catchAll(() => import_effect20.Effect.void));
-var initializeIgnoreRules = (fs, pathService, baseDir) => import_effect20.Effect.gen(function* () {
+}).pipe(import_effect23.Effect.catchAll(() => import_effect23.Effect.void));
+var initializeIgnoreRules = (fs, pathService, baseDir) => import_effect23.Effect.gen(function* () {
   const ignoreRules = (0, import_ignore.default)();
   ignoreRules.add([".git/", "**/.DS_Store", "**/Thumbs.db"]);
   for (const ignoreFileName of IGNORE_FILE_NAMES) {
@@ -1875,14 +2250,14 @@ var initializeIgnoreRules = (fs, pathService, baseDir) => import_effect20.Effect
   yield* collectIgnorePatterns(fs, pathService, baseDir, baseDir, ignoreRules);
   return ignoreRules;
 });
-var getFilesToInclude = (fs, pathService, dir, ignoreRules) => import_effect20.Effect.gen(function* () {
+var getFilesToInclude = (fs, pathService, dir, ignoreRules) => import_effect23.Effect.gen(function* () {
   const filesToInclude = [];
-  const walkDir = (currentDir) => import_effect20.Effect.gen(function* () {
-    const items = yield* fs.readDirectory(currentDir).pipe(import_effect20.Effect.mapError(() => new ArchiveCreateError({ message: `Failed to read directory: ${currentDir}` })));
+  const walkDir = (currentDir) => import_effect23.Effect.gen(function* () {
+    const items = yield* fs.readDirectory(currentDir).pipe(import_effect23.Effect.mapError(() => new ArchiveCreateError({ message: `Failed to read directory: ${currentDir}` })));
     for (const item of items) {
       const fullPath = pathService.join(currentDir, item);
       const relativePath = pathService.relative(dir, fullPath);
-      const stat = yield* import_effect20.Effect.tryPromise({
+      const stat = yield* import_effect23.Effect.tryPromise({
         try: () => nodeFsPromises.lstat(fullPath),
         catch: () => new ArchiveCreateError({ message: `Failed to stat: ${fullPath}` })
       });
@@ -1896,21 +2271,21 @@ var getFilesToInclude = (fs, pathService, dir, ignoreRules) => import_effect20.E
         }
       }
     }
-  }).pipe(import_effect20.Effect.catchAll(() => import_effect20.Effect.void));
+  }).pipe(import_effect23.Effect.catchAll(() => import_effect23.Effect.void));
   yield* walkDir(dir);
   return filesToInclude;
 });
-var ArchiveService = class extends import_effect20.Effect.Service()("ArchiveService", {
+var ArchiveService = class extends import_effect23.Effect.Service()("ArchiveService", {
   accessors: true,
-  effect: import_effect20.Effect.gen(function* () {
-    const fs = yield* import_platform6.FileSystem.FileSystem;
-    const pathService = yield* import_platform6.Path.Path;
-    const createZipArchive = import_effect20.Effect.fn("ArchiveService.createZipArchive")(function* (inputDir, outputFile, options = {}) {
-      yield* import_effect20.Effect.annotateCurrentSpan("inputDir", inputDir);
-      yield* import_effect20.Effect.annotateCurrentSpan("outputFile", outputFile);
-      yield* import_effect20.Effect.log("Creating zip archive", { inputDir, outputFile });
+  effect: import_effect23.Effect.gen(function* () {
+    const fs = yield* import_platform8.FileSystem.FileSystem;
+    const pathService = yield* import_platform8.Path.Path;
+    const createZipArchive = import_effect23.Effect.fn("ArchiveService.createZipArchive")(function* (inputDir, outputFile, options = {}) {
+      yield* import_effect23.Effect.annotateCurrentSpan("inputDir", inputDir);
+      yield* import_effect23.Effect.annotateCurrentSpan("outputFile", outputFile);
+      yield* import_effect23.Effect.log("Creating zip archive", { inputDir, outputFile });
       const ignoreRules = options.useIgnoreFiles !== false ? yield* initializeIgnoreRules(fs, pathService, inputDir) : (0, import_ignore.default)();
-      const filesToInclude = options.whitelist ? yield* import_effect20.Effect.tryPromise({
+      const filesToInclude = options.whitelist ? yield* import_effect23.Effect.tryPromise({
         try: () => Promise.all(
           options.whitelist.map((file) => (0, import_build_utils3.getFilesForPattern)(file, inputDir, options.excludeFiles ?? []))
         ),
@@ -1918,25 +2293,25 @@ var ArchiveService = class extends import_effect20.Effect.Service()("ArchiveServ
           message: "Failed to resolve whitelist patterns",
           cause: error instanceof Error ? error.message : String(error)
         })
-      }) : yield* import_effect20.Effect.gen(function* () {
+      }) : yield* import_effect23.Effect.gen(function* () {
         if (options.excludeFiles && options.excludeFiles.length > 0) {
           ignoreRules.add(options.excludeFiles);
         }
         return yield* getFilesToInclude(fs, pathService, inputDir, ignoreRules).pipe(
-          import_effect20.Effect.map((files) => [files])
+          import_effect23.Effect.map((files) => [files])
         );
       });
-      const archiveExists = yield* fs.exists(outputFile).pipe(import_effect20.Effect.catchAll(() => import_effect20.Effect.succeed(false)));
+      const archiveExists = yield* fs.exists(outputFile).pipe(import_effect23.Effect.catchAll(() => import_effect23.Effect.succeed(false)));
       if (archiveExists) {
         yield* fs.remove(outputFile).pipe(
-          import_effect20.Effect.mapError(
+          import_effect23.Effect.mapError(
             (error) => new ArchiveCreateError({
               message: `Failed to remove existing archive: ${String(error)}`
             })
           )
         );
       }
-      yield* import_effect20.Effect.tryPromise({
+      yield* import_effect23.Effect.tryPromise({
         try: () => new Promise((resolve, reject) => {
           const output = nodeFs.createWriteStream(outputFile);
           const archive = (0, import_archiver.default)("zip", { zlib: { level: 9 } });
@@ -1955,14 +2330,14 @@ var ArchiveService = class extends import_effect20.Effect.Service()("ArchiveServ
         })
       });
       const fileInfo = yield* fs.stat(outputFile).pipe(
-        import_effect20.Effect.mapError(
+        import_effect23.Effect.mapError(
           (error) => new ArchiveCreateError({
             message: `Failed to stat archive: ${String(error)}`
           })
         )
       );
       const size = Number(fileInfo.size);
-      yield* import_effect20.Effect.log("Archive created", { size });
+      yield* import_effect23.Effect.log("Archive created", { size });
       return { path: outputFile, size };
     });
     return { createZipArchive };
@@ -1971,32 +2346,32 @@ var ArchiveService = class extends import_effect20.Effect.Service()("ArchiveServ
 };
 
 // src/services/deployment-api.ts
-var import_effect21 = require("effect");
-var DeploymentApiService = class extends import_effect21.Effect.Service()("DeploymentApiService", {
+var import_effect24 = require("effect");
+var DeploymentApiService = class extends import_effect24.Effect.Service()("DeploymentApiService", {
   accessors: true,
   dependencies: [ApiClientService.Default],
-  effect: import_effect21.Effect.gen(function* () {
+  effect: import_effect24.Effect.gen(function* () {
     const apiClient = yield* ApiClientService;
     const getClient = apiClient.getClient.pipe(
-      import_effect21.Effect.mapError((err) => new DeploymentAuthError({ message: `Authentication failed: ${err.message}` }))
+      import_effect24.Effect.mapError((err) => new DeploymentAuthError({ message: `Authentication failed: ${err.message}` }))
     );
-    const createDeployment = import_effect21.Effect.fn("DeploymentApiService.createDeployment")(function* (applicationId) {
-      yield* import_effect21.Effect.annotateCurrentSpan("applicationId", applicationId);
-      yield* import_effect21.Effect.log("Creating deployment", { applicationId });
+    const createDeployment = import_effect24.Effect.fn("DeploymentApiService.createDeployment")(function* (applicationId) {
+      yield* import_effect24.Effect.annotateCurrentSpan("applicationId", applicationId);
+      yield* import_effect24.Effect.log("Creating deployment", { applicationId });
       const client = yield* getClient;
-      const deployment = yield* import_effect21.Effect.tryPromise({
+      const deployment = yield* import_effect24.Effect.tryPromise({
         try: () => client.deployments.create({ applicationId }),
         catch: (error) => new DeploymentCreateError({
           message: `Failed to create deployment: ${error instanceof Error ? error.message : String(error)}`
         })
       });
-      yield* import_effect21.Effect.log("Deployment created", { deploymentId: deployment.id });
+      yield* import_effect24.Effect.log("Deployment created", { deploymentId: deployment.id });
       return deployment.id;
     });
-    const startMultipartUpload = import_effect21.Effect.fn("DeploymentApiService.startMultipartUpload")(function* (deploymentId) {
-      yield* import_effect21.Effect.annotateCurrentSpan("deploymentId", deploymentId);
+    const startMultipartUpload = import_effect24.Effect.fn("DeploymentApiService.startMultipartUpload")(function* (deploymentId) {
+      yield* import_effect24.Effect.annotateCurrentSpan("deploymentId", deploymentId);
       const client = yield* getClient;
-      const result = yield* import_effect21.Effect.tryPromise({
+      const result = yield* import_effect24.Effect.tryPromise({
         try: () => client.deployments.startUpload(deploymentId),
         catch: (error) => new UploadStartError({
           message: `Failed to start multipart upload: ${error instanceof Error ? error.message : String(error)}`
@@ -2004,9 +2379,9 @@ var DeploymentApiService = class extends import_effect21.Effect.Service()("Deplo
       });
       return result.uploadId;
     });
-    const getPresignedUrl = import_effect21.Effect.fn("DeploymentApiService.getPresignedUrl")(function* (deploymentId, uploadId, partNumber) {
+    const getPresignedUrl = import_effect24.Effect.fn("DeploymentApiService.getPresignedUrl")(function* (deploymentId, uploadId, partNumber) {
       const client = yield* getClient;
-      const result = yield* import_effect21.Effect.tryPromise({
+      const result = yield* import_effect24.Effect.tryPromise({
         try: () => client.deployments.getPresignedUrl(deploymentId, uploadId, partNumber),
         catch: (error) => new PresignedUrlError({
           message: `Failed to get presigned URL: ${error instanceof Error ? error.message : String(error)}`,
@@ -2015,11 +2390,11 @@ var DeploymentApiService = class extends import_effect21.Effect.Service()("Deplo
       });
       return result.url;
     });
-    const uploadPart = import_effect21.Effect.fn("DeploymentApiService.uploadPart")(function* (presignedUrl, data, partNumber) {
-      yield* import_effect21.Effect.annotateCurrentSpan("partNumber", partNumber);
-      yield* import_effect21.Effect.annotateCurrentSpan("size", data.length);
+    const uploadPart = import_effect24.Effect.fn("DeploymentApiService.uploadPart")(function* (presignedUrl, data, partNumber) {
+      yield* import_effect24.Effect.annotateCurrentSpan("partNumber", partNumber);
+      yield* import_effect24.Effect.annotateCurrentSpan("size", data.length);
       const client = yield* getClient;
-      const result = yield* import_effect21.Effect.tryPromise({
+      const result = yield* import_effect24.Effect.tryPromise({
         try: () => client.deployments.uploadPart(presignedUrl, data, partNumber),
         catch: (error) => new UploadPartError({
           message: `Failed to upload part ${partNumber}: ${error instanceof Error ? error.message : String(error)}`,
@@ -2028,21 +2403,21 @@ var DeploymentApiService = class extends import_effect21.Effect.Service()("Deplo
       });
       return result;
     });
-    const completeUpload = import_effect21.Effect.fn("DeploymentApiService.completeUpload")(function* (deploymentId, uploadId, parts) {
-      yield* import_effect21.Effect.annotateCurrentSpan("deploymentId", deploymentId);
-      yield* import_effect21.Effect.annotateCurrentSpan("partsCount", parts.length);
+    const completeUpload = import_effect24.Effect.fn("DeploymentApiService.completeUpload")(function* (deploymentId, uploadId, parts) {
+      yield* import_effect24.Effect.annotateCurrentSpan("deploymentId", deploymentId);
+      yield* import_effect24.Effect.annotateCurrentSpan("partsCount", parts.length);
       const client = yield* getClient;
-      yield* import_effect21.Effect.tryPromise({
+      yield* import_effect24.Effect.tryPromise({
         try: () => client.deployments.completeUpload(deploymentId, uploadId, parts),
         catch: (error) => new UploadCompleteError({
           message: `Failed to complete upload: ${error instanceof Error ? error.message : String(error)}`
         })
       });
-      yield* import_effect21.Effect.log("Upload completed successfully");
+      yield* import_effect24.Effect.log("Upload completed successfully");
     });
-    const getDeploymentStatus = import_effect21.Effect.fn("DeploymentApiService.getDeploymentStatus")(function* (deploymentId) {
+    const getDeploymentStatus = import_effect24.Effect.fn("DeploymentApiService.getDeploymentStatus")(function* (deploymentId) {
       const client = yield* getClient;
-      const deployment = yield* import_effect21.Effect.tryPromise({
+      const deployment = yield* import_effect24.Effect.tryPromise({
         try: () => client.deployments.get(deploymentId),
         catch: (error) => new DeploymentStatusError({
           message: `Failed to get deployment status: ${error instanceof Error ? error.message : String(error)}`
@@ -2050,9 +2425,9 @@ var DeploymentApiService = class extends import_effect21.Effect.Service()("Deplo
       });
       return deployment.status;
     });
-    const getLogs = import_effect21.Effect.fn("DeploymentApiService.getLogs")(function* (deploymentId, options) {
+    const getLogs = import_effect24.Effect.fn("DeploymentApiService.getLogs")(function* (deploymentId, options) {
       const client = yield* getClient;
-      const result = yield* import_effect21.Effect.tryPromise({
+      const result = yield* import_effect24.Effect.tryPromise({
         try: () => client.deployments.getLogs(deploymentId, options),
         catch: (error) => new DeploymentLogsFetchError({
           message: `Failed to get logs: ${error instanceof Error ? error.message : String(error)}`
@@ -2060,9 +2435,9 @@ var DeploymentApiService = class extends import_effect21.Effect.Service()("Deplo
       });
       return result;
     });
-    const getHostnames = import_effect21.Effect.fn("DeploymentApiService.getHostnames")(function* (deploymentId) {
+    const getHostnames = import_effect24.Effect.fn("DeploymentApiService.getHostnames")(function* (deploymentId) {
       const client = yield* getClient;
-      const result = yield* import_effect21.Effect.tryPromise({
+      const result = yield* import_effect24.Effect.tryPromise({
         try: () => client.deployments.getHostnames(deploymentId),
         catch: (error) => new DeploymentHostnamesFetchError({
           message: `Failed to get hostnames: ${error instanceof Error ? error.message : String(error)}`
@@ -2093,86 +2468,86 @@ var appOption5 = import_cli11.Options.text("app").pipe(
 var deployCommand = import_cli11.Command.make(
   "deploy",
   { app: appOption5 },
-  ({ app }) => import_effect22.Effect.gen(function* () {
+  ({ app }) => import_effect25.Effect.gen(function* () {
     const projectConfig = yield* ProjectConfigService;
     const deploymentApi = yield* DeploymentApiService;
     const archiveService = yield* ArchiveService;
     const projectLink = yield* ProjectLinkService;
-    const pathService = yield* import_platform7.Path.Path;
+    const pathService = yield* import_platform9.Path.Path;
     const cwd = process.cwd();
-    const applicationId = yield* import_effect22.Option.match(app, {
-      onSome: (id) => import_effect22.Effect.succeed(id),
-      onNone: () => projectLink.resolve(cwd).pipe(import_effect22.Effect.map((link) => link.applicationId))
+    const applicationId = yield* import_effect25.Option.match(app, {
+      onSome: (id) => import_effect25.Effect.succeed(id),
+      onNone: () => projectLink.resolve(cwd).pipe(import_effect25.Effect.map((link) => link.applicationId))
     });
-    yield* import_effect22.Effect.log("Starting deploy command");
+    yield* import_effect25.Effect.log("Starting deploy command");
     const { config } = yield* projectConfig.resolve(cwd);
-    yield* import_effect22.Console.log("Creating deployment...");
+    yield* import_effect25.Console.log("Creating deployment...");
     const deploymentId = yield* deploymentApi.createDeployment(applicationId);
-    yield* import_effect22.Console.log(`Deployment ID: ${deploymentId}`);
-    yield* import_effect22.Console.log("Creating archive...");
-    const archivePath = pathService.join(os2.tmpdir(), `project-${Date.now()}.zip`);
+    yield* import_effect25.Console.log(`Deployment ID: ${deploymentId}`);
+    yield* import_effect25.Console.log("Creating archive...");
+    const archivePath = pathService.join(os4.tmpdir(), `project-${Date.now()}.zip`);
     const archive = yield* archiveService.createZipArchive(config.userArchive?.rootOverwrite || cwd, archivePath, {
       whitelist: config.userArchive?.fileWhitelist,
       excludeFiles: config.excludeFiles,
       useIgnoreFiles: false,
       useManagedIgnore: false
     });
-    yield* import_effect22.Console.log(`Archive created (${(0, import_commons.formatFileSize)(archive.size)})`);
-    yield* import_effect22.Console.log("Uploading archive...");
+    yield* import_effect25.Console.log(`Archive created (${(0, import_commons.formatFileSize)(archive.size)})`);
+    yield* import_effect25.Console.log("Uploading archive...");
     yield* uploadArchive(deploymentId, archivePath, archive.size);
-    yield* import_effect22.Console.log("Upload complete.");
-    yield* import_effect22.Console.log("The deployment pipeline is now being provisioned. This may take a few seconds.");
+    yield* import_effect25.Console.log("Upload complete.");
+    yield* import_effect25.Console.log("The deployment pipeline is now being provisioned. This may take a few seconds.");
     yield* pollDeployment(deploymentId);
   }).pipe(
-    import_effect22.Effect.catchTags({
-      ProjectNotLinkedError: (err) => import_effect22.Console.error(err.message).pipe(import_effect22.Effect.andThen(import_effect22.Effect.fail(err))),
-      ProjectLinkReadError: (err) => import_effect22.Console.error(err.message).pipe(import_effect22.Effect.andThen(import_effect22.Effect.fail(err))),
-      ConfigNotFoundError: (err) => import_effect22.Console.error(err.message).pipe(import_effect22.Effect.andThen(import_effect22.Effect.fail(err))),
-      ConfigParseError: (err) => import_effect22.Console.error(`Config parse error: ${err.message}`).pipe(import_effect22.Effect.andThen(import_effect22.Effect.fail(err))),
-      ConfigValidationError: (err) => import_effect22.Effect.gen(function* () {
+    import_effect25.Effect.catchTags({
+      ProjectNotLinkedError: (err) => import_effect25.Console.error(err.message).pipe(import_effect25.Effect.andThen(import_effect25.Effect.fail(err))),
+      ProjectLinkReadError: (err) => import_effect25.Console.error(err.message).pipe(import_effect25.Effect.andThen(import_effect25.Effect.fail(err))),
+      ConfigNotFoundError: (err) => import_effect25.Console.error(err.message).pipe(import_effect25.Effect.andThen(import_effect25.Effect.fail(err))),
+      ConfigParseError: (err) => import_effect25.Console.error(`Config parse error: ${err.message}`).pipe(import_effect25.Effect.andThen(import_effect25.Effect.fail(err))),
+      ConfigValidationError: (err) => import_effect25.Effect.gen(function* () {
         for (const e of err.errors) {
-          yield* import_effect22.Console.error(e);
+          yield* import_effect25.Console.error(e);
         }
-        yield* import_effect22.Console.error(err.message);
-      }).pipe(import_effect22.Effect.andThen(import_effect22.Effect.fail(err))),
-      DeploymentCreateError: (err) => import_effect22.Console.error(`Deployment creation failed: ${err.message}`).pipe(import_effect22.Effect.andThen(import_effect22.Effect.fail(err))),
-      ArchiveCreateError: (err) => import_effect22.Console.error(`Archive creation failed: ${err.message}`).pipe(import_effect22.Effect.andThen(import_effect22.Effect.fail(err))),
-      UploadStartError: (err) => import_effect22.Console.error(`Upload failed: ${err.message}`).pipe(import_effect22.Effect.andThen(import_effect22.Effect.fail(err))),
-      UploadPartError: (err) => import_effect22.Console.error(`Upload failed: ${err.message}`).pipe(import_effect22.Effect.andThen(import_effect22.Effect.fail(err))),
-      UploadCompleteError: (err) => import_effect22.Console.error(`Upload failed: ${err.message}`).pipe(import_effect22.Effect.andThen(import_effect22.Effect.fail(err))),
-      PresignedUrlError: (err) => import_effect22.Console.error(`Upload failed: ${err.message}`).pipe(import_effect22.Effect.andThen(import_effect22.Effect.fail(err))),
-      DeploymentAuthError: (err) => import_effect22.Console.error(`Authentication failed: ${err.message}`).pipe(import_effect22.Effect.andThen(import_effect22.Effect.fail(err))),
-      DeploymentFailedError: (err) => import_effect22.Console.error(err.message).pipe(import_effect22.Effect.andThen(import_effect22.Effect.fail(err)))
+        yield* import_effect25.Console.error(err.message);
+      }).pipe(import_effect25.Effect.andThen(import_effect25.Effect.fail(err))),
+      DeploymentCreateError: (err) => import_effect25.Console.error(`Deployment creation failed: ${err.message}`).pipe(import_effect25.Effect.andThen(import_effect25.Effect.fail(err))),
+      ArchiveCreateError: (err) => import_effect25.Console.error(`Archive creation failed: ${err.message}`).pipe(import_effect25.Effect.andThen(import_effect25.Effect.fail(err))),
+      UploadStartError: (err) => import_effect25.Console.error(`Upload failed: ${err.message}`).pipe(import_effect25.Effect.andThen(import_effect25.Effect.fail(err))),
+      UploadPartError: (err) => import_effect25.Console.error(`Upload failed: ${err.message}`).pipe(import_effect25.Effect.andThen(import_effect25.Effect.fail(err))),
+      UploadCompleteError: (err) => import_effect25.Console.error(`Upload failed: ${err.message}`).pipe(import_effect25.Effect.andThen(import_effect25.Effect.fail(err))),
+      PresignedUrlError: (err) => import_effect25.Console.error(`Upload failed: ${err.message}`).pipe(import_effect25.Effect.andThen(import_effect25.Effect.fail(err))),
+      DeploymentAuthError: (err) => import_effect25.Console.error(`Authentication failed: ${err.message}`).pipe(import_effect25.Effect.andThen(import_effect25.Effect.fail(err))),
+      DeploymentFailedError: (err) => import_effect25.Console.error(err.message).pipe(import_effect25.Effect.andThen(import_effect25.Effect.fail(err)))
     })
   )
 );
-var uploadArchive = (deploymentId, archivePath, fileSize) => import_effect22.Effect.gen(function* () {
+var uploadArchive = (deploymentId, archivePath, fileSize) => import_effect25.Effect.gen(function* () {
   const deploymentApi = yield* DeploymentApiService;
-  const fs = yield* import_platform7.FileSystem.FileSystem;
+  const fs = yield* import_platform9.FileSystem.FileSystem;
   const uploadId = yield* deploymentApi.startMultipartUpload(deploymentId);
   const FILE_CHUNK_SIZE = 10 * 1024 * 1024;
   const numChunks = Math.ceil(fileSize / FILE_CHUNK_SIZE);
-  yield* import_effect22.Effect.log("Starting multipart upload", { uploadId, numChunks, fileSize });
-  const parts = yield* import_effect22.Effect.all(
+  yield* import_effect25.Effect.log("Starting multipart upload", { uploadId, numChunks, fileSize });
+  const parts = yield* import_effect25.Effect.all(
     Array.from({ length: numChunks }, (_, i) => {
       const partNumber = i + 1;
       const start = i * FILE_CHUNK_SIZE;
       const bytesToRead = partNumber < numChunks ? FILE_CHUNK_SIZE : fileSize - start;
-      return import_effect22.Effect.gen(function* () {
+      return import_effect25.Effect.gen(function* () {
         const presignedUrl = yield* deploymentApi.getPresignedUrl(deploymentId, uploadId, partNumber);
-        const chunkData = yield* import_effect22.Stream.runCollect(fs.stream(archivePath, { offset: start, bytesToRead })).pipe(
-          import_effect22.Effect.map((chunks) => {
+        const chunkData = yield* import_effect25.Stream.runCollect(fs.stream(archivePath, { offset: start, bytesToRead })).pipe(
+          import_effect25.Effect.map((chunks) => {
             const arrays = Array.from(chunks);
             return Buffer.concat(arrays);
           }),
-          import_effect22.Effect.mapError(
+          import_effect25.Effect.mapError(
             (error) => new UploadPartError({
               message: `Failed to read chunk ${partNumber}: ${String(error)}`,
               partNumber
             })
           )
         );
-        yield* import_effect22.Effect.log(`Uploading part ${partNumber}/${numChunks}`, { size: chunkData.length });
+        yield* import_effect25.Effect.log(`Uploading part ${partNumber}/${numChunks}`, { size: chunkData.length });
         return yield* deploymentApi.uploadPart(presignedUrl, chunkData, partNumber);
       });
     }),
@@ -2180,20 +2555,20 @@ var uploadArchive = (deploymentId, archivePath, fileSize) => import_effect22.Eff
   );
   yield* deploymentApi.completeUpload(deploymentId, uploadId, parts);
 });
-var pollDeployment = (deploymentId) => import_effect22.Effect.gen(function* () {
+var pollDeployment = (deploymentId) => import_effect25.Effect.gen(function* () {
   const deploymentApi = yield* DeploymentApiService;
   let lastStatus = "PENDING";
   let logOffset = 0;
-  yield* import_effect22.Console.log("Status: Pending");
-  yield* import_effect22.Effect.repeat(
-    import_effect22.Effect.gen(function* () {
-      const newStatus = yield* deploymentApi.getDeploymentStatus(deploymentId).pipe(import_effect22.Effect.catchTag("DeploymentStatusError", () => import_effect22.Effect.succeed(lastStatus)));
+  yield* import_effect25.Console.log("Status: Pending");
+  yield* import_effect25.Effect.repeat(
+    import_effect25.Effect.gen(function* () {
+      const newStatus = yield* deploymentApi.getDeploymentStatus(deploymentId).pipe(import_effect25.Effect.catchTag("DeploymentStatusError", () => import_effect25.Effect.succeed(lastStatus)));
       if (newStatus !== lastStatus) {
         lastStatus = newStatus;
         const label = newStatus.charAt(0) + newStatus.slice(1).toLowerCase();
-        yield* import_effect22.Console.log(`Status: ${label}`);
+        yield* import_effect25.Console.log(`Status: ${label}`);
       }
-      const logsPage = yield* deploymentApi.getLogs(deploymentId, { offset: logOffset, limit: 100 }).pipe(import_effect22.Effect.catchTag("DeploymentLogsFetchError", () => import_effect22.Effect.succeed(null)));
+      const logsPage = yield* deploymentApi.getLogs(deploymentId, { offset: logOffset, limit: 100 }).pipe(import_effect25.Effect.catchTag("DeploymentLogsFetchError", () => import_effect25.Effect.succeed(null)));
       if (logsPage) {
         for (const logEntry of logsPage.items) {
           logOffset++;
@@ -2201,68 +2576,211 @@ var pollDeployment = (deploymentId) => import_effect22.Effect.gen(function* () {
         }
       }
       if (newStatus === "ACTIVE") {
-        const hostnames = yield* deploymentApi.getHostnames(deploymentId).pipe(import_effect22.Effect.catchTag("DeploymentHostnamesFetchError", () => import_effect22.Effect.succeed([])));
+        const hostnames = yield* deploymentApi.getHostnames(deploymentId).pipe(import_effect25.Effect.catchTag("DeploymentHostnamesFetchError", () => import_effect25.Effect.succeed([])));
         const active = hostnames.find((h) => h.active) ?? hostnames.at(0);
         if (active) {
-          yield* import_effect22.Console.log(`Deployed to https://${active.hostname}`);
+          yield* import_effect25.Console.log(`Deployed to https://${active.hostname}`);
         } else {
-          yield* import_effect22.Console.log("Deployment is live.");
+          yield* import_effect25.Console.log("Deployment is live.");
         }
-        return yield* import_effect22.Effect.fail("done");
+        return yield* import_effect25.Effect.fail("done");
       }
       if (newStatus === "FAILED") {
-        return yield* import_effect22.Effect.fail(
+        return yield* import_effect25.Effect.fail(
           new DeploymentFailedError({
             message: "The deployment failed. Please check the logs for more information."
           })
         );
       }
     }),
-    import_effect22.Schedule.addDelay(import_effect22.Schedule.forever, () => import_effect22.Duration.seconds(1))
+    import_effect25.Schedule.addDelay(import_effect25.Schedule.forever, () => import_effect25.Duration.seconds(1))
   ).pipe(
-    import_effect22.Effect.catchAll((err) => {
-      if (err === "done") return import_effect22.Effect.void;
-      return import_effect22.Effect.fail(err);
+    import_effect25.Effect.catchAll((err) => {
+      if (err === "done") return import_effect25.Effect.void;
+      return import_effect25.Effect.fail(err);
     })
   );
 });
 var printLog = (logEntry) => {
   switch (logEntry.type) {
     case "ERROR":
-      return import_effect22.Console.error(logEntry.message);
+      return import_effect25.Console.error(logEntry.message);
     case "WARN":
-      return import_effect22.Console.warn(logEntry.message);
+      return import_effect25.Console.warn(logEntry.message);
     default:
-      return import_effect22.Console.log(logEntry.message);
+      return import_effect25.Console.log(logEntry.message);
   }
 };
 
 // src/commands/platform/index.ts
-var platformBase = import_cli12.Command.make("platform", {}, () => import_effect23.Effect.void);
+var platformBase = import_cli12.Command.make("platform", {}, () => import_effect26.Effect.void);
 var platformCommand = platformBase.pipe(import_cli12.Command.withSubcommands([deployCommand]));
 
-// src/commands/whoami/index.ts
+// src/commands/setup/index.ts
 var import_cli13 = require("@effect/cli");
-var import_effect24 = require("effect");
-var whoamiCommand = import_cli13.Command.make(
+var import_effect27 = require("effect");
+var fileArg2 = import_cli13.Args.text({ name: "file" }).pipe(
+  import_cli13.Args.withDescription("Output file to write (default: .env.local)"),
+  import_cli13.Args.optional
+);
+var appOption6 = import_cli13.Options.text("app").pipe(
+  import_cli13.Options.withAlias("a"),
+  import_cli13.Options.withDescription("Application ID to set up (skips the interactive picker)"),
+  import_cli13.Options.optional
+);
+var orgOption6 = import_cli13.Options.text("org").pipe(
+  import_cli13.Options.withAlias("o"),
+  import_cli13.Options.withDescription("Only list applications belonging to this organization ID when picking"),
+  import_cli13.Options.optional
+);
+var environmentOption2 = import_cli13.Options.text("environment").pipe(
+  import_cli13.Options.withAlias("e"),
+  import_cli13.Options.withDescription("Environment slug to resolve overrides for (e.g. preview)"),
+  import_cli13.Options.optional
+);
+var yesOption2 = import_cli13.Options.boolean("yes").pipe(
+  import_cli13.Options.withAlias("y"),
+  import_cli13.Options.withDescription("Overwrite an existing file without confirmation")
+);
+var rotateOption2 = import_cli13.Options.boolean("rotate").pipe(
+  import_cli13.Options.withDescription("Force a fresh API key, revoking the previous one")
+);
+var setupCommand = import_cli13.Command.make(
+  "setup",
+  {
+    file: fileArg2,
+    app: appOption6,
+    org: orgOption6,
+    environment: environmentOption2,
+    yes: yesOption2,
+    rotate: rotateOption2
+  },
+  ({ file, app, org, environment, yes, rotate }) => import_effect27.Effect.gen(function* () {
+    const apiClient = yield* ApiClientService;
+    const projectLink = yield* ProjectLinkService;
+    const envFile = yield* EnvFileService;
+    const localCredentials = yield* LocalCredentialsService;
+    const cwd = process.cwd();
+    const existingLink = yield* projectLink.load(cwd);
+    let applicationId;
+    if (import_effect27.Option.isSome(existingLink)) {
+      applicationId = existingLink.value.applicationId;
+      if (import_effect27.Option.isSome(app) || import_effect27.Option.isSome(org)) {
+        yield* import_effect27.Console.log(
+          `Note: this directory is already linked to ${applicationId}; ignoring --app/--org. Run "gigadrive unlink" first to target a different application.`
+        );
+      }
+    } else {
+      const organizationId = import_effect27.Option.getOrUndefined(org);
+      const { items: apps } = yield* apiClient.request((client) => client.applications.list({ organizationId }));
+      if (apps.length === 0) {
+        return yield* import_effect27.Effect.fail(
+          new NoApplicationsFoundError({
+            message: 'No applications found. Create one in the Gigadrive console, then run "gigadrive setup" again.'
+          })
+        );
+      }
+      const explicitAppId = import_effect27.Option.getOrUndefined(app);
+      let chosen;
+      if (explicitAppId !== void 0) {
+        const match = apps.find((a) => a.id === explicitAppId);
+        if (match === void 0) {
+          return yield* import_effect27.Effect.fail(
+            new ApplicationNotFoundError({
+              message: `Application "${explicitAppId}" was not found among your applications.`
+            })
+          );
+        }
+        chosen = match;
+      } else if (apps.length === 1) {
+        chosen = apps[0];
+      } else {
+        chosen = yield* import_cli13.Prompt.run(
+          import_cli13.Prompt.select({
+            message: "Select an application to set up",
+            choices: apps.map((a) => ({ title: `${a.name} (${a.organization.name})`, value: a }))
+          })
+        );
+      }
+      applicationId = chosen.id;
+      yield* projectLink.save(cwd, { applicationId, organizationId: chosen.organization.id });
+      yield* import_effect27.Console.log(`Linked this directory to application ${applicationId}.`);
+    }
+    const target = import_effect27.Option.getOrElse(file, () => ".env.local");
+    const environmentSlug = import_effect27.Option.getOrUndefined(environment);
+    const { items, omittedSensitive } = yield* apiClient.request(
+      (client) => client.applications.envVars.pull(applicationId, environmentSlug ? { environment: environmentSlug } : void 0)
+    );
+    const existing = yield* envFile.read(target);
+    if (import_effect27.Option.isSome(existing) && !yes) {
+      const overwrite = yield* import_cli13.Prompt.run(
+        import_cli13.Prompt.confirm({ message: `${target} already exists. Overwrite?`, initial: false })
+      );
+      if (!overwrite) {
+        return yield* import_effect27.Console.log("Cancelled.");
+      }
+    }
+    const credentialEntries2 = yield* localCredentials.provision({
+      applicationId,
+      rotate,
+      existingContent: import_effect27.Option.getOrUndefined(existing)
+    });
+    const entries = [...items.map((v) => ({ key: v.key, value: v.value })), ...credentialEntries2];
+    yield* envFile.write(target, entries);
+    const gitignored = yield* envFile.ensureGitignored(cwd, target);
+    yield* import_effect27.Console.log("\nLocal dev environment ready.");
+    yield* import_effect27.Console.log(`  \u2022 Wrote ${items.length} variable(s) and API credentials to ${target}.`);
+    if (omittedSensitive > 0) {
+      yield* import_effect27.Console.log(
+        `  \u2022 Skipped ${omittedSensitive} sensitive variable(s) (only production/preview hold secrets).`
+      );
+    }
+    if (gitignored) {
+      yield* import_effect27.Console.log(`  \u2022 Added ${target} to .gitignore.`);
+    }
+    yield* import_effect27.Console.log("  \u2022 Your app can now call the Gigadrive API via the SDK (GIGADRIVE_CLIENT_ID/SECRET).");
+  }).pipe(
+    import_effect27.Effect.catchTags({
+      // Ctrl+C during a prompt is a deliberate cancel — exit 0.
+      QuitException: () => import_effect27.Console.log("Cancelled."),
+      NotAuthenticatedError: (err) => import_effect27.Console.error('You are not logged in. Run "gigadrive login" to authenticate.').pipe(
+        import_effect27.Effect.andThen(import_effect27.Effect.fail(err))
+      ),
+      ApiRequestError: (err) => import_effect27.Console.error(`Setup failed: ${err.message}`).pipe(import_effect27.Effect.andThen(import_effect27.Effect.fail(err))),
+      NoApplicationsFoundError: (err) => import_effect27.Console.error(err.message).pipe(import_effect27.Effect.andThen(import_effect27.Effect.fail(err))),
+      ApplicationNotFoundError: (err) => import_effect27.Console.error(err.message).pipe(import_effect27.Effect.andThen(import_effect27.Effect.fail(err))),
+      ProjectLinkReadError: (err) => import_effect27.Console.error(err.message).pipe(import_effect27.Effect.andThen(import_effect27.Effect.fail(err))),
+      ProjectLinkWriteError: (err) => import_effect27.Console.error(err.message).pipe(import_effect27.Effect.andThen(import_effect27.Effect.fail(err))),
+      EnvFileReadError: (err) => import_effect27.Console.error(err.message).pipe(import_effect27.Effect.andThen(import_effect27.Effect.fail(err))),
+      EnvFileWriteError: (err) => import_effect27.Console.error(err.message).pipe(import_effect27.Effect.andThen(import_effect27.Effect.fail(err))),
+      DevCredentialsStoreReadError: (err) => import_effect27.Console.error(err.message).pipe(import_effect27.Effect.andThen(import_effect27.Effect.fail(err))),
+      DevCredentialsStoreWriteError: (err) => import_effect27.Console.error(err.message).pipe(import_effect27.Effect.andThen(import_effect27.Effect.fail(err)))
+    })
+  )
+);
+
+// src/commands/whoami/index.ts
+var import_cli14 = require("@effect/cli");
+var import_effect28 = require("effect");
+var whoamiCommand = import_cli14.Command.make(
   "whoami",
   {},
-  () => import_effect24.Effect.gen(function* () {
+  () => import_effect28.Effect.gen(function* () {
     const auth = yield* AuthService;
     const info = yield* auth.getUserInfo;
-    yield* import_effect24.Console.log(JSON.stringify(info, null, 2));
+    yield* import_effect28.Console.log(JSON.stringify(info, null, 2));
   }).pipe(
-    import_effect24.Effect.catchTags({
-      NotAuthenticatedError: () => import_effect24.Console.log('You are not logged in. Run "gigadrive login" to authenticate.'),
-      UserInfoFetchError: (err) => import_effect24.Console.error(`Failed to retrieve user info: ${err.message}`),
-      OAuthDiscoveryError: (err) => import_effect24.Console.error(`Failed to retrieve user info: ${err.message}`)
+    import_effect28.Effect.catchTags({
+      NotAuthenticatedError: () => import_effect28.Console.log('You are not logged in. Run "gigadrive login" to authenticate.'),
+      UserInfoFetchError: (err) => import_effect28.Console.error(`Failed to retrieve user info: ${err.message}`),
+      OAuthDiscoveryError: (err) => import_effect28.Console.error(`Failed to retrieve user info: ${err.message}`)
     })
   )
 );
 
 // src/index.ts
-var gigadrive = import_cli14.Command.make("gigadrive", {}, () => import_effect25.Effect.void).pipe(
-  import_cli14.Command.withSubcommands([
+var gigadrive = import_cli15.Command.make("gigadrive", {}, () => import_effect29.Effect.void).pipe(
+  import_cli15.Command.withSubcommands([
     loginCommand,
     logoutCommand,
     whoamiCommand,
@@ -2274,27 +2792,31 @@ var gigadrive = import_cli14.Command.make("gigadrive", {}, () => import_effect25
     aiCommand,
     buildCommand,
     debugCommand,
-    platformCommand
+    platformCommand,
+    setupCommand
   ])
 );
-var cli = import_cli14.Command.run(gigadrive, {
+var cli = import_cli15.Command.run(gigadrive, {
   name: "Gigadrive CLI",
   version: package_default.version
 });
-var BaseServices = import_effect25.Layer.mergeAll(
+var BaseServices = import_effect29.Layer.mergeAll(
   OAuthConfigService.Default,
   AuthStorageService.Default,
   PackageManagerService.Default,
   ArchiveService.Default,
   import_network_config2.NetworkConfigLive,
   ProjectConfigService.Default,
-  ProjectLinkService.Default
-).pipe(import_effect25.Layer.provideMerge(AuthService.Default));
-var ApiClientLive = import_effect25.Layer.provide(ApiClientService.Default, BaseServices);
-var DeploymentApiLive = import_effect25.Layer.provide(DeploymentApiService.Default, BaseServices);
-var ServicesLive = import_effect25.Layer.mergeAll(BaseServices, ApiClientLive, DeploymentApiLive);
-var AppLive = import_effect25.Layer.mergeAll(ServicesLive, import_effect25.Logger.minimumLogLevel(import_effect25.LogLevel.Info)).pipe(
-  import_effect25.Layer.provideMerge(import_platform_node.NodeContext.layer)
-);
-import_platform_node.NodeRuntime.runMain(import_effect25.Effect.provide(cli(process.argv), AppLive));
+  ProjectLinkService.Default,
+  EnvFileService.Default,
+  DevCredentialsStore.Default
+).pipe(import_effect29.Layer.provideMerge(AuthService.Default));
+var ApiClientLive = import_effect29.Layer.provide(ApiClientService.Default, BaseServices);
+var DeploymentApiLive = import_effect29.Layer.provide(DeploymentApiService.Default, BaseServices);
+var LocalCredentialsLive = import_effect29.Layer.provide(LocalCredentialsService.Default, BaseServices);
+var ServicesLive = import_effect29.Layer.mergeAll(BaseServices, ApiClientLive, DeploymentApiLive, LocalCredentialsLive);
+var AppLive = import_effect29.Layer.mergeAll(ServicesLive, import_effect29.Logger.minimumLogLevel(import_effect29.LogLevel.Info)).pipe(
+  import_effect29.Layer.provideMerge(import_platform_node.NodeContext.layer)
+);
+import_platform_node.NodeRuntime.runMain(import_effect29.Effect.provide(cli(process.argv), AppLive));
 //# sourceMappingURL=index.cjs.map