How andreipath26/whaxon-ai-forensics works
WHAXON is a defensive security-assessment application: operators define authorized scope, run supported assessments, interpret and validate observations, preserve evidence, report results, and retest remediation. The CLI, browser API, and optional TUI/desktop interfaces expose a shared core, while Engine V2 adds durable, approval-bound workflow plans and run requests. The graph combines documented product stages with source-index-supported connections; unsampled subsystems are represented by their exact directories, and uncertain internal links are omitted.
Main entry points: __init__.py Shared core · server.py Web workspace/API · runner.py Assessment runner · workflow.py Workflow contracts
Components 25
Operator interfaces
- Command-line
src/whaxon/cli.py - Web workspace/API
src/whaxon/interfaces/web/server.py - Terminal interface
src/whaxon/interfaces/tui/screens/main.py - Desktop shell
src/whaxon/interfaces/gui/app.py
Assessment execution
- Shared core
src/whaxon/core/__init__.py - Scope and policy
src/whaxon/core/scope.py - Tool catalog
src/whaxon/core/catalog.py - Assessment runner
src/whaxon/core/runner.py - Tool adapters
src/whaxon/adapters/base.py - Recon services
src/whaxon/core/recon_v2.py
Evidence and reporting
- Finding validation
src/whaxon/core/validator.py - Finding analysis
src/whaxon/core/findings.py - Assessment store
src/whaxon/core/store.py - Reports
src/whaxon/core/report.py - Remediation retesting
src/whaxon/core/remediation.py
Workflow engine
- Workflow contracts
src/whaxon/core/workflow.py - Capability providers
src/whaxon/core/providers.py - Plan proposals
src/whaxon/core/workflow_proposals.py - Workflow scheduler
src/whaxon/core/scheduler.py - Workflow worker
src/whaxon/core/worker.py
AI assistance
- AI bridge
src/whaxon/core/ai_bridge.py - LLM provider
src/whaxon/ai/providers/llm.py
Other components
- Operator
- External security tools
- LLM service
Connections 32
- Operator → Command-line: initiates assessment
src/whaxon/cli.py - Command-line → Shared core: requests operations
- Operator → Web workspace/API: uses workspace
README.md - Web workspace/API → Shared core: routes API calls
src/whaxon/interfaces/web/server.py - Operator → Terminal interface: uses terminal UI
README.md - Terminal interface → Shared core: uses shared core
src/whaxon/interfaces/tui/app.py - Desktop shell → Web workspace/API: embeds web UI
src/whaxon/interfaces/gui/app.py - Shared core → Scope and policy: checks authorization
src/whaxon/core/__init__.py - Shared core → Tool catalog: loads catalog
src/whaxon/core/__init__.py - Shared core → Assessment runner: orchestrates tools
src/whaxon/core/__init__.py - Assessment runner → Tool adapters: dispatches tools
- Tool adapters → External security tools: invokes tools
- Shared core → Recon services: offers recon services
src/whaxon/core/__init__.py - Operator → Scope and policy: defines authorized scope
README.md - Operator → Assessment runner: runs assessment
README.md - Assessment runner → Finding analysis: collects observations
README.md - Finding analysis → Finding validation: validates supported cases
README.md - Finding validation → Assessment store: preserves evidence
- Finding analysis → Assessment store: stores assessment data
- Reports → Assessment store: reads assessment data
src/whaxon/core/report.py - Reports → Scope and policy: reads scope context
src/whaxon/core/report.py - Operator → Reports: produces assessment report
README.md - Operator → Remediation retesting: retests remediation
README.md - Web workspace/API → Workflow contracts: exposes workflow APIs
src/whaxon/interfaces/web/server.py - Command-line → Workflow contracts: offers workflow commands
- Workflow contracts → Workflow scheduler: schedules plans
- Workflow scheduler → Workflow worker: dispatches tasks
- Plan proposals → Workflow contracts: constructs plans
src/whaxon/core/workflow_proposals.py - Plan proposals → Capability providers: checks provider contracts
src/whaxon/core/workflow_proposals.py - AI bridge → Plan proposals: prepares reviewable plans
src/whaxon/core/ai_bridge.py - AI bridge → LLM provider: uses LLM provider
src/whaxon/core/ai_bridge.py - LLM provider → LLM service: requests suggestions