# Golden Set for Patch Validation (in BinaryIndex)

## Module
BinaryIndex

## Status
IMPLEMENTED

## Description
Golden set analysis pipeline and API controller for curated binary patch validation test cases.

## Implementation Details
- **Modules**: `src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Analysis/`, `src/BinaryIndex/StellaOps.BinaryIndex.WebService/Controllers/`
- **Key Classes**:
  - `GoldenSetAnalysisPipeline` (`src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Analysis/GoldenSetAnalysisPipeline.cs`) - runs validation analysis against golden set definitions
  - `GoldenSetController` (`src/BinaryIndex/StellaOps.BinaryIndex.WebService/Controllers/GoldenSetController.cs`) - REST API for golden set CRUD operations with filtering, pagination, and ordering
    - `POST /api/v1/golden-sets` - create golden set definitions
    - `GET /api/v1/golden-sets` - list with status/component/tag filters
    - `GET /api/v1/golden-sets/{id}` - get by ID
  - `GoldenSetValidator` (`src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.GoldenSet/Validation/GoldenSetValidator.cs`) - validates golden set definitions
- **Interfaces**: `IGoldenSetStore`, `IGoldenSetValidator`
- **Models**: `GoldenSetDefinition`, `GoldenSetListQuery`, `GoldenSetListResponse`, `GoldenSetCreateRequest/Response`
- **Enums**: `GoldenSetStatus` (Draft, Active, etc.), `GoldenSetOrderBy`

## E2E Test Plan
- [ ] Create a golden set via `POST /api/v1/golden-sets` and verify it is stored with Draft status
- [ ] List golden sets with component filter and verify only matching sets are returned
- [ ] Get golden set by ID and verify all fields including metadata are returned
- [ ] Run golden set analysis pipeline against a known binary pair and verify patch validation result
- [ ] Verify golden set validation rejects definitions with invalid CVE references
- [ ] Verify pagination and ordering work correctly with multiple golden sets