How lam5943/cse-hq-bot-2026 works
CSE-HQ is a Discord-native project coordination bot. Users interact through Discord commands and views; those reach project operations, collaboration records, reporting, and grounded AI features, with SQLite persistence. Optional GitHub synchronization and webhook-driven Forum publishing form a separate integration branch. The README documents capabilities such as welcomes and scheduled dashboard snapshots whose implementation wiring is not established by the excerpts, so those are represented only where the tree supports a component; edges rely on README statements or SOURCE INDEX references, not unsampled call-flow assumptions.
Main entry points: repositories Domain repositories · ui.py Commands and views · ai_session_service.py Assistant sessions · ai_service.py Grounded AI answers
Components 26
Discord interface
- Bot runtime
cse_hq_bot/bot.py - Commands and views
cse_hq_bot/ui.py
Project coordination
- Role permissions
cse_hq_bot/permissions.py - Project settings
cse_hq_bot/services/project_service.py - Task operations
cse_hq_bot/services/task_service.py - Bug operations
cse_hq_bot/services/bug_service.py - Meetings and decisions
cse_hq_bot/services/meeting_service.py - Standup tracking
cse_hq_bot/services/standup_service.py - Progress reports
cse_hq_bot/services/report_service.py - Weekly dashboard
cse_hq_bot/services/weekly_dashboard_service.py
Grounded assistant
- Assistant sessions
cse_hq_bot/services/ai_session_service.py - Grounded AI answers
cse_hq_bot/services/ai_service.py - Project context retrieval
cse_hq_bot/services/project_context_service.py - Confirmed AI actions
cse_hq_bot/services/ai_action_service.py - AI providers
cse_hq_bot/ai/provider_router.py - Read-only web research
cse_hq_bot/services/web_research_service.py
Persistence
- SQLite database
cse_hq_bot/db.py - Domain repositories
cse_hq_bot/repositories
External integrations
- GitHub integration
cse_hq_bot/services/github_service.py - GitHub API provider
cse_hq_bot/github_provider.py - GitHub webhook
cse_hq_bot/github_webhook.py - Forum publishing
cse_hq_bot/services/forum_publishing_service.py - Discord Forum gateway
cse_hq_bot/discord_forum_gateway.py
Other components
- Discord users
- GitHub
- Tavily search
Connections 34
- Discord users → Bot runtime: uses Discord
- Bot runtime → Commands and views: registers interface
cse_hq_bot/bot.py - Commands and views → Project settings: invokes operations
cse_hq_bot/ui.py - Commands and views → Task operations: invokes operations
cse_hq_bot/ui.py - Commands and views → Bug operations: invokes operations
cse_hq_bot/ui.py - Commands and views → Meetings and decisions: invokes operations
cse_hq_bot/ui.py - Commands and views → Standup tracking: invokes operations
cse_hq_bot/ui.py - Commands and views → GitHub integration: invokes operations
cse_hq_bot/ui.py - Task operations → Role permissions: checks access
cse_hq_bot/services/task_service.py - Bug operations → Role permissions: checks access
cse_hq_bot/services/bug_service.py - Meetings and decisions → Role permissions: checks access
cse_hq_bot/services/meeting_service.py - Project settings → Domain repositories: uses repository
cse_hq_bot/services/project_service.py - Task operations → Domain repositories: uses repository
cse_hq_bot/services/task_service.py - Bug operations → Domain repositories: uses repository
cse_hq_bot/services/bug_service.py - Meetings and decisions → Domain repositories: uses repository
cse_hq_bot/services/meeting_service.py - Domain repositories → SQLite database: reads and writes
cse_hq_bot/repositories/collab_repository.py - Commands and views → Assistant sessions: starts sessions
- Assistant sessions → Grounded AI answers: requests answers
cse_hq_bot/services/ai_session_service.py - Grounded AI answers → Project context retrieval: retrieves project context
cse_hq_bot/services/ai_service.py - Grounded AI answers → AI providers: generates response
- Grounded AI answers → Read-only web research: requests research
cse_hq_bot/services/ai_service.py - Read-only web research → Tavily search: searches web
- Assistant sessions → Domain repositories: persists sessions
cse_hq_bot/services/ai_session_service.py - Assistant sessions → Confirmed AI actions: handles proposals
cse_hq_bot/services/ai_session_service.py - Confirmed AI actions → Domain repositories: persists proposals
cse_hq_bot/services/ai_action_service.py - GitHub integration → GitHub API provider: fetches repository data
cse_hq_bot/services/github_service.py - GitHub integration → Domain repositories: caches records
cse_hq_bot/services/github_service.py - GitHub → GitHub API provider: provides repository data
- GitHub → GitHub webhook: sends events
cse_hq_bot/github_webhook.py - GitHub webhook → Forum publishing: routes events
cse_hq_bot/github_webhook.py - Forum publishing → Domain repositories: deduplicates publications
cse_hq_bot/services/forum_publishing_service.py - Forum publishing → Discord Forum gateway: publishes posts
- Progress reports → Domain repositories: reads project records
- Weekly dashboard → Domain repositories: stores snapshots