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

42
docs/features/checked/scanner/surface-fs-file-manifest-store.md Normal file
View File

@@ -0,0 +1,42 @@
# Surface.FS File Manifest Store
## Module
Scanner
## Status
VERIFIED
## Description
Persistent manifest store for scanner surface state, providing content-addressed caching of file system facets (layers, mounts, rootfs entries) with seal extraction for deterministic replay.
## Implementation Details
- **File Manifest Store**:
- `src/Scanner/__Libraries/StellaOps.Scanner.Surface.FS/FileSurfaceManifestStore.cs` - `FileSurfaceManifestStore` providing content-addressed storage for file system facets (layers, mounts, rootfs entries)
- **Seal Extraction**:
- `src/Scanner/__Libraries/StellaOps.Scanner.Surface.FS/FacetSealExtractor.cs` - `FacetSealExtractor` extracting deterministic seals from file system facets for replay verification
- `src/Scanner/__Libraries/StellaOps.Scanner.Surface.FS/FacetSealExtractionOptions.cs` - Options for seal extraction behavior
- **DI Registration**:
- `src/Scanner/__Libraries/StellaOps.Scanner.Surface.FS/ServiceCollectionExtensions.cs` - DI registration for surface FS services
- **Configuration**:
- `src/Scanner/StellaOps.Scanner.WebService/Options/SurfaceManifestStoreOptionsConfigurator.cs` - WebService-side configuration for manifest store
- **Tests**:
- `src/Scanner/__Tests/StellaOps.Scanner.Surface.FS.Tests/FileSurfaceManifestStoreTests.cs` - Manifest store tests
- `src/Scanner/__Tests/StellaOps.Scanner.WebService.Tests/SurfaceManifestStoreOptionsConfiguratorTests.cs` - Configuration tests
## E2E Test Plan
- [ ] Store a file system facet in `FileSurfaceManifestStore` and verify it is retrievable by its content-addressed key
- [ ] Verify content-addressed caching returns the same facet for identical content without re-storage
- [ ] Extract a seal from stored facets using `FacetSealExtractor` and verify it is deterministic (same facets produce identical seals)
- [ ] Verify the manifest store correctly handles layer, mount, and rootfs entry facets with correct metadata
- [ ] Verify seal extraction supports deterministic replay by reproducing the exact same seal from the same inputs
---
## 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 |