[derek73]

Refs #965. #965 stays open for two questions recorded as Open lines: whether an unlisted word in capitals should join a listed credential's run in both orders (decisions/S8, CBE XYZ vs XYZ CBE), and telling FREng written in its own mask from the surname Freng (decisions/suffix-acronym-collisions).

What changes

GOV.UK display names (the govuk-people corpus, #962) end in post-nominals that no vocabulary listed. Each one became the family name (Jane Doe KC → family KC), and after a comma the name reversed (Jane Doe, CChem → given CChem). This PR lists them.

• KC, PC, DL are gated credential words. Each is a credential with acronym = false beside a name reading. It compiles into SUFFIX_WORDS_AMBIGUOUS and is read by rules/S11's count and S6's case lean, as fils is. A dotted K.C./P.C./D.L. is not a spelling of the word, so it stays Should Ram Bahadur B.K. keep B.K. as its family name? #864's paired initials.
  • John Smith KC, Jane Doe, DL → suffix.
  • Ram KC, Anna DL, Ravi PC → family.
• Supporting changes for the gated words.
  • credential joins GATED_WORDS, and build check 11 is widened. The honorific, status, courtesy, professional_honorific and generic suffix kinds are still refused beside a name reading; each has a mutation row.
  • classify writes the credential kind tag on a gated credential, and _vocab.suffix_kind reads it first. Without that, KC would land in the generation view.
  • Negative control: with master's pipeline, the new _EXPECTED_READINGS and _EXPECTED_ALTERNATIVES rows fail, and so does the existing test_every_suffix_words_reading_alternative_and_index_kind_agree.
• 18 plain credentials: FRS, KFSM, FRSA, FNucI, MRTPI, FRAeS, CChem, MRPharmS, MIBiol, FRMetS, CStJ, MICFor, MChemA, ACMA, BVSc, HMI, MMS, LLB. Mixed-case ones carry a cased mask.
• FIET and FREng are gated ambiguous acronyms. Each has a family reading (US Census 2010: Fiet 140, Freng 187).
• MoID is refused with an excluded reason: Moid is a given name written last (Syed Abdul Moid).
• Rules amended:
  • S11: the When clause takes the credential word, and there are new Then and Accepted bullets.
  • S6, C4, C12, S2, S5, S7: the class is named "a suffix word that is also a name".
  • R8: a shipped credential listed in suffix_words_ambiguous reads as a credential.
  • S3: the King's Counsel sentence.
• Decisions: entries in decisions/S11 and decisions/suffix-acronym-collisions, a pointer in decisions/R8, and the Open line in decisions/S8.

Per word

Word	Listing	Reason
KC	gated credential word	Nepali surname K.C.: ORCID family box 584 (NP 163); nepal-candidates K.C. 342, K.C 129, Kc 21; psc Kc 30
PC	gated credential word	initials: ORCID boxes given 149 / family 112 (IN 29); NPPES 2,246 (Professional Corporation)
DL	gated credential word	initials: ORCID boxes given 54 / family 21; psc Dl 7
FIET	gated acronym	surname Fiet, US Census 2010: 140
FREng	gated acronym (mask FREng)	surname Freng, US Census 2010: 187, Wikidata 2
MoID	excluded	Moid is a given name: psc 4, nepal 2, ORCID given box 20
FRS, KFSM, FRSA, MRTPI, ACMA, HMI, MMS, LLB	credential	no name population (Census, SSA and Wikidata below their floors)
FNucI, FRAeS, CChem, MRPharmS, MIBiol, FRMetS, CStJ, MICFor, MChemA, BVSc	credential with cased mask	no name population

Corpus moves

Measured with tools/differential/measure.py --base against master 4ebb51d.

Committed corpora

• The committed snapshot gains the rules' new examples.
• Its only move is 2 CLDR fictional Dl (Romanian salutation) renderings under capitalized(force=True): Dl → DL.
• CLDR, GND and Wikidata agreement: no move.

govuk-people (the issue's recipe)

• KC as the last family word: 36 → 9. The 9 are peers behind a title, an accepted cost.
• Other post-nominals ending the family: 27 → 11.
  • Remaining: FREng 3 (accepted), DL 2 behind a peer's title, and 6 names outside this batch.
  • Outside the batch: CEng 3 (newly exposed behind FIET), MNSS 1, KG 1, OM 1.
• Comma reversals: 16 → 0.

Other corpora

• ctgov-officials: 9 reversals fixed.
• ukec-individuals: 5 names gain the suffix (KC 3, DL 2).
• orcid-researchers: gains AO KC, a comma KC, BA LLB, FRSA.

Accepted costs, recorded in decisions/S11:

• Three-word Nepali names ending in capital KC read KC as the suffix: orcid 22 (17 agreement regressions with PC), nepal-candidates 5.
• Initials written KC/PC/DL at the end of a one-case family-comma name are read as the credential: fec 7.
• M.M.S. as initials: orcid 1.
• NPPES's 622 P.C. stay paired initials.
• Masked KC/PC/DL recase surnames and initials in case views. Counts per corpus are in decisions/S11.

No field moves: psc-individuals (reports and case views only). tse-donors has 1 case view. tw-donors and cz-candidates: none.

Checks

• uv run pytest: 34,034 passed.
• -n0 -m serial: 42 passed.
• uv run --python 3.15 pytest: passed.
• mypy, ruff: clean.
• Sphinx doctest: 575 tests, 0 failures. README doctest: clean.
• build.py --check: current.
• The design-docs-reviewer ran twice, on the change and on the fix commit. Every finding is addressed in the last two commits.

🤖 Generated with Claude Code