CLI — キャッシュのメンテナンス
cleanup
概要: ai-i18n-tools cleanup [--dry-run] [--backup <path>]
markdown_source_issuesテーブル全体をクリアし、その後sync --force-update(抽出、UI、SVG、ドキュメント、および有効な場合はtranslate-json)を実行して、現在設定されているドキュメントのMarkdownの問題が再生成されるようにします。その後、次の処理を行います。
- 古いセグメント行(nullの
last_hit_at/ 空のファイルパス)を削除します。 - 解決されたソースパスがディスク上に存在しない
file_tracking行を破棄します。 filepathメタデータが欠落しているファイルを指している翻訳行を削除します。- 孤立した
translation_failures行を削除します。 - 設定に存在しないロケールのキャッシュ行(
sourceLocale、ルートtargetLocales、およびブロックごとのdocs[]/json[]targetLocales)を破棄します。
廃止されたロケールに対してはキャッシュのみが対象となり、生成されたドキュメント、フラットUIファイル、およびstrings.jsonエントリはそのまま残されます(これらを削除するにはpurge-localeを使用します)。同期後、削除数(古いセグメント、孤立したfile_tracking、孤立した翻訳、孤立した失敗、未設定のロケール)と事前のMarkdown問題クリア数がログに記録されます。
主なオプション: --dry-run, --backup
--backup <path>は変更前にSQLiteバックアップをそのパスに書き出します(このフラグが設定されない限りバックアップは作成されません)。
clean-temp
概要: ai-i18n-tools clean-temp [-r | --root <path>] [-f | --force] [--dry-run]
設定はありません。ディレクトリツリー(デフォルト: cwd)を走査して*.log、*.tmp、cache.db.backup*.sqliteを探し、find -printのような./…パスを出力します。一致がある場合: -f / --force(プロンプトなしで削除)が指定されない限りDelete these files? (y/n)で確認を求めます。一致がない場合: プロンプトなしで終了します。--dry-run: リストのみ、プロンプトや削除は行いません(--forceより優先)。
主なオプション: -r / --root, -f / --force, --dry-run
purge-locale
概要: ai-i18n-tools purge-locale -l <code> [-l <code> …] [options]
指定されたロケールについて、translations、file_tracking、およびtranslation_failuresからキャッシュされたすべての行、ならびにそのロケール用に生成された以下のアーティファクトを削除します: 翻訳済みドキュメント (docs[]から解決された.md/.mdx/.astro出力。これには、ソースが削除された孤立した出力も含まれます (カスタムpathTemplateが構成されている場合を除き、各ブロックの出力ツリーをスキャンして見つけられたもの))、ロケールごとのフラットUIファイル (<flatOutputDir>/<locale>.json)、構成されている場合のそのロケールのGettext .po/.mo、そのロケールの.resxサテライト ({baseName}.{culture}.resx; ニュートラルな{baseName}.resxは残ります)、およびstrings.json内のそのロケールのエントリ。
ロケールは、繰り返し指定可能な -l / --locale で渡します (BCP-47 に正規化されます)。ロケールごとのカウント (キャッシュ行、ドキュメント、strings.json エントリ、フラットファイル) を出力し、パージ対象がないロケールについては警告を出力します (エラーにはなりません)。-y / --yes / -f / --force が指定されていない限り、確認プロンプトが表示されます。--dry-run: カウントと削除されるファイルを報告しますが、何も削除しません。--keep-files: 生成されたファイルと strings.json はそのまま残し、SQLite キャッシュのみをパージします。--backup <path> が渡されない限り、SQLite のバックアップは作成されません。このオプションを渡すと、削除前にそのパスへバックアップが書き込まれます。
主なオプション: -l / --locale, --dry-run, -y / --yes, -f / --force, --keep-files, --backup