consolidate-memory

/consolidate-memory — Manutenção do Vault de Memória

Objetivo: rotina de manutenção do vault persistente seguindo policies/memory-consolidation.md. Workflow seguro: snapshot → dry-run → confirmação → apply → verify → report.

Quando usar:

• semanalmente (rotina)
• após uso intenso (50+ sessions)
• antes de release major (limpar stale)
• vault crescer demais (> 500 arquivos)

Quando NÃO usar:

• vault recém-criado (< 20 arquivos)
• sem backup possível (não é repo git, não tem espaço para .bak)

Skill ativada: Context Manager (skill 08) em modo "vault janitor".

Pré-requisitos

• vault em D:\claude-memory\ ou path explícito via --vault <path>
• backup viável (espaço em disco para snapshot OU vault é repo git)

Processo

Passo 1 — Snapshot

VAULT="${1:-D:/claude-memory}"
TIMESTAMP=$(date +%Y-%m-%d-%H%M)

# Se é repo git: commit
if [ -d "$VAULT/.git" ]; then
  cd "$VAULT" && git add -A && git commit -m "snapshot pre-consolidate $TIMESTAMP"
else
  # Copy snapshot
  cp -r "$VAULT" "$VAULT.bak.$TIMESTAMP"
fi

Passo 2 — Dry run (auditoria sem mudança)

Para cada categoria de policies/memory-consolidation.md, listar candidatos:

2.1 Logs de sessão duplicados

• Buscar logs do mesmo dia/projeto: ls $VAULT/logs/YYYY-MM-DD-<projeto>-*.md
• Comparar similaridade (filename ou conteúdo > 80% similar) → marcar para merge
• Output: lista de pares [A.md, B.md] → keep A, delete B

2.2 Logs órfãos / antigos

• Logs > 90 dias sem ser referenciado em outro lugar → archive candidate
• Logs de projetos inexistentes → archive candidate

2.3 Architecture decisions

• Decisões com mesmo título em projetos iguais → merge candidate
• Decisões status: superseded sem newer ref → flag

2.4 Working set / context packs

• Files referenciados que não existem mais → remove entry
• Entries duplicadas (mesmo path) → merge metadata

2.5 Learned skills

• Score < 0.3 e idade > 30d → archive candidate
• Score ≥ 0.8 e 5+ usos → promote candidate
• Triggers conflitantes → resolve candidate