stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity

save checkpoint

Browse Source
This commit is contained in:
master
2026-02-14 09:11:48 +02:00
parent 9ca2de05df
commit e9aeadc040
1512 changed files with 30863 additions and 4728 deletions
Download Patch File Download Diff File Expand all files Collapse all files

39
docs/features/checked/scanner/material-changes-orchestrator.md Normal file
View File

@@ -0,0 +1,39 @@
# 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 |