sagadeck 1.11.3 → 1.11.4

package/docs/ANDAMENTO.md

@@ -8,6 +8,28 @@ começar. Trabalho em curso vai para o GitHub (commit + push) a cada etapa, nunc
 
 ---
 
+## 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 +238,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 +256,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 +314,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 +2263,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.4",
   "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/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");