primocode 10.15.2 → 10.17.0

package/lib/sandbox.js

@@ -8,13 +8,18 @@
  *                           hard_requirement (recusa)
  *
  * O que o comando pode: escrever na pasta do projeto, em /tmp e em
- * ~/.primocode/cache; ler quase tudo, MENOS ~/.ssh, ~/.aws, ~/.config/gcloud,
- * ~/.npmrc e .env*. Rede ligada (o `npm install` precisa), com opção de cortar.
+ * ~/.primocode/cache; ler quase tudo, MENOS os arquivos de credencial da
+ * LEITURA_NEGADA_HOME (chaves, tokens, a conta do PrimoCode, o Keychain) e
+ * .env*. Rede ligada (o `npm install` precisa), com opção de cortar.
+ * No macOS ainda fica de fora: osascript, o comando `security` (Keychain) e
+ * escrever hook em .git/hooks (rodaria FORA da cerca no próximo commit).
+ * O ssh-agent da pessoa fica fora por padrão (review do Arthur, #162): sem
+ * ele, "não lê ~/.ssh" vale de verdade, e não só para o arquivo.
  * Quando bloqueia, a mensagem diz POR QUE, para o modelo aprender.
  *
  * Config em ~/.primocode/config.json:
  *   "sandbox": { "ligado": true, "modo": "best_effort"|"hard_requirement",
- *                "rede": true, "env_permitidas": ["MINHA_KEY"],
+ *                "rede": true, "ssh_agent": false, "env_permitidas": ["MINHA_KEY"],
  *                "escrita_extra": ["~/.npm"] }
  */
 'use strict';
@@ -25,10 +30,14 @@ const path = require('path');
 const { execFile, spawnSync } = require('child_process');
 
 const MODOS = ['best_effort', 'hard_requirement'];
-const LEITURA_NEGADA_HOME = ['.ssh', '.aws', '.config/gcloud', '.npmrc'];
+const LEITURA_NEGADA_HOME = ['.ssh', '.aws', '.config/gcloud', '.npmrc',
+    '.primocode/conta.json', '.netrc', '.git-credentials', '.config/gh', '.docker', '.kube', 'Library/Keychains'];
+// Socket do ssh-agent do macOS (launchd). O caminho exato vem do SSH_AUTH_SOCK; a regex pega os outros.
+const SOCKET_SSH_MAC = '^/private/(tmp|var/run)/com\\.apple\\.launchd\\.[^/]+/Listeners$';
 const SECRETA = /(_KEY|_TOKEN|SECRET)/i;
 
 let _avisou = false;
+let _avisouDesligado = false;
 let _forcaMecanismo; // teste: undefined = detectar; null = ausente; 'seatbelt'|'bwrap'
 
 function arquivoConfig(home) { return path.join(home || os.homedir(), '.primocode', 'config.json'); }
@@ -43,6 +52,7 @@ function config(home) {
         ligado: typeof s.ligado === 'boolean' ? s.ligado : process.platform === 'darwin',
         modo: MODOS.includes(s.modo) ? s.modo : 'best_effort',
         rede: s.rede !== false,
+        ssh_agent: s.ssh_agent === true,
         env_permitidas: Array.isArray(s.env_permitidas) ? s.env_permitidas.map(String) : [],
         escrita_extra: Array.isArray(s.escrita_extra) ? s.escrita_extra.map(String) : [],
     };
@@ -68,6 +78,17 @@ function mecanismo() {
     return null;
 }
 
+/** Linha para a PESSOA ver no terminal (o stderr do comando só o modelo lê). Vai pro
+ *  stderr do processo para não sujar a saída do `-p`. */
+function avisarPessoa(msg) {
+    try { console.error(require('./ui.js').c.warn(`  ⎿ ${msg}`)); } catch { /* sem tela */ }
+}
+
+function socketSsh() {
+    const s = process.env.SSH_AUTH_SOCK;
+    try { return s && fs.statSync(s).isSocket() ? real(s) : null; } catch { return null; }
+}
+
 function real(p) { try { return fs.realpathSync(p); } catch { return path.resolve(p); } }
 function expandir(p, home) { return p.startsWith('~') ? path.join(home, p.slice(1)) : p; }
 const sbq = (s) => '"' + String(s).replace(/\\/g, '\\\\').replace(/"/g, '\\"') + '"';
@@ -86,8 +107,20 @@ function perfilSeatbelt(projectDir, cfg = config(), home = os.homedir()) {
     const l = ['(version 1)', '(allow default)', '(deny file-write*)'];
     for (const p of escrita) l.push(`(allow file-write* (subpath ${sbq(p)}))`);
     l.push('(allow file-write* (literal "/dev/null") (literal "/dev/tty") (literal "/dev/dtracehelper") (regex #"^/dev/fd/"))');
+    // Hook em .git/hooks roda fora da cerca no próximo `git commit` da pessoa. O .sample do `git init` passa.
+    l.push('(deny file-write* (regex #"/\\.git/hooks/[^/]+$"))');
+    l.push('(allow file-write* (regex #"/\\.git/hooks/[^/]+\\.sample$"))');
     for (const p of negadosLeitura) l.push(`(deny file-read* (subpath ${sbq(real(p))}) (subpath ${sbq(p)}))`);
     l.push('(deny file-read* (regex #"/\\.env($|\\.[^/]*$)"))');
+    // osascript manda o Terminal/Finder fazer o que a cerca não deixa; `security` lê o Keychain.
+    l.push('(deny process-exec (literal "/usr/bin/osascript") (literal "/usr/bin/security"))');
+    l.push('(deny appleevent-send)');
+    l.push('(deny mach-lookup (global-name "com.apple.SecurityServer") (global-name "com.apple.securityd"))');
+    if (!cfg.ssh_agent) {
+        const sock = socketSsh();
+        l.push(`(deny network-outbound (remote unix-socket (path-regex #"${SOCKET_SSH_MAC}")))`);
+        if (sock) l.push(`(deny network-outbound (remote unix-socket (path-literal ${sbq(sock)})))`);
+    }
     if (!cfg.rede) l.push('(deny network*)');
     return l.join('\n');
 }
@@ -106,6 +139,11 @@ function argsBwrap(projectDir, cfg = config(), home = os.homedir()) {
             if (/^\.env($|\.)/.test(f)) a.push('--ro-bind', '/dev/null', path.join(real(projectDir), f));
         }
     } catch { /* pasta sumiu */ }
+    // Montado DEPOIS do --bind do projeto, para valer por cima dele. [VERIFICAR] no Linux.
+    const hooks = path.join(real(projectDir), '.git', 'hooks');
+    if (fs.existsSync(hooks)) a.push('--ro-bind', hooks, hooks);
+    const sock = cfg.ssh_agent ? null : socketSsh();
+    if (sock) a.push('--ro-bind', '/dev/null', sock);
     if (!cfg.rede) a.push('--unshare-net');
     a.push('--die-with-parent', '--chdir', real(projectDir));
     return a;
@@ -115,7 +153,16 @@ function argsBwrap(projectDir, cfg = config(), home = os.homedir()) {
 function envolver(command, projectDir, opts = {}) {
     const home = opts.home || os.homedir();
     const cfg = opts.cfg || config(home);
-    if (!cfg.ligado) return { semCerca: true, motivo: 'desligado' };
+    if (!cfg.ligado) {
+        let aviso = null;
+        if (!_avisouDesligado) {
+            _avisouDesligado = true;
+            aviso = process.platform === 'darwin'
+                ? 'aviso: o sandbox está desligado; os comandos do agente rodam sem cerca. /sandbox on liga.'
+                : 'aviso: o sandbox vem desligado fora do macOS; os comandos do agente rodam sem cerca. /sandbox on liga (no Linux precisa do bwrap).';
+        }
+        return { semCerca: true, motivo: 'desligado', aviso };
+    }
     const mec = mecanismo();
     if (!mec) {
         if (cfg.modo === 'hard_requirement') {
@@ -132,14 +179,15 @@ function envolver(command, projectDir, opts = {}) {
 /** Se o comando falhou por causa da cerca, diz por quê (e qual caminho). */
 function explicar(stderr, projectDir, cfg, home) {
     const txt = String(stderr || '');
-    const m = /(?:^|\n)(?:[^\n:]*:\s*)?(\/[^\n:]+?|\.{1,2}\/[^\n:]+?|[^\s:'"]+?):?\s*(?:Operation not permitted|Permission denied|Read-only file system)/.exec(txt)
+    const m = /(?:^|\n)(?:[^\n:]*:\s*)?(\/[^\n:]+?|\.{1,2}\/[^\n:]+?|[^\s:'"]+?):?\s*(?:(?:open|read|stat|lstat|opendir|write):\s*)?(?:Operation not permitted|Permission denied|Read-only file system)/.exec(txt)
         || /(?:Operation not permitted|Permission denied|Read-only file system)[^\n]*?['"]([^'"\n]+)['"]/.exec(txt);
     if (!m) return null;
     const alvo = path.resolve(projectDir, m[1].trim());
     const { negadosLeitura } = caminhos(projectDir, cfg, home);
     const secreto = negadosLeitura.some((p) => alvo === p || alvo.startsWith(p + path.sep) || alvo.startsWith(real(p) + path.sep))
         || /(^|\/)\.env($|\.)/.test(alvo);
-    if (secreto) return `o sandbox bloqueou leitura de segredo: ${alvo} (~/.ssh, ~/.aws, ~/.config/gcloud, ~/.npmrc e .env* ficam fora do alcance). Não tente ler isso; peça ao usuário o que precisa.`;
+    if (secreto) return `o sandbox bloqueou leitura de segredo: ${alvo} (${LEITURA_NEGADA_HOME.map((p) => '~/' + p).join(', ')} e .env* ficam fora do alcance). Não tente ler isso; peça ao usuário o que precisa.`;
+    if (/\/\.git\/hooks\//.test(alvo)) return `o sandbox bloqueou escrita em hook do git: ${alvo}. Hook roda fora da cerca; se o usuário quiser um, ele instala.`;
     if (/Read-only|Operation not permitted|Permission denied/.test(txt)) {
         return `o sandbox bloqueou escrita fora do projeto: ${alvo}. Escreva só dentro de ${projectDir}, em /tmp ou em ~/.primocode/cache.`;
     }
@@ -168,7 +216,7 @@ function executar(command, { projectDir, timeout = 60000, env = process.env, hom
         const termina = (error, stdout, stderr) => {
             let err = stderr || '';
             const info = { mecanismo: e.mec || null };
-            if (e.aviso) err = e.aviso + '\n' + err;
+            if (e.aviso) { err = e.aviso + '\n' + err; avisarPessoa(e.aviso); }
             if (error && e.mec) {
                 const why = explicar(err, cwd, cfg, e.home);
                 if (why) { err = err + '\n[sandbox] ' + why; info.bloqueou = why; }
@@ -191,7 +239,7 @@ function estado(home) {
 
 function _teste({ mecanismo: m, avisou } = {}) {
     if (m !== undefined) _forcaMecanismo = m === 'auto' ? undefined : m;
-    if (avisou !== undefined) _avisou = avisou;
+    if (avisou !== undefined) { _avisou = avisou; _avisouDesligado = avisou; }
 }
 
 module.exports = { config, salvar, estado, mecanismo, envolver, executar, explicar, filtrarEnv, perfilSeatbelt, argsBwrap, MODOS, _teste };

package/lib/titulo-conversa.js

@@ -0,0 +1,46 @@
+/**
+ * titulo-conversa.js — quem dá título à conversa é quem leu a primeira troca.
+ *
+ * Antes o título era o começo da primeira mensagem ("Oi.", "E ele tem o…"): o
+ * gravador (lib/nuvem.js) usava `tituloDe`. Agora, depois da primeira resposta
+ * de uma conversa NOVA, o modelo escreve um título de 2 a 5 palavras e o
+ * gravador troca o do documento na nuvem. O app (Mac e desktop) lê esse título
+ * em `primocode conversas --json`, então a lateral muda sozinha.
+ *
+ * Se o modelo não responder a tempo, ou vier lixo, vale o título de antes:
+ * nenhum erro aparece. Puro, menos `escolher`, que recebe quem pergunta de fora.
+ */
+'use strict';
+
+const TEMPO_MAXIMO_MS = 8000;
+
+/** A pergunta. Curta: vai numa chamada à parte. */
+function pergunta(pedido, resposta) {
+    return 'Dê um título curto para esta conversa, de 2 a 5 palavras, em português do Brasil. '
+        + 'O título diz o ASSUNTO (ex.: Site da padaria, Vídeo de lançamento, Erro no login), '
+        + 'nunca "Conversa" nem "Oi". Sem aspas, sem ponto final e sem explicação. Responda SÓ com o título.\n\n'
+        + `PESSOA: ${String(pedido || '').slice(0, 500)}\n\nPRIMO: ${String(resposta || '').slice(0, 500)}`;
+}
+
+/** Limpa a resposta do modelo. Devolve null quando não dá pra confiar nela. */
+function limpar(resposta) {
+    const linha = String(resposta || '').trim().split('\n').map((l) => l.trim()).find(Boolean) || '';
+    const t = linha.replace(/^(t[ií]tulo)\s*:\s*/i, '').replace(/^[`"'“”*#\s]+|[`"'“”*.\s]+$/g, '').replace(/\s+/g, ' ');
+    const palavras = t.split(' ').filter(Boolean);
+    if (!t || t.length > 60 || palavras.length < 1 || palavras.length > 7) return null;
+    if (/^(conversa|oi|ol[aá]|t[ií]tulo|sem t[ií]tulo)$/i.test(t)) return null;
+    return t.charAt(0).toUpperCase() + t.slice(1);
+}
+
+/** Pergunta ao modelo e devolve o título limpo, ou null (falhou, demorou ou veio lixo). Nunca rejeita. */
+async function escolher({ pedido, resposta, perguntar, tempoMs = TEMPO_MAXIMO_MS }) {
+    try {
+        let timer;
+        const limite = new Promise((ok) => { timer = setTimeout(() => ok(null), tempoMs); });
+        const r = await Promise.race([Promise.resolve(perguntar(pergunta(pedido, resposta))), limite]);
+        clearTimeout(timer);
+        return r == null ? null : limpar(r);
+    } catch { return null; }
+}
+
+module.exports = { pergunta, limpar, escolher, TEMPO_MAXIMO_MS };

package/lib/tools.js

@@ -274,10 +274,13 @@ function grepFiles({ pattern, glob, ignoreCase, contexto = 0, maxResultados = 10
    USER, NODE_*, nvm etc. continuam — sem eles `npm`, `node` e `git` quebram.
    Na dúvida o nome sai: um token a mais escondido custa pouco, um a menos
    vaza. Só o caminho do agente (execute → run_shell) é filtrado; os usos
-   internos (abrir terminal, desinstalar) seguem com o ambiente inteiro. */
+   internos (abrir terminal, desinstalar) seguem com o ambiente inteiro.
+   O SSH_AUTH_SOCK também sai (review do Arthur, #162): com ele o agente usa o
+   ssh-agent da pessoa (`git push`, `ssh host`) sem ler ~/.ssh. Volta só com
+   `/sandbox ssh on`. */
 const NOME_SECRETO = /(TOKEN|SECRET|KEY|PASSWORD|PASSWD|CREDENTIAL|AUTH|COOKIE|SESSION)/i;
 const PREFIXO_SECRETO = /^(AWS_|OPENAI_|ANTHROPIC_|GEMINI_|GOOGLE_API|GROQ_|OPENROUTER_|AZURE_|HF_|HUGGING)/i;
-const SEMPRE_PASSA = new Set(['PATH', 'HOME', 'USER', 'LOGNAME', 'SHELL', 'LANG', 'TERM', 'TMPDIR', 'PWD', 'SSH_AUTH_SOCK']);
+const SEMPRE_PASSA = new Set(['PATH', 'HOME', 'USER', 'LOGNAME', 'SHELL', 'LANG', 'TERM', 'TMPDIR', 'PWD']);
 
 function ambienteLimpo(env = process.env, permitidas = []) {
     const limpo = {};
@@ -289,6 +292,10 @@ function ambienteLimpo(env = process.env, permitidas = []) {
     return limpo;
 }
 
+function permitidasNoShell(cfg = sandbox.config()) {
+    return cfg.ssh_agent ? [...cfg.env_permitidas, 'SSH_AUTH_SOCK'] : cfg.env_permitidas;
+}
+
 async function runShell(command, timeout = 60000, cwd, env) {
     return new Promise((resolve) => {
         exec(command, { timeout, cwd: cwd || process.cwd(), maxBuffer: 10 * 1024 * 1024, env: env || process.env }, (error, stdout, stderr) => {
@@ -668,7 +675,7 @@ async function despachar(name, args, ctx) {
             case 'run_shell':
                 // Dentro da cerca (lib/sandbox.js); desligada ou sem mecanismo cai no exec de sempre.
                 return sandbox.executar(args.command, { projectDir, timeout: args.timeout_ms || 60000,
-                    env: ambienteLimpo(process.env, sandbox.config().env_permitidas) });
+                    env: ambienteLimpo(process.env, permitidasNoShell()) });
             case 'run_in_new_terminal':
                 return runInNewTerminal(args.command, args.cwd || projectDir);
             case 'open_in_browser': {
@@ -712,6 +719,15 @@ async function despachar(name, args, ctx) {
                 return { ok: true, gravado: entry };
             }
 
+            // A memória que dura entre sessões (lib/memoria-usuario.js).
+            case 'lembrar': {
+                const mem = require('./memoria-usuario.js');
+                const acao = String(args.acao || 'salvar').toLowerCase();
+                if (acao === 'apagar') return mem.apagar(args.nome);
+                if (acao === 'salvar') return mem.salvar({ nome: args.nome, descricao: args.descricao, tipo: args.tipo, texto: args.texto });
+                return { ok: false, error: 'Ação inválida. Use "salvar" ou "apagar".' };
+            }
+
             // ── MCP: o serviço pela API dele, antes do mouse (lib/mcp.js) ──
             case 'mcp_procurar':
                 return require('./mcp.js').procurar(args.busca || args.query || args.servico || '');
@@ -846,6 +862,9 @@ async function despachar(name, args, ctx) {
                 // A transcrição precisa do servidor (a chave é dele), então o
                 // contexto do pedido atravessa até aqui.
                 return estudio.ferramentaVideo(args, ctx);
+            case 'editor_pro':
+                // A edição completa de vídeo FALADO: o motor do EDIT IA PRO (lib/editor-pro.js, editor/).
+                return require('./editor-pro.js').ferramenta(args, ctx);
             case 'estudio_render':
                 // A pasta de trabalho vai junto: a composição do Hyperframes que a IA escreveu mora nela.
                 return estudio.ferramentaRender({ ...args, __pasta: projectDir }, {
@@ -978,7 +997,7 @@ async function uninstall() {
 }
 
 module.exports = {
-    fmtBytes, treeDir, runShell, ambienteLimpo, openInBrowser, runInNewTerminal,
+    fmtBytes, treeDir, runShell, ambienteLimpo, permitidasNoShell, openInBrowser, runInNewTerminal,
     execute, uninstall, resolveInProject, globToRegex, globFiles, grepFiles, editFile,
     multiEdit, writeTodos, getTodos,
     liberarLeitura, pastasDeConsulta, esquecerConsultas, resolverParaLer,

package/lib/ui.js

@@ -552,12 +552,12 @@ const ROTULOS = {
            legítimo — e só a linha de baixo revelava que tinha falhado. */
         planejar_producao:'Diretor', estudio_projeto:'Estúdio·projeto',
         estudio_plano:'Estúdio·plano', estudio_narrar:'Estúdio·narração',
-        estudio_video:'Estúdio·vídeo', estudio_render:'Estúdio·render',
+        estudio_video:'Estúdio·vídeo', estudio_render:'Estúdio·render', editor_pro:'Editor·vídeo',
         estudio_site:'Estúdio·marca',
         desktop_windows:'Desktop·janelas', desktop_focus:'Desktop·foco',
         desktop_elements:'Desktop·elementos', desktop_click_element:'Desktop·click',
     estudio_midia:'Estúdio·mídia', estudio_ae:'Estúdio·After Effects', estudio_motion:'Estúdio·Motion', estudio_editar:'Estúdio·Editar', construir_app:'Construir',
-    remember_general:'Lembrar',
+    remember_general:'Lembrar', lembrar:'Memória',
     mcp_procurar:'MCP·procurar', mcp_conectar:'MCP·conectar', mcp_usar:'MCP',
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primocode",
-  "version": "10.15.2",
+  "version": "10.17.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": {
@@ -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/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"
+    "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 && node test/app-chat-cli.test.js && node test/app-chat-ponte.test.js && node test/gosto-motion.test.js && node test/desktop-vivo.test.js && node test/desktop-chat.test.js && node test/desktop-voz.test.js && node test/desktop-painel-dados.test.js && node test/titulo-conversa.test.js && node test/memoria-usuario.test.js && node test/landing-instalar.test.js && node test/foto-na-cena.test.js && node test/protecao.test.js && node test/entrega.test.js && node test/chamada-torta.test.js && node test/passagem.test.js && node test/editor-pro.test.js && node test/gosto-app.test.js && node test/guarda-layout.test.js && node test/acabamento.test.js"
   },
   "engines": {
     "node": ">=18.17.0"
@@ -31,6 +31,7 @@
     "lib/",
     "studio/",
     "skills/",
+    "editor/",
     "voz/",
     "LICENSES/",
     "README.md",

package/skills/editar-meu-video/SKILL.md

@@ -1,9 +1,13 @@
 ---
 nome: Editar o vídeo gravado
-descricao: como tratar uma gravação do usuário sem estragar o ritmo dela
-quando: gravei, gravação, gravacao, meu vídeo, meu video, editar, edição, edicao, corte, legenda, legendas, b-roll, broll
+descricao: operações soltas numa gravação (importar, cortar silêncio, recortar a pessoa) — a edição completa é a skill editar-video
+quando: cortar silêncio, cortar silencio, recortar a pessoa, trocar o fundo, b-roll, broll, importar a gravação
 autor: PrimoCode
 ---
+A EDIÇÃO COMPLETA de um vídeo falado (corte, legenda animada, gancho, peças,
+sons, trilha) é do `editor_pro` — carregue a skill `editar-video`. Esta aqui é
+para as operações soltas no Estúdio.
+
 O vídeo é da pessoa. Ela apareceu, falou e errou — o seu trabalho é tirar o
 que atrapalha, não refazer o que ela fez.
 

package/skills/editar-video/SKILL.md

@@ -0,0 +1,113 @@
+---
+nome: Editar vídeo falado (motor EDIT IA PRO)
+descricao: a edição completa da gravação da pessoa falando — corte, voz, legenda, gancho, peças, b-roll, sons, trilha e portão
+quando: edita meu vídeo, editar meu vídeo, edite esse vídeo, editar o vídeo, edição do vídeo, edicao do video, reels, tiktok, shorts, criativo, legenda e efeitos, legendas, gancho, cortar os respiros, tirar os erros, melhor tomada, vídeo falado, gravei, gravação, gravacao, vsl, anúncio
+autor: PrimoCode (adaptada do EDIT IA PRO, SHK Soluções Digitais, com autorização)
+---
+Você é o editor e o diretor. O motor (ferramenta `editor_pro`, ou
+`primocode editor <acao> --json '{...}'` pelo run_shell) mede e faz o
+trabalho pesado; você decide o que aparece em cada momento e por quê.
+
+## Como falar com a pessoa
+
+- Português simples, frases curtas. Nada de JSON, comando ou caminho comprido
+  na conversa: "estou ouvindo as tomadas", "tirei os respiros".
+- Tempos no formato 00:12. Antes de passo demorado (transcrição, render),
+  diga mais ou menos quanto leva.
+- No máximo UMA pergunta, e só se não der para deduzir ("é anúncio, Reels ou
+  aula?"). O resto tem padrão; conte as suposições numa frase no fim.
+
+## Princípios
+
+1. **A fala gravada manda.** Tudo entra no tempo da palavra que chama (pode
+   antecipar até 0,15 s). Tempo vem da fala que o `cortar` devolve, nunca
+   de estimativa.
+2. **Fidelidade.** Número, nome, prova e oferta só se a pessoa disse. Faltou
+   material: diga o que falta, não invente.
+3. **Respiro é erro.** O corte já tira silêncio de 0,25 s ou mais e fica com a
+   última tomada inteira de cada frase.
+4. **Uma ideia por vez na tela; rosto livre.** Nada sobre olhos e boca.
+   Alguma coisa muda a cada 2 a 4 s.
+5. **Só entrega com o portão PASSOU.** Reprovou: conserte o plano e monte de
+   novo. Nunca mostre um vídeo reprovado.
+
+## O caminho
+
+1. `editor_pro acao:"cortar" video:"<arquivo>" prompt:"nomes, de, marca"`.
+   Na primeira vez ele baixa os arquivos do editor e cria o Python dele
+   (avise: alguns minutos). Volta `pasta`, `duracao`, `volume` e `fala`: as
+   frases do corte com o tempo (`3.42-5.10 texto`). O original nunca é tocado.
+2. **Leia a fala e escreva o plano.** Divida por ideia e decida o que entra
+   em cada bloco (tabela "que peça para cada fala", abaixo).
+3. `editor_pro acao:"montar" pasta:"<pasta>" plano:{...} trilha:"auto"`.
+   Ele cria o projeto, põe a câmera viva, os sons casados com cada animação,
+   renderiza, mixa a trilha com ducking e roda o portão. Volta `video`
+   (`<pasta>/final.mp4`), `quadros` (6 PNGs), `audio` e `portao`.
+4. **Olhe os quadros** (read_file nos PNGs) antes de entregar. Algo feio
+   (texto cortado, peça no rosto, b-roll sem nada a ver): mude o plano e
+   monte de novo.
+5. Entregue com uma nota curta: onde está o vídeo, o que foi feito, o que
+   faltou. Atalho sem plano: `acao:"editar"` (o plano automático põe um
+   gancho e as peças que a fala pede).
+
+## O plano
+
+```json
+{"gancho": "O que é *IA*",
+ "pecas": [
+  {"id": "def", "tipo": "lettering", "principal": "Máquinas *aprendem*", "apoio": "e decidem", "em": 6.9, "sai": 10.6, "posicao": "topo"},
+  {"id": "passos", "tipo": "passo_a_passo", "depois_de": 12.3, "sai": 23.1,
+   "passos": [{"texto": "Recebe exemplos", "em": 12.6}, {"texto": "Ajusta parâmetros", "em": 16.9}]},
+  {"id": "lista", "tipo": "lista_check", "titulo": "Tudo isso é *IA*", "marca": "check", "depois_de": 31, "sai": 35,
+   "itens": [{"texto": "Assistentes", "em": 31.05}, {"texto": "Carros sozinhos", "em": 32.9}]}],
+ "broll": [{"busca": "self-driving car", "de": 26.1, "ate": 28.4, "rotulo": "Carro *autônomo*"}]}
+```
+
+- `gancho`: até 4 palavras fortes da primeira frase; `*palavra*` sai em
+  destaque. `false` desliga.
+- `pecas`: as do catálogo. `em`, `sai`, `depois_de` em segundos do corte.
+- `broll`: imagem livre (Wikimedia, CC0) buscada pelo que a pessoa DISSE
+  naquele instante (busca em inglês acha mais), 1,5 a 3 s, com `rotulo`
+  curto. `"modo": "tela_verde"` recorta a pessoa na frente da imagem.
+- Opcionais: `estilo` (`laranja` padrão, `papelaria`, `noite`), `legenda`
+  (`padrao` | `discreta`), `correcoes` (`{"palavra errada": "certa"}` quando a
+  transcrição errou um nome), `blocos` (enquadramento à mão), `trilha_abaixo`
+  (dB da trilha abaixo da voz, 20), `sons: false`, `camera_viva: false`.
+- `trilha`: `"auto"` (busca uma faixa com energia), o caminho de um áudio da
+  pessoa, ou `"nenhuma"`.
+
+## Que peça para cada fala
+
+| a fala | a peça |
+|---|---|
+| uma expressão que muda o sentido | `lettering` (`principal`, `apoio`) |
+| enumera ("espaço, estoque, frete") | `lista_check` (`marca` check ou x), cada item na sua palavra, até 22 letras |
+| etapas em ordem | `passo_a_passo` |
+| um número que importa | `contador` (`valor_final`, `sufixo`, `rotulo`) |
+| nome de uma coisa a fixar | `rotulo` (em cima da cabeça) |
+| afirmação curta que fecha a ideia | `carimbo` (1 ou 2 palavras) |
+| cita algo concreto que se pode mostrar | `broll` |
+
+Peça grande (lista, passos) ganha moldura sozinha. Lettering com mais de 6
+palavras é erro. Campos de cada peça: `<editor>/references/animacao-catalogo.md`;
+enquadramento: `references/enquadramento.md`; sons e trilha:
+`references/som-e-trilha.md` (`<editor>` é a pasta que o `preparar` devolve).
+
+## O som
+
+O motor mede a voz de cada trecho e acerta o ganho antes do volume final:
+gravação baixa (-38 LUFS) sai em -14 LUFS, pico até -1 dBTP, 48 kHz, sem o
+modo dinâmico que bombeia a voz. A limpeza de ruído é leve por padrão
+(`limpar: "forte"` no cortar, `false` desliga). O portão reprova volume fora,
+modo dinâmico, amostra clipada, respiro, quadro preto e texto fora da zona
+segura do Reels.
+
+## Quando algo dá errado
+
+- Erro de um passo: a mensagem diz qual e por quê (em português). Corrija a
+  entrada e tente de novo; não repita o mesmo pedido esperando outro
+  resultado.
+- Palavra errada na legenda: `correcoes` no plano, ou `prompt` no cortar.
+- A mesma correção falhou duas vezes: pare e conte à pessoa o que testou.
+- Operação solta (só cortar um trecho, juntar, exportar): é o editor por
+  linha do tempo (`primocode video help`), não este.

package/studio/pessoa.py

@@ -175,6 +175,42 @@ def recortar(entrada, saida, suavizar=7, encolher=2, limiar=0.6):
             "largura": largura, "altura": altura, "fps": round(fps, 2)}
 
 
+def recortar_foto(entrada, saida, suavizar=7, encolher=2, limiar=0.6, minimo=0.08):
+    """Recorta a pessoa de UMA FOTO e grava um PNG com alfa (foto na cena do motion).
+
+    Se a pessoa ocupa menos de `minimo` do quadro (ou não há pessoa), devolve
+    semPessoa: quem chamou usa a foto inteira com moldura arredondada.
+    """
+    import cv2
+    import numpy as np
+    import mediapipe as mp
+
+    quadro = cv2.imread(entrada, cv2.IMREAD_COLOR)
+    if quadro is None:
+        return {"ok": False, "error": f"não consegui abrir a foto {entrada}"}
+    segmentador = mp.solutions.selfie_segmentation.SelfieSegmentation(model_selection=0)
+    try:
+        resultado = segmentador.process(cv2.cvtColor(quadro, cv2.COLOR_BGR2RGB))
+    finally:
+        segmentador.close()
+    mascara = (resultado.segmentation_mask > limiar).astype(np.uint8) * 255
+    cobertura = float((mascara > 0).mean())
+    if cobertura < minimo:
+        return {"ok": False, "semPessoa": True, "cobertura": round(cobertura, 3),
+                "error": "não achei uma pessoa nesta foto."}
+    if encolher > 0:
+        mascara = cv2.erode(mascara, np.ones((3, 3), np.uint8), iterations=int(encolher))
+    if suavizar > 0:
+        k = int(suavizar) | 1
+        mascara = cv2.GaussianBlur(mascara, (k, k), 0)
+    bgra = cv2.cvtColor(quadro, cv2.COLOR_BGR2BGRA)
+    bgra[:, :, 3] = mascara
+    if not cv2.imwrite(saida, bgra):
+        return {"ok": False, "error": f"não consegui gravar o recorte em {saida}"}
+    return {"ok": True, "arquivo": saida, "cobertura": round(cobertura, 3),
+            "largura": int(quadro.shape[1]), "altura": int(quadro.shape[0])}
+
+
 def main():
     p = argparse.ArgumentParser(description="Recorte de pessoa do PrimoCode Studio")
     sub = p.add_subparsers(dest="comando", required=True)
@@ -185,10 +221,26 @@ def main():
     r.add_argument("--suavizar", type=int, default=7)
     r.add_argument("--encolher", type=int, default=2)
     r.add_argument("--limiar", type=float, default=0.6)
+    f = sub.add_parser("recortar-foto")
+    f.add_argument("--entrada", required=True)
+    f.add_argument("--saida", required=True)
+    f.add_argument("--suavizar", type=int, default=7)
+    f.add_argument("--encolher", type=int, default=2)
+    f.add_argument("--limiar", type=float, default=0.6)
     args = p.parse_args()
 
     falta = faltando()
 
+    if args.comando == "recortar-foto":
+        # Dentro do motion não se instala nada (o MediaPipe passa de 100 MB): sem ele, a foto vai inteira, com moldura.
+        if falta:
+            saida = {"ok": False, "semMediaPipe": True, "falta": falta,
+                     "error": "o recorte de pessoa precisa de " + ", ".join(falta) + " (a foto segue inteira, com moldura)."}
+        else:
+            saida = recortar_foto(args.entrada, args.saida, args.suavizar, args.encolher, args.limiar)
+        print(json.dumps(saida, ensure_ascii=False))
+        sys.exit(0 if saida.get("ok") else 1)
+
     if args.comando == "conferir":
         saida = {"ok": not falta, "falta": falta,
                  "comoResolver": (f"{sys.executable} -m pip install --user " + " ".join(falta)