primocode 10.14.1 → 10.15.1

package/LICENSES/robo.txt

@@ -0,0 +1,19 @@
+Robô 3D da tela do Primo (voz/primo_voz/vendor/RobotExpressive.glb)
+
+Modelo: RobotExpressive, de Tomás Laulhé (https://www.patreon.com/quaternius). CC0 1.0 (domínio público).
+Modificações de Don McCurdy: três morph targets de expressão, conversão com FBX2GLTF, materiais deduplicados.
+Fonte: https://github.com/mrdoob/three.js/tree/r170/examples/models/gltf/RobotExpressive (README conferido na tag r170).
+Aqui as cores dos materiais são trocadas em tempo de execução (branco/grafite + ciano); o arquivo .glb é o original.
+
+three.js r170 + GLTFLoader (voz/primo_voz/vendor/three-robo.min.js, bundle mínimo gerado com esbuild)
+Licença MIT, Copyright 2010-2024 three.js authors. Texto completo: voz/primo_voz/vendor/three.LICENSE.txt
+
+--- Robô do Spline (voz.json: "robo": "spline", o padrão; "expressive" volta ao RobotExpressive acima) ---
+
+Cena: "AI Robotics Landing Page" (template da comunidade v0/Spline)
+  https://v0.app/templates/ai-robotics-landing-page-iArz1CoDHnf
+  https://prod.spline.design/kZDDjO5HuC9GJUM2/scene.splinecode  (baixada em tempo de execução, precisa de internet; não vai no repo)
+Licença da cena: [VERIFICAR] — confirmar com o autor/Spline antes de uso comercial. Uso atual: pedido do Joel, uso interno.
+Runtime: @splinetool/runtime 1.12.95 (voz/primo_voz/vendor/spline-runtime.min.js, bundle IIFE gerado com esbuild; local, sem CDN).
+  O pacote npm não declara campo "license" [VERIFICAR] — o Joel informou MIT; conferir no repositório splinetool antes de redistribuir.
+Sem internet ou cena lenta (> 6 s): cai no RobotExpressive (CC0).

package/README.md

@@ -1,4 +1,4 @@
-# PrimoCode v10.14.0
+# PrimoCode v10.15.1
 
 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.14.0
+ ▐▛███▜▌   Primo Code v10.15.1
 ▝▜█████▛▘  Bem-vindo de volta, Joel
   ▘▘ ▝▝    ~/primocode  · /dir <pasta> muda
 ```
@@ -17,6 +17,10 @@ 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`.
 
+## Primo (voz)
+
+`/voice` abre a tela do Primo: agenda, clima, música, máquina e um robô 3D no centro. Diga **"Primo"** para chamar; ele fala frase a frase e você pode interromper. Na primeira vez cria `~/.primocode/voz-venv` sozinho (`primocode doutor` mostra o estado). Robô offline: `"robo":"expressive"` em `~/.primocode/voz.json`.
+
 ## Novidades da 10.14
 
 - **Vídeo de motion de ponta a ponta** (EffectCraft, 68 receitas, voz, trilha, prévia e editor por comando). Detalhes no `CHANGELOG.md`.

package/bin/primocode.js

@@ -212,7 +212,9 @@ const SLASH_COMANDOS = [
     ['/chats', 'suas conversas salvas, as mesmas do app e do celular'],
     ['/logout', 'desconecta este computador da conta'],
     ['!comando', 'roda direto no shell, sem passar pelo agente (o campo fica âmbar)'],
-    ['/voice', 'liga o microfone: você fala, ele faz, e a resposta sai em voz alta'],
+    ['/voice', 'liga o Primo: diga "Primo, ..."; ele faz e responde em voz alta, com a tela dele (robô, agenda, clima, música)'],
+    ['/voice painel', 'só o painel do Primo (ESC esconde)'],
+    ['/voice nome <Nome>', 'dá outro nome ao assistente (vira a palavra de ativação)'],
     ['/voice parar', 'desliga o modo voz e fecha o microfone'],
     ['/skills', 'o que ele sabe fazer bem — ligue e desligue'],
     ['/marketplace', 'a tela das skills: navegue, ligue, crie'],
@@ -1619,6 +1621,7 @@ let chatEmVoo = null;
 /* O ouvinte de voz em segundo plano.
    Um por sessão: dois processos disputando o mesmo microfone dão um vazio
    intermitente que parece defeito de hardware e não é. */
+let vozPainel = null;      // /voice painel: só o HUD
 let vozEmEspera = null;   // a sessão do /voice: { processo, falar, calar }
 /* Por onde a fala entra no terminal. Nasce no main(), junto da fila — é lá
    que moram o `busy`, a fila e o `ask` pendente. */
@@ -2474,8 +2477,26 @@ async function handleSlash(text) {
 
                Desligar é o primeiro caso de propósito: quem quer fechar o
                microfone quer AGORA, sem esbarrar em checagem de dependência. */
-            if (/^(parar|stop|off|sair)$/i.test((rest || '').trim())) {
-                if (!vozEmEspera) { console.log(c.muted('  O modo voz não está ligado.')); break; }
+            const argVoz = (rest || '').trim();
+            // Só o painel (HUD em tela cheia no Mac; quadro no terminal fora dele).
+            if (/^painel$/i.test(argVoz)) {
+                const py = vozModo.python();
+                if (!py) { console.log(c.err('  O painel precisa do Python 3.')); break; }
+                if (vozPainel) { try { vozPainel.processo.kill(); } catch {} vozPainel = null; }
+                vozPainel = vozModo.abrirPainel({ python: py });
+                console.log(c.muted(vozPainel.tela ? '  Tela do Primo aberta — ESC esconde.' : '  Sem o painel gráfico aqui: rode `primocode voz painel` num terminal separado.'));
+                break;
+            }
+            // /voice nome <Nome>: a pessoa dá o nome ao assistente (e a palavra de ativação passa a ser ele).
+            const mNome = argVoz.match(/^nome\s+(.{2,20})$/i);
+            if (mNome) {
+                const salvo = vozModo.definirNome(mNome[1]);
+                console.log(salvo ? c.ok(`  Fechado: o assistente agora se chama ${salvo}. Vale na próxima vez que ligar o /voice.`) : c.err('  Nome inválido (1 ou 2 palavras, até 20 letras).'));
+                break;
+            }
+            if (/^(parar|stop|off|sair)$/i.test(argVoz)) {
+                if (vozPainel) { try { vozPainel.processo.kill(); } catch {} vozPainel = null; }
+                if (!vozEmEspera) { console.log(c.muted(vozPainel === null ? '  Modo voz e painel fechados.' : '  O modo voz não está ligado.')); break; }
                 try { vozEmEspera.processo.kill(); } catch {}
                 vozEmEspera = null;
                 console.log(c.muted('  Modo voz desligado. O microfone fechou.'));
@@ -2498,6 +2519,7 @@ async function handleSlash(text) {
                 break;
             }
             for (const a of prep.avisos) console.log(c.dim(`  ${a}`));
+            if (process.platform === 'darwin') { try { vozModo.instalarApp({ python: prep.python }); } catch { /* o app é bônus */ } }
 
             const sessao = vozModo.abrir({
                 python: prep.python,
@@ -2508,10 +2530,12 @@ async function handleSlash(text) {
                     console.log('  ' + c.bold(c.brand('🎙 Modo voz ligado')) + c.muted(' — é só falar. A resposta sai em voz alta.'));
                     console.log('  ' + c.dim('Falar por cima corta a voz · digitar continua valendo · /voice parar desliga'));
                 },
+                aoParar: () => { try { require('../lib/act.js').interromper(); } catch { /* nada rodando */ } },
                 aoOuvir: (texto) => { if (entradaDeVoz) entradaDeVoz(texto); },
                 mostrar: (texto) => console.log('  ' + c.dim(texto)),
             });
             vozEmEspera = sessao;
+            require('../lib/voz-ponte').escutar((nome, args) => sessao.ferramenta(nome, args));
             sessao.pronto.then((r) => {
                 if (vozEmEspera === sessao) vozEmEspera = null;
                 if (r && !r.ok) console.log(c.err(`  o modo voz fechou: ${r.error}`));
@@ -2883,6 +2907,32 @@ async function main() {
         process.exit(require('../lib/skills.js').main(process.argv.slice(3)));
     }
     // `primocode planos`: a tabela comparativa, sem abrir a sessão.
+    // `primocode voz nome <Nome>` / `primocode voz painel`: o Primo sem abrir a sessão.
+    if (process.argv[2] === 'voz') {
+        const vz = require('../lib/voz.js');
+        const [sub, ...resto] = process.argv.slice(3);
+        if (sub === 'nome') {
+            const n = vz.definirNome(resto.join(' '));
+            console.log(n ? `Fechado: o assistente agora se chama ${n}.` : 'Uso: primocode voz nome <Nome>  (1 ou 2 palavras)');
+            process.exit(n ? 0 : 1);
+        }
+        if (sub === 'painel') {
+            const py = vz.python();
+            if (!py) { console.log('O painel precisa do Python 3.'); process.exit(1); }
+            const r = vz.abrirPainel({ python: py });
+            r.processo.on('close', () => process.exit(0));
+            return;
+        }
+        if (sub === 'instalar-app') {
+            const py = vz.python();
+            if (!py) { console.log('O app precisa do Python 3 (rode /voice uma vez para preparar o ambiente).'); process.exit(1); }
+            const r = vz.instalarApp({ python: py, dock: resto.includes('--dock') });
+            console.log(r.ok ? `Primo.app instalado em ${r.app}. Abra pelo Launchpad, Spotlight ou Finder.` : `Não deu: ${r.erro || 'veja o log'}`);
+            process.exit(r.ok ? 0 : 1);
+        }
+        console.log('Uso: primocode voz nome <Nome> | primocode voz painel | primocode voz instalar-app [--dock] (o resto é /voice dentro da sessão)');
+        process.exit(0);
+    }
     if (['doutor', 'doctor', 'preparar'].includes(process.argv[2])) {
         process.exit(await require('../lib/preparar.js').main(process.argv.slice(2)));
     }
@@ -3129,6 +3179,7 @@ async function main() {
                 }
             } catch (e) {
                 fala.problema(e);
+                if (vozEmEspera && vozEmEspera.estado) vozEmEspera.estado('erro');
             }
             // Pedido falado (ou tarefa que recebeu recado falado): a resposta
             // final sai em voz alta, resumida. O detalhe fica na tela.

package/lib/act.js

@@ -846,6 +846,7 @@ async function runAct(userPrompt, opts) {
     let paradoPorTravar = null;
     /* Anota ANTES de agir (lib/auditoria.js): recusado também fica no livro. */
     const anotar = (tc, decisao, motivo) => {
+        if (decisao !== 'recusada' && decisao !== 'negada') require('./voz-ponte').ferramenta(tc.name, tc.arguments);
         const id = auditoria.antes({ agente: rotulo, ferramenta: tc.name, args: tc.arguments, decisao, motivo });
         const falhou = auditoria.problema();
         if (falhou) console.log(c.warn(`⚠ ${falhou}`));

package/lib/conta.js

@@ -213,6 +213,7 @@ async function entrar({ email, senha } = {}, op = {}) {
 }
 
 function abrirNoNavegador(url) {
+    if (process.env.PRIMOCODE_SEM_NAVEGADOR === '1') return false;   // app do Primo (voz): navegador só com clique explícito
     const [cmd, args] = process.platform === 'darwin' ? ['open', [url]]
         : process.platform === 'win32' ? ['cmd', ['/c', 'start', '""', url]]
             : ['xdg-open', [url]];

package/lib/estudio/exportar.js

@@ -156,6 +156,7 @@ function registrar({ id, assunto, caminho, formato, duracao, assinatura, entrega
 }
 const listar = (arq) => ler(arq).filter((v) => v.caminho && fs.existsSync(v.caminho)).sort((a, b) => String(b.data).localeCompare(String(a.data)));
 function abrirNoSistema(alvo) {
+    if (process.env.PRIMOCODE_SEM_NAVEGADOR === '1') return false;   // app do Primo (voz): navegador só com clique explícito
     const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'cmd' : 'xdg-open';
     const args = process.platform === 'win32' ? ['/c', 'start', '""', alvo] : [alvo];
     return spawnSync(cmd, args, { stdio: 'ignore' }).status === 0;

package/lib/mcp.js

@@ -204,6 +204,7 @@ function conectarHttp(def, { tetoMs = 60000, nome, buscar = globalThis.fetch } =
 const b64url = (b) => Buffer.from(b).toString('base64').replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
 
 function abrirUrl(url) {
+    if (process.env.PRIMOCODE_SEM_NAVEGADOR === '1') return false;   // app do Primo (voz): navegador só com clique explícito
     const [cmd, args] = process.platform === 'darwin' ? ['open', [url]]
         : process.platform === 'win32' ? ['cmd', ['/c', 'start', '""', url]]
             : ['xdg-open', [url]];

package/lib/preparar.js

@@ -70,6 +70,8 @@ function estudioLinhas(dep = {}) {
     // marca ativa
     const mk = tenta(() => require('./marca-kit.js').ativa([process.cwd()]), null);
     poe(null, 'Marca ativa', mk ? (mk.nome || mk.slug || 'sim') : 'nenhuma — primocode marca criar <nome>');
+    // Primo (modo voz)
+    tenta(() => linhas.push(...require('./voz.js').linhasDoutor()), null);
     // MCP
     const mcp = tenta(() => Object.keys(require('./mcp.js').servidores()), []);
     poe(null, 'MCP', mcp.length ? mcp.join(', ') : 'nenhum servidor');

package/lib/tools.js

@@ -304,6 +304,7 @@ async function runShell(command, timeout = 60000, cwd, env) {
 // UM argumento, não texto que um shell reinterpreta — sem isso, um valor tipo
 // `https://x/"; touch /tmp/pwned; echo "` injetava comando (achado de segurança).
 function openInBrowser(target) {
+    if (process.env.PRIMOCODE_SEM_NAVEGADOR === '1') return Promise.resolve({ ok: false, error: 'o navegador está bloqueado no modo voz: só abre quando a pessoa clica' });   // app do Primo (voz): navegador só com clique explícito
     const p = os.platform();
     const [cmd, args, opener] = p === 'darwin' ? ['open', [target], 'open']
         : p === 'win32' ? ['cmd.exe', ['/c', 'start', '', target], 'start']

package/lib/voz-ponte.js

@@ -0,0 +1,15 @@
+/**
+ * voz-ponte.js — o aviso do agente para o modo voz, sem um depender do outro.
+ *
+ * O agente (lib/act.js) diz "comecei a ferramenta X" aqui; o /voice, se estiver
+ * ligado, se inscreve e repassa ao Primo (painel mostra "executando" e ele
+ * confirma em voz alta: "rodando os testes"). Sem /voice, ninguém escuta.
+ */
+'use strict';
+
+let ouvinte = null;
+
+module.exports = {
+    escutar: (fn) => { ouvinte = typeof fn === 'function' ? fn : null; },
+    ferramenta: (nome, args) => { if (ouvinte) { try { ouvinte(String(nome || ''), args || {}); } catch { /* o aviso nunca derruba o agente */ } } },
+};

package/lib/voz.js

@@ -63,8 +63,19 @@ function paraFalar(texto, { frases = 3, teto = 420 } = {}) {
     return (fala || t.slice(0, teto)).trim();
 }
 
-/** Onde está o Python 3. Mesmo problema do Estúdio, mesma cura. */
+/* O VENV DO PRIMO. As dependências opcionais (VAD, painel em tela cheia) moram
+ * em ~/.primocode/voz-venv, instaladas sob demanda: ninguém precisa quebrar o
+ * Python do sistema (PEP 668) nem perde nada se não instalar. */
+const VENV = path.join(os.homedir(), '.primocode', 'voz-venv');
+const venvPython = () => path.join(VENV, process.platform === 'win32' ? 'Scripts' : 'bin', process.platform === 'win32' ? 'python.exe' : 'python');
+
+/** Onde está o Python 3. O do venv do Primo ganha, se já existir. */
 function python() {
+    if (fs.existsSync(venvPython())) return venvPython();
+    return pythonDoSistema();
+}
+
+function pythonDoSistema() {
     const nomes = process.platform === 'win32'
         ? ['python', 'py', 'python3']
         : ['python3', 'python', '/opt/homebrew/bin/python3', '/usr/local/bin/python3', '/usr/bin/python3'];
@@ -223,7 +234,7 @@ function instalar(py, pacotes, aoFalar = () => {}) {
  * @param {()=>void} [op.aoPronto]              o microfone abriu
  * @returns {{processo, pronto: Promise, falar:(t:string)=>void, calar:()=>void}}
  */
-function abrir({ python: py, servidor, token, voz, aoOuvir, mostrar = () => {}, aoPronto = () => {} }) {
+function abrir({ python: py, servidor, token, voz, aoParar = () => {}, aoOuvir, mostrar = () => {}, aoPronto = () => {} }) {
     let p;
     const manda = (obj) => {
         try { p.stdin.write(JSON.stringify(obj) + '\n'); } catch { /* já fechou */ }
@@ -237,6 +248,7 @@ function abrir({ python: py, servidor, token, voz, aoOuvir, mostrar = () => {},
                 PRIMOCODE_SERVER: servidor,
                 PRIMOCODE_TOKEN: token || '',
                 PRIMOCODE_VOZ: voz || 'antonio',
+                PRIMOCODE_CWD: process.cwd(),
                 PYTHONUNBUFFERED: '1',
                 // O Whisper deixa um semáforo para o sistema recolher na saída,
                 // e o Python avisa disso no stderr. É inofensivo; o aviso não é.
@@ -254,6 +266,7 @@ function abrir({ python: py, servidor, token, voz, aoOuvir, mostrar = () => {},
                 try { msg = JSON.parse(linha); } catch { continue; }
                 if (msg.tipo === 'fim') { try { p.kill(); } catch {} return; }
                 if (msg.tipo === 'pronto') { try { aoPronto(); } catch {} continue; }
+                if (msg.tipo === 'parar') { try { aoParar(); } catch {} continue; }
                 if (msg.tipo === 'erro') { mostrar(String(msg.texto || ''), true); continue; }
                 if (msg.tipo === 'ouvi' && String(msg.texto || '').trim()) {
                     try { aoOuvir(String(msg.texto).trim()); } catch (e) { mostrar(e.message, true); }
@@ -276,7 +289,12 @@ function abrir({ python: py, servidor, token, voz, aoOuvir, mostrar = () => {},
     return {
         processo: p,
         pronto,
-        falar: (texto) => { const t = paraFalar(texto); if (t) manda({ tipo: 'falar', texto: t }); },
+        /* O texto vai BRUTO: quem resume é o Primo (voz/primo_voz/conversa.py) —
+           a voz diz o resumo, o painel mostra o resto (código, listas). */
+        falar: (texto) => { const t = String(texto || '').trim(); if (t) manda({ tipo: 'falar', texto: t, bruto: true }); },
+        // O agente começou uma ferramenta: o painel mostra "executando" e o Primo confirma ("rodando os testes").
+        ferramenta: (nome, args) => manda({ tipo: 'ferramenta', nome, args: args || {} }),
+        painel: (acao) => manda({ tipo: 'painel', acao }),
         calar: () => manda({ tipo: 'calar' }),
         // A bolinha na tela: 'esperando' quando o terminal termina sem falar.
         estado: (e) => manda({ tipo: 'estado', estado: e }),
@@ -303,7 +321,11 @@ function abrir({ python: py, servidor, token, voz, aoOuvir, mostrar = () => {},
  */
 const OPCIONAIS = () => [
     ['faster_whisper', 'faster-whisper', 'a transcrição local (Whisper)'],
+    ['pysilero_vad', 'pysilero-vad', 'o fim de fala preciso (Silero VAD)'],
+    ['edge_tts', 'edge-tts', 'a voz neural pt-BR (Edge TTS)'],
     ...(process.platform === 'darwin' ? [
+        ['WebKit', 'pyobjc-framework-WebKit', 'o painel em tela cheia do Primo'],
+        ['EventKit', 'pyobjc-framework-EventKit', 'os compromissos de hoje do app Calendário'],
         ['Quartz', 'pyobjc-framework-Quartz', 'o cursor do Primo na tela'],
         ['Vision', 'pyobjc-framework-Vision', 'ler o texto da tela (clicar pelo nome em qualquer app)'],
     ] : []),
@@ -394,13 +416,23 @@ async function baixarWhisper(py) {
  * @returns {Promise<{ok:boolean, python?:string, esperando?:boolean,
  *                    avisos:string[], error?:string, comoResolver?:string}>}
  */
+async function criarVenv(aoFalar) {
+    if (fs.existsSync(venvPython())) return null;
+    const base = pythonDoSistema();
+    if (!base) return null;
+    aoFalar('criando o ambiente do Primo (~/.primocode/voz-venv)');
+    const r = await rodar(base, ['-m', 'venv', VENV], 5 * 60 * 1000);
+    return r.ok ? null : `não consegui criar o ambiente do Primo (${porqueOPipFalhou(r.saida)}) — uso o Python do sistema.`;
+}
+
 async function preparar(aoFalar = () => {}) {
+    const avisoVenv = await criarVenv(aoFalar);
     const py = python();
     if (!py) {
         return { ok: false, avisos: [], error: 'o modo voz precisa do Python 3, e não achei nenhum nesta máquina.',
             comoResolver: process.platform === 'darwin' ? 'brew install python' : 'instale em python.org e abra o terminal de novo' };
     }
-    const avisos = [];
+    const avisos = avisoVenv ? [avisoVenv] : [];
 
     // 1. sistema, depois 2. os obrigatórios pelo pip.
     let falta = faltando(py);
@@ -435,4 +467,66 @@ async function preparar(aoFalar = () => {}) {
     return { ok: true, python: py, avisos };
 }
 
-module.exports = { DICA_COMPUTADOR, paraFalar, conferir, instalar, preparar, porqueOPipFalhou, abrir, python, PASTA };
+/** Primo.app em ~/Applications (Launchpad/Spotlight) + o primo-app.json com os caminhos ABSOLUTOS de node e primocode:
+ *  o app aberto pelo Finder não tem o PATH do terminal. Chamado no primeiro /voice e por `primocode voz instalar-app`. */
+function instalarApp({ python: py, dock = false } = {}) {
+    if (process.platform !== 'darwin') return { ok: false, erro: 'o app do Primo é só para macOS' };
+    try {
+        let cfg = {};
+        try { cfg = require('./config').loadConfig(); } catch { /* usa o padrão do app */ }
+        const arq = path.join(os.homedir(), '.primocode', 'primo-app.json');
+        fs.mkdirSync(path.dirname(arq), { recursive: true });
+        fs.writeFileSync(arq, JSON.stringify({
+            node: process.execPath, primocode: path.resolve(__dirname, '..', 'bin', 'primocode.js'),
+            servidor: cfg.server || '', path: process.env.PATH || '', voz: cfg.voz || 'antonio', versao: require('../package.json').version,
+        }, null, 2));
+        const env = { ...process.env, PYTHONPATH: PASTA, ...(dock ? { PRIMOCODE_APP_DOCK: '1' } : {}) };
+        const linhas = execFileSync(py, ['-m', 'primo_voz.appmac'], { cwd: PASTA, env, encoding: 'utf8', timeout: 60000, stdio: ['ignore', 'pipe', 'ignore'] }).trim().split('\n');
+        return { ok: !!linhas[0], exe: linhas[0] || null, pythonpath: linhas[1] || PASTA, app: path.join(os.homedir(), 'Applications', 'Primo.app') };
+    } catch (e) { return { ok: false, erro: e.message }; }
+}
+
+/** `/voice painel`: só o HUD (sem microfone). Mac com PyObjC = tela cheia; senão, o quadro no terminal. */
+function abrirPainel({ python: py }) {
+    const mac = process.platform === 'darwin' && temModulo(py, 'WebKit');
+    // No Mac o painel roda pelo Primo.app (Dock e Cmd+Tab mostram "Primo" com o ícone); sem ele, o python direto.
+    let exe = null, pp = PASTA;
+    if (mac) { const r = instalarApp({ python: py }); if (r.exe) { exe = r.exe; pp = r.pythonpath; } }
+    const [cmd, args] = exe ? [exe, ['-m', 'primo_voz.hud', '--livre']] : [py, ['-m', mac ? 'primo_voz.hud' : 'primo_voz.painel_tui', ...(mac ? ['--livre'] : [])]];
+    const p = spawn(cmd, args, {
+        cwd: PASTA, env: { ...process.env, PYTHONPATH: exe ? pp : PASTA }, stdio: mac ? 'ignore' : ['pipe', 'inherit', 'inherit'],
+    });
+    return { processo: p, tela: mac };
+}
+
+/** Grava o nome do assistente em ~/.primocode/voz.json (o mesmo arquivo que voz/primo_voz/identidade.py lê). */
+function definirNome(nome) {
+    const limpo = String(nome || '').replace(/[^\p{L}\p{N} -]/gu, '').trim();
+    if (!limpo || limpo.split(/\s+/).length > 2 || limpo.length < 2 || limpo.length > 20) return null;
+    const arq = process.env.PRIMOCODE_VOZ_CONFIG || path.join(os.homedir(), '.primocode', 'voz.json');
+    let cfg = {};
+    try { cfg = JSON.parse(fs.readFileSync(arq, 'utf8')); } catch { /* primeira vez */ }
+    cfg.nome = limpo.split(/\s+/).map((w) => w[0].toUpperCase() + w.slice(1)).join(' ');
+    fs.mkdirSync(path.dirname(arq), { recursive: true });
+    fs.writeFileSync(arq, JSON.stringify(cfg, null, 2));
+    return cfg.nome;
+}
+
+/** As linhas do `primocode doutor` sobre o modo voz. */
+function linhasDoutor() {
+    const py = python();
+    if (!py) return [{ ok: false, item: 'Primo (voz)', detalhe: 'sem Python 3', conserto: 'brew install python' }];
+    const tem = (m) => temModulo(py, m);
+    const venv = fs.existsSync(venvPython());
+    const linha = (ok, item, detalhe, conserto) => ({ ok, item, detalhe, conserto: ok === false ? conserto : undefined });
+    return [
+        linha(venv ? true : null, 'Primo: ambiente', venv ? VENV : 'ainda não criado — /voice cria sozinho', undefined),
+        linha(tem('sounddevice') && tem('numpy'), 'Primo: microfone', 'sounddevice + numpy', '/voice instala; ou: ' + py + ' -m pip install sounddevice numpy'),
+        linha(tem('faster_whisper') ? true : null, 'Primo: Whisper local', tem('faster_whisper') ? 'instalado' : 'não instalado — usa o servidor'),
+        linha(tem('pysilero_vad') ? true : null, 'Primo: Silero VAD', tem('pysilero_vad') ? 'fim de fala preciso' : 'não instalado — usa o corte por volume'),
+        linha(process.platform === 'darwin' ? (tem('WebKit') ? true : null) : null, 'Primo: tela cheia',
+            process.platform !== 'darwin' ? 'só no Mac — aqui, painel no terminal' : tem('WebKit') ? 'pronto' : 'sem PyObjC WebKit — usa a orbe'),
+    ];
+}
+
+module.exports = { instalarApp, definirNome, VENV, abrirPainel, linhasDoutor, DICA_COMPUTADOR, paraFalar, conferir, instalar, preparar, porqueOPipFalhou, abrir, python, PASTA };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primocode",
-  "version": "10.14.1",
+  "version": "10.15.1",
   "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": {
@@ -10,7 +10,7 @@
     "start": "node bin/primocode.js",
     "postinstall": "node lib/preparar.js || true",
     "test:server": "cd server && npm test",
-    "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/mcp-http.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 && node test/effectcraft.test.js && node test/projetos.test.js && node test/maquina.test.js && node test/maquina-som.test.js && node test/maquina-voz.test.js && node test/prova-fresca.test.js && node test/cota-video.test.js && node test/hooks.test.js && node test/modo-plano.test.js && node test/headless.test.js && node test/retomar.test.js && node test/sandbox.test.js && node test/exportar.test.js && node test/editor-video.test.js && node test/marca-kit.test.js && node test/preparar.test.js && node test/landing-planos.test.js && node test/limites.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/primo-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/mcp-http.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 && node test/effectcraft.test.js && node test/projetos.test.js && node test/maquina.test.js && node test/maquina-som.test.js && node test/maquina-voz.test.js && node test/prova-fresca.test.js && node test/cota-video.test.js && node test/hooks.test.js && node test/modo-plano.test.js && node test/headless.test.js && node test/retomar.test.js && node test/sandbox.test.js && node test/exportar.test.js && node test/editor-video.test.js && node test/marca-kit.test.js && node test/preparar.test.js && node test/landing-planos.test.js && node test/limites.test.js"
   },
   "engines": {
     "node": ">=18.17.0"
@@ -32,6 +32,7 @@
     "studio/",
     "skills/",
     "voz/",
+    "LICENSES/",
     "README.md",
     "comandos/",
     "!**/__pycache__",