six-degrees 0.4.0-beta.1 → 0.4.0

package/lib/scoring.js

@@ -36,7 +36,7 @@
 // on every rescore and never written into your company scores.
 //
 // Tiers are graded on your network's curve unless you choose the fixed scale
-// (Settings → Tiers): your top 3% of 1st-degree people are S, and so on down
+// (Scores → Tiers): your top 3% of 1st-degree people are S, and so on down
 // (CURVE). The curve only lifts, so a strong network keeps its fixed-scale
 // tiers, and it never lifts anyone under 4 into S or A. Everyone, 2nd degree
 // included, is graded on the same cut-offs, taken from your 1st degree.
@@ -88,6 +88,25 @@ export const LEVELS = {
   audience10m: { key: 'audience10m', label: 'Audience of 10M+', level: 5, points: 9 },
   audience1m: { key: 'audience1m', label: 'Audience of 1M+', level: 4, points: 7.5 },
   audience100k: { key: 'audience100k', label: 'Audience of 100K+', level: 3, points: 6.5 },
+  // Government and the services, on the same points. An elected or appointed
+  // leader (a senator, a governor, a mayor, a cabinet secretary) is C-suite;
+  // their deputies, state legislators, commissioners, ambassadors and judges
+  // are VPs; a deputy assistant secretary, a city councilmember or a sheriff a
+  // director. Officers by rank: a 3–4 star general or admiral is C-suite, a
+  // 1–2 star a VP, a colonel (a Navy captain) a director, a lieutenant colonel
+  // (a commander) a manager, a major (a captain) a senior IC; a command
+  // sergeant major or a master chief leads like a manager.
+  govLeader: { key: 'govLeader', label: 'Government Leader', level: 6, points: 10 },
+  govSenior: { key: 'govSenior', label: 'Senior Official', level: 5, points: 9 },
+  judge: { key: 'judge', label: 'Judge', level: 5, points: 9 },
+  govOfficial: { key: 'govOfficial', label: 'Government Official', level: 4, points: 7.5 },
+  seniorGeneral: { key: 'seniorGeneral', label: 'General / Admiral (3–4 star)', level: 6, points: 10 },
+  general: { key: 'general', label: 'General / Admiral (1–2 star)', level: 5, points: 9 },
+  colonel: { key: 'colonel', label: 'Colonel / Navy Captain', level: 4, points: 7.5 },
+  ltColonel: { key: 'ltColonel', label: 'Lt. Colonel / Commander', level: 3, points: 6.5 },
+  seniorEnlisted: { key: 'seniorEnlisted', label: 'Senior Enlisted Leader', level: 3, points: 6.5 },
+  nco: { key: 'nco', label: 'Senior NCO / Warrant Officer', level: 2, points: 5 },
+  major: { key: 'major', label: 'Major / Captain', level: 2, points: 5 },
 };
 
 // Checked in this order within one part of a headline. Earlier rules REMOVE
@@ -95,8 +114,15 @@ export const LEVELS = {
 // Staff" as a chief, or "Product Owner" as an owner. The highest level found wins.
 // A title's possessive is an award or an office named for it, not the title:
 // "President's Club" (sales), "Chairman's Award", "CEO's Office", "Dean's List".
+// Staff are not their boss: "Chief of Staff to the CEO", "Executive Assistant
+// to the General Manager" (but "Promoted to VP" is the VP). Government and
+// military titles aren't here: they count only where a title is written
+// (officeTitle, below).
 const TITLE_RULES = [
   [/\b(reporting )?(to|for) (the |our |a )?(ceo|cto|coo|cfo|cmo|founders?|co-?founders?|president|chair(man)?|professors?|dean|provost|chancellor)\b/g, null],
+  // An assistant's boss, with or without "the"; another staff word's only with
+  // it ("Associate to VP", "from Manager to GM" are promotions).
+  [/(?<!\bfrom\s+(?:[a-z]+\s+){0,2})(?:(?<=\b(?:assistant|aide|advisor|adviser|chief of staff|support|liaison|scheduler|ea)\s+)(to|for) (the |our |a )?|(?<=\b(?:paralegal|clerk|counsel|associate|coordinator|manager)\s+)(to|for) (the|our|a) )(general manager|managing director|gm|vice president|[se]?vp|general counsel|chief counsel)\b/g, null],
   [/\bchief of staff\b/g, 'director'],
   [/\b(senior |executive |assistant |associate )?vice[-\s]?president\b|\b(s|e|a)?vp\b/g, 'vp'],
   // Universities, before the C-suite rule reads "Vice Chancellor" as a
@@ -113,6 +139,23 @@ const TITLE_RULES = [
   // A dean only as a title: before "of", "for", a comma or the part's end, and
   // never a company's name ("Dean Foods", "at Dean Health Plan").
   [/(?<!\b(?:at|@)\s*)\bdean\b(?!['’]s\b)(?=\s*(?:(?:of|for|at|and|emerit(?:us|a))\b|[&@,(]|$))/g, 'dean'],
+  // A company's general counsel is an executive; the lawyers under a general
+  // or a chief counsel are directors and seniors. A military chief (a chief
+  // petty officer, a chief warrant officer) isn't a chief officer.
+  [/(?<!\b(?:promoted|from\s+[a-z]+(?:\s+[a-z]+)?)\s)\b(?:to|supporting|supports|support to) (?:the|our|a) (?:(?:deputy|associate|assistant) )?(?:(?:general|chief) counsel|division chief|section chief)\b/g, null],
+  [/\b(associate|assistant|deputy) general counsel\b/g, 'director'],
+  [/\b(associate|assistant|deputy) chief counsel\b/g, 'senior'],
+  [/(?<=\b(?:assistant|paralegal|clerk|coordinator|specialist|analyst|aide|supporting|support)\b[^|]*?|\b(?:attorney|lawyer|counsel|associate|manager|administrator)\b[^|,]*,[^|]*?)\b(general|chief) counsel\b/g, null],
+  [/\b(?:general|chief) counsel\b(?=[\s,]*(?:['’]s|office|division|practice|group|llp|l\.l\.p|p\.?c\.?|pllc|law|operations|team|department)\b)/g, null],
+  [/^\s*(?:(?:(?:senior |executive )?vice president|[se]?vp|chief legal officer|clo|head of legal|corporate secretary|secretary)\s*(?:,|&|and)\s*)*(?:general|chief) counsel\b|(?<=\b(?:[se]?vp|vice president|chief legal officer|clo|head of legal|president|coo|ceo)\s*(?:,|&|and)\s*|\b(?:attorney|lawyer)\s*(?:&|and)\s*)(?:general|chief) counsel\b/g, 'vp'],
+  [/\b(?:general|chief) counsel\b/g, null],
+  [/\b(senior |master )?chief petty officer\b|\bchief warrant officer\b|\bchief master sergeant\b/g, null],
+  // A government's or a lab's division and branch chiefs lead them, and a
+  // medical school's section chief is its division chief. A division's or a
+  // unit's chief officer is a chief officer ("Division Chief Nursing Officer").
+  [/\b(division chief|section chief(?= of\b))\b(?!\s+(\w+\s+){0,3}officer\b|\s+executive\b)|\bchief of (the )?[a-z]+ division\b/g, 'director'],
+  [/\b(branch|section|unit) chief\b(?!\s+(\w+\s+){0,3}officer\b|\s+executive\b)|^\s*chief,\s+[a-z &]+ (branch|section|office)\b/g, 'manager'],
+  [/^\s*chief,\s+[a-z &]+ division\b/g, 'director'],
   [/\b(product|process|content|data|feature|service|project|business process) owner\b/g, 'ic'],
   [/\b(client|channel|strategic|business|brand|creative|agency|solutions?|account|community|developer|technology|alliances?|content|media|marketing|talent|partner) partner\b/g, 'senior'],
   [/\bpartner (manager|marketing|development|success)\b/g, 'manager'],
@@ -121,9 +164,10 @@ const TITLE_RULES = [
   [/(?:\b(ceo|cto|cfo|coo|cmo|cro|cpo|cio|ciso|cdo|cso)\b|\bchief\s+(\w+\s+){0,3}officer\b|\bchief executive\b|\b(co-?)?founder\b|\bcofounder\b|\bpresident\b|\bchair(man|woman|person)\b|\bexecutive chair\b|\b(general|managing|founding) partner\b|\bchancellor\b|\bprovost\b)(?!['’]s\b)/g, 'csuite'],
   [/\b(co-?)?owner\b|\bentrepreneur\b|\bself[-\s]employed\b|\bproprietor\b/g, 'owner'],
   // "MD" is a managing director only where a doctor's degree can't be meant:
-  // at a company that isn't a hospital's or a clinic's ("MD @ J.P. Morgan"), or
-  // with a division after it ("MD, Investment Banking"), not a degree ("MD, MBA").
-  [/\bmanaging director\b|\bmd\b(?=\s*(?:at\b|@))(?!\s*(?:at\b|@)[^|]*\b(?:hospitals?|clinics?|health|healthcare|medical|medicine|physicians?|pediatrics?|surgery|surgical|kaiser|mayo|hopkins|dermatology|cardiology|oncology|orthopa?edics?|urgent care)\b)|^\s*md,\s+(?!(?:mba|phd|mph|ms|msc|mhs|mha|mhsa|jd|facs|facp|facc|faap|dds|dmd|do|rn|np|pa|ma|mbe|mpp)\b)|\bgeneral manager\b|\bgm\b|\bcountry (manager|director|lead|head)\b|\bhead of country\b|\bglobal head\b|\bchief (technologist|scientist|architect|economist|evangelist|strategist|engineer|of \w+)\b|^\s*partner\b|\bpartner (at|@)|\b(venture|senior|equity|operating) partner\b|\bboard (member|director|chair)\b|\bchair of the board\b|\bmember of the board\b|\bboard of directors\b/g, 'vp'],
+  // at a company that isn't a hospital's or a clinic's ("MD @ J.P. Morgan", read
+  // in readPart), or with a division after it ("MD, Investment Banking"), not a
+  // degree ("MD, MBA").
+  [/\bmanaging director\b|\bmd\b(?=\s*(?:at\s|@))|^\s*md,\s+(?!(?:mba|phd|mph|ms|msc|mhs|mha|mhsa|jd|facs|facp|facc|faap|dds|dmd|do|rn|np|pa|ma|mbe|mpp)\b)|\bgeneral manager\b|\bgm\b|\bcountry (manager|director|lead|head)\b|\bhead of country\b|\bglobal head\b|\bchief (technologist|scientist|architect|economist|evangelist|strategist|engineer|of \w+)\b|^\s*partner\b|\bpartner (at|@)|\b(venture|senior|equity|operating) partner\b|\bboard (member|director|chair)\b|\bchair of the board\b|\bmember of the board\b|\bboard of directors\b/g, 'vp'],
   [/\b(senior |executive |creative |art |associate )?director\b|\bhead of\b|\bhead\b(?= (coach|chef))|\b(angel |venture )?investor\b|\bprincipal at\b|\b(technical|distinguished|senior) fellow\b|(?<!account |sales |customer )\bexecutive\b(?! (assistant|producer|chef))/g, 'director'],
   [/\bmanager\b|\bmgr\b|\b(team |tech |design |engineering )?lead\b|\bleader\b|\bprincipal\b|\bstaff (engineer|designer|scientist|product|data)\b|\bsupervisor\b|\bsuperintendent\b/g, 'manager'],
   [/\bsenior\b|\bsr\b\.?|\bspecialist\b|\barchitect\b|\bexpert\b|\bexecutive producer\b/g, 'senior'],
@@ -166,7 +210,33 @@ const SHORT_NAME_CLUB = /\b(club|society)\b/;
 const FIELD_ASSOCIATION = /\b(marketing|finance|financial|business|economics|accounting|consulting|investment|investing|entrepreneurship|engineering|computer science|data science|nursing|pre-?law|pre-?med|students?)\b.*\bassociation\b/;
 // An alumni club or a parents' association is for grown-ups.
 const GROWN_UP = /\b(alumni|alumnae|alumnus|alum|parents?)\b/;
-const FORMER = /^\s*(ex[-\s]|former(ly)?\b|previously\b|prev\b|past\b|retired\b)/i;
+const FORMER = /^\s*(ex[-\s]|former(ly)?\b|previously\b|prev\b|past\b|retired\b|ret(\.|d\.?)?\s)/i;
+// Retired, written after the title: "Colonel (Ret.), U.S. Army", "COL (R)",
+// "Admiral, USN, Ret.", "Army Colonel, Retired". A former role, like "Ex-" or
+// "Retired" before it. A part that says only that ("Colonel, USAF - Retired")
+// makes the role before it former (readRoles).
+const RETIRED = /\(\s*(?:[a-z.]+,\s*)?ret(\.|ired|d\.?)?\s*\)|,\s*ret(\.|ired|d\.?)?\s*(?=,|$)|,\s*retired\s*(?=,|\)|$)|\bret\.\s*$|\b(army|navy|air force|marine corps|marines|usmc|usaf|usn|uscg|coast guard|space force)\s+(ret(\.|d\.?)?|retired)\s*$/i;
+const RETIRED_ONLY = /^\s*\(?\s*(ret\.?|retd\.?|retired)\s*\)?\s*$/i;
+// An office named for its head is where someone works, not their title: "IT
+// Specialist, Office of the Chief Information Officer", "Attorney, Judge
+// Advocate General's Corps". Only the head's title is taken out, so a title
+// written after an office's own name stays ("Office of Technology Licensing
+// Director").
+const OFFICE_NAME = /\boffice of (the )?(chief [a-z]+ officer|ceo|cto|cfo|coo|cio|ciso|cmo|president|vice president|general counsel|chief counsel|inspector general|solicitor general|surgeon general|attorney general|(under |deputy )?secretary( of [a-z ]+?)?|governor|lieutenant governor|mayor|director( of [a-z ]+?)?|chair(man)?|commissioner|(u\.?s\.? )?(senator|congress(wo)?man|representative)( [a-z.]+){0,3})( of (the )?[a-z.& ]+?)?(?=\s*(,|$|\||\(|\sat\s|@))|\b(judge advocate|adjutant) general['’]?s? corps\b|\b(general|chief) counsel['’]?s? (office|division|section|staff|team|department)\b|\boffice of (the )?(general|chief) counsel\b/g;
+// The company after "at" says where someone works, not what they do: its
+// words aren't read as a title ("Server at President Hotel", "Driver at
+// Executive Limo"). It runs to the next comma, a bracket, an emoji, or to
+// what starts another title or says what they do there: "at Stripe as Head
+// of Growth", "at Goldman Sachs (VP)", "at Google and Founder of Northwind".
+// "at" is the word alone: "AT&T Director" and "At-Large Director" are titles.
+// A part that starts with "at" has its title in the company's span ("At Home
+// Store Manager", "At Microsoft: Principal PM"), so nothing is taken out.
+const AT_COMPANY = /(?<=\S.*?)(\s(?:at\s|@)\s*)(?:(?!\s(?:as|where|leading|building|helping|working|and|while|also|plus|now|since|then|formerly|previously|x|in (?:19|20)\d\d)\s|\s[&+/]\s|\.\s|\s(?:at\s|@)|\s\S+(?:\s\S+)?\s(?:of|at|for)\s|\s\S+(?:\s\S+)?\s?@|\s?(?:→|►|->|=>)|[:(\[/\p{Extended_Pictographic}])[^,|])*/gu;
+const HEALTH_ORG = /\b(?:hospitals?|clinics?|health|healthcare|medical|medicine|physicians?|pediatrics?|surgery|surgical|kaiser|mayo|hopkins|dermatology|cardiology|oncology|orthopa?edics?|urgent care)\b/;
+// A doctor's specialty written after the hospital: "MD at Emory, Pediatrics".
+// Not a banker's coverage group ("MD at Goldman Sachs, Healthcare").
+const CARE_PLACE = /\b(?:hospitals?|clinic\w*|medical (?:center|school|group|director)|health system|school of medicine|residency|fellow(?:ship)?|resident|attending|physician|surgeon|hospitalist|professor|pediatric\w*|surg\w*|cardiolog\w*|oncolog\w*|hematolog\w*|orthopa?edic\w*|medicine|radiolog\w*|anesthesi\w*|psychiatr\w*|neurolog\w*|dermatolog\w*|urolog\w*|ophthalmolog\w*|patholog\w*|obstetric\w*|gynecolog\w*|gastroenterolog\w*|nephrolog\w*|endocrinolog\w*|rheumatolog\w*|pulmon\w*|geriatric\w*|palliative|critical care|primary care|infectious disease\w*|neonatolog\w*|otolaryngolog\w*|immunolog\w*|emergency|trauma)\b/;
+const SPECIALTY = /^(?:[a-z-]+ ){0,2}(?:pediatrics?|surgery|cardiology|oncology|orthopa?edics?|medicine|radiology|anesthesiology|anesthesia|psychiatry|neurology|dermatology|urology|ophthalmology|pathology|obstetrics(?: and gynecology)?|gynecology|ob\/?gyn|neurosurgery|gastroenterology|nephrology|endocrinology|rheumatology|pulmonology|hematology|geriatrics|palliative care|critical care|primary care|infectious diseases?|hospitalist|neonatology|otolaryngology|allergy(?: and immunology)?|immunology|emergency|trauma)$/;
 
 /** Can this short name ("USC", "UBS") be a school's? Not one on NOT_A_SCHOOL, nor a company the curated list knows. */
 function schoolShortName(name) {
@@ -176,7 +246,11 @@ function schoolShortName(name) {
 }
 
 /** Does this part of a headline say they're studying now? "CS @ NYU", "Economics student". */
+// A war or staff college's students are serving officers, not students.
+const SERVICE_SCHOOL = /\b(war college|staff college|command and general staff|naval postgraduate school|air university|national defense university|eisenhower school|joint forces staff college|school of advanced (military|air|warfighting))\b/i;
+
 function studies(part) {
+  if (SERVICE_SCHOOL.test(part)) return false;
   if (STUDENT.test(` ${part.toLowerCase()} `)) return true;
   const at = MAJOR.test(part) && AT_SHORT_NAME.exec(part);
   return !!at && schoolShortName(at[1]);
@@ -203,8 +277,13 @@ export function headlineParts(headline = '') {
 }
 
 function readPart(part) {
-  let s = ` ${part.toLowerCase()} `;
+  let s = ` ${part.toLowerCase()} `.replace(OFFICE_NAME, ' ');
+  // "MD at a hospital" is a doctor, which only the company (or a specialty
+  // after it) says.
+  const at = s.match(/\s(?:at\s|@)\s*([^,|]*)((?:,[^,|]*)*)/);
+  if (at && /\bmd\b(?=\s*(?:at\s|@))/.test(s) && (HEALTH_ORG.test(at[1]) || at[2].split(',').some((p) => SPECIALTY.test(p.trim()) || CARE_PLACE.test(p)))) s = s.replace(/\bmd\b/, ' ');
   if (INTERN.test(s)) return LEVELS.intern;
+  s = s.replace(AT_COMPANY, '$1 ');
   if (studies(part)) return LEVELS.student;
   let best = null;
   for (const [re, key] of TITLE_RULES) {
@@ -217,6 +296,650 @@ function readPart(part) {
   return best;
 }
 
+// ── government and the services ─────────────────────────────────────────────
+// A government or military title counts only where a title is written: the
+// start of a headline part, before its organization ("Senator, U.S. Senate",
+// "Colonel | U.S. Air Force", "Deputy Secretary of Defense"). Anywhere else
+// the same words name an office, a company or a club: "Staff Assistant,
+// Office of the Secretary of Defense", "Store Manager at Dollar General",
+// "Law Clerk to Chief Judge…". And a title means government only where its
+// own organization is a government's (where(), below: "Speaker at Soho
+// House", "Administrator at U.S. Bank" and "City Manager, Uber" aren't), and a
+// club, a church, a school, a profession, a mock government, an honorary or a
+// joke title never is (CIVIC: "Rotary District Governor", "Delegate, AMA House
+// of Delegates", "Governor, Florida Boys State", "Mayor of Fun at Northwind";
+// MOCK anywhere in the headline). Every rank but
+// the flag ranks spelled out needs its service beside it, in the same part or
+// as a part of its own ("Captain | U.S. Navy"), and nothing a veterans' group,
+// a cadet, a team, a licence or an honorary title holds is a commission
+// (NOT_MILITARY: "Kentucky Colonel", "Commander, VFW Post 42", "Captain, Navy
+// Rugby", "Master Chief | Halo Cosplayer"). A captain is a colonel's equal only
+// in a navy; a commander's level is their unit's (a division's is a general).
+// Four rounds of adversarial review found what these rules keep out; the
+// cases are in tests/scoring-misses.test.mjs.
+const STATES = String.raw`alabama|alaska|arizona|arkansas|california|colorado|connecticut|delaware|florida|georgia|hawaii|idaho|illinois|indiana|iowa|kansas|kentucky|louisiana|maine|maryland|massachusetts|michigan|minnesota|mississippi|missouri|montana|nebraska|nevada|new hampshire|new jersey|new mexico|new york|north carolina|north dakota|ohio|oklahoma|oregon|pennsylvania|rhode island|south carolina|south dakota|tennessee|texas|utah|vermont|virginia|washington|west virginia|wisconsin|wyoming|puerto rico|guam|american samoa|(?:the )?(?:u\.?\s?s\.?\s)?virgin islands|(?:the )?northern mariana islands|district of columbia`;
+const COUNTRIES = String.raw`afghanistan|albania|algeria|andorra|angola|argentina|armenia|australia|austria|azerbaijan|the bahamas|bahamas|bahrain|bangladesh|barbados|belarus|belgium|belize|benin|bhutan|bolivia|bosnia and herzegovina|botswana|brazil|brunei|bulgaria|burkina faso|burundi|cabo verde|cambodia|cameroon|canada|central african republic|chad|chile|china|colombia|comoros|congo|costa rica|cote d'ivoire|ivory coast|croatia|cuba|cyprus|czech republic|czechia|denmark|djibouti|dominica|dominican republic|ecuador|egypt|el salvador|equatorial guinea|eritrea|estonia|eswatini|ethiopia|fiji|finland|france|gabon|the gambia|gambia|georgia|germany|ghana|greece|grenada|guatemala|guinea|guinea-bissau|guyana|haiti|the holy see|holy see|honduras|hungary|iceland|india|indonesia|iran|iraq|ireland|israel|italy|jamaica|japan|jordan|kazakhstan|kenya|kiribati|kosovo|kuwait|kyrgyzstan|laos|latvia|lebanon|lesotho|liberia|libya|liechtenstein|lithuania|luxembourg|madagascar|malawi|malaysia|maldives|mali|malta|marshall islands|mauritania|mauritius|mexico|micronesia|moldova|monaco|mongolia|montenegro|morocco|mozambique|myanmar|burma|namibia|nauru|nepal|the netherlands|netherlands|new zealand|nicaragua|niger|nigeria|north korea|north macedonia|norway|oman|pakistan|palau|panama|papua new guinea|paraguay|peru|the philippines|philippines|poland|portugal|qatar|romania|russia|rwanda|saint kitts and nevis|saint lucia|saint vincent and the grenadines|samoa|san marino|sao tome and principe|saudi arabia|senegal|serbia|seychelles|sierra leone|singapore|slovakia|slovenia|solomon islands|somalia|south africa|south korea|the republic of korea|korea|south sudan|spain|sri lanka|sudan|suriname|sweden|switzerland|syria|taiwan|tajikistan|tanzania|thailand|timor-leste|togo|tonga|trinidad and tobago|tunisia|turkey|turkiye|turkmenistan|tuvalu|uganda|ukraine|the united arab emirates|united arab emirates|the united kingdom|united kingdom|great britain|uruguay|uzbekistan|vanuatu|venezuela|vietnam|yemen|zambia|zimbabwe|the kyrgyz republic|kyrgyz republic|the slovak republic|slovak republic|lao pdr|viet nam|the vatican|vatican|osce|the osce`;
+// A country's own forces: "French Navy", "German Army" (not the Swiss Army, a knife).
+const NATIONS = String.raw`u\.?\s?s\.?|united states|royal|british|canadian|australian|indian|israeli|french|german|italian|spanish|dutch|polish|norwegian|swedish|danish|finnish|japanese|korean|south korean|republic of korea|philippine|mexican|brazilian|new zealand|irish|belgian|greek|hellenic|turkish|ukrainian|singapore|south african|pakistani|egyptian|saudi|nigerian|kenyan|argentine|chilean|colombian|peruvian|portuguese|czech|romanian|hungarian|estonian|latvian|lithuanian|jordanian|emirati|qatari|taiwanese|thai|malaysian|indonesian|vietnamese|bangladeshi|sri lankan|nepalese|austrian`;
+const INTERNATIONAL = String.raw`the united nations|united nations|u\.?n\.?|nato|the european union|european union|the organization of american states|organization of american states|the african union|african union|asean|the world trade organization|world trade organization|the oecd|oecd|opec|interpol`;
+const STATE_NAME = new RegExp(String.raw`\b(${STATES})\b`);
+// A state's government named as the place it is: "State of Florida", "Commonwealth of Virginia".
+const STATE_GOV = new RegExp(String.raw`\b(?:state|commonwealth) of (?:${STATES})\b|\b(?:${STATES}) (?:state )?(?:government|legislature|senate|house of (?:representatives|delegates)|general assembly|state assembly|supreme court)\b|(?:^|[,|(@:]\s*|\b(?:the|at|of|for|with|in)\s)(?:${STATES}) (?:state )?(?:department|agency|office|cabinet)\b`);
+// A place that is only a state: the whole part says nothing else.
+const JUST_A_STATE = new RegExp(String.raw`^(?:the )?(?:(?:state|commonwealth) of )?(?:${STATES})(?: state)?$`);
+// A government's departments: "Department of Defense", not "Department of Surgery".
+const DEPT = String.raw`(?:the )?(?:state|defense|war|justice|treasury|interior|agriculture(?: and consumer services)?|commerce|labor(?: and (?:industry|workforce development))?|health(?: and human services| and mental hygiene)?|human services|social services|children and famil(?:y|ies)(?: services)?|(?:higher )?education|energy|transportation|veterans (?:affairs|services)|homeland security|housing(?: and urban development)?|army|navy|air force|environmental (?:protection|quality|conservation)|natural resources|conservation|fish and (?:wildlife|game)|parks(?: and recreation)?|revenue|taxation|finance(?: and administration)?|corrections|public safety|motor vehicles|highway safety(?: and motor vehicles)?|juvenile justice|law|insurance|financial (?:services|institutions)|banking(?: and finance)?|economic (?:development|opportunity|security)|community (?:affairs|development)|workforce development|employment(?: security)?|public health|mental health|developmental services|aging|elder affairs|military affairs|emergency management|information technology|administrative services|general services|management services|business(?: and professional)? regulation|consumer affairs|water resources|environment|public works|sanitation|buildings|city planning|homeless services|police|fire)`;
+// Where a government title may name its government: its own body, not "U.S. Bank".
+const GOV_ORG = new RegExp(String.raw`^(?:the )?(?:u\.?\s?s\.?|united states|federal|state of|commonwealth of|city of|county of|town of|village of|borough of|township of)\b[^,|]*?\b(?:department|dept\.?|agency|administration|bureau|commission|board|office|service|authority|court|senate|house of representatives|assembly|legislature|congress|marshals|attorney['’]?s office|embassy|mission)(?: of [a-z ,&'.-]+| for [a-z ,&'.-]+)?$|\b(?:department|dept\.?) of ${DEPT}\b|\b(?:senate(?!\s+(?:bank|federal|credit|capital|group|partners|consulting|solutions|inc|llc))|house of representatives|house of delegates|state assembly|legislature|library of congress|congressional (?:budget office|research service)|(?:u\.?\s?s\.?|united states|${STATES}|state) supreme court|supreme (?:judicial )?court of (?:the )?[a-z ]+|court of appeals|(?:district|circuit|superior|county|municipal|probate|family|juvenile|tax|bankruptcy) court|judicial circuit|supreme judicial court|court of (?:criminal )?appeals|appeals court|court of chancery|court of federal claims|court of international trade|appellate (?:court|division)|(?:congressional|legislative|house|senate|assembly) district|city council|town council|county commission|board of (?:county )?commissioners|board of supervisors|police department|sheriff['’]?s office|state attorney['’]?s office|district attorney['’]?s office|parliament)\b|^(?:the )?white house(?: office| staff| press office| national security council)?$|\bexecutive office of the president\b|\b(?:u\.?\s?s\.?|american) (?:embassy|consulate)\b|\b(?:embassy|consulate(?: general)?) (?:of|in)\b|\b(?:city|county|state|federal|tribal|municipal|local) government$|^(?:the )?government of\b|${STATE_GOV.source}`);
+// Not a government's: clubs, churches, schools and students, professions,
+// mock governments, honorary and joke titles.
+const CIVIC = /\b(rotary|lions clubs?|kiwanis|circle k|jaycees|jci|toastmasters|optimist|civitan|elks|moose|masonic|freemasons?|lodge|knights of columbus|pta|pto|students?|sga|asg|associated students|student government|model (un|united nations|congress|senate|legislature|g20|nato|oas)|\w*mun|boys state|girls state|youth (in|and) government|mock (trial|congress|legislature|government)|intercollegiate|faculty|(staff|faculty|student|graduate|university|employee|classified|academic|campus) (senate|assembly)|honor (court|council|board)|scouts?|fraternity|sorority|district \d{4}|alumni|model parliament|youth parliament|high school|middle school|olympics|ama|aba|american medical association|american bar association|chamber of commerce|youth|church|catholic|diocese|synod|presbyterian|methodist|baptist|episcopal|lutheran|congregation|ministry|ministries|vestry|temple|mosque|synagogue|daughters of the american revolution|sons of the american revolution|lineage|association|society|convention|cosplay|honorary|fantasy|kickball|softball|soccer|baseball|basketball|football|hockey|bowling|golf|pickleball|volleyball|rugby|lacrosse|chess|cornhole|tennis|swim|rodeo|athletics?|league|clubs?|tournament|esports|gaming|panhellenic|interfraternity|greek life|honors college|debate|key club|builders club|american legion|vfw|veterans of foreign wars|freemasonry|scottish rite|shriners|collectors|hoa|homeowners|condo|undergraduate|scouting|bsa|deca|ffa|4-h|fbla|hosa|skillsusa|y ?& ?g|girlguiding|brownies|guides|st john ambulance|chamber|state bar|bar of|oxford union|cambridge union|debating (?:union|society)|youth council|bodybuilding|physique|npc|ifbb|powerlifting|junior chamber|republicans?|democrats?|democratic party|republican party|libertarian|green party|young republicans|young democrats|college republicans|college democrats|party of|gop|teen|campus|neighborhood watch|homeschool(?:ing|er)?|of (fun|vibes|content|culture|coffee|memes|good vibes|snacks|hot takes|takes|chaos|hustle|growth|mischief|awesome|everything|all things|sales|marketing|the (internet|office|slack|break room|group chat|home|family|kitchen|grill)|my (house|home|family|kitchen)))\b|\b(bar|medical|nursing|hospital|dental|bankers|realtors?) (association|board of governors)\b|\bboard of governors\b(?! of the federal reserve)/;
+// Mock governments, anywhere in a headline: no official lists one.
+const MOCK = /\b(boys state|girls state|boys nation|girls nation|model (?:[a-z]+ )?(un|united nations|congress|senate|legislature|g20|nato|oas|oecd|asean|parliament|supreme court|court|government|cabinet|eu|european union|arab league|african union|city council)|\w+mun|mun|youth (in|and|&) government|youth (parliament|senate|legislature|council)|mock (trial|congress|legislature|government|election)|junior state of america|junior chamber|jci|cowboy action|sass|reenact\w*|student (?:parliament|supreme court|court))\b/;
+// A part about someone's past or a role beside the mock body isn't one: "Model UN Alumni".
+const MOCK_PAST = /\b(alumni|alum|former|ex-|coach|advis[eo]r|mentor|judge|volunteer|director)\b/;
+// A city's, a county's or a school district's government, as its own name
+// says: "City of Orlando", "Orange County", "Broward County Public Schools",
+// "Orlando Fire Department", "District 5".
+const LOCAL_GOV = /^(?:the )?(?:city|town|village|borough|township|county|parish|municipality) of (?!hope\b)[a-z]|\b(?:city|town|village|county) (?:hall|government|commission)\b|^(?:the )?(?:[a-z.'-]+ ){1,3}(?:county|metropolitan|metro|city|town) council$|^(?:the )?city and county of [a-z]|\bboard of (?:county )?(?:commissioners|supervisors|aldermen|selectmen|education)\b|\b(?:public schools|school district|independent school district|isd|unified school district|county schools)\b|\bfire (?:rescue|department|district)\b|\bpolice department\b|\bsheriff['’]?s? (?:office|department)\b/;
+// A county, a district or a ward named alone is a place: a local office's
+// ("Commissioner, Orange County", "Council Member, District 5"), or where
+// anyone else works ("Ambassador | Orange County | lululemon").
+const LOCAL_PLACE = new RegExp(String.raw`^(?:(?:[a-z.'-]+ ){1,3}(?:county|parish)(?: government)?|(?:district|ward|precinct|seat|place) \d+|\d+(?:st|nd|rd|th) district|at-large)(?:,\s*(?:[a-z]{2}|${STATES}))?$`);
+// Tribal nations, by the names most use.
+const TRIBES = String.raw`cherokee|navajo|choctaw|chickasaw|muscogee|creek|seminole|osage|oneida|seneca|mohawk|onondaga|potawatomi|shawnee|comanche|kiowa|apache|hopi|zuni|lakota|dakota|oglala|sioux|ojibwe|chippewa|ho-chunk|menominee|blackfeet|crow|shoshone|arapaho|ute|yakama|nez perce|tlingit|haida|lumbee|pequot|mashantucket|mohegan|miccosukee|cheyenne|pawnee|quapaw|wyandotte|delaware|lenape|kickapoo|winnebago|omaha|ponca|tohono o'odham|gila river|salt river|pascua yaqui|yaqui|colville|tulalip|puyallup|lummi|makah|nisqually|quinault|coeur d'alene|kootenai|salish|klamath|karuk|yurok|hoopa|pechanga|morongo|agua caliente|san manuel|chumash|pomo|miwok|washoe|paiute|jicarilla|mescalero|laguna|acoma|isleta|jemez|taos|narragansett|wampanoag|passamaquoddy|penobscot|catawba|coushatta|chitimacha`;
+// A tribe's government, not a business it owns ("Cherokee Nation Businesses")
+// or a brand with a tribe's word ("Tribe Capital", "Growth Nation").
+const TRIBAL_GOV = new RegExp(String.raw`\b(?:${TRIBES})(?: (?:indian|tribal))? (?:nation|tribe|tribes|indians|indian community|indian tribe|reservation)(?: of (?:the )?[a-z ]+)?$|\b(?:${TRIBES})[a-z -]* indian community\b|\b(?:nation|tribe|pueblo|band) of (?:the )?(?:${TRIBES})\b|\bpueblo of [a-z]+|\b(?:tribal (?:council|government|court|nation)|indian (?:community|reservation|tribe)|rancheria|first nations?)$|\bband of [a-z ]+ indians\b`);
+const TRIBAL_BUSINESS = /\b(businesses|enterprises|holdings|entertainment|gaming|casino|resort|industries|development corporation|corp|corporation|inc|llc)\b/;
+// A legislature named as the whole organization: "Florida Senate", "U.S. House of Representatives".
+const LEGIS = new RegExp(String.raw`^(?:the )?(?:(?:u\.?\s?s\.?|united states|${STATES})\s+)?(?:state\s+)?(?:house of (?:representatives|delegates)|senate|legislature|congress)$|^(?:the )?senate of (?:the )?[a-z ]+$|^(?:the )?(?:${NATIONS}) senate$|^(?:(?:${STATES}) )?(?:state )?(?:house|senate|assembly|legislative) district \d+$|^(?:the )?(?:${STATES})\s+(?:state\s+)?(?:house|assembly|general assembly)$|^(?:the )?state (?:house|assembly)$`);
+// A state's government itself, as the whole organization: "State of Florida".
+const STATE_ITSELF = new RegExp(String.raw`^(?:the )?(?:(?:state|commonwealth|territory) of (?:${STATES})|(?:${STATES})(?: state)? government|government of (?:${STATES}))$`);
+// A federal agency, by its name or its initials, at the start of an organization: "FBI Miami Field Office".
+const AGENCY_NAMES = String.raw`(?:u\.?\s?s\.?\s|united states )?(?:environmental protection agency|federal aviation administration|federal emergency management agency|national aeronautics and space administration|transportation security administration|agency for international development|drug enforcement administration|national highway traffic safety administration|general services administration|small business administration|centers for medicare (?:and|&) medicaid services|federal highway administration|federal transit administration|federal railroad administration|maritime administration|national oceanic and atmospheric administration|federal bureau of investigation|internal revenue service|social security administration|customs and border protection|immigration and customs enforcement|citizenship and immigration services|secret service|marshals service|bureau of alcohol, tobacco, firearms and explosives|occupational safety and health administration|food and drug administration|veterans health administration|executive office for immigration review|border patrol)`;
+const AGENCY_INITIALS = String.raw`fcc|sec|ftc|fec|nrc|ferc|cftc|eeoc|nlrb|uspto|fdic|cfpb|epa|faa|fema|nasa|tsa|usaid|dea|nhtsa|gsa|sba|cms|fhwa|fta|fra|noaa|fbi|irs|ssa|cbp|uscis|atf|osha|fda|vha|hsi|usss|usms|dhs|doj|hud|usda|hhs`;
+const AGENCY = new RegExp(String.raw`^(?:the )?(?:${AGENCY_NAMES}|(?:u\.?\s?s\.?\s)?(?:${AGENCY_INITIALS}))(?:,?\s+(?:(?:[a-z.]+\s+){0,2}(?:field|district|regional|area|resident) office|region(?:al office)?(?: \d+| [ivx]+)?|headquarters|hq|(?:[a-z]+\s+){0,2}(?:division|sector)))?$`);
+const AGENCY_EXACT = new RegExp(String.raw`^(?:the )?(?:${AGENCY_NAMES}|(?:u\.?\s?s\.?\s)(?:${AGENCY_INITIALS}))$`);
+// An organization that isn't a government's, whatever else it says: "State of Florida Credit Union".
+const NOT_GOV = /\b(credit union|fcu|bank|inc|llc|corp|corporation|company|foods|brands|pharma\w*|holdings|solutions|consulting|partners|realty|dental|university|college|academy|montessori|preparatory|prep school|day school|christian school|catholic school|hospital|health system|medical center|church|association|society|club|league|foundation|chapter|tech council|chamber|hotel|inn|suites|resort|restaurant|podcast|show|radio|meeting|forum|market|coffee|cafe|grill|garage|grocery|salon|studio|brewing|bistro|tavern|pub|deli|bakery|gallery|pac|press|accounts?|team|programs|contracts|relations|partnerships)\b/;
+// A part that names no organization: a place, a credential, who they are.
+const PLACE = new RegExp(String.raw`^(?:the )?(?:(?:state|commonwealth) of )?(?:${STATES}|${COUNTRIES})(?: state)?$|^[a-z .'-]+,\s*[a-z]{2}$|^[a-z]{2}$|\b(?:area|metro|region|based)\b`);
+const NOT_AN_ORG = /^(?:cpa|mba|phd|jd|esq\.?|md|rn|pmp|cfa|cfp|pe|ms|ma|mpa|mph|llm|shrm-[a-z]+)$|\b(?:veteran|vet|mom|dad|mother|father|husband|wife|parent|grand(?:ma|pa|mother|father|parent)|christian|believer|author|speaker|podcaster|host|advocate|volunteer|mentor|runner|golfer|traveler|lover|enthusiast|fan|licensed|admitted|bar|retired|former)\b/;
+const LEAD = String.raw`(?:(?:acting|interim|the|honorable|hon\.?|\d+(?:st|nd|rd|th)|principal|u\.?\s?s\.?|united states|(?:two|three|four|five|\d)[-\s]term|longtime|elected|sitting|incumbent|current|active duty)\s+)*`;
+// A company's or a board's officers: "Assistant Secretary of the Corporation", "of Acme Holdings Inc.".
+const CORP_OFFICER = /\b(corporation|company|board|inc\.?|llc|holdings|ltd|plc|trust|fund|bank|partners|group)\b/;
+// Judging that isn't a court's: competitions, fairs, moot courts, a food court.
+const NOT_COURT = /\b(universit(y|ies)|college|students?|sga|moot|mock|sommeliers?|food court|fairs?|competitions?|hackathons?|pageants?|shows?|debate|awards?|contests?|olympiads?|festivals?|teen court|cook-?off|bake-?off|rodeo|barrel racing|cheer(?:leading)?|bbq|barbecue|chili|ffa|4-h|livestock|cattle|horse show|equestrian|kennel club|dog show|gymnastics|figure skating|culinary|robotics|spelling bee|martial arts|pitch|startup|demo day|shark tank|bodybuilding|physique|npc|ifbb|powerlifting|car shows?|dance|cheer)\b/;
+const FED_BODY = String.raw`(?:u\.?\s?s\.?\s|united states )?(?:securities and exchange commission|consumer product safety commission|nuclear regulatory commission|commodity futures trading commission|equal employment opportunity commission|international trade commission|federal (?:communications|trade|election|energy regulatory|maritime) commission|federal deposit insurance corporation|federal reserve(?! bank)(?: board| system)?|board of governors of the federal reserve(?: system)?|national (?:labor relations|transportation safety) board|internal revenue service|food and drug administration|social security administration|customs and border protection|council of economic advisers)`;
+
+// The services, and the units and bases that say which one.
+const SVC = String.raw`(?:(?:${NATIONS})\s+)?(?:army national guard|air national guard|national guard|army reserves?|navy reserves?|naval reserves?|air force reserves?|marine corps reserves?|coast guard reserves?|army (?:nurse|medical|dental|medical service|medical specialist|veterinary|chaplain) corps|navy (?:nurse|medical service|chaplain) corps|army|navy|air force|marine corps|marines|space force|coast guard|armed forces|canadian armed forces|department of defense|public health service(?: commissioned corps)?|noaa corps|noaa commissioned officer corps)|(?:u\.?\s?s\.?|united states) marine|\b(?:usmc|usmcr|usaf|usafr|afrc|usn|usnr|uscg|uscgr|ussf|usar|arng|ang|usphs|dod|raf|idf)\b`;
+// "Army" and "Navy" alone are also a crowd's or a brand's words ("Church Army",
+// "Brand Army", "Grassroots Army"): alone, a service is the whole organization
+// ("Captain, U.S. Navy", "Colonel, Army National Guard"), or qualified.
+const QUALIFIED_SVC = String.raw`(?:(?:${NATIONS}|the)\s+(?:army|navy|air force|marine corps|marines|space force|coast guard)|army national guard|air national guard|national guard|(?:army|navy|naval|air force|marine corps|coast guard) reserves?|air force|marine corps|space force|coast guard|armed forces|department of defense|public health service|noaa corps|noaa commissioned officer corps|army (?:nurse|medical|dental|medical service|medical specialist|veterinary|chaplain) corps|navy (?:nurse|medical service|chaplain) corps)|(?:u\.?\s?s\.?|united states) marine|\b(?:usmc|usmcr|usaf|usafr|afrc|usn|usnr|uscg|uscgr|ussf|usar|arng|ang|usphs|dod|raf|idf)\b`;
+const NOT_SVC_AFTER = String.raw`(?!\s(?:spouses?|wife|wives|husbands?|moms?|mothers?|dads?|fathers?|grandmas?|grandpas?|brats?|famil(?:y|ies)|kids?|rotc|jrotc|federal|exchange|cross|pier|surplus|one|league|association|times|history|museum|band|academy|veterans?|vet|of|navy|army|surplus|store|beach|lifeguards?|blue|ferry|taxi|island|chess|debate|esports|rifle|pistol|sports|athletics|club|team|choir|chorus|yard|coffee|brewing|supply|outfitters|paintball|airsoft|wrestling|swimming|rugby|lacrosse|football|soccer|basketball|baseball|hockey|golf|tennis|volleyball|softball|sailing|rowing|crew)\b)`;
+const SERVICE_IN = new RegExp(String.raw`(?<!(?:salvation|old|texas|nebraska|great|commemorative|church|brand|grassroots)\s)(?:${QUALIFIED_SVC})${NOT_SVC_AFTER}|\b(?:uss|usns|uscgc|afb)\s|\bnaval\b|\bv[a-z]{1,3}-\d+\b|\b(?:air force base|joint base|naval air station|naval station|marine corps (?:base|air station)|marine (?:division|expeditionary|regiment|aircraft wing|logistics group))\b|\b\d+(?:st|nd|rd|th) (?:[a-z]+ ){0,2}(?:division|brigade|battalion|regiment|wing|squadron|fleet|corps|group|airborne|infantry|cavalry)\b|\b(?:u\.?\s?s\.? )?(?:central|european|pacific|indo-pacific|africa|southern|northern|special operations|cyber|space|strategic|transportation) command\b|\b(?:pacific|u\.?\s?s\.? air forces in europe|air forces) air forces?\b|\bpacific air forces\b|\b(?:army|navy|air force|marine corps|fleet) forces command\b|\bnavy region\b|\b(?:u\.?\s?s\.? )?(?:pacific|atlantic|fleet forces|\d+(?:st|nd|rd|th)|second|third|fifth|sixth|seventh) fleet\b|\b(?:air combat|air mobility|air education and training|global strike|materiel|training and doctrine|forces|futures|sealift|military sealift|space and missile systems) command\b`);
+// A part whose organization is just a service ("Colonel, Army", "Captain, Navy").
+const REST_IS_SERVICE = new RegExp(String.raw`^(?:the\s+)?(?:${SVC})\b${NOT_SVC_AFTER}`);
+const NAVY_IN = new RegExp(String.raw`(?<!(?:old|texas|nebraska|great)\s)\b(?:navy|naval|usn|usnr|coast guard|uscg|uscgr|noaa corps|noaa commissioned officer corps|public health service|usphs|uss|usns|uscgc)\b${NOT_SVC_AFTER}`);
+// A part that is only a service ("U.S. Navy", "Retired U.S. Army", "USAF (Ret.)").
+const SERVICE_ONLY = new RegExp(String.raw`^(?:(?:retired|former|ret\.?|retd\.?)\s+)?(?:the\s+)?(?:(?:${STATES})\s+)?(?:${SVC})(?:\s+reserves?)?(?:,?\s*(?:\((?:ret\.?|retd\.?|retired|active duty)\)|ret\.?|retd\.?|retired|active duty))?$`);
+const RETIRED_SERVICE = /^(retired|former|ret\b)|\bret\.?\)?$|\bretired\)?$/;
+// A service's retirement tag, a rank or two between: "U.S. Army (Ret.)", "(USAF, Ret.)", "Army Colonel (Retired)".
+const SERVICE_RETIRED = new RegExp(String.raw`(?:${SVC})(?:\s+[a-z.]+){0,2}[\s,]*(?:\(\s*)?(?:ret\.?|retd\.?|retired)\b`);
+const RANKED = new Set(['seniorGeneral', 'general', 'colonel', 'ltColonel', 'major', 'seniorEnlisted', 'nco']);
+const MIL_UNIT = /\b(division|brigade|battalion|squadron|wing|regiment|fleet|command|corps|group|task force|carrier|uss|usns|uscgc|infantry|airborne|cavalry|artillery|armor|special forces|seal team|marines?|garrison|installation|base|detachment|company|battery|troop|flight)\b/;
+const NOT_MILITARY = /\b(army and navy union|honorary|kentucky colonels?|tennessee colonel|commemorative air force|great navy|texas navy|nebraska navy|civil air patrol|rotc|jrotc|cadets?|midshipm[ae]n|american legion|vfw|veterans of foreign wars|amvets|disabled american veterans|marine corps league|navy league|air force association|association of the united states army|ausa|moaa|auxiliary|order of the|boy scouts|girl scouts|scouts bsa|sea cadets|young marines|salvation army|licensed|license|mariner|merchant marine|charter|vessel|yacht|\d+\s*-?\s*ton|oupv|six-pack|halo|cosplay\w*|reenact\w*|star trek|police|sheriff['’]?s?|lapd|nypd|highway patrol|state patrol|troopers?|corrections|fire (?:department|rescue|district|dept|station|company|service|marshal)|firefighters?|(?:engine|ladder|truck|rescue|squad|station) \d+|power squadron|boating|sailing|society|relief|ministr(?:y|ies)|fans?|store|shop|surplus|park rangers?|community services|engine company|restaurants?|street|avenue|cleaning|architects?|architecture|lifeguards?|boys brigade|girls brigade|pickleball|squad|hospital|university|college|drum corps|marching|charters?|fishing|ems|ambulance|museum|docent|association|veterans|alumni|chapter|memorial|credit union|fcu|casino|varsity|intramural|club|league|rugby|lacrosse|football|soccer|basketball|baseball|hockey|crew|rowing|sailing team|athletics|captain of|wrestling|swimming|diving|track|cross country|fencing|boxing|golf|tennis|volleyball|softball|water polo|rifle team|pistol team|squash|sprint football|gymnastics|cheer(?:leading)?|starfleet|sea scouts?|model ships?|paintball|airsoft|corps of cadets|citadel|composite squadron|model shipbuilders|chess|debate|esports|(?:usna|usma|usafa|uscga)\s*['’]?\d{2})\b|(?<!seal |combat |protection |support |engagement |training |assistance )\bteam\b/;
+// Civilian words in a part beside a rank whose own part names its service only
+// weakly (a numbered unit, a USS name, "naval"): "Commander, 3rd Division |
+// Northwind Police Department", "Commanding Officer, USS Northwind | Starfleet International".
+const NOT_MILITARY_NEAR = /\b(harbor pilot|ship pilot|river pilot|parasail\w*|watersports|sportfishing|marina|dive|eve online|nerf|warhammer|esports|gaming|game|guild|clan|minecraft|roblox|fortnite|call of duty|discord|virtual|dcs world|flight sim\w*|milsim|texas navy|nebraska navy|great navy|salvation army|cruises|fishing|guide|charters?|boat|yacht|tours?|ferry|cruise|towing|tug|airlines?|air lines|federal air marshal|fams|tsa|starfleet|star trek|sea cadets?|sea scouts?|cosplay\w*|halo|reenact\w*|police|sheriff|fire (?:department|rescue)|lapd|nypd|model ships?|shipbuilders|civil air patrol|cap|corps of cadets|cadets?|citadel|vmi|rotc|jrotc|paintball|airsoft)\b/;
+// A part that belongs with a rank: its service, its unit, its job, a place, "Retired".
+const milish = (p) => SERVICE_ONLY.test(p) || RETIRED_ONLY.test(p) || RETIRED_SERVICE.test(p) || (PLACE.test(p) && !/^[a-z]{2}$/.test(p)) || /\b(?:army|navy|naval|air force|marine|coast guard|military|infantry|staff) officer\b/.test(p) || (MIL_ROLE.test(p) && !isOrg(p) && !NOT_MILITARY_NEAR.test(p))
+  || (MIL_UNIT.test(p) && /\d/.test(p) && !isOrg(p) && !NOT_MILITARY.test(p) && !NOT_MILITARY_NEAR.test(p));
+const STRONG_SERVICE = new RegExp(String.raw`(?:${QUALIFIED_SVC})`);
+// Short forms that are also credentials or companies: a CSM is a Certified ScrumMaster,
+// a CPT a personal trainer, LTC long-term care, ADM and MSG companies. With their
+// service in the same part only ("LTC, U.S. Army"), never one borrowed from another part.
+const LOOKALIKE_SHORT = /^(?:ltc|cpt|csm|cmc|msg|msgt|mg|bg|adm|gen)\b/;
+
+// Military short forms, read only at the start of a title and only beside a service.
+const RANK_SHORT = [
+  [/^(?:lt\.?\s?gen(?:eral|\.)?|ltgen|ltg|lieut\.?\s?general)(?=\s|$)/, 'lieutenant general'],
+  [/^(?:maj\.?\s?gen(?:eral|\.)?|majgen|mg)(?=\s|$)/, 'major general'],
+  [/^(?:brig\.?\s?gen(?:eral|\.)?|bgen|bg)(?=\s|$)/, 'brigadier general'],
+  [/^gen\.?(?=\s|$)/, 'general'],
+  [/^(?:vice\s?adm\.?|vadm)(?=\s|$)/, 'vice admiral'],
+  [/^(?:rear\s?adm\.?|radm|rdml)(?=\s|$)/, 'rear admiral'],
+  [/^adm\.?(?=\s|$)/, 'admiral'],
+  [/^(?:lt\.?\s?col(?:onel|\.)?|lieut\.?\s?colonel|ltcol|ltc|lcol)(?=\s|$)/, 'lieutenant colonel'],
+  [/^col\.?(?=\s|$)/, 'colonel'],
+  [/^(?:lt\.?\s?cdr\.?|lcdr|ltcdr|lt\.?\s?commander)(?=\s|$)/, 'lieutenant commander'],
+  [/^cdr\.?(?=\s|$)/, 'commander'],
+  [/^(?:capt\.?|cpt)(?=\s|$)/, 'captain'],
+  [/^maj\.?(?=\s|$)/, 'major'],
+  [/^lt\.?(?=\s|$)/, 'lieutenant'],
+  [/^csm(?=\s|$)/, 'command sergeant major'],
+  [/^(?:sgtmaj|sgt\.?\s?maj\.?)(?=\s|$)/, 'sergeant major'],
+  [/^sgm(?=\s|$)/, 'sergeant major'],
+  [/^cmsgt(?=\s|$)/, 'chief master sergeant'],
+  [/^(?:mcpo|mcpon|cmc)(?=\s|$)/, 'master chief'],
+  [/^scpo(?=\s|$)/, 'senior chief petty officer'],
+  [/^(?:cw[2-5]|cwo[2-5]?)(?=\s|$)/, 'chief warrant officer'],
+  [/^wo1(?=\s|$)/, 'warrant officer'],
+  [/^sfc(?=\s|$)/, 'sergeant first class'],
+  [/^1sg(?=\s|$)/, 'first sergeant'],
+  [/^(?:msg|msgt)(?=\s|$)/, 'master sergeant'],
+  [/^smsgt(?=\s|$)/, 'senior master sergeant'],
+  [/^mgysgt(?=\s|$)/, 'master gunnery sergeant'],
+  [/^gysgt(?=\s|$)/, 'gunnery sergeant'],
+];
+// [the whole title, its level, whether it needs a service beside it]. The
+// flag ranks spelled out, and the services' chiefs, are nobody else's. A
+// captain is 'captain' (a colonel's equal in a navy, a major's elsewhere), a
+// lieutenant counts only in a navy (a major's equal), and a commander,
+// commanding or executive officer is 'commander': their unit decides.
+const RANKS = [
+  [String.raw`chief of staff of the (?:u\.?\s?s\.?\s)?(?:army|air force)|vice chief of staff of the (?:u\.?\s?s\.?\s)?(?:army|air force)|chief of naval operations|vice chief of naval operations|commandant of the (?:u\.?\s?s\.?\s)?(?:marine corps|coast guard)|(?:vice )?chairman of the joint chiefs(?: of staff)?|chief of space operations|chief of the national guard bureau`, 'seniorGeneral', false],
+  [String.raw`sergeant major of the (?:army|marine corps)|master chief petty officer of the (?:navy|coast guard)|chief master sergeant of the (?:air force|space force)|senior enlisted advisor to the chairman`, 'seniorEnlisted', false],
+  [String.raw`lieutenant general|vice admiral|(?:three|four|3|4)[-\s]star (?:general|admiral)|general of the army|fleet admiral`, 'seniorGeneral', false],
+  [String.raw`air marshal|air chief marshal`, 'seniorGeneral', true],
+  [String.raw`major general|brigadier general|rear admiral(?: \((?:lower|upper) half\))?|(?:one|two|1|2)[-\s]star (?:general|admiral)`, 'general', false],
+  [String.raw`air vice marshal|air commodore`, 'general', true],
+  [String.raw`(?:deputy )?commanding general|brigadier|commodore`, 'general', true],
+  [String.raw`general|admiral`, 'seniorGeneral', true],
+  [String.raw`lieutenant colonel|wing commander`, 'ltColonel', true],
+  [String.raw`colonel|group captain`, 'colonel', true],
+  [String.raw`(?:(?:deputy|vice|garrison|installation|base|battalion|squadron|wing|group|ship|regimental|brigade|division|corps|fleet|company|battery|troop|flight|detachment|task force) )*commander|commanding officer|executive officer`, 'commander', true],
+  [String.raw`lieutenant commander|squadron leader|major`, 'major', true],
+  [String.raw`captain`, 'captain', true],
+  [String.raw`lieutenant`, 'lieutenant', true],
+  [String.raw`command sergeant major|sergeant major|(?:command )?master chief(?: petty officer)?|chief master sergeant|command chief(?: master sergeant)?|master gunnery sergeant`, 'seniorEnlisted', true],
+  [String.raw`(?:senior )?chief petty officer|senior chief|(?:senior )?master sergeant|(?:first|1st) sergeant|sergeant first class|gunnery sergeant|(?:chief )?warrant officer(?: [1-5])?`, 'nco', true],
+  [String.raw`o-?(?:9|10)`, 'seniorGeneral', true],
+  [String.raw`o-?[78]`, 'general', true],
+  [String.raw`o-?6`, 'colonel', true],
+  [String.raw`o-?5`, 'ltColonel', true],
+  [String.raw`o-?4`, 'major', true],
+  [String.raw`e-?9`, 'seniorEnlisted', true],
+  [String.raw`e-?[78]`, 'nco', true],
+].map(([src, key, needsService]) => [new RegExp(`^(?:${src})$`), key, needsService]);
+const LEVEL_DOWN = { seniorGeneral: 'general', general: 'colonel', colonel: 'ltColonel', ltColonel: 'major', major: 'major' };
+
+// A unit's usual commander, smallest first: the first unit a title names is the
+// one commanded ("Executive Officer, 1st Battalion, 75th Ranger Regiment" is a
+// battalion's).
+const UNIT_LEVELS = [
+  [/\b(company|battery|troop|flight|detachment)\b/, 'major'],
+  [/\b(battalion|squadron|ship|uss|uscgc|submarine|destroyer|frigate|cutter|v[a-z]{1,3}-\d+)\b/, 'ltColonel'],
+  [/\b(brigade|wing|group|regiment|garrison|installation|base|naval (air )?station|naval hospital|joint base)\b/, 'colonel'],
+  [/\b(division|strike group|region|command|(surface|submarine|naval|expeditionary) forces?|air forces)\b/, 'general'],
+  [/\b(corps|fleet|combatant command|(materiel|combat|mobility|training and doctrine|futures|forces|special operations|space|cyber|strategic|transportation|northern|southern|central|european|pacific|indo-pacific|africa|global strike|education and training) command)\b/, 'seniorGeneral'],
+];
+
+/** A commander's (or a commanding or executive officer's) level, from their unit. */
+function commandLevel(n, where) {
+  const text = `${n.replace(/\b(commander|commanding officer|executive officer|deputy|vice)\b/g, ' ')} ${where}`
+    .replace(new RegExp(String.raw`(?:${SVC})(?![a-z])`, 'g'), ' ').replace(/\b(?:nurse|medical|dental|medical service|chaplain|supply|civil engineer|judge advocate general['’]?s?) corps\b/g, ' ');
+  let key = 'ltColonel';
+  let first = Infinity;
+  for (const [re, level] of UNIT_LEVELS) {
+    const m = text.match(re);
+    if (m && (m.index < first || (m.index === first && level === 'seniorGeneral'))) { first = m.index; key = level; }
+  }
+  if (/\b(deputy|vice)\b/.test(n) || /^executive officer/.test(n)) key = LEVEL_DOWN[key];
+  return key;
+}
+
+/** A rank written as the title, or null; `retired` when it says so. */
+// A serving officer's job, as its own part: "F-35 Pilot", "Intelligence Officer".
+const MIL_ROLE = /\b(pilot|aviator|navigator|operator|surgeon|physician|chaplain|jag|strategist|intelligence|logistics|signal|infantry|armor|artillery|cyber|special forces|seal|ranger|aviation|acquisition|commander|garrison|battalion|brigade|squadron|staff officer)\b/;
+
+function militaryTitle(raw, t, title, rest, prev, next, others, nextRetired = false, after = '') {
+  if (NOT_MILITARY.test(t)) return null;
+  // A civilian word beside the rank ("| Warhammer", "| Fishing Guide") counts unless the rank's own
+  // part names its service; the Coast Guard's name is also on boat captains' licences.
+  const ownService = (STRONG_SERVICE.test(t.replace(/\bgeneral of the army\b/, ' ')) || REST_IS_SERVICE.test(rest)) && !/\b(?:coast guard|uscg)\b/.test(t);
+  if (!ownService && [prev, next].some((p) => p && NOT_MILITARY_NEAR.test(p))) return null;
+  const atOrg = rest.match(/(?:^|\s)(?:at|@)\s+(.+)$/);
+  if (atOrg && !SERVICE_IN.test(atOrg[1]) && !REST_IS_SERVICE.test(atOrg[1])) return null;
+  let n = title.replace(/(?<=[a-z])-(?=[a-z])/g, ' ').replace(/^(?:(?:acting|interim|the)\s+)*/, '');
+  let retired = /\(\s*r\s*\)/.test(raw.toLowerCase());
+  n = n.replace(/,?\s+(?:\(?ret\.?\)?|\(?retired\)?)$/, () => { retired = true; return ''; })
+    .replace(/,?\s+\(?active duty\)?$/, '');
+  let service = SERVICE_IN.test(t) || REST_IS_SERVICE.test(rest) || /^usa(?:,|$)/.test(rest);
+  // A numbered unit, a USS name or "naval" alone is weak: not beside a police
+  // department, a fire rescue, a fan club or any other organization.
+  const weak = service && !STRONG_SERVICE.test(t) && !REST_IS_SERVICE.test(rest);
+  if (weak && (isOrg(rest.replace(/\b(group|company|hospital|battery|troop)\b/g, ' ')) || [prev, next].some((p) => p && !milish(p)))) service = false;
+  const own = service;
+  const lead = n.match(new RegExp(`^(?:${SVC}|marine)(?:\\s+reserves?)?\\s+`));
+  if (lead) { n = n.slice(lead[0].length); service = true; }
+  const trail = n.match(new RegExp(`(?:\\s+(?:in|with|of) the)?\\s+(?:${SVC})$`));
+  const variants = trail ? [n, n.slice(0, -trail[0].length)] : [n];
+  if (trail) service = true;
+  // A service in a part of its own is the rank's when nothing else is named
+  // beside the rank but its units and places ("Commander, 1st Brigade | U.S.
+  // Army"), not a civilian employer ("Commander, Security Group, Northwind
+  // Casino | U.S. Army"); one further off past another title ("LTC |
+  // Acquisition Officer | U.S. Army"), not past an employer ("Captain | Delta
+  // Air Lines | Retired USAF" is an airline captain).
+  const servicePart = (p) => SERVICE_ONLY.test(p) || /^(?:the )?(?:u\.?\s?s\.? )?(?:central|european|pacific|indo-pacific|africa|southern|northern|special operations|cyber|space|strategic|transportation) command$/.test(p);
+  const alone = servicePart(next) ? next : !rest && servicePart(prev) ? prev : null;
+  const unitsOnly = pieces(rest).every((p) => SERVICE_IN.test(p) || REST_IS_SERVICE.test(p) || PLACE.test(p)
+    || (MIL_UNIT.test(p) && !isOrg(p) && /\d|\b(?:[ivxl]+|fort|camp|joint|naval|marine|battalion|brigade|squadron|regiment|fleet|garrison|infantry|airborne|cavalry|artillery|special forces|seal team|detachment|task force|expeditionary|corps)\b/.test(p)));
+  const formerThen = alone === next && !!after && (isOrg(after) || NOT_MILITARY_NEAR.test(after)) && !milish(after);   // "Captain | Former USAF | Delta Air Lines"
+  // A service before the rank with an employer after it ("U.S. Navy | Captain | Delta Air Lines"),
+  // or a civilian job just before a bare rank ("Claims Handler | Admiral | Royal Navy Reserve").
+  const otherSide = alone === next ? prev : next;
+  const flanked = !otherSide || milish(otherSide);   // "Claims Handler | Admiral | Royal Navy Reserve" isn't
+  const jobBefore = !rest && !!prev && !milish(prev);
+  if (alone && unitsOnly && !formerThen && flanked) { service = true; if (alone === next && (RETIRED_SERVICE.test(next) || nextRetired)) retired = true; }
+  // A service further off, past only the rank's own jobs and units ("LTC | Acquisition Officer |
+  // U.S. Army", "Colonel | 82nd Airborne Division | U.S. Army"), never past an employer.
+  const milPart = (p) => !isOrg(p) && !(isGovOrg(p) && !SERVICE_ONLY.test(p)) && !NOT_MILITARY.test(p) && !NOT_MILITARY_NEAR.test(p)
+    && (!!readPart(p) || MIL_ROLE.test(p) || RETIRED_ONLY.test(p) || (MIL_UNIT.test(p) && /\d|\b(?:division|brigade|battalion|squadron|wing|regiment|fleet|command)\b/.test(p)));
+  const at = others.indexOf(t);
+  const far = at < 0 ? -1 : others.findIndex((o, i) => i > at + 1 && servicePart(o));
+  if (!service && !rest && !jobBefore && far > 0 && others.slice(at + 1, far).every(milPart)) service = true;
+  for (let v of variants) {
+    let short = false;
+    for (const [re, full] of RANK_SHORT) {
+      if (re.test(v)) {
+        if (LOOKALIKE_SHORT.test(v) && !own && !others.every((o) => o === t || milish(o))) return null;
+        v = v.replace(re, full); short = true; break;
+      }
+    }
+    for (const [re, key, needsService] of RANKS) {
+      if (!re.test(v)) continue;
+      if ((needsService || short) && !service) return null;
+      const naval = NAVY_IN.test(t) || (!!alone && NAVY_IN.test(alone));
+      const level = key === 'captain' ? (naval ? 'colonel' : 'major')
+        : key === 'lieutenant' ? (naval ? 'major' : null)
+          : key === 'commander' ? commandLevel(v, rest) : key;
+      return level ? { key: level, retired } : null;
+    }
+  }
+  return null;
+}
+
+// Government titles, [the whole title after LEAD, a level or (c) => level | null].
+// The first pattern that matches decides; a function that returns SKIP lets the
+// later ones try. `c` is { n: the title without LEAD, rest: the part's text
+// after the title, prev, next and after: the parts before and after it, text:
+// the part with the parts on either side, at: whether the part names its
+// organization with "at", us: whether the title says "U.S." }.
+//
+// A title means government only where its organization is a government's
+// (where(), below): "Controller, State of Florida", not "Controller |
+// Texas | Northwind Homes". Only a title nobody else holds counts with no
+// organization named ("State Senator", "Special Agent in Charge"); one that
+// others hold too needs its government named ("Mayor, City of Orlando",
+// "Administrator, U.S. Small Business Administration"), or to be the whole
+// headline ("Mayor of Orlando", "Secretary of Commerce").
+const SKIP = Symbol('not this pattern');
+const place = String.raw`(?:(?:${STATES}|al|ak|az|ar|ca|co|ct|de|fl|ga|hi|id|il|in|ia|ks|ky|la|me|md|ma|mi|mn|ms|mo|mt|ne|nv|nh|nj|nm|ny|nys|nc|nd|oh|ok|or|pa|ri|sc|sd|tn|tx|ut|vt|va|wa|wv|wi|wy) (?:state )?)?`;
+// Courts named by their circuit or district: "Ninth Circuit", "Middle District of Florida".
+const JUDICIAL_AREA = new RegExp(String.raw`^(?:the )?(?:(?:first|second|third|fourth|fifth|sixth|seventh|eighth|ninth|tenth|eleventh|twelfth|thirteenth|fourteenth|fifteenth|sixteenth|seventeenth|eighteenth|nineteenth|twentieth|federal|d\.?c\.?|\d+(?:st|nd|rd|th)) (?:judicial )?circuit(?: court)?(?: of [a-z ]+)?|(?:(?:northern|southern|eastern|western|middle|central) )?district of (?:${STATES}))$`);
+const INTERNATIONAL_BODY = new RegExp(String.raw`^(?:the )?(?:${INTERNATIONAL})$`);
+const INTERNATIONAL_IN = new RegExp(String.raw`\b(?:${INTERNATIONAL})\b`);
+// An organization anyone can see is one: a company the lists know, or a name
+// with a company's, a school's or a club's word ("Northwind Pharmaceuticals").
+const ORG_WORD = /\b(inc|llc|ltd|corp|corporation|co|company|group|brands?|foods?|beverages?|pharma\w*|health|healthcare|bank|capital|partners|solutions|services|systems|technolog(?:y|ies)|labs?|media|studios?|apparel|fitness|coaching|consulting|realty|homes|law|title|insurance|airlines?|air lines|university|college|school|academy|institute|association|society|club|league|foundation|church|collective|agency|ventures|holdings|enterprises|industries|motors|logistics|staffing|restaurants?|cafe|coffee|sake|tequila|whisk(?:e)?y|wines?|spirits|brewing|distillery|hotels?|resorts?|casino|creative|design|digital|software|network|plan|clinic|hospital|medical|dental|pharmacy|store|shop|market|mall|refinery|plant|repair|recruiting|properties|real estate|mortgage|lending|financial|investments?|wealth|trust|credit union|kitchen|grill|bakery|diner|martial arts|dojo|gym|maritime|shipping|care|home care|living|travel|tours|yoga|retreats?|wellness|podcast|seeds|exports?|imports?)\b/;
+const DEPT_OF = new RegExp(String.raw`^${DEPT}\b`);
+// Cities people are mayors of: the largest U.S. cities, the state capitals and
+// some more. "Mayor of Tampa" names a city; "Mayor of Candyland" doesn't.
+const CITY = new RegExp(String.raw`^(?:the )?(?:city of )?(?:new york|new york city|los angeles|chicago|houston|phoenix|philadelphia|san antonio|san diego|dallas|austin|jacksonville|fort worth|san jose|columbus|charlotte|indianapolis|san francisco|seattle|denver|oklahoma city|nashville|el paso|las vegas|boston|detroit|portland|louisville|memphis|baltimore|milwaukee|albuquerque|tucson|fresno|sacramento|mesa|kansas city|atlanta|omaha|colorado springs|raleigh|long beach|virginia beach|miami|oakland|minneapolis|tulsa|bakersfield|wichita|arlington|aurora|tampa|new orleans|cleveland|honolulu|anaheim|lexington|stockton|corpus christi|henderson|riverside|newark|saint paul|st\. paul|santa ana|cincinnati|irvine|orlando|pittsburgh|st\. louis|saint louis|greensboro|jersey city|anchorage|lincoln|plano|durham|buffalo|chandler|chula vista|toledo|madison|gilbert|reno|fort wayne|north las vegas|st\. petersburg|saint petersburg|lubbock|irving|laredo|winston-salem|chesapeake|glendale|garland|scottsdale|norfolk|boise|fremont|spokane|santa clarita|baton rouge|richmond|hialeah|san bernardino|tacoma|modesto|huntsville|des moines|yonkers|rochester|moreno valley|fayetteville|fontana|columbus|worcester|port st\. lucie|little rock|augusta|oxnard|birmingham|montgomery|frisco|amarillo|salt lake city|grand rapids|huntington beach|overland park|glendale|tallahassee|grand prairie|mckinney|cape coral|sioux falls|peoria|providence|vancouver|knoxville|akron|shreveport|mobile|brownsville|newport news|fort lauderdale|chattanooga|tempe|ontario|santa rosa|elk grove|salem|pembroke pines|eugene|garden grove|cary|fort collins|corona|springfield|jackson|alexandria|hayward|clarksville|lakewood|lancaster|salinas|palmdale|springfield|macon|sunnyvale|pomona|killeen|escondido|pasadena|naperville|bellevue|joliet|murfreesboro|midland|rockford|paterson|savannah|bridgeport|torrance|mcallen|syracuse|surprise|denton|roseville|thornton|miramar|mesquite|olathe|dayton|carrollton|waco|orange|fullerton|charleston|west valley city|visalia|hampton|gainesville|warren|coral springs|cedar rapids|round rock|sterling heights|kent|columbia|santa clara|new haven|stamford|concord|elizabeth|athens|thousand oaks|lafayette|simi valley|topeka|norman|fargo|wilmington|abilene|odessa|pearland|victorville|hartford|vallejo|allentown|berkeley|richardson|arvada|ann arbor|cambridge|sugar land|lansing|evansville|college station|fairfield|clearwater|beaumont|independence|provo|west jordan|murrieta|palm bay|el monte|carlsbad|charleston|temecula|clovis|meridian|westminster|costa mesa|high point|manchester|pueblo|lakeland|pompano beach|west palm beach|antioch|everett|downey|lowell|centennial|elgin|broken arrow|miami gardens|billings|jurupa valley|sandy springs|gresham|lewisville|hillsboro|ventura|greeley|inglewood|waterbury|league city|santa maria|tyler|davie|daly city|boulder|allen|west covina|sparks|wichita falls|green bay|san mateo|norwalk|rialto|las cruces|chico|el cajon|burbank|south bend|renton|vista|davenport|edinburg|tuscaloosa|kenosha|albany|annapolis|augusta|bismarck|carson city|cheyenne|dover|frankfort|harrisburg|helena|jefferson city|juneau|montpelier|olympia|pierre|santa fe|trenton|winter park|winter garden|kissimmee|sanford|oviedo|maitland|altamonte springs|daytona beach|sarasota|naples|boca raton|delray beach|key west|ocala|pensacola|plant city|palm beach|miami beach|coral gables|hoboken|asheville|boulder|flagstaff|santa barbara|palo alto|mountain view|redmond|kirkland|scottsdale|sedona)(?:,\s*(?:[a-z]{2}|${STATES}))?$`);
+// A municipality named as one: "Plant City", "League City", "College Station".
+const MUNICIPALITY = /^[a-z .'-]+ (?:city|town|township|village|borough|station|springs|beach|heights|falls)$/;
+const MUNICIPALITY_OF = /\bof (?:the )?[a-z .'-]+ (?:city|town|township|village|borough|station|springs|beach|heights|falls)\b/g;
+const JOKE_PLACE = /\b(downtown|midtown|uptown|flavortown|funkytown|linkedin|twitter|tiktok|instagram|youtube|social media|the internet|the (block|neighborhood|hood|office|house)|my (house|block|street|home)|[a-z]+ town|real estate|sales|marketing|content|mortgages?)\b/;
+const SALES = /\b(account|sales|manager|representative|specialist|consultant|recruiter|advisor|adviser|hr|benefits|payroll|lead|business development|partner)\b/;
+const FED_RESERVE = /\bfederal reserve (board|system)\b|\bboard of governors of the federal reserve\b|^(the )?federal reserve$/;
+
+const pieces = (s) => s.replace(/^(?:at|@)\s+/, '').replace(/(\S)\s*\([^)]*\)/g, '$1').split(/,\s*/).map((p) => p.trim()).filter(Boolean);
+// A state's or the federal government's own body by its name: "Florida Public
+// Service Commission", "Texas Medical Board", "Nuclear Regulatory Commission".
+const STATE_BODY = new RegExp(String.raw`^(?:the )?(?:(?:${STATES})(?! city)(?: state)? )?(?:public service|public utilit(?:y|ies)|corporation|railroad) commission$|^(?:the )?(?:${STATES})(?! city)(?: state)? (?:gaming|ethics|elections?|parole|pardons and paroles|lottery|racing|athletic|real estate|medical|nursing|pharmacy|dental|bar examiners|workers['’]? compensation|industrial|civil service|human rights|tax|utility|water|environmental quality|fish and (?:game|wildlife)) (?:commission|board)$|^(?:the )?${FED_BODY}$`);
+// A company the lists know is a government only when its own name says so
+// (the public dataset has the U.S. Senate and the IRS): "Norfolk Southern
+// Police Department" is the railroad's.
+const govName = (name) => GOV_ORG.test(name) || AGENCY.test(name) || LEGIS.test(name) || STATE_BODY.test(name) || SERVICE_ONLY.test(name) || /\bu\.?\s?s\.? courts?\b/.test(name);
+const knownCompany = (p) => isKnownCompany(p) && !govName(String(cleanCompany(p) || '').toLowerCase());
+// A police or fire department named for a company, a campus or a mall is theirs.
+const privateForce = (p) => { const m = p.match(/^(.+?)\s+(?:police|fire|public safety)(?: department)?$/); return !!m && (isOrg(m[1]) || isKnownCompany(m[1]) || /\b(campus|mall|railroad|railway|university|college|school|hospital|airport)\b/.test(m[1])); };
+const isGovOrg = (p) => !NOT_GOV.test(p) && !CIVIC.test(p) && !STUDENT_ORG.test(p) && !knownCompany(p) && !privateForce(p) && (GOV_ORG.test(p) || LOCAL_GOV.test(p) || STATE_ITSELF.test(p) || LEGIS.test(p) || AGENCY.test(p)
+  || (TRIBAL_GOV.test(p) && !TRIBAL_BUSINESS.test(p) && !isOrg(p)) || INTERNATIONAL_BODY.test(p) || JUDICIAL_AREA.test(p) || STATE_BODY.test(p) || SERVICE_ONLY.test(p));
+const isOrg = (p) => ORG_WORD.test(p) || isKnownCompany(p);
+// A tag after a title that names no organization: a party and state ("(R-FL)"), a bracket.
+const TAG = /^\(?[rdi]-?[a-z]{2}(?:-\d+)?\)?$|^\(.*\)$|^[a-z]{2}-(?:\d{1,2}|al)$|^(?:19|20)\d\d\s*[-–]\s*(?:(?:19|20)\d\d|present)$|^(?:[a-z .]+['’]s? )?\d+(?:st|nd|rd|th) (?:congressional |assembly |senate |house )?(?:district|ward)$/;
+// A place a local office can name without its government's word: after its
+// comma any name that isn't an organization or a title ("City Councilmember,
+// Orlando"); as a part of its own only a county, a district or "City, State"
+// ("Mayor | Oviedo, Florida").
+const CITY_STATE = new RegExp(String.raw`^[a-z .'-]{2,30},\s*(?:[a-z]{2}|${STATES})$`);
+const placeLike = (p, own = true) => PLACE.test(p) || LOCAL_PLACE.test(p) || CITY_STATE.test(p)
+  || (own && (CITY.test(p) || (MUNICIPALITY.test(p) && !JOKE_PLACE.test(p) && !BODY_WORD.test(p))));
+// A name with a body's word is an organization, not a place: "The Joint Commission", "City Year".
+const BODY_WORD = /\b(commission|council|committee|board|association|league|chamber|foundation|society|institute|club|center|centre|program|group|agency|office|department|authority|bureau|services?|team|network|alliance|coalition|project|initiative|fund|trust|year|corps|federation|union|guild|partnership)\b/;
+// A piece after a comma that is a second title, not an organization: "Ambassador, Deputy Permanent Representative…".
+const anotherTitle = (p) => !isOrg(p) && !!readPart(p);
+/**
+ * Where the title is held: 'gov' when its organization is a government's,
+ * 'other' when it's some other organization, 'none' when none is named. The
+ * organization is the rest of the part ("Mayor, City of Orlando"); with none
+ * there, the next part, past a place ("Controller | Texas | Northwind
+ * Homes"), or a headline's first part when it's a government's ("State of
+ * Ohio | Governor"). Anything after a comma is an organization but a second
+ * title; a part of its own only when it looks like one, since it may be
+ * another title or who they are ("Retired Judge | Mediator").
+ */
+function whereOwn(c) {
+  const own = pieces(c.rest).filter((p) => !TAG.test(p));
+  if (own.some((p) => CIVIC.test(p) || STUDENT_ORG.test(p))) return 'other';
+  if (own.some(isGovOrg)) return 'gov';
+  return own.some((p) => !placeLike(p) && (isOrg(p) || CIVIC.test(p) || (!NOT_AN_ORG.test(p) && !anotherTitle(p)))) ? 'other' : 'none';
+}
+// A part that says who someone is or what else they do, not an employer: a
+// job title, a family or a hobby word ("Podcast Host", "Swim Dad", "Little
+// League Coach", "Former Police Chief").
+const BIO = /\b(host|personality|commentator|contributor|analyst|lover|dad|mom|father|mother|husband|wife|coach|fan|advocate|referee|deacon|elder|volunteer|mentor|planner|author|speaker|veteran|runner|golfer|reader|traveler|enthusiast|former|retired|ex-|alum\w*)\b/;
+const PARTY = /^(?:a |proud )?(?:democrat|republican|independent|libertarian|conservative|progressive|moderate)s?$|^\(?[rdi]\)?$/;
+const employer = (p) => !!p && (isOrg(p) || CIVIC.test(p) || STUDENT_ORG.test(p)) && !readPart(p) && !BIO.test(p) && !PARTY.test(p) && !isGovOrg(p);
+// For a title that names its government ("County Sheriff", "Mayor of Tampa",
+// "Ohio State Treasurer"): the other parts are its bio unless they name an employer.
+function whereSoft(c) {
+  const own = whereOwn(c);
+  if (own !== 'none') return own;
+  const next = [c.next, PLACE.test(c.next) || LOCAL_PLACE.test(c.next) || CITY_STATE.test(c.next) ? c.after : ''];
+  return next.some((p) => employer(p)) ? 'other' : next.some((p) => p && isGovOrg(p)) || (c.prevLeads && isGovOrg(c.prev)) ? 'gov' : 'none';
+}
+const soft = (key) => (c) => (whereSoft(c) === 'other' ? null : key);
+function where(c) {
+  const own = whereOwn(c);
+  if (own !== 'none') return own;
+  for (const p of [c.next, c.after]) {
+    if (!p) break;
+    if (isGovOrg(p)) return 'gov';
+    if (!PLACE.test(p) && !LOCAL_PLACE.test(p)) {
+      if (CIVIC.test(p) || STUDENT_ORG.test(p) || (!/\s(?:at|@)\s/.test(` ${p} `) && isOrg(p))) return 'other';
+      break;
+    }
+  }
+  return c.prevLeads && isGovOrg(c.prev) ? 'gov' : 'none';
+}
+// A local office's place: its own part's, or the next part's when that is only a place.
+const localPlace = (c) => pieces(c.rest).some((p) => placeLike(p)) || (!c.rest && !!c.next && placeLike(c.next, false) && where(c) !== 'other');
+// The title is the whole headline (a place after it aside).
+const alone = (c) => !c.prev && !c.next && pieces(c.rest).every((p) => PLACE.test(p) || TAG.test(p));
+const besides = (c) => [...pieces(c.rest), c.prevLeads ? c.prev : '', c.next].filter(Boolean);
+const houseOf = (c) => besides(c).some((p) => LEGIS.test(p)) || /\bhouse district \d+/.test(c.part);
+const congress = (c) => /\b(u\.?\s?s\.?|united states) (house|senate|congress)\b|\bcongressional district\b/.test(c.n)
+  || besides(c).some((p) => /^(?:the )?(?:u\.?\s?s\.?|united states) (?:house of representatives|house|senate|congress)$|congressional district(?: \d+)?$|^(the )?congress$/.test(p));
+const houseOwn = (c) => pieces(c.rest).some((p) => LEGIS.test(p));
+const inState = (c) => STATE_NAME.test(c.n) || besides(c).some((p) => STATE_GOV.test(p) || JUST_A_STATE.test(p));
+// Judging that isn't a court's, in the part or the next part when it's where the title is held.
+const notCourt = (c) => NOT_COURT.test(c.part) || (!c.rest && NOT_COURT.test(c.next));
+// Nobody else holds these: any organization but some other one will do.
+const notOther = (key) => (c) => (where(c) === 'other' ? null : key);
+// Titles only officials hold: the other parts are their bio, not where the
+// title is held ("U.S. Senator | Podcast Host").
+const ownOnly = (key) => (c) => (whereSoft(c) === 'other' ? null : key);
+const FOREIGN_WORDS = /\b(department of state|state department|foreign service|embassy|consulate|u\.?\s?s\.? mission|united nations|nato|usaid|diplomat)\b/;
+const FOREIGN = { test: (p) => FOREIGN_WORDS.test(p) && !/\b(program|fulbright|alumni|club|volunteer|society|association|scholar|suites|hotel|hilton|inn)\b/.test(p) };
+// A title that needs its government named, unless it's the whole headline.
+const needGov = (key) => (c) => (where(c) === 'gov' || alone(c) ? key : null);
+// Nothing else in the headline but the title (tags and places aside), or only a government beside it.
+const nothingElse = (c) => alone(c) || where(c) === 'gov';
+const GOV = [
+  // Congress and the legislatures.
+  [String.raw`(?:u\.?\s?s\.?|united states) senator(?: (?:for|from) .*)?`, ownOnly('govLeader')],
+  [String.raw`${place}state senator(?: .*)?`, ownOnly('govSenior')],
+  [String.raw`senator`, (c) => (c.us ? ownOnly('govLeader')(c) : SKIP)],
+  [String.raw`${place}state (?:representative|rep\.?|delegate|assembly ?(?:member|man|woman|person)|legislator)(?: .*)?`, (c) => (whereSoft(c) !== 'other' && (houseOf(c) || inState(c) || /\bdistrict\b/.test(`${c.n} ${c.rest} ${c.next}`)) ? 'govSenior' : null)],
+  [String.raw`${place}(?:district \d+ )?senator(?: (?:for|from|of) .*)?`, (c) => (where(c) === 'other' ? null : congress(c) ? 'govLeader'
+    : houseOf(c) || STATE_NAME.test(c.n) || (where(c) === 'gov' && inState(c)) ? 'govSenior' : null)],
+  [String.raw`(?:u\.?\s?s\.?|united states) representative (?:for|from) (?:${STATES})['’]?s? (?:\d+(?:st|nd|rd|th)|at-large)(?: congressional)? district`, 'govLeader'],
+  [String.raw`congress(?:wo)?man(?: (?:for|from) .*)?|congressperson(?: (?:for|from) .*)?|member of (?:the )?(?:u\.?\s?s\.?\s|united states )?congress|(?:member|delegate) (?:of|to) the (?:u\.?\s?s\.?|united states) house of representatives|resident commissioner(?: of puerto rico)?`, ownOnly('govLeader')],
+  [String.raw`(?:(?:u\.?\s?s\.?|united states|congressional) )?(?:representative|rep\.?)(?: (?:for|from|of) .*)?|member|legislator`, (c) => (where(c) === 'other' ? SKIP : congress(c) ? 'govLeader'
+    : houseOf(c) ? 'govSenior' : besides(c).some((p) => /\bcounty legislature\b/.test(p)) ? 'govOfficial' : SKIP)],
+  [String.raw`(?:(?:(?!(?:assistant|aide|driver|secretary|speechwriter|son|daughter|wife|husband|married|future|aspiring|campaign|former|endorsed|staff|intern|clerk|to|for|of|by|the|a|an|with)\b)[a-z.'-]+ ){0,3})?county legislator(?:, .*)?`, (c) => (nothingElse(c) || pieces(c.rest).some((p) => placeLike(p)) ? 'govOfficial' : null)],
+  [String.raw`member of the (?:[a-z.']+ ){0,3}(?:house of (?:representatives|delegates)|state assembly|assembly|state senate|senate|legislature|general assembly)(?: (?:from|for|representing) .*)?`, (c) => (where(c) !== 'other' && inState(c) ? 'govSenior' : null)],
+  [String.raw`${place}(?:assembly ?(?:member|man|woman|person)(?: .*)?|delegate(?: .*)?)`, (c) => (where(c) !== 'other' && (houseOf(c) || (STATE_NAME.test(c.n) && !/delegate/.test(c.n))) && inState(c) ? 'govSenior' : null)],
+  [String.raw`${place}(?:state )?(?:(?:senate|house|assembly) )?(?:majority|minority) (?:leader|whip)(?: .*)?|speaker(?: pro tem(?:pore)?)?(?: of the (?:u\.?\s?s\.?\s)?(?:house|assembly)(?: of (?:representatives|delegates))?)?(?: .*)?|(?:senate )?president(?: pro tem(?:pore)?)?(?: of the (?:[a-z.']+ ){0,2}senate)?`,
+    (c) => (!(/\b(senate|house|assembly|legislature)\b/.test(c.n) || houseOwn(c)) || whereOwn(c) === 'other' ? SKIP
+      : congress(c) ? 'govLeader' : inState(c) || /\bstate\b/.test(`${c.n} ${c.rest}`) ? 'govSenior'
+        : houseOwn(c) || alone(c) ? 'govLeader' : SKIP)],
+  // Governors and statewide offices.
+  [String.raw`(?:(?:${STATES}) )?(?:lieutenant|lt\.?) governor(?: of (?:the (?:state|commonwealth) of )?(?:${STATES}))?`, (c) => (STATE_NAME.test(c.n) ? ownOnly('govSenior')(c) : where(c) !== 'other' && inState(c) && !c.after ? 'govSenior' : null)],
+  [String.raw`(?:(?:${STATES}) )?governor(?: of (?:the (?:state|commonwealth|territory) of )?(?:${STATES}))?|governor of the (?:federal reserve(?: system| board)?|board of governors of the federal reserve(?: system)?)|governor of the pueblo of [a-z ]+|governor of (?:the )?[a-z' -]+ nation`,
+    (c) => {
+      const ownRest = pieces(c.rest).filter((p) => !TAG.test(p));
+      const own = ownRest.length ? ownRest : [c.next, c.prevLeads ? c.prev : ''];
+      if (FED_RESERVE.test(c.n) || /federal reserve/.test(c.n) || own.some((p) => FED_RESERVE.test(p))) return 'govSenior';
+      if (/pueblo of| nation$/.test(c.n)) return 'govLeader';
+      if (STATE_NAME.test(c.n)) return whereOwn(c) === 'other' ? null : 'govLeader';
+      if (where(c) === 'other') return null;
+      if (own.some((p) => TRIBAL_GOV.test(p) && !TRIBAL_BUSINESS.test(p))) return 'govLeader';
+      return STATE_NAME.test(c.n) || own.some((p) => JUST_A_STATE.test(p) || STATE_ITSELF.test(p)) ? 'govLeader' : null;
+    }],
+  [String.raw`federal reserve governor|member of the board of governors of the federal reserve(?: system)?`, 'govSenior'],
+  // A statewide officer names the state in the title or as the organization:
+  // "State Treasurer", "Insurance Commissioner, State of Georgia". A
+  // department's own auditor or a company's controller isn't one.
+  [String.raw`${place}(?:state )?(?:treasurer|comptroller|controller|auditor|auditor general|superintendent of public instruction|commissioner of (?:agriculture|insurance|education|labor|revenue)|land commissioner|insurance commissioner|(?:agriculture|education|labor|revenue|railroad) commissioner|surgeon general)(?: (?:of|for) .*)?`,
+    (c) => (STATE_NAME.test(c.n) && whereSoft(c) !== 'other') || (/^state /.test(c.n) && nothingElse(c))
+      || (!/^(?:controller|auditor)$/.test(c.n) && (pieces(c.rest).some((p) => STATE_ITSELF.test(p)) || (!c.rest && STATE_ITSELF.test(c.next)))) ? 'govSenior' : SKIP],
+  // Cities, counties and tribes.
+  [String.raw`mayor pro tem(?:pore)?(?:, .*)?`, needGov('govOfficial')],
+  [String.raw`(?:deputy|vice|assistant) mayor(?: for .*)?`, (c) => (where(c) === 'gov' || alone(c) || (/ for /.test(c.n) && whereSoft(c) !== 'other') || ((pieces(c.rest).some((p) => placeLike(p)) || CITY_STATE.test(c.next)) && whereSoft(c) !== 'other') ? 'govSenior' : null)],
+  [String.raw`mayor(?: of .*)?`, (c) => {
+    const w = where(c);
+    if (w === 'gov' || (w === 'none' && /\b(city|town|village|borough|township) of\b/.test(c.n))) return 'govLeader';
+    const of = c.n.match(/^mayor of (?:the )?(.+)$/);
+    // A city named beside the title: "Mayor | Oviedo, Florida", "Mayor, Winter Park".
+    const beside = pieces(c.rest)[0] || (!c.rest ? c.next : '');
+    if (w !== 'other' && !of && beside && !JOKE_PLACE.test(beside) && (pieces(c.rest).some((p) => placeLike(p)) || CITY_STATE.test(c.next)) && whereSoft(c) !== 'other') return 'govLeader';
+    return of && !c.prev && (CITY.test(of[1]) || CITY_STATE.test(of[1]) || MUNICIPALITY.test(of[1])) && !JOKE_PLACE.test(of[1]) && !isKnownCompany(of[1]) && whereSoft(c) !== 'other' ? 'govLeader' : null;
+  }],
+  [String.raw`(?:(?:(?!(?:assistant|aide|driver|secretary|speechwriter|son|daughter|wife|husband|married|future|aspiring|campaign|former|endorsed|staff|intern|clerk|to|for|of|by|the|a|an|with)\b)[a-z.'-]+ ){0,3})?county (?:executive|mayor|judge executive)(?: of .*)?`, (c) => (nothingElse(c) || pieces(c.rest).some((p) => placeLike(p)) || (!c.rest && LOCAL_PLACE.test(c.next) && !c.after) ? 'govLeader' : null)],
+  [String.raw`(?:principal )?chief|(?:tribal )?(?:chairman|chairwoman|chairperson|president)`, (c) => (!c.at && (c.rest ? pieces(c.rest) : [c.next]).some((p) => TRIBAL_GOV.test(p) && !TRIBAL_BUSINESS.test(p) && !isOrg(p)) ? 'govLeader' : SKIP)],
+  // "City Manager" is also a gig app's or a mobility company's operations
+  // title (Uber, Lime): only with a government's name.
+  [String.raw`(?:(?:assistant|deputy|acting|interim) )?(?:(?:(?!(?:assistant|aide|driver|secretary|speechwriter|son|daughter|wife|husband|married|future|aspiring|campaign|former|endorsed|staff|intern|clerk|to|for|of|by|the|a|an|with)\b)[a-z.'-]+ ){0,2}(?:county|town|village|borough)|city) (?:administrator|manager)(?: .*)?`,
+    (c) => { const w = where(c); return w === 'gov' || (w === 'none' && ((pieces(c.rest).some((p) => placeLike(p)) && !c.next) || ((alone(c) || localPlace(c)) && !/\bcity (manager|administrator)\b/.test(c.n)))) ? 'govOfficial' : null; }],
+  // Cabinets: the federal one's, and a state's when it says so. With no
+  // government named, only the whole headline or "U.S." ("Secretary of
+  // Education | Homeschool Mom" is a joke).
+  [String.raw`${place}secretary of (?:state|defense|war|commerce|labor|education|energy|agriculture|transportation|veterans affairs|homeland security|health(?: and human services)?|housing and urban development|the (?:treasury|interior|army|navy|air force))(?: (?:of|for) .*)?`,
+    (c) => {
+      if (/secretary of state of /.test(c.n) && !STATE_NAME.test(c.n)) return null;
+      const w = c.us || STATE_NAME.test(c.n) ? whereSoft(c) : where(c);
+      if (w === 'other') return null;
+      if (STATE_NAME.test(c.n) || besides(c).some((p) => STATE_GOV.test(p) || JUST_A_STATE.test(p))) return 'govSenior';
+      return c.us || w === 'gov' || alone(c) ? 'govLeader' : null;
+    }],
+  [String.raw`deputy assistant secretary(?: (?:of|for) .*)?`, (c) => (CORP_OFFICER.test(c.part) ? null : (/ of /.test(c.n) ? (DEPT_OF.test(c.n.replace(/^.*? of /, '')) && whereOwn(c) !== 'other') : nothingElse(c)) ? 'govOfficial' : null)],
+  // An under, deputy or assistant secretary "of" a department, or "for" a
+  // policy area; not a company's ("Assistant Secretary of Northwind Foods").
+  [String.raw`(?:deputy under|deputy|under)[-\s]?secretary(?: (?:of|for) .*)?|undersecretary(?: .*)?|assistant secretary(?: (?:of|for) .*)?`,
+    (c) => {
+      if (CORP_OFFICER.test(c.part) || whereOwn(c) === 'other') return null;
+      const of = c.n.match(/\b(of|for) (.+)$/);
+      if (of && of[1] === 'of') return DEPT_OF.test(of[2]) ? 'govSenior' : null;
+      if (where(c) === 'other') return null;
+      if (of) return where(c) === 'gov' || alone(c) || c.us ? 'govSenior' : null;
+      return where(c) === 'gov' ? 'govSenior' : null;
+    }],
+  [String.raw`(?:deputy )?(?:national security advis[eo]r|director of national intelligence)|white house chief of staff|director of the office of management and budget`, (c) => (where(c) === 'other' ? null : /^deputy/.test(c.n) ? 'govSenior' : 'govLeader')],
+  // A university's or a company's president has assistants too.
+  [String.raw`(?:deputy )?assistant to the president(?: (?:for|and) .*)?`, (c) => (/of the united states/.test(c.n) || (where(c) === 'gov' && [c.rest, c.next, c.prevLeads ? c.prev : ''].some((p) => /\b(white house|executive office of the president|national security council|nsc)\b/.test(p))) ? (/^deputy/.test(c.n) ? 'govSenior' : 'govLeader') : null)],
+  // A beverage brand's trade representative sells to its trade.
+  [String.raw`(?:deputy )?(?:u\.?\s?s\.?\s|united states )?trade representative`, (c) => (where(c) !== 'other' && (c.us || /\b(ustr|office of the (u\.?\s?s\.?|united states) trade representative)\b/.test(c.text)) ? (/^deputy/.test(c.n) ? 'govSenior' : 'govLeader') : null)],
+  [String.raw`director`, (c) => (/^(?:the )?(?:office of management and budget|federal bureau of investigation|central intelligence agency|national security agency|u\.?\s?s\.? secret service|u\.?\s?s\.? marshals service|u\.?\s?s\.? census bureau|national institutes of health|centers for disease control and prevention|u\.?\s?s\.? mint|bureau of alcohol, tobacco, firearms and explosives)$/.test(c.rest || (!c.prev && !c.after ? c.next : '')) || /^(?:the )?(?:fbi|cia|nsa|atf|dea)$/.test(c.rest) ? 'govSenior' : SKIP)],
+  [String.raw`(?:fbi|cia|nsa|atf|dea|cdc|nih) director`, (c) => (where(c) === 'gov' || alone(c) ? 'govSenior' : null)],
+  [String.raw`postmaster general|librarian of congress|archivist of the united states|auditor general of the (?:army|navy|air force)`, notOther('govSenior')],
+  [String.raw`(?:u\.?\s?s\.?\s|united states )?special (?:presidential )?envoy(?: .*)?`, (c) => (/ to the (ceo|cto|coo|cfo|founders?|president|chair\w*|board)\b/.test(c.n) ? null : where(c) === 'gov' || (where(c) === 'none' && (c.us || /presidential/.test(c.n) || (alone(c) && / for /.test(c.n)))) ? 'govSenior' : null)],
+  [String.raw`charge d'affaires(?: .*)?`, (c) => (c.us || (where(c) === 'gov' && [c.rest, c.next].some((p) => FOREIGN.test(p))) ? 'govSenior' : null)],
+  [String.raw`(?:under|assistant)[-\s]secretary[-\s]general(?: .*)?`, notOther('govSenior')],
+  [String.raw`special agent in charge|assistant special agent in charge|chief patrol agent|undersheriff`, needGov('govOfficial')],
+  // A hospital's, a home-health chain's or a senior-living company's
+  // regional and associate administrators are theirs.
+  [String.raw`(?:regional|associate|deputy associate) administrator|assistant inspector general(?: .*)?|(?:principal )?deputy assistant attorney general(?: .*)?|associate deputy attorney general(?: .*)?`,
+    (c) => (where(c) === 'gov' || (/inspector general|attorney general/.test(c.n) && where(c) !== 'other') ? 'govOfficial' : null)],
+  [String.raw`director of the (?:fbi|cia|nsa|federal bureau of investigation|central intelligence agency|national security agency|secret service|u\.?\s?s\.? marshals service)|(?:u\.?\s?s\.?|united states) marshal(?: for .*)?|comptroller (?:general of the united states|of the currency)|treasurer of the united states`, ownOnly('govSenior')],
+  // Lawyers for the government.
+  [String.raw`(?:principal )?deputy associate attorney general(?: .*)?`, notOther('govOfficial')],
+  [String.raw`associate attorney general(?: .*)?`, notOther('govSenior')],
+  [String.raw`(?:principal )?deputy attorney general(?: .*)?|assistant attorney general(?: .*)?`, (c) => (/\b(of the united states|u\.?\s?s\.? department of justice|department of justice|doj)\b/.test(c.text) && !STATE_GOV.test(c.text) ? 'govSenior' : 'senior')],
+  [String.raw`(?:special deputy|special assistant|senior assistant) attorney general(?: .*)?`, 'senior'],
+  [String.raw`${place}attorney general(?: (?:of|for) .*)?`, (c) => ((/ (?:of|for) /.test(` ${c.n} `) || STATE_NAME.test(c.n) || c.us ? ownOnly : needGov)('govLeader')(c))],
+  [String.raw`(?:assistant|deputy|senior assistant|chief assistant|executive assistant) (?:u\.?\s?s\.?|united states|district|state|county|commonwealth(?:['’]s)?) attorney(?: .*)?`, 'senior'],
+  // "US Attorney" is also what a U.S.-qualified lawyer abroad writes: the
+  // U.S. Attorney names a district, or is the whole headline.
+  [String.raw`(?:(?:(?!(?:assistant|aide|driver|secretary|speechwriter|son|daughter|wife|husband|married|future|aspiring|campaign|former|endorsed|staff|intern|clerk|to|for|of|by|the|a|an|with)\b)[a-z.'-]+ ){0,3}county |[a-z .'-]+ city )?(?:u\.?\s?s\.?|united states|district|state|state's|county|commonwealth(?:['’]s)?) attorney(?: (?:for|of) .*)?`,
+    (c) => {
+      if (/\battorney at law\b/.test(c.text)) return null;
+      const w = where(c);
+      if (w === 'other') return null;
+      if (w === 'gov' || pieces(c.rest).some((p) => /\b(district|county|circuit|judicial)\b/.test(p)) || /\bdistrict\b/.test(c.n)) return 'govSenior';
+      return w === 'other' || (c.us && !alone(c)) ? null : 'govSenior';
+    }],
+  [String.raw`deputy (?:inspector general|solicitor general|program executive officer|peo)(?: .*)?`, (c) => (SALES.test(c.n) ? null : notOther('govOfficial')(c))],
+  [String.raw`(?:solicitor|inspector|surgeon|adjutant) general(?: .*)?`, (c) => (/general (counsel|office|staff|investigator|auditor|attorney|agent)/.test(c.n) ? null
+    : / of /.test(c.n) ? (new RegExp(String.raw` of (?:the )?(?:united states|${STATES})$`).test(c.n) ? soft('govSenior')(c) : null)
+      : nothingElse(c) || (!c.rest && JUST_A_STATE.test(c.next) && !c.after) ? 'govSenior' : null)],
+  // Defense and civil-service executives. "PEO" is also a professional
+  // employer organization, the HR industry's word ("PEO Account Manager").
+  [String.raw`program executive officer(?: .*)?`, (c) => (c.service || /\bpeo\b|program executive office/.test(c.rest) || where(c) === 'gov' ? 'govSenior' : null)],
+  [String.raw`(?:member of the )?senior executive service(?: member)?|(?:tier (?:[1-3]|i{1,3}) )?ses(?: tier [1-3])?(?: member)?`, (c) => (/senior executive service/.test(c.n) || c.service || whereOwn(c) === 'gov' || (/tier|member/.test(c.n) && where(c) === 'gov') ? 'govSenior' : null)],
+  // Diplomats and international bodies. A brand's ambassador is theirs: an
+  // ambassador is a diplomat "to" a country, at an embassy or a mission, or
+  // retired as one ("Ambassador (Ret.)"; "Former Ambassador | Lululemon" isn't).
+  [String.raw`secretary[-\s]general(?: of (?:the )?.*)?`, (c) => ([c.n.replace(/^secretary[-\s]general(?: of (?:the )?)?/, ''), ...pieces(c.rest), ...(c.rest ? [] : [c.next])].some((p) => INTERNATIONAL_BODY.test(p)) ? 'govLeader' : null)],
+  [String.raw`(?:u\.?\s?s\.?\s|united states )?ambassador(?: of the united states| extraordinary and plenipotentiary)?(?: to (?:the )?(?:republic of |kingdom of |state of )?(?:${COUNTRIES}|${INTERNATIONAL})(?:,? (?:and|&) (?:the )?(?:${COUNTRIES}))*)?|ambassador-at-large(?: .*)?`,
+    (c) => (whereSoft(c) === 'other' ? null : [c.rest, c.next, c.prevLeads ? c.prev : ''].some((p) => FOREIGN.test(p)) || INTERNATIONAL_IN.test(c.rest)
+      || ((/at-large| to /.test(` ${c.n} `) || c.retTag) && (c.us || alone(c))) ? 'govSenior' : null)],
+  [String.raw`ambassador of (?:the )?(?:${COUNTRIES}) to (?:the )?(?:united states|${COUNTRIES}|${INTERNATIONAL})`, 'govSenior'],
+  [String.raw`(?:deputy |alternate )?(?:permanent )?representative (?:of .* )?to the (?:${INTERNATIONAL})(?: .*)?|(?:deputy |alternate )?permanent representative(?: .*)?`, (c) => (INTERNATIONAL_IN.test(c.text) && where(c) !== 'other' ? 'govSenior' : null)],
+  [String.raw`consul general(?: .*)?`, (c) => (c.us || new RegExp(String.raw` of (?:the )?(?:${COUNTRIES}|united states)\b`).test(c.n) || [c.rest, c.next].some((p) => FOREIGN.test(p)) || alone(c) ? 'govOfficial' : null)],
+  // Courts, not a fair's, a rodeo's or a campus's: the court is named, or the
+  // title says which kind it is ("U.S. District Judge").
+  [String.raw`chief justice(?: .*)?`, (c) => (notCourt(c) ? null : where(c) === 'gov' || (whereOwn(c) !== 'other' && (STATE_NAME.test(c.n) || /united states|supreme court/.test(c.n))) ? 'govLeader' : null)],
+  [String.raw`(?:(?:${STATES}|state|u\.?\s?s\.?) )?supreme court justice`, ownOnly('judge')],
+  [String.raw`(?:associate |presiding )?justice(?: of .*)?`, (c) => (!notCourt(c) && where(c) === 'gov' ? 'judge' : !notCourt(c) && where(c) !== 'other' && /\b(supreme|appeals|appellate|superior) (judicial )?court|court of (appeals|criminal appeals)\b/.test(`${c.n} ${c.rest}`) ? 'judge' : null)],
+  [String.raw`(?:(?:${STATES}) |(?:(?!(?:assistant|aide|driver|secretary|speechwriter|son|daughter|wife|husband|married|future|aspiring|campaign|former|endorsed|staff|intern|clerk|to|for|of|by|the|a|an|with)\b)[a-z.'-]+ ){0,3}county )?(?:(?:chief|presiding|senior|associate|federal|state|u\.?\s?s\.?|united states|district|circuit|county|superior|family|probate|municipal|juvenile|criminal|civil|city|justice|appellate|appeals|bankruptcy|magistrate|administrative law|immigration|tax|trial|tribal|court) )*judge(?: of .*)?`,
+    (c) => {
+      if (notCourt(c)) return null;
+      const named = /\b(federal|district|circuit|superior|probate|municipal|juvenile|criminal|appellate|appeals|bankruptcy|magistrate|administrative law|immigration|court|tribal)\b/.test(c.n) || c.us;
+      const w = named ? whereSoft(c) : where(c);
+      if (w !== 'none') return w === 'gov' ? 'judge' : null;
+      return /\b(federal|district|circuit|superior|probate|municipal|juvenile|criminal|appellate|appeals|bankruptcy|magistrate|administrative law|immigration|court|tribal)\b/.test(c.n) || c.us || (c.retired && /^(?:hon\.? )?judge$/.test(c.n)) ? 'judge' : null;
+    }],
+  // Commissions.
+  [String.raw`(?:(?:(?!(?:assistant|aide|driver|secretary|speechwriter|son|daughter|wife|husband|married|future|aspiring|campaign|former|endorsed|staff|intern|clerk|to|for|of|by|the|a|an|with)\b)[a-z.'-]+ ){0,3}(?:county|city|town|village|borough|parish) )?(?:(?:planning|zoning|parks?(?: and recreation)?|library|historic preservation) )*(?:county |city |town )?commissioner(?: .*)?`,
+    (c) => (/\b(county|city|town|village|borough|parish)\b/.test(c.n) ? soft('govOfficial')(c) : /\b(planning|zoning|parks?|library|historic)\b/.test(c.n) ? notOther('govOfficial')(c) : SKIP)],
+  [String.raw`(?:police|fire) (?:commissioner|chief)|chief of (?:police|the fire department)|superintendent of police`, needGov('govSenior')],
+  [String.raw`chief`, (c) => (where(c) === 'gov' && /\b(police|fire|sheriff)/.test(c.rest || c.next) ? 'govSenior' : SKIP)],
+  [String.raw`(?:fcc|sec|ftc|fec|nrc|ferc|cftc|eeoc|nlrb) (?:commissioner|chair(?:man|woman)?)`, notOther('govSenior')],
+  // An agency's initials are also its programs' ("SBA Administrator" at a
+  // bank lends SBA loans): its head names the agency, or is the whole headline.
+  [String.raw`(?:fda|irs|cbp|ice|fema|epa|ssa|uspto|nasa|faa|tsa|dea|atf|gsa|sba) (?:commissioner|administrator|chair(?:man|woman)?)`, (c) => (where(c) === 'gov' || alone(c) ? 'govSenior' : null)],
+  [String.raw`(?:deputy|assistant|associate) commissioner(?: .*)?`, (c) => (where(c) === 'gov' ? 'govOfficial' : null)],
+  [String.raw`commissioner(?: of .*)?`, (c) => {
+    const w = where(c);
+    if (w === 'other') return null;
+    const own = [c.n, ...pieces(c.rest), ...(c.rest ? [] : [c.next]), c.prevLeads ? c.prev : ''];
+    if (own.some((p) => STATE_BODY.test(p))) return 'govSenior';
+    if (own.some((p) => LOCAL_GOV.test(p))) return 'govOfficial';
+    if ((/^commissioner of (the )?(health|education|agriculture|insurance|labor|revenue|police|corrections|public safety|human services|social services|transportation|environmental protection|internal revenue|food and drugs|u\.?\s?s\.? customs|immigration|social security)$/.test(c.n) && nothingElse(c)) || w === 'gov') return 'govSenior';
+    return localPlace(c) ? 'govOfficial' : null;
+  }],
+  // An agency's head: the agency named in full, as the title's or the part's
+  // organization ("Administrator, U.S. Small Business Administration").
+  [String.raw`(?:deputy )?administrator(?: of .*)?`, (c) => {
+    const of = c.n.match(/ of (.+)$/);
+    const named = of ? AGENCY_EXACT.test(of[1]) || /^(?:the )?(?:nasa|epa|fema|usaid|sba|gsa|faa|tsa|nhtsa|noaa)$/.test(of[1]) : (c.rest ? pieces(c.rest) : [c.next]).some((p) => AGENCY_EXACT.test(p));
+    return named ? (/^deputy/.test(c.n) ? 'govOfficial' : 'govSenior') : null;
+  }],
+  [String.raw`chair(?:man|woman|person)?(?: of .*)?`, (c) => (!c.at && [c.n.replace(/^chair(?:man|woman|person)? of (?:the )?/, ''), ...pieces(c.rest), ...(c.rest ? [] : [c.next])].some((p) => STATE_BODY.test(p)) ? 'govSenior' : SKIP)],
+  // Local officials: a council's own name, or a city's, a county's or a district's.
+  [String.raw`(?:(?:${STATES}|[a-z.'-]+ (?:city|county)|city|town|village|borough|county|metro|district \d+|ward \d+|at-large|deputy|vice|chair|former) )*(?:council ?(?:member|man|woman|person)|councilmember|councill?or|alder(?:man|woman|person)|selectman|selectwoman|select board member)(?: .*)?`,
+    (c) => (/\b(forbes|advisory|parent|students?|youth|business|young entrepreneur|yec|ypo|eo|technology|tech|advisors?|chamber|young professionals|leadership|development|nonprofit)\b/.test(c.part) ? null
+      : where(c) === 'gov' || (/\b(city|town|village|borough|county|district|ward|metro|at-large|parish)\b/.test(c.n) && whereSoft(c) !== 'other') || (where(c) === 'none' && pieces(c.rest).some((p) => placeLike(p))) ? 'govOfficial' : null)],
+  [String.raw`(?:(?:(?!(?:assistant|aide|driver|secretary|speechwriter|son|daughter|wife|husband|married|future|aspiring|campaign|former|endorsed|staff|intern|clerk|to|for|of|by|the|a|an|with)\b)[a-z.'-]+ ){0,3})?county supervisor(?:, .*)?|member of the (?:[a-z.']+ ){0,2}board of supervisors`, (c) => (nothingElse(c) || pieces(c.rest).some((p) => placeLike(p)) ? 'govOfficial' : null)],
+  [String.raw`(?:(?:(?!(?:assistant|aide|driver|secretary|speechwriter|son|daughter|wife|husband|married|future|aspiring|campaign|former|endorsed|staff|intern|clerk|to|for|of|by|the|a|an|with)\b)[a-z.'-]+ ){0,3}(?:county|parish) )?sheriff(?: of .*)?`, (c) => (where(c) === 'gov' || (/\b(county|parish)\b/.test(c.n) && whereSoft(c) !== 'other') || (where(c) === 'none' && !c.after && [...pieces(c.rest), c.rest ? '' : c.next].some((p) => LOCAL_PLACE.test(p))) ? 'govOfficial' : null)],
+  [String.raw`supervisor`, (c) => (pieces(c.rest).some((p) => /board of supervisors$/.test(p) && isGovOrg(p)) ? 'govOfficial' : SKIP)],
+  // A private school's board is its trustees'.
+  [String.raw`school board (?:member|chair(?:man|woman|person)?|trustee|president|vice chair)(?:, .*)?|member of the (?:[a-z.']+ ){0,3}school board`, needGov('govOfficial')],
+  [String.raw`prime minister(?: of (?:the )?(?:${COUNTRIES}))?|member of parliament(?: for .*)?`, (c) => (/ of /.test(c.n) ? ownOnly('govLeader')(c) : needGov('govLeader')(c))],
+].map(([src, key]) => [new RegExp(`^${LEAD}(?:${src})$`), key]);
+const OFFICE_TABLES = { corpOfficer: CORP_OFFICER, notCourt: NOT_COURT, fedBody: FED_BODY, dept: DEPT, mock: MOCK, localGov: LOCAL_GOV,
+  tribes: TRIBES, tribalGov: TRIBAL_GOV, tribalBusiness: TRIBAL_BUSINESS, legislature: LEGIS, stateItself: STATE_ITSELF, agency: AGENCY,
+  agencyExact: AGENCY_EXACT, notGov: NOT_GOV, place: PLACE, notAnOrg: NOT_AN_ORG, judicialArea: JUDICIAL_AREA, orgWord: ORG_WORD,
+  jokePlace: JOKE_PLACE, municipality: MUNICIPALITY, party: PARTY, nations: NATIONS, sales: SALES, fedReserve: FED_RESERVE, stateBody: STATE_BODY, milRole: MIL_ROLE, serviceRetired: SERVICE_RETIRED,
+  // How the tables are applied, too: a change to where a title is held rescores like a table's.
+  code: [pieces, isGovOrg, isOrg, anotherTitle, whereOwn, where, alone, besides, houseOf, congress, inState, notOther, notCourt, officeTitle, militaryTitle, commandLevel, readPart, readRoles].map(String),
+  qualifiedService: QUALIFIED_SVC, restIsService: REST_IS_SERVICE, unitLevels: UNIT_LEVELS, states: STATES, countries: COUNTRIES, international: INTERNATIONAL, stateGov: STATE_GOV, govOrg: GOV_ORG,
+  civic: CIVIC, lead: LEAD, service: SVC, serviceIn: SERVICE_IN, navy: NAVY_IN, serviceOnly: SERVICE_ONLY, milUnit: MIL_UNIT,
+  notMilitary: NOT_MILITARY, rankShort: RANK_SHORT, ranks: RANKS,
+  gov: GOV.map(([re, key]) => [re, typeof key === 'function' ? String(key) : key]) };
+
+const lowerPart = (text) => String(text || '').normalize('NFKD').replace(/[\u0300-\u036f]/g, '').replace(/[\p{Extended_Pictographic}\u{1F1E6}-\u{1F1FF}\uFE0F\u200D]/gu, ' ').toLowerCase()
+  .replace(/\(\s*([a-z.]+),\s*(?:ret(?:\.|ired|d\.?)?|r)\s*\)/g, ' $1 ').replace(/\(\s*(ret(\.|ired|d\.?)?|r)\s*\)/g, ' ')
+  .replace(/[’‘]/g, "'").replace(/\bambassador at large\b/g, 'ambassador-at-large').replace(/\s+/g, ' ').trim();
+// What an official is "for": a portfolio, not a company ("Under Secretary for Science and Technology").
+const PORTFOLIO = /\b(technolog\w*|health|financial|science|security|policy|affairs|development|research|management|programs?|services?|education|energy|environment|resources|operations|legislation|planning|preparedness|intelligence|acquisition|readiness|innovation|infrastructure)\b/;
+// Officials' titles written short, at the start of a title: "Sen., Florida Senate", "Gov. of Ohio".
+const GOV_SHORT = [[/^state sen\.?(?=\s|,|$)/, 'state senator'], [/^sen\.?(?=\s|,|$)/, 'senator'], [/^lt\.? gov\.?(?=\s|,|$)/, 'lieutenant governor'], [/^gov\.?(?=\s|,|$)/, 'governor'],
+  [/^amb\.?(?=\s|,|$)/, 'ambassador'], [/^del\.?(?=\s|,|$)/, 'delegate'], [/^rep\.(?=\s|,|$)/, 'representative']];
+
+/**
+ * A government or military title written where a title goes, or null: the
+ * part's text up to its first comma, "at", "@" or bracket is the title; the
+ * rest of the part, and the parts on either side, only say where it is held.
+ * A rank that says it's retired comes back with `retired`.
+ */
+// Staff words: a part like this before an official's title names the official as their principal.
+// An official's own title in the part before ("Former Governor | U.S. Senator") isn't a staffer's.
+const officeLike = (p) => /\b(senator|congress\w*|representative|governor|mayor|secretary of|judge|justice|commissioner|general|admiral|colonel|captain|commander)\b/.test(p) && !/\b(aide|assistant|driver|clerk|staff|intern|secretary to|press secretary)\b/.test(p);
+const STAFFER = /\b(aide|law clerk|assistant|staff(?:er)?|scheduler|clerk|paralegal|advocate|driver|intern|fellow|chief of staff|press secretary|secretary|speechwriter|director|counsel|analyst|investigator|deputy|dispatcher|detective|generalist|liaison|coordinator|caseworker|officer|manager|specialist|writer|photographer|agent)\b/;
+function officeTitle(part, prev = '', next = '', others = [], former = false, after = '') {
+  const t = lowerPart(part);
+  const cut = t.search(/,|\s(?:at|@)\s|\s@|\(/);
+  const title = (cut < 0 ? t : t.slice(0, cut)).trim().replace(/[.:;]+$/, '');
+  const rest = cut < 0 ? '' : t.slice(cut).replace(/^[,\s]+/, '');
+  const side = { prev: lowerPart(prev), next: lowerPart(next) };
+  // The official or flag officer a staffer works for: "Flag Aide | Rear Admiral, U.S. Navy".
+  const principal = !!side.prev && STAFFER.test(side.prev) && !FORMER.test(prev) && !officeLike(side.prev);
+  const mil = militaryTitle(part, t, title, rest, side.prev, side.next, others.map(lowerPart), RETIRED.test(next) || RETIRED_ONLY.test(next), lowerPart(after));
+  if (mil && principal && (mil.key === 'seniorGeneral' || mil.key === 'general')) return null;
+  if (mil) return { ...LEVELS[mil.key], ...(mil.retired && { retired: true }) };
+  // Government: never a club's, a church's, a school's, a fraternity's, a
+  // mock government's or a joke's, and never at an organization that isn't a
+  // government's. A club or a school in another part is where() 's to see.
+  if (principal || CIVIC.test(t.replace(MUNICIPALITY_OF, ' ')) || STUDENT_ORG.test(t) || others.map(lowerPart).some((o) => MOCK.test(o) && !MOCK_PAST.test(o)) || /^(candidate|nominee|running)\b/.test(title)) return null;
+  const at = /^(?:at|@)\s/.test(rest);
+  if (at && !pieces(rest).some(isGovOrg)) return null;
+  let n = title.replace(new RegExp(`^${LEAD}`), '');
+  for (const [re, full] of GOV_SHORT) if (re.test(n)) { n = n.replace(re, full); break; }
+  // An organization written inside the title is its own: "State Representative for Northwind Insurance".
+  const inTitle = n.match(/ (?:for|of|to|at) (?:the )?(.+)$/);
+  if (inTitle && (isKnownCompany(inTitle[1]) || (isOrg(inTitle[1]) && !PORTFOLIO.test(inTitle[1]))) && !isGovOrg(inTitle[1]) && !DEPT_OF.test(inTitle[1]) && !MUNICIPALITY.test(inTitle[1])) return null;
+  const c = { n, part: t, rest, at, prev: side.prev, prevLeads: !!prev && others[0] === prev, next: side.next, after: lowerPart(after),
+    text: `${side.prev} ${t} ${side.next}`, service: SERVICE_IN.test(t), retired: former || RETIRED.test(part),
+    retTag: RETIRED.test(part), us: /\b(?:u\.?\s?s\.?|united states)\s/.test(title) };
+  for (const [re, key] of GOV) {
+    if (!re.test(title) && !re.test(n)) continue;   // n: a short form spelled out
+    const k = typeof key === 'function' ? key(c) : key;
+    if (k === SKIP) continue;
+    return k ? LEVELS[k] : null;
+  }
+  return null;
+}
+
 // An audience of their own, in one part of a headline: "2.5M+ followers",
 // "2,500,000 followers", "1.2M monthly listeners", "500K subscribers", "3M+ on
 // TikTok". Not views, users or impressions, which are a campaign's or a
@@ -286,10 +1009,33 @@ function heldAfterComma(part) {
  */
 export function readRoles(headline = '', role = '') {
   const out = [];
-  for (const raw of headlineParts(headline || role)) {
-    const former = FORMER.test(raw);
+  const parts = headlineParts(headline || role);
+  let last = null;   // the last role a title gave: { role, i, rank }
+  let retiredNext = false;   // a lone "Retired" before any role: the next one's
+  for (const [i, raw] of parts.entries()) {
+    // "Colonel, U.S. Army | Retired": the role just before, or a rank's with
+    // its service between ("Colonel | U.S. Army | Retired"); not a civilian
+    // job further back ("Senior Manager at Deloitte | Navy Veteran | Retired").
+    if (RETIRED_ONLY.test(raw)) {
+      const afterwards = /\b(board|volunteer|advis[eo]r|mentor|trustee|chair|docent|member|consultant|adjunct|part-time|substitute|fractional|golfer|investor|coach|tutor)\b/i.test(last?.role.part || '');
+      if (!last) { retiredNext = true; continue; }
+      if (last && !afterwards && (last.i === i - 1 || (last.i === i - 2 && last.rank && SERVICE_ONLY.test(lowerPart(parts[i - 1]))))) last.role.former = true;
+      continue;
+    }
+    // "Paralegal – General Counsel": the office they work in, split off by a dash.
+    if (/^(?:the )?(?:general|chief) counsel(?:,.*)?$/i.test(raw.trim()) && i > 0 && !(readPart(parts[i - 1])?.level >= LEVELS.vp.level)) continue;
+    const retiredTag = RETIRED.test(raw);
     const part = raw.replace(FORMER, '').replace(/^[@\s.:]+/, '');
-    let title = readPart(part);
+    const office = officeTitle(part, parts[i - 1] ?? '', parts[i + 1] ?? '', parts, FORMER.test(raw) || retiredTag, parts[i + 2] ?? '');
+    // A civilian job is retired when the tag is its own: "Teacher (Retired)",
+    // "Nurse, Retired". Not a service's after it ("Program Manager at Leidos,
+    // U.S. Army (Ret.)"), nor a second role's ("Realtor at Compass,
+    // Firefighter (Ret.)", "Teacher (Retired), Realtor at Compass").
+    const roles = part.replace(/\([^)]*\)/g, ' ').split(',').filter((p) => p.trim() && !RETIRED_ONLY.test(p));
+    const former = FORMER.test(raw) || (retiredTag && (!!office || (!SERVICE_RETIRED.test(part.toLowerCase()) && roles.length <= 1)));
+    let title = office || readPart(part);
+    const retired = !!title?.retired;
+    if (retired) { const { retired: _, ...rest } = title; title = rest; }
     let company = companyIn(part) || (out.length === 0 && isKnownCompany(part) ? cleanCompany(part) : null);
     let inferred = false;
     if (!company && title) {
@@ -297,7 +1043,11 @@ export function readRoles(headline = '', role = '') {
       inferred = !!company;
     }
     if (!title && company) title = { ...LEVELS.ic, label: 'Works there' };
-    if (title) out.push({ title, company, former, part, ...(inferred && { inferred }) });
+    if (title) {
+      out.push({ title, company, former: former || retired || retiredNext, part, ...(inferred && { inferred }) });
+      retiredNext = false;
+      last = { role: out[out.length - 1], i, rank: RANKED.has(title.key) };
+    }
     else if (!former) {
       const before = [...out].reverse().find((r) => !r.audience);
       const at = before && !before.former && !before.company ? heldAt(part, before.part) : null;
@@ -311,7 +1061,7 @@ export function readRoles(headline = '', role = '') {
 
 /** Is this person a student right now? Then no other title makes them powerful yet. */
 export function isStudent(headline = '') {
-  return headlineParts(headline).some((p) => !FORMER.test(p) && (studies(p) || INTERN.test(` ${p.toLowerCase()} `)));
+  return headlineParts(headline).some((p) => !FORMER.test(p) && !SERVICE_SCHOOL.test(p) && (studies(p) || INTERN.test(` ${p.toLowerCase()} `)));
 }
 
 /** The person's first current title (a quick read; scoring weighs every role), an audience only when it's all they state. */
@@ -337,7 +1087,7 @@ export function readTitle(headline = '', role = '') {
 // Nothing on the list is below 7. Regional picks, picks from one person's
 // career or network, and small startups are not on it: they are estimated
 // from the network like any other company (4, or 5–6 when many of the
-// network's people work there), and anyone can score them on Paths → Scores,
+// network's people work there), and anyone can score them on the Scores tab,
 // where a score set always wins. When in doubt, a company stays off: the
 // estimate is the neutral default.
 //
@@ -1065,10 +1815,10 @@ export const COMPANY_DATA = [
   ['U.S. Department of Veterans Affairs', 8, exactly('u.s. department of veterans affairs', 'us department of veterans affairs', 'united states department of veterans affairs', 'department of veterans affairs', 'veterans affairs', 'u.s. veterans affairs', 'us veterans affairs', 'u.s. va', 'us va', 'veterans health administration', 'veterans benefits administration', 'national cemetery administration', 'va medical center', 'veterans affairs medical center', 'va health care system', 'va healthcare system', 'va hospital'), 'health', 'U.S. executive department (va.gov, OPM data), about 446,500 staff (July 2026)'],
   ['U.S. Department of Homeland Security', 8, exactly('u.s. department of homeland security', 'us department of homeland security', 'united states department of homeland security', 'department of homeland security', 'u.s. dhs', 'us dhs', 'federal law enforcement training centers', 'federal law enforcement training center', 'fletc', 'federal protective service'), 'defense', 'U.S. executive department (dhs.gov, OPM data), about 225,500 civilian staff (July 2026)'],
   ['U.S. Army', 8, exactly('u.s. army', 'us army', 'united states army', 'u.s. army reserve', 'us army reserve', 'united states army reserve', 'department of the army', 'u.s. department of the army', 'us department of the army', 'united states department of the army', 'hqda'), 'defense', 'U.S. military branch (army.mil, DMDC and OPM data), about 458,100 active duty and 188,300 civilians (2026)'],
-  ['U.S. Navy', 8, exactly('u.s. navy', 'us navy', 'united states navy', 'u.s. navy reserve', 'us navy reserve', 'united states navy reserve', 'u.s. naval reserve', 'us naval reserve', 'united states naval reserve', 'department of the navy', 'u.s. department of the navy', 'us department of the navy', 'united states department of the navy', 'office of naval research'), 'defense', 'U.S. military branch (navy.mil, DMDC and OPM data), about 347,700 active duty and 184,300 civilians (2026)'],
+  ['U.S. Navy', 8, exactly('u.s. navy', 'us navy', 'united states navy', 'u.s. navy reserve', 'us navy reserve', 'united states navy reserve', 'u.s. naval reserve', 'us naval reserve', 'united states naval reserve', 'department of the navy', 'u.s. department of the navy', 'us department of the navy', 'united states department of the navy', 'office of naval research', 'usn'), 'defense', 'U.S. military branch (navy.mil, DMDC and OPM data), about 347,700 active duty and 184,300 civilians (2026)'],
   ['U.S. Air Force', 8, exactly('u.s. air force', 'us air force', 'united states air force', 'usaf', 'u.s. air force reserve', 'us air force reserve', 'united states air force reserve', 'air force reserve command', 'department of the air force', 'u.s. department of the air force', 'us department of the air force'), 'defense', 'U.S. military branch (af.mil, DMDC and OPM data), about 320,000 active duty and 144,000 civilians (2026)'],
   ['U.S. Marine Corps', 8, exactly('u.s. marine corps', 'us marine corps', 'united states marine corps', 'usmc', 'marine corps', 'u.s. marine corps reserve', 'us marine corps reserve', 'united states marine corps reserve', 'usmcr', 'marine forces reserve', 'u.s. marines', 'us marines', 'united states marines'), 'defense', 'U.S. military branch (marines.mil, DMDC and OPM data), about 169,900 active duty and 16,200 civilians (2026)'],
-  ['U.S. Space Force', 8, exactly('u.s. space force', 'us space force', 'united states space force', 'space systems command', 'space operations command', 'space training and readiness command', 'space development agency'), 'defense', 'U.S. military branch (spaceforce.mil, DMDC and OPM data), about 10,200 Guardians and 7,100 civilians (2026)'],
+  ['U.S. Space Force', 8, exactly('u.s. space force', 'us space force', 'united states space force', 'space systems command', 'space operations command', 'space training and readiness command', 'space development agency', 'ussf'), 'defense', 'U.S. military branch (spaceforce.mil, DMDC and OPM data), about 10,200 Guardians and 7,100 civilians (2026)'],
   ['U.S. Coast Guard', 8, exactly('u.s. coast guard', 'us coast guard', 'united states coast guard', 'uscg', 'u.s. coast guard reserve', 'us coast guard reserve', 'united states coast guard reserve'), 'defense', 'U.S. military branch (uscg.mil, DMDC and OPM data), about 43,600 active duty and 8,700 civilians (2026)'],
   ['National Guard', 8, exactly('national guard', 'u.s. national guard', 'us national guard', 'united states national guard', 'army national guard', 'air national guard', 'national guard bureau', 'arng', 'alabama national guard', 'alabama army national guard', 'alabama air national guard', 'alaska national guard', 'alaska army national guard', 'alaska air national guard', 'arizona national guard', 'arizona army national guard', 'arizona air national guard', 'arkansas national guard', 'arkansas army national guard', 'arkansas air national guard', 'california national guard', 'california army national guard', 'california air national guard', 'colorado national guard', 'colorado army national guard', 'colorado air national guard', 'connecticut national guard', 'connecticut army national guard', 'connecticut air national guard', 'delaware national guard', 'delaware army national guard', 'delaware air national guard', 'florida national guard', 'florida army national guard', 'florida air national guard', 'georgia national guard', 'georgia army national guard', 'georgia air national guard', 'hawaii national guard', 'hawaii army national guard', 'hawaii air national guard', 'idaho national guard', 'idaho army national guard', 'idaho air national guard', 'illinois national guard', 'illinois army national guard', 'illinois air national guard', 'indiana national guard', 'indiana army national guard', 'indiana air national guard', 'iowa national guard', 'iowa army national guard', 'iowa air national guard', 'kansas national guard', 'kansas army national guard', 'kansas air national guard', 'kentucky national guard', 'kentucky army national guard', 'kentucky air national guard', 'louisiana national guard', 'louisiana army national guard', 'louisiana air national guard', 'maine national guard', 'maine army national guard', 'maine air national guard', 'maryland national guard', 'maryland army national guard', 'maryland air national guard', 'massachusetts national guard', 'massachusetts army national guard', 'massachusetts air national guard', 'michigan national guard', 'michigan army national guard', 'michigan air national guard', 'minnesota national guard', 'minnesota army national guard', 'minnesota air national guard', 'mississippi national guard', 'mississippi army national guard', 'mississippi air national guard', 'missouri national guard', 'missouri army national guard', 'missouri air national guard', 'montana national guard', 'montana army national guard', 'montana air national guard', 'nebraska national guard', 'nebraska army national guard', 'nebraska air national guard', 'nevada national guard', 'nevada army national guard', 'nevada air national guard', 'new hampshire national guard', 'new hampshire army national guard', 'new hampshire air national guard', 'new jersey national guard', 'new jersey army national guard', 'new jersey air national guard', 'new mexico national guard', 'new mexico army national guard', 'new mexico air national guard', 'new york national guard', 'new york army national guard', 'new york air national guard', 'north carolina national guard', 'north carolina army national guard', 'north carolina air national guard', 'north dakota national guard', 'north dakota army national guard', 'north dakota air national guard', 'ohio national guard', 'ohio army national guard', 'ohio air national guard', 'oklahoma national guard', 'oklahoma army national guard', 'oklahoma air national guard', 'oregon national guard', 'oregon army national guard', 'oregon air national guard', 'pennsylvania national guard', 'pennsylvania army national guard', 'pennsylvania air national guard', 'rhode island national guard', 'rhode island army national guard', 'rhode island air national guard', 'south carolina national guard', 'south carolina army national guard', 'south carolina air national guard', 'south dakota national guard', 'south dakota army national guard', 'south dakota air national guard', 'tennessee national guard', 'tennessee army national guard', 'tennessee air national guard', 'texas national guard', 'texas army national guard', 'texas air national guard', 'utah national guard', 'utah army national guard', 'utah air national guard', 'vermont national guard', 'vermont army national guard', 'vermont air national guard', 'virginia national guard', 'virginia army national guard', 'virginia air national guard', 'washington national guard', 'washington army national guard', 'washington air national guard', 'west virginia national guard', 'west virginia army national guard', 'west virginia air national guard', 'wisconsin national guard', 'wisconsin army national guard', 'wisconsin air national guard', 'wyoming national guard', 'wyoming army national guard', 'wyoming air national guard', 'district of columbia national guard', 'district of columbia army national guard', 'district of columbia air national guard', 'd.c. national guard', 'd.c. army national guard', 'd.c. air national guard', 'dc national guard', 'dc army national guard', 'dc air national guard', 'puerto rico national guard', 'puerto rico army national guard', 'puerto rico air national guard', 'guam national guard', 'guam army national guard', 'guam air national guard', 'virgin islands national guard', 'virgin islands army national guard', 'virgin islands air national guard', 'u.s. virgin islands national guard', 'u.s. virgin islands army national guard', 'u.s. virgin islands air national guard'), 'defense', 'U.S. military reserve component (nationalguard.mil, OPM data), about 433,000 members (FY2025)'],
   ['FBI', 8, exactly('fbi', 'federal bureau of investigation', 'u.s. federal bureau of investigation', 'us federal bureau of investigation'), 'defense', 'U.S. federal law-enforcement agency (fbi.gov, OPM data), about 35,300 staff (July 2026)'],
@@ -1542,7 +2292,7 @@ export function companyScore(name, { overrides = new Map(), headcount = 0, indus
 /**
  * A company's score from a read of the network (readNetwork): its headcount,
  * industry and where that came from, and its sectors, as scoreNetwork scores
- * it. Rescoring, Settings' preview and Paths → Scores all score a company
+ * it. Rescoring, Settings' preview and the Scores tab all score a company
  * through this, so they give it the same score.
  */
 export function companyScoreIn(read, name, { overrides, focus } = {}) {
@@ -1619,7 +2369,8 @@ export const RULE_TABLES = {
   junkCompany: JUNK_COMPANY, notACompany: NOT_A_COMPANY, nameEnd: NAME_END, legalForm: LEGAL_FORM, wholeName: WHOLE_NAME,
   schoolName: SCHOOL_NAME, notItsStaff: NOT_ITS_STAFF, platformRole: PLATFORM_ROLE, platforms: PLATFORMS, bonuses: BONUSES,
   audience: AUDIENCE, notTheirAudience: NOT_THEIR_AUDIENCE, audienceUnits: UNIT, ownVenture: OWN_VENTURE,
-  affiliation: AFFILIATION, academic: ACADEMIC,
+  affiliation: AFFILIATION, academic: ACADEMIC, retired: RETIRED, retiredOnly: RETIRED_ONLY, officeName: OFFICE_NAME, atCompany: AT_COMPANY, healthOrg: HEALTH_ORG, specialty: SPECIALTY, serviceSchool: SERVICE_SCHOOL,
+  offices: OFFICE_TABLES,
 };
 
 // ── putting it together ──────────────────────────────────────────────────────
@@ -1636,7 +2387,7 @@ export function tierFor(power) {
   return 'D';
 }
 
-// Settings → Tiers: graded on your network's curve (the default), or on the
+// Scores → Tiers: graded on your network's curve (the default), or on the
 // fixed scale above.
 export const TIER_SCALES = ['curve', 'fixed'];
 export const TIER_SCALE_SETTING = {
@@ -1914,7 +2665,7 @@ export function readNetwork(rows = [], { industryOf, sectorsOf, groupOf } = {})
  * many of your people work at each company and each company's one industry;
  * then, with `tierScale` 'curve', everyone is graded on the network's curve,
  * with cut-offs from the 1st-degree people's scores so far (the app passes
- * the saved Settings → Tiers, which is the curve unless you chose otherwise;
+ * the saved Scores → Tiers, which is the curve unless you chose otherwise;
  * called without one, a network is graded on the fixed scale); then
  * 1st-degree bridges get their circle boost from their scored circle, judged
  * by the tiers you see, and are graded again on the same cut-offs.