sb-internals-vault-check

name	sb-internals/vault-check
description	Detecta se o cwd (ou ancestral) é um vault Second Brain válido. Uso primário: invocada por outras skills (sb-lint, sb-ingest, etc) como pré-condição de ativação (G-VAULT-SCOPED).

sb-internals/vault-check

Skill auxiliar. Valida se a sessão está rodando dentro de um vault Second Brain.

Contrato

• Input: cwd atual.
• Output: stdout com path absoluto do vault root; exit 0 em caso de sucesso.
• Falha: exit 1 + mensagem em stderr detalhando markers faltantes.

Resolução (ordem de prioridade, DL-M2-10)

1. ENV var SECOND_BRAIN_VAULT_PATH.
2. Config file ~/.claude/plugins/second-brain/config.json campo vault_path.
3. Walk-up do cwd (máximo 20 níveis, DL-M2-09) até encontrar os 3 markers.

Markers obrigatórios

• CLAUDE.md
• SECOND-BRAIN-ARCHITECTURE.md
• OPERATIONS-STATE.md com frontmatter claude_md_title: Second Brain

Uso

vault_root=$(bash skills/sb-internals/vault-check/check.sh) || {
  echo "Not in a Second Brain vault; aborting." >&2
  exit 1
}
cd "$vault_root"
# ... continuar operação ...

Testes

tests/test_vault_check.py cobre:

• walk-up a partir do próprio vault root
• walk-up a partir de subdir aninhado
• abort quando markers ausentes
• ENV var sobrescreve walk-up
• marker parcial (1 de 3) aborta