primocode 8.32.0 → 8.33.1

package/lib/boas-vindas.js

@@ -0,0 +1,161 @@
+/**
+ * boas-vindas.js — a primeira vez que alguém roda `primo`.
+ *
+ *   "Eu desinstalei e instalei novamente, está na versão nova, e quando mandei
+ *    ele já abriu. Não veio a parte pra mim fazer login, selecionar qual IA eu
+ *    quero — se quero usar já o Conecta Primo AI como IA, se quero usar outra
+ *    IA. Não tem nada disso."
+ *
+ * Tinha razão: o CLI abria direto no prompt. Quem instalava não descobria que
+ * existe conta, não descobria que dá para usar a própria chave, e ia usar o
+ * gratuito achando que era só aquilo — até bater na cota e concluir que o
+ * produto não presta.
+ *
+ * ── POR QUE ISTO É UM MÓDULO, E NÃO CÓDIGO SOLTO NO bin/ ─────────────────
+ * Porque tem decisão dentro: quando aparecer, o que perguntar, o que gravar,
+ * e o que fazer quando a pessoa só aperta Enter. Isso precisa de teste, e
+ * teste não digita em terminal. Aqui a entrada e a saída são funções que o
+ * teste passa; o bin/ liga nas de verdade.
+ *
+ * ── APARECE UMA VEZ SÓ, E DÁ PARA PULAR ──────────────────────────────────
+ * Um assistente que volta toda vez vira obstáculo. Este grava a marca de que
+ * já rodou e não volta — nem se a pessoa escolher "depois". Quem quiser
+ * rever chama `/conectar` ou `/chave`, que é onde as duas coisas moram.
+ */
+
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const MARCA = () => path.join(os.homedir(), '.primocode', 'ja-abriu.json');
+
+/**
+ * Já passou por aqui?
+ *
+ * Duas provas, e basta uma: a marca própria, ou um config.json que já existe
+ * de uma versão anterior. A segunda evita que quem já usava o PrimoCode há
+ * meses veja um "bem-vindo, é sua primeira vez" ao atualizar — o que faria a
+ * atualização parecer uma reinstalação, e é o tipo de coisa que assusta.
+ */
+function jaAbriu({ arquivoConfig } = {}) {
+    try { if (fs.existsSync(MARCA())) return true; } catch {}
+    try { if (arquivoConfig && fs.existsSync(arquivoConfig)) return true; } catch {}
+    return false;
+}
+
+function marcarQueAbriu(dados = {}) {
+    try {
+        const caminho = MARCA();
+        fs.mkdirSync(path.dirname(caminho), { recursive: true });
+        fs.writeFileSync(caminho, JSON.stringify({
+            em: new Date().toISOString(), ...dados,
+        }, null, 2), 'utf8');
+        return true;
+    } catch { return false; }
+}
+
+/** Para o teste e para quem quiser rever: apaga a marca. */
+function esquecer() {
+    try { fs.rmSync(MARCA(), { force: true }); return true; } catch { return false; }
+}
+
+const ESCOLHAS = [
+    {
+        id: 'conecta',
+        titulo: 'Usar a IA do Conecta Primo AI',
+        detalhe: 'A que já vem pronta. Entra na sua conta; Premium ou Super libera o limite.',
+    },
+    {
+        id: 'propria',
+        titulo: 'Usar a minha própria IA',
+        detalhe: 'Sua chave do Claude ou do Codex, ou o Claude Code / Codex já instalados.',
+    },
+    {
+        id: 'depois',
+        titulo: 'Decidir depois',
+        detalhe: 'Começa no gratuito. /conectar e /chave estão lá quando você quiser.',
+    },
+];
+
+/** O que a pessoa digitou → qual escolha. Aceita número, o id, ou Enter. */
+function lerEscolha(texto) {
+    const t = String(texto || '').trim().toLowerCase();
+    // Enter puro é a primeira opção: é a recomendada, e quem aperta Enter sem
+    // ler está dizendo "faz o que for melhor", não "não quero nada".
+    if (!t) return ESCOLHAS[0].id;
+    const n = Number(t);
+    if (Number.isInteger(n) && n >= 1 && n <= ESCOLHAS.length) return ESCOLHAS[n - 1].id;
+    for (const e of ESCOLHAS) if (t === e.id || t.startsWith(e.id.slice(0, 4))) return e.id;
+    if (/^(n|nao|não|depois|pular|skip)$/.test(t)) return 'depois';
+    if (/claude|codex|chave|propri/.test(t)) return 'propria';
+    if (/conecta|primo|conta|entrar/.test(t)) return 'conecta';
+    return null;      // não entendi: quem chama pergunta de novo
+}
+
+/**
+ * O assistente.
+ *
+ * @param {object} op
+ * @param {(q:string)=>Promise<string>} op.perguntar  lê uma linha
+ * @param {(s:string)=>void} op.mostrar               escreve na tela
+ * @param {object} op.cores                           o `c` do ui.js
+ * @param {()=>Promise<any>} op.conectar              roda o login (o /conectar)
+ * @param {()=>Promise<any>} op.configurarChave       abre o /chave
+ * @param {boolean} op.interativo                     false = não pergunta nada
+ */
+async function rodar({ perguntar, mostrar, cores: c, conectar, configurarChave,
+    interativo = true } = {}) {
+    /* Sem terminal de verdade (pipe, script, CI) NÃO se pergunta nada. Um
+       assistente que espera resposta num lugar onde ninguém pode responder
+       trava o processo para sempre — e trava calado, que é o pior jeito. */
+    if (!interativo) {
+        marcarQueAbriu({ escolha: 'sem-terminal' });
+        return { ok: true, escolha: 'depois', perguntou: false };
+    }
+
+    mostrar('');
+    mostrar(c.bold(c.brand('  Primeira vez por aqui.')));
+    mostrar(c.muted('  Escolha qual IA vai pensar por trás do PrimoCode:'));
+    mostrar('');
+    ESCOLHAS.forEach((e, i) => {
+        mostrar('  ' + c.brand(String(i + 1)) + c.muted('. ') + c.white(e.titulo)
+            + (i === 0 ? c.dim('  (recomendado)') : ''));
+        mostrar('     ' + c.dim(e.detalhe));
+    });
+    mostrar('');
+
+    let escolha = null;
+    for (let tentativa = 0; tentativa < 3 && !escolha; tentativa++) {
+        const dito = await perguntar(c.brand('  ❯ ') + c.muted('1, 2 ou 3 (Enter = 1) '));
+        escolha = lerEscolha(dito);
+        if (!escolha) mostrar(c.muted('  Não entendi. Digite 1, 2 ou 3.'));
+    }
+    // Três tentativas sem entender: segue no gratuito em vez de insistir.
+    // Ninguém deve ficar preso numa pergunta para usar o programa.
+    if (!escolha) escolha = 'depois';
+
+    let resultado = { escolha };
+    if (escolha === 'conecta' && conectar) {
+        mostrar('');
+        resultado.conexao = await conectar();
+    } else if (escolha === 'propria' && configurarChave) {
+        mostrar('');
+        resultado.chave = await configurarChave();
+    } else if (escolha === 'depois') {
+        mostrar('');
+        mostrar(c.muted('  Tudo bem. Você está no gratuito — ele funciona, mas tem cota.'));
+        mostrar(c.dim('  ') + c.brand('/conectar') + c.dim(' entra na sua conta · ')
+            + c.brand('/chave') + c.dim(' usa a sua própria IA'));
+    }
+
+    // A marca é gravada DEPOIS de tudo, mas grava mesmo se o login falhar:
+    // insistir no assistente a cada abertura porque a rede caiu uma vez
+    // seria punir a pessoa por um problema que não é dela.
+    marcarQueAbriu({ escolha });
+    mostrar('');
+    return { ok: true, perguntou: true, ...resultado };
+}
+
+module.exports = { jaAbriu, marcarQueAbriu, esquecer, lerEscolha, rodar, ESCOLHAS, MARCA };

package/lib/modo.js

@@ -109,10 +109,50 @@ function escolherModo(texto, ctx = {}) {
     if (RE_SAUDACAO.test(t)) return { modo: 'chat', motivo: 'cumprimento' };
     if (RE_SATISFEITO.test(t)) return { modo: 'chat', motivo: 'está satisfeito' };
 
-    // Pergunta sobre ele mesmo, e pergunta conceitual, ganham do verbo:
-    // "como faço para criar um site?" é dúvida, não pedido de execução.
+    // Pergunta sobre ele mesmo ganha do verbo: "o que você faz?" é dúvida.
     if (RE_SOBRE_ELE.test(t)) return { modo: 'chat', motivo: 'pergunta sobre ele' };
-    if (RE_CONCEITUAL.test(t)) return { modo: 'chat', motivo: 'pergunta conceitual' };
+
+    /* ── A ENCOMENDA GANHA DA PERGUNTA ───────────────────────────────────
+       "como faço para criar um site?" é dúvida. Mas "pesquise COMO FUNCIONA
+       o WAV e escreva o resultado em wav.md" é encomenda: tem verbo de ação E
+       diz o arquivo que deve nascer. A frase conceitual ali é o ASSUNTO do
+       trabalho, não o pedido.
+
+       Antes, a checagem conceitual vinha antes destas duas e ganhava sempre.
+       O efeito era mudo: o pedido virava conversa, a resposta vinha certa, e
+       o arquivo NUNCA nascia — com um "não posso criar arquivos" no fim, que
+       é a única pista, e ela chega depois de a pessoa já ter esperado.
+       Aconteceu de verdade num teste: `wav.md` não existiu, e "crie uma
+       apresentação sobre X: o que é, o que faz…" foi para o chat porque o
+       ROTEIRO DOS SLIDES tinha "o que é" dentro.
+
+       O que separa uma coisa da outra é ONDE a frase conceitual está. No
+       COMEÇO ela governa a frase inteira e é a pergunta: "como faço para
+       criar um site?", "por que o node é assíncrono". Mais para dentro, ela
+       é o assunto de um pedido que já começou com outra coisa: "pesquise
+       como funciona…", "crie uma apresentação: o que é, o que faz…".
+
+       E nem o arquivo nomeado escapa da regra: "pra que serve o package.json"
+       cita um arquivo e continua sendo pergunta. O que decide é a POSIÇÃO,
+       não a presença. */
+    const conceitual = t.match(RE_CONCEITUAL);
+    if (conceitual) {
+        /* O que decide é o que vem ANTES dela. Se a frase já tinha começado
+           com um verbo de ação, a pergunta é o assunto do trabalho:
+
+             "pesquise | como funciona o WAV e escreva em wav.md"  → encomenda
+             "crie uma apresentação: | o que é, o que faz…"        → encomenda
+             "| pra que serve o package.json"                      → pergunta
+             "| como funciona o WAV?"                              → pergunta
+             "me | explica o que é recursão"                       → pergunta
+
+           Contar caracteres não serve: "pesquise" tem nove letras e "crie uma
+           apresentação de 4 slides sobre o PrimoCode:" tem quarenta e três, e
+           os dois são a mesma coisa. Quem manda é o verbo, não a régua. */
+        const antes = t.slice(0, conceitual.index);
+        const jaEraOrdem = RE_VERBO.test(antes) || RE_PECA.test(antes);
+        if (!jaEraOrdem) return { modo: 'chat', motivo: 'pergunta conceitual' };
+    }
 
     // "refaz", "de novo", "continua" — retomada, com ou sem contexto.
     if (RE_CONTINUACAO.test(t)) return { modo: 'primocode', motivo: 'retoma a tarefa' };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primocode",
-  "version": "8.32.0",
+  "version": "8.33.1",
   "description": "PrimoCode — agente de engenharia com IA e cursor próprio. Modelos grátis. 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/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"
+    "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/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"
   },
   "engines": {
     "node": ">=18.17.0"