mednotes-opencode 0.1.0

package/.opencode/mednotes/docs/public-vocabulary.md

@@ -0,0 +1,104 @@
+# Dicionário Público (Internal → User)
+
+Tradução canônica para resposta visível em workflow público. "Não dizer" é
+proibido por padrão; "Dizer" é a forma humana. Termos internos só aparecem
+em `<details>` técnicos quando o usuário pediu, em `/mednotes:status`, em
+debug explícito, ou na seção `Detalhes técnicos` ao final do relatório.
+
+Workflows que exigem UX "just works" (esconder internals por padrão):
+`/mednotes:create`, `/mednotes:enrich`, `/mednotes:fix-wiki`,
+`/mednotes:link`, `/mednotes:link-body`, `/mednotes:link-related`,
+`/mednotes:process-chats`, `/mednotes:pdf-library`, `/flashcards`.
+
+Workflows mistos (mais técnico no default): `/mednotes:setup`,
+`/mednotes:status`, `/mednotes:history`, `/mednotes:telemetry`, `/report`.
+
+## Execução E Ambiente
+
+| Interno | Não dizer | Dizer |
+|---|---|---|
+| `uv run python ...` / `uv` | "rodei `uv`", "vou rodar `uv run`" | "preparei o ambiente e rodei", "executei" |
+| `--dry-run`, dry-run | "rodei `--dry-run`", "dry-run limpo" | "fiz uma prévia", "nada foi alterado ainda" |
+| `--apply`, apply | "vou rodar apply" | "vou aplicar" / "aplico se você confirmar" |
+| receipt / recibo (técnico) | "gerei recibo `<path>.json`" | "registrei o que foi feito" / "guardei ponto de restauração" |
+| manifest / batch | "manifest do batch" | "lote" só se precisar contar; preferir "essas 4 notas" |
+| hash / sha256 / `content_hash` | "hash bate", "sha256=…" | omitir; ou "identifiquei a versão da nota" |
+| schema / schema drift / plan v4/v5 | "schema drift", "plano v5" | "o formato esperado mudou; vou recalcular" |
+| `Exit Code:` | "Exit Code 1" | "o comando falhou: <causa curta>" |
+| `tool status=success` | "tool status success" | omitir; falar do resultado |
+| `agent_metrics` / `turns_used` / `max_turns` | "12 turns used" | omitir; em bloqueio: "o agente esgotou tentativas; precisa de revisão" |
+
+## Estado E Decisão
+
+| Interno | Não dizer | Dizer |
+|---|---|---|
+| `next_action` / `next_command` | "next_action", "next_command" | "próxima ação" |
+| `human_decision_required` | "human decision required" | "preciso de uma decisão sua" |
+| `human_decision_packet` | "packet", "opções do packet" | "opções para você escolher" |
+| `blocked_reason` / `status=blocked` | "status=blocked", "blocked_reason=…" | "bloqueio: <causa em pt-BR>" |
+| `preview_ready` / `ready_to_publish` | "preview_ready", "ready_to_publish" | "prévia pronta", "pronto para publicar" |
+| `phase` (ex. `architect`, `triage`) | "fase architect" | "etapa atual: arquitetura/triagem" |
+| `contract_gap` / `error_context` | "contract_gap.missing_next_action" | "o sistema não me deu próxima ação clara; preciso de orientação sua" |
+
+## Armazenamento
+
+| Interno | Não dizer | Dizer |
+|---|---|---|
+| SQLite / vocabulary DB / DB | "SQLite", "DB de vocabulário" | "índice de vocabulário" |
+| `vocabulary_bootstrap` / `bootstrap_required` | "bootstrap_required" | "o índice de vocabulário precisa ser construído" |
+| `link-trigger-context.v1` | "link trigger context" | omitir; o linker é dito como "reparei as conexões entre notas" |
+| `images_*` frontmatter | "frontmatter `images_*`" | "imagens da nota" |
+
+## Versionamento E Vault
+
+| Interno | Não dizer | Dizer |
+|---|---|---|
+| restore point / `restore_point_id` / commit | "commit", "branch", "SHA `<abc>`" | "ponto de restauração" |
+| Git / push / `sync_status` | "git push", "sync_status=skipped" | "backup online" / "backup online pendente" |
+| `run-start` / `run-finish` / vault guard | "rodei `run-start`" | omitir; protegido por "ponto de restauração" |
+
+## Bypass Técnico (Nunca Em UX Pública)
+
+| Interno | Não dizer | Dizer |
+|---|---|---|
+| `MEDNOTES_ALLOW_DEV_ESCAPE` | nunca em UX pública | nunca em UX pública |
+| `--skip-prompt-eval` | nunca em UX pública | nunca em UX pública |
+| `--force-diagnose` | nunca em UX pública | nunca em UX pública |
+
+## Eval E Avaliação
+
+| Interno | Não dizer | Dizer |
+|---|---|---|
+| `eval-curator-batch` / evaluator | "evaluator devolveu needs_review" | "a verificação automática marcou itens para revisão" |
+| `needs_review` | "needs_review" | "preciso revisar antes de aplicar" |
+| `prompt-eval` / curator-prompt-eval.json | "curator-prompt-eval" | omitir; preferir "verificação do plano" |
+
+## Agentes E Subagentes
+
+| Interno | Não dizer | Dizer |
+|---|---|---|
+| `med-link-graph-curator` | nome do agente | "etapa de curadoria de vocabulário" |
+| `med-knowledge-architect` | nome do agente | "etapa de reescrita" |
+| `med-chat-triager` | nome do agente | "etapa de triagem do chat" |
+| `med-publish-guard` | nome do agente | "verificação antes de publicar" |
+| `med-flashcard-maker` | nome do agente | "etapa de geração de cards" |
+| `@generalist` / subagent genérico | mencionar | nunca (rota oficial não usa) |
+
+## Quando Internals Podem Aparecer
+
+- Sempre em `<details>` recolhido com cabeçalho "Detalhes técnicos" (camada
+  visível padrão continua humana).
+- Em `/mednotes:status`, `/mednotes:setup`, `/mednotes:telemetry`,
+  `/mednotes:history` no resumo principal quando o usuário pediu inspeção.
+- Em debug explícito (usuário pediu "mostre o JSON", "rode com `--json`",
+  "explique o erro técnico").
+
+## Anti-Padrão Recorrente (Run Real)
+
+Em `/mednotes:fix-wiki`, foi exposto ao usuário: "batch de curadoria",
+"plano v5", "schema drift", "hash mismatch", "uv run", "manifest",
+"needs_review" e "skip-prompt-eval". Tradução correta:
+
+> "Fiz uma prévia da Wiki. Encontrei um conflito de versão e preciso da sua
+> decisão antes de continuar. Nada foi alterado ainda. Próxima ação:
+> <frase curta>."

package/.opencode/mednotes/docs/semantic-linker.md

@@ -0,0 +1,141 @@
+---
+name: med-auto-linker
+description: Contrato compacto do /mednotes:link: diagnostico, desambiguacao contextual e apply auditavel do grafo da Wiki.
+---
+
+# Semantic Linker Contract
+
+No workflow público `/mednotes:link`, use a CLI pública `wiki/cli.py run-linker`.
+`/mednotes:link-body` usa o mesmo `run-linker` com `--no-related-notes`.
+`/mednotes:link-related` usa `wiki/cli.py related-notes-sync`, cujo output
+público é `medical-notes-workbench.link-related-fsm-result.v1`. O payload
+operacional antigo de Related Notes é detalhe interno: consumidores leem
+`progress_view_model`, `state_machine_snapshot`, `decision`, `receipt`,
+`artifacts`, `diagnostic_context` e `error_context`. O linker cuida só de
+`knowledge_graph`: WikiLinks, aliases, vocabulary DB, meanings, body linker,
+Related Notes, backlinks e validação do grafo. Não corrige estilo, YAML,
+publicação, conteúdo didático, taxonomia nem índice Dataview.
+`/mednotes:link` é o dono de todo reparo de grafo; curadoria semântica é fase
+interna de /mednotes:link, não tarefa manual final para o usuário.
+
+Fonte operacional: `~/.gemini/medical-notes-workbench/vocabulary.sqlite`.
+YAML `aliases` é projeção humana do DB, não autorização suficiente para linkar
+corpo. `CATALOGO_WIKI.json`, quando existir, é legado/apoio; não é fonte
+primária de decisão semântica.
+
+Contrato público: `run-linker --diagnose --json` lê Wiki/Git/DB/aliases/links,
+export do Related Notes e estado do grafo, salva `link-diagnosis.json` e não
+muta Markdown. `run-linker --diagnose --no-related-notes --json` pula
+`related_notes_sync` para o comando body-only. Workflows que mudaram notas
+passam `--trigger-context <json>`. `run-linker --apply --diagnosis <json>
+--json` consome o diagnóstico salvo, revalida snapshot/hash/Git e bloqueia se
+estiver stale. Se o diagnóstico contém `wiki_dir`, `catalog_path` e
+`vocabulary_db_path`, o apply usa esses caminhos quando overrides explícitos não
+forem passados. `--receipt` nunca sobrescreve arquivo existente; nesse caso o
+workflow bloqueia com `receipt_path_exists`. Apply nunca chama LLM.
+O diagnóstico grava `last_diagnosis_attempt` em `link-state.v2`; repetição sem
+mudança pode retornar `skipped_reason=redundant_diagnosis_without_state_change`.
+Se o vocabulary DB ainda não existe, o diagnóstico registra
+`vocabulary_bootstrap.status=planned` e bloqueia `body_term_linker` com
+`vocabulary_bootstrap_required` quando houver notas a ingerir; criar SQLite,
+limpar aliases/WikiLinks antigos e enfileirar notas é responsabilidade de um
+apply workflow-aware do próprio `/mednotes:link` ou de um workflow que o chama,
+como `/mednotes:fix-wiki`.
+No apply, `vocabulary_semantic_repair` resolve a fila simples com meanings por
+título/nota, policy direta só para título e aliases contextuais; depois força
+novo diagnóstico e aplica. Só bloqueia em decisão humana, conflito ou erro real.
+
+Fases fixas:
+
+1. `reference_repair`
+2. `contextual_alias_disambiguation`
+3. `body_term_linker`
+4. `related_notes_sync`
+5. `graph_validation`
+
+Regras semânticas:
+
+- `1 meaning canônico = 1 nota Wiki`.
+- Atomicidade/split segue `atomicity-splitting-policy.md`: o DB decide a partir
+  de `semantic_signal` do corpo, nunca de title-only signal; só
+  `split_required` vira `deferred_work_items.status=pending`.
+- Várias notas para o mesmo meaning é duplicata/merge.
+- `direct` só linka quando uma surface tem um meaning e uma nota canônica.
+- `requires_context` exige decisão por ocorrência. Exemplo: `PCR` pode ser
+  Proteína C Reativa, Parada Cardiorrespiratória ou Reação em Cadeia da
+  Polimerase, mesmo se o vault ainda só tiver uma candidata.
+- Matches seguros de único alvo canônico são resolvidos pelo script. Ambiguidades
+  médicas reais exigem orquestração oficial por agente/subagent; o script não
+  abre `gemini -p` escondido. Alvo inventado, confiança baixa ou contexto
+  insuficiente vira `defer`/`no_link`.
+
+Body linker usa scanner Aho-Corasick, preserva YAML, headings, code, imagens,
+embeds, footer e `## 🔗 Notas Relacionadas`, exceto quando a fase dela roda.
+Qualidade do body linker é medida por `evaluate-body-linker` com fixtures
+redigidas; falso positivo deve bloquear o gate.
+
+`reference_repair` usa trigger context ou Git para `created`, `modified`,
+`deleted`, `renamed`, `moved` e `merged`. Rename/move/merge validado reescreve
+links entrantes; delete sem substituto vira `structural_deleted`.
+
+Related Notes é seção gerenciada pelo linker: remover só o bloco abaixo de
+`## 🔗 Notas Relacionadas`, preservar as demais seções finais e reescrever a partir do export
+estável do plugin (`score >= 0.78`, teto configurado, ordem de relevância).
+O recovery oficial do export tenta primeiro o comando do plugin via Obsidian
+CLI. Se a CLI não existir, mas o plugin estiver instalado no vault, o Workbench
+pode reconstruir `index.json` e `medical-notes-export.json` pela rota headless
+compatível com o plugin, lendo a chave do `data.json` sem expor segredo. O
+export público nunca carrega API key, embeddings, cache interno, Markdown bruto
+ou conteúdo clínico; falha de quota vira
+`related_notes_headless_quota_exhausted`. Execução longa demais vira
+`related_notes_headless_time_budget_exhausted`, com índice parcial salvo e
+retomada oficial. A rota headless impõe no mínimo 10s entre chamadas externas
+de embedding, mesmo se `embeddingRequestDelayMs` vier menor, zero ou ausente.
+O orçamento padrão de execução headless é 120s e pode ser ajustado por
+`MEDNOTES_RELATED_NOTES_HEADLESS_MAX_SECONDS` em testes/automação.
+Quando a rota headless já salvou parte do índice, o blocker deve carregar
+payload tipado de progresso Related Notes com total, restante, janela de retry e
+`resume_supported=true`. Se o bloqueio for quota externa ou orçamento de tempo,
+o plano deve deixar claro que a retomada é posterior (`executable_now=false`),
+não continuação imediata; isso não é decisão humana nem instrução para o usuário
+editar Related Notes manualmente.
+O linker não mantém índice Dataview. Notas operacionais marcadas com
+`indice`/`índice` são ignoradas no grafo/linker e devem preservar queries,
+code blocks e forma operacional própria.
+
+Proveniência não é Related Notes: `chats[]` é metadata consultável da fonte e
+`## 🧬 Fontes Consolidadas` é a seção visível final, gerenciada pelos workflows
+de publicação/fix-wiki. O linker não cria nem apaga `chats[]`.
+Export stale usa `related-notes-sync --recover-export --mode auto --json`.
+Se Related Notes for o único blocker e body/reference estiverem seguros,
+`run-linker --diagnose` inclui `body_only_fallback.safe=true`; caso contrário,
+`safe=false`.
+Quando `fix-wiki --apply` não consegue recuperar o export, mas os blockers de
+grafo estão dentro da seção gerenciada, ele pode registrar
+`related-notes-safety-cleanup.v1`: remove apenas WikiLinks inválidos já
+presentes em `## 🔗 Notas Relacionadas`, preserva links existentes que ainda
+resolvem para uma única nota e mantém `related_notes_blocked` até o plugin gerar
+um export fresco. Essa limpeza não calcula embeddings nem novas relações.
+
+Recibos/diagnósticos não gravam Markdown clínico bruto nem diff textual. O
+`med-link-graph-curator` mantém meanings, aliases, policies e work items; ele
+não edita Markdown diretamente e não chama outro subagente.
+Para `deferred_work_items[].reason=non_atomic_note`, use
+`atomicity-splitting-policy.md`: `semantic_signal` deve trazer evidência do
+corpo, relação/fragmento e estimativa dos filhos; sem isso o apply bloqueia como
+`semantic_ingestion.atomicity_signal_required`.
+O parent passa `agent-work-packet.v1`: path/hash/DB, ações, stop conditions,
+`difficulty_route`, rubrica e contrato. `simple_atomic` é curto;
+`complex_semantic_review` classifica/defer riscos; `blocked_preflight` para
+antes de gastar tokens. `plan_hash` é corpus-only sem runtime; `prompt_identity`
+valida no apply.
+Quando o diagnóstico emitir `vocabulary_curator_batch_plan_path`, o apply ainda
+deve tentar `vocabulary_semantic_repair`; se sobrar pendência humana, continue a
+cadeia dentro do `/mednotes:link` e não encerre como próximo passo manual.
+Depois dos outputs, gere manifest com `collect-curator-outputs`; não escreva
+manual. Rode `eval-curator-batch --report <report> --json`.
+O gate emite `curator-prompt-eval.v1` e bloqueia alias amplo, vazamento, rota
+complexa sem defer/split, orçamento excedido ou falta de `agent_metrics`.
+Apply real exige `--prompt-eval <report.json>`; `--skip-prompt-eval` exige
+`MEDNOTES_ALLOW_DEV_ESCAPE=1` e `--skip-prompt-eval-reason`, e registra
+`agent.curator_prompt_eval_skip`.

package/.opencode/mednotes/docs/taxonomy-policy.md

@@ -0,0 +1,90 @@
+# Política Canônica de Taxonomia
+
+Este contrato governa apenas a hierarquia de pastas da `Wiki_Medicina`.
+A fonte executável de verdade é
+`bundle/scripts/mednotes/wiki/taxonomy/policy.py`; este documento é a
+projeção humana distribuída com a extensão.
+
+## Hierarquia
+
+- Nível 1: cinco grandes áreas numeradas, em conjunto fechado.
+- Nível 2: especialidades canônicas sob cada grande área, em conjunto fechado.
+- Nível 3: subcategoria opcional sob uma especialidade canônica.
+- Nível 4+: leaf ou pasta de nota.
+
+`schema.py` e os subcomandos `taxonomy-*` derivam áreas, especialidades e
+aliases de `policy.py`. Subcategorias/leaves continuam governadas por
+`allow_new_leaf=True` e bloqueio de similaridade próxima.
+
+## Grandes Áreas
+
+- `1. Clínica Médica`
+- `2. Cirurgia`
+- `3. Ginecologia e Obstetrícia`
+- `4. Pediatria`
+- `5. Medicina Preventiva`
+
+## Ginecologia E Obstetrícia
+
+A grande área canônica é `3. Ginecologia e Obstetrícia`.
+
+Especialidades canônicas:
+
+- `Ginecologia`
+- `Obstetrícia`
+
+Aliases legados preservados por compatibilidade:
+
+- `#. Ginecologia e Obstetricia` -> `3. Ginecologia e Obstetrícia`
+- `3. Ginecologia e Obstetricia` -> `3. Ginecologia e Obstetrícia`
+- `Ginecologia_Obstetricia` -> `3. Ginecologia e Obstetrícia`
+- `Ginecologia e Obstetricia` -> `3. Ginecologia e Obstetrícia`
+- `Ginecologia e Obstetrícia` -> `3. Ginecologia e Obstetrícia`
+- `Obstetricia` -> `3. Ginecologia e Obstetrícia/Obstetrícia`
+
+## Versão Da Política
+
+A versão executável atual é `2026-05-15.taxonomy-v1`. Planos e recibos de
+migração registram essa versão e não devem ser aplicados quando a versão atual
+for diferente.
+
+## Status Humano
+
+Use `taxonomy-status` para entender o estado da árvore real antes de aplicar
+migração. O comando emite JSON e pode escrever relatório Markdown com
+`--report-output`.
+
+## Criação De Leaf Nova
+
+Dry-run pode sugerir `taxonomy_new_dirs`. Publish real só cria diretórios novos
+quando o recibo de dry-run para o mesmo manifest autorizou exatamente esses
+diretórios.
+
+## Decisão Operacional
+
+- Preservar caminhos que já estão sob área e especialidade canônicas.
+- Resolver aliases conhecidos para o destino canônico antes de publicar ou
+  migrar.
+- Criar leaf nova somente sob pai canônico coerente e sem similaridade fuzzy
+  bloqueadora.
+- Bloquear para decisão humana quando a área, especialidade, similaridade ou
+  destino for ambíguo.
+- Mover pastas somente via `taxonomy-migrate`, com plano, recibo e rollback.
+
+## Comandos
+
+- `taxonomy-canonical`
+- `taxonomy-tree`
+- `taxonomy-audit`
+- `taxonomy-status`
+- `taxonomy-resolve`
+- `taxonomy-plan`
+- `taxonomy-apply`
+- `taxonomy-rollback`
+- `taxonomy-migrate`
+
+`fix-wiki` pode auditar e planejar taxonomia, mas migração de pastas continua
+passando pelo mecanismo de plano/aplicação/rollback de `taxonomy-migrate`.
+`taxonomy-plan`, `taxonomy-apply` e `taxonomy-rollback` são nomes mais claros
+para o mesmo fluxo. `taxonomy-migrate --dry-run|--apply|--rollback` permanece
+compatível.

package/.opencode/mednotes/docs/triage-policy.md

@@ -0,0 +1,187 @@
+# Triage Policy
+
+Política editorial para o `med-chat-triager`. Define como dividir um único
+raw chat em unidades semânticas duráveis sem decidir nada sobre a Wiki
+existente. Pareado com `agent-role-contracts.md` e `merge-policy.md`.
+
+Regra-âncora:
+
+> 1 meaning canônico = 1 nota Wiki. O triager declara meanings; ele não
+> decide se eles já existem.
+
+## Ações Permitidas (`triage-note-plan.v2`)
+
+### `planned_meaning`
+
+Use para cada unidade médica durável que merece virar trabalho downstream
+(nota nova, rewrite canônico ou merge candidato — quem decide é o planner,
+não o triager).
+
+Critérios:
+
+- representa um conceito médico atômico, com escopo definível em uma frase;
+- o raw chat fornece evidência suficiente para descrever esse escopo;
+- a unidade tem `meaning_claim` com `label`, `scope`, `boundaries`, `kind` e
+  `evidence_summary` redigido;
+- `staged_title` é um nome de arquivo limpo em pt-BR (sem path separators,
+  caracteres proibidos Windows, controle, ponto/espaço final).
+
+Granularidade:
+
+- não fragmente abaixo da unidade semântica (ex.: não emita
+  `Mecanismo de ação dos ISRS` separado de `ISRS` quando o raw discute apenas
+  ISRS como um todo);
+- não infle granularidade (ex.: não emita uma nota por critério de
+  diagnóstico isolado quando o raw discute o quadro completo);
+- preferir uma unidade ampla com `attach_to_planned_meaning` em vez de
+  várias unidades pequenas mal sustentadas.
+
+### `attach_to_planned_meaning`
+
+Use para informação útil subordinada a outra unidade do mesmo raw chat.
+Requer `target_item_id` apontando para uma `planned_meaning` válida do mesmo
+plano.
+
+`reason_code` fechado:
+
+- `supporting_detail`: detalhe clínico/farmacológico que reforça a unidade
+  alvo;
+- `boundary_clarification`: discussão que ajuda a delimitar o escopo da
+  unidade alvo;
+- `example_or_case`: exemplo/caso que ilustra a unidade alvo;
+- `cross_reference`: menção breve que aponta a unidade alvo para outra
+  unidade do mesmo raw.
+
+`attach_to_planned_meaning` não vira nota separada. Ele é dica para o
+architect agregar conteúdo dentro da unidade alvo.
+
+### `not_a_note`
+
+Use para conteúdo do raw chat que não deve virar nota.
+
+`reason_code` fechado:
+
+- `administrative_chatter`: pedido operacional, metacomentário, saudação;
+- `repetition_no_new_information`: repete unidade já planejada sem novidade;
+- `out_of_scope_for_medical_wiki`: assunto fora do escopo da Wiki médica;
+- `low_value_fragment`: fragmento sem conteúdo médico aproveitável.
+
+`reason` em texto livre é obrigatório e deve ser redigido e curto.
+
+### `needs_context`
+
+Use quando o raw chat **não permite segmentação semântica segura** para a
+unidade em questão. Não é dúvida sobre cobertura existente: é dúvida sobre
+identidade da unidade no próprio raw.
+
+`reason_code` fechado:
+
+- `evidence_insufficient`: o raw chat não traz texto suficiente para
+  sustentar `meaning_claim.scope`/`boundaries`;
+- `multiple_topics_undifferentiated`: o raw mistura múltiplas unidades sem
+  que o triager consiga separá-las com segurança a partir do texto;
+- `clinical_ambiguity`: contradição clínica no próprio raw que precisa de
+  revisão humana antes de virar nota;
+- `language_or_encoding_blocker`: o raw está corrompido, truncado ou em
+  formato que o triager não consegue ler.
+
+`needs_context` exige `reason` redigido. Pode existir junto de
+`planned_meaning`/`attach_to_planned_meaning` (planos mistos são permitidos);
+um plano inteiro só com `needs_context` é também válido e cabe ao planner
+decidir entre re-triagem manual e bloqueio.
+
+## Proibições
+
+- Não declarar que uma nota já existe na Wiki. Isso é decisão do planner
+  contra Wiki/vocabulary DB.
+- Não emitir `winner_path`, `merge_target` ou similar.
+- Não consultar vocabulary DB como autoridade.
+- Não usar título de nota Wiki existente como identidade — `meaning_claim`
+  vive em texto, não em filename.
+- Não pedir decisão humana genérica. Se a dúvida é editorial, usar
+  `needs_context` com `reason_code` específico.
+
+## Forma De `meaning_claim`
+
+```json
+{
+  "label": "Uso de ISRS em gestantes",
+  "scope": "seguranca, contraindicacoes e conduta clinica na gestacao",
+  "boundaries": [
+    "nao cobre mecanismo geral dos ISRS",
+    "nao cobre depressao puerperal como entidade separada"
+  ],
+  "kind": "clinical_concept",
+  "evidence_summary": "O chat discute risco e conduta de ISRS na gestacao."
+}
+```
+
+Campos:
+
+- `label`: nome humano da unidade. Curto.
+- `scope`: o que está dentro da unidade. Uma frase.
+- `boundaries`: 1–3 itens em lista descrevendo o que parece relacionado mas
+  fica fora. Lista vazia é permitida apenas quando a unidade não tem vizinho
+  próximo no raw.
+- `kind`: tipo operacional fechado:
+  - `clinical_concept` (entidades clínicas, síndromes, manifestações);
+  - `drug_concept` (fármaco/classe);
+  - `diagnostic_criterion` (critério/escore);
+  - `management_strategy` (conduta/protocolo);
+  - `procedure` (procedimento);
+  - `physiology_or_mechanism` (mecanismo/fisiologia);
+  - `epidemiology_or_definition` (definição/epidemiologia).
+- `evidence_summary`: resumo operacional **redigido** do que no raw sustenta
+  a unidade. Sem conteúdo clínico bruto longo, sem citação direta extensa.
+
+## Critérios Editoriais Curtos
+
+- Se o raw aborda dois assuntos vizinhos com escopo claro e evidência
+  separada → duas `planned_meaning` com `boundaries` apontando uma para a
+  outra.
+- Se o raw aborda um assunto com vários detalhes que enriquecem aquela
+  unidade → uma `planned_meaning` + N `attach_to_planned_meaning`.
+- Se o raw é principalmente operacional ou administrativo → o plano só
+  contém `not_a_note`. Plano todo `not_a_note` é válido e marca o raw como
+  descarte editorial.
+- Se o raw é claramente médico mas o triager não consegue separar com
+  segurança → uma ou mais entradas `needs_context` com `reason_code` exato.
+
+## O Que A Triagem Não Decide
+
+- Existência prévia na Wiki.
+- Path canônico ou taxonomia final.
+- Quem é "winner" entre dois meanings parecidos.
+- Se duas unidades de raws diferentes representam o mesmo meaning.
+
+Tudo isso é responsabilidade do planner Python e/ou curator.
+
+## Exemplos Curtos
+
+Correto — granularidade ampla com anexos:
+
+```text
+T001 planned_meaning  ISRS na gestação
+T002 attach_to_planned_meaning → T001 (supporting_detail) farmacocinética
+T003 attach_to_planned_meaning → T001 (boundary_clarification) puerpério não cobre
+```
+
+Errado — fragmento abaixo da unidade:
+
+```text
+T001 planned_meaning  Mecanismo de ação dos ISRS
+T002 planned_meaning  Meia-vida dos ISRS
+T003 planned_meaning  Recaptação de serotonina pelos ISRS
+```
+
+Correto — descarte editorial:
+
+```text
+T001 not_a_note (administrative_chatter) Pedido operacional sem conteúdo médico.
+```
+
+Correto — raw insuficiente:
+
+```text
+T001 needs_context (evidence_insufficient) Discussão fragmentada sobre HAS sem fechamento de escopo.
+```