primocode 8.42.2 → 9.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primocode",
-  "version": "8.42.2",
+  "version": "9.1.0",
   "description": "PrimoCode — agente de engenharia com IA e cursor próprio. Requer conta Conecta Primo AI (Premium ou Super). Cria arquivos, roda comandos, controla navegador e desktop: abre apps, clica em botões e ícones pelo nome, digita e usa atalhos.",
   "main": "bin/primocode.js",
   "bin": {
@@ -8,7 +8,7 @@
   },
   "scripts": {
     "start": "node bin/primocode.js",
-    "test": "node test/tools.test.js && node test/ui.test.js && node test/modo.test.js && node test/pasta.test.js && node test/catalogo.test.js && node test/desktop.test.js && node test/effort.test.js && node test/claude-engine.test.js && node test/regressao.test.js && node test/memoria-conversa.test.js && node test/repeticao.test.js && node test/referencia.test.js && node test/parar.test.js && node test/continuar.test.js && node test/studio-spec.test.js && node test/studio-versoes.test.js && node test/voz.test.js && node test/editor.test.js && node test/estudio-projeto.test.js && node test/vocabulario.test.js && node test/video-export.test.js && node test/monotonia.test.js && node test/clipe.test.js && node test/midia-envio.test.js && node test/pausas.test.js && node test/fala-repetida.test.js && node test/trilha.test.js && node test/anuncio.test.js && node test/pipeline.test.js && node test/app.test.js && node test/elementos.test.js && node test/remotion.test.js && node test/aplicativo.test.js && node test/conta.test.mjs && node test/nuvem.test.js && node test/codex.test.js && node test/chaves.test.js && node test/prazo.test.js && node test/primeira-vez.test.js && node test/janela.test.js && node test/pareamento.test.js && node test/fala.test.js && node test/especialistas.test.js && node test/icone.test.js && node test/exportar.test.js && node test/ate-o-fim.test.js && node test/motion.test.js && node test/audio-marca.test.js && node test/diretor.test.js && node test/camera.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/skills.test.js && node test/estudio.test.js && node test/voz.test.js && node test/modo.test.js && node test/pasta.test.js && node test/catalogo.test.js && node test/desktop.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/referencia.test.js && node test/parar.test.js && node test/continuar.test.js && node test/pipeline.test.js && node test/app.test.js && node test/aplicativo.test.js && node test/conta.test.mjs && node test/nuvem.test.js && node test/prazo.test.js && node test/primeira-vez.test.js && node test/janela.test.js && node test/pareamento.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"
   },
   "engines": {
     "node": ">=18.17.0"
@@ -29,6 +29,15 @@
     "lib/",
     "app/",
     "studio/",
-    "README.md"
+    "skills/",
+    "voz/",
+    "README.md",
+    "!**/__pycache__",
+    "!**/*.pyc",
+    "!**/*.pyo",
+    "!**/*.log",
+    "!studio/arquivos",
+    "!studio/midia",
+    "!studio/saida"
   ]
 }

package/skills/acessibilidade/SKILL.md

@@ -0,0 +1,28 @@
+---
+nome: Acessibilidade
+descricao: interface que funciona para quem não usa mouse nem enxerga a tela
+quando: acessibilidade, acessível, acessivel, a11y, aria, teclado, leitor de tela, contraste, semântica, semantica, html
+autor: PrimoCode
+---
+Acessibilidade não é uma camada que se adiciona no fim. É como o HTML é
+escrito.
+
+**HTML semântico primeiro**: `button` para ação, `a` para navegação, `header`,
+`nav`, `main`, `section`, `label`. Uma `div` com `onclick` não recebe foco,
+não responde ao Enter e não existe para um leitor de tela. ARIA só entra
+quando o elemento certo não existe — `aria-label` num `button` de ícone, sim;
+`role="button"` numa `div`, não.
+
+**Teclado**: dá para percorrer a página inteira com Tab, na ordem visual, e o
+foco é VISÍVEL (`:focus-visible` com contorno de verdade — nunca
+`outline: none` sem substituto). Modal prende o foco dentro e volta ao botão
+que o abriu no Esc.
+
+**Contraste**: 4.5:1 em texto normal, 3:1 em texto grande e em borda de
+controle. Cinza-claro sobre branco é a falha mais comum.
+
+**Imagem** tem `alt` que descreve a função, não o arquivo. Decorativa leva
+`alt=""`.
+
+**Formulário**: todo campo com `label` ligado, erro em texto (não só em
+vermelho) e ligado ao campo por `aria-describedby`.

package/skills/api-que-nao-quebra/SKILL.md

@@ -0,0 +1,27 @@
+---
+nome: API que não quebra
+descricao: rotas, validação, erro e segurança em servidor
+quando: api, rota, rotas, endpoint, servidor, backend, express, fastapi, flask, django, rest, webhook, autenticação, autenticacao, token, banco de dados
+autor: PrimoCode
+---
+Leia o que já existe (rotas, modelos, como o projeto trata erro e
+configuração) e siga o padrão dele. Um projeto com dois padrões é pior que um
+projeto com um padrão ruim.
+
+**Valide na borda.** Toda entrada: tipo, tamanho, faixa. O erro responde com o
+código HTTP certo e uma mensagem que diz o que corrigir — "Bad Request" não
+diz nada a ninguém.
+
+**Nunca**: segredo no código (vai para variável de ambiente, com o
+`.env.example` atualizado); entrada do usuário concatenada em SQL, comando de
+shell ou caminho de arquivo; catch vazio; dado pessoal no log.
+
+**Separe** rota, regra de negócio e acesso a dados. A rota lê e responde; ela
+não sabe fazer conta.
+
+**Pense no que falha**: rede fora, disco cheio, campo ausente, mesmo pedido
+chegando duas vezes. Uma rota que só funciona com o caminho feliz não está
+pronta.
+
+Antes de terminar, suba o servidor e mostre uma requisição respondendo de
+verdade — com o corpo da resposta, não só o status.

package/skills/depurar-de-verdade/SKILL.md

@@ -0,0 +1,29 @@
+---
+nome: Depurar de verdade
+descricao: achar a causa do defeito em vez de tentar consertos no escuro
+quando: bug, erro, defeito, quebrado, não funciona, nao funciona, falha, corrigir, consertar, debug, depurar, travando
+autor: PrimoCode
+---
+Não conserte antes de reproduzir. Conserto sem reprodução é chute, e chute que
+"parece ter resolvido" esconde o defeito para ele voltar depois.
+
+**A ordem**:
+
+1. **Reproduza.** Qual entrada, qual passo, o que aconteceu, o que deveria ter
+   acontecido. Se não reproduz, o defeito não está onde você acha.
+2. **Leia o erro inteiro.** A primeira linha diz o sintoma; a pilha diz o
+   lugar. A linha que importa costuma ser a primeira que é do PROJETO, não da
+   biblioteca.
+3. **Isole.** Metade de cada vez: o dado está errado ao entrar ou ao sair?
+   Antes ou depois desta função? Cada medição corta o espaço de busca pela
+   metade.
+4. **Entenda a causa.** "Adicionei um try/catch e parou de aparecer" não é
+   causa, é mordaça.
+5. **Conserte** o menor pedaço possível, e **prove** rodando a reprodução do
+   passo 1.
+
+Se o projeto tem teste, escreva PRIMEIRO o que falha, depois a correção,
+depois veja-o passar. Assim o defeito não volta sem ninguém ver.
+
+Quando a suspeita for de ambiente (versão, variável, caminho), confira em vez
+de supor: rode `--version`, imprima a variável, liste a pasta.

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

@@ -0,0 +1,59 @@
+---
+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
+autor: PrimoCode
+---
+O vídeo é da pessoa. Ela apareceu, falou e errou — o seu trabalho é tirar o
+que atrapalha, não refazer o que ela fez.
+
+## A ordem que funciona
+
+1. `estudio_video acao:"importar"` — o original entra na pasta do projeto, e
+   fica intocado. Nunca escreva por cima do arquivo dela.
+2. `acao:"medir"` — duração, tamanho, fps. Enquadramento vertical e
+   horizontal mudam tudo o que vem depois.
+3. `acao:"legendas"` — a transcrição com tempo. Ela serve para duas coisas: a
+   legenda em si e saber DO QUE ela está falando em cada instante, que é o
+   que decide onde entra apoio.
+4. `acao:"cortar-silencio"` — depois de ler, não antes.
+5. O plano, com a gravação como elemento de vídeo.
+
+## Corte de silêncio
+
+Pausa curta é fala, não erro. Corte só o que passa de ~0,6s, e deixe respiro
+nas pontas (~0,18s). O padrão já faz isso; mexer nele é decisão, não ajuste.
+
+Depois do corte, ASSISTA: peça quadros (`acao:"quadro"`) em alguns pontos de
+emenda. Corte que fica bom no papel e ruim no ouvido é o normal, não a
+exceção.
+
+## Legenda
+
+A legenda tem estilo — fonte, peso, cor, contorno, posição, animação. Ela não
+é uma linha branca no rodapé por obrigação.
+
+Regras que valem: no máximo 5 ou 6 palavras por vez; posição alta o bastante
+para não ser coberta pela interface do aplicativo onde o vídeo vai; contorno
+ou sombra, porque o fundo muda; e nunca cobrindo o rosto de quem fala.
+
+## B-roll
+
+Quando ela cita uma coisa concreta, essa coisa aparece — e ela some da tela
+por 1 a 3 segundos. Depois volta. É isso que dá ritmo a vídeo falado.
+
+Busque a imagem pelo que ela DISSE naquele instante (você tem os tempos da
+transcrição). Volte sempre antes de a frase acabar.
+
+## Troca de fundo
+
+`acao:"recortar-pessoa"` devolve a pessoa com fundo transparente. Ponha uma
+imagem relacionada ao assunto atrás — não uma textura decorativa.
+
+O recorte erra na borda do cabelo. Se ficar com cara de adesivo, aumente o
+`suavizar` e o `encolher` antes de desistir.
+
+## O que contar para ela
+
+Diga quantos segundos saíram e quantos cortes foram feitos. É fala dela que
+sumiu do vídeo — ela tem o direito de saber, e de discordar.

package/skills/escrever-em-portugues/SKILL.md

@@ -0,0 +1,28 @@
+---
+nome: Escrever em português
+descricao: texto de produto que soa como gente, não como manual traduzido
+quando: texto, copy, escrever, redação, redacao, mensagem, microcopy, erro, aviso, botão, botao, e-mail, email, post, legenda
+autor: PrimoCode
+---
+Escreva como alguém que conhece o assunto falaria com um colega — em português
+do Brasil, não em inglês traduzido.
+
+**O que denuncia tradução**: "Nós fornecemos soluções", "Clique aqui para",
+"Oops! Algo deu errado", voz passiva em tudo, "seu/sua" em toda frase,
+gerúndio de call center ("vou estar enviando").
+
+**Mensagem de erro** diz três coisas, nesta ordem: o que aconteceu, por que, e
+o que fazer agora. "Erro 500" não é nenhuma das três. Sem culpar a pessoa: "o
+e-mail precisa de @" e não "você digitou errado".
+
+**Botão** é um verbo que descreve o resultado: "Salvar alterações", "Enviar
+pedido" — nunca "OK", "Enviar" solto ou "Clique aqui".
+
+**Frase curta.** Se precisou de vírgula para respirar duas vezes, são duas
+frases. Corte advérbio ("simplesmente", "basicamente", "rapidamente") e
+superlativo sem número.
+
+Número concreto vence adjetivo: "responde em 2 segundos" vale mais que
+"ultrarrápido".
+
+Não use emoji para dar emoção a um texto que não tem nenhuma.

package/skills/git-limpo/SKILL.md

@@ -0,0 +1,28 @@
+---
+nome: Git limpo
+descricao: commit, branch e histórico que alguém consegue ler depois
+quando: git, commit, commitar, branch, pull request, pr, merge, histórico, historico, versionar
+autor: PrimoCode
+---
+O histórico é documentação. Quem vai lê-lo é você daqui a seis meses,
+procurando por que uma linha existe.
+
+**Commit**: um assunto por commit. A primeira linha diz o que MUDA no
+comportamento, no imperativo e sem ponto final ("corrige o cálculo do frete
+para pedido sem CEP"). O corpo diz POR QUE — o que estava errado e o que se
+tentou antes. O código já mostra o que foi feito; o que ele não mostra é o
+motivo.
+
+**Nunca** commite: segredo, chave, `.env`, `node_modules`, pasta de build,
+arquivo de editor. Confira com `git status` antes, e com `git diff --staged`
+antes de fechar.
+
+**Antes de commitar**, rode o que o projeto roda (lint, teste). Commit que
+quebra a build custa o tempo de todo mundo que der pull.
+
+**Branch** com nome que diz o assunto, não o seu nome.
+
+**Pull request**: título que é a frase do commit; corpo com o que muda, por
+que, e como conferir. Se o projeto tem template de PR, siga o template.
+
+Nunca reescreva histórico que já foi empurrado e que outra pessoa pode ter.

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

@@ -0,0 +1,62 @@
+---
+nome: Motion de primeira
+descricao: como um vídeo criado do zero deixa de parecer feito por máquina
+quando: vídeo, video, motion, animação, animacao, anúncio, anuncio, reels, teaser, abertura, comercial, propaganda, estúdio, estudio
+autor: PrimoCode
+---
+Não existe template. Cada propriedade deste vídeo é uma decisão sua, e a
+primeira decisão é **não repetir o vídeo anterior**.
+
+## O que denuncia vídeo feito por IA
+
+Não faça nada disto, em nenhum vídeo:
+
+- gradiente roxo-para-azul (o mais reconhecível de todos), e gradiente de duas
+  cores que não têm relação com o assunto;
+- tudo centralizado, do primeiro ao último quadro;
+- uma fonte só, em todos os tamanhos;
+- texto que aparece com `opacidade 0→1` e mais nada, cena após cena;
+- ícone genérico flutuando ao lado de cada frase;
+- tempo igual em todas as cenas;
+- transição igual entre todas.
+
+## O que separa motion bom de slide animado
+
+**A câmera existe.** Zoom, pan e dolly são da CENA, não do elemento. Um zoom
+lento de 1.0 para 1.08 ao longo de uma cena dá vida a um quadro parado — e
+quase nenhum vídeo automático faz isso.
+
+**Nada entra do nada.** Um elemento entra vindo de algum lugar (de baixo, de
+trás, de fora do quadro), com `saida` ou `elastico` na suavização. Movimento
+linear é a assinatura da máquina: no mundo físico nada começa e para na mesma
+velocidade.
+
+**Profundidade.** Camadas que se movem em velocidades diferentes (parallax)
+custam duas linhas e mudam a cena inteira: fundo devagar, meio médio, frente
+rápido. Com `perspectiva` na cena, `rotacaoX`/`rotacaoY`/`z` viram 3D de
+verdade.
+
+**Ritmo.** Cena de informação simples: 1,5 a 2,5s. Cena com frase para ler: 3
+a 4s. Fecho: 2s. Variar a duração é o que cria ritmo; repetir cria sono.
+
+**Silêncio visual.** Um quadro com uma frase e mais nada vale mais que um com
+seis elementos. Espaço vazio é composição, não desperdício.
+
+## Cor e tipo
+
+Escolha a paleta a partir do ASSUNTO, e escreva os valores. Três a cinco
+cores: uma dominante, uma de destaque, neutros com viés da dominante. Se a
+marca existe, leia o site dela com `estudio_site` e use as cores medidas —
+não as que você imagina que ela usa.
+
+Duas fontes, no máximo: uma de display para o que grita, uma neutra para o
+que se lê. `estudio_midia acao:"fontes"` mostra um leque grande — sair do
+Inter/Montserrat é metade do trabalho de não parecer genérico.
+
+## Antes de renderizar
+
+- Todo `src` aponta para arquivo que existe na pasta (baixe antes).
+- Os tempos das cenas batem com os tempos MEDIDOS da narração.
+- Nenhuma cena tem a mesma composição da anterior.
+- Leia o seu próprio plano e pergunte: em que este vídeo é diferente do
+  último que eu fiz? Se não houver resposta, refaça antes de renderizar.

package/skills/pagina-que-converte/SKILL.md

@@ -0,0 +1,28 @@
+---
+nome: Página que converte
+descricao: estrutura e acabamento de landing page, site e página de venda
+quando: landing, landing page, site, página, pagina, home, hero, seção, secao, cta, conversão, conversao, vendas, institucional
+autor: PrimoCode
+---
+Uma página que converte tem ordem, não mais elementos.
+
+**A ordem que funciona**: promessa clara em até 8 palavras → uma linha que
+explica para quem é → prova (número real, print, nome de cliente) → o que a
+pessoa ganha, em 3 blocos → objeção respondida → um único pedido de ação,
+repetido no fim.
+
+**Um CTA por página.** Dois pedidos de ação competem entre si e a pessoa não
+faz nenhum.
+
+**O que denuncia página genérica** — não faça nada disto:
+gradiente roxo-para-azul no fundo, tudo centralizado do topo ao rodapé,
+sombra em todo cartão, emoji no lugar de ícone, "Bem-vindo ao nosso site",
+"Soluções inovadoras", texto de exemplo em qualquer lugar.
+
+**Acabamento**: escala de espaço consistente (4/8/12/16/24/32/48), no máximo
+dois pesos de fonte, contraste de 4.5:1 no texto, botão com hover e
+focus-visible, largura de leitura entre 60 e 75 caracteres. Funciona de 360px
+a 1440px sem rolagem horizontal.
+
+Escreva o texto de verdade, sobre o assunto de verdade. Uma página bonita com
+texto vazio não convence ninguém.

package/skills/performance-web/SKILL.md

@@ -0,0 +1,28 @@
+---
+nome: Performance web
+descricao: página que carrega rápido de verdade, não no papel
+quando: performance, lento, lenta, rápido, rapido, otimizar, otimização, otimizacao, carregamento, lighthouse, bundle, imagem, imagens
+autor: PrimoCode
+---
+Meça antes de otimizar. Otimizar por palpite muda código sem mudar o tempo.
+
+**O que quase sempre é o culpado, nesta ordem**: imagem gigante servida em
+tamanho de tela cheia; fonte externa bloqueando a renderização; JavaScript que
+roda antes de a página aparecer; biblioteca inteira importada para usar uma
+função.
+
+**Imagem**: dimensione para o tamanho em que aparece, use formato moderno
+(WebP/AVIF), declare `width` e `height` no HTML (sem isso a página pula
+enquanto carrega) e `loading="lazy"` no que está abaixo da dobra.
+
+**Fonte**: `font-display: swap`, e prefira a fonte do sistema quando a marca
+não exige outra. Uma fonte externa custa uma conexão e um bloqueio.
+
+**JavaScript**: nada que não seja necessário para a primeira tela. `defer` no
+que puder esperar. Antes de adicionar uma biblioteca, escreva a função — três
+linhas suas custam menos que 40 KB de dependência.
+
+**CSS**: evite seletor que força recálculo em rolagem; anime só `transform` e
+`opacity`.
+
+Prove com número: o tamanho do que é baixado antes e depois.

package/skills/revisao-antes-de-entregar/SKILL.md

@@ -0,0 +1,27 @@
+---
+nome: Revisão antes de entregar
+descricao: confere o próprio trabalho antes de dizer que acabou
+quando: pronto, terminar, entregar, finalizar, revisar, conferir, testar, verificar
+autor: PrimoCode
+---
+Antes de dizer que terminou, PROVE. A mentira mais comum de um agente é
+"pronto" sem prova, e ela custa a confiança inteira.
+
+O que conta como prova, por tipo de entrega:
+
+- **Página HTML**: abra com `browser_open` e leia o console. Erro no console é
+  tarefa inacabada, mesmo que a página pareça certa. Confira que o texto
+  aparece de verdade — página em branco por TypeError na primeira linha
+  responde 200 e tem título.
+- **Código com teste**: rode o comando de teste do projeto e mostre a saída
+  real. Nunca escreva "os testes passam" sem a saída na mão.
+- **Código sem teste**: execute o caminho principal uma vez. Se não dá para
+  executar, diga isso em vez de afirmar que funciona.
+- **Arquivo de configuração**: leia de volta o que escreveu.
+
+Releia o seu próprio diff antes de terminar, procurando o que você mesmo
+quebraria: caminho que não existe, promessa sem await, variável que só existe
+num dos ramos, texto de exemplo esquecido.
+
+Se algo ficou por fazer, diga em UMA linha o que foi e por quê. Entregar 90%
+dizendo a verdade vale mais que entregar 90% dizendo 100%.

package/skills/slides-que-prendem/SKILL.md

@@ -0,0 +1,40 @@
+---
+nome: Slides que prendem
+descricao: apresentação sem template, que se lê de longe e não entedia
+quando: slides, slide, apresentação, apresentacao, deck, pitch, palestra
+autor: PrimoCode
+---
+Slide não é documento projetado. Se ele se lê inteiro em voz alta, é um
+documento — e o público já leu antes de você falar.
+
+## A estrutura, sem modelo pronto
+
+Não existe "layout capa" nem "layout duas colunas". Cada slide é composto do
+zero, como uma cena: fundo, elementos posicionados, tipografia escolhida.
+
+O que existe é uma ORDEM que funciona: a tensão antes da solução. Comece pelo
+problema que a plateia reconhece, não pela apresentação de quem fala.
+
+## Uma ideia por slide
+
+Se precisa rolar o olho para ler, dividiu errado. Título que é uma AFIRMAÇÃO
+("o custo dobrou em 6 meses"), não um rótulo ("custos").
+
+Número grande é slide inteiro: um número, uma linha do que ele significa, e
+mais nada.
+
+## Legibilidade antes de beleza
+
+Texto de corpo nunca abaixo de 28pt no 1920×1080. Contraste alto — slide é
+visto em sala com luz. No máximo duas fontes e três cores.
+
+## Ritmo
+
+Varie: slide denso, slide de respiro, slide de número, slide de citação.
+Quinze slides iguais em sequência perdem qualquer plateia, por melhores que
+sejam.
+
+## Prova
+
+Todo dado tem origem escrita ao lado, pequena. Dado sem fonte é opinião com
+fonte tipográfica melhor — e alguém vai perguntar.

package/studio/edge.py

@@ -117,81 +117,32 @@ def disponivel():
     return _verificado
 
 
-# Por que a instalação falhava calada, e o vídeo saía com a voz do Google:
-# `pip install --user` é recusado pelo Python do sistema em Debian/Ubuntu e
-# no do Homebrew ("externally-managed-environment", PEP 668), e em máquina
-# sem pip o `-m pip` nem existe. Um `pip install` só, em segundo plano, com a
-# saída jogada fora, era exatamente a falha que ninguém vê. Agora são várias
-# tentativas, em ordem, e a última linha do erro de cada uma fica guardada
-# para o status contar o que houve.
-ESTRATEGIAS = [
-    ["-m", "pip", "install", "--user", "--quiet", "edge-tts"],
-    ["-m", "pip", "install", "--user", "--quiet", "--break-system-packages", "edge-tts"],
-    ["-m", "pip", "install", "--quiet", "edge-tts"],
-    ["-m", "pip", "install", "--quiet", "--break-system-packages", "edge-tts"],
-]
-_ultimo_erro = ""
-_thread = None
-
-
 def _rotina_instalar():
-    global _instalando, _verificado, _ultimo_erro
+    global _instalando, _verificado
     try:
-        # Sem pip, primeiro o ensurepip — é o que o python.org e a Apple
-        # trazem para o caso.
-        try:
-            r = subprocess.run([sys.executable, "-m", "pip", "--version"],
-                               stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, timeout=30)
-            if r.returncode != 0:
-                subprocess.run([sys.executable, "-m", "ensurepip", "--user", "--default-pip"],
-                               stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, timeout=120)
-        except Exception:
-            pass
-        for args in ESTRATEGIAS:
-            try:
-                r = subprocess.run([sys.executable] + args, stdout=subprocess.DEVNULL,
-                                   stderr=subprocess.PIPE, timeout=240)
-            except Exception as e:
-                _ultimo_erro = str(e)[-200:]
-                continue
-            _verificado = None
-            if r.returncode == 0 and disponivel():
-                _ultimo_erro = ""
-                sys.stderr.write("[edge] edge-tts instalado (%s)\n" % " ".join(args[2:]))
-                return
-            _ultimo_erro = (r.stderr or b"").decode("utf-8", "replace").strip().splitlines()[-1:][0][-200:] \
-                if (r.stderr or b"").strip() else "pip devolveu %s" % r.returncode
-        sys.stderr.write("[edge] não consegui instalar o edge-tts: %s\n" % _ultimo_erro)
+        subprocess.run(
+            [sys.executable, "-m", "pip", "install", "--user", "--quiet", "edge-tts"],
+            stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL, timeout=180)
+    except Exception as e:
+        sys.stderr.write("[edge] pip install falhou: %s\n" % e)
     finally:
         _verificado = None          # força nova checagem
         with _tranca:
             _instalando = False
 
 
-def instalar(esperar=0):
-    """Traz o pacote — em segundo plano por padrão; com `esperar` (segundos),
-    quem chamou fica aguardando até esse teto.
-
-    Esperar existe porque a narração de um vídeo NÃO pode sair pela voz de
-    reserva só porque o pip ainda estava rodando: quem pede voz agora e tem
-    internet merece a voz neural agora. Meio minuto de pip é menos ruim que
-    um vídeo inteiro com voz de robô."""
-    global _instalando, _thread
+def instalar():
+    """Tenta trazer o pacote em segundo plano, uma vez. Não bloqueia: quem
+    pediu narração agora ouve o próximo motor da corrente, e a partir da
+    próxima vez o Edge já responde."""
+    global _instalando
     if disponivel():
-        return True
+        return
     with _tranca:
-        if not _instalando:
-            _instalando = True
-            _thread = threading.Thread(target=_rotina_instalar, daemon=True)
-            _thread.start()
-        t = _thread
-    if t and esperar:
-        t.join(esperar)
-    return disponivel()
-
-
-def ultimo_erro():
-    return _ultimo_erro
+        if _instalando:
+            return
+        _instalando = True
+    threading.Thread(target=_rotina_instalar, daemon=True).start()
 
 
 def _dur_do_vtt(caminho):
@@ -264,7 +215,6 @@ def estado():
         "motor": "edge",
         "disponivel": disponivel(),
         "instalando": inst,
-        "erro": _ultimo_erro or None,
         "precisa_internet": True,
         "vozes": [{"id": v["id"], "nome": v["nome"], "genero": v["genero"],
                    "padrao": bool(v.get("padrao"))} for v in CATALOGO],