| name | sb-ingest |
| description | Ingere fonte bruta (URL, PDF, markdown em .raw/) no Second Brain. Use quando o usuário envia link/arquivo para salvar no vault, cola texto para preservar, ou diz 'ingere isso', 'salva pro meu second brain', 'adiciona ao vault'. NÃO use para responder perguntas (use sb-query) ou para salvar conversa atual (use sb-save). Idempotente: re-invocação sobre mesmo .raw/ arquivo produz NO-OP. |
| version | 0.3.0-alpha |
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:
- Pré-condição (G-VAULT-SCOPED): invocar
sb-internals/vault-check. Se exit ≠ 0, abortar.
- 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.
- Compilação (Etapa 2 — KNOWLEDGE-MAP): ler catálogo, detectar tipo, handle ambiguidades, skip se duplicate (idempotência DL-M3-I).
- 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.
- Verificação (Etapa 4): invocar
sb-lint pontual.
- Sugestões (Etapa 5): listar lacunas, propor ações (não executar).
- 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.
