Solução de problemas
Comece por:
lore hooks statusPara cada ferramenta, ele mostra se a ferramenta foi detectada, onde o hook do Lore está instalado (escopo de usuário, projeto ou gerenciado) e para qual org, a última entrega e a idade do contexto em cache. lore hooks status --json traz os mesmos dados em formato legível por máquina.
Campos do status
| Campo | Significado |
|---|---|
detected | A pasta de configuração da ferramenta existe na sua home |
| linhas de escopo | Cada lugar em que há um hook do Lore instalado, com org e modo |
here: org … | A org que uma sessão iniciada no diretório atual recebe, e de onde ela vem. As linhas seguintes indicam os hooks que ficam calados e um .lore.yaml ignorado (veja Quando há mais de um hook do Lore instalado) |
last delivery: fresh | A última sessão recebeu o contexto direto do Lore |
last delivery: cached | O Lore estava inacessível, e a sessão recebeu a cópia em cache |
last delivery: notice | A sessão recebeu um aviso de uma linha em vez do contexto (veja abaixo) |
cached context … old | Idade do contexto mais recente em cache para aquela org |
sign-in | valid, refreshable (vencida; a próxima sessão renova em segundo plano), expired (rode lore login) ou missing |
last refresh | A última renovação da sessão: refreshed, rejected (rode lore login), unavailable (o provedor de identidade estava inacessível) ou no-session |
O lore auth status mostra a validade da sessão e a última renovação, com a causa. O diagnóstico detalhado, inclusive de cada renovação em segundo plano, fica em ~/.config/lore/logs/hooks.log. O hook nunca joga erros na sua ferramenta de IA.
Avisos na sessão
| Aviso | Solução |
|---|---|
| not signed in | Rode lore login |
| your session expired | Rode lore login |
| refreshing your sign-in | Nada a fazer: a sessão está sendo renovada em segundo plano, e a próxima sessão recebe o contexto da org |
| …isn’t a member of the org | Confira a org em lore hooks status ou peça a um owner da org para adicionar você. O contexto em cache não é mostrado de propósito |
| there is no org … | A org do hook, ou do .lore.yaml do repositório, não existe. Corrija o nome ali, ou rode lore hooks pin --org=<org> |
| …named by this repository’s .lore.yaml | O repositório está vinculado a uma org da qual você não faz parte. Peça acesso ao owner dessa org. O Lore não entrega a sua outra org ali no lugar dela |
| no org configured for this hook | Reinstale com lore hooks install --org=<sua-org> |
| couldn’t reach the Registry and there is no recent cached context | Verifique a rede. O contexto volta na próxima sessão |
| …needs a Pro plan, which your org no longer has | Fale com um owner da org. Os hooks do modo org exigem Pro |
Problemas comuns
- Contexto da org errada, ou de duas orgs. Rode
lore hooks statusno repositório: as linhashere:mostram quais hooks respondem. Duas respostas indicam que o repositório tem um hook que o Lore não consegue confirmar se roda para você (Codex, Cursor); use o.lore.yamlno lugar, ou alinhe as orgs dos hooks. - Nem contexto nem aviso. Abra uma sessão nova, porque os hooks rodam no início da sessão. No Codex, confira se você aprovou o hook em
/hooks. No Cursor, tente uma segunda mensagem (veja o Modo individual). - O contexto chega duas vezes. Atualize o Lore CLI. As versões atuais entregam uma vez só, mesmo quando uma ferramenta roda os arquivos de hook de várias ferramentas.
- O
installpulou um arquivo. O arquivo existente não é um JSON válido (ou, no escopo gerenciado do Codex, já define[hooks]). O Lore nunca sobrescreve um arquivo que não consegue ler. Corrija o arquivo e rode o comando de novo. - A memória não aparece, mas as Rules sim. A memória da org exige o plano Pro. As Rules são entregues em todos os planos.