# summved/log-generator architecture

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

- Interactive diagram: https://gitdiagram.com/summved/log-generator
- Repository: https://github.com/summved/log-generator

## Overview

SIEM Log Generator is a local TypeScript CLI for producing synthetic security logs and delivering them to configured outputs, with replay, attack-chain simulation, threat-framework coverage, ML analysis, and monitoring. The main workflow is CLI/configuration → generation (optionally across workers) → filtering and output/history; separate commands drive replay and analysis. Source excerpts and the SOURCE INDEX support several internal calls; README statements support documented capabilities whose implementation was not sampled, so those links are cited to the README.

Main entry points: [`src/cli.ts`](https://github.com/summved/log-generator/blob/main/src/cli.ts) (CLI commands), [`src/LogGeneratorManager.ts`](https://github.com/summved/log-generator/blob/main/src/LogGeneratorManager.ts) (Generation manager), [`src/utils/outputManager.ts`](https://github.com/summved/log-generator/blob/main/src/utils/outputManager.ts) (Output manager), [`src/generators/BaseGenerator.ts`](https://github.com/summved/log-generator/blob/main/src/generators/BaseGenerator.ts) (Source generators)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Generation runtime"]
  node_manager["Generation manager"]
  node_factory["Generator factory"]
  node_generators["Source generators<br/>[BaseGenerator.ts]"]
  node_socgen["Security operations generator"]
  node_template["Template rendering<br/>[templateEngine.ts]"]
  node_workers["Worker generation"]
  node_backpressure["Flow control<br/>[backpressure.ts]"]
end

subgraph group_delivery["Output and replay"]
  node_output["Output manager<br/>[outputManager.ts]"]
  node_formatters["Log formatters<br/>[formatters.ts]"]
  node_storage[("Log history<br/>[storage.ts]")]
  node_replay["Log replay<br/>[ReplayManager.ts]"]
  node_logfiles["Historical log files<br/>[logFiles.ts]"]
end

subgraph group_security["Threat simulation"]
  node_mitrefilter["MITRE filtering<br/>[mitreFilter.ts]"]
  node_mitremap["MITRE mapping<br/>[mitreMapper.ts]"]
  node_chainmanager["Chain manager"]
  node_chainengine["Chain execution"]
  node_stepfactory["Step log factory<br/>[StepLogFactory.ts]"]
  node_chaintypes["Chain definitions<br/>[attackChain.ts]"]
  node_d3fend["D3FEND mapping<br/>[d3fendMapper.ts]"]
end

subgraph group_analysis["Analysis and monitoring"]
  node_mlprofile["Behavioral profiling<br/>[logProfile.ts]"]
  node_mlvolume["Volume analysis<br/>[volumeAnalysis.ts]"]
  node_mloutliers["Anomaly detection<br/>[logOutliers.ts]"]
  node_indicators["IOC analysis<br/>[indicators.ts]"]
  node_classifier["Text classification"]
  node_metrics["Prometheus metrics"]
  node_httpserver["Health endpoints<br/>[httpServer.ts]"]
  node_logger["Application logging<br/>[logger.ts]"]
end

subgraph group_setup["CLI and configuration"]
  node_cli["CLI commands<br/>[cli.ts]"]
  node_config["Config manager<br/>[index.ts]"]
  node_validator["Config validator<br/>[configValidator.ts]"]
end

node_user(("Operator"))
node_siem["Configured SIEM"]

node_user -->|"runs commands"| node_cli
node_cli -->|"starts generation"| node_manager
node_cli -->|"loads configuration"| node_config
node_manager -->|"reads settings"| node_config
node_manager -->|"validates configuration"| node_validator
node_manager -->|"creates generators"| node_factory
node_factory -->|"instantiates sources"| node_generators
node_manager -->|"creates SOC generator"| node_socgen
node_generators -->|"renders templates"| node_template
node_generators -->|"maps techniques"| node_mitremap
node_manager -->|"filters generated logs"| node_mitrefilter
node_manager -->|"dispatches generation"| node_workers
node_workers -->|"applies flow control"| node_backpressure
node_manager -->|"hands off logs"| node_output
node_output -->|"formats logs"| node_formatters
node_output -->|"stores history"| node_storage
node_output -->|"sends configured output"| node_siem
node_cli -->|"runs chain commands"| node_chainmanager
node_chainmanager -->|"executes chain"| node_chainengine
node_chainengine -->|"creates step logs"| node_stepfactory
node_chainmanager -->|"loads chain model"| node_chaintypes
node_cli -->|"reports coverage"| node_d3fend
node_cli -->|"runs replay"| node_replay
node_replay -->|"reads history"| node_storage
node_cli -->|"analyzes historical files"| node_logfiles
node_cli -->|"learns profiles"| node_mlprofile
node_mlprofile -->|"reads log files"| node_logfiles
node_cli -->|"forecasts volume"| node_mlvolume
node_mlvolume -->|"reads log files"| node_logfiles
node_cli -->|"detects anomalies"| node_mloutliers
node_cli -->|"extracts indicators"| node_indicators
node_cli -->|"classifies text"| node_classifier
node_manager -->|"records metrics"| node_metrics
node_manager -->|"starts monitoring"| node_httpserver
node_manager -->|"logs runtime events"| node_logger
node_siem -.->|"receives generated logs"| node_user

click node_cli "https://github.com/summved/log-generator/blob/main/src/cli.ts"
click node_config "https://github.com/summved/log-generator/blob/main/src/config/index.ts"
click node_validator "https://github.com/summved/log-generator/blob/main/src/utils/configValidator.ts"
click node_manager "https://github.com/summved/log-generator/blob/main/src/LogGeneratorManager.ts"
click node_factory "https://github.com/summved/log-generator/blob/main/src/generators/createGenerators.ts"
click node_generators "https://github.com/summved/log-generator/blob/main/src/generators/BaseGenerator.ts"
click node_socgen "https://github.com/summved/log-generator/blob/main/src/generators/SecurityOperationsGenerator.ts"
click node_template "https://github.com/summved/log-generator/blob/main/src/utils/templateEngine.ts"
click node_workers "https://github.com/summved/log-generator/blob/main/src/workers/GenerationWorkers.ts"
click node_backpressure "https://github.com/summved/log-generator/blob/main/src/workers/backpressure.ts"
click node_mitrefilter "https://github.com/summved/log-generator/blob/main/src/utils/mitreFilter.ts"
click node_mitremap "https://github.com/summved/log-generator/blob/main/src/utils/mitreMapper.ts"
click node_chainmanager "https://github.com/summved/log-generator/blob/main/src/chains/AttackChainManager.ts"
click node_chainengine "https://github.com/summved/log-generator/blob/main/src/chains/AttackChainEngine.ts"
click node_stepfactory "https://github.com/summved/log-generator/blob/main/src/chains/StepLogFactory.ts"
click node_chaintypes "https://github.com/summved/log-generator/blob/main/src/types/attackChain.ts"
click node_d3fend "https://github.com/summved/log-generator/blob/main/src/utils/d3fendMapper.ts"
click node_output "https://github.com/summved/log-generator/blob/main/src/utils/outputManager.ts"
click node_formatters "https://github.com/summved/log-generator/blob/main/src/utils/formatters.ts"
click node_storage "https://github.com/summved/log-generator/blob/main/src/utils/storage.ts"
click node_replay "https://github.com/summved/log-generator/blob/main/src/replay/ReplayManager.ts"
click node_logfiles "https://github.com/summved/log-generator/blob/main/src/utils/logFiles.ts"
click node_mlprofile "https://github.com/summved/log-generator/blob/main/src/ml/logProfile.ts"
click node_mlvolume "https://github.com/summved/log-generator/blob/main/src/ml/volumeAnalysis.ts"
click node_mloutliers "https://github.com/summved/log-generator/blob/main/src/ml/logOutliers.ts"
click node_indicators "https://github.com/summved/log-generator/blob/main/src/ml/indicators.ts"
click node_classifier "https://github.com/summved/log-generator/blob/main/src/ml/logTextClassifier.ts"
click node_metrics "https://github.com/summved/log-generator/blob/main/src/utils/metricsCollector.ts"
click node_httpserver "https://github.com/summved/log-generator/blob/main/src/utils/httpServer.ts"
click node_logger "https://github.com/summved/log-generator/blob/main/src/utils/logger.ts"

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_manager,node_factory,node_generators,node_socgen,node_template,node_workers,node_backpressure toneBlue
class node_output,node_formatters,node_storage,node_replay,node_logfiles toneAmber
class node_mitrefilter,node_mitremap,node_chainmanager,node_chainengine,node_stepfactory,node_chaintypes,node_d3fend toneMint
class node_mlprofile,node_mlvolume,node_mloutliers,node_indicators,node_classifier,node_metrics,node_httpserver,node_logger toneRose
class node_cli,node_config,node_validator,node_user,node_siem toneIndigo
```

## Components

### Generation runtime

- [Generation manager](https://github.com/summved/log-generator/blob/main/src/LogGeneratorManager.ts): `src/LogGeneratorManager.ts`
- [Generator factory](https://github.com/summved/log-generator/blob/main/src/generators/createGenerators.ts): `src/generators/createGenerators.ts`
- [Source generators](https://github.com/summved/log-generator/blob/main/src/generators/BaseGenerator.ts): `src/generators/BaseGenerator.ts`
- [Security operations generator](https://github.com/summved/log-generator/blob/main/src/generators/SecurityOperationsGenerator.ts): `src/generators/SecurityOperationsGenerator.ts`
- [Template rendering](https://github.com/summved/log-generator/blob/main/src/utils/templateEngine.ts): `src/utils/templateEngine.ts`
- [Worker generation](https://github.com/summved/log-generator/blob/main/src/workers/GenerationWorkers.ts): `src/workers/GenerationWorkers.ts`
- [Flow control](https://github.com/summved/log-generator/blob/main/src/workers/backpressure.ts): `src/workers/backpressure.ts`

### Output and replay

- [Output manager](https://github.com/summved/log-generator/blob/main/src/utils/outputManager.ts): `src/utils/outputManager.ts`
- [Log formatters](https://github.com/summved/log-generator/blob/main/src/utils/formatters.ts): `src/utils/formatters.ts`
- [Log history](https://github.com/summved/log-generator/blob/main/src/utils/storage.ts): `src/utils/storage.ts`
- [Log replay](https://github.com/summved/log-generator/blob/main/src/replay/ReplayManager.ts): `src/replay/ReplayManager.ts`
- [Historical log files](https://github.com/summved/log-generator/blob/main/src/utils/logFiles.ts): `src/utils/logFiles.ts`

### Threat simulation

- [MITRE filtering](https://github.com/summved/log-generator/blob/main/src/utils/mitreFilter.ts): `src/utils/mitreFilter.ts`
- [MITRE mapping](https://github.com/summved/log-generator/blob/main/src/utils/mitreMapper.ts): `src/utils/mitreMapper.ts`
- [Chain manager](https://github.com/summved/log-generator/blob/main/src/chains/AttackChainManager.ts): `src/chains/AttackChainManager.ts`
- [Chain execution](https://github.com/summved/log-generator/blob/main/src/chains/AttackChainEngine.ts): `src/chains/AttackChainEngine.ts`
- [Step log factory](https://github.com/summved/log-generator/blob/main/src/chains/StepLogFactory.ts): `src/chains/StepLogFactory.ts`
- [Chain definitions](https://github.com/summved/log-generator/blob/main/src/types/attackChain.ts): `src/types/attackChain.ts`
- [D3FEND mapping](https://github.com/summved/log-generator/blob/main/src/utils/d3fendMapper.ts): `src/utils/d3fendMapper.ts`

### Analysis and monitoring

- [Behavioral profiling](https://github.com/summved/log-generator/blob/main/src/ml/logProfile.ts): `src/ml/logProfile.ts`
- [Volume analysis](https://github.com/summved/log-generator/blob/main/src/ml/volumeAnalysis.ts): `src/ml/volumeAnalysis.ts`
- [Anomaly detection](https://github.com/summved/log-generator/blob/main/src/ml/logOutliers.ts): `src/ml/logOutliers.ts`
- [IOC analysis](https://github.com/summved/log-generator/blob/main/src/ml/indicators.ts): `src/ml/indicators.ts`
- [Text classification](https://github.com/summved/log-generator/blob/main/src/ml/logTextClassifier.ts): `src/ml/logTextClassifier.ts`
- [Prometheus metrics](https://github.com/summved/log-generator/blob/main/src/utils/metricsCollector.ts): `src/utils/metricsCollector.ts`
- [Health endpoints](https://github.com/summved/log-generator/blob/main/src/utils/httpServer.ts): `src/utils/httpServer.ts`
- [Application logging](https://github.com/summved/log-generator/blob/main/src/utils/logger.ts): `src/utils/logger.ts`

### CLI and configuration

- [CLI commands](https://github.com/summved/log-generator/blob/main/src/cli.ts): `src/cli.ts`
- [Config manager](https://github.com/summved/log-generator/blob/main/src/config/index.ts): `src/config/index.ts`
- [Config validator](https://github.com/summved/log-generator/blob/main/src/utils/configValidator.ts): `src/utils/configValidator.ts`

### Other components

- **Operator**
- **Configured SIEM**

## Connections

- Operator → CLI commands: runs commands (evidence: `README.md`)
- CLI commands → Generation manager: starts generation (evidence: `src/cli.ts`)
- CLI commands → Config manager: loads configuration (evidence: `src/cli.ts`)
- Generation manager → Config manager: reads settings (evidence: `src/LogGeneratorManager.ts`)
- Generation manager → Config validator: validates configuration (evidence: `src/LogGeneratorManager.ts`)
- Generation manager → Generator factory: creates generators (evidence: `src/LogGeneratorManager.ts`)
- Generator factory → Source generators: instantiates sources (evidence: `src/generators/createGenerators.ts`)
- Generation manager → Security operations generator: creates SOC generator (evidence: `src/LogGeneratorManager.ts`)
- Source generators → Template rendering: renders templates (evidence: `src/generators/BaseGenerator.ts`)
- Source generators → MITRE mapping: maps techniques (evidence: `src/generators/BaseGenerator.ts`)
- Generation manager → MITRE filtering: filters generated logs (evidence: `src/LogGeneratorManager.ts`)
- Generation manager → Worker generation: dispatches generation (evidence: `src/LogGeneratorManager.ts`)
- Worker generation → Flow control: applies flow control
- Generation manager → Output manager: hands off logs (evidence: `src/LogGeneratorManager.ts`)
- Output manager → Log formatters: formats logs (evidence: `src/utils/outputManager.ts`)
- Output manager → Log history: stores history (evidence: `src/utils/outputManager.ts`)
- Output manager → Configured SIEM: sends configured output (evidence: `README.md`)
- CLI commands → Chain manager: runs chain commands (evidence: `src/cli.ts`)
- Chain manager → Chain execution: executes chain (evidence: `src/chains/AttackChainManager.ts`)
- Chain execution → Step log factory: creates step logs (evidence: `src/chains/AttackChainEngine.ts`)
- Chain manager → Chain definitions: loads chain model (evidence: `src/chains/AttackChainManager.ts`)
- CLI commands → D3FEND mapping: reports coverage (evidence: `src/cli.ts`)
- CLI commands → Log replay: runs replay (evidence: `src/cli.ts`)
- Log replay → Log history: reads history (evidence: `src/replay/ReplayManager.ts`)
- CLI commands → Historical log files: analyzes historical files (evidence: `src/cli.ts`)
- CLI commands → Behavioral profiling: learns profiles (evidence: `src/cli.ts`)
- Behavioral profiling → Historical log files: reads log files (evidence: `src/ml/logProfile.ts`)
- CLI commands → Volume analysis: forecasts volume (evidence: `src/cli.ts`)
- Volume analysis → Historical log files: reads log files (evidence: `src/ml/volumeAnalysis.ts`)
- CLI commands → Anomaly detection: detects anomalies (evidence: `src/cli.ts`)
- CLI commands → IOC analysis: extracts indicators (evidence: `src/cli.ts`)
- CLI commands → Text classification: classifies text (evidence: `src/cli.ts`)
- Generation manager → Prometheus metrics: records metrics (evidence: `src/LogGeneratorManager.ts`)
- Generation manager → Health endpoints: starts monitoring (evidence: `src/LogGeneratorManager.ts`)
- Generation manager → Application logging: logs runtime events (evidence: `src/LogGeneratorManager.ts`)
- Configured SIEM → Operator: receives generated logs (evidence: `README.md`)
