Generated from cat-harness/library/processes/translation-round-trip.bpmn by gen-processes-viz.ts — do not edit here. All processes · cat-harness processes

Translation round trip (untainted)

Process_TranslationRoundTrip · advisory · 6 step(s)

Did the meaning survive the translation? The untainted round trip on a sample of one locale’s strings, with the two parties kept apart: a back-translator who sees only the target text, and an adjudicator who sees only the source and the back-translation.

You are in this process when multi-locale-translation or translation-refresh calls it, after the deterministic gates have passed. It is the translation instance of untainted-verification: the producer (the locale translator) draws the sample and never writes the verdict; the back-translator renders and rules on nothing; the adjudicator rules. GT_RoundTripQa in translation-workflow is the same check drawn as one step; this diagram draws its parties, because the separation between them is what makes the result a measurement.

A first run samples every diagram label, the personas and scenarios, and a seeded random fraction of the rest; a refresh samples only the strings it changed. The third state is drawn: when two separate parties cannot be dispatched, the producer records “could not dispatch” with a reason, and that is never a pass.

BPMN diagram: Translation round trip (untainted)

How it connects

Lanes — who acts

lanerolewhat it does here
Locale translatorlocale-translatorThe producer. It chooses what is checked, by a rule stated before any result is seen, and hands on the target strings alone. It may record one thing here, “could not dispatch”, because without that state a producer forbidden from writing a verdict has nothing honest to write.
Back-translatorback-translatorSees the target strings and nothing else: not the source, not the repository, no tools. Shown the source, it writes the source back and the check passes without measuring anything.
Round-trip adjudicatorround-trip-adjudicatorSees the source strings and the back-translation, never the target text, and rules each pair drift or not drift with its reason. Both halves of the drift definition are in front of it, so that inflection and word order are not ruled as drift.

Steps

Every one of the 6 step(s) is documented.

steplaneskill / sub-processwhat it does
Draw the sample
Task_RT_Sample
Locale translatortranslation-managerOn a first translation: every diagram label, every persona and scenario string, and a seeded random fraction of the rest, with the seed written down so the sample can be drawn again. On a refresh: only the strings that were new or fuzzy. Hand the back-translator the msgstr values alone, keyed by an opaque id.
Record could not dispatch
Task_RT_RecordNA
Locale translatortranslation-managerWrite one entry, result: "n/a", metrics.dispatch: "unavailable", with the reason. The producer may write this entry and no other. It is never a pass, and the QA report says so.
Back-translate the target text
Task_RT_BackTranslate
Back-translatoruntainted-verificationRender each target string into the source language, from the target text alone, using no tools, and say so in a TOOLS_USED line that is recorded. A string that cannot be rendered is reported as such, not guessed.
Pre-screen every pair
Task_RT_PreScreen
Round-trip adjudicatortranslation-managerMechanically, over every (source, back-translation) pair: flag a pair whose negation, modal, quantifier, number or code tokens differ, and a pair whose word overlap is low. The pre-screen only chooses what is read first; it rules on nothing, and an unflagged pair is still in the sample.
Read and rule each flagged pair
Task_RT_Rule
Round-trip adjudicatoruntainted-verification
translation-manager
Read every flagged pair in full and rule it drift or not drift, with the reason. Not drift: synonyms, articles, word order, inflection, a purpose clause rendered in the subjunctive, an acronym left uninflected, an acronym spelled out with the acronym kept. Drift: a claim added, dropped, weakened, strengthened or reversed; a term of art swapped for one that means something else; a named entity, number or quantifier moved.
Record both witnesses
Task_RT_Record
Round-trip adjudicatoruntainted-verificationRecord the adjudicator’s verdict first and the back-translator’s rendering behind it (translation:roundtrip --payload), so a reader can ask both who ruled and on what basis. The counts (sampled, flagged, drift, not drift) go into the locale’s QA report.

Decisions

Every one of the 1 decision(s) is documented.

decisionwhat decides itbranches
Two parties available?
Gateway_RT_Dispatch
Can a back-translator and an adjudicator be dispatched as two separate parties, neither of them the producer? Yes runs the round trip. No records the third state.Yes → Back-translate the target text
No → Record could not dispatch

folio-assistant — code under the Apache License 2.0, documentation under CC BY 3.0. Generated schema and API references are rebuilt from source on every push to main.

deployed dev