# bhupesh-debug/cyber architecture

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

- Interactive diagram: https://gitdiagram.com/bhupesh-debug/cyber
- Repository: https://github.com/bhupesh-debug/cyber
- Video tour (about a minute): https://gitdiagram.com/bhupesh-debug/cyber/video

## Overview

This repository is an Obsidian-based cybersecurity knowledge vault with accompanying forensic and geospatial report-generation scripts. Its documented user workflow is to ingest source material into linked wiki notes, query and file analyses, and use specialized commands for threat modeling, CVEs, and lab debriefs. Separate scripts support malware-audit, geocoding, and consolidated dossier deliverables. The command behavior and vault capabilities are described in the README; sampled code excerpts do not establish a complete automated pipeline between them.

Main entry points: [`wiki`](https://github.com/bhupesh-debug/cyber/tree/main/wiki) (Knowledge Notes), [`COMMANDS.md`](https://github.com/bhupesh-debug/cyber/blob/main/COMMANDS.md) (Agent Commands), [`GPS_Address_Intelligence`](https://github.com/bhupesh-debug/cyber/tree/main/GPS_Address_Intelligence) (Geospatial Deliverables), [`build_all_reports.py`](https://github.com/bhupesh-debug/cyber/blob/main/build_all_reports.py) (Combined Report Builder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_knowledge["Knowledge Vault"]
  node_commands["Agent Commands<br/>[COMMANDS.md]"]
  node_raw["Source Documents"]
  node_wiki["Knowledge Notes"]
  node_index["Wiki Catalog<br/>[index.md]"]
  node_log["Audit Log<br/>[log.md]"]
end

subgraph group_analysis["Security Analysis"]
  node_attacks["Attack Notes"]
  node_defenses["Defense Notes"]
  node_vulns["Vulnerability Notes"]
  node_tools["Tool Dossiers"]
  node_frameworks["Security Frameworks"]
  node_architectures["Security Architectures"]
  node_writeups["Incident Writeups"]
  node_analyses["Filed Analyses"]
end

subgraph group_geo["Geospatial Intelligence"]
  node_geocoder["Address Verification<br/>[run_geocoding.py]"]
  node_intaglio["Geospatial PDF"]
  node_georesults["Geospatial Deliverables"]
end

subgraph group_reports["Report Generation"]
  node_auditgen["Audit Report Generator<br/>[generate_report.py]"]
  node_mastergen["Master Dossier Generator"]
  node_allreports["Combined Report Builder"]
  node_masterpdf["Master Dossier"]
  node_auditpdf["Cyber Audit Report"]
end

node_user(("Vault User"))

node_user -->|"runs commands"| node_commands
node_commands -->|"ingests sources"| node_raw
node_commands -->|"updates notes"| node_wiki
node_commands -->|"updates catalog"| node_index
node_commands -->|"updates log"| node_log
node_commands -->|"files answers"| node_analyses
node_wiki -->|"includes tradecraft"| node_attacks
node_wiki -->|"includes defenses"| node_defenses
node_wiki -->|"includes CVEs"| node_vulns
node_wiki -->|"includes dossiers"| node_tools
node_wiki -->|"includes frameworks"| node_frameworks
node_wiki -->|"includes designs"| node_architectures
node_wiki -->|"includes investigations"| node_writeups
node_geocoder -.->|"produces results"| node_georesults
node_intaglio -.->|"generates report"| node_georesults
node_auditgen -->|"generates report"| node_auditpdf
node_mastergen -->|"builds dossier"| node_masterpdf
node_allreports -->|"generates report"| node_auditpdf
node_allreports -.->|"generates report"| node_georesults

click node_commands "https://github.com/bhupesh-debug/cyber/blob/main/COMMANDS.md"
click node_raw "https://github.com/bhupesh-debug/cyber/tree/main/raw"
click node_wiki "https://github.com/bhupesh-debug/cyber/tree/main/wiki"
click node_index "https://github.com/bhupesh-debug/cyber/blob/main/wiki/index.md"
click node_log "https://github.com/bhupesh-debug/cyber/blob/main/wiki/log.md"
click node_attacks "https://github.com/bhupesh-debug/cyber/tree/main/wiki/attacks"
click node_defenses "https://github.com/bhupesh-debug/cyber/tree/main/wiki/defenses"
click node_vulns "https://github.com/bhupesh-debug/cyber/tree/main/wiki/vulnerabilities"
click node_tools "https://github.com/bhupesh-debug/cyber/tree/main/wiki/tools"
click node_frameworks "https://github.com/bhupesh-debug/cyber/tree/main/wiki/frameworks"
click node_architectures "https://github.com/bhupesh-debug/cyber/tree/main/wiki/architectures"
click node_writeups "https://github.com/bhupesh-debug/cyber/tree/main/wiki/writeups"
click node_analyses "https://github.com/bhupesh-debug/cyber/tree/main/wiki/analyses"
click node_geocoder "https://github.com/bhupesh-debug/cyber/blob/main/GPS_Address_Intelligence/run_geocoding.py"
click node_intaglio "https://github.com/bhupesh-debug/cyber/blob/main/GPS_Address_Intelligence/run_intaglio_pdf.py"
click node_georesults "https://github.com/bhupesh-debug/cyber/tree/main/GPS_Address_Intelligence"
click node_auditgen "https://github.com/bhupesh-debug/cyber/blob/main/Cybersecurity_Audit/generate_report.py"
click node_mastergen "https://github.com/bhupesh-debug/cyber/blob/main/Master_Executive_Report/build_master_dossier.py"
click node_allreports "https://github.com/bhupesh-debug/cyber/blob/main/build_all_reports.py"
click node_masterpdf "https://github.com/bhupesh-debug/cyber/tree/main/Master_Executive_Report"
click node_auditpdf "https://github.com/bhupesh-debug/cyber/tree/main/Cybersecurity_Audit/05_Final_PDF_Report"

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_commands,node_raw,node_wiki,node_index,node_log,node_user toneBlue
class node_attacks,node_defenses,node_vulns,node_tools,node_frameworks,node_architectures,node_writeups,node_analyses toneAmber
class node_geocoder,node_intaglio,node_georesults toneMint
class node_auditgen,node_mastergen,node_allreports,node_masterpdf,node_auditpdf toneRose
```

## Components

### Knowledge Vault

- [Agent Commands](https://github.com/bhupesh-debug/cyber/blob/main/COMMANDS.md): `COMMANDS.md`
- [Source Documents](https://github.com/bhupesh-debug/cyber/tree/main/raw): `raw`
- [Knowledge Notes](https://github.com/bhupesh-debug/cyber/tree/main/wiki): `wiki`
- [Wiki Catalog](https://github.com/bhupesh-debug/cyber/blob/main/wiki/index.md): `wiki/index.md`
- [Audit Log](https://github.com/bhupesh-debug/cyber/blob/main/wiki/log.md): `wiki/log.md`

### Security Analysis

- [Attack Notes](https://github.com/bhupesh-debug/cyber/tree/main/wiki/attacks): `wiki/attacks`
- [Defense Notes](https://github.com/bhupesh-debug/cyber/tree/main/wiki/defenses): `wiki/defenses`
- [Vulnerability Notes](https://github.com/bhupesh-debug/cyber/tree/main/wiki/vulnerabilities): `wiki/vulnerabilities`
- [Tool Dossiers](https://github.com/bhupesh-debug/cyber/tree/main/wiki/tools): `wiki/tools`
- [Security Frameworks](https://github.com/bhupesh-debug/cyber/tree/main/wiki/frameworks): `wiki/frameworks`
- [Security Architectures](https://github.com/bhupesh-debug/cyber/tree/main/wiki/architectures): `wiki/architectures`
- [Incident Writeups](https://github.com/bhupesh-debug/cyber/tree/main/wiki/writeups): `wiki/writeups`
- [Filed Analyses](https://github.com/bhupesh-debug/cyber/tree/main/wiki/analyses): `wiki/analyses`

### Geospatial Intelligence

- [Address Verification](https://github.com/bhupesh-debug/cyber/blob/main/GPS_Address_Intelligence/run_geocoding.py): `GPS_Address_Intelligence/run_geocoding.py`
- [Geospatial PDF](https://github.com/bhupesh-debug/cyber/blob/main/GPS_Address_Intelligence/run_intaglio_pdf.py): `GPS_Address_Intelligence/run_intaglio_pdf.py`
- [Geospatial Deliverables](https://github.com/bhupesh-debug/cyber/tree/main/GPS_Address_Intelligence): `GPS_Address_Intelligence`

### Report Generation

- [Audit Report Generator](https://github.com/bhupesh-debug/cyber/blob/main/Cybersecurity_Audit/generate_report.py): `Cybersecurity_Audit/generate_report.py`
- [Master Dossier Generator](https://github.com/bhupesh-debug/cyber/blob/main/Master_Executive_Report/build_master_dossier.py): `Master_Executive_Report/build_master_dossier.py`
- [Combined Report Builder](https://github.com/bhupesh-debug/cyber/blob/main/build_all_reports.py): `build_all_reports.py`
- [Master Dossier](https://github.com/bhupesh-debug/cyber/tree/main/Master_Executive_Report): `Master_Executive_Report`
- [Cyber Audit Report](https://github.com/bhupesh-debug/cyber/tree/main/Cybersecurity_Audit/05_Final_PDF_Report): `Cybersecurity_Audit/05_Final_PDF_Report`

### Other components

- **Vault User**

## Connections

- Vault User → Agent Commands: runs commands (evidence: `README.md`)
- Agent Commands → Source Documents: ingests sources (evidence: `README.md`)
- Agent Commands → Knowledge Notes: updates notes (evidence: `README.md`)
- Agent Commands → Wiki Catalog: updates catalog (evidence: `README.md`)
- Agent Commands → Audit Log: updates log (evidence: `README.md`)
- Agent Commands → Filed Analyses: files answers (evidence: `README.md`)
- Knowledge Notes → Attack Notes: includes tradecraft (evidence: `README.md`)
- Knowledge Notes → Defense Notes: includes defenses (evidence: `README.md`)
- Knowledge Notes → Vulnerability Notes: includes CVEs (evidence: `README.md`)
- Knowledge Notes → Tool Dossiers: includes dossiers (evidence: `README.md`)
- Knowledge Notes → Security Frameworks: includes frameworks (evidence: `README.md`)
- Knowledge Notes → Security Architectures: includes designs (evidence: `README.md`)
- Knowledge Notes → Incident Writeups: includes investigations (evidence: `README.md`)
- Address Verification → Geospatial Deliverables: produces results
- Geospatial PDF → Geospatial Deliverables: generates report
- Audit Report Generator → Cyber Audit Report: generates report (evidence: `Cybersecurity_Audit/generate_report.py`)
- Master Dossier Generator → Master Dossier: builds dossier (evidence: `Master_Executive_Report/build_master_dossier.py`)
- Combined Report Builder → Cyber Audit Report: generates report (evidence: `build_all_reports.py`)
- Combined Report Builder → Geospatial Deliverables: generates report