Archivzugriff

Phase 1 stellt read-only Archivzugriff bereit.

Unterstützt

• Verzeichnisquellen für Entwicklung und synthetische Tests
• ZIP-basierte .scs-Archive
• Archivdiagnose mit Eintragsanzahl, unkomprimierter Größe und Warnungen

Sicherheitsgrenzen für ZIP-SCS

Standardwerte:

• maximale Eintragsanzahl: 250000
• maximale Größe eines Eintrags: 512 MiB
• maximale unkomprimierte Gesamtsumme: 16 GiB

Einträge mit unsicheren virtuellen Pfaden werden ignoriert. Doppelte virtuelle Pfade werden diagnostiziert; der erste Eintrag bleibt aktiv.

HashFS

HashFS-Archive werden als eigener Archivtyp erkannt. Der native Clean-Room-Lesezugriff ist noch nicht implementiert und liefert eine klare Diagnose.

Für ein vom Benutzer selbst bereitgestelltes offizielles SCS-Extractor-Werkzeug existiert ein Adaptervertrag. Das Werkzeug wird nicht mitgeliefert.

Details stehen in docs/formats/HASHFS_CLEAN_ROOM_SPEC.md.

Externer Extractor-Adapter

Der Adapter startet ein benutzerkonfiguriertes lokales Programm mit Argumentvorlagen. Er unterstützt:

• Dateiliste über Standardausgabe
• Extraktion einer einzelnen Datei in einen temporären Ausgabepfad
• Zeitlimit
• Abbruch per CancellationToken
• Normalisierung virtueller Pfade

Das temporäre Extraktionsergebnis wird nach dem Einlesen gelöscht.