| name | cloud-vm-setup |
| description | Set up and run the doughnut dev environment on Cursor Cloud VM (no Nix). Use when working on Cloud VM, running tests on Cloud VM, or encountering command errors related to missing nix. Triggers on: cloud VM, cloud agent, no nix available, /workspace path. |
Set up and run the doughnut dev environment on Cursor Cloud VM without Nix.
Purpose: Cloud-agent development and testing when nix develop is unavailable.
Output: Environment ready for tests + summary ending with ## CLOUD VM READY.
**On Cloud VM: do NOT use `CURSOR_DEV=true nix develop -c` prefix. Run commands directly.**
Pre-configured: Node.js v24.16.0, pnpm 11.3.0 — no nix needed.
Ports:
| Service | Port |
|---|
| Spring Boot | 9081 |
| Local LB | 5173 |
| Vite dev | 5174 |
| MySQL | 3309 |
| Redis | 6380 |
CI=1 is exported by the setup script (CLI PTY tests use pipe fallback, matching
GitHub Actions).
Backend + E2E one-time setup (idempotent — safe to re-run):
source /workspace/scripts/cloud_agent_setup.sh
Installs: Java 25, MySQL 8.4 (port 3309), Redis (port 6380), xvfb, and initializes
test databases.
```bash
pnpm frontend:test
```
Single file: pnpm -C frontend test tests/path/to/TestFile.spec.ts (no -- before the path).
```bash
source /workspace/scripts/cloud_agent_setup.sh
./backend/gradlew -p backend migrateTestDB -Dspring.profiles.active=test
./backend/gradlew -p backend test -Dspring.profiles.active=test --build-cache --parallel
```
```bash
source /workspace/scripts/cloud_agent_setup.sh
pnpm bundle:all
pnpm exec run-p -clnr backend:sut:ci start:mb local:lb &
NO_PROXY=127.0.0.1,localhost pnpm exec wait-on http://127.0.0.1:5173/__lb__/ready --timeout 120000
xvfb-run pnpm cypress run --spec e2e_test/features/.feature --config-file e2e_test/config/ci.ts
```
- `pnpm sut:healthcheck` — check if stack is up
- `pnpm sut:restart` — SIGTERM listeners on 5173/5174/9081, then restart (requires `lsof`)
<success_criteria>
- Setup script run when backend/E2E needed
- Commands run without nix prefix
- Correct ports and healthcheck commands available
- Final output includes
## CLOUD VM READY
</success_criteria>
Confirm environment state and which test commands to use.
Common commands:
| Task | Command |
|---|
| Frontend tests | pnpm frontend:test |
| Backend tests | pnpm backend:verify |
| Linting | pnpm lint:all |
| Formatting | pnpm format:all |
## CLOUD VM READY
<out_of_scope>
- Do not use
CURSOR_DEV=true nix develop -c on Cloud VM.
- Do not assume local Nix shell ports or paths (
/Users/... vs /workspace/...).
</out_of_scope>
