Fix parser-blocking bugs in FileBackup.ps1 and add modular test harness

FileBackup.ps1: replace 10 Unicode smart quotes with ASCII (script can now
parse), and drop the K timezone specifier from FileLabelDateFormat so change
folders no longer get illegal ':' characters in their names.

New tests/ layout supports three volume backends (Subst for CI, VHDX for
Hyper-V hosts, RealUSB for physical sticks set up via Setup-USB.bat). Run-All
sweeps four mode/compression combos through eight suite groups (G1-G8). One-
click entry via RunAllTests.bat; GitHub Actions workflow runs the Subst
backend on every push and PR. README documents the project and test plan.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: diytechy

.github/workflows/tests.yml

@@ -0,0 +1,76 @@
+name: tests
+
+on:
+  push:
+    branches: [main, working, Claude]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  subst-backend:
+    name: Tests (Subst backend, windows-latest)
+    runs-on: windows-latest
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Cache K4os.Hash.xxHash
+        uses: actions/cache@v4
+        with:
+          path: ~\AppData\Local\PackageManagement\NuGet\Packages\K4os.Hash.xxHash.1.0.8
+          key: k4os-xxhash-1.0.8-${{ runner.os }}
+
+      - name: Install deps (non-interactive)
+        shell: pwsh
+        run: |
+          .\tests\Setup.ps1 -InstallDeps -NonInteractive
+
+      - name: Verify 7-Zip
+        shell: pwsh
+        run: |
+          if (-not (Test-Path 'C:\Program Files\7-Zip\7z.exe')) {
+              throw "7-Zip missing on runner"
+          }
+
+      - name: Run tests (Subst backend)
+        shell: pwsh
+        run: |
+          .\tests\Run-All.ps1 `
+              -Backend Subst `
+              -ResultRoot $env:RUNNER_TEMP\fbtest `
+              -EmitJUnit `
+              -NonInteractive
+
+      - name: Upload raw results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results-subst
+          path: ${{ runner.temp }}\fbtest\**
+
+      - name: Publish JUnit
+        if: always()
+        uses: dorny/test-reporter@v1
+        with:
+          name: FileBackup (Subst)
+          path: ${{ runner.temp }}\fbtest\**\results.xml
+          reporter: java-junit
+          fail-on-error: false
+
+  vhdx-backend:
+    name: Tests (VHDX backend, self-hosted)
+    runs-on: [self-hosted, windows, hyper-v]
+    if: ${{ vars.HAS_SELF_HOSTED_HYPERV == 'true' }}
+    timeout-minutes: 60
+    steps:
+      - uses: actions/checkout@v4
+      - shell: pwsh
+        run: |
+          .\tests\Setup.ps1 -InstallDeps -NonInteractive
+          .\tests\Run-All.ps1 -Backend VHDX `
+              -ResultRoot $env:RUNNER_TEMP\fbtest -EmitJUnit -NonInteractive
+      - if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results-vhdx
+          path: ${{ runner.temp }}\fbtest\**

FileBackup.ps1

@@ -64,7 +64,7 @@ $ReconstructBatName     = 'RECONSTRUCT.bat'
 $ReconstructLogName     = 'RECONSTRUCT.log'
 
 $CSVDateFormat          = 'O'    # ISO 8601 round-trip
-$FileLabelDateFormat    = "yyyy_MM_dd_HH_mm_ssK" # label in folder and manifest names
+$FileLabelDateFormat    = 'yyyy_MM_dd_HH_mm_ss'  # label in folder and manifest names (no zone — Windows paths can't contain ':')
 $ChangeFolderDateMask   = 'yyyy_MM_dd_HH_mm_ss'  # pattern we look for in change folder names
 
 # Alphabet for short name encoding (base-N over this alphabet)
@@ -1281,28 +1281,28 @@ function Run-BackupSet {
     }
 
     # 2. Create logger
-    $logPath = Join-Path $paths.ChgPath ‘backup.log’
+    $logPath = Join-Path $paths.ChgPath 'backup.log'
     $log = New-Logger -LogFile $logPath
     $LogPaths.Add($logPath)
 
-    & $log "----- Backup set ‘$($Set.Name)’ starting -----"
+    & $log "----- Backup set '$($Set.Name)' starting -----"
 
     # 3. Guard staging folder
     try {
         $stagingFolder = Initialize-StagingFolder -ChgPath $paths.ChgPath -Log $log
     } catch {
-        & $log "Failed to initialize staging folder: $($_.Exception.Message)" ‘ERROR’
+        & $log "Failed to initialize staging folder: $($_.Exception.Message)" 'ERROR'
         $OverallSuccess.Value = $false
         return
     }
 
     # 4. Update source manifest
-    & $log "Updating source manifest at ‘$($paths.SrcPath)’."
-    $sourceDb = UpdateSourceDatabase -SourcePath $paths.SrcPath -FfprobePath $Deps[‘ffprobe’]
+    & $log "Updating source manifest at '$($paths.SrcPath)'."
+    $sourceDb = UpdateSourceDatabase -SourcePath $paths.SrcPath -FfprobePath $Deps['ffprobe']
 
     # 5. Sanitize backup manifest
-    & $log "Sanitizing backup manifest at ‘$($paths.BkpPath)’."
-    $backupDb = SanitizeBackupDatabase -BackupRoot $paths.BkpPath -PreserveFolderTree ([bool]$Set.PreserveFolderTree) -CompressEnabled ([bool]$Set.CompressEnabled) -SevenZipPath $Deps[‘7z’] -Log $log
+    & $log "Sanitizing backup manifest at '$($paths.BkpPath)'."
+    $backupDb = SanitizeBackupDatabase -BackupRoot $paths.BkpPath -PreserveFolderTree ([bool]$Set.PreserveFolderTree) -CompressEnabled ([bool]$Set.CompressEnabled) -SevenZipPath $Deps['7z'] -Log $log
 
     # 6. Hash recalc decision
     $lastHashRun = $null
@@ -1313,7 +1313,7 @@ function Run-BackupSet {
     & $log "HashRecalcFreq=$($Set.HashRecalcFreq), LastHashRun=$lastHashRun, Recalculate=$recalc"
 
     # 7. Write pre-backup manifest to staging
-    & $log "Saving pre-backup manifest to staging ‘$stagingFolder’."
+    & $log "Saving pre-backup manifest to staging '$stagingFolder'."
     Write-Manifest -FolderPath $stagingFolder -Records $backupDb
 
     # 8. Diff
@@ -1335,7 +1335,7 @@ function Run-BackupSet {
             -BkpPath $paths.BkpPath `
             -PreserveFolderTree ([bool]$Set.PreserveFolderTree) `
             -CompressEnabled ([bool]$Set.CompressEnabled) `
-            -SevenZipPath $Deps[‘7z’] `
+            -SevenZipPath $Deps['7z'] `
             -BackupDb $backupDb `
             -BackupMap ([ref]$backupMap) `
             -ChangedCount ([ref]$changedCount) `
@@ -1369,7 +1369,7 @@ function Run-BackupSet {
     SanitizeChangeDatabase -ChangeRoot $paths.ChgPath -BackupRoot $paths.BkpPath -Log $log
 
     & $log "Changed files count = $changedCount"
-    & $log "----- Backup set ‘$($Set.Name)’ completed -----"
+    & $log "----- Backup set '$($Set.Name)' completed -----"
 }
 
 # endregion