primocode 9.2.2 → 9.2.3

package/README.md

@@ -1,4 +1,4 @@
-# PrimoCode v9.2.2
+# PrimoCode v9.2.3
 
 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 v9.2.2
+ ▐▛███▜▌   Primo Code v9.2.3
 ▝▜█████▛▘  Bem-vindo de volta, Joel
   ▘▘ ▝▝    ~/primocode  · /dir <pasta> muda
 ```

package/lib/estudio/index.js

@@ -81,6 +81,31 @@ function rodarPython(script, args, { timeout = 20 * 60000 } = {}) {
 
 // ── estudio_projeto ──────────────────────────────────────────────────────
 
+/**
+ * A queixa quando o projeto não aparece — e ela muda conforme o motivo.
+ *
+ * "não achei o projeto 'undefined'" é o que o agente recebia ao chamar a
+ * ferramenta SEM id, e não ensina nada: ele não sabe se inventou o id, se o
+ * projeto sumiu, ou se esqueceu o argumento. Visto em produção — o modelo
+ * chamou `estudio_plano` sem id e ficou repetindo a chamada.
+ */
+function semProjeto(id) {
+    if (id == null || String(id).trim() === '') {
+        return {
+            ok: false,
+            error: 'faltou dizer em qual projeto (id).',
+            comoResolver: 'crie um com estudio_projeto acao:"criar" e use o id que ele devolve, '
+                + 'ou ache o existente com acao:"listar" / acao:"procurar".',
+        };
+    }
+    return {
+        ok: false,
+        error: `não achei o projeto "${id}".`,
+        comoResolver: 'liste com estudio_projeto acao:"listar" e use um id de lá — '
+            + 'o id é o nome da pasta (ex: "2026-09-22-anuncio-picpay"), não o título.',
+    };
+}
+
 async function ferramentaProjeto(args) {
     const acao = String(args.acao || 'listar').toLowerCase();
 
@@ -93,7 +118,7 @@ async function ferramentaProjeto(args) {
 
     if (acao === 'abrir' || acao === 'ler') {
         const p = projeto.ler(args.id);
-        if (!p) return { ok: false, error: `não achei o projeto "${args.id}". Use acao:"procurar".` };
+        if (!p) return semProjeto(args.id);
         const pl = projeto.lerPlano(args.id);
         return {
             ok: true, projeto: p,
@@ -142,7 +167,7 @@ function listarArquivos(pasta) {
 
 async function ferramentaPlano(args) {
     const p = projeto.ler(args.id);
-    if (!p) return { ok: false, error: `não achei o projeto "${args.id}".` };
+    if (!p) return semProjeto(args.id);
 
     if (args.voltarPara) return projeto.voltarPara(args.id, args.voltarPara);
 
@@ -193,7 +218,7 @@ async function ferramentaPlano(args) {
 async function ferramentaMidia(args) {
     const acao = String(args.acao || 'imagem').toLowerCase();
     const p = args.id ? projeto.ler(args.id) : null;
-    if (args.id && !p) return { ok: false, error: `não achei o projeto "${args.id}".` };
+    if (args.id && !p) return semProjeto(args.id);
 
     if (acao === 'fontes') {
         if (args.conferir) return assets.conferirFonte(args.conferir);
@@ -282,7 +307,7 @@ async function ferramentaNarrar(args) {
     if (args.vozes) return rodarPython('narrar.py', ['vozes'], { timeout: 30000 });
 
     const p = projeto.ler(args.id);
-    if (!p) return { ok: false, error: `não achei o projeto "${args.id}".` };
+    if (!p) return semProjeto(args.id);
     const texto = String(args.texto || '').trim();
     if (!texto) return { ok: false, error: 'não há texto para narrar.' };
 
@@ -313,7 +338,7 @@ async function ferramentaNarrar(args) {
 async function ferramentaVideo(args, ctx = {}) {
     const acao = String(args.acao || 'medir').toLowerCase();
     const p = projeto.ler(args.id);
-    if (!p) return { ok: false, error: `não achei o projeto "${args.id}".` };
+    if (!p) return semProjeto(args.id);
 
     const pronto = video.conferir();
     if (!pronto.ok) return pronto;
@@ -436,7 +461,7 @@ async function transcrever(p, alvo, ctx) {
 
 async function ferramentaRender(args, ctx = {}) {
     const p = projeto.ler(args.id);
-    if (!p) return { ok: false, error: `não achei o projeto "${args.id}".` };
+    if (!p) return semProjeto(args.id);
     const pl = projeto.lerPlano(args.id);
     if (!pl) return { ok: false, error: 'não há plano neste projeto.' };
 

package/lib/estudio/projeto.js

@@ -103,13 +103,38 @@ function lerJSON(arquivo, padrao = null) {
     try { return JSON.parse(fs.readFileSync(arquivo, 'utf8')); } catch { return padrao; }
 }
 
-const pastaDe = (id) => path.join(PROJETOS, id);
+/**
+ * A pasta de um projeto — ou null, quando o id não serve.
+ *
+ * ── POR QUE ISTO VALIDA, EM VEZ DE SÓ CONCATENAR ────────────────────────
+ * O `id` vem do MODELO, e o modelo erra de dois jeitos que doem aqui:
+ *
+ * 1. Não manda nada. Visto em produção: o agente chamou `estudio_plano` sem
+ *    `id`, o `path.join` recebeu `undefined` e a tool explodiu com
+ *    'The "path" argument must be of type string. Received undefined' — uma
+ *    mensagem que não fala de projeto nenhum, e que o agente não tem como
+ *    corrigir porque não diz o que faltou. A checagem de "achei o projeto?"
+ *    vinha DEPOIS, e nunca era alcançada.
+ *
+ * 2. Manda um id com caminho dentro ("../../etc/passwd", "/tmp/x"). O
+ *    `path.join` obedece: sobe de pasta e sai da casa dos projetos. O id de
+ *    um projeto é um nome de pasta, não um caminho — então tudo que tem
+ *    barra ou `..` é recusado, em vez de resolvido.
+ */
+function pastaDe(id) {
+    if (typeof id !== 'string' || !id.trim()) return null;
+    const limpo = id.trim();
+    if (limpo.includes('/') || limpo.includes('\\') || limpo.includes('..')) return null;
+    return path.join(PROJETOS, limpo);
+}
 
 /** O meta de um projeto, ou null. */
 function ler(id) {
-    const meta = lerJSON(path.join(pastaDe(id), 'projeto.json'));
+    const pasta = pastaDe(id);
+    if (!pasta) return null;
+    const meta = lerJSON(path.join(pasta, 'projeto.json'));
     if (!meta) return null;
-    return { ...meta, pasta: pastaDe(id) };
+    return { ...meta, pasta };
 }
 
 function salvar(id, mudancas) {
@@ -142,17 +167,21 @@ function listar({ limite = 50 } = {}) {
  * perde um caderno quando o processo morre no meio.
  */
 function anotar(id, tipo, texto, extra = {}) {
+    const pasta = pastaDe(id);
+    if (!pasta) return false;
     const linha = JSON.stringify({ quando: agora(), tipo, texto: String(texto || ''), ...extra });
     try {
-        fs.mkdirSync(pastaDe(id), { recursive: true });
-        fs.appendFileSync(path.join(pastaDe(id), 'caderno.jsonl'), linha + '\n', 'utf8');
+        fs.mkdirSync(pasta, { recursive: true });
+        fs.appendFileSync(path.join(pasta, 'caderno.jsonl'), linha + '\n', 'utf8');
         return true;
     } catch { return false; }
 }
 
 function caderno(id, { ultimas = 40 } = {}) {
+    const pasta = pastaDe(id);
+    if (!pasta) return [];
     let bruto = '';
-    try { bruto = fs.readFileSync(path.join(pastaDe(id), 'caderno.jsonl'), 'utf8'); } catch { return []; }
+    try { bruto = fs.readFileSync(path.join(pasta, 'caderno.jsonl'), 'utf8'); } catch { return []; }
     const linhas = bruto.split('\n').filter(Boolean).slice(-ultimas);
     return linhas.map((l) => { try { return JSON.parse(l); } catch { return null; } }).filter(Boolean);
 }
@@ -193,9 +222,11 @@ function procurar(texto, { limite = 5 } = {}) {
 
 // ── o plano ──────────────────────────────────────────────────────────────
 
-const planoDe = (id) => path.join(pastaDe(id), 'plano.json');
+// null quando o id não serve — e `lerJSON(null)` devolve null, que é o que
+// todo mundo aqui já sabe tratar.
+const planoDe = (id) => { const p = pastaDe(id); return p ? path.join(p, 'plano.json') : null; };
 
-function lerPlano(id) { return lerJSON(planoDe(id)); }
+function lerPlano(id) { const a = planoDe(id); return a ? lerJSON(a) : null; }
 
 /**
  * Grava o plano e guarda a versão anterior.
@@ -205,9 +236,11 @@ function lerPlano(id) { return lerJSON(planoDe(id)); }
  * nada é sobrescrito sem uma cópia ficar para trás.
  */
 function salvarPlano(id, plano, motivo = '') {
+    const pasta = pastaDe(id);
+    if (!pasta) return { ok: false, error: `Projeto "${id}" não existe.` };
     const anterior = lerPlano(id);
     if (anterior) {
-        const versoes = path.join(pastaDe(id), 'versoes');
+        const versoes = path.join(pasta, 'versoes');
         fs.mkdirSync(versoes, { recursive: true });
         const n = fs.readdirSync(versoes).filter((f) => f.endsWith('.json')).length + 1;
         escreverJSON(path.join(versoes, `${String(n).padStart(3, '0')}.json`), anterior);
@@ -218,12 +251,16 @@ function salvarPlano(id, plano, motivo = '') {
 }
 
 function versoes(id) {
-    const dir = path.join(pastaDe(id), 'versoes');
+    const pasta = pastaDe(id);
+    if (!pasta) return [];
+    const dir = path.join(pasta, 'versoes');
     try { return fs.readdirSync(dir).filter((f) => f.endsWith('.json')).sort(); } catch { return []; }
 }
 
 function voltarPara(id, versao) {
-    const arquivo = path.join(pastaDe(id), 'versoes', versao);
+    const pasta = pastaDe(id);
+    if (!pasta) return { ok: false, error: `Projeto "${id}" não existe.` };
+    const arquivo = path.join(pasta, 'versoes', String(versao || '').replace(/[^\w.-]+/g, ''));
     const plano = lerJSON(arquivo);
     if (!plano) return { ok: false, error: `Versão "${versao}" não existe.` };
     salvarPlano(id, plano, `voltou para a versão ${versao}`);
@@ -232,9 +269,11 @@ function voltarPara(id, versao) {
 
 /** Onde guardar uma mídia baixada, com nome que não colide. */
 function caminhoDeMidia(id, nome) {
+    const pasta = pastaDe(id);
+    if (!pasta) return null;
     const limpo = String(nome || 'arquivo').replace(/[^\w.-]+/g, '-').slice(-60);
     const marca = crypto.randomBytes(3).toString('hex');
-    return path.join(pastaDe(id), 'midia', `${marca}-${limpo}`);
+    return path.join(pasta, 'midia', `${marca}-${limpo}`);
 }
 
 module.exports = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primocode",
-  "version": "9.2.2",
+  "version": "9.2.3",
   "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": {