# English translation and renames: the shared names 2026-11-16. Decided by the user: everything in the seven repositories of the architecture (`docs/architecture.drawio`) goes to English, the labels of `labeling/auto` included, and French file names and identifiers are renamed. This table fixes every name that crosses a file or a repository boundary; inside a file, translate freely but consistently. Conversations with the user stay in French; the repositories are in English. ## Rules for every translator - Text (docs, prompts, comments, docstrings, program output, UI, label descriptions): English, same meaning, same structure, nothing added or dropped. Keep proper nouns, sensor names (PR04, CTR03), station names, label ids (NORDEND-243), family keys, numbers, units, dates and date formats exactly as they are. - The evidence vocabulary stays as it is: `confirmed`, `strongly supported`, `consistent with`, `possible`, `insufficient evidence`, `not observed`. - History references (D-119, E-004, "wf-improve session X, mod. 1, S2", commit hashes) stay as they are. - Frozen, not translated (a README in each may be translated): `Optimizer/archive/**`, `labeling/docs/archive/**`, `Diagnostic-App/docs/superpowers/**` (plans and specs are history), `labeling/manual/*.jsonl` descriptions (the user's own; only their keys are migrated). - Never touch `.env`; never copy metric identifiers (`SIM_CCID`, `ip*`). - Do not commit: the orchestrator commits each repository after the integration checks. ## 1. Label files (`labeling/auto/*.jsonl`, `labeling/manual/*.jsonl`, an analysis' `labels.jsonl`) | French key | English key | |---|---| | `id` | `id` | | `debut` | `start` | | `fin` | `end` | | `categorie` | `family` | | `description` | `description` | | `revue` | `review` | | `analyse` | `analysis` | Family values do not change (`Visibility`, `Obstruction`, `Target issue`, `Thermal displacement`, `No data`, `Displacement`). New labels are written in English. ## 2. labeling | Before | After | |---|---| | `familles.md` | `families.md` (its table column « Pour le client » → "For the client") | | `regles-d-etiquetage.md` | `labeling-rules.md` | | `carte-des-etiquettes.md` | `label-map.md` | | `connaissances/` | `knowledge/` | | `connaissances/cas-annotes-par-l-expert.md` | `knowledge/expert-annotated-cases.md` | | `connaissances/chaine-de-mesure.md` | `knowledge/measurement-chain.md` | | `connaissances/colonnes-des-deplacements.md` | `knowledge/displacement-columns.md` | | `connaissances/cycle-thermique.md` | `knowledge/thermal-cycle.md` | | `connaissances/images-de-la-camera.md` | `knowledge/camera-images.md` | | `connaissances/incident-de-barcelone.md` | `knowledge/barcelona-incident.md` | | `connaissances/les-trous.md` | `knowledge/gaps.md` | | `connaissances/metriques-de-qualite.md` | `knowledge/quality-metrics.md` | | `controle.py` | `validate.py` | | `ids.py`, `precedents.py` | unchanged names | | `precedents.py --exclure`, `--famille` | `--exclude`, `--family` (`--k`, `--index`, `--check` unchanged) | Provenance strings of `precedents.py`: `auto, reviewed on `, `auto, not reviewed (analysis )`. ## 3. An analysis folder (`labeling/auto/analyses/__/`) | Before | After | |---|---| | `demande.json` (keys `station`, `debut`, `fin`, `indices`) | `request.json` (keys `station`, `start`, `end`, `hints`) | | `etiquettes.jsonl` | `labels.jsonl` | | `analyse.md` | `analysis.md` | | `rapport.md` | `report.md` | | `outils/` (the analyst's scripts) | `scripts/` | | `outils.md` (the tool-builder's report) | `tools.md` | | `travail/` | `work/` | | `travail/journal.jsonl` | `work/log.jsonl` | | `travail/session` | `work/session` | | `travail/versees.jsonl` | `work/submitted.jsonl` | | `travail/optimisation.jsonl` | `work/optimization.jsonl` | Figures keep their file names unless the report translator renames them and fixes every link to them. ## 4. tools (`~/tools`) Files (`scripts/`): `donnees.py` → `data.py`, `inventaire.py` → `inventory.py`, `resume.py` → `summary.py`, `plages.py` → `ranges.py`, `jours.py` → `days.py`, `ensemble.py` → `overview.py`, `metriques.py` → `metrics.py`, `qualite.py` → `quality.py`, `stations.py` → `stations.py`, `graphique.py` → `plot.py`, `vignettes.py` → `thumbnails.py`, `gif.py` → `gif.py`. `GUIDE.md` keeps its name. Names imported from another file (exactly these): | Module | Before → after | |---|---| | `data` (ex `donnees`) | `charger` → `load`, `charger_camera` → `load_camera`, `charger_temperature` → `load_temperature`, `charger_metriques` → `load_metrics`, `est_reference` → `is_reference`, `rejetee` → `rejected`, `filtrer` → `filter_window`, `instant` → `parse_time`, `iso` → `iso`, `heure_image` → `image_time`, `trouver` → `find_files`, `POSE` → `POSE` | | `plot` (ex `graphique`) | `borne` → `bound`, `COLONNES` → `COLUMNS` | | `summary` (ex `resume`) | `QUALITE` → `QUALITY`, `ARRONDI` → `ROUNDING`, `bruit_propre` → `own_noise`, `duree` → `duration`, `STATS` → `STATS`, `COLONNES` → `COLUMNS` | | `inventory` (ex `inventaire`) | `METRIQUE_RE` → `METRIC_RE` | | `metrics` (ex `metriques`) | `cibles` → `targets`, `coupe` → `cut`, `suites` → `runs` | The app (`Diagnostic-App/app/server/station.py`) imports `data` and uses `load`, `load_camera`, `image_time`, `parse_time`, `iso`. Command-line options: | Before | After | Before | After | |---|---|---|---| | `--autres` | `--others` | `--marge` | `--margin` | | `--bords` | `--edges` | `--marque` | `--mark` | | `--bornes` | `--bounds` | `--metriques` | `--metrics` | | `--calme` | `--calm` | `--metriques-seules` | `--metrics-only` | | `--capteurs` | `--sensors` | `--min-mesures` | `--min-measurements` | | `--colonne` | `--column` | `--niveau periode\|fenetre` | `--level period\|window` | | `--colonnes` | `--columns` | `--noms` | `--names` | | `--commun` | `--common` | `--nuit` | `--night` | | `--contraste` | `--contrast` | `--numeros` | `--numbers` | | `--contre` | `--against` | `--pas` | `--step` | | `--debut` | `--start` | `--rayon` | `--radius` | | `--duree` | `--duration` | `--residus …\|non` | `--residuals …\|no` | | `--etiquettes` | `--labels` | `--rigide` | `--rigid` | | `--fichiers` | `--files` | `--sans` | `--without` | | `--fin` | `--end` | `--sauf` | `--except` | | `--fixe` | `--fixed` | `--seuil` | `--threshold` | | `--fusion` | `--merge` | `--sortie` | `--out` | | `--glissant` | `--rolling` | `--suivre` | `--follow` | | `--heures` | `--times` | `--table T1/T2\|non` | `--table T1/T2\|no` | | `--hors` | `--outside` | `--essai` | `--self-test` | | `--jours` | `--days` | `--lissage` | `--smoothing` | | `--largeur` | `--width` | | | Unchanged: `--figure`, `--fraction`, `--instants`, `--k`, `--max`, `--min`, `--stat median|min|max`, `--zone`. Default output folder: `out/diagnostic` (unchanged). Output: English text, every number, date format and column order identical. ## 5. agents (`~/agents`) - `agents/analyste.md` → `agents/analyst.md`, agent `agents:analyst`. Its request: `Station: data//. Range: → (UTC). Hints: <…> | none. Output folder: /. DETECTORS: yes | no. Events: (only with DETECTORS: yes). INSTRUCTIONS: .` - `agents/tool-builder.md`, agent `agents:tool-builder`. Its request: `Analysis: /. Tools: /. Write .` - `upgrader`, `validator`: already English. ## 6. Diagnostic-App - `consignes/analyste.md` → `instructions/analyst.md`. - `app/serveur/` → `app/server/`: `serveur.py` → `server.py`, `station.py`, `analyse.py` → `analysis.py`, `check.py`. - `app/web/src/commun.jsx` → `app/web/src/common.jsx`; `App.jsx`, `main.jsx`, `pages/Data.jsx`, `pages/Images.jsx` keep their names. - API: `/api/courbes` → `/api/curves`, `/api/detecteurs` → `/api/detectors`, `/api/etiquettes` → `/api/labels`, `/api/analyses/{name}/rapport.html` → `report.html`, `/optimiser` → `/optimize`, `/bilan.html` → `/summary.html`; the others unchanged. JSON fields between server and page: English, chosen by the Diagnostic-App translator, the same on both sides. - Environment variables `AIMSIGHT_DATA`, `AIMSIGHT_LABELS`, `AIMSIGHT_PORT`, the VS Code task "Run app" and the six links (`data`, `labeling`, `detectors`, `tools`, `agents`, `optimizer`) keep their names. ## 7. Optimizer - `seances/` → `sessions/` (the default `OUT` of `improve`: `sessions/_/`). ## 8. detectors - Already English. `bench/score.py` and `bench/regression.py` read the label keys of section 1 (`start`, `end`, `family`, `description`); `CLAUDE.md` and `README.md` say so (the "French keys" line goes). ## 9. aimsight-data - `extraction/pomper.py` → `extraction/pump.py`, `extraction/pomper.sh` → `extraction/pump.sh`, `extraction/lenzspitze_absolu.py` → `extraction/lenzspitze_absolute.py`; `stations.txt` unchanged. - Options: `--du` → `--from`, `--au` → `--to`, `--delai` → `--delay`; `--diff`, `--every`, `--images`, `--out` unchanged. - `out/pompage.log` → `out/pump.log`, `out/pompage.lock` → `out/pump.lock`. - VS Code tasks: « pomper » → "pump", « pomper une plage » → "pump a range". - The Windows Task Scheduler task « AIMsight pompage » keeps its name; its action points to `extraction/pump.sh` (updated by the orchestrator with `schtasks.exe`). - `.env` variable names do not change.