How whitewolf251501-dot/aa-os-yuvi works
YUVI is a browser-based AI business operating system for running a small growth-agency workspace. Its main interaction is a user sending a message through the app: intent detection routes recognized requests to skills, while other messages are enriched with business, memory, and knowledge context before going to Groq and returning to the chat. The workspace also covers lead/client management, generated-output libraries and chat widgets, uploaded knowledge, proactive follow-ups, and configurable skills. The README documents the core chat and skill flow; sampled source supports knowledge and widget behavior, while some workspace wiring is only visible in the app as a whole.
Main entry points: app.js App Workspace · contextBuilder.js Context Builder · brain.js Brain API · groq.js Groq Adapter
Components 30
Business Workspace
- App Workspace
app.js - Chat Interface
index.html - Leads And Clients
app.js - Output Library
brain/libraryEngine.js - Chat Widgets
brain/widgetEngine.js
AI Conversation
- Brain API
brain/brain.js - Intent Detection
brain/intentDetector.js - Prompt Composer
brain/promptComposer.js - Skill Orchestrator
brain/skillOrchestrator.js - Groq Adapter
integrations/groq.js
Skills And Knowledge
- Skill Registry
skills/skillRegistry.js - Skill Loader
skills/skillLoader.js - Skill Manager
skills/skillManager.js - Uploaded Prompt Skills
skills/promptSkillEngine.js - File Parser
knowledge/fileParser.js - Knowledge Manager
knowledge/knowledgeManager.js
Memory And Security
- Context Builder
memory/contextBuilder.js - Browser Storage
memory/contextBuilder.js - Encrypted Vault
core/vault.js - Biometric Helper
core/webauthn.js
Automation And Integrations
- Event Bus
brain/eventBus.js - Event Rules
automation/eventRules.js - Scheduler
automation/scheduler.js - Proactive Engine
brain/proactiveEngine.js - GitHub Memory
integrations/github.js - Canva Links
integrations/canva.js - WhatsApp Links
integrations/whatsapp.js - n8n Integration
integrations/n8n.js
Other components
- Business User
- Groq API
Connections 38
- Business User → Chat Interface: sends message
- Chat Interface → App Workspace: forwards input
- App Workspace → Brain API: calls chat
- Brain API → Intent Detection: detects intent
- Intent Detection → Skill Orchestrator: routes match
- Skill Orchestrator → Skill Registry: executes skill
- Brain API → Prompt Composer: composes fallback
- Prompt Composer → Context Builder: requests context
- Context Builder → Knowledge Manager: reads knowledge
- Context Builder → GitHub Memory: reads memory
- Context Builder → Browser Storage: reads local data
- Prompt Composer → Groq Adapter: builds messages
- Groq Adapter → Groq API: sends prompt
- Groq API → Groq Adapter: returns response
- Groq Adapter → Brain API: returns response
- Brain API → App Workspace: returns result
- App Workspace → Chat Interface: renders reply
- App Workspace → Leads And Clients: manages records
- App Workspace → Output Library: archives outputs
- App Workspace → Chat Widgets: manages widgets
- App Workspace → Encrypted Vault: secures workspace
- Encrypted Vault → Biometric Helper: requests PRF
- App Workspace → Skill Manager: opens settings
- Skill Manager → Skill Registry: configures skills
- Skill Loader → Skill Registry: registers skills
- Uploaded Prompt Skills → Skill Registry: registers uploaded skill
- Skill Manager → Knowledge Manager: manages files
- Knowledge Manager → File Parser: parses uploads
- Knowledge Manager → Browser Storage: stores extracted text
- Context Builder → GitHub Memory: reads GitHub file
- GitHub Memory → Browser Storage: syncs memory
- App Workspace → Event Bus: emits workspace events
- Event Rules → Event Bus: subscribes rules
- Scheduler → Event Bus: dispatches scheduled events
- App Workspace → Proactive Engine: checks follow-ups
- App Workspace → Canva Links: opens design links
- App Workspace → WhatsApp Links: creates contact links
- App Workspace → n8n Integration: calls integration