operacao-scripts

Scripts Operacionais

operacao scripts

Scripts Python para manutenção e validação do vault.

---

Scripts disponíveis

Script	Uso	O que faz
vault-lint.py	python3 99-operacao/scripts/vault-lint.py	Verifica convenção de nomes em todo o vault (MEMORY-CONTRACT §4.1)

---

vault-lint.py

Verifica:

• Ausência de acentos em nomes de arquivo
• Ausência de espaços
• Minúsculas
• Formato YYYY-MM-DD_descricao-curta ou kebab-case (com sufixos semânticos opcionais via _)

Exceções permitidas: top-level em maiúscula (HOME.md, HOME-board.md, HOME-cliente.md, README.md, TASKS.md, MEETINGS.md, DEFINICOES.md, STYLE-GUIDE.md, MEMORY-CONTRACT.md, AXIOS-HANDOFF.md), folder notes (<nome-da-pasta>.md, ex: 02-costal.md, canonico.md) e templates (_template.md, _templates/*.md).

Extensões verificadas: .md, .pdf, .docx, .xmind, .png, .jpg, .xlsx, .pptx.

Uso

# Lint completo
python3 99-operacao/scripts/vault-lint.py
 
# Escopo reduzido
python3 99-operacao/scripts/vault-lint.py --path 01-colliers
 
# Sugestões de rename (dry-run)
python3 99-operacao/scripts/vault-lint.py --fix-dry

Retorna exit code 0 se limpo, 1 se há violações.

Quando rodar

• Antes de commit material no vault
• Semanalmente (checklist de governança do Axios)
• Após ingestão de lote novo de PDFs/documentos

---

Ver também

• 99-operacao
• MEMORY-CONTRACT §4.1 — convenção de nomes
• document-audit