Skip to main content

System Architecture

Argus is a Vite/React frontend with a Node/Express+tRPC backend and a deterministic investigation engine.

High-level system flow

Frontend case UI → backend routers → investigation runner → extraction and research engines → evidence and verification layers → report generation → completed-case rendering.

Main layers​

  • Frontend: case UI, completed-case reports, Mission Control preview surfaces
  • Routers: analysis, cases, documents, notes, admin
  • Investigation engine: extraction, claim building, verification targets, Stage 3A, enhanced DD
  • Evidence and report layer: evidence ledger, projection plan, baseline answer coverage, quality checker
  • Artifacts and smokes: scripts and fixture-based validation

Important architectural distinction​

The canonical stored report is not identical to the enhanced presentation layer.

  • canonical report: persisted investigation snapshot
  • enhanced report: deterministic presentation artifact recomposed on read

That distinction matters whenever live output diverges from smoke output.