fix: PropertySet argument transform crash when -PropertySet omitted

CHANGELOG.md

@@ -13,6 +13,11 @@
   any `IDictionary` instead of only exact `System.Collections.Hashtable`, so
   configuration built via `ConvertFrom-Json -AsHashtable` (which returns an
   `OrderedHashtable`) and other ordered/generic dictionaries bind correctly.
+- `PropertySetTransformAttribute` no longer calls the broken, argument-less
+  `Read-PropertySet` when `-PropertySet` is omitted (that call could never
+  bind and always threw). `-PropertySet` is now a mandatory parameter on
+  `Test-FeatureFlag`, matching `Test-Condition`, so the missing value is
+  reported with a clear mandatory-parameter error instead. (#84)
 
 ## [1.0.0] 2026-06-05
 
@@ -73,7 +78,7 @@
   constraints now correctly returns `$false` instead of continuing
   evaluation.
 - `PropertyValidation` threshold fields (`Minimum`, `Maximum`,
   `MinLength`, `MaxLength`) changed to `Nullable[int]` so an unconfigured
   constraint is no longer treated as zero.
 - `PropertyValidation.ToHashtable` now omits null/unset fields to
   prevent invalid entries in serialized JSON during Save/FromFile
@@ -144,7 +149,7 @@
 ### Changed
 
 - `Test-Condition` function now accepts `ConditionGroup` objects instead of
   hashtables for the Condition parameter, providing stronger type safety.
 - `Test-Condition` function now accepts `PropertySet` objects instead of a
   generic Properties hashtable for the Properties parameter.
 - Internal condition evaluation logic updated to use null checks on

Gatekeeper/Classes/Property.ps1

@@ -186,7 +186,7 @@ class PropertySetTransformAttribute : System.Management.Automation.ArgumentTrans
 
     [object] Transform([System.Management.Automation.EngineIntrinsics]$engineIntrinsics, [object] $inputData) {
         if ($null -eq $inputData) {
-            return $(Read-PropertySet)
+            return $null
         }
         if ($inputData -is [PropertySet]) {
             return $inputData

Gatekeeper/Public/Test-FeatureFlag.ps1

@@ -36,6 +36,8 @@
         [FeatureFlag]
         [FeatureFlagTransformAttribute()]
         $FeatureFlag,
+        [Parameter(Mandatory)]
+        [ValidateNotNull()]
         [PropertySet]
         [PropertySetTransformAttribute()]
         $PropertySet,

docs/en-US/Test-FeatureFlag.md

@@ -13,7 +13,7 @@
 ## SYNTAX
 
 ```
-Test-FeatureFlag [-FeatureFlag] <FeatureFlag> [[-PropertySet] <PropertySet>] [-Context] <Hashtable>
+Test-FeatureFlag [-FeatureFlag] <FeatureFlag> [-PropertySet] <PropertySet> [-Context] <Hashtable>
  [-ProgressAction <ActionPreference>] [<CommonParameters>]
 ```
 
@@ -60,7 +60,7 @@
 Parameter Sets: (All)
 Aliases:
 
-Required: False
+Required: True
 Position: 2
 Default value: None
 Accept pipeline input: False
@@ -88,7 +88,7 @@
 ```yaml
 Type: ActionPreference
 Parameter Sets: (All)
 Aliases: proga
 
 Required: False
 Position: Named