CLI — Manutenção de cache
cleanup
Sinopse: ai-i18n-tools cleanup [--dry-run] [--backup <path>]
Limpa a tabela markdown_source_issues inteira, então executa sync --force-update (extração, UI, SVG, documentos e translate-json quando ativado) para que os problemas de markdown sejam repopulados para os documentos atualmente configurados. Em seguida:
- remove linhas de segmento obsoletas (
last_hit_atnulo / caminho de arquivo vazio); - descarta linhas
file_trackingcujo caminho de origem resolvido está faltando no disco; - remove linhas de tradução cujos metadados
filepathapontam para um arquivo ausente; - poda linhas
translation_failuresórfãs; - descarta linhas de cache para localidades ausentes da configuração (
sourceLocale, raiztargetLocalese qualquerdocs[]/json[]targetLocalespor bloco).
Somente cache para localidades desativadas — documentos gerados, arquivos de UI planos e entradas strings.json são deixados intactos (use purge-locale para remover esses). Registra contagens de poda após a sincronização (segmentos obsoletos, file_tracking órfãos, traduções órfãs, falhas órfãs, localidades não configuradas) mais a contagem de limpeza inicial de problemas de markdown.
Opções principais: --dry-run, --backup
--backup <path> grava um backup SQLite nesse caminho antes das modificações (nenhum backup, a menos que este sinalizador esteja definido).
clean-temp
Sinopse: ai-i18n-tools clean-temp [-r | --root <path>] [-f | --force] [--dry-run]
Nenhuma configuração. Percorre uma árvore de diretórios (padrão: diretório de trabalho atual) para *.log, *.tmp e cache.db.backup*.sqlite, imprime caminhos ./… como find -print. Com correspondências: solicita Delete these files? (y/n), a menos que -f / --force (excluir sem prompt). Sem correspondências: sai sem solicitar. --dry-run: apenas lista, sem prompt ou exclusões (substitui --force).
Opções principais: -r / --root, -f / --force, --dry-run
purge-locale
Sinopse: ai-i18n-tools purge-locale -l <code> [-l <code> …] [options]
Excluir todas as linhas em cache para o(s) local(is) fornecido(s) de translations, file_tracking e translation_failures, e os artefatos gerados para esse local: documentos traduzidos (saídas .md / .mdx / .astro resolvidas de docs[], incluindo saídas órfãs cuja origem foi removida — encontradas ao varrer a árvore de saída de cada bloco, exceto quando um pathTemplate personalizado é configurado), o arquivo de UI plano por local (<flatOutputDir>/<locale>.json), o .po / .mo Gettext do local quando configurado, o satélite .resx do local ({baseName}.{culture}.resx; o {baseName}.resx neutro permanece), e as entradas do local em strings.json.
Localidades são passadas via -l / --locale repetível (normalizado para BCP-47). Imprime contagens por localidade (linhas de cache, documentos, entradas strings.json, arquivo plano); avisa (não gera erro) para localidades sem nada para purgar. Solicita confirmação, a menos que -y / --yes / -f / --force. --dry-run: relata contagens e os arquivos que seriam removidos, não exclui nada. --keep-files: purga apenas o cache SQLite, deixando arquivos gerados e strings.json intocados. Nenhum backup SQLite é feito, a menos que --backup <path> seja passado, o que escreve um backup para esse caminho antes da exclusão.
Opções principais: -l / --locale, --dry-run, -y / --yes, -f / --force, --keep-files, --backup