epic(publication): text & translation finalization campaign

[jsboige]

Context

All structural/formatting work is now complete or in-flight:

• ✅ Pipeline operational (82 PDFs, 20 SVGs, 44 tests green)
• ✅ Mind map HTML wrappers published (feat(mindmap): fix + publish + Playwright-test HTML wrapper generation (regression of #129) #196, Publish mind map HTML wrappers to Cards/Fallacies/Mindmaps/{lang}/ (phase 3 of #196) #198)
• ✅ École des Menteurs cover (feat(rules): restore École des Menteurs cover layout + generalize to other rules with AI illustrations #188 phase 1, fix(rules): restore Ecole des Menteurs cover — scope :not selectors + yellow subtitle #194)
• ✅ Overflow detection script (feat(qa): detect Virtues card text overflow + tighten Virtues card copy #190 phase 1, feat(qa): Virtues card overflow detection (#190 phase 1) #195)
• ✅ Rules card layout optimization (Rules cards: optimiser la mise en page par variante de jeu #119, PR fix(rules): optimize Rules card layout — merge paragraphs per variant (#119) #201)
• 🔄 GSheet sync tooling (feat(tooling): bidirectional Google Spreadsheet sync for source CSVs with diff safeguards #193, PR feat(sync): bidirectional GSheet ↔ CSV sync (#193) #200)

What remains before publication: text quality and translation completeness.

Current translation coverage

Dataset	Rows	EN	RU	PT	Notes
Fallacies	1408	✅ core 100%, Simple_name 4%, political_example 2%	✅ ~85%	✅ ~85%	4 micro-issues identified
Virtues	223	❌ 0% — NO columns	❌ 0%	❌ 0%	Blocked by #183
Scenarii	167	⚠️ 53% (suggestion only, missing 7 columns)	⚠️ 54%	⚠️ 54%	77 rows untranslated
Rules	18*	✅ 100%	✅ 100%	✅ 100%	Minor quality issues (apostrophe PT)

*After PR #201 merge (was 24).

Phases

Phase 0 — Infrastructure (prerequisites)

• feat(translations): Upgrade OpenAI translation pipeline + complete Virtues i18n #183 — Upgrade translation pipeline SDK (Betalgo.OpenAI obsolete, models deprecated)
• feat(tooling): bidirectional Google Spreadsheet sync for source CSVs with diff safeguards #193 — Merge GSheet sync (PR feat(sync): bidirectional GSheet ↔ CSV sync (#193) #200) — enables bidirectional data flow
• Virtues CSV schema — Add _en, _ru, _pt columns to Virtues taxonomy CSV
• Scenarii CSV schema — Add missing EN columns (category_en, subcategory_en, title_en, smoothTalker_en, drawer_en, context_en, issue_en)

Phase 1 — French source text quality

• feat(content): simplify French source texts for broader accessibility (preserve taxonomy nuances) #191 — Simplify French source texts for broader accessibility
• feat(qa): detect Virtues card text overflow + tighten Virtues card copy #190 phase 2 — Tighten Virtues card copy (overflow fixes guided by detection script)
• Fallacies micro-fixes — Fix 4 identified issues:
  • Row 930: wrong link_en (Wikipedia Creepypasta instead of Appeal to Novelty)
  • Row 552: empty desc_ru
  • Row 152: truncated desc_ru (sentence cut mid-word)
  • Row 859: truncated desc_en/desc_pt for Appel à la Pureté

Phase 2 — Translation completeness

• Fallacies — Fill Simple_name_en (1348 empty), political_example_en/ru/pt (1373 empty each)
• Scenarii — Translate all 77 untranslated rows + add 7 missing EN columns
  • Fix "baratineur" appearing untranslated in 11+ EN rows → "smooth talker"
• Virtues — Full initial translation for all 223 rows × 3 languages
• Rules PT quality — Fix "Liars 'School" apostrophe in Portuguese

Phase 3 — Multi-pass quality review (#192)

• Consistency pass — Terminology alignment across datasets (e.g., "baratineur"/"smooth talker")
• Tone pass — Ensure game-appropriate register (playful but precise)
• Taxonomy fidelity — Verify translated hierarchy names preserve classification nuances
• Native speaker review — At minimum for EN, ideally RU and PT

Phase 4 — Visual validation & publication

• Regenerate all card images with corrected texts
• Run overflow detection (feat(qa): detect Virtues card text overflow + tighten Virtues card copy #190) on all languages/variants
• Assemble PDFs and verify layout
• Visual QA — spot-check all 4 languages across all card types
• release: Publish new GitHub release with updated game materials #134 — GitHub Release

Dependencies

Phase 0: #183 (SDK) + #193 (GSheet) ──┐
                                       ├──→ Phase 2 (translations)
Phase 1: #191 (FR text) ──────────────┘          │
                                                  ├──→ Phase 3 (quality)
                                                  │          │
                                                  │          ├──→ Phase 4 (visual + release)
                                                  │
Phase 0: Virtues schema ──→ Phase 2: Virtues i18n ┘

Roles

• ai-01: Phase 1 micro-fixes, Phase 3 consistency/automated checks, Phase 4 visual QA
• po-2023: Phase 0 (feat(translations): Upgrade OpenAI translation pipeline + complete Virtues i18n #183 SDK upgrade, Virtues schema), Phase 2 bulk translation runs
• User: Phase 1 (feat(content): simplify French source texts for broader accessibility (preserve taxonomy nuances) #191 editorial decisions), Phase 3 (native speaker validation), Phase 4 (final sign-off)

Metrics

Target: 100% translation coverage with 0 overflow across all 4 languages before release (#134).