primocode 10.7.1 → 10.9.0

package/README.md

@@ -1,4 +1,4 @@
-# PrimoCode v10.7.1
+# PrimoCode v10.9.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.7.1
+ ▐▛███▜▌   Primo Code v10.9.0
 ▝▜█████▛▘  Bem-vindo de volta, Joel
   ▘▘ ▝▝    ~/primocode  · /dir <pasta> muda
 ```

package/bin/primocode.js

@@ -253,16 +253,20 @@ async function comandoApi(rest) {
 
     const apelido = { claude: 'claude-code', gpt: 'chatgpt', openai: 'chatgpt' }[arg.toLowerCase()];
     let id = apelido || ids.find((k) => k === arg.toLowerCase() || P[k].nome.toLowerCase().startsWith(arg.toLowerCase()) && arg);
+    // A lista numerada, a pergunta e a resposta somem depois da escolha: fica só o resultado (lib/entrada.js, marcar).
+    let marca = null;
+    const tirarLista = () => { if (marca && rl && rl.voltarPara) rl.voltarPara(marca); marca = null; };
     if (!id) {
+        if (rl && rl.marcar) marca = rl.marcar();
         console.log('');
         console.log('  ' + c.bold('Com qual IA você quer rodar?') + c.muted('  a sua chave ou a sua assinatura, sem o limite do servidor'));
         if (atual) console.log('  ' + c.muted('agora: ') + c.white(atual.cli ? atual.nome : `${atual.nome} · ${atual.modelo} · chave ${provedorLocal.mascarar(atual.chave)}`));
         ids.forEach((k, i) => console.log(`  ${c.brand(String(i + 1))}  ${c.white(P[k].nome.padEnd(24))}${c.dim(P[k].dica)}`));
         console.log(`  ${c.brand('0')}  ${c.white('Servidor do PrimoCode'.padEnd(24))}${c.dim('sem chave, com o limite do plano')}`);
         const escolha = String(await ask(`  ${c.brand('?')} Número: `)).trim();
-        if (escolha === '0') return comandoApi('off');
+        if (escolha === '0') { tirarLista(); return comandoApi('off'); }
         id = ids[Number(escolha) - 1];
-        if (!id) { console.log(c.muted('  Nada mudou.')); return; }
+        if (!id) { tirarLista(); console.log(c.muted('  Nada mudou.')); return; }
     }
 
     const p = P[id];
@@ -270,22 +274,25 @@ async function comandoApi(rest) {
     // e logada. Quem pensa é ela; quem executa é o PrimoCode.
     if (p.cli) {
         if (!require('../lib/local/motor-cli').instalado(id)) {
+            tirarLista();
             console.log(c.warn(`  O ${p.nome} não está instalado nesta máquina.`) + c.muted(`  Veja ${p.onde}`));
             return;
         }
         const salvo = provedorLocal.salvar({ provedor: id, modelo: p.modelos[0] });
+        tirarLista();
         console.log(c.ok(`  Pronto: ${salvo.nome}`) + c.muted('  · usa a sua assinatura, sem chave'));
         console.log(c.dim(`  O ${p.nome} decide, o PrimoCode executa. /api off volta ao servidor`));
         return;
     }
     console.log(c.muted(`  Pegue a chave em `) + c.white(p.onde));
     const chave = String(await askSecret(`  ${c.brand('?')} Cole a chave do ${p.nome} (não aparece na tela): `)).trim();
-    if (!chave) { console.log(c.muted('  Nada mudou.')); return; }
+    if (!chave) { tirarLista(); console.log(c.muted('  Nada mudou.')); return; }
     const sp = new Spinner('conferindo a chave').start();
     const r = await provedorLocal.conferir(id, chave);
     sp.stop();
-    if (!r.ok) { console.log(c.warn(`  ${r.error}`)); return; }
+    if (!r.ok) { tirarLista(); console.log(c.warn(`  ${r.error}`)); return; }
     const salvo = provedorLocal.salvar({ provedor: id, chave, modelo: r.modelo });
+    tirarLista();
     console.log(c.ok(`  Pronto: ${salvo.nome} · ${salvo.modelo}`) + c.muted(`  · chave ${provedorLocal.mascarar(chave)}`));
     console.log(c.dim('  Agora os pedidos vão direto daqui, com a sua cota. /api modelo <nome> troca o modelo · /api off volta ao servidor'));
 }
@@ -1279,6 +1286,8 @@ async function enviarPedido(userText) {
                 // ferramentas desktop_* no servidor (ver DICA_COMPUTADOR).
                 instrucao: [i === 0 && querComputador(userText) ? vozModo.DICA_COMPUTADOR : '',
                     i === 0 ? require('../lib/estudio/referencias.js').instrucao() : '',
+                    // As imagens do pedido (arrastadas ou coladas): guardadas para o Estúdio importar, e ditas ao agente.
+                    i === 0 ? (() => { const R = require('../lib/estudio/referencias.js'); return R.instrucaoDasImagens(R.guardarImagens(R.imagensNoTexto(userText))); })() : '',
                     i === 0 ? plan.notaOutraPasta || '' : ''].filter(Boolean).join('\n\n'),
             });
 

package/lib/act.js

@@ -686,6 +686,13 @@ const RITMO_AGENTE = '[ritmo]\n'
    entrar já lido (ver lib/pre-leitura.js). */
 function buildMemoryContext(projectDir, projectName, pedido = '', { memoriaDaPasta = true } = {}) {
     const parts = [];
+    /* NO SERVIDOR O CONTEXTO É CURTO (13/10: "continua lendo e listando
+       coisas desnecessárias"). O plano grátis guarda ~1.900 tokens de
+       conversa; 3.400 de contexto fixo empurravam para fora o que o modelo
+       acabou de ler, e ele lia de novo. Com provedor próprio (/api) nada muda. */
+    let proprio = false;
+    try { proprio = !!require('./local/provedor.js').atual(); } catch { /* sem provedor próprio */ }
+    const curto = (t) => (proprio || t.length <= 1500 ? t : '…' + t.slice(-1500));
     // As instruções vêm primeiro: são regra de quem manda no projeto, e a
     // memória é o que o agente anotou. Entram aqui (e não no bin) para valer
     // igual no terminal, no modo voz e em cada passo de um plano.
@@ -697,14 +704,14 @@ function buildMemoryContext(projectDir, projectName, pedido = '', { memoriaDaPas
        bin), ela não vem de novo. */
     if (memoriaDaPasta) {
         const daPasta = require('./agents-md.js').ler(projectDir);
-        if (daPasta) parts.push(`[AGENTS.md — memória desta pasta: de onde a conversa parou]\n${daPasta}`);
+        if (daPasta) parts.push(`[AGENTS.md — memória desta pasta: de onde a conversa parou]\n${curto(daPasta)}`);
     }
     const geral = cfg.readGeneralMemory();
-    if (geral.trim()) parts.push(`[memory-geral.md]\n${geral}`);
+    if (geral.trim()) parts.push(`[memory-geral.md]\n${curto(geral)}`);
     const projeto = cfg.readProjectMemory(projectDir);
-    if (projeto.trim()) parts.push(`[${projectName || 'projeto'}/memory.md]\n${projeto}`);
+    if (projeto.trim()) parts.push(`[${projectName || 'projeto'}/memory.md]\n${curto(projeto)}`);
     const arquivos = arquivosDoProjeto(projectDir);
-    const mapa = mapaDoProjeto(projectDir, 80, arquivos);
+    const mapa = mapaDoProjeto(projectDir, proprio ? 80 : 30, arquivos);
     if (mapa) parts.push(`[${projectName || 'projeto'}/arquivos]\n${mapa}\n\n${preLeitura.JUNTAR_LEITURAS}`);
     const lidos = preLeitura.bloco(preLeitura.escolher(projectDir, arquivos, pedido));
     if (lidos) parts.push(lidos);

package/lib/entrada.js

@@ -37,6 +37,9 @@
 
 'use strict';
 
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
 const readline = require('readline');
 const { EventEmitter } = require('events');
 const { c, visibleWidth, truncate } = require('./ui.js');
@@ -46,7 +49,51 @@ const stripAnsiLocal = (s) => String(s).replace(/\x1b\[[0-9;]*m/g, '');
 // ── O desenho ────────────────────────────────────────────────────────────
 
 /** A etiqueta de colagem em destaque (fininha, na cor da marca), sem mudar a largura. */
-const RE_ETIQUETA = /\[Colado #\d+ · [^\]]+\]/g;
+const RE_ETIQUETA = /\[(?:Colado|Imagem) #\d+[^\]]*\]/g;
+
+/* A IMAGEM ARRASTADA (Joel, 13/10: "#imagem1 #imagem2, igual fica aqui").
+   Arrastar arquivo para o terminal é uma colagem do CAMINHO, e cada terminal
+   escreve de um jeito: o do macOS escapa o espaço e põe um no fim
+   ("Captura\ de\ Tela.png "), o iTerm põe entre aspas, outros mandam
+   file://. Devolve os caminhos quando TODOS são imagens que existem; senão
+   null, e a colagem segue como texto. */
+const RE_IMAGEM = /\.(png|jpe?g|gif|webp|heic|bmp|tiff?|svg)$/i;
+function imagensArrastadas(texto) {
+    const t = String(texto || '').trim();
+    if (!t || t.includes('\n')) return null;
+    const pedacos = [];
+    let cur = '', aspas = null;
+    for (let i = 0; i < t.length; i++) {
+        const ch = t[i];
+        if (aspas) { if (ch === aspas) aspas = null; else cur += ch; continue; }
+        if (ch === "'" || ch === '"') { aspas = ch; continue; }
+        if (ch === '\\' && i + 1 < t.length) { cur += t[++i]; continue; }
+        if (/\s/.test(ch)) { if (cur) pedacos.push(cur); cur = ''; continue; }
+        cur += ch;
+    }
+    if (aspas) return null;
+    if (cur) pedacos.push(cur);
+    const arquivos = pedacos.map((p) => (p.startsWith('file://') ? decodeURI(p.slice(7)) : p.replace(/^~(?=\/)/, os.homedir())));
+    const existe = (f) => { try { return fs.statSync(f).isFile(); } catch { return false; } };
+    if (!arquivos.length || !arquivos.every((f) => path.isAbsolute(f) && RE_IMAGEM.test(f) && existe(f))) return null;
+    return arquivos;
+}
+
+/* O QUE A ETIQUETA GUARDAVA, embaixo do pedido já enviado: o nome da imagem,
+   ou as primeiras linhas do texto colado e quanto falta. Na caixa a etiqueta
+   poupa espaço; depois de mandar, quem rola a conversa quer ver o que foi. */
+function guardadosNaTela(guardados, largura) {
+    const out = [];
+    for (const [et, conteudo] of guardados || []) {
+        if (et.startsWith('[Imagem')) { out.push(`⎿ ${et} ${path.basename(conteudo)}`); continue; }
+        const linhas = String(conteudo).split('\n');
+        const mostra = linhas.slice(0, 3).map((l) => truncate(l, Math.max(10, largura - et.length - 6)));
+        out.push(`⎿ ${et} ${mostra[0]}`);
+        for (const l of mostra.slice(1)) out.push(`  ${' '.repeat(et.length)} ${l}`);
+        if (linhas.length > 3) out.push(`  ${' '.repeat(et.length)} … +${linhas.length - 3} linhas`);
+    }
+    return out;
+}
 function pintarEtiquetas(s) { return String(s).replace(RE_ETIQUETA, (m) => c.brand(m) + '\x1b[38;5;254m'); }
 
 /* As cores do painel, no cubo de 256 cores. O fundo é um degrau acima do
@@ -248,12 +295,14 @@ function montar(e) {
 }
 
 /** O pedido que foi mandado, como fica no histórico da tela: um painel. */
-function pedidoNaTela(texto, colunas) {
+function pedidoNaTela(texto, colunas, guardados = []) {
     const largura = Math.max(24, Math.min(colunas || 80, 200)) - 1;
     const barra = `${COR.barra}┃${COR.reset}`;
     const linhas = quebrar(texto, Math.max(8, largura - PREFIXO))
         .map((l) => painel(barra + '   ' + pintarEtiquetas(c.white(l.texto)), largura));
-    return [painel(barra, largura), ...linhas, painel(barra, largura)].join('\n');
+    const extras = guardadosNaTela(guardados, largura - PREFIXO)
+        .map((l) => painel(barra + '   ' + c.dim(truncate(l, largura - PREFIXO)), largura));
+    return [painel(barra, largura), ...linhas, ...extras, painel(barra, largura)].join('\n');
 }
 
 // ── A caixa viva ─────────────────────────────────────────────────────────
@@ -403,6 +452,21 @@ class Entrada extends EventEmitter {
         if (this.ativo && !this.fechado) this._desenhar();
     }
 
+    /* UMA ESCOLHA QUE SOME depois de respondida (o /api, 13/10: "só apareça
+       pra qual modelo trocou, aquela lista enorme os números somem").
+       marcar() antes de listar, voltarPara(marca) depois: a lista, a pergunta
+       e a resposta saem da conversa, e fica só o que vier depois. Só na tela
+       cheia; no modo linha o terminal já rolou e o texto fica. */
+    marcar() { return this.cheia ? { n: this.conversa.length, ultima: this.conversa[this.conversa.length - 1] } : null; }
+    voltarPara(marca) {
+        if (!marca || !this.cheia || this.conversa.length < marca.n) return;
+        this.conversa.length = marca.n;
+        if (marca.n) this.conversa[marca.n - 1] = marca.ultima;
+        this.rolagem = 0;
+        this._quadroAnterior = null;
+        this._pintar();
+    }
+
     /** Um comando com tela própria desenha aqui (na tela cheia). null fecha. */
     painel(texto) {
         this.painelTexto = texto == null ? null : String(texto).replace(/\n+$/, '');
@@ -566,7 +630,7 @@ class Entrada extends EventEmitter {
         this._mudou();
     }
 
-    limpar() { this.line = ''; this.cursor = 0; this.menu = null; this.colados = new Map(); this._mudou(); }
+    limpar() { this.line = ''; this.cursor = 0; this.menu = null; this.colados = new Map(); this.nImagem = 0; this._mudou(); }
 
     /* COLAR VIRA ETIQUETA, como no Claude Code: texto grande colado (várias
        linhas, ou mais de 300 caracteres) entra na caixa como
@@ -576,10 +640,22 @@ class Entrada extends EventEmitter {
     colar(texto) {
         const t = String(texto || '');
         if (!t) return;
+        if (!this.colados) this.colados = new Map();
+        /* Imagem arrastada: uma etiqueta por arquivo, e no Enter volta o caminho.
+           O contador não reaproveita número: apagar a #1 não faz a próxima repetir a #2. */
+        const imagens = imagensArrastadas(t);
+        if (imagens) {
+            const ets = imagens.map((f) => {
+                this.nImagem = (this.nImagem || 0) + 1;
+                const et = `[Imagem #${this.nImagem}]`;
+                this.colados.set(et, f);
+                return et;
+            });
+            return this.write(ets.join(' ') + (/\s$/.test(t) ? ' ' : ''));
+        }
         const linhas = t.split('\n').length;
         if (linhas < 3 && t.length <= 300) return this.write(t);
-        if (!this.colados) this.colados = new Map();
-        const n = this.colados.size + 1;
+        const n = [...this.colados.keys()].filter((k) => k.startsWith('[Colado')).length + 1;
         const etiqueta = `[Colado #${n} · ${linhas > 1 ? `${linhas} linhas` : `${t.length} caracteres`}]`;
         this.colados.set(etiqueta, t);
         this.write(etiqueta);
@@ -890,7 +966,9 @@ class Entrada extends EventEmitter {
         if (this.menu) return this._escolherDoMenu();
         const visto = this.line;
         const texto = this.expandir(visto);
+        const guardados = [...(this.colados || [])].filter(([et]) => visto.includes(et));
         this.colados = new Map();
+        this.nImagem = 0;
         const oculto = this.oculto;
         this.oculto = false;
         this.line = '';
@@ -921,8 +999,8 @@ class Entrada extends EventEmitter {
                 const temAlgo = this.conversa.some((l) => /\S/.test(l));
                 const ultima = this.conversa[this.conversa.length - 1] || '';
                 const antes = !temAlgo ? '' : /\S/.test(ultima) ? '\n\n' : '\n';
-                tela.acrescentar(this.conversa, antes + pedidoNaTela(visto, mainW - 1) + '\n\n');
-            } else this.escreverCru(pedidoNaTela(visto, process.stdout.columns || 80) + '\n');
+                tela.acrescentar(this.conversa, antes + pedidoNaTela(visto, mainW - 1, guardados) + '\n\n');
+            } else this.escreverCru(pedidoNaTela(visto, process.stdout.columns || 80, guardados) + '\n');
             if (this.historico[this.historico.length - 1] !== texto) this.historico.push(texto);
         }
         this._desenhar();
@@ -932,4 +1010,4 @@ class Entrada extends EventEmitter {
 
 function criar(op) { return new Entrada(op).iniciar(); }
 
-module.exports = { criar, Entrada, montar, quebrar, encher, pintarEtiquetas, painel, pedidoNaTela, PREFIXO, COR };
+module.exports = { criar, Entrada, montar, quebrar, encher, pintarEtiquetas, painel, pedidoNaTela, imagensArrastadas, PREFIXO, COR };

package/lib/estudio/conferencia.js

@@ -0,0 +1,98 @@
+/**
+ * conferencia.js — a conferência do vídeo PRONTO: o arquivo, medido, e não
+ * o plano.
+ *
+ *   "gostei, ficou bom. mas ainda não. tá quase lá" (Joel, 11/10)
+ *
+ * O revisor.js olha o plano antes do render. Este olha o .mp4 que saiu, e
+ * troca o "quase lá" no olho por número que se confere sem abrir o vídeo
+ * (a ideia veio do review.mjs do cth9191/animate, MIT):
+ *
+ *   som      volume integrado (LUFS), variação (LRA) e pico verdadeiro, pelo
+ *            ebur128 do ffmpeg. Alvo: -14 LUFS (±2) e pico até -1 dBTP.
+ *   parado   trecho em que a imagem não muda por 2 s ou mais, pelo
+ *            freezedetect, com o quadro reduzido a 320 px. Calibrado em 13/10
+ *            em 5 vídeos: na resolução cheia o ruído do fundo esconde a tela
+ *            parada; a 160 px o texto fica pequeno demais e a palavra que
+ *            entra não conta como mudança. A 320 px o teste-10-5-motion-com-
+ *            imagem dá 6,5 s a 8,3 s ("torrado" parado, a pílula vazia, e
+ *            para quando "café" entra), e os vídeos 3D não dão nada.
+ *
+ * Só mede e avisa. Não conserta nada: quem decide se refaz é o agente.
+ * As duas leituras (lerSom, lerParados) são puras e testáveis sem vídeo.
+ */
+
+'use strict';
+
+const video = require('./video.js');
+
+const ALVO = { lufs: -14, folgaLufs: 2, picoMax: -1, paradoMin: 2 };
+const r1 = (n) => Math.round(n * 10) / 10;
+
+/* O ebur128 escreve uma linha a cada 100 ms e um resumo no fim. Só o resumo
+   vale: a última linha "I:" de antes dele é a média até ali, não do vídeo. */
+function lerSom(texto) {
+    const t = String(texto || '');
+    const i = t.lastIndexOf('Summary:');
+    if (i < 0) return null;
+    const resumo = t.slice(i);
+    const num = (re) => { const m = resumo.match(re); return m ? Number(m[1]) : null; };
+    const lufs = num(/I:\s*(-?[\d.]+|-inf)\s*LUFS/);
+    if (lufs == null) return null;
+    return { lufs, lra: num(/LRA:\s*(-?[\d.]+)\s*LU\b/), pico: num(/Peak:\s*(-?[\d.]+)\s*dBFS/) };
+}
+
+/* O freezedetect marca o começo e o fim de cada trecho parado. Um começo
+   sem fim é tela parada até o último quadro. Dois trechos colados (o texto
+   some e o fundo fica) são, na tela, uma parada só. */
+function lerParados(texto, duracao) {
+    const trechos = [];
+    const juntar = (de, ate) => {
+        const ultimo = trechos[trechos.length - 1];
+        if (ultimo && de - ultimo.ate < 0.2) ultimo.ate = r1(ate);
+        else trechos.push({ de: r1(de), ate: r1(ate) });
+    };
+    let de = null;
+    for (const linha of String(texto || '').split('\n')) {
+        const i = linha.match(/freeze_start:\s*([\d.]+)/);
+        if (i) { de = Number(i[1]); continue; }
+        const f = linha.match(/freeze_end:\s*([\d.]+)/);
+        if (f && de != null) { juntar(de, Number(f[1])); de = null; }
+    }
+    if (de != null && duracao > de) juntar(de, duracao);
+    return trechos;
+}
+
+/** As medidas viram avisos. Puro. */
+function julgar({ som, parados = [] }, alvo = ALVO) {
+    const avisos = [];
+    if (som && Number.isFinite(som.lufs)) {
+        if (Math.abs(som.lufs - alvo.lufs) > alvo.folgaLufs) {
+            avisos.push(`volume em ${som.lufs} LUFS, longe do alvo de ${alvo.lufs} (${som.lufs < alvo.lufs ? 'baixo demais' : 'alto demais'})`);
+        }
+        if (som.pico != null && som.pico > alvo.picoMax) avisos.push(`pico de ${som.pico} dBTP: estoura no celular (o máximo é ${alvo.picoMax})`);
+    }
+    for (const p of parados) {
+        const dura = r1(p.ate - p.de);
+        if (dura >= alvo.paradoMin) avisos.push(`imagem parada por ${dura} s (de ${p.de} s a ${p.ate} s)`);
+    }
+    return avisos;
+}
+
+/** Mede o arquivo numa passada só do ffmpeg e devolve medidas e avisos. */
+async function conferir(arquivo, { duracao = 0 } = {}) {
+    const c = video.conferir();
+    if (!c.ok) return c;
+    const r = await video.rodar(video.ffmpeg(), [
+        '-hide_banner', '-nostats', '-i', arquivo,
+        '-vf', 'scale=320:-2,freezedetect=n=0.002:d=1.5',
+        '-af', 'ebur128=peak=true',
+        '-f', 'null', '-',
+    ], { timeout: 10 * 60000 });
+    if (!r.ok) return { ok: false, error: `a conferência não leu o vídeo: ${r.erro.slice(-200)}` };
+    const som = lerSom(r.erro);
+    const parados = lerParados(r.erro, duracao);
+    return { ok: true, som, parados, avisos: julgar({ som, parados }) };
+}
+
+module.exports = { ALVO, lerSom, lerParados, julgar, conferir };

package/lib/estudio/estilo.js

@@ -76,7 +76,29 @@ function estiloDaVez(aleatorio = Math.random, semImagem = false) {
     return variedade.sortear(lista, 'estilo', { aleatorio }) || lista[0];
 }
 
+/* O ESTILO DA CASA (13/10, sobre o primocode-ele-constroi.mp4: "esse vídeo tá
+   top! quero os vídeos nesse estilo, todos os vídeos que ele gerar"). Todo
+   vídeo é o GERATIVO — tipografia grande e reta, as cores da marca, Inter e
+   JetBrains Mono. O estilo que o agente ou o roteiro escolhem não vale mais:
+   o rodízio dava um vídeo de cada jeito. Muda só quando a PESSOA pede pelo
+   nome, ou pede a animação 3D com personagens (o personagem). */
+// Nome de estilo inequívoco, ou "estilo X". "Vídeo de lançamento" e "cinema" contam o assunto, não o estilo.
+const PEDE_PELO_NOME = /\b(fluid[oa]|vox|explainer|h[ií]brid[oa]|cl[aá]ssico|brand reveal|estilo (?:de )?(?:marca|impacto|cinema|lan[çc]amento|minimalista|fluido|vox))\b/i;
+const CASA = true;
+
 function escolherEstilo({ pedido = '', agente = null, roteiro = null, girar = false, semImagem = false, aleatorio } = {}) {
+    if (CASA) {
+        // O personagem 3D é outro produto (bonecos conversando), não um jeito do motion: esse o agente e o roteiro ainda pedem.
+        if (PEDE_PERSONAGEM.test(pedido) || normal(agente) === 'personagem' || normal(roteiro) === 'personagem') return 'personagem';
+        const nomeado = (String(pedido).match(PEDE_PELO_NOME) || [])[1];
+        if (nomeado) {
+            const x = nomeado.toLowerCase().replace(/^estilo (?:de )?/, '').replace(/^fluida$/, 'fluido').replace(/^h[ií]brid[oa]$/, 'hibrido')
+                .replace(/^brand reveal$/, 'marca').replace(/^minimalista$/, 'fluido').replace(/^explainer$/, 'vox').replace(/^cl[aá]ssico$/, 'classico').replace(/^lan[çc]amento$/, 'lancamento');
+            const n = normal(x);
+            if (n) return n;
+        }
+        return 'gerativo';
+    }
     const pedidoAgente = normal(agente);
     if (pedidoAgente) return pedidoAgente;
     const doRoteiro = normal(roteiro);
@@ -101,4 +123,4 @@ function escolherEstilo({ pedido = '', agente = null, roteiro = null, girar = fa
 /** Os estilos que usam os efeitos leves e a trilha do ende.app (os de motion, não os de corte). */
 const LEVES = new Set(['gerativo', 'motion', 'vox', 'marca', 'lancamento', 'fluido', 'personagem']);
 
-module.exports = { escolherEstilo, estiloDaVez, ESTILOS, LEVES, PEDE_MOTION, PEDE_FLUIDO, RODIZIO, RODIZIO_SEM_IMAGEM, PEDE_PERSONAGEM };
+module.exports = { escolherEstilo, estiloDaVez, ESTILOS, LEVES, PEDE_MOTION, PEDE_FLUIDO, RODIZIO, RODIZIO_SEM_IMAGEM, PEDE_PERSONAGEM, PEDE_PELO_NOME };

package/lib/estudio/gerativo.js

@@ -238,7 +238,7 @@ function acertosDeHumor(roteiro) {
    lê roteiro.escolhasGerativo, e a marca continua mandando por cima. */
 function escolherVisual(roteiro = {}, { aleatorio = Math.random } = {}) {
     const variedade = require('./variedade.js');
-    const marca = roteiro.marca || {};
+    const marca = require('./marca.js').marcaEmObjeto(roteiro.marca);
     const n = acertosDeHumor(roteiro);
     const max = Math.max(...Object.values(n));
     const humor = variedade.sortear(Object.keys(HUMORES), 'humor-gerativo', { aleatorio, adequacao: (h) => (n[h] + 1) / (max + 1) });
@@ -637,7 +637,11 @@ function camposDe(marca, humor, s, dita = null, fixa = null) {
     if (dita && !ehCor(c.destaque)) { const j = k.indexOf(dita); if (j > 0) k[j] = k[1]; k[1] = dita; }
     // A marca: o fundo dela, o destaque dela e a tinta dela tomam os lugares de mesmo papel.
     const escuro = (x) => luz(x) < 0.35, claro = (x) => luz(x) > 0.7;
-    for (const cor of [c.fundo, c.destaque, c.tinta].filter(ehCor)) {
+    /* Marca de fundo escuro sem tinta declarada: o claro é o branco frio, não
+       o creme do sorteio (o motion do PrimoCode, preto e ciano, ganhava fundo
+       #F1EADB na lista e no fim — 13/10). */
+    const tinta = ehCor(c.tinta) ? c.tinta : (ehCor(c.fundo) && luz(c.fundo) < 0.2 ? '#F5F5F7' : null);
+    for (const cor of [c.fundo, c.destaque, tinta].filter(ehCor)) {
         const lugar = escuro(cor) ? 0 : claro(cor) ? 2 : 1;
         if (!k.includes(cor)) k[lugar] = cor;
     }
@@ -941,7 +945,7 @@ function montarGerativo({ roteiro, largura = 1920, altura = 1080, tempos = [], n
 /** A partitura, sem áudio nem plano — é o que os testes olham. */
 function partituraDe({ roteiro, largura = 1920, altura = 1080, tempos = [], icones = {} }) {
     const partes = roteiro.partes || [];
-    const marca = roteiro.marca || {};
+    const marca = require('./marca.js').marcaEmObjeto(roteiro.marca);
     const W = largura, H = altura, deitado = W >= H;
     const semente = roteiro.semente != null ? hash('semente:' + roteiro.semente)
         : hash(JSON.stringify([partes.map((p) => [p.tipo, p.titulo, p.texto, p.fala, p.valor, p.itens, p.nao, p.sim, p.destaque]), marca.nome || '']));
@@ -959,8 +963,14 @@ function partituraDe({ roteiro, largura = 1920, altura = 1080, tempos = [], icon
        eixos para animar); a genérica da marca vira texto, e o título ganha
        uma face da biblioteca do humor. ─────────────────────────────────── */
     const pedida = (marca.fontes && marca.fontes.titulo) || '';
-    const pedidaTexto = (marca.fontes && marca.fontes.texto) || '';
-    const boa = (f) => f && VARIAVEIS[f] && !BANIDAS.includes(f) && VARIAVEIS[f].eixos.wght;
+    /* O texto da marca; sem ele, a mono da marca (o site do PrimoCode é a
+       Instrument Serif nos títulos e a JetBrains Mono no resto, 13/10). */
+    const monoMarca = (marca.fontes && marca.fontes.mono) || '';
+    const pedidaTexto = (marca.fontes && marca.fontes.texto) || (VARIAVEIS[monoMarca] ? monoMarca : '');
+    /* A da marca vale se a biblioteca carrega (e não é cara de IA), mesmo sem
+       eixo de peso: sem eixo ela só não anima o peso. Exigir o wght trocava a
+       Instrument Serif do site por uma Bodoni sorteada (13/10). */
+    const boa = (f) => f && VARIAVEIS[f] && !BANIDAS.includes(f);
     const ou = (salva, sorteada) => salva || sorteada;
     const display = boa(pedida) ? pedida : ou(E.display, s.um(H0.displays));
     const cinetica = eixoDe(display, 'wdth') && eixoDe(display, 'wdth')[0] <= 75 ? display : s.um(H0.cineticas);
@@ -1129,7 +1139,12 @@ function partituraDe({ roteiro, largura = 1920, altura = 1080, tempos = [], icon
         const mx = Math.max(r, g, bb), mn = Math.min(r, g, bb), d = mx - mn; if (!d) return 0;
         const hh = mx === r ? ((g - bb) / d) % 6 : mx === g ? (bb - r) / d + 2 : (r - g) / d + 4; return (hh * 60 + 360) % 360; };
     const longe = (x) => { const d = Math.abs(matiz(x) - matiz(ident.acento)); return Math.min(d, 360 - d); };
-    const ousada = [campos[3], campos[4]].filter(ehCor).sort((x, y) => longe(y) - longe(x))[0];
+    /* Com marca, a ousada é a de APOIO da marca, ou nenhuma: o amarelo do
+       sistema sorteado entrava de fundo no motion preto e ciano do PrimoCode (13/10). */
+    const mc = marca.cores || {};
+    const daMarca = ehCor(mc.fundo) || ehCor(mc.destaque);
+    const ousada = daMarca ? (ehCor(mc.apoio) && mc.apoio !== ident.acento ? mc.apoio : null)
+        : [campos[3], campos[4]].filter(ehCor).sort((x, y) => longe(y) - longe(x))[0];
     const fortes = [ident.acento, ousada].filter((x, i, a) => ehCor(x) && a.indexOf(x) === i);
     const nCor = batidas.length >= 6 ? Math.max(2, Math.round(batidas.length / 3.5)) : batidas.length >= 4 ? 1 : 0;
     const candCor = batidas.map((b, i) => i).filter((i) => i > 0 && !['marca', 'produto'].includes(batidas[i].comp));
@@ -1453,6 +1468,36 @@ function partituraDe({ roteiro, largura = 1920, altura = 1080, tempos = [], icon
     fundo.ambiente = AMBIENTES.includes(roteiro.ambiente) ? roteiro.ambiente : E.ambiente || 'limpo';
     fundo.acento = ACENTOS_JEITO.includes(roteiro.acento) ? roteiro.acento : E.acento || 'traco';
 
+    /* SEM LETRA TORTA (13/10: "os motions saem muito tortos"). A letra que
+       vira outra antes de assentar (decodifica, flap), a que chega voando e
+       girando (monta), a que entra inclinada (onda) e a palavra que explode em
+       letras rodando deixavam o "SGERE", o "a o" solto e o quadro vazio de
+       letras fantasmas. Os sorteios acontecem igual (a semente não muda o
+       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'];
+    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') {
+            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;
+        }
+        const tortas = (b.linhas || []).filter((l) => TORTOS.includes(l.comportamento));
+        if (tortas.length) {
+            // A janela conta só as batidas com linha principal (tese ou número, fora a marca), como quem assiste vê.
+            const k = comGesto.indexOf(b);
+            const perto = k < 0 ? [] : comGesto.filter((_, j) => j !== k && Math.abs(j - k) <= 3).map((x) => principal(x).comportamento);
+            const limpo = GESTOS_LIMPOS.find((x) => !perto.includes(x)) || 'mascara';
+            for (const l of tortas) l.comportamento = limpo;
+        }
+    });
+
     return {
         versao: 1, semente, fps: FPS, humor,
         musica: { genero: ou(E.genero, s.um(H0.generos)), generos: H0.generos }, largura: W, altura: H, duracao, regras: REGRAS,
@@ -1480,14 +1525,16 @@ function molduraDe(roteiro, E, { W, H, deitado, marca, secoes }) {
     };
 }
 
+/* O eixo de peso da fonte; a estática (a Instrument Serif da marca) é só 400. */
+const pesoDe = (fonte) => (VARIAVEIS[fonte] && VARIAVEIS[fonte].eixos.wght) || [400, 400];
+
 // ── as composições: de conteúdo + contexto, uma batida ─────────────────
 function compor(comp, br, ctx) {
     const { s, W, H, M, deitado, base, larguraUtil, tamRotulo, fontes } = ctx;
     const c = br.conteudo;
     const palavras = ctx.palavras || [];
     const b = { id: 'b' + Math.round(br.de * 1000), parte: br.parte, de: r3(br.de), ate: r3(br.ate), comp, origem: c.tipo === 'falado' ? 'falado' : 'conteudo', linhas: [], acento: [] };
-    const eixosDisplay = VARIAVEIS[fontes.display].eixos;
-    const wMax = eixosDisplay.wght[1];
+    const wMax = pesoDe(fontes.display)[1];
     const wTese = Math.min(wMax, s.um([800, 900, 900, 1000]));
     const destaqueTk = tokens(c.destaque || '');
     const ehTese = (w) => destaqueTk.length && tokens(w).some((k) => destaqueTk.includes(k));
@@ -1516,13 +1563,21 @@ function compor(comp, br, ctx) {
     };
     const vert = (opcoes) => s.um(opcoes);
     const tese = (l) => { l.papel = 'tese'; return l; };
+    /* O ponto do acento ENTRA NO LUGAR do ponto final: com os dois, saía
+       "Uma ideia.." (13/10). */
+    const pontoFinal = (l) => {
+        l.texto = l.texto.replace(/\.$/, '');
+        const u = l.palavras[l.palavras.length - 1];
+        if (u) u.texto = u.texto.replace(/\.$/, '');
+        b.acento.push({ forma: 'ponto', alvo: { linha: l.id, fim: true } });
+    };
 
     switch (comp) {
         case 'gigante': {
             const txt = c.titulo || c.nome || c.sim || c.valor || c.texto || '';
             const maiusc = txt.length <= 16 && s.chance(0.65);
             const fonte = s.chance(0.5) ? fontes.cinetica : fontes.display;
-            const eixos = { wght: Math.min(VARIAVEIS[fonte].eixos.wght[1], wTese) };
+            const eixos = { wght: Math.min(pesoDe(fonte)[1], wTese) };
             const op = { fonte, wght: eixos.wght, maiusc };
             // A frase de 3+ palavras pode ir em 3 linhas no 16:9: cresce na altura em vez de encolher na largura.
             const nMax = deitado ? Math.min(3, Math.max(2, txt.split(/\s+/).length)) : Math.min(4, txt.split(/\s+/).length);
@@ -1543,7 +1598,7 @@ function compor(comp, br, ctx) {
                plano inteiro (12/10, o estilo padrão quebrava). Sem linha, sem acento. */
             if (!ultima) break;
             if (c.riscado) b.acento.push({ forma: 'risco', alvo: { linha: ultima.id } });
-            else if (/[.!]$/.test(txt) || s.chance(0.4)) b.acento.push({ forma: 'ponto', alvo: { linha: ultima.id, fim: true } });
+            else if (/[.!]$/.test(txt) || s.chance(0.4)) pontoFinal(ultima);
             else {
                 const lt = b.linhas.find((l) => l.papel === 'tese' && l.palavras.some((p) => p.papel === 'tese')) || ultima;
                 const pi = Math.max(0, lt.palavras.findIndex((p) => p.papel === 'tese'));
@@ -1608,13 +1663,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') } }); }
-            else b.acento.push({ forma: 'ponto', alvo: { linha: b.linhas[b.linhas.length - 1].id, fim: true } });
+            else pontoFinal(b.linhas[b.linhas.length - 1]);
             break;
         }
         case 'contador': {
             const n = numeroDe(c.valor);
             const fonte = s.chance(0.6) ? fontes.cinetica : fontes.display;
-            const eixos = { wght: Math.min(VARIAVEIS[fonte].eixos.wght[1], wTese) };
+            const eixos = { wght: Math.min(pesoDe(fonte)[1], wTese) };
             const alinha = 'centro';
             const lg = deitado ? W * 0.62 : larguraUtil;
             const tam = tamanhoQueCabe(c.valor, lg * 0.82, (deitado ? 0.36 : 0.17) * H, { fonte, wght: eixos.wght });
@@ -1653,8 +1708,11 @@ function compor(comp, br, ctx) {
         case 'divisao': {
             const lado = deitado ? (larguraUtil - M * 0.6) / 2 : larguraUtil;
             const op = { fonte: fontes.display, wght: wTese };
-            const fN = caberEmLinhas(c.nao, lado, deitado ? 3 : 2, (deitado ? 0.13 : 0.08) * H, { ...op, wght: 400 });
-            const fS = caberEmLinhas(c.sim, lado, deitado ? 3 : 3, (deitado ? 0.17 : 0.1) * H, op);
+            /* Teto mais alto (13/10): com 13% e 17% da altura, "sugere / constrói"
+               ficava miúdo no canto, metade do tamanho do gigante ao lado. A
+               largura da metade é que segura a frase longa. */
+            const fN = caberEmLinhas(c.nao, lado, deitado ? 3 : 2, (deitado ? 0.2 : 0.11) * H, { ...op, wght: 400 });
+            const fS = caberEmLinhas(c.sim, lado, deitado ? 3 : 3, (deitado ? 0.26 : 0.14) * H, op);
             if (deitado) {
                 b.bloco = { x: M, y: H * 0.5, alinha: 'esq', vert: 'meio', largura: lado, gap: 0.1, colunas: [M, M + lado + M * 0.6] };
             } else {
@@ -1688,7 +1746,7 @@ function compor(comp, br, ctx) {
             const lg = deitado ? W * 0.7 : larguraUtil * 0.9;
             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, VARIAVEIS[fonte].eixos.wght[1]) }, comportamento: 'contorno' }).marca = true;
+            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 } });
             b.acento.push({ forma: 'ponto', alvo: { linha: b.linhas[0].id, antes: true } });
             break;
@@ -1699,7 +1757,7 @@ function compor(comp, br, ctx) {
             const maiusc = true;
             const tam = tamanhoQueCabe(txt, larguraUtil, (deitado ? 0.26 : 0.13) * H, { fonte, wght: 900, maiusc });
             b.bloco = { x: W / 2, y: H * 0.5, alinha: 'centro', vert: 'meio', largura: larguraUtil, gap: 0.1 };
-            linha(txt, 'tese', { fonte, tamanho: tam, eixos: { wght: Math.min(900, VARIAVEIS[fonte].eixos.wght[1]) }, maiusc });
+            linha(txt, 'tese', { fonte, tamanho: tam, eixos: { wght: Math.min(900, pesoDe(fonte)[1]) }, maiusc });
             b.textura = { texto: (maiusc ? txt.toUpperCase() : txt), tamanho: tam, fonte, linhas: Math.ceil(H / (tam * 1.02)) + 3, velocidade: Math.round(s.entre(40, 90) * base) };
             // Moldura em volta da palavra é vício de "cara de IA" (a caixa na palavra-chave); sai em 08/10.
             b.acento.push({ forma: s.chance(0.5) ? 'ponto' : 'sublinha', alvo: { linha: b.linhas[0].id } });

package/lib/estudio/index.js

@@ -47,6 +47,8 @@ const assets = require('./assets.js');
 const video = require('./video.js');
 const batida = require('./batida.js');
 const revisor = require('./revisor.js');
+const marcaLib = require('./marca.js');
+const conferencia = require('./conferencia.js');
 const margem = require('./margem.js');
 const assinatura = require('./assinatura.js');
 const identidade = require('./identidade.js');
@@ -509,6 +511,15 @@ async function ferramentaMidia(args) {
 
     /* O ELEMENTO do site, tirado pelo código (print-site.js): a lista das peças
        (logo, botão, cartão, título…) e uma peça sozinha, com o fundo transparente. */
+    /* A REFERÊNCIA VISUAL que a pessoa manda (13/10: "não usa as referências
+       que mandei" — era o print da landing, arrastado no pedido). O agente não
+       enxerga imagem; aqui ela entra no projeto, as cores saem pelo ffmpeg e,
+       se o projeto ainda não tem marca, viram a marca. Com site, o site manda. */
+    if (acao === 'referencia' || acao === 'referência') {
+        if (!p) return semProjeto(args.id);
+        return importarReferencia(p, String(args.arquivo || args.caminho || args.src || ''));
+    }
+
     if (acao === 'elementos') return printSite.elementosDoSite(args.url || args.site || args.termo, { celular: !!args.celular });
     if (acao === 'elemento') {
         if (!p) return { ok: false, error: 'para tirar o elemento é preciso dizer em qual projeto (id).' };
@@ -1247,6 +1258,32 @@ function conferirAssinatura(p, r, nome) {
     projeto.anotar(p.id, 'assinatura', fora.length ? `fora da assinatura ${nome}: ${fora.join('; ')}` : `seguiu a assinatura ${nome}`);
 }
 
+/* A REFERÊNCIA VISUAL que a pessoa manda (13/10: "não usa as referências
+   que mandei" — era o print da landing, arrastado no pedido). O agente não
+   enxerga imagem; aqui ela entra no projeto, as cores saem pelo ffmpeg e, se o
+   projeto ainda não tem marca, viram a marca. Com site, o site manda. */
+function importarReferencia(p, arquivo) {
+    const orig = String(arquivo || '').trim().replace(/^file:\/\//, '');
+    if (!orig || !fs.existsSync(orig)) return { ok: false, error: 'mande em "arquivo" o caminho da imagem de referência.' };
+    const nome = path.basename(orig).normalize('NFD').replace(/[\u0300-\u036f]/g, '').replace(/[^\w.-]+/g, '-');
+    const destino = path.join(p.pasta, 'midia', 'referencias', nome);
+    fs.mkdirSync(path.dirname(destino), { recursive: true });
+    fs.copyFileSync(orig, destino);
+    const rel = path.relative(p.pasta, destino).replace(/\\/g, '/');
+    const cores = marcaLib.coresDaImagem(destino);
+    const temMarca = !!(p.marca && Object.keys(marcaLib.marcaEmObjeto(p.marca).cores || {}).length);
+    const salvar = { referencias: [...(p.referencias || []).filter((x) => x.src !== rel), { src: rel, cores, de: orig }] };
+    if (!temMarca && cores.length) salvar.marca = { ...(p.marca || {}), ...marcaLib.marcaEmObjeto({ cores }) };
+    projeto.salvar(p.id, salvar);
+    projeto.anotar(p.id, 'referencia', `imagem ${rel}: ${cores.join(' ') || 'sem cor'}${temMarca ? '' : ' (virou a marca)'}`);
+    return {
+        ok: true, src: rel, cores, viraMarca: !temMarca && cores.length > 0,
+        comoUsar: (temMarca ? 'O projeto já tem a marca do site: ela manda nas cores; a referência guia o JEITO (composição, peso, o que aparece). '
+            : 'Estas cores viraram a marca do projeto. ')
+            + 'Se a imagem é print do site ou do produto, o vídeo mostra a tela de verdade (estudio_midia acao:"print" e a peça printsite).',
+    };
+}
+
 async function prepararRoteiro(p, args) {
     const roteiro = typeof args.roteiro === 'string' ? JSON.parse(args.roteiro) : args.roteiro;
     if (Array.isArray(roteiro)) return prepararRoteiro(p, { ...args, roteiro: { partes: roteiro } });
@@ -1257,8 +1294,16 @@ async function prepararRoteiro(p, args) {
     for (const pt of roteiro.partes || []) {
         if (pt.src && !existe(pt.src)) { if (!pt.busca && /^https?:/i.test(pt.src)) pt.busca = pt.titulo || ''; delete pt.src; }
     }
+    // As imagens do pedido (o terminal guardou em referencias.imagens) entram sozinhas, uma vez por projeto.
+    const jaTem = new Set((p.referencias || []).map((x) => x.de));
+    const novas = referencias.imagens().filter((f) => !jaTem.has(f));
+    for (const f of novas) { try { importarReferencia(p, f); } catch (e) { projeto.anotar(p.id, 'referencia', `não importou ${path.basename(f)}: ${e.message}`); } }
+    if (novas.length) p = projeto.ler(p.id) || p;
     if (roteiro.marca) {
-        roteiro.marca = { ...(p.marca || {}), ...roteiro.marca };
+        /* A do roteiro por cima da do site, CAMPO A CAMPO: antes o "cores" em
+           lista do agente apagava o {fundo, destaque} lido do site (13/10). */
+        const site = marcaLib.marcaEmObjeto(p.marca), dele = marcaLib.marcaEmObjeto(roteiro.marca);
+        roteiro.marca = { ...site, ...dele, cores: { ...(site.cores || {}), ...(dele.cores || {}) }, fontes: { ...(site.fontes || {}), ...(dele.fontes || {}) } };
         if (roteiro.marca.logo && !existe(roteiro.marca.logo)) roteiro.marca.logo = (p.marca && existe(p.marca.logo)) ? p.marca.logo : undefined;
     } else if (p.marca) roteiro.marca = p.marca;
     const partes = roteiro.partes || [];
@@ -1276,6 +1321,12 @@ async function prepararRoteiro(p, args) {
     const semImagem = referencias.semImagem(ref);
     let estilo = escolherEstilo({ pedido: pedidoTxt, agente: args.estilo, roteiro: roteiro.estilo, girar: true, semImagem });
     if (semImagem && (estilo === 'hibrido' || estilo === 'cinema')) estilo = 'gerativo';
+    /* AS FONTES DA CASA (13/10, o primocode-ele-constroi.mp4 que o Joel aprovou):
+       no gerativo, título em Inter e texto em JetBrains Mono, com as CORES da
+       marca. Só muda se o pedido falar de fonte. */
+    if (estilo === 'gerativo' && !/\bfontes?\b|tipografia|\bserifa/i.test(pedidoTxt)) {
+        roteiro.marca = { ...(roteiro.marca || {}), fontes: { titulo: 'Inter', texto: 'JetBrains Mono' } };
+    }
     /* "O vídeo deve ter um 3D do fone" (30/09): pedido de 3D vira o gerativo
        com o produto modelado girando numa batida (kit/tres.jsx) — a menos que
        o agente tenha escolhido outro estilo pelo nome. */
@@ -1847,6 +1898,9 @@ async function prepararRoteiro(p, args) {
                 } catch { /* fica sem */ }
                 continue;
             }
+            // O ícone do próprio site (estudio_site guardou os <svg> na marca).
+            const doSite = h.match(/^site:(\d+)$/i);
+            if (doSite) { const x = ((roteiro.marca || {}).iconesSite || [])[Number(doSite[1]) - 1]; if (x && x.svg) icones[h] = x.svg; continue; }
             if (!/^[a-z0-9-]+:[a-z0-9-]+$/i.test(h) || icones[h]) continue;
             try { const ic = await assets.icone(h, { pasta: p.pasta }); if (ic && ic.ok) icones[h] = ic.svg; else projeto.anotar(p.id, 'icones', `herói ${h} não baixou: ${(ic && ic.error) || '?'}`); } catch { /* fica sem */ }
         }
@@ -2106,6 +2160,12 @@ async function ferramentaRender(args, ctx = {}) {
     projeto.salvar(args.id, { renders: [...(p.renders || []), { quando: new Date().toISOString(), arquivo: saida, bytes }] });
     projeto.anotar(args.id, 'render', `${(bytes / 1048576).toFixed(1)} MB, ${conferida.duracao}s`);
 
+    /* A CONFERÊNCIA (conferencia.js): o arquivo que saiu, medido. Som fora do
+       alvo e imagem parada viram aviso; quem decide se refaz é o agente. */
+    const conf = fs.existsSync(saida) ? await conferencia.conferir(saida, { duracao: conferida.duracao }) : { ok: false };
+    const avisosDoArquivo = conf.ok ? conf.avisos : [];
+    if (avisosDoArquivo.length) projeto.anotar(args.id, 'conferencia', avisosDoArquivo.join('; '));
+
     // O vídeo pronto abre. É a única coisa que abre — a interface morreu, e
     // o que a pessoa pediu foi o vídeo.
     if (ctx.abrir) { try { ctx.abrir(saida); } catch { /* o caminho está na resposta */ } }
@@ -2114,8 +2174,9 @@ async function ferramentaRender(args, ctx = {}) {
         ok: true, arquivo: saida, bytes, segundos: conferida.duracao,
         faltaram: faltaram.length ? faltaram : undefined,
         revisao: revisao.consertos.length || revisao.avisos.length ? { consertado: revisao.consertos, avisos: revisao.avisos } : undefined,
+        conferencia: conf.ok ? { som: conf.som, parados: conf.parados, avisos: conf.avisos } : undefined,
         aviso: 'ABERTO para o usuário assistir. Chame finish dizendo o que foi feito'
-            + (revisao.avisos.length ? ' — e cite os avisos da revisão que valem um novo plano.' : '.'),
+            + (revisao.avisos.length || avisosDoArquivo.length ? ' — e cite os avisos da revisão e da conferência que valem um novo plano.' : '.'),
     };
 }
 
@@ -2227,6 +2288,9 @@ async function ferramentaSite(args) {
                         }
                     }
                 } catch { /* sem gradiente */ }
+                /* Os ícones do próprio site (os <svg> dos cartões): viram "site:N" no roteiro. */
+                const icSite = marcaLib.iconesDoSite(html);
+                if (icSite.length) { marca.iconesSite = icSite; r.icones = icSite.map((x, i) => `site:${i + 1}${x.nome ? ' (' + x.nome + ')' : ''}`); }
                 projeto.salvar(args.id, { acervo: { fotos: a.fotos, videos: a.videos, fatos: a.fatos, site: r.url }, marca });
                 projeto.anotar(args.id, 'midia', `acervo do site: ${a.fotos.length} fotos, ${a.videos.length} vídeos, ${a.paginas.length} páginas lidas`);
                 let orcamento = 4200;
@@ -2240,7 +2304,8 @@ async function ferramentaSite(args) {
                 r.comoUsar = 'Escreva o roteiro com os FATOS acima (datas, local, números, frases da marca) — nada '
                     + 'inventado. As fotos e os vídeos reais da marca entram SOZINHOS no vídeo: não precisa pôr '
                     + '"busca" nas partes de imagem (use tipo "imagem" com só o título). Use as cores, a fonte e '
-                    + 'a logo em roteiro.marca.';
+                    + 'a logo em roteiro.marca (objeto: {cores: {fundo, destaque, tinta}, fontes: {titulo, texto}}).'
+                    + (r.icones ? ' Os ícones do site estão em "icones": ponha icone:"site:N" na parte em que o assunto dele aparece.' : '');
             } catch (e) {
                 r.acervo = { erro: e.message };
             }

package/lib/estudio/kit/fluido.jsx

@@ -281,6 +281,11 @@ function leiaute(P) {
            ela ficava VAZIA até a voz chegar na frase (teste de 08/10). */
         const p0 = pr ? pr.palavras[0].em : b.de;
         const entT = [Math.max(ent[0], p0 - 0.4), Math.max(ent[1], p0 + 0.1)];
+        /* Mas a pílula de ANTES ficava: o texto dela saía e a forma esperava
+           vazia até a voz (0,6 s no café de 11/10, de 7,2 s a 7,9 s). Quando
+           a voz demora, a forma encolhe num ponto e cresce já com a frase. */
+        // Começa em b.de, quando o texto de antes já saiu (antes disso a forma laranja ficava atrás dele).
+        if (entT[0] >= b.de + 0.4) vai(b.de, b.de + 0.4, forma(tx, ty, 16 * u, 16 * u, { solid: 1, ac: 1 }));
         if (umaLinha) vai(entT[0], entT[1], forma(tx, ty, (t ? t.w : 200 * u) + 110 * u, h, { fill: 1, stroke: 0.35 }));
         else vai(entT[0], entT[1], forma(t.left - 40 * u, ty, 6 * u, t.h * 0.92, { solid: 1, ac: 1, r: 3 }));
       }

package/lib/estudio/kit/gerativo.jsx

@@ -430,8 +430,8 @@ function letra({ t, fps, l, p, j, ch, i, idx, n, b, cx, cores, eixosF, alvoSaida
   const centroLinha = cx ? cx.x + cx.w / 2 : 0;
   switch (c) {
     case 'carimbo': {
-      const r0 = (acaso(semente) - 0.5) * 8;
-      tr.push('rotate(' + (r0 * (1 - m)).toFixed(2) + 'deg)', 'scale(' + (1 + 0.32 * (1 - m)).toFixed(4) + ')');
+      // Sem inclinação: a letra carimbada torta lia como defeito (13/10). Fica o impacto da escala.
+      tr.push('scale(' + (1 + 0.32 * (1 - m)).toFixed(4) + ')');
       const f = tl * fps;
       blur = f < 2 ? 1.4 : Math.max(0, 0.7 * (1 - (f - 2) / 7));
       break;
@@ -917,7 +917,11 @@ export function Gerativo({ el, t, fps }) {
      leve a cada meio segundo, como um bumbo. */
   // A respiração lenta do mundo (sem bumbo: o pulso batendo lia como tranco).
   sz += 0.008 * Math.sin((t * Math.PI * 2) / 3.4);
-  const cam = { x: cam0.x + sx, y: cam0.y + sy, zoom: cam0.zoom * (1 + sz), rot: cam0.rot + sr };
+  /* A câmera NÃO GIRA (13/10, "os motions saem muito tortos"): o giro das
+     chaves (cam0.rot) e o da deriva (sr) inclinavam o mundo inteiro, e todo
+     texto saía com a linha de base caída. Ficam a deriva, o zoom e o tranco. */
+  void sr;
+  const cam = { x: cam0.x + sx, y: cam0.y + sy, zoom: cam0.zoom * (1 + sz), rot: 0 };
   const ac0 = acentoEm(t, estados);
   // O acento também vive: treme de leve e respira na espessura.
   const ac = { ...ac0, pts: ac0.pts.map((q, i) => [q[0] + Math.sin(t * 3.1 + i * 0.5) * 1.6 * base, q[1] + Math.cos(t * 2.7 + i * 0.37) * 1.6 * base]), larg: ac0.larg * (1 + 0.08 * Math.sin(t * 4.2)) };
@@ -929,7 +933,8 @@ export function Gerativo({ el, t, fps }) {
   const origem = tela(ac.cx, ac.cy);
   /* O ESPAÇO 3D: o mundo tem perspectiva, a câmera também inclina (rotateX/Y)
      e as camadas estão em profundidades diferentes — o texto não é adesivo. */
-  const rx = Math.cos(t * 0.27) * 1.4, ry = Math.sin(t * 0.31) * 2 + cam.rot * 0.6;
+  // A perspectiva fica, mas quase parada: 1,4° e 2° deixavam a frase em trapézio.
+  const rx = Math.cos(t * 0.27) * 0.35, ry = Math.sin(t * 0.31) * 0.5;
   const mundo = 'translate(' + W / 2 + 'px,' + H / 2 + 'px) rotate(' + cam.rot.toFixed(3) + 'deg) rotateX(' + rx.toFixed(3) + 'deg) rotateY(' + ry.toFixed(3) + 'deg) scale(' + cam.zoom.toFixed(4) + ') translate(' + (-W / 2 - cam.x).toFixed(1) + 'px,' + (-H / 2 - cam.y).toFixed(1) + 'px)';
   // No ar: a batida atual, a anterior enquanto sai.
   const noAr = bs.filter((x, i) => i === bi || (i === bi - 1 && t < x.ate + 0.14 && x.saida !== 'corte'));

package/lib/estudio/kit/mundo.jsx

@@ -831,6 +831,15 @@ const ESP = {
   macaco: { forma: 4, corpo: [0.36, 0.42, 0.42], perna: 0.36, cab: 0.36, foc: [0.22, 0.14, 0.08], orelha: 'redonda', rabo: 'longo', cor: '#7a5232', cor2: '#e6c9a0', focCor: '#e6c9a0' },
 };
 
+/** Onde a cabeça do quatro-patas fica no chão, a partir do centro do bicho:
+ *  o corpo vira 0,55 de lado e a cabeça vai na frente dele (o Quadrupede).
+ *  A câmera mirava o meio do corpo e o rosto saía cortado na borda (13/10). */
+export function frenteDoBicho(especie) {
+  const e = ESP[especie] || ESP.cachorro;
+  if (e.forma === 'ave' || e.forma === 'pinguim' || e.forma === 'peixe' || e.forma === 'dino') return { giro: 0, dist: 0 };
+  return { giro: 0.55, dist: e.corpo[2] / 2 + e.cab * 0.25 + (e.pescoco || 0) * 0.25 };
+}
+
 /** A altura da cabeça (para a câmera mirar no rosto do bicho). */
 export function alturaDoBicho(especie) {
   const e = ESP[especie] || ESP.cachorro;

package/lib/estudio/kit/voxel.jsx

@@ -30,7 +30,7 @@ import { UnrealBloomPass } from 'three/examples/jsm/postprocessing/UnrealBloomPa
 import { BokehPass } from 'three/examples/jsm/postprocessing/BokehPass.js';
 import { OutputPass } from 'three/examples/jsm/postprocessing/OutputPass.js';
 import { RoomEnvironment } from 'three/examples/jsm/environments/RoomEnvironment.js';
-import { Mundo, Animal, Coisa, alturaDoBicho, useIcones } from './mundo.jsx';
+import { Mundo, Animal, Coisa, alturaDoBicho, frenteDoBicho, useIcones } from './mundo.jsx';
 
 const clamp = (x, a = 0, b = 1) => Math.max(a, Math.min(b, x));
 const lerp = (a, b, k) => a + (b - a) * k;
@@ -267,7 +267,8 @@ function RostoPixel({ p, est }) {
    "olha como quero o 3D": o rosto da referência é LOW-POLY — uma esfera de
    poucas faces com sombreado chapado, nariz de pirâmide, sobrancelha grossa,
    o cabelo cacheado feito de dezenas de pedrinhas facetadas. O corpo segue
-   de blocos. `cabeca: 'cubo'` volta ao rosto de pixel da 10.5. */
+   de blocos. Desde 13/10 só sai com `cabeca: 'facetada'`: o padrão voltou a
+   ser o cubo com rosto de pixel da 10.5 (partitura sem o campo também). */
 const GEO_FACETA = new Map();
 function faceta(det) {
   if (!GEO_FACETA.has(det)) GEO_FACETA.set(det, new THREE.IcosahedronGeometry(1, det));
@@ -432,7 +433,7 @@ function PessoaBloco({ p, est }) {
       <BracoBloco lado={-1} g={est.gesto[0]} cor={p.roupa} pele={p.pele} t={est.t} acao={a} k={ka} />
       <BracoBloco lado={1} g={est.gesto[1]} cor={p.roupa} pele={p.pele} t={est.t} acao={a} k={ka} />
       <group position={[0, 1.8 + resp, 0]} rotation={[cp, cy, cr]}>
-        {p.cabeca === 'cubo' ? (
+        {p.cabeca !== 'facetada' ? (
           <>
             <Bloco s={[CAB, CAB, CAB]} c={p.pele} r={0.04} rough={0.6} />
             <RostoPixel p={p} est={est} />
@@ -623,13 +624,34 @@ function lugarDoFigurante(el, fig, j, vert = false) {
   return [lado * (borda + Math.floor(j / 2) * 0.9), 0, baixo ? 0.45 : -0.5];
 }
 
+/* A CÂMERA NÃO ATRAVESSA NINGUÉM (13/10): no close de quem fala, outro do
+   elenco ficava entre a lente e o rosto, ou com a lente dentro dele (o close
+   do cachorro com o braço do outro cortando o quadro). `bate` diz se alguém
+   do elenco, um cilindro do chão até acima da cabeça, corta o caminho. */
+function bate(el, quem, pos, alvo) {
+  const dx = alvo[0] - pos[0], dz = alvo[2] - pos[2], L2 = dx * dx + dz * dz || 1;
+  for (let j = 0; j < el.length; j++) {
+    if (j === quem) continue;
+    const [x, , z] = lugarDe(el, j);
+    const u = clamp(((x - pos[0]) * dx + (z - pos[2]) * dz) / L2);
+    const py = pos[1] + (alvo[1] - pos[1]) * u;
+    if (Math.hypot(pos[0] + dx * u - x, pos[2] + dz * u - z) < 0.55 && py < alturaDaCabeca(el[j]) + 0.3) return true;
+  }
+  return false;
+}
+
 function cameraDe(pl, t, part, aspecto) {
   const vert = aspecto < 1;
   const el = part.elenco;
   const dois = el.length > 1;
   const quem = el[pl.alvo] ? pl.alvo : 0;
-  const cabeca = (i) => { const p = lugarDe(el, i); return [p[0], alturaDaCabeca(el[i]), p[2]]; };
-  const frente = (i) => [Math.sin(giroDe(el, i)), 0, Math.cos(giroDe(el, i))];
+  // O bicho de quatro patas tem a cabeça NA FRENTE do corpo, e o rosto virado para onde o corpo vira.
+  const doBicho = (i) => (el[i] && el[i].tipo === 'animal' ? frenteDoBicho(el[i].especie) : { giro: 0, dist: 0 });
+  const cabeca = (i) => {
+    const p = lugarDe(el, i), b = doBicho(i), g = giroDe(el, i) + b.giro;
+    return [p[0] + Math.sin(g) * b.dist, alturaDaCabeca(el[i]), p[2] + Math.cos(g) * b.dist];
+  };
+  const frente = (i) => { const g = giroDe(el, i) + doBicho(i).giro * 0.7; return [Math.sin(g), 0, Math.cos(g)]; };
   const k = clamp((t - pl.de) / Math.max(0.5, pl.ate - pl.de));
   const fovK = vert ? 1.45 : 1;
   let pos, alvo, fov;
@@ -658,11 +680,16 @@ function cameraDe(pl, t, part, aspecto) {
     const dist = (pl.tipo === 'detalhe' ? 1.25 : pl.tipo === 'close' ? 1.7 : 2.7) * (vert ? 1.25 : 1);
     fov = (pl.tipo === 'detalhe' ? 30 : pl.tipo === 'close' ? 32 : 34) * fovK;
     const h = cabeca(quem), f = frente(quem);
-    const lado = pl.lado * 0.42;
-    const dir = [f[0] * Math.cos(lado) - f[2] * Math.sin(lado), 0, f[0] * Math.sin(lado) + f[2] * Math.cos(lado)];
     const baixo = pl.tipo === 'medio' ? 0.05 : -0.32;
-    pos = [h[0] + dir[0] * dist, h[1] + baixo, h[2] + dir[2] * dist];
     alvo = [h[0], h[1] + (pl.tipo === 'medio' ? -0.35 : -0.02), h[2]];
+    const de = (ld) => {
+      const lado = ld * 0.42;
+      const dir = [f[0] * Math.cos(lado) - f[2] * Math.sin(lado), 0, f[0] * Math.sin(lado) + f[2] * Math.cos(lado)];
+      return [h[0] + dir[0] * dist, h[1] + baixo, h[2] + dir[2] * dist];
+    };
+    // O lado pedido; se alguém corta, o outro lado, de frente, mais aberto; senão, a câmera sobe por cima.
+    pos = [pl.lado, -pl.lado, 0, 1.6, -1.6].map(de).find((q) => !bate(el, quem, q, alvo));
+    if (!pos) { const q = de(pl.lado); pos = [q[0], q[1] + 0.9, q[2]]; }
   }
   // No vertical a legenda está no alto: a câmera mira acima, e o rosto desce no quadro.
   if (vert) alvo = [alvo[0], alvo[1] + (pl.tipo === 'aberto' || pl.tipo === 'largo' ? 0.45 : pl.tipo === 'medio' ? 0.3 : pl.tipo === 'ombro' ? 0.22 : 0.17), alvo[2]];

package/lib/estudio/marca.js

@@ -280,4 +280,109 @@ async function marcaDaEmpresa(args, { projectDir, studio }) {
     };
 }
 
-module.exports = { marcaDaEmpresa, candidatasALogo, coresDe, fontesDe, metas, atributo };
+/* A MARCA EM LISTA VIRA OBJETO (13/10). O agente escreve a marca do jeito
+   que leu: "cores": ["#22d3ee", "#0a0b0b", …], "fontes": ["Instrument
+   Serif", "JetBrains Mono"]. O Estúdio lê {fundo, destaque, tinta} e
+   {titulo, texto, mono}. Sem a conversão, `cores.fundo` não existia, o
+   gerativo achava que não havia marca e sorteava o humor: o motion do
+   PrimoCode saiu vermelho e creme em Bodoni, com o site preto e ciano.
+     cores   a primeira escura é o fundo, a primeira viva o destaque (a
+             segunda, o apoio), a primeira clara a tinta;
+     fontes  a mono vai para mono; das outras, a 1ª é título e a 2ª texto.
+   O que já é objeto passa intacto. */
+function marcaEmObjeto(m) {
+    if (!m || typeof m !== 'object') return {};
+    const out = { ...m };
+    if (Array.isArray(m.cores)) {
+        const rgb = (h) => { const n = parseInt(h.slice(1), 16); return [n >> 16, (n >> 8) & 255, n & 255].map((v) => v / 255); };
+        const luz = (h) => { const [r, g, b] = rgb(h); return 0.2126 * r + 0.7152 * g + 0.0722 * b; };
+        const sat = (h) => { const v = rgb(h); return Math.max(...v) - Math.min(...v); };
+        const cs = m.cores.map((x) => String((x && x.cor) || x || '').trim()).filter((x) => /^#[0-9a-f]{6}$/i.test(x));
+        const vivas = cs.filter((x) => sat(x) > 0.25);
+        const fundo = cs.find((x) => luz(x) < 0.12 && sat(x) <= 0.25);
+        const tinta = cs.find((x) => luz(x) > 0.8 && sat(x) <= 0.25);
+        out.cores = { ...(fundo ? { fundo } : {}), ...(vivas[0] ? { destaque: vivas[0] } : {}), ...(vivas[1] ? { apoio: vivas[1] } : {}), ...(tinta ? { tinta } : {}) };
+    }
+    if (Array.isArray(m.fontes)) {
+        const fs = m.fontes.map((f) => String((f && f.nome) || f || '').trim()).filter(Boolean);
+        const mono = fs.find((f) => /mono|code|consol/i.test(f));
+        const resto = fs.filter((f) => f !== mono);
+        out.fontes = { ...(resto[0] ? { titulo: resto[0] } : {}), ...(resto[1] ? { texto: resto[1] } : {}), ...(mono ? { mono } : {}) };
+    }
+    return out;
+}
+
+/* OS ÍCONES DO SITE (13/10: "não usa os ícones do site"). Os ícones de uma
+   landing quase sempre são <svg> inline (o desenho de traço ao lado de cada
+   cartão), e não arquivos. Aqui saem os pequenos — com viewBox, sem imagem
+   nem script dentro, até 4 KB — com um nome: o aria-label, o <title>, ou o
+   título (h2/h3/h4) logo depois dele no HTML. No roteiro viram "site:N". */
+function iconesDoSite(html, max = 12) {
+    const out = [], vistos = new Set();
+    const re = /<svg\b[^>]*>[\s\S]*?<\/svg>/gi;
+    let m;
+    while ((m = re.exec(String(html || ''))) && out.length < max) {
+        const svg = m[0];
+        if (svg.length > 4000 || /<(image|script|foreignObject)\b/i.test(svg) || !/viewBox=/i.test(svg)) continue;
+        const abre = svg.slice(0, svg.indexOf('>') + 1);
+        const lado = Number((abre.match(/\b(?:width|height)=["']?(\d+)/i) || [])[1] || 0);
+        if (lado > 120) continue;
+        const corpo = svg.replace(/\s+/g, ' ');
+        if (vistos.has(corpo)) continue;
+        vistos.add(corpo);
+        const depois = String(html).slice(re.lastIndex, re.lastIndex + 500);
+        const nome = (abre.match(/aria-label=["']([^"']+)/i) || [])[1]
+            || (svg.match(/<title>([^<]+)<\/title>/i) || [])[1]
+            || ((depois.match(/<h[2-4][^>]*>([\s\S]*?)<\/h[2-4]>/i) || [])[1] || '').replace(/<[^>]+>/g, '').trim()
+            || '';
+        out.push({ nome: nome.slice(0, 40), svg });
+    }
+    return out;
+}
+
+/* AS CORES DE UMA IMAGEM (a referência que a pessoa manda: o print do site,
+   um frame, um anúncio de que gostou). O ffmpeg reduz a imagem a 160 px e
+   devolve os pixels; as cores parecidas viram uma, e saem as 6 que mais
+   aparecem, da mais comum à menos. Sem ffmpeg, lista vazia. */
+function coresDaImagem(arquivo, max = 6) {
+    const { spawnSync } = require('child_process');
+    const r = spawnSync('ffmpeg', ['-v', 'error', '-i', arquivo, '-vf', 'scale=160:-1', '-frames:v', '1', '-f', 'rawvideo', '-pix_fmt', 'rgb24', '-'], { maxBuffer: 1 << 22 });
+    if (r.status !== 0 || !r.stdout || !r.stdout.length) return [];
+    const conta = new Map();
+    for (let i = 0; i + 2 < r.stdout.length; i += 3) {
+        const k = ((r.stdout[i] >> 3) << 10) | ((r.stdout[i + 1] >> 3) << 5) | (r.stdout[i + 2] >> 3);
+        conta.set(k, (conta.get(k) || 0) + 1);
+    }
+    const hex = (k) => '#' + [(k >> 10) & 31, (k >> 5) & 31, k & 31].map((v) => (v * 8 + 4).toString(16).padStart(2, '0')).join('');
+    const rgb = (h) => [1, 3, 5].map((i) => parseInt(h.slice(i, i + 2), 16));
+    const longe = (a, b) => { const x = rgb(a), y = rgb(b); return Math.hypot(x[0] - y[0], x[1] - y[1], x[2] - y[2]); };
+    // As 4 mais comuns, e as 2 mais VIVAS que aparecem de verdade: a cor da
+    // marca costuma ocupar pouca área (o ciano de um título, o botão), e sem
+    // isto o print dava só fundo e cinza.
+    const total = r.stdout.length / 3;
+    const sat = (h) => { const v = rgb(h); return (Math.max(...v) - Math.min(...v)) / 255; };
+    const lista = [...conta].sort((a, b) => b[1] - a[1]).map(([k, n]) => ({ h: hex(k), n }));
+    const out = [];
+    const por = (x) => { if (out.length < max && out.every((o) => longe(o, x.h) > 48)) out.push(x.h); };
+    for (const x of lista) { if (out.length >= Math.max(1, max - 2)) break; por(x); }
+    /* As vivas se espalham em dezenas de tons de 1 ou 2 pixels (a borda da
+       letra mistura com o fundo): contam por MATIZ, em faixas de 30°, e de
+       cada faixa vale o pixel mais vivo — o miolo da letra, não a borda. */
+    const faixas = new Map();
+    for (let i = 0; i + 2 < r.stdout.length; i += 3) {
+        const v = [r.stdout[i], r.stdout[i + 1], r.stdout[i + 2]], mx = Math.max(...v), mn = Math.min(...v), d = mx - mn;
+        if (d / 255 < 0.35 || mx < 60) continue;
+        const hh = mx === v[0] ? ((v[1] - v[2]) / d) % 6 : mx === v[1] ? (v[2] - v[0]) / d + 2 : (v[0] - v[1]) / d + 4;
+        const f = Math.floor(((hh * 60 + 360) % 360) / 30);
+        const x = faixas.get(f) || { n: 0, melhor: null, nota: -1 };
+        x.n++;
+        const nota = d * mx;
+        if (nota > x.nota) { x.nota = nota; x.melhor = '#' + v.map((c) => c.toString(16).padStart(2, '0')).join(''); }
+        faixas.set(f, x);
+    }
+    [...faixas.values()].filter((x) => x.n >= Math.max(8, total * 0.0005)).sort((a, b) => b.n - a.n).slice(0, 2).forEach((x) => por({ h: x.melhor }));
+    void sat; void lista;
+    return out;
+}
+
+module.exports = { marcaDaEmpresa, candidatasALogo, coresDe, fontesDe, metas, atributo, marcaEmObjeto, iconesDoSite, coresDaImagem };

package/lib/estudio/personagem.js

@@ -154,8 +154,10 @@ function aparencia(nome, pedido = {}) {
         barba: !!pedido.barba && pedido.genero !== 'f',   // só quando pedida: sorteada, ficava estranha em quem tem cabelo longo
         bigode: !!pedido.bigode && pedido.genero !== 'f',
         ...(pedido.genero ? { genero: pedido.genero } : {}),
-        // A cabeça facetada (low-poly) é o padrão; 'cubo' é o rosto de pixel da 10.5.
-        ...(pedido.cabeca === 'cubo' ? { cabeca: 'cubo' } : {}),
+        /* O cubo com rosto de pixel (o da 10.5) é o padrão de novo: o low-poly
+           da 10.6 ficou "feito com polígonos, bugado e horrível" (Joel, 13/10).
+           A facetada só sai pedida. */
+        cabeca: pedido.cabeca === 'facetada' ? 'facetada' : 'cubo',
     };
 }
 

package/lib/estudio/referencias.js

@@ -80,8 +80,12 @@ function notasDaAssinatura() {
 function instrucao(atual = ATUAL) { const i = instrucaoDoModo(atual); return i ? i + notasDaAssinatura() : ''; }
 function instrucaoDoModo({ modo, escopo, explicito } = ATUAL) {
     // O vídeo sem imagem é motion: o agente escolhe o estilo de motion que serve ao roteiro, não um fixo.
-    const motion = 'O vídeo é MOTION: tipografia, formas, ícones, animação e som. Escolha em roteiro.estilo o motion que serve a este '
-        + 'roteiro (gerativo, fluido, impacto, vox, marca, lancamento) ou deixe vazio para o rodízio — não repita sempre o mesmo.';
+    const motion = 'O vídeo é MOTION: tipografia, formas, ícones, animação e som, no ESTILO DA CASA (o gerativo, com as cores da '
+        + 'marca): não ponha roteiro.estilo, a menos que a pessoa tenha pedido outro estilo pelo nome. '
+        /* O ROTEIRO (13/10: "o roteiro que monta é horrível" — eram os títulos da landing em fila). */
+        + 'O ROTEIRO é uma história de 15 a 25 s: gancho (a situação de quem assiste) → o que o produto FAZ → UMA prova concreta '
+        + 'dos fatos do site → a ação (nome, comando, link). Nunca os títulos das seções do site em sequência. Cada fala tem de 5 a '
+        + '12 palavras e puxa a próxima; o titulo da parte é a palavra-chave (1 a 4 palavras), não a fala repetida.';
     if (modo === 'sem' && explicito) {
         return '[REFERÊNCIAS: NENHUMA] A pessoa quer SÓ MOTION: não pesquise (nada de pesquisar_referencia nem estudio_site), '
             + 'não busque foto nem vídeo, não use estudio_midia de banco. Escreva o roteiro com o que o pedido já diz. ' + motion;
@@ -124,4 +128,42 @@ function filtrar(r, { modo, escopo } = ATUAL) {
     return { ...r, fontes: refs.length, referencias: refs, ...(fora ? { foraDoEscopo: fora } : {}) };
 }
 
-module.exports = { definir, atual, limpar, semImagem, termos, entender, inferir, instrucao, dominios, filtrar };
+/* AS IMAGENS DO PEDIDO (13/10: "não usa as referências que mandei" — era o
+   print da landing, arrastado no pedido). O modelo do servidor não enxerga
+   imagem e nem pode chamar a importação (a lista de ações dele é fechada),
+   então o terminal guarda aqui os caminhos de imagem que EXISTEM no texto do
+   pedido, e o Estúdio importa sozinho no próximo roteiro (index.js). */
+let IMAGENS = [];
+const RE_EXT_IMG = /\.(png|jpe?g|gif|webp|heic|bmp)\b/gi;
+function imagensNoTexto(texto) {
+    const fs = require('fs'), os = require('os');
+    const t = String(texto || '');
+    const achadas = [];
+    let m;
+    while ((m = RE_EXT_IMG.exec(t))) {
+        const fim = m.index + m[0].length;
+        // Do fim da extensão para trás: o começo é uma "/" (ou "~/", "file://") no início ou depois de espaço/aspas.
+        let melhor = null;
+        for (let i = m.index; i >= 0; i--) {
+            if (t[i] !== '/' && !(t[i] === '~' && t[i + 1] === '/')) continue;
+            const antes = i === 0 ? ' ' : t[i - 1];
+            if (!/[\s'"(:]/.test(antes) && !(t.slice(Math.max(0, i - 7), i) === 'file://')) continue;
+            const bruto = t.slice(i, fim).replace(/\\(.)/g, '$1').replace(/^~(?=\/)/, os.homedir());
+            try { if (fs.statSync(bruto).isFile()) melhor = bruto; } catch { /* não é este começo */ }
+        }
+        if (melhor && !achadas.includes(melhor)) achadas.push(melhor);
+    }
+    return achadas.slice(0, 6);
+}
+function guardarImagens(lista) { IMAGENS = Array.isArray(lista) ? lista.slice(0, 6) : []; return IMAGENS; }
+function imagens() { return IMAGENS; }
+function instrucaoDasImagens(lista = IMAGENS) {
+    if (!lista.length) return '';
+    return `[REFERÊNCIA VISUAL] A pessoa mandou ${lista.length} imagem(ns): ${lista.map((f) => require('path').basename(f)).join(', ')}. `
+        + 'Elas SÃO a referência do pedido, mesmo em "só motion". Se o pedido é vídeo, o Estúdio já guarda cada uma no projeto e tira as '
+        + 'cores dela (com site, as cores do site mandam). Escreva o roteiro seguindo o que a referência mostra e diga no fim, '
+        + 'em uma linha, o que dela o vídeo usou.';
+}
+
+module.exports = { definir, atual, limpar, semImagem, termos, entender, inferir, instrucao, dominios, filtrar,
+    imagensNoTexto, guardarImagens, imagens, instrucaoDasImagens };

package/lib/pre-leitura.js

@@ -32,7 +32,8 @@
 const fs = require('fs');
 const path = require('path');
 
-const ORCAMENTO_SERVIDOR = 6 * 1024;
+// 2,5 KB no servidor (13/10): 6 KB de arquivo pré-lido não cabiam no orçamento do plano grátis e empurravam a conversa para fora.
+const ORCAMENTO_SERVIDOR = 2.5 * 1024;
 const ORCAMENTO_LOCAL = 40 * 1024;
 const MAIOR_ARQUIVO = 20 * 1024;
 

package/lib/tools.js

@@ -630,8 +630,15 @@ async function despachar(name, args, ctx) {
                 return editFile(args, projectDir);
             case 'read_file':
                 return readFile(args, projectDir);
-            case 'list_dir':
-                return { ok: true, tree: treeDir(resolverParaLer(args.path, projectDir), args.depth || 2) };
+            case 'list_dir': {
+                /* No máximo 60 linhas (13/10: "continua listando coisas desnecessárias").
+                   Pasta grande listada inteira enche a conversa e não diz onde está o que importa. */
+                const arvore = String(treeDir(resolverParaLer(args.path, projectDir), args.depth || 2));
+                const ls = arvore.split('\n');
+                if (ls.length <= 60) return { ok: true, tree: arvore };
+                return { ok: true, tree: ls.slice(0, 60).join('\n'), cortado: ls.length - 60,
+                    dica: 'Lista grande, cortei. Não liste de novo: use glob com o padrão do que procura (ex.: "src/**/*.css") ou grep pelo nome.' };
+            }
             /* `pasta` (opcional): procurar numa pasta que o usuário citou, sem
                trocar a de trabalho. Os caminhos voltam relativos a ELA, e a
                resposta diz qual é. */

package/lib/travado.js

@@ -15,6 +15,10 @@
  *      vezes sem escrita no meio?                              → travado
  *   3. VOLTAS_SEM_NOVIDADE voltas seguidas sem escrever nada e sem nenhuma
  *      chamada que ainda não tinha sido feita?                 → travado
+ *   4. LIMITE_OLHAR leituras, listagens e buscas DIFERENTES seguidas, sem
+ *      nenhuma ação no meio (escrever, rodar, usar o Estúdio)? → travado
+ *      (13/10: "continua lendo e listando coisas desnecessárias". As regras
+ *      1 a 3 só pegam repetição: ler 20 arquivos diferentes nunca travava.)
  * Na primeira vez, um empurrão curto (o que está repetindo, o que fazer). Se
  * travar de novo depois do empurrão, PARA e diz por quê.
  *
@@ -28,10 +32,14 @@ const path = require('path');
 const LIMITE_RELEITURA = 3;
 const LIMITE_MESMA_CHAMADA = 4;
 const VOLTAS_SEM_NOVIDADE = 6;
+const LIMITE_OLHAR = 8;
+const OLHAR = new Set(['read_file', 'list_dir', 'glob', 'grep']);
+// O shell que só olha: listar, achar, procurar, mostrar arquivo.
+const RE_SHELL_OLHA = /^(?:cd\s+\S+\s*&&\s*)?(?:ls|find|grep|rg|cat|head|tail|sed\s+-n|tree|wc|nl|less|more|stat|file|du)\b/;
 const ESCRITAS = new Set(['write_file', 'edit_file', 'multi_edit']);
 
 function novo() {
-    return { leituras: new Map(), chamadas: new Map(), vistas: new Set(), novidade: false, voltasSemNovidade: 0, avisos: 0 };
+    return { leituras: new Map(), chamadas: new Map(), vistas: new Set(), novidade: false, voltasSemNovidade: 0, avisos: 0, olhou: [], limiteOlhar: LIMITE_OLHAR };
 }
 
 /* A faixa que a leitura cobre. Sem offset nem limit, o read_file devolve o
@@ -89,6 +97,19 @@ function observar(estado, nome, args, pasta) {
         estado.novidade = true;
     }
     if (!estado.vistas.has(chave)) { estado.vistas.add(chave); estado.novidade = true; }
+    // Regra 4: o que só olha soma; qualquer ação zera.
+    const soOlha = OLHAR.has(nome) || (nome === 'run_shell' && RE_SHELL_OLHA.test(String(a.command || '').trim()));
+    if (!soOlha) { estado.olhou = []; estado.limiteOlhar = LIMITE_OLHAR; }
+    else {
+        const alvo = a.path || a.pattern || a.query || a.command || '.';
+        const curto = pasta && a.path ? path.relative(pasta, caminhoDe(a.path, pasta)) || '.' : String(alvo).slice(0, 40);
+        estado.olhou.push(`${nome === 'run_shell' ? '$ ' : ''}${curto}`);
+        if (estado.olhou.length >= estado.limiteOlhar) {
+            // A segunda vez vem 4 olhadas depois: o empurrão dá espaço para o último passo, não para mais um passeio.
+            estado.limiteOlhar = estado.olhou.length + 4;
+            return `olhou ${estado.olhou.length} coisas seguidas sem fazer nada (${estado.olhou.slice(-6).join(', ')})`;
+        }
+    }
     const leitura = nome === 'read_file' ? a : nome === 'run_shell' ? leituraDoShell(a.command) : null;
     if (leitura && leitura.path) {
         const caminho = caminhoDe(leitura.path, pasta);
@@ -138,4 +159,4 @@ function decidir(estado, motivo) {
     };
 }
 
-module.exports = { LIMITE_RELEITURA, LIMITE_MESMA_CHAMADA, VOLTAS_SEM_NOVIDADE, LEITURA_PADRAO, novo, faixa, leituraDoShell, observar, fimDaVolta, decidir };
+module.exports = { LIMITE_RELEITURA, LIMITE_MESMA_CHAMADA, VOLTAS_SEM_NOVIDADE, LIMITE_OLHAR, LEITURA_PADRAO, novo, faixa, leituraDoShell, observar, fimDaVolta, decidir };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primocode",
-  "version": "10.7.1",
+  "version": "10.9.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/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/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"
+    "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/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/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"
   },
   "engines": {
     "node": ">=18.17.0"