stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
ccdfd41e4f39e22f65e3030fa326adbe494a1528
git.stella-ops.org/src/Scanner/__Libraries/StellaOps.Scanner.SmartDiff/AGENTS.md
master 5d5e80b2e4 stabilize tests
2026-02-01 21:37:40 +02:00

1.4 KiB
Raw Blame History

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.
    1. Keep outputs deterministic (stable ordering, UTC timestamps, invariant formatting).
    1. Avoid cross-module edits unless explicitly referenced in the sprint and recorded in Decisions & Risks.