save checkpoint

docs/features/checked/scanner/tiered-scanner-precision.md

@@ -0,0 +1,36 @@
+# 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 |