From 6843874bcf485cba53c82400b3199c564296976b Mon Sep 17 00:00:00 2001
From: Simon Schrottner <simon.schrottner@dynatrace.com>
Date: Thu, 12 Mar 2026 16:12:07 +0100
Subject: [PATCH 1/3] test(semver): add edge case scenarios for v-prefix,
 partial versions, and build metadata

Adds @semver-edge-cases tagged scenarios covering:
- v-prefix versions (v1.0.0) stripped transparently on both sides
- Partial versions (1, 1.2) padded with .0 components
- Build metadata ignored per SemVer 2.0.0 Rule 10

Addresses: https://github.com/open-feature/flagd/issues/1873

Signed-off-by: Simon Schrottner <simon.schrottner@dynatrace.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 flags/custom-ops.json     | 42 +++++++++++++++++++++++++++++++++++++++
 gherkin/targeting.feature | 36 +++++++++++++++++++++++++++++++++
 2 files changed, 78 insertions(+)

diff --git a/flags/custom-ops.json b/flags/custom-ops.json
index 85f5f9a..84b1a94 100644
--- a/flags/custom-ops.json
+++ b/flags/custom-ops.json
@@ -299,6 +299,48 @@
           }
         ]
       }
+    },
+    "semver-v-prefix-flag": {
+      "state": "ENABLED",
+      "variants": {
+        "match": "match",
+        "no-match": "no-match"
+      },
+      "defaultVariant": "no-match",
+      "targeting": {
+        "if": [
+          {"sem_ver": [{"var": "version"}, "=", "v1.0.0"]},
+          "match", "no-match"
+        ]
+      }
+    },
+    "semver-partial-version-flag": {
+      "state": "ENABLED",
+      "variants": {
+        "match": "match",
+        "no-match": "no-match"
+      },
+      "defaultVariant": "no-match",
+      "targeting": {
+        "if": [
+          {"sem_ver": [{"var": "version"}, "^", "1"]},
+          "match", "no-match"
+        ]
+      }
+    },
+    "semver-build-metadata-flag": {
+      "state": "ENABLED",
+      "variants": {
+        "match": "match",
+        "no-match": "no-match"
+      },
+      "defaultVariant": "no-match",
+      "targeting": {
+        "if": [
+          {"sem_ver": [{"var": "version"}, "=", "1.0.0+build"]},
+          "match", "no-match"
+        ]
+      }
     }
   }
 }
diff --git a/gherkin/targeting.feature b/gherkin/targeting.feature
index 5dd7ae2..3b5d0a6 100644
--- a/gherkin/targeting.feature
+++ b/gherkin/targeting.feature
@@ -240,6 +240,42 @@ Feature: Targeting rules
       | 3.1.0   | major |
       | 4.0.0   | none  |
 
+  @semver @semver-edge-cases
+  Scenario Outline: sem_ver v-prefix handling
+    Given a String-flag with key "semver-v-prefix-flag" and a default value "fallback"
+    And a context containing a key "version", with type "String" and with value "<version>"
+    When the flag was evaluated with details
+    Then the resolved details value should be "<value>"
+    Examples:
+      | version | value    |
+      | 1.0.0   | match    |
+      | v1.0.0  | match    |
+      | 2.0.0   | no-match |
+
+  @semver @semver-edge-cases
+  Scenario Outline: sem_ver partial version handling
+    Given a String-flag with key "semver-partial-version-flag" and a default value "fallback"
+    And a context containing a key "version", with type "String" and with value "<version>"
+    When the flag was evaluated with details
+    Then the resolved details value should be "<value>"
+    Examples:
+      | version | value    |
+      | 1.5.0   | match    |
+      | 1.0.0   | match    |
+      | 2.0.0   | no-match |
+
+  @semver @semver-edge-cases
+  Scenario Outline: sem_ver build metadata ignored
+    Given a String-flag with key "semver-build-metadata-flag" and a default value "fallback"
+    And a context containing a key "version", with type "String" and with value "<version>"
+    When the flag was evaluated with details
+    Then the resolved details value should be "<value>"
+    Examples:
+      | version       | value    |
+      | 1.0.0         | match    |
+      | 1.0.0+other   | match    |
+      | 2.0.0         | no-match |
+
   Scenario Outline: Time-based operations
     Given a Integer-flag with key "timestamp-flag" and a default value "0"
     And a context containing a key "time", with type "Integer" and with value "<time>"

From 97e339171eb9f2f086f59816a56d48d8d49ddbea Mon Sep 17 00:00:00 2001
From: Simon Schrottner <simon.schrottner@dynatrace.com>
Date: Mon, 30 Mar 2026 16:02:21 +0200
Subject: [PATCH 2/3] test(semver): mirror edge case scenarios to evaluator
 gherkin suite

Adds the v-prefix, partial version, and build-metadata semver scenarios
from the SDK-level gherkin (gherkin/targeting.feature) to the evaluator
suite, with matching flag definitions in evaluator/flags/testkit-flags.json.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: Simon Schrottner <simon.schrottner@dynatrace.com>
---
 evaluator/flags/testkit-flags.json | 24 ++++++++++++++++++
 evaluator/gherkin/semver.feature   | 39 ++++++++++++++++++++++++++++++
 2 files changed, 63 insertions(+)

diff --git a/evaluator/flags/testkit-flags.json b/evaluator/flags/testkit-flags.json
index 268e905..38c9be5 100644
--- a/evaluator/flags/testkit-flags.json
+++ b/evaluator/flags/testkit-flags.json
@@ -474,6 +474,30 @@
           ["two", 50]
         ]
       }
+    },
+    "semver-v-prefix-flag": {
+      "state": "ENABLED",
+      "variants": { "match": "match", "no-match": "no-match" },
+      "defaultVariant": "no-match",
+      "targeting": {
+        "if": [{"sem_ver": [{"var": "version"}, "=", "v1.0.0"]}, "match", "no-match"]
+      }
+    },
+    "semver-partial-version-flag": {
+      "state": "ENABLED",
+      "variants": { "match": "match", "no-match": "no-match" },
+      "defaultVariant": "no-match",
+      "targeting": {
+        "if": [{"sem_ver": [{"var": "version"}, "^", "1"]}, "match", "no-match"]
+      }
+    },
+    "semver-build-metadata-flag": {
+      "state": "ENABLED",
+      "variants": { "match": "match", "no-match": "no-match" },
+      "defaultVariant": "no-match",
+      "targeting": {
+        "if": [{"sem_ver": [{"var": "version"}, "=", "1.0.0+build"]}, "match", "no-match"]
+      }
     }
   },
   "$evaluators": {
diff --git a/evaluator/gherkin/semver.feature b/evaluator/gherkin/semver.feature
index 0b215c7..be76454 100644
--- a/evaluator/gherkin/semver.feature
+++ b/evaluator/gherkin/semver.feature
@@ -43,3 +43,42 @@ Feature: Evaluator semantic version operator
       | key                          | context_value |
       | semver-invalid-version-flag  | not-a-version |
       | semver-invalid-operator-flag | 1.0.0         |
+
+  @semver-edge-cases
+  Scenario Outline: v-prefix handling
+    Given an evaluator
+    And a String-flag with key "semver-v-prefix-flag" and a fallback value "fallback"
+    And a context containing a key "version", with type "String" and with value "<version>"
+    When the flag was evaluated with details
+    Then the resolved details value should be "<value>"
+    Examples:
+      | version | value    |
+      | 1.0.0   | match    |
+      | v1.0.0  | match    |
+      | 2.0.0   | no-match |
+
+  @semver-edge-cases
+  Scenario Outline: partial version handling
+    Given an evaluator
+    And a String-flag with key "semver-partial-version-flag" and a fallback value "fallback"
+    And a context containing a key "version", with type "String" and with value "<version>"
+    When the flag was evaluated with details
+    Then the resolved details value should be "<value>"
+    Examples:
+      | version | value    |
+      | 1.5.0   | match    |
+      | 1.0.0   | match    |
+      | 2.0.0   | no-match |
+
+  @semver-edge-cases
+  Scenario Outline: build metadata ignored in comparison
+    Given an evaluator
+    And a String-flag with key "semver-build-metadata-flag" and a fallback value "fallback"
+    And a context containing a key "version", with type "String" and with value "<version>"
+    When the flag was evaluated with details
+    Then the resolved details value should be "<value>"
+    Examples:
+      | version     | value    |
+      | 1.0.0       | match    |
+      | 1.0.0+other | match    |
+      | 2.0.0       | no-match |

From 734c18f1ccdefa5cc58d9c3089256c682ca2882b Mon Sep 17 00:00:00 2001
From: Simon Schrottner <simon.schrottner@dynatrace.com>
Date: Mon, 30 Mar 2026 16:05:52 +0200
Subject: [PATCH 3/3] test(semver): add per-scenario subtags for granular
 opt-out

Adds @semver-v-prefix, @semver-partial-version and @semver-build-metadata
subtags so SDK implementations can exclude individual edge-case scenarios
during their migration period (e.g. -t 'not @semver-v-prefix'), mirroring
the pattern used by @fractional-nested.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: Simon Schrottner <simon.schrottner@dynatrace.com>
---
 evaluator/gherkin/semver.feature | 6 +++---
 gherkin/targeting.feature        | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/evaluator/gherkin/semver.feature b/evaluator/gherkin/semver.feature
index be76454..6bb2c13 100644
--- a/evaluator/gherkin/semver.feature
+++ b/evaluator/gherkin/semver.feature
@@ -44,7 +44,7 @@ Feature: Evaluator semantic version operator
       | semver-invalid-version-flag  | not-a-version |
       | semver-invalid-operator-flag | 1.0.0         |
 
-  @semver-edge-cases
+  @semver-edge-cases @semver-v-prefix
   Scenario Outline: v-prefix handling
     Given an evaluator
     And a String-flag with key "semver-v-prefix-flag" and a fallback value "fallback"
@@ -57,7 +57,7 @@ Feature: Evaluator semantic version operator
       | v1.0.0  | match    |
       | 2.0.0   | no-match |
 
-  @semver-edge-cases
+  @semver-edge-cases @semver-partial-version
   Scenario Outline: partial version handling
     Given an evaluator
     And a String-flag with key "semver-partial-version-flag" and a fallback value "fallback"
@@ -70,7 +70,7 @@ Feature: Evaluator semantic version operator
       | 1.0.0   | match    |
       | 2.0.0   | no-match |
 
-  @semver-edge-cases
+  @semver-edge-cases @semver-build-metadata
   Scenario Outline: build metadata ignored in comparison
     Given an evaluator
     And a String-flag with key "semver-build-metadata-flag" and a fallback value "fallback"
diff --git a/gherkin/targeting.feature b/gherkin/targeting.feature
index 3b5d0a6..cd29f9d 100644
--- a/gherkin/targeting.feature
+++ b/gherkin/targeting.feature
@@ -240,7 +240,7 @@ Feature: Targeting rules
       | 3.1.0   | major |
       | 4.0.0   | none  |
 
-  @semver @semver-edge-cases
+  @semver @semver-edge-cases @semver-v-prefix
   Scenario Outline: sem_ver v-prefix handling
     Given a String-flag with key "semver-v-prefix-flag" and a default value "fallback"
     And a context containing a key "version", with type "String" and with value "<version>"
@@ -252,7 +252,7 @@ Feature: Targeting rules
       | v1.0.0  | match    |
       | 2.0.0   | no-match |
 
-  @semver @semver-edge-cases
+  @semver @semver-edge-cases @semver-partial-version
   Scenario Outline: sem_ver partial version handling
     Given a String-flag with key "semver-partial-version-flag" and a default value "fallback"
     And a context containing a key "version", with type "String" and with value "<version>"
@@ -264,7 +264,7 @@ Feature: Targeting rules
       | 1.0.0   | match    |
       | 2.0.0   | no-match |
 
-  @semver @semver-edge-cases
+  @semver @semver-edge-cases @semver-build-metadata
   Scenario Outline: sem_ver build metadata ignored
     Given a String-flag with key "semver-build-metadata-flag" and a default value "fallback"
     And a context containing a key "version", with type "String" and with value "<version>"