primocode 10.13.0 → 10.14.1

package/lib/preparar.js

@@ -0,0 +1,111 @@
+/**
+ * preparar.js — deixa o PrimoCode pronto logo depois do `npm i -g primocode`, e mostra o que falta.
+ *
+ *   node lib/preparar.js            → postinstall: dispara o download do EffectCraft em segundo plano. NUNCA falha a instalação.
+ *   primocode preparar              → baixa o EffectCraft agora e mostra o resultado.
+ *   primocode doutor                → o diagnóstico de sempre + o que o Estúdio precisa (estudioLinhas).
+ */
+
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawn, spawnSync } = require('child_process');
+
+const sem = () => process.env.PRIMOCODE_SEM_POSINSTALL === '1' || process.env.CI === 'true';
+
+/** Roda no postinstall: rápido, sem rede no processo principal, sem erro. */
+function posinstalar() {
+    try {
+        if (sem()) return;
+        const ec = require('./estudio/effectcraft.js');
+        if (!ec.asset()) return;
+        const filho = spawn(process.execPath, [__filename, '--fundo'], { detached: true, stdio: 'ignore', windowsHide: true });
+        filho.on('error', () => {});
+        filho.unref();
+        console.log('PrimoCode instalado. Baixando o motor After Effects (EffectCraft) em segundo plano; rode `primocode doutor` para conferir o que falta.');
+    } catch { /* instalação nunca falha por causa disto */ }
+}
+
+async function baixarEffectCraft() {
+    const ec = require('./estudio/effectcraft.js');
+    try { return await Promise.race([ec.garantir(), new Promise((r) => setTimeout(() => r({ ok: false, error: 'demorou demais (10 min)' }), 600000))]); }
+    catch (e) { return { ok: false, error: e.message }; }
+}
+
+function achar(nome) {
+    try { const r = spawnSync(process.platform === 'win32' ? 'where' : 'which', [nome], { encoding: 'utf8', timeout: 5000 }); return r.status === 0 ? r.stdout.split('\n')[0].trim() : null; } catch { return null; }
+}
+
+/** As linhas do `doutor` que dizem respeito ao Estúdio e aos recursos novos. Cada ✗ traz como resolver. */
+function estudioLinhas(dep = {}) {
+    const linhas = [];
+    const poe = (ok, item, detalhe, conserto) => linhas.push({ ok, item, detalhe, conserto: ok === false ? conserto : undefined });
+    const tenta = (fn, padrao) => { try { return fn(); } catch { return padrao; } };
+
+    // EffectCraft (motor After Effects)
+    const ec = tenta(() => require('./estudio/effectcraft.js'));
+    if (ec) {
+        const bin = process.env.PRIMOCODE_EFFECTCRAFT_BIN || path.join(os.homedir(), '.primocode', 'bin', 'effectcraft-' + ec.VERSAO);
+        const tem = fs.existsSync(bin) && (fs.statSync(bin).isFile() || fs.readdirSync(bin).length > 0);
+        poe(ec.asset() ? tem : null, 'EffectCraft', tem ? `v${ec.VERSAO} instalado` : (ec.asset() ? 'ainda não baixado' : 'sem binário para este sistema'),
+            'rode: primocode preparar   (baixa uns 100 MB; precisa de internet)');
+    }
+    // ffmpeg / ffprobe
+    const ff = tenta(() => require('./estudio/video.js').ffmpeg(), null) || achar('ffmpeg');
+    poe(!!ff, 'ffmpeg', ff || 'não encontrado', { darwin: 'brew install ffmpeg', linux: 'sudo apt install ffmpeg', win32: 'winget install Gyan.FFmpeg' }[process.platform] || 'instale o ffmpeg');
+    // whisper (tempo de cada palavra na legenda)
+    const wbin = process.env.PRIMOCODE_WHISPER_BIN || '/opt/homebrew/bin/whisper-cli';
+    const w = fs.existsSync(wbin) ? wbin : achar('whisper-cli');
+    poe(w ? true : null, 'whisper', w || 'não instalado — a legenda usa o tempo estimado, sem medir cada palavra', undefined);
+    if (!w) linhas[linhas.length - 1].conserto = 'opcional: brew install whisper-cpp';
+    // fontes (cache do Google Fonts)
+    const cache = tenta(() => require('./estudio/glifos.js').CACHE, null);
+    const nFontes = cache && fs.existsSync(cache) ? fs.readdirSync(cache).filter((f) => /\.(ttf|otf)$/i.test(f)).length : 0;
+    poe(null, 'Fontes', nFontes ? `${nFontes} em cache` : 'baixam sozinhas no primeiro vídeo (precisa de internet)');
+    // sandbox
+    const sb = tenta(() => require('./sandbox.js').estado(), null);
+    if (sb) poe(null, 'Sandbox', sb.ativo ? `ligado (${sb.mecanismo})` : (sb.mecanismo ? `desligado — ${sb.mecanismo} disponível; /sandbox on liga` : 'sem mecanismo neste sistema (comandos rodam sem isolamento)'));
+    // 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>');
+    // MCP
+    const mcp = tenta(() => Object.keys(require('./mcp.js').servidores()), []);
+    poe(null, 'MCP', mcp.length ? mcp.join(', ') : 'nenhum servidor');
+    // plano
+    const eu = tenta(() => require('./conta.js').atual(), null);
+    poe(eu ? true : false, 'Plano', eu ? `${eu.plano}${eu.pro ? ' (pago)' : ''} · ${eu.email || ''}` : 'sem login', 'entre com /login (ou `primocode`, no primeiro uso)');
+    return linhas;
+}
+
+function imprimir(linhas, log = console.log) {
+    for (const l of linhas) {
+        log(`  ${l.ok === true ? '✓' : l.ok === false ? '✗' : '·'} ${String(l.item).padEnd(18)}${l.detalhe || ''}`);
+        if (l.conserto) log(`    → ${l.conserto}`);
+    }
+    const ruins = linhas.filter((l) => l.ok === false).length;
+    log(ruins ? `\n  ${ruins} ${ruins === 1 ? 'coisa para arrumar' : 'coisas para arrumar'}.` : '\n  Tudo certo.');
+    return ruins;
+}
+
+async function main(args = []) {
+    const cmd = args[0];
+    if (cmd === 'preparar') {
+        console.log('Baixando o EffectCraft…');
+        const r = await baixarEffectCraft();
+        console.log(r.ok ? '✓ EffectCraft pronto: ' + r.bin : '✗ ' + r.error);
+        return r.ok ? 0 : 1;
+    }
+    const extra = require('./comandos-extra.js'), cfg = require('./config.js');
+    console.log('');
+    const base = await extra.diagnosticar({ raiz: cfg.ROOT_DIR, arquivoConfig: cfg.CONFIG_FILE, acharChrome: () => require('./browser').findChrome(), prazoServidor: 8000 });
+    return imprimir(base.concat(estudioLinhas())) ? 1 : 0;
+}
+
+module.exports = { posinstalar, baixarEffectCraft, estudioLinhas, imprimir, main };
+
+if (require.main === module) {
+    if (process.argv[2] === '--fundo') baixarEffectCraft().then(() => process.exit(0), () => process.exit(0));
+    else posinstalar();
+}

package/lib/retomar.js

@@ -0,0 +1,55 @@
+'use strict';
+// --resume [id] e --worktree <nome>: flags puras + git worktree. Sem tela, testável.
+const { spawnSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+/* Tira --resume/--worktree do argv. `--resume` sem id (ou seguido de outra flag/pedido
+   entre aspas não é adivinhado): só consome o próximo se parecer um id (sem espaço, sem '-'). */
+function analisar(argv) {
+    const out = { resume: null, worktree: null, erro: null, args: [] };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--resume' || a.startsWith('--resume=')) {
+            let id = a.includes('=') ? a.slice(a.indexOf('=') + 1) : '';
+            if (!id && argv[i + 1] && /^[\w.:-]+$/.test(argv[i + 1]) && !argv[i + 1].startsWith('-')
+                && /\d/.test(argv[i + 1])) id = argv[++i];
+            out.resume = id || true;
+        } else if (a === '--worktree' || a.startsWith('--worktree=')) {
+            let n = a.includes('=') ? a.slice(a.indexOf('=') + 1) : argv[i + 1];
+            if (!a.includes('=')) i++;
+            if (!n || n.startsWith('-')) { out.erro = 'Uso: primocode --worktree <nome>'; if (n) i--; } else out.worktree = n;
+        } else out.args.push(a);
+    }
+    return out;
+}
+
+function nomeValido(n) { return /^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(n || ''); }
+
+function git(cwd, args) {
+    const r = spawnSync('git', args, { cwd, encoding: 'utf-8' });
+    return { ok: r.status === 0, out: (r.stdout || '').trim(), err: (r.stderr || '').trim() };
+}
+
+/* Cria ../<repo>-<nome> numa branch nova <nome>. Recusa fora de repo git. */
+function criarWorktree(nome, cwd) {
+    if (!nomeValido(nome)) return { ok: false, error: 'Nome inválido: use letras, números, ponto, hífen ou _.' };
+    const topo = git(cwd, ['rev-parse', '--show-toplevel']);
+    if (!topo.ok || !topo.out) return { ok: false, error: 'Worktree só funciona dentro de um repositório git.' };
+    const raiz = topo.out;
+    const destino = path.join(path.dirname(raiz), `${path.basename(raiz)}-${nome}`);
+    if (fs.existsSync(destino)) return { ok: false, error: `A pasta ${destino} já existe.` };
+    const r = git(raiz, ['worktree', 'add', '-b', nome, destino]);
+    if (!r.ok) return { ok: false, error: `git worktree falhou: ${r.err.split('\n')[0]}` };
+    return { ok: true, path: fs.realpathSync(destino), branch: nome };
+}
+
+/* Escolhe uma conversa da lista por número (1..n) ou por id (inteiro ou prefixo). */
+function escolher(conversas, ref) {
+    const r = String(ref || '').trim();
+    if (!r) return null;
+    if (/^\d{1,3}$/.test(r) && conversas[Number(r) - 1]) return conversas[Number(r) - 1];
+    return conversas.find((x) => String(x.id) === r) || conversas.find((x) => String(x.id).startsWith(r)) || null;
+}
+
+module.exports = { analisar, criarWorktree, escolher, nomeValido };

package/lib/sandbox.js

@@ -0,0 +1,197 @@
+/**
+ * sandbox.js — a cerca em volta do run_shell.
+ *
+ * Decisão do Joel (08/10, JOEL-FEAT-002): isolamento NATIVO, leve, sem VM.
+ *   macOS  → sandbox-exec (Seatbelt) com um perfil gerado na hora
+ *   Linux  → bubblewrap (bwrap), se existir
+ *   Windows/sem mecanismo → best_effort (avisa uma vez e segue) ou
+ *                           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.
+ * 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"],
+ *                "escrita_extra": ["~/.npm"] }
+ */
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+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 SECRETA = /(_KEY|_TOKEN|SECRET)/i;
+
+let _avisou = false;
+let _forcaMecanismo; // teste: undefined = detectar; null = ausente; 'seatbelt'|'bwrap'
+
+function arquivoConfig(home) { return path.join(home || os.homedir(), '.primocode', 'config.json'); }
+
+function lerConfig(home) {
+    try { return JSON.parse(fs.readFileSync(arquivoConfig(home), 'utf8')) || {}; } catch { return {}; }
+}
+
+function config(home) {
+    const s = lerConfig(home).sandbox || {};
+    return {
+        ligado: typeof s.ligado === 'boolean' ? s.ligado : process.platform === 'darwin',
+        modo: MODOS.includes(s.modo) ? s.modo : 'best_effort',
+        rede: s.rede !== false,
+        env_permitidas: Array.isArray(s.env_permitidas) ? s.env_permitidas.map(String) : [],
+        escrita_extra: Array.isArray(s.escrita_extra) ? s.escrita_extra.map(String) : [],
+    };
+}
+
+function salvar(parcial, home) {
+    const arq = arquivoConfig(home);
+    const atual = lerConfig(home);
+    atual.sandbox = { ...(atual.sandbox || {}), ...parcial };
+    fs.mkdirSync(path.dirname(arq), { recursive: true });
+    fs.writeFileSync(arq, JSON.stringify(atual, null, 2));
+    return config(home);
+}
+
+function temBinario(nome) {
+    try { return spawnSync(nome, ['--version'], { stdio: 'ignore', timeout: 3000 }).error === undefined; } catch { return false; }
+}
+
+function mecanismo() {
+    if (_forcaMecanismo !== undefined) return _forcaMecanismo;
+    if (process.platform === 'darwin') return fs.existsSync('/usr/bin/sandbox-exec') ? 'seatbelt' : null;
+    if (process.platform === 'linux') return temBinario('bwrap') ? 'bwrap' : null;
+    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, '\\"') + '"';
+
+function caminhos(projectDir, cfg, home) {
+    const escrita = [real(projectDir), '/tmp', real('/tmp'), real(os.tmpdir()), path.join(home, '.primocode', 'cache'),
+        ...cfg.escrita_extra.map((p) => expandir(p, home))];
+    try { fs.mkdirSync(path.join(home, '.primocode', 'cache'), { recursive: true }); } catch { /* sem cache, sem drama */ }
+    const negadosLeitura = LEITURA_NEGADA_HOME.map((p) => path.join(home, p));
+    return { escrita: [...new Set(escrita.map((p) => real(p)))], negadosLeitura };
+}
+
+/** Perfil Seatbelt. Em Seatbelt a ÚLTIMA regra que casa vence: negações no fim. */
+function perfilSeatbelt(projectDir, cfg = config(), home = os.homedir()) {
+    const { escrita, negadosLeitura } = caminhos(projectDir, cfg, home);
+    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/"))');
+    for (const p of negadosLeitura) l.push(`(deny file-read* (subpath ${sbq(real(p))}) (subpath ${sbq(p)}))`);
+    l.push('(deny file-read* (regex #"/\\.env($|\\.[^/]*$)"))');
+    if (!cfg.rede) l.push('(deny network*)');
+    return l.join('\n');
+}
+
+function argsBwrap(projectDir, cfg = config(), home = os.homedir()) {
+    const { escrita, negadosLeitura } = caminhos(projectDir, cfg, home);
+    const a = ['--ro-bind', '/', '/', '--dev', '/dev', '--proc', '/proc'];
+    for (const p of escrita) if (fs.existsSync(p)) a.push('--bind', p, p);
+    for (const p of negadosLeitura) {
+        if (!fs.existsSync(p)) continue;
+        if (fs.statSync(p).isDirectory()) a.push('--tmpfs', p); else a.push('--ro-bind', '/dev/null', p);
+    }
+    // .env* na pasta do projeto (um nível; o resto o Seatbelt cobre por regex)
+    try {
+        for (const f of fs.readdirSync(projectDir)) {
+            if (/^\.env($|\.)/.test(f)) a.push('--ro-bind', '/dev/null', path.join(real(projectDir), f));
+        }
+    } catch { /* pasta sumiu */ }
+    if (!cfg.rede) a.push('--unshare-net');
+    a.push('--die-with-parent', '--chdir', real(projectDir));
+    return a;
+}
+
+/** Decide como envolver o comando. Devolve { cmd, args } ou { recusado } ou { semCerca }. */
+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' };
+    const mec = mecanismo();
+    if (!mec) {
+        if (cfg.modo === 'hard_requirement') {
+            return { recusado: 'o sandbox está em hard_requirement e este computador não tem como isolar (macOS: sandbox-exec; Linux: bwrap). Comando não rodou. Instale o bwrap ou use /sandbox off.' };
+        }
+        let aviso = null;
+        if (!_avisou) { _avisou = true; aviso = 'aviso: sem sandbox neste computador (modo best_effort); o comando roda sem isolamento.'; }
+        return { semCerca: true, motivo: 'sem_mecanismo', aviso };
+    }
+    if (mec === 'seatbelt') return { cmd: '/usr/bin/sandbox-exec', args: ['-p', perfilSeatbelt(projectDir, cfg, home), '/bin/sh', '-c', command], mec, cfg, home };
+    return { cmd: 'bwrap', args: [...argsBwrap(projectDir, cfg, home), '/bin/sh', '-c', command], mec, cfg, home };
+}
+
+/** 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)
+        || /(?: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 (/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.`;
+    }
+    return null;
+}
+
+function filtrarEnv(env, permitidas) {
+    const out = {};
+    for (const [k, v] of Object.entries(env)) {
+        if (v === undefined) continue;
+        if (SECRETA.test(k) && !permitidas.includes(k)) continue;
+        out[k] = v;
+    }
+    return out;
+}
+
+/** Roda o comando dentro da cerca. Mesmo formato do runShell: { ok, code, stdout, stderr }. */
+function executar(command, { projectDir, timeout = 60000, env = process.env, home } = {}) {
+    const cwd = projectDir || process.cwd();
+    const cfg = config(home);
+    const env2 = filtrarEnv(env, cfg.env_permitidas);
+    // `home` só escolhe de onde lê a config; as pastas protegidas são sempre as do ~ de verdade.
+    const e = envolver(command, cwd, { cfg });
+    return new Promise((resolve) => {
+        if (e.recusado) return resolve({ ok: false, code: 126, stdout: '', stderr: e.recusado, sandbox: { recusado: true } });
+        const termina = (error, stdout, stderr) => {
+            let err = stderr || '';
+            const info = { mecanismo: e.mec || null };
+            if (e.aviso) err = e.aviso + '\n' + err;
+            if (error && e.mec) {
+                const why = explicar(err, cwd, cfg, e.home);
+                if (why) { err = err + '\n[sandbox] ' + why; info.bloqueou = why; }
+            }
+            const r = error ? { ok: false, code: error.code ?? 1, stdout, stderr: err, killed: error.killed } : { ok: true, code: 0, stdout, stderr: err };
+            r.sandbox = info;
+            resolve(r);
+        };
+        const opt = { timeout, cwd, maxBuffer: 10 * 1024 * 1024, env: env2 };
+        if (e.semCerca) return require('child_process').exec(command, opt, termina);
+        execFile(e.cmd, e.args, opt, termina);
+    });
+}
+
+function estado(home) {
+    const cfg = config(home);
+    const mec = mecanismo();
+    return { ...cfg, mecanismo: mec, ativo: cfg.ligado && !!mec };
+}
+
+function _teste({ mecanismo: m, avisou } = {}) {
+    if (m !== undefined) _forcaMecanismo = m === 'auto' ? undefined : m;
+    if (avisou !== undefined) _avisou = avisou;
+}
+
+module.exports = { config, salvar, estado, mecanismo, envolver, executar, explicar, filtrarEnv, perfilSeatbelt, argsBwrap, MODOS, _teste };

package/lib/skills.js

@@ -377,7 +377,9 @@ function pontuar(skill, texto) {
         // A borda e escrita a mao em vez de `\b`: o gatilho pode comecar ou
         // terminar em simbolo ("e-mail"), e ali o `\b` nao vale.
         const re = new RegExp('(^|[^a-z0-9])' + escapado + '($|[^a-z0-9])');
-        if (re.test(t)) pontos++;
+        // Gatilho de várias palavras é mais específico ("render do vídeo" vale mais que "vídeo"):
+        // sem isso uma skill genérica e grande empata e come o teto da específica.
+        if (re.test(t)) pontos += p.split(/\s+/).length;
     }
     return pontos;
 }

package/lib/tools.js

@@ -13,6 +13,7 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 const { exec, execFile } = require('child_process');
+const sandbox = require('./sandbox.js');
 const browser = require('./browser');
 const desktop = require('./desktop');
 const cursor = require('./cursor');
@@ -278,11 +279,11 @@ const NOME_SECRETO = /(TOKEN|SECRET|KEY|PASSWORD|PASSWD|CREDENTIAL|AUTH|COOKIE|S
 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']);
 
-function ambienteLimpo(env = process.env) {
+function ambienteLimpo(env = process.env, permitidas = []) {
     const limpo = {};
     for (const [nome, valor] of Object.entries(env)) {
         if (valor === undefined) continue;
-        if (!SEMPRE_PASSA.has(nome) && (NOME_SECRETO.test(nome) || PREFIXO_SECRETO.test(nome))) continue;
+        if (!SEMPRE_PASSA.has(nome) && !permitidas.includes(nome) && (NOME_SECRETO.test(nome) || PREFIXO_SECRETO.test(nome))) continue;
         limpo[nome] = valor;
     }
     return limpo;
@@ -664,7 +665,9 @@ async function despachar(name, args, ctx) {
                 return b.outra && r && r.ok !== false ? { ...r, pasta: b.raiz } : r;
             }
             case 'run_shell':
-                return runShell(args.command, args.timeout_ms || 60000, projectDir, ambienteLimpo());
+                // 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) });
             case 'run_in_new_terminal':
                 return runInNewTerminal(args.command, args.cwd || projectDir);
             case 'open_in_browser': {
@@ -830,6 +833,12 @@ async function despachar(name, args, ctx) {
                 return estudio.ferramentaPlano({ ...args, __pasta: projectDir });
             case 'estudio_midia':
                 return estudio.ferramentaMidia(args);
+            case 'estudio_ae':
+                return estudio.ferramentaAE(args);
+            case 'estudio_motion':
+                return estudio.ferramentaMotion(args);
+            case 'estudio_editar':
+                return estudio.ferramentaEditar(args);
             case 'estudio_narrar':
                 return estudio.ferramentaNarrar(args);
             case 'estudio_video':
@@ -937,7 +946,7 @@ async function despachar(name, args, ctx) {
                         parecidas: catalogo.parecidasCom(name),
                         comoResolver: velhoEstudio
                             ? 'O Estúdio foi TROCADO: studio_* não existe mais. As ferramentas de hoje são '
-                              + 'planejar_producao, estudio_projeto, estudio_plano, estudio_midia, estudio_narrar, '
+                              + 'planejar_producao, estudio_projeto, estudio_plano, estudio_midia, estudio_ae, estudio_motion, estudio_editar, estudio_narrar, '
                               + 'estudio_video, estudio_render e estudio_site. Use-as. '
                               + 'Se ELAS não estiverem na sua lista de ferramentas, o servidor está desatualizado: '
                               + 'PARE de tentar outros nomes e diga isso ao usuário em uma frase — é o que ele '

package/lib/ui.js

@@ -556,7 +556,7 @@ const ROTULOS = {
         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', construir_app:'Construir',
+    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',
     mcp_procurar:'MCP·procurar', mcp_conectar:'MCP·conectar', mcp_usar:'MCP',
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primocode",
-  "version": "10.13.0",
+  "version": "10.14.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": {
@@ -8,7 +8,9 @@
   },
   "scripts": {
     "start": "node bin/primocode.js",
-    "test": "node test/tools.test.js && node test/ui.test.js && node test/entrada.test.js && node test/transparencia.test.js && node test/permissao.test.js && node test/compatibilidade.test.js && node test/skills.test.js && node test/skills-de-fora.test.js && node test/skills-novas.test.js && node test/comandos.test.js && node test/estudio.test.js && node test/voz.test.js && node test/modo.test.js && node test/pasta.test.js && node test/projeto.test.js && node test/nome-projeto.test.js && node test/api-propria.test.js && node test/claude-engine.test.js && node test/codex.test.js && node test/conferir.test.js && node test/catalogo.test.js && node test/desktop.test.js && node test/seta.test.js && node test/effort.test.js && node test/regressao.test.js && node test/memoria-conversa.test.js && node test/repeticao.test.js && node test/casar.test.js && node test/recado.test.js && node test/releitura.test.js && node test/snapshot.test.js && node test/video.test.js && node test/limpeza.test.js && node test/autonomia.test.js && node test/desfazer.test.js && node test/desfazer-git.test.js && node test/referencia.test.js && node test/parar.test.js && node test/continuar.test.js && node test/pipeline.test.js && node test/conta.test.mjs && node test/planos-tela.test.js && node test/nuvem.test.js && node test/prazo.test.js && node test/primeira-vez.test.js && node test/fala.test.js && node test/especialistas.test.js && node test/empurrao.test.js && node test/terminal-novo.test.js && node test/markdown.test.js && node test/coerencia.test.js && node test/contexto.test.js && node test/perigo.test.js && node test/rapidez.test.js && node test/mascotes.test.js && node test/comandos-extra.test.js && node test/offline.test.js && node test/edicao.test.js && node test/composicao.test.js && node test/acervo-site.test.js && node test/impacto.test.js && node test/cinema.test.js && node test/producao.test.js && node test/ende.test.js && node test/capa.test.js && node test/broll.test.js && node test/morfar.test.js && node test/motion.test.js && node test/motion-roteiro.test.js && node test/kit-motion.test.js && node test/gerativo.test.js && node test/gerativo-identidade.test.js && node test/gerativo-moldura.test.js && node test/gerativo-heroi.test.js && node test/gerativo-ambiente.test.js && node test/gerativo-variedade.test.js && node test/hibrido.test.js && node test/batida.test.js && node test/estudio-acervo.test.js && node test/estudio-diretor.test.js && node test/estudio-marca.test.js && node test/estudio-novo-projeto.test.js && node test/estudio-plano.test.js && node test/estudio-slides.test.js && node test/estudio-video.test.js && node test/revisor.test.js && node test/conferencia.test.js && node test/cor.test.js && node test/assinatura.test.js && node test/biblioteca.test.js && node test/mcp.test.js && node test/personas.test.js && node test/efeitos.test.js && node test/auto.test.js && node test/colar.test.js && node test/rolar.test.js && node test/orquestra.test.js && node test/shell-limpo.test.js && node test/editar-remotion.test.js && node test/variacao3d.test.js && node test/portao-skill.test.js && node test/clones.test.js && node test/kokoro.test.js && node test/fluido.test.js && node test/zoom.test.js && node test/personagem.test.js && node test/tela.test.js && node test/margem.test.js && node test/travado.test.js && node test/leitura.test.js && node test/producao-provedores.test.js && node test/broll-frase.test.js && node test/vazamento.test.js && node test/colecao.test.js && node test/mundo.test.js && node test/mcp-procurar.test.js && node test/selecao.test.js && node test/nome-curto.test.js && node test/agents-md.test.js && node test/outra-pasta.test.js && node test/estudio-sem-id.test.js && node test/estudio-objeto-do-site.test.js && node test/cenarios.test.js && node test/movimentos.test.js && node test/gerativo-so-fala.test.js && node test/estilos.test.js && node test/proporcao.test.js && node test/cena.test.js && node test/sem-narracao.test.js && node test/camadas.test.js && node test/gerativo-referencias.test.js && node test/voicestudio.test.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"
   },
   "engines": {
     "node": ">=18.17.0"

package/skills/after-effects/SKILL.md

@@ -0,0 +1,52 @@
+---
+nome: After Effects
+descricao: motion design em camadas, com keyframes, ease e expressões, renderizado pelo motor EffectCraft
+quando: after effects, ae, aftereffects, effectcraft, extendscript, jsx, keyframe, motion design
+autor: PrimoCode
+---
+Use a ferramenta `estudio_ae`: você escreve um JSX (ExtendScript do After Effects),
+o EffectCraft roda, renderiza `video-ae.mp4` e devolve quadros PNG em `ae/`.
+
+**Antes de escrever, procure um modelo:** `estudio_midia acao:"projetos"` e, na receita
+com `scripts_ae`, leia os `.jsx` do `caminho` (são projetos reais do Clube do Motion que
+montam as comps por script). Copie o MÉTODO (câmera, curvas, trocas de cena), não o conteúdo.
+
+## Regras
+
+- **Sempre com ease.** Keyframe linear parece máquina: ponha `KeyframeEase` em todo
+  movimento (`setTemporalEaseAtKey`).
+- **9:16 = 1080×1920** (16:9 = 1920×1080), fps 30. A duração da comp é a do vídeo.
+- **Fontes** vão em `fontes: [{familia, peso}]` (Google Fonts); o mesmo nome entra em `doc.font`.
+- **Confira os quadros**: passe `conferir: [0.5, 2]` e olhe os PNG antes de dar por pronto.
+  Texto cortado, sobreposto ou fora da área segura: ajuste o JSX e rode de novo.
+- Erro do script volta com o texto da saída. Corrija a linha, não reescreva tudo.
+- `comp` é o nome exato que você deu no `addComp`.
+
+## Match names que funcionam
+
+- `app.project.items.addComp(nome, w, h, 1, dur, fps)`
+- `comp.layers.addSolid([r,g,b], nome, w, h, 1)`, `addText("..")`, `addShape()`
+- Forma: `"ADBE Root Vectors Group".addProperty("ADBE Vector Group")`, depois
+  `"ADBE Vectors Group".addProperty("ADBE Vector Shape - Ellipse" | "ADBE Vector Graphic - Fill")`,
+  com `"ADBE Vector Ellipse Size"` e `"ADBE Vector Fill Color"`
+- Transform: `"ADBE Transform Group"` com `"ADBE Position" | "ADBE Scale" | "ADBE Opacity"` e `setValueAtTime`
+- Ease: `KeyframeEase(0, 80)` com `setTemporalEaseAtKey(i, [ease], [ease])`
+- Expressão: `prop.expression = "wiggle(2,20)"`
+- Efeito: `"ADBE Effect Parade".addProperty("ADBE Gaussian Blur 2" | "ADBE Glo2")`
+- Texto: `"ADBE Text Properties"` / `"ADBE Text Document"`; `td.value` é o `TextDocument`;
+  mude `doc.font`, `fontSize`, `fillColor`, `justification` e grave com `td.setValue(doc)`
+
+## Exemplo mínimo
+
+```js
+var comp = app.project.items.addComp("Cena", 1080, 1920, 1, 3, 30);
+comp.layers.addSolid([0.06, 0.06, 0.1], "fundo", 1080, 1920, 1);
+var t = comp.layers.addText("Olá");
+var td = t.property("ADBE Text Properties").property("ADBE Text Document");
+var doc = td.value; doc.font = "Poppins-Bold"; doc.fontSize = 140; doc.fillColor = [1, 1, 1];
+doc.justification = ParagraphJustification.CENTER_JUSTIFY; td.setValue(doc);
+var pos = t.property("ADBE Transform Group").property("ADBE Position");
+pos.setValueAtTime(0, [540, 1100]); pos.setValueAtTime(0.8, [540, 960]);
+var e = new KeyframeEase(0, 80);
+pos.setTemporalEaseAtKey(1, [e], [e]); pos.setTemporalEaseAtKey(2, [e], [e]);
+```

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

@@ -0,0 +1,84 @@
+---
+nome: Máquina de motion
+descricao: o assunto vira um vídeo de motion profissional, com cenas, sons no tempo e áudio a -14 LUFS, sem você escrever JSX
+quando: motion, reel, reels, anúncio animado, anuncio animado, vinheta, motion design, after effects, vídeo de motion, video de motion
+autor: PrimoCode
+---
+Para vídeo de motion, **prefira `estudio_motion`** a escrever JSX com `estudio_ae`. Você
+preenche um JSON; o kit faz o trabalho fino (curva em toda chave, mola com quique, câmera que
+nunca para, botão que afunda, palavra-chave em itálico) e põe os sons no tempo.
+
+## O caminho
+
+1. **Procure um método.** `estudio_midia acao:"projetos"` lista as receitas do Clube do Motion.
+   Ache a mais próxima do pedido, leia a ficha (formato, duração, o que ela decide) e passe o
+   `id` dela em `receita`: a máquina segue o formato e a duração da ficha.
+2. `estudio_projeto` (criar), se ainda não há projeto.
+3. **Escreva as cenas** (o JSON abaixo). Uma ideia por cena.
+4. `estudio_motion` e **abra os quadros** (`ae/quadro-*.png`). Texto cortado, tela vazia ou
+   cor sem contraste: mude o JSON e rode de novo. A máquina já confere um quadro por cena
+   e tenta uma vez sozinha, mas olhe você também.
+
+## O JSON
+
+```json
+{
+  "id": "meu-projeto", "assunto": "Pão quente às 7h na Padaria do Joel",
+  "formato": "9:16", "duracao": 15,
+  "marca": { "cores": { "fundo": "#FFF1DC", "destaque": "#E8590C", "tinta": "#3B1F0E" },
+             "fontes": { "titulo": "Poppins", "texto": "Plus Jakarta Sans", "destaque": "Playfair Display" } },
+  "cenas": [
+    { "tipo": "gancho", "titulo": "Pão *quente* às 7h", "sub": "Padaria do Joel" },
+    { "tipo": "celular", "titulo": "Peça em *10 segundos*", "toques": ["Pão francês", "Café", "Confirmar"] },
+    { "tipo": "numero", "valor": "1.200", "rotulo": "pães assados por semana" },
+    { "tipo": "lista", "titulo": "Todo dia fresquinho", "itens": ["Pão francês", "Brioche", "Café coado"] },
+    { "tipo": "cta", "titulo": "Venha *hoje*", "botao": "Peça agora" }
+  ]
+}
+```
+
+**Você não precisa escolher o tipo da cena.** Mande `papel` (gancho · problema · processo · prova · virada · cta) e o
+conteúdo (`titulo`, `itens`, `valor`, `rotulo`, `antes`, `depois`, `texto`, `autor`, `botao`, `fala`): o diretor escolhe a
+primitiva pela metáfora do assunto, sorteia com uma semente por vídeo e foge das assinaturas dos últimos vídeos
+(`~/.primocode/studio/assinaturas.json`). Se quiser mandar, mande: `tipo`, `transicoes`, `camera`, `tipografia`, `metafora`, `semente`.
+
+- **38 primitivas** (`tipo`): gancho · cinetico · particulas · odometro · citacao · cta · carimbo · revela · heroi · explosao ·
+  icones · leque · parede_logos · celular · mergulho (a tela vira a próxima cena) · notificacoes · chat · interface (recriada
+  em camadas) · cursor · prompt · rolagem · numero · barras · linha · medidor · calendario · funil · relogio · lista ·
+  cards_pulam · laco · linha_tempo · camera_nulls · mapa · antes_depois · split · ondas · estrelas.
+- **15 transições:** encolhe · empurra · mascara · zoom · flash · persiana · chicote · desfoque · cortina · pontos · giro ·
+  tremor · abre · dissolve · corte.
+- **8 câmeras:** deriva · pulso (na batida) · mao · trilho · orbita · push · chicote · cinema.
+- **8 tipografias:** editorial · poster · tecnica · manuscrita · pesada · serifa_fina · arredondada · geometrica.
+- **Elementos reais:** `elementos: ["pão","relógio"]` (ícones 3D, GIF animado do Noto, `logos`, `site`); o diretor completa
+  até 3 ou mais. Tudo no vídeo tem a ver com o assunto.
+- **Narração que manda:** `voz: {}` e uma `fala` por cena. O whisper mede cada palavra; nada aparece antes de ser dito;
+  legenda por palavra com a palavra-chave em destaque.
+- **Som real:** efeitos CC0 por ação e assunto (cache em `~/.primocode/studio/sfx/`), cortes na batida da trilha, trilha 15 dB
+  abaixo da voz com ducking, final em −14 LUFS. Sem rede, cai nos sons leves.
+- **Layout que não quebra:** o texto é medido e encaixado na área segura; depois do render o Node confere quadro vazio,
+  texto fora, sobreposição e contraste, e refaz até 2 vezes. A folha de contato fica em `ae/folha-de-contato.png`.
+
+## A régua
+
+- **A palavra-chave vai entre `*asteriscos*`**: sai em itálico, na cor de destaque, com sublinhado.
+  Uma por título.
+- **Ritmo:** de 1 a 2,5 s por cena (`dur`); o celular pode passar um pouco. Para 15 s, 6 cenas ou mais;
+  para 20 s, 8. Não repita o mesmo tipo duas vezes seguidas.
+- **Texto curto:** título de 2 a 6 palavras; item de lista com até 4. O kit quebra a linha e encolhe o
+  corpo, mas frase longa vira parede.
+- **Cor:** sem `marca`, a paleta sai do assunto (forno, rosé, grafite com lima, floresta, petróleo, coral);
+  nunca roxo-azul genérico. Com `marca`, o kit só garante o contraste.
+- **Fonte:** qualquer uma do Google Fonts; o destaque funciona melhor numa serifada itálica.
+- **Som:** whoosh na troca, pop no estalo, clique no toque, subida no número. Nada para escrever.
+- **Voz e trilha são opcionais:** `voz` (o texto a narrar) e `trilha` ("upbeat lofi"): a trilha fica
+  15 dB abaixo da voz. O vídeo todo sai a -14 LUFS.
+
+Sem `cenas`, a máquina monta o roteiro padrão (gancho, problema, processo, prova, cta) a partir
+do assunto: serve de rascunho, mas um roteiro escrito por você sempre ganha.
+
+## Se o JSX for inevitável
+
+Um efeito que os 8 tipos não cobrem? Aí sim `estudio_ae`, leia a skill `after-effects` e
+copie o MÉTODO dos scripts do Clube. O kit (`lib/estudio/kit-ae/base.jsx`) pode ser
+concatenado antes do seu script: `novaComp`, `texto`, `forma`, `mola`, `curva`, `camera`, `troca`, `som`.