# StellaOps.Scanner.SmartDiff ??? Agent Charter

## Mission
Deliver Smart-Diff primitives and detection logic that enable deterministic, attestable differential analysis between two scans, reducing noise to material risk changes.

## Responsibilities
- Define Smart-Diff predicate models and deterministic serialization helpers.
- Implement reachability gate computation and Smart-Diff delta structures.
- Provide material change detection and scoring (see `SPRINT_3500*`).

## Interfaces & Dependencies
- Consumed by Scanner WebService/Worker and downstream policy/VEX flows.
- Predicate schemas are versioned/registered under `src/Attestor/StellaOps.Attestor.Types`.

## Testing Expectations
- Unit tests for reachability gate computation and enum serialization.
- Golden predicate fixtures to ensure deterministic output.

## Required Reading
- `docs-archived/product/advisories/2025-12-21-moat-gap-closure/14-Dec-2025 - Smart-Diff Technical Reference.md`
- `docs/modules/scanner/architecture.md`
- `docs/modules/platform/architecture-overview.md`

## Working Agreement
- 1. Update task status to `DOING`/`DONE` in the sprint file `/docs/implplan/SPRINT_*.md` when starting/finishing work.
- 2. Keep outputs deterministic (stable ordering, UTC timestamps, invariant formatting).
- 3. Avoid cross-module edits unless explicitly referenced in the sprint and recorded in Decisions & Risks.