audit-flush
Contraparte manual do hook Stop. Mesma lógica, invocada sob demanda.
Quando usar
- O usuário pede para inspecionar entradas de trilha em estágio antes do auto-flush.
- O usuário deseja reenviar entradas que foram movidas para
$CCAUDIT_PENDING_DIRapós uma falha anterior (acerto de segredo ou erro de push). - O auto-flush está desabilitado (
CCAUDIT_MANUAL=1) e as entradas precisam ser enviadas explicitamente. - O usuário precisa de um registro escrito de que "<usuário> inspecionou e aprovou este envio no momento X" — executar
/audit-flushdeixa um rastro (o autor do commit e o timestamp) que um hook Stop desacompanhado não consegue.
Flags
| Flag | Comportamento |
|---|---|
| (nenhuma) | Mesmo fluxo que hooks/auto-flush.sh: escanear, verificar segredos, enviar, limpar estágio. |
--dry-run | Listar o que seria enviado, sair sem tocar em nada. |
--force | Incluir o conteúdo de $CCAUDIT_PENDING_DIR além do estágio; tentar novamente tudo. |
Procedimento
Siga skills/audit-flush/procedure.md passo a passo. Não invente verificações de segurança adicionais — o hook e esta skill devem permanecer com comportamento idêntico, pois divergência cria estado indefinido.
O que esta skill NÃO faz
- Ela não modifica entradas de trilha. As entradas são apenas de acréscimo uma vez escritas no estágio.
- Ela não exclui do repositório remoto de trilha. Se uma entrada ruim foi enviada, a correção é uma nova entrada referenciando a ruim por hash — nunca uma reescrita.
- Ela não reconfigura o remoto.
CCAUDIT_TRAIL_REPOé somente leitura da perspectiva desta skill.