sagadeck 1.9.0 → 1.11.0

package/README.md

@@ -16,7 +16,7 @@ Ele vem com 11 temas (incluindo prata limpo e respirável, artesanal desenhado
 ```bash
 npm install -g sagadeck
 ```
-Requer **Node.js 22.13+** e **Chrome ou Edge** instalados (o PDF, o PNG e as conferências visuais usam o navegador).
+Requer **Node.js 24+** e **Chrome ou Edge** instalados (o PDF, o PNG e as conferências visuais usam o navegador).
 É tudo Node: não precisa de Python. (O pacote do PyPI parou na 1.5.0.)
 
 ## Comece aqui
@@ -96,6 +96,7 @@ de cada papel:
 | visão | ver o slide renderizado e as imagens coladas | opcional; vazio = o de texto |
 | imagem | ilustrações (`image_prompt`) | opcional |
 | busca | pesquisa na web da geração (no OpenRouter, um modelo `:online`) | opcional; sem ele, buscadores diretos |
+| conferir | as conferências: contas, leitura crítica e confirmação da revisão visual (um modelo de raciocínio mais forte só onde a conta precisa estar certa) | opcional; vazio = o de texto |
 
 **Testar** faz uma pergunta curta com o que está na tela antes de salvar. A configuração fica só nesta máquina, em
 `~/.sagadeck/ia.json` (fora do código e fora da biblioteca, que pode sincronizar com a nuvem); a chave nunca volta
@@ -138,7 +139,7 @@ As variáveis abaixo valem por cima da configuração (útil em servidor e em te
 |---|---|
 | `SAGADECK_LLM_URL` | qualquer API compatível com OpenAI (ex.: `https://openrouter.ai/api/v1`) |
 | `SAGADECK_LLM_KEY` | a chave (bearer token) |
-| `SAGADECK_TEXT_MODEL` / `SAGADECK_VISION_MODEL` / `SAGADECK_IMAGE_MODEL` / `SAGADECK_SEARCH_MODEL` | os modelos de cada papel |
+| `SAGADECK_TEXT_MODEL` / `SAGADECK_VISION_MODEL` / `SAGADECK_IMAGE_MODEL` / `SAGADECK_SEARCH_MODEL` / `SAGADECK_CHECK_MODEL` | os modelos de cada papel (`CHECK`: o das conferências) |
 | `SAGADECK_LLM_TIMEOUT` | segundos por chamada (padrão `180`) |
 | `SAGADECK_IA` | outro arquivo de configuração (padrão `~/.sagadeck/ia.json`) |
 
@@ -285,6 +286,12 @@ navegador, mas não para editar.
 
 ## Slides para devs: API ao vivo
 
+Na biblioteca, **Programação** e **APIs com cURL** abrem a criação com exemplos de pedidos, código colado,
+anexos técnicos e prévia do briefing. Também há duas bases curtas para começar **sem IA**.
+No editor, **Início ou Inserir → Código / cURL** transforma conteúdo colado em código, explicação guiada
+ou requisição de API. Selecione linhas para criar as etapas; Bash/cURL, JSON e SQL têm realce offline.
+Os temas **Terminal Pro** e **Aurora Dev**, em Design, trazem código legível e capas com rede animada.
+
 O layout `api` é um slide tipo Postman: mostra o pedido (URL, corpo, cabeçalhos) e o código equivalente
 (curl, Python e Python comentado), e o botão **Executar** roda o pedido de verdade na frente da plateia:
 síncrono, polling com linha do tempo, streaming, upload, token (JWT decodificado), embeddings, TTS/STT e

package/SKILL.md

@@ -11,7 +11,7 @@ O sagadeck gera apresentações profissionais a partir de um arquivo YAML, ofere
 
 Quando a pessoa pede para instalar o sagadeck e deixar pronto:
 
-1. `npm install -g sagadeck` (Node 22.13+; não precisa de Python).
+1. `npm install -g sagadeck` (Node 24+; não precisa de Python).
 2. `sagadeck studio`: o navegador abre sozinho em **http://127.0.0.1:3517** (é também a primeira linha que o
    comando escreve; `--sem-navegador` não abre). **O Studio é a interface do sagadeck**: biblioteca, editor e chat com
    IA. O terminal fica aberto enquanto ela usa.

package/bin/sagadeck.js

@@ -76,7 +76,7 @@ const HELP = `sagadeck — YAML -> apresentação (HTML animado + PowerPoint edi
   sagadeck autofix <deck.yaml> [--out=pasta]   auto-corrige sobreposições, margens e excesso de texto no YAML
   sagadeck diff <a.yaml> <b.yaml> [--json]      o que entrou, saiu, mudou e andou entre dois decks (por uid)
   sagadeck enxugar <deck.yaml> [--fix]          palavras por slide contra o limite do material (--fix: excedente para as notas)
-  sagadeck ia-check [--rapido] [--so=texto,visao,imagem,pesquisa,video] [--video-real] [--json]
+  sagadeck ia-check [--rapido] [--so=texto,visao,imagem,pesquisa,video,conferencia] [--video-real] [--json]
                                    testa a IA configurada, sem tela: cada recurso com uma chamada de verdade, todos ao
                                    mesmo tempo, cada resultado assim que chega. --rapido pula imagem e vídeo; vídeo, por
                                    padrão, só confere chave e catálogo; --video-real gera um clipe curto (é cobrado).

package/docs/ANDAMENTO.md

@@ -8,6 +8,308 @@ começar. Trabalho em curso vai para o GitHub (commit + push) a cada etapa, nunc
 
 ---
 
+## Conversão para a unidade do resultado — 23/10/2026 (branch `claude/unidade-resultado`)
+
+Terceiro pedido à IA na cópia da Narumi, em produção (`020c243`): ela resolveu as pendências dos slides 12, 23 e 24,
+mas a conferência das contas acusou falsos alarmes ("107 L/s dá 106.400", "120 cm dá 12.000"): o modelo escreveu a
+conversão para a unidade do resultado na fórmula (`*1000` para L/s, `*100` para cm) e o código convertia de novo.
+A detecção de conversão feita à mão olhava só as unidades das vars; agora olha também a do resultado. Conferido no
+deck: os slides 21, 22 e 27 que a correção mexeu continuaram certos (273 m; 944 cm e sobra de 273 cm; velocidades
+0,64 / 0,605 / 0,58 m/s).
+Um ensaio em memória com o modelo real mostrou que o problema é maior: o modelo rotula mal as unidades (kPa num
+lugar, N/m³ no outro) e a conta com unidades sai mil vezes errada ("273 m dá 937045"); empurrada pelos alarmes, a
+correção enfeitou o slide 21 com "= 100 × 2,729 m". Regra nova (`judge`): a conta bate se bater nos números dados
+OU com a conversão; só é divergência o que não bate de jeito nenhum. As unidades servem para evitar alarme falso,
+nunca para criar um. Saiu a acusação da fórmula do slide por unidades (`fn_slide`), que deu alarme falso no deck
+real. Testes: `units.test.js` (rótulo errado não acusa; L/s só bate com a conversão; erro de verdade acusa) e ao
+vivo (resultado certo em L/s e cm não vira alarme; 600 s → 240 s com a resposta calculada pelo motor).
+
+## Ajustes depois do teste na cópia — 23/10/2026 (branch `claude/ajustes-conferencia`)
+
+Teste em produção na cópia da Narumi (nunca no deck da Mary): a IA, pelo chat, corrigiu as contas (21: 273 m;
+22: gráfico com 944 cm disponíveis e a sobra de 272 cm; 25: D ≈ 0,17 m, comercial 0,20 m, hf 1,29 m com "Confira"
+nas notes) e depois os avisos da criação (slides 5, 6, 9, 11, 15, 16, 18, 22). Três ajustes:
+- a conferência deixou um aviso falso ("273 m dá 617,8": fórmula errada do verificador; a IA que corrige disse que
+  o slide estava certo). Agora, quando ela discorda, uma conferência independente decide; o aviso só fica se as
+  duas acusarem (`math.contestadas` conta os que caíram).
+- a resposta do chat trazia `</parameter>` solto (formato de ferramenta do modelo): `cleanProse` tira essas
+  marcas, sem mexer em HTML da pessoa.
+- dado `p_atm` no exercício aparecia "pₐtm": índice de várias letras ganha chaves (`symbolTex` em `src/lessons.js`).
+- o painel Revisar › Conferência seguia com os 24 avisos visuais mesmo depois de a IA corrigir os slides pelo chat.
+  O relatório guarda a impressão digital de cada slide (`slideMarks`; relatório antigo usa a versão mais antiga
+  guardada em `.sagadeck/versoes/`): aviso de slide que mudou aparece como "o slide mudou; confira se ainda vale" e
+  não vai mais à IA como pendência.
+- o selo da Conferência consultava o servidor a cada troca de slide; agora só quando o deck é salvo (e na abertura
+  e no fim de cada pedido ao chat). `perf.test.js` conta as consultas durante a navegação (falhou com 4, passa com 0).
+  O teste de desempenho com 200 slides também falha às vezes nesta máquina com uma troca de 4–5 s, inclusive em
+  commits de antes destas mudanças (`3c18855`, `df0f7df`): instabilidade da máquina, não regressão (a CI passa).
+Testes em `ai.test.js` e `engine.test.js`; os ajustes falham sem o conserto.
+
+## Arquivo travado no Windows — 23/10/2026 (branch `claude/rename-windows`)
+
+A CI da main falhou no Windows depois do #201: o rename atômico do deck deu EPERM por mais tempo que as novas
+tentativas (~1 s) e o teste do formulário do slide api leu o deck sem a última mudança (as rodadas seguintes
+passaram). `RENAME_DELAYS` agora espera até ~4 s (OneDrive/antivírus da pessoa também ganham). Teste novo em
+`deck-file.test.js` simula o arquivo travado por 1,5 s: falhou antes, passa agora.
+
+## Contas calculadas no exercício resolvido — 22/10/2026 (branch `claude/unruffled-nobel-8f9bce`, parte de `claude/conferir-contas`)
+
+A raiz do "L₁ ≈ 55 m": o número do passo era texto da IA. Agora, no `solution`, o número nasce da conta.
+- `src/runtime/solution.js` (motor e apresentação, como o `calc.js`): dados com `symbol` + `value` numérico viram
+  variáveis (nome do símbolo: `L_1` → `L1`, `\rho` → `rho`; ou `name`); passo e resposta com `fn` são calculados na
+  ordem pelo compilador de `formula.js` (sem eval). Valor no fim do LaTeX do passo (`≈`, ou `=` se exato) ou onde
+  estiver `{{nome}}` (o próprio nome do passo); `{{nome}}`/`{{expr:casas}}` também nos textos, resposta e enunciado.
+  Vírgula decimal, milhar (`\,` na fórmula, ponto no texto), `decimals` ou 4 algarismos.
+- Erro na fórmula ou letra sem valor: aviso de render ("exercício resolvido: passo 2: a fórmula usa "k"…") e caixa
+  `.sol-error` no passo; o valor vira traço, sem LaTeX quebrado. A IA recebe o aviso como qualquer outro.
+- `interactive: true`: controle deslizante em cada dado (passo na grade das casas do dado; min/max alinhados, senão
+  0,01 virava 0,011), Restaurar, números trocados ao vivo por marcas `\htmlData{solv=k}` (KaTeX com `trust` só para
+  esse atributo) e `<span data-solv>` no texto. Só nesse modo o HTML leva as marcas; o estático segue limpo.
+  O MathML não acompanha o número novo: no modo interativo ele some e o leitor de tela lê o próprio desenho.
+  Carregado em `build.js` só com `solution` interativo; Studio serve `/solution.js` e monta no editor.
+- `math-check.js`: `forAudit` tira os passos/resposta com `fn` e troca `{{…}}` por "(calculado)"; `hasMath` de um
+  exercício com `fn` só é verdade se sobrar número escrito à mão.
+- Formulário (fórmula, nome, unidade, casas do passo; nome/mín./máx. do dado; "Dados ajustáveis"), exemplo da galeria
+  (juros com `fn` e interativo), `REFERENCIA.md` (seção + exemplo do sifão, que renderiza sem aviso) e o prompt
+  ("nunca escreva à mão um resultado que uma fórmula dá").
+- Testes em `test/lessons.test.js` (onde o `solution` já mora): render com valores e arredondamento, erro claro,
+  conferência que pula o calculado, apresentação interativa e o formulário do Studio conferido no deck salvo.
+
+## Unidades e contas do material — 23/10/2026 (branch `claude/conferir-unidades`, worktree `../sagadeck-conferir-unidades`)
+
+Continuação da conferência das contas (#201), sugestões 3 e 4 da revisão do deck da Mary.
+- `src/ai/units.js`: unidades comuns de aula e relatório (m, cm, L/s, kN/m², mH2O, °C, %…) → fator para o SI e
+  dimensão. `dimensionOf` acha a dimensão de uma conta sem árvore de expressão: escala cada grandeza de base (×2, ×3)
+  e vê como o resultado muda; soma de grandezas diferentes não muda como potência e é apontada.
+- Conferência das contas com unidades: a IA dá a unidade de cada var; a conta é feita no SI e volta para a unidade
+  do slide (L/s × m³/s, cm × m deixam de dar falso erro; 611 m/s no lugar de 0,611 é pego). `fn_slide` (a fórmula
+  como o slide escreveu) é acusada quando não fecha em unidades, só se a conta da própria IA fecha. Conversão feita
+  à mão pela IA (Q/1000 com Q em L/s) não é convertida de novo; resultado sem unidade fica no SI.
+- Leitura crítica confere as contas do próprio material (`auditMaterialMath`): duas rodadas independentes em
+  paralelo, só fica o que as duas acusam (o modelo real errou a conversão numa rodada); vira item `inconsistencia`
+  com trecho literal conferido. Usa o modelo das conferências (#202).
+Testes: `units.test.js` (unidades, dimensão, conversão, fórmula do slide), `critique.test.js` (gabarito errado vira
+item, rodadas que discordam não viram aviso), ao vivo (`SAGADECK_LIVE=1`): conversão esquecida e lista com
+gabarito errado, 3 de 3. Suíte completa da branch antes da integração: 1.117 testes, 1.086 aprovados, zero falhas.
+Integração com #202, #203 e #204 (base `claude/laughing-ritchie-81bb23`): conflito só na REFERENCIA, as duas frases
+ficaram.
+
+## Painel Revisar › Conferência — 22/10/2026 (branch `claude/laughing-ritchie-81bb23`, sobre `claude/conferir-contas`)
+
+Continuação da conferência das contas (abaixo): os achados das checagens tinham aviso, mas não tinham lugar nem
+botão (relatório num arquivo, uma mensagem do chat na primeira abertura, selo de origem na miniatura). Agora:
+- Revisar › **Conferência** (ao lado de Mudanças), com selo da contagem pendente: por slide, contas que não batem,
+  contas do material que não fecham, números sem base no material, avisos da revisão visual, figuras do material sem
+  slide e slides `derivado`/`proprio`. Montado no servidor (`src/studio/conference.js`) a partir do relatório
+  (`.sagadeck/avaliacao-geracao.json`) e do deck atual; achado que o deck já não tem (o número saiu do slide, o
+  slide não existe) some sozinho. Tela em `src/studio/public/conference-ui.js`.
+- Por item: Ir ao slide; **Corrigir com IA** (pedido pontual no chat; conta vai com `contas: [n]` no corpo do pedido
+  e o Studio confere depois da resposta, mesmo que a IA não peça); **Ignorar** (`decisoes` no relatório). O que não
+  dá para conferir sozinho (aviso visual, figura, origem) sai do painel ao ir para o chat (`enviado`).
+- Toda conferência das contas pelo chat grava o resultado no relatório (`recordMath`): conta corrigida sai do painel.
+- **Conferir de novo** (`/api/conferencia/conferir`): contas (`checkMath` só auditando), números (`unsupportedNumbers`,
+  o núcleo do `checkNumbers`) e figuras (`uncoveredVisuals`) no deck atual; sem IA, confere o que não precisa dela.
+- As pendências vão junto de cada pedido ao chat (`editDeck({ pending })`, bloco PENDÊNCIAS DA CONFERÊNCIA
+  AUTOMÁTICA); o ignorado não vai, nem quando a mensagem antiga dos avisos está na conversa. REFERENCIA atualizada.
+Testes: `ai.test.js` (itens, ignorar, recordMath, Conferir de novo com e sem IA) e `studio-ai.test.js` (o painel
+usado como a pessoa usaria: selo, Conferir de novo, Ignorar, Corrigir com IA numa conta e num slide da IA,
+conferindo deck salvo, relatório e o que foi ao modelo; zero erros JS). Ícones Lucide novos: list-checks,
+calculator, hash, image-off. Suíte completa: `npm test`, 1.116 testes, 1.087 aprovados, 29 condicionais pulados, zero falhas.
+Falta: PR empilhado sobre o #201 (`claude/conferir-contas`), CI verde, merge.
+
+## Pedido da criação gravado — 22/10/2026 (branch `claude/pedido-da-criacao-0d34bc`, sobre `claude/conferir-contas`)
+
+Origem: no deck da Mary dava para provar que ela anexou um PPTX (estava em `contexto/`), mas não o que ela pediu: o
+briefing não ficava salvo e o serviço não loga pedidos.
+Feito: `src/studio/generation-request.js` grava `.sagadeck/geracao.json` em arquivo próprio (não mexe no relatório
+`avaliacao-geracao.json`): data, origem (`biblioteca`, `editor`, `chat`), o briefing exatamente como foi para a IA e
+`briefingPadrao` (a pessoa não escreveu nada e foi o texto padrão da tela; a biblioteca manda `guide.padrao`, com
+intenção, público, objetivo e roteiro), resposta à pergunta da IA, duração, slides, tema, estilo, direção, anexos
+(nome, tipo, tamanho em bytes, caracteres lidos, caminho em `contexto/documentos/<hash>/`), Preferências que mudam a
+geração (idioma, imagens, pesquisa, perguntar, autor), fontes da pesquisa, modelos e o endereço do provedor sem
+usuário, senha nem parâmetros (nada de chave). Criar pelo chat com documento anexado reescrevendo a maior parte do
+deck grava o mesmo arquivo (origem `chat`); o pedido anterior vai para `anteriores` (10 últimos). Duplicar já copia a
+pasta inteira; o pacote `.sagadeck` agora leva `.sagadeck/geracao.json`.
+Testes: `storage.test.js` (biblioteca com anexo; segredos e `anteriores`), `library-ui.test.js` (pedido guiado
+digitado; só com anexo grava o texto padrão marcado, duplicar e o pacote levam o arquivo, zero erros JS),
+`studio-ai.test.js` (Deck com IA do editor e criação pelo chat com docx). Conferido que falham sem a gravação.
+Falta: PR com CI verde e merge (depois do PR #201, que é a base).
+
+## Modelo para conferir — 22/10/2026 (branch `claude/modelo-por-etapa-d74f41`, parte de `claude/conferir-contas`)
+
+Origem: no ensaio real da conferência das contas, o modelo de texto (deepseek flash) levou 5 a 12 min e uma rodada
+estourou tokens. Um modelo de raciocínio mais forte só nas conferências dá precisão sem encarecer a escrita.
+Feito:
+- `~/.sagadeck/ia.json` ganhou o papel opcional `models.check` (`ROLES` em `src/ai/ia-config.js`); `llmConfig()` dá
+  `checkModel` (variável `SAGADECK_CHECK_MODEL`, senão `models.check`, senão o de texto: nada muda para quem não
+  configurar). O apelido `"check"` resolve para ele em `resolveModel`, como `"vision"`.
+- Usam `model: "check"`: a conferência das contas (`auditBatch` em `math-check.js`), a leitura crítica
+  (`critique.js`) e a confirmação dos achados da revisão visual (`quality.js`; se o modelo de conferir não aceitar
+  imagem, a chamada cai no de visão pelo caminho que já existia). A correção que a conferência pede continua no de
+  texto (é escrita). A checagem de números (`checkNumbers`) não tem chamada de conferência: acha os números no código
+  e pede a correção à escrita, então não mudou.
+- Configurar IA: campo "Modelo para conferir" (largura inteira, com a linha "um modelo de raciocínio mais forte só
+  onde a conta precisa estar certa"). Os campos de modelo continuam texto livre, sem lista do provedor (nenhum tem).
+- `ia-check`: recurso `conferencia` (CLI `--so=conferencia`, MCP, `/api/ia/check`): quando o modelo de conferir é
+  outro que o de texto, uma conta com resposta conhecida, com raciocínio e 4000 tokens; senão, `SEM CONFIG`.
+Testes: `ai.test.js` (contas, leitura crítica e confirmação vão ao de conferir; a correção e a revisão ao de texto;
+sem configurar, tudo ao de texto; falha sem a mudança), `ia-check.test.js`, `library-ui.test.js` (tela grava
+`models.check` no ia.json, reabre mostrando, zero erros JS).
+
+## Conferência das contas — 22/10/2026 (branch `claude/conferir-contas`, worktree `../sagadeck-conferir-contas`)
+
+Origem: deck de aula criado na Oracle (Hidráulica, Aula 5, conta da Mary) saiu com "L₁ ≈ 55 m" num exercício cuja
+resposta o material não trazia; a própria conta escrita no slide dá ≈ 273 m (folga 2,73 m ÷ perda 0,01 m/m). O
+gráfico do slide seguinte nascia desse número e comparava grandezas diferentes. Nenhuma checagem pegou:
+- `unsupportedNumbers` ignorava inteiro de 2 dígitos ("55") e partia o decimal do LaTeX ("9{,}45" → "9", "45");
+- a revisão visual (sem raciocínio) não refaz conta; dois avisos dela eram falsos (slide 11 se contradizia; slide 22
+  dizia que a barra de 120 era menor que a de 12, mas o gráfico renderiza certo, conferido em foto);
+- os 24 avisos ficavam só em `.sagadeck/avaliacao-geracao.json`: o Studio nunca mostrava (ninguém via).
+Feito:
+- Filtro: resultado depois de ≈/\approx/"cerca de" é conferido mesmo pequeno; `{,}` do LaTeX vira um número só.
+- `src/ai/math-check.js`: etapa "Conferindo as contas" na geração (depois da checagem de números) e no chat. A IA
+  escreve cada resultado como fórmula a partir dos dados (sem usar o número do slide); o código calcula com o
+  compilador do `calc` (`src/runtime/formula.js`, sem eval) e compara (casas do slide ou 3%). O que não bate volta
+  para a IA corrigir, junto com os slides que citam o número; confere de novo; o que sobrar vira aviso.
+- Chat: a IA pede a conferência com `contas: [n]` ou `contas: true` (decide pelo prompt, seção CONFERIR AS
+  CONTAS); edição que muda números de slide com conta também é conferida.
+- Relatório da criação grava `facts`, `math`, `coverage` e `avisado`; na primeira abertura os avisos viram mensagem
+  do chat (uma vez) e um toast.
+- Prompt e REFERENCIA: resposta que o material não traz leva `provenance: derivado`; ordem de grandeza por um
+  segundo caminho; gráfico de balanço só compara grandezas da mesma natureza.
+- Revisão: auditor descarta achado que se contradiz e desproporção que os valores do gráfico desmentem.
+Testes: `ai.test.js` (filtro, aritmética, geração corrige e avisa, campo contas), `studio-ai.test.js` (avisos no
+chat e correção pelo chat conferida no deck salvo, zero erros JS), `quality-direction.test.js`, e ao vivo
+(`SAGADECK_LIVE=1`): o modelo real achou 600 s → 240 s e pediu `contas:` sozinho no chat.
+Ensaios com o modelo real no deck da Mary (só em memória, nada gravado) mostraram mais três coisas, já tratadas:
+número que está no material e não fecha (o 2,57 m da lista dela; a conta dá 1,29 m) vai à parte e segue o pedido
+da pessoa ou a autoria (autor: fica no slide com "Confira" nas notes); a correção às vezes esquece o número velho
+num passo (agora diz os campos onde ele aparece e tem segunda rodada); o deck inteiro de uma vez estourava tokens
+(agora lotes de 4 slides, nova tentativa sem raciocínio, lote ruim vira "não conferido"). O 4º ensaio corrigiu
+slides 21 (273 m), 22 (gráfico refeito: 945 cm disponíveis, sobra 273 cm), 26 (tabela) e 30 (resumo); achou também
+erros que ninguém tinha visto (velocidades da tabela do slide 26). A correção pelo chat leva a conversa: "pode
+corrigir o material" da pessoa vale sobre a regra da autoria.
+Suíte completa: `npm test`, 1.108 testes, 1.079 aprovados, 29 condicionais pulados, zero falhas. Studio local na
+3517 rodando `c65772e` a partir desta worktree, para validação dela.
+Falta (depois do ok dela): PR, CI verde, merge, deploy na Oracle (produção estava na 1.9.0) e, no deck da conta da
+Mary, pedir à IA do sagadeck pelo chat que confira e corrija as contas (inclusive as do material: a aula é dela e
+ela autorizou caprichar), corrija os avisos da criação e melhore a aula. A correção é da IA, não à mão.
+
+## UX para programação e APIs com cURL — 12/10/2026 (branch `codex/ux-dev-slides`, versão 1.10.0)
+
+Pedido: reduzir dificuldade de uso, facilitar geração técnica, acrescentar recursos e dois temas bonitos com
+animação; testar, PR, merge, publicar no npm e atualizar sagadeck-dev. Trabalho somente na pasta oficial,
+sem worktrees, conforme AGENTS.md. Main começou limpa em `46e0afd`, com a CI dos quatro ambientes verde.
+
+Diagnóstico: recursos técnicos existiam, mas começar dependia de descobrir layouts, escrever briefing do zero e
+preencher campos estruturados. cURL era exibido sem realce de sintaxe; demos extensas não eram uma base curta.
+Mudanças:
+- Biblioteca com entradas Programação/APIs com cURL; Nova com IA oferece exemplos de pedidos, material técnico
+  colado, público/objetivo/roteiro opcionais, resumo, prévia do pedido e Ctrl+Enter. Intenção explícita orienta o
+  modelo pelo prompt, sem regras de decisão por regex; texto e estilo manual continuam prioritários.
+- Bases sem IA (`src/studio/developer-starters.js`), cinco slides com exemplo consistente, guia, saída e terminal
+  de cenas. Criação pela biblioteca; a de APIs usa ENSAIO e funciona localmente sem credenciais externas.
+- Início/Inserir › Código / cURL: conteúdo colado vira código, código guiado ou requisição de API. Parser de
+  argumentos sem shell e sem executar; opções não suportadas geram mensagem antes de inserir. Credenciais
+  reconhecidas viram referências a Segredos antes de gravar. Código de exibição é preservado literalmente.
+- Etapas guiadas por seleção de linhas, no modal e em Formatar; linguagem inferida/selecionável; realce offline
+  novo de Bash/cURL, JSON e SQL. Anexos de código/configuração preservam espaços, indentação e linhas em branco.
+- `terminal-pro` (grafite/menta, IDE) e `aurora-dev` (azul noite/lilás/ciano, painéis e luz suave): fontes embutidas,
+  contraste de texto/sintaxe, rede de capa que para fora dela e em movimento reduzido/exportação. Design usa o
+  mesmo caminho existente de tema salvo; nenhum deck pessoal modificado.
+
+Regressões cobrem parser, segredos, código literal, etapas e arquivos gravados, prompts ao LLM, anexos técnicos,
+criação sem IA, escolha dos temas por teclado, contraste, animação, movimento reduzido e exportação. Testes
+direcionados de motor/fontes/guards: 85 aprovados; temas e geração passaram também no navegador.
+Geração com IA real também aprovada: briefing técnico aplica Aurora Dev e mantém o cURL original copiável (62 s).
+Revisão independente achou e reproduziu perdas de inteiros grandes ao proteger JSON e de variáveis na codificação
+do formulário: proteção agora edita só spans sensíveis do texto. Interpolação contextual opt-in
+(`request.bodyEncoding`/`urlEncoding`) mantém JSON/form/query corretos no envio; ensaio HTTP real confere `&`, aspas,
+barras, Unicode, números grandes e máscara de respostas/gravações. URL com Segredo agora é enviada já resolvida.
+Callbacks de upload/geração são invalidados ao trocar/cancelar modal; Tab fica no diálogo e Escape devolve foco.
+Essas regressões falharam antes das correções e passaram depois. Suíte completa iniciada com as frentes estáveis.
+Entrega final aguardando suíte completa e CI; publicação de `sagadeck@1.10.0` por release com trusted publishing.
+Oracle: atualizar apenas `/opt/sagadeck-dev`/`sagadeck-dev.service` (3518), preservando produção. Reiniciar também
+a instância local verificada na 3517 e conferir versão/recursos depois da atualização.
+Retomada em 13/10 após limite da sessão. Suíte inicial: 1.084 testes, 1.054 aprovados, 27 condicionais pulados e
+3 falhas (uma de Python ausente no PATH, uma de rótulo e a contagem do teste pai). Python passou isolado com o
+runtime disponível no PATH; a guarda de palavras grudadas agora reconhece o nome técnico cURL sem enfraquecer
+os demais rótulos. A revisão final também cobre execução pelo navegador preservando corpo JSON literal e comandos
+equivalentes copiáveis com segredos em JSON/form/query. Suíte final concluída: `npm test`, 1.093 testes,
+1.066 aprovados, 27 condicionais pulados, zero falhas (24 min). Geradores de cURL/JavaScript/Python também
+enviaram pedidos reais ao ensaio HTTP. Preview e Formatar mantêm JSON literal; respostas/gravações não permitem
+recuperar segredos mesmo em logs com JSON aninhado. Instância local reiniciada na 3517, versão 1.10.0, com os novos
+módulos/CSS respondendo 200. PR #197 publicado; os quatro checks originais Ubuntu/Windows, Node 22/24, passaram.
+Por orientação posterior do usuário, o suporte passa a Node 24+: engines, instruções de instalação e matriz da
+CI atualizados, sem mudança no código já aprovado. YAML e metadados conferidos; a nova CI exige Ubuntu e Windows
+com Node 24 antes de merge/release. DEV da Oracle recebeu `135cfd2`, com versão 1.10.0 e ambos os temas disponíveis;
+produção preservada. A publicação npm ainda aguarda merge e CI do commit final.
+PR #197 integrado em `03f9ff4`; local na 3517 e DEV na 3518 reiniciados com esse commit e versão 1.10.0.
+Os dois checks do PR passaram, mas a nova rodada da main encontrou uma corrida no teste de Formatar: o helper
+confirmava a gravação no servidor antes de o formulário do novo slide terminar de renderizar, lendo o corpo
+do slide anterior. Publicação npm suspensa até corrigir e validar essa sincronização. Correção na branch
+`codex/ux-dev-format-sync`; nenhuma mudança no conteúdo das apresentações nem no código da aplicação.
+Atrasar `api/render-slide` em 400 ms reproduziu exatamente a falha da Ubuntu. O helper agora aguarda a
+identidade do formulário pelo campo Título, além da gravação; a mesma regressão passou após o ajuste.
+Seis testes dirigidos aprovados, zero erros JavaScript e corpos JSON/form conferidos também no arquivo salvo.
+Suíte completa após o ajuste: `npm test`, 1.093 testes, 1.066 aprovados, 27 condicionais pulados e zero falhas
+(30 min). A falha da main ficou restrita a essa sincronização; Windows passou. Correção pronta para commit/PR
+e checks Ubuntu/Windows Node 24 antes de integrar e publicar a versão 1.10.0.
+
+## Assistente em prévia de modelo na Oracle — 12/10/2026
+
+O erro `APP_UNKNOWN · a4670ccb` da produção era `path.dirname(null)` no preparo dos anexos: modelos abertos
+pela vitrine ainda não têm arquivo. O pedido parava antes de chegar ao modelo. Agora o chat só prepara documentos
+em uma pasta existente; documento binário, imagem gerada e edição materializam a cópia com os helpers da biblioteca.
+Conversa simples continua sem criar arquivo. A aba do servidor e o endereço do editor passam a usar essa mesma
+cópia, evitando edição perdida ou segunda cópia no pedido seguinte. Modelo de fábrica e outras pessoas preservados.
+Regressão em `test/studio-ai-preview.test.js`: falhou antes com o erro exato; cobre conversa, edição salva,
+recarregamento no navegador, isolamento por usuário e documento inventariado na pasta pessoal.
+Imagem gerada também é conferida no arquivo e na pasta pessoal. Texto e visão reais passaram nos dois serviços.
+A CI da main apresentou timeout no teclado ao mudar o título logo após abrir o editor no Windows 24; o teste da
+biblioteca agora espera a página terminar de carregar antes de editar, mantendo a conferência do arquivo salvo.
+Validação: npm test com 1.034 testes, 1.008 aprovados, 26 condicionais pulados, zero falhas; quatro regressões novas
+passaram na suíte. O teste da biblioteca com a espera de carregamento passou também isolado (13 testes).
+Entrega: commit da correção para os dois serviços da Oracle após validação local; merge do PR somente com os quatro
+checks verdes (Ubuntu/Windows, Node 22/24). Não há mudança de dependências nem publicação de versão no npm.
+PR #196 publicado. Oracle dev (3518) e produção (3517) receberam o commit `e32a3c1` e reiniciaram; nos dois,
+o pedido real em uma prévia voltou com `mode: llm`, conversa, sem diagnóstico de erro e sem criar cópia.
+Bibliotecas pessoais não foram alteradas. A CI do PR continua sendo acompanhada para concluir o merge.
+Revisão adicional reproduziu perda ao recarregar quando o patch só mudava campos do deck (tema, contexto…) ou
+excluía slides: a lista de slides alterados era vazia e a cópia não nascia. A materialização agora vale para toda
+ação do modelo, preservando conversa e alternativas em prévia. Regressão confere tema salvo, exclusão e demais
+slides preservados; falhou antes da correção.
+Suíte completa após esse ajuste: 1.035 testes, 1.009 aprovados, 26 condicionais pulados e zero falhas.
+Os cinco testes de prévia passaram; nova CI será exigida para o commit final antes do merge do PR #196.
+Oracle dev e produção receberam também `333857f`: conversa real e mudança de tema pelo modelo funcionaram;
+o tema permaneceu ao reabrir o arquivo pelas APIs nativas. Apresentações sintéticas removidas pela biblioteca.
+A CI aprovou Ubuntu 22/24 e Windows 22. Windows 24 teve timeout na galeria; o teste isolado passou (3/3) e a
+reexecução aprovou o carrossel, mas encontrou `ERR_NO_BUFFER_SPACE` durante exportação. Isso indica pressão de
+recursos de rede no runner; a faixa TCP dinâmica agora é ampliada somente nas máquinas descartáveis da CI,
+com diagnóstico de estados TCP em falhas. Testes e exigência de zero erros de navegador preservados.
+Código da aplicação permanece o mesmo da suíte local completa aprovada (1.009/26/0); ajuste de CI validado como
+YAML, e os quatro ambientes serão novamente conferidos antes do merge.
+
+## Sobre legível no tema escuro — 12/10/2026 (branch `sobre-tema-escuro`)
+
+Narumi (com print): no Windows e no dev da Oracle o Sobre "não abre direito", com texto apagado. Causa: o CSS do
+`about.js` pegava o fundo de `--panel`/`--bg`, que nenhuma página define (caía no branco), e o texto de `--text`,
+que no tema escuro é claro, o que dava contraste 1,16. Agora fundo, borda e botão vêm de `--chrome`, `--ui-line` e
+`--brand-fill`, que o editor (style.css/studio-next.css) e a biblioteca (library.css) definem nos dois temas. Teste
+novo em `test/sobre.test.js`: contraste WCAG mínimo de 4,5 do texto contra o fundo da janela, nos temas claro e
+escuro, no editor e na biblioteca. Ele falha com o CSS antigo.
+
+## Ajuda › Sobre o SagaDeck — 12/10/2026 (branch `ajuda-sobre`)
+
+Narumi: "insira um help com about no menu onde eu posso ver a versão". A aba **Ajuda** fecha a faixa do editor
+(depois de Avançado, como no PowerPoint) com Sobre o SagaDeck, O que mudou (CHANGELOG) e Demos. O Sobre
+(`src/studio/public/about.js`, `window.SagaAbout`; qualquer elemento com `data-about` abre) mostra a versão em
+destaque, commit, Node e sistema (novos em `/api/instance`), desde quando está no ar, a biblioteca (no multiusuário,
+só que é do servidor) e se a IA está configurada, com Copiar informações para suporte. Na biblioteca, um botão com o
+ícone de informação no alto. Achados de passagem: o `dialog` nativo abria colado no canto (uma regra global zerava
+a margem; o Sobre põe `margin:auto`) e botão da faixa que é link (`a.rbtn`) saía sublinhado. Teste:
+`test/sobre.test.js`; a ordem da faixa em `studio.test.js`.
+
 ## `sagadeck ia-check`: o que de IA funciona, sem tela — 12/10/2026 (branch `ia-check`)
 
 Narumi: "o sagadeck está preparado para ser testado por um agente de IA (tipo o Copilot) sem o front-end?

package/docs/REFERENCIA.md

@@ -15,7 +15,7 @@ Mídia paga não é proibida por padrão. Quando for apropriada, proponha seu us
 ```yaml
 title: Nome da palestra          # obrigatório (vira rodapé e título da janela)
 author: Seu Nome · Cargo
-theme: sinal                     # sinal | editorial | noite | bauhaus | terminal | jornal | rabisco | oceano | pop | aurora | prata | aluminio | arcade | relevo | musgo | wine | caderno | lousa | cartaz | infografico (ou customizado, ver fim)
+theme: sinal                     # sinal | editorial | noite | bauhaus | terminal | terminal-pro | jornal | rabisco | oceano | pop | aurora | aurora-dev | prata | aluminio | arcade | relevo | musgo | wine | caderno | lousa | cartaz | infografico (ou customizado, ver fim)
 palette: floresta                # opcional: só as cores, vale em qualquer tema (ver "Temas e paletas"); sem ela, as cores do tema
 duration: 50                     # minutos — o modo apresentador mostra se você está adiantado/atrasado
 event: Summit de Dados 2026       # opcional — para {evento} no rodapé/cabeçalho
@@ -132,7 +132,7 @@ Tabela em markdown no meio de um texto (`problem`, `body`, `text`, passo do `sol
 
 ### Cenas interativas para ensinar
 
-`codewalk` mantém o código estável e revela a explicação, o destaque de linhas e uma saída esperada por etapa. O código e os comandos cURL são texto; não há execução. No Studio, a linguagem é inferida pela extensão do arquivo e pode ser escolhida no menu: Python (`.py`), Java (`.java`), JavaScript (`.js`, `.jsx`, `.mjs`, `.cjs`), TypeScript (`.ts`, `.tsx`, `.mts`, `.cts`) ou C# (`.cs`). Node.js é um runtime de JavaScript, não uma linguagem separada; arquivos Node usam a opção JavaScript. A apresentação aplica realce sintático a essas cinco linguagens sem depender de serviços externos. Use as setas da apresentação ou os botões numerados. Depois da última etapa, a seta avança ao slide seguinte. As etapas também aparecem corretamente na prévia do apresentador e são restauradas pelo endereço da apresentação.
+`codewalk` mantém o código estável e revela a explicação, o destaque de linhas e uma saída esperada por etapa. O código e os comandos cURL são texto; não há execução. No Studio, a linguagem é inferida pela extensão do arquivo e pode ser escolhida no menu: Python, Java, JavaScript, TypeScript, C#, Bash/cURL, JSON ou SQL. Node.js é um runtime de JavaScript, não uma linguagem separada; arquivos Node usam a opção JavaScript. A apresentação aplica realce sintático a essas oito linguagens sem depender de serviços externos. Use as setas da apresentação ou os botões numerados. Depois da última etapa, a seta avança ao slide seguinte. As etapas também aparecem corretamente na prévia do apresentador e são restauradas pelo endereço da apresentação.
 
 ```yaml
 - layout: codewalk
@@ -172,6 +172,46 @@ O cabeçalho do deck aceita `fit: { minCodePt, minTextPt, wrapCode }`: até onde
 
 O cabeçalho do deck aceita `motion: none | subtle | expressive` (padrão `subtle`; no Studio, menu **Apresentar ▾ › Animações**: Sem animação, Suaves, Expressivas). A preferência do sistema por movimento reduzido tem prioridade. A intensidade muda a animação; os controles e revelações continuam funcionando.
 
+## Criar apresentações de programação e APIs no Studio
+
+Na biblioteca, **Programação** e **APIs com cURL** abrem a criação com IA já orientada ao assunto. A pessoa pode
+escrever livremente, usar um exemplo de pedido, colar código/comando/resposta ou anexar arquivos técnicos. Público,
+objetivo e roteiro são opcionais. A prévia mostra o pedido completo antes de gerar; Ctrl+Enter inicia a geração.
+O tema sugerido é `terminal-pro` para programação e `aurora-dev` para APIs; uma escolha manual de estilo prevalece.
+Essas escolhas orientam o modelo pelo prompt, sem impor uma sequência fixa de layouts.
+
+**Começar com um exemplo, sem IA** cria uma base editável de cinco slides na biblioteca, com exemplo consistente,
+código guiado, saída e capa com terminal animado. Programação inclui um diagrama do fluxo. APIs inclui uma chamada
+POST ao ambiente `ensaio`, que funciona no Studio local sem configurar credenciais. No servidor multiusuário,
+chamadas de API seguem o modo de gravação existente. Cada uso cria uma apresentação independente.
+
+**Inserir › Código / cURL** aceita conteúdo colado e oferece código para mostrar, código guiado por etapas ou
+requisição de API a partir de cURL. O importador lê os argumentos sem abrir um shell e sem executar a chamada.
+Nos guias, selecionar linhas e adicionar uma etapa cria o destaque, com explicação e saída ilustrativa editáveis;
+o painel Formatar também oferece essa ação. Código de exibição e guia não são executados.
+
+A importação de cURL aceita método/URL, cabeçalhos, corpo literal/JSON, consulta com `-G` e `--data-urlencode`,
+aspas e continuação de linha. Credenciais reconhecidas em cabeçalhos, consulta ou corpo são substituídas por
+`{{secret.nome}}`; a prévia informa os nomes para cadastrar em Ambientes. Os demais bytes do JSON, inclusive números
+grandes e formatação, são preservados. Variáveis existentes `{{nome}}` continuam referenciadas. Opções sem equivalente
+no executor, como `-L`, `-k`, multipart `-F`, corpo vindo de arquivo `@` e substituição de shell, geram um erro claro;
+para apenas exibir o comando completo, escolha Código no slide.
+
+O importador acrescenta `request.bodyEncoding: json | urlencoded` e `request.urlEncoding: query` quando apropriado.
+Esses campos preservam o escape dos valores interpolados no corpo e nos parâmetros da URL, primeiro com variáveis
+e depois com Segredos, inclusive aspas, Unicode e `&`. O restante do corpo literal permanece intacto. Não é preciso
+configurá-los no formulário. Pedidos existentes sem esses campos mantêm a interpolação anterior.
+Os exemplos copiáveis de cURL, JavaScript e Python respeitam esses mesmos escapes. O cURL simples continua curto;
+quando um Segredo precisa ser escapado em JSON/form/query, o exemplo Bash inclui um pequeno helper Node.js e indica
+essa dependência no próprio comando. Literais como `$HOME` continuam literais quando vieram assim no cURL original.
+
+Além de Python, Java, JavaScript, TypeScript e C#, o realce offline aceita **Bash** (`.sh`, `.bash`; aliases `shell`,
+`sh`, `curl`), **JSON** (`.json`, `.jsonc`) e **SQL** (`.sql`). Bash destaca comandos, opções e variáveis; JSON,
+chaves e valores; SQL, palavras-chave sem exigir maiúsculas. O conteúdo continua copiável, com indentação e linhas
+preservadas. Anexos de código (`js`, `ts`, `py`, `sh`, `http`, `sql`, `go`, `rs`, `java`, `cs` e outros) entram como
+material de contexto sem remover espaços ou linhas em branco. Saídas simuladas devem ser identificadas como exemplos;
+nunca afirme execução sem evidência nem invente endpoints ou resultados reais.
+
 ## Screenshots com destaques no Studio
 
 Em **Início → Screenshot**, cole (Ctrl+V), arraste ou escolha uma imagem PNG, JPEG ou WebP de até 8 MB.
@@ -528,7 +568,7 @@ aparecem (`showValues: true` força os valores).
 **SVG próprio**: `{ svg: "<svg viewBox='0 0 100 100'>…</svg>" }` — use `style="fill:var(--fg)"`, `var(--hi)`, `var(--em)` para seguir o tema.
 **Imagem**: `{ image: foto.jpg, fit: cover }` (caminho relativo ao YAML; é embutida no HTML). Sem `fit`, a imagem preenche a caixa, mas cabe inteira (`contain`) quando o corte passaria de 20% (gráfico com eixo e legenda na borda, esquema largo numa coluna alta); solta no fluxo (num `add`) e sem altura, não passa de 420 px. Para foto que pode ser cortada, `fit: cover`; para gráfico, `fit: contain`.
 **Imagem gerada por IA**: `{ image_prompt: "descrição visual, em inglês", fit: cover }` (sai sem texto: rótulos, números e títulos vão no slide; se a ilustração precisa de rótulos dentro dela, diga quais no prompt, em português e entre aspas: `with labels "Divisor de água", "Rio"`) — `sagadeck imagens deck.yaml` gera o arquivo em `imagens/` com o modelo de imagem e troca por `image:`.
-**Redesenhar uma figura do deck** (xerox, escaneada, borrada): `{ image_prompt: "Clean up and redraw THIS EXACT figure… (o que ela mostra, as cores)", image_ref: imagens/original/mapa.png, fit: contain }` — o modelo de imagem recebe a figura como base e devolve o redesenho; se não sair, fica a figura de base. Depois do redesenho, o elemento guarda a figura de base em `original` (ex.: `{ image: imagens/ia-1a2b.png, original: contexto/visuais/…/fig.png, fit: contain }`). Figura de documento anexado (PDF) traz no inventário `sourcePx` (tamanho nativo da imagem): esquema de caixas e setas borrado vira `diagram` nativo fiel; gráfico com os valores no paper vira `chart` nativo com os números exatos; gráfico sem os dados à mão e ilustração podem ser redesenhados assim; mapa e foto ficam. Reconstrução nativa de figura do documento leva no slide `sourceFigure: contexto/visuais/…/fig.png`. **Origem do conteúdo** (deck com material anexado): cada slide de conteúdo leva `provenance: material` (o que afirma está no material), `provenance: derivado` (reorganização, cálculo ou gráfico feito a partir dos números do material) ou `provenance: proprio` (inclusão da IA: contexto, analogia, exemplo, crítica), com `provenanceNote` curta quando não for `material`; o Studio mostra um selo na miniatura, a apresentação não. O deck grava `context.autoria`: `autor` (a pessoa apresenta o próprio trabalho: fiel ao material, crítica e perguntas prováveis nas notes) ou `livre` (aula, resenha, journal club, divulgação, tema geral: conteúdo próprio liberado, marcado). A **leitura crítica** do material (inconsistências, achados escondidos, perguntas prováveis, limitações, slide que representa mal o material, cada item com trecho literal conferido) fica em `.sagadeck/leitura-critica.json` e acompanha os pedidos ao chat. **Voltar ao original** ("mantenha a figura original", "volte para o gráfico do paper"): o visual do slide vira `figure: { image: <sourceFigure ou original>, fit: contain }`, sem mexer no texto. Números que o paper só dá no texto ou em tabela podem virar `chart` criado pela IA, com os valores exatos e `source` dizendo de onde vieram. Equação com `latex` no inventário vai como fórmula nativa (`math`, `equations`), nunca como o recorte.
+**Redesenhar uma figura do deck** (xerox, escaneada, borrada): `{ image_prompt: "Clean up and redraw THIS EXACT figure… (o que ela mostra, as cores)", image_ref: imagens/original/mapa.png, fit: contain }` — o modelo de imagem recebe a figura como base e devolve o redesenho; se não sair, fica a figura de base. Depois do redesenho, o elemento guarda a figura de base em `original` (ex.: `{ image: imagens/ia-1a2b.png, original: contexto/visuais/…/fig.png, fit: contain }`). Figura de documento anexado (PDF) traz no inventário `sourcePx` (tamanho nativo da imagem): esquema de caixas e setas borrado vira `diagram` nativo fiel; gráfico com os valores no paper vira `chart` nativo com os números exatos; gráfico sem os dados à mão e ilustração podem ser redesenhados assim; mapa e foto ficam. Reconstrução nativa de figura do documento leva no slide `sourceFigure: contexto/visuais/…/fig.png`. **Origem do conteúdo** (deck com material anexado): cada slide de conteúdo leva `provenance: material` (o que afirma está no material), `provenance: derivado` (reorganização, cálculo ou gráfico feito a partir dos números do material) ou `provenance: proprio` (inclusão da IA: contexto, analogia, exemplo, crítica), com `provenanceNote` curta quando não for `material`; o Studio mostra um selo na miniatura, a apresentação não. O deck grava `context.autoria`: `autor` (a pessoa apresenta o próprio trabalho: fiel ao material, crítica e perguntas prováveis nas notes) ou `livre` (aula, resenha, journal club, divulgação, tema geral: conteúdo próprio liberado, marcado). A **leitura crítica** do material (inconsistências, inclusive conta do material que não fecha com os próprios dados, achados escondidos, perguntas prováveis, limitações, slide que representa mal o material, cada item com trecho literal conferido) fica em `.sagadeck/leitura-critica.json` e acompanha os pedidos ao chat. **Voltar ao original** ("mantenha a figura original", "volte para o gráfico do paper"): o visual do slide vira `figure: { image: <sourceFigure ou original>, fit: contain }`, sem mexer no texto. Números que o paper só dá no texto ou em tabela podem virar `chart` criado pela IA, com os valores exatos e `source` dizendo de onde vieram. Equação com `latex` no inventário vai como fórmula nativa (`math`, `equations`), nunca como o recorte.
 
 ## Notas / roteiro (`notes`)
 
@@ -547,6 +587,12 @@ Linhas que começam com PALAVRAS EM MAIÚSCULAS seguidas de `:` viram etiquetas
 
 ## Temas e paletas
 
+Temas de desenvolvimento: `terminal-pro` usa grafite, menta e azul, títulos alinhados à esquerda, rótulos
+monoespaçados e janelas de código; `aurora-dev` usa azul noite, lilás e ciano, luz suave e painéis arredondados.
+Ambos usam Space Grotesk e IBM Plex Mono embutidas, código sem ligaduras e cores de sintaxe com contraste de leitura.
+A rede ambiente da capa anima enquanto ela está ativa; `ambient: false` remove o efeito. Movimento reduzido,
+`motion: none` e exportação deixam a rede estática, com código e explicações legíveis.
+
 Como no PowerPoint, são duas escolhas independentes:
 
 - **Tema** (`theme`): fontes, raio das bordas, textura e uma **pele** própria que rearruma capa, seção e encerramento, muda o jeito dos slides de conteúdo (título, cartões, marcadores da lista, citação, número grande, frase) e põe ornamentos (`sinal`: faixa zebrada e selo no chapéu; `editorial`: fios e capa centralizada; `noite`: moldura fina; `bauhaus`: círculo, quadrado e triângulo; `terminal`: janela com barra e prompt; `jornal`: fios de jornal e manchete sublinhada; `rabisco`: fitas adesivas e títulos inclinados; `oceano`: ondas e chapéu em pílula; `pop`: adesivos e sombra chapada; `aurora`: brilhos e traço em gradiente; `prata`: limpo e centralizado; `relevo`: ficção científica sóbria (sala de controle de filme, sem néon): grafite profundo, curvas de nível ao fundo, cantoneiras de mira, título leve embaixo à esquerda, rótulos técnicos em monoespaçada; combina com ilustração 3D realista (terreno, cidade, água) e gráfico 3D (`science` com superfície); `arcade`: videogame e fliperama, tela de tubo com linhas de varredura, neon, título em pixel no meio e chão de tijolos de jogo de plataforma; `aluminio`: prata metálico de lançamento de aparelho premium, título cromado embaixo à esquerda e um disco de metal polido; `wine`: o `musgo` em vinho (mesmo arranjo, fontes, faixa e rede na capa): fundo vinho quase preto, vermelho-rosado e rosé, com o vermelho forte só no detalhe; `caderno`: visual thinking em papel claro — título em letra de mão alta (Amatic SC) com traço de lápis, chapéu coral em serifada (Gelasio), frase em lilás, rabiscos de ícones em pastel nos cantos (lupa, ampulheta, engrenagem, lápis, chave, lâmpada); `lousa`: quadro-negro verde com giz — título em giz amarelo (Cabin Sketch) com traço laranja, linha de giz sob o título, poeira e marcas de giz apagado, lâmpada e lápis de giz na capa; `cartaz`: cartaz de protesto em papel cinza com grão — condensada pesada (Bebas Neue) em faixa vermelha torta, chapéu como etiqueta amarela, moldura preta grossa na capa, número da seção num disco amarelo; `infografico`: dados chapados — capa azul com chão verde e nuvem, títulos em maiúsculas, chapéu numa tarja verde, números enormes em condensada; `musgo`: laboratório noturno de bom gosto (verde-musgo quase preto, âmbar e sálvia, serifada Fraunces com o destaque do título em âmbar itálico, rótulos em IBM Plex Mono com fio âmbar, texto em Space Grotesk): grade de pontos que some nas bordas e luz âmbar na capa, seção como separador com o número entre fios na linha do chapéu e o título grande embaixo, e a faixa que corre no pé da capa com os títulos das seções (`ticker`); combina com o terminal de cenas (`motion: {type: console}`) na figura da capa ou num `canvas`; `manual` e `manual-noite`: documentação técnica, sem ornamento, código e texto corrido legíveis — o par claro/escuro do mesmo arranjo, para material de consulta, tutorial e apostila: `manual` imprime bem, `manual-noite` descansa a vista). Nos slides de conteúdo: `sinal` barra de aviso e placas; `editorial` fios finos e citação centralizada; `noite` tudo centralizado e cartões vazados; `bauhaus` faixas de cor primária e círculos; `terminal` título como comando e cartões-janela; `jornal` fios duplos e colunas; `oceano` cartões flutuando e balões; `pop` contorno grosso e sombra dura; `prata` centralizado e sem caixa; `aluminio` cartões de alumínio com chanfro de luz; `relevo` painéis de vidro fosco com traço gelo; `arcade` cartões de 8 bits com borda de pixel e sombra dura; `rabisco` tracejados e números circulados; `aurora` vidro com brilho; `caderno` cartões brancos com moldura grossa pastel (menta, lilás, amarelo, coral) e marcador amarelo contornado; `lousa` cartões contornados a giz com borda torta e marcadores em pingo de giz; `cartaz` cartões brancos girados como fotos coladas, números de lista em etiqueta e destaque em vermelho; `infografico` cartões com a faixa da cor do grupo, números em cartões coloridos e números de lista em círculos coloridos; `musgo`/`wine` cartões vazados que sobem no mouse, números em monoespaçada âmbar, marcador em losango, código em janela com três bolinhas e botões âmbar. Trocar o tema já muda o arranjo: não reescreva slides só para "combinar" com o tema.
@@ -723,7 +769,26 @@ Tabela é tabela, nunca imagem: dados de um livro ou de um PowerPoint que vieram
 
 ## Aula: exercício resolvido, calculadora ao vivo, algoritmo animado (`solution`, `calc`, `algo`)
 
-**`solution` — exercício resolvido passo a passo.** À esquerda, `problem` (enunciado), `givens` (dados: `{symbol, value, unit, label}` ou `{latex, label}`; vírgula decimal pode) e `find` (o que se pede, LaTeX). À direita, a conta: o primeiro quadro pergunta `prompt` (padrão "Por onde você começaria?"); cada clique revela o próximo `steps: [{text, latex, note}]` (os anteriores ficam compactos); o último mostra `answer: {latex, text, label}` em destaque. Mantenha cada passo curto (uma ideia, uma linha de conta); de 3 a 6 passos. Use para qualquer matéria com conta: física, engenharia, finanças, estatística.
+**`solution` — exercício resolvido passo a passo.** À esquerda, `problem` (enunciado), `givens` (dados: `{symbol, value, unit, label}` ou `{latex, label}`; vírgula decimal pode) e `find` (o que se pede, LaTeX). À direita, a conta: o primeiro quadro pergunta `prompt` (padrão "Por onde você começaria?"); cada clique revela o próximo `steps: [{text, latex, note}]` (os anteriores ficam compactos); o último mostra `answer: {latex, text, label}` em destaque. Mantenha cada passo curto (uma ideia, uma linha de conta); de 3 a 6 passos. Use para qualquer matéria com conta: física, engenharia, finanças, estatística. Resposta que o material não traz é cálculo da IA: o slide leva `provenance: derivado` com `provenanceNote` ("resposta calculada pela IA"). Toda conta do deck passa pela **conferência das contas**: a IA escreve cada resultado como fórmula a partir dos dados e o sagadeck calcula (o mesmo compilador do `calc`, convertendo as unidades: L/s e m³/s, cm e m) e compara com o slide (vale a conta nos números dados ou com a conversão: só é divergência o que não bate de jeito nenhum); o que não bate volta para correção e o que sobrar vira aviso. No chat, `contas: [n]` (ou `contas: true`) pede essa conferência. O que as checagens automáticas deixam pendente (contas que não batem, contas do material que não fecham, números sem base no material, avisos da revisão visual, figuras do material sem slide, slides `derivado`/`proprio`) fica no painel **Revisar › Conferência** do Studio, por slide, com Corrigir com IA e Ignorar; a lista do que está pendente acompanha os pedidos ao chat (PENDÊNCIAS DA CONFERÊNCIA AUTOMÁTICA), e o que a pessoa ignorou sai dela.
+
+**Contas calculadas pelo sagadeck (`fn`) — prefira sempre que o exercício tem conta.** Não escreva o resultado à mão: escreva a fórmula e deixe o sagadeck calcular. Cada dado com `symbol` e `value` numérico vira uma variável (o nome vem do símbolo: `L_1` → `L1`, `\rho` → `rho`, `h_f` → `hf`; ou dê `name`). Cada passo pode ter `fn` (fórmula em texto, as mesmas regras do `calc`: `C*(1+i)^n`, `sqrt(2*g*h)`, `(D/f)*(2*g/v^2)*hd`), `name` (para os passos seguintes usarem o resultado), `unit` e `decimals` (casas; sem ele, 4 algarismos). O valor entra no fim do LaTeX do passo (`latex: "L_1 = \frac{D}{f}\cdot\frac{2g}{v^2}\cdot h"` sai `… ≈ 272,9 m`), ou onde estiver `{{nome}}`; passo só com `fn` mostra `nome = valor`. `{{nome}}` vale também nos textos, na `answer` (`latex: "L_1 \approx {{L1}}\ \mathrm{m}"`, `text: "cabem uns {{L1:0}} m de tubo"`) e no enunciado; `{{expressão:casas}}` faz uma conta curta (`{{(M/C - 1)*100:0}}%`). Vírgula decimal e milhar saem sozinhos. Fórmula com erro ou letra sem valor aparece no slide como aviso, com o motivo. A resposta pode ter `fn` também. `interactive: true` põe um controle em cada dado: a pessoa muda um dado na apresentação e todos os passos e a resposta recalculam (`min`/`max`/`step` no dado ajustam o controle; sem eles, de um décimo a dez vezes o valor). Passo sem `fn` continua como sempre (fórmula escrita, sem conta). A conferência das contas só refaz o que foi escrito à mão.
+
+```yaml
+- layout: solution
+  title: Até onde o sifão alcança?
+  givens:
+    - { symbol: D, value: "0,3", unit: m, label: diâmetro }
+    - { symbol: f, value: "0,026", label: fator de atrito }
+    - { symbol: g, value: "9,81", unit: m/s², label: gravidade }
+    - { symbol: v, value: "1,5", unit: m/s, label: velocidade }
+    - { symbol: h, value: "2,73", unit: m, label: carga disponível }
+  find: L_1
+  steps:
+    - { text: Perda por metro de tubo, latex: "J = \\frac{f}{D}\\cdot\\frac{v^2}{2g}", fn: "f/D*v^2/(2*g)", name: J, decimals: 4 }
+    - { text: Comprimento que a carga paga, latex: "L_1 = \\frac{h}{J}", fn: "h/J", name: L1, unit: m, decimals: 1 }
+  answer: { latex: "L_1 \\approx {{L1}}\\ \\mathrm{m}", text: "Cabem cerca de {{L1:0}} m de tubo." }
+  interactive: true
+```
 
 **`calc` — calculadora ao vivo.** `inputs: { nome: {label, value, min, max, step, unit, latex, decimals} }` viram controles deslizantes (`fixed: true` = constante, mostrada com `latex`). `outputs: [{name, label, fn, latex, unit, decimals}]` são calculados na ordem (um usa os anteriores e as entradas pelo nome, inclusive nomes longos como `nu`, `eps`); `fn` é fórmula em texto (as mesmas regras de `plot.functions`: `V*D/nu`, `0.25/(log10(eps/(3.7*D) + 5.74/Re^0.9))^2`; `log` e `log10` são base 10, `ln` é natural). Faixas: `of: Re, cases: [{below: 2300, text: Laminar, color: s3}, {below: 4000, text: Transição, color: em}, {text: Turbulento, color: hi}]` — mostra o selo da faixa; cada faixa pode ter a sua `fn` (f = 64/Re abaixo de 2300, outra acima). `scale: {min, max, log}` desenha a régua com as faixas e o ponteiro. Tudo recalcula enquanto a pessoa arrasta; PDF mostra os valores iniciais.
 
@@ -1181,6 +1246,9 @@ cada resultado sai assim que chega:
   aceita imagem falha, em vez de responder sem ver);
 - **imagem**: gera uma imagem pequena e confere que voltou PNG, JPEG, WebP ou GIF (grava o arquivo e diz onde);
 - **pesquisa**: o modelo de pesquisa precisa dizer a data de hoje;
+- **conferência**: quando há um **modelo para conferir** em Configurar IA (outro que o de texto; é o das contas, da
+  leitura crítica e da confirmação da revisão visual), uma conta pequena com resposta conhecida, com raciocínio; sem
+  ele, as conferências usam o modelo de texto e sai `SEM CONFIG`;
 - **vídeo**: sem `--video-real`, só confere o modelo no catálogo, de graça, e sai `SEM PROVA`; com `--video-real`,
   gera o clipe mais curto e leve que o modelo aceita, acompanha, baixa e confere o MP4 (cobrado; leva minutos).
 

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "sagadeck",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "description": "Gerador de apresentações: YAML -> HTML animado + PowerPoint editável, com temas e figuras geradas na hora.",
   "type": "module",
   "bin": {
     "sagadeck": "bin/sagadeck.js"
   },
   "engines": {
-    "node": ">=22.13.0"
+    "node": ">=24.0.0"
   },
   "license": "MIT",
   "homepage": "https://github.com/naruminho/sagadeck#readme",
@@ -29,7 +29,7 @@
   ],
   "dependencies": {
     "jszip": "^3.10.2",
-    "katex": "^0.18.9",
+    "katex": "^0.19.0",
     "lucide-static": "^1.47.0",
     "pdfjs-dist": "^6.3.289",
     "playwright-core": "^1.63.0",
@@ -65,7 +65,7 @@
     "jsqr": "^1.4.0",
     "leaflet": "1.9.4",
     "maplibre-gl": "6.13.0",
-    "mermaid": "^11.17.2"
+    "mermaid": "^12.1.0"
   },
   "scripts": {
     "dev": "node bin/sagadeck.js studio",

package/src/ai/context.js

@@ -23,7 +23,12 @@ export async function extractDocText(name, buf) {
   if (buf.length > UPLOAD_MAX_BYTES) throw new Error(`Arquivo grande demais (${(buf.length / 1048576).toFixed(1)} MB, limite 15 MB).`);
   const ext = (String(name).match(/\.([a-z0-9]+)$/i)?.[1] || "").toLowerCase();
   if(ext==='doc')return {...await extractDocText('converted.docx',await convertLegacyWord(buf)),detail:'doc (convertido para docx)'};
-  if (["txt", "md", "markdown", "csv", "json", "yaml", "yml"].includes(ext)) {
+  // Código é material da pessoa: espaços e linhas podem fazer parte de strings ou da sintaxe.
+  if (["js", "mjs", "cjs", "ts", "tsx", "jsx", "py", "sh", "bash", "ps1", "http", "sql", "go", "rs", "java", "c", "cpp", "h", "cs", "rb", "php", "html", "css"].includes(ext)) {
+    return { text: buf.toString("utf8"), detail: `código (.${ext})` };
+  }
+  if (["json", "jsonc", "yaml", "yml"].includes(ext)) return { text: buf.toString("utf8"), detail: "texto" };
+  if (["txt", "md", "markdown", "csv"].includes(ext)) {
     return { text: clean(buf.toString("utf8")), detail: "texto" };
   }
   if (ext === "docx") {
@@ -74,7 +79,7 @@ export async function extractDocText(name, buf) {
     return { text: clean(parts.join("\n\n")), detail: `xlsx (${sheets.length} planilha(s))` };
   }
   if (ext === "pdf") return pdfText(buf);
-  throw new Error(`Tipo não suportado${ext ? ` (.${ext})` : ""}: vale txt, md, csv, docx, xlsx, pptx e pdf.`);
+  throw new Error(`Tipo não suportado${ext ? ` (.${ext})` : ""}: anexe texto, código (js, ts, py, sh, http, sql e outros), docx, xlsx, pptx ou pdf.`);
 }
 
 async function pdfText(buf) {