Set up Cursor Cloud dev environment (Redpanda epoll fix + AGENTS.md)

[Vinosaamaa]

Summary

• Configured and verified the full Chanter local development environment (infra + backend microservices + frontend) on a Cursor Cloud VM.
• Forced Redpanda's Seastar reactor backend to epoll in infra/docker-compose.yml; the default linux-aio backend crashes on startup in restricted container/VM environments (close() syscall failed: Invalid argument). epoll is supported on all Linux hosts, so it is safe for every dev environment.
• Added AGENTS.md with a ## Cursor Cloud specific instructions section capturing non-obvious startup/run/test caveats for future agents.

Acceptance Criteria

• make product-up brings up all services and make product-health passes.
• Lint and tests run green for frontend and backend.
• Core product functionality is exercised end-to-end (channel chat + AI Study Assistant).

Test Plan

• Unit tests — backend mvn test (all modules) and frontend vitest run (203 tests)
• Integration or contract tests
• Frontend tests — npm run lint + npm test
• Docker Compose smoke test — infra healthy; make product-health passes
• Not applicable because:

Manual verification:

• Signed in as the demo learner, posted a message in #general (realtime channel chat), and asked the AI Study Assistant a question in #questions — both worked end-to-end.

chanter_channel_chat_demo.mp4
chanter_ai_study_assistant_demo.mp4
Message posted in #general channel
AI Study Assistant answer in #questions

Architecture And Operations Notes

• Service boundaries changed: no
• Database migrations added: no
• Events or API contracts changed: no
• Security or permission behavior changed: no
• Observability impact: no

Checklist

• Scope is a vertical slice with a clear user or operator outcome.
• Backend permission checks are enforced by the service performing the protected action.
• No secrets or local-only credentials are committed.
• Docs or ADRs are updated for durable architecture/process decisions.

_{To show artifacts inline, enable in settings.}

  

[codeant-ai]

🏁 CodeAnt Quality Gate Results

Commit: ecd670bc
Scan Time: 2026-07-16 05:04:00 UTC

✅ Overall Status: PASSED

Quality Gate Details

Quality Gate	Status	Details
Duplicate Code	✅ PASSED	0.0% duplicated
SAST	✅ PASSED	No security issues
IAC	✅ PASSED	Rating S: No issues

View Full Results