sagadeck 1.2.0 → 1.3.1

package/src/figures/diagrams.js

@@ -1,7 +1,7 @@
 // Diagramas gerados em SVG.
 //   { diagram: loop, nodes: [dados, modelo, decisão, ação], actor: in|on|out|none, at: 3 }
 //   { diagram: spectrum, stops: [HITL, HOTL, HOOTL], at: 1, left: "humano decide", right: "máquina decide" }
-//   { diagram: flow, steps: [a, b, c], highlight: 1 }
+//   { diagram: flow, steps: [a, b, c], highlight: 1, cols: 5 } (fila longa desce em serpentina)
 //   { diagram: venn, a: "…", b: "…", both: "…" }
 import { esc } from "../markup.js";
 import { humanBody } from "./pictos.js";
@@ -84,18 +84,46 @@ export function spectrum(o = {}) {
 
 export function flow(o = {}) {
   const steps = o.steps || [];
-  const n = steps.length, bw = 300, gap = 90, bh = 150;
-  const W = n * bw + (n - 1) * gap;
+  const n = steps.length, bw = 300, gap = 90, bh = 150, vgap = 130;
+  const perRow = Math.max(1, o.cols || 5);
+  const rows = Math.max(1, Math.ceil(n / perRow));
   const id = `ar${++uid}`;
+  const box = (x, y, s, hl) =>
+    `<rect x="${x}" y="${y}" width="${bw}" height="${bh}" rx="18" style="fill:var(${hl ? "--hi" : "--surface"});stroke:var(--fg)" stroke-width="${hl ? 0 : 4}"/>` +
+    `<foreignObject x="${x + 16}" y="${y + 10}" width="${bw - 32}" height="${bh - 20}"><div xmlns="http://www.w3.org/1999/xhtml" class="f-heading" style="height:100%;display:flex;align-items:center;justify-content:center;text-align:center;font-size:36px;color:var(${hl ? "--on-hi" : "--fg"})">${esc(s)}</div></foreignObject>`;
+  const arrow = (x1, y1, x2, y2) =>
+    `<line x1="${x1}" y1="${y1}" x2="${x2}" y2="${y2}" style="stroke:var(--fg)" stroke-width="8" marker-end="url(#${id})"/>`;
   let g = arrowDefs(id);
+  if (rows === 1) {
+    const W = n * bw + (n - 1) * gap;
+    steps.forEach((s, i) => {
+      const x = i * (bw + gap);
+      g += box(x, 0, s, o.highlight === i);
+      if (i < n - 1) g += arrow(x + bw + 12, bh / 2, x + bw + gap - 20, bh / 2);
+    });
+    return wrap([-4, -4, W + 8, bh + 8], g, "flow");
+  }
+  // fila longa (10 a 12 caixas): serpentina em fileiras, ida e volta — a letra continua legível
+  const W = perRow * bw + (perRow - 1) * gap;
+  const at = (i) => {
+    const r = Math.floor(i / perRow), k = i % perRow;
+    const y = r * (bh + vgap);
+    return { x: r % 2 === 0 ? k * (bw + gap) : W - bw - k * (bw + gap), y };
+  };
   steps.forEach((s, i) => {
-    const x = i * (bw + gap);
-    const hl = o.highlight === i;
-    g += `<rect x="${x}" y="0" width="${bw}" height="${bh}" rx="18" style="fill:var(${hl ? "--hi" : "--surface"});stroke:var(--fg)" stroke-width="${hl ? 0 : 4}"/>`;
-    g += `<foreignObject x="${x + 16}" y="10" width="${bw - 32}" height="${bh - 20}"><div xmlns="http://www.w3.org/1999/xhtml" class="f-heading" style="height:100%;display:flex;align-items:center;justify-content:center;text-align:center;font-size:36px;color:var(${hl ? "--on-hi" : "--fg"})">${esc(s)}</div></foreignObject>`;
-    if (i < n - 1) g += `<line x1="${x + bw + 12}" y1="${bh / 2}" x2="${x + bw + gap - 20}" y2="${bh / 2}" style="stroke:var(--fg)" stroke-width="8" marker-end="url(#${id})"/>`;
+    const { x, y } = at(i);
+    g += box(x, y, s, o.highlight === i);
+    if (i >= n - 1) return;
+    const a = at(i), b = at(i + 1);
+    if (a.y === b.y) {
+      const dir = b.x > a.x ? 1 : -1;
+      g += arrow(a.x + (dir > 0 ? bw + 12 : -12), a.y + bh / 2, b.x + (dir > 0 ? -20 : bw + 20), b.y + bh / 2);
+    } else {
+      const cx1 = a.x + bw / 2, cx2 = b.x + bw / 2, my = a.y + bh + vgap / 2;
+      g += `<path d="M${cx1} ${a.y + bh} V${my} H${cx2} V${b.y}" fill="none" style="stroke:var(--fg)" stroke-width="8" marker-end="url(#${id})"/>`;
+    }
   });
-  return wrap([-4, -4, W + 8, bh + 8], g, "flow");
+  return wrap([-4, -4, W + 8, rows * bh + (rows - 1) * vgap + 8], g, "flow");
 }
 
 export function venn(o = {}) {

package/src/fiscal/autofix.js

@@ -360,7 +360,7 @@ export function autofixDeck(spec, issuesReport = []) {
   };
 }
 
-function countSlideWords(s) {
+export function countSlideWords(s) {
   const txt = [];
   const walk = (v, k) => {
     if (k === "notes" || k === "source" || k === "id" || k === "layout" || k === "tone") return;

package/src/fiscal/enxugar.js

@@ -0,0 +1,22 @@
+// enxugar: relatório de palavras por slide contra o limite do material
+// (a mesma conta e o mesmo limite do fiscal anti-sono do autofix).
+// Base para `sagadeck enxugar deck.yaml [--fix]`.
+import { countSlideWords } from "./autofix.js";
+import { wordLimit } from "../purpose.js";
+
+export function enxugarReport(spec = {}) {
+  const slides = Array.isArray(spec.slides) ? spec.slides : [];
+  return slides.map((s, i) => {
+    const words = countSlideWords(s || {});
+    const limit = wordLimit(s || {}, spec);
+    return { index: i, layout: s?.layout || "blocks", title: s?.title || "", words, limit, over: Math.max(0, words - limit) };
+  });
+}
+
+export function formatEnxugar(rows) {
+  const over = rows.filter((r) => r.over > 0);
+  if (!over.length) return `ok: ${rows.length} slide(s), todos dentro do limite.`;
+  return [`${over.length} de ${rows.length} slide(s) acima do limite:`,
+    ...over.map((r) => `  slide ${r.index + 1}${r.title ? ` "${r.title}"` : ""} [${r.layout}]: ${r.words} palavras (limite ${r.limit}, +${r.over})`),
+  ].join("\n");
+}

package/src/fiscal/normalize.js

@@ -14,8 +14,19 @@ const COLOR_MAP = {
   branco: "FFFFFF",
 };
 
-export function normalizeSpec(rawSpec) {
-  if (!rawSpec || typeof rawSpec !== "object") return rawSpec;
+// Vírgula em valor de fluxo (`text: 3,5 peixes…` dentro de [{...}]) que o YAML partiu em
+// {text: 3, "5 peixes…": null}: junta de volta. Chave nula começando com dígito nunca é intencional.
+function fixCommaSplit(o) {
+  if (!o || typeof o !== "object" || Array.isArray(o)) return;
+  for (const k of Object.keys(o)) {
+    if (o[k] === null && /^\d/.test(k)) {
+      const target = ["text", "title", "label", "when"].find((f) => typeof o[f] === "number" || typeof o[f] === "string");
+      if (target) { o[target] = `${o[target]},${k}`; delete o[k]; }
+    }
+  }
+}
+
+export function normalizeSpec(rawSpec) {  if (!rawSpec || typeof rawSpec !== "object") return rawSpec;
   const spec = JSON.parse(JSON.stringify(rawSpec));
 
   // 1. Normalização no nível da raiz
@@ -100,6 +111,12 @@ export function normalizeSpec(rawSpec) {
       });
     }
 
+    // Vírgula em valor de fluxo YAML (`text: 3,5 peixes…` dentro de [{...}]) quebra em
+    // {text: 3, "5 peixes…": null}: junta de volta antes que vire dado truncado no slide.
+    for (const f of ["events", "steps", "items"]) {
+      if (Array.isArray(s[f])) s[f].forEach(fixCommaSplit);
+    }
+
     // Cores comuns em português
     if (s.color && COLOR_MAP[s.color.toLowerCase()]) {
       s.color = COLOR_MAP[s.color.toLowerCase()];

package/src/import/crop.js

@@ -48,11 +48,18 @@ export async function cropRegions(jobs) {
           const x = Math.max(0, Math.floor(j.x)), y = Math.max(0, Math.floor(j.y));
           const w = Math.max(1, Math.min(img.width - x, Math.ceil(j.w))), h = Math.max(1, Math.min(img.height - y, Math.ceil(j.h)));
           const c = document.createElement("canvas"); c.width = w; c.height = h;
-          c.getContext("2d").drawImage(img, x, y, w, h, 0, 0, w, h);
-          return c.toDataURL("image/png");
+          const g = c.getContext("2d", { willReadFrequently: true }); g.drawImage(img, x, y, w, h, 0, 0, w, h);
+          // densidade de tinta (fração de pixels não-papel): recorte quase em branco = caixa errada
+          let ink = 0;
+          try {
+            const d = g.getImageData(0, 0, w, h).data;
+            for (let i = 0; i < d.length; i += 16) { if ((d[i] + d[i + 1] + d[i + 2]) / 3 < 235) ink++; }
+            ink /= d.length / 16;
+          } catch { ink = 1; }
+          return { png: c.toDataURL("image/png"), ink };
         });
       }, [data, list.map(({ x, y, w, h }) => ({ x, y, w, h }))]);
-      outs.forEach((u, k) => { fs.writeFileSync(list[k].dst, Buffer.from(u.split(",")[1], "base64")); done.push(list[k].dst); });
+      outs.forEach((u, k) => { fs.writeFileSync(list[k].dst, Buffer.from(u.png.split(",")[1], "base64")); list[k].ink = u.ink; done.push(list[k].dst); });
     }
   } finally { await browser.close(); }
   return done;

package/src/layouts.js

@@ -124,9 +124,11 @@ export const LAYOUTS = {
   },
 
   statement(s, ctx) {
-    // o tamanho pelo comprimento: frase curta é manchete; parágrafo inteiro em letra de título ocupava a tela toda
-    const words = String(s.text || (s.lines || []).map((l) => (typeof l === "string" ? l : l?.text || "")).join(" ")).split(/\s+/).filter(Boolean).length;
-    const role = s.as || (words > 45 ? "lead" : words > 22 ? "h2" : "title");
+    // o tamanho pelo comprimento EM CARACTERES: contar palavras falhava com palavra longa
+    // e frase de 100+ caracteres em destaque grande ocupava a tela (headline é para frase curta).
+    // `as` explícito vence.
+    const chars = String(s.text || (s.lines || []).map((l) => (typeof l === "string" ? l : l?.text || "")).join(" ")).length;
+    const role = s.as || (chars > 100 ? "lead" : chars > 60 ? "h2" : "title");
     const lines = s.lines
       ? s.lines.map((l, i) => {
           const o = typeof l === "string" ? { text: l } : l;

package/src/library.js

@@ -249,9 +249,80 @@ export function openLibrary(root) {
     return idOf(yaml);
   }
 
+  // ---- geração em andamento (invisível): a IA trabalha numa pasta oculta do tópico e a apresentação
+  // só aparece na biblioteca quando pronta (publicada com o título final, num renomear atômico). Nada a meio
+  // fazer fica visível — nem pode ser apagado sem querer no meio da geração. Interrompida: vai para a lixeira
+  // (recuperável, como qualquer exclusão), nunca apagada direto; órfãs vão para a lixeira na subida do Studio.
+  const STAGING = ".gerando";
+  function stagingRoot(topic) {
+    const base = topicDir(topic || ensureTopic("Sem tópico"));
+    const stage = path.join(base, STAGING);
+    fs.mkdirSync(stage, { recursive: true });
+    return { base, stage };
+  }
+  function createStagingDeck(topic) {
+    const { stage } = stagingRoot(topic);
+    const dir = uniquePath(stage, String(Date.now()));
+    fs.mkdirSync(dir, { recursive: true });
+    const file = path.join(dir, "deck.yaml");
+    writeDeckFile(file, { title: "Gerando…", slides: [{ layout: "cover", title: "Gerando…" }] });
+    return { dir, file };
+  }
+  function stagingOf(topic, dir) {
+    const { base } = stagingRoot(topic);
+    const abs = path.resolve(dir);
+    const rel = path.relative(base, abs);
+    if (!rel || rel.startsWith("..") || path.isAbsolute(rel) || path.dirname(rel) !== STAGING) throw new Error("pasta temporária inválida");
+    return { base, abs };
+  }
+  // publica: confere o .yaml ANTES de mover; o renomear é atômico (mesmo disco) e o .yaml acompanha a pasta
+  function publishStagedDeck(topic, dir, title) {
+    const { base, abs } = stagingOf(topic, dir);
+    const yaml = path.join(abs, "deck.yaml");
+    const spec = YAML.parse(fs.readFileSync(yaml, "utf8")) || {};
+    if (!Array.isArray(spec.slides) || !spec.slides.length) throw new Error("a geração não produziu slides: nada foi publicado");
+    const dest = uniquePath(base, safeName(title || spec.title || "Nova apresentação"));
+    spec.title = title || spec.title || path.basename(dest);
+    fs.renameSync(abs, dest);
+    const final = path.join(dest, path.basename(dest) + ".yaml");
+    fs.renameSync(path.join(dest, "deck.yaml"), final);
+    writeDeckFile(final, spec); // só o título muda no arquivo
+    return idOf(final);
+  }
+  // descarta com cuidado: lixeira (visível e restaurável), nunca rm direto — pode ter material da pessoa lá dentro
+  function discardStaging(topic, dir, reason = "Geração interrompida") {
+    const { abs } = stagingOf(topic, dir);
+    const tdir = path.join(root, TRASH);
+    fs.mkdirSync(tdir, { recursive: true });
+    const slot = path.join(tdir, `${Date.now()}-${STAGING}`);
+    fs.mkdirSync(slot);
+    fs.renameSync(abs, path.join(slot, path.basename(abs)));
+    const yaml = path.join(slot, path.basename(abs), "deck.yaml");
+    let slides = 0, title = reason;
+    try { const spec = YAML.parse(fs.readFileSync(yaml, "utf8")) || {}; slides = Array.isArray(spec.slides) ? spec.slides.length : 0; if (spec.title && spec.title !== "Gerando…") title = spec.title; } catch {}
+    fs.writeFileSync(path.join(slot, ".origem.json"), JSON.stringify({
+      topic, title, deleted: Date.now(), yaml: "deck.yaml",
+      unit: path.basename(abs), slides, staging: true,
+    }));
+    return path.basename(slot);
+  }
+  // na subida: toda pasta temporária é órfã (a geração morreu com o processo) — vai para a lixeira, nunca some
+  function recoverStaging() {
+    const moved = [];
+    for (const e of fs.readdirSync(root, { withFileTypes: true })) {
+      if (!e.isDirectory() || hidden(e.name)) continue;
+      const stage = path.join(root, e.name, STAGING);
+      if (!fs.existsSync(stage)) continue;
+      for (const s of fs.readdirSync(stage, { withFileTypes: true })) {
+        if (!s.isDirectory()) continue;
+        try { moved.push(discardStaging(e.name, path.join(stage, s.name), "Geração interrompida (Studio reiniciado)")); } catch {}
+      }
+    }
+    return moved;
+  }
+
   // ---- lixeira ----
-  function trashDeck(id) {
-    const { file, unit, info } = unitOf(id);
+  function trashDeck(id) {    const { file, unit, info } = unitOf(id);
     const tdir = path.join(root, TRASH);
     fs.mkdirSync(tdir, { recursive: true });
     const slot = path.join(tdir, `${Date.now()}-${path.basename(unit)}`);
@@ -393,6 +464,7 @@ export function openLibrary(root) {
     root, list, resolveId, idOf,
     createTopic, updateTopic, deleteTopic,
     createDeck, moveDeck, renameDeck, duplicateDeck,
+    createStagingDeck, publishStagedDeck, discardStaging, recoverStaging,
     trashDeck, restoreDeck, purgeDeck, purgeOld, listTrash, emptyTrash,
     importPackage,
   };

package/src/motion.js

@@ -26,7 +26,7 @@ function scene(o){
  const message=(kind)=>parent.postMessage({sagaMotion:kind},'*');
  const chat=document.querySelector('.chat'),input=document.querySelector('.input'),thread=document.querySelector('.thread'),status=document.querySelector('.status');
  function reset(){started=false;phase='idle';elapsed=0;chat.hidden=true;input.textContent='';thread.replaceChildren();status.textContent='';}
- window.addEventListener('message',e=>{if(e.source!==parent)return;if(e.data?.sagaMotion==='poster'){reduced=true;if(o.type==='terminal')document.querySelector('.feed').textContent=o.lines.join('\n');}if(e.data?.sagaMotion==='active')active=!!e.data.active;if(e.data?.sagaMotion==='reset')reset();if(e.data?.sagaMotion==='start'){reset();started=true;active=true;phase='recognize';chat.hidden=false;}});
+ message('ready');window.addEventListener('message',e=>{if(e.source!==parent)return;if(e.data?.sagaMotion==='poster'){reduced=true;if(o.type==='terminal')document.querySelector('.feed').textContent=o.lines.join('\n');}if(e.data?.sagaMotion==='active')active=!!e.data.active;if(e.data?.sagaMotion==='reset')reset();if(e.data?.sagaMotion==='start'){reset();started=true;active=true;phase='recognize';chat.hidden=false;}});
  if(o.type==='chat'&&o.manual){const request=e=>{if(!active)return;if(e.type==='keydown'&&![' ','Enter','ArrowRight','PageDown'].includes(e.key))return;e.preventDefault();message('start-request');};document.addEventListener('click',request);document.addEventListener('keydown',request);}
  if(o.type==='chat'&&!o.manual){started=true;phase='recognize';chat.hidden=false;}
  function bubble(text,kind){const el=document.createElement('div');el.className='bubble '+kind;el.textContent=text;thread.append(el);return el;}

package/src/package.js

@@ -78,6 +78,21 @@ export async function packDeck(spec, { baseDir, name = "apresentacao", generator
     created: new Date().toISOString(), generator }, null, 2));
   root.file(main, YAML.stringify(packagedSpec(spec, assets), { indent: 2, lineWidth: 0 }));
   const files = [], missing = [];
+  const pesquisa = [];
+  try {
+    const pdir = path.join(dir, "contexto", "pesquisa");
+    for (const f of fs.readdirSync(pdir)) {
+      const abs = path.join(pdir, f);
+      if (fs.statSync(abs).isFile()) pesquisa.push({ rel: `contexto/pesquisa/${f}`, abs });
+    }
+  } catch {}
+  let budget = 2 * 1024 * 1024; // a pesquisa viaja junto, sem estourar o pacote
+  const skipped = [];
+  for (const q of pesquisa) {
+    const size = fs.statSync(q.abs).size;
+    if (size <= budget) { root.file(q.rel, fs.readFileSync(q.abs)); files.push(q.rel); budget -= size; }
+    else skipped.push(q.rel);
+  }
   for (const a of assets) {
     if (a.exists) { root.file(a.rel, fs.readFileSync(a.abs)); files.push(a.rel); }
     else missing.push(a.ref);
@@ -86,7 +101,7 @@ export async function packDeck(spec, { baseDir, name = "apresentacao", generator
     root.file("FALTANDO.txt", `Estes arquivos são usados pela apresentação, mas não foram encontrados em ${dir}:\n\n` +
       missing.map((m) => `- ${m}`).join("\n") + "\n\nColoque-os nesta pasta (mesmo caminho) para a apresentação ficar completa.\n");
   }
-  return { zip: await zip.generateAsync({ type: "nodebuffer", compression: "DEFLATE" }), files, missing };
+  return { zip: await zip.generateAsync({ type: "nodebuffer", compression: "DEFLATE" }), files, missing, pesquisaSkipped: skipped };
 }
 
 // Extrai um pacote numa pasta nova (nunca sobrescreve) e devolve o .yaml principal.

package/src/research/brave.js

@@ -0,0 +1,12 @@
+// Buscador com chave (fase 3): Brave Search API. Só entra na cadeia com BRAVE_SEARCH_KEY
+// (sem chave, é pulado em silêncio — nunca trava a pesquisa por falta de configuração).
+export async function searchBrave(query, { limit = 8, timeoutMs = 12000, key = process.env.BRAVE_SEARCH_KEY } = {}) {
+  if (!key) return [];
+  const url = `https://api.search.brave.com/res/v1/web/search?q=${encodeURIComponent(query)}&count=${Math.min(limit, 20)}&text_decorations=0`;
+  const res = await fetch(url, { signal: AbortSignal.timeout(timeoutMs), headers: { "X-Subscription-Token": key, "Accept": "application/json" } });
+  if (!res.ok) throw new Error(`Brave respondeu HTTP ${res.status}`);
+  const j = await res.json();
+  return ((j.web && j.web.results) || []).slice(0, limit)
+    .map((r) => ({ title: String(r.title || r.url), url: String(r.url || ""), snippet: String(r.description || "").slice(0, 300), date: String(r.age || "") }))
+    .filter((r) => /^https?:\/\//.test(r.url));
+}

package/src/research/chat-research.js

@@ -0,0 +1,29 @@
+// Pesquisa web no chat de um deck aberto (fase 2): a mesma decisão do `new`
+// (a IA diz se o que ela sabe basta), mas com o pedido da mensagem.
+// Se precisar, busca, lê e anota; os materiais [F1]… entram no prompt junto
+// com a instrução de citação, e tudo fica em contexto/pesquisa/ do deck.
+// Sem internet (SAGADECK_WEB=0, a rede do banco): avisa e segue sem inventar.
+// Falhou: segue com o que a IA sabe (o chat nunca trava por causa da pesquisa).
+import { decideResearch, runResearch, researchInstruction, defaultWeb } from "./research.js";
+
+const today = () => new Date().toISOString().slice(0, 10);
+
+export async function maybeResearch({ prompt, materials = [], saveDir = null, onProgress = () => {}, web = null } = {}) {
+  try {
+    const plan = await decideResearch(prompt, { materials });
+    if (!plan.pesquisar) return { materials, report: { pesquisou: false, motivo: plan.motivo }, instruction: "" };
+    onProgress(`vou pesquisar: ${plan.motivo}`);
+    if (process.env.SAGADECK_WEB === "0") {
+      const report = { pesquisou: true, motivo: plan.motivo, buscas: plan.buscas, fontes: [], falhas: ["web desligada"], offline: true, data: today() };
+      return { materials, report, instruction: researchInstruction(report) };
+    }
+    const r = await runResearch(plan, { briefing: prompt, web: web || defaultWeb, onProgress, saveDir });
+    onProgress(r.materials.length
+      ? `pesquisa: ${r.materials.length} fonte(s) lida(s) (${r.report.fontes.map((f) => f.site).join(", ")})`
+      : "a pesquisa não achou fonte que desse para ler; sigo com o que eu sei, sem inventar dado recente.");
+    return { materials: [...materials, ...r.materials], report: r.report, instruction: researchInstruction(r.report) };
+  } catch (e) {
+    onProgress(`a pesquisa falhou (${e.message}); sigo com o que eu sei`);
+    return { materials, report: null, instruction: "" };
+  }
+}

package/src/research/links.js

@@ -0,0 +1,37 @@
+// Checagem de links das fontes da pesquisa: a URL continua de pé?
+// Base para `sagadeck links deck.yaml` (lê contexto/pesquisa/fontes.json ao lado do deck).
+import fs from "node:fs";
+import path from "node:path";
+
+export function linksOfDeck(deckDir) {
+  try {
+    const report = JSON.parse(fs.readFileSync(path.join(deckDir, "contexto", "pesquisa", "fontes.json"), "utf8"));
+    const urls = [...new Set((report.fontes || []).map((f) => f?.url).filter((u) => typeof u === "string" && /^https?:/i.test(u)))];
+    return urls;
+  } catch { return []; }
+}
+
+export async function checkLinks(urls, { fetchFn = fetch, timeoutMs = 15000 } = {}) {
+  const out = [];
+  for (const url of urls || []) {
+    try {
+      const ctrl = new AbortController();
+      const t = setTimeout(() => ctrl.abort(), timeoutMs);
+      try {
+        const r = await fetchFn(url, { redirect: "follow", signal: ctrl.signal });
+        out.push({ url, ok: !!r.ok, status: r.status });
+      } finally { clearTimeout(t); }
+    } catch (e) {
+      out.push({ url, ok: false, status: 0, erro: e?.name === "AbortError" ? "tempo esgotado" : String(e?.message || e).slice(0, 120) });
+    }
+  }
+  return out;
+}
+
+export function formatLinks(rows) {
+  if (!rows.length) return "sem links para conferir.";
+  const bad = rows.filter((r) => !r.ok);
+  return [`${rows.length - bad.length} de ${rows.length} links respondendo:`,
+    ...rows.map((r) => `  ${r.ok ? "ok " : "QUEBROU"} ${r.status || "-"} ${r.url}${r.erro ? ` (${r.erro})` : ""}`),
+  ].join("\n");
+}

package/src/research/research.js

@@ -14,6 +14,8 @@ import path from "node:path";
 import { chat } from "../ai/llm.js";
 import { fetchUrlDoc } from "../ai/context.js";
 import { searchDuckDuckGo } from "./duckduckgo.js";
+import { searchWikipedia } from "./wikipedia.js";
+import { searchBrave } from "./brave.js";
 
 const today = () => new Date().toISOString().slice(0, 10);
 const clip = (s, n) => (String(s ?? "").length > n ? String(s).slice(0, n - 1) + "…" : String(s ?? ""));
@@ -73,10 +75,21 @@ export async function llmSearch(q, { limit = 8 } = {}) {
   const t = r.text || "", m = t.match(/```(?:json)?\s*([\s\S]*?)```/), raw = m ? m[1] : t.slice(t.indexOf("["), t.lastIndexOf("]") + 1);
   return (JSON.parse(raw) || []).filter((x) => /^https?:\/\//.test(x?.url || "")).slice(0, limit).map((x) => ({ title: String(x.title || x.url), url: String(x.url), snippet: String(x.snippet || ""), date: String(x.date || "") }));
 }
+const BACKENDS = {
+  llm: (q) => llmSearch(q),
+  duckduckgo: (q) => searchDuckDuckGo(q, { limit: 8, timeoutMs: 12000 }),
+  brave: (q) => searchBrave(q),
+  wikipedia: (q) => searchWikipedia(q),
+};
+// cadeia configurável: SAGADECK_SEARCH_BACKENDS="brave,llm,duckduckgo" (nomes desconhecidos são ignorados)
+export function searchChain() {
+  const names = String(process.env.SAGADECK_SEARCH_BACKENDS || "llm,duckduckgo,wikipedia").split(",").map((s) => s.trim()).filter(Boolean);
+  return names.filter((n) => BACKENDS[n]);
+}
 async function searchAny(q) {
   const errors = [];
-  for (const f of [() => llmSearch(q), () => searchDuckDuckGo(q, { limit: 8, timeoutMs: 12000 })]) {
-    try { const r = await f(); if (r.length) return r; errors.push("nenhum resultado"); } catch (e) { errors.push(e.message); }
+  for (const name of searchChain()) {
+    try { const r = await BACKENDS[name](q); if (r.length) return r; errors.push(`${name}: nenhum resultado`); } catch (e) { errors.push(`${name}: ${e.message}`); }
   }
   throw new Error(`nenhum buscador respondeu (${errors.join("; ")})`);
 }
@@ -109,11 +122,38 @@ Responda só JSON: {"pesquisar": true|false, "externalAuthorized": true|false, "
   return { pesquisar: !!r.pesquisar && (!materials.some(m=>m.kind !== 'pesquisa') || r.externalAuthorized === true), motivo: String(r.motivo || ""), academico: !!r.academico, buscas: (Array.isArray(r.buscas) ? r.buscas : []).map(String).filter(Boolean).slice(0, 5) };
 }
 
+// ---- cache de busca: a mesma pergunta não paga o buscador duas vezes (TTL em dias) -------------------------------
+const cacheFile = (saveDir) => (saveDir ? path.join(saveDir, "contexto", "pesquisa", "busca-cache.json") : null);
+const cacheDays = () => Number(process.env.SAGADECK_SEARCH_CACHE_DIAS || 7);
+function readSearchCache(saveDir) {
+  try { return JSON.parse(fs.readFileSync(cacheFile(saveDir), "utf8")); } catch { return {}; }
+}
+function writeSearchCache(saveDir, cache) {
+  fs.mkdirSync(path.dirname(cacheFile(saveDir)), { recursive: true });
+  fs.writeFileSync(cacheFile(saveDir), JSON.stringify(cache));
+}
+export function cachedWeb(web, saveDir) {
+  if (!saveDir) return web;
+  const memo = async (kind, q, fn) => {
+    const key = `${kind}:${String(q).trim().toLowerCase()}`;
+    const hit = readSearchCache(saveDir)[key];
+    if (hit && Array.isArray(hit.resultados) && Date.now() - hit.quando < cacheDays() * 864e5) return hit.resultados;
+    const r = await fn(q);
+    try { const c = readSearchCache(saveDir); c[key] = { quando: Date.now(), resultados: r }; writeSearchCache(saveDir, c); } catch {}
+    return r;
+  };
+  return { ...web,
+    search: (q) => memo("web", q, (x) => web.search(x)),
+    ...(web.arxiv ? { arxiv: (q) => memo("arxiv", q, (x) => web.arxiv(x)) } : {}),
+  };
+}
+
 // ---- 2 a 5 -------------------------------------------------------------------------------------------------------
 const siteOf = (u) => { try { return new URL(u).hostname.replace(/^www\./, ""); } catch { return ""; } };
 const isArxiv = (u) => /arxiv\.org\/(abs|pdf)\//.test(u);
 
 export async function runResearch(plan, { briefing = "", web = defaultWeb, onProgress = () => {}, saveDir = null, maxSources = 8, annotationTimeoutMs = 45000 } = {}) {
+  web = cachedWeb(web, saveDir);
   const report = { pesquisou: true, motivo: plan.motivo, buscas: plan.buscas, fontes: [], descartadas: 0, falhas: [], offline: false, data: today() };
   // 2. buscar
   onProgress(`Pesquisando: ${plan.buscas.join(" · ")}`);

package/src/research/wikipedia.js

@@ -0,0 +1,15 @@
+// Buscador sem chave (fase 3): Wikipedia via OpenSearch. Cobre o caso "referência estável"
+// quando o LLM e o DuckDuckGo falham; sem snippet longo, mas com URL exata e descrição curta.
+export async function searchWikipedia(query, { limit = 5, lang = "pt", timeoutMs = 10000 } = {}) {
+  const attempt = async (wiki) => {
+    const url = `https://${wiki}.wikipedia.org/w/api.php?action=opensearch&search=${encodeURIComponent(query)}&limit=${limit}&namespace=0&format=json`;
+    const res = await fetch(url, { signal: AbortSignal.timeout(timeoutMs), headers: { "user-agent": "sagadeck/1.0 (pesquisa para apresentação)" } });
+    if (!res.ok) throw new Error(`Wikipedia (${wiki}) respondeu HTTP ${res.status}`);
+    const [, titles = [], descs = [], links = []] = await res.json();
+    return titles.map((title, i) => ({ title, url: links[i] || "", snippet: (descs[i] || "").slice(0, 300), date: "" })).filter((r) => /^https?:\/\//.test(r.url));
+  };
+  const pt = await attempt(lang).catch(() => []);
+  if (pt.length || lang === "en") return pt.slice(0, limit);
+  const en = await attempt("en").catch(() => []);
+  return [...pt, ...en].slice(0, limit);
+}

package/src/runtime/base.css

@@ -137,8 +137,8 @@ body{-webkit-font-smoothing:antialiased;text-rendering:optimizeLegibility;font-k
 .muted{color:var(--muted)}
 .em{color:var(--em)}
 .t a{color:inherit;text-decoration-thickness:.06em;text-underline-offset:.14em}
-mark{color:var(--on-hi);background:linear-gradient(var(--hi),var(--hi)) no-repeat 0 55%/0% 92%;padding:0 .1em;margin:0 -.04em;-webkit-box-decoration-break:clone;box-decoration-break:clone;transition:background-size .8s var(--ease-out) .25s}
-mark.play{background-size:100% 92%}
+mark{color:var(--on-hi);background:linear-gradient(var(--hi),var(--hi)) no-repeat 0 58%/0% 84%;padding:0 .1em;margin:0 -.04em;-webkit-box-decoration-break:clone;box-decoration-break:clone;transition:background-size .8s var(--ease-out) .25s}
+mark.play{background-size:100% 84%}
 /* estilos alternativos do ==destaque== (markStyle) */
 .ms-sublinhado mark{background:none;color:inherit;padding:0;margin:0;text-decoration:underline;text-decoration-color:var(--hi);text-decoration-thickness:.12em;text-underline-offset:.16em}
 .ms-cor mark{background:none;color:var(--em);padding:0;margin:0}
@@ -439,16 +439,16 @@ code.f-mono{font-size:.86em;background:color-mix(in srgb,var(--fg) 9%,transparen
 .av-perigo .av-icon{color:var(--alert)}
 .av-perigo .av-title{text-transform:uppercase;letter-spacing:.04em}
 
-.tl{position:relative;display:grid;grid-template-columns:repeat(var(--n),1fr);gap:40px;flex:1;align-content:center}
+.tl{position:relative;display:grid;grid-template-columns:repeat(var(--n),1fr);gap:40px;flex:1;align-content:center;min-height:520px}
 .tl-line{position:absolute;left:0;right:0;top:50%;height:6px;background:var(--line);border-radius:3px;display:none}
-.tl-ev{position:relative;display:flex;flex-direction:column;gap:16px;padding-top:62px}
+.tl-ev{position:relative;display:flex;flex-direction:column;gap:20px;padding-top:62px;min-width:0}
 .tl-dot{position:absolute;top:0;left:0;width:44px;height:44px;border-radius:50%;background:var(--bg);border:8px solid var(--fg)}
 .tl-ev::before{content:"";position:absolute;left:44px;right:-40px;top:19px;height:6px;background:var(--line)}
 .tl-ev:last-child::before{display:none}
 .tl-ev.hl .tl-dot{background:var(--hi)}
-.tl-when{font-size:96px;line-height:.9}
+.tl-when{font-size:calc(max(54px, 96px - max(0px, (var(--n, 3) - 3) * 13px)));line-height:.95;overflow-wrap:anywhere}
 .tl-ev.hl .tl-when{color:var(--em)}
-.tl-title{font-size:42px}
+.tl-title{font-size:42px;overflow-wrap:anywhere}
 .tl-text{font-size:30px;color:var(--muted)}
 .tl-tag{font-size:20px;color:var(--em)}
 .tl-after{margin-top:auto}

package/src/runtime/motion.js

@@ -9,7 +9,7 @@ for(const frame of document.querySelectorAll('iframe[data-motion]')){
   const begin=e=>{if(!slide?.classList.contains('current')||done||e.target.closest('input,textarea,select,[contenteditable=true]'))return;if(e.type==='keydown'&&![' ','Enter','ArrowRight','PageDown'].includes(e.key))return;e.preventDefault();e.stopImmediatePropagation();if(started){finish();return;}started=true;send('start');};
   document.addEventListener('keydown',begin,true);slide.addEventListener('click',begin,true);
  }
- window.addEventListener('message',e=>{if(e.source!==frame.contentWindow)return;if(e.data?.sagaMotion==='done')finish();if(e.data?.sagaMotion==='start-request'&&slide?.classList.contains('current')&&!done){if(started)finish();else{started=true;send('start');}}});
+ window.addEventListener('message',e=>{if(e.source!==frame.contentWindow)return;if(e.data?.sagaMotion==='done')finish();if(e.data?.sagaMotion==='ready')activate();if(e.data?.sagaMotion==='start-request'&&slide?.classList.contains('current')&&!done){if(started)finish();else{started=true;send('start');}}});
  const activate=()=>{const active=slide?.classList.contains('current');send('active',active);if(document.documentElement.classList.contains('export')||document.documentElement.dataset.motion==='none'||matchMedia('(prefers-reduced-motion: reduce)').matches)send('poster');if(!active){started=false;done=false;frame.style.visibility='';send('reset');}};
  frame.addEventListener('load',activate);if(slide)new MutationObserver(activate).observe(slide,{attributes:true,attributeFilter:['class']});
 }

package/src/runtime/runtime.js

@@ -809,8 +809,21 @@
       document.body.classList.add("mouse"); clearTimeout(mt); mt = setTimeout(() => document.body.classList.remove("mouse"), 1600);
       const l = $("#laser"); l.style.left = e.clientX + "px"; l.style.top = e.clientY + "px";
     });
-    let tx = null; document.addEventListener("touchstart", (e) => (tx = e.touches[0].clientX));
-    document.addEventListener("touchend", (e) => { if (tx == null) return; const d = e.changedTouches[0].clientX - tx; if (Math.abs(d) > 50) cmd(d < 0 ? "next" : "prev"); tx = null; });
+    // Mobile: arrastar pro lado troca de slide; tocar (sem arrastar) avança. Toque em controle
+    // (botão, link, campo, vídeo, widget, ir-para) continua sendo do controle, nunca avança.
+    let tx = null, ty = null, tt = 0;
+    document.addEventListener("touchstart", (e) => { const t = e.touches[0]; tx = t.clientX; ty = t.clientY; tt = Date.now(); }, { passive: true });
+    document.addEventListener("touchend", (e) => {
+      if (tx == null) return;
+      const t = e.changedTouches[0], dx = t.clientX - tx, dy = t.clientY - ty, dt = Date.now() - tt;
+      tx = ty = null;
+      if (Math.abs(dx) > 50 && Math.abs(dx) > Math.abs(dy)) { cmd(dx < 0 ? "next" : "prev"); return; }
+      if (Math.abs(dx) < 12 && Math.abs(dy) < 12 && dt < 500 && !e.target.closest("a,button,input,textarea,select,[contenteditable],video,audio,iframe,.widget,[data-goto]")) {
+        const sel = typeof getSelection === "function" && getSelection();
+        if (sel && !sel.isCollapsed) return; // selecionando texto: não avança
+        cmd("next");
+      }
+    }, { passive: true });
     const [i, k] = parseHash();
     slides.forEach((s) => s.classList.remove("current"));
     cur = -1;