primocode 10.15.1 → 10.16.0

package/lib/memoria-usuario.js

@@ -0,0 +1,164 @@
+/**
+ * memoria-usuario.js — o PrimoCode lembra de quem a pessoa é.
+ *
+ * A memória que vale entre sessões, do jeito do Claude Code: um fato por
+ * arquivo .md em ~/.primocode/memoria/, e um índice MEMORIA.md com uma linha
+ * por fato. O índice entra no contexto de TODA sessão; o corpo de cada fato
+ * o modelo lê quando precisa (read_file no caminho).
+ *
+ *   ~/.primocode/memoria/MEMORIA.md          - [Título](arquivo.md) — gancho
+ *   ~/.primocode/memoria/<nome-em-kebab>.md  frontmatter (nome, descricao, tipo) + corpo
+ *
+ * Difere do memory-geral.md (uma lista corrida de frases) e do AGENTS.md da
+ * pasta (o resumo da conversa): aqui cada fato tem nome, tipo e pode ser
+ * atualizado ou apagado sem duplicar.
+ *
+ * HOME é injetável, como em lib/estudio/gosto.js: o teste usa uma casa temporária.
+ */
+
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const TIPOS = ['usuario', 'feedback', 'projeto', 'referencia'];
+const LINHAS_DO_INDICE = 200;
+const LIMITE_TEXTO = 8000;
+const INDICE = 'MEMORIA.md';
+
+// Cara de segredo: o fato fica em disco e volta em todo prompt, então chave não entra.
+const SEGREDOS = [
+    /\bsk-[A-Za-z0-9_-]{8,}/,
+    /\bAIza[0-9A-Za-z_-]{10,}/,
+    /\bgh[pousr]_[A-Za-z0-9]{10,}/,
+    /-----BEGIN [A-Z ]*(?:PRIVATE KEY|CERTIFICATE)?-----/,
+    /\bxox[abprs]-[A-Za-z0-9-]{8,}/,
+    /\bAKIA[0-9A-Z]{12,}/,
+    /\b(?:senha|password|passwd|token|api[_-]?key|secret)\s*[:=]\s*\S+/i,
+];
+
+function pasta(home = os.homedir()) { return path.join(home, '.primocode', 'memoria'); }
+function arquivoIndice(home) { return path.join(pasta(home), INDICE); }
+
+/** "Prefere Respostas Curtas!" → "prefere-respostas-curtas". '' se não sobrar nada. */
+function kebab(s) {
+    return String(s || '').normalize('NFD').replace(/[̀-ͯ]/g, '').toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 60).replace(/-+$/, '');
+}
+
+function umaLinha(s) { return String(s || '').replace(/\s+/g, ' ').trim(); }
+
+/** O texto parece ter segredo? Devolve true/false. Puro. */
+function temSegredo(...textos) {
+    return textos.some((t) => SEGREDOS.some((re) => re.test(String(t || ''))));
+}
+
+/** "usuario-prefere-curto" → "Usuario prefere curto": o título que aparece no índice. */
+function titulo(nome) {
+    const t = String(nome || '').replace(/-/g, ' ');
+    return t.charAt(0).toUpperCase() + t.slice(1);
+}
+
+function montar({ nome, descricao, tipo, texto }) {
+    return `---\nnome: ${nome}\ndescricao: ${descricao}\ntipo: ${tipo}\n---\n\n${String(texto).trim()}\n`;
+}
+
+/** Lê o frontmatter simples (chave: valor) e o corpo. null se não tem. */
+function analisar(conteudo) {
+    const m = String(conteudo || '').match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+    if (!m) return null;
+    const meta = {};
+    for (const l of m[1].split('\n')) {
+        const i = l.indexOf(':');
+        if (i > 0) meta[l.slice(0, i).trim()] = l.slice(i + 1).trim();
+    }
+    return { ...meta, corpo: m[2].trim() };
+}
+
+/** Todas as memórias, em ordem alfabética do arquivo. */
+function listar(home) {
+    let nomes = [];
+    try { nomes = fs.readdirSync(pasta(home)); } catch { return []; }
+    const saida = [];
+    for (const f of nomes.sort()) {
+        if (!f.endsWith('.md') || f === INDICE) continue;
+        let a = null;
+        try { a = analisar(fs.readFileSync(path.join(pasta(home), f), 'utf-8')); } catch { /* ilegível: pula */ }
+        if (!a) continue;
+        saida.push({ nome: a.nome || f.slice(0, -3), descricao: a.descricao || '', tipo: a.tipo || '', arquivo: f, corpo: a.corpo });
+    }
+    return saida;
+}
+
+/** Refaz o MEMORIA.md a partir dos arquivos: o índice nunca desanda do que existe. */
+function reindexar(home) {
+    const linhas = listar(home).map((m) => `- [${titulo(m.nome)}](${m.arquivo}) — ${m.descricao}`);
+    fs.mkdirSync(pasta(home), { recursive: true });
+    fs.writeFileSync(arquivoIndice(home), linhas.length ? linhas.join('\n') + '\n' : '', 'utf-8');
+}
+
+/**
+ * Salva ou atualiza (mesmo nome = mesmo arquivo, sem duplicar).
+ * Devolve { ok, nome, arquivo, criado } ou { ok:false, error }.
+ */
+function salvar({ nome, descricao, tipo, texto } = {}, home) {
+    const slug = kebab(nome);
+    if (!slug) return { ok: false, error: 'Dê um nome curto pra memória (ex.: "prefere-respostas-curtas").' };
+    const desc = umaLinha(descricao);
+    if (!desc) return { ok: false, error: 'Falta a descrição: uma linha dizendo do que se trata.' };
+    const t = String(tipo || '').toLowerCase();
+    if (!TIPOS.includes(t)) return { ok: false, error: `Tipo inválido. Use um destes: ${TIPOS.join(', ')}.` };
+    const corpo = String(texto || '').trim();
+    if (!corpo) return { ok: false, error: 'Falta o texto da memória.' };
+    if (corpo.length > LIMITE_TEXTO) return { ok: false, error: `Texto grande demais (máx. ${LIMITE_TEXTO} letras). Resuma.` };
+    if (temSegredo(nome, desc, corpo)) {
+        return { ok: false, error: 'Isso tem cara de segredo (chave, token ou senha). Não guardo isso na memória. Tire o segredo e tente de novo.' };
+    }
+    const arquivo = `${slug}.md`;
+    const caminho = path.join(pasta(home), arquivo);
+    const criado = !fs.existsSync(caminho);
+    try {
+        fs.mkdirSync(pasta(home), { recursive: true });
+        fs.writeFileSync(caminho, montar({ nome: slug, descricao: desc, tipo: t, texto: corpo }), 'utf-8');
+        reindexar(home);
+    } catch (e) { return { ok: false, error: `Não consegui gravar: ${e.message}` }; }
+    return { ok: true, nome: slug, arquivo, criado };
+}
+
+/** Apaga pelo nome. Devolve { ok } ou { ok:false, error }. */
+function apagar(nome, home) {
+    const slug = kebab(nome);
+    const caminho = path.join(pasta(home), `${slug}.md`);
+    if (!slug || !fs.existsSync(caminho)) return { ok: false, error: `Não achei a memória "${nome}".` };
+    try { fs.unlinkSync(caminho); reindexar(home); } catch (e) { return { ok: false, error: `Não consegui apagar: ${e.message}` }; }
+    return { ok: true, nome: slug };
+}
+
+/** O índice, cortado em `max` linhas (a cabeça fica). '' se não há memória. */
+function carregarIndice(home, max = LINHAS_DO_INDICE) {
+    let t = '';
+    try { t = fs.readFileSync(arquivoIndice(home), 'utf-8'); } catch { return ''; }
+    const linhas = t.split('\n').filter((l) => l.trim());
+    if (linhas.length <= max) return linhas.join('\n');
+    return linhas.slice(0, max).join('\n') + `\n(… cortado: mais ${linhas.length - max} memórias, use /memoria)`;
+}
+
+/** As regras de quando salvar. Entram no contexto junto com o índice. */
+const INSTRUCAO = '[memória]\n'
+    + 'Você tem memória que dura entre sessões, em ~/.primocode/memoria/ (ferramenta `lembrar`: ação salvar ou apagar). '
+    + 'O índice está abaixo; para ler uma memória, read_file no arquivo dela.\n'
+    + '- SALVE quando a pessoa corrige um jeito de trabalhar, diz uma preferência, conta quem é, ou dá um fato de projeto que não está no código. '
+    + 'tipo: usuario (quem é, como trabalha), feedback (correção ou preferência), projeto (fato do projeto), referencia (onde achar algo).\n'
+    + '- NÃO salve o que o código ou o git já mostram, nem o que só vale para esta conversa. Nunca salve chave, token ou senha.\n'
+    + '- ANTES de salvar, confira o índice: se já existe uma que cobre, salve com o MESMO nome para atualizar, em vez de duplicar.';
+
+/** O bloco que entra no contexto da sessão: instrução + índice. */
+/* No servidor (plano grátis) o contexto fixo é curto: o índice entra só com as primeiras `linhas`, e o resto
+   vira o aviso de corte. Com provedor próprio (/api) entra até LINHAS_DO_INDICE. */
+function blocoDoContexto(home, { linhas = LINHAS_DO_INDICE } = {}) {
+    const indice = carregarIndice(home, linhas);
+    return INSTRUCAO + (indice ? `\n\n[MEMORIA.md — o que você já sabe sobre esta pessoa]\n${indice}` : '\n\n(Ainda não há memórias salvas.)');
+}
+
+module.exports = { TIPOS, INDICE, LINHAS_DO_INDICE, pasta, arquivoIndice, kebab, temSegredo, listar, salvar, apagar, reindexar, carregarIndice, blocoDoContexto, INSTRUCAO };

package/lib/nuvem.js

@@ -300,6 +300,27 @@ async function lerConversa(id, { limite = 200 } = {}) {
     } catch (e) { return { ok: false, error: e.message }; }
 }
 
+/**
+ * Apaga uma conversa. O Firestore não apaga a subcoleção junto com o
+ * documento, então as mensagens vão antes, em lotes, e a conversa por último.
+ */
+async function apagarConversa(id) {
+    const s = await abrir();
+    if (!s) return { ok: false, error: 'não conectado' };
+    const base = `${BASE(s.projeto)}/users/${s.uid}/${COLECAO}/${id}`;
+    const auth = { Authorization: `Bearer ${s.idToken}` };
+    try {
+        for (let volta = 0; volta < 50; volta++) {
+            const r = await httpsJson(`${base}/messages?pageSize=300`, 'GET', null, auth);
+            const docs = r.documents || [];
+            if (!docs.length) break;
+            for (const d of docs) await httpsJson(`${FIRESTORE}/v1/${d.name}`, 'DELETE', null, auth);
+        }
+        await httpsJson(base, 'DELETE', null, auth);
+        return { ok: true };
+    } catch (e) { return { ok: false, error: e.message }; }
+}
+
 // ── o gravador da sessão ─────────────────────────────────────────────────
 
 /** Título a partir da primeira frase: uma linha, curta, sem cortar no meio de
@@ -388,7 +409,7 @@ module.exports = {
     cifrar, decifrar, cifrarJson, decifrarJson,
     gravador, tituloDe,
     abrir, esquecer,
-    salvarConversa, salvarMensagem, listarConversas, lerConversa,
+    salvarConversa, salvarMensagem, listarConversas, lerConversa, apagarConversa,
     COLECAO, VERSAO_CIFRA, ITERACOES, TAM_IV,
     // A tradução para o formato do Firestore sai daqui porque é ela que decide
     // o que vira `stringValue` em claro e o que vira `mapValue` cifrado.

package/lib/repeticao.js

@@ -100,7 +100,7 @@ function consultaDe(nome, args) {
  * ficam fora da época. */
 const OBSERVAM = new Set(['read_file', 'list_dir', 'glob', 'grep', 'browser_read', 'browser_screenshot',
     'desktop_screenshot', 'desktop_size', 'desktop_windows', 'desktop_elements']);
-const NAO_MUDAM = new Set(['write_todos', 'remember_general', 'pesquisar_referencia', ...REFERENCIAS]);
+const NAO_MUDAM = new Set(['write_todos', 'remember_general', 'lembrar', 'pesquisar_referencia', ...REFERENCIAS]);
 const SHELL_SO_LEITURA = /^\s*(ls|cat|head|tail|pwd|echo|grep|rg|find|wc|tree|stat|file|which|type|du|df|env|printenv|date|git\s+(status|log|diff|show|branch|remote))\b[^;&|>]*$/;
 
 function comandoDe(args) {

package/lib/sandbox.js

@@ -8,13 +8,18 @@
  *                           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.
+ * ~/.primocode/cache; ler quase tudo, MENOS os arquivos de credencial da
+ * LEITURA_NEGADA_HOME (chaves, tokens, a conta do PrimoCode, o Keychain) e
+ * .env*. Rede ligada (o `npm install` precisa), com opção de cortar.
+ * No macOS ainda fica de fora: osascript, o comando `security` (Keychain) e
+ * escrever hook em .git/hooks (rodaria FORA da cerca no próximo commit).
+ * O ssh-agent da pessoa fica fora por padrão (review do Arthur, #162): sem
+ * ele, "não lê ~/.ssh" vale de verdade, e não só para o arquivo.
  * 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"],
+ *                "rede": true, "ssh_agent": false, "env_permitidas": ["MINHA_KEY"],
  *                "escrita_extra": ["~/.npm"] }
  */
 'use strict';
@@ -25,10 +30,14 @@ 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 LEITURA_NEGADA_HOME = ['.ssh', '.aws', '.config/gcloud', '.npmrc',
+    '.primocode/conta.json', '.netrc', '.git-credentials', '.config/gh', '.docker', '.kube', 'Library/Keychains'];
+// Socket do ssh-agent do macOS (launchd). O caminho exato vem do SSH_AUTH_SOCK; a regex pega os outros.
+const SOCKET_SSH_MAC = '^/private/(tmp|var/run)/com\\.apple\\.launchd\\.[^/]+/Listeners$';
 const SECRETA = /(_KEY|_TOKEN|SECRET)/i;
 
 let _avisou = false;
+let _avisouDesligado = false;
 let _forcaMecanismo; // teste: undefined = detectar; null = ausente; 'seatbelt'|'bwrap'
 
 function arquivoConfig(home) { return path.join(home || os.homedir(), '.primocode', 'config.json'); }
@@ -43,6 +52,7 @@ function config(home) {
         ligado: typeof s.ligado === 'boolean' ? s.ligado : process.platform === 'darwin',
         modo: MODOS.includes(s.modo) ? s.modo : 'best_effort',
         rede: s.rede !== false,
+        ssh_agent: s.ssh_agent === true,
         env_permitidas: Array.isArray(s.env_permitidas) ? s.env_permitidas.map(String) : [],
         escrita_extra: Array.isArray(s.escrita_extra) ? s.escrita_extra.map(String) : [],
     };
@@ -68,6 +78,17 @@ function mecanismo() {
     return null;
 }
 
+/** Linha para a PESSOA ver no terminal (o stderr do comando só o modelo lê). Vai pro
+ *  stderr do processo para não sujar a saída do `-p`. */
+function avisarPessoa(msg) {
+    try { console.error(require('./ui.js').c.warn(`  ⎿ ${msg}`)); } catch { /* sem tela */ }
+}
+
+function socketSsh() {
+    const s = process.env.SSH_AUTH_SOCK;
+    try { return s && fs.statSync(s).isSocket() ? real(s) : null; } catch { 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, '\\"') + '"';
@@ -86,8 +107,20 @@ function perfilSeatbelt(projectDir, cfg = config(), home = os.homedir()) {
     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/"))');
+    // Hook em .git/hooks roda fora da cerca no próximo `git commit` da pessoa. O .sample do `git init` passa.
+    l.push('(deny file-write* (regex #"/\\.git/hooks/[^/]+$"))');
+    l.push('(allow file-write* (regex #"/\\.git/hooks/[^/]+\\.sample$"))');
     for (const p of negadosLeitura) l.push(`(deny file-read* (subpath ${sbq(real(p))}) (subpath ${sbq(p)}))`);
     l.push('(deny file-read* (regex #"/\\.env($|\\.[^/]*$)"))');
+    // osascript manda o Terminal/Finder fazer o que a cerca não deixa; `security` lê o Keychain.
+    l.push('(deny process-exec (literal "/usr/bin/osascript") (literal "/usr/bin/security"))');
+    l.push('(deny appleevent-send)');
+    l.push('(deny mach-lookup (global-name "com.apple.SecurityServer") (global-name "com.apple.securityd"))');
+    if (!cfg.ssh_agent) {
+        const sock = socketSsh();
+        l.push(`(deny network-outbound (remote unix-socket (path-regex #"${SOCKET_SSH_MAC}")))`);
+        if (sock) l.push(`(deny network-outbound (remote unix-socket (path-literal ${sbq(sock)})))`);
+    }
     if (!cfg.rede) l.push('(deny network*)');
     return l.join('\n');
 }
@@ -106,6 +139,11 @@ function argsBwrap(projectDir, cfg = config(), home = os.homedir()) {
             if (/^\.env($|\.)/.test(f)) a.push('--ro-bind', '/dev/null', path.join(real(projectDir), f));
         }
     } catch { /* pasta sumiu */ }
+    // Montado DEPOIS do --bind do projeto, para valer por cima dele. [VERIFICAR] no Linux.
+    const hooks = path.join(real(projectDir), '.git', 'hooks');
+    if (fs.existsSync(hooks)) a.push('--ro-bind', hooks, hooks);
+    const sock = cfg.ssh_agent ? null : socketSsh();
+    if (sock) a.push('--ro-bind', '/dev/null', sock);
     if (!cfg.rede) a.push('--unshare-net');
     a.push('--die-with-parent', '--chdir', real(projectDir));
     return a;
@@ -115,7 +153,16 @@ function argsBwrap(projectDir, cfg = config(), home = os.homedir()) {
 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' };
+    if (!cfg.ligado) {
+        let aviso = null;
+        if (!_avisouDesligado) {
+            _avisouDesligado = true;
+            aviso = process.platform === 'darwin'
+                ? 'aviso: o sandbox está desligado; os comandos do agente rodam sem cerca. /sandbox on liga.'
+                : 'aviso: o sandbox vem desligado fora do macOS; os comandos do agente rodam sem cerca. /sandbox on liga (no Linux precisa do bwrap).';
+        }
+        return { semCerca: true, motivo: 'desligado', aviso };
+    }
     const mec = mecanismo();
     if (!mec) {
         if (cfg.modo === 'hard_requirement') {
@@ -132,14 +179,15 @@ function envolver(command, projectDir, opts = {}) {
 /** 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)
+    const m = /(?:^|\n)(?:[^\n:]*:\s*)?(\/[^\n:]+?|\.{1,2}\/[^\n:]+?|[^\s:'"]+?):?\s*(?:(?:open|read|stat|lstat|opendir|write):\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 (secreto) return `o sandbox bloqueou leitura de segredo: ${alvo} (${LEITURA_NEGADA_HOME.map((p) => '~/' + p).join(', ')} e .env* ficam fora do alcance). Não tente ler isso; peça ao usuário o que precisa.`;
+    if (/\/\.git\/hooks\//.test(alvo)) return `o sandbox bloqueou escrita em hook do git: ${alvo}. Hook roda fora da cerca; se o usuário quiser um, ele instala.`;
     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.`;
     }
@@ -168,7 +216,7 @@ function executar(command, { projectDir, timeout = 60000, env = process.env, hom
         const termina = (error, stdout, stderr) => {
             let err = stderr || '';
             const info = { mecanismo: e.mec || null };
-            if (e.aviso) err = e.aviso + '\n' + err;
+            if (e.aviso) { err = e.aviso + '\n' + err; avisarPessoa(e.aviso); }
             if (error && e.mec) {
                 const why = explicar(err, cwd, cfg, e.home);
                 if (why) { err = err + '\n[sandbox] ' + why; info.bloqueou = why; }
@@ -191,7 +239,7 @@ function estado(home) {
 
 function _teste({ mecanismo: m, avisou } = {}) {
     if (m !== undefined) _forcaMecanismo = m === 'auto' ? undefined : m;
-    if (avisou !== undefined) _avisou = avisou;
+    if (avisou !== undefined) { _avisou = avisou; _avisouDesligado = avisou; }
 }
 
 module.exports = { config, salvar, estado, mecanismo, envolver, executar, explicar, filtrarEnv, perfilSeatbelt, argsBwrap, MODOS, _teste };

package/lib/tools.js

@@ -274,10 +274,13 @@ function grepFiles({ pattern, glob, ignoreCase, contexto = 0, maxResultados = 10
    USER, NODE_*, nvm etc. continuam — sem eles `npm`, `node` e `git` quebram.
    Na dúvida o nome sai: um token a mais escondido custa pouco, um a menos
    vaza. Só o caminho do agente (execute → run_shell) é filtrado; os usos
-   internos (abrir terminal, desinstalar) seguem com o ambiente inteiro. */
+   internos (abrir terminal, desinstalar) seguem com o ambiente inteiro.
+   O SSH_AUTH_SOCK também sai (review do Arthur, #162): com ele o agente usa o
+   ssh-agent da pessoa (`git push`, `ssh host`) sem ler ~/.ssh. Volta só com
+   `/sandbox ssh on`. */
 const NOME_SECRETO = /(TOKEN|SECRET|KEY|PASSWORD|PASSWD|CREDENTIAL|AUTH|COOKIE|SESSION)/i;
 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']);
+const SEMPRE_PASSA = new Set(['PATH', 'HOME', 'USER', 'LOGNAME', 'SHELL', 'LANG', 'TERM', 'TMPDIR', 'PWD']);
 
 function ambienteLimpo(env = process.env, permitidas = []) {
     const limpo = {};
@@ -289,6 +292,10 @@ function ambienteLimpo(env = process.env, permitidas = []) {
     return limpo;
 }
 
+function permitidasNoShell(cfg = sandbox.config()) {
+    return cfg.ssh_agent ? [...cfg.env_permitidas, 'SSH_AUTH_SOCK'] : cfg.env_permitidas;
+}
+
 async function runShell(command, timeout = 60000, cwd, env) {
     return new Promise((resolve) => {
         exec(command, { timeout, cwd: cwd || process.cwd(), maxBuffer: 10 * 1024 * 1024, env: env || process.env }, (error, stdout, stderr) => {
@@ -668,7 +675,7 @@ async function despachar(name, args, ctx) {
             case 'run_shell':
                 // 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) });
+                    env: ambienteLimpo(process.env, permitidasNoShell()) });
             case 'run_in_new_terminal':
                 return runInNewTerminal(args.command, args.cwd || projectDir);
             case 'open_in_browser': {
@@ -712,6 +719,15 @@ async function despachar(name, args, ctx) {
                 return { ok: true, gravado: entry };
             }
 
+            // A memória que dura entre sessões (lib/memoria-usuario.js).
+            case 'lembrar': {
+                const mem = require('./memoria-usuario.js');
+                const acao = String(args.acao || 'salvar').toLowerCase();
+                if (acao === 'apagar') return mem.apagar(args.nome);
+                if (acao === 'salvar') return mem.salvar({ nome: args.nome, descricao: args.descricao, tipo: args.tipo, texto: args.texto });
+                return { ok: false, error: 'Ação inválida. Use "salvar" ou "apagar".' };
+            }
+
             // ── MCP: o serviço pela API dele, antes do mouse (lib/mcp.js) ──
             case 'mcp_procurar':
                 return require('./mcp.js').procurar(args.busca || args.query || args.servico || '');
@@ -978,7 +994,7 @@ async function uninstall() {
 }
 
 module.exports = {
-    fmtBytes, treeDir, runShell, ambienteLimpo, openInBrowser, runInNewTerminal,
+    fmtBytes, treeDir, runShell, ambienteLimpo, permitidasNoShell, openInBrowser, runInNewTerminal,
     execute, uninstall, resolveInProject, globToRegex, globFiles, grepFiles, editFile,
     multiEdit, writeTodos, getTodos,
     liberarLeitura, pastasDeConsulta, esquecerConsultas, resolverParaLer,

package/lib/ui.js

@@ -557,7 +557,7 @@ const ROTULOS = {
         desktop_windows:'Desktop·janelas', desktop_focus:'Desktop·foco',
         desktop_elements:'Desktop·elementos', desktop_click_element:'Desktop·click',
     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',
+    remember_general:'Lembrar', lembrar:'Memória',
     mcp_procurar:'MCP·procurar', mcp_conectar:'MCP·conectar', mcp_usar:'MCP',
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primocode",
-  "version": "10.15.1",
+  "version": "10.16.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": {
@@ -10,7 +10,7 @@
     "start": "node bin/primocode.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/primo-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"
+    "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/primo-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 && node test/app-chat-cli.test.js && node test/app-chat-ponte.test.js && node test/gosto-motion.test.js && node test/desktop-vivo.test.js && node test/memoria-usuario.test.js && node test/landing-instalar.test.js"
   },
   "engines": {
     "node": ">=18.17.0"