sagadeck 1.10.0 → 1.11.0

package/src/studio/generation-report.js

@@ -1,10 +1,70 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { mathWarning } from '../ai/math-check.js';
+import { renameRetry } from '../fs-retry.js';
+
+// Relatório da criação com IA (.sagadeck/avaliacao-geracao.json): revisão visual, variedade, números sem base no
+// material, contas e figuras de fora. `avisado` diz se a pessoa já viu os avisos no chat (generationNotice).
+const reportFile = (dir) => path.join(dir, '.sagadeck', 'avaliacao-geracao.json');
+
+export function loadGenReport(dir) {
+  if (!dir) return null;
+  try { return JSON.parse(fs.readFileSync(reportFile(dir), 'utf8')); } catch { return null; }
+}
+
+// grava inteiro (tmp + rename): o painel Conferência e o chat mexem no mesmo arquivo
+export function writeGenReport(dir, report) {
+  const file = reportFile(dir), tmp = `${file}.tmp-${process.pid}`;
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.writeFileSync(tmp, JSON.stringify(report, null, 2), 'utf8');
+  renameRetry(tmp, file);
+}
+
+// impressão digital de um slide (o que ele mostra, sem uid nem marcas do Studio): o aviso da revisão visual vale para
+// o slide como ele era; mudou, o painel avisa que o aviso pode estar velho
+export function slideMark(slide) {
+  const s = JSON.stringify({ ...slide, uid: undefined, auto: undefined, review: undefined });
+  let h = 5381; for (const c of s) h = ((h << 5) + h + c.codePointAt(0)) >>> 0;
+  return h.toString(36);
+}
+// marcas por slide: pelo uid (sobrevive a inserir e apagar slides) e, sem uid, pela posição
+export const slideMarks = (spec) => Object.fromEntries((spec?.slides || []).map((s, i) => [s?.uid || `#${i + 1}`, slideMark(s)]));
 
 export function saveGenReport(dir, generation) {
   const reportDir = path.join(dir, '.sagadeck');
   fs.mkdirSync(reportDir, { recursive: true });
-  fs.writeFileSync(path.join(reportDir, 'avaliacao-geracao.json'), JSON.stringify({
+  fs.writeFileSync(reportFile(dir), JSON.stringify({
     createdAt: new Date().toISOString(), quality: generation.quality, variety: generation.variety,
+    ...(generation.spec ? { slideMarks: slideMarks(generation.spec) } : {}),
+    ...(generation.facts ? { facts: generation.facts } : {}), ...(generation.math ? { math: generation.math } : {}),
+    ...(generation.coverage ? { coverage: generation.coverage } : {}), avisado: false,
   }, null, 2), 'utf8');
 }
+
+// Os avisos que a conferência automática deixou sem resolver, como texto para a pessoa
+export function generationWarnings(report) {
+  const out = [];
+  const m = mathWarning(report?.math);
+  if (m) out.push(m);
+  const facts = report?.facts?.unsupported || [];
+  if (facts.length) out.push(`Números sem base no material: ${facts.map((b) => `${b.number} (slide ${b.slide})`).join(', ')}`);
+  const missing = report?.coverage?.missing || [];
+  if (missing.length) out.push(`Figuras e tabelas do material sem slide: ${missing.join('; ')}`);
+  const issues = report?.quality?.issues || [];
+  for (const i of issues.slice(0, 12)) out.push(`Slide ${i.slide}: ${String(i.text).slice(0, 240)}`);
+  if (issues.length > 12) out.push(`… e mais ${issues.length - 12} aviso(s) da revisão visual.`);
+  return out;
+}
+
+// Na primeira vez que a apresentação abre depois da criação, os avisos viram uma mensagem do chat (uma vez só):
+// antes eles ficavam só no arquivo, e ninguém via que a revisão tinha reclamado.
+export function generationNotice(dir) {
+  if (!dir) return null;
+  let report;
+  try { report = JSON.parse(fs.readFileSync(reportFile(dir), 'utf8')); } catch { return null; }
+  if (report.avisado) return null;
+  const warnings = generationWarnings(report);
+  try { fs.writeFileSync(reportFile(dir), JSON.stringify({ ...report, avisado: true }, null, 2), 'utf8'); } catch { return null; }
+  if (!warnings.length) return null;
+  return `A conferência automática da criação desta apresentação deixou estes avisos sem resolver:\n${warnings.map((w) => `- ${w}`).join('\n')}\nPeça "corrija os avisos da criação" para eu tentar de novo, ou ajuste à mão.`;
+}

package/src/studio/generation-request.js

@@ -0,0 +1,80 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { llmConfig } from '../ai/llm.js';
+import { loadPreferences } from '../preferences.js';
+import { renameRetry } from '../fs-retry.js';
+
+// O pedido que originou a apresentação (.sagadeck/geracao.json), para dar para auditar depois: foi um prompt ou um
+// material? o que a pessoa pediu? Grava o briefing exatamente como foi para a IA (e se era o texto padrão da tela),
+// a resposta à pergunta da IA, duração, estilo, os anexos (nome, tipo, tamanho, onde ficaram em contexto/), as
+// Preferências que mudam a geração e os modelos. Nada de chave: do provedor, só o endereço sem usuário e senha.
+// Recriar pelo chat grava por cima; o pedido anterior vai para `anteriores` (os 10 últimos).
+export const REQUEST_FILE = path.join('.sagadeck', 'geracao.json');
+
+const text = (v, max = 20000) => (v == null || v === '' ? undefined : String(v).slice(0, max));
+const num = (v) => (Number(v) > 0 ? Number(v) : undefined);
+const clean = (o) => Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined));
+
+// onde o anexo ficou guardado (mesma pasta de prepareDocumentMaterials: contexto/documentos/<sha256 12>/<nome>)
+function storedPath(dir, name, bytes) {
+  if (!bytes) return undefined;
+  const hash = crypto.createHash('sha256').update(bytes).digest('hex').slice(0, 12);
+  const rel = ['contexto', 'documentos', hash, path.basename(name)].join('/');
+  return fs.existsSync(path.join(dir, ...rel.split('/'))) ? rel : undefined;
+}
+
+function material(dir, m) {
+  const name = String(m.name || '');
+  const ext = path.extname(name).slice(1).toLowerCase();
+  return clean({
+    nome: name,
+    tipo: /^https?:/i.test(name) ? 'link' : ext || 'texto',
+    detalhe: text(m.detail, 200),
+    tamanho: m.bytes ? m.bytes.length : undefined, // bytes do arquivo anexado
+    caracteres: String(m.text || '').length || undefined, // texto que a IA leu
+    caminho: storedPath(dir, name, m.bytes),
+  });
+}
+
+// o endereço do provedor, sem usuário, senha nem parâmetros (onde às vezes vai uma chave)
+function provider(cfg) {
+  if (cfg.adaptador) return 'adaptador';
+  try { const u = new URL(cfg.url); return `${u.protocol}//${u.host}${u.pathname.replace(/\/+$/, '')}`; } catch { return undefined; }
+}
+
+// origem: "biblioteca" | "editor" | "chat"; pedido: o corpo do pedido (briefing, answer, duration, style…);
+// materials: os anexos como vieram (com bytes); spec: a apresentação gerada (tema e título finais)
+export function saveGenerationRequest(dir, { origem, pedido = {}, materials = [], spec = null, research = null, prefs = loadPreferences().ia, cfg = llmConfig() } = {}) {
+  if (!dir) return null;
+  const guide = pedido.guide && typeof pedido.guide === 'object' ? pedido.guide : {};
+  const entry = clean({
+    data: new Date().toISOString(),
+    origem,
+    briefing: String(pedido.briefing || ''),
+    briefingPadrao: !!guide.padrao,
+    guia: clean({ intencao: text(guide.intent, 40), publico: text(guide.audience, 500), objetivo: text(guide.goal, 500), roteiro: text(guide.route, 40) }),
+    resposta: text(pedido.answer, 500),
+    duracao: num(pedido.duration),
+    slides: num(pedido.slides),
+    tema: text(pedido.theme, 80),
+    estilo: text(pedido.style, 80),
+    direcao: text(pedido.direction && typeof pedido.direction === 'object' ? JSON.stringify(pedido.direction) : pedido.direction, 4000),
+    materiais: materials.map((m) => material(dir, m)),
+    preferencias: clean({ idioma: prefs?.idioma || 'auto', imagens: prefs?.imagens !== false, pesquisa: prefs?.pesquisa !== false, perguntar: prefs?.perguntar !== false, autor: text(prefs?.autor, 120) }),
+    pesquisa: research?.fontes?.length ? research.fontes.map((f) => clean({ site: text(f.site, 200), url: text(f.url, 500) })) : undefined,
+    modelos: clean({ texto: cfg.textModel, visao: cfg.visionModel, imagem: cfg.imageModel, busca: cfg.searchModel || undefined }),
+    provedor: provider(cfg),
+    resultado: spec ? clean({ titulo: text(spec.title, 200), tema: text(spec.theme, 80), slides: Array.isArray(spec.slides) ? spec.slides.length : undefined }) : undefined,
+  });
+  if (!Object.keys(entry.guia).length) delete entry.guia;
+  const file = path.join(dir, REQUEST_FILE);
+  let anteriores = [];
+  try { const old = JSON.parse(fs.readFileSync(file, 'utf8')); anteriores = [{ ...old, anteriores: undefined }, ...(old.anteriores || [])].slice(0, 10); } catch { /* primeiro pedido */ }
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  const out = { ...entry, ...(anteriores.length ? { anteriores: JSON.parse(JSON.stringify(anteriores)) } : {}) };
+  const tmp = `${file}.tmp-${process.pid}`;
+  fs.writeFileSync(tmp, JSON.stringify(out, null, 2), 'utf8');
+  renameRetry(tmp, file);
+  return out;
+}

package/src/studio/ia-routes.js

@@ -52,7 +52,7 @@ export async function iaRoutes({ req, res, pathname, opts, readJSON }) {
     // testar: uma pergunta curta com o que está na tela (antes de salvar)
     const base = llmConfig();
     const cfg = { ...base, url: next.url.replace(/\/+$/, ""), key: keyOf(next), headers: next.headers || {}, adaptador: next.adaptador || "",
-      textModel: next.models.text, visionModel: next.models.vision || next.models.text, imageModel: next.models.image || "image", searchModel: next.models.search || "",
+      textModel: next.models.text, visionModel: next.models.vision || next.models.text, imageModel: next.models.image || "image", searchModel: next.models.search || "", checkModel: next.models.check || next.models.text,
       timeoutMs: 60_000, firstTimeoutMs: 60_000 };
     const t0 = Date.now();
     try {

package/src/studio/layout-samples.js

@@ -143,7 +143,7 @@ export const LAYOUT_SAMPLES = {
   decisionlab: {layout:"decisionlab", title:"A revisão melhora o resultado?", lab:{volume:10000,errorRate:2,reviewRate:100,catchRate:60,introducedRate:0.2,seconds:30}},
   infographic: { layout: "infographic", shape: "arco", title: "Os ==desafios== da viagem", center: { title: "Desafios" }, items: [{ title: "Roteiro", text: "Três cidades em dez dias" }, { title: "Orçamento", text: "Hospedagem pesa mais" }, { title: "Documentos", text: "Passaporte e visto" }, { title: "Clima", text: "Chuva na segunda semana" }] },
   diagram: { layout: "diagram", kicker: "Processo", title: "Da ideia à ==produção==", mermaid: "flowchart LR\n  A([:lightbulb: Ideia]):::hi --> B{Vale testar?}\n  B -->|sim| C[:flask-conical: Protótipo]\n  B -.->|não| X[Arquivar]:::vazado\n  C ==> D[:rocket: Produção]:::em" },
-  solution: {layout:"solution", title:"Exercício: quanto rende em 3 anos?", problem:"R$ 1.000 aplicados a 1% ao mês, com juros compostos. Quanto há depois de 36 meses?", givens:[{symbol:"C", value:"1000", unit:"R\\$", label:"capital"}, {symbol:"i", value:"0,01", label:"taxa ao mês"}, {symbol:"n", value:"36", label:"meses"}], find:"M", steps:[{text:"Juros compostos", latex:"M = C\\,(1 + i)^n"}, {text:"Substitui os dados", latex:"M = 1000 \\cdot 1{,}01^{36}"}, {text:"Calcula a potência", latex:"1{,}01^{36} \\approx 1{,}4308"}], answer:{latex:"M \\approx R\\$\\,1.430{,}77", text:"Rende cerca de 43% em 3 anos."}},
+  solution: {layout:"solution", title:"Exercício: quanto rende em 3 anos?", problem:"R$ 1.000 aplicados a 1% ao mês, com juros compostos. Quanto há depois de 36 meses?", givens:[{symbol:"C", value:"1000", unit:"R\\$", label:"capital"}, {symbol:"i", value:"0,01", label:"taxa ao mês"}, {symbol:"n", value:"36", label:"meses"}], find:"M", steps:[{text:"Juros compostos", latex:"M = C\\,(1 + i)^n"}, {text:"Calcula o fator", latex:"(1 + i)^n = (1 + {{i}})^{ {{n}} }", fn:"(1+i)^n", name:"fator", decimals:4}, {text:"Multiplica pelo capital", latex:"M = {{C}} \\cdot {{fator}}", fn:"C*fator", name:"M", decimals:2}], answer:{latex:"M \\approx R\\$\\,{{M}}", text:"Rende cerca de {{(M/C - 1)*100:0}}% em {{n}} meses."}, interactive:true},
   calc: {layout:"calc", title:"Qual é o regime do escoamento?", inputs:{V:{label:"Velocidade", latex:"V", value:1.5, min:0.01, max:4, step:0.01, unit:"m/s"}, D:{label:"Diâmetro", latex:"D", value:0.05, min:0.005, max:0.3, step:0.005, unit:"m"}, nu:{label:"Viscosidade (água, 20 °C)", latex:"\\nu = 1{,}0\\times10^{-6}\\ \\mathrm{m^2/s}", value:0.000001, fixed:true}}, outputs:[{name:"Re", label:"Número de Reynolds", latex:"Re = \\frac{VD}{\\nu}", fn:"V*D/nu", decimals:0}, {name:"regime", label:"Regime", of:"Re", cases:[{below:2300, text:"Laminar", color:"s3"}, {below:4000, text:"Transição", color:"em"}, {text:"Turbulento", color:"hi"}], scale:{min:100, max:1000000, log:true}}]},
   algo: {layout:"algo", title:"Bubble sort passo a passo", algorithm:"bubble", array:[5, 1, 4, 2, 8, 3]},
   carousel: {layout:"carousel", title:"Cinco lugares, cinco lições", style:"arc", items:[{title:"Montanha", text:"Subir devagar é o jeito mais rápido de chegar.", label:"Capítulo 1"}, {title:"Mar", text:"Tudo o que é fundo começa raso."}, {title:"Cidade", text:"Muita gente, muita luz, pouco silêncio."}, {title:"Deserto", text:"Onde o pouco vira muito."}, {title:"Floresta", text:"Cada árvore conta uma história."}]},

package/src/studio/public/ai-settings.js

@@ -4,12 +4,12 @@ window.SagaAISettings = (() => {
   const css = `.ai-cfg{max-width:min(560px,calc(100vw - 32px));width:100%;border:1px solid var(--border,#c9ced6);border-radius:12px;padding:18px 20px;background:var(--panel,var(--bg,#fff));color:var(--text,#1d2433);font:14px/1.45 system-ui,sans-serif}
 .ai-cfg::backdrop{background:rgba(0,0,0,.35)}.ai-cfg h2{margin:0 0 6px;font-size:18px}.ai-cfg p{margin:4px 0 10px;color:var(--text-2,#555)}
 .ai-cfg label{display:block;margin:10px 0 3px;font-weight:600;font-size:12px}.ai-cfg input,.ai-cfg select{width:100%;box-sizing:border-box;padding:7px 9px;border:1px solid var(--border,#c9ced6);border-radius:8px;background:var(--bg,#fff);color:inherit;font:inherit}
-.ai-cfg .grid{display:grid;grid-template-columns:1fr 1fr;gap:0 12px}.ai-cfg small{color:var(--text-3,#777);font-size:12px}.ai-cfg .warn{background:#fef3c7;color:#78350f;border-radius:8px;padding:8px 10px}
+.ai-cfg .grid{display:grid;grid-template-columns:1fr 1fr;gap:0 12px}.ai-cfg .grid .wide{grid-column:1/-1}.ai-cfg small{color:var(--text-3,#777);font-size:12px}.ai-cfg .warn{background:#fef3c7;color:#78350f;border-radius:8px;padding:8px 10px}
 .ai-cfg .row{display:flex;gap:8px;justify-content:flex-end;margin-top:16px;flex-wrap:wrap}.ai-cfg button{padding:7px 14px;border-radius:8px;border:1px solid var(--border,#c9ced6);background:transparent;color:inherit;cursor:pointer;font:inherit}
 .ai-cfg .rec{background:var(--selected,#eef);border-radius:8px;padding:8px 10px;margin:6px 0 4px}.ai-cfg .rec button{margin-top:6px;display:block}
 .ai-cfg button.primary{background:var(--brand,#5b4bdb);border-color:var(--brand,#5b4bdb);color:#fff}.ai-cfg [data-status]{margin-top:10px;min-height:1.4em}.ai-cfg [data-status].ok{color:#15803d}.ai-cfg [data-status].err{color:#b91c1c}`;
-  const LABEL = { text: "Modelo de texto", vision: "Modelo que vê imagens", image: "Modelo de imagem", search: "Modelo de busca na web", video: "Modelo de vídeo" };
-  const HINT = { text: "obrigatório", vision: "opcional; vazio = o de texto", image: "opcional; para gerar ilustrações", search: "opcional; no OpenRouter, um modelo :online", video: "opcional; para gerar clipes (cobrado por segundo)" };
+  const LABEL = { text: "Modelo de texto", vision: "Modelo que vê imagens", image: "Modelo de imagem", search: "Modelo de busca na web", video: "Modelo de vídeo", check: "Modelo para conferir" };
+  const HINT = { text: "obrigatório", vision: "opcional; vazio = o de texto", image: "opcional; para gerar ilustrações", search: "opcional; no OpenRouter, um modelo :online", video: "opcional; para gerar clipes (cobrado por segundo)", check: "opcional; vazio = o de texto. Um modelo de raciocínio mais forte só onde a conta precisa estar certa (contas, leitura crítica, revisão)" };
   const esc = (s) => String(s ?? "").replace(/[&<>"]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[c]);
   let dialog, info, onSaved = () => {};
 
@@ -47,7 +47,7 @@ window.SagaAISettings = (() => {
       <input id="ai-cfg-url" data-f="url" placeholder="https://…/v1" spellcheck="false">
       <label for="ai-cfg-key">Chave</label>
       <input id="ai-cfg-key" data-f="key" type="password" autocomplete="off" spellcheck="false" placeholder="${c.keySet ? `configurada (${esc(c.keyHint)}${c.keyFrom === "variável" ? `, da variável ${esc(c.keyEnv)}` : ""}); em branco mantém` : "cole a chave do provedor"}">
-      <div class="grid">${(info.roles || []).map((r) => `<div><label for="ai-cfg-${r}">${LABEL[r] || r}</label><input id="ai-cfg-${r}" data-model="${r}" value="${esc(c.models?.[r])}" placeholder="${info.recommended?.models?.[r] ? `ex.: ${esc(info.recommended.models[r])}` : ""}" spellcheck="false"><small>${HINT[r] || ""}</small></div>`).join("")}</div>
+      <div class="grid">${(info.roles || []).map((r) => `<div${r === "check" ? ' class="wide"' : ""}><label for="ai-cfg-${r}">${LABEL[r] || r}</label><input id="ai-cfg-${r}" data-model="${r}" value="${esc(c.models?.[r])}" placeholder="${info.recommended?.models?.[r] ? `ex.: ${esc(info.recommended.models[r])}` : ""}" spellcheck="false"><small>${HINT[r] || ""}</small></div>`).join("")}</div>
       <p><small>Texto e visão funcionam em qualquer provedor compatível com a API da OpenAI. Gerar imagem e buscar na web dependem do provedor: funcionam no OpenRouter com modelos de imagem e modelos <code>:online</code>; em outros, a pesquisa usa buscadores diretos e a imagem pode não sair.</small></p>
       <div data-status role="status"></div>
       <div class="row"><button type="button" data-close>Fechar</button><button type="button" data-test>Testar</button><button type="button" class="primary" data-save>Salvar</button></div>`;

package/src/studio/public/app.js

@@ -378,6 +378,7 @@
       renderThumbnails();
       selectSlide(0);
       loadChatHistory();
+      conference.refresh(); // o selo da Conferência: uma consulta ao abrir; depois, a cada salvamento
     } catch (err) {
       showToast("Erro ao carregar apresentação: " + err.message);
     }
@@ -431,6 +432,7 @@
       window.SagaMap?.mount(dom.renderedSlideContainer); // só aqui (prévia grande); miniaturas e galeria ficam na prévia em SVG
       window.SagaMapData?.attach(dom.renderedSlideContainer, slide, () => { syncDeckToServer(); renderCurrentSlide(); }, { toast: showToast, hydrate: hydrateIcons, materialized: previewMaterialized });
       window.SagaCalc?.mount(dom.renderedSlideContainer); // calculadora ao vivo: os controles funcionam no editor também
+      window.SagaSolution?.mount(dom.renderedSlideContainer); // exercício interativo: idem
       window.SagaDiagrams?.mount(dom.renderedSlideContainer).then(() => reportDiagram(dom.renderedSlideContainer));
       window.SagaDecisionLab?.mount(dom.renderedSlideContainer);
       applyEditorStep(idx);
@@ -2807,6 +2809,13 @@
     state, showToast: (...a) => showToast(...a), renderThumbnails: () => renderThumbnails(), renderCurrentSlide: () => renderCurrentSlide(),
     trackDeck: (l) => trackDeck(l), hydrateIcons: (el) => hydrateIcons(el), plainTitle: (sl, i) => plainTitle(sl, i),
   });
+  // Revisar › Conferência (conference-ui.js): o que as checagens acharam, com Corrigir com IA (pedido pontual ao chat)
+  const conference = window.SagaConference.create({
+    state, showToast: (...a) => showToast(...a), renderThumbnails: () => renderThumbnails(), renderCurrentSlide: () => renderCurrentSlide(),
+    hydrateIcons: (el) => hydrateIcons(el), plainTitle: (sl, i) => plainTitle(sl, i),
+    chatBusy: () => !!chatApi.getChatJob(),
+    askChat: (text, extra) => { openPane("chat"); dom.chatInput.value = text; chatApi.handleChatSubmit(null, extra); },
+  });
   // Desfazer / refazer único (history.js): todo caminho que muda o deck passa por trackDeck, com o rótulo da origem
   const deckHistory = window.SagaHistory.createHistory();
   function trackDeck(label = "Edição") {
@@ -2866,7 +2875,8 @@
       });
       if (adopted && !state.applyingHistory) deckHistory.rebase(state.deck);
       updateSaveStatus(res.ok ? "saved" : "error");
-      if (res.ok) window.SagaProject?.deckChanged();
+      // o selo da Conferência acompanha o que mudou no deck (navegar entre slides não muda nada: não consulta)
+      if (res.ok) { window.SagaProject?.deckChanged(); conference.refreshSoon(); }
       else if (throwOnError) throw new Error(data.error || 'Não foi possível salvar as mudanças antes de exportar.');
     } catch (err) {
       console.warn("Erro ao sincronizar com servidor:", err);
@@ -3910,6 +3920,7 @@ ${ta.value}`;
     document.getElementById("btn-header-footer").addEventListener("click", openHeaderFooter);
     document.getElementById("btn-styles")?.addEventListener("click", openStyles);
     document.getElementById("btn-review-changes")?.addEventListener("click", openReviewList);
+    document.getElementById("btn-conference")?.addEventListener("click", () => conference.open());
     document.getElementById("btn-close-hf").addEventListener("click", closeHeaderFooter);
     document.getElementById("btn-hf-cancel").addEventListener("click", closeHeaderFooter);
     document.getElementById("btn-hf-apply").addEventListener("click", applyHeaderFooter);

package/src/studio/public/chat.js

@@ -96,7 +96,8 @@ window.SagaChat = function ({ state, dom, escHtml, hydrateIcons, showToast, open
     box.scrollIntoView({ block: "nearest" });
   }
 
-  async function handleChatSubmit(e) {
+  // extra: o que o Studio manda junto do pedido (contas: [n] do painel Conferência, conferidas depois da resposta)
+  async function handleChatSubmit(e, extra = {}) {
     if (e) e.preventDefault();
     if (chatJob) { if(e?.type === "submit") chatJob.stop(); return; }
     const message = dom.chatInput.value.trim();
@@ -156,6 +157,7 @@ window.SagaChat = function ({ state, dom, escHtml, hydrateIcons, showToast, open
         renderNotes: state.renderNotes || [],
         autoRun: !!state.autoRunCommands, // a pessoa liberou os comandos desta conversa (só enquanto a página está aberta)
         expectFile: state.file,
+        ...(Array.isArray(extra?.contas) ? { contas: extra.contas } : {}),
       }, (ev) => { if (!commandEvent(ev)) work.update(ev); }, job.controller.signal);
       if (state.file !== job.file) { work.done(); showToast("O pedido terminou na apresentação em que começou; a apresentação atual foi preservada.", 6000); return; }
       if (!data.spec) throw new Error(data.error || "resposta sem deck");
@@ -245,6 +247,7 @@ window.SagaChat = function ({ state, dom, escHtml, hydrateIcons, showToast, open
       dom.chatInput.disabled = false;
       dom.chatInput.focus();
       await saveChatHistory();
+      window.dispatchEvent(new Event("sagadeck:chat-done")); // o painel Conferência confere o selo de novo
     }
   }
 
@@ -321,7 +324,8 @@ window.SagaChat = function ({ state, dom, escHtml, hydrateIcons, showToast, open
   async function loadChatHistory() {
     state.autoRunCommands = false; // outra apresentação: nada fica liberado
     try {
-      const { history } = await (await fetch("api/chat/history")).json();
+      const { history, notice } = await (await fetch("api/chat/history")).json();
+      if (notice) showToast("A criação com IA deixou avisos sem resolver: veja no chat da IA.", 8000);
       state.chatHistory = Array.isArray(history) ? history : [];
       state.loadingHistory = true; // conversa guardada não é resposta nova (o atalho do chat não acende)
       setTimeout(() => { state.loadingHistory = false; });

package/src/studio/public/conference-ui.js

@@ -0,0 +1,91 @@
+// Painel Revisar › Conferência: tudo o que as checagens automáticas acharam no deck aberto (contas, números sem base
+// no material, avisos da revisão visual, figuras do material sem slide, slides que a IA calculou ou incluiu), por
+// slide, com Ir ao slide, Corrigir com IA (um pedido pontual ao chat) e Ignorar (gravado no relatório). A lista vem
+// do servidor (src/studio/conference.js); o app passa o que o painel usa (create(ctx)).
+(function () {
+  const KIND_ICON = { conta: "calculator", material: "file-text", numero: "hash", visual: "scan-eye", figura: "image-off", derivado: "calculator", proprio: "sparkles" };
+  function create(ctx) {
+    const { state, showToast, renderThumbnails, renderCurrentSlide, hydrateIcons, plainTitle, askChat, chatBusy } = ctx;
+    let items = [], salvo = false, conferidoEm = null, timer = null, checking = false;
+    const json = async (r) => { const j = await r.json().catch(() => ({})); if (!r.ok || j.error) throw new Error(j.error || `HTTP ${r.status}`); return j; };
+    function take(j) {
+      items = j.items || []; salvo = !!j.salvo; conferidoEm = j.conferidoEm || null;
+      const b = document.getElementById("conference-badge");
+      if (b) { b.textContent = items.length; b.classList.toggle("clean", !items.length); }
+      document.getElementById("conference-dialog")?.dispatchEvent(new Event("refresh"));
+    }
+    async function refresh() {
+      try { take(await json(await fetch("api/conferencia"))); } catch { /* sem servidor: o selo fica como estava */ }
+    }
+    // o deck muda o tempo todo (formulário, IA): o selo acompanha sem uma consulta por tecla
+    const refreshSoon = () => { clearTimeout(timer); timer = setTimeout(refresh, 700); };
+    function goTo(n) {
+      if (!(n >= 1 && n <= (state.deck?.slides?.length || 0))) return;
+      state.currentSlideIndex = n - 1;
+      renderThumbnails(); renderCurrentSlide();
+    }
+    async function decide(id, status) {
+      try { take(await json(await fetch("api/conferencia/item", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ id, status }) }))); }
+      catch (e) { showToast(e.message); }
+    }
+    async function recheck(btn) {
+      if (checking) return;
+      checking = true; btn.disabled = true;
+      btn.innerHTML = '<i class="ic" data-ic="loader-circle"></i> Conferindo…'; hydrateIcons(btn);
+      try {
+        const j = await json(await fetch("api/conferencia/conferir", { method: "POST", headers: { "Content-Type": "application/json" }, body: "{}" }));
+        take(j);
+        showToast(`Conferido: ${items.length ? `${items.length} pendência(s)` : "nada pendente"}.${j.notes?.length ? ` ${j.notes.join(" ")}` : ""}`, 6000);
+      } catch (e) { showToast(`A conferência não saiu: ${e.message}`); }
+      finally { checking = false; document.getElementById("conference-dialog")?.dispatchEvent(new Event("refresh")); }
+    }
+    function fix(it, dlg) {
+      if (chatBusy()) { showToast("Espere a IA terminar o pedido atual.", 3000); return; }
+      if (it.slide) goTo(it.slide);
+      dlg.close();
+      // conta que não bate: o Studio confere de novo depois da resposta (contas: [n]) e o resultado decide se ela
+      // sai do painel; o resto (sem como conferir sozinho) sai ao ir para o chat
+      if (it.kind !== "conta" && it.kind !== "material") decide(it.id, "enviado");
+      askChat(it.fix, it.contas ? { contas: it.contas } : {});
+    }
+    function open() {
+      let dlg = document.getElementById("conference-dialog");
+      const fill = () => {
+        const groups = new Map();
+        for (const it of items) { const k = it.slide || 0; if (!groups.has(k)) groups.set(k, []); groups.get(k).push(it); }
+        const order = [...groups.keys()].sort((a, b) => (a || 1e9) - (b || 1e9));
+        dlg.innerHTML = `<header><i class="ic" data-ic="list-checks"></i><b>Conferência</b><span class="rv-count">${items.length}</span><span class="grow"></span>${salvo ? `<button type="button" class="btn btn-sm" data-recheck title="Refaz no deck atual a conferência das contas, a checagem dos números e das figuras do material"><i class="ic" data-ic="${checking ? "loader-circle" : "refresh-cw"}"></i> ${checking ? "Conferindo…" : "Conferir de novo"}</button>` : ""}<button type="button" class="btn btn-sm" data-close title="Fechar"><i class="ic" data-ic="x"></i></button></header>
+          <div class="rv-list conf-list">${items.length ? order.map((k) => `<section class="conf-group" data-slide="${k}"><div class="conf-group-head">${k ? `<b class="rv-num">${k}</b><span class="conf-slide-title"></span><button type="button" class="btn btn-sm" data-go="${k}">Ir ao slide</button>` : "<b>Deck todo</b>"}</div>${groups.get(k).map((it) => `<div class="conf-item conf-${it.kind}" data-id="${it.id}"><span class="conf-kind"><i class="ic" data-ic="${KIND_ICON[it.kind] || "circle-alert"}"></i><span></span></span><span class="conf-text"></span><span class="conf-actions"><button type="button" class="btn btn-primary btn-sm" data-fix><i class="ic" data-ic="wand-sparkles"></i> Corrigir com IA</button><button type="button" class="btn btn-sm" data-ignore title="Está certo assim: sai do painel e dos próximos pedidos à IA"><i class="ic" data-ic="eye-off"></i> Ignorar</button></span></div>`).join("")}</section>`).join("")
+            : `<div class="rv-empty">${salvo ? "Nada pendente: as checagens automáticas não deixaram avisos neste deck." : "A conferência vale para apresentações salvas na biblioteca."}</div>`}</div>
+          ${conferidoEm ? `<div class="conf-foot">Conferido em ${new Date(conferidoEm).toLocaleString("pt-BR")}</div>` : ""}`;
+        dlg.querySelectorAll(".conf-group").forEach((g) => {
+          const n = +g.dataset.slide;
+          if (n && state.deck?.slides?.[n - 1]) g.querySelector(".conf-slide-title").textContent = plainTitle(state.deck.slides[n - 1], n - 1);
+          g.querySelector("[data-go]")?.addEventListener("click", () => { goTo(n); dlg.close(); });
+        });
+        dlg.querySelectorAll(".conf-item").forEach((row) => {
+          const it = items.find((x) => x.id === row.dataset.id);
+          row.querySelector(".conf-kind span").textContent = it.label;
+          row.querySelector(".conf-text").textContent = it.text;
+          row.querySelector("[data-fix]").onclick = () => fix(it, dlg);
+          row.querySelector("[data-ignore]").onclick = () => decide(it.id, "ignorado");
+        });
+        dlg.querySelector("[data-recheck]")?.addEventListener("click", (e) => recheck(e.currentTarget));
+        dlg.querySelector("[data-close]").onclick = () => dlg.close();
+        hydrateIcons(dlg);
+      };
+      if (!dlg) {
+        dlg = document.createElement("dialog");
+        dlg.id = "conference-dialog"; dlg.className = "review-dialog conference-dialog";
+        document.body.append(dlg);
+        dlg.addEventListener("refresh", () => { if (dlg.open) fill(); });
+      }
+      fill();
+      if (!dlg.open) dlg.showModal();
+      refresh();
+    }
+    window.addEventListener("sagadeck:chat-done", refreshSoon);
+    return { open, refresh, refreshSoon };
+  }
+  window.SagaConference = { create };
+})();

package/src/studio/public/index.html

@@ -336,6 +336,7 @@
             <i class="ic" data-ic="wand"></i><span>Arrumar layout</span><b id="fiscal-badge" class="fiscal-badge clean">0</b>
           </button>
           <button id="btn-review-changes" class="rbtn rbtn-lg" title="O que mudou em relação ao original: aceitar ou desfazer slide a slide"><i class="ic" data-ic="git-compare"></i><span>Mudanças</span><b id="review-badge" class="fiscal-badge clean">0</b></button>
+          <button id="btn-conference" class="rbtn rbtn-lg" title="O que as checagens automáticas acharam (contas, números sem base no material, avisos da revisão, figuras de fora, slides da IA): ir ao slide, corrigir com IA ou ignorar"><i class="ic" data-ic="list-checks"></i><span>Conferência</span><b id="conference-badge" class="fiscal-badge clean">0</b></button>
           <button id="btn-ai-review" class="rbtn rbtn-lg" title="A IA recebe uma imagem do slide, avalia a composição e aplica melhorias. Usa tokens."><i class="ic" data-ic="scan-eye"></i><span>Revisar com IA</span></button>
         </div>
         <div class="rgroup-label">Layout</div>
@@ -879,6 +880,7 @@
   <script src="screenshot-editor.js"></script>
   <script src="formula.js"></script>
   <script src="calc.js"></script>
+  <script src="solution.js"></script>
   <script src="science.js"></script>
   <script src="map-background.js"></script>
   <script src="map.js"></script>
@@ -892,6 +894,7 @@
   <script src="merge-decks.js"></script>
   <script src="history.js"></script>
   <script src="review-ui.js"></script>
+  <script src="conference-ui.js"></script>
   <script src="share-ui.js"></script>
   <script src="slide-clipboard.js"></script>
   <script src="slide-select.js"></script>

package/src/studio/public/library.js

@@ -539,7 +539,10 @@
         generating = true;
         btn.disabled = true;
         status.textContent = "Gerando… pode levar um minuto.";
-        const payload = { topic, briefing, answer: answer || undefined, stream: true, duration: Number(min.value) || undefined, style: style.value || undefined, materials: docs.map((d) => d.id) };
+        // guide: o que a pessoa escolheu no pedido guiado; padrao = não escreveu nada e foi o texto padrão (fica no registro da criação)
+        const v = values();
+        const guideInfo = { intent: v.intent, audience: v.audience.trim() || undefined, goal: v.goal.trim() || undefined, route: v.route || undefined, padrao: !v.briefing.trim() };
+        const payload = { topic, briefing, answer: answer || undefined, stream: true, duration: Number(min.value) || undefined, style: style.value || undefined, materials: docs.map((d) => d.id), guide: guideInfo };
         try {
           const res = await fetch("api/library/decks/ai", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(payload) });
           if (!res.ok) throw new Error((await res.json().catch(() => ({}))).error || `HTTP ${res.status}`);

package/src/studio/public/slide-form.js

@@ -220,10 +220,15 @@
         { addLabel: "Adicionar item", newItem: () => ({ title: "Novo item", text: "" }) })],
     // aula (src/lessons.js): exercício resolvido, calculadora ao vivo, algoritmo animado
     solution: [f.text("kicker", "Chapéu"), f.text("title", "Título"), f.area("problem", "Enunciado"),
-      f.list("givens", "Dados", obj([f.text("symbol", "Símbolo (LaTeX)", { mono: true }), f.text("value", "Valor", { placeholder: "0,05" }), f.text("unit", "Unidade"), f.text("label", "Nome"), f.more([f.text("latex", "Ou a linha inteira em LaTeX", { mono: true })])]), { addLabel: "Adicionar dado", newItem: () => ({ symbol: "x", value: "1", unit: "" }) }),
+      f.list("givens", "Dados", obj([f.text("symbol", "Símbolo (LaTeX)", { mono: true }), f.text("value", "Valor", { placeholder: "0,05" }), f.text("unit", "Unidade"), f.text("label", "Nome"),
+        f.more([f.text("latex", "Ou a linha inteira em LaTeX", { mono: true }), f.text("name", "Nome na conta", { mono: true, hint: "Como as fórmulas chamam este dado. Sem ele, vem do símbolo: L_1 vira L1." }),
+          f.num("min", "Mínimo do controle"), f.num("max", "Máximo do controle")])]), { addLabel: "Adicionar dado", newItem: () => ({ symbol: "x", value: "1", unit: "" }) }),
       f.text("find", "Pede-se (LaTeX)", { mono: true }),
-      f.list("steps", "Passos (um por clique)", obj([f.text("text", "O que se faz"), f.area("latex", "A conta (LaTeX)", { mono: true, rows: 2 }), f.text("note", "Observação")]), { addLabel: "Adicionar passo", newItem: () => ({ text: "Próximo passo", latex: "" }) }),
-      f.obj("answer", "Resposta", [f.text("latex", "Resultado (LaTeX)", { mono: true }), f.text("text", "Em palavras"), f.text("label", "Rótulo", { placeholder: "Resposta" })]),
+      f.list("steps", "Passos (um por clique)", obj([f.text("text", "O que se faz"), f.area("latex", "A conta (LaTeX)", { mono: true, rows: 2, hint: "{{nome}} mostra o valor calculado; sem ele, o valor entra no fim." }),
+        f.text("fn", "Fórmula que calcula", { mono: true, placeholder: "C*(1+i)^n", hint: "O sagadeck faz a conta com os dados e os passos anteriores (pelo nome)." }),
+        f.text("name", "Nome do resultado", { mono: true, placeholder: "M" }), f.text("unit", "Unidade do resultado"), f.num("decimals", "Casas decimais"), f.text("note", "Observação")]), { addLabel: "Adicionar passo", newItem: () => ({ text: "Próximo passo", latex: "" }) }),
+      f.obj("answer", "Resposta", [f.text("latex", "Resultado (LaTeX)", { mono: true, hint: "Use {{nome}} para o valor calculado: M \\approx {{M}}" }), f.text("text", "Em palavras"), f.text("label", "Rótulo", { placeholder: "Resposta" })]),
+      f.bool("interactive", "Dados ajustáveis na apresentação"),
       f.more([f.text("prompt", "Pergunta antes do primeiro passo", { placeholder: "Por onde você começaria?" })])],
     calc: window.SagaCalcFields(f, obj), map: window.SagaMapFields(f, obj),
     codelab: window.SagaLabFields.codelab(f, obj),

package/src/studio/public/style.css

@@ -1304,6 +1304,29 @@ textarea.form-control.napkin-input { min-height: 220px; resize: vertical; font-f
 .rv-note { color: var(--text-2); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .rv-empty { padding: 24px; text-align: center; color: var(--text-2); }
 
+/* Revisar › Conferência (conference-ui.js): achados das checagens automáticas, por slide */
+.conference-dialog { width: min(820px, 94vw); }
+.conf-group { padding: 4px 0 8px; border-bottom: 1px solid var(--ui-line); }
+.conf-group:last-child { border-bottom: 0; }
+.conf-group-head { display: flex; align-items: center; gap: 8px; padding: 6px 8px; font-size: 12px; }
+.conf-group-head .rv-num { width: auto; color: var(--text-2); }
+.conf-slide-title { flex: 1; min-width: 0; font-weight: 600; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.conf-item { display: flex; align-items: flex-start; gap: 10px; margin: 2px 0 2px 34px; padding: 6px 8px; border-left: 3px solid var(--ui-line); border-radius: 0 6px 6px 0; font-size: 12px; }
+.conf-item:hover { background: var(--hover); }
+.conf-item.conf-conta, .conf-item.conf-material { border-left-color: #c42b1c; }
+.conf-item.conf-numero, .conf-item.conf-figura { border-left-color: #bc4b09; }
+.conf-item.conf-visual { border-left-color: #0063b1; }
+.conf-item.conf-derivado, .conf-item.conf-proprio { border-left-color: #8764b8; }
+.conf-kind { display: inline-flex; align-items: center; gap: 4px; flex: 0 0 170px; font-weight: 600; color: var(--text-2); }
+.conf-kind .ic { width: 14px; height: 14px; }
+.conf-text { flex: 1; min-width: 0; line-height: 1.4; }
+.conf-actions { display: flex; gap: 6px; flex-shrink: 0; }
+.conf-foot { padding: 6px 12px 10px; font-size: 11px; color: var(--text-3); }
+@media (max-width: 640px) {
+  .conf-item { flex-wrap: wrap; margin-left: 8px; }
+  .conf-kind { flex-basis: 100%; }
+}
+
 /* Arquivo › Compartilhar link (share-ui.js) */
 .share-dialog { width: min(620px, 94vw); }
 .share-new { display: flex; flex-wrap: wrap; align-items: center; gap: 10px 18px; margin-bottom: 14px; }