How venkatganeshreddy/cd_relay works
Relay is a role-aware department operating copilot: contributors submit daily work and leads manage goals, tasks, and worklogs; the workspace consolidates this activity into reports, recommendations, and planning drafts. Its React screens use a shared Supabase client for data and auth, while server-side agent graphs provide grounded AI workflows. The repository also exposes Relay data through MCP servers. The README documents these system boundaries and capabilities; some wiring and implementation details are unsampled, so those relationships are not expanded.
Main entry points: app.jsx App & Routing · modal_app.py Agent HTTP Endpoints · common.py Shared Agent Runtime · supabase-client.js Data & Auth Client
Components 30
Department Workspace
- App & Routing
app.jsx - Role Access
views-auth.jsx - Daily Reports
views-submit.jsx - Tasks & Escalations
views-ops.jsx - Team Goals
views-goals.jsx - Department Worklogs
views-worklogs.jsx - Dashboard & Roll-ups
views-dashboard.jsx - Meeting Notes
views-relay.jsx - Concierge Q&A
views-copilot.jsx - Engram Feedback
views-engram.jsx - Agent Farm
views-farm.jsx - Codex & System Map
views-architecture.jsx
AI Agent Workflows
- Advisor Recommendations
agents/graphs/advisor.py - Scribe & Dispatcher
agents/graphs/scribe.py - Grounded Roll-ups
agents/graphs/rollup.py - Monthly Planner
agents/graphs/planner.py - Curator Memory
agents/graphs/curator.py - Sentry Escalation
agents/graphs/sentry.py
Agent Runtime
- Agent HTTP Endpoints
agents/modal_app.py - Shared Agent Runtime
agents/graphs/common.py - LLM & REST Access
agents/llm.py - Structured Output Schemas
agents/graphs/schemas.py
Data & Integrations
- Data & Auth Client
supabase-client.js - Supabase Store & Auth
- MCP Read Tools
mcp/tools.mjs - Local MCP Server
mcp/server.mjs - OAuth MCP Server
mcp/oauth-server.mjs
Other components
- Contributor / Lead
- Claude MCP Client
- OpenRouter Models
Connections 43
- Contributor / Lead → App & Routing: uses
README.md - App & Routing → Role Access: routes to
README.md - App & Routing → Daily Reports: loads screens
README.md - App & Routing → Tasks & Escalations: loads screens
README.md - App & Routing → Team Goals: loads screens
README.md - App & Routing → Department Worklogs: loads screens
README.md - App & Routing → Dashboard & Roll-ups: loads screens
README.md - App & Routing → Meeting Notes: loads screens
README.md - App & Routing → Concierge Q&A: loads screens
README.md - App & Routing → Engram Feedback: loads screens
README.md - App & Routing → Agent Farm: loads screens
README.md - App & Routing → Codex & System Map: loads screens
README.md - Role Access → Data & Auth Client: uses
README.md - Daily Reports → Data & Auth Client: persists reports
README.md - Tasks & Escalations → Data & Auth Client: reads and writes
README.md - Team Goals → Data & Auth Client: persists goals
README.md - Department Worklogs → Data & Auth Client: reads worklogs
README.md - Dashboard & Roll-ups → Data & Auth Client: reads reports
README.md - Data & Auth Client → Supabase Store & Auth: queries and writes
README.md - Contributor / Lead → Agent HTTP Endpoints: requests agent work
README.md - Agent HTTP Endpoints → Advisor Recommendations: dispatches to
agents/modal_app.py - Agent HTTP Endpoints → Scribe & Dispatcher: dispatches to
agents/modal_app.py - Agent HTTP Endpoints → Grounded Roll-ups: dispatches to
agents/modal_app.py - Agent HTTP Endpoints → Monthly Planner: dispatches to
agents/modal_app.py - Agent HTTP Endpoints → Curator Memory: dispatches to
agents/modal_app.py - Agent HTTP Endpoints → Sentry Escalation: dispatches to
agents/modal_app.py - Advisor Recommendations → Shared Agent Runtime: calls
agents/graphs/advisor.py - Scribe & Dispatcher → Shared Agent Runtime: calls
agents/graphs/scribe.py - Grounded Roll-ups → Shared Agent Runtime: calls
agents/graphs/rollup.py - Monthly Planner → Shared Agent Runtime: calls
agents/graphs/planner.py - Curator Memory → Shared Agent Runtime: calls
agents/graphs/curator.py - Sentry Escalation → Shared Agent Runtime: uses
agents/graphs/sentry.py - Shared Agent Runtime → LLM & REST Access: calls
agents/graphs/common.py - Shared Agent Runtime → Structured Output Schemas: validates outputs
agents/graphs/common.py - LLM & REST Access → OpenRouter Models: sends prompts
agents/llm.py - LLM & REST Access → Supabase Store & Auth: reads and writes
agents/llm.py - Local MCP Server → MCP Read Tools: registers tools
mcp/server.mjs - OAuth MCP Server → MCP Read Tools: uses tools
mcp/oauth-server.mjs - Claude MCP Client → Local MCP Server: queries
README.md - Claude MCP Client → OAuth MCP Server: connects
README.md - MCP Read Tools → Supabase Store & Auth: queries Relay data
mcp/tools.mjs - Engram Feedback → Curator Memory: feeds corrections
- Concierge Q&A → Agent HTTP Endpoints: forwards questions