verbatra report

verbatra report provenance lit verbatra.provenance.json, le fichier de verrouillage et les fichiers de locale, puis affiche par locale cible combien de valeurs une machine a écrites, combien une personne a relues et combien des personnes ont écrites ou importées. Il n'appelle aucun fournisseur, n'a besoin d'aucune clé d'API et n'écrit rien. Le rapport est une preuve d'appui, pas un conseil juridique.

SynopsisCopier le lien vers cette section

verbatra report <report> [flags]

• <report> : le rapport à afficher. provenance est le seul pour l'instant ; tout autre nom est une erreur d'utilisation.

ExemplesCopier le lien vers cette section

# décomptes par locale : machine non relue, machine relue, humaine, importée et le reste
verbatra report provenance

# origine et état de relecture de chaque clé, pour un fichier d'audit
verbatra report provenance --json > provenance-report.json

# seulement la locale allemande
verbatra report provenance --locales de

OptionsCopier le lien vers cette section

Accepte aussi les options globales --cwd, --config et --json.

ComportementCopier le lien vers cette section

SortieCopier le lien vers cette section

verbatra report provenance (source en, verbatra 0.12.0, 2026-09-29T08:00:00.000Z)
  locale  machine, unreviewed  machine, reviewed  human  import  external  unrecorded  unknown  total
  de      12                   40                 3      85      1         0           0        141
Supporting evidence from verbatra.provenance.json, not legal advice. --json lists every key.

La première ligne nomme la locale source, la version de verbatra et le moment où le rapport a été fait. Chaque ligne compte les clés qui ont une valeur à la fois dans la source et dans cette locale. Preuves de traduction automatique décrit les catégories, ce que le rapport peut montrer ou non, et le schéma JSON complet.

Il n'y a pas de --out : le rapport va sur stdout, comme pour check et diff, alors redirige-le si tu veux le garder.

Sortie JSONCopier le lien vers cette section

Schéma : report-envelope.json valide l'enveloppe entière ; Schémas liste les autres.

--json affiche une enveloppe dont le result liste l'origine, l'état de relecture, le fournisseur, le modèle et le relecteur de chaque clé, pour un fichier d'audit. Si le fichier de provenance est illisible, le résultat est { "available": false, "reason": "provenance-unreadable" }.

Provenance illisibleCopier le lien vers cette section

Un rapport sans fichier de provenance lisible listerait chaque valeur comme unrecorded, ce qui n'est pas la même chose que ne pas avoir d'enregistrement. La commande échoue donc prudemment avec la sortie 1, comme check --require-reviewed, pour qu'un job de CI n'archive pas un fichier d'audit vide.

Retour dans le terminalCopier le lien vers cette section

La commande affiche une ligne pendant qu'elle lit les fichiers. Quand des traductions automatiques attendent une relecture, elle suggère Studio :

verbatra: reading the provenance record... done (0.1s)
next: verbatra studio (approve or reject the 12 machine translations no person has reviewed yet)

Ces lignes vont sur stderr, et --quiet les supprime. Consulte Sortie dans le terminal.

Codes de sortieCopier le lien vers cette section

Consulte le contrat des codes de sortie.

Voir aussiCopier le lien vers cette section

• Preuves de traduction automatique couvre le rapport, son schéma et les marqueurs de traduction automatique dans les exports XLIFF et TMX.
• Le fichier de verrouillage explique le fichier de provenance que lit le rapport.
• verbatra check --require-reviewed fait échouer la CI tant qu'une traduction automatique n'est pas approuvée.