> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fau.fpt.icu/llms.txt
> Use this file to discover all available pages before exploring further.

# Ferramenta de Diagnóstico (doctor)

> Execute verificações de saúde para diagnosticar problemas de configuração e ferramentas.

<Tip>
  Execute `doctor` primeiro sempre que você encontrar comportamento inesperado. Ele expõe rapidamente diretórios ausentes, receitas que não podem ser analisadas, um lockfile obsoleto e ferramentas ausentes antes de você se aprofundar.
</Tip>

O comando `doctor` inspeciona sua configuração local e reporta o status de cada verificação:

```bash theme={null}
fp-appimage-updater doctor
```

## Verificações executadas

| Verificação           | O que ela verifica                                               |
| --------------------- | ---------------------------------------------------------------- |
| `config_dir`          | O diretório de configuração existe                               |
| `apps_dir`            | O subdiretório de apps existe                                    |
| `global_config`       | O arquivo global `config.yml` está presente e pode ser analisado |
| `state_dir`           | O diretório de estado está acessível                             |
| `parsed_app_recipes`  | Número de arquivos de receita que carregaram com sucesso         |
| `invalid_app_recipes` | Número de arquivos de receita que falharam ao ser analisados     |
| `process_lock`        | Se o lockfile atual está ausente, ativo ou obsoleto              |
| `github_api`          | Conectividade da API do GitHub e validade do token               |

Cada verificação reporta `ok` ou `warn`. Um resultado `warn` não impede a ferramenta de rodar, mas pode explicar um comportamento inesperado.

`process_lock` reporta `warn` quando o lockfile parece obsoleto ou malformado. Isso geralmente significa que uma execução anterior terminou inesperadamente, e a próxima execução pode limpá-lo.

O `doctor` verifica arquivos locais, ferramentas locais e realiza uma requisição leve à API do GitHub para verificar seu limite de taxa e o status do token.

<Note>
  Adicione `--json` para obter saída legível por máquina adequada para scripts ou monitoramento:

  ```bash theme={null}
  fp-appimage-updater doctor --json
  ```
</Note>

## Problemas comuns

**Os arquivos de receita falharam ao ser analisados**

Execute `validate` para identificar quais arquivos têm erros e qual é o erro de análise:

```bash theme={null}
fp-appimage-updater validate
```

Para verificar uma única receita por nome:

```bash theme={null}
fp-appimage-updater validate <app-name>
```

***

**Diretório de configuração não encontrado**

Inicialize o diretório de configuração com:

```bash theme={null}
fp-appimage-updater init --global
```

Isso cria a estrutura de diretórios esperada e um `config.yml` inicial.