chore(analyzer): structured PSScriptAnalyzer settings, bump to 1.25.0

- PSScriptAnalyzerSettings.psd1: replace the single-line @{ IncludeRules = @('*') }
  with the standard structured form (IncludeDefaultRules + Include/Exclude/Rules
  blocks). Includes a commented-out PSUseCompatibleSyntax/PSUseCompatibleCmdlets
  scaffold for projects that want cross-version compatibility checks.
- build.depend.psd1: bump PSScriptAnalyzer from 1.24.0 to 1.25.0 to pick up
  newer rule fixes.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: tablackburn

PSScriptAnalyzerSettings.psd1

@@ -1,3 +1,28 @@
+# https://learn.microsoft.com/en-us/powershell/utility-modules/psscriptanalyzer/using-scriptanalyzer
 @{
-    IncludeRules = @('*')
+    IncludeDefaultRules = $true
+
+    IncludeRules        = @(
+        # Default rules
+        'PS*'
+    )
+
+    # If IncludeRules and ExcludeRules are empty, all rules will be applied
+    ExcludeRules        = @()
+
+    Rules               = @{
+        #  PSUseCompatibleSyntax  = @{
+        #    # This turns the rule on (setting it to false will turn it off)
+        #    Enable         = $true
+
+        #    # List the targeted versions of PowerShell here
+        #    TargetVersions = @(
+        #      '5.1',
+        #      '7.2'
+        #    )
+        #  }
+        #  PSUseCompatibleCmdlets = @{
+        #    compatibility = @('core-7.2.0-windows')
+        #  }
+    }
 }

build.depend.psd1

@@ -23,6 +23,6 @@
         Version = '0.7.3'
     }
     'PSScriptAnalyzer' = @{
-        Version = '1.24.0'
+        Version = '1.25.0'
     }
 }