Skip to content

Commit e8fd11f

Browse files
Revert Cursor Cloud AGENTS.md docs from kaushik-IDE (#18) (#20)
<!-- CURSOR_AGENT_PR_BODY_BEGIN --> ## Summary Reverts merge commit `b204386` (#18) from `kaushik-IDE`. The Cursor Cloud `AGENTS.md` documentation is being relocated onto **main** via #19. This PR removes the duplicate section from Kaushik's branch so it no longer carries Cloud-env docs that belong on `main`. ## Changes - `AGENTS.md`: remove `## Cursor Cloud specific instructions` (62 lines) — revert of #18 No application code changes. <!-- CURSOR_AGENT_PR_BODY_END --> <div><a href="https://cursor.com/agents/bc-8ce91e70-c67b-48c6-84b3-05bb9d06231a?cursor_ref=pr_footer&cursor_cta=open_in_web"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/assets/images/open-in-web-dark.png"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/assets/images/open-in-web-light.png"><img alt="Open in Web" width="114" height="28" src="https://cursor.com/assets/images/open-in-web-dark.png"></picture></a>&nbsp;<a href="https://cursor.com/background-agent?bcId=bc-8ce91e70-c67b-48c6-84b3-05bb9d06231a&cursor_ref=pr_footer&cursor_cta=open_in_cursor"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/assets/images/open-in-cursor-dark.png"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/assets/images/open-in-cursor-light.png"><img alt="Open in Cursor" width="131" height="28" src="https://cursor.com/assets/images/open-in-cursor-dark.png"></picture></a>&nbsp;</div> Co-authored-by: Cursor Agent <cursoragent@cursor.com>
1 parent b204386 commit e8fd11f

1 file changed

Lines changed: 0 additions & 62 deletions

File tree

AGENTS.md

Lines changed: 0 additions & 62 deletions
Original file line numberDiff line numberDiff line change
@@ -180,65 +180,3 @@ model work without CORS or cookie special-casing.
180180
- Database provider anti-pattern → never use if/else for database types
181181
- Connection pool pollution → always reset session state after benchmark operations
182182
- Frontend state → use Zustand selector hooks to avoid infinite re-render loops
183-
184-
## Cursor Cloud specific instructions
185-
186-
The dev environment runs the stack **natively (no Docker)**: Java 25 + Maven wrapper backend,
187-
Vite frontend, and locally-installed PostgreSQL 16 + Redis. System dependencies (JDK 25,
188-
Postgres, pgvector, Redis) are baked into the VM snapshot; the startup update script only
189-
refreshes `npm install`. Standard commands live in [`CLAUDE.md`](CLAUDE.md) — this section
190-
only covers cloud-specific, non-obvious caveats.
191-
192-
### Services (start these each session — systemd is NOT running in the VM)
193-
194-
- **PostgreSQL 16** (vault DB, port 5432): start with `sudo pg_ctlcluster 16 main start`.
195-
DB `dba_agent` (user/pass `postgres`/`postgres`), extensions `vector` + `pg_stat_statements`
196-
enabled. `shared_preload_libraries=pg_stat_statements` is already set in the cluster config.
197-
- **Redis** (cache, port 6379): start with `sudo redis-server /etc/redis/redis.conf --daemonize yes`.
198-
Redis degrades gracefully but the local `.env` points at it.
199-
- **Backend** (port 8080, base path `/api`): `bash scripts/start-backend.sh` (wraps
200-
`./mvnw spring-boot:run`; it strips `SPRING_PROFILES_ACTIVE=prod` for local runs → dev mode).
201-
- **Frontend** (port 3000): `npm run dev` (Vite proxies `/api` → 8080 and `/agent-api` → 8787).
202-
- **Hermes Agent webui** (port 8787, optional): needed only for the sidebar **Agent** tab.
203-
See caveats below for install + `HERMES_WEBUI_ALLOWED_ORIGINS`.
204-
- A demo target DB `demo_shop` (same Postgres server, sample `customers`/`products`/`orders`)
205-
exists for exercising connection/schema features without an external database.
206-
207-
### Non-obvious setup caveats (each cost real debugging time)
208-
209-
- **Java 25 is mandatory** (`pom.xml` sets `java.version=25`); the VM's default `java` is set
210-
to Temurin 25 via `update-alternatives`, and `JAVA_HOME` is exported in `~/.bashrc`.
211-
- **`.env` is loaded by `source` in `scripts/start-backend.sh`, which runs under `set -e`.**
212-
Dotted keys like `spring.data.redis.host=...` make bash abort the whole script with
213-
"command not found". Use Spring relaxed-binding UPPERCASE env names instead
214-
(e.g. `SPRING_DATA_REDIS_HOST`). This is why the local `.env` avoids dotted keys.
215-
- **`ENCRYPTION_KEYS` must be set, not just `ENCRYPTION_KEY`.** `application.properties`
216-
hardcodes `ENCRYPTION_KEYS=${ENCRYPTION_KEYS:}`; with the OS env var unset this is a
217-
circular placeholder reference that fails `EncryptionService` bean creation at boot. The
218-
local `.env` sets `ENCRYPTION_KEYS=<id>:<base64key>` matching `ENCRYPTION_KEY_ID`.
219-
- **`SECURITY_AUTH_ENABLED=false`** (set in `.env`) enables the dev auto-admin bypass, so the
220-
web UI needs no login. Auth defaults to ON in every profile otherwise (there is no
221-
`admin/admin`); a real login needs the localhost admin-bootstrap flow (see README).
222-
- **The `scheduled_tasks` table and the `vector`/`pg_stat_statements` extensions** come from
223-
`docker/postgres/init/*.sql`. In the native (non-Docker) setup those were applied by hand;
224-
they persist in the snapshot. If you ever recreate the vault DB, re-apply
225-
`docker/postgres/init/*.sql` or db-scheduler logs `relation "scheduled_tasks" does not exist`.
226-
- **LLM (Azure OpenAI) is configured in the local gitignored `.env`** (not committed). Working
227-
values for this environment: `DEEPSQL_CHAT_PROVIDER=openai`,
228-
`DEEPSQL_CHAT_ENDPOINT=https://deepsql-selfhost-resource.cognitiveservices.azure.com/`,
229-
`DEEPSQL_CHAT_MODEL=gpt-5.4` (deployment name), plus matching `DEEPSQL_EMBEDDING_*` with
230-
`text-embedding-3-large`. Also set `AZURE_OPENAI_KEY` / `AZURE_OPENAI_ENDPOINT` aliases —
231-
`hermes/install.sh` reads those. After changing LLM env, restart the backend
232-
(`scripts/start-backend.sh`); `/api/setup/status` should show `hasLlmConfig: true`.
233-
- **Agent tab (Hermes) is optional but required for the in-app Agent chat UI.** Install via
234-
`curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --non-interactive --skip-setup`,
235-
symlink `~/.hermes/hermes-agent/.venv``venv` (DeepSQL's `hermes/install.sh` expects `.venv`),
236-
then `bash hermes/install.sh`. Start the webui with
237-
`HERMES_WEBUI_ALLOWED_ORIGINS=http://localhost:3000,http://127.0.0.1:3000`
238-
(without this, Vite's Origin header makes Hermes return **403** "Cross-origin mismatch").
239-
Webui listens on `:8787`; Vite proxies `/agent-api` → there.
240-
- **Before running backend tests that boot the Spring context** (e.g. `ApiSmokeTest`), stop
241-
the running backend first — both use `ddl-auto=update` on the same `dba_agent` DB and can
242-
deadlock on an `ALTER TABLE`. Test env vars are documented in `CLAUDE.md` (Testing).
243-
- `npm run lint` currently reports many pre-existing warnings/errors in the repo; that is the
244-
baseline, not a setup failure.

0 commit comments

Comments
 (0)