chore(fase0): higiene do repositório + corrige gitignore que escondia fcpxml/models/

Fase 0 do roteiro de reestruturação (Engine/docs/10_MAPA_REESTRUTURACAO.md):
move code/WHISPERX (2,6 GB de backups órfãos, sem uso ativo, sem
.gitmodules) para ~/Archives/G-ART-WHISPERX-backup fora do workspace git;
traz admin/ para o gate de lint de run_after_fix.sh; corrige
fcpxml/writer/adjustment.py, que gerava um wrapper <adjustment> inexistente
no DTD 1.13 (filtros agora vão direto no <clip>, na ordem exigida), com
teste de regressão novo.

Achado à parte: .gitignore tinha uma regra solta "models/" (pensada só
para o cache do Whisper em code/models/) que também escondia do git todo o
pacote fcpxml/models/ — nunca commitado, sem proteção nenhuma. Corrigida
para /code/models/, ancorada na raiz.

Docs atualizados no mesmo commit (02_MODULES, 09_MANUTENCAO,
10_MAPA_REESTRUTURACAO, 05_EXPERIENCIAS #34 e #36), conforme a regra do
CLAUDE.md.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

code/Engine/docs/09_MANUTENCAO.md

@@ -7,7 +7,7 @@ Este é o documento de rota. Os outros descrevem o que **é**; este diz o que
 **fazer** e por onde começar quando chega uma implementação, uma melhoria ou
 uma correção.
 
-Última varredura: 2026-08-21 · 1.498 testes · lint zerado (fora de server.py/ai_edit.py/llm_local.py, pré-existentes)
+Última varredura: 2026-09-22 · 1.543 testes passando (+1 falha pré-existente em `test_forced_align.py` e +1 erro pré-existente em `test_refine_voice_timeline_tool.py`, ver §2.6) · lint zerado em `code/` e em `admin/` (fora de server.py/ai_edit.py/fcpxml/analise.py, pré-existentes — outro trabalho em andamento na branch)
 
 ---
 
@@ -48,10 +48,12 @@ o olho do usuário. Não é para sair criando suíte de UI — mas lógica pura
 foi parar na camada de tela (cálculo de trim, mapeamento de tempo) deveria
 descer para o Python, onde já existe rede.
 
-### 2.3 `admin/` fica fora do lint
-`run_after_fix.sh` roda o ruff de dentro de `code/`, então `admin/` — 1.751
-linhas de código que o app depende para funcionar — nunca é verificado.
-Incluir mexe no gate, então é decisão consciente, não esquecimento.
+### 2.3 ~~`admin/` fica fora do lint~~ — resolvido em 2026-09-22
+`run_after_fix.sh` agora roda um segundo passo (`ruff check --config
+pyproject.toml ../admin/`) com a mesma config do engine. Precisou de
+`# noqa: E402` em 6 imports de `admin/models_api.py`/`admin/models_gui.py`
+(padrão `sys.path.insert` antes do import local, convenção já usada no
+projeto). Lint de `admin/` está zerado.
 
 ### 2.4 Confirmações visuais pendentes no FCP
 Várias entradas do `05_EXPERIENCIAS.md` estão marcadas como resolvidas *no XML*
@@ -68,9 +70,39 @@ causa raiz. Não investigado a fundo ainda.
 → `fcpxml/writer/cut.py` (`cut_clip_ranges`, `min_keep_seconds`), padding do
 `remove_media_silence`.
 
-### 2.6 Submódulo `WHISPERX` com conteúdo modificado e não commitado
-Está fora dos commits de propósito, porque ninguém verificou o que mudou lá
-dentro. Precisa ser olhado e resolvido — ou commitado, ou revertido.
+### 2.6 ~~`fcpxml/writer/adjustment.py` gerava um wrapper `<adjustment>` inválido~~ — resolvido em 2026-09-22
+`ClipDeAjuste` embrulhava filtros num `<clip><adjustment>...</adjustment></clip>`,
+que não existe no DTD real da Apple. Corrigido para anexar
+`filter-video`/`filter-audio` direto como filhos do `<clip>` (na ordem que o
+DTD exige: vídeo antes de áudio). Teste de regressão em
+`tests/test_writer_adjustment.py`. Segue sem uso em `server_tools`/`admin/api`
+— só deixou de estar pronto pra alguém reusar do jeito errado.
+→ `05_EXPERIENCIAS.md` #34.
+
+### 2.7 `test_refine_voice_timeline_tool.py` quebrado: `voice_timeline.extract_pitch` ausente
+`TestRefineVoiceTimelineHandler::test_max_zooms_caps_the_list` tenta
+`monkeypatch.setattr(vt, "extract_pitch", ...)` mas `fcpxml/voice_timeline.py`
+não tem mais (ou nunca teve, nesta branch) essa função. Pertence ao trabalho
+de análise de voz já em andamento nesta branch (`voice_timeline.py`
+modificado, não commitado) — não investigado a fundo, só registrado aqui
+para não se perder.
+→ `fcpxml/voice_timeline.py`, `tests/test_refine_voice_timeline_tool.py`.
+
+### 2.8 ~~Submódulo `WHISPERX` com conteúdo modificado e não commitado~~ — resolvido em 2026-09-22
+Não era um submódulo git registrado (sem `.gitmodules`) — era uma pasta
+`.git` solta de 2,6 GB dentro de `code/`, com cópias/backups congelados do
+próprio projeto (`WHISPERX_backup_88476/`, uma cópia inteira e antiga de
+`fcp-mcp-server-main`). Só 3 referências no código ativo, todas em
+comentários (`fcpxml/diarize.py`, `tests/test_diarize.py`,
+`admin/api/shared.py`), nenhum import ou caminho dependia dela. Além do
+peso morto, ela também inflava qualquer lint rodado com `--exclude`
+explícito (que sobrescreve o `exclude` do `pyproject.toml`) — foi assim que
+um `ruff check . --exclude docs/` chegou a acusar 510 erros, quase todos
+dentro dela. Movida para `~/Archives/G-ART-WHISPERX-backup` (fora do
+workspace git), copiada e verificada (`diff -rq`) antes de remover o
+original. `WHISPERX/` também saiu do `exclude` do ruff em
+`code/pyproject.toml` — não faz mais sentido excluir um caminho que não
+existe mais dentro de `code/`.
 
 ---
 
@@ -102,6 +134,8 @@ quanto arquivo gigante.
 ```bash
 cd code && ./Engine/run_after_fix.sh        # lint zerado + 1.498 testes
 admin/run_app.command                       # se mexeu no app (padrão de revisão)
+admin/run.command                            # app + atualização incremental da RAG
+rag/search_gart.sh "consulta"                # busca híbrida no índice RAG (ver rag/README.md)
 ```
 
 E, além do script: