@@ -177,19 +177,13 @@ only covers cloud-specific, non-obvious caveats.
177177 Redis degrades gracefully but the local ` .env ` points at it.
178178- ** Backend** (port 8080, base path ` /api ` ): ` bash scripts/start-backend.sh ` (wraps
179179 ` ./mvnw spring-boot:run ` ; it strips ` SPRING_PROFILES_ACTIVE=prod ` for local runs → dev mode).
180- <<<<<<< HEAD
181- - ** Frontend** (port 3000): ` npm run dev ` (Vite proxies ` /api ` → 8080 and ` /agent-api ` → 8787).
182- - ** DeepSQL Agent API** (port 8787, optional): needed for the sidebar ** Agent** tab.
183- Runtime is a customized Nous Hermes Agent; see caveats below for install +
184- ` HERMES_WEBUI_ALLOWED_ORIGINS ` (upstream env name).
185- =======
186180- ** Frontend** (port 3000): prefer ` npx vite --host 0.0.0.0 --port 3000 ` (or ` npm run dev `
187181 with ` server.host ` set). Plain ` npm run dev ` can bind ** IPv6-only** (` ::1:3000 ` ) in this
188182 VM so ` curl http://127.0.0.1:3000 ` fails even though Vite looks healthy. Vite proxies
189183 ` /api ` → 8080 and ` /agent-api ` → 8787.
190- - ** Hermes Agent webui ** (port 8787, optional): needed only for the sidebar ** Agent** tab.
191- See caveats below for install + ` HERMES_WEBUI_ALLOWED_ORIGINS ` .
192- > > > > > > > 7dacaac (docs(agents): note Vite IPv4 bind and Spring CORS loopback hosts)
184+ - ** DeepSQL Agent API ** (port 8787, optional): needed for the sidebar ** Agent** tab.
185+ Runtime is a customized Nous Hermes Agent; see caveats below for install +
186+ ` HERMES_WEBUI_ALLOWED_ORIGINS ` (upstream env name).
193187- A demo target DB ` demo_shop ` (same Postgres server, sample ` customers ` /` products ` /` orders ` )
194188 exists for exercising connection/schema features without an external database.
195189
@@ -241,19 +235,11 @@ only covers cloud-specific, non-obvious caveats.
241235 ` http://deepsql-agent:8788/provision ` ) with ` AGENT_PROVISION_SECRET ` . In this VM run
242236 ` python3 scripts/local-agent-provisioner.py ` (needs those two env vars in ` .env ` ).
243237 Without it, Spring logs ` agent.provision-secret is unset — skipping… ` and the
244- <<<<<<< HEAD
245238 ` u-admin ` agent profile is never created/token-refreshed.
246- =======
247- ` u-admin ` Hermes profile is never created/token-refreshed.
248- - ** Hermes webui Origin allowlist for Vite.** Start Hermes with
249- ` HERMES_WEBUI_ALLOWED_ORIGINS=http://localhost:3000,http://127.0.0.1:3000 ` or browser
250- requests via the Vite ` /agent-api ` proxy return ** 403** "Cross-origin mismatch".
251- Webui listens on ` :8787 ` .
252239- ** Spring CORS must allow both loopback hosts.** Set
253240 ` CORS_ALLOWED_ORIGINS=http://localhost:3000,http://127.0.0.1:3000 ` in ` .env ` . Opening
254241 the UI as ` http://127.0.0.1:3000 ` while only ` localhost ` is allowlisted yields ** 403**
255242 on ` POST /api/agent/session ` (and other cookie-auth APIs).
256- >>>>>>> 7dacaac (docs(agents): note Vite IPv4 bind and Spring CORS loopback hosts)
257243- ** Before running backend tests that boot the Spring context** (e.g. ` ApiSmokeTest ` ), stop
258244 the running backend first — both use ` ddl-auto=update ` on the same ` dba_agent ` DB and can
259245 deadlock on an ` ALTER TABLE ` . Test env vars are documented in ` CLAUDE.md ` (Testing).
0 commit comments