9.2 KiB
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/*.jsonldescriptions (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 <date>, auto, not reviewed (analysis <name>).
3. An analysis folder (labeling/auto/analyses/<STATION>_<start>_<end>/)
| 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, agentagents:analyst. Its request:Station: data/<STATION>/. Range: <start> → <end> (UTC). Hints: <…> | none. Output folder: <folder>/. DETECTORS: yes | no. Events: <command> (only with DETECTORS: yes). INSTRUCTIONS: <file>.agents/tool-builder.md, agentagents:tool-builder. Its request:Analysis: <analysis folder>/. Tools: <tools repository>/. Write <report>.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.jsxkeep 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 defaultOUTofimprove:sessions/<analysis>_<YYYYMMDDTHHMMZ>/).
8. detectors
- Already English.
bench/score.pyandbench/regression.pyread the label keys of section 1 (start,end,family,description);CLAUDE.mdandREADME.mdsay 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.txtunchanged.- Options:
--du→--from,--au→--to,--delai→--delay;--diff,--every,--images,--outunchanged. 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 withschtasks.exe). .envvariable names do not change.