# klaif00/crashtrace architecture

> Architecture diagram of the GitHub repository klaif00/crashtrace, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/klaif00/crashtrace
- Repository: https://github.com/klaif00/crashtrace

## Overview

CrashTrace is a Windows GUI debugger and offline static-analysis tool. The main workflow is a user selecting a target, the app launching and observing it, collecting diagnostic evidence, and presenting a report. Separate static-analysis branches provide DLL Scan and the explicitly incomplete Can I Run It? feature. The graph uses README claims and the supplied source excerpts/index; unsampled implementation details and some runtime wiring are not asserted.

Main entry points: [`TestApp/TestApp/MainForm.cs`](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/MainForm.cs) (Main window), [`TestApp/TestApp/ReadinessAnalyzer.cs`](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/ReadinessAnalyzer.cs) (Readiness analysis), [`TestApp/TestApp/DisassemblyHelper.cs`](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/DisassemblyHelper.cs) (Disassembly helper), [`TestApp/TestApp/ManagedExceptionReader.cs`](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/ManagedExceptionReader.cs) (Managed exceptions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application UI"]
  node_program["App startup<br/>[Program.cs]"]
  node_main["Main window<br/>[MainForm.cs]"]
  node_about["About dialog<br/>[AboutForm.cs]"]
end

subgraph group_debug["Debug session"]
  node_capture["Debug capture<br/>[MainForm.cs]"]
  node_memory["Memory inspection<br/>[MemoryInspector.cs]"]
  node_disassembly["Disassembly"]
  node_disassemblyhelper["Disassembly helper"]
  node_managed["Managed exceptions"]
  node_minidump["Minidump capture<br/>[MiniDumpWriter.cs]"]
end

subgraph group_analysis["Diagnostic analysis"]
  node_reportdata["Report data<br/>[CrashReportData.cs]"]
  node_patterns["Crash patterns"]
  node_recommend["Recommendations"]
end

subgraph group_static["Static tools"]
  node_dllform["DLL Scan UI<br/>[DllScanForm.cs]"]
  node_dllscan["DLL scanner<br/>[DllScanner.cs]"]
  node_readinessui["Can I Run It UI<br/>[Can I Run It.cs]"]
  node_readiness["Readiness analysis"]
  node_strings["String extraction<br/>[StringExtractor.cs]"]
  node_entropy["Entropy analysis<br/>[EntropyAnalyzer.cs]"]
  node_manifest["Manifest analysis<br/>[ManifestReader.cs]"]
end

subgraph group_helpers["Managed helpers"]
  node_helper32["32-bit helper<br/>[Program.cs]"]
  node_reader32["32-bit exception reader"]
  node_helper64["64-bit helper<br/>[Program.cs]"]
  node_reader64["64-bit exception reader"]
end

node_user(("User"))
node_target["Target program"]
node_debugapi["Windows debug API"]

node_user -->|"launches"| node_program
node_program -->|"opens"| node_main
node_user -->|"selects target"| node_main
node_main -->|"debugs"| node_target
node_main -->|"uses"| node_debugapi
node_main -->|"runs session"| node_capture
node_capture -->|"observes"| node_target
node_capture -->|"receives events"| node_debugapi
node_main -->|"inspects memory"| node_memory
node_main -->|"disassembles"| node_disassembly
node_main -->|"uses"| node_disassemblyhelper
node_disassemblyhelper -->|"reads"| node_memory
node_disassemblyhelper -->|"uses"| node_disassembly
node_main -->|"reads exceptions"| node_managed
node_main -.->|"writes dump"| node_minidump
node_main -->|"builds"| node_reportdata
node_patterns -->|"analyzes"| node_reportdata
node_recommend -->|"uses"| node_reportdata
node_main -.->|"analyzes"| node_patterns
node_main -.->|"generates advice"| node_recommend
node_main -->|"opens"| node_about
node_main -->|"opens"| node_dllform
node_dllform -->|"scans file"| node_dllscan
node_main -->|"opens"| node_readinessui
node_readinessui -->|"analyzes file"| node_readiness
node_readiness -->|"extracts strings"| node_strings
node_readiness -->|"analyzes entropy"| node_entropy
node_readiness -->|"reads manifest"| node_manifest
node_managed -.->|"dispatches by architecture"| node_helper32
node_managed -.->|"dispatches by architecture"| node_helper64
node_helper32 -.->|"runs"| node_reader32
node_helper64 -.->|"runs"| node_reader64

click node_program "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/Program.cs"
click node_main "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/MainForm.cs"
click node_about "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/AboutForm.cs"
click node_capture "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/MainForm.cs"
click node_memory "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/MemoryInspector.cs"
click node_disassembly "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/BasicDisassembler.cs"
click node_disassemblyhelper "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/DisassemblyHelper.cs"
click node_managed "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/ManagedExceptionReader.cs"
click node_minidump "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/MiniDumpWriter.cs"
click node_reportdata "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/CrashReportData.cs"
click node_patterns "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/CrashPatternAnalyzer.cs"
click node_recommend "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/RecommendationEngine.cs"
click node_dllform "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/DllScanForm.cs"
click node_dllscan "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/DllScanner.cs"
click node_readinessui "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/Can%20I%20Run%20It.cs"
click node_readiness "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/ReadinessAnalyzer.cs"
click node_strings "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/StringExtractor.cs"
click node_entropy "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/EntropyAnalyzer.cs"
click node_manifest "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/ManifestReader.cs"
click node_helper32 "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestAppHelper32/Program.cs"
click node_reader32 "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestAppHelper32/HelperExceptionReader.cs"
click node_helper64 "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestAppHelper64/Program.cs"
click node_reader64 "https://github.com/klaif00/crashtrace/blob/main/TestApp/TestAppHelper64/HelperExceptionReader.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_program,node_main,node_about,node_user toneBlue
class node_capture,node_memory,node_disassembly,node_disassemblyhelper,node_managed,node_minidump toneAmber
class node_reportdata,node_patterns,node_recommend,node_debugapi toneMint
class node_dllform,node_dllscan,node_readinessui,node_readiness,node_strings,node_entropy,node_manifest toneRose
class node_helper32,node_reader32,node_helper64,node_reader64,node_target toneIndigo
```

## Components

### Application UI

- [App startup](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/Program.cs): `TestApp/TestApp/Program.cs`
- [Main window](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/MainForm.cs): `TestApp/TestApp/MainForm.cs`
- [About dialog](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/AboutForm.cs): `TestApp/TestApp/AboutForm.cs`

### Debug session

- [Debug capture](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/MainForm.cs): `TestApp/TestApp/MainForm.cs`
- [Memory inspection](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/MemoryInspector.cs): `TestApp/TestApp/MemoryInspector.cs`
- [Disassembly](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/BasicDisassembler.cs): `TestApp/TestApp/BasicDisassembler.cs`
- [Disassembly helper](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/DisassemblyHelper.cs): `TestApp/TestApp/DisassemblyHelper.cs`
- [Managed exceptions](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/ManagedExceptionReader.cs): `TestApp/TestApp/ManagedExceptionReader.cs`
- [Minidump capture](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/MiniDumpWriter.cs): `TestApp/TestApp/MiniDumpWriter.cs`

### Diagnostic analysis

- [Report data](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/CrashReportData.cs): `TestApp/TestApp/CrashReportData.cs`
- [Crash patterns](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/CrashPatternAnalyzer.cs): `TestApp/TestApp/CrashPatternAnalyzer.cs`
- [Recommendations](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/RecommendationEngine.cs): `TestApp/TestApp/RecommendationEngine.cs`

### Static tools

- [DLL Scan UI](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/DllScanForm.cs): `TestApp/TestApp/DllScanForm.cs`
- [DLL scanner](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/DllScanner.cs): `TestApp/TestApp/DllScanner.cs`
- [Can I Run It UI](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/Can%20I%20Run%20It.cs): `TestApp/TestApp/Can I Run It.cs`
- [Readiness analysis](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/ReadinessAnalyzer.cs): `TestApp/TestApp/ReadinessAnalyzer.cs`
- [String extraction](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/StringExtractor.cs): `TestApp/TestApp/StringExtractor.cs`
- [Entropy analysis](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/EntropyAnalyzer.cs): `TestApp/TestApp/EntropyAnalyzer.cs`
- [Manifest analysis](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestApp/ManifestReader.cs): `TestApp/TestApp/ManifestReader.cs`

### Managed helpers

- [32-bit helper](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestAppHelper32/Program.cs): `TestApp/TestAppHelper32/Program.cs`
- [32-bit exception reader](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestAppHelper32/HelperExceptionReader.cs): `TestApp/TestAppHelper32/HelperExceptionReader.cs`
- [64-bit helper](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestAppHelper64/Program.cs): `TestApp/TestAppHelper64/Program.cs`
- [64-bit exception reader](https://github.com/klaif00/crashtrace/blob/main/TestApp/TestAppHelper64/HelperExceptionReader.cs): `TestApp/TestAppHelper64/HelperExceptionReader.cs`

### Other components

- **User**
- **Target program**
- **Windows debug API**

## Connections

- User → App startup: launches (evidence: `TestApp/TestApp/Program.cs`)
- App startup → Main window: opens (evidence: `TestApp/TestApp/Program.cs`)
- User → Main window: selects target (evidence: `README`)
- Main window → Target program: debugs (evidence: `README`)
- Main window → Windows debug API: uses (evidence: `README`)
- Main window → Debug capture: runs session (evidence: `TestApp/TestApp/MainForm.cs`)
- Debug capture → Target program: observes (evidence: `README`)
- Debug capture → Windows debug API: receives events (evidence: `README`)
- Main window → Memory inspection: inspects memory (evidence: `TestApp/TestApp/MainForm.cs`)
- Main window → Disassembly: disassembles (evidence: `TestApp/TestApp/MainForm.cs`)
- Main window → Disassembly helper: uses (evidence: `TestApp/TestApp/MainForm.cs`)
- Disassembly helper → Memory inspection: reads (evidence: `TestApp/TestApp/DisassemblyHelper.cs`)
- Disassembly helper → Disassembly: uses (evidence: `TestApp/TestApp/DisassemblyHelper.cs`)
- Main window → Managed exceptions: reads exceptions (evidence: `TestApp/TestApp/MainForm.cs`)
- Main window → Minidump capture: writes dump (evidence: `TestApp/TestApp/MainForm.cs`)
- Main window → Report data: builds (evidence: `TestApp/TestApp/MainForm.cs`)
- Crash patterns → Report data: analyzes (evidence: `TestApp/TestApp/CrashPatternAnalyzer.cs`)
- Recommendations → Report data: uses (evidence: `TestApp/TestApp/RecommendationEngine.cs`)
- Main window → Crash patterns: analyzes (evidence: `TestApp/TestApp/MainForm.cs`)
- Main window → Recommendations: generates advice (evidence: `TestApp/TestApp/MainForm.cs`)
- Main window → About dialog: opens (evidence: `TestApp/TestApp/MainForm.cs`)
- Main window → DLL Scan UI: opens (evidence: `TestApp/TestApp/MainForm.cs`)
- DLL Scan UI → DLL scanner: scans file (evidence: `TestApp/TestApp/DllScanForm.cs`)
- Main window → Can I Run It UI: opens (evidence: `TestApp/TestApp/MainForm.cs`)
- Can I Run It UI → Readiness analysis: analyzes file (evidence: `TestApp/TestApp/Can I Run It.cs`)
- Readiness analysis → String extraction: extracts strings (evidence: `TestApp/TestApp/ReadinessAnalyzer.cs`)
- Readiness analysis → Entropy analysis: analyzes entropy (evidence: `TestApp/TestApp/ReadinessAnalyzer.cs`)
- Readiness analysis → Manifest analysis: reads manifest (evidence: `TestApp/TestApp/ReadinessAnalyzer.cs`)
- Managed exceptions → 32-bit helper: dispatches by architecture
- Managed exceptions → 64-bit helper: dispatches by architecture
- 32-bit helper → 32-bit exception reader: runs
- 64-bit helper → 64-bit exception reader: runs
