PlotDirector/PlotLine/Data/Reference/Names/v1.0.0/README.md

PlotDirector Name Intelligence reference data v1.0.0

Production-candidate global reference package for deterministic name recognition, ranking and relationship evidence in PlotDirector.

Scale

• 3,067 recognised given-name forms.
• 525 curated short-form, diminutive, nickname, spelling-variant and alternative-form relationships.
• 92,010 usage profiles: every name × six locales × five inclusive birth-era bands.
• Direct registration-derived profiles for the United States and United Kingdom; explicitly labelled blended estimates for Ireland, Canada, Australia and New Zealand.

Non-negotiable semantics

This library is positive evidence, not a whitelist. Missing names remain eligible for character detection through manuscript evidence. Gender values are priors, not character facts. Relationships generate candidates and continuity warnings; they never auto-merge characters. Existing project-specific CharacterAliases remain untouched and authoritative for that project.

Import order

1. name_locales.csv
2. given_names.csv
3. name_relationships.csv
4. name_usages.csv

Upsert using the stable string keys, optionally resolving them to application surrogate keys. Never use CSV row order as identity.

Review and validation

Start with REVIEW.md and the three review_sample_*.csv files. validation_report.json records the full structural validation result. See DATA_CONTRACT.md, METHODOLOGY.md, and VALIDATION.md before implementation.