TorusGuard Report — Posture Reporting & SARIF / HTML Export
Objective
Aggregate findings, verification traces, and recheck results into an auditable executive security report, export schema-compliant OASIS SARIF v2.1.0 logs for CI/CD pipelines, and render zero-dependency single-file visual HTML posture reports.
Two Execution Modes
Mode A: Automated CLI Execution
Run the report engine from your terminal:
# Generate visual dark-mode HTML dashboard
npx torusguard report --html
# Export OASIS SARIF v2.1.0 for GitHub Code Scanning / CI
npx torusguard report --sarif
# Generate both HTML and SARIF for latest run
npx torusguard report --html --sarif
# Generate report for a specific project directory
npx torusguard report ./examples/vulnerable-react-express --html
# Target a specific run ID
npx torusguard report --run run-20260910-121618-audit --html
Under the Hood:
- Invokes
python .torusguard/scripts/html_reporter.pyto compile self-contained, offline-ready HTML reports with dynamic filtering, posture gauge, and cluster summaries at.torusguard/runs/<run_id>/report.html. - Invokes
python .torusguard/scripts/sarif_exporter.pyto produce OASIS SARIF v2.1.0 logs at.torusguard/runs/<run_id>/results.sarif. - Finalizes
manifest.jsonmetrics and updates historical posture scoring. - Displays 75-column terminal cards.
Mode B: In-Session AI Chat Agent Reporting
When generating security posture summaries in AI chat:
- Aggregate Run Data: Inspect
findings.json,remediation.md, andrecheck.mdfrom the active run. - Calculate Posture Score: Compute posture score ($0$–$100$) based on severity weighting (Critical: 25, High: 15, Medium: 5, Low: 2).
- Format Executive Card: Present finding counts, closed vulnerabilities, remaining risks, and compliance posture.
- Export Artifacts: Verify that
report.htmlandresults.sarifare serialized to disk.
SARIF v2.1.0 Specification
- Schema:
https://docs.oasis-open.org/sarif/sarif/v2.1.0/cos02/schemas/sarif-schema-2.1.0.json - Tool Driver:
name: TorusGuard,semanticVersion: 1.3.3, full rules catalog indriver.rules. - Automation Details:
automationDetails.id: "torusguard/static"to avoid collisions in multi-scanner CI/CD pipelines. - Fingerprints:
partialFingerprints.primaryLocationLineHashwith SHA-256 context hash.
Output Card Format
### 📊 TorusGuard Security Posture Report Emitted
- **Run ID:** `run-20260910-121618-audit`
- **Posture Score:** 85 / 100 (HIGH SECURITY)
- **Findings Summary:** 3 Evaluated · 2 Confirmed Fixed · 1 Unresolved
- **HTML Dashboard:** `.torusguard/runs/<run_id>/report.html` (View in browser)
- **SARIF v2.1.0 Export:** `.torusguard/runs/<run_id>/results.sarif` (Ready for CI)