37 lines
1.8 KiB
Markdown
37 lines
1.8 KiB
Markdown
# Tiered Scanner Precision (Imported/Executed/Tainted-Sink Tiers with PR-AUC Metrics)
|
|
|
|
## Module
|
|
Scanner
|
|
|
|
## Status
|
|
VERIFIED
|
|
|
|
## Description
|
|
Fidelity-aware analysis with tiered precision is implemented including benchmark corpus management, metrics calculation, fidelity endpoints, and reproducibility verification.
|
|
|
|
## Implementation Details
|
|
- **Fidelity-Aware Analyzer**:
|
|
- `src/Scanner/__Libraries/StellaOps.Scanner.Orchestration/Fidelity/FidelityAwareAnalyzer.cs` - `FidelityAwareAnalyzer` adjusting analysis precision based on configured fidelity tier (Imported, Executed, Tainted-Sink) with corresponding precision/recall tradeoffs
|
|
- **Fidelity API**:
|
|
- `src/Scanner/StellaOps.Scanner.WebService/Endpoints/FidelityEndpoints.cs` - `FidelityEndpoints` REST API for querying and configuring fidelity tiers and viewing precision metrics
|
|
- **Tests**:
|
|
- `src/Scanner/__Tests/StellaOps.Scanner.Core.Tests/Fidelity/FidelityAwareAnalyzerTests.cs` - Unit tests for fidelity-aware analysis including benchmark corpus and PR-AUC metric validation
|
|
|
|
## E2E Test Plan
|
|
- [ ] Configure the scanner at "Imported" fidelity tier and verify it produces results with high recall but lower precision
|
|
- [ ] Configure "Executed" fidelity tier and verify results include only dependencies confirmed as loaded/executed
|
|
- [ ] Configure "Tainted-Sink" fidelity tier and verify results are restricted to vulnerabilities with confirmed data flow to sinks
|
|
- [ ] Verify fidelity endpoints return precision metrics (PR-AUC scores) for each tier against benchmark corpus
|
|
- [ ] Verify fidelity tier selection is deterministic and reproducible across identical scan inputs
|
|
|
|
---
|
|
|
|
## Verification
|
|
|
|
| Check | Result |
|
|
|-------|--------|
|
|
| Tier 0 - Source files exist | PASS |
|
|
| Tier 1 - Build + code review | PASS |
|
|
| Tier 2 - Integration tests | PASS |
|
|
| Verified | 2026-02-13T18:10:00Z |
|