sagadeck 1.4.0 → 1.6.0

package/src/library.js

@@ -9,25 +9,75 @@
 //       rascunho.yaml                 um .yaml solto no tópico também é uma apresentação
 //     rascunho.yaml                   .yaml solto na raiz = apresentação sem tópico
 // Na raiz, pasta é SEMPRE tópico. "Nova sem tópico" vai para "Sem tópico"; importar sem tópico, para "Importados".
-//     .lixeira/                       excluídas (30 dias), com .origem.json
+//     .lixeira/                       excluídas (1 dia), com .origem.json
 //     .cache/                         capas geradas
 //
 // O id de uma apresentação é o caminho do .yaml dela, relativo à biblioteca, com "/" (ex.: "Palestras/X/X.yaml").
 import fs from "node:fs";
+import { renameRetry } from "./fs-retry.js";
 import os from "node:os";
+import { execFileSync } from "node:child_process";
 import path from "node:path";
 import YAML from "yaml";
 import * as MASTER from "./master.js";
 import { unpackDeck } from "./package.js";
 import { writeDeckFile } from "./deck-file.js";
+import { loadPreferences } from "./preferences.js";
 
-export const TRASH_DAYS = 30;
+export const TRASH_DAYS = 30; // padrão; cada máquina escolhe em Preferências › Biblioteca (lixeiraDias)
 const TRASH = ".lixeira";
 const TOPIC_META = ".topico.json";
 const COLORS = ["#d33a2c", "#0f6cbd", "#e5a50a", "#8b5cf6", "#0e9f6e", "#e8590c", "#d6336c", "#495057"];
 
-export function defaultLibraryRoot(env = process.env) {
-  return path.resolve(env.SAGADECK_HOME || path.join(os.homedir(), "sagadeck"));
+// Pasta Documentos do Windows como o Explorer a mostra: a pasta conhecida "Personal" do registro, que pode estar
+// redirecionada (OneDrive\Documents, outro disco, "Documentos"). Sem ela, %USERPROFILE%\Documents. Fora do Windows, null.
+let documentsCache;
+export function documentsDir({ platform = process.platform, home = os.homedir() } = {}) {
+  if (platform !== "win32") return null;
+  if (documentsCache !== undefined && home === os.homedir()) return documentsCache;
+  let found = null;
+  try {
+    const out = execFileSync("reg", ["query", "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\Shell Folders", "/v", "Personal"], { encoding: "utf8", windowsHide: true, timeout: 5000 });
+    found = out.match(/Personal\s+REG_\w+\s+(.+)/)?.[1]?.trim() || null;
+  } catch { /* sem registro: o padrão abaixo */ }
+  const dir = found && path.isAbsolute(found) ? found : path.join(home, "Documents");
+  if (home === os.homedir()) documentsCache = dir;
+  return dir;
+}
+
+// A biblioteca: SAGADECK_HOME, senão <Documentos>\sagadeck no Windows e ~/sagadeck fora dele. Enquanto a biblioteca
+// antiga (~/sagadeck, o padrão até a 1.4) não foi movida para Documentos, ela continua valendo: nunca abre vazia.
+export function defaultLibraryRoot(env = process.env, { platform = process.platform, home = os.homedir(), documents } = {}) {
+  if (env.SAGADECK_HOME) return path.resolve(env.SAGADECK_HOME);
+  const legacy = path.join(home, "sagadeck");
+  const docs = documents !== undefined ? documents : documentsDir({ platform, home });
+  if (!docs) return path.resolve(legacy);
+  const target = path.join(docs, "sagadeck");
+  if (!fs.existsSync(target) && hasContent(legacy) && !isLink(legacy)) return path.resolve(legacy);
+  return path.resolve(target);
+}
+
+const isLink = (p) => { try { return fs.lstatSync(p).isSymbolicLink(); } catch { return false; } };
+const hasContent = (p) => { try { return fs.readdirSync(p).length > 0; } catch { return false; } };
+
+// Leva a biblioteca antiga (~/sagadeck) para <Documentos>\sagadeck, uma vez: move a pasta inteira (mesma unidade:
+// instantâneo) e deixa no lugar antigo uma junção para a nova, para atalhos e configurações antigas continuarem
+// valendo. Não mexe se SAGADECK_HOME manda, se a nova já tem conteúdo (não mistura bibliotecas) ou se a antiga já
+// é a junção. Falhou (arquivo aberto, outra unidade): a antiga continua sendo a biblioteca e tenta de novo depois.
+export function migrateLegacyLibrary(env = process.env, { platform = process.platform, home = os.homedir(), documents } = {}) {
+  if (env.SAGADECK_HOME) return { skipped: "SAGADECK_HOME" };
+  const docs = documents !== undefined ? documents : documentsDir({ platform, home });
+  if (!docs) return { skipped: "fora do Windows" };
+  const legacy = path.join(home, "sagadeck"), target = path.join(docs, "sagadeck");
+  if (path.resolve(legacy) === path.resolve(target) || isLink(legacy) || !hasContent(legacy)) return { skipped: "nada a mover" };
+  if (hasContent(target)) return { skipped: "as duas têm conteúdo", legacy, target };
+  try {
+    fs.mkdirSync(docs, { recursive: true });
+    if (fs.existsSync(target)) fs.rmdirSync(target); // pasta vazia criada antes
+    renameRetry(legacy, target);
+  } catch (e) { return { error: e.message, legacy, target }; }
+  try { fs.symlinkSync(target, legacy, "junction"); } catch { /* sem a junção, a nova pasta já é a biblioteca */ }
+  return { moved: true, legacy, target };
 }
 
 // Onde uma apresentação NOVA é gravada: sempre na biblioteca. Um caminho dentro dela é respeitado; qualquer
@@ -65,8 +115,11 @@ const isYaml = (name) => /\.ya?ml$/i.test(name) && !hidden(name);
 
 // nome de pasta/arquivo válido no Windows (e no Linux): sem <>:"/\|?*, sem ponto/espaço no fim
 export function safeName(s, fallback = "Sem título") {
-  const clean = String(s || "").normalize("NFC").replace(/[<>:"/\\|?*\u0000-\u001f]/g, " ").replace(/\s+/g, " ").trim()
-    .replace(/[. ]+$/, "").slice(0, 80).trim();
+  let clean = String(s || "").normalize("NFC").replace(/[<>:"/\\|?*\u0000-\u001f]/g, " ").replace(/\s+/g, " ").trim()
+    .replace(/[. ]+$/, "");
+  // nome longo corta no último espaço antes de 80 (a pasta saía "…and Urban Flood Predic")
+  if (clean.length > 80) { const cut = clean.slice(0, 81).lastIndexOf(" "); clean = clean.slice(0, cut >= 40 ? cut : 80); }
+  clean = clean.replace(/[\s.,;:—–-]+$/, "").trim();
   return /^(con|prn|aux|nul|com\d|lpt\d)$/i.test(clean) || !clean ? fallback : clean;
 }
 
@@ -76,7 +129,9 @@ function uniquePath(dir, name, ext = "") {
   return p;
 }
 
-export function openLibrary(root) {
+// trashDays: quantos dias a lixeira guarda (padrão: o das Preferências desta máquina, lido a cada limpeza)
+export function openLibrary(root, { trashDays } = {}) {
+  const keepDays = () => trashDays ?? loadPreferences().biblioteca?.lixeiraDias ?? TRASH_DAYS;
   root = path.resolve(root);
   fs.mkdirSync(root, { recursive: true });
 
@@ -139,7 +194,7 @@ export function openLibrary(root) {
       topics.push({ id: e.name, name: e.name, color: meta.color || COLORS[topics.length % COLORS.length], count: mine.length, created: meta.created || 0 });
     }
     topics.sort((a, b) => a.name.localeCompare(b.name, "pt-BR"));
-    return { root, topics, decks, trash: listTrash() };
+    return { root, topics, decks, trash: listTrash(), trashDays: keepDays() };
   }
 
   // ---- tópicos ----
@@ -164,7 +219,7 @@ export function openLibrary(root) {
     if (color) fs.writeFileSync(path.join(dir, TOPIC_META), JSON.stringify({ ...topicMeta(dir), color }));
     if (name && safeName(name) !== path.basename(dir)) {
       const to = uniquePath(root, safeName(name));
-      fs.renameSync(dir, to);
+      renameRetry(dir, to);
       dir = to;
     }
     return path.basename(dir);
@@ -208,7 +263,7 @@ export function openLibrary(root) {
     if (path.dirname(unit) === dest) return id;
     const ext = unit === file ? path.extname(file) : "";
     const to = uniquePath(dest, path.basename(unit, ext), ext);
-    fs.renameSync(unit, to);
+    renameRetry(unit, to);
     return idOf(unit === file ? to : path.join(to, path.basename(file)));
   }
 
@@ -220,12 +275,12 @@ export function openLibrary(root) {
     if (unit === file) return id; // .yaml solto: só o título
     const to = uniquePath(path.dirname(unit), safeName(title));
     if (path.basename(to) === path.basename(unit)) return id;
-    fs.renameSync(unit, to);
+    renameRetry(unit, to);
     // o .yaml com o nome da pasta acompanha a pasta
     let yaml = path.join(to, path.basename(file));
     if (path.basename(file).replace(/\.ya?ml$/i, "") === path.basename(unit)) {
       const renamed = path.join(to, path.basename(to) + path.extname(file));
-      fs.renameSync(yaml, renamed);
+      renameRetry(yaml, renamed);
       yaml = renamed;
     }
     return idOf(yaml);
@@ -240,7 +295,7 @@ export function openLibrary(root) {
     let yaml = unit === file ? to : path.join(to, path.basename(file));
     if (unit !== file && path.basename(file).replace(/\.ya?ml$/i, "") === path.basename(unit)) {
       const renamed = path.join(to, path.basename(to) + path.extname(file));
-      fs.renameSync(yaml, renamed);
+      renameRetry(yaml, renamed);
       yaml = renamed;
     }
     const spec = YAML.parse(fs.readFileSync(yaml, "utf8")) || {};
@@ -283,9 +338,9 @@ export function openLibrary(root) {
     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);
+    renameRetry(abs, dest);
     const final = path.join(dest, path.basename(dest) + ".yaml");
-    fs.renameSync(path.join(dest, "deck.yaml"), final);
+    renameRetry(path.join(dest, "deck.yaml"), final);
     writeDeckFile(final, spec); // só o título muda no arquivo
     return idOf(final);
   }
@@ -296,7 +351,7 @@ export function openLibrary(root) {
     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)));
+    renameRetry(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 {}
@@ -327,7 +382,7 @@ export function openLibrary(root) {
     fs.mkdirSync(tdir, { recursive: true });
     const slot = path.join(tdir, `${Date.now()}-${path.basename(unit)}`);
     fs.mkdirSync(slot);
-    fs.renameSync(unit, path.join(slot, path.basename(unit)));
+    renameRetry(unit, path.join(slot, path.basename(unit)));
     fs.writeFileSync(path.join(slot, ".origem.json"), JSON.stringify({
       topic: info.topic, title: info.title, deleted: Date.now(), yaml: path.relative(unit === file ? path.dirname(file) : unit, file),
       unit: path.basename(unit), slides: info.slides,
@@ -348,7 +403,7 @@ export function openLibrary(root) {
     const isFile = /\.ya?ml$/i.test(o.unit);
     const ext = isFile ? path.extname(o.unit) : "";
     const to = uniquePath(dest, path.basename(o.unit, ext), ext);
-    fs.renameSync(path.join(slot, o.unit), to);
+    renameRetry(path.join(slot, o.unit), to);
     fs.rmSync(slot, { recursive: true, force: true });
     return idOf(isFile ? to : path.join(to, o.yaml));
   }
@@ -362,7 +417,8 @@ export function openLibrary(root) {
     return all.length;
   }
   function purgeOld(now = Date.now()) {
-    for (const t of listTrash()) if (now - t.deleted > TRASH_DAYS * 864e5) purgeDeck(t.id);
+    const days = keepDays();
+    for (const t of listTrash()) if (now - t.deleted > days * 864e5) purgeDeck(t.id);
   }
 
   // ---- importar .sagadeck / .zip ----

package/src/locale.js

@@ -0,0 +1,18 @@
+// Idioma dos números do deck (`lang`, padrão pt-BR): contador, gráficos e mapas formatavam sempre em português, e um
+// deck em inglês mostrava "1.403" (mil quatrocentos e três) e "0,93". A renderização é síncrona, slide a slide: quem
+// monta o deck (build.js) define o idioma antes e os desenhos leem daqui.
+let current = "pt-BR";
+
+export function normalizeLocale(lang) {
+  const l = String(lang || "").trim();
+  if (!l) return "pt-BR";
+  if (/^pt/i.test(l)) return "pt-BR";
+  if (/^en/i.test(l)) return /^en-GB/i.test(l) ? "en-GB" : "en-US";
+  try { return Intl.getCanonicalLocales(l)[0]; } catch { return "pt-BR"; }
+}
+
+export function setDeckLocale(lang) { current = normalizeLocale(lang); return current; }
+export const deckLocale = () => current;
+export const formatNumber = (v, opts) => Number(v).toLocaleString(current, opts);
+// separador decimal do idioma atual ("," em pt-BR, "." em en-US)
+export const decimalSeparator = (locale = current) => (1.5).toLocaleString(locale).replace(/\d/g, "")[0] || ",";

package/src/mcp/server.js

@@ -82,7 +82,7 @@ const TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        path: { type: "string", description: "Nome da apresentação (ou caminho dentro da biblioteca SAGADECK_HOME/~/sagadeck). Toda apresentação é gravada na biblioteca: caminho de fora vira só o nome, e nada é sobrescrito" },
+        path: { type: "string", description: "Nome da apresentação (ou caminho dentro da biblioteca SAGADECK_HOME ou Documentos/sagadeck). Toda apresentação é gravada na biblioteca: caminho de fora vira só o nome, e nada é sobrescrito" },
         title: { type: "string", description: "Título provisório da apresentação" },
         theme: {
           type: "string",
@@ -105,7 +105,7 @@ const TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        path: { type: "string", description: "Nome da apresentação (ou caminho dentro da biblioteca SAGADECK_HOME/~/sagadeck). Toda apresentação é gravada na biblioteca: caminho de fora vira só o nome, e nada é sobrescrito" },
+        path: { type: "string", description: "Nome da apresentação (ou caminho dentro da biblioteca SAGADECK_HOME ou Documentos/sagadeck). Toda apresentação é gravada na biblioteca: caminho de fora vira só o nome, e nada é sobrescrito" },
         title: { type: "string", description: "Título da apresentação" },
         theme: {
           type: "string",

package/src/motion.js

@@ -22,11 +22,11 @@ function drawTrace(ctx,o,t,w,h){
  ctx.restore();
 }
 function scene(o){
- let active=o.type!=='chat',started=false,epoch=performance.now(),serial=0,phase='idle',elapsed=0,previous=0;let reduced=matchMedia('(prefers-reduced-motion:reduce)').matches;const main=document.querySelector('main'),canvas=document.querySelector('canvas'),ctx=canvas.getContext('2d');
+ let active=o.type!=='chat',started=false,epoch=performance.now(),serial=0,phase='idle',elapsed=0,previous=0;const reduceQuery=matchMedia('(prefers-reduced-motion:reduce)');let still=false,reduced=!!o.still||reduceQuery.matches;const recompute=()=>{reduced=!!o.still||still||reduceQuery.matches;};reduceQuery.addEventListener?.('change',recompute);const main=document.querySelector('main'),canvas=document.querySelector('canvas'),ctx=canvas.getContext('2d');
  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='';}
- 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;}});
+ window.__sagaMotion=()=>({active,reduced,started,serial,phase});message('ready');window.addEventListener('message',e=>{if(e.source!==parent)return;if(e.data?.sagaMotion==='poster'){still=e.data.active!==false;recompute();if(reduced&&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;}
@@ -51,6 +51,8 @@ function scene(o){
  }
  requestAnimationFrame(draw);
 }
-export function motionHTML(value,colors){const o=motionOptions(value,colors);const css=`html,body{height:100%;background:${o.type==='chat'?'transparent':o.background};color:${o.foreground};overflow:hidden}main{height:100%;position:relative}canvas{position:absolute;inset:0;width:100%;height:100%}.caption{position:absolute;top:12px;left:16px;color:${o.secondary};font:11px monospace;letter-spacing:1.5px}.feed{position:absolute;top:36px;left:16px;right:16px;bottom:12px;overflow:hidden;font:${o.type==='terminal'?o.fontSize:12}px/1.5 monospace;white-space:pre}.chat{position:absolute;inset:0;border:1px solid ${o.secondary};border-radius:16px;padding:18px;background:${o.background};display:flex;flex-direction:column;gap:12px}.chat[hidden]{display:none}.thread{flex:1;overflow:auto;display:flex;flex-direction:column;gap:12px}.bubble{font:18px/1.45 system-ui;max-width:90%;padding:10px 14px;border-radius:10px;white-space:pre-wrap}.user{align-self:flex-end;background:#263a51}.assistant{align-self:flex-start}.status{font:14px system-ui;color:${o.secondary};min-height:18px}.input{border:1px solid #51617b;border-radius:9px;min-height:48px;padding:12px;font:17px system-ui;white-space:pre-wrap}.chat-title{font:12px system-ui;letter-spacing:2px;color:${o.secondary}}`;
+// still: o deck pediu movimento nenhum (motion: none). A cena já nasce parada e completa; antes ela só sabia pela
+// mensagem da página, que sob carga chegava depois de o terminal começar a digitar.
+export function motionHTML(value,colors,{still=false}={}){const o={...motionOptions(value,colors),...(still?{still:true}:{})};const css=`html,body{height:100%;background:${o.type==='chat'?'transparent':o.background};color:${o.foreground};overflow:hidden}main{height:100%;position:relative}canvas{position:absolute;inset:0;width:100%;height:100%}.caption{position:absolute;top:12px;left:16px;color:${o.secondary};font:11px monospace;letter-spacing:1.5px}.feed{position:absolute;top:36px;left:16px;right:16px;bottom:12px;overflow:hidden;font:${o.type==='terminal'?o.fontSize:12}px/1.5 monospace;white-space:pre}.chat{position:absolute;inset:0;border:1px solid ${o.secondary};border-radius:16px;padding:18px;background:${o.background};display:flex;flex-direction:column;gap:12px}.chat[hidden]{display:none}.thread{flex:1;overflow:auto;display:flex;flex-direction:column;gap:12px}.bubble{font:18px/1.45 system-ui;max-width:90%;padding:10px 14px;border-radius:10px;white-space:pre-wrap}.user{align-self:flex-end;background:#263a51}.assistant{align-self:flex-start}.status{font:14px system-ui;color:${o.secondary};min-height:18px}.input{border:1px solid #51617b;border-radius:9px;min-height:48px;padding:12px;font:17px system-ui;white-space:pre-wrap}.chat-title{font:12px system-ui;letter-spacing:2px;color:${o.secondary}}`;
  const html=`<main><canvas aria-hidden="true"></canvas><div class="caption">${esc(o.type==='chat'?'':o.caption)}</div><div class="feed" aria-hidden="true"></div><section class="chat" hidden><div class="chat-title">${esc(o.caption||'ASSISTENTE')}</div><div class="thread" aria-live="polite"></div><div class="status"></div><div class="input" aria-label="Mensagem digitada"></div></section></main>`;
  const doc=playgroundDocument({html,css,javascript:`${drawHologram.toString()}\n${drawTrace.toString()}\n(${scene.toString()})(${JSON.stringify(o)});`});return `<iframe data-motion="${o.type}" data-motion-manual="${o.manual}" data-motion-finish="${o.finish}" title="${esc(o.caption||'Detalhe animado')}" sandbox="allow-scripts" style="width:100%;height:100%;border:0" srcdoc="${esc(doc)}"></iframe>`;}

package/src/preferences.js

@@ -1,6 +1,7 @@
 // Preferências do sagadeck nesta máquina: ~/.sagadeck/preferencias.json (ou SAGADECK_PREFERENCIAS), ao lado do
 // ambientes.yaml e do identidades.yaml. Valem para o Studio inteiro; o deck (fit:, author…) vence quando define.
 import fs from "node:fs";
+import { renameRetry } from "./fs-retry.js";
 import os from "node:os";
 import path from "node:path";
 
@@ -21,6 +22,9 @@ export const PREF_SCHEMA = {
   exportacao: {
     pdfClaro: { def: false },   // PDF e impressão na versão clara do tema (quando o tema tem par claro/escuro)
   },
+  biblioteca: {
+    lixeiraDias: { def: 30, min: 1, max: 365 }, // excluída fica restaurável por tantos dias, depois é apagada de vez
+  },
 };
 
 export function preferencesFile(env = process.env, home = os.homedir()) {
@@ -56,6 +60,6 @@ export function savePreferences(patch, file = preferencesFile()) {
   fs.mkdirSync(path.dirname(file), { recursive: true });
   const tmp = `${file}.tmp-${process.pid}`;
   fs.writeFileSync(tmp, JSON.stringify(out, null, 2) + "\n", "utf8");
-  fs.renameSync(tmp, file);
+  renameRetry(tmp, file);
   return out;
 }

package/src/research/research.js

@@ -11,7 +11,7 @@
 // (fontes.json, notas.md e o texto de cada fonte). Sem internet (a rede do banco): avisa e segue sem inventar.
 import fs from "node:fs";
 import path from "node:path";
-import { chat } from "../ai/llm.js";
+import { chat, llmConfig } from "../ai/llm.js";
 import { fetchUrlDoc } from "../ai/context.js";
 import { searchDuckDuckGo } from "./duckduckgo.js";
 import { searchWikipedia } from "./wikipedia.js";
@@ -66,11 +66,12 @@ export async function arxivSearch(q, { limit = 5 } = {}) {
     return { title: tag("title"), url: abs, pdf: abs.replace("/abs/", "/pdf/"), snippet: clip(tag("summary"), 300), date: tag("published").slice(0, 10), arxiv: true };
   });
 }
-// Busca pelo modelo "search" do modelrelay (no OpenRouter, um modelo com ":online": a busca na web dele, por API
-// oficial). O DuckDuckGo direto passou a responder com desafio anti-robô; ele fica como segunda tentativa. Sem o
-// apelido "search" no modelrelay (a rede do banco), não há buscador: a pesquisa avisa e segue sem inventar.
+// Busca pelo modelo de busca configurado (Configurar IA › busca; no OpenRouter, um modelo com ":online": a busca na
+// web dele, por API oficial). O DuckDuckGo direto passou a responder com desafio anti-robô; ele fica como segunda
+// tentativa. Sem modelo de busca (a rede do banco), não há buscador: a pesquisa avisa e segue sem inventar.
 export async function llmSearch(q, { limit = 8 } = {}) {
-  const model = process.env.SAGADECK_SEARCH_MODEL || "search";
+  const model = llmConfig().searchModel;
+  if (!model) throw new Error("sem modelo de busca configurado");
   const r = await chat([{ role: "user", content: `Hoje é ${today()}. Pesquise na web e liste as ${limit} melhores fontes para: ${q}\nPrefira fontes primárias (site oficial, documentação, artigo, imprensa séria); para humor, memes e opiniões sobre cultura, blogs e fóruns também podem ser pertinentes. Para cada uma, o título, a URL completa e exata (a página, não o site), uma frase do que ela traz e a data, se houver.\nResponda só JSON: [{"title": "…", "url": "https://…", "snippet": "…", "date": "…"}]` }], { model, maxTokens: 3000, temperature: 0, reasoningOff: true });
   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 || "") }));

package/src/runtime/calc.js

@@ -6,10 +6,10 @@
     if (v == null || !Number.isFinite(v)) return "—";
     if (o.sci || Math.abs(v) >= 1e7 || (Math.abs(v) < 1e-3 && v !== 0)) {
       const [m, e] = v.toExponential(2).split("e");
-      return `${m.replace(".", ",")} × 10${String(Number(e)).split("").map((c) => SUP[c] ?? c).join("")}`;
+      return `${(1.5).toLocaleString((typeof document !== "undefined" && document.documentElement.lang) || "pt-BR").includes(",") ? m.replace(".", ",") : m} × 10${String(Number(e)).split("").map((c) => SUP[c] ?? c).join("")}`;
     }
-    if (o.decimals != null) return v.toLocaleString("pt-BR", { minimumFractionDigits: o.decimals, maximumFractionDigits: o.decimals });
-    return v.toLocaleString("pt-BR", { maximumSignificantDigits: Math.abs(v) >= 1000 ? 7 : 4 });
+    if (o.decimals != null) return v.toLocaleString((typeof document !== "undefined" && document.documentElement.lang) || "pt-BR", { minimumFractionDigits: o.decimals, maximumFractionDigits: o.decimals });
+    return v.toLocaleString((typeof document !== "undefined" && document.documentElement.lang) || "pt-BR", { maximumSignificantDigits: Math.abs(v) >= 1000 ? 7 : 4 });
   }
   // todas as saídas na ordem (uma saída usa as anteriores); `cases` escolhe texto/cor/fórmula pela faixa de `of`
   function evaluate(model, values = {}) {

package/src/runtime/decision-lab.js

@@ -17,7 +17,7 @@
     return { ...s, automatic, caught, introduced, reviewed: automatic - caught + introduced,
       hours: s.volume * r * s.seconds / 3600, delta: introduced - caught };
   }
-  const fmt = n => n.toLocaleString('pt-BR', { maximumFractionDigits: 1 });
+  const fmt = n => n.toLocaleString((typeof document !== "undefined" && document.documentElement.lang) || "pt-BR", { maximumFractionDigits: 1 });
   function mount(container = document) {
     container.querySelectorAll('[data-decision-lab]').forEach(el => {
       if (el.dataset.mounted) return;

package/src/runtime/motion.js

@@ -10,6 +10,10 @@ for(const frame of document.querySelectorAll('iframe[data-motion]')){
   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==='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');}};
+ const activate=()=>{const active=slide?.classList.contains('current');send('active',active);send('poster',document.documentElement.classList.contains('export')||document.documentElement.dataset.motion==='none'||matchMedia('(prefers-reduced-motion: reduce)').matches);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']});
+ // a cena pode ter carregado e dito 'ready' antes deste script escutar: fala com ela já (senão ela não sabe do slide
+ // atual nem do movimento reduzido e anima sem parar)
+ activate();
+ matchMedia('(prefers-reduced-motion: reduce)').addEventListener?.('change',activate);
 }

package/src/runtime/runtime.js

@@ -65,7 +65,8 @@
   }
 
   // ---------- contador ----------
-  function fmtNum(v, dec) { return v.toLocaleString("pt-BR", { minimumFractionDigits: dec, maximumFractionDigits: dec }); }
+  // no idioma do deck (<html lang>, que vem do lang do deck): em inglês "1,403" e "0.93"
+  function fmtNum(v, dec) { return v.toLocaleString((typeof document !== "undefined" && document.documentElement.lang) || "pt-BR", { minimumFractionDigits: dec, maximumFractionDigits: dec }); }
   function runCounter(c, instant) {
     const to = +c.dataset.to, from = +c.dataset.from, dec = +c.dataset.dec, cv = $(".cv", c);
     const pre = c.dataset.prefix, suf = c.dataset.suffix;

package/src/studio/ai-chat-route.js

@@ -11,11 +11,31 @@ import { reviewExperience } from "../ai/quality.js";
 import { maybeResearch } from "../research/chat-research.js";
 import { chatErrorResult } from "./errors.js";
 import { cancellable, respond } from "./ai-response.js";
-import { prepareDocumentMaterials, takeMaterials } from "../ai/document-materials.js";
+import { prepareDocumentMaterials, takeMaterials, storedDocumentMaterials } from "../ai/document-materials.js";
+import { critiqueMaterials, critiqueMarkdown, saveCritique, loadCritique, critiqueMaterial, markCritiqueItem } from "../ai/critique.js";
 import { styleAction } from "./style-routes.js";
 import * as Project from "./project.js";
 import { carryVisualEdits } from "./visual-keys.js";
 
+// Arquivos que a IA pode pedir para ver (ver: […]): imagens DENTRO da pasta da apresentação (os recortes e as
+// páginas do material ficam em contexto/visuais/). Caminho que sai da pasta, que não existe ou que não é imagem fica
+// de fora; no máximo 6.
+export function lookableFiles(deckDir, wanted = []) {
+  if (!deckDir) return [];
+  const root = path.resolve(deckDir);
+  const out = [];
+  for (const w of wanted) {
+    const rel = String(w || "").replace(/\\/g, "/").replace(/^\.\//, "").trim();
+    if (!rel || !/\.(png|jpe?g|webp|gif)$/i.test(rel)) continue;
+    const abs = path.resolve(root, rel);
+    if (abs !== root && !abs.startsWith(root + path.sep)) continue;
+    if (!fs.existsSync(abs) || !fs.statSync(abs).isFile()) continue;
+    if (!out.some((o) => o.abs === abs)) out.push({ rel, abs });
+    if (out.length >= 6) break;
+  }
+  return out;
+}
+
 export async function aiChatRoutes({ req, res, pathname, url, W, readJSON, staleTab, llmAvailable, llmConfig, lookAt, withBase, apiBlocked, ensureEnsaio, readPastedLinks, imageOptions, apiContextFor, commandRunner, diagramCheck, slideSnapshots, persist, isBundledTemplate, runTransform, transforms, apiEnv }) {
   if (pathname === "/api/ai/chat/cancel" && req.method === "POST") {
     const body = await readJSON(req);
@@ -25,6 +45,52 @@ export async function aiChatRoutes({ req, res, pathname, url, W, readJSON, stale
     res.end(JSON.stringify({ ok: true, stopped: !!job }));
     return true;
   }
+  // Leitura crítica do material da apresentação aberta (botão do chat): src/ai/critique.js. Nada muda nos slides; o
+  // resultado fica em .sagadeck/leitura-critica.json (acompanha os próximos pedidos ao chat) e volta como conversa.
+  if (pathname === "/api/ai/critique" && req.method === "POST") {
+    const body = await readJSON(req);
+    if (staleTab(body, W, res)) return true;
+    const deckDir = W.file && !isBundledTemplate(W.file) ? path.dirname(W.file) : null;
+    const spec = body.spec || W.spec;
+    await respond(res, body.stream, async (emit) => {
+      const P = deckDir ? Project.projectOf(W.file) : null;
+      let materials = deckDir ? storedDocumentMaterials(deckDir) : [];
+      if (!materials.length && P) materials = (await Project.contextMaterials(P)).filter((m) => String(m.text || "").length > 1500);
+      if (!materials.length) return { talk: true, reply: "Esta apresentação não tem material anexado para ler criticamente. Anexe o documento (PDF, Word) no chat e peça de novo.", options: [] };
+      if (!(await llmAvailable({ force: true }))) return { talk: true, reply: `A IA está desligada (nenhum LLM respondendo em ${llmConfig().url}).`, options: [] };
+      emit({ phase: "step", text: `Lendo ${materials.map((m) => m.name).join(", ")} com olho crítico…` });
+      const c = await critiqueMaterials(materials, { spec, briefing: spec?.context ? JSON.stringify(spec.context) : "" });
+      saveCritique(deckDir, c);
+      const autor = spec?.context?.autoria !== "livre";
+      const options = c.itens.length
+        ? (autor
+          ? ["Leve para os slides os achados que estão no material", "Ponha as perguntas prováveis e as inconsistências nas notes", "Corrija os slides apontados", "Só queria ler, obrigado"]
+          : ["Transforme os achados em conteúdo, marcando o que é do sagadeck", "Crie um slide de discussão crítica", "Corrija os slides apontados", "Só queria ler, obrigado"])
+        : [];
+      const head = c.itens.length
+        ? `Li ${c.material.join(", ")} como um revisor da área. ${c.itens.length} ponto(s), cada um com o trecho do material que o sustenta (conferido no texto). ${autor ? "Como a apresentação é do próprio autor, nada disso entra nos slides sem você pedir: o que é achado do material pode ir para os slides; crítica e perguntas, para as notes." : "Como a apresentação é livre, posso transformar isso em conteúdo, marcando o que é do sagadeck."}`
+        : "Não achei nada com trecho conferido no material para apontar.";
+      // os pontos vão também estruturados: o chat mostra cada um como cartão, ligado ao slide, com Aplicar e Ignorar
+      return { talk: true, reply: `${head}\n\n${critiqueMarkdown(c)}`, critique: { itens: c.itens, autor, summary: `${head}${c.naoConfirmados.length ? `
+
+_${c.naoConfirmados.length} observação(ões) descartada(s): o trecho citado não foi encontrado no material._` : ""}` }, options, actions: [`Leitura crítica: ${c.itens.length} ponto(s) conferido(s)${c.naoConfirmados.length ? `, ${c.naoConfirmados.length} descartado(s) sem trecho no material` : ""}`] };
+    });
+    return true;
+  }
+  // cartão da leitura crítica: a pessoa aplicou ou ignorou o ponto (ignorado deixa de acompanhar os pedidos)
+  if (pathname === "/api/ai/critique/item" && req.method === "POST") {
+    const body = await readJSON(req);
+    const deckDir = W.file && !isBundledTemplate(W.file) ? path.dirname(W.file) : null;
+    try {
+      const item = markCritiqueItem(deckDir, String(body.id || ""), String(body.status || ""));
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({ ok: true, item }));
+    } catch (e) {
+      res.writeHead(400, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({ error: e.message }));
+    }
+    return true;
+  }
   if (pathname === "/api/ai/chat" && req.method === "POST") {
     const body = await readJSON(req);
     if (staleTab(body, W, res)) return true;
@@ -53,7 +119,7 @@ export async function aiChatRoutes({ req, res, pathname, url, W, readJSON, stale
         // Sem modelo, ninguém decide nada: nem "o que é X?" nem "resuma" viram edição por palavra-chave
         // (as regras antigas trocavam o layout e enfiavam texto genérico no slide). O deck fica como está.
         return {
-          reply: `A IA está desligada (nenhum LLM respondendo em ${llmConfig().url}), então não mexi em nada. Rode "modelrelay serve" ou defina SAGADECK_LLM_URL e mande de novo.`,
+          reply: `A IA está desligada (${llmConfig().url ? `nenhum LLM respondendo em ${llmConfig().url}` : "não configurada"}), então não mexi em nada. Configure em Configurar IA (provedor e chave) e mande de novo.`,
           spec, actions: [], targetSlide: body.targetSlide, talk: true, mode: "off",
         };
       }
@@ -69,6 +135,9 @@ export async function aiChatRoutes({ req, res, pathname, url, W, readJSON, stale
         // arquivos do projeto (contexto/): material para a IA, junto com os anexos da mensagem
         const P = taskWorkspace.file && !isBundledTemplate(taskWorkspace.file) ? Project.projectOf(taskWorkspace.file) : null;
         if (P) for (const doc of await Project.contextMaterials(P)) if (!materials.some((m) => m.name === doc.name || m.name === doc.name.split("/").pop())) materials.push(doc);
+        // a leitura crítica já feita (geração ou botão) acompanha o pedido, rotulada como do sagadeck
+        const critique = critiqueMaterial(loadCritique(P ? path.dirname(taskWorkspace.file) : null));
+        if (critique) materials.push(critique);
         // links colados na mensagem: o servidor lê sozinho e conta nas ações
         const linkActions = [];
         for (const doc of await readPastedLinks(taskWorkspace, prompt, linkActions)) materials.push(doc);
@@ -77,9 +146,10 @@ export async function aiChatRoutes({ req, res, pathname, url, W, readJSON, stale
         const chatResearch = await maybeResearch({ prompt, materials, saveDir: taskWorkspace.file && !isBundledTemplate(taskWorkspace.file) ? path.dirname(taskWorkspace.file) : null, onProgress: (s) => emit({ phase: "step", text: s }) });
         materials = chatResearch.materials;
         if (chatResearch.report?.fontes?.length) linkActions.push(`Pesquisa na web: ${chatResearch.report.fontes.length} fonte(s) (${chatResearch.report.fontes.map((f) => f.site).join(", ")})`);
-        result = await editDeck({
+        const firstInstruction = chatResearch.instruction ? `${chatResearch.instruction}\n${prompt}` : prompt;
+        const editOpts = (extra = {}) => ({
           spec: withBase(taskWorkspace, spec), signal,
-          instruction: chatResearch.instruction ? `${chatResearch.instruction}\n${prompt}` : prompt,
+          instruction: firstInstruction,
           targetSlide: target,
           issues,
           images: true, // a IA decide (regra no prompt: só quando pedirem ou aceitarem)
@@ -94,8 +164,34 @@ export async function aiChatRoutes({ req, res, pathname, url, W, readJSON, stale
           runCommand: commandRunner(req, emit, body, taskWorkspace, signal),
           reviewCheck: (deck, indices) => reviewExperience(deck, indices, { snapshot: slideSnapshots, onProgress: emit, signal, briefing:prompt }),
           styles: taskWorkspace.file && !isBundledTemplate(taskWorkspace.file) ? { list: taskWorkspace.library.listStyles(), current: taskWorkspace.spec?.style?.name || null } : null,
+          ...extra,
         });
+        result = await editDeck(editOpts());
         signal.throwIfAborted();
+        // A IA pediu para VER o material (ver: [recortes, páginas]): do documento ela só recebe o texto e o
+        // inventário. O Studio carrega as imagens (só arquivos da pasta desta apresentação) e chama de novo, com elas
+        // anexadas; até 2 rodadas. Antes ela respondia "não tenho acesso ao PDF" ou dizia ter visto o que não viu.
+        const deckDir = taskWorkspace.file && !isBundledTemplate(taskWorkspace.file) ? path.dirname(taskWorkspace.file) : null;
+        const seen = [];
+        for (let round = 1; result.look?.length && round <= 2; round++) {
+          const files = lookableFiles(deckDir, result.look);
+          const missing = result.look.filter((f) => !files.some((x) => x.rel === f.replace(/\\/g, "/").replace(/^\.\//, "")));
+          emit({ phase: "step", text: files.length ? `Olhando o material: ${files.map((f) => path.basename(f.rel)).join(", ")}…` : "Os arquivos pedidos não estão na pasta da apresentação." });
+          const { imagesAsDataUrls } = await import("../import/crop.js");
+          const urls = files.length ? await imagesAsDataUrls(files.map((f) => f.abs), { width: 1600, quality: 0.9 }) : [];
+          signal.throwIfAborted();
+          files.forEach((f, k) => urls[k] && seen.push({ label: `material: ${f.rel}`, dataUrl: urls[k] }));
+          result.actions = [...(result.actions || []), files.length ? `Olhei no material: ${files.map((f) => f.rel).join(", ")}` : "Pedido de ver o material sem arquivo válido"];
+          const before = result;
+          result = await editDeck(editOpts({
+            visuals: [...visuals, ...seen],
+            history: [...history, { role: "user", text: prompt }, { role: "assistant", text: before.reply }],
+            instruction: `${files.length ? `Aqui estão as imagens do material que você pediu para ver (${files.map((f) => f.rel).join(", ")}), anexadas com o rótulo "material: <arquivo>".` : "Nenhuma das imagens pedidas existe na pasta da apresentação."}${missing.length ? ` Não encontrei: ${missing.join(", ")} (use os caminhos exatos do inventário: recortes em items[].image e páginas inteiras em pages).` : ""} Agora atenda o pedido da pessoa já vendo, sem pedir de novo o que já está aqui:\n"""\n${firstInstruction}\n"""`,
+          }));
+          signal.throwIfAborted();
+          result.actions = [...before.actions, ...(result.actions || [])];
+        }
+        if (result.look?.length) result = { ...result, look: undefined, talk: true, reply: `${result.reply}\n(Já mostrei as imagens duas vezes; me diga o que procurar nelas.)` };
         // documento anexado NESTA mensagem e a resposta montou/reescreveu a maior parte do deck (criar a apresentação
         // do paper pelo chat): a mesma conferência de cobertura da geração. Pedido pontual ("use a figura 3 no slide
         // 5") não dispara: mexe em poucos slides.

package/src/studio/banner.js

@@ -0,0 +1,18 @@
+// O que o `sagadeck studio` escreve ao subir. A primeira linha é o endereço do Studio, a página que a pessoa abre: antes
+// vinha primeiro o endereço de um serviço de IA à parte, e um agente pedido para "deixar pronto para usar" abria a
+// página dele ou, sem achar o Studio, saía criando uma interface do zero. A IA se configura dentro do Studio.
+import { PROVIDERS } from "../ai/ia-config.js";
+
+const providerName = (ai) => Object.values(PROVIDERS).find((p) => p.url === ai.url)?.label || ai.url;
+
+export function studioBanner({ version, url, library, ai = null, multiuser = false, usersDir = "", pid = process.pid, isLibrary = true }) {
+  const iaLine = !ai || !(ai.url || ai.adaptador)
+    ? "  IA: não configurada. No Studio, clique em IA desligada (ou Configurar IA na biblioteca) e informe provedor e chave."
+    : `  IA: ${providerName(ai)} · texto ${ai.textModel}${ai.source === "variável" ? " (pelas variáveis SAGADECK_LLM_*)" : ""}`;
+  return [
+    `✓ SagaDeck Studio ${version} pronto. Abra no navegador: ${url}${isLibrary ? "  (biblioteca)" : ""}`,
+    multiuser ? `  multiusuário: bibliotecas em ${usersDir}` : `  biblioteca: ${library}`,
+    iaLine,
+    `  processo ${pid}`,
+  ];
+}

package/src/studio/code-version.js

@@ -0,0 +1,35 @@
+// Impressão do código do sagadeck (caminho, data e tamanho de cada arquivo). O Studio guarda a de quando subiu e a
+// página consulta de tempos em tempos: se o código mudou no disco (git pull, npm update, merge), o servidor que está
+// rodando ainda é o velho e a página avisa "reinicie". Antes, um Studio aberto antes de uma atualização recebia
+// arquivos novos do disco com o servidor velho e quebrava em silêncio (nenhum slide abria).
+import fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+
+const CODE = /\.(m?js|html|css|json)$/i;
+
+export function codeFingerprint(root) {
+  const h = crypto.createHash("sha1");
+  const walk = (dir) => {
+    let entries;
+    try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return; }
+    for (const e of entries.sort((a, b) => (a.name < b.name ? -1 : 1))) {
+      if (e.name === "node_modules" || e.name.startsWith(".")) continue;
+      const p = path.join(dir, e.name);
+      if (e.isDirectory()) walk(p);
+      else if (CODE.test(e.name)) { try { const st = fs.statSync(p); h.update(`${path.relative(root, p)}|${st.mtimeMs}|${st.size}\n`); } catch {} }
+    }
+  };
+  walk(root);
+  return h.digest("hex").slice(0, 16);
+}
+
+// a que vale para o servidor: a de quando ele subiu × a de agora (recalculada no máximo a cada poucos segundos)
+export function codeWatch(root, { every = 3000 } = {}) {
+  const started = codeFingerprint(root);
+  let now = started, at = Date.now();
+  return () => {
+    if (Date.now() - at > every) { now = codeFingerprint(root); at = Date.now(); }
+    return { started, now, changed: now !== started };
+  };
+}