Repository navigation
Conversation
Add an opt-in capability for consumers that implement dependent flag evaluation, and verify its wire encoding alongside the existing rules capability. Environment: Datadog workspace Co-Authored-By: Codex GPT-6 <noreply@localhost>
Evaluate variant-key dependencies in authored order with depth-safe memoization and preserve successful-path exposure eligibility for SDKs. Environment: Datadog workspace Co-Authored-By: Codex GPT-6 <noreply@localhost>
Contributor
📚 Documentation Check Results📦
|
Contributor
🔒 Cargo Deny Results📦
|
BenchmarksComparisonBenchmark execution time: 2026-11-03 20:11:26 Comparing candidate commit 983b4b0 in PR branch Found 0 performance improvements and 6 performance regressions! Performance is the same for 8 metrics, 0 unstable metrics.
|
| cpu_model | git_commit_sha | git_commit_date | git_branch |
|---|---|---|---|
| Intel(R) Xeon(R) Platinum 8259CL CPU @ 2.50GHz | 983b4b0 | 1793735878 | helen/ffe-dependent-flags-evaluator |
| scenario | metric | min | mean ± sd | median ± mad | p75 | p95 | p99 | max | peak_to_median_ratio | skewness | kurtosis | cv | sem | runs | sample_size |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| dependent_flags/memoized_16_references | execution_time | 3.014µs | 3.026µs ± 0.004µs | 3.025µs ± 0.001µs | 3.027µs | 3.029µs | 3.039µs | 3.059µs | 1.13% | 4.750 | 38.802 | 0.12% | 0.000µs | 1 | 200 |
| scenario | metric | 95% CI mean | Shapiro-Wilk pvalue | Ljung-Box pvalue (lag=1) | Dip test pvalue |
|---|---|---|---|---|---|
| dependent_flags/memoized_16_references | execution_time | [3.025µs; 3.026µs] or [-0.017%; +0.017%] | None | None | None |
Group 2
| cpu_model | git_commit_sha | git_commit_date | git_branch |
|---|---|---|---|
| Intel(R) Xeon(R) Platinum 8259CL CPU @ 2.50GHz | 983b4b0 | 1793735878 | helen/ffe-dependent-flags-evaluator |
| scenario | metric | min | mean ± sd | median ± mad | p75 | p95 | p99 | max | peak_to_median_ratio | skewness | kurtosis | cv | sem | runs | sample_size |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| dependent_flags/legacy | execution_time | 113.370ns | 113.959ns ± 0.192ns | 113.965ns ± 0.111ns | 114.061ns | 114.220ns | 114.549ns | 114.684ns | 0.63% | 0.159 | 2.281 | 0.17% | 0.014ns | 1 | 200 |
| scenario | metric | 95% CI mean | Shapiro-Wilk pvalue | Ljung-Box pvalue (lag=1) | Dip test pvalue |
|---|---|---|---|---|---|
| dependent_flags/legacy | execution_time | [113.932ns; 113.985ns] or [-0.023%; +0.023%] | None | None | None |
Group 3
| cpu_model | git_commit_sha | git_commit_date | git_branch |
|---|---|---|---|
| Intel(R) Xeon(R) Platinum 8259CL CPU @ 2.50GHz | 983b4b0 | 1793735878 | helen/ffe-dependent-flags-evaluator |
| scenario | metric | min | mean ± sd | median ± mad | p75 | p95 | p99 | max | peak_to_median_ratio | skewness | kurtosis | cv | sem | runs | sample_size |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| dependent_flags/one_prerequisite | execution_time | 739.088ns | 742.316ns ± 1.820ns | 742.146ns ± 0.265ns | 742.408ns | 743.195ns | 745.512ns | 763.660ns | 2.90% | 9.122 | 98.592 | 0.24% | 0.129ns | 1 | 200 |
| scenario | metric | 95% CI mean | Shapiro-Wilk pvalue | Ljung-Box pvalue (lag=1) | Dip test pvalue |
|---|---|---|---|---|---|
| dependent_flags/one_prerequisite | execution_time | [742.064ns; 742.568ns] or [-0.034%; +0.034%] | None | None | None |
Group 4
| cpu_model | git_commit_sha | git_commit_date | git_branch |
|---|---|---|---|
| Intel(R) Xeon(R) Platinum 8259CL CPU @ 2.50GHz | 983b4b0 | 1793735878 | helen/ffe-dependent-flags-evaluator |
| scenario | metric | min | mean ± sd | median ± mad | p75 | p95 | p99 | max | peak_to_median_ratio | skewness | kurtosis | cv | sem | runs | sample_size |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| flagevaluation_evp/coalescer/scale/2500flags_500users_20fields | execution_time | 32.033ms | 32.183ms ± 0.057ms | 32.173ms ± 0.031ms | 32.205ms | 32.282ms | 32.335ms | 32.369ms | 0.61% | 0.603 | 1.610 | 0.18% | 0.008ms | 1 | 50 |
| flagevaluation_evp/coalescer/scale/2500flags_500users_20fields | throughput | 77235.302op/s | 77681.543op/s ± 137.967op/s | 77705.473op/s ± 75.272op/s | 77751.816op/s | 77855.522op/s | 77976.831op/s | 78043.780op/s | 0.44% | -0.586 | 1.591 | 0.18% | 19.512op/s | 1 | 50 |
| flagevaluation_evp/coalescer/stress/10flags_1000users_250fields | execution_time | 204.312ms | 205.233ms ± 1.274ms | 204.658ms ± 0.258ms | 205.016ms | 208.141ms | 208.217ms | 208.230ms | 1.75% | 1.745 | 1.275 | 0.61% | 0.255ms | 1 | 25 |
| flagevaluation_evp/coalescer/stress/10flags_1000users_250fields | throughput | 4802.385op/s | 4872.701op/s ± 29.939op/s | 4886.197op/s ± 6.158op/s | 4887.542op/s | 4893.320op/s | 4894.206op/s | 4894.473op/s | 0.17% | -1.741 | 1.265 | 0.60% | 5.988op/s | 1 | 25 |
| flagevaluation_evp/coalescer/typical/100flags_50users_10fields | execution_time | 690.698µs | 702.403µs ± 5.065µs | 702.272µs ± 3.674µs | 707.096µs | 709.992µs | 710.690µs | 711.666µs | 1.34% | -0.237 | -0.495 | 0.72% | 0.506µs | 1 | 100 |
| flagevaluation_evp/coalescer/typical/100flags_50users_10fields | throughput | 140515.295op/s | 142375.744op/s ± 1028.497op/s | 142394.877op/s ± 744.829op/s | 143024.705op/s | 144407.169op/s | 144761.028op/s | 144781.077op/s | 1.68% | 0.268 | -0.458 | 0.72% | 102.850op/s | 1 | 100 |
| scenario | metric | 95% CI mean | Shapiro-Wilk pvalue | Ljung-Box pvalue (lag=1) | Dip test pvalue |
|---|---|---|---|---|---|
| flagevaluation_evp/coalescer/scale/2500flags_500users_20fields | execution_time | [32.167ms; 32.199ms] or [-0.049%; +0.049%] | None | None | None |
| flagevaluation_evp/coalescer/scale/2500flags_500users_20fields | throughput | [77643.301op/s; 77719.785op/s] or [-0.049%; +0.049%] | None | None | None |
| flagevaluation_evp/coalescer/stress/10flags_1000users_250fields | execution_time | [204.733ms; 205.732ms] or [-0.243%; +0.243%] | None | None | None |
| flagevaluation_evp/coalescer/stress/10flags_1000users_250fields | throughput | [4860.965op/s; 4884.437op/s] or [-0.241%; +0.241%] | None | None | None |
| flagevaluation_evp/coalescer/typical/100flags_50users_10fields | execution_time | [701.410µs; 703.396µs] or [-0.141%; +0.141%] | None | None | None |
| flagevaluation_evp/coalescer/typical/100flags_50users_10fields | throughput | [142174.162op/s; 142577.326op/s] or [-0.142%; +0.142%] | None | None | None |
Group 5
| cpu_model | git_commit_sha | git_commit_date | git_branch |
|---|---|---|---|
| Intel(R) Xeon(R) Platinum 8259CL CPU @ 2.50GHz | 983b4b0 | 1793735878 | helen/ffe-dependent-flags-evaluator |
| scenario | metric | min | mean ± sd | median ± mad | p75 | p95 | p99 | max | peak_to_median_ratio | skewness | kurtosis | cv | sem | runs | sample_size |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| single_flag_killswitch/rules-based | execution_time | 199.281ns | 202.248ns ± 1.995ns | 201.912ns ± 1.511ns | 203.708ns | 205.661ns | 207.544ns | 209.307ns | 3.66% | 0.604 | 0.317 | 0.98% | 0.141ns | 1 | 200 |
| scenario | metric | 95% CI mean | Shapiro-Wilk pvalue | Ljung-Box pvalue (lag=1) | Dip test pvalue |
|---|---|---|---|---|---|
| single_flag_killswitch/rules-based | execution_time | [201.971ns; 202.524ns] or [-0.137%; +0.137%] | None | None | None |
Group 6
| cpu_model | git_commit_sha | git_commit_date | git_branch |
|---|---|---|---|
| Intel(R) Xeon(R) Platinum 8259CL CPU @ 2.50GHz | 983b4b0 | 1793735878 | helen/ffe-dependent-flags-evaluator |
| scenario | metric | min | mean ± sd | median ± mad | p75 | p95 | p99 | max | peak_to_median_ratio | skewness | kurtosis | cv | sem | runs | sample_size |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| sdk_test_data/rules-based | execution_time | 303.545µs | 310.013µs ± 11.974µs | 306.798µs ± 1.566µs | 309.356µs | 322.770µs | 355.692µs | 430.385µs | 40.28% | 6.618 | 55.386 | 3.85% | 0.847µs | 1 | 200 |
| scenario | metric | 95% CI mean | Shapiro-Wilk pvalue | Ljung-Box pvalue (lag=1) | Dip test pvalue |
|---|---|---|---|---|---|
| sdk_test_data/rules-based | execution_time | [308.353µs; 311.672µs] or [-0.535%; +0.535%] | None | None | None |
Group 7
| cpu_model | git_commit_sha | git_commit_date | git_branch |
|---|---|---|---|
| Intel(R) Xeon(R) Platinum 8259CL CPU @ 2.50GHz | 983b4b0 | 1793735878 | helen/ffe-dependent-flags-evaluator |
| scenario | metric | min | mean ± sd | median ± mad | p75 | p95 | p99 | max | peak_to_median_ratio | skewness | kurtosis | cv | sem | runs | sample_size |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| flagevaluation_evp/payloads/scale/2500flags_500users_20fields | execution_time | 34.941ms | 35.145ms ± 0.106ms | 35.153ms ± 0.067ms | 35.208ms | 35.321ms | 35.383ms | 35.416ms | 0.75% | 0.178 | -0.251 | 0.30% | 0.015ms | 1 | 50 |
| flagevaluation_evp/payloads/scale/2500flags_500users_20fields | throughput | 70588.585op/s | 71134.406op/s ± 213.488op/s | 71117.769op/s ± 134.901op/s | 71270.103op/s | 71459.080op/s | 71532.691op/s | 71550.134op/s | 0.61% | -0.163 | -0.267 | 0.30% | 30.192op/s | 1 | 50 |
| flagevaluation_evp/payloads/stress/10flags_1000users_250fields | execution_time | 194.603ms | 195.574ms ± 0.650ms | 195.386ms ± 0.483ms | 195.958ms | 196.583ms | 197.095ms | 197.254ms | 0.96% | 0.786 | -0.033 | 0.33% | 0.130ms | 1 | 25 |
| flagevaluation_evp/payloads/stress/10flags_1000users_250fields | throughput | 5069.614op/s | 5113.220op/s ± 16.957op/s | 5118.066op/s ± 12.679op/s | 5125.457op/s | 5132.272op/s | 5137.234op/s | 5138.680op/s | 0.40% | -0.773 | -0.063 | 0.32% | 3.391op/s | 1 | 25 |
| flagevaluation_evp/payloads/typical/100flags_50users_10fields | execution_time | 844.055µs | 845.843µs ± 0.649µs | 845.946µs ± 0.409µs | 846.252µs | 846.842µs | 847.171µs | 847.197µs | 0.15% | -0.320 | -0.141 | 0.08% | 0.065µs | 1 | 100 |
| flagevaluation_evp/payloads/typical/100flags_50users_10fields | throughput | 118036.342op/s | 118225.271op/s ± 90.793op/s | 118210.846op/s ± 57.114op/s | 118282.645op/s | 118395.318op/s | 118425.369op/s | 118475.692op/s | 0.22% | 0.324 | -0.139 | 0.08% | 9.079op/s | 1 | 100 |
| scenario | metric | 95% CI mean | Shapiro-Wilk pvalue | Ljung-Box pvalue (lag=1) | Dip test pvalue |
|---|---|---|---|---|---|
| flagevaluation_evp/payloads/scale/2500flags_500users_20fields | execution_time | [35.116ms; 35.174ms] or [-0.083%; +0.083%] | None | None | None |
| flagevaluation_evp/payloads/scale/2500flags_500users_20fields | throughput | [71075.232op/s; 71193.581op/s] or [-0.083%; +0.083%] | None | None | None |
| flagevaluation_evp/payloads/stress/10flags_1000users_250fields | execution_time | [195.319ms; 195.828ms] or [-0.130%; +0.130%] | None | None | None |
| flagevaluation_evp/payloads/stress/10flags_1000users_250fields | throughput | [5106.573op/s; 5119.867op/s] or [-0.130%; +0.130%] | None | None | None |
| flagevaluation_evp/payloads/typical/100flags_50users_10fields | execution_time | [845.716µs; 845.971µs] or [-0.015%; +0.015%] | None | None | None |
| flagevaluation_evp/payloads/typical/100flags_50users_10fields | throughput | [118207.476op/s; 118243.066op/s] or [-0.015%; +0.015%] | None | None | None |
Baseline
Baseline benchmark details
Group 1
| cpu_model | git_commit_sha | git_commit_date | git_branch |
|---|---|---|---|
| Intel(R) Xeon(R) Platinum 8259CL CPU @ 2.50GHz | 899c4cc | 1793721195 | main |
| scenario | metric | min | mean ± sd | median ± mad | p75 | p95 | p99 | max | peak_to_median_ratio | skewness | kurtosis | cv | sem | runs | sample_size |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| flagevaluation_evp/coalescer/scale/2500flags_500users_20fields | execution_time | 31.414ms | 31.560ms ± 0.068ms | 31.573ms ± 0.045ms | 31.603ms | 31.662ms | 31.681ms | 31.693ms | 0.38% | -0.300 | -0.657 | 0.21% | 0.010ms | 1 | 50 |
| flagevaluation_evp/coalescer/scale/2500flags_500users_20fields | throughput | 78882.287op/s | 79215.152op/s ± 171.549op/s | 79182.626op/s ± 113.308op/s | 79319.182op/s | 79512.470op/s | 79564.277op/s | 79582.342op/s | 0.50% | 0.309 | -0.654 | 0.21% | 24.261op/s | 1 | 50 |
| flagevaluation_evp/coalescer/stress/10flags_1000users_250fields | execution_time | 190.137ms | 190.873ms ± 0.954ms | 190.653ms ± 0.212ms | 190.841ms | 193.330ms | 193.937ms | 193.954ms | 1.73% | 2.688 | 6.088 | 0.49% | 0.191ms | 1 | 25 |
| flagevaluation_evp/coalescer/stress/10flags_1000users_250fields | throughput | 5155.856op/s | 5239.206op/s ± 25.835op/s | 5245.137op/s ± 5.815op/s | 5251.338op/s | 5258.018op/s | 5259.079op/s | 5259.378op/s | 0.27% | -2.675 | 6.043 | 0.48% | 5.167op/s | 1 | 25 |
| flagevaluation_evp/coalescer/typical/100flags_50users_10fields | execution_time | 688.541µs | 699.785µs ± 5.146µs | 697.795µs ± 2.125µs | 705.108µs | 708.100µs | 708.901µs | 709.209µs | 1.64% | 0.198 | -0.894 | 0.73% | 0.515µs | 1 | 100 |
| flagevaluation_evp/coalescer/typical/100flags_50users_10fields | throughput | 141002.118op/s | 142908.686op/s ± 1049.433op/s | 143308.649op/s ± 436.430op/s | 143571.160op/s | 144717.503op/s | 144875.005op/s | 145234.669op/s | 1.34% | -0.174 | -0.877 | 0.73% | 104.943op/s | 1 | 100 |
| scenario | metric | 95% CI mean | Shapiro-Wilk pvalue | Ljung-Box pvalue (lag=1) | Dip test pvalue |
|---|---|---|---|---|---|
| flagevaluation_evp/coalescer/scale/2500flags_500users_20fields | execution_time | [31.541ms; 31.579ms] or [-0.060%; +0.060%] | None | None | None |
| flagevaluation_evp/coalescer/scale/2500flags_500users_20fields | throughput | [79167.601op/s; 79262.702op/s] or [-0.060%; +0.060%] | None | None | None |
| flagevaluation_evp/coalescer/stress/10flags_1000users_250fields | execution_time | [190.499ms; 191.247ms] or [-0.196%; +0.196%] | None | None | None |
| flagevaluation_evp/coalescer/stress/10flags_1000users_250fields | throughput | [5229.078op/s; 5249.333op/s] or [-0.193%; +0.193%] | None | None | None |
| flagevaluation_evp/coalescer/typical/100flags_50users_10fields | execution_time | [698.776µs; 700.793µs] or [-0.144%; +0.144%] | None | None | None |
| flagevaluation_evp/coalescer/typical/100flags_50users_10fields | throughput | [142703.001op/s; 143114.371op/s] or [-0.144%; +0.144%] | None | None | None |
Group 2
| cpu_model | git_commit_sha | git_commit_date | git_branch |
|---|---|---|---|
| Intel(R) Xeon(R) Platinum 8259CL CPU @ 2.50GHz | 899c4cc | 1793721195 | main |
| scenario | metric | min | mean ± sd | median ± mad | p75 | p95 | p99 | max | peak_to_median_ratio | skewness | kurtosis | cv | sem | runs | sample_size |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| single_flag_killswitch/rules-based | execution_time | 162.650ns | 166.370ns ± 3.538ns | 165.588ns ± 2.175ns | 168.133ns | 172.683ns | 177.589ns | 186.532ns | 12.65% | 1.920 | 5.899 | 2.12% | 0.250ns | 1 | 200 |
| scenario | metric | 95% CI mean | Shapiro-Wilk pvalue | Ljung-Box pvalue (lag=1) | Dip test pvalue |
|---|---|---|---|---|---|
| single_flag_killswitch/rules-based | execution_time | [165.880ns; 166.860ns] or [-0.295%; +0.295%] | None | None | None |
Group 3
| cpu_model | git_commit_sha | git_commit_date | git_branch |
|---|---|---|---|
| Intel(R) Xeon(R) Platinum 8259CL CPU @ 2.50GHz | 899c4cc | 1793721195 | main |
| scenario | metric | min | mean ± sd | median ± mad | p75 | p95 | p99 | max | peak_to_median_ratio | skewness | kurtosis | cv | sem | runs | sample_size |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| sdk_test_data/rules-based | execution_time | 265.236µs | 271.363µs ± 12.525µs | 268.439µs ± 1.444µs | 270.500µs | 283.141µs | 319.992µs | 400.153µs | 49.07% | 7.006 | 60.594 | 4.60% | 0.886µs | 1 | 200 |
| scenario | metric | 95% CI mean | Shapiro-Wilk pvalue | Ljung-Box pvalue (lag=1) | Dip test pvalue |
|---|---|---|---|---|---|
| sdk_test_data/rules-based | execution_time | [269.627µs; 273.099µs] or [-0.640%; +0.640%] | None | None | None |
Group 4
| cpu_model | git_commit_sha | git_commit_date | git_branch |
|---|---|---|---|
| Intel(R) Xeon(R) Platinum 8259CL CPU @ 2.50GHz | 899c4cc | 1793721195 | main |
| scenario | metric | min | mean ± sd | median ± mad | p75 | p95 | p99 | max | peak_to_median_ratio | skewness | kurtosis | cv | sem | runs | sample_size |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| flagevaluation_evp/payloads/scale/2500flags_500users_20fields | execution_time | 34.609ms | 34.823ms ± 0.116ms | 34.807ms ± 0.081ms | 34.908ms | 35.005ms | 35.054ms | 35.078ms | 0.78% | 0.196 | -0.732 | 0.33% | 0.016ms | 1 | 50 |
| flagevaluation_evp/payloads/scale/2500flags_500users_20fields | throughput | 71269.738op/s | 71793.064op/s ± 238.551op/s | 71824.060op/s ± 167.889op/s | 71957.727op/s | 72151.793op/s | 72230.856op/s | 72235.091op/s | 0.57% | -0.184 | -0.737 | 0.33% | 33.736op/s | 1 | 50 |
| flagevaluation_evp/payloads/stress/10flags_1000users_250fields | execution_time | 182.012ms | 182.899ms ± 0.408ms | 182.993ms ± 0.232ms | 183.207ms | 183.520ms | 183.574ms | 183.578ms | 0.32% | -0.416 | -0.394 | 0.22% | 0.082ms | 1 | 25 |
| flagevaluation_evp/payloads/stress/10flags_1000users_250fields | throughput | 5447.271op/s | 5467.527op/s ± 12.208op/s | 5464.701op/s ± 6.914op/s | 5475.250op/s | 5489.115op/s | 5493.157op/s | 5494.157op/s | 0.54% | 0.426 | -0.387 | 0.22% | 2.442op/s | 1 | 25 |
| flagevaluation_evp/payloads/typical/100flags_50users_10fields | execution_time | 853.746µs | 855.817µs ± 1.029µs | 855.811µs ± 0.571µs | 856.375µs | 858.004µs | 858.184µs | 858.456µs | 0.31% | 0.351 | 0.082 | 0.12% | 0.103µs | 1 | 100 |
| flagevaluation_evp/payloads/typical/100flags_50users_10fields | throughput | 116488.219op/s | 116847.598op/s ± 140.399op/s | 116848.271op/s ± 77.984op/s | 116927.796op/s | 117075.384op/s | 117126.823op/s | 117130.826op/s | 0.24% | -0.344 | 0.076 | 0.12% | 14.040op/s | 1 | 100 |
| scenario | metric | 95% CI mean | Shapiro-Wilk pvalue | Ljung-Box pvalue (lag=1) | Dip test pvalue |
|---|---|---|---|---|---|
| flagevaluation_evp/payloads/scale/2500flags_500users_20fields | execution_time | [34.791ms; 34.855ms] or [-0.092%; +0.092%] | None | None | None |
| flagevaluation_evp/payloads/scale/2500flags_500users_20fields | throughput | [71726.943op/s; 71859.186op/s] or [-0.092%; +0.092%] | None | None | None |
| flagevaluation_evp/payloads/stress/10flags_1000users_250fields | execution_time | [182.739ms; 183.059ms] or [-0.087%; +0.087%] | None | None | None |
| flagevaluation_evp/payloads/stress/10flags_1000users_250fields | throughput | [5462.741op/s; 5472.312op/s] or [-0.088%; +0.088%] | None | None | None |
| flagevaluation_evp/payloads/typical/100flags_50users_10fields | execution_time | [855.615µs; 856.018µs] or [-0.024%; +0.024%] | None | None | None |
| flagevaluation_evp/payloads/typical/100flags_50users_10fields | throughput | [116820.080op/s; 116875.116op/s] or [-0.024%; +0.024%] | None | None | None |
Route flags without prerequisite conditions through the allocation-only evaluator, sharing validation and assignment construction with dependent evaluation. Environment: Datadog workspace Co-Authored-By: Codex GPT-6 <noreply@localhost>
Apply main’s removal of the obsolete Clippy allowance before merging main, preserving the dependent-flags benchmark. Environment: Datadog workspace Co-Authored-By: Codex GPT-6 <noreply@localhost>
Apply main’s removal of the obsolete Clippy allowance before merging main, preserving the dependent-flags benchmark. Environment: Datadog workspace Co-Authored-By: Codex GPT-6 <noreply@localhost>
hhan2024
marked this pull request as ready for review
November 2, 2026 15:22
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 1cf7834903
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
Contributor
FFE reviewer selectionReviewers: @typotter, @sameerank Why: Dependent Flags — The shared Rust FFE engine now evaluates prerequisite (flagEvaluation) conditions. Reviewers come from the matched pod. 🤖 Automated selection. Selection detailsInitiative: project / dependent-flags Why this match: The shared Rust FFE engine now evaluates prerequisite (flagEvaluation) conditions. It compares prerequisite variant keys with ONE_OF/NOT_ONE_OF and short-circuits. It handles missing, disabled, cyclic and over-depth prerequisites, enforces maxDependencyDepth with memoized dependency height, and parses prerequisite conditions in the UFC models and compiled config. This is the dependent-flags behavior that SDKs consume, and benchmarks and tests for dependent flags are included.
Additional review: openfeature-architecture — The change adds to the public evaluation contract that SDK providers consume. It exports a new eval_flag_with_trace API that returns EvaluationResult/EvaluationRecord with per-flag results and an exposure_eligible marker. It also adds public EvaluationError variants (DependencyEvaluationFailed, DependencyCycle, DependencyDepthExceeded) that providers must map to OpenFeature error and reason metadata. Coverage: @typotter. Evidence: libdd-ffe/src/rules_based/eval/eval_assignment.rs, libdd-ffe/src/rules_based/error.rs, libdd-ffe/src/rules_based/eval/mod.rs, libdd-ffe/src/rules_based/mod.rs The PR author was excluded. Existing reviewers and teams were preserved. Debug or fix a problemWorkflow run · Bits Code session
Evidence and run details✅ Complete — reviewer coverage verified. The workflow checked pending requests or submitted reviews on the evaluated head. Generated asynchronously by the FFE reviewer-routing workflow. Changed paths: Evaluated head: Registry revision: Pinned skill source: Instructions: workflow-injected snapshot (no plugin loaded) Instruction snapshot SHA-256: |
This was referenced Nov 3, 2026
typotter
requested changes
Nov 3, 2026
typotter
left a comment
typotter
left a comment
There was a problem hiding this comment.
🤖 Review from Codex working with Tyler Potter:
Requesting changes for the inline finding.
Validate dependency limits only when an authored condition reaches a prerequisite. Preserve independent evaluations and skipped branches, align condition validation and empty-list membership with JS, and record prerequisites rejected by depth. Cover lazy validation, null limits, trace ordering, and per-flag isolation. Environment: Datadog workspace Co-Authored-By: Codex GPT-6 <noreply@localhost>
aarsilv
added
the
crucible: reviewing
aarsilv
reviewed
Nov 4, 2026
| Some(value) => { | ||
| let depth = value | ||
| .as_f64() | ||
| .filter(|depth| depth.fract() == 0.0 && (0.0..=255.0).contains(depth)) |
There was a problem hiding this comment.
🤖 Comment from Claude working with Aaron Silverman:
[P2] A 255-edge dependency chain overflows small thread stacks. Please lower the accepted maximum, for example to 32.
The evaluation recurses on the caller's stack, several frames per dependency edge. I evaluated a 255-edge chain with maxDependencyDepth: 255 on threads with fixed stack sizes:
| Build | 128 KiB | 256 KiB | 512 KiB | 1 MiB |
|---|---|---|---|---|
| release | overflow | overflow | pass | pass |
| debug | overflow | overflow | overflow | overflow |
Each "overflow" run reported has overflowed its stack; Rust aborts the process on a stack overflow. Host threads with small stacks exist, so a valid configuration should not be able to crash the process.
Suggested change: accept 0..=32 here (and in the README). That cuts the maximum recursion depth by about eight times; I did not measure a 32-edge chain. Make the same change in the other evaluators, the fixtures and the design document, so all SDKs accept the same range.
aarsilv
reviewed
Nov 4, 2026
|
|
||
| /// One requested evaluation and the prerequisites it actually evaluated. | ||
| #[derive(Debug)] | ||
| pub struct EvaluationResult { |
There was a problem hiding this comment.
🤖 Comment from Claude working with Aaron Silverman:
[P3] Two small API points for the new trace types.
EvaluationResultandEvaluationRecordare public structs with public fields and no#[non_exhaustive]. Adding a field later is a semver-major change forlibdd-ffe. feat(ffe): support dependent flag evaluations dd-trace-php#4421 already buildsEvaluationResultwith a struct literal. Suggest#[non_exhaustive]on both, plus a constructor such asEvaluationResult::from_error(error).eval_flag_with_tracedoes not emit thelog::trace!records, so its direct callers (the C FFI in feat(ffe): expose prerequisite evaluations through C FFI #2791, and the Python and PHP bindings) lose those diagnostics.eval_flag_with_optionsalready callseval_flag_with_traceand logs afterwards, so suggest moving the logging intoeval_flag_with_trace(covering its early returns) and removing it fromeval_flag_with_options, so each evaluation logs once.
aarsilv
reviewed
Nov 4, 2026
| /// Records exclude the requested root flag and occur once per evaluated prerequisite. | ||
| /// An unsuccessful root has no eligible prerequisite exposures. SDKs must additionally | ||
| /// honor each assignment's `do_log`, consent, and exposure deduplication policy. | ||
| pub fn eval_flag_with_trace( |
There was a problem hiding this comment.
🤖 Comment from Claude working with Aaron Silverman:
Heads up: This PR conflicts with main, and the recorded checks at 983b4b0 contain no GitHub Actions test results. Several consumers also pin an older revision of this branch.
- The conflict is in this file:
mainnow has feat(ffe)!: parse split features and expose them over the FFI #2773, which addsfeatures: split.features.clone()to the assignment literal. Keep this PR's structure and add that field toAllocation::assignment. - At
983b4b0, the GitHub checks show only skipped rustfmt runs, the pending merge gate, and GitLab pipelines. I rancargo test -p libdd-ffe --features exposure-events,evaluation-metrics,flagevaluation-evplocally on983b4b0: 137 tests passed, plus 10 doc tests. - feat(ffe): expose prerequisite evaluations through C FFI #2791 is based on
1cf7834, not on this head. feat(openfeature): support dependent flags on Python delivery paths dd-trace-py#21346 pins1cf7834. The evaluator files in feat(ffe): support dependent flag evaluations dd-trace-php#4421's submodule pin are identical to1cf7834. Between1cf7834and this head, handling of an invalidmaxDependencyDepth(for example256no longer rejects the whole configuration) and of empty value lists changed. - Rebasing on
mainalso brings in fix: preserve session tokens on trace stats requests #2794 (session tokens on trace stats requests). DataDog/dd-trace-pymainalready ships that fix through v46.1.1, so consumers should not pin a revision without it.
Suggested order: rebase this PR and #2791 on main, merge both, and release. Then update the Python and PHP native pins to that release, and update Ruby to the published gem that contains both PRs.
aarsilv
reviewed
Nov 4, 2026
| .any(|value| value.as_ref() == dependency.assignment.variation_key.as_str()) | ||
| == *expected_membership; | ||
| if matched { | ||
| exposures.insert(key.clone()); |
There was a problem hiding this comment.
🤖 Comment from Claude working with Aaron Silverman:
[P1] Proposed exposure rule change, to follow the worked example in the dependent-flags design: a prerequisite whose own comparison rejects the rule should remain eligible for an exposure.
This block adds a prerequisite to exposures only when its condition matches. The design's example uses a rule that requires both a user attribute (country) and a prerequisite flag's value. For a user who matches the attribute but whose prerequisite evaluates to the other variant, the root falls back, and the example lists both the root and the prerequisite for exposure handling (subject to the usual logging rules and deduplication). The design's numbered rule about rejected rules can be read more broadly, so the design is ambiguous; we would like to follow the example.
Suggested evaluator change: when a FlagEvaluation condition is the condition that rejects the rule, keep that key (and dependency.exposures) in a flag-level "influencing" set, and mark those records exposure_eligible when the root succeeds. Rules rejected by another condition, and root failures, keep today's behavior.
The shared fixture cases dependent-one-of-miss and dependent-not-one-of-hit in ffe-system-test-data need the same change, and so do the other evaluators.
aarsilv
reviewed
Nov 4, 2026
| // Copyright 2026-Present Datadog, Inc. https://www.datadoghq.com/ | ||
| // SPDX-License-Identifier: Apache-2.0 | ||
|
|
||
| use super::eval_assignment::*; |
There was a problem hiding this comment.
🤖 Comment from Claude working with Aaron Silverman:
[P2] This PR does not run the shared dependent-flags cases from ffe-system-test-data, so no checked-in shared case checks this implementation's dependency results or telemetry.
- The fixture pin here (
libdd-ffe-test-suite/ffe-system-test-dataat0781ce2) predatesevaluation-suites/dependent-flags/. [FFL-1695] test: add variant-key dependent flag conformance fixtures ffe-system-test-data#45 added that suite, and [FFL-1795] Add inapplicable dependent exposure fixture ffe-system-test-data#57, [FFL-1795] Validate rejected dependency exposure not logged ffe-system-test-data#58 and test: cover unassigned prerequisite failure ffe-system-test-data#60 extended it. feat: add evaluation case applicability controls ffe-system-test-data#56 added the case applicability controls. The reviewed fixture revision isb57eac6onmain. libdd-ffe-test-suite/tests/canonical_fixtures.rsreads only the rootufc-config.jsonandevaluation-cases/, and it callsget_assignment, so it cannot see trace records.
Suggested change: bump the fixtures to b57eac6 and add a runner for evaluation-suites/dependent-flags (or, more generally, every suite directory). Assert result and, where present, expectations.exposures and expectations.evaluationEvents (including _count and noUnmatchedEvents). Assert the case count (14 today), so the runner cannot pass with zero cases. I wrote a runner for that one suite and ran it: with the fixtures at b57eac6, all 14 cases pass at 983b4b0, and the core canonical test still passes. If every record is marked exposure_eligible, the runner fails.
Runner for the dependent-flags suite (tested)
diff --git a/libdd-ffe-test-suite/tests/canonical_fixtures.rs b/libdd-ffe-test-suite/tests/canonical_fixtures.rs
index 8d7c8b69d..d15044704 100644
--- a/libdd-ffe-test-suite/tests/canonical_fixtures.rs
+++ b/libdd-ffe-test-suite/tests/canonical_fixtures.rs
@@ -244,3 +244,150 @@ fn error_code_from_error(err: &EvaluationError) -> Option<&'static str> {
_ => Some("GENERAL"),
}
}
+
+#[derive(Debug, Deserialize)]
+#[serde(rename_all = "camelCase")]
+struct SuiteCase {
+ flag: String,
+ variation_type: FlagType,
+ default_value: serde_json::Value,
+ targeting_key: Option<Str>,
+ #[serde(default)]
+ attributes: HashMap<Str, serde_json::Value>,
+ result: TestResult,
+ expectations: Option<serde_json::Value>,
+}
+
+/// Removes one actual event that matches every field the matcher states.
+fn take_match(actual: &mut Vec<serde_json::Value>, matcher: &serde_json::Value) -> bool {
+ let fields: Vec<_> = matcher
+ .as_object()
+ .unwrap()
+ .iter()
+ .filter(|(key, _)| !key.starts_with('_'))
+ .collect();
+ let Some(index) = actual.iter().position(|event| {
+ fields
+ .iter()
+ .all(|(key, value)| event.get(key.as_str()) == Some(value))
+ }) else {
+ return false;
+ };
+ actual.remove(index);
+ true
+}
+
+fn assert_events(
+ kind: &str,
+ flag: &str,
+ mut actual: Vec<serde_json::Value>,
+ expectations: &serde_json::Value,
+) {
+ for matcher in expectations[kind].as_array().cloned().unwrap_or_default() {
+ let count = matcher
+ .get("_count")
+ .and_then(|count| count.as_u64())
+ .unwrap_or(1);
+ for _ in 0..count {
+ assert!(
+ take_match(&mut actual, &matcher),
+ "{flag}: missing {kind} {matcher}; left {actual:?}"
+ );
+ }
+ }
+ if expectations["noUnmatchedEvents"] == serde_json::Value::Bool(true) {
+ assert!(actual.is_empty(), "{flag}: unexpected {kind} {actual:?}");
+ }
+}
+
+#[test]
+#[cfg_attr(miri, ignore)]
+fn evaluates_dependent_flags_suite() {
+ let suite = fixture_root().join("evaluation-suites/dependent-flags");
+ let config = Configuration::from_server_response(
+ UniversalFlagConfig::from_json(fs::read(suite.join("ufc-config.json")).unwrap()).unwrap(),
+ );
+ let cases: Vec<SuiteCase> =
+ serde_json::from_slice(&fs::read(suite.join("cases/dependent-flags.json")).unwrap())
+ .unwrap();
+ assert_eq!(cases.len(), 14);
+ for case in cases {
+ let attributes = case
+ .attributes
+ .into_iter()
+ .map(|(key, value)| (key, serde_json::from_value::<Attribute>(value).unwrap()))
+ .collect();
+ let subject = EvaluationContext::new(case.targeting_key, Arc::new(attributes));
+ let trace = config.eval_flag_with_trace(
+ &case.flag,
+ &subject,
+ case.variation_type.into(),
+ Utc::now(),
+ EvaluationOptions::default(),
+ );
+ let (value, reason, code) = match &trace.result {
+ Ok(assignment) => (
+ assignment.value.variation_value(),
+ reason_from_assignment(assignment.reason),
+ None,
+ ),
+ Err(err) => (
+ case.default_value.clone(),
+ reason_from_error(err),
+ error_code_from_error(err),
+ ),
+ };
+ assert_eq!(value, case.result.value, "{}", case.flag);
+ if let Some(expected) = case.result.reason.as_deref() {
+ assert_eq!(reason, expected, "{}", case.flag);
+ }
+ if let Some(expected) = case.result.error_code.as_deref() {
+ assert_eq!(code, Some(expected), "{}", case.flag);
+ }
+ let Some(expectations) = case.expectations else {
+ continue;
+ };
+ // This runner reports an unassigned or disabled prerequisite record as GENERAL, as the no-assignment case expects.
+ let mut events: Vec<serde_json::Value> = trace
+ .evaluations
+ .iter()
+ .map(|record| {
+ let code = match &record.result {
+ Ok(_) => None,
+ Err(EvaluationError::FlagDisabled | EvaluationError::DefaultAllocationNull) => {
+ Some("GENERAL")
+ }
+ Err(err) => error_code_from_error(err),
+ };
+ serde_json::json!({"flag": record.flag_key.as_str(), "errorCode": code})
+ })
+ .collect();
+ events.push(serde_json::json!({"flag": case.flag, "errorCode": code}));
+ assert_events("evaluationEvents", &case.flag, events, &expectations);
+
+ let mut exposures: Vec<serde_json::Value> = trace
+ .evaluations
+ .iter()
+ .filter_map(|record| match &record.result {
+ Ok(assignment) if record.exposure_eligible && assignment.do_log => {
+ Some(serde_json::json!({
+ "flag": record.flag_key.as_str(),
+ "allocation": assignment.allocation_key.as_str(),
+ "variant": assignment.variation_key.as_str(),
+ }))
+ }
+ _ => None,
+ })
+ .collect();
+ if let Ok(assignment) = &trace.result {
+ if assignment.do_log {
+ exposures.push(serde_json::json!({
+ "flag": case.flag,
+ "allocation": assignment.allocation_key.as_str(),
+ "variant": assignment.variation_key.as_str(),
+ }));
+ }
+ }
+ assert_events("exposures", &case.flag, exposures, &expectations);
+ }
+}
aarsilv
reviewed
Nov 4, 2026
| if depth + result.height > limit { | ||
| return Err(EvaluationError::DependencyDepthExceeded); | ||
| } | ||
| return Ok(result.clone()); |
There was a problem hiding this comment.
🤖 Comment from Claude working with Aaron Silverman:
[P2] No test reuses a memoized prerequisite that has its own successful prerequisites, so a regression in this line passes all existing dependent-flag tests.
I changed this line to drop the nested exposures on a memo hit: return Ok(EvaluatedFlag { exposures: HashSet::new(), ..result.clone() });. All 27 dependent-flag tests still passed. The existing successful memo-reuse tests reuse leaf prerequisites, and two shared fixture cases (reuse across allocations, and a transitive success followed by a root rejection) have no exact Rust equivalent.
Suggested tests (tested)
All three pass on 983b4b0. memoized_transitive_prerequisite_keeps_nested_exposures_when_reused fails with the mutation above.
diff --git a/libdd-ffe/src/rules_based/eval/dependent_flags_tests.rs b/libdd-ffe/src/rules_based/eval/dependent_flags_tests.rs
index 23fc808ad..bebd00390 100644
--- a/libdd-ffe/src/rules_based/eval/dependent_flags_tests.rs
+++ b/libdd-ffe/src/rules_based/eval/dependent_flags_tests.rs
@@ -687,3 +687,52 @@ fn independent_flags_ignore_unrelated_dependency_graphs() {
assert_eq!(result.result.unwrap().variation_key.as_str(), "on");
assert!(result.evaluations.is_empty());
}
+
+#[test]
+fn memoized_transitive_prerequisite_keeps_nested_exposures_when_reused() {
+ let mut root = flag(vec![]);
+ root["allocations"][0]["rules"] = json!([
+ {"conditions": [dependency("parent"), fails()]},
+ {"conditions": [dependency("parent")]}
+ ]);
+ let r = eval(wire(
+ json!({"root": root, "parent": flag(vec![dependency("leaf")]), "leaf": flag(vec![])}),
+ ));
+ assert_eq!(r.result.unwrap().variation_key.as_str(), "on");
+ assert_eq!(
+ r.evaluations
+ .iter()
+ .map(|e| e.flag_key.as_str())
+ .collect::<Vec<_>>(),
+ ["leaf", "parent"]
+ );
+ assert!(r.evaluations.iter().all(|e| e.exposure_eligible));
+}
+
+#[test]
+fn transitive_success_then_root_rule_rejection_exposes_nothing() {
+ let r = eval(wire(
+ json!({"root": flag(vec![dependency("parent"), fails()]),
+ "parent": flag(vec![dependency("leaf")]), "leaf": flag(vec![])}),
+ ));
+ assert_eq!(r.result.unwrap().variation_key.as_str(), "off");
+ assert_eq!(r.evaluations.len(), 2);
+ assert!(
+ r.evaluations
+ .iter()
+ .all(|e| e.result.is_ok() && !e.exposure_eligible)
+ );
+}
+
+#[test]
+fn prerequisite_first_reached_in_rejected_allocation_is_exposed_once_by_later_allocation() {
+ let mut root = flag(vec![dependency("parent"), fails()]);
+ root["allocations"]
+ .as_array_mut()
+ .unwrap()
+ .insert(1, allocation(vec![dependency("parent")], "on"));
+ let r = eval(wire(json!({"root": root, "parent": flag(vec![])})));
+ assert_eq!(r.result.unwrap().variation_key.as_str(), "on");
+ assert_eq!(r.evaluations.len(), 1);
+ assert!(r.evaluations[0].exposure_eligible);
+}
aarsilv
reviewed
Nov 4, 2026
| marked `exposure_eligible` belong to the root's successful rule/split path; a failed root has | ||
| no eligible prerequisite exposures. SDKs must | ||
| also apply each assignment's `do_log`, consent, and ordinary exposure deduplication policy. | ||
| The trace does not emit telemetry itself. SDKs should advertise dependent-flag support only |
There was a problem hiding this comment.
🤖 Comment from Claude working with Aaron Silverman:
Reminder: release order for the dependent-flags stack.
- Rebase this PR and feat(ffe): expose prerequisite evaluations through C FFI #2791 on
main, merge, and release libdatadog. - Update the native pins in feat(openfeature): support dependent flags on Python delivery paths dd-trace-py#21346 and feat(ffe): support dependent flag evaluations dd-trace-php#4421 to that release, and update feat(open_feature): support dependent flag evaluations dd-trace-rb#6613 to the published libdatadog gem that contains both PRs.
- Server-side capability gating must be live before any SDK advertises
dependent-flag-variant-key-v1.
This was referenced Nov 4, 2026
aarsilv
reviewed
Nov 5, 2026
|
|
||
| #[derive(Debug, Clone, PartialEq, Serialize, Deserialize)] | ||
| #[serde(deny_unknown_fields)] | ||
| pub(crate) struct FlagEvaluationWire { |
There was a problem hiding this comment.
🤖 Comment from Claude working with Aaron Silverman:
[P1] An unknown key inside flagEvaluation makes the flag that contains it fail. #[serde(deny_unknown_fields)] on FlagEvaluationWire rejects any key other than key, so a future field such as {"key": "beta", "property": "variant"} makes the flag fail and return the caller default. dd-trace-py and dd-trace-rb inherit this through libdd-ffe. Other flags still work, unless their evaluation reaches the failing flag as a prerequisite.
We want UFC parsing to tolerate newly added fields. We made the same request for the edge evaluator in ddoghq/dd-source#155394. The dependent-flags design leaves evaluating other prerequisite properties, such as enablement state and error codes, open as future extensions.
Bench result (local merged SDK builds, with the ffe-dogfooding staging UFC plus synthetic flags): the scenario added unknown keys inside each flagEvaluation, on each dependent condition, and in evaluatorParams. Go, Node.js, Java, .NET, Python and Ruby returned errors for every tested dependent flag, because each one rejects the extra flagEvaluation key. PHP, whose libdatadog branch has no deny_unknown_fields on FlagEvaluationWire, returned the expected values.
Suggested change: read key, ignore other keys, and keep rejecting a missing or empty key (remove deny_unknown_fields from FlagEvaluationWire, and change the extra-key case in invalid_dependency_conditions_are_isolated_to_the_containing_flag to expect acceptance). If strict parsing is intended instead, the server must keep new fields away from older clients, for example through a new capability version. Either way, please add a shared case with an extra flagEvaluation key to the ffe-system-test-data dependent-flags suite, so that all SDKs agree.
Contributor
Author
There was a problem hiding this comment.
going to make this change. system test to ensure this behavior added in ffe-system-test-data #71: and system-tests #8378
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What does this PR do?
This PR is the shared rust engine equivalent of the core evaluation work in DataDog/openfeature-js-client#414 and implements the same main behavior:
Evaluate
flagEvaluationconditions by comparing prerequisite variant keys withONE_OF/NOT_ONE_OF, preserving authored order and short-circuiting. A mismatch rejects the rule; a reached missing, disabled, malformed, unassigned, cyclic, or over-depth prerequisite fails the root evaluation and preserves the underlying cause.Dependency conditions accept empty string arrays and require a key-only
flagEvaluationreference with noattributeselector. Flags without prerequisite conditions retain an allocation-only fast path; validation and assignment construction are shared with the dependency path.Each invocation shares its configuration, context, timestamp, and experimentation opt-out policy. Memoized results retain dependency height, including rejected branches, so reuse cannot bypass
evaluatorParams.maxDependencyDepth(default 10; explicit 0–255). The raw depth setting is retained at ingestion and validated only when a dependency condition executes. Invalid values, including explicitnull, fail that evaluation withConfigurationParseError; independent flags and skipped dependency branches remain usable.Motivation
SDKs need prerequisite evaluation and the information required to report it correctly before advertising dependent-flag support. The new
eval_flag_with_traceAPI returns unique prerequisite results, including errors and prerequisites rejected by the depth guard, and marks only the final successful rule/split path as eligible for exposures. SDKs still applydo_log, privacy, and deduplication policies; existing evaluation APIs remain available.Additional notes
Stacked on #2745 for the native RC capability enum. Neither PR automatically opts consumers in. Python integration must consume the new API and explicitly activate capability reporting; a native library release remains separate from this PR.
Validation