From d3b4660ae457a55e5056ac9e5cf3bde435b87d79 Mon Sep 17 00:00:00 2001
From: Simon Gagnon <git@simoncrypta.dev>
Date: Thu, 8 Oct 2026 11:58:02 -0400
Subject: [PATCH] docs(vite-plus): give vp dev the leased DATABASE_URL via
 cedarpg run --attach

Vite+ dependsOn does not forward env, and task env only fingerprints and
passes through the vp process env, so the old dev example never saw the
lease URL. Wrap vp dev with attach-only cedarpg run; db:acquire stays the
dependency. test is unchanged: the stock Vitest setup acquires itself.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 CHANGELOG.md              | 1 +
 README.md                 | 6 ++++--
 src/adapters/vite-plus.ts | 5 +++--
 3 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 476488e..3d31939 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -27,6 +27,7 @@
 
 ### Fixed
 
+- README / `@cedarjs/pg/vite-plus` Vite+ example: `dev` is now `cedarpg run --attach --mode=dev -- vp dev` (with `cache: false`). Vite+ `dependsOn` does not forward env and task `env` only passes through the `vp` process env, so the old `command: "vp dev"` + `env: ["DATABASE_URL"]` never saw the leased URL.
 - Ephemeral host cold start no longer deletes `/dev/shm/PostgreSQL.*` and `pgserve-*`. Those are live shared-memory segments of every Postgres on the machine. Running with `CI=true` or `CEDAR_PG_EPHEMERAL_HOST=1` next to a registered local host deleted that host's segment, and every new connection to it then failed with `58P01 could not open shared memory segment` until it was restarted. Cold start now removes only cedar-pg's own leftover data dir (`/dev/shm/cedar-pg-<uid>`). The `53100` / quota hint no longer recommends `rm /dev/shm/PostgreSQL.*`.
 - TEMPLATE `cloneWorkerDatabase` reuses the worker's `<template>_c_<workerId>` in Postgres across Jest test files. The `0.2.0-beta.0` fix cached the clone on `globalThis`, but Jest resets `globalThis` and the module registry for each test file. So the second file in a worker still ran `CREATE DATABASE` and failed with `database already exists`. The in-memory memo is removed; the database is the source of truth. As a result, calling it again with a different `root` / `name` in one process no longer throws: each call clones or reuses its own name. `smoke:pg` now runs two Jest files in one worker, after a seeded crashed run.
 
diff --git a/README.md b/README.md
index 4f685c3..539a90f 100644
--- a/README.md
+++ b/README.md
@@ -106,15 +106,17 @@ export default defineConfig({
         env: ["DATABASE_URL", "TEST_DATABASE_URL"],
       },
       dev: {
-        command: "vp dev",
+        command: "cedarpg run --attach --mode=dev -- vp dev",
         dependsOn: ["db:acquire"],
-        env: ["DATABASE_URL"],
+        cache: false,
       },
     },
   },
 });
 ```
 
+Like Nx `dependsOn`, Vite+ `dependsOn` does not forward env, and task `env` only fingerprints and passes through variables already set in the `vp` process. So `dev` acquires once via `db:acquire`, then `cedarpg run --attach` hands the lease `DATABASE_URL` to `vp dev`. `test` needs no wrapper: the stock Vitest setup acquires and sets the URL itself.
+
 `cedarPgDev()` does not acquire. Keep `dependsOn: ["db:acquire"]`. On listen it prints a status panel (TTY, non-CI). Vite CLI shortcuts (`key` then Enter; also listed under `h`):
 
 | Key | Action                                                                 |
diff --git a/src/adapters/vite-plus.ts b/src/adapters/vite-plus.ts
index 4d01b2b..82f8344 100644
--- a/src/adapters/vite-plus.ts
+++ b/src/adapters/vite-plus.ts
@@ -20,10 +20,11 @@
  *         dependsOn: ['db:acquire-test'],
  *         env: ['DATABASE_URL', 'TEST_DATABASE_URL'],
  *       },
+ *       // dependsOn does not forward env: attach hands vp dev the lease URL.
  *       dev: {
- *         command: 'vp dev',
+ *         command: 'cedarpg run --attach --mode=dev -- vp dev',
  *         dependsOn: ['db:acquire'],
- *         env: ['DATABASE_URL'],
+ *         cache: false,
  *       },
  *     },
  *   },