stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
b851aa8300b7febfb2e661443c8e39df13fa4e22
git.stella-ops.org/docs/features/checked/scanner/material-changes-orchestrator.md
master e9aeadc040 save checkpoint
2026-02-14 09:11:48 +02:00

2.2 KiB
Raw Blame History

Material Changes Orchestrator (Unified Cross-Module Diff Report)

Module

Scanner

Status

VERIFIED

Description

Unified orchestration service that chains Scanner SmartDiff, BinaryIndex fingerprint diffs, and Unknowns tracking into a single "material changes" report with compact card-style output (what changed, why it matters, next action). Enables one-stop review of all changes across layers.

Implementation Details

  • Orchestrator:
    • src/Scanner/__Libraries/StellaOps.Scanner.MaterialChanges/IMaterialChangesOrchestrator.cs - IMaterialChangesOrchestrator interface defining the material changes workflow
    • src/Scanner/__Libraries/StellaOps.Scanner.MaterialChanges/MaterialChangesOrchestrator.cs - MaterialChangesOrchestrator chains SmartDiff, BinaryIndex fingerprint diffs, and Unknowns tracking into a unified report
  • Report Model:
    • src/Scanner/__Libraries/StellaOps.Scanner.MaterialChanges/MaterialChangesReport.cs - MaterialChangesReport model with compact card-style output (what changed, why it matters, next action)
  • Card Generation:
    • src/Scanner/__Libraries/StellaOps.Scanner.MaterialChanges/CardGenerators.cs - CardGenerators produces compact card-style summaries for each type of material change
  • DI Registration: src/Scanner/__Libraries/StellaOps.Scanner.MaterialChanges/MaterialChangesServiceExtensions.cs

E2E Test Plan

  • Trigger a rescan of a container image with known changes and verify the material changes orchestrator produces a unified report
  • Verify the report includes SmartDiff results (component additions, removals, version changes)
  • Verify the report includes BinaryIndex fingerprint diff results when binary changes are detected
  • Verify the report includes Unknowns tracking deltas (newly unknown vs newly resolved)
  • Verify card-style output includes "what changed", "why it matters", and "next action" for each change
  • Verify the report correctly aggregates changes across all container layers

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