chore(deps): upgrade effect to 4.0.2

.agents/skills/effect/references/CONFIG.md

@@ -10,9 +10,9 @@ export const dataDirectoryConfig = Config.schema(AbsolutePath, "APP_DATA_DIR");
 export const layerFromEnvironment = Layer.effect(
   Configuration.Service,
   Effect.gen(function* () {
-    const apiKey = yield* Config.redacted("API_KEY");
-    const optionalModel = yield* Config.option(Config.string("MODEL"));
-    const enabled = yield* Config.boolean("FEATURE_ENABLED").pipe(Config.withDefault(false));
+    const apiKey = yield* Config.Redacted("API_KEY");
+    const optionalModel = yield* Config.option(Config.String("MODEL"));
+    const enabled = yield* Config.Boolean("FEATURE_ENABLED").pipe(Config.withDefault(false));
 
     return Configuration.Service.of({ apiKey, optionalModel, enabled });
   }),
@@ -23,7 +23,7 @@ export const layerFromEnvironment = Layer.effect(
 
 - `Config<T>` is yieldable and reads the current `ConfigProvider` reference.
 - The default provider is `ConfigProvider.fromEnv()`.
-- Use `Config.redacted(...)` for credentials.
+- Use `Config.Redacted(...)` for credentials.
 - Use `Config.schema(...)` or `Config.mapOrFail(...)` for refined values.
 - Use `Config.option(...)` for semantic absence.
 - Use `Config.withDefault(...)` for missing-data defaults only; malformed values still fail.

.agents/skills/effect/references/HTTP_CLIENTS.md

@@ -4,10 +4,10 @@ Use this when writing outgoing HTTP calls, Effect HttpClient adapters, status cl
 
 Use Effect HTTP client modules for outgoing HTTP in app/provider code:
 
-- `effect/unstable/http/HttpClient`
-- `effect/unstable/http/HttpClientRequest`
-- `effect/unstable/http/HttpClientResponse`
-- `effect/unstable/http/HttpClientError`
+- `effect/http/HttpClient`
+- `effect/http/HttpClientRequest`
+- `effect/http/HttpClientResponse`
+- `effect/http/HttpClientError`
 
 Prefer Effect HttpClient in Effect application and provider code when its typed errors, layers, and transforms are useful. Raw `fetch` remains reasonable for browser or edge constraints, small adapters, platform transports, and libraries that intentionally avoid unstable Effect HTTP APIs.
 

apps/cli/README.md

@@ -101,7 +101,7 @@ See [`docs/binary-distribution.md`](./docs/binary-distribution.md) for a full ex
 
 ## Architecture
 
-The CLI is built on `effect/unstable/cli`.
+The CLI is built on `effect/cli`.
 
 Important areas:
 

apps/cli/scripts/bench-cli.ts

@@ -11,7 +11,7 @@ import process from "node:process";
 import { parseArgs } from "node:util";
 import { BunRuntime, BunServices } from "@effect/platform-bun";
 import { Clock, Console, Effect, FileSystem, Path, Ref, Stdio } from "effect";
-import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
+import { ChildProcess, ChildProcessSpawner } from "effect/process";
 import { readSpans, type ReportSpan } from "./trace-report.ts";
 
 const USAGE =

apps/cli/src/auth/command-credentials.layer.ts

@@ -402,7 +402,7 @@ export const accessTokenForProfile = Effect.fn("CommandCredentials.accessTokenFo
       return Option.some(cliSettings.accessToken.value);
     }
 
-    const noKeyring = yield* Config.option(Config.string("SUPABASE_NO_KEYRING")).parse(
+    const noKeyring = yield* Config.option(Config.String("SUPABASE_NO_KEYRING")).parse(
       configProvider,
     );
     const keyringModule = yield* loadKeyringModule(fs, noKeyring);
@@ -435,7 +435,7 @@ const makeCommandCredentials = Effect.gen(function* () {
   const runtimeInfo = yield* RuntimeInfo;
   const cliSettings = yield* CommandSettings;
   const configProvider = yield* ConfigProvider.ConfigProvider;
-  const noKeyring = yield* Config.option(Config.string("SUPABASE_NO_KEYRING")).parse(
+  const noKeyring = yield* Config.option(Config.String("SUPABASE_NO_KEYRING")).parse(
     configProvider,
   );
   const debugLogger = yield* DebugLogger;

apps/cli/src/auth/command-platform-api-factory.layer.ts

@@ -1,4 +1,4 @@
-import { FetchHttpClient } from "effect/unstable/http";
+import { FetchHttpClient } from "effect/http";
 import { Effect, Layer } from "effect";
 
 import { dohFetchLayer } from "../command-internal/http-dns.ts";

apps/cli/src/auth/command-platform-api.layer.ts

@@ -1,6 +1,6 @@
 import { makeApiClient } from "@supabase/api/effect";
 import { Effect, Layer, Option, Redacted } from "effect";
-import * as HttpClient from "effect/unstable/http/HttpClient";
+import * as HttpClient from "effect/http/HttpClient";
 
 import { CLI_VERSION } from "../shared/cli/version.ts";
 import { CommandSettings } from "../config/command-settings.service.ts";

apps/cli/src/auth/command-platform-api.layer.unit.test.ts

@@ -1,8 +1,8 @@
 import { describe, expect, it } from "@effect/vitest";
 import { Effect, Exit, FileSystem, Layer, Option, Path, Redacted } from "effect";
-import * as HttpClient from "effect/unstable/http/HttpClient";
-import * as HttpClientResponse from "effect/unstable/http/HttpClientResponse";
-import type * as HttpClientRequest from "effect/unstable/http/HttpClientRequest";
+import * as HttpClient from "effect/http/HttpClient";
+import * as HttpClientResponse from "effect/http/HttpClientResponse";
+import type * as HttpClientRequest from "effect/http/HttpClientRequest";
 import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { access, mkdir, readFile, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";

apps/cli/src/auth/http-debug.layer.ts

@@ -1,6 +1,6 @@
 import { Effect, Layer } from "effect";
-import { FetchHttpClient } from "effect/unstable/http";
-import * as HttpClient from "effect/unstable/http/HttpClient";
+import { FetchHttpClient } from "effect/http";
+import * as HttpClient from "effect/http/HttpClient";
 
 import { dohFetchLayer } from "../command-internal/http-dns.ts";
 import { DebugLogger } from "../command-internal/debug-logger.service.ts";

apps/cli/src/cli/boolean-flag-defaults.unit.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { Primitive, type Command } from "effect/unstable/cli";
+import { Primitive, type Command } from "effect/cli";
 import {
   commandInternals,
   flattenSubcommands,
@@ -9,19 +9,19 @@ import { unwrapParam } from "../command-internal/param-introspection.ts";
 import { rootCommandForFeatures } from "./root.ts";
 
 /**
- * `Flag.boolean(name)` alone builds a required param, so omitting it fails the whole command
+ * `Flag.Boolean(name)` alone builds a required param, so omitting it fails the whole command
  * with a missing-flag error before the handler runs — every boolean flag must pair with
  * `Flag.withDefault(false)` or `Flag.optional`. No other test catches this: handler integration
  * tests build their flags record directly, bypassing the parser, and the type checker can't see
  * the required-ness since it still infers as `boolean`.
  */
 
 /**
- * Uses `Primitive.getTypeName(Primitive.boolean)` rather than the literal `"boolean"`, so a
+ * Uses `Primitive.getTypeName(Primitive.Boolean)` rather than the literal `"boolean"`, so a
  * rename upstream breaks loudly instead of silently matching nothing and passing every command.
  * Avoids `primitiveType._tag` to keep this guard off effect's runtime representation.
  */
-const BOOLEAN_TYPE_NAME = Primitive.getTypeName(Primitive.boolean);
+const BOOLEAN_TYPE_NAME = Primitive.getTypeName(Primitive.Boolean);
 
 function booleanFlagsRequiringAValue(command: Command.Command.Any): ReadonlyArray<string> {
   const internals = commandInternals(command);

apps/cli/src/cli/complete.ts

@@ -1,8 +1,8 @@
 import { BunServices } from "@effect/platform-bun";
 import { Cause, Effect, Layer, Option } from "effect";
-import { FetchHttpClient } from "effect/unstable/http";
-import { GlobalFlag } from "effect/unstable/cli";
-import type { Command, Param, Primitive } from "effect/unstable/cli";
+import { FetchHttpClient } from "effect/http";
+import { GlobalFlag } from "effect/cli";
+import type { Command, Param, Primitive } from "effect/cli";
 import process from "node:process";
 import {
   QUERY_OUTPUT_FORMATS,
@@ -59,7 +59,7 @@ export interface FlagDescriptor {
   readonly description: string | undefined;
   readonly isVariadic: boolean;
   readonly isBoolean: boolean;
-  /** `Param.Single`'s underlying `Primitive<A>._tag` (`"Boolean"`, `"Choice"`, `"Integer"`, ...). */
+  /** `Param.Single`'s underlying `Primitive<A>._tag` (`"Boolean"`, `"Choice"`, `"Int"`, ...). */
   readonly primitiveTag: string;
   /** The valid value set for a `primitiveTag === "Choice"` flag; `undefined` for every other tag. */
   readonly choiceKeys: ReadonlyArray<string> | undefined;
@@ -461,8 +461,8 @@ function hasUnconsumedFlagTerminator(
 
 /**
  * Flags whose real validation rejects a leading `-`/`+`, unlike this tree's plain signed
- * `Flag.integer`/`Flag.string` declarations — checked before `primitiveTag` dispatch since
- * `storage cp --jobs` is declared as `Flag.string`. Key = `<matched command path>:<flag name>`.
+ * `Flag.Int`/`Flag.String` declarations — checked before `primitiveTag` dispatch since
+ * `storage cp --jobs` is declared as `Flag.String`. Key = `<matched command path>:<flag name>`.
  */
 const COMPLETION_UINT_FLAGS: ReadonlySet<string> = new Set([
   "functions deploy:jobs",
@@ -473,7 +473,7 @@ const COMPLETION_UINT_FLAGS: ReadonlySet<string> = new Set([
 
 /**
  * Flags validated against Go duration syntax (see `isValidGoDuration`) rather than this
- * tree's plain `Flag.string` declarations.
+ * tree's plain `Flag.String` declarations.
  */
 const COMPLETION_DURATION_FLAGS: ReadonlySet<string> = new Set([
   "gen types:query-timeout",
@@ -690,9 +690,9 @@ function isValidFlagValue(
         return outputFlagChoiceKeys(matchedPath).includes(value);
       }
       return flag.choiceKeys !== undefined && flag.choiceKeys.includes(value);
-    case "Integer":
+    case "Int":
       return isValidBase0Int64(value);
-    case "Float":
+    case "Finite":
       return value.trim().length > 0 && !Number.isNaN(Number(value));
     default:
       return true;

apps/cli/src/cli/complete.unit.test.ts

@@ -511,7 +511,7 @@ describe("respondToComplete", () => {
       { path: ["db", "reset"], flag: "last" },
     ])("rejects a negative value for $path --$flag", ({ path, flag }) => {
       // These flags are validated as unsigned integers, which reject a leading sign,
-      // unlike this tree's plain signed Flag.integer regex.
+      // unlike this tree's plain signed Flag.Int regex.
       const result = respondToComplete(rootCommand, ["__complete", ...path, `--${flag}`, "-1", ""]);
       expect(result).toEqual({ candidates: [], directive: CompletionDirective.Default });
     });
@@ -593,7 +593,7 @@ describe("respondToComplete", () => {
 
     it("rejects a value one past int64 max for a plain (non-uint) integer flag", () => {
       // Validated against the signed int64 range, which is narrower than the uint64
-      // bound `Flag.integer` alone would suggest.
+      // bound `Flag.Int` alone would suggest.
       const overflow = respondToComplete(rootCommand, [
         "__complete",
         "backups",

apps/cli/src/cli/main.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 import { BunServices } from "@effect/platform-bun";
 import { Effect, Exit, Layer, Stdio } from "effect";
-import { FetchHttpClient } from "effect/unstable/http";
+import { FetchHttpClient } from "effect/http";
 import { runCli } from "../shared/cli/run.ts";
 import { upgradeNoticeHook } from "../command-internal/upgrade-notice.ts";
 import { analyticsLayer } from "../telemetry/analytics.layer.ts";

apps/cli/src/cli/root-stack-aliases.integration.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, test } from "@effect/vitest";
 import { Console, Effect, Layer, Option } from "effect";
-import { CliOutput, Command } from "effect/unstable/cli";
+import { CliOutput, Command } from "effect/cli";
 import { emptyEnv, fakeConsole, mockOutput } from "../../tests/helpers/mocks.ts";
 import { CliArgs } from "../shared/cli/cli-args.service.ts";
 import { textCliOutputFormatter } from "../shared/output/text-formatter.ts";

apps/cli/src/cli/root.ts

@@ -1,5 +1,5 @@
 import { Effect, Layer, Option } from "effect";
-import { Command } from "effect/unstable/cli";
+import { Command } from "effect/cli";
 import { backupsCommand } from "../commands/backups/backups.command.ts";
 import { bootstrapCommand } from "../commands/bootstrap/bootstrap.command.ts";
 import { branchesCommand } from "../commands/branches/branches.command.ts";

apps/cli/src/command-internal/bitbucket-pipeline.ts

@@ -14,7 +14,7 @@ export const bitbucketCloneDir = Effect.fnUntraced(function* (
     const projectValue = Option.fromNullishOr(projectEnvValues[BITBUCKET_CLONE_DIR_ENV_KEY]);
     if (Option.isSome(projectValue)) return projectValue;
   }
-  return yield* Config.option(Config.string(BITBUCKET_CLONE_DIR_ENV_KEY));
+  return yield* Config.option(Config.String(BITBUCKET_CLONE_DIR_ENV_KEY));
 });
 
 /** Returns whether a non-empty Bitbucket marker disables restricted Docker options. */

apps/cli/src/command-internal/branch-target.ts

@@ -1,6 +1,6 @@
 import type { ApiClient, V1ListAllBranchesOutput } from "@supabase/api/effect";
 import { Duration, Effect, Option } from "effect";
-import * as HttpClientError from "effect/unstable/http/HttpClientError";
+import * as HttpClientError from "effect/http/HttpClientError";
 
 import { CommandPlatformApiFactory } from "../auth/command-platform-api-factory.service.ts";
 import { CommandPlatformApi } from "../auth/command-platform-api.service.ts";

apps/cli/src/command-internal/bundled-postgres-client.ts

@@ -10,8 +10,8 @@ import {
   PlatformError,
   Stream,
 } from "effect";
-import { FetchHttpClient } from "effect/unstable/http";
-import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
+import { FetchHttpClient } from "effect/http";
+import { ChildProcess, ChildProcessSpawner } from "effect/process";
 import {
   ArtifactError,
   postgresVersion,
@@ -135,7 +135,7 @@ const nativeRun = Effect.fn("BundledPostgresClient.nativeRun")(function* <E>(
   const tool = ["pg_dump", "pg_dumpall", "pg_prove", "psql"].includes(command)
     ? path.join(artifactRoot, "bin", command)
     : command;
-  const inheritedPath = yield* Config.option(Config.string("PATH")).pipe(
+  const inheritedPath = yield* Config.option(Config.String("PATH")).pipe(
     Effect.mapError(mapSpawnError),
   );
   const env = {

apps/cli/src/command-internal/connect-errors.unit.test.ts

@@ -1,4 +1,4 @@
-import { ConnectionError, SqlError } from "effect/unstable/sql/SqlError";
+import { ConnectionError, SqlError } from "effect/sql/SqlError";
 import * as Pg from "pg";
 import { describe, expect, it } from "vitest";
 

apps/cli/src/command-internal/container-cli.ts

@@ -1,6 +1,6 @@
 import { Data, Effect, Stream } from "effect";
-import * as ChildProcess from "effect/unstable/process/ChildProcess";
-import { ChildProcessSpawner } from "effect/unstable/process/ChildProcessSpawner";
+import * as ChildProcess from "effect/process/ChildProcess";
+import { ChildProcessSpawner } from "effect/process/ChildProcessSpawner";
 
 import {
   withChildTraceEnv,

apps/cli/src/command-internal/container-cli.unit.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from "@effect/vitest";
 import { Deferred, Effect, Exit, PlatformError, Sink, Stream, Tracer } from "effect";
-import { ChildProcessSpawner } from "effect/unstable/process";
+import { ChildProcessSpawner } from "effect/process";
 
 import {
   containerCliExitCode,

apps/cli/src/command-internal/db-bootstrap/await-storage-ready.ts

@@ -8,8 +8,8 @@
  */
 
 import { Effect, Result } from "effect";
-import type * as HttpClient from "effect/unstable/http/HttpClient";
-import type { ChildProcessSpawner } from "effect/unstable/process/ChildProcessSpawner";
+import type * as HttpClient from "effect/http/HttpClient";
+import type { ChildProcessSpawner } from "effect/process/ChildProcessSpawner";
 
 import { inspectContainerState } from "../docker-lifecycle.ts";
 import { serviceContainerName } from "../docker-ids.ts";

apps/cli/src/command-internal/db-bootstrap/await-storage-ready.unit.test.ts

@@ -1,7 +1,7 @@
 import { describe, expect, it } from "@effect/vitest";
 import { Cause, Deferred, Effect, Exit, Fiber, Layer, Sink, Stream } from "effect";
-import { ChildProcessSpawner } from "effect/unstable/process";
-import * as HttpClient from "effect/unstable/http/HttpClient";
+import { ChildProcessSpawner } from "effect/process";
+import * as HttpClient from "effect/http/HttpClient";
 import * as TestClock from "effect/testing/TestClock";
 
 import { HealthCheckTimeoutError } from "./health-check.ts";

apps/cli/src/command-internal/db-bootstrap/container-lifecycle.ts

@@ -9,7 +9,7 @@
  */
 
 import { Data, Effect, Stream } from "effect";
-import type { ChildProcessSpawner } from "effect/unstable/process/ChildProcessSpawner";
+import type { ChildProcessSpawner } from "effect/process/ChildProcessSpawner";
 
 import {
   actionability,

apps/cli/src/command-internal/db-bootstrap/container-lifecycle.unit.test.ts

@@ -4,7 +4,7 @@ import { join } from "node:path";
 
 import { describe, expect, it } from "@effect/vitest";
 import { Deferred, Effect, PlatformError, Sink, Stream } from "effect";
-import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
+import { ChildProcess, ChildProcessSpawner } from "effect/process";
 import { afterEach, beforeEach } from "vitest";
 
 import {

apps/cli/src/command-internal/db-bootstrap/db-setup.ts

@@ -11,7 +11,7 @@
 
 import type { CliConfig } from "@supabase/config";
 import { Data, Effect, type FileSystem, Option, type Path, Schedule } from "effect";
-import type { ChildProcessSpawner } from "effect/unstable/process/ChildProcessSpawner";
+import type { ChildProcessSpawner } from "effect/process/ChildProcessSpawner";
 
 import type { LocalServiceVersionOverrides } from "../../shared/services/services.shared.ts";
 import { slimImagesEnabled } from "../../shared/services/slim-images.ts";

apps/cli/src/command-internal/db-bootstrap/db-setup.unit.test.ts

@@ -18,7 +18,7 @@ import {
   Stream,
   Tracer,
 } from "effect";
-import { ChildProcessSpawner } from "effect/unstable/process";
+import { ChildProcessSpawner } from "effect/process";
 
 import { mockOutput, mockRuntimeInfo } from "../../../tests/helpers/mocks.ts";
 import { DbExecError } from "../db-connection.errors.ts";

apps/cli/src/command-internal/db-bootstrap/health-check.ts

@@ -6,9 +6,9 @@
  */
 
 import { Context, Data, Duration, Effect, Schedule, Stream } from "effect";
-import * as HttpClient from "effect/unstable/http/HttpClient";
-import * as HttpClientRequest from "effect/unstable/http/HttpClientRequest";
-import type { ChildProcessSpawner } from "effect/unstable/process/ChildProcessSpawner";
+import * as HttpClient from "effect/http/HttpClient";
+import * as HttpClientRequest from "effect/http/HttpClientRequest";
+import type { ChildProcessSpawner } from "effect/process/ChildProcessSpawner";
 
 import {
   actionability,

apps/cli/src/command-internal/db-bootstrap/health-check.unit.test.ts

@@ -1,9 +1,9 @@
 import { describe, expect, it } from "@effect/vitest";
 import { Deferred, Effect, Exit, Fiber, Layer, Sink, Stream, Tracer } from "effect";
 import * as PlatformError from "effect/PlatformError";
-import { ChildProcessSpawner } from "effect/unstable/process";
-import * as HttpClient from "effect/unstable/http/HttpClient";
-import * as HttpClientResponse from "effect/unstable/http/HttpClientResponse";
+import { ChildProcessSpawner } from "effect/process";
+import * as HttpClient from "effect/http/HttpClient";
+import * as HttpClientResponse from "effect/http/HttpClientResponse";
 import * as TestClock from "effect/testing/TestClock";
 
 import { DbConnectError } from "../db-connection.errors.ts";
@@ -682,7 +682,7 @@ describe("waitForHealthyServices", () => {
         yield* Fiber.await(fiber);
 
         const wait = spans.find((span) => span.name === "HealthCheck.waitHealthyServices");
-        expect(spans.map((span) => span.name)).not.toContain("http.client HEAD");
+        expect(spans.map((span) => span.name)).not.toContain("HEAD");
         expect(wait?.attributes.get("retry.attempt_count")).toBe(2);
       }),
     );

apps/cli/src/command-internal/db-bootstrap/image-prepull.ts

@@ -5,7 +5,7 @@
  */
 
 import { Data, Effect, Result } from "effect";
-import type { ChildProcessSpawner } from "effect/unstable/process/ChildProcessSpawner";
+import type { ChildProcessSpawner } from "effect/process/ChildProcessSpawner";
 
 import {
   actionability,