primocode 10.12.0 → 10.13.0

package/README.md

@@ -1,4 +1,4 @@
-# PrimoCode v10.12.0
+# PrimoCode v10.13.0
 
 Agente de engenharia brasileiro para o terminal, no estilo Claude Code.
 Cria arquivos de verdade, roda comandos, **controla o navegador e o desktop** —
@@ -9,7 +9,7 @@ OpenRouter, e cada apelido (`top`/`main`/`fast`) é uma **corrente**: se um mode
 está no limite de pedidos, o próximo atende. Você não vê o erro, e não paga nada.
 
 ```
- ▐▛███▜▌   Primo Code v10.12.0
+ ▐▛███▜▌   Primo Code v10.13.0
 ▝▜█████▛▘  Bem-vindo de volta, Joel
   ▘▘ ▝▝    ~/primocode  · /dir <pasta> muda
 ```
@@ -17,6 +17,14 @@ está no limite de pedidos, o próximo atende. Você não vê o erro, e não pag
 Personalize o mascote (`primo`, `fox`, `cat`) e o nome com que ele te chama —
 veja `/mascot` e `/name`.
 
+## O que mudou na 10.13
+
+- **Motion pelas referências:** o título enche a tela (rótulo nunca abaixo de 2% da altura), a cena dura de 1 a 2 s, o texto entra com ataque rápido e freio forte, e a frase sai inteira. As saídas que espalhavam letras saíram. O círculo de caneta na palavra-chave ganha o ✓. Sem quadro morto entre as cenas. A conta está em `docs/planos/2026-10-15-motion-pelas-referencias.md`.
+- **Revisão do texto:** antes do render, o PrimoCode avisa texto pequeno demais para o celular e contraste abaixo de 3:1.
+- **Camadas sem legenda dobrada:** a cena escrita pela IA não repete a fala por cima da legenda.
+- **Voz do VoiceStudio:** com o app aberto no Mac, ele narra primeiro. Fechado, a narração segue para o Gemini (`PRIMOCODE_SEM_VOICESTUDIO=1` desliga).
+- **Edição de vídeo:** num vídeo sem pedido falado, a edição não para mais na legenda. O agente corta, dá zoom e cor.
+
 ## O que mudou na 10.12
 
 - **Vídeo em camadas:** você grava só a fala e o PrimoCode monta o resto. O rosto vira cartão, bolinha no canto, some e volta, com mola, e o motion ocupa o espaço que sobra. A legenda vai palavra por palavra, com a palavra forte em serif itálico. O áudio nunca pula. Use `estudio_video acao:"camadas"`: sem batidas, ele propõe pela transcrição.

package/lib/estudio/assinaturas/gerativo.json

@@ -4,7 +4,7 @@
   "origem": "o vídeo que o Joel aprovou em 08/10/2026 (teste-e2e-sono, o gerativo do PR #113, 30,3 s), medido",
   "descricao": "Batida curta e seca, pouco texto por linha, numa identidade só (2 chãos, 1 acento, 2 fontes): o fundo troca na virada de seção, a primeira por corte seco. A palavra gigante entra em ~1 de cada 3 batidas. O som é desenhado da semente e fica mais raro que no fluido.",
   "faixas": {
-    "batida_mediana_s": { "min": 2, "max": 4.5, "medido": 3.18, "diz": "cada batida dura de 1,7 a 4,5 s, o normal é ~3 s" },
+    "batida_mediana_s": { "min": 1, "max": 3, "medido": 3.18, "revisto": "15/10/2026: as referências do Joel (\"motion devem sair assim\") cortam a cada 1 a 2 s; a faixa saiu de 2–4,5 para 1–3 s.", "diz": "cada batida dura de 1 a 3 s, o normal é ~2 s" },
     "palavras_por_frase_max": { "max": 5, "medido": 3, "diz": "no máximo 3 palavras por linha" },
     "palavras_por_frase_mediana": { "max": 3, "medido": 2, "diz": "o normal é 1 a 2 palavras por linha" },
     "cortes_secos": { "min": 1, "medido": 5, "diz": "o fundo troca por corte seco (5 das 9 trocas)" },

package/lib/estudio/camadas.js

@@ -299,6 +299,10 @@ function montar({ src, duracao, palavras = [], batidas, largura = 1080, altura =
                     tipo: 'componente', src: b.cena,
                     dados: {
                         largura: area.w, altura: area.h, duracao: r3(dur - entra),
+                        /* 15/10: a cena escrevia a fala, e a legenda do PrimoCode vinha
+                           por cima ("provou / provou o bolo"). A fala é para SINCRONIA. */
+                        legendaNoQuadro: true,
+                        regra: 'a legenda da fala já está no quadro: não escreva a fala; use as palavras só para o tempo, e desenhe a ideia',
                         fala: ws.map((p) => p.texto).join(' '),
                         palavras: ws.map((p) => ({ texto: p.texto, t: r3(p.de - b.de - entra) })),
                         destaque: (Array.isArray(b.destaque) ? b.destaque : b.destaque ? [b.destaque] : []),

package/lib/estudio/diretor.js

@@ -110,7 +110,8 @@ function vozPara({ tom = 'neutro', idioma = 'pt-BR', genero } = {}) {
 /** Quantas cenas cabem, e de que tamanho, num vídeo desta duração. */
 function ritmoPara(segundos) {
     const s = Math.max(5, Number(segundos) || 30);
-    const media = s <= 20 ? 2.6 : s <= 45 ? 3.4 : s <= 90 ? 4.2 : 5;
+    // (15/10) As referências cortam a cada 1 a 2 s; o PrimoCode pedia 2,6 a 5 s e saía lento.
+    const media = s <= 20 ? 1.8 : s <= 45 ? 2.2 : s <= 90 ? 2.6 : 3;
     return { cenas: Math.max(3, Math.round(s / media)), duracaoMedia: media,
         palavrasPorCena: Math.round(media * 2.6) };   // ~155 palavras/minuto de narração
 }

package/lib/estudio/efeitos-fabrica/terminal-digitando.jsx

@@ -16,7 +16,8 @@ export default function TerminalDigitando({ el, t }) {
   const c = d.cores || {};
   const f = d.fontes || {};
   const u = t - (d.atraso || 0);
-  const linhas = (Array.isArray(d.linhas) && d.linhas.length ? d.linhas : [d.titulo || d.fala || 'faz o vídeo pra mim']).map(String).slice(0, 6);
+  // O prompt "›" é da janela: a linha que já vem com "> " ou "$ " saía com ele dobrado ("› > faz um site", 15/10).
+  const linhas = (Array.isArray(d.linhas) && d.linhas.length ? d.linhas : [d.titulo || d.fala || 'faz o vídeo pra mim']).map((x) => String(x).replace(/^\s*[>›$#]\s+/, '')).slice(0, 6);
   const vel = d.velocidade || 26;
   const k = mola(u);
   const largura = Math.min(W * 0.96, H * 1.5);

package/lib/estudio/gerativo.js

@@ -510,7 +510,9 @@ function tituloDaFala(fala) {
 
 function conteudoDe(p, marca = {}) {
     const titulo = p.titulo || p.texto || tituloDaFala(p.fala);
-    const itens = itensDe(p);
+    // O item que repete o título ("Sem troco" / "sem troco", 15/10) sai: o quadro dizia a mesma coisa duas vezes.
+    const igual = (a, b) => tokens(a).join(' ') === tokens(b).join(' ');
+    const itens = itensDe(p).filter((it) => !igual(it, titulo));
     if (p.tipo === 'numero' && numeroDe(p.valor)) return { tipo: 'numero', valor: String(p.valor), rotulo: p.rotulo || titulo, sub: p.sub || '' };
     if (itens.length >= 2) return { tipo: 'lista', titulo: p.tipo === 'cores' ? titulo : titulo, itens: itens.slice(0, 5), numerada: p.tipo === 'passos' };
     if (p.tipo === 'contraste' && (p.nao || p.sim)) return { tipo: 'contraste', nao: p.nao || '', sim: p.sim || titulo };
@@ -528,7 +530,7 @@ const textoDoConteudo = (c) => [c.titulo, c.sub, c.valor, c.rotulo, c.nao, c.sim
 const COMPOSICOES = ['gigante', 'pilha', 'divisao', 'contador', 'cascata', 'parede', 'citacao', 'marca', 'palavras', 'produto'];
 const COMPORTAMENTOS = ['carimbo', 'mascara', 'onda', 'decodifica', 'peso', 'largura', 'tracking', 'desfoque', 'flap', 'pontos', 'contorno', 'monta'];
 const SAIDAS = ['pontos', 'evapora', 'atravessa', 'desliza', 'comprime', 'explode', 'chicote', 'inunda', 'corte'];
-const ACENTOS = ['ponto', 'sublinha', 'anel', 'risco', 'barra', 'bala', 'marca', 'moldura', 'seta'];
+const ACENTOS = ['ponto', 'sublinha', 'anel', 'risco', 'barra', 'bala', 'marca', 'moldura', 'seta', 'visto'];
 
 function pesosDe(c, { curto, palavras, primeira, ultima, tem3d, pergunta, exclama, numeroNoTitulo }) {
     switch (c.tipo) {
@@ -1055,13 +1057,18 @@ function partituraDe({ roteiro, largura = 1920, altura = 1080, tempos = [], icon
     const M = Math.round(W * (deitado ? 0.085 : 0.095));
     const larguraUtil = W - 2 * M;
     const base = Math.min(W, H) / 1080;
-    const tamRotulo = Math.round((deitado ? 24 : 30) * base);
+    /* (15/10, as referências) O rótulo de 24–30 px (1,6% da altura no 9:16)
+       não se lia no celular ("NO COADOR", "pra você, de graça"). O rótulo
+       fica em ~2% da altura, e a segunda voz (o sub, a frase de apoio) em
+       3–4%, como a anotação das referências. */
+    const tamRotulo = Math.round(Math.max((deitado ? 24 : 30) * base, H * (deitado ? 0.026 : 0.02)));
     const tem3d = !!roteiro.modelo3d;
     const ws = temposDasPartes(partes, tempos);
 
     // ── os limites de cada parte na linha do tempo ────────────────────────
     const inicio = [];
-    partes.forEach((_, i) => inicio.push(i === 0 ? 0 : r3(Math.max(inicio[i - 1] + 1.4, ws[i].de - 0.12))));
+    // 0,9 s (eram 1,4): nas referências a cena dura 1 a 2 s; com fala rápida a parte segue a voz.
+    partes.forEach((_, i) => inicio.push(i === 0 ? 0 : r3(Math.max(inicio[i - 1] + 0.9, ws[i].de - 0.12))));
     const ultimaFala = ws[ws.length - 1];
     const duracao = r1(Math.max(inicio[inicio.length - 1] + 2.0, (ultimaFala.ate || 0) + 1.15));
     const fimParte = partes.map((_, i) => (i < partes.length - 1 ? inicio[i + 1] : duracao));
@@ -1544,14 +1551,18 @@ function partituraDe({ roteiro, largura = 1920, altura = 1080, tempos = [], icon
        resto); no fim, cada gesto vira o seu par limpo. */
     /* O substituto é um limpo que não aparece nas 3 batidas de cada lado: a
        passagem e o gesto da tese não voltam antes de 3 batidas. */
-    const TORTOS = ['decodifica', 'flap', 'onda', 'monta'];
-    const GESTOS_LIMPOS = ['mascara', 'desfoque', 'tracking', 'pontos', 'contorno', 'carimbo'];
-    const SAIDAS_LIMPAS = ['evapora', 'desliza', 'comprime', 'pontos', 'atravessa'];
+    /* (15/10, as referências) Os pontos, o evapora e o comprime também
+       espalhavam as letras ("dad|o", "· p o n d e", parecia glitch). Nas
+       referências a frase sai inteira: desliza, atravessa ou corta seco. */
+    const TORTOS = ['decodifica', 'flap', 'onda', 'monta', 'pontos'];
+    const GESTOS_LIMPOS = ['mascara', 'desfoque', 'tracking', 'contorno', 'carimbo'];
+    const SAIDAS_LIMPAS = ['desliza', 'atravessa', 'corte'];
+    const SAIDAS_SUJAS = ['explode', 'chicote', 'pontos', 'evapora', 'comprime'];
     const vizinhas = (i) => batidas.filter((_, j) => j !== i && Math.abs(j - i) <= 3);
     const principal = (b) => (b.linhas || []).find((l) => (l.papel === 'tese' || l.papel === 'numero') && !l.marca);
     const comGesto = batidas.filter(principal);
     batidas.forEach((b, i) => {
-        if (b.saida === 'explode' || b.saida === 'chicote') {
+        if (SAIDAS_SUJAS.includes(b.saida)) {
             const perto = vizinhas(i).map((x) => x.saida);
             b.saida = SAIDAS_LIMPAS.find((x) => !perto.includes(x)) || 'corte';
             if (batidas[i + 1]) batidas[i + 1].entrada = b.saida;
@@ -1626,6 +1637,11 @@ function molduraDe(roteiro, E, { W, H, deitado, marca, secoes }) {
 const pesoDe = (fonte) => (VARIAVEIS[fonte] && VARIAVEIS[fonte].eixos.wght) || [400, 400];
 
 // ── as composições: de conteúdo + contexto, uma batida ─────────────────
+/** A segunda voz (sub, a frase de apoio): 3–4% da altura, como a anotação das referências. */
+function tamSegunda({ H, deitado, tamRotulo }) {
+    return Math.round(Math.max(tamRotulo, H * (deitado ? 0.042 : 0.03)));
+}
+
 function compor(comp, br, ctx) {
     const { s, W, H, M, deitado, base, larguraUtil, tamRotulo, fontes } = ctx;
     const c = br.conteudo;
@@ -1739,6 +1755,8 @@ function compor(comp, br, ctx) {
                 else {
                     const lt = comTese || teses[teses.length - 1];
                     b.acento.push({ forma, alvo: { linha: lt.id, palavra: comTese ? lt.palavras.findIndex((p) => p.papel === 'tese') : null } });
+                    // O círculo de caneta na tese ganha o ✓ (15/10, as referências), sem gastar sorteio.
+                    if (forma === 'anel' && comTese) b.acento.push({ forma: 'visto', alvo: { linha: lt.id, palavra: lt.palavras.findIndex((p) => p.papel === 'tese') } });
                 }
             }
             // O ThreeCanvas só aceita pixel inteiro; ele ocupa a altura toda, para o chão não cortar.
@@ -1759,7 +1777,13 @@ function compor(comp, br, ctx) {
             }
             for (const t of fit.linhas) { const l = linha(t, 'apoio', { tamanho: fit.tamanho, eixos: { wght: 560 } }); misturarPesos(l, { maiorTese: 1.14 }); }
             const lt = b.linhas.find((l) => l.palavras.some((p) => p.papel === 'tese'));
-            if (lt) { tese(lt); b.acento.push({ forma: s.chance(0.6) ? 'sublinha' : 'anel', alvo: { linha: lt.id, palavra: lt.palavras.findIndex((p) => p.papel === 'tese') } }); }
+            if (lt) {
+                tese(lt);
+                const alvo = { linha: lt.id, palavra: lt.palavras.findIndex((p) => p.papel === 'tese') };
+                const forma = s.chance(0.6) ? 'sublinha' : 'anel';
+                b.acento.push({ forma, alvo });
+                if (forma === 'anel') b.acento.push({ forma: 'visto', alvo: { ...alvo } });
+            }
             else pontoFinal(b.linhas[b.linhas.length - 1]);
             break;
         }
@@ -1774,7 +1798,7 @@ function compor(comp, br, ctx) {
             const l = linha(c.valor, 'numero', { fonte, tamanho: tam, eixos });
             const tRot = Math.max(30 * base, Math.min(tam * 0.22, 64 * base));
             if (c.rotulo) linha(c.rotulo, 'apoio', { tamanho: tRot, eixos: { wght: 600 }, fonte: fontes.display });
-            if (c.sub) linha(c.sub, 'rotulo', { fonte: fontes.mono, tamanho: tamRotulo, tracking: 0.08, eixos: { wght: 400 } });
+            if (c.sub) linha(c.sub, 'rotulo', { fonte: fontes.mono, tamanho: tamSegunda(ctx), tracking: 0.02, eixos: { wght: 400 } });
             b.contador = { linha: l.id, ...n, dur: 0.9 };
             b.acento.push({ forma: c.valor.length <= 4 ? 'anel' : 'sublinha', alvo: { linha: l.id } });
             break;
@@ -1844,7 +1868,7 @@ function compor(comp, br, ctx) {
             const tam = tamanhoQueCabe(nome, lg, (deitado ? 0.3 : 0.16) * H, { fonte, wght: 800 });
             b.bloco = { x: W / 2 + tam * 0.3, y: H * 0.5, alinha: 'centro', vert: 'meio', largura: lg, gap: 0.2 };
             linha(nome, 'tese', { fonte, tamanho: tam, eixos: { wght: Math.min(800, pesoDe(fonte)[1]) }, comportamento: 'contorno' }).marca = true;
-            if (c.sub || c.link) linha(c.sub || c.link, 'rotulo', { fonte: fontes.mono, tamanho: tamRotulo, tracking: 0.2, maiusc: true, eixos: { wght: 400 } });
+            if (c.sub || c.link) linha(c.sub || c.link, 'rotulo', { fonte: fontes.mono, tamanho: tamSegunda(ctx), tracking: 0.06, eixos: { wght: 400 } });
             b.acento.push({ forma: 'ponto', alvo: { linha: b.linhas[0].id, antes: true } });
             break;
         }
@@ -1952,9 +1976,10 @@ function tempoDaBatida(b, palavras, ctx) {
         l.t = r3(Math.max(i === 0 ? b.de + 0.1 : t + REGRAS.stagger[0] * Q, falado != null ? falado : (i === 0 ? b.de + 0.12 : t + passo)));
         t = l.t;
     });
-    /* Quadro morto não: a primeira coisa da batida entra em até 0,35 s, mesmo
-       que a voz ainda não a tenha dito (o resto segue a voz). */
-    if (ordem[0] && ordem[0].t > b.de + 0.35) ordem[0].t = r3(b.de + 0.35);
+    /* Quadro morto não: a primeira coisa da batida entra em até 0,12 s, mesmo
+       que a voz ainda não a tenha dito (o resto segue a voz). Eram 0,35 s, e
+       com a saída da anterior o teste de 15/10 tinha 23% de quadro vazio. */
+    if (ordem[0] && ordem[0].t > b.de + 0.12) ordem[0].t = r3(b.de + 0.12);
     for (let i = 1; i < ordem.length; i++) if (ordem[i].t < ordem[i - 1].t + REGRAS.stagger[0] * Q) ordem[i].t = r3(ordem[i - 1].t + REGRAS.stagger[0] * Q);
     // Nada entra tarde demais para ser lido: de trás para frente, com o stagger mínimo.
     for (let i = ordem.length - 1; i >= 0; i--) {
@@ -1985,7 +2010,11 @@ function tempoDaBatida(b, palavras, ctx) {
         let tw = l.t;
         l.palavras.forEach((p, j) => {
             const alvo = qs[j] != null ? qs[j] : (j === 0 ? l.t : tw + 2 * Q);
-            p.t = r3(Math.min(Math.max(j === 0 ? l.t : tw + 2 * Q, alvo), Math.max(l.t, fim)));
+            /* Quadro morto não, também na palavra (15/10): a voz pode dizer
+               outra coisa antes ("Aponta a câmera, paga, e o pão…"); a primeira
+               palavra da batida entra com a linha, as outras seguem a voz. */
+            const abre = j === 0 && l === ordem[0];
+            p.t = r3(abre ? l.t : Math.min(Math.max(j === 0 ? l.t : tw + 2 * Q, alvo), Math.max(l.t, fim)));
             tw = p.t;
         });
     }

package/lib/estudio/index.js

@@ -65,6 +65,7 @@ const gerativo = require('./gerativo.js');
 const fluido = require('./fluido.js');
 const vox = require('./vox.js');
 const kokoro = require('./kokoro.js');
+const voicestudio = require('./voicestudio.js');
 const lancamento = require('./lancamento.js');
 const glifos = require('./glifos.js');
 const personagem = require('./personagem.js');
@@ -887,7 +888,7 @@ async function ferramentaVideo(args, ctx = {}) {
                 ok: true, proposta: camadas.propor(palavras, m.segundos), duracao: m.segundos,
                 comoUsar: 'é uma SUGESTÃO pela transcrição. Decida você: mude as formas, junte ou separe batidas, '
                     + 'escreva a cena de motion de cada ideia (componentes/x.jsx, recebe {el, t, fps}; el.dados traz largura/altura do espaço livre, '
-                    + 'palavras com t, destaque, cores e fontes) ou use um efeito de fábrica pelo nome (estudio_midia acao:"efeitos"), '
+                    + 'palavras com t, destaque, cores e fontes; a LEGENDA da fala já está no quadro, então a cena NÃO escreve a fala: desenha a ideia) ou use um efeito de fábrica pelo nome (estudio_midia acao:"efeitos"), '
                     + 'e chame de novo com batidas:[{de, ate, rosto, cena?, destaque?, canto?, dados?}].',
             };
         }
@@ -1177,6 +1178,35 @@ async function narrarComGemini(lista, mp3, { voz, direcao } = {}) {
     }
 }
 
+/* A VOZ DO VOICESTUDIO (15/10): o app local fala o roteiro inteiro, e o resto
+   é o caminho do Gemini — volume de Reels, a transcrição para achar as partes.
+   Fechado ou falhando, devolve ok:false e a cadeia segue para o Gemini. */
+async function narrarComVoiceStudio(lista, mp3, { voz } = {}) {
+    if (process.env.PRIMOCODE_SEM_VOICESTUDIO) return { ok: false, indisponivel: true, error: 'voicestudio desligado' };
+    try {
+        const texto = lista.map((x) => x.texto).join('\n\n');
+        // A voz do Gemini ("Kore", "Charon") não existe lá: só um perfil do próprio app.
+        const perfil = /^vs:/i.test(String(voz || '')) ? String(voz).slice(3) : undefined;
+        const r = await voicestudio.falar(texto, { voz: perfil });
+        if (!r.ok) return r;
+        const bruto = mp3.replace(/\.mp3$/, '-vs.mp3');
+        fs.writeFileSync(bruto, r.audio);
+        const c = await video.rodar(video.ffmpeg(), ['-y', '-i', bruto, '-af', 'loudnorm=I=-14:TP=-1.5:LRA=9', '-c:a', 'libmp3lame', '-q:a', '3', mp3], { timeout: 120000 });
+        try { fs.unlinkSync(bruto); } catch { /* fica */ }
+        if (!c.ok) return { ok: false, error: 'voicestudio: não consegui converter a voz' };
+        const med = await video.medir(mp3);
+        const chars = lista.reduce((n, x) => n + x.texto.length, 0);
+        if (med.segundos < chars / 22) return { ok: false, error: `voicestudio: a voz veio cortada (${med.segundos.toFixed(1)} s para ${chars} caracteres)` };
+        const cfg = require('../config').loadConfig();
+        const tr = await require('../api').requestTranscricao(cfg.server, { token: cfg.token, audio: fs.readFileSync(mp3).toString('base64'), nome: 'voz.mp3', idioma: 'pt' });
+        const palavras = (tr && tr.palavras) || [];
+        if (!palavras.length) return { ok: false, error: 'voicestudio: sem a transcrição da voz para achar as partes' };
+        return { ok: true, voz: `voicestudio ${perfil || 'default'}`, segundos: med.segundos, partes: alinharPartes(lista, palavras, med.segundos) };
+    } catch (e) {
+        return { ok: false, error: 'voicestudio: ' + e.message };
+    }
+}
+
 /* Onde estão os rostos em cada foto (studio/rostos.py, pelo uv). Guardado no
    projeto: a mesma foto não é analisada duas vezes. */
 async function acharRostos(p, srcs) {
@@ -1270,7 +1300,9 @@ async function narrarComCache(lista, mp3, { voz, direcao } = {}) {
     if (fs.existsSync(cm) && fs.existsSync(cj)) { fs.copyFileSync(cm, mp3); return { ok: true, ...JSON.parse(fs.readFileSync(cj, 'utf8')) }; }
     // A voz local pedida (voz: 'kokoro'): direto nela, sem gastar a cota do Gemini.
     if (kokoro.querKokoro(voz)) return kokoro.narrar(lista, mp3, { voz, uv: acharUv() });
-    const v = await narrarComGemini(lista, mp3, { voz, direcao });
+    // O VoiceStudio local primeiro (15/10); fechado ou falhando, o Gemini.
+    let v = await narrarComVoiceStudio(lista, mp3, { voz });
+    if (!v.ok) v = await narrarComGemini(lista, mp3, { voz, direcao });
     if (v.ok) { try { fs.mkdirSync(dir, { recursive: true }); fs.copyFileSync(mp3, cm); fs.writeFileSync(cj, JSON.stringify({ voz: v.voz, segundos: v.segundos, partes: v.partes })); } catch { /* sem cache */ } }
     return v;
 }
@@ -1289,6 +1321,7 @@ async function produzirNecessidade(p, roteiro, pedido, provedores) {
    direção dele), o Kokoro local e o Edge. A falha de uma passa para a próxima. */
 function provedoresDeVoz(lista, mp3, arq, voz, vozEdge, { soEdge = false, gemini, escolha } = {}) {
     const todos = {
+        voicestudio: () => narrarComVoiceStudio(lista, mp3, { voz }),
         gemini: () => gemini(),
         kokoro: () => kokoro.narrar(lista, mp3, { voz, uv: acharUv() }),
         edge: () => {
@@ -1307,7 +1340,7 @@ function provedoresDeVoz(lista, mp3, arq, voz, vozEdge, { soEdge = false, gemini
 /* A VOZ DE RESERVA, quando o Gemini falha: o Kokoro (local, sem cota) e
    depois o Edge. A falha de uma passa para a próxima, nunca derruba. */
 function narrarReserva(lista, mp3, arq, voz, vozEdge, { soEdge = false, semKokoro = false } = {}) {
-    const passos = kokoro.ordem(voz, process.env, { soEdge }).filter((n) => n !== 'gemini' && !(semKokoro && n === 'kokoro'));
+    const passos = kokoro.ordem(voz, process.env, { soEdge }).filter((n) => n !== 'gemini' && n !== 'voicestudio' && !(semKokoro && n === 'kokoro'));
     return kokoro.corrente(passos, {
         kokoro: () => kokoro.narrar(lista, mp3, { voz, uv: acharUv() }),
         edge: () => rodarPython('narrar.py', ['roteiro', '--arquivo', arq, '--saida', mp3, '--voz', kokoro.vozNoEdge(voz, vozEdge)], { timeout: 10 * 60000 }),

package/lib/estudio/kit/gerativo.jsx

@@ -295,6 +295,21 @@ function geometria(a, b, L, P) {
     for (let i = 0; i < N; i++) { const q = -2.3 + (i / (N - 1)) * Math.PI * 2 * 1.1; const e = 1 + (i / N) * 0.07; pts.push([ccx + Math.cos(q) * rx * e, ccy + Math.sin(q) * ry * e]); }
     return { pts, larg: Math.max(4 * base, cx.s * 0.03), alfa: 1, frente: true, cx: ccx, cy: ccy };
   }
+  if (f === 'visto') {
+    /* O ✓ de caneta (15/10, as referências): depois do círculo, ao lado da
+       palavra, em dois traços; se não cabe à direita, encosta na margem. */
+    const pw = alvoPalavra();
+    const s = cx.s, cy0 = cx.y + cx.h * 0.5;
+    const A = [pw.x + pw.w + s * 0.16, cy0], B = [pw.x + pw.w + s * 0.27, cy0 + s * 0.2], C = [pw.x + pw.w + s * 0.52, cy0 - s * 0.3];
+    const dx = Math.min(0, P.largura - 24 * base - C[0]);
+    const q = 0.3;
+    for (let i = 0; i < N; i++) {
+      const k = i / (N - 1);
+      const [p0, p1, u] = k < q ? [A, B, k / q] : [B, C, (k - q) / (1 - q)];
+      pts.push([lerp(p0[0], p1[0], u) + dx, lerp(p0[1], p1[1], u)]);
+    }
+    return { pts, larg: Math.max(5 * base, s * 0.045), alfa: 1, frente: true, tampa: 'round', cx: B[0] + dx, cy: B[1] };
+  }
   if (f === 'barra') {
     // O vão da barra é o respiro do vídeo (margem.js): colada, ela riscava a primeira letra.
     // A deriva da vida abre as letras até 3% da linha para fora: a barra recua junto.

package/lib/estudio/kokoro.js

@@ -94,7 +94,9 @@ async function narrar(lista, mp3, { voz, uv, espeak = acharEspeak(), executar =
     roteiro pula as outras. */
 function ordem(voz, env = process.env, { soEdge = false } = {}) {
     if (soEdge) return ['edge'];
-    return querKokoro(voz, env) ? ['kokoro', 'edge'] : ['gemini', 'edge', 'kokoro'];
+    if (querKokoro(voz, env)) return ['kokoro', 'edge'];
+    // O VoiceStudio local vem primeiro (15/10); fechado, a cadeia segue para o Gemini na hora.
+    return env.PRIMOCODE_SEM_VOICESTUDIO ? ['gemini', 'edge', 'kokoro'] : ['voicestudio', 'gemini', 'edge', 'kokoro'];
 }
 
 /* A voz do Gemini no Edge: o narrar.py só conhece antonio, francisca e

package/lib/estudio/remotion.js

@@ -108,9 +108,9 @@ import { KIT, CURVAS_KIT, Filtros } from './kit';
 import { COMPONENTES } from './componentes';
 
 /* ── SUAVIZAÇÃO ──────────────────────────────────────────────────────────
- * Cada curva é uma função de 0..1 em 0..1. "suave" é o padrão porque
- * movimento linear é o que mais denuncia animação feita por máquina: nada no
- * mundo físico começa e para na mesma velocidade. */
+ * Cada curva é uma função de 0..1 em 0..1. A "editorial" é o padrão (15/10):
+ * movimento linear denuncia máquina, e o entra-e-sai devagar da "suave" lia
+ * como fade; as referências atacam rápido e desaceleram forte. */
 const CURVAS = {
   linear: (t) => t,
   suave: (t) => (t < 0.5 ? 2 * t * t : 1 - Math.pow(-2 * t + 2, 2) / 2),
@@ -143,7 +143,9 @@ function valorEm(trilha, t, padrao) {
     const a = trilha[i], b = trilha[i + 1];
     if (t >= a.t && t <= b.t) {
       const bruto = b.t === a.t ? 1 : (t - a.t) / (b.t - a.t);
-      const curva = CURVAS[b.e || a.e || 'suave'] || CURVAS.suave;
+      /* (15/10, as referências) Sem curva dita, a editorial: ataque rápido e
+         desaceleração forte. A "suave" (entra e sai devagar) lia como fade. */
+      const curva = CURVAS[b.e || a.e || 'editorial'] || CURVAS.editorial;
       const k = curva(bruto);
       /* Texto no lugar do número: é COR ("#ff6a00") ou CAMINHO (o "d" de um
          SVG). A cor mistura; o caminho se deforma (morfar.js): a bolinha

package/lib/estudio/revisor.js

@@ -16,6 +16,8 @@
  *   avisa     a mesma sequência de elementos em 4+ cenas seguidas (cara de template)
  *   avisa     imagem sem a pessoa pedir, ou imagem em mais da metade das cenas
  *   conserta  efeito sonoro demais (mais de 1 a cada 1,5 s) → ficam os mais altos
+ *   avisa     texto pequeno demais para o celular (< 2% da altura no 9:16)
+ *   avisa     texto com contraste abaixo de 3:1 contra o fundo da cena
  * Puro: o plano entra, o plano consertado e a lista saem.
  */
 
@@ -34,6 +36,62 @@ const palavras = (t) => String(t || '').split(/\s+/).filter(Boolean).length;
 // Imagem ou vídeo DE FORA: o vídeo da própria gravação (deOrigem) e o recorte da pessoa não contam.
 const imagemDeFora = (el) => el && (el.tipo === 'imagem' || (el.tipo === 'video' && el.deOrigem == null && !/pessoa-/.test(el.src || '')));
 
+/* O TEXTO QUE NÃO SE LÊ (15/10, as referências): rótulo de 1,6% da altura
+   ("NO COADOR") e laranja sobre bege. Nas referências a palavra principal
+   ocupa 55–85% da largura e a segunda voz ~5% da altura, sempre em contraste
+   duro. Contraste é o da WCAG para texto grande (3:1). */
+const hex6 = (c) => {
+    const m = /^#?([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(String(c || '').trim());
+    if (!m) return null;
+    const h = m[1].length === 3 ? m[1].split('').map((x) => x + x).join('') : m[1];
+    return [0, 2, 4].map((i) => parseInt(h.slice(i, i + 2), 16) / 255);
+};
+const luminancia = (c) => {
+    const v = hex6(c);
+    if (!v) return null;
+    const [r, g, b] = v.map((x) => (x <= 0.03928 ? x / 12.92 : Math.pow((x + 0.055) / 1.055, 2.4)));
+    return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+};
+function contraste(a, b) {
+    const la = luminancia(a), lb = luminancia(b);
+    if (la == null || lb == null) return null;
+    return (Math.max(la, lb) + 0.05) / (Math.min(la, lb) + 0.05);
+}
+const corDoFundo = (f) => (typeof f === 'string' ? f : f && (f.valor || f.cor)) || null;
+
+function revisarLeitura(plano, avisos) {
+    const W = Number(plano.formato && plano.formato.largura) || 1920, H = Number(plano.formato && plano.formato.altura) || 1080;
+    const piso = H * (W > H ? 0.024 : 0.019);
+    const curto = (t) => String(t || '').slice(0, 24);
+    const pequenos = [], apagados = [];
+    (plano.cenas || []).forEach((c, i) => {
+        const fundo = corDoFundo(c.fundo) || plano.fundoGeral;
+        for (const e of c.elementos || []) {
+            if (!e) continue;
+            if (e.tipo === 'texto') {
+                const tam = Number(e.tamanho || (e.estilo && e.estilo.tamanho));
+                if (tam && tam < piso) pequenos.push(`cena ${i + 1} "${curto(e.texto)}" ${r2((tam / H) * 100)}%`);
+                const k = contraste(e.cor || (e.estilo && e.estilo.cor), fundo);
+                if (k != null && k < 3) apagados.push(`cena ${i + 1} "${curto(e.texto)}" ${r2(k)}:1`);
+            }
+            if (e.tipo === 'kit' && e.peca === 'gerativo' && e.partitura) {
+                const Hp = Number(e.partitura.altura) || H;
+                const pisoP = Hp * ((Number(e.partitura.largura) || W) > Hp ? 0.024 : 0.019);
+                for (const b of e.partitura.batidas || []) {
+                    const cores = b.cores || {};
+                    for (const l of b.linhas || []) {
+                        if (l.tamanho && l.tamanho < pisoP) pequenos.push(`batida ${r2(b.de)}s "${curto(l.texto)}" ${r2((l.tamanho / Hp) * 100)}%`);
+                    }
+                    const k = contraste(cores.texto, cores.fundo);
+                    if (k != null && k < 3) apagados.push(`batida ${r2(b.de)}s ${cores.texto} sobre ${cores.fundo} ${r2(k)}:1`);
+                }
+            }
+        }
+    });
+    if (pequenos.length) avisos.push(`texto pequeno demais para o celular (piso ~2% da altura): ${pequenos.slice(0, 3).join('; ')}${pequenos.length > 3 ? ` e mais ${pequenos.length - 3}` : ''}`);
+    if (apagados.length) avisos.push(`texto com contraste abaixo de 3:1 contra o fundo: ${apagados.slice(0, 3).join('; ')}${apagados.length > 3 ? ` e mais ${apagados.length - 3}` : ''}`);
+}
+
 function revisar(plano, { semImagem = false } = {}) {
     const consertos = [], avisos = [];
     const cenas = (plano && plano.cenas) || [];
@@ -114,6 +172,9 @@ function revisar(plano, { semImagem = false } = {}) {
     if (semImagem && comImagem) avisos.push(`${comImagem} cena(s) com imagem de fora, mas a pessoa não pediu imagem`);
     else if (cenas.length >= 4 && comImagem / cenas.length > 0.5) avisos.push(`imagem em ${comImagem} de ${cenas.length} cenas — a imagem é um momento, não o vídeo inteiro`);
 
+    // 7. O texto que não se lê: pequeno demais ou sem contraste.
+    revisarLeitura(plano, avisos);
+
     return { plano, consertos, avisos };
 }
 

package/lib/estudio/voicestudio.js

@@ -0,0 +1,81 @@
+/**
+ * voicestudio.js — a voz local do VoiceStudio, a primeira da cadeia.
+ *
+ *   "achei isso: https://voicestudio.sh/ podemos usar pra narração do motion,
+ *    ele entra primeiro na cadeia e depois, se falhar, o Gemini" (Joel, 15/10)
+ *
+ * O VoiceStudio é um app de desktop (AGPL-3.0) que a pessoa instala e deixa
+ * aberto; ele serve uma API no formato da OpenAI em localhost:3900, sem chave
+ * no loopback (docs/api-auth.md do repo dele). O PrimoCode só CHAMA a API —
+ * não copia nem distribui o código dele, então a licença não pega.
+ *
+ * Fechado, a porta recusa na hora e a cadeia segue para o Gemini sem esperar.
+ * Puro de rede: http do Node, sem dependência.
+ *
+ *   VOICESTUDIO_URL     outro endereço (padrão http://127.0.0.1:3900)
+ *   VOICESTUDIO_VOZ     o perfil de voz do app (padrão "default")
+ *   VOICESTUDIO_MODELO  o motor (padrão "omnivoice")
+ */
+
+'use strict';
+
+const http = require('http');
+const https = require('https');
+
+const URL_PADRAO = 'http://127.0.0.1:3900';
+const LIMITE = 4096;   // o input máximo do /v1/audio/speech
+
+function base(url) { return String(url || process.env.VOICESTUDIO_URL || URL_PADRAO).replace(/\/+$/, ''); }
+
+function pedir(metodo, url, { corpo = null, timeout = 800 } = {}) {
+    return new Promise((ok) => {
+        let u;
+        try { u = new URL(url); } catch { ok({ ok: false, error: 'endereço inválido' }); return; }
+        const lib = u.protocol === 'https:' ? https : http;
+        const dados = corpo ? Buffer.from(JSON.stringify(corpo)) : null;
+        const req = lib.request(u, {
+            method: metodo,
+            headers: dados ? { 'content-type': 'application/json', 'content-length': dados.length } : {},
+        }, (res) => {
+            const partes = [];
+            res.on('data', (c) => partes.push(c));
+            res.on('end', () => ok({ ok: res.statusCode >= 200 && res.statusCode < 300, status: res.statusCode, corpo: Buffer.concat(partes) }));
+        });
+        req.setTimeout(timeout, () => req.destroy(new Error('tempo esgotado')));
+        req.on('error', (e) => ok({ ok: false, error: e.message, recusou: /ECONNREFUSED|EADDRNOTAVAIL|ENOTFOUND/.test(e.code || e.message) }));
+        if (dados) req.write(dados);
+        req.end();
+    });
+}
+
+/** O app está aberto? Pergunta rápida: fechado, a porta recusa na hora. */
+async function disponivel({ url } = {}) {
+    const r = await pedir('GET', base(url) + '/v1/audio/voices', { timeout: 800 });
+    return r.ok === true;
+}
+
+/**
+ * Um texto em áudio (mp3). Nunca lança: devolve {ok, audio} ou {ok:false, error}.
+ * O primeiro pedido carrega o modelo no app, por isso o tempo é longo.
+ */
+async function falar(texto, { url, voz, modelo, idioma = 'pt', timeout = 10 * 60000 } = {}) {
+    const input = String(texto || '').trim();
+    if (!input) return { ok: false, error: 'voicestudio: texto vazio' };
+    if (input.length > LIMITE) return { ok: false, error: `voicestudio: o texto passa de ${LIMITE} caracteres` };
+    if (!(await disponivel({ url }))) return { ok: false, indisponivel: true, error: 'voicestudio: o app não está aberto' };
+    const r = await pedir('POST', base(url) + '/v1/audio/speech', {
+        corpo: {
+            model: modelo || process.env.VOICESTUDIO_MODELO || 'omnivoice',
+            input,
+            voice: voz || process.env.VOICESTUDIO_VOZ || 'default',
+            response_format: 'mp3',
+            language: idioma,
+        },
+        timeout,
+    });
+    if (!r.ok) return { ok: false, error: `voicestudio: ${r.error || 'status ' + r.status}${r.corpo && r.corpo.length < 400 ? ' ' + r.corpo.toString() : ''}` };
+    if (!r.corpo || r.corpo.length < 8) return { ok: false, error: 'voicestudio: áudio vazio' };
+    return { ok: true, audio: r.corpo };
+}
+
+module.exports = { disponivel, falar, URL_PADRAO, LIMITE };

package/lib/video/auto.js

@@ -254,9 +254,22 @@ function juntarSilencios(sil) {
     return out;
 }
 
+/* O que vem depois do auto. Sem pedido falado (15/10: um vídeo do Instagram,
+   "edita pra mim?"), o plano é vazio e só a legenda entra — e o agente
+   exportava assim. Aí a edição volta para ele decidir, com o cardápio. */
+function depois(passos) {
+    if ((passos || []).length) return { semPedido: false, texto: 'inspect para OLHAR os momentos; export renderiza (o 3D sai no export)' };
+    return {
+        semPedido: true,
+        texto: 'A gravação não tem pedido falado: só a legenda entrou, e isso ainda não é a edição. '
+            + 'Se a pessoa pediu para editar, a edição é sua: leia a fala (get_transcript) e decida — por exemplo cortar os silêncios (remove_silence), '
+            + 'zoom nos momentos fortes (auto_zoom), apoio quando ela cita uma coisa (add_clips), cor (grade). Olhe com inspect antes do export.',
+    };
+}
+
 const OPS = {
     auto: {
-        uso: 'auto {asset?,dryRun?} — O VÍDEO É O PEDIDO: lê o que a pessoa FALA na gravação ("separe em camadas", "coloca o logo do Claude aqui", "com o estalar de dedos me coloca numa praia", "junta e vira um cérebro", "cortou o silêncio", "o vídeo acaba") e aplica cada efeito no momento em que ela diz, ancorado na palavra, na mão, no estalo e no juntar das mãos; legenda sempre. Use logo depois do import quando pedirem "edite esse vídeo" sem dizer o quê',
+        uso: 'auto {asset?,dryRun?} — O VÍDEO É O PEDIDO: lê o que a pessoa FALA na gravação ("separe em camadas", "coloca o logo do Claude aqui", "com o estalar de dedos me coloca numa praia", "junta e vira um cérebro", "cortou o silêncio", "o vídeo acaba") e aplica cada efeito no momento em que ela diz, ancorado na palavra, na mão, no estalo e no juntar das mãos; legenda sempre. Serve quando a gravação TRAZ pedidos falados. Sem pedido falado (vídeo de outra pessoa, ou só fala), ele põe só a legenda, e o resto da edição é decisão sua',
         async run(ctx, a) {
             const T = require('./timeline.js');
             const C = require('./camadas.js');
@@ -317,13 +330,15 @@ const OPS = {
                 if (L.position && ids.length) await roda('style_captions', { ids, position: L.position }, desde !== null ? 'em cima da cabeça, desde o momento dito' : 'em cima da cabeça');
             }
             const falhou = feitos.filter((f) => !f.ok);
+            const prox = depois(plano.passos);
             return { ok: !falhou.length, feitos, tookS: Math.round((Date.now() - inicio) / 100) / 10,
                 ...(falhou.length ? { error: falhou.map((f) => `${f.op}: ${f.error}`).join('; ') } : {}),
-                depois: 'inspect para OLHAR os momentos; export renderiza (o 3D sai no export)' };
+                ...(prox.semPedido ? { semPedido: true } : {}),
+                depois: prox.texto };
         },
     },
 };
 
 const EX = { auto: '{}' };
 
-module.exports = { planejar, frases, normal, fundoPedido, juntarSilencios, OPS, EX };
+module.exports = { planejar, frases, normal, fundoPedido, juntarSilencios, depois, OPS, EX };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primocode",
-  "version": "10.12.0",
+  "version": "10.13.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/planos-tela.test.js && 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/gerativo-identidade.test.js && node test/gerativo-moldura.test.js && node test/gerativo-heroi.test.js && node test/gerativo-ambiente.test.js && node test/gerativo-variedade.test.js && node test/hibrido.test.js && node test/batida.test.js && node test/estudio-acervo.test.js && node test/estudio-diretor.test.js && node test/estudio-marca.test.js && node test/estudio-novo-projeto.test.js && node test/estudio-plano.test.js && node test/estudio-slides.test.js && node test/estudio-video.test.js && node test/revisor.test.js && node test/conferencia.test.js && node test/cor.test.js && node test/assinatura.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/rolar.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 && node test/zoom.test.js && node test/personagem.test.js && node test/tela.test.js && node test/margem.test.js && node test/travado.test.js && node test/leitura.test.js && node test/producao-provedores.test.js && node test/broll-frase.test.js && node test/vazamento.test.js && node test/colecao.test.js && node test/mundo.test.js && node test/mcp-procurar.test.js && node test/selecao.test.js && node test/nome-curto.test.js && node test/agents-md.test.js && node test/outra-pasta.test.js && node test/estudio-sem-id.test.js && node test/estudio-objeto-do-site.test.js && node test/cenarios.test.js && node test/movimentos.test.js && node test/gerativo-so-fala.test.js && node test/estilos.test.js && node test/proporcao.test.js && node test/cena.test.js && node test/sem-narracao.test.js && node test/camadas.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/planos-tela.test.js && 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/gerativo-identidade.test.js && node test/gerativo-moldura.test.js && node test/gerativo-heroi.test.js && node test/gerativo-ambiente.test.js && node test/gerativo-variedade.test.js && node test/hibrido.test.js && node test/batida.test.js && node test/estudio-acervo.test.js && node test/estudio-diretor.test.js && node test/estudio-marca.test.js && node test/estudio-novo-projeto.test.js && node test/estudio-plano.test.js && node test/estudio-slides.test.js && node test/estudio-video.test.js && node test/revisor.test.js && node test/conferencia.test.js && node test/cor.test.js && node test/assinatura.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/rolar.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 && node test/zoom.test.js && node test/personagem.test.js && node test/tela.test.js && node test/margem.test.js && node test/travado.test.js && node test/leitura.test.js && node test/producao-provedores.test.js && node test/broll-frase.test.js && node test/vazamento.test.js && node test/colecao.test.js && node test/mundo.test.js && node test/mcp-procurar.test.js && node test/selecao.test.js && node test/nome-curto.test.js && node test/agents-md.test.js && node test/outra-pasta.test.js && node test/estudio-sem-id.test.js && node test/estudio-objeto-do-site.test.js && node test/cenarios.test.js && node test/movimentos.test.js && node test/gerativo-so-fala.test.js && node test/estilos.test.js && node test/proporcao.test.js && node test/cena.test.js && node test/sem-narracao.test.js && node test/camadas.test.js && node test/gerativo-referencias.test.js && node test/voicestudio.test.js"
   },
   "engines": {
     "node": ">=18.17.0"

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

@@ -7,43 +7,35 @@ autor: PrimoCode
 Não existe template. Cada propriedade deste vídeo é uma decisão sua, e a
 primeira decisão é **não repetir o vídeo anterior**.
 
-## O que denuncia vídeo feito por IA
-
-Não faça nada disto, em nenhum vídeo:
-
-- gradiente roxo-para-azul, e gradiente de duas
-  cores que não têm relação com o assunto;
-- tudo centralizado, do primeiro ao último quadro;
-- uma fonte só, em todos os tamanhos;
-- texto que aparece com `opacidade 0→1` e mais nada, cena após cena;
-- ícone genérico flutuando ao lado de cada frase;
-- tempo igual em todas as cenas;
-- transição igual entre todas.
-
-## O que separa motion bom de slide animado
-
-**A câmera existe.** Um zoom lento de 1.0 para 1.08 na cena inteira dá vida a
-um quadro parado.
-
-**Nada entra do nada.** Um elemento entra vindo de algum lugar (de baixo, de
-trás, de fora do quadro), com `spring` do Remotion ou easing de saída. Movimento
-linear é a assinatura da máquina: no mundo físico nada começa e para na mesma
-velocidade.
-
-**Profundidade.** Parallax (fundo devagar, frente rápido); `perspective` com
-`rotateX`/`translateZ`, ou three, para 3D de verdade.
-
-**Ritmo.** Informação simples 1,5–2,5 s; frase para ler 3–4 s; fecho 2 s.
-
-**Silêncio visual.** Um quadro com uma frase e mais nada vale mais que um com
-seis elementos. Espaço vazio é composição, não desperdício.
+## O que denuncia IA (nunca)
+
+Gradiente roxo-azul ou sem relação com o assunto; tudo centralizado; uma fonte
+só; texto que só faz `opacidade 0→1`; ícone genérico ao lado de cada frase;
+tempo e transição iguais em todas as cenas; letra cortada ou embaralhada na troca.
+
+## A régua (medida nas referências que o Joel aprovou)
+
+Números, não estilo pronto: o estilo continua seu.
+
+- **Escala:** título de 1 a 3 palavras ocupando 55–85% da largura. Nada abaixo de 2% da altura.
+- **Ritmo:** uma ideia por cena, 1 a 2 s (frase para ler 2–3 s). Com trilha, corte na batida.
+- **Entrada:** máscara (sobe de baixo, recorte reto), palavra por palavra de desfocado
+  para nítido (0,15–0,3 s cada) ou esticando com borrão; `spring` ou ataque rápido e
+  freio forte. **Saída:** a frase sai inteira (desliza, recua, corte seco).
+- **Cor:** fundo chapado, 1 tinta + 1 acento, contraste de 3:1 ou mais; até 5 cores.
+- **Segunda voz:** o apoio é menor (~4% da altura), na segunda fonte, e chega 0,25–0,5 s depois.
+- **À mão:** na palavra que é a tese, um círculo de caneta que se desenha (com ✓ ou seta).
+- **Acento vivo e câmera:** um ponto ou forma acompanha o título e vira o elemento da
+  próxima cena (a transição é o elemento). Zoom lento de 1.0 a 1.08 e parallax dão vida.
+- **Produto:** a interface é código (cartão, toggle, cursor que clica com resultado, número que conta).
+- **Explicar:** uma cena ensina desenhando (curva, gráfico, contorno com âncoras).
+- **Fecho:** a marca sozinha, centralizada, 1,5–2 s. Moldura de ferramenta (cantos,
+  timecode) só em reel de marca ou tecnologia: `moldura:"cantos"`.
 
 ## O caminho: você escreve cada cena
 
-Motion nesse nível não sai de molde: cada cena é UMA ideia desenhada para a
-fala — a interface do produto montando, o número que cresce, o objeto em 3D,
-o gráfico que mostra a ideia, a palavra gigante que se transforma. Quem
-desenha é você, em React.
+Cada cena é UMA ideia desenhada para a fala (a interface montando, o número
+que cresce, o objeto 3D, a palavra gigante). Quem desenha é você, em React.
 
 1. `estudio_projeto` (criar). A marca tem site? `estudio_site` mede cores e fontes.
 2. `estudio_midia acao:"estilos"`: monte a identidade pelo assunto em
@@ -62,23 +54,13 @@ desenha é você, em React.
    arquivo e mande o roteiro de novo.
 6. `estudio_render`. A voz, a trilha, os sons e o fundo são do Estúdio.
 
-**Variedade:** `estudio_midia acao:"efeitos"` antes das cenas; adapte e use
-como `componente`. Uma técnica nova por vídeo. Risco em 2+ linhas: traço por linha.
-
-Parte sem `componente` cai no gerativo (a tipografia anima sozinha): é a
-reserva, não o objetivo. Sem imagem é o padrão (foto só se pedirem).
-
-## Cor e tipo
-
-A paleta sai do ASSUNTO, no `estiloVisual` (um nome do cardápio ou 5 cores
-suas). Se a marca existe, as cores medidas pelo `estudio_site` mandam — não
-as que você imagina que ela usa.
+**Variedade:** `estudio_midia acao:"efeitos"`, adapte e use como `componente`; uma
+técnica nova por vídeo. Parte sem `componente` cai no gerativo (a reserva). Foto só se pedirem.
 
-Duas fontes, no máximo: display para o que grita, neutra para o que se lê.
+## Cor, tipo e conferência
 
-## Antes de renderizar
+A paleta sai do ASSUNTO (`estiloVisual`); a marca existe? As cores medidas pelo
+`estudio_site` mandam. Duas fontes: display para o que grita, neutra para o que se lê.
 
-- Os tempos das cenas batem com os tempos MEDIDOS da narração.
-- Nenhuma cena tem a mesma composição da anterior.
-- Leia o seu próprio plano e pergunte: em que este vídeo é diferente do
-  último que eu fiz? Se não houver resposta, refaça antes de renderizar.
+Antes do render: os tempos batem com a narração MEDIDA, nenhuma cena repete a
+composição da anterior, e este vídeo é diferente do último. Senão, refaça.