How aadi3006/threatlenx works
ThreatLenX is an offline-first, client-side SOC investigation and threat-analysis platform. Analysts enter through the spatial command hub, choose a workspace, and use a shared security-service facade to work with local security data; investigation supports explaining incidents, while hunting and detection engineering support finding and testing threats. Case management, evidence auditing, response playbooks, metrics, integrations, and cyber-range simulation are distinct product capabilities. The README documents workspace navigation and capabilities; source-index references and excerpts support only the cited internal links, so other plausible runtime connections are omitted.
Main entry points: SpatialCommandHub.tsx Spatial Command Hub · security-service.ts Security Service · bootstrap.ts Application Bootstrap · page.tsx Application Entry
Components 23
Analyst Workspaces
- Application Entry
app/page.tsx - Spatial Command Hub
app/spatial/hub/SpatialCommandHub.tsx - Command Center
app/spatial/command/CommandCenterWorkspace.tsx - Incident Investigation
app/spatial/investigation/InvestigationHub.tsx - Investigation Views
app/spatial/investigation - Threat Hunting
app/spatial/hunting/ThreatHuntingWorkspace.tsx - Case Management
app/spatial/cases/CaseWorkspace.tsx - Evidence Vault
app/spatial/evidence/EvidenceWorkspace.tsx - Detection Engineering
app/spatial/detection/DetectionEngineeringWorkspace.tsx - AI Assistant
app/spatial/ai/ContextualAiAssistant.tsx
Security Operations
- Security Service
app/core/security-service.ts - Event Model
app/core/models/event.ts - Incident Model
app/core/models/incident.ts - Detection Engine
app/core/security/detection-engine.ts - Hunt Engine
app/core/hunting/threat-hunt-engine.ts - Metrics Engine
app/core/metrics/metrics-engine.ts
Local Platform
- Application Bootstrap
app/core/bootstrap.ts - Local Provider
app/core/providers/local-provider.ts - IndexedDB Store
app/core/storage/idb-store.ts - Integration Sync
app/core/integration/sync-engine.ts
Response and Simulation
- Playbook Execution
app/core/response/playbook-execution-engine.ts - Cyber-Range Simulation
app/core/simulation/simulation-engine.ts
Other components
- SOC Analyst
Connections 24
- SOC Analyst → Application Entry: opens
README.md - Application Entry → Spatial Command Hub: renders
app/page.tsx - Application Entry → Application Bootstrap: initializes
app/page.tsx - Spatial Command Hub → Command Center: navigates to
README.md - Spatial Command Hub → Incident Investigation: navigates to
README.md - Spatial Command Hub → Threat Hunting: navigates to
README.md - Spatial Command Hub → Case Management: navigates to
README.md - Spatial Command Hub → Evidence Vault: navigates to
README.md - Spatial Command Hub → Detection Engineering: navigates to
README.md - Incident Investigation → Investigation Views: provides
README.md - Threat Hunting → Security Service: uses
app/spatial/hunting/ThreatHuntingWorkspace.tsx - Threat Hunting → AI Assistant: renders
app/spatial/hunting/ThreatHuntingWorkspace.tsx - Detection Engineering → Security Service: uses
app/spatial/detection/DetectionEngineeringWorkspace.tsx - AI Assistant → Security Service: uses
app/spatial/ai/ContextualAiAssistant.tsx - Security Service → Local Provider: delegates to
app/core/security-service.ts - Application Bootstrap → Security Service: initializes
app/core/bootstrap.ts - Application Bootstrap → Local Provider: configures
app/core/bootstrap.ts - Application Bootstrap → IndexedDB Store: configures
app/core/bootstrap.ts - Application Bootstrap → AI Assistant: configures AI
app/core/bootstrap.ts - Hunt Engine → Event Model: queries
app/core/hunting/threat-hunt-engine.ts - Detection Engine → Event Model: evaluates
app/core/security/detection-engine.ts - Cyber-Range Simulation → IndexedDB Store: reads and writes
app/core/simulation/simulation-engine.ts - Integration Sync → IndexedDB Store: reads and writes
app/core/integration/sync-engine.ts - Security Service → Incident Model: creates incidents
app/core/security-service.ts