feat: add assignment_origin to ResolvedFlag (#472)

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: nicklasl

confidence-resolver/protos/confidence/flags/resolver/v1/api.proto

@@ -182,4 +182,7 @@ message ResolvedFlag {
 
   // Determines whether the flag should be applied in the clients
  bool should_apply = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // The origin of the assignment, e.g. the rule name.
+  string assignment_origin = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
 }

confidence-resolver/src/lib.rs

@@ -1707,6 +1707,7 @@ impl<'a> TryFrom<&ResolvedValue<'a>> for flags_resolver::ResolvedFlag {
             flag: value.flag.name.clone(),
             reason: value.inner.reason,
             should_apply: value.should_apply(),
+            assignment_origin: value.inner.rule.clone(),
             ..Default::default()
         };
 

confidence-resolver/src/resolver_spec_tests.rs

@@ -132,6 +132,7 @@ struct SpecResolvedFlag {
     value: Option<serde_json::Value>,
     should_apply: Option<bool>,
     assignment_id: Option<String>,
+    assignment_origin: Option<String>,
 }
 
 // ---------------------------------------------------------------------------
@@ -461,6 +462,15 @@ fn run_spec_test(state: &ResolverState, test_case: &SpecTestCase) {
             );
         }
 
+        // assignmentOrigin assertion
+        if let Some(expected_origin) = &expected_flag.assignment_origin {
+            assert_eq!(
+                &actual.assignment_origin, expected_origin,
+                "[{}] assignmentOrigin mismatch for flag '{}'",
+                test_case.name, expected_flag.flag,
+            );
+        }
+
         // assignmentId assertion (from resolve token)
         if let Some(expected_assignment_id) = &expected_flag.assignment_id {
             let token = resolver

confidence-resolver/test-payloads/resolver-spec/tests.json

@@ -4114,5 +4114,28 @@
         "expectError": null
       }
     }
+  },
+  {
+    "name": "assignment_origin_is_matched_rule_name",
+    "resolveRequest": {
+      "flags": ["flags/simple-flag"],
+      "evaluationContext": { "targeting_key": "user1", "country": "SE" },
+      "clientSecret": "test-secret"
+    },
+    "expectedResult": {
+      "general": {
+        "resolvedFlags": [
+          {
+            "flag": "flags/simple-flag",
+            "reason": "RESOLVE_REASON_MATCH",
+            "variant": "on",
+            "value": { "enabled": true },
+            "shouldApply": true,
+            "assignmentOrigin": "flags/simple-flag/rules/rule1"
+          }
+        ],
+        "expectError": null
+      }
+    }
   }
 ]

openfeature-provider/go/confidence/internal/local_resolver/assets/confidence_resolver.wasm

@@ -77,6 +77,7 @@ describe.each([
       flagMetadata: {},
       value: 3.6,
       shouldApply: true,
+      assignmentOrigin: 'flags/web-sdk-e2e-flag/rules/zphggscnfdpvcp4jy5ui',
     };
 
     expect(await client.getNumberDetails('web-sdk-e2e-flag.obj.double', 1, ctx)).toEqual(expectedObject);

openfeature-provider/go/confidence/internal/proto/resolver/api.pb.go

@@ -277,6 +277,7 @@ describe('remote materialization for sticky assignments', () => {
               value: { enabled: true },
               reason: RESOLVE_REASON_MATCH,
               shouldApply: true,
+              assignmentOrigin: 'flags/test-flag/rules/rule1',
             },
           ],
           resolveToken: new Uint8Array(),
@@ -317,6 +318,7 @@ describe('remote materialization for sticky assignments', () => {
               value: { enabled: true },
               reason: RESOLVE_REASON_MATCH,
               shouldApply: true,
+              assignmentOrigin: 'flags/test-flag/rules/rule1',
             },
           ],
           resolveToken: new Uint8Array(),
@@ -362,6 +364,7 @@ describe('remote materialization for sticky assignments', () => {
               value: { color: 'blue', size: 10 },
               reason: ResolveReason.RESOLVE_REASON_MATCH,
               shouldApply: true,
+              assignmentOrigin: 'flags/my-flag/rules/rule1',
             },
           ],
           resolveToken: new Uint8Array(),
@@ -405,6 +408,7 @@ describe('remote materialization for sticky assignments', () => {
               value: { ok: true },
               reason: ResolveReason.RESOLVE_REASON_MATCH,
               shouldApply: true,
+              assignmentOrigin: 'flags/test-flag/rules/rule1',
             },
           ],
           resolveToken: new Uint8Array(),
@@ -443,6 +447,7 @@ describe('remote materialization for sticky assignments', () => {
               value: { ok: true },
               reason: ResolveReason.RESOLVE_REASON_MATCH,
               shouldApply: true,
+              assignmentOrigin: 'flags/test-flag/rules/rule1',
             },
           ],
           resolveToken: new Uint8Array(),
@@ -479,6 +484,7 @@ describe('SDK telemetry', () => {
               value: { enabled: true },
               reason: RESOLVE_REASON_MATCH,
               shouldApply: true,
+              assignmentOrigin: 'flags/test-flag/rules/rule1',
             },
           ],
           resolveToken: new Uint8Array(),
@@ -522,6 +528,7 @@ describe('registerResolve telemetry', () => {
               value: { enabled: true },
               reason: RESOLVE_REASON_MATCH,
               shouldApply: true,
+              assignmentOrigin: 'flags/test-flag/rules/rule1',
             },
           ],
           resolveToken: new Uint8Array(),
@@ -581,6 +588,7 @@ describe('registerResolve telemetry', () => {
               value: { enabled: 'not-a-boolean' },
               reason: RESOLVE_REASON_MATCH,
               shouldApply: true,
+              assignmentOrigin: 'flags/test-flag/rules/rule1',
             },
           ],
           resolveToken: new Uint8Array(),

openfeature-provider/js/src/ConfidenceServerProviderLocal.e2e.test.ts

@@ -25,6 +25,7 @@ describe('FlagBundle', () => {
             value: { enabled: true },
             reason: ResolveReason.RESOLVE_REASON_MATCH,
             shouldApply: true,
+            assignmentOrigin: '',
           },
         ],
       });
@@ -99,6 +100,7 @@ describe('FlagBundle', () => {
             value: { key: 'value' },
             reason: ResolveReason.RESOLVE_REASON_MATCH,
             shouldApply: true,
+            assignmentOrigin: '',
           },
         ],
       });
@@ -118,6 +120,7 @@ describe('FlagBundle', () => {
             value: undefined,
             reason: ResolveReason.RESOLVE_REASON_NO_SEGMENT_MATCH,
             shouldApply: false,
+            assignmentOrigin: '',
           },
         ],
       });
@@ -136,13 +139,15 @@ describe('FlagBundle', () => {
             value: { x: 1 },
             reason: ResolveReason.RESOLVE_REASON_MATCH,
             shouldApply: true,
+            assignmentOrigin: '',
           },
           {
             flag: 'flags/apply-false',
             variant: 'v1',
             value: { x: 2 },
             reason: ResolveReason.RESOLVE_REASON_MATCH,
             shouldApply: false,
+            assignmentOrigin: '',
           },
         ],
       });
@@ -200,6 +205,7 @@ describe('FlagBundle', () => {
             value: { config: { enabled: true, limit: 10 } },
             reason: ResolveReason.RESOLVE_REASON_MATCH,
             shouldApply: true,
+            assignmentOrigin: '',
           },
         ],
       });

openfeature-provider/js/src/ConfidenceServerProviderLocal.test.ts

@@ -23,13 +23,14 @@ export const decodeToken: (base64: string) => Uint8Array = bytesFromBase64;
 
 export function create({ resolveId, resolveToken, resolvedFlags }: ResolveFlagsResponse): FlagBundle {
   const flags = Object.fromEntries(
-    resolvedFlags.map(({ flag, reason, variant, value, shouldApply }) => {
+    resolvedFlags.map(({ flag, reason, variant, value, shouldApply, assignmentOrigin }) => {
       const name = flag.slice(FLAG_PREFIX.length);
       const details: ResolutionDetails<FlagObject | null> = {
         reason: convertReason(reason),
         variant,
         value: value ?? null,
         shouldApply,
+        assignmentOrigin,
       };
       return [name, details];
     }),