How rudrao2/tara works
Tara is an AI community manager: members ask questions in chat, Tara consults Notion-backed knowledge and responds; unknowns go to organizers for answers that are relayed and learned. It also detects and tracks member problems, and routes human-needed work through notifications and approvals. Organizers use the web dashboard and phone PWA to review cases, approve actions, and operate the console. The graph preserves these documented capabilities; some subsystems are represented by exact source directories because their implementation was not sampled. Edges reflect shown calls, source-index references, or README statements; unsampled relationships are omitted.
Main entry points: pipeline.ts Event processing · channels.ts Channel actions · approvals.ts Action approvals · community.ts Community agent
Components 27
Community channels
- Telegram adapter
src/channels/telegram.ts - Slack adapter
src/channels/slack.ts - WhatsApp adapter
src/channels/whatsapp.ts - Message batching
src/conversation/batcher.ts - Event processing
src/pipeline.ts
Agent and learning
- Community agent
src/agent/community.ts - Learning agent
src/agent/learn.ts - Mood analysis
src/agent/mood.ts
Care and operations
- Member cases
src/core/cases.ts - Human notifications
src/core/notify.ts - Care and digest jobs
src/jobs - Operator console agent
src/agent/console.ts - Action approvals
src/core/approvals.ts - Channel actions
src/core/channels.ts
Knowledge and safeguards
- Knowledge service
src/kb/knowledge.ts - Notion knowledge base
- Group guides and timeline
src/kb - Execution policies
src/swy/policies.ts - Execution runtime
src/swy/exec.ts - SQLite repository
src/store/repo.ts
Organizer interfaces
- Web API server
src/server/app.ts - Organizer dashboard
web/src/App.tsx - Phone PWA
web/src/mobile/MobileApp.tsx - Phone push
src/core/notify.ts
Other components
- Community members
- Organizers
- Resend email
Connections 37
- Community members → Telegram adapter: message
- Community members → Slack adapter: message
- Community members → WhatsApp adapter: message
- Telegram adapter → Event processing: ingests
- Slack adapter → Event processing: ingests
- WhatsApp adapter → Event processing: emits events
src/channels/whatsapp.ts - Event processing → Message batching: batches messages
src/pipeline.ts - Event processing → Community agent: runs agent
src/pipeline.ts - Event processing → Learning agent: runs learning
src/pipeline.ts - Event processing → Mood analysis: reads mood
src/pipeline.ts - Community agent → Knowledge service: searches knowledge
- Learning agent → Knowledge service: writes answers
src/agent/learn.ts - Knowledge service → Notion knowledge base: syncs and writes
src/kb/knowledge.ts - Community agent → Group guides and timeline: uses guide context
- Event processing → Member cases: updates cases
src/pipeline.ts - Mood analysis → Member cases: scores members
src/core/cases.ts - Member cases → Human notifications: escalates attention
src/core/cases.ts - Human notifications → Phone push: sends alerts
src/core/notify.ts - Human notifications → Resend email: emails organizers
- Care and digest jobs → Community agent: runs care sweep
- Care and digest jobs → Knowledge service: archives digest
src/jobs/digest.ts - Care and digest jobs → Resend email: emails digest
- Organizers → Operator console agent: requests actions
- Organizer dashboard → Web API server: uses API
- Phone PWA → Web API server: uses API
- Web API server → Action approvals: serves approval state
- Operator console agent → Action approvals: creates previews
src/agent/console.ts - Organizers → Action approvals: approves actions
- Action approvals → Channel actions: executes approved actions
src/core/approvals.ts - Channel actions → Telegram adapter: sends messages
src/core/channels.ts - Channel actions → Slack adapter: sends messages
src/core/channels.ts - Channel actions → WhatsApp adapter: sends messages
src/core/channels.ts - Channel actions → Execution runtime: executes guarded tools
src/core/channels.ts - Execution runtime → Execution policies: checks policies
src/swy/policies.ts - Event processing → SQLite repository: persists conversation state
src/pipeline.ts - Member cases → SQLite repository: stores cases
src/core/cases.ts - Action approvals → SQLite repository: stores approvals
src/core/approvals.ts