feat(env): add @executor/env package

packages/core/env/CHANGELOG.md

@@ -0,0 +1,5 @@
+# @executor/env
+
+## 1.4.0
+
+- Add vendored Effect env package with t3-env style runtime validation ergonomics.

packages/core/env/README.md

@@ -0,0 +1,52 @@
+# @executor/env
+
+Vendored environment tooling based on [`rayhanadev/effect-env`](https://github.com/rayhanadev/effect-env), with runtime ergonomics inspired by [`t3-oss/t3-env`](https://github.com/t3-oss/t3-env).
+
+## What this adds
+
+- `Env` helper constructors for Effect `Config` values
+- `makeEnv` for Effect Context/Layer integration
+- `createEnv(shape, options)` for runtime env assembly with:
+  - an optional `prefix` for client-safe keys
+  - `runtimeEnv`
+  - `onValidationError` / `onInvalidAccess`
+  - `skipValidation`
+  - `emptyStringAsUndefined`
+  - `extends`
+  - `createFinalConfig` customization hook
+
+## Example
+
+```ts
+import { createEnv, Env } from "@executor/env";
+
+export const shared = createEnv(
+  {
+    NODE_ENV: Env.literal("NODE_ENV", "development", "test", "production"),
+  },
+  {
+    runtimeEnv: process.env,
+  },
+);
+
+export const web = createEnv(
+  {
+    PUBLIC_API_URL: Env.url("PUBLIC_API_URL"),
+  },
+  {
+    prefix: "PUBLIC_",
+    runtimeEnv: import.meta.env,
+  },
+);
+
+export const server = createEnv(
+  {
+    DATABASE_URL: Env.url("DATABASE_URL"),
+    PORT: Env.numberOr("PORT", 3000),
+  },
+  {
+    runtimeEnv: process.env,
+    extends: [shared],
+  },
+);
+```

packages/core/env/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@executor/env",
+  "private": true,
+  "type": "module",
+  "version": "1.4.0",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "scripts": {
+    "typecheck": "bunx tsc --noEmit -p tsconfig.json",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "effect": "catalog:"
+  },
+  "devDependencies": {
+    "@effect/vitest": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  }
+}