sagadeck 1.11.3 → 1.11.5

package/bin/sagadeck.js

@@ -414,6 +414,8 @@ async function main() {
         console.error(`A porta ${port} está ocupada por outro programa. Use --port=OUTRA.`);
         process.exit(1);
       });
+      // SIGTERM do systemd ao reiniciar: sai em segundos, sem esperar o SIGKILL (src/studio/shutdown.js)
+      (await import("../src/studio/shutdown.js")).installShutdown(server);
       server.listen(port, host, async () => {
         const { studioBanner } = await import("../src/studio/banner.js");
         for (const line of studioBanner({ version: VERSION, url: `http://${shownHost}:${port}/`, library, ai: (await import("../src/ai/llm.js")).llmConfig(), multiuser, usersDir: path.join(library, "usuarios"), isLibrary: !deckFile })) console.log(line);

package/docs/ANDAMENTO.md

@@ -8,6 +8,46 @@ começar. Trabalho em curso vai para o GitHub (commit + push) a cada etapa, nunc
 
 ---
 
+## 1.11.5: parada do servidor, biblioteca no OneDrive — 23/10/2026 (branch `claude/parada-e-fotos`)
+
+- **Parada**: o Playwright, ao abrir o Chrome, instala um tratador de SIGTERM que só fecha o navegador; com ele, o
+  Node não sai mais sozinho. No Oracle, cada reinício ficava 90 s fora do ar até o SIGKILL (o log de toda semana:
+  "Failed with result 'timeout'"). `src/studio/shutdown.js`: SIGTERM/SIGHUP param de aceitar conexões, dão 8 s para
+  as que estão em uso, cortam o resto, fecham o Chrome das miniaturas e saem. Teste: `test/studio-shutdown.test.js`
+  (o prazo; e o Studio de verdade, depois de abrir o Chrome, sai em segundos com SIGTERM; só no Linux, porque no
+  Windows o SIGTERM mata na hora). Conferido no Oracle: sem a correção, não saiu em 15 s; com ela, saiu em 2 s.
+- **Biblioteca no OneDrive**: a listagem lia e interpretava o YAML de todas as apresentações a cada abertura (com
+  "arquivos só na nuvem", isso baixa cada uma). Agora guarda título, slides, tema e avisos pela data, tamanho e inode
+  do `.yaml` e do relatório de avisos, em memória e em `lista.json` no cache. Teste: `library.test.js` (nenhum
+  `.yaml` relido sem mudança, nem depois de reiniciar; só o que mudou; apagado some; cache estragado não quebra).
+- **Cache fora da nuvem**: `libraryCacheDir` põe capas, vitrine e lista em `%LOCALAPPDATA%\sagadeck\cache\<biblioteca>`
+  quando a biblioteca está dentro do OneDrive (variáveis `OneDrive`, `OneDriveCommercial`, `OneDriveConsumer`); o
+  `.cache` antigo de dentro dela sai (só `capas`, `vitrine` e `lista.json`). Fora do OneDrive e no servidor, nada muda.
+- **Fotos da transformação, medido e deixado como está**: cada foto custa ~0,4 s e o lote tem no máximo 5 slides;
+  abrir o deck uma vez por lote pouparia ~10 s numa transformação de 40 slides, que leva minutos de IA.
+
+## 1.11.4: CI mais rápida, implantação por roteiro, diário em dia — 23/10/2026 (branch `claude/melhorias-infra`)
+
+- **Antivírus do Windows segurava a abertura do deck** (exportação, fotos, PDF, PPTX e conferência): o Node lia o
+  HTML recém-gravado só para ver se tinha mapa, e no Windows essa primeira leitura de um HTML grande fica parada 15 a
+  20 s (o Chrome abre na hora). Agora quem grava usa `writeDeckHTML` (`src/export/recent-html.js`: build, exportação
+  do Studio) e a abertura usa o texto da memória; sem ele, quem lê é o Chrome, e o Node só relê se houver mapa (o
+  mapa abre por endereço local, servido da memória). `lengths.test.js` caiu de 84 s para 18 s nesta máquina; cada
+  exportação no Windows de quem usa deixa de esperar. Teste: `test/open-deck.test.js` (conta as leituras do arquivo
+  pelo Node; falha com o código antigo).
+- **CI em 3 partes por sistema**, ao mesmo tempo: `scripts/test-parte.mjs` reparte os arquivos pelo peso (os lentos
+  numa tabela lá dentro; dividir pela ordem dos arquivos dava 22 min × 13 min). Os checks exigidos na main continuam
+  `test (ubuntu-latest, 24.x)` e `test (windows-latest, 24.x)`: o job `test` de cada sistema confere pela API do run
+  que as 3 partes dele passaram. Antes: 26 min no Ubuntu e 37 no Windows por PR. Teste: `test/test-parte.test.js`
+  (todo arquivo em exatamente uma parte, partes equilibradas, pesos só de arquivos que existem).
+- **Implantação no Oracle por roteiro**: `node scripts/implantar-oracle.mjs` (dev primeiro, estável só se o dev subiu
+  na versão certa; git como root; npm ci só quando o lock muda além do número da versão; confere `/api/instance`).
+  Hoje à mão o git sem sudo falhou calado e o npm ci rodou sem precisar. Teste: `test/implantar-oracle.test.js` roda o
+  roteiro de verdade com git real e sudo/systemctl/curl/npm de mentira (no Linux; conferido no próprio Oracle).
+- `SAGADECK_ADMINS=305cc6c7416383c8` (a Narumi) em `/etc/sagadeck.env` no Oracle: vale para os dois serviços.
+- Diário: as pendências "Falta: PR…" do Painel Conferência (#204), do Pedido da criação (#203), da Conferência das
+  contas (#201, 1.11.0) e da Frente E (Frente F) viraram "Concluído".
+
 ## 1.11.3 — 23/10/2026 (branch `claude/versao-1.11.3`)
 
 Junta o envio de cópia para outra pessoa (#217), o Corrigir tudo (#218) e os testes ao vivo a cada 3 versões (#216).
@@ -216,7 +256,7 @@ Testes: `ai.test.js` (itens, ignorar, recordMath, Conferir de novo com e sem IA)
 usado como a pessoa usaria: selo, Conferir de novo, Ignorar, Corrigir com IA numa conta e num slide da IA,
 conferindo deck salvo, relatório e o que foi ao modelo; zero erros JS). Ícones Lucide novos: list-checks,
 calculator, hash, image-off. Suíte completa: `npm test`, 1.116 testes, 1.087 aprovados, 29 condicionais pulados, zero falhas.
-Falta: PR empilhado sobre o #201 (`claude/conferir-contas`), CI verde, merge.
+Concluído: entrou no PR #204 (depois do #201) e saiu na 1.11.0.
 
 ## Pedido da criação gravado — 22/10/2026 (branch `claude/pedido-da-criacao-0d34bc`, sobre `claude/conferir-contas`)
 
@@ -234,7 +274,7 @@ pasta inteira; o pacote `.sagadeck` agora leva `.sagadeck/geracao.json`.
 Testes: `storage.test.js` (biblioteca com anexo; segredos e `anteriores`), `library-ui.test.js` (pedido guiado
 digitado; só com anexo grava o texto padrão marcado, duplicar e o pacote levam o arquivo, zero erros JS),
 `studio-ai.test.js` (Deck com IA do editor e criação pelo chat com docx). Conferido que falham sem a gravação.
-Falta: PR com CI verde e merge (depois do PR #201, que é a base).
+Concluído: entrou no PR #203 (depois do #201) e saiu na 1.11.0.
 
 ## Modelo para conferir — 22/10/2026 (branch `claude/modelo-por-etapa-d74f41`, parte de `claude/conferir-contas`)
 
@@ -292,9 +332,8 @@ erros que ninguém tinha visto (velocidades da tabela do slide 26). A correção
 corrigir o material" da pessoa vale sobre a regra da autoria.
 Suíte completa: `npm test`, 1.108 testes, 1.079 aprovados, 29 condicionais pulados, zero falhas. Studio local na
 3517 rodando `c65772e` a partir desta worktree, para validação dela.
-Falta (depois do ok dela): PR, CI verde, merge, deploy na Oracle (produção estava na 1.9.0) e, no deck da conta da
-Mary, pedir à IA do sagadeck pelo chat que confira e corrija as contas (inclusive as do material: a aula é dela e
-ela autorizou caprichar), corrija os avisos da criação e melhore a aula. A correção é da IA, não à mão.
+Concluído: entrou no PR #201 e saiu na 1.11.0 (Oracle e npm); a IA do sagadeck corrigiu o deck da conta da Mary pelo
+chat, e a versão revisada foi para a pasta dela como outra apresentação.
 
 ## UX para programação e APIs com cURL — 12/10/2026 (branch `codex/ux-dev-slides`, versão 1.10.0)
 
@@ -2242,8 +2281,8 @@ raciocínio, a mesma conferência sai em 1–2 s e acha o que importa (título r
   "a partir de um arquivo" só com o anexo), `studio-themes.test.js` (prévia sem gravar, clique aplica),
   `studio.test.js` (Baixar tudo: zip com pptx com notas, pdf e roteiro), `storage.test.js` (gerado na biblioteca).
 
-Falta da lista: modo simples por padrão (avançado dobrável) e as fontes do Google embutidas (a rede do banco barra
-`fonts.googleapis.com`: temas perdem a letra, abrir/exportar pode esperar, e cada abertura avisa o Google).
+Concluído depois, na Frente F (28/09/2026, logo acima): modo simples e fontes embutidas, sem o Google. O modo
+simples saiu mais tarde (a faixa mostra tudo).
 
 ## Frente D (preguiçoso): trocar o tema muda o arranjo dos slides de conteúdo — 28/09/2026
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sagadeck",
-  "version": "1.11.3",
+  "version": "1.11.5",
   "description": "Gerador de apresentações: YAML -> HTML animado + PowerPoint editável, com temas e figuras geradas na hora.",
   "type": "module",
   "bin": {

package/src/build.js

@@ -19,6 +19,7 @@ import { esc, notesHTML, plain, md, INLINE_MATH } from "./markup.js";
 import { normalizeSpec } from "./fiscal/normalize.js";
 import { readRecordings } from "./api-client.js";
 import { explorationStates } from './exploration.js';
+import { writeDeckHTML } from "./export/recent-html.js";
 import { calcModel } from './lessons.js';
 import { loadMapConfig, mapaFile, tilesForDeck } from "./map-config.js";
 
@@ -257,7 +258,7 @@ export function buildFile(file, outFile) {
   const spec = loadSpec(file);
   const r = buildHTML(spec);
   fs.mkdirSync(path.dirname(outFile), { recursive: true });
-  fs.writeFileSync(outFile, r.html);
+  writeDeckHTML(outFile, r.html); // a conferência e a exportação abrem em seguida sem reler (export/recent-html.js)
   return { ...r, spec, outFile };
 }
 

package/src/export/browser.js

@@ -4,6 +4,8 @@ import http from "node:http";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
 import { chromium } from "playwright-core";
+import { recentHTML } from "./recent-html.js";
+export { writeDeckHTML } from "./recent-html.js";
 
 const CANDIDATES = [
   process.env.SAGADECK_BROWSER,
@@ -24,10 +26,12 @@ export function findBrowser() {
 
 // Deck com mapa abre por um endereço local (http://127.0.0.1), não como arquivo: o servidor de tiles do OpenStreetMap
 // pede que o navegador diga de onde vem o pedido, e página aberta do disco não diz. Só lê a pasta do deck.
-async function serveDir(dir) {
+// main: { "deck.html": texto } serve o deck da memória (sem o Node reler o arquivo; veja writeDeckHTML)
+async function serveDir(dir, main = {}) {
   const server = http.createServer((req, res) => {
     const rel = decodeURIComponent(new URL(req.url, "http://x").pathname).replace(/^\/+/, "");
     const file = path.resolve(dir, rel);
+    if (req.method === "GET" && Object.hasOwn(main, rel)) { res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" }); return res.end(main[rel]); }
     if (req.method !== "GET" || !file.startsWith(path.resolve(dir)) || !fs.existsSync(file) || !fs.statSync(file).isFile()) { res.writeHead(404); return res.end(); }
     res.writeHead(200, { "Content-Type": file.endsWith(".html") ? "text/html; charset=utf-8" : "application/octet-stream" });
     fs.createReadStream(file).pipe(res);
@@ -41,15 +45,23 @@ export const settleSlide = (page) => page.evaluate(() => window.SagaMap?.settled
 
 export async function openDeck(htmlFile, { scale = 1 } = {}) {
   const browser = await chromium.launch({ executablePath: findBrowser() });
-  const hasMap = fs.readFileSync(htmlFile, "utf8").includes('class="map-box');
-  const server = hasMap ? await serveDir(path.dirname(htmlFile)) : null;
-  if (server) { const close = browser.close.bind(browser); browser.close = async () => { await close(); server.close(); }; }
   try {
   const page = await browser.newPage({ viewport: { width: 1920, height: 1080 }, deviceScaleFactor: scale });
   const errors = [];
   page.on("pageerror", (e) => errors.push(e.message));
   page.on("console", (m) => { if (m.type() === "error") errors.push(m.text()); });
-  await page.goto((server ? `http://127.0.0.1:${server.address().port}/${encodeURIComponent(path.basename(htmlFile))}` : pathToFileURL(htmlFile).href) + "?export=1");
+  const fileURL = pathToFileURL(htmlFile).href + "?export=1";
+  // tem mapa? Pelo texto na memória; sem ele, quem lê o arquivo é o Chrome, e o Node só relê se houver mapa
+  let html = recentHTML(htmlFile), hasMap;
+  if (html != null) hasMap = html.includes('class="map-box');
+  else { await page.goto(fileURL); hasMap = await page.evaluate(() => !!document.querySelector(".map-box")); }
+  if (hasMap) {
+    const name = path.basename(htmlFile);
+    const server = await serveDir(path.dirname(htmlFile), { [name]: html ?? fs.readFileSync(htmlFile) });
+    const close = browser.close.bind(browser); browser.close = async () => { await close(); server.close(); };
+    errors.length = 0;
+    await page.goto(`http://127.0.0.1:${server.address().port}/${encodeURIComponent(name)}?export=1`);
+  } else if (html != null) await page.goto(fileURL);
   await page.waitForFunction(() => window.sagadeck && window.sagadeck.cur >= 0 && document.fonts.status === "loaded");
   // a janela com o tamanho do slide (deck.aspect: 4:3 → 1920 × 1440): foto, PDF e PPTX sem faixa nem corte
   const size = await page.evaluate(() => window.sagadeck.size || { w: 1920, h: 1080 });

package/src/export/recent-html.js

@@ -0,0 +1,24 @@
+// HTML que este processo acabou de gravar (build, exportação, conferência). No Windows, o antivírus segura por 15 a
+// 20 s a primeira leitura pelo Node de um HTML grande recém-gravado (o Chrome abre na hora): a abertura no Chrome
+// (browser.js: openDeck) usa o texto da memória em vez de reler o arquivo. Vale só enquanto o arquivo no disco é o
+// mesmo (tamanho e data); guarda só os últimos (o Studio fica aberto o dia todo). Módulo à parte, sem o Playwright,
+// para o build gravar por aqui sem carregar o navegador.
+import fs from "node:fs";
+import path from "node:path";
+
+const RECENT = new Map(); // caminho -> { html, size, mtimeMs }
+
+export function writeDeckHTML(file, html) {
+  fs.writeFileSync(file, html);
+  const key = path.resolve(file), st = fs.statSync(file);
+  RECENT.delete(key);
+  RECENT.set(key, { html, size: st.size, mtimeMs: st.mtimeMs });
+  while (RECENT.size > 4) RECENT.delete(RECENT.keys().next().value);
+}
+
+export function recentHTML(file) {
+  const r = RECENT.get(path.resolve(file));
+  if (!r) return null;
+  const st = fs.statSync(file, { throwIfNoEntry: false });
+  return st && st.size === r.size && st.mtimeMs === r.mtimeMs ? r.html : null;
+}

package/src/library.js

@@ -10,9 +10,10 @@
 //     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 (1 dia), com .origem.json
-//     .cache/                         capas geradas
+//     .cache/                         capas geradas e lista (no OneDrive, fica fora: libraryCacheDir)
 //
 // O id de uma apresentação é o caminho do .yaml dela, relativo à biblioteca, com "/" (ex.: "Palestras/X/X.yaml").
+import crypto from "node:crypto";
 import fs from "node:fs";
 import { renameRetry, copyRetry, removeRetry } from "./fs-retry.js";
 import os from "node:os";
@@ -69,6 +70,20 @@ export function defaultLibraryRoot(env = process.env, { platform = process.platf
   return path.resolve(target);
 }
 
+// Cache do que se refaz sozinho (capas, vitrine, lista da biblioteca). Com a biblioteca no OneDrive, fica na pasta
+// local do Windows (%LOCALAPPDATA%\sagadeck\cache\<biblioteca>), fora da nuvem: não ocupa a cota, não sincroniza a
+// cada capa nova e uma máquina não pega o cache da outra. Fora do OneDrive (e no servidor): <biblioteca>/.cache.
+export function libraryCacheDir(root, { env = process.env, platform = process.platform } = {}) {
+  root = path.resolve(root);
+  const low = root.toLowerCase();
+  const clouds = platform === "win32" ? [env.OneDrive, env.OneDriveCommercial, env.OneDriveConsumer].filter(Boolean).map((p) => path.resolve(p).toLowerCase()) : [];
+  if (env.LOCALAPPDATA && clouds.some((c) => low === c || low.startsWith(c + path.sep))) {
+    const tag = `${safeName(path.basename(root), "biblioteca")}-${crypto.createHash("sha1").update(low).digest("hex").slice(0, 8)}`;
+    return path.join(env.LOCALAPPDATA, "sagadeck", "cache", tag);
+  }
+  return path.join(root, ".cache");
+}
+
 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; } };
 
@@ -150,6 +165,13 @@ export function openLibrary(root, { trashDays } = {}) {
   const keepDays = () => trashDays ?? loadPreferences().biblioteca?.lixeiraDias ?? TRASH_DAYS;
   root = path.resolve(root);
   fs.mkdirSync(root, { recursive: true });
+  const cacheDir = libraryCacheDir(root);
+  // o cache saiu da biblioteca no OneDrive (libraryCacheDir): o que ficou lá dentro é só do sagadeck e se refaz
+  if (cacheDir !== path.join(root, ".cache")) {
+    const old = path.join(root, ".cache");
+    for (const n of ["capas", "vitrine", "lista.json"]) try { fs.rmSync(path.join(old, n), { recursive: true, force: true }); } catch { /* travado pela sincronização: fica para a próxima */ }
+    try { fs.rmdirSync(old); } catch { /* não existe ou tem outra coisa */ }
+  }
 
   // caminho absoluto de um id, sem sair da biblioteca
   function resolveId(id) {
@@ -172,17 +194,48 @@ export function openLibrary(root, { trashDays } = {}) {
     return path.join(dir, same || files.sort()[0]);
   }
 
-  function deckInfo(file, topic) {
-    const st = fs.statSync(file);
+  // O que a listagem mostra de cada apresentação (título, slides, tema, avisos), guardado pela data, tamanho e inode
+  // do .yaml e do relatório de avisos: só relê o que mudou. Ler a data e o tamanho não abre o arquivo; ler o conteúdo,
+  // sim. Com a biblioteca no OneDrive e "arquivos só na nuvem", cada listagem baixava todas as apresentações, e
+  // interpretar o YAML de todas a cada abertura da biblioteca crescia com ela. Fica também em .cache/lista.json, para
+  // valer depois de reiniciar o Studio.
+  const listCacheFile = path.join(cacheDir, "lista.json");
+  let listCache = null, listCacheDirty = false;
+  const stamp = (f) => { const s = fs.statSync(f, { throwIfNoEntry: false }); return s ? `${s.mtimeMs}:${s.size}:${s.ino}` : "-"; };
+  function cachedInfo(file, own) {
+    if (!listCache) { try { listCache = JSON.parse(fs.readFileSync(listCacheFile, "utf8")) || {}; } catch { listCache = {}; } }
+    const id = idOf(file), key = `${stamp(file)}|${own ? stamp(path.join(path.dirname(file), ".sagadeck", "avaliacao-geracao.json")) : ""}`;
+    const hit = listCache[id];
+    if (hit?.key === key) return hit.info;
     let spec = {};
     try { spec = YAML.parse(fs.readFileSync(file, "utf8")) || {}; } catch {}
-    const own = idOf(file).split("/").length === 3;
     const pending = own ? pendingWarnings(path.dirname(file), spec) : 0;
+    const info = { title: String(spec.title || path.basename(file).replace(/\.ya?ml$/i, "")), slides: Array.isArray(spec.slides) ? spec.slides.length : 0, theme: spec.theme || "", ...(pending ? { pendencias: pending } : {}) };
+    listCache[id] = { key, info };
+    listCacheDirty = true;
+    return info;
+  }
+  function saveListCache(ids) {
+    if (!listCache) return;
+    for (const id of Object.keys(listCache)) if (!ids.has(id)) { delete listCache[id]; listCacheDirty = true; } // apagada ou movida
+    if (!listCacheDirty) return;
+    try {
+      fs.mkdirSync(path.dirname(listCacheFile), { recursive: true });
+      const tmp = `${listCacheFile}.tmp-${process.pid}`;
+      fs.writeFileSync(tmp, JSON.stringify(listCache));
+      renameRetry(tmp, listCacheFile);
+      listCacheDirty = false;
+    } catch { /* sem cache em disco: só fica a memória */ }
+  }
+
+  function deckInfo(file, topic) {
+    const st = fs.statSync(file);
+    const own = idOf(file).split("/").length === 3;
+    const { pendencias, ...info } = cachedInfo(file, own);
     return {
-      id: idOf(file), topic: topic || "", title: String(spec.title || path.basename(file).replace(/\.ya?ml$/i, "")),
-      slides: Array.isArray(spec.slides) ? spec.slides.length : 0, theme: spec.theme || "", edited: st.mtimeMs,
+      id: idOf(file), topic: topic || "", ...info, edited: st.mtimeMs,
       folder: own, // true = pasta própria (com imagens etc.); false = .yaml solto
-      ...(pending ? { pendencias: pending } : {}), // só quando há aviso
+      ...(pendencias ? { pendencias } : {}), // só quando há aviso
     };
   }
 
@@ -212,6 +265,7 @@ export function openLibrary(root, { trashDays } = {}) {
       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"));
+    saveListCache(new Set(decks.map((d) => d.id)));
     return { root, topics, decks, trash: listTrash(), trashDays: keepDays() };
   }
 
@@ -560,7 +614,7 @@ export function openLibrary(root, { trashDays } = {}) {
   return {
     listStyles, saveStyle, loadStyle, applyStyleTo, defaultStyle, setDefaultStyle, withDefaultStyle,
     importOffice,
-    root, list, resolveId, idOf,
+    root, cacheDir, list, resolveId, idOf,
     createTopic, updateTopic, deleteTopic,
     createDeck, moveDeck, renameDeck, duplicateDeck, sendDeckTo,
     createStagingDeck, publishStagedDeck, discardStaging, recoverStaging,

package/src/studio/exporting.js

@@ -9,6 +9,7 @@ import os from "node:os";
 import path from "node:path";
 import JSZip from "jszip";
 import { buildHTML } from "../build.js";
+import { writeDeckHTML } from "../export/recent-html.js";
 import { THEMES } from "../themes.js";
 import { loadPreferences } from "../preferences.js";
 import { packDeck, EXTENSION, MIME } from "../package.js";
@@ -46,7 +47,7 @@ export async function generateExport(kind, spec, name, { notes = true, audience,
     if (["pptx","pdf","tudo"].includes(kind)) spec=expandApiCollections(spec);
     const r = buildHTML(spec);
     const htmlFile = path.join(tmp, "deck.html");
-    fs.writeFileSync(htmlFile, r.html);
+    writeDeckHTML(htmlFile, r.html);
     const errors = [];
     const make = async (what) => {
       const progress = event => onProgress({ ...event, format: what });
@@ -60,7 +61,7 @@ export async function generateExport(kind, spec, name, { notes = true, audience,
         // Preferências › Exportação: tema escuro com par claro (manual-noite → manual) sai claro no PDF, bom para imprimir
         const light = loadPreferences().exportacao.pdfClaro === true ? lightVariant(spec) : null;
         let file = htmlFile;
-        if (light) { file = path.join(tmp, "deck-claro.html"); fs.writeFileSync(file, buildHTML(light).html); }
+        if (light) { file = path.join(tmp, "deck-claro.html"); writeDeckHTML(file, buildHTML(light).html); }
         await pdf(file, out, { onProgress: progress });
       } else if (what === "estudo" || what === "estudo-html") {
         const { shots } = await import("../export/shots.js");

package/src/studio/library-routes.js

@@ -54,7 +54,7 @@ export async function libraryRoutes({ req, res, pathname, url, W, opts, admin, u
     if (pathname === "/api/library/gallery-cover" && req.method === "GET") {
       const key = galleryKey(url.searchParams.get("key")), entry = galleryEntry(key);
       const spec = entry.dir ? { ...entry.spec, _dir: entry.dir } : entry.spec;
-      const cacheDir = path.join(L.root, ".cache", "vitrine");
+      const cacheDir = path.join(L.cacheDir, "vitrine");
       const cached = path.join(cacheDir, `${crypto.createHash("sha1").update(`${key}|${JSON.stringify(entry.spec)}`).digest("hex")}.jpg`);
       if (!fs.existsSync(cached)) {
         const [shot] = await slideSnapshots(spec, 0, { mode: "final", width: 480 });
@@ -68,7 +68,7 @@ export async function libraryRoutes({ req, res, pathname, url, W, opts, admin, u
     if (pathname === "/api/library/cover" && req.method === "GET") {
       const file = L.resolveId(url.searchParams.get("id"));
       const st = fs.statSync(file);
-      const cacheDir = path.join(L.root, ".cache", "capas");
+      const cacheDir = path.join(L.cacheDir, "capas");
       const cached = path.join(cacheDir, `${crypto.createHash("sha1").update(`${L.idOf(file)}|${st.mtimeMs}`).digest("hex")}.jpg`);
       if (!fs.existsSync(cached)) {
         const spec = loadSpec(file);

package/src/studio/shutdown.js

@@ -0,0 +1,31 @@
+// Parada do Studio quando o sistema pede (SIGTERM do systemd ao reiniciar, SIGHUP ao fechar o terminal). Sem isto,
+// o processo não saía: o Playwright, ao abrir o Chrome (miniaturas, fotos, exportação), instala um tratador de SIGTERM
+// que só fecha o navegador, e com um tratador instalado o Node deixa de sair sozinho. No servidor, cada reinício
+// ficava 90 s fora do ar até o systemd matar à força (SIGKILL), no meio do que estivesse rodando.
+// Aqui: para de aceitar conexões, dá `grace` ms para as que estão em uso terminarem (uma resposta da IA ao vivo, uma
+// gravação), corta o que sobrar, fecha o Chrome das miniaturas e sai.
+export const SINAIS_DE_PARADA = ["SIGTERM", "SIGHUP"];
+
+export function installShutdown(server, { grace = 8000, log = (m) => console.log(m), exit = (code) => process.exit(code), closeBrowsers } = {}) {
+  let stopping = null;
+  const stop = (signal) => {
+    if (stopping) return stopping;
+    stopping = (async () => {
+      log(`  ${signal}: parando o Studio (até ${Math.round(grace / 1000)} s para o que está em andamento)`);
+      const closed = new Promise((resolve) => server.close(() => resolve()));
+      // a conexão que termina a resposta fica aberta à espera de outra (keep-alive) e seguraria o close até o prazo
+      server.closeIdleConnections?.();
+      const idle = setInterval(() => server.closeIdleConnections?.(), 100);
+      let timer;
+      const late = new Promise((resolve) => { timer = setTimeout(() => { server.closeAllConnections?.(); resolve(); }, grace); });
+      await Promise.race([closed, late]);
+      clearTimeout(timer); clearInterval(idle);
+      try { await (closeBrowsers ?? (async () => (await import("./snapshot.js")).closeSnapshots()))(); } catch { /* o Chrome já fechou */ }
+      exit(0);
+    })();
+    return stopping;
+  };
+  const handlers = SINAIS_DE_PARADA.map((s) => [s, () => { stop(s); }]);
+  for (const [s, h] of handlers) process.on(s, h);
+  return { stop, uninstall: () => { for (const [s, h] of handlers) process.off(s, h); } };
+}