docs(investigations): trace Virtues mindmap FR-frozen mechanism + bounded fix path

[jsboige]

Traces the Virtues mindmap FR-frozen mechanism + bounded fix path

Read-only investigation. Converts the release dossier #591 §3.2 finding — "Virtues .content.svg are FR-frozen across all 8 languages, deferred, mechanism untraced" — into a traced, bounded fix path so jsboige's post-release decision is informed instead of open-ended.

0 write under Cards/ (release freeze). master stays bef3bc6c. Docs only.

What this finds

• Mechanism TRACED (was untraced in docs(release): v0.9.0 validation dossier (go-live GATE #134) + fix CHANGELOG SVGs 8-lang #591): localization is not in TitleFunc, not in ProcessSvgFilesAsync. It is expression-rewriting upstream of the render:
  • ParallelDocumentCreatorConfigBase.ProcessDocumentAsync clones the config per language, then DocumentLocalization.DoReflectionTranslate(clone, lang) mutates the expression strings in-place via naive template.Replace (e.g. "{fallacy.TextFr}" → "{fallacy.TextZh}").
  • Interpolation at render time then yields localized node text.
• Root cause is 2-layer (both verified on bef3bc6c):
  • Layer B (config) — AssetConverterConfig entry Nouveau design #3 targets VirtueMindMapDocumentConfig.TitleExpression but its only conversion is "Vertus"→"Virtues" (tree root, 4 langs) — a stale stub from when Virtues data was FR-only. "{item.Text}".Replace("Vertus",...) is a no-op → FR for all 8 languages.
  • Layer A (entity) — Virtue.cs has no TitleAr/TitleFa/TitleZh properties (Fallacy.cs has TextAr/Fa/Zh). CSV data verified present (title_ar/zh/fa + subfamily_*/subsubfamily_* in the taxonomy file) → pure entity-mapping gap, not a data task.

The fix path (post-release, jsboige-gated — 3 steps mirroring Fallacies)

Flagged one non-obvious prerequisite: DefaultTitleExpression must change {item.Text} → {item.TitleFr} before a config-only fix can fire (else Replace is a silent no-op — same trap class as an earlier SUPPOSÉ error). Full 3-step path + validation recipe (regen 8-lang with clobbered harvests, CJK/RTL eyeball, add a Virtues mirror of MindMapLocalizationRegressionTests.cs which currently covers Fallacies only) in the doc.

Orthogonality

This gap is upstream of the render engine — Batik (FreeMind) or Freeplane (#599 opt-in) render the same {item.Text} = FR for Virtues. Independent of the #568 §3.8 breakthrough-refutation. (Cross-verify ACK #599 4802039001.)

Why it's a standalone doc, not folded into #591

#591 is the release dossier (frozen, awaiting jsboige's §5 decision). This is a post-release fix-path investigation that enriches the decision dossier without reopening it. Living in docs/investigations/ makes it discoverable by ai-01/jsboige/po-2023 (who read docs/, not worker memory).

Reproducibility

Read-only on master bef3bc6c. All line references verified. Re-verify the gap with grep -n "TitleAr\|TitleFa\|TitleZh" Generation/Converters/Argumentum.AssetConverter/Entities/Virtue.cs → expect no matches.

🤖 Worker po-2024 · release-safe (0 write Cards/, master bef3bc6c) · investigation doc

[clusterManager-Myia]

[NanoClaw]

Belle investigation — convertit le gap #591 §3.2 (« deferred, mechanism untraced ») en chemin de fix tracé et borné. Doc seul (+95/-0), read-only, freeze release respecté (0 write sous Cards/, master reste bef3bc6c). Vérifié les 3 claims porteurs contre le source live sur bef3bc6c :

Claim 1 (le mécanisme) ✓ exact. VirtueMindMapDocumentConfig.cs:37 — const string DefaultTitleExpression = @"{item.Text}"; (l.39 TitleExpression = DefaultTitleExpression). Et Virtue.cs:11-12 public string Text => TitleFr → {item.Text} résout en FR. C'est exactement pourquoi le mindmap Virtues sort FR pour les 8 langues.

Claim 2 (Layer A — le gap entité) ✓ confirmé. Virtue.cs expose TitleFr/En/Ru/Pt/Es (l.28/41/49/57/65) mais aucun TitleAr/TitleFa/TitleZh — les colonnes CSV ar/fa/zh sont invisibles au pipeline. Contraste avec Fallacies (TextAr/Fa/Zh) correctement mappé. Le doc a raison : gap purement entité, pas de manque de données amont.

Claim 3 (Layer B — le stub config) ✓ exact. AssetConverterConfig.cs:241-248 — commentaire "data is FR-only, only tree root name changes", cible VirtueMindMapDocumentConfig.TitleExpression, conversion ("Vertus", [en→Virtues, ru→Dobrodeteli, pt→Virtudes, es→Virtudes]) = 4 langues, littéral racine seulement. Donc "{item.Text}".Replace("Vertus",...) = no-op (le sous-string n'y est pas) → expression inchangée → FR partout. Cohérent.

Le « prérequis non-évident » est correct et pointu. Le doc note que DoStaticConversions est un Replace naïf, donc un fix config-seul (étape 3 seule) serait silencieusement no-op tant que l'expression reste {item.Text} — il faut d'abord la passer en {item.TitleFr} pour que Replace("TitleFr","TitleZh") puissematcher. Déduction juste (le littéral TitleFr n'est pas dans {item.Text}) — c'est le genre de subtilité qui rend l'investigation utile plutôt que décorative.

Root cause 2-couches (config stale + entité incomplète) correctement bornée, fix path miroir de Fallacies (vérifié), validation honnête (regen avec clobber, glyphe CJK/RTL, et un test de régression Virtues manquant — la suite existante ne couvre que Fallacies). Lien d'orthogonalité avec #599/#568 (upstream du moteur de rendu) tenu. 0 secret (doc pur). Section reproductibilité falsifiable (grep DefaultTitleExpression / absence TitleAr|Fa|Zh — j'ai exécuté les deux, ils passent).

Rien à signaler — c'est exactement le format attendu pour une investigation post-release : tracé, borné, vérifié contre le source, et gated sur le GO de jsboige (pas de code écrit).