Integrate fourteen filesystem and format maintenance branches

.github/workflows/refs-diagnostic.yml

@@ -0,0 +1,57 @@
+name: ReFS diagnostic
+
+on:
+  push:
+    branches: [refs-block-refcount-clone]
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: 'true'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Clone PNGCrushCS sibling
+        run: git clone --depth 1 https://github.com/Hawkynt/PNGCrushCS.git "$GITHUB_WORKSPACE/../PNGCrushCS"
+      - uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '10.0.x'
+          dotnet-quality: preview
+      - name: Pre-build sibling
+        shell: bash
+        run: |
+          set -euo pipefail
+          cd "$GITHUB_WORKSPACE/../PNGCrushCS"
+          REQUIRED="Compression.Core FileFormat.Core FileFormat.Bmp FileFormat.Apng FileFormat.Tiff FileFormat.BigTiff FileFormat.Mng FileFormat.Fli FileFormat.Dcx FileFormat.Icns FileFormat.Mpo FileFormat.Jpeg FileFormat.Png"
+          locate() {
+            local proj="$1"
+            if [ -f "$proj/$proj.csproj" ]; then echo "$proj"; return 0; fi
+            if [ -f "FileFormats/$proj/$proj.csproj" ]; then echo "FileFormats/$proj"; return 0; fi
+            return 1
+          }
+          for proj in $REQUIRED; do
+            if ! locate "$proj" >/dev/null; then exit 0; fi
+          done
+          for proj in $REQUIRED; do
+            dir="$(locate "$proj")"
+            dotnet build "$dir/$proj.csproj" --configuration Release --nologo
+          done
+      - name: Restore
+        run: dotnet restore CompressionWorkbench.slnx
+      - name: Build and capture diagnostics
+        id: build
+        shell: bash
+        continue-on-error: true
+        run: |
+          set -o pipefail
+          dotnet build CompressionWorkbench.slnx --configuration Release --no-restore 2>&1 | tee refs-build.log
+      - uses: actions/upload-artifact@v4
+        with:
+          name: refs-build-log
+          path: refs-build.log
+      - name: Propagate build result
+        if: steps.build.outcome != 'success'
+        run: exit 1

.github/workflows/regenerate-moosefs-docs.yml

@@ -0,0 +1,51 @@
+name: Regenerate MooseFS docs
+
+on:
+  push:
+    branches: [feature/moosefs-maintenance]
+
+concurrency:
+  group: regenerate-moosefs-docs
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: 'true'
+
+jobs:
+  regenerate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '10.0.x'
+          dotnet-quality: 'preview'
+      - name: Rewrite filesystem support matrix
+        env:
+          CWB_WRITE_DOCS: '1'
+        run: >-
+          dotnet test Compression.Tests/Compression.Tests.csproj
+          --configuration Release
+          --filter FullyQualifiedName~FilesystemReadmeIsCurrentTests.TheSupportMatrix_SaysWhatTheCodeSays
+          --nologo
+      - name: Rewrite filesystem package API reference
+        uses: Hawkynt/RepositoryTemplate/package-readme@v1
+        with:
+          mode: write
+          project: Hawkynt.FileFormats.FileSystems/Hawkynt.FileFormats.FileSystems.csproj
+      - name: Commit generated documentation
+        shell: bash
+        run: |
+          set -euo pipefail
+          if git diff --quiet -- Hawkynt.FileFormats.FileSystems/README.md Hawkynt.FileFormats.FileSystems/REFERENCE.md; then
+            echo 'Filesystem package documentation already current.'
+            exit 0
+          fi
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+          git add Hawkynt.FileFormats.FileSystems/README.md Hawkynt.FileFormats.FileSystems/REFERENCE.md
+          git commit -m '* regenerate filesystem package documentation'
+          git push

Compression.Core/DiskImage/PartitionedDiskLister.cs

@@ -175,7 +175,7 @@ private static string MakePartitionPrefix(PartitionEntry part) {
   // ── Add / Remove (partition-aware) ────────────────────────────────────
 
   /// <summary>
-  /// Partition-aware <see cref="IArchiveModifiable.Add"/>. Returns <c>true</c>
+  /// Partition-aware <see cref="IArchiveModifiable.Add(System.IO.Stream, System.Collections.Generic.IReadOnlyList{Compression.Registry.ArchiveInputInfo})"/>. Returns <c>true</c>
   /// when a partition table was present and at least one input was dispatched
   /// through the partition-aware path; <c>false</c> when no partition table
   /// exists so the caller can fall through to the existing single-FS path.
@@ -243,7 +243,7 @@ public static bool TryAdd(Stream disk, IReadOnlyList<ArchiveInputInfo> inputs) {
   }
 
   /// <summary>
-  /// Partition-aware <see cref="IArchiveModifiable.Remove"/>. Returns <c>true</c>
+  /// Partition-aware <see cref="IArchiveModifiable.Remove(System.IO.Stream, string[])"/>. Returns <c>true</c>
   /// when a partition table was present and at least one entry was removed;
   /// <c>false</c> if no partition table was detected. Entry name shapes:
   /// <c>Partition&lt;N&gt;_&lt;Type&gt;/&lt;inner&gt;</c> deletes an inner-FS

Compression.Core/README.md

@@ -204,7 +204,7 @@ Use the concrete version you intend to consume; this document does not predict a
 
 <!-- API:BEGIN generated by Hawkynt/RepositoryTemplate/package-readme — edit the XML docs in source, not here -->
 
-Every public and protected member of all 627 types, generated from the built assembly and its XML documentation, is in [REFERENCE.md](https://github.com/Hawkynt/CompressionWorkbench/blob/main/Compression.Core/REFERENCE.md).
+Every public and protected member of all 628 types, generated from the built assembly and its XML documentation, is in [REFERENCE.md](https://github.com/Hawkynt/CompressionWorkbench/blob/main/Compression.Core/REFERENCE.md).
 
 <!-- API:END -->