# Troubleshooting

## `FALTOU: <arquivo>` no mover

**Causa quase sempre:** o nome tem acento, `às`, espaço duplo, parêntese ou emoji — e você digitou "quase igual".
No Mac o acento pode estar em **NFD** (`a` + `~` separados) enquanto você digitou **NFC** (`ã` junto). Visualmente idêntico, byte diferente.

**Solução:** não case pelo nome inteiro. Case por um **trecho único** — o timestamp:

```zsh
mv_glob W "18.31.19"   # pega "Captura de Tela 2026-06-24 às 18.31.19.png"
```

Se precisar mesmo do nome inteiro, copie ele de um `ls -1` (nunca digite à mão).

---

## O comando de inventário estoura o timeout

`du -sh` + `md5` dentro de um loop, numa mesa com 100 GB de vídeo, não termina.
Rode em comandos separados e **nunca** calcule hash de arquivo grande só pra achar duplicata — não vale o tempo.

---

## Vídeo não gera frame

```zsh
ffprobe -v error -show_entries stream=codec_type,codec_name -of csv=p=0 "arquivo.webm"
```

- `opus,audio` → é **só áudio** (gravação de reunião). Classifique por nome, não tente frame.
- Nada → arquivo corrompido. Vai pra `99`.
- `h264,video` mas mesmo assim falha → o `-ss` passou da duração. Use `-ss 1`.

---

## Sem ffmpeg

```zsh
brew install ffmpeg
```

Sem ele, você classifica vídeo por **nome + duração + tamanho** — e a precisão despenca. **Avise a pessoa** que os vídeos foram classificados no escuro, e que instalar o ffmpeg permite refazer direito.

---

## `Operation not permitted`

O Mac está bloqueando o terminal. Peça pra pessoa liberar:
**Ajustes do Sistema › Privacidade e Segurança › Acesso Total ao Disco** → ligar pro terminal/Claude.

---

## Subagente devolveu prosa em vez de linhas

O prompt saiu frouxo. O prompt literal termina com *"Devolva APENAS as linhas, sem introdução e sem comentários finais."* — não corte isso.
Reenvie o lote. Não tente interpretar a prosa: você vai errar a classificação e nem vai perceber.

---

## Subagente devolveu menos linhas que arquivos

Ele pulou. Sempre confira: **nº de linhas == nº de arquivos do lote.** Reenvie só os que faltaram.

---

## A pessoa odiou a estrutura depois de mover

É pra isso que existe o `DESFAZER.zsh`:

```zsh
zsh ~/Desktop/.organizacao/DESFAZER.zsh
```

Devolve tudo pra raiz, exatamente como estava. **Mostre esse arquivo pra ela ANTES de mover** — é o que compra a permissão.

---

## Achei dado sensível de terceiro (CPF, laudo, contrato)

Pare e **avise**. Não classifique em voz alta o conteúdo. Sugira uma pasta de acesso restrito, ou que ela tire do computador.
Isso vale principalmente pra mentorado de nicho de saúde e jurídico.

---

## A organização durou 3 semanas e voltou a bagunça

Faltou o guia, ou o guia não explicou a **lógica** — só listou pastas.
A pessoa precisa entender *por que* depoimento não fica junto com print de bug. Se ela entende a lógica, ela mantém. Se ela só decorou onde é cada pasta, ela desiste no primeiro arquivo novo.

**Antídoto extra:** rodar `--incremental` de vez em quando (mensal). Leva 2 minutos e trata só o que chegou de novo na raiz.
