i18n-sync— agent skill

Contexte

Les 5 fichiers de locale se trouvent dans apps/desktop/src/locales/ :

• en.ts — source de vérité (objet TypeScript imbriqué const en = { ... })
• fr.ts, es.ts, pt-BR.ts, zh-CN.ts — doivent refléter exactement la même structure

Les locales utilisent des objets imbriqués (pas de clés dot-notation plates) :

const fr = {
  common: {
    cancel: "Annuler",
    save: "Enregistrer",
  },
  // ...
}

Les composants Vue consomment les clés via useI18n() :

const { t } = useI18n()
// template: {{ t('common.save') }}

Choix du mode

Au démarrage, demander à l'utilisateur quel mode il souhaite — sauf si le contexte est explicite (ex : "j'ai ajouté un bouton", "il faut traduire X") : aller directement en Mode 3.

Mode 1 — Audit

Objectif : détecter les désynchronisations sans modifier aucun fichier.

1. Lire en.ts et extraire récursivement toutes les clés (chemin dot-notation : common.cancel, branches.create, …)
2. Faire de même pour fr.ts, es.ts, pt-BR.ts, zh-CN.ts
3. Pour chaque locale, calculer :

• Clés manquantes : présentes dans en.ts mais absentes de la locale
• Clés orphelines : présentes dans la locale mais absentes de en.ts

1. Afficher le tableau récapitulatif :

Locale     | Clés manquantes | Clés orphelines
-----------|-----------------|----------------
fr.ts      | 0               | 0
es.ts      | 3               | 0
pt-BR.ts   | 1               | 2
zh-CN.ts   | 0               | 0

1. Lister les clés concernées sous le tableau (regroupées par locale)
2. Signaler les clés orphelines séparément — elles peuvent indiquer une fonctionnalité supprimée ; demander à l'utilisateur si elles doivent être retirées

Mode 2 — Scaffold (correction automatique)

Objectif : corriger toutes les désynchronisations détectées.

Pour chaque clé manquante dans une locale :

• Ajouter la clé avec la valeur anglaise et le commentaire // TODO: translate
• Respecter la position de la clé dans le groupe imbriqué correspondant (ordre de en.ts)
• Ne jamais supprimer de clé existante sans confirmation explicite

Exemple :

// Avant (es.ts) — clé manquante : common.refresh
common: {
  cancel: "Cancelar",
  save: "Guardar",
},

// Après
common: {
  cancel: "Cancelar",
  refresh: "Refresh", // TODO: translate
  save: "Guardar",
},

Pour les clés orphelines :

• Ne pas les supprimer automatiquement
• Lister chaque clé orpheline et demander confirmation avant suppression

Terminer par un résumé des fichiers modifiés et du nombre de clés ajoutées.

Mode 3 — Ajout d'une nouvelle clé

Objectif : ajouter proprement une nouvelle string UI dans les 5 locales.

1. Identifier le groupe imbriqué approprié dans en.ts (ex: common, branches, settings…)
2. Ajouter la clé dans en.ts avec la valeur en anglais définitive
3. Ajouter la même clé dans fr.ts, es.ts, pt-BR.ts, zh-CN.ts avec valeur anglaise + // TODO: translate
4. Si l'utilisateur précise un composant Vue, vérifier qu'il utilise useI18n() — signaler tout texte hardcodé détecté
5. Afficher la clé dot-notation résultante pour copier-coller dans le composant

Exemple d'ajout dans en.ts :

branches: {
  checkout: "Check out",
  create: "Create branch",
  delete: "Delete branch",         // ← nouvelle clé ajoutée ici
  rename: "Rename",
},

Exemple dans fr.ts :

branches: {
  checkout: "Extraire",
  create: "Créer une branche",
  delete: "Delete branch",         // TODO: translate
  rename: "Renommer",
},

Rappels critiques

• Ne jamais hardcoder du texte en dur dans les composants Vue — utiliser t('clé')
• Ajouter la clé dans tous les fichiers même si la traduction n'est pas prête
• Les clés orphelines sont suspectes : poser la question avant toute suppression
• L'ordre des clés dans en.ts fait référence ; les autres locales suivent le même ordre dans chaque groupe