Prune round-trip rulings of removed strings
Drop the translation-semantic-roundtrip rulings of strings the catalogues no longer hold, and renumber the rest to catalogue order. Rulings are paired with strings by the hash of their msgid, so removing strings invalidates none and needs no agent re-run; this is the upkeep that follows. It only drops or renumbers: a verdict is never changed or invented, and a ruling for a string the ref’s history never held (one recorded ahead of its PR) is kept.
Skills it satisfies
A skill states the capability; this Tool is one way to exercise it. Each skill’s declared input and output contract follows, where it has one.
translation-manager
Translation lifecycle management for folio content. Covers gettext PO/POT extraction and injection, TranslationNode manifests as KG nodes, official vs unofficial translations, staleness tracking, sign-off workflow, automatic badge rendering, the poSources fallback resolution chain, and translating into several locales as a team: one extraction, a PR per locale to main, FHIR terms as CodeSystem supplements, the untainted round trip as run, and the per-locale QA report.
Source: cat-harness/library/skills/library-core/translation-manager.md.
Also satisfied by: translation-extract, translation-inject, translation-platforms, translation-roundtrip-record, translation-signoff, translation-status, translation-validate.
The skill declares no I/O contract (schemas/skills/translation-manager/{input,output}.schema.json).
Inputs and outputs
Each port names a shared type by IRI, so two Tools for one skill can be checked for interchangeability.
| port | type | required | description | constraint | |
|---|---|---|---|---|---|
| in | write | Flag | Apply the change to test/attestations/translation-qa/. Absent, it is a dry run that prints each dropped ruling and the renumbered spans. | boolean · A boolean switch — projects to a bare flag, with no value word | |
| in | ref | Branch | Whose catalogues decide what was removed. Default origin/main: the state branch serves main and every branch, so a ruling goes only once main no longer holds its string. | string · pattern ^[A-Za-z0-9][A-Za-z0-9._/-]*$ · A git branch name | |
| out | attestations | RepoPath | With –write, the rewritten test/attestations/translation-qa/<catalogue>.<locale>.attestations.json, to be pushed to cat/who-iris/attestations. | string · pattern ^[A-Za-z0-9._][A-Za-z0-9._/-]*$ · A path relative to the repository root. No .. segments. |
Processes and tasks
Steps this Tool can carry out, because each names a skill it satisfies:
| process | step | lane | via skill |
|---|---|---|---|
| Human Translation Workflow | Identify content and target locale | Translation Coordinator | translation-manager |
| Human Translation Workflow | Assign to qualified human translator | Translation Coordinator | translation-manager |
| Human Translation Workflow | Check translation completeness | Translation Coordinator | translation-manager |
| Human Translation Workflow | Request completion of remaining strings | Translation Coordinator | translation-manager |
| Human Translation Workflow | Receive assignment and materials | Human Translator | translation-manager |
| Human Translation Workflow | Translate strings in preferred tool | Human Translator | translation-manager |
| Human Translation Workflow | Submit completed .po file | Human Translator | translation-manager |
| Human Translation Workflow | Review translation for accuracy | Subject-Matter Expert / Reviewer | translation-manager |
| Human Translation Workflow | Return for correction with annotations | Subject-Matter Expert / Reviewer | translation-manager |
| Human Translation Workflow | Sign off translation as official | Subject-Matter Expert / Reviewer | translation-manager |
| Human Translation Workflow | Extract the POT | Automated Pipeline | translation-manager |
| Human Translation Workflow | Prepare domain glossary | Automated Pipeline | translation-manager |
| Human Translation Workflow | Inject the PO | Automated Pipeline | translation-manager |
| Human Translation Workflow | Round-trip translation QA | Automated Pipeline | translation-manager |
| Human Translation Workflow | Append WHO disclaimer (if DAK) | Automated Pipeline | translation-manager |
| Human Translation Workflow | Write status.json (official) | Automated Pipeline | translation-manager |
| Multi-locale translation | Extract every template once | Source-language lead | translation-manager |
| Multi-locale translation | Merge the one source PR to main | Source-language lead | translation-manager |
| Multi-locale translation | Translate one locale | Locale translator (one per locale) | translation-manager |
| Multi-locale translation | File the source errors as one issue | Source-language lead | translation-manager |
| Multi-locale translation | Run the deterministic gates | Locale translator (one per locale) | translation-manager |
| Multi-locale translation | Check glossary consistency | Locale translator (one per locale) | translation-manager |
| Multi-locale translation | Write the locale’s QA report | Locale translator (one per locale) | translation-manager |
| Multi-locale translation | Open the locale PR to main | Locale translator (one per locale) | translation-manager |
| Multi-locale translation | Fix each drift on the PR | Locale translator (one per locale) | translation-manager |
| Multi-locale translation | Validate and merge in the window | Source-language lead | translation-manager |
| Translation refresh (watcher) | Translate new and fuzzy only | Locale translator | translation-manager |
| Translation refresh (watcher) | Re-run the gates | Locale translator | translation-manager |
| Translation refresh (watcher) | QA report and one PR to main | Locale translator | translation-manager |
| Translation round trip (untainted) | Draw the sample | Locale translator | translation-manager |
| Translation round trip (untainted) | Record could not dispatch | Locale translator | translation-manager |
| Translation round trip (untainted) | Pre-screen every pair | Round-trip adjudicator | translation-manager |
| Translation round trip (untainted) | Read and rule each flagged pair | Round-trip adjudicator | translation-manager |
| Translation Workflow | Extract translatable strings (POT) | Agent / platform (automated) | translation-manager |
| Translation Workflow | Build and review the locale term base | Agent / platform (automated) | translation-manager |
| Translation Workflow | Produce translation (PO file) | Agent / platform (automated) | translation-manager |
| Translation Workflow | Inject translations (PO → Markdown) | Agent / platform (automated) | translation-manager |
| Translation Workflow | Round-trip translation QA (back-translate) | Agent / platform (automated) | translation-manager |
| Translation Workflow | Check glossary terms (translation:glossary:check) | Agent / platform (automated) | translation-manager |
| Translation Workflow | Adjudicate the flagged passage (human) | Human reviewer / adjudicator | translation-manager |
| Translation Workflow | Edit the flagged passage and re-inject | Human reviewer / adjudicator | translation-manager |
| Translation Workflow | Write status.json (unofficial) | Agent / platform (automated) | translation-manager |
| Translation Workflow | Sign off translation (human adjudicator) | Human reviewer / adjudicator | translation-manager |
| Translation Workflow | Write status.json (official) | Agent / platform (automated) | translation-manager |
| Translation Workflow | Check staleness (source hash) | Agent / platform (automated) | translation-manager |
| Narrative review | Review the translation | Narrative reviewer | translation-manager |
| Ingestion subprocess — the L1 completeness gate | Round-trip translation QA | Ingestion Engine (agent, runs unattended) | translation-manager |
How it is deployed and reached
- Command line. From the repository root:
bun run cat translation-qa:prune.cat translation-qa:prunerunsbun run who-iris/scripts/translation-qa-prune.ts(declared inwho-iris/package.json). - GitHub Actions. No workflow in this checkout runs its command.
As an API: its operation in the OpenAPI document and the MCP tool list of its layer.
| install | none |
| runtime | bun, git |
| network | no |
What it is made of
| role | file | |
|---|---|---|
| definition | who-iris/tools/translation-qa-prune/translation-qa-prune.ts | |
| script | who-iris/scripts/translation-qa-prune.ts |
Linked data
The Tool is published as its own JSON-LD document at its IRI, https://litlfred.github.io/folio-assistant/who-iris/tools/translation-qa-prune.jsonld, partOf its layer’s document. The node below is the definition this page was drawn from, and is embedded in the page as application/ld+json.
{
"@context": "https://litlfred.github.io/folio-assistant/who-iris/who-iris.context.jsonld",
"@id": "https://litlfred.github.io/folio-assistant/who-iris/tools/translation-qa-prune.jsonld",
"@type": "https://litlfred.github.io/cat-harness/v0/ns/Tool",
"partOf": "https://litlfred.github.io/folio-assistant/who-iris/who-iris.jsonld",
"name": "translation-qa-prune",
"title": "Prune round-trip rulings of removed strings",
"description": "Drop the translation-semantic-roundtrip rulings of strings the catalogues no longer hold, and renumber the rest to catalogue order. Rulings are paired with strings by the hash of their msgid, so removing strings invalidates none and needs no agent re-run; this is the upkeep that follows. It only drops or renumbers: a verdict is never changed or invented, and a ruling for a string the ref's history never held (one recorded ahead of its PR) is kept.",
"install": {
"none": true
},
"invoke": {
"shell": "bun run cat translation-qa:prune"
},
"io": {
"inputs": [
{
"name": "write",
"schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/Flag",
"description": "Apply the change to test/attestations/translation-qa/. Absent, it is a dry run that prints each dropped ruling and the renumbered spans.",
"required": false,
"arg": {
"flag": "--write"
}
},
{
"name": "ref",
"schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/Branch",
"description": "Whose catalogues decide what was removed. Default origin/main: the state branch serves main and every branch, so a ruling goes only once main no longer holds its string.",
"required": false,
"arg": {
"flag": "--ref"
}
}
],
"outputs": [
{
"name": "attestations",
"schema": "https://litlfred.github.io/folio-assistant/cat-harness/tool-types.schema.json#/$defs/RepoPath",
"description": "With --write, the rewritten `test/attestations/translation-qa/<catalogue>.<locale>.attestations.json`, to be pushed to `cat/who-iris/attestations`."
}
]
},
"satisfies": [
"translation-manager"
],
"requirements": {
"runtime": [
"bun",
"git"
],
"network": false
}
}