release(core): PR-108-Audit wiederherstellen und Version-SSOT auf 6.0.0 stabilisieren (#116)

* docs(governance): add full PR-108 review audit matrix with evidence

* release(versioning): align active convergence to 6.0.0

* docs(governance): add reimplementation evidence for PR-108 file set

* fix(docs): normalize truncated URLs in PR-108 audit matrix

* docs(versioning): remove deferred 6.0.1 section from EN changelog

* docs(versioning): drop deferred 6.0.1 row from DE history

* docs(versioning): drop deferred 6.0.1 row from EN history

* docs(versioning): remove deferred 6.0.1 section from DE changelog

* docs(governance): fix typo Aehnlichkeit in PR108 audit matrix

* docs(governance): korrigiere Tippfehler nicht in Audit-Tabelle

* docs(governance): korrigiere zweites nicht in Audit-Tabelle

* docs(governance): korrigiere Benennung in Audit-Tabelle

* docs(versioning): align EvidenceHashingIO spelling in DE changelog

* docs(governance): remove markdown code-fence fragments from audit table

* docs(governance): clarify historical 6.0.1 context in PR108 audit rows

* style(props): normalize Directory.Build.props indentation

* docs(infrastructure): complete XML docs and logic block comments

* docs(abstractions): ergaenze konstruktor-xml-dokumentation

* style(core): richte Dim-Deklarationen spaltenweise aus

* Update src/FileTypeDetection/Infrastructure/ArchiveInternals.vb

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Tomtastisch <82227609+tomtastisch@users.noreply.github.com>

* style(vb): enforce Dim block alignment across FileTypeDetection

* fix(config): stabilisiere Builder-Syntax in Registry-Konfiguration

* fix(core): stabilisiere filekind-kompatibilitaet und policy-formatierung

---------

Signed-off-by: Tomtastisch <82227609+tomtastisch@users.noreply.github.com>
Co-authored-by: GitHub Copilot Agent <github-actions[bot]@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: 3 people

AGENTS.md

@@ -109,3 +109,16 @@ Abweichung ist blocker und vor Merge/Release zu beheben.
 ## 10) Lokale Overrides
 - Optional: `AGENTS.override.md` wird zusaetzlich angewendet.
 - `AGENTS.override.md` ist lokal-only und darf nicht committed werden.
+
+## 11) VB.NET Deklarationsstil (verbindlich)
+- Lokale Variablendeklarationen mit `Dim` werden in zusammenhängenden Blöcken spaltenweise ausgerichtet.
+- Ausrichtung erfolgt mindestens über diese Spalten:
+  - `Dim`
+  - Variablenname
+  - `As <Typ>`
+  - optionale Initialisierung `= <Wert>`
+- Die Einrückung startet linksbündig identisch je Block.
+- Beispiel:
+  - `Dim hasContentTypes           As Boolean     = False`
+  - `Dim hasOpenDocumentConflict   As Boolean     = False`
+  - `Dim candidateOpenDocumentKind As FileKind`

Directory.Build.props

@@ -1,10 +1,10 @@
 <Project>
-    <PropertyGroup>
-        <Deterministic>true</Deterministic>
-        <ContinuousIntegrationBuild Condition="'$(CI)' == 'true'">true</ContinuousIntegrationBuild>
-        <RestorePackagesWithLockFile>true</RestorePackagesWithLockFile>
-    </PropertyGroup>
   <PropertyGroup>
-    <RepoVersion>6.0.1</RepoVersion>
+    <Deterministic>true</Deterministic>
+    <ContinuousIntegrationBuild Condition="'$(CI)' == 'true'">true</ContinuousIntegrationBuild>
+    <RestorePackagesWithLockFile>true</RestorePackagesWithLockFile>
+  </PropertyGroup>
+  <PropertyGroup>
+    <RepoVersion>6.0.0</RepoVersion>
   </PropertyGroup>
 </Project>

docs/governance/047_PR_108_REVIEW_AUDIT_DE.MD

@@ -6,21 +6,20 @@
 
 Diese Tabelle wurde aus der Commit-Historie anhand der Policy in
 `docs/versioning/001_POLICY_VERSIONING.MD` abgeleitet.
-Heuristik fuer die Rueckwirkungs-Zuordnung:
+Heuristik für die Rückwirkungs-Zuordnung:
 - Major-Overrides: `5255724`, `fd03389`
 - `feat:` oder `Add ...` (nicht-Doku) => Minor
 - `docs|test|ci|chore|tooling|refactor|fix` => Patch
 
 Aktueller Entwicklungsstand:
-- Aktuelle Entwicklungslinie enthaelt `6.x` (aktueller Arbeitsstand: `v6.0.1`; Details in `docs/versioning/003_CHANGELOG_RELEASES.MD`).
+- Aktuelle Entwicklungslinie enthält `6.x` (aktueller Arbeitsstand: `v6.0.0`; Details in `docs/versioning/003_CHANGELOG_RELEASES.MD`).
 
 Hinweis:
 - Die Spalte `Keyword` verwendet den technischen Klassifizierungswert aus der Historie.
 - Einzelne Committitel bleiben in der Originalsprache, wenn sie als exakter Quelltextnachweis uebernommen wurden.
 
 | Version | Kurzbeschreibung | Commit | Keyword |
 |---|---|---|---|
-| `6.0.1` | Refactor-Haertung: interne SSOT-Utilities nach `Infrastructure/Utils` konsolidiert, Core-Utility-Logik in dedizierte Dateien gesplittet und Duplikat-Guards vereinheitlicht | [unreleased](https://github.com/tomtastisch/FileClassifier/compare/v5.2.1...HEAD) | patch |
 | `6.0.0` | Breaking-Release: `FileKind`-Enum und `HashRoundTripReport`-Public-API auf neues Slot-/Methodenmodell umgestellt, Hashing-Interna in Core/RoundTrip/Io ausgelagert | [unreleased](https://github.com/tomtastisch/FileClassifier/compare/v5.2.1...HEAD) | breaking |
 | `5.2.1` | SharpCompress-API auf typsichere Aufrufe umgestellt, tar.gz-Verarbeitung fail-closed gehaertet und Qodana-CI-Gate als Pflichtlauf dokumentiert/erzwungen | [unreleased](https://github.com/tomtastisch/FileClassifier/compare/v5.2.0...HEAD) | patch |
 | `5.2.0` | netstandard2.0-Compat-Layer eingefuehrt, Provider-Struktur konsolidiert und TFM-Multi-Targeting erweitert | [8d65a52](https://github.com/tomtastisch/FileClassifier/commit/8d65a52) | minor |

docs/versioning/002_HISTORY_VERSIONS.MD

@@ -4,30 +4,20 @@
 
 # Changelog
 
-Alle Aenderungen werden hier technisch dokumentiert. Die Release-Version selbst ist
+Alle Änderungen werden hier technisch dokumentiert. Die Release-Version selbst ist
 der Git-Tag `vX.Y.Z` (optional `-prerelease`) als SSOT.
 
-## [6.0.1]
-- Added:
-  - Neues internes Submodul `src/FileTypeDetection/Infrastructure/Utils/` als SSOT fuer wiederverwendbare Guard-/I/O-/Pfad-/Logging-Helfer.
-- Changed:
-  - Utility-Klassen aus `CoreInternals.vb` in dedizierte Dateien unter `Infrastructure/Utils` ausgelagert; `CoreInternals.vb` auf Refinement-Logik fokussiert.
-  - Vorhandene Utils von `src/FileTypeDetection/Utils/` nach `src/FileTypeDetection/Infrastructure/Utils/` verschoben und Namespace auf `Tomtastisch.FileClassifier.Infrastructure.Utils` konsolidiert.
-  - Duplizierte Byte-Array-Guard-Checks auf `ByteArrayGuard.HasContent(...)` vereinheitlicht.
-- Docs/CI/Tooling:
-  - Versionskonvergenz auf `6.0.1` nachgezogen (`RepoVersion`, `Version`, `PackageVersion`, Versionshistorie DE/EN).
-
 ## [6.0.0]
 - Added:
-  - Neue interne Hashing-Services (`EvidenceHashingCore`, `EvidenceHashingRoundTrip`, `EvidenceHashingIo`) fuer deterministische Auslagerung ohne neue Dependencies.
+  - Neue interne Hashing-Services (`EvidenceHashingCore`, `EvidenceHashingRoundTrip`, `EvidenceHashingIO`) für deterministische Auslagerung ohne neue Dependencies.
 - Changed:
   - Breaking-Umstellung von `FileKind`-Werten (`Docx`/`Xlsx`/`Pptx` -> `Doc`/`Xls`/`Ppt`).
   - Breaking-Umstellung der `HashRoundTripReport`-Public-API auf Slot-basiertes Zugriffsmodell (`HashSlot`, `Evidence(...)`, `LogicalEquals(...)`, `PhysicalEquals(...)`).
   - `EvidenceHashing` auf Fassade reduziert; Kernlogik in interne stateless Services verschoben.
 - Fixed:
   - Reflection-basierte Unit-Tests auf neue interne Hashing-Typen angepasst.
 - Docs/CI/Tooling:
-  - Versionskonvergenz lokal auf `6.0.0` vorbereitet (`RepoVersion`, `Version`, `PackageVersion`, Versionshistorie DE/EN).
+  - Versionskonvergenz aktiv auf `6.0.0` gesetzt (`RepoVersion`, `Version`, `PackageVersion`, Versionshistorie DE/EN).
 
 ## [5.2.1]
 - Added:

docs/versioning/003_CHANGELOG_RELEASES.MD

@@ -12,14 +12,13 @@ Heuristics for retroactive classification:
 - `docs|test|ci|chore|tooling|refactor|fix` => patch
 
 Current state:
-- Current release line contains `6.x` (current working state: `v6.0.1`; details in `docs/versioning/103_CHANGELOG_RELEASES.MD`).
+- Current release line contains `6.x` (current working state: `v6.0.0`; details in `docs/versioning/103_CHANGELOG_RELEASES.MD`).
 
 Note:
 - The \"short description\" column follows the original commit/PR intent text for deterministic traceability and is not normalized to a single language.
 
 | Version | Short description | Commit | Keyword |
 |---|---|---|---|
-| `6.0.1` | Refactor hardening: consolidated internal SSOT utilities into `Infrastructure/Utils`, split core utility logic into dedicated files, and unified duplicate byte guards | [unreleased](https://github.com/tomtastisch/FileClassifier/compare/v5.2.1...HEAD) | patch |
 | `6.0.0` | Breaking release: migrated `FileKind` enum and `HashRoundTripReport` public API to the new slot/method model and split hashing internals into core/roundtrip/io services | [unreleased](https://github.com/tomtastisch/FileClassifier/compare/v5.2.1...HEAD) | breaking |
 | `5.2.1` | Switched SharpCompress calls to type-safe APIs, hardened tar.gz fail-closed handling, and enforced/documented Qodana CI as a mandatory gate | [unreleased](https://github.com/tomtastisch/FileClassifier/compare/v5.2.0...HEAD) | patch |
 | `5.2.0` | Introduce netstandard2.0 compatibility layer, consolidate provider structure, and extend TFM multi-targeting | [8d65a52](https://github.com/tomtastisch/FileClassifier/commit/8d65a52) | minor |

docs/versioning/102_HISTORY_VERSIONS.MD

@@ -6,16 +6,6 @@
 
 All changes are documented here in technical terms. The release version itself is the Git tag `vX.Y.Z` (optional `-prerelease`) as SSOT.
 
-## [6.0.1]
-- Added:
-  - New internal submodule `src/FileTypeDetection/Infrastructure/Utils/` as the SSOT for reusable guard/I/O/path/logging helpers.
-- Changed:
-  - Moved utility classes from `CoreInternals.vb` into dedicated files under `Infrastructure/Utils`; narrowed `CoreInternals.vb` to refinement logic.
-  - Relocated existing utils from `src/FileTypeDetection/Utils/` to `src/FileTypeDetection/Infrastructure/Utils/` and consolidated the namespace to `Tomtastisch.FileClassifier.Infrastructure.Utils`.
-  - Unified duplicate byte-array guard checks to `ByteArrayGuard.HasContent(...)`.
-- Docs/CI/Tooling:
-  - Updated version convergence to `6.0.1` (`RepoVersion`, `Version`, `PackageVersion`, version history DE/EN).
-
 ## [6.0.0]
 - Added:
   - New internal hashing services (`EvidenceHashingCore`, `EvidenceHashingRoundTrip`, `EvidenceHashingIo`) for deterministic extraction without adding dependencies.
@@ -26,7 +16,7 @@ All changes are documented here in technical terms. The release version itself i
 - Fixed:
   - Updated reflection-based unit tests to the new internal hashing types.
 - Docs/CI/Tooling:
-  - Prepared local version convergence to `6.0.0` (`RepoVersion`, `Version`, `PackageVersion`, version history DE/EN).
+  - Set active version convergence to `6.0.0` (`RepoVersion`, `Version`, `PackageVersion`, version history DE/EN).
 
 ## [5.2.1]
 - Added:

docs/versioning/103_CHANGELOG_RELEASES.MD

@@ -37,6 +37,11 @@ Namespace Global.Tomtastisch.FileClassifier
         ''' </summary>
         Public ReadOnly Property Size As Integer
 
+        ''' <summary>
+        '''     Initialisiert ein unveränderliches In-Memory-Modell für einen Archiveintrag.
+        ''' </summary>
+        ''' <param name="entryPath">Normalisierter relativer Eintragspfad.</param>
+        ''' <param name="payload">Extrahierter Byteinhalt des Eintrags.</param>
         Friend Sub New _
             (
                 entryPath As String,

src/FileTypeDetection/Abstractions/Archive/ZipExtractedEntry.vb

@@ -44,6 +44,14 @@ Namespace Global.Tomtastisch.FileClassifier
         ''' </summary>
         Public ReadOnly Property ExtensionVerified As Boolean
 
+        ''' <summary>
+        '''     Initialisiert ein detailliertes Detektionsergebnis.
+        ''' </summary>
+        ''' <param name="detectedType">Finaler, nach allen Policies ermittelter Dateityp.</param>
+        ''' <param name="reasonCode">Deterministischer Reason-Code für den Entscheidungspfad.</param>
+        ''' <param name="usedZipContentCheck">Kennzeichnet eine inhaltsbasierte Archivprüfung.</param>
+        ''' <param name="usedStructuredRefinement">Kennzeichnet ein strukturiertes Archiv-Refinement.</param>
+        ''' <param name="extensionVerified">Kennzeichnet die bestätigte Endungsprüfung.</param>
         Friend Sub New _
             (
                 detectedType As FileType,

src/FileTypeDetection/Abstractions/Detection/DetectionDetail.vb

@@ -28,7 +28,7 @@ Namespace Global.Tomtastisch.FileClassifier
         ''' <summary>Enum-Schlüssel des Typs.</summary>
         Public ReadOnly Property Kind As FileKind
 
-        ''' <summary>Kanonische Endung inklusive Punkt, bei Unknown leer.</summary>
+        ''' <summary>Kanonische Endung inklusive Punkt, bei UNKNOWN leer.</summary>
         Public ReadOnly Property CanonicalExtension As String
 
         ''' <summary>Kanonischer MIME-Typ als Metadatum, kann leer sein.</summary>
@@ -44,6 +44,14 @@ Namespace Global.Tomtastisch.FileClassifier
         ''' </summary>
         Public ReadOnly Property Aliases As ImmutableArray(Of String)
 
+        ''' <summary>
+        '''     Initialisiert ein unveränderliches Dateityp-Wertobjekt.
+        ''' </summary>
+        ''' <param name="kind">Enum-Schlüssel des Dateityps.</param>
+        ''' <param name="canonicalExtension">Kanonische Endung inklusive Punkt.</param>
+        ''' <param name="mime">Kanonischer MIME-Typ als Metadatum.</param>
+        ''' <param name="allowed">Kennzeichnet die Policy-Zulässigkeit.</param>
+        ''' <param name="aliases">Aliasmenge für Endungszuordnung.</param>
         Friend Sub New _
             (
                 kind As FileKind,
@@ -53,8 +61,8 @@ Namespace Global.Tomtastisch.FileClassifier
                 aliases As IEnumerable(Of String)
             )
 
-            Dim dedup As HashSet(Of String) = New HashSet(Of String)(StringComparer.OrdinalIgnoreCase)
-            Dim n As String
+            Dim dedup          As HashSet(Of String) = New HashSet(Of String)(StringComparer.OrdinalIgnoreCase)
+            Dim n              As String
             Dim orderedAliases As List(Of String)
 
             Me.Kind = kind
@@ -83,7 +91,6 @@ Namespace Global.Tomtastisch.FileClassifier
         ''' </summary>
         ''' <returns>String-Repräsentation des Feldes <see cref="Kind"/>.</returns>
         Public Overrides Function ToString() As String
-
             Return Kind.ToString()
         End Function
     End Class