# 0xsilversurfer/bmodetector architecture

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

- Interactive diagram: https://gitdiagram.com/0xsilversurfer/bmodetector
- Repository: https://github.com/0xsilversurfer/bmodetector

## Overview

BMODetector is an authorized-use scanner for REST, web-based AI, and RAG APIs. Its workflow profiles the target, sends OWASP LLM probes (including repeats), analyzes responses with deterministic rules, optionally adds AI opinions and network reconnaissance, then calculates a gap analysis and emits DevSecOps reports. The main orchestration and analysis modules are excerpted; some report formats, authentication options, and browser discovery are documented but not fully sampled, so those relationships rely on README evidence.

Main entry points: [`bmo_detector.py`](https://github.com/0xsilversurfer/bmodetector/blob/main/bmo_detector.py) (CLI audit runner), [`judge.py`](https://github.com/0xsilversurfer/bmodetector/blob/main/judge.py) (Target profiling), [`scoring.py`](https://github.com/0xsilversurfer/bmodetector/blob/main/scoring.py) (Risk and gap scoring), [`reporter.py`](https://github.com/0xsilversurfer/bmodetector/blob/main/reporter.py) (Audit report formats)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scan["Scan workflow"]
  node_cli["CLI audit runner<br/>[bmo_detector.py]"]
  node_catalog["OWASP probe catalog<br/>[test_cases.yaml]"]
  node_profiling["Target profiling<br/>[judge.py]"]
  node_probe_generation["Probe generation<br/>[judge.py]"]
end

subgraph group_analysis["Analysis and scoring"]
  node_response_analysis["Deterministic verdicts<br/>[judge.py]"]
  node_ai_judges["Optional AI judges"]
  node_recon["HTTP reconnaissance<br/>[judge.py]"]
  node_scoring["Risk and gap scoring<br/>[scoring.py]"]
  node_benchmark["Benchmark metrics<br/>[scoring.py]"]
end

subgraph group_outputs["Reports and remediation"]
  node_remediation["Guardrail generation<br/>[reporter.py]"]
  node_report_formats["Audit report formats<br/>[reporter.py]"]
  node_report_store[("Reports and history")]
end

subgraph group_lab["Training target"]
  node_lab_api["Mock training API<br/>[mock_api.py]"]
end

node_operator(("Authorized operator"))
node_target_api["Target AI API"]

node_operator -->|"starts audit"| node_cli
node_cli -->|"loads probes"| node_catalog
node_cli -->|"profiles target"| node_profiling
node_profiling -->|"sends questions"| node_target_api
node_cli -->|"generates probes"| node_probe_generation
node_probe_generation -.->|"requests variants"| node_ai_judges
node_cli -->|"sends probes"| node_target_api
node_target_api -->|"returns responses"| node_cli
node_cli -->|"analyzes responses"| node_response_analysis
node_response_analysis -.->|"requests opinion"| node_ai_judges
node_cli -->|"runs optional recon"| node_recon
node_recon -->|"checks endpoint"| node_target_api
node_cli -->|"aggregates results"| node_scoring
node_scoring -->|"computes percentiles"| node_benchmark
node_cli -->|"generates guardrails"| node_remediation
node_cli -->|"creates deliverables"| node_report_formats
node_report_formats -.->|"writes reports"| node_report_store
node_cli -.->|"can launch locally"| node_lab_api

click node_cli "https://github.com/0xsilversurfer/bmodetector/blob/main/bmo_detector.py"
click node_catalog "https://github.com/0xsilversurfer/bmodetector/blob/main/payloads/test_cases.yaml"
click node_profiling "https://github.com/0xsilversurfer/bmodetector/blob/main/judge.py"
click node_probe_generation "https://github.com/0xsilversurfer/bmodetector/blob/main/judge.py"
click node_response_analysis "https://github.com/0xsilversurfer/bmodetector/blob/main/judge.py"
click node_recon "https://github.com/0xsilversurfer/bmodetector/blob/main/judge.py"
click node_scoring "https://github.com/0xsilversurfer/bmodetector/blob/main/scoring.py"
click node_benchmark "https://github.com/0xsilversurfer/bmodetector/blob/main/scoring.py"
click node_remediation "https://github.com/0xsilversurfer/bmodetector/blob/main/reporter.py"
click node_report_formats "https://github.com/0xsilversurfer/bmodetector/blob/main/reporter.py"
click node_report_store "https://github.com/0xsilversurfer/bmodetector/tree/main/reports"
click node_lab_api "https://github.com/0xsilversurfer/bmodetector/blob/main/target_lab/mock_api.py"

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_cli,node_catalog,node_profiling,node_probe_generation toneBlue
class node_response_analysis,node_ai_judges,node_recon,node_scoring,node_benchmark toneAmber
class node_remediation,node_report_formats,node_report_store,node_target_api toneMint
class node_lab_api toneRose
class node_operator toneIndigo
```

## Components

### Scan workflow

- [CLI audit runner](https://github.com/0xsilversurfer/bmodetector/blob/main/bmo_detector.py): `bmo_detector.py`
- [OWASP probe catalog](https://github.com/0xsilversurfer/bmodetector/blob/main/payloads/test_cases.yaml): `payloads/test_cases.yaml`
- [Target profiling](https://github.com/0xsilversurfer/bmodetector/blob/main/judge.py): `judge.py`
- [Probe generation](https://github.com/0xsilversurfer/bmodetector/blob/main/judge.py): `judge.py`

### Analysis and scoring

- [Deterministic verdicts](https://github.com/0xsilversurfer/bmodetector/blob/main/judge.py): `judge.py`
- **Optional AI judges**
- [HTTP reconnaissance](https://github.com/0xsilversurfer/bmodetector/blob/main/judge.py): `judge.py`
- [Risk and gap scoring](https://github.com/0xsilversurfer/bmodetector/blob/main/scoring.py): `scoring.py`
- [Benchmark metrics](https://github.com/0xsilversurfer/bmodetector/blob/main/scoring.py): `scoring.py`

### Reports and remediation

- [Guardrail generation](https://github.com/0xsilversurfer/bmodetector/blob/main/reporter.py): `reporter.py`
- [Audit report formats](https://github.com/0xsilversurfer/bmodetector/blob/main/reporter.py): `reporter.py`
- [Reports and history](https://github.com/0xsilversurfer/bmodetector/tree/main/reports): `reports`

### Training target

- [Mock training API](https://github.com/0xsilversurfer/bmodetector/blob/main/target_lab/mock_api.py): `target_lab/mock_api.py`

### Other components

- **Authorized operator**
- **Target AI API**

## Connections

- Authorized operator → CLI audit runner: starts audit (evidence: `README.md`)
- CLI audit runner → OWASP probe catalog: loads probes (evidence: `bmo_detector.py`)
- CLI audit runner → Target profiling: profiles target (evidence: `bmo_detector.py`)
- Target profiling → Target AI API: sends questions (evidence: `judge.py`)
- CLI audit runner → Probe generation: generates probes (evidence: `bmo_detector.py`)
- Probe generation → Optional AI judges: requests variants (evidence: `judge.py`)
- CLI audit runner → Target AI API: sends probes (evidence: `bmo_detector.py`)
- Target AI API → CLI audit runner: returns responses (evidence: `bmo_detector.py`)
- CLI audit runner → Deterministic verdicts: analyzes responses (evidence: `bmo_detector.py`)
- Deterministic verdicts → Optional AI judges: requests opinion (evidence: `README.md`)
- CLI audit runner → HTTP reconnaissance: runs optional recon (evidence: `README.md`)
- HTTP reconnaissance → Target AI API: checks endpoint (evidence: `judge.py`)
- CLI audit runner → Risk and gap scoring: aggregates results (evidence: `bmo_detector.py`)
- Risk and gap scoring → Benchmark metrics: computes percentiles (evidence: `scoring.py`)
- CLI audit runner → Guardrail generation: generates guardrails (evidence: `README.md`)
- CLI audit runner → Audit report formats: creates deliverables (evidence: `README.md`)
- Audit report formats → Reports and history: writes reports (evidence: `README.md`)
- CLI audit runner → Mock training API: can launch locally (evidence: `README.md`)
