From 830d957d4ea50cae6469ad0a37170e8759847bc4 Mon Sep 17 00:00:00 2001
From: Will Blair <85643015+williamjblair@users.noreply.github.com>
Date: Thu, 27 Aug 2026 11:21:37 -0400
Subject: [PATCH] Simplify Neon HTTP connection guidance

---
 apps/problems/README.md                              | 12 ++++++++----
 .../2026-08-13-problems-latency-and-architecture.md  |  6 ++++++
 2 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/apps/problems/README.md b/apps/problems/README.md
index 2a18727..932e91d 100644
--- a/apps/problems/README.md
+++ b/apps/problems/README.md
@@ -96,11 +96,15 @@ build therefore obtains fresh least-privilege database URLs from Neon instead
 of copying production credentials:
 
 ```bash
-VELA_PROJECTION_DATABASE_URL="$(neonctl connection-string main --project-id lingering-meadow-20929365 --role-name vela_projection_reader_20260813 --database-name vela_projection --pooled --no-color)" \
-VELA_ACTIVITY_DATABASE_URL="$(neonctl connection-string main --project-id lingering-meadow-20929365 --role-name vela_activity_app --database-name vela_activity --pooled --no-color)" \
+VELA_PROJECTION_DATABASE_URL="$(neonctl connection-string main --project-id lingering-meadow-20929365 --role-name vela_projection_reader_20260813 --database-name vela_projection --no-color)" \
+VELA_ACTIVITY_DATABASE_URL="$(neonctl connection-string main --project-id lingering-meadow-20929365 --role-name vela_activity_app --database-name vela_activity --no-color)" \
 bun run --filter @vela/problems build
 ```
 
+Problems uses the Neon serverless HTTP driver, not a long-lived TCP client.
+Use direct Neon hostnames here; a pooled hostname adds no connection-pooling
+benefit to the HTTP transport.
+
 ## Develop
 
 From the repository root:
@@ -110,8 +114,8 @@ bun install --frozen-lockfile
 PORT=4322 HOST=localhost bun run dev:problems # example; match the staging callback
 bun run --filter @vela/problems typecheck
 bun run --filter @vela/problems test
-VELA_PROJECTION_DATABASE_URL="$(neonctl connection-string main --project-id lingering-meadow-20929365 --role-name vela_projection_reader_20260813 --database-name vela_projection --pooled --no-color)" \
-VELA_ACTIVITY_DATABASE_URL="$(neonctl connection-string main --project-id lingering-meadow-20929365 --role-name vela_activity_app --database-name vela_activity --pooled --no-color)" \
+VELA_PROJECTION_DATABASE_URL="$(neonctl connection-string main --project-id lingering-meadow-20929365 --role-name vela_projection_reader_20260813 --database-name vela_projection --no-color)" \
+VELA_ACTIVITY_DATABASE_URL="$(neonctl connection-string main --project-id lingering-meadow-20929365 --role-name vela_activity_app --database-name vela_activity --no-color)" \
 bun run --filter @vela/problems build
 bun run check:design-system
 ```
diff --git a/docs/performance/2026-08-13-problems-latency-and-architecture.md b/docs/performance/2026-08-13-problems-latency-and-architecture.md
index 958d8e6..73bd198 100644
--- a/docs/performance/2026-08-13-problems-latency-and-architecture.md
+++ b/docs/performance/2026-08-13-problems-latency-and-architecture.md
@@ -120,6 +120,12 @@ one explicit shared preview environment rather than a misleading claim of
 per-PR branching. If Git previews are enabled later, replace it with automatic
 branch-per-preview provisioning for both runtime credentials together.
 
+**2026-08-27 correction.** The live Vercel project now has database variables
+only in the Production environment. No Preview-scoped database variable or
+Git-preview binding remains. The persistent Neon `vercel-preview` branch is
+therefore retained only pending deletion approval, not as current runtime
+infrastructure.
+
 ## Package and dependency disposition
 
 - Keep `@vela/projection-data` as the only scientific projection reader and `@vela/activity-data` as the only hosted write surface.