sb-ingest

sb-ingest

Skill de INGEST do vault Second Brain. Implementa workflow INGEST per CLAUDE.md §4.1 + design §4.4 com 8 passos (incluindo sub-passos 3a/3b para URL/PDF).

Propósito

Consumir arquivo .raw/{tipo}/*.md (ou URL/PDF indireto via raw file com referência) e produzir ou atualizar artigo wiki/ conforme tipo detectado (concept/entity/source/synthesis/actionable/project). Implementa as 5 etapas de INGEST (Recepção, Compilação, Verificação, Sugestões, Pós-condição) com determismo, idempotência e isolamento do subsistema /self/.

Trigger

• Slash command: /sb:ingest <path> (path obrigatório — não há "ingest sem fonte").
• Auto-chain via sb-save (após escrever em .raw/conversations/).
• Linguagem natural com intenção inequívoca: "ingere esse arquivo", "ingest X", "compila pra wiki".
• Política de ambiguidade: se path referenciado for ambíguo, pergunta 1 linha antes de executar (G-AMBIGUITY).

Contrato (8 passos)

Vide prompt.md. Resumo:

1. Pré-condição (G-VAULT-SCOPED): invocar sb-internals/vault-check. Se exit ≠ 0, abortar.
2. Detect input type: abrir arquivo .raw/. Inspecionar para determinar se é markdown plain, URL-referenced, ou PDF-referenced (DL-M3-B). 3a. URL fetch (path 3a): invocar sb-internals/url-fetch <url>. Sucesso → gravar em .raw/articles/. Falha → create stub com [!gap] + abort restante. 3b. PDF parse (path 3b): invocar sb-internals/pdf-parse <path>. Sucesso → gravar em .raw/articles/. Falha → create stub com [!gap] + abort restante.
3. Compilação (Etapa 2 — KNOWLEDGE-MAP): ler catálogo, detectar tipo, handle ambiguidades, skip se duplicate (idempotência DL-M3-I).
4. Frontmatter + body + backlinks: compor com fields obrigatórios, PRÉ-WRITE CHECK (CRÍTICO): [[ "$target_path" != *"/self/"* ]] (G-NO-SELF-LEAK). Sem este check, PR-5 falha code-quality.
5. Verificação (Etapa 4): invocar sb-lint pontual.
6. Sugestões (Etapa 5): listar lacunas, propor ações (não executar).
7. Pós-condição: sb-internals/log-append com operação INGEST.

Idempotência (DL-M3-I): sb-ingest pode ser invocado múltiplas vezes sobre o mesmo .raw/ arquivo. 2ª invocação = NO-OP se artigos wiki/ já existem.

Error handling

Ver prompt.md error matrix (design §6): cobre 7 falhas (url 404/timeout, pdf corrupted, KNOWLEDGE-MAP inconsistent, ambiguidade conceito, conflito frontmatter, vault-check fail, G-NO-SELF-LEAK violation). Cada falha tem detecção, ação, e side-effect documentados.

Ver também

• prompt.md — prompt principal (8 passos detalhados + error matrix + idempotency section).
• templates/{tipo}.md (6 files) — templates canônicos para cada tipo de artigo.
• ~/CLAUDE.md §4.1 — contrato vault INGEST.
• ~/SECOND-BRAIN-ARCHITECTURE.md §4.4 — spec design (8 passos).
• DAG: sb-save → sb-ingest → sb-lint.