git.stella-ops.org/src/Scanner/__Libraries/StellaOps.Scanner.Reachability/AGENTS.md

AGENTS - Scanner Reachability Library

Mission

Deliver deterministic reachability analysis, slice generation, and evidence artifacts used by Scanner and downstream policy/VEX workflows.

Roles

• Backend engineer (.NET 10, C# preview).
• QA engineer (unit/integration tests with deterministic fixtures).

Required Reading

• docs/README.md
• docs/07_HIGH_LEVEL_ARCHITECTURE.md
• docs/modules/platform/architecture-overview.md
• docs/modules/scanner/architecture.md
• docs/modules/reach-graph/guides/DELIVERY_GUIDE.md
• docs/modules/reach-graph/guides/slice-schema.md
• docs/modules/reach-graph/guides/replay-verification.md

Working Directory & Boundaries

• Primary scope: src/Scanner/__Libraries/StellaOps.Scanner.Reachability/
• Tests: src/Scanner/__Tests/StellaOps.Scanner.Reachability.Tests/
• Avoid cross-module edits unless explicitly noted in the sprint.

Determinism & Offline Rules

• Stable ordering for graphs, slices, and diffs.
• UTC timestamps only; avoid wall-clock nondeterminism.
• Offline-first: no external network calls; use CAS and local caches.

Testing Expectations

• Add schema validation and round-trip tests for slice artifacts.
• Ensure deterministic serialization bytes for any DSSE payloads.
• Run dotnet test src/Scanner/StellaOps.Scanner.sln when feasible.

Workflow

• Update sprint status on task transitions.
• Record decisions/risks in sprint Execution Log and Decisions & Risks.