fix(resolver): FamilyResolver — alias inside mutex + UPPER case-normalization

[sroussey]

Summary

Two HIGH-priority fixes for the shared FamilyResolver powering SponsorFamilyResolver and UnderwriterFamilyResolver.

• Alias lookup serialised inside the per-key mutex. Pre-fix code acquired the per-key mutex for find-or-create, released it, then ran resolveAlias() OUTSIDE the lock. Two parallel resolve() calls on the same family name could split if an alias was installed between the create and the alias lookup — one returned the alias target, the other the pre-alias id. This is the same race PR fix: DRSLTR dispatch, SPAC sponsor span verification, resolver test + RFC-9112 Content-Length #127 fixed for PersonResolver / CompanyResolver in commit 8fe6fd0; applying the same fix here so the family resolvers benefit. New regression tests in both family-resolver test files wrap aliasRepo.resolve with an in-flight counter and assert maxInFlight === 1 under two parallel resolves on the same key (pre-fix code drives it to 2).

• normalizeFamilyName reverted to UPPER. The shared helper introduced in commit 960d707 silently flipped the family-name fold from UPPER (the pre-refactor SponsorFamilyResolver convention) to lower. CanonicalSponsorFamilyRepo.findByResolverAndName runs an exact-match storage query with no case fold, so any existing UPPER canonical_sponsor_family.normalized_name rows became unreachable, and operator-installed aliases keyed on those canonical ids would silently orphan. Reverts to UPPER and pins it via a new dedicated FamilyResolver.test.ts covering UPPER output, case-insensitivity, internal-whitespace collapse, and empty/whitespace-only input. Three test fixtures (CanonicalSponsorFamilyRepo, CanonicalUnderwriterFamilyRepo, underwriterFamily command tests) that hardcoded lowercase normalized_name literals are updated to match.

Test plan

• bun test src/resolver/FamilyResolver.test.ts — new file pinning the UPPER case convention.
• bun test src/resolver/SponsorFamilyResolver.test.ts — adds the alias-in-mutex regression test.
• bun test src/resolver/UnderwriterFamilyResolver.test.ts — adds the alias-in-mutex regression test.
• bun test src/resolver/PersonResolver.test.ts — sibling resolver, unchanged but exercised to confirm no regression.
• bun test src/resolver/CompanyResolver.test.ts — sibling resolver, unchanged but exercised to confirm no regression.
• bun test src/storage/canonical/CanonicalSponsorFamilyRepo.test.ts — fixture flipped to UPPER.
• bun test src/storage/canonical/CanonicalUnderwriterFamilyRepo.test.ts — fixture flipped to UPPER.
• bun test src/commands/sponsorFamily.test.ts — uses normalizeSponsorFamilyName() dynamically; passes after the case flip.
• bun test src/commands/underwriterFamily.test.ts — three lowercase normalized_name literals flipped to UPPER.
• bun test src/resolver/ src/storage/canonical/ final sanity sweep: 116 tests pass, 0 fail.
• bun run build-types — TypeScript strict type-check clean.

---

Generated by Claude Code