How devfiqi/colorstack-ai works
ColorStack AI turns Discord conversations into persistent organizational facts, reconciles them into current state, evaluates event readiness, and builds bounded context for executive reasoning and daily briefs. Users can inspect operational data through a read-only local dashboard. The README documents the major workflow and capabilities; source-index relationships support several internal links, but unsampled implementations and frontend request wiring are not inferred.
Main entry points: session.py PostgreSQL · builder.py Context builder · briefing/service.py Brief generation · reasoning/service.py Cloud reasoning
Components 20
Discord ingestion
- Discord bot
src/colorstack_ai/discord/client.py - Message ingestion
src/colorstack_ai/ingestion
Organizational operations
- Local extraction
src/colorstack_ai/extraction - Organizational state
src/colorstack_ai/state - Event playbooks
src/colorstack_ai/playbooks - Requirement evaluation
src/colorstack_ai/requirements
Context and reasoning
- Context builder
src/colorstack_ai/context/builder.py - Bounded retrieval
src/colorstack_ai/context/retrieval.py - Query interpretation
src/colorstack_ai/context/query_parser.py - Cloud reasoning
src/colorstack_ai/reasoning/service.py - Reasoning provider
src/colorstack_ai/reasoning/providers/openai.py
Briefing and dashboard
- Brief generation
src/colorstack_ai/briefing/service.py - Brief formatting
src/colorstack_ai/briefing/formatter.py - Brief delivery
src/colorstack_ai/briefing/delivery.py - Dashboard API
src/colorstack_ai/api/service.py - API routes
src/colorstack_ai/api/routes/dashboard.py - Dashboard interface
frontend/src/routes
Persistence
- PostgreSQL
src/colorstack_ai/db/session.py
Other components
- Discord server
- Dashboard user
Connections 24
- Discord server → Discord bot: sends messages
README.md - Discord bot → Message ingestion: ingests messages
src/colorstack_ai/discord/client.py - Message ingestion → PostgreSQL: stores raw messages
README.md - PostgreSQL → Local extraction: supplies messages
README.md - Local extraction → PostgreSQL: stores extracted facts
README.md - Organizational state → PostgreSQL: persists current state
README.md - Event playbooks → PostgreSQL: stores playbooks
README.md - Requirement evaluation → PostgreSQL: stores evaluations
README.md - Context builder → Bounded retrieval: builds from retrieval
src/colorstack_ai/context/builder.py - Bounded retrieval → PostgreSQL: reads organizational data
src/colorstack_ai/context/retrieval.py - Query interpretation → Context builder: interprets queries
src/colorstack_ai/context/builder.py - Context builder → Cloud reasoning: provides bounded context
README.md - Cloud reasoning → Reasoning provider: invokes provider
src/colorstack_ai/reasoning/service.py - Reasoning provider → Cloud reasoning: returns response
- Context builder → Brief generation: supplies organization context
src/colorstack_ai/briefing/service.py - Brief generation → Cloud reasoning: requests reasoning
src/colorstack_ai/briefing/service.py - Brief generation → Brief formatting: formats brief
src/colorstack_ai/briefing/service.py - Brief generation → PostgreSQL: records brief runs
- Brief delivery → Discord server: delivers executive brief
README.md - API routes → Dashboard API: routes dashboard requests
src/colorstack_ai/api/routes/dashboard.py - Dashboard API → Context builder: builds dashboard context
src/colorstack_ai/api/service.py - Dashboard API → PostgreSQL: reads dashboard data
src/colorstack_ai/api/service.py - Dashboard user → Dashboard interface: views dashboard
README.md - Dashboard interface → API routes: requests dashboard data