chore(env): add Cloud Agent development environment - #2
Draft
Bigdez55 wants to merge 1 commit into
Draft
Conversation
Add .cursor/environment.json + install.sh to make the KJVA Bible app usable in Cloud Agents: - install: create backend venv (MLX stripped for linux, retrieval-only per ADR-0003), install cryptography (AES-GCM backend the soul-manager runtime needs to bootstrap) + pytest/httpx/ruff, and npm ci the Vite frontend. - terminals: FastAPI backend on :8001 and Vite dev server on :5173. - ports: expose 8001 and 5173. Verified: 64/64 backend tests pass, retrieval completion + verse browsing work end to end, install is idempotent. Co-authored-by: Desmond <Bigdez55@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a Cursor Cloud Agent development environment for the KJVA Bible app so future agents boot into a working backend + frontend without manual setup. No application code is changed.
New files:
.cursor/environment.json— install command, dev-server terminals, and exposed ports (repository-managed, highest-precedence source)..cursor/install.sh— idempotent bootstrap for the Python backend venv and the React/Vite frontend.What the environment provides
:8001) — creates a.venv, installsbackend/requirements.txtwith MLX stripped (Apple-Silicon-only; linux runs the documented retrieval-first path per ADR-0003), pluscryptography,pytest,httpx,ruff.:5173) —npm ci; the dev server proxies/apito the backend.Why
cryptographyis installed hereIt is not in
backend/requirements.txt, but the KJVA soul-manager runtime needs an AES-GCM backend to bootstrap. Without it,POST /api/completefails withRUNTIME_NOT_BOOTSTRAPPEDand 3 backend tests fail. Installing it in the environment leaves the app source untouched while making the runtimecognitive_ready.Validation
Validated on the working VM, then re-validated by a prebuilt environment build and a fresh Cloud Agent booted from that build.
pytest)bash .cursor/install.sh)ok/api/healthstatus: ok,cognitive_ready: true, verse index loaded, no bootstrap errorJohn 3:16,Numbers 15:37-41, prefix match)/apiproxyVerified via the exact
terminalscommands fromenvironment.json.