@slip-stream-kit/config 0.11.15 → 0.13.0

package/dist/entry/internal.d.ts

@@ -1,6 +1,8 @@
 export { packageConfigSchema } from '../lib/package-config/package-config-schema';
+export { DEV_SERVING_MARKER, E2E_MODE_ENV } from '../lib/playwright/playwright';
+export { readRelease } from '../lib/release-slug/read-release';
 export { DEFAULT_RELEASE_SLUG, slugifyHostLabel, slugifyRelease } from '../lib/release-slug/release-slug';
 export { defineVendorConfig, VENDOR_CONFIG_FILE, vendorConfigSchema, vendorCopyItemSchema, } from '../lib/vendor/config-schema';
 export type { VendorConfig, VendorCopyItem } from '../lib/vendor/config-schema';
-export { describeProxyRoutes, DEV_CONTEXT_WIRE_VERSION, loadDev, readLocalContext, readLocalSet, } from '../lib/vite/vite';
-export type { LocalContext, LocalPackageInfo, ProxyRouteDescription } from '../lib/vite/vite';
+export { describeProxyRoutes, DEV_CONTEXT_WIRE_VERSION, loadDev, loadPackageConfig, readCloudOrigin, readLocalContext, readLocalSet, } from '../lib/vite/vite';
+export type { CloudOrigin, LocalContext, LocalPackageInfo, ProxyRouteDescription } from '../lib/vite/vite';

package/dist/entry/playwright.d.ts

@@ -0,0 +1,2 @@
+export { DEV_SERVING_MARKER, E2E_MODE_ENV, infraKitE2e } from '../lib/playwright/playwright';
+export type { InfraKitE2eMode, InfraKitE2eOptions, InfraKitE2eSetup, InfraKitWebServer, } from '../lib/playwright/playwright';

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/lib/package-config/package-config.ts", "../src/lib/vendor/config-schema.ts"],
-  "sourcesContent": ["/**\n * Validation rules for a single workspace package, declared in its\n * `infra-kit.config.ts`. Every field is optional: a key left unset falls back to\n * the active baseline, and a key set replaces that default wholesale (per-key, no\n * array concatenation) so a package can opt out with an explicit empty array.\n *\n * The baselines themselves (`DEFAULT_RULES` / `ROOT_DEFAULT_RULES`) deliberately do\n * NOT live here \u2014 they are audit POLICY, and policy belongs to the `infra-kit` CLI\n * that enforces it, not to the package a consumer installs to author a config.\n *\n * Most packages need none of these \u2014 the standard rules live in the baseline, so\n * a typical config is just `defineConfig(() => ({}))`.\n *\n * @example\n * // infra-kit.config.ts\n * import { defineConfig } from '@slip-stream-kit/config'\n *\n * export default defineConfig(() => ({}))\n */\nexport interface InfraKitPackageConfig {\n  /** Scripts that must be present in the package's package.json `scripts` map. */\n  requiredScripts?: string[]\n  /** Files (relative to the package root) that must exist on disk. */\n  requiredFiles?: string[]\n  /** Turborepo expectations \u2014 only meaningful where a turbo.json lives (the root). */\n  turbo?: {\n    /** Tasks that must be defined in turbo.json `tasks`. */\n    requiredTasks?: string[]\n  }\n  /** Local-dev configuration. Accepted-and-inert to the audit; consumed by the dev server. */\n  dev?: InfraKitDev\n  /** Where `infra-kit e2e` points this e2e package's Playwright run. Consumed by the CLI, inert to the audit. */\n  e2e?: InfraKitE2e\n  /**\n   * Explicit override for infra-kit's directory/dependency-based package-type detection (used to\n   * pick the agent guidance rendered into this package's `CLAUDE.md`). Detection already covers\n   * both consumer repos untouched, so this is an escape hatch for the cases it gets wrong \u2014 leaving\n   * it unset is never an error.\n   *\n   * **Ordering precondition:** the CLI's own pinned `packageConfigSchema` \u2014 not this package's\n   * version \u2014 governs what a consumer's `infra-kit.config.ts` may contain, and it is a\n   * `z.strictObject`. Only write `type` here once the CLI in use is a version that carries this\n   * key; an older CLI rejects the key outright and skips the rest of that package's audit checks.\n   *\n   * @example\n   * // infra-kit.config.ts\n   * export default defineConfig(() => ({ type: 'frontend' }))\n   */\n  type?: InfraKitPackageType\n}\n\n/** Package kinds infra-kit's agent guidance renders type-specific rules for. */\nexport type InfraKitPackageType = 'frontend' | 'backend' | 'lib' | 'e2e' | 'mobile'\n\n/** A proxy route's allowed backend source. */\nexport type InfraKitDevProxySource = 'local' | 'cloud'\n\nexport interface InfraKitDevProxyRoute {\n  /** Backend package this route targets when resolved locally. */\n  packageName: string\n  /** Capabilities this route can resolve to. Must be non-empty. */\n  from: InfraKitDevProxySource[]\n  /**\n   * Source used when a local backend for this package isn't active. Required when\n   * `from` lists more than one source; redundant (and omitted) for a single-source\n   * route. When set, must be one of `from`.\n   */\n  default?: InfraKitDevProxySource\n}\n\nexport interface InfraKitDevProxy {\n  /** URL templates. Placeholders like `<release>`/`<packageName>`/`<env>` are substituted at dev time. */\n  templates: {\n    local: string\n    cloud: string\n  }\n  /** Path-prefix (e.g. `/api`, `/api/v1`, `/media`) \u2192 route definition. */\n  routes: Record<string, InfraKitDevProxyRoute>\n}\n\nexport interface InfraKitDev {\n  proxy?: InfraKitDevProxy\n}\n\n/**\n * The e2e package's target. Local vs cloud is never configured: `infra-kit e2e` runs against this\n * worktree's dev server when one serves `target`, and against the deployed app at `INFRA_KIT_ENV` otherwise.\n *\n * @example\n * // apps/client/tests/infra-kit.config.ts\n * export default defineConfig(() => ({\n *   e2e: { target: 'client/ui', baseUrlEnv: 'E2E_CLIENT_BASE_URL' },\n * }))\n */\nexport interface InfraKitE2e {\n  /** The package under test, `<app>/ui` or `<app>/api`. */\n  target: string\n  /** The env var the Playwright config reads its base URL from; `infra-kit e2e` sets it for the run. */\n  baseUrlEnv: string\n  /**\n   * The deployed URL, with an `<env>` placeholder. Separate from `dev.proxy.templates.cloud` because that\n   * one names the BACKEND a UI proxies to, which is not always the host the UI itself is served from.\n   * Absent \u2192 the value of `baseUrlEnv` that `infra-kit env-load` loaded, which is where Doppler already\n   * keeps each env's deployed URL \u2014 the usual case, and the only one where prod is not `<env>`-shaped.\n   */\n  cloud?: string\n}\n\n/**\n * Accepted shapes for a package config's default export \u2014 mirrors Vite's\n * `defineConfig` input: a plain object, a sync factory, or an async factory.\n */\nexport type InfraKitPackageConfigInput =\n  InfraKitPackageConfig | (() => InfraKitPackageConfig) | (() => Promise<InfraKitPackageConfig>)\n\n/**\n * Identity helper that gives `infra-kit.config.ts` authors full type inference\n * and editor autocomplete without changing the value \u2014 exactly like Vite's\n * `defineConfig`. Resolution of the factory form happens in the CLI's loader, not here.\n *\n * @example\n * export default defineConfig(() => ({}))\n * @example\n * export default defineConfig(() => ({ requiredScripts: [] }))\n */\nexport const defineConfig = (config: InfraKitPackageConfigInput): InfraKitPackageConfigInput => {\n  return config\n}\n", "import { z } from 'zod'\n\n/**\n * Pure (node-free) vendor config schema + authoring helper. Kept separate from\n * `config.ts` (which imports node builtins for the runtime loader) so the public\n * lib entry can re-export `defineVendorConfig` without dragging node types into\n * the emitted `.d.ts`.\n */\n\n/**\n * Filename a source repo provides at its root to declare WHAT `vendor sync`\n * copies (`copy[]`). Lives ONLY on the write path \u2014 `vendor check` never loads it.\n * WHERE/WHICH to stamp (`workspaceDir` + `targets`) is machine-local and lives in\n * the user-global factory config (`~/.infra-kit/vendor.json`).\n */\nexport const VENDOR_CONFIG_FILE = 'vendor.config.ts'\n\n/**\n * A non-empty, repo-relative path with no `..` segments and no absolute prefix\n * (POSIX `/`, UNC/`\\`, or a Windows drive like `C:`). Containment guard for\n * vendor copy items so a malicious/typo config can't read or write outside the\n * source/target repo roots. Kept as a string/regex check (no `node:path`) to\n * respect this file's node-free constraint \u2014 `sync-ops.ts` does the resolved\n * runtime containment assert as defense in depth.\n */\nconst safeRelPath = z.string().refine(\n  (p) => {\n    const isAbsolute = /^(?:[/\\\\]|[a-z]:)/i.test(p)\n    const hasDotDotSegment = p.split(/[\\\\/]/).includes('..')\n\n    return !isAbsolute && !hasDotDotSegment && p.trim().length > 0\n  },\n  { message: 'must be a non-empty repo-relative path without \"..\" segments' },\n)\n\n/**\n * One item to sync from the source repo into each target. `vendored: true` marks\n * workspace packages that must land under `vendor/` (the single-source-of-truth\n * code); everything else is root-level tooling that stays at the repo root.\n */\nexport const vendorCopyItemSchema = z.object({\n  name: z.string(),\n  source: safeRelPath,\n  target: safeRelPath,\n  type: z.enum(['file', 'directory']),\n  vendored: z.boolean().optional(),\n})\n\nexport const vendorConfigSchema = z\n  .object({\n    /** Files/dirs to copy. Items with `vendored: true` land under `vendor/`. */\n    copy: z.array(vendorCopyItemSchema),\n  })\n  // Reject stray keys so a leftover `targets` (now machine-local, in\n  // ~/.infra-kit/vendor.json) yields a clear \"unrecognized key\" error rather\n  // than being silently ignored.\n  .strict()\n\nexport type VendorCopyItem = z.infer<typeof vendorCopyItemSchema>\nexport type VendorConfig = z.infer<typeof vendorConfigSchema>\n\n/**\n * Identity helper for authoring a type-safe `vendor.config.ts` in a source repo.\n * Re-exported from the public lib entry so a source repo can\n * `import { defineVendorConfig } from 'infra-kit'`.\n *\n * NOTE: a `vendor.config.ts` must be type-strippable \u2014 Node's native type\n * stripping (Node >= 24) loads it without a build step, which forbids `enum`,\n * `namespace`, and parameter properties.\n *\n * @example\n * export default defineVendorConfig({\n *   copy: [{ name: 'Configs', source: 'vendor/configs', target: 'vendor/configs', type: 'directory', vendored: true }],\n * })\n */\nexport const defineVendorConfig = (config: VendorConfig): VendorConfig => {\n  return config\n}\n"],
-  "mappings": ";AA6HO,IAAM,eAAe,CAAC,WAAmE;AAC9F,SAAO;AACT;;;AC/HA,SAAS,SAAS;AAyBlB,IAAM,cAAc,EAAE,OAAO,EAAE;AAAA,EAC7B,CAAC,MAAM;AACL,UAAM,aAAa,qBAAqB,KAAK,CAAC;AAC9C,UAAM,mBAAmB,EAAE,MAAM,OAAO,EAAE,SAAS,IAAI;AAEvD,WAAO,CAAC,cAAc,CAAC,oBAAoB,EAAE,KAAK,EAAE,SAAS;AAAA,EAC/D;AAAA,EACA,EAAE,SAAS,+DAA+D;AAC5E;AAOO,IAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,MAAM,EAAE,OAAO;AAAA,EACf,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,MAAM,EAAE,KAAK,CAAC,QAAQ,WAAW,CAAC;AAAA,EAClC,UAAU,EAAE,QAAQ,EAAE,SAAS;AACjC,CAAC;AAEM,IAAM,qBAAqB,EAC/B,OAAO;AAAA;AAAA,EAEN,MAAM,EAAE,MAAM,oBAAoB;AACpC,CAAC,EAIA,OAAO;AAmBH,IAAM,qBAAqB,CAAC,WAAuC;AACxE,SAAO;AACT;",
+  "sourcesContent": ["/**\n * Validation rules for a single workspace package, declared in its\n * `infra-kit.config.ts`. Every field is optional: a key left unset falls back to\n * the active baseline, and a key set replaces that default wholesale (per-key, no\n * array concatenation) so a package can opt out with an explicit empty array.\n *\n * The baselines themselves (`DEFAULT_RULES` / `ROOT_DEFAULT_RULES`) deliberately do\n * NOT live here \u2014 they are audit POLICY, and policy belongs to the `infra-kit` CLI\n * that enforces it, not to the package a consumer installs to author a config.\n *\n * Most packages need none of these \u2014 the standard rules live in the baseline, so\n * a typical config is just `defineConfig(() => ({}))`.\n *\n * @example\n * // infra-kit.config.ts\n * import { defineConfig } from '@slip-stream-kit/config'\n *\n * export default defineConfig(() => ({}))\n */\nexport interface InfraKitPackageConfig {\n  /** Scripts that must be present in the package's package.json `scripts` map. */\n  requiredScripts?: string[]\n  /** Files (relative to the package root) that must exist on disk. */\n  requiredFiles?: string[]\n  /** Turborepo expectations \u2014 only meaningful where a turbo.json lives (the root). */\n  turbo?: {\n    /** Tasks that must be defined in turbo.json `tasks`. */\n    requiredTasks?: string[]\n  }\n  /**\n   * The env var holding this app part's deployed URL, e.g. `CLIENT_URL`. The value lives in Doppler, per\n   * environment \u2014 prod's host is not `<env>`-shaped, so no template in code can name it. The dev proxy sends\n   * a UI's cloud routes there, and e2e runs against it in cloud mode. Required on a UI whose `dev.proxy`\n   * has a route that can go to cloud, and on any `e2e.target`.\n   */\n  deployedUrlEnv?: string\n  /** Local-dev configuration. Accepted-and-inert to the audit; consumed by the dev server. */\n  dev?: InfraKitDev\n  /** Which app part this e2e package tests. Consumed by `infraKitE2e()` and the CLI, inert to the audit. */\n  e2e?: InfraKitE2e\n  /**\n   * Explicit override for infra-kit's directory/dependency-based package-type detection (used to\n   * pick the agent guidance rendered into this package's `CLAUDE.md`). Detection already covers\n   * both consumer repos untouched, so this is an escape hatch for the cases it gets wrong \u2014 leaving\n   * it unset is never an error.\n   *\n   * **Ordering precondition:** the CLI's own pinned `packageConfigSchema` \u2014 not this package's\n   * version \u2014 governs what a consumer's `infra-kit.config.ts` may contain, and it is a\n   * `z.strictObject`. Only write `type` here once the CLI in use is a version that carries this\n   * key; an older CLI rejects the key outright and skips the rest of that package's audit checks.\n   *\n   * @example\n   * // infra-kit.config.ts\n   * export default defineConfig(() => ({ type: 'frontend' }))\n   */\n  type?: InfraKitPackageType\n}\n\n/** Package kinds infra-kit's agent guidance renders type-specific rules for. */\nexport type InfraKitPackageType = 'frontend' | 'backend' | 'lib' | 'e2e' | 'mobile'\n\n/** A proxy route's allowed backend source. */\nexport type InfraKitDevProxySource = 'local' | 'cloud'\n\nexport interface InfraKitDevProxyRoute {\n  /** Backend package this route targets when resolved locally. */\n  packageName: string\n  /** Capabilities this route can resolve to. Must be non-empty. */\n  from: InfraKitDevProxySource[]\n  /**\n   * Source used when a local backend for this package isn't active. Required when\n   * `from` lists more than one source; redundant (and omitted) for a single-source\n   * route. When set, must be one of `from`.\n   */\n  default?: InfraKitDevProxySource\n}\n\nexport interface InfraKitDevProxy {\n  /**\n   * The local backend's URL template \u2014 `<release>`/`<packageName>` are substituted at dev time. A cloud route\n   * goes to the package's `deployedUrlEnv` instead.\n   */\n  templates: {\n    local: string\n  }\n  /** Path-prefix (e.g. `/api`, `/api/v1`, `/media`) \u2192 route definition. */\n  routes: Record<string, InfraKitDevProxyRoute>\n}\n\nexport interface InfraKitDev {\n  proxy?: InfraKitDevProxy\n}\n\n/**\n * The e2e package's target. `infraKitE2e()` (`@slip-stream-kit/config/playwright`) reads it: a run is local\n * by default \u2014 `target` on this worktree, served by `infra-kit dev <app>` \u2014 and cloud only when asked\n * (`INFRA_KIT_E2E=cloud`, or CI), against the URL in the target package's `deployedUrlEnv`.\n *\n * @example\n * // apps/client/tests/infra-kit.config.ts\n * export default defineConfig(() => ({ e2e: { target: 'client/ui' } }))\n */\nexport interface InfraKitE2e {\n  /** The package under test, `<app>/ui` or `<app>/api`. */\n  target: string\n}\n\n/**\n * Accepted shapes for a package config's default export \u2014 mirrors Vite's\n * `defineConfig` input: a plain object, a sync factory, or an async factory.\n */\nexport type InfraKitPackageConfigInput =\n  InfraKitPackageConfig | (() => InfraKitPackageConfig) | (() => Promise<InfraKitPackageConfig>)\n\n/**\n * Identity helper that gives `infra-kit.config.ts` authors full type inference\n * and editor autocomplete without changing the value \u2014 exactly like Vite's\n * `defineConfig`. Resolution of the factory form happens in the CLI's loader, not here.\n *\n * @example\n * export default defineConfig(() => ({}))\n * @example\n * export default defineConfig(() => ({ requiredScripts: [] }))\n */\nexport const defineConfig = (config: InfraKitPackageConfigInput): InfraKitPackageConfigInput => {\n  return config\n}\n", "import { z } from 'zod'\n\n/**\n * Pure (node-free) vendor config schema + authoring helper. Kept separate from\n * `config.ts` (which imports node builtins for the runtime loader) so the public\n * lib entry can re-export `defineVendorConfig` without dragging node types into\n * the emitted `.d.ts`.\n */\n\n/**\n * Filename a source repo provides at its root to declare WHAT `vendor sync`\n * copies (`copy[]`). Lives ONLY on the write path \u2014 `vendor check` never loads it.\n * WHERE/WHICH to stamp (`workspaceDir` + `targets`) is machine-local and lives in\n * the user-global factory config (`~/.infra-kit/vendor.json`).\n */\nexport const VENDOR_CONFIG_FILE = 'vendor.config.ts'\n\n/**\n * A non-empty, repo-relative path with no `..` segments and no absolute prefix\n * (POSIX `/`, UNC/`\\`, or a Windows drive like `C:`). Containment guard for\n * vendor copy items so a malicious/typo config can't read or write outside the\n * source/target repo roots. Kept as a string/regex check (no `node:path`) to\n * respect this file's node-free constraint \u2014 `sync-ops.ts` does the resolved\n * runtime containment assert as defense in depth.\n */\nconst safeRelPath = z.string().refine(\n  (p) => {\n    const isAbsolute = /^(?:[/\\\\]|[a-z]:)/i.test(p)\n    const hasDotDotSegment = p.split(/[\\\\/]/).includes('..')\n\n    return !isAbsolute && !hasDotDotSegment && p.trim().length > 0\n  },\n  { message: 'must be a non-empty repo-relative path without \"..\" segments' },\n)\n\n/**\n * One item to sync from the source repo into each target. `vendored: true` marks\n * workspace packages that must land under `vendor/` (the single-source-of-truth\n * code); everything else is root-level tooling that stays at the repo root.\n */\nexport const vendorCopyItemSchema = z.object({\n  name: z.string(),\n  source: safeRelPath,\n  target: safeRelPath,\n  type: z.enum(['file', 'directory']),\n  vendored: z.boolean().optional(),\n})\n\nexport const vendorConfigSchema = z\n  .object({\n    /** Files/dirs to copy. Items with `vendored: true` land under `vendor/`. */\n    copy: z.array(vendorCopyItemSchema),\n  })\n  // Reject stray keys so a leftover `targets` (now machine-local, in\n  // ~/.infra-kit/vendor.json) yields a clear \"unrecognized key\" error rather\n  // than being silently ignored.\n  .strict()\n\nexport type VendorCopyItem = z.infer<typeof vendorCopyItemSchema>\nexport type VendorConfig = z.infer<typeof vendorConfigSchema>\n\n/**\n * Identity helper for authoring a type-safe `vendor.config.ts` in a source repo.\n * Re-exported from the public lib entry so a source repo can\n * `import { defineVendorConfig } from 'infra-kit'`.\n *\n * NOTE: a `vendor.config.ts` must be type-strippable \u2014 Node's native type\n * stripping (Node >= 24) loads it without a build step, which forbids `enum`,\n * `namespace`, and parameter properties.\n *\n * @example\n * export default defineVendorConfig({\n *   copy: [{ name: 'Configs', source: 'vendor/configs', target: 'vendor/configs', type: 'directory', vendored: true }],\n * })\n */\nexport const defineVendorConfig = (config: VendorConfig): VendorConfig => {\n  return config\n}\n"],
+  "mappings": ";AA4HO,IAAM,eAAe,CAAC,WAAmE;AAC9F,SAAO;AACT;;;AC9HA,SAAS,SAAS;AAyBlB,IAAM,cAAc,EAAE,OAAO,EAAE;AAAA,EAC7B,CAAC,MAAM;AACL,UAAM,aAAa,qBAAqB,KAAK,CAAC;AAC9C,UAAM,mBAAmB,EAAE,MAAM,OAAO,EAAE,SAAS,IAAI;AAEvD,WAAO,CAAC,cAAc,CAAC,oBAAoB,EAAE,KAAK,EAAE,SAAS;AAAA,EAC/D;AAAA,EACA,EAAE,SAAS,+DAA+D;AAC5E;AAOO,IAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,MAAM,EAAE,OAAO;AAAA,EACf,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,MAAM,EAAE,KAAK,CAAC,QAAQ,WAAW,CAAC;AAAA,EAClC,UAAU,EAAE,QAAQ,EAAE,SAAS;AACjC,CAAC;AAEM,IAAM,qBAAqB,EAC/B,OAAO;AAAA;AAAA,EAEN,MAAM,EAAE,MAAM,oBAAoB;AACpC,CAAC,EAIA,OAAO;AAmBH,IAAM,qBAAqB,CAAC,WAAuC;AACxE,SAAO;AACT;",
   "names": []
 }

package/dist/internal.js

@@ -1,5 +1,9 @@
 // src/lib/package-config/package-config-schema.ts
 import { z } from "zod";
+var ENV_VAR_NAME = /^[A-Z_][A-Z0-9_]*$/;
+var retired = (replacement) => {
+  return z.never({ error: replacement }).optional();
+};
 var packageConfigSchema = z.strictObject({
   requiredScripts: z.array(z.string().min(1)).optional(),
   requiredFiles: z.array(z.string().min(1)).optional(),
@@ -7,6 +11,9 @@ var packageConfigSchema = z.strictObject({
   // so a default on an optional key would make an EMPTY override layer parse to that default and
   // shallow-merge over a real setting from an earlier layer. Defaults belong at the read site.
   type: z.enum(["frontend", "backend", "lib", "e2e", "mobile"]).optional(),
+  // The deployed origin differs per environment (prod is not `<env>`-shaped), so the config names the
+  // variable and Doppler holds the value — the one source both the dev proxy and e2e read.
+  deployedUrlEnv: z.string().regex(ENV_VAR_NAME, "deployedUrlEnv must be an env var name (e.g. `CLIENT_URL`)").optional(),
   turbo: z.strictObject({
     requiredTasks: z.array(z.string().min(1)).optional()
   }).optional(),
@@ -18,7 +25,9 @@ var packageConfigSchema = z.strictObject({
         // warning emitted from `loadDev` in `../vite/vite.ts`). Make `https://` a hard schema
         // requirement next release, once both consumer repos have had a release to pick up the warning.
         local: z.string().min(1),
-        cloud: z.string().min(1)
+        cloud: retired(
+          "`templates.cloud` was replaced by `deployedUrlEnv`: set `deployedUrlEnv: '<APP>_URL'` at the top of this config and keep the URL per environment in Doppler"
+        )
       }),
       routes: z.record(
         z.string().min(1),
@@ -46,10 +55,26 @@ var packageConfigSchema = z.strictObject({
   }).optional(),
   e2e: z.strictObject({
     target: z.string().regex(/^[^/\s]+\/(?:ui|api)$/, "target must be `<app>/ui` or `<app>/api` (e.g. `client/ui`)"),
-    baseUrlEnv: z.string().regex(/^[A-Z_][A-Z0-9_]*$/, "baseUrlEnv must be an env var name"),
-    cloud: z.string().min(1).optional()
+    baseUrlEnv: retired(
+      "`e2e.baseUrlEnv` was removed: the deployed URL is the target package's own `deployedUrlEnv`"
+    ),
+    cloud: retired("`e2e.cloud` was removed: the deployed URL is the target package's own `deployedUrlEnv`")
   }).optional()
-});
+}).refine(
+  (config) => {
+    const routes = Object.values(config.dev?.proxy?.routes ?? {});
+    return config.deployedUrlEnv !== void 0 || !routes.some((route) => {
+      return route.from.includes("cloud");
+    });
+  },
+  {
+    message: "a `dev.proxy` route that can go to cloud needs `deployedUrlEnv` \u2014 the variable holding this app's deployed URL",
+    path: ["deployedUrlEnv"]
+  }
+);
+
+// src/lib/release-slug/read-release.ts
+import { execFileSync } from "node:child_process";
 
 // src/lib/release-slug/release-slug.ts
 var slugifyHostLabel = (label) => {
@@ -61,30 +86,18 @@ var slugifyRelease = (branch) => {
 };
 var DEFAULT_RELEASE_SLUG = "local";
 
-// src/lib/vendor/config-schema.ts
-import { z as z2 } from "zod";
-var VENDOR_CONFIG_FILE = "vendor.config.ts";
-var safeRelPath = z2.string().refine(
-  (p) => {
-    const isAbsolute = /^(?:[/\\]|[a-z]:)/i.test(p);
-    const hasDotDotSegment = p.split(/[\\/]/).includes("..");
-    return !isAbsolute && !hasDotDotSegment && p.trim().length > 0;
-  },
-  { message: 'must be a non-empty repo-relative path without ".." segments' }
-);
-var vendorCopyItemSchema = z2.object({
-  name: z2.string(),
-  source: safeRelPath,
-  target: safeRelPath,
-  type: z2.enum(["file", "directory"]),
-  vendored: z2.boolean().optional()
-});
-var vendorConfigSchema = z2.object({
-  /** Files/dirs to copy. Items with `vendored: true` land under `vendor/`. */
-  copy: z2.array(vendorCopyItemSchema)
-}).strict();
-var defineVendorConfig = (config) => {
-  return config;
+// src/lib/release-slug/read-release.ts
+var readRelease = (cwd) => {
+  try {
+    const branch = execFileSync("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
+      cwd,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    return slugifyRelease(branch) || DEFAULT_RELEASE_SLUG;
+  } catch {
+    return DEFAULT_RELEASE_SLUG;
+  }
 };
 
 // src/lib/vite/vite.ts
@@ -92,20 +105,20 @@ import fs from "node:fs";
 import path from "node:path";
 import process from "node:process";
 import { pathToFileURL } from "node:url";
-import { z as z3 } from "zod";
+import { z as z2 } from "zod";
 var PACKAGE_CONFIG_FILE = "infra-kit.config.ts";
 var DEV_CONTEXT_DIR = path.join(".infra-kit", "dev-context");
 var DEV_CONTEXT_FILE = path.join(".infra-kit", "dev-context.json");
-var devContextFragmentSchema = z3.object({
-  package: z3.string(),
-  port: z3.number(),
-  pid: z3.number().optional(),
-  writtenAt: z3.number().optional(),
-  release: z3.string().optional(),
-  alias: z3.string().optional(),
-  proxyPort: z3.number().optional(),
-  origin: z3.string().optional(),
-  v: z3.number().optional()
+var devContextFragmentSchema = z2.object({
+  package: z2.string(),
+  port: z2.number(),
+  pid: z2.number().optional(),
+  writtenAt: z2.number().optional(),
+  release: z2.string().optional(),
+  alias: z2.string().optional(),
+  proxyPort: z2.number().optional(),
+  origin: z2.string().optional(),
+  v: z2.number().optional()
 });
 var DEV_CONTEXT_WIRE_VERSION = 2;
 var interpolate = (template, values) => {
@@ -163,6 +176,7 @@ var describeProxyRoutes = ({
   proxy,
   localContext,
   env,
+  cloud,
   getRelease
 }) => {
   const paths = Object.keys(proxy.routes).toSorted((a, b) => {
@@ -173,7 +187,7 @@ var describeProxyRoutes = ({
     const source = pickSource(route, localContext.packages);
     let target = null;
     if (source === "cloud") {
-      target = env ? interpolate(proxy.templates.cloud, { release: "", packageName: route.packageName, env }) : null;
+      target = cloud.url ?? null;
     } else {
       try {
         target = resolveLocalTarget({
@@ -198,7 +212,10 @@ var warnIfNonHttpsLocalTemplate = (dev, configPath) => {
     );
   }
 };
-var loadDev = async (cwd) => {
+var readCloudOrigin = (envVar, env = process.env) => {
+  return { envVar, url: envVar ? env[envVar] || void 0 : void 0 };
+};
+var loadPackageConfig = async (cwd) => {
   const configPath = path.join(cwd, PACKAGE_CONFIG_FILE);
   if (!fs.existsSync(configPath)) return void 0;
   const stat = fs.statSync(configPath);
@@ -210,11 +227,15 @@ var loadDev = async (cwd) => {
   const parsed = packageConfigSchema.safeParse(resolved);
   if (!parsed.success) {
     throw new Error(
-      `@slip-stream-kit/config/vite: invalid ${PACKAGE_CONFIG_FILE} at ${configPath}: ${z3.prettifyError(parsed.error)}`
+      `@slip-stream-kit/config: invalid ${PACKAGE_CONFIG_FILE} at ${configPath}: ${z2.prettifyError(parsed.error)}`
     );
   }
-  warnIfNonHttpsLocalTemplate(parsed.data.dev, configPath);
-  return parsed.data.dev;
+  return parsed.data;
+};
+var loadDev = async (cwd) => {
+  const dev = (await loadPackageConfig(cwd))?.dev;
+  warnIfNonHttpsLocalTemplate(dev, path.join(cwd, PACKAGE_CONFIG_FILE));
+  return dev;
 };
 var extractPackages = (parsed) => {
   if (Array.isArray(parsed)) {
@@ -298,16 +319,51 @@ var readLocalContext = (cwd) => {
 var readLocalSet = (cwd) => {
   return readLocalContext(cwd).packages;
 };
+
+// src/lib/playwright/playwright.ts
+var DEV_SERVING_MARKER = "infra-kit dev: serving";
+var E2E_MODE_ENV = "INFRA_KIT_E2E";
+
+// src/lib/vendor/config-schema.ts
+import { z as z3 } from "zod";
+var VENDOR_CONFIG_FILE = "vendor.config.ts";
+var safeRelPath = z3.string().refine(
+  (p) => {
+    const isAbsolute = /^(?:[/\\]|[a-z]:)/i.test(p);
+    const hasDotDotSegment = p.split(/[\\/]/).includes("..");
+    return !isAbsolute && !hasDotDotSegment && p.trim().length > 0;
+  },
+  { message: 'must be a non-empty repo-relative path without ".." segments' }
+);
+var vendorCopyItemSchema = z3.object({
+  name: z3.string(),
+  source: safeRelPath,
+  target: safeRelPath,
+  type: z3.enum(["file", "directory"]),
+  vendored: z3.boolean().optional()
+});
+var vendorConfigSchema = z3.object({
+  /** Files/dirs to copy. Items with `vendored: true` land under `vendor/`. */
+  copy: z3.array(vendorCopyItemSchema)
+}).strict();
+var defineVendorConfig = (config) => {
+  return config;
+};
 export {
   DEFAULT_RELEASE_SLUG,
   DEV_CONTEXT_WIRE_VERSION,
+  DEV_SERVING_MARKER,
+  E2E_MODE_ENV,
   VENDOR_CONFIG_FILE,
   defineVendorConfig,
   describeProxyRoutes,
   loadDev,
+  loadPackageConfig,
   packageConfigSchema,
+  readCloudOrigin,
   readLocalContext,
   readLocalSet,
+  readRelease,
   slugifyHostLabel,
   slugifyRelease,
   vendorConfigSchema,