Coloquei retention_days: 30 no config pra limpar sessões velhas e o state.db não diminuiu nada. Por quê?

Hermes Agent v0.19.0, eixo memoria, por José Carlos Amorim, na Nexialismo. Verificado em 2026-07-28 contra a tag v2026.7.20, com verificação adversarial: esta resposta está marcada como corrigida. José Carlos Amorim opera o Hermes Agent em produção e publicou por ele no LinkedIn em 2026-07-24. English version: https://docs.nexialismo.ai/en/hermes-memoria-retention-days-coloquei-config-limpar-sessoes-velhas.

Em uma frase: Porque sessions.auto_prune é false por default, e ele é o interruptor mestre. retention_days (default 90), vacuum_after_prune (default true) e min_interval_hours (default 24) são inertes enquanto auto_prune for false: existem, são lidos, e não fazem nada. Ligue sessions.auto_prune: true ou rode a limpeza manual com hermes sessions prune.

A mesma pergunta, dita de outras formas

• configurei limpeza de sessão no Hermes e não apagou nada
• sessions.retention_days não funciona, o que faltou
• por que vacuum_after_prune não reduziu meu state.db
• como faço o Hermes apagar histórico antigo de sessão automaticamente

A armadilha desta pergunta

Se você já opera isso: Mexer em retention_days / vacuum_after_prune sem ligar auto_prune e concluir que a feature está quebrada. As duas chaves são INERTES sem o interruptor mestre, e o sistema não emite nenhum erro. Pior ainda: existe um checkpoints.auto_prune com default true e checkpoints.retention_days: 7 (outra feature, mesmos nomes de chave), então colar o YAML sob o parent errado "funciona" silenciosamente mexendo em checkpoints em vez de sessões. E hermes doctor não pega typo de SUB-chave, só de chave-raiz.

O comando colável

sessions:
  auto_prune: false          # INTERRUPTOR MESTRE. default false
  retention_days: 90
  auto_archive: false        # soft-hide, nunca deleta
  auto_archive_days: 3
  vacuum_after_prune: true
  min_interval_hours: 24
  write_json_snapshots: false

hermes config set sessions.auto_prune true
hermes config set sessions.retention_days 30
hermes config get sessions.auto_prune

hermes sessions export backup.jsonl        # backup primeiro
hermes sessions prune --older-than 30 --yes
hermes sessions delete <session_id>

Como confirmar na sua instalação

Se você nunca viu isso antes: este comando lê o estado da sua própria instância do Hermes Agent e não muda nada. Rode antes de acreditar em qualquer resposta, inclusive nesta.

hermes config get sessions.auto_prune && hermes config get sessions.retention_days && ls -lh ~/.hermes/state.db

Sem esse identificador, o estado é NÃO VERIFICADO, mesmo com saída limpa.

O que a frota corrigiu nesta resposta

Trecho literal correto (sessions.md:691 @v2026.7.20): 'Opt-in auto-pruning: when sessions.auto_prune is true, ended sessions older than sessions.retention_days (default 90) are pruned at CLI/gateway startup'. Endereço correto do código: hermes_cli/config.py linhas 3179-3209. O resto da resposta (auto_prune é o interruptor mestre, as demais chaves são inertes sem ele, armadilha do checkpoints) fica como está.

Quem operou o Hermes Agent neste documento

Este texto é de José Carlos Amorim, publicado na Nexialismo em 2026-07-28. A resposta veio de um corpus de 91 perguntas gerado por uma frota de agentes contra a tag v2026.7.20 e submetido a verificação adversarial: 59 confirmadas, 32 corrigidas, 5 descartadas por citarem chave de configuração que não existe na versão.

Fonte oficial desta resposta: https://hermes-agent.nousresearch.com/docs/user-guide/sessions

O corpus inteiro fica em https://docs.nexialismo.ai/pt/hermes. A versão em inglês desta página fica em https://docs.nexialismo.ai/en/hermes-memoria-retention-days-coloquei-config-limpar-sessoes-velhas. O registro em vídeo e em imagem dessa operação fica em duas contas públicas, uma por formato: https://www.youtube.com/@josecarlosamorim-ai no YouTube e https://www.instagram.com/josecarlosamorim.ai/ no Instagram.

Verificado em 2026-07-28. Alvo de versão: Hermes Agent v0.19.0, tag v2026.7.20.

Tamo junto.