Skip to content

Fix BACKEND_URL docs and frontend env setup - #4

Merged
ntemposd merged 7 commits into
mainfrom
cursor/fix-backend-url-docs-ba48
Jun 9, 2026
Merged

ntemposd merged 7 commits into
mainfrom
cursor/fix-backend-url-docs-ba48

Conversation

@ntemposd

@ntemposd ntemposd commented Jun 9, 2026 •

Copy link
Copy Markdown
Owner

Summary

Aligns documentation and setup with the current Next.js proxy architecture, fixes CI-blocking backend test drift, and adds production build validation for BACKEND_URL.

Changes

Documentation & setup

  • README.md: Split backend/frontend env setup; document proxy model; remove stale NEXT_PUBLIC_BACKEND_URL guidance
  • frontend/lib/http.ts: Update network error message to reference BACKEND_URL and BACKEND_API_KEY
  • frontend/lib/README.md: Clarify proxy architecture
  • backend/README.md: Correct retrieval/RAG notes to match topic-only queries and disabled-by-default neighbor enrichment
  • setup.sh / setup.bat: Auto-create frontend/.env.local from example

Production hardening

  • frontend/next.config.ts: Fail production builds when BACKEND_URL is missing

CI fix

  • backend/tests/: Update stale tests for topic-only RAG queries, 4-arg fetch_context_messages, and opt-in neighbor_window=1 enrichment

Verification

  • python -m unittest discover -s backend/tests — 66 tests pass
  • BACKEND_URL=http://localhost:8000 npm run build — succeeds
Open in Web Open in Cursor 

Replace stale NEXT_PUBLIC_BACKEND_URL references with the current
server-side proxy model. Update README, error copy, and setup scripts to
create frontend/.env.local from the example so local dev works out of the box.

Co-authored-by: Dimitrios Ntempos <dimitriosntempos@gmail.com>
@vercel

vercel Bot commented Jun 9, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
exhumed Ready Ready Preview, Comment Jun 9, 2026 7:09am

- Align turn_workflow and database unit tests with topic-only RAG queries
  and opt-in neighbor enrichment (neighbor_window=1)
- Fail production frontend builds when BACKEND_URL is unset
- Correct backend README retrieval notes to match current behavior

Co-authored-by: Dimitrios Ntempos <dimitriosntempos@gmail.com>
Align architecture and prompt-construction docs with the runtime default
in settings.py and .env.example. Note that larger models remain available
via LLM_MODEL_ID when quota allows.

Co-authored-by: Dimitrios Ntempos <dimitriosntempos@gmail.com>
Mark agt_010, agt_015, and agt_016 as unavailable until their source
material is ingested. Filter them from default councils and saved
selections, block drafting in the controller, and show them as disabled
'Corpus pending' options in the speaker roster.

Co-authored-by: Dimitrios Ntempos <dimitriosntempos@gmail.com>
Detect localhost BACKEND_URL on Vercel, map Vercel auth HTML to a clear
proxy error, show council load failures in the UI, and document Preview
environment requirements.

Co-authored-by: Dimitrios Ntempos <dimitriosntempos@gmail.com>
Co-authored-by: Dimitrios Ntempos <dimitriosntempos@gmail.com>
…atch

Co-authored-by: Dimitrios Ntempos <dimitriosntempos@gmail.com>
@ntemposd
ntemposd merged commit 1bddbbf into main Jun 9, 2026
4 checks passed

This branch was successfully deployed

1 active deployment
Preview — 7013df8b Deployed Jun 9, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants