feat(form-builder): MergeStrategy enum methods + binding value objects (WS-6)

- FormFieldBindingMergeStrategy::nullWinnerBehaviour() and
  isValidForScalarTargets() encode the per-strategy null-winner matrix
  (RFC Q7) and the collection-only restriction (RFC V1).
- ResolvedBinding/BindingApplicationResult/BindingPassResult readonly
  DTOs for the binding pipeline. Construction-time validation for
  trust level. Apply-status derived from result aggregate.

Note: the existing enum is named FormFieldBindingMergeStrategy (not
MergeStrategy as the prompt sketched). Methods added to it directly.

Refs: RFC-WS-6.md §3 (Q4, Q7), §4 (V1)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-25 22:38:55 +02:00
parent 447511634d
commit b2e9ef8824
8 changed files with 463 additions and 0 deletions

View File

@@ -10,4 +10,31 @@ enum FormFieldBindingMergeStrategy: string
case Append = 'append';
case Replace = 'replace';
case FirstWriteWins = 'first_write_wins';
/**
* RFC-WS-6 §3 (Q7) what to do when the conflict-resolution winner
* has a null value. Returns one of:
* - 'write' write null to the target (intent: clear)
* - 'noop' leave the target untouched
* - 'conditional' write only when the target itself is null
*/
public function nullWinnerBehaviour(): string
{
return match ($this) {
self::Overwrite => 'write',
self::Append => 'noop',
self::Replace => 'noop',
self::FirstWriteWins => 'conditional',
};
}
/**
* RFC-WS-6 §4 (V1) Append is collection-only (idempotent retry only
* with set semantics; scalar-append demands fingerprinting which is
* an architectural smell).
*/
public function isValidForScalarTargets(): bool
{
return $this !== self::Append;
}
}