primocode 10.13.0 → 10.14.1

package/README.md

@@ -1,4 +1,4 @@
-# PrimoCode v10.13.0
+# PrimoCode v10.14.0
 
 Agente de engenharia brasileiro para o terminal, no estilo Claude Code.
 Cria arquivos de verdade, roda comandos, **controla o navegador e o desktop** —
@@ -9,7 +9,7 @@ OpenRouter, e cada apelido (`top`/`main`/`fast`) é uma **corrente**: se um mode
 está no limite de pedidos, o próximo atende. Você não vê o erro, e não paga nada.
 
 ```
- ▐▛███▜▌   Primo Code v10.13.0
+ ▐▛███▜▌   Primo Code v10.14.0
 ▝▜█████▛▘  Bem-vindo de volta, Joel
   ▘▘ ▝▝    ~/primocode  · /dir <pasta> muda
 ```
@@ -17,6 +17,21 @@ 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`.
 
+## 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`.
+- **Exportar para redes** em três formatos, com capa, legenda e créditos. **Kit de marca** com `primocode marca`.
+- **Sandbox** (`/sandbox on`), **hooks**, `-p`, `--resume`, `--worktree`, modo plano e **planos por recurso** (`primocode planos`).
+- **Instalou, está pronto:** o motor After Effects baixa sozinho. `primocode doutor` mostra o que falta e como resolver.
+
+## O que mudou na 10.14
+
+- **Motor After Effects:** a ferramenta `estudio_ae` roda um JSX e renderiza o mp4, com a skill `after-effects`.
+- **Projetos completos:** seis receitas que a IA consulta (`estudio_midia acao:projetos`), uma delas em After Effects.
+- **MCP remoto:** servidores por HTTP (`{"type":"http","url":"https://…/mcp"}` no `mcp.json`), com login OAuth pelo navegador.
+- **Clube do Motion:** `primocode mcp login clube-do-motion` entra com a conta assinante e libera projetos de motion, referências, skills e músicas.
+- O token fica em `~/.primocode/mcp-tokens.json` (só você lê). `primocode mcp logout <nome>` apaga.
+
 ## O que mudou na 10.13
 
 - **Motion pelas referências:** o título enche a tela (rótulo nunca abaixo de 2% da altura), a cena dura de 1 a 2 s, o texto entra com ataque rápido e freio forte, e a frase sai inteira. As saídas que espalhavam letras saíram. O círculo de caneta na palavra-chave ganha o ✓. Sem quadro morto entre as cenas. A conta está em `docs/planos/2026-10-15-motion-pelas-referencias.md`.
@@ -106,6 +121,24 @@ veja `/mascot` e `/name`.
 
 Em uma frase: **é o poder de um agente de código no terminal, em português, controlando o seu computador de verdade — sem você precisar configurar chave de API nenhuma.**
 
+## Comparado ao Claude Code e ao Codex
+
+Tabela completa, com `arquivo:linha`, em [docs/paridade.md](docs/paridade.md). O resumo:
+
+| | Claude Code | Codex | PrimoCode |
+|---|---|---|---|
+| Hooks antes/depois de ferramenta | tem | parcial | tem (`~/.primocode/hooks.json`) |
+| Modo só leitura (plan) | tem | read-only | tem (`/permissoes plano`) |
+| Headless (`-p`, JSON, stdin) | tem | `codex exec` | tem |
+| Desfazer por pedido | `/rewind` | usa git | tem (`/desfazer`) |
+| MCP stdio, HTTP, OAuth | tem | tem | tem |
+| Sandbox de SO | opcional | tem | não |
+| Worktrees | tem | não | não |
+
+Hook em 3 linhas: `{"PreToolUse":[{"matcher":"run_shell","command":"./checar.sh"}]}`. O comando
+recebe o evento em JSON no stdin; sair com código 2 bloqueia a ferramenta. Em script:
+`git diff | primocode -p "revisa" --output-format json --permission-mode plan`.
+
 ## Instalação
 
 ```bash
@@ -302,6 +335,14 @@ De onde vem o material, tudo sem chave de API:
 A licença desce junto de tudo, num `.licenca.json` ao lado do arquivo:
 descobrir depois de publicar que a foto exigia crédito é tarde.
 
+## Motor After Effects (EffectCraft)
+
+A ferramenta `estudio_ae` usa o [EffectCraft](https://github.com/storytold/effectcraft) (storytold, licença MIT/Apache-2.0): ele roda JSX (ExtendScript) no modelo de objetos do After Effects, sem o After Effects instalado. O PrimoCode baixa o binário 0.11.1 na primeira vez para `~/.primocode/bin/effectcraft-0.11.1/` e confere o sha256. `PRIMOCODE_EFFECTCRAFT_BIN` aponta para um binário seu. A IA escreve o JSX, as fontes vêm do Google Fonts e os quadros de conferência saem em `ae/`.
+
+## Projetos completos
+
+Seis receitas originais em `lib/estudio/dados/projetos/` (narrado, produto, SaaS, só com sons, elementos de site e After Effects). Cada uma traz a ficha técnica, as etapas e um prompt com `{{CAMPOS}}`. A IA lista com `estudio_midia acao:"projetos"` e lê uma com `acao:"projeto" nome:"<id>"`.
+
 ## Subagentes
 
 Para tarefas com partes independentes, o agente delega:
@@ -338,12 +379,10 @@ PrimoCode barra e devolve a tarefa para ele:
 ## Testes
 
 ```bash
-npm test
+npm test               # o CLI: ferramentas, agente, Estúdio, vídeo (sai com 0)
+npm run test:server    # o servidor, dentro de server/
 ```
 
-25 verificações sobre glob, grep, edit_file, leitura por partes e bloqueio de
-caminho fora do projeto.
-
 ## Uso
 
 ```bash
@@ -351,12 +390,16 @@ primocode                              # interativo
 primocode "crie um jogo de carro"      # one-shot
 primocode -f app.js "onde está o bug?" # com arquivo anexado
 primocode -c                           # continua a última conversa salva (--continue)
+primocode --resume [id]                # retoma uma conversa (sem id: lista e você escolhe)
+primocode --worktree <nome>            # worktree ../<repo>-<nome> em branch nova, e abre a sessão lá
 ```
 
 ## Comandos
 
 | Comando | Descrição |
 |---|---|
+| `/resume [n\|id]` | Lista as conversas salvas ou retoma uma |
+| `/worktree <nome>` | Cria `../<repo>-<nome>` numa branch nova e entra nele (só em repo git) |
 | `/dir <caminho>` | Trabalha numa pasta que já existe, onde você quiser |
 | `/project` | Lista projetos. `/project <nome>` cria em `~/primocode` |
 | `/projetos [n]` | Os projetos de `~/primocode` do mais recente para o mais antigo, com quando mexeu e o tamanho. `/projetos 2` entra no segundo (o `/project` sem nome mostra a mesma lista) |
@@ -432,17 +475,28 @@ Mexer no mouse e no teclado (controle do computador) sempre pede licença.
 ## Arquitetura
 
 ```
-┌────────────────┐   HTTPS/SSE    ┌───────────────────┐   HTTPS   ┌──────────┐
-│  primocode CLI │ ─────────────► │  primocode-server │ ────────► │OpenRouter│
-│  (seu terminal)│ ◄───────────── │     (Render)      │ ◄──────── │   API    │
-└────────────────┘                └───────────────────┘           └──────────┘
-     executa as tools                monta o prompt
-     localmente                      e fala com o modelo
+┌────────────────┐   HTTPS/SSE    ┌───────────────────┐   HTTPS   ┌─────────────────────┐
+│  primocode CLI │ ─────────────► │  primocode-server │ ────────► │ ZeroGPU · Gemini ·  │
+│  (seu terminal)│ ◄───────────── │     (Railway)     │ ◄──────── │ Groq · HF · OpenRtr │
+└────────────────┘                └───────────────────┘           └─────────────────────┘
+     executa as tools                monta o prompt, a conta,     a corrente: se um modelo
+     localmente                      os planos e a voz            recusa, o próximo atende
 ```
 
 As tools rodam **no seu computador** — o servidor nunca toca nos seus arquivos.
 Ele decide o que fazer; o CLI faz e devolve o resultado.
 
+### Um repositório, duas partes
+
+| pasta | o que é | como sai |
+|---|---|---|
+| raiz (`bin/`, `lib/`, `skills/`, `studio/`, `voz/`) | o CLI `primocode` | `npm publish` (o `files` do `package.json` não leva o `server/`) |
+| `server/` | o primocode-server: agente, conta Firebase, planos, voz, Estúdio | Railway, serviço `primocode-server`, pasta raiz `server`, em `https://primocode-server-production.up.railway.app` |
+
+O `server/` veio do repositório `primocode-server` em 15/10/2026, com o histórico
+inteiro (`git log -- server/`). As chaves ficam nas variáveis do Railway; o
+`server/.env.example` diz quais são.
+
 ## Licença
 
 MIT © ConectaPrimoAI

package/bin/primocode.js

@@ -44,6 +44,7 @@ const vozModo = require('../lib/voz');
 const conta = require('../lib/conta');
 const planosTela = require('../lib/planos.js');
 const nuvem = require('../lib/nuvem');
+const retomar = require('../lib/retomar');
 const compat = require('../lib/compatibilidade');
 const mencoesLib = require('../lib/mencoes');
 const extra = require('../lib/comandos-extra');
@@ -121,13 +122,17 @@ const state = {
 
 const HELP = `
 ${c.bold('Comandos')}
+  ${c.brand('/resume')} [n|id]      retoma uma conversa salva (sem argumento, lista)
+  ${c.brand('/worktree')} <nome>    cria ../<repo>-<nome> numa branch nova e entra
   ${c.brand('/dir')} <caminho>      trabalha numa pasta que já existe (onde você quiser)
   ${c.brand('/project')}            lista projetos ou cria em ~/primocode: /project <nome>
   ${c.brand('/projetos')} [n]       projetos do mais recente, com tamanho · /projetos 2 entra
   ${c.brand('/novo')} <descrição>   começa um projeto NOVO do zero, em pasta própria
   ${c.brand('/mode')}               /mode primocode|chat|auto
   ${c.brand('/effort')}             esforço do agente — do rápido ao mais esperto
-  ${c.brand('/permissoes')}         quando ele pergunta antes de agir: auto|perguntar|livre
+  ${c.brand('/permissoes')}         quando ele pergunta antes de agir: auto|perguntar|livre|plano
+  ${c.brand('-p')} "pedido"          modo script: sem tela, aceita stdin e --output-format json
+  ${c.brand('/sandbox')}            isola os comandos do agente: on|off|rede on|off|status
   ${c.brand('/compact')}            resume a conversa e devolve o contexto
   ${c.brand('/init')}               estuda o projeto e escreve o PRIMO.md
   ${c.brand('/attach')} <arquivo>   anexa arquivo ao próximo pedido · ou @arquivo no pedido
@@ -140,6 +145,7 @@ ${c.bold('Comandos')}
   ${c.brand('/open')} <arq|url>     abre no navegador
   ${c.brand('/abrir')}              abre o projeto: o servidor de pé, ou a index.html
   ${c.brand('/copiar')}             copia a última resposta
+  ${c.brand('/videos')}             seus vídeos prontos (abrir <n> · pasta <n>)
   ${c.brand('/historico')} [termo]  procura nos seus pedidos antigos
   ${c.brand('/login')}              entra na sua conta · ${c.brand('/account')} mostra o plano
   ${c.brand('/planos')}             os planos e o link para assinar
@@ -152,6 +158,7 @@ ${c.bold('Comandos')}
   ${c.brand('/custo')}              tokens e pedidos desta sessão, por provedor
   ${c.brand('/atalhos')}            as teclas que ajudam
   ${c.brand('/name')} <nome>        como o Primo te chama
+  ${c.brand('/marca')} [criar|listar|usar]  o kit de marca: cores, fontes e logo em todo vídeo
   ${c.brand('/mascot')} [nome|n]    galeria dos mascotes · /mascot reacoes on|off
   ${c.brand('/config')}             mostra suas preferências
   ${c.brand('/clear')}              limpa a conversa   ${c.brand('/cls')} limpa a tela
@@ -183,7 +190,7 @@ const SLASH_COMANDOS = [
     ['/dir', 'trabalhar numa pasta sua'],
     ['/mode', 'primocode | chat | auto'],
     ['/effort', 'esforço: low → ultracode (←/→ para ajustar)'],
-    ['/permissoes', 'auto | perguntar | livre — quando ele pede licença'],
+    ['/permissoes', 'auto | perguntar | livre | plano — quando ele pede licença'],
     ['/compact', 'resume a conversa e devolve o contexto'],
     ['/init', 'estuda o projeto e escreve o PRIMO.md (as instruções dele)'],
     ['/attach', 'anexa arquivo ao pedido'],
@@ -197,6 +204,7 @@ const SLASH_COMANDOS = [
     ['/open', 'abre no navegador'],
     ['/abrir', 'abre o projeto atual: o servidor de pé, ou a index.html'],
     ['/copiar', 'copia a última resposta'],
+    ['/videos', 'seus vídeos prontos (abrir n · pasta n)'],
     ['/historico', 'procura nos seus pedidos antigos: /historico login'],
     ['/login', 'entra na sua conta (abre o navegador) · /login senha: e-mail e senha aqui'],
     ['/account', 'sua conta e o seu plano'],
@@ -218,6 +226,7 @@ const SLASH_COMANDOS = [
     ['/atalhos', 'as teclas que ajudam'],
     ['/connectors', 'quem está atendendo os seus pedidos'],
     ['/name', 'como ele te chama'],
+    ['/marca', 'kit de marca: cores, fontes e logo'],
     ['/mascot', 'galeria dos mascotes · escolha por nome ou número'],
     ['/config', 'suas preferências'],
     ['/clear', 'limpa a conversa'],
@@ -1804,6 +1813,47 @@ async function continuarUltima() {
     return true;
 }
 
+/* /resume e --resume: sem referência lista as conversas; com número ou id, retoma. */
+async function retomarConversa(ref, { listar = true } = {}) {
+    if (!conta.atual()) { console.log(c.muted('  Não conectado. ') + c.brand('/login') + c.muted(' para retomar conversas.')); return false; }
+    const l = await nuvem.listarConversas({ limite: 20 });
+    if (!l.ok) { console.log(c.err(`  ${l.error}`)); return false; }
+    if (!l.conversas.length) { console.log(c.muted('  Nenhuma conversa salva ainda.')); return false; }
+    if (!ref) {
+        if (!listar) return false;
+        console.log(c.white('\n  Conversas recentes'));
+        l.conversas.forEach((x, i) => console.log('  ' + c.dim(String(i + 1).padStart(2)) + ' ' + c.white(x.titulo.slice(0, 52).padEnd(52))
+            + c.dim(`${String(x.mensagens).padStart(3)} msg  ${x.atualizada ? new Date(x.atualizada).toLocaleDateString('pt-BR') : '—'}`)));
+        console.log(c.dim('\n  /resume <número ou id> retoma.'));
+        return false;
+    }
+    const alvo = retomar.escolher(l.conversas, ref);
+    if (!alvo) { console.log(c.err(`  Não achei a conversa ${ref}.`)); return false; }
+    const conv = await abrirConversa(alvo);
+    if (!conv.ok) { console.log(c.err(`  ${conv.error}`)); return false; }
+    console.log(c.ok(`  ${alvo.titulo}`) + c.muted(`  · ${conv.mensagens.length} mensagens carregadas`));
+    return true;
+}
+
+/* `--resume` sem id: mostra a lista e pergunta o número (só em terminal). */
+async function escolherNaAbertura() {
+    await retomarConversa(null);
+    if (!process.stdin.isTTY) return false;
+    const rl = require('readline').createInterface({ input: process.stdin, output: process.stdout });
+    const resp = await new Promise((res) => rl.question('  Qual? (número, Enter cancela) ', res));
+    rl.close();
+    return resp.trim() ? retomarConversa(resp.trim()) : false;
+}
+
+/* /worktree <nome>: cria e entra. */
+function entrarNoWorktree(nome) {
+    const w = retomar.criarWorktree(nome, projectDir());
+    if (!w.ok) { console.log(c.err(`  ${w.error}`)); return false; }
+    entrarNoProjeto(w.path, '/dir');
+    console.log(c.ok(`  worktree ${shortPath(w.path)}`) + c.muted(`  · branch ${w.branch}`));
+    return true;
+}
+
 async function handleSlash(text) {
     const [cmd] = text.trim().slice(1).split(/\s+/);
     const rest = text.trim().slice(1 + cmd.length).trim();
@@ -1818,6 +1868,12 @@ async function handleSlash(text) {
     switch (nome) {
         case 'help': console.log(HELP); break;
 
+        case 'resume': await retomarConversa(rest); break;
+        case 'worktree':
+            if (!rest) console.log(c.muted('  Uso: /worktree <nome>  (cria ../<repo>-<nome> numa branch nova e entra)'));
+            else entrarNoWorktree(rest.split(/\s+/)[0]);
+            break;
+
         /* /projetos e /project sem nome são a MESMA lista: antes o /project só
            listava os nomes, em ordem alfabética, e quem procurava "o de ontem"
            tinha de abrir pasta por pasta. Agora vem do mais recente, com
@@ -1908,23 +1964,36 @@ async function handleSlash(text) {
 
         /* Quando ele pergunta antes de agir. Os três modos e o porquê de cada
            um estão em lib/perigo.js. */
+        case 'sandbox': {
+            const sb = require('../lib/sandbox.js');
+            const [a, b] = String(rest || '').toLowerCase().split(/\s+/);
+            if (a === 'on' || a === 'off') sb.salvar({ ligado: a === 'on' });
+            else if (a === 'rede' && (b === 'on' || b === 'off')) sb.salvar({ rede: b === 'on' });
+            else if (a && a !== 'status') { console.log(c.err('Uso: /sandbox [on|off|rede on|rede off|status]')); break; }
+            const e = sb.estado();
+            console.log(c.muted('  Sandbox: ') + (e.ativo ? c.ok('ligado') : c.warn(e.ligado ? 'ligado, mas sem mecanismo neste computador' : 'desligado'))
+                + c.muted(` · mecanismo: ${e.mecanismo || 'nenhum'} · rede: ${e.rede ? 'aberta' : 'bloqueada'} · modo: ${e.modo}`));
+            console.log(c.dim('  Escreve só no projeto, /tmp e ~/.primocode/cache; não lê ~/.ssh, ~/.aws, ~/.npmrc, .env*. Detalhes: docs/sandbox.md'));
+            break;
+        }
         case 'permissoes':
         case 'permissions': {
             const DIZ = {
                 auto: 'roda tudo, mas pergunta antes do que não tem volta (apagar fora do projeto, push --force, sudo…)',
                 perguntar: 'pergunta antes de todo comando e de toda escrita de arquivo',
                 livre: 'nunca pergunta — nem antes do que não tem volta',
+                plano: 'só lê: recusa escrita e comando que muda coisa; investiga e entrega o plano',
             };
             const atual = perigo.normalizarModo(state.config.permissoes);
             if (!rest) {
                 console.log(c.muted('  Agora: ') + c.brand(atual) + c.muted(' — ' + DIZ[atual]));
                 for (const m of perigo.MODOS) console.log(`  ${m === atual ? c.brand('● ' + m) : c.muted('○ ' + m)}  ${c.dim(DIZ[m])}`);
-                console.log(c.dim('  Use /permissoes auto|perguntar|livre'));
+                console.log(c.dim('  Use /permissoes auto|perguntar|livre|plano'));
                 break;
             }
             const pedido = rest.toLowerCase();
             if (!perigo.MODOS.includes(perigo.normalizarModo(pedido)) || (perigo.normalizarModo(pedido) === 'auto' && pedido !== 'auto')) {
-                console.log(c.err('Uso: /permissoes auto|perguntar|livre'));
+                console.log(c.err('Uso: /permissoes auto|perguntar|livre|plano'));
                 break;
             }
             const m = perigo.normalizarModo(pedido);
@@ -2165,6 +2234,14 @@ async function handleSlash(text) {
         /* A galeria: todos lado a lado, número e nome em cima. Escolhe por
            nome ou número — na hora, se há teclado; senão pelo /mascot <n>.
            Num pipe não pergunta: a "resposta" seria o próximo comando. */
+        // O kit de marca (lib/marca-kit.js): /marca criar|listar|usar <nome> [aqui]|mostrar|apagar <nome>
+        case 'marca': {
+            const kit = require('../lib/marca-kit.js');
+            const perguntar = async (t, p) => (String(await ask(`${c.brand('?')} ${t}${p ? c.muted(` [${p}]`) : ''}: `)).trim() || p || '');
+            await kit.main((rest || 'mostrar').split(/\s+/), { perguntar, dizer: (t) => console.log(c.muted(t)), pasta: state.workDir || process.cwd() });
+            break;
+        }
+
         case 'mascot': case 'mascote': {
             const reac = rest.match(/^(reac(?:oes|ões)?|rea[cç][aã]o|reactions?)\s*(on|off|liga[r]?|desliga[r]?|sim|n[aã]o)?$/i);
             if (reac) {
@@ -2243,7 +2320,7 @@ async function handleSlash(text) {
 
         /* O /status olha só o servidor. O /doctor olha tudo o que costuma
            ser o motivo de "não funciona" — e cada ✗ diz como consertar. */
-        case 'doctor': case 'medico': case 'médico': {
+        case 'doctor': case 'doutor': case 'medico': case 'médico': {
             const sp = new Spinner('conferindo').start();
             const linhas = await extra.diagnosticar({
                 saude: () => api.getHealth(state.config.server, state.config.token),
@@ -2261,6 +2338,7 @@ async function handleSlash(text) {
                 console.log(`  ${marca} ${ui.padRight(c.white(l.item), 18)}${ui.truncate(c.muted(l.detalhe || ''), Math.max(20, (process.stdout.columns || 80) - 23))}`);
                 if (l.conserto) console.log(`    ${c.dim('→ ' + l.conserto)}`);
             }
+            for (const l of require('../lib/preparar.js').estudioLinhas()) linhas.push(l), console.log(`  ${l.ok === true ? c.ok('✓') : l.ok === false ? c.err('✗') : c.dim('·')} ${ui.padRight(c.white(l.item), 18)}${c.muted(l.detalhe || '')}`), l.conserto && console.log(`    ${c.dim('→ ' + l.conserto)}`);
             const ruins = linhas.filter((l) => l.ok === false).length;
             console.log(ruins ? c.warn(`\n  ${ruins} ${ruins === 1 ? 'coisa para arrumar' : 'coisas para arrumar'}.`) : c.ok('\n  Tudo certo.'));
             break;
@@ -2282,6 +2360,11 @@ async function handleSlash(text) {
             break;
         }
 
+        case 'videos': case 'vídeos': {
+            console.log(require('../lib/estudio/exportar.js').main(rest.split(/\s+/).filter(Boolean)).texto);
+            break;
+        }
+
         case 'copiar': case 'copy': {
             const r = extra.copiar(state.lastResponse);
             if (r.ok) console.log(c.ok('  Copiado.') + c.dim(`  ${state.lastResponse.length} caracteres · é só colar`));
@@ -2792,9 +2875,27 @@ async function main() {
         process.exit(await require('../lib/video/cli.js').main(process.argv.slice(3)));
     }
     // `primocode mcp …`: os servidores MCP pelo run_shell (lib/mcp.js).
+    if (process.argv[2] === 'videos') {
+        const r = require('../lib/estudio/exportar.js').main(process.argv.slice(3));
+        console.log(r.texto); process.exit(r.ok ? 0 : 1);
+    }
     if (process.argv[2] === 'skill' || process.argv[2] === 'skills') {
         process.exit(require('../lib/skills.js').main(process.argv.slice(3)));
     }
+    // `primocode planos`: a tabela comparativa, sem abrir a sessão.
+    if (['doutor', 'doctor', 'preparar'].includes(process.argv[2])) {
+        process.exit(await require('../lib/preparar.js').main(process.argv.slice(2)));
+    }
+    if (process.argv[2] === 'planos') {
+        const { loadConfig } = require('../lib/config');
+        const r = await planosTela.buscarPlanos(loadConfig().server);
+        const eu = conta.atual();
+        for (const l of planosTela.desenhar(r, { cores: c, atual: eu && eu.pro ? eu.plano : null, site: conta.SITE })) console.log(l);
+        process.exit(0);
+    }
+    if (process.argv[2] === 'marca') {
+        process.exit(await require('../lib/marca-kit.js').main(process.argv.slice(3)));
+    }
     if (process.argv[2] === 'mcp') {
         process.exit(await require('../lib/mcp.js').main(process.argv.slice(3)));
     }
@@ -2825,7 +2926,16 @@ async function main() {
     // resto (one-shot, -f) segue sendo lido do jeito de sempre.
     const todos = process.argv.slice(2);
     const continuar = todos.some((a) => a === '-c' || a === '--continue');
-    const args = todos.filter((a) => a !== '-c' && a !== '--continue');
+    const fl = retomar.analisar(todos.filter((a) => a !== '-c' && a !== '--continue'));
+    const args = fl.args;
+    if (fl.erro) { console.error(fl.erro); process.exit(1); }
+    if (fl.worktree) {
+        // Antes de tudo: a sessão inteira nasce dentro do worktree.
+        const w = retomar.criarWorktree(fl.worktree, process.cwd());
+        if (!w.ok) { console.error(w.error); process.exit(1); }
+        process.chdir(w.path);
+        console.log(c.dim(`  ⎿ worktree ${w.path} (branch ${w.branch})`));
+    }
 
     // Flags padrão de CLI — funcionam em qualquer máquina, úteis em scripts/CI.
     if (args[0] === '--version' || args[0] === '-v' || args[0] === '-V') {
@@ -2838,6 +2948,33 @@ async function main() {
         process.exit(0);
     }
 
+    /* `-p` / `--print`: o modo de script e CI (lib/headless.js). Sem tela, o
+       stdin entra no pedido, e --output-format json devolve um JSON só. */
+    {
+        const H = require('../lib/headless.js');
+        const h = H.analisar(args);
+        if (h.ativo) {
+            if (h.erro) { console.error(h.erro); process.exit(1); }
+            if (h.permissao) {
+                const perm = perigo.normalizarModo(h.permissao);
+                state.config.permissoes = perm; // só nesta execução, não grava
+            }
+            const inicio = Date.now();
+            const pedido = H.montarPedido(h.resto.filter((a) => a !== '-f'), await H.lerStdin());
+            if (!pedido) { console.error('Uso: primocode -p "pedido" [--output-format json] [--permission-mode plan]'); process.exit(1); }
+            if (typeof fl.resume === 'string') await retomarConversa(fl.resume);
+            else if (continuar) await continuarUltima();
+            state.semTerminal = true;
+            let erro = null;
+            const texto = await H.capturar(async () => {
+                try { await sendPrompt(pedido); } catch (e) { erro = e.message || String(e); }
+            }, { calar: h.formato === 'json' });
+            if (h.formato === 'json') console.log(H.resultadoJson({ texto, erro, inicio, permissao: state.config.permissoes }));
+            else if (erro) console.error(erro);
+            process.exit(erro ? 1 : 0);
+        }
+    }
+
     // Modo one-shot: primocode "crie um jogo de carro"
     if (args.length && !args[0].startsWith('-')) {
         const fileFlag = args.indexOf('-f');
@@ -2852,7 +2989,8 @@ async function main() {
         }
 
         // Com -c, o pedido continua a última conversa em vez de chegar sozinho.
-        if (continuar) await continuarUltima();
+        if (typeof fl.resume === 'string') await retomarConversa(fl.resume);
+        else if (continuar) await continuarUltima();
         /* O MESMO caminho do pedido digitado (sendPrompt). Este modo tinha um
            runAct próprio, e por isso ficava sem tudo o que vive lá: o plano em
            passos, a retomada automática, o @arquivo, o checkpoint do /desfazer. */
@@ -3088,7 +3226,9 @@ async function main() {
     }).catch(() => { state.liberado = true; })
         // Depois da abertura, porque é nela que a pessoa entra na conta — e
         // sem conta não há conversa para achar.
-        .then(() => (continuar ? continuarUltima().catch(() => false) : null))
+        .then(() => (fl.resume === true ? escolherNaAbertura().catch(() => false)
+            : fl.resume ? retomarConversa(fl.resume).catch(() => false)
+                : continuar ? continuarUltima().catch(() => false) : null))
         .then(() => {
             // O que sobrou de adiantado não era resposta de nada: vira comando,
             // na ordem em que foi digitado. Nada se perde, só esperou a vez.

package/lib/act.js

@@ -13,6 +13,8 @@
 const { c, Spinner, PENSANDO } = require('./ui');
 const fala = require('./fala');
 const especialistas = require('./especialistas');
+const limites = require('./limites');
+let avisouParalelo = false;
 const tools = require('./tools');
 const api = require('./api');
 const cfg = require('./config');
@@ -24,6 +26,7 @@ const permissao = require('./permissao');
 const perigo = require('./perigo');
 const skills = require('./skills');
 const checkpoint = require('./checkpoint');
+const hooks = require('./hooks');
 const tempos = require('./tempos');
 const preLeitura = require('./pre-leitura');
 const travado = require('./travado');
@@ -795,6 +798,9 @@ async function runAct(userPrompt, opts) {
     };
     const falhasPendentes = [];
     let tentativasDeEncerrar = 0;
+    // Portão de prova fresca (Gravitas, comum/desmontados/udaysharmadev-Gravitas.md): o
+    // `finish` depois de editar código sem rodar nada depois volta UMA vez.
+    const prova = novoPortaoDeProva();
     /* ── CONFERIR ANTES DE DIZER "PRONTO" ───────────────────────────────
      * Mexeu em página (html, css, js) nesta tarefa? Antes de aceitar o
      * `finish`, o PrimoCode abre a página num navegador invisível e olha: tela
@@ -1318,8 +1324,12 @@ async function runAct(userPrompt, opts) {
         const spawns = toolCalls.filter((tc) => tc.name === 'spawn_agent');
         const resultadosSpawn = new Map();
         if (spawns.length && !PARAR) garantirPasta();
-        if (spawns.length > 1 && !PARAR) {
-            const juntos = spawns.slice(0, 8);
+        /* O plano decide quantos subagentes rodam JUNTOS (lib/limites.js; grátis e
+           Primo: um de cada vez, o resto continua em fila). Nunca recusa: só diz o porquê. */
+        const par = spawns.length > 1 ? await limites.paralelo() : null;
+        if (par) { const av = par.aviso(spawns.length); if (av && !avisouParalelo) { avisouParalelo = true; console.log(`  ${av}`); } }
+        if (spawns.length > 1 && par.max > 1 && !PARAR) {
+            const juntos = spawns.slice(0, par.max);
             fala.paralelo(juntos.length, profundidade);
             const ids = juntos.map((tc) => anotar(tc, 'permitida'));
             const rs = await Promise.all(juntos.map((tc) =>
@@ -1361,7 +1371,13 @@ async function runAct(userPrompt, opts) {
         let motivoTravou = null;
         for (const tc of toolCalls) {
             if (PARAR) break;
+            prova.ver(tc);
             if (tc.name === 'finish') {
+                const faltaProva = prova.barrar();
+                if (faltaProva) {
+                    messages.push({ role: 'tool', tool_call_id: tc.id, content: faltaProva });
+                    continue;
+                }
                 const relato = await conferirPagina();
                 if (relato) {
                     messages.push({
@@ -1588,6 +1604,17 @@ async function runAct(userPrompt, opts) {
                 continue;
             }
 
+            /* Hook PreToolUse (lib/hooks.js): exit 2 bloqueia a ferramenta. */
+            const gancho = hooks.rodar('PreToolUse', { nome: tc.name, args: tc.arguments, projectDir: pastaAtual });
+            if (gancho.bloqueado) {
+                anotar(tc, 'recusada', gancho.motivo);
+                fala.acao(tc.name, tc.arguments, profundidade);
+                console.log(fala.resultado(profundidade) + c.warn(`bloqueado por hook — ${gancho.motivo.slice(0, 80)}`));
+                registro.anotar(livro, tc.name, tc.arguments, { ok: false, error: gancho.motivo });
+                messages.push({ role: 'tool', tool_call_id: tc.id, content: JSON.stringify({ ok: false, error: `Bloqueado por hook: ${gancho.motivo}` }) });
+                continue;
+            }
+
             algoRodou = true;
             rodouTool = true;
             fala.acao(tc.name, tc.arguments, profundidade);
@@ -1604,6 +1631,7 @@ async function runAct(userPrompt, opts) {
             const result = adiantadas.has(tc.id) ? adiantadas.get(tc.id)
                 : await tools.execute(tc.name, tc.arguments, { projectDir: pastaAtual, server, token, api });
             auditoria.depois(idAcao, result);
+            for (const aviso of hooks.rodar('PostToolUse', { nome: tc.name, args: tc.arguments, resultado: result, projectDir: pastaAtual }).avisos) console.log(c.dim(`  ⎿ ${aviso}`));
             traco(`${tc.name} devolveu ok=${result && result.ok}`);
             if (/^estudio_|^planejar_producao$/.test(tc.name) && result && result.ok !== false) {
                 const id = result.id || (result.projeto && result.projeto.id) || (tc.arguments && tc.arguments.id);
@@ -1986,5 +2014,30 @@ async function rodarPipeline(args, ctx) {
     });
 }
 
-module.exports = { runAct, videoForaDeEdicao, entregaDoAgente, lembreteDeParalelo, buildMemoryContext, leituraPeloShell, historicoEnxuto, interromper, mandarDuranteATarefa, trabalhando, sobrasDaCaixa, entregarRecados, compactar, motivoDaParada, pareceParadaNoMeio, ehTetoDeToken, ehTransitorio, esperaDoErro,
+/**
+ * Portão de prova fresca: marca a edição de código e o comando rodado, nessa
+ * ordem. `barrar()` devolve a frase de "AINDA NÃO" (uma vez só) quando o
+ * último código editado não tem comando depois dele; senão null. Página
+ * (html/css) fica com o conferirPagina.
+ */
+const CODIGO = /\.(m?[jt]sx?|cjs|py|rb|go|rs|java|php|sh|c|cpp|cs)$/i;
+function novoPortaoDeProva() {
+    let seq = 0, edicao = 0, rodou = 0, avisou = false;
+    return {
+        ver(tc) {
+            const a = (tc && tc.arguments) || {};
+            if (tc.name === 'write_file' || tc.name === 'edit_file' || tc.name === 'multi_edit') {
+                if (CODIGO.test(String(a.path || a.file_path || ''))) edicao = ++seq;
+            } else if (tc.name === 'run_shell' || tc.name === 'run_in_new_terminal') rodou = ++seq;
+        },
+        barrar() {
+            if (!edicao || rodou > edicao || avisou) return null;
+            avisou = true;
+            return 'AINDA NÃO: você editou código e não rodou nada depois. Rode o teste ou o comando que prova '
+                + 'que funciona, leia o resultado e chame finish de novo (ou diga o que não conseguiu conferir).';
+        },
+    };
+}
+
+module.exports = { novoPortaoDeProva, runAct, videoForaDeEdicao, entregaDoAgente, lembreteDeParalelo, buildMemoryContext, leituraPeloShell, historicoEnxuto, interromper, mandarDuranteATarefa, trabalhando, sobrasDaCaixa, entregarRecados, compactar, motivoDaParada, pareceParadaNoMeio, ehTetoDeToken, ehTransitorio, esperaDoErro,
     anotacaoDoQueJaFoi, encolherParaContinuar, MAX_ITERATIONS };

package/lib/catalogo.js

@@ -111,7 +111,8 @@ const GRUPOS = [
                 + 'o render empurra para dentro, encolhe o texto largo e afasta o colado; enfeite de fundo marque decorativo: true.' },
 
             { tool: 'estudio_midia', escreve: true, faz: 'procura e baixa ícone, imagem, música e efeito sonoro da internet, e lista as fontes',
-              args: 'acao: biblioteca | estilos | salvar_estilo | movimentos | cenarios | salvar_cenario | imagem | icones | icones3d | animacoes | som | trilha | efeito | fontes | print | elementos | elemento | recortar. termo. id (para baixar). '
+              args: 'acao: biblioteca | projetos | projeto | estilos | salvar_estilo | movimentos | cenarios | salvar_cenario | imagem | icones | icones3d | animacoes | som | trilha | efeito | fontes | print | elementos | elemento | recortar. termo. id (para baixar). '
+                + 'projetos termo categoria:narrado|produto|saas|sound|elementos|ae: receitas de projeto completo (ficha, etapas, prompt); projeto nome:"<id>" traz a receita inteira. '
                 + 'movimentos termo:"quique" categoria:entrada|saida|enfase|loop: os 100+ movimentos prontos com nome; no elemento, movimento:"<nome>" (ou {nome, em, duracao}, ou uma lista) vira quadros-chave sozinho. Varie: não use o mesmo em todo elemento. Pode inventar o seu em anima. '
                 + 'estilos: as peças do gerativo (humor, paleta, fontes, trilha, ambiente, acento, material) — dezenas de milhares de combinações, e os estilos que a pessoa salvou. '
                 + 'Monte o do vídeo pelo ASSUNTO em roteiro.estiloVisual; misture um salvo com {base:"<nome>", ...}; crie paleta nova com 5 cores. '
@@ -136,6 +137,16 @@ const GRUPOS = [
                 + 'icones: sem "nome", procura; com "nome" ("lucide:zap"), baixa. '
                 + 'Tudo é BAIXADO para a pasta do projeto — o plano nunca aponta para a internet.' },
 
+            { tool: 'estudio_ae', escreve: true, faz: 'monta e renderiza uma composição em After Effects (JSX, via EffectCraft), com keyframes, expressões e efeitos',
+              args: 'id. script (o JSX: app.project.items.addComp, camadas, setValueAtTime com ease). comp (o nome da composição). fontes [{familia, peso}]. '
+                + 'audio (caminho relativo, juntado ao vídeo). conferir [segundos]: quadros PNG para olhar antes de dar por pronto. Leia a skill after-effects. Sai em video-ae.mp4.' },
+            { tool: 'estudio_motion', escreve: true, faz: 'a máquina de motion: do assunto ao vídeo de motion pronto (cenas no After Effects, sons no tempo, trilha e voz opcionais, −14 LUFS)',
+              args: 'id. assunto. formato (9:16|1:1|16:9). duracao (6 a 60 s). receita (id de estudio_midia acao:"projetos": usa o formato e a duração da ficha). '
+                + 'marca {cores:{fundo,destaque,tinta}, fontes:{titulo,texto,destaque}}. cenas [{papel, tipo?, fala?, titulo, itens, valor, rotulo, antes, depois, texto, autor, botao}] (o diretor escolhe entre 38 primitivas, 15 transições, 8 câmeras e 8 tipografias, com assinatura própria; a palavra-chave vai entre *asteriscos*). '
+                + 'elementos (termos reais do assunto). transicoes. camera. tipografia. semente. voz (texto ou {}; o whisper mede cada palavra). trilha (true ou o que buscar; false desliga). Sem cenas, o diretor monta. Prefira esta a escrever JSX. Sai em video-motion.mp4. previa:true = rascunho em segundos (meia resolução, sem mix final) para aprovar antes do final.' },
+            { tool: 'estudio_editar', escreve: true, faz: 'o editor por comando: muda um vídeo do estudio_motion (texto, cor, fonte, ritmo, cenas, trilha, volume, formato) e guarda versões',
+              args: 'id_video. mudancas [{op, ...}]: texto {cena,valor} · cor {fundo,destaque,tinta|paleta} · fonte {titulo,texto,destaque} · ritmo {fator} · duracao {cena,segundos|total} · remover/mover/duplicar {cena,para} · trilha {valor:false|busca} · volume {alvo:voz|trilha|sfx,db} · formato {valor}. '
+                + 'previa (rascunho rápido). final (render final da versão atual). voltar_para (n da versão). listar. "Deixa mais rápido" = ritmo fator 0.8; "tira a música" = trilha valor false. Sai em versoes/vN.' },
             { tool: 'estudio_narrar', escreve: true, faz: 'gera a narração em voz neural e devolve o tempo MEDIDO de cada fala',
               args: 'id. texto. voz (antonio|francisca|thalita). estilo (normal|anuncio|calmo|dramatico). '
                 + 'vozes: true lista as vozes. '

package/lib/config.js

@@ -400,6 +400,7 @@ function esquecerProjeto() {
 }
 
 module.exports = {
+    tokenDaConta,
     tokensDoAssunto, GENERICAS,
     lembrarProjeto, projetoLembrado, esquecerProjeto, PROJETO_ATIVO_FILE, pastasRecentes, nomeDaPasta,
     loadConfig, saveConfig, appendHistory, servidor, SERVIDOR,