sagadeck 1.11.4 → 1.11.6

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,51 @@ começar. Trabalho em curso vai para o GitHub (commit + push) a cada etapa, nunc
 
 ---
 
+## 1.11.6: rodada de uso real — 23/10/2026 (branch `claude/parada-e-fotos`)
+
+Quatro pedidos reais no sagadeck-dev (conta de teste `verificacao`, tópico "Rodada de uso real"), pelo caminho da
+biblioteca (Nova › Com IA, `POST /api/library/decks/ai`), com o modelo do servidor (deepseek-v4.1-flash): aula de
+vigas de concreto (20 min, com exemplo numérico), pitch de automação da conciliação (5 min), guia de Git (consulta) e
+palestra sobre burnout (15 min). Os quatro saíram em 4 a 9 min cada, variados (11, 3, 12 e 9 layouts diferentes). A
+revisão automática deixou avisos; cada um foi conferido no YAML e na foto do slide:
+- **Bug: `stats` ignorava `prefix`/`suffix`** (o pitch mostrava "4" por "4%"). Corrigido em `elements.js`, com
+  REFERENCIA e formulário do Studio. Teste no `engine.test.js`.
+- **Bug: código quebrava a linha no hífen** (`--no-` / `edit` no dossier do guia). `noHyphenBreak` (markup.js) põe
+  cada hífen num `<span class="hy">`, e o CSS um word joiner por `::after` (não vai na cópia); vale no `code()` e no
+  código do dossier. Testes: `engine.test.js` e `test/code-hyphen.test.js` (no Chrome, com o slide do guia; falha sem a
+  correção).
+- **Bug: barra com `color: hi` usava o marca-texto claro** (palestra, tema editorial: destaque mais fraco que o fundo).
+  `charts.js` usa `--hi-ink`, como o texto. Teste no `engine.test.js`.
+- **Bug: variedade cobrava impacto/respiro/tom de material de consulta**, contra a REFERENCIA. `variety.js` só cobra
+  isso fora de `purpose: consulta`. Teste no `engine.test.js`.
+- **Alarmes falsos da revisão (não mexidos)**: "barras de 48% e 43% quase iguais" (estão proporcionais) e "nota em
+  cinza escuro no preto" (é cinza claro, legível). Ficam como observação: a revisão por imagem ainda erra em proporção
+  e contraste; se voltar a aparecer, olhar a resolução das fotos que vão para ela.
+- Conteúdo, para a IA corrigir (Corrigir tudo com IA): coeficiente 0,68 sem a origem (0,85 × 0,8) e diagrama pequeno
+  na aula; quarto risco só nas notas do pitch.
+- **Testes com o modelo de verdade (1.11.6 é múltipla de 3)**: 25 de 27 de primeira em 25 min, nenhum quebrado.
+  Instáveis (passaram na repetição): "refinamento: conversa e depois 'pode fazer'" (o modelo trocou o slide por outro
+  texto em vez de aplicar o combinado; já tinha aparecido antes) e "gerar deck: sai variado" (estourou os 10 min do
+  teste esperando o provedor; não é a regra da variedade, que só mudou para `consulta`).
+
+## 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

package/docs/REFERENCIA.md

@@ -93,7 +93,7 @@ Tabela em markdown no meio de um texto (`problem`, `body`, `text`, passo do `sol
 | `hub` | `kicker, title, question, options: [{icon, title, text, meta, goto}], cols, build` | mapa de caminhos: cada opção leva (`goto`) à parte da apresentação daquele caminho; ver [Navegação por caminhos](#navegação-por-caminhos-hub-goto-back-next) |
 | `onepage` | `kicker, title, subtitle, journey: [texto ou {icon, title, text, goto}], journeyTitle, problem: {title, text, numbers: [{value, label}], items}, solution: {…}, dashboard: {numbers: [{value, label, trend, title}], figures: [gráfico ou ufmap, com title]}` | tudo numa página (jornada, problema, solução, painel); ver [One-page](#one-page-onepage) |
 | `status` | `kicker, title, health: ok\|risco\|atrasado, healthLabel, progress (0–100), highlight, done, doing, blocked, risks, upcoming: [texto ou {text, owner, due}], shots: [{image, caption}]` | status semanal; ver [Status semanal](#status-semanal-status) |
-| `stats` | `title, stats: [{value, label, text, icon, trend, trendUp, color}], cols, build` | indicadores (KPIs) em cartões, com tendência (`trend: "+12%"`) |
+| `stats` | `title, stats: [{value, prefix, suffix, label, text, icon, trend, trendUp, color}], cols, build` | indicadores (KPIs) em cartões, com tendência (`trend: "+12%"`) |
 | `timeline` | `title, events: [{when, title, text, tag, more}], highlight, after, build` | linha do tempo; `more` põe um botão + no marco que abre um balão (ver abaixo) |
 | `chart` | `title, chart: {…}, side (texto ou elemento), chartHeight` | gráfico + comentário |
 | `table` | `title, head, rows, style, color, highlight, total, side, caption, source` | tabela de verdade nas cores do tema |

package/package.json

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

package/src/adaptive-layouts.js

@@ -1,4 +1,4 @@
-import {md,esc} from './markup.js';
+import {md,esc,noHyphenBreak} from './markup.js';
 import {iconSVG} from './figures/icons.js';
 export function adaptiveGrid(items=[],variant='mosaic') {
   const n=items.length;
@@ -14,5 +14,5 @@ export function adaptiveHTML(s,variant) {
   <div class="adaptive-index f-label">${item.icon?iconSVG(item.icon,{size:38}):String(i+1).padStart(2,'0')}</div>
   ${item.value!=null?`<div class="adaptive-value t f-display">${md(String(item.value))}</div>`:''}
   <h3 class="t f-heading">${md(item.title||'')}</h3>${item.text?`<div class="adaptive-text t f-body">${md(item.text)}</div>`:''}
-  ${item.code?`<pre class="adaptive-code f-mono">${esc(item.code)}</pre>`:''}${item.foot?`<div class="adaptive-foot t f-label">${md(item.foot)}</div>`:''}</article>`).join('')}</div>`;
+  ${item.code?`<pre class="adaptive-code f-mono">${noHyphenBreak(esc(item.code))}</pre>`:''}${item.foot?`<div class="adaptive-foot t f-label">${md(item.foot)}</div>`:''}</article>`).join('')}</div>`;
 }

package/src/ai/variety.js

@@ -25,10 +25,16 @@ export function varietyReport(spec) {
   if (n >= 6) {
     const want = Math.min(8, Math.ceil(n * 0.5));
     if (distinct < want) problems.push(`só ${distinct} layouts diferentes em ${n} slides de conteúdo (bom: ${want} ou mais)`);
-    const listy = body.filter((s) => LISTY.has(s.layout)).length;
-    if (listy / n > 0.45) problems.push(`${listy} de ${n} slides são listas/cartões — falta respiro (manchete, número grande, imagem, pergunta)`);
-    if (!body.some((s) => IMPACT.has(s.layout))) problems.push("nenhum slide de impacto (manchete, número grande, frase, página inteira, pergunta)");
-    if (new Set(slides.map((s) => s.tone)).size === 1) problems.push(`todos os slides no mesmo tom (${slides[0].tone}) — alterne com escuro/destaque nos momentos-chave`);
+    // material de consulta (purpose: consulta) é para estudar depois: sem "número de impacto" nem slide só de título
+    // (REFERENCIA), e lista é o normal. Cobrar respiro e impacto ali era aviso falso, e a revisão empurrava a IA a pôr
+    // slides que o propósito pede para não ter (rodada de uso real, guia de Git, 23/10/2026)
+    if (spec?.purpose !== "consulta") {
+      const listy = body.filter((s) => LISTY.has(s.layout)).length;
+      if (listy / n > 0.45) problems.push(`${listy} de ${n} slides são listas/cartões — falta respiro (manchete, número grande, imagem, pergunta)`);
+      if (!body.some((s) => IMPACT.has(s.layout))) problems.push("nenhum slide de impacto (manchete, número grande, frase, página inteira, pergunta)");
+      // consulta pode ficar toda clara (imprime e lê bem); a regra do tom é de palco
+      if (new Set(slides.map((s) => s.tone)).size === 1) problems.push(`todos os slides no mesmo tom (${slides[0].tone}) — alterne com escuro/destaque nos momentos-chave`);
+    }
   }
   const counts = {};
   body.forEach((s) => (counts[s.layout] = (counts[s.layout] || 0) + 1));

package/src/elements.js

@@ -9,7 +9,7 @@ import katex from "katex";
 import { formatNumber, decimalSeparator } from "./locale.js";
 import fs from "node:fs";
 import path from "node:path";
-import { md, esc, plain } from "./markup.js";
+import { md, esc, plain, noHyphenBreak } from "./markup.js";
 import { iconSVG } from "./figures/icons.js";
 import { picto } from "./figures/pictos.js";
 import { diagram } from "./figures/diagrams.js";
@@ -551,7 +551,7 @@ export function stats(e, ctx) {
         ${iconHtml}
         ${trendHtml}
       </div>
-      <div class="st-val t f-display" style="${valColor}">${md(String(st.value ?? st.stat ?? ""))}</div>
+      <div class="st-val t f-display" style="${valColor}">${md(`${st.prefix ?? ""}${st.value ?? st.stat ?? ""}${st.suffix ?? ""}`)}</div>
       ${st.label ? `<div class="st-lab t f-heading">${md(st.label)}</div>` : ""}
       ${st.text ? `<div class="st-sub t f-body">${md(st.text)}</div>` : ""}
     </div>`;
@@ -619,7 +619,7 @@ export function code(e) {
   const language = resolveCodeLanguage(e.language, e.filename);
   const lines = language ? highlightCode(source, language) : source.split("\n").map(esc);
   const hl = new Set([].concat(e.highlight || []));
-  const body = lines.map((l, i) => `<div class="cl${hl.has(i + 1) ? " hl" : ""}"><span class="cn">${i + 1}</span><span class="cc">${l || " "}</span></div>`).join("");
+  const body = lines.map((l, i) => `<div class="cl${hl.has(i + 1) ? " hl" : ""}"><span class="cn">${i + 1}</span><span class="cc">${noHyphenBreak(l) || " "}</span></div>`).join("");
   return `<div${attrs(e, "code f-mono", `font-size:${e.size || 34}px;`)}${language ? ` data-language="${esc(language)}"` : ""}>${body}</div>`;
 }
 

package/src/figures/charts.js

@@ -21,6 +21,10 @@ const cvar = (c, d) => {
   if (/^#?[0-9a-f]{6}$/i.test(c)) return `#${String(c).replace("#", "")}`;
   // paleta do tema é namespaced (--c-c1…): nome pelado ("c3") viraria var indefinida = preto
   if (/^c[1-9]\d*$/.test(c) || /^(accent|alert|ink|paper)$/.test(c)) return `var(--c-${c})`;
+  // "hi" é a cor do marca-texto, clara nos temas de papel: a barra em destaque saía rosa-claro, quase sumindo, e as
+  // de fundo (muted) mais fortes que ela. Como no texto (elements.js: textColorVal), a marca usa a versão com
+  // contraste (--hi-ink: o hi se ele aparece no fundo, senão a ênfase). Rodada de uso real, 23/10/2026.
+  if (c === "hi") return "var(--hi-ink,var(--hi))";
   return `var(--${c})`;
 };
 const fmt = (v, o) => {

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/markup.js

@@ -16,6 +16,12 @@ export function esc(s) {
     .replace(/"/g, """);
 }
 
+// Código que quebra linha (pre-wrap): o navegador quebra depois do hífen, e "git commit --amend --no-edit" saía como
+// "--no-" / "edit" (quem copia do slide digita errado). Cada hífen vira <span class="hy">, e o CSS põe um "word joiner"
+// (U+2060) depois dele por ::after: a linha não quebra ali, e o texto copiado continua o mesmo (o ::after não é copiado).
+// Recebe HTML já escapado ou realçado: só troca o hífen fora das tags.
+export const noHyphenBreak = (html) => String(html).replace(/(<[^>]*>)|-/g, (m, tag) => tag || '<span class="hy">-</span>');
+
 // tabela em markdown no meio do texto (uma linha "| a | b |" por linha, com ou sem a linha "|---|---|" depois do
 // cabeçalho): vira tabela de verdade (src/table.js), não texto com barras
 const PIPE_TABLE = /(^|\n)((?:[ \t]*\|[^\n]*\|[ \t]*(?:\n|$)){2,})/g;

package/src/runtime/base.css

@@ -333,6 +333,8 @@ html[data-motion="none"] .flip-in,.export .flip-in{transition:none}
 .cl.hl{background:color-mix(in srgb,var(--c-accent) 26%,transparent);box-shadow:inset 8px 0 0 var(--c-accent)}
 .cn{width:2.2em;color:#777;flex:none}
 .cc{white-space:pre}
+/* hífen do código sem quebra de linha depois dele (markup.js: noHyphenBreak); o ::after não vai na cópia */
+.hy::after{content:"\2060"}
 .code.code-wrap .cl{min-width:0!important}.code.code-wrap .cc{white-space:pre-wrap;overflow-wrap:anywhere;flex:1;min-width:0}.code.code-scroll{overflow:auto;scrollbar-width:thin}
 .tok-keyword{color:#c792ea}
 .tok-string{color:#c3e88d}

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/public/slide-form.js

@@ -70,7 +70,7 @@
       { addLabel: "Adicionar turno", newItem: () => ({ who: 1, commit: "" }) })];
   const CARD = [f.icon("icon", "Ícone"), f.text("title", "Título"), f.area("text", "Texto"), f.area("flip", "Verso (o cartão vira no clique)"),
     f.more([f.text("number", "Número"), f.text("foot", "Rodapé"), f.text("badge", "Selo"), f.bool("hl", "Destacar"), f.num("step", "Aparece no clique"), f.text("goto", "Ao clicar, ir para", { hint: "Id do slide de destino (ou o número dele): navegação por caminhos." })])];
-  const STAT = [f.text("value", "Valor"), f.text("label", "Rótulo"), f.text("trend", "Tendência"), f.icon("icon", "Ícone"),
+  const STAT = [f.text("value", "Valor"), f.text("prefix", "Antes do valor", { hint: "Ex.: R$ " }), f.text("suffix", "Depois do valor", { hint: "Ex.: %, h, mil" }), f.text("label", "Rótulo"), f.text("trend", "Tendência"), f.icon("icon", "Ícone"),
     f.more([f.bool("trendUp", "Tendência positiva"), f.color("color", "Cor")])];
   const STEP = [f.text("title", "Título"), f.area("text", "Texto"), f.icon("icon", "Ícone"), f.more([f.text("tag", "Etiqueta"), f.text("goto", "Ao clicar, ir para", { hint: "Id do slide de destino (ou o número dele): navegação por caminhos." })])];
   // bloco do one-page (problema, solução): texto, números grandes e tópicos

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); } };
+}