primocode 10.0.0 → 10.1.0

package/lib/video/render.js

@@ -82,6 +82,8 @@ async function temPillow() {
 
 /** As camadas de texto da janela: {índiceDaFaixa: arquivo .ffconcat}. */
 async function camadasDeTexto(pasta, tl, { from, to, escala }) {
+    const avisosPos = [];
+    const posicao = require('./gerados.js').posicoesDeLegenda(pasta, tl, avisosPos);
     const faixas = tl.tracks.map((t, i) => ({ t, i })).filter(({ t }) => t.type === 'text' && t.clips.length && !t.hidden);
     if (!faixas.length) return { camadas: {}, avisos: [] };
     if (!(await temPillow())) {
@@ -96,7 +98,7 @@ async function camadasDeTexto(pasta, tl, { from, to, escala }) {
     const estados = [];
     const camadas = {};
     for (const { t, i } of faixas) {
-        const { segmentos, desenhos } = TX.estadosDaFaixa(tl, t, { from, to, escala });
+        const { segmentos, desenhos } = TX.estadosDaFaixa(tl, t, { from, to, escala, posicao });
         if (!Object.keys(desenhos).length) continue;
         for (const [chave, items] of Object.entries(desenhos)) {
             if (!fs.existsSync(arquivoDe(chave)) && !estados.some((e) => e.chave === chave)) estados.push({ chave, file: arquivoDe(chave), items });
@@ -112,13 +114,13 @@ async function camadasDeTexto(pasta, tl, { from, to, escala }) {
         try { fs.unlinkSync(job); } catch {}
         if (!r.ok) return { camadas: {}, avisos: [`os textos não foram desenhados: ${r.error}`] };
     }
-    return { camadas, avisos: [], estados: estados.length };
+    return { camadas, avisos: [...new Set(avisosPos)], estados: estados.length };
 }
 
 // ── rodar o ffmpeg ───────────────────────────────────────────────────────
 
-async function rodarGrafo(pasta, g, saida) {
-    const arq = path.join(pasta, 'cache', `grafo-${process.pid}.txt`);
+async function rodarGrafo(pasta, g, saida, sufixo = '') {
+    const arq = path.join(pasta, 'cache', `grafo-${process.pid}${sufixo}.txt`);
     fs.mkdirSync(path.dirname(arq), { recursive: true });
     fs.writeFileSync(arq, g.grafo);
     // O grafo vai por arquivo: com cinquenta clipes ele passa do teto de
@@ -130,29 +132,80 @@ async function rodarGrafo(pasta, g, saida) {
     return { ...r, grafo: arq };
 }
 
-async function exportar(pasta, tl, { out, from = 0, to, preview = false, crf = 20 } = {}) {
+/* O EXPORT EM PARTES: o grafo do ffmpeg é quase todo de um núcleo só (cada
+   filtro roda numa thread), e um vídeo com pessoa recortada, fundo novo,
+   3D e legenda passa a maior parte do tempo nele. Então o VÍDEO sai em
+   pedaços de quadros, cada um num ffmpeg, ao mesmo tempo, e junta por
+   concat sem recodificar; o ÁUDIO sai inteiro, numa passada só (é barato,
+   e cortar AAC em pedaços deixa estalo na emenda). As emendas caem em
+   quadro inteiro: o quadro N sai igual com 1 ou com 9 pedaços. */
+async function exportar(pasta, tl, { out, from = 0, to, preview = false, crf = 20, partes } = {}) {
     const c = conferir();
     if (!c.ok) return c;
+    const ger = await require('./gerados.js').garantir(pasta, tl);
+    if (!ger.ok) return ger;
     const escala = preview ? 0.5 : 1;
     const ate = to === undefined ? T.duracao(tl) : Number(to);
-    const tx = await camadasDeTexto(pasta, tl, { from, to: ate, escala });
-    const g = F.montarGrafo(tl, { from, to: ate, camadasDeTexto: tx.camadas, escala });
     const destino = path.resolve(out || path.join(pasta, 'saida', `${tl.nome || 'video'}${preview ? '-preview' : ''}.mp4`));
     fs.mkdirSync(path.dirname(destino), { recursive: true });
     const inicio = Date.now();
-    const r = await rodarGrafo(pasta, g, [
-        '-map', g.saidaV, '-map', g.saidaA, '-t', F.num(g.segundos), '-r', String(tl.fps),
-        ...argsDoCodec(codecDeVideo(), crf), '-pix_fmt', 'yuv420p', '-c:a', 'aac', '-b:a', '192k', '-movflags', '+faststart', destino,
-    ]);
-    if (!r.ok) return { ok: false, error: 'o ffmpeg falhou', detalhe: r.erro.slice(-600), grafo: r.grafo };
-    return { ok: true, file: destino, s: T.r2(g.segundos), size: `${g.W}x${g.H}`, mb: T.r2(fs.statSync(destino).size / 1048576),
-        tookS: Math.round((Date.now() - inicio) / 100) / 10, ...(tx.avisos.length ? { avisos: tx.avisos } : {}) };
+    const PAR = require('./paralelo.js');
+    const total = ate - from;
+    const n = partes !== undefined ? Math.max(1, Number(partes)) : Math.max(1, Math.min(PAR.quantos(), Math.floor(total / (tl.fps * 2))));
+    const codec = argsDoCodec(codecDeVideo(), crf);
+    const extra = ger.feitos ? { gerados: ger.feitos, geradosS: ger.tookS } : {};
+    if (n === 1) {
+        const tx = await camadasDeTexto(pasta, tl, { from, to: ate, escala });
+        const g = F.montarGrafo(tl, { from, to: ate, camadasDeTexto: tx.camadas, escala });
+        const r = await rodarGrafo(pasta, g, [
+            '-map', g.saidaV, '-map', g.saidaA, '-t', F.num(g.segundos), '-r', String(tl.fps),
+            ...codec, '-pix_fmt', 'yuv420p', '-c:a', 'aac', '-b:a', '192k', '-movflags', '+faststart', destino,
+        ]);
+        if (!r.ok) return { ok: false, error: 'o ffmpeg falhou', detalhe: r.erro.slice(-600), grafo: r.grafo };
+        return { ok: true, file: destino, s: T.r2(g.segundos), size: `${g.W}x${g.H}`, mb: T.r2(fs.statSync(destino).size / 1048576),
+            tookS: Math.round((Date.now() - inicio) / 100) / 10, partes: 1, ...extra, ...(tx.avisos.length ? { avisos: tx.avisos } : {}) };
+    }
+    const tmp = path.join(pasta, 'cache', `export-${process.pid}`);
+    fs.rmSync(tmp, { recursive: true, force: true });
+    fs.mkdirSync(tmp, { recursive: true });
+    const cortes = Array.from({ length: n + 1 }, (_, i) => from + Math.round((total * i) / n));
+    // Os PNGs do texto antes, em fila: dois pedaços desenhando o mesmo estado ao mesmo tempo se atropelariam.
+    const avisos = new Set();
+    const pedacos = [];
+    for (let i = 0; i < n; i++) {
+        const tx = await camadasDeTexto(pasta, tl, { from: cortes[i], to: cortes[i + 1], escala });
+        tx.avisos.forEach((a) => avisos.add(a));
+        pedacos.push({ de: cortes[i], ate: cortes[i + 1], tx, arq: path.join(tmp, `v${String(i).padStart(3, '0')}.mp4`) });
+    }
+    const res = await PAR.emParalelo([
+        ...pedacos.map((p, i) => () => {
+            const g = F.montarGrafo(tl, { from: p.de, to: p.ate, camadasDeTexto: p.tx.camadas, escala, audio: false });
+            return rodarGrafo(pasta, g, ['-map', g.saidaV, '-frames:v', String(p.ate - p.de), '-r', String(tl.fps), ...codec, '-pix_fmt', 'yuv420p', p.arq], `-v${i}`);
+        }),
+        () => {
+            const g = F.montarGrafo(tl, { from, to: ate, escala, video: false });
+            return rodarGrafo(pasta, g, ['-map', g.saidaA, '-t', F.num(g.segundos), '-c:a', 'aac', '-b:a', '192k', path.join(tmp, 'audio.m4a')], '-a');
+        },
+    ], n + 1);
+    const ruim = res.find((r) => !r.ok);
+    if (ruim) return { ok: false, error: 'o ffmpeg falhou', detalhe: ruim.erro.slice(-600), grafo: ruim.grafo };
+    const lista = path.join(tmp, 'lista.txt');
+    fs.writeFileSync(lista, pedacos.map((p) => `file '${p.arq.replace(/'/g, "'\\''")}'`).join('\n') + '\n');
+    const j = await video.rodar(video.ffmpeg(), ['-hide_banner', '-loglevel', 'error', '-y', '-f', 'concat', '-safe', '0', '-i', lista,
+        '-i', path.join(tmp, 'audio.m4a'), '-map', '0:v', '-map', '1:a', '-c', 'copy', '-movflags', '+faststart', destino]);
+    if (!j.ok) return { ok: false, error: 'não juntei os pedaços do export', detalhe: j.erro.slice(-400) };
+    fs.rmSync(tmp, { recursive: true, force: true });
+    return { ok: true, file: destino, s: T.r2(total / tl.fps), size: `${T.par(tl.width * escala)}x${T.par(tl.height * escala)}`,
+        mb: T.r2(fs.statSync(destino).size / 1048576), tookS: Math.round((Date.now() - inicio) / 100) / 10, partes: n, ...extra,
+        ...(avisos.size ? { avisos: [...avisos] } : {}) };
 }
 
 /** Os quadros pedidos, com a grade 0–1 e o número do quadro, numa folha só. */
 async function inspecionar(pasta, tl, { frames, escala = 0.5, out } = {}) {
     const c = conferir();
     if (!c.ok) return c;
+    const ger = await require('./gerados.js').garantir(pasta, tl);
+    if (!ger.ok) return ger;
     const dur = T.duracao(tl);
     const lista = [...new Set(frames.map((f) => Math.max(0, Math.min(dur - 1, Math.round(Number(f))))))].slice(0, 12);
     const dir = path.join(pasta, 'cache', 'inspect');

package/lib/video/texto.js

@@ -36,7 +36,7 @@ function palavrasDo(c) {
 }
 
 /** O estado de UM clipe de texto no quadro local `lf` — ou null (não aparece). */
-function estado(tl, c, lf) {
+function estado(tl, c, lf, pos = null) {
     const st = { ...ESTILO_PADRAO, ...(c.text.style || {}) };
     const d = c.durationFrames;
     const anim = c.text.animation || 'none';
@@ -85,7 +85,7 @@ function estado(tl, c, lf) {
     const W = tl.width;
     const H = tl.height;
     const item = {
-        cx: r3(c.transform.cx * W), cy: r3(c.transform.cy * H), w: Math.round(c.transform.w * W),
+        cx: r3((pos ? pos.cx : c.transform.cx) * W), cy: r3((pos ? pos.cy : c.transform.cy) * H), w: Math.round(c.transform.w * W),
         size: Math.round(st.size * H), font: st.font, color: st.color, align: st.align,
         stroke: st.stroke, sw: Math.round(st.strokeWidth * st.size * H), bg: st.bg,
         scale: r3(scale), alpha: Math.round(alpha * 100) / 100, words,
@@ -97,8 +97,10 @@ function estado(tl, c, lf) {
 /**
  * Os estados de uma faixa na janela [from, to): segmentos consecutivos com o
  * mesmo desenho viram um só. Devolve {segmentos:[{dur, chave}], desenhos}.
+ * `posicao(clipe, quadro)` → {cx, cy} | null: a legenda que SEGUE alguém
+ * (a cabeça) troca o lugar do transform pelo que ela devolver, quadro a quadro.
  */
-function estadosDaFaixa(tl, faixa, { from = 0, to, escala = 1 } = {}) {
+function estadosDaFaixa(tl, faixa, { from = 0, to, escala = 1, posicao = null } = {}) {
     const ate = to === undefined ? T.duracao(tl) : to;
     const clips = faixa.clips.filter((c) => !c.hidden && T.fim(c) > from && c.startFrame < ate);
     const escalar = (it) => (escala === 1 ? it : {
@@ -114,7 +116,7 @@ function estadosDaFaixa(tl, faixa, { from = 0, to, escala = 1 } = {}) {
         for (let j = k; j < clips.length && clips[j].startFrame <= f; j++) {
             const c = clips[j];
             if (f >= T.fim(c)) continue;
-            const it = estado(tl, c, f - c.startFrame);
+            const it = estado(tl, c, f - c.startFrame, posicao ? posicao(c, f) : null);
             if (it) itens.push(escalar(it));
         }
         const json = JSON.stringify(itens);

package/lib/video/timeline.js

@@ -267,6 +267,7 @@ function compacto(tl, c, track) {
     if (Object.keys(tf).length) o.xf = tf;
     if (Object.values(c.crop).some((v) => v)) o.crop = c.crop;
     if (c.fit !== 'cover') o.fit = c.fit;
+    if (c.papel) o.role = c.papel;
     const kf = Object.keys(c.keyframes || {}).filter((k) => c.keyframes[k].length);
     if (kf.length) o.kf = kf;
     if (c.effects.length) o.fx = c.effects.map((e) => e.type);
@@ -289,15 +290,22 @@ function vista(tl, { from = 0, to = Infinity } = {}) {
         });
         const f = { i, type: t.type, n: t.clips.length, clips };
         if (t.muted) f.muted = true;
+        if (t.role) f.role = t.role;
         return f;
     });
     const assets = {};
     for (const a of Object.values(tl.assets)) {
         assets[a.id] = { nome: a.nome, kind: a.kind, s: r2(a.seconds || 0) };
         if (a.width) assets[a.id].size = `${a.width}x${a.height}`;
-        if (!a.hasAudio && a.kind === 'video') assets[a.id].mudo = true;
+        if (!a.hasAudio && a.kind === 'video' && !a.gerado) assets[a.id].mudo = true;
+        if (a.gerado) assets[a.id].gerado = a.gerado.tipo;
     }
     const out = { fps: tl.fps, size: `${tl.width}x${tl.height}`, dur: duracao(tl), durS: r2(segundos(tl, duracao(tl))), assets, tracks };
+    if (tl.fx) {
+        // As receitas dos efeitos, em segundos da ORIGEM (o que o rastro mediu).
+        out.fx = {};
+        for (const [k, v] of Object.entries(tl.fx)) out.fx[k] = { objetos: (v.objetos || []).map((o) => `${o.id}:${o.modelo}@${o.mao} ${o.de}-${o.ate}s`), ...(v.fusao ? { fusao: v.fusao } : {}) };
+    }
     if (tl.markers.length) out.markers = tl.markers.filter((m) => m.frame >= from && m.frame < to).slice(0, 60);
     return out;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primocode",
-  "version": "10.0.0",
+  "version": "10.1.0",
   "description": "PrimoCode — agente de engenharia com IA e cursor próprio. Requer conta Conecta Primo AI (Premium ou Super). Cria arquivos, roda comandos, controla navegador e desktop: abre apps, clica em botões e ícones pelo nome, digita e usa atalhos.",
   "main": "bin/primocode.js",
   "bin": {
@@ -8,7 +8,7 @@
   },
   "scripts": {
     "start": "node bin/primocode.js",
-    "test": "node test/tools.test.js && node test/ui.test.js && node test/entrada.test.js && node test/transparencia.test.js && node test/permissao.test.js && node test/compatibilidade.test.js && node test/skills.test.js && node test/skills-de-fora.test.js && node test/skills-novas.test.js && node test/comandos.test.js && node test/estudio.test.js && node test/voz.test.js && node test/modo.test.js && node test/pasta.test.js && node test/projeto.test.js && node test/nome-projeto.test.js && node test/api-propria.test.js && node test/claude-engine.test.js && node test/codex.test.js && node test/conferir.test.js && node test/catalogo.test.js && node test/desktop.test.js && node test/seta.test.js && node test/effort.test.js && node test/regressao.test.js && node test/memoria-conversa.test.js && node test/repeticao.test.js && node test/casar.test.js && node test/recado.test.js && node test/releitura.test.js && node test/snapshot.test.js && node test/video.test.js && node test/limpeza.test.js && node test/autonomia.test.js && node test/desfazer.test.js && node test/desfazer-git.test.js && node test/referencia.test.js && node test/parar.test.js && node test/continuar.test.js && node test/pipeline.test.js && node test/conta.test.mjs && node test/nuvem.test.js && node test/prazo.test.js && node test/primeira-vez.test.js && node test/fala.test.js && node test/especialistas.test.js && node test/empurrao.test.js && node test/terminal-novo.test.js && node test/markdown.test.js && node test/coerencia.test.js && node test/contexto.test.js && node test/perigo.test.js && node test/rapidez.test.js && node test/mascotes.test.js && node test/comandos-extra.test.js && node test/offline.test.js && node test/edicao.test.js && node test/composicao.test.js && node test/acervo-site.test.js && node test/impacto.test.js && node test/cinema.test.js && node test/producao.test.js && node test/ende.test.js && node test/capa.test.js && node test/broll.test.js && node test/morfar.test.js && node test/motion.test.js && node test/motion-roteiro.test.js && node test/kit-motion.test.js"
+    "test": "node test/tools.test.js && node test/ui.test.js && node test/entrada.test.js && node test/transparencia.test.js && node test/permissao.test.js && node test/compatibilidade.test.js && node test/skills.test.js && node test/skills-de-fora.test.js && node test/skills-novas.test.js && node test/comandos.test.js && node test/estudio.test.js && node test/voz.test.js && node test/modo.test.js && node test/pasta.test.js && node test/projeto.test.js && node test/nome-projeto.test.js && node test/api-propria.test.js && node test/claude-engine.test.js && node test/codex.test.js && node test/conferir.test.js && node test/catalogo.test.js && node test/desktop.test.js && node test/seta.test.js && node test/effort.test.js && node test/regressao.test.js && node test/memoria-conversa.test.js && node test/repeticao.test.js && node test/casar.test.js && node test/recado.test.js && node test/releitura.test.js && node test/snapshot.test.js && node test/video.test.js && node test/limpeza.test.js && node test/autonomia.test.js && node test/desfazer.test.js && node test/desfazer-git.test.js && node test/referencia.test.js && node test/parar.test.js && node test/continuar.test.js && node test/pipeline.test.js && node test/conta.test.mjs && node test/nuvem.test.js && node test/prazo.test.js && node test/primeira-vez.test.js && node test/fala.test.js && node test/especialistas.test.js && node test/empurrao.test.js && node test/terminal-novo.test.js && node test/markdown.test.js && node test/coerencia.test.js && node test/contexto.test.js && node test/perigo.test.js && node test/rapidez.test.js && node test/mascotes.test.js && node test/comandos-extra.test.js && node test/offline.test.js && node test/edicao.test.js && node test/composicao.test.js && node test/acervo-site.test.js && node test/impacto.test.js && node test/cinema.test.js && node test/producao.test.js && node test/ende.test.js && node test/capa.test.js && node test/broll.test.js && node test/morfar.test.js && node test/motion.test.js && node test/motion-roteiro.test.js && node test/kit-motion.test.js && node test/gerativo.test.js && node test/hibrido.test.js && node test/biblioteca.test.js && node test/mcp.test.js && node test/personas.test.js && node test/efeitos.test.js && node test/auto.test.js && node test/colar.test.js && node test/orquestra.test.js && node test/shell-limpo.test.js && node test/editar-remotion.test.js && node test/variacao3d.test.js && node test/portao-skill.test.js && node test/clones.test.js && node test/kokoro.test.js && node test/fluido.test.js"
   },
   "engines": {
     "node": ">=18.17.0"

package/skills/escrever-em-portugues/SKILL.md

@@ -25,4 +25,7 @@ superlativo sem número.
 Número concreto vence adjetivo: "responde em 2 segundos" vale mais que
 "ultrarrápido".
 
+**Revisando um texto pronto**: aponte o trecho que soa errado e reescreva só
+ele. O resto, que já funciona, fica como está.
+
 Não use emoji para dar emoção a um texto que não tem nenhuma.

package/skills/interface-revisada/SKILL.md

@@ -12,7 +12,8 @@ a correção. Primeiro o que impede alguém de usar; acabamento vai no fim.
 - O que é clicável é `button` ou `a`, com hover, estado pressionado e foco
   visível (`:focus-visible`).
 - Alvo de toque de pelo menos 44×44px. Nada importante escondido só no hover.
-- Ação que demora mostra que está trabalhando e não pode ser enviada duas vezes.
+- Todo clique responde em até 200 ms. Ação que demora mostra que está
+  trabalhando e não pode ser enviada duas vezes.
 - Ação que apaga pede confirmação ou oferece desfazer.
 - O endereço guarda o estado (aba, filtro, página): o voltar do navegador e o
   link compartilhado levam ao mesmo lugar.
@@ -32,6 +33,7 @@ novo) e cheio (texto longo quebra ou termina em `…`; mil itens não travam).
 **Layout**
 - De 360px a 1440px sem rolagem para o lado; respeita a área segura do celular
   (`env(safe-area-inset-bottom)`).
+- Tela cheia é `100dvh`, nunca `100vh` (no celular, `vh` some sob a barra).
 - Imagem com `width`/`height` ou `aspect-ratio`, para a página não pular.
 - Número em coluna com `tabular-nums`; título com `text-wrap: balance`.
 
@@ -43,5 +45,9 @@ rolagem acompanham) e contraste de 4.5:1 nos dois temas. Animação só em
 `transform` e `opacity`, curta (150 a 300ms) e desligada em
 `prefers-reduced-motion`. Nunca `transition: all`.
 
+**Pior caso** (teste com o dado ruim): Texto enorme (`min-width: 0` e
+`overflow-wrap: anywhere`); Lista vazia; largura de 320px; Rede lenta (DevTools,
+Slow 3G); Mil itens (paginar ou virtualizar).
+
 **Feche com a contagem**: quantos impedem o uso, quantos atrapalham, quantos são
 acabamento. E conserte nessa mesma ordem.

package/skills/motion-de-primeira/SKILL.md

@@ -54,13 +54,14 @@ Em vídeo de produto, anúncio e vinheta, escreva **uma cena de 8 a 15 s** no
 - **`forma: "traco"`**: forma livre por `caminho` (`d` de SVG, caixa 0 0 100
   100, M/L/C/Q/Z). `caminho` e `cor` animam:
   `"caminho": [{"t":1.6,"v":BOLA},{"t":2.5,"v":FOGUETE,"e":"elastico"}]`.
-- **`tipo: "grupo"`**: elementos que andam juntos, ou a tela dentro da tela
-  (`"recorte": true`). Filhos contam tempo e posição a partir do grupo.
 - **A troca é no mesmo lugar e instante**: o foguete some onde o ícone nasce; o
   app nasce do tamanho e da COR do ícone.
 
-Por roteiro, o estilo segue o assunto: `motion` (padrão), `vox` (explicar; dê `destaque` e `fonte`),
-`marca`, `lancamento`; `visual` troca a peça de uma parte.
+Por roteiro, o padrão é `hibrido` (dê `busca` em inglês por parte); `gerativo` (o motion), `vox` (explicar; dê
+`destaque` e `fonte`), `marca`, `lancamento` pelo nome; `visual` troca a peça de uma parte.
+
+Pedido de motion (ou sem referências): `estilo: "gerativo"`, só o roteiro
+(`fala`, `destaque`); `roteiro.semente` sorteia outro, `modelo3d` traz o 3D.
 
 ## Cor e tipo
 

package/skills/projeto-no-github/SKILL.md

@@ -27,6 +27,12 @@ Tudo pelo `gh` (GitHub CLI) e pelo `git`, rodando no terminal do projeto.
 4. `gh pr create --fill` (ou `--title` e `--body` dizendo o que e por quê).
    Diga o link do PR.
 
+**Segredo:** `.env` só existe na máquina. Nunca crie, edite ou renomeie
+`.env` pelo site do GitHub (renomear `.env.example` para `.env` lá já vazou
+chave em repositório público). O `.env.example` leva só os nomes, sem valor.
+Antes do push: `git ls-files | grep '\.env$'` tem de vir vazio. Vazou? Troque a
+chave na hora; apagar o arquivo não basta, ela fica no histórico.
+
 **Nunca** faça `push --force` em `main`, nunca apague branch dos outros, nunca
 commite `.env`. Conflito: resolva lendo os dois lados, não escolhendo um às
 cegas.

package/skills/publicar-na-internet/SKILL.md

@@ -31,6 +31,9 @@ ela quem entra na conta dela.
 **3. Confira:** abra a URL publicada com browser_open e leia a página. Só diga
 que está no ar se ela abriu com o conteúdo certo. Termine dizendo o LINK.
 
+**Link compartilhável:** `og:image` com URL absoluta (`https://.../capa.png`),
+nunca `/capa.png`; sem isso o link sai sem imagem no WhatsApp.
+
 **Nunca** publique `.env`, chave ou senha: confira se `.gitignore` e o
 `.vercelignore`/`.netlifyignore` os deixam de fora. Variáveis secretas vão no
 painel do serviço (ou `vercel env add`), não no código.

package/skills/site-com-motion/SKILL.md

@@ -26,6 +26,8 @@ tudo com a mesma duração; `transition: all`; texto piscando; nada que responda
   que acompanha o scroll (parallax, barra de progresso, imagem que cresce), use
   `animation-timeline: view()` e deixe a página parada onde isso não existe (`@supports`).
 - **Só `transform` e `opacity`.** Animar `top`, `width`, `height` ou `box-shadow` trava no celular.
+  Confira com grep: zero `transition: all` no CSS.
+- **Seção de tela cheia** usa `100dvh`, e não `100vh`, pra não ficar atrás da barra do celular.
 - **Troca de página ou de estado:** a View Transitions API (`document.startViewTransition`), com o
   caminho sem animação quando o navegador não tiver.
 - **Biblioteca só se precisar.** CSS e um pouco de JS resolvem quase tudo. Timeline longa ou texto

package/studio/narrar.py

@@ -256,13 +256,16 @@ def comando_falar(args):
 # tempo de CADA PALAVRA volta junto (WordBoundary do edge-tts): é o que
 # sincroniza a tipografia com a voz.
 REGISTRO = {
-    "gancho":   {"ritmo": "+6%",  "tom": "+3Hz", "respiro": 0.35},
-    "numero":   {"ritmo": "-7%",  "tom": "-1Hz", "respiro": 0.45},
-    "contraste": {"ritmo": "+2%", "tom": "+1Hz", "respiro": 0.4},
-    "lista":    {"ritmo": "+0%",  "tom": "+0Hz", "respiro": 0.35},
-    "citacao":  {"ritmo": "-10%", "tom": "-2Hz", "respiro": 0.5},
-    "cta":      {"ritmo": "+4%",  "tom": "+2Hz", "respiro": 0.2},
-    "normal":   {"ritmo": "+0%",  "tom": "+0Hz", "respiro": 0.3},
+    # 10.0: "os vídeos estão muito lentos" (29/09). Ritmo de anúncio por
+    # padrão — ninguém fala devagar num reels — e o respiro entre as partes
+    # caiu para o de uma vírgula: o corte seco é que dá energia.
+    "gancho":   {"ritmo": "+18%", "tom": "+4Hz", "respiro": 0.12},
+    "numero":   {"ritmo": "+8%",  "tom": "+1Hz", "respiro": 0.18},
+    "contraste": {"ritmo": "+14%", "tom": "+2Hz", "respiro": 0.15},
+    "lista":    {"ritmo": "+14%", "tom": "+2Hz", "respiro": 0.12},
+    "citacao":  {"ritmo": "+6%",  "tom": "+0Hz", "respiro": 0.2},
+    "cta":      {"ritmo": "+16%", "tom": "+4Hz", "respiro": 0.1},
+    "normal":   {"ritmo": "+14%", "tom": "+2Hz", "respiro": 0.12},
 }