本文へスキップ
本文へスキップ

リファレンス / CLI

機械翻訳されたページ

このページは自動翻訳のため、誤りや不自然な表現が含まれている可能性があります。正式な内容は英語版です。英語の原文を読む。

verbatra report

読み取り専用のプロジェクトレポートを出力します。来歴レポートは、各訳文の出どころと、人がレビューしたかどうかを一覧します。

verbatra report provenance は verbatra.provenance.json、ロックファイル、ロケールファイルを読み込み、ターゲットロケールごとに、機械が書いた値の件数、人がレビューした値の件数、人が書いたかインポートした値の件数を出力します。プロバイダーを呼び出さず、API キーも不要で、何も書き込みません。レポートは補足的な証跡であり、法的助言ではありません。

書式

verbatra report <report> [flags]
  • <report>:出力するレポートです。現在は provenance だけで、ほかの名前は使い方の誤りになります。

例

# ロケールごとの件数(機械翻訳で未レビュー、機械翻訳でレビュー済み、人が書いた値、インポート、その他)
verbatra report provenance

# 監査ファイル用に、各キーの出どころとレビューの状態を出力する
verbatra report provenance --json > provenance-report.json

# ドイツ語ロケールだけを対象にする
verbatra report provenance --locales de

オプション

オプション引数デフォルト説明
--locales<list>すべての設定済みターゲットこのカンマ区切りの部分集合だけをレポートする。設定にないロケールは UNKNOWN_LOCALE、空のリストは INVALID_LOCALES で失敗し、どちらも終了コード 2 になる

グローバルオプションの --cwd、--config、--json も使えます。

動作

出力

出力
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.

1 行目には、ソースロケール、verbatra のバージョン、レポートの作成日時が示されます。各行は、ソースとそのロケールの両方に値があるキーを数えます。来歴レポートに、各分類の説明、レポートでわかることとわからないこと、JSON スキーマの全体があります。

--out はありません。レポートは check や diff と同じく stdout に出力されるため、保存するにはリダイレクトします。

JSON 出力

スキーマ:report-envelope.json がエンベロープ(envelope)全体を検証します。ほかのスキーマはスキーマに一覧があります。

--json は、JSON 出力のエンベロープを 1 つ出力します。result には、監査ファイル向けに、すべてのキーの出どころ、レビューの状態、プロバイダー、モデル、レビュー担当者が一覧されます。来歴ファイルを読み込めない場合、結果は { "available": false, "reason": "provenance-unreadable" } です。

読み込めない来歴

読み込める来歴ファイルがないままレポートを作ると、すべての値が unrecorded として一覧されます。これは記録がないことと同じではありません。そのためコマンドは、安全側で失敗し(fail closed)、終了コード 1 で終了します。check --require-reviewed と同じ動作です。これにより、CI ジョブが空の監査ファイルをアーカイブすることはありません。

ターミナルへの表示

コマンドは、ファイルを読み込んでいる間、1 行を表示します。機械翻訳がレビュー待ちの場合は、Studio を提案します。

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

これらの行は stderr に出力され、--quiet で表示されなくなります。詳しくはターミナル出力を参照してください。

終了コード

終了コード意味
0レポートが出力された
1レポートなし。verbatra.provenance.json が破損している、またはより新しい verbatra が書き込んだ
2実行できなかった。設定エラー、読み取れないソースファイルまたはロックファイル、設定にないまたは空の --locales 値(UNKNOWN_LOCALE、INVALID_LOCALES)、不明なレポート名

終了コードの規則は終了コードを参照してください。

関連項目

GitHub で編集

このページの内容