sb-internals-log-append

name	sb-internals/log-append
description	Append-only helper para OPERATIONS-LOG.md e arquivos de log similares. Uso primário: invocada por outras skills ao final de INGEST/LINT/AUTORESEARCH/SAVE/GAP-REVIEW.

sb-internals/log-append

Skill auxiliar. Garante append-only safety (DL-M2-07).

Contrato

• Input: path do target como argumento; entry markdown via stdin.
• Output: exit 0 em sucesso (conteúdo anterior preservado; entry no final); exit 1 + stderr em erro.
• Criação: se target não existe, cria com a entry como conteúdo inicial.

Uso

echo "
## 2026-04-21 LINT pontual
- arquivos verificados: 6
- violações encontradas: 0
" | bash skills/sb-internals/log-append/append.sh "$vault_root/OPERATIONS-LOG.md"

Garantias

• Append-only: nenhuma linha anterior é modificada (verificado em test_preserves_existing_content).
• Cria target se não existe (verificado em test_creates_file_if_missing).
• Idempotente no sentido de preservar conteúdo anterior byte-a-byte (test_idempotent_preserves_binary_identity).