docs(skill): corte deve deixar folga na borda que encosta em fala mantida

Cortes escritos rente ao timestamp da palavra soavam secos (relatado no
projeto Mastopexia) — o critério e o prompt do modelo local mandavam cobrir
a frase inteira sem orientar a borda que toca fala mantida. Adiciona a regra
de recuar ~0,15-0,25s nas duas pontas quando o corte encosta em conteúdo
que fica, tanto no skill (06-texto-corte-marcador.md) quanto no prompt
embutido do Ollama (llm_local.py) — pra não precisar ajustar na mão de novo.

Também registra em 05_EXPERIENCIAS.md/09_MANUTENCAO.md a dívida de
resolve_actions não tolerar margem quando zoom/marker encosta na borda
de um corte (contornado manualmente, não corrigido em código ainda), e
atualiza a lista de dívidas abertas (etapa 6/offset de whisper já resolvidos
nesta sessão).

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-19 · 1.466 testes · lint zerado
+Última varredura: 2026-08-21 · 1.498 testes · lint zerado (fora de server.py/ai_edit.py/llm_local.py, pré-existentes)
 
 ---
 
@@ -33,40 +33,33 @@ vai para `fcpxml/`.
 
 Ordenado por quanto atrapalha, não por esforço.
 
-### 2.1 A etapa 6 ignora a revisão de ênfases
-O usuário lapida as frases na etapa 5, o `_phrase_review.json` é gravado — e a
-etapa 6 ainda processa como antes. Falta ligar: **zoom e legenda dinâmica só
-nas frases de ênfase, legenda comum no resto**. É a continuação natural do
-trabalho da etapa 5 e o item mais valioso da lista.
-→ `MacApp/Sources/WizardView.swift` (`finalizeProcessing`), `admin/api/subtitles.py`,
-`fcpxml/phrase_review.py` (`emphasis_spans` já é produzido e ninguém consome).
+### 2.1 `resolve_actions` não tolera margem no encosto de zoom/marker contra um corte
+Um `zoom`/`marker` cuja borda cai exatamente em cima do `start`/`end` de um
+`cut` é descartado como "apontando para material cortado" — mesmo quando a
+intenção era ficar bem ao lado. Contornado manualmente no projeto Mastopexia
+(recuando as bordas na mão); a correção estrutural é dar a `resolve_actions`
+uma margem de tolerância (meio frame) antes de considerar uma ação "dentro"
+do corte. → `fcpxml/voice_actions.py` (`resolve_actions`/`shift_after_cuts`),
+`05_EXPERIENCIAS.md` #27.
 
-### 2.2 Offset de ~400 ms no timing por palavra
-O faster-whisper sem alinhamento forçado erra o início de cada palavra em
-~0,4 s. Isso desloca zoom, corte e `gap_before` de uma vez. Há paliativo
-aplicado por projeto; a correção estrutural é ligar o **WhisperX** (ou
-alinhamento equivalente) em `transcribe.py`, o que levaria o erro para ~30 ms.
-Custo real: regerar todos os `_transcript.json` e `_voice_timeline.json`
-existentes. → `05_EXPERIENCIAS.md` #14, estado `parcialmente resolvido`.
-
-### 2.3 `MacApp/` não tem teste automatizado
+### 2.2 `MacApp/` não tem teste automatizado
 5.500 linhas de Swift sem uma asserção. A rede hoje é o harness manual (§4) e
 o olho do usuário. Não é para sair criando suíte de UI — mas lógica pura que
 foi parar na camada de tela (cálculo de trim, mapeamento de tempo) deveria
 descer para o Python, onde já existe rede.
 
-### 2.4 `admin/` fica fora do lint
+### 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.5 Confirmações visuais pendentes no FCP
+### 2.4 Confirmações visuais pendentes no FCP
 Várias entradas do `05_EXPERIENCIAS.md` estão marcadas como resolvidas *no XML*
 — testes verdes, DTD válido — mas **pendentes de importação real no Final Cut**.
 XML válido não é o mesmo que XML que renderiza como o esperado. Ao mexer em
 legenda, zoom ou keyframe, a confirmação final é abrir no FCP.
 
-### 2.6 Submódulo `WHISPERX` com conteúdo modificado e não commitado
+### 2.5 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.
 
@@ -98,7 +91,7 @@ quanto arquivo gigante.
 ## 4. Checklist antes de dar algo por pronto
 
 ```bash
-cd code && ./Engine/run_after_fix.sh        # lint zerado + 1.466 testes
+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)
 ```
 
@@ -125,7 +118,7 @@ E, além do script:
 | FCP recusa o arquivo ao importar | `id` inválido, ordem de filhos, timebase | `writer/validation.py`, `dtd.py` |
 | Título importa mas não aparece | Template/uid Motion que não resolve | `writer/titles.py` |
 | Corte no lugar errado | Tempo pós-corte usado como se fosse original | `voice_actions.py` (`shift_after_cuts`) |
-| Zoom no lugar errado | Idem, ou offset de timing do Whisper | §2.2 |
+| Zoom/marker sumindo perto de um corte | Borda encostando exatamente no `cut` | §2.1 |
 | Legenda sobrepondo | Layout ou conteúdo antigo no arquivo | `collision.py`, `text_layout.py` |
 | "Ênfase" apontando para palavra à toa | Falta renormalizar após o corte | `refine_voice_timeline` |
 | App diz que falta librosa/pyannote | `uv run` com cwd errado | `PythonBridge.swift` (§3 do doc 08) |