How mohith535/nova-agentic-layer-over-taskflow works
Nova is a local-first AI layer over TaskFlow: a user asks for a briefing, coaching, planning, task action, or opportunity search, and Nova routes the request to a specialist that grounds its response or action in TaskFlow data. The web console also exposes profile onboarding, memory, behavioral context, and the Scout feed; the CLI offers the core agent and MCP entry points. The graph preserves the documented agent and integration branches. Some agent, storage, and web implementation details are unsampled, so uncertain relationships are omitted.
Main entry points: server.py Web console · tools.py Nova capability layer · orchestrator.py Agent router · tools_adk.py ADK tool wrappers
Components 28
User entry points
- Web console
nova/web/server.py - CLI
nova/main.py
Agent workflows
- Agent router
nova/orchestrator.py - Briefing agent
nova/agents/briefing_agent.py - Coach agent
nova/agents/coach_agent.py - Fast coach
nova/agents/fast_coach.py - Planning agent
nova/agents/planning_agent.py - Plan proposals
nova/agents/planner_propose.py - Task operator
nova/agents/operator_agent.py - Opportunity scout
nova/agents/scout_agent.py - Profile onboarding
nova/agents/profile_agent.py - Reflection
nova/agents/reflection_agent.py - Pattern insights
nova/agents/pattern_agent.py - Greeting
nova/agents/greeting_agent.py - ADK tool wrappers
nova/agents/tools_adk.py - MCP agent tools
nova/agents/mcp_backed.py
TaskFlow and memory
- Nova capability layer
nova/mcp/tools.py - TaskFlow reader
nova/mcp/taskflow_reader.py - TaskFlow writer
nova/mcp/taskflow_writer.py - Local memory
nova/memory/store.py - Domain models
nova/models.py - TaskFlow data
nova/mcp/taskflow_reader.py
MCP and integrations
- Model configuration
nova/config.py - MCP server
nova/mcp/server.py - Opportunity Hunter
nova/mcp/hunter_bridge.py
Other components
- User
- Gemini
- TaskFlow user data
Connections 40
- User → Web console: uses console
README.md - User → CLI: runs commands
README.md - Web console → Nova capability layer: reads context
nova/web/server.py - Web console → Profile onboarding: runs onboarding
nova/web/server.py - Web console → Reflection: requests reflection
nova/web/server.py - Web console → Greeting: requests greeting
nova/web/server.py - Web console → Agent router: routes requests
nova/web/server.py - CLI → Agent router: builds agent
nova/main.py - CLI → MCP server: runs MCP
nova/main.py - Agent router → Briefing agent: transfers briefing
nova/orchestrator.py - Agent router → Coach agent: transfers coaching
nova/orchestrator.py - Agent router → Planning agent: transfers planning
nova/orchestrator.py - Agent router → Task operator: transfers task action
nova/orchestrator.py - Agent router → Opportunity scout: transfers scouting
nova/orchestrator.py - Briefing agent → ADK tool wrappers: uses tools
nova/agents/briefing_agent.py - Coach agent → ADK tool wrappers: uses tools
nova/agents/coach_agent.py - Planning agent → ADK tool wrappers: uses tools
nova/agents/planning_agent.py - Task operator → ADK tool wrappers: uses tools
nova/agents/operator_agent.py - Opportunity scout → ADK tool wrappers: uses tools
nova/agents/scout_agent.py - Web console → Fast coach: runs fast coaching
nova/web/server.py - Web console → Pattern insights: requests patterns
nova/web/server.py - Web console → Plan proposals: proposes plans
nova/web/server.py - Planning agent → Plan proposals: prepares proposals
- ADK tool wrappers → Nova capability layer: calls capabilities
nova/agents/tools_adk.py - Coach agent → MCP agent tools: uses MCP optionally
nova/agents/coach_agent.py - MCP agent tools → MCP server: spawns subprocess
nova/agents/mcp_backed.py - MCP server → Nova capability layer: wraps capabilities
nova/mcp/server.py - Nova capability layer → TaskFlow reader: reads task data
nova/mcp/tools.py - Nova capability layer → TaskFlow writer: writes task data
nova/mcp/tools.py - Nova capability layer → Local memory: recalls and stores
nova/mcp/tools.py - Nova capability layer → Domain models: uses domain models
nova/mcp/tools.py - TaskFlow reader → TaskFlow data: resolves local data
nova/mcp/taskflow_reader.py - TaskFlow writer → TaskFlow reader: uses task reader
nova/mcp/taskflow_writer.py - TaskFlow reader → TaskFlow user data: reads local board
- TaskFlow writer → TaskFlow user data: updates local board
- Nova capability layer → Opportunity Hunter: delegates hunter actions
nova/mcp/tools.py - Model configuration → Gemini: validates API key
nova/config.py - Briefing agent → Model configuration: selects model
nova/agents/briefing_agent.py - Coach agent → Model configuration: selects model
nova/agents/coach_agent.py - Planning agent → Model configuration: selects model
nova/agents/planning_agent.py