How atomslight/nordavo_project_support_agent works
Nordavo is a CLI support-ticket agent. The user runs analysis or decision commands; workflows fetch tickets, redact sensitive text, classify language, and—when deciding—use the FAQ to prepare a validated reply, handoff, or closure. Decisions are persisted locally; sending is a separate explicit operation that posts approved saved actions to the Helpdesk. The graph also shows provider fallback, local state and audit logging. Relationships follow the supplied excerpts, SOURCE INDEX references, and README; unsampled subsystem internals are not inferred.
Main entry points: decision_workflow.py Decision and send workflow · cli.py Command interface · decision.py Decision classifier · language.py Language classifier
Components 17
CLI and configuration
- Command interface
src/nordavo/cli.py - Settings
src/nordavo/be/config.py
Ticket processing
- Language analysis workflow
src/nordavo/workflow.py - Decision and send workflow
src/nordavo/decision_workflow.py - Helpdesk client
src/nordavo/be/helpdesk.py - Ticket and decision models
src/nordavo/models.py
AI and safety
- Redaction and validation
src/nordavo/ai/safety.py - Language classifier
src/nordavo/ai/language.py - Decision classifier
src/nordavo/ai/decision.py - Prompt rules
src/nordavo/ai/prompts.py
State and audit
- Ticket state store
src/nordavo/be/state.py - Decision ledger
src/nordavo/be/decision_state.py - Run audit log
src/nordavo/be/run_log.py
Other components
- CLI user
- Helpdesk API
- Gemini and Groq
- Support FAQ
data/knowledgebase/faq.md
Connections 32
- CLI user → Command interface: runs commands
README.md - Command interface → Settings: loads settings
src/nordavo/cli.py - Command interface → Language analysis workflow: starts analysis
src/nordavo/cli.py - Command interface → Decision and send workflow: starts decisions
src/nordavo/cli.py - Command interface → Helpdesk client: builds client
src/nordavo/cli.py - Command interface → Language classifier: builds analyzer
src/nordavo/cli.py - Command interface → Decision classifier: builds analyzer
src/nordavo/cli.py - Command interface → Run audit log: creates audit
src/nordavo/cli.py - Language analysis workflow → Helpdesk client: fetches tickets
src/nordavo/workflow.py - Language analysis workflow → Redaction and validation: redacts tickets
src/nordavo/workflow.py - Language analysis workflow → Language classifier: analyzes text
src/nordavo/workflow.py - Language analysis workflow → Ticket state store: saves results
src/nordavo/workflow.py - Decision and send workflow → Helpdesk client: fetches tickets
src/nordavo/decision_workflow.py - Decision and send workflow → Redaction and validation: redacts tickets
src/nordavo/decision_workflow.py - Decision and send workflow → Language classifier: analyzes language
src/nordavo/decision_workflow.py - Decision and send workflow → Decision classifier: requests decisions
src/nordavo/decision_workflow.py - Decision and send workflow → Ticket state store: reads and updates
src/nordavo/decision_workflow.py - Decision and send workflow → Decision ledger: saves decisions
src/nordavo/decision_workflow.py - Decision and send workflow → Run audit log: records events
src/nordavo/decision_workflow.py - Decision and send workflow → Support FAQ: reads FAQ
README.md - Decision and send workflow → Helpdesk client: sends approved actions
src/nordavo/decision_workflow.py - Helpdesk client → Helpdesk API: requests tickets and posts
README.md - Language classifier → Gemini and Groq: classifies with fallback
src/nordavo/ai/language.py - Decision classifier → Gemini and Groq: decides with fallback
src/nordavo/ai/decision.py - Decision classifier → Prompt rules: uses decision rules
src/nordavo/ai/decision.py - Language classifier → Prompt rules: uses language prompt
src/nordavo/ai/language.py - Decision classifier → Redaction and validation: validates output
src/nordavo/ai/decision.py - Language classifier → Ticket and decision models: returns assessment
src/nordavo/ai/language.py - Decision classifier → Ticket and decision models: returns decision
src/nordavo/ai/decision.py - Helpdesk client → Ticket and decision models: maps ticket data
src/nordavo/be/helpdesk.py - Ticket state store → Ticket and decision models: stores ticket data
src/nordavo/be/state.py - Decision ledger → Ticket and decision models: stores decisions
src/nordavo/be/decision_state.py