Add UI String

4. Match how the file already addresses the manager

Most of these languages choose between a familiar and a polite second person — du/Sie, tu/vous, ty/vy, kamu/Anda, 你/您 — and that choice is not yours to make one string at a time. Each file has already made it. A string in the wrong register reads to a native speaker the way a stranger using your first name does: not wrong, exactly, but written by someone who wasn't paying attention.

Read four or five neighbouring values in the namespace you are editing, and copy their form.

Do not instead count pronouns across the whole file and follow the majority. Those counts are dominated by third-person text about players rather than text to the manager, and the markers are ambiguous in both directions. Spanish su is "his" far more often than polite "your". And a capital Sie only means formal "you" mid-sentence — at the start of one, where German capitalises regardless, de.json also uses it for "they" and for "it". One string carries the whole problem:

transfers.transferFeedbackCounterHeadline
  "Sie wollen mehr, bevor sie einschlagen."   // They want more before shaking hands.

Both pronouns are the same word meaning the same thing — the club on the other side of the deal. Only sentence position capitalises the first. A grep for Sie counts one of them as formal address and misses the other entirely.

Register follows who is speaking, which is why one file can hold both forms correctly. In de.json, a journalist's question under match.press.* is formal (Sie, throughout); a menu label, and the dialogue options the manager picks under be.msg.playerEvent.options.*, are familiar (du). Neither of those is a bug.

Elsewhere in de.json the two forms are genuinely tangled — board correspondence under be.msg.* mixes them from one letter to the next. That is unresolved, not a pattern to copy: if the keys around yours disagree with each other, say so rather than picking one silently.

⚠️ A polite form can force you to guess the manager's gender. Formal Czech takes a plural auxiliary but keeps the participle singular and gendered: uspořádal jste says the manager is a man, uspořádala jste says she is a woman, and the game does not know. Rephrase so that nobody is the subject — Tisková konference dnes už proběhla, a press conference has already taken place today. Any locale that agrees a verb or adjective with the person being addressed can spring this.

5. INTENTIONAL_SAME.json — only for terms that truly don't translate

src/i18n/INTENTIONAL_SAME.json allowlists keys whose value is legitimately identical to English: proper nouns, competition names, position abbreviations like GK. Entries are keyed by locale code, or global for all of them.

This is an escape hatch for linguistics, not for unfinished work. If you find yourself adding several keys at once, you are using it wrong.

6. Backend strings are keys, not prose

Rust never emits English text for the player. It emits a translation key, and the frontend resolves it:

• src/utils/backendI18n.ts — the main mapping
• src/utils/backendI18nPlayerEvents.ts — player event messages
• src/utils/backendI18n.legacy.ts — keys kept for old saves

So a new inbox message or news headline generated in ofm_core means: emit the key on the Rust side, map it in backendI18n.ts if the mapping isn't automatic, and add the key to every locale file. src/utils/backendI18n.localeCoverage.test.ts covers this half.

7. Run the gates

npm exec --no -- vitest run src/i18n        # localeCoverage + frontendKeyCoverage + index
npm exec --no -- vitest run src/utils       # backendI18n coverage, if you touched backend keys

• localeCoverage.test.ts — every locale has every en.json key, and no locale silently copies the English string (outside INTENTIONAL_SAME.json).
• frontendKeyCoverage.test.ts — every literal t("…") key in src/ exists in en.json. It parses the TypeScript AST, so typo'd keys fail too.

Then the advisory sweep:

npm run audit:i18n

This command always exits 0. It is a heuristic reporter over both src/ and src-tauri/; read its output and check whether any candidate it lists is a string you just added. A clean run is not a pass — the vitest gates are.

Checklist

• Key added to src/i18n/locales/en.json, in the right namespace
• Real translations added to all 11 other locales
• Interpolation placeholders identical across every locale
• pt and pt-BR translated separately
• Form of address matches the neighbouring keys, and no wording assumes the manager’s gender
• INTENTIONAL_SAME.json touched only for genuinely untranslatable terms
• Backend keys mapped in src/utils/backendI18n*.ts if applicable
• npm exec --no -- vitest run src/i18n green
• npm run audit:i18n output read, not just run
• Any new aria-label uses a translated string, not a hardcoded one