feat: Add the override marker to the model, evaluator, and reason

[kinyoklion]

Summary

This PR is stacked on #449 so that the flag overrides series applies in order. It does not use that PR's code.

Flag overrides, as defined by the OVERRIDE specification, need three pieces below the store: a marker on the flag and segment model that says a definition came from the override store, evaluator marking that follows every definition an evaluation reads, and an indicator on the evaluation reason that reports the marking to callers. This change adds those three pieces. Nothing sets the marker yet, so the SDK behaves exactly as before. The override store, the overlay, and the data system wiring follow in the next PR.

The model classes FeatureFlag and Segment carry the marker as an attribute that is never serialized, because as_json returns the flag data hash. as_override returns a marked shallow copy and leaves the original unchanged. Only the SDK components that manage override entries will set it.

The evaluator marks an evaluation as override-affected when the evaluated flag, a prerequisite flag at any depth, or a segment read during clause matching carries the marker. A segment counts when it is read, so a segment that does not match, or one read through a negated clause, still marks the evaluation. The marking propagates upward only. A prerequisite's own record reflects the definitions its own subtree read, so a plain prerequisite inside a marked evaluation is recorded as usual, and a prerequisite of an overridden flag is not marked by its parent. An error result is marked when a marked definition was read before the failure, including a failure raised while a prerequisite was being evaluated. An evaluation that reads no marked definition keeps the shared precomputed detail instances.

EvaluationReason#override_affected carries the indicator, following the inExperiment and bigSegmentsStatus precedents. It is written to JSON as overrideAffected only when true, so the wire format of ordinary evaluations is unchanged. with_override_affected returns the same instance when nothing changes, and with_big_segments_status keeps the indicator.

Verification: specs for the model marker (default, copy, original unchanged, not serialized), the reason indicator (default, JSON when true and when false, [], equality, interaction with the big segments status), and the evaluator marking rules (direct, prerequisite at any depth, upward-only propagation, unaffected prerequisite record, segment read with and without a match, negated clause, nested segment, unresolved definition, prerequisite failure, malformed override, error raised during a prerequisite evaluation, big segments status kept). Full suite and RuboCop are clean. Each new spec was checked against a deliberate defect in the code it covers.

The existing FDv1 and FDv2 file data sources keep their current behavior. This series does not change them; the override feature is additive.

SDK-3249

---

Note

Overview
Adds experimental flag-override plumbing so evaluations can report when override-store definitions influenced the result, without wiring the override store yet (nothing calls as_override in production code, so default behavior stays the same).

Model: FeatureFlag and Segment get a non-serialized override marker via override? and as_override (shallow copy).

Evaluator: Tracks override_affected on state and EvalResult, sets it when the evaluated flag, any prerequisite subtree, or any segment read during matching is marked; prerequisite records carry their own subtree marking with upward-only propagation. Unaffected evaluations still reuse shared precomputed EvaluationDetail instances.

Reason: EvaluationReason#override_affected and with_override_affected; JSON adds overrideAffected only when true.

Specs cover marker serialization, reason JSON/equality, and evaluator propagation edge cases (negated segments, errors, big segments).

^{Reviewed by Cursor Bugbot for commit ed8fccf. Bugbot is set up for automated code reviews on this repo. Configure here.}

[kinyoklion]

bugbot review

[cursor]

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit ed8fccf. Configure here.}