How aannapoorani/adaptive-forensic-safety works
JOCKY is a multi-machine digital-forensics platform with an adaptive investigation workflow, evidence-integrity services, and a React management console. The principal flow is: an operator creates an investigation, the backend plans and runs collection rounds, analyzes evidence, and exposes results, timelines, reports, and chain verification. The README also documents a JOCKY DSL/compiler, polymorphic builds, evasion analysis, and CDN routing. Those capabilities are included, but their internal wiring is not inferred where source excerpts do not show it.
Main entry points: investigation_service.py Investigation Runner · evasion.py Evasion Routes · investigations.py Investigation Routes · database.py Relational Store
Components 25
Management Console
- Console Router
frontend/src/App.tsx - Investigation View
frontend/src/pages/InvestigationDetailPage.tsx - API Client
frontend/src/services/api.ts
Investigation Workflow
- FastAPI Routes
backend/app/main.py - Investigation Routes
backend/app/api/investigations.py - Investigation Runner
backend/app/services/investigation_service.py - Investigation Records
backend/app/models/investigation.py
Collection And Analysis
- Intent Profiles
backend/app/intelligence/intent_engine.py - Evidence Graph
backend/app/intelligence/evidence_graph.py - Workflow Planner
backend/app/intelligence/workflow_planner.py - Collector Registry
backend/app/collectors/registry.py - Correlation Engine
backend/app/intelligence/correlation_engine.py - Remote Agent
backend/app/services/remote_agent.py - Machine Records
backend/app/models/machine.py - Driver Analysis
backend/app/collectors/drivers.py
Evidence Integrity
- Evidence Records
backend/app/models/evidence.py - Relational Store
backend/app/core/database.py - Chain Of Custody
backend/app/services/chain_service.py - Signing Keys
backend/app/core/key_manager.py - Evidence Verifier
backend/app/services/verifier_service.py
Evasion And DSL
- JOCKY Compiler
backend/app/jocky/compiler.py - Polymorphic Engine
backend/app/jocky/polymorphic.py - CDN Routing
backend/app/jocky/cdn_routing.py - Evasion Routes
backend/app/api/evasion.py
Other components
- Operator
Connections 26
- Operator → Console Router: uses
- Console Router → Investigation View: renders
frontend/src/App.tsx - Investigation View → API Client: requests data
frontend/src/pages/InvestigationDetailPage.tsx - API Client → Investigation Routes: calls endpoints
frontend/src/services/api.ts - FastAPI Routes → Investigation Routes: registers routes
backend/app/main.py - Investigation Routes → Investigation Runner: delegates
backend/app/api/investigations.py - Investigation Runner → Intent Profiles: resolves intent
backend/app/services/investigation_service.py - Investigation Runner → Evidence Graph: builds graph
backend/app/services/investigation_service.py - Investigation Runner → Workflow Planner: plans steps
backend/app/services/investigation_service.py - Investigation Runner → Collector Registry: dispatches operations
backend/app/services/investigation_service.py - Investigation Runner → Correlation Engine: correlates evidence
backend/app/services/investigation_service.py - Investigation Runner → JOCKY Compiler: compiles scripts
backend/app/services/investigation_service.py - Investigation Runner → Investigation Records: persists rounds
backend/app/services/investigation_service.py - Investigation Runner → Remote Agent: dispatches remotely
- Remote Agent → Machine Records: manages machines
- Investigation Routes → Evasion Routes: exposes evasion APIs
- Evasion Routes → Polymorphic Engine: builds variants
backend/app/api/evasion.py - Evasion Routes → Driver Analysis: runs driver probes
backend/app/api/evasion.py - Evasion Routes → CDN Routing: configures routing
backend/app/api/evasion.py - Investigation Runner → Chain Of Custody: records custody
backend/app/services/investigation_service.py - Chain Of Custody → Evidence Records: stores provenance
backend/app/services/chain_service.py - Chain Of Custody → Signing Keys: signs chain tip
backend/app/services/chain_service.py - Evidence Verifier → Evidence Records: verifies artifacts
backend/app/services/verifier_service.py - Investigation Runner → Relational Store: reads and writes
backend/app/services/investigation_service.py - Relational Store → Investigation Records: stores records
backend/app/core/database.py - Relational Store → Evidence Records: stores records
backend/app/core/database.py