strobengine 0.4.1__tar.gz → 0.5.0__tar.gz

{strobengine-0.4.1 → strobengine-0.5.0}/.gitignore

@@ -248,3 +248,6 @@ __marimo__/
 
 # Streamlit
 .streamlit/secrets.toml
+
+# strobengine reports
+.strobengine/

{strobengine-0.4.1 → strobengine-0.5.0}/CHANGELOG.md

@@ -4,6 +4,66 @@ All notable changes to `strobengine` will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.0] - 2026-08-30
+
+### Documentation
+
+- Convert README links to absolute GitHub URLs
+- *(cli)* Add --sse/--no-sse and --sse-max-events to option tables
+- *(examples)* Add SSE streaming load test examples
+- Add SSE load testing reference guide
+- Add SSE to README, quickstart, and table of contents
+- Mark HTML report generator as complete in roadmap
+- Mark baseline comparison as complete in roadmap
+- Add reporting and visualizations reference guide
+- Add Reporting & Visualizations to documentation indexes
+- Add Advanced Metrics & Observability epic to roadmap
+- Mark Export Formats as complete in roadmap
+
+### Features
+
+- *(config)* Add sse_enabled, sse_max_events to TestConfig
+- *(metrics)* Add sse_events_received, sse_first_event_us, sse_event_interval_us to RequestMetric
+- *(sse)* Implement SSE frame parser and SseEngine
+- *(sse)* Wire SSE engine into protocol detection and config routing
+- *(sse)* Centralize protocol routing and add URL normalization
+- *(deps)* Add serde with derive feature for report serialization
+- *(report)* Add ReportArtifact schema with serde serialization
+- *(config)* Add output_dir and no_save to TestConfig
+- *(python)* Wire report persistence through CLI and engine
+- *(report)* Add ReportArtifact::from_summary_and_config converter
+- *(report)* Add save_report_json with atomic writes and latest.json
+- *(report)* Invoke save_report_json on benchmark completion
+- *(reporting)* Add standalone HTML report generator with Chart.js
+- *(cli)* Add --html flag for standalone HTML report generation
+- *(reporting)* Add baseline artifact loading and delta comparison
+- *(reporting)* Add Historical Comparison section to HTML report
+- *(cli)* Add --compare-to flag for baseline comparison
+- *(reporting)* Inline Chart.js from local asset for 100% offline reports
+- *(reporting)* Add CLI terminal comparison and extend compute_comparison
+- *(engine)* Add get_config() convenience method to StrobEngine
+- *(reporting)* Add Markdown, JUnit XML, and CSV export generators
+- *(cli)* Add --markdown, --junit, --csv export flags
+- *(reporting)* Add generate_markdown_summary for GitHub Actions / PR comments
+- *(reporting)* Add generate_junit_report and generate_csv_report
+
+### Miscellaneous Tasks
+
+- *(pyproject)* Simplify readme config and update documentation URL
+- *(scripts)* Run uv lock during release version bump
+
+### Styling
+
+- *(tests)* Reorder imports in test_reporting.py for ruff isort compliance
+
+### Testing
+
+- *(config)* Update TestConfig::new calls with SSE parameters
+- *(e2e)* Add SSE streaming endpoint to mock server
+- *(e2e)* Add SSE integration tests for error paths and streaming
+- *(e2e)* Add persistence E2E tests for report artifact disk writing
+- *(reporting)* Add unit tests for Markdown summary generator
+- *(reporting)* Add JUnit XML and CSV export unit tests
 ## [0.4.1] - 2026-08-26
 
 ### Bug Fixes
@@ -22,6 +82,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Slim README and link to documentation pages
 - Add multi-target, reporting, SSE, messaging, and caching epics to roadmap
 
+### Miscellaneous Tasks
+
+- *(release)* Bump version to 0.4.1
+
 ### Testing
 
 - *(e2e)* Remove bytes_received assertion from PingPong mode test

{strobengine-0.4.1 → strobengine-0.5.0}/Cargo.lock

@@ -1461,6 +1461,7 @@ dependencies = [
  "base64",
  "bytes",
  "futures-core",
+ "futures-util",
  "h2",
  "http",
  "http-body",
@@ -1479,12 +1480,14 @@ dependencies = [
  "sync_wrapper",
  "tokio",
  "tokio-rustls",
+ "tokio-util",
  "tower",
  "tower-http",
  "tower-service",
  "url",
  "wasm-bindgen",
  "wasm-bindgen-futures",
+ "wasm-streams",
  "web-sys",
 ]
 
@@ -1654,6 +1657,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "4148590afebada386688f18773da617792bf2ef03ffc1e4cbd2b1d45b023e0ba"
 dependencies = [
  "serde_core",
+ "serde_derive",
 ]
 
 [[package]]
@@ -1781,7 +1785,7 @@ checksum = "6ce2be8dc25455e1f91df71bfa12ad37d7af1092ae736f3a6cd0e37bc7810596"
 
 [[package]]
 name = "strobengine"
-version = "0.4.1"
+version = "0.5.0"
 dependencies = [
  "async-trait",
  "base64",
@@ -1801,6 +1805,7 @@ dependencies = [
  "pyo3",
  "quinn",
  "reqwest",
+ "serde",
  "serde_json",
  "tokio",
  "tokio-stream",
@@ -2355,6 +2360,19 @@ dependencies = [
  "unicode-ident",
 ]
 
+[[package]]
+name = "wasm-streams"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9d1ec4f6517c9e11ae630e200b2b65d193279042e28edd4a2cda233e46670bbb"
+dependencies = [
+ "futures-util",
+ "js-sys",
+ "wasm-bindgen",
+ "wasm-bindgen-futures",
+ "web-sys",
+]
+
 [[package]]
 name = "web-sys"
 version = "0.3.103"

{strobengine-0.4.1 → strobengine-0.5.0}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "strobengine"
-version = "0.4.1"
+version = "0.5.0"
 edition = "2024"
 readme = "README.md"
 
@@ -15,7 +15,7 @@ crate-type = ["cdylib", "rlib"]
 # "abi3-py311" tells pyo3 (and maturin) to build using the stable ABI with
 # minimum Python version 3.11
 pyo3 = { version = "0.29", features = ["extension-module", "abi3-py311"] }
-reqwest = { version = "0.13.4", default-features = false, features = ["rustls", "http2"] }
+reqwest = { version = "0.13.4", default-features = false, features = ["rustls", "http2", "stream"] }
 http = "1"
 bytes = "1"
 tokio = { version = "1.53.0", features = ["sync", "time", "rt", "rt-multi-thread", "macros", "signal"] }
@@ -37,6 +37,7 @@ base64 = "0.22"
 hex = "0.4"
 prost-reflect = { version = "0.16.5", features = ["serde"] }
 protox = "0.9.1"
+serde = { version = "1", features = ["derive"] }
 serde_json = "1.0.151"
 tonic-reflection = { version = "0.14.6", default-features = false }
 quinn = { version = "0.11", default-features = false, features = ["runtime-tokio", "rustls-ring"] }

strobengine-0.5.0/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: strobengine
+Version: 0.5.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.27.0
+Requires-Dist: jinja2>=3.1
+License-File: LICENSE
+Summary: A load testing framework with a Python UI and a bare-metal Rust engine core.
+Author-email: riccione <28346232+riccione@users.noreply.github.com>
+License-Expression: Apache-2.0
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Changelog, https://github.com/strobeops/strobengine/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/strobeops/strobengine/blob/main/docs/table_of_contents.md
+Project-URL: Homepage, https://github.com/strobeops/strobengine
+Project-URL: Source, https://github.com/strobeops/strobengine
+
+# strobengine
+
+A high-performance HTTP, WebSocket, gRPC, and SSE load testing engine with a Python API and a bare-metal Rust core.
+
+## Install
+
+```bash
+pip install strobengine
+# or from source
+git clone https://github.com/strobeops/strobengine.git && cd strobengine && uv sync
+```
+
+> See [Installation Guide](https://github.com/strobeops/strobengine/blob/main/docs/install.md) for Docker, PyPI, and development setup.
+
+## Quick Start
+
+```python
+from strobengine import StrobEngine
+from strobengine.reporter import print_summary
+
+engine = StrobEngine(url="http://localhost:8080/api/health", concurrency=50, duration=30)
+summary = engine.run()
+print_summary(summary)
+```
+
+```bash
+strobengine load http://localhost:8080/api/health -c 50 -d 30
+```
+
+> See [Quick Start Guide](https://github.com/strobeops/strobengine/blob/main/docs/quickstart.md) for Python API and CLI examples.
+
+## Documentation
+
+| Section | Description |
+|---------|-------------|
+| [Installation](https://github.com/strobeops/strobengine/blob/main/docs/install.md) | Build from source, Docker, PyPI |
+| [Dependencies](https://github.com/strobeops/strobengine/blob/main/docs/dependencies.md) | System requirements, Rust crates, Python packages |
+| [Quick Start](https://github.com/strobeops/strobengine/blob/main/docs/quickstart.md) | Python API and CLI usage examples |
+| [CLI Reference](https://github.com/strobeops/strobengine/blob/main/docs/cli.md) | All subcommands, flags, and options |
+| [HTTP Methods](https://github.com/strobeops/strobengine/blob/main/docs/http_methods.md) | Supported methods, request bodies, headers |
+| [WebSocket](https://github.com/strobeops/strobengine/blob/main/docs/websockets.md) | WS/WSS modes, pub/sub broadcasting, metrics |
+| [gRPC](https://github.com/strobeops/strobengine/blob/main/docs/grpc.md) | Unary calls, protobuf, deadline, chaos |
+| [HTTP/3](https://github.com/strobeops/strobengine/blob/main/docs/http3.md) | QUIC transport, 0-RTT resumption, loss recovery |
+| [SSE](https://github.com/strobeops/strobengine/blob/main/docs/sse.md) | Server-Sent Events streaming, TTFB, event intervals |
+| [Reporting](https://github.com/strobeops/strobengine/blob/main/docs/reports.md) | JSON persistence, HTML reports, baseline comparison |
+| [Docker](https://github.com/strobeops/strobengine/blob/main/docs/docker.md) | Pulling images, running containers |
+| [Testing](https://github.com/strobeops/strobengine/blob/main/docs/testing.md) | Test structure, e2e, CI/CD |
+| [Roadmap](https://github.com/strobeops/strobengine/blob/main/docs/roadmap.md) | Planned features |
+
+## How to Contribute
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feat/my-feature`)
+3. Install dependencies and set up pre-push Git hooks:
+   ```bash
+   uv sync
+   uv run pre-commit install --hook-type pre-push
+   ```
+4. Run formatting, linting, and tests manually (or let git push run them automatically):
+   ```bash
+   make check
+   ```
+5. Commit your changes following [Conventional Commits](https://www.conventionalcommits.org/)
+6. Push to your branch and open a Pull Request
+
+## License
+
+This project is licensed under the Apache License, Version 2.0. See [LICENSE](https://github.com/strobeops/strobengine/blob/main/LICENSE) for the full text.
+

strobengine-0.5.0/README.md

@@ -0,0 +1,68 @@
+# strobengine
+
+A high-performance HTTP, WebSocket, gRPC, and SSE load testing engine with a Python API and a bare-metal Rust core.
+
+## Install
+
+```bash
+pip install strobengine
+# or from source
+git clone https://github.com/strobeops/strobengine.git && cd strobengine && uv sync
+```
+
+> See [Installation Guide](https://github.com/strobeops/strobengine/blob/main/docs/install.md) for Docker, PyPI, and development setup.
+
+## Quick Start
+
+```python
+from strobengine import StrobEngine
+from strobengine.reporter import print_summary
+
+engine = StrobEngine(url="http://localhost:8080/api/health", concurrency=50, duration=30)
+summary = engine.run()
+print_summary(summary)
+```
+
+```bash
+strobengine load http://localhost:8080/api/health -c 50 -d 30
+```
+
+> See [Quick Start Guide](https://github.com/strobeops/strobengine/blob/main/docs/quickstart.md) for Python API and CLI examples.
+
+## Documentation
+
+| Section | Description |
+|---------|-------------|
+| [Installation](https://github.com/strobeops/strobengine/blob/main/docs/install.md) | Build from source, Docker, PyPI |
+| [Dependencies](https://github.com/strobeops/strobengine/blob/main/docs/dependencies.md) | System requirements, Rust crates, Python packages |
+| [Quick Start](https://github.com/strobeops/strobengine/blob/main/docs/quickstart.md) | Python API and CLI usage examples |
+| [CLI Reference](https://github.com/strobeops/strobengine/blob/main/docs/cli.md) | All subcommands, flags, and options |
+| [HTTP Methods](https://github.com/strobeops/strobengine/blob/main/docs/http_methods.md) | Supported methods, request bodies, headers |
+| [WebSocket](https://github.com/strobeops/strobengine/blob/main/docs/websockets.md) | WS/WSS modes, pub/sub broadcasting, metrics |
+| [gRPC](https://github.com/strobeops/strobengine/blob/main/docs/grpc.md) | Unary calls, protobuf, deadline, chaos |
+| [HTTP/3](https://github.com/strobeops/strobengine/blob/main/docs/http3.md) | QUIC transport, 0-RTT resumption, loss recovery |
+| [SSE](https://github.com/strobeops/strobengine/blob/main/docs/sse.md) | Server-Sent Events streaming, TTFB, event intervals |
+| [Reporting](https://github.com/strobeops/strobengine/blob/main/docs/reports.md) | JSON persistence, HTML reports, baseline comparison |
+| [Docker](https://github.com/strobeops/strobengine/blob/main/docs/docker.md) | Pulling images, running containers |
+| [Testing](https://github.com/strobeops/strobengine/blob/main/docs/testing.md) | Test structure, e2e, CI/CD |
+| [Roadmap](https://github.com/strobeops/strobengine/blob/main/docs/roadmap.md) | Planned features |
+
+## How to Contribute
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feat/my-feature`)
+3. Install dependencies and set up pre-push Git hooks:
+   ```bash
+   uv sync
+   uv run pre-commit install --hook-type pre-push
+   ```
+4. Run formatting, linting, and tests manually (or let git push run them automatically):
+   ```bash
+   make check
+   ```
+5. Commit your changes following [Conventional Commits](https://www.conventionalcommits.org/)
+6. Push to your branch and open a Pull Request
+
+## License
+
+This project is licensed under the Apache License, Version 2.0. See [LICENSE](https://github.com/strobeops/strobengine/blob/main/LICENSE) for the full text.

{strobengine-0.4.1 → strobengine-0.5.0}/docs/cli.md

@@ -43,6 +43,8 @@ By default, this spawns **10 concurrent workers** for **10 seconds** with a **10
 | `--http3/--no-http3` | off | Enable HTTP/3 over QUIC |
 | `--quic-zero-rtt` | off | Enable QUIC 0-RTT connection testing |
 | `--quic-max-idle-timeout` | none | QUIC max idle timeout in ms |
+| `--sse/--no-sse` | off | Enable SSE streaming mode |
+| `--sse-max-events` | none | Maximum events to receive per connection |
 
 ## Stress Subcommand Options
 
@@ -75,6 +77,8 @@ By default, this spawns **10 concurrent workers** for **10 seconds** with a **10
 | `--http3/--no-http3` | off | Enable HTTP/3 over QUIC |
 | `--quic-zero-rtt` | off | Enable QUIC 0-RTT connection testing |
 | `--quic-max-idle-timeout` | none | QUIC max idle timeout in ms |
+| `--sse/--no-sse` | off | Enable SSE streaming mode |
+| `--sse-max-events` | none | Maximum events to receive per connection |
 
 ## Spike Subcommand Options
 
@@ -108,6 +112,8 @@ By default, this spawns **10 concurrent workers** for **10 seconds** with a **10
 | `--http3/--no-http3` | off | Enable HTTP/3 over QUIC |
 | `--quic-zero-rtt` | off | Enable QUIC 0-RTT connection testing |
 | `--quic-max-idle-timeout` | none | QUIC max idle timeout in ms |
+| `--sse/--no-sse` | off | Enable SSE streaming mode |
+| `--sse-max-events` | none | Maximum events to receive per connection |
 
 ## Global Options
 

{strobengine-0.4.1 → strobengine-0.5.0}/docs/quickstart.md

@@ -76,6 +76,19 @@ summary = engine.run()
 print_summary(summary)
 ```
 
+### SSE Streaming
+
+```python
+engine = StrobEngine(
+    url="http://localhost:8080/sse",
+    concurrency=10,
+    duration=30,
+    options=RequestOptions(sse_enabled=True),
+)
+summary = engine.run()
+print_summary(summary)
+```
+
 ### Async Execution
 
 For async contexts (FastAPI, Typer, etc.):
@@ -111,6 +124,9 @@ strobengine load grpc://localhost:50051 \
   --grpc-method SayHello \
   --grpc-payload CgR0ZXN0 \
   -c 10 -d 30
+
+# SSE streaming
+strobengine load http://localhost:8080/sse --sse -c 10 -d 30
 ```
 
 > See [CLI Reference](cli.md) for all available flags and options.

strobengine-0.5.0/docs/reports.md

@@ -0,0 +1,149 @@
+# Reporting & Visualizations
+
+strobengine automatically persists execution reports as JSON artifacts
+and optionally generates standalone HTML reports with interactive
+Chart.js visualizations and historical baseline comparisons.
+
+## Implicit Report Persistence
+
+After every load test, strobengine writes a JSON report artifact
+to disk by default.
+
+| Property | Value |
+|----------|-------|
+| Default directory | `./.strobengine/reports/` |
+| Filename pattern | `report_YYYYMMDD_HHMMSS_<host>.json` |
+| Atomic writes | Yes — tmp file + rename prevents corruption |
+| `latest.json` pointer | Yes — tracks most recent report |
+
+Reports are written by both the Rust engine (`run_load_test`) and
+the Python reporter (`save_report`).
+
+## Configuration Flags
+
+These flags appear on all three subcommands (`load`, `stress`, `spike`):
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--output-dir <DIR>` | string | `.strobengine/reports/` | Override report storage directory |
+| `--no-save` | flag | false | Disable disk persistence entirely |
+| `--html <PATH>` | string | none | Generate standalone HTML report at filepath |
+| `--compare-to <PATH>` | string | none | Baseline JSON report for comparison |
+
+## JSON Artifact Schema
+
+### Structure
+
+| Section | Key Fields |
+|---------|------------|
+| `metadata` | `timestamp`, `duration_secs`, `target_url`, `cli_options`, `system_info` |
+| `cli_options` | `method`, `concurrency`, `timeout_secs`, `chaos`, `chaos_rate`, `body`, `headers` |
+| `system_info` | `hostname`, `platform`, `version` |
+| `summary` | `total_requests`, `successful_requests`, `failed_requests`, `rps`, `bytes_transferred` |
+| `latency_percentiles` | `p50_us`, `p90_us`, `p95_us`, `p99_us`, `min_us`, `max_us`, `mean_us` |
+| `error_breakdown` | Status code string → count (e.g., `"200": 950, "500": 50`) |
+
+All latency values are stored in **microseconds**.
+
+### Example
+
+```json
+{
+  "metadata": {
+    "timestamp": "2026-08-28T09:48:19Z",
+    "duration_secs": 30.0,
+    "target_url": "http://localhost:8080/api",
+    "cli_options": { "method": "GET", "concurrency": 50, "chaos": false },
+    "system_info": { "hostname": "ci-runner-01", "platform": "linux", "version": "0.5.0" }
+  },
+  "summary": { "total_requests": 1500, "successful_requests": 1485, "failed_requests": 15, "rps": 50.0, "bytes_transferred": 524288 },
+  "latency_percentiles": { "p50_us": 1200.0, "p90_us": 3500.0, "p95_us": 5200.0, "p99_us": 9800.0, "min_us": 200.0, "max_us": 15000.0, "mean_us": 2800.0 },
+  "error_breakdown": { "200": 1485, "500": 15 }
+}
+```
+
+## HTML Report Generation
+
+### Dependencies
+
+- **Chart.js** — bundled locally at `src/strobengine/reporting/assets/chart.min.js`
+  (186KB, embedded inline in generated HTML — 100% offline, no CDN required)
+- **Jinja2** — used for template rendering (`jinja2>=3.1`)
+
+### CLI Usage
+
+```bash
+strobengine load http://localhost:8080/api -c 10 -d 30 --html report.html
+```
+
+### Features
+
+- **Self-contained single-file HTML** — no external dependencies
+- **Embedded Chart.js** — 100% offline, no internet required
+- **Dark theme** — slate/navy color palette
+- **Bar chart**: Latency percentiles (P50, P90, P95, P99) in milliseconds
+- **Doughnut chart**: Status code distribution (2xx, 4xx, 5xx, Other)
+- **Metadata grid**: Target URL, method, concurrency, duration, RPS, error rate
+
+### Python API
+
+```python
+from strobengine import StrobEngine
+from strobengine.reporting.html_report import save_html_report
+
+engine = StrobEngine(url="http://localhost:8080", concurrency=10, duration=30)
+summary = engine.run()
+filepath = save_html_report(summary, engine.get_config(), "report.html")
+```
+
+## Historical Baseline Comparison
+
+### CLI Usage
+
+```bash
+# First run — generates baseline report
+strobengine load http://localhost:8080/api -c 10 -d 30
+
+# Second run — compare against baseline (terminal output)
+strobengine load http://localhost:8080/api -c 10 -d 30 \
+  --compare-to .strobengine/reports/report_baseline.json
+
+# Second run — compare with HTML report
+strobengine load http://localhost:8080/api -c 10 -d 30 \
+  --html report.html --compare-to .strobengine/reports/report_baseline.json
+```
+
+### Terminal Output
+
+`--compare-to` displays a Rich table comparing baseline vs current metrics,
+even without `--html`. The table includes:
+
+| Metric | Baseline | Current | Delta |
+|--------|----------|---------|-------|
+| RPS | 33.00 | 40.00 | +21.21% (green) |
+| P95 Latency | 35.00 ms | 25.00 ms | -28.57% (green) |
+| Error Rate | 10.00% | 5.00% | -5.00pp (green) |
+
+Color coding:
+- **Green**: Improvement (higher RPS, lower latency, fewer errors)
+- **Red**: Regression (lower RPS, higher latency, more errors)
+- **Gray**: No change (0% delta)
+
+### HTML Output
+
+When used with `--html`, the comparison section is embedded in the report
+with the same color-coded deltas.
+
+### Delta Calculation
+
+| Metric | Formula | Unit |
+|--------|---------|------|
+| RPS | `((current - baseline) / baseline) * 100` | % (positive = improvement) |
+| P95 Latency | `((current - baseline) / baseline) * 100` | % (negative = improvement) |
+| Error Rate | `current_rate - baseline_rate` | pp (negative = improvement) |
+
+## Limitations
+
+- Baseline comparison assumes same target URL (cross-URL comparison not supported)
+- Report schema version is not tracked (no migration support)
+- `--compare-to` requires the baseline file to be a valid strobengine JSON artifact

{strobengine-0.4.1 → strobengine-0.5.0}/docs/roadmap.md

@@ -72,15 +72,47 @@ This document outlines the planned trajectory and upcoming feature epics for **s
 ### Epic: Test Persistence & Visual Reporting
 *Target Focus: Long-Term Benchmark Tracking & Visualization*
 
-- [ ] **Artifact Persistence Engine**
-  - [ ] Automatic disk storage for raw JSON execution metrics (`--output-dir`, `--save-report`).
-  - [ ] Standardized report schema featuring execution metadata (timestamps, CLI flags, system specs, latency percentiles).
-- [ ] **HTML / Visual Report Generator**
-  - [ ] Standalone HTML report output with embedded latency distribution charts (p50, p90, p95, p99).
-  - [ ] Summary dashboards comparing current runs against historical baseline artifacts.
-- [ ] **Export Formats**
-  - [ ] Markdown summary generation for CI/CD Pull Request integration (GitHub Actions step comments).
-  - [ ] CSV/JUnit XML exports for standard test runner ingestion.
+- [x] **Artifact Persistence Engine** `[v0.5.0]`
+  - [x] Automatic disk storage for raw JSON execution metrics (`--output-dir`, `--no-save`). `[v0.5.0]`
+  - [x] Standardized report schema featuring execution metadata (timestamps, CLI flags, system specs, latency percentiles). `[v0.5.0]`
+- [x] **HTML / Visual Report Generator** `[v0.5.0]`
+  - [x] Standalone HTML report output with embedded latency distribution charts (p50, p90, p95, p99). `[v0.5.0]`
+  - [x] Summary dashboards comparing current runs against historical baseline artifacts. `[v0.5.0]`
+- [x] **Export Formats** `[v0.5.0]`
+  - [x] Markdown summary generation for CI/CD Pull Request integration (GitHub Actions step comments). `[v0.5.0]`
+  - [x] CSV/JUnit XML exports for standard test runner ingestion. `[v0.5.0]`
+
+---
+
+### Epic: Advanced Metrics & Observability
+*Target Focus: Deep Performance Insights & System Monitoring*
+
+- [ ] **Aggregate Existing Protocol Metrics** `[v0.6.0]`
+  - [ ] Forward `connection_latency_us`, `quic_*`, `sse_*` fields through aggregator to `TestSummary`
+  - [ ] Add protocol-specific sections to JSON report artifact
+
+- [ ] **Chaos Fault Tracking** `[v0.6.0]`
+  - [ ] Count injected faults by type (ConnectionDrop, LatencySpike, etc.)
+  - [ ] Include fault breakdown in JSON report artifact
+
+- [ ] **Extended Latency Statistics** `[v0.6.0]`
+  - [ ] Compute latency jitter (standard deviation)
+  - [ ] Add p99.99 percentile
+  - [ ] Add latency histogram buckets for distribution visualization
+
+- [ ] **Client System Resource Monitoring** `[v0.7.0]`
+  - [ ] Track engine CPU %, memory (RSS), thread count during test
+  - [ ] Sample at configurable interval (e.g., every 1s)
+  - [ ] Include in JSON report artifact and HTML visualization
+
+- [ ] **Connection Pool Metrics** `[v0.7.0]`
+  - [ ] Track socket creation rate vs reuse rate
+  - [ ] Report DNS resolution duration (if instrumentable)
+
+- [ ] **Protocol-Specific Deep Metrics** `[v0.8.0]`
+  - [ ] WebSocket: unsolicited pings/pongs, backpressure depth
+  - [ ] gRPC: stream concurrency utilization, flow control window exhaustion
+  - [ ] HTTP/3: congestion window size, connection migration success rate
 
 ---
 
@@ -102,8 +134,8 @@ This document outlines the planned trajectory and upcoming feature epics for **s
 - [x] **HTTP/3 (QUIC)** `[v0.4.0] - 2026-08-23`
   - [x] UDP-based QUIC transport layer support. `[v0.4.0] - 2026-08-23`
   - [x] Zero-RTT connection testing and loss recovery benchmarking. `[v0.4.0] - 2026-08-23`
-- [ ] **Server-Sent Events (SSE / HTTP Streaming)**
-  - [ ] Persistent HTTP streaming response parsing (Time-to-First-Byte, chunk latency, LLM stream benchmarking).
+- [x] **Server-Sent Events (SSE / HTTP Streaming)** `[v0.5.0]`
+  - [x] Persistent HTTP streaming response parsing (Time-to-First-Byte, chunk latency, LLM stream benchmarking). `[v0.5.0]`
 
 ---