Skip to content
This repository was archived by the owner on Apr 14, 2026. It is now read-only.

Refactor name collision resolution to strategy-based loop#10

Merged
mromaszewicz merged 1 commit intomainfrom
feat/strategy-based-collision-resolution
Feb 8, 2026
Merged

Refactor name collision resolution to strategy-based loop#10
mromaszewicz merged 1 commit intomainfrom
feat/strategy-based-collision-resolution

Conversation

@mromaszewicz
Copy link
Copy Markdown
Member

Replace the iteration-number-dependent branching in resolveCollisions with a clean, uniform loop over an ordered list of named resolution strategies. The old code used iteration 0 for context suffix, iterations 1-8 for disambiguateName (which itself tried 4 strategies sequentially), and iteration 9 for numeric fallback.

The new design introduces two function types (collisionGroupStrategy and disambiguationStrategy) and an ordered strategy list. Each iteration applies one strategy to all conflicting buckets, then re-buckets. If a strategy makes no progress, the next one is tried.

Strategies extracted into standalone functions:

  • strategyContextSuffix (from resolveWithContextSuffix)
  • strategyPerSchemaDisambiguate (wraps 4 sub-strategies from disambiguateName)
  • strategyNumericFallback (last-resort safety net)
  • tryContentTypeSuffix, tryStatusCodeSuffix, tryParamIndexSuffix, tryCompositionTypeSuffix (from disambiguateName)

Also moves all collision resolution code into its own file (resolve_collisions.go) for better separation of concerns.

Behavioral equivalence verified: go generate produces identical output, all tests pass.

Replace the iteration-number-dependent branching in resolveCollisions
with a clean, uniform loop over an ordered list of named resolution
strategies. The old code used iteration 0 for context suffix, iterations
1-8 for disambiguateName (which itself tried 4 strategies sequentially),
and iteration 9 for numeric fallback.

The new design introduces two function types (collisionGroupStrategy and
disambiguationStrategy) and an ordered strategy list. Each iteration
applies one strategy to all conflicting buckets, then re-buckets. If a
strategy makes no progress, the next one is tried.

Strategies extracted into standalone functions:
- strategyContextSuffix (from resolveWithContextSuffix)
- strategyPerSchemaDisambiguate (wraps 4 sub-strategies from disambiguateName)
- strategyNumericFallback (last-resort safety net)
- tryContentTypeSuffix, tryStatusCodeSuffix, tryParamIndexSuffix,
  tryCompositionTypeSuffix (from disambiguateName)

Also moves all collision resolution code into its own file
(resolve_collisions.go) for better separation of concerns.

Behavioral equivalence verified: go generate produces identical output,
all tests pass.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@mromaszewicz mromaszewicz merged commit 3650846 into main Feb 8, 2026
4 checks passed
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant