fix: address PR review feedback

Chocolatey.ps1:
- Fix synopsis grammar and replace stale Chocolatey.org references with
  the Chocolatey community repository
- Document the Dependency and ChocoInstallScriptUrl parameters
- Compare "have latest" versions SemanticVersion-first so prerelease
  versions (e.g. 2.2.2-beta) do not fall through to a reinstall

FileSystem.ps1:
- Report the specific missing $Source in the error, not the whole
  $Sources collection
- Wire the documented Force switch: drop robocopy /XO so the target is
  overwritten even where its copy is newer

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: HeyItsGilbert

PSDepend/PSDependScripts/Chocolatey.ps1

@@ -1,18 +1,25 @@
 <#
     .SYNOPSIS
-    Installs a Chocolatey package a repository.
+    Installs a package from a Chocolatey repository.
 
     .DESCRIPTION
-    Installs a package from a Chocolatey repository like Chocolatey.org.
+    Installs a package from a Chocolatey repository like the Chocolatey community repository.
 
     Relevant Dependency metadata:
         Name: The name of the package
         Version: Used to identify existing installs meeting this criteria. Defaults to 'latest'
         Source: Source Uri. Defaults to https://community.chocolatey.org/api/v2/
 
+    .PARAMETER Dependency
+    Dependency to process
+
     .PARAMETER Force
     If specified and the package is already installed, force the install again.
 
+    .PARAMETER ChocoInstallScriptUrl
+    Url to the script used to bootstrap Chocolatey when choco.exe is not found.
+    Defaults to https://community.chocolatey.org/install.ps1
+
     .PARAMETER PSDependAction
     Test, or Install the package. Defaults to Install
 
@@ -27,7 +34,7 @@
         }
     }
 
-    # Install version 2.0.2 of git via Chocolatey.org
+    # Install version 2.0.2 of git from the Chocolatey community repository
 
     .EXAMPLE
     @{
@@ -54,7 +61,7 @@
         'putty' = 'latest'
     }
 
-    # Installs the list of Chocolatey packages from Chocolatey.org using the Global PSDependOptions to limit repetition.
+    # Installs the list of Chocolatey packages from the Chocolatey community repository using the Global PSDependOptions to limit repetition.
 
 #>
 [CmdletBinding()]
@@ -304,9 +311,23 @@ else {
 # If the version in the remote repository is less than or equal to the version installed, then we have the latest already
 [System.Version]$parsedRepositoryVersion = $null
 [System.Version]$parsedExistingVersion = $null
-$haveLatest = [System.Version]::TryParse($repositoryVersion, [ref]$parsedRepositoryVersion) -and
-    [System.Version]::TryParse($existingVersion, [ref]$parsedExistingVersion) -and
+[System.Management.Automation.SemanticVersion]$parsedRepositorySemanticVersion = $null
+[System.Management.Automation.SemanticVersion]$parsedExistingSemanticVersion = $null
+$haveLatest = if (
+    [System.Management.Automation.SemanticVersion]::TryParse([string]$repositoryVersion, [ref]$parsedRepositorySemanticVersion) -and
+    [System.Management.Automation.SemanticVersion]::TryParse([string]$existingVersion, [ref]$parsedExistingSemanticVersion)
+) {
+    $parsedRepositorySemanticVersion -le $parsedExistingSemanticVersion
+}
+elseif (
+    [System.Version]::TryParse([string]$repositoryVersion, [ref]$parsedRepositoryVersion) -and
+    [System.Version]::TryParse([string]$existingVersion, [ref]$parsedExistingVersion)
+) {
     $parsedRepositoryVersion -le $parsedExistingVersion
+}
+else {
+    $false
+}
 if ($Version -eq 'latest' -and $haveLatest) {
     Write-Verbose "You have the latest version of [$Name], with installed version [$existingVersion] and Source version [$repositoryVersion]"
     if ($PSDependAction -contains 'Test') {

PSDepend/PSDependScripts/FileSystem.ps1

@@ -85,7 +85,7 @@ $TestOutput = @()
 foreach ($Source in @($Sources)) {
     if (-not (Test-Path $Source)) {
         if ($PSDependAction -notcontains 'Test') {
-            Write-Error "Skipping $DependencyName, could not find source [$Sources]"
+            Write-Error "Skipping $DependencyName, could not find source [$Source]"
         }
         continue
     }
@@ -108,8 +108,11 @@ foreach ($Source in @($Sources)) {
         }
         if ($PSDependAction -contains 'Install') {
             # TODO: Add non Windows equivalent...
-            [string[]]$Arguments = "/XO"
-            $Arguments += "/E"
+            [string[]]$Arguments = "/E"
+            if (-not ($Dependency.Parameters.Force -eq $True -or $Force)) {
+                # Without -Force, skip files where the target copy is newer
+                $Arguments += "/XO"
+            }
             if ($Dependency.Parameters.Mirror -eq $True -or $Mirror) {
                 $Arguments += "/PURGE"
             }