Files
aimsight-app/docs/superpowers/plans/2026-11-16-english-renames.md
T

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/*.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 <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, agent agents: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, agent agents: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.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/<analysis>_<YYYYMMDDTHHMMZ>/).

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.