@fefsbenson/jarvis 1.0.2 → 1.2.0

package/bin/cli.js

@@ -12,7 +12,9 @@
  *
  * JARVIS · PRAGMA · by Felipe Brandão
  */
-import { createWriteStream, existsSync, mkdirSync, readdirSync, statSync } from 'node:fs';
+import { createWriteStream, existsSync, mkdirSync, readdirSync, statSync,
+         readFileSync, writeFileSync, copyFileSync, rmSync } from 'node:fs';
+import { createHash } from 'node:crypto';
 import { spawn, spawnSync } from 'node:child_process';
 import { createInterface } from 'node:readline';
 import { tmpdir } from 'node:os';
@@ -117,7 +119,7 @@ function barra(feito, total) {
   return `  ${laranja('█'.repeat(cheio))}${fraco('░'.repeat(largura - cheio))}  ${cinza(`${Math.round(pct * 100)}%`)}`;
 }
 
-async function baixar(token, destino) {
+async function baixar(token, destino, plataforma = 'linux') {
   // 1. qual é a versão mais recente
   const rel = await api(`/repos/${REPO}/releases/latest`, token);
   if (rel.status === 401) throw new Error('TOKEN_INVALIDO');
@@ -125,8 +127,20 @@ async function baixar(token, destino) {
   if (!rel.ok) throw new Error(`GitHub respondeu ${rel.status}`);
   const dados = await rel.json();
 
-  const asset = (dados.assets || []).find(a => a.name.endsWith('.tar.gz'));
-  if (!asset) throw new Error('Release sem pacote .tar.gz');
+  // 2. o pacote da plataforma escolhida.
+  // Um release traz os dois assets (jarvis-X.Y.Z-windows.tar.gz e -linux).
+  // Só cai no primeiro .tar.gz disponível quando o release é antigo e tem um
+  // pacote único — assim uma versão nova do baixador continua instalando
+  // releases publicados antes desta separação.
+  const sufixo = PLATAFORMAS[plataforma]?.sufixo || 'linux';
+  const tarballs = (dados.assets || []).filter(a => a.name.endsWith('.tar.gz'));
+  const asset = tarballs.find(a => a.name.includes(`-${sufixo}`)) ||
+                (tarballs.length === 1 ? tarballs[0] : null);
+  if (!asset) {
+    const nomes = tarballs.map(a => a.name).join(', ') || 'nenhum';
+    throw new Error(
+      `Release ${dados.tag_name} não tem pacote para ${sufixo}. Assets: ${nomes}`);
+  }
 
   console.log(`  ${verde('✓')}  ${branco('Versão')} ${cinza(dados.tag_name)}  ${fraco((asset.size / 1048576).toFixed(1) + ' MB')}`);
 
@@ -190,32 +204,59 @@ function erroDeAcesso(tipo) {
 }
 
 /**
- * O harness roda em POSIX, não em Windows nativo: os 104 hooks do
- * settings.json são invocados com `bash .../pyrun.sh` e 153 arquivos usam
- * caminho POSIX. Instalar no PowerShell criaria um sistema que copia mas
- * não funciona — pior que não instalar.
+ * Existem dois pacotes, porque são dois sistemas de verdade.
+ *
+ * O de Linux/WSL invoca os hooks com `bash pyrun.sh`; o de Windows usa
+ * `python pyrun.py` e resolve o ambiente virtual em `Scripts\` em vez de
+ * `bin/`. Instalar o pacote errado produz um sistema que copia mas não
+ * funciona — que é pior que não instalar, porque o dono só descobre depois.
+ *
+ * O padrão vem do sistema detectado, mas quem decide é o dono: no Windows
+ * ele pode legitimamente querer o pacote POSIX, se for rodar dentro do WSL.
  */
-function avisarWindows() {
-  if (process.platform !== 'win32') return true;
-  console.log(`  ${vermelho(neg('O JARVIS precisa do WSL — não roda no Windows direto.'))}`);
-  console.log();
-  console.log(`  ${cinza('O sistema usa bash para executar seus 104 hooks. No PowerShell')}`);
-  console.log(`  ${cinza('ele até instalaria, mas não funcionaria.')}`);
-  console.log();
-  console.log(`  ${branco('Abra o Ubuntu (WSL) e rode lá o mesmo comando:')}`);
+const PLATAFORMAS = {
+  windows: { rotulo: 'Windows (PowerShell)', sufixo: 'windows' },
+  linux:   { rotulo: 'Linux, WSL ou macOS',  sufixo: 'linux'   },
+};
+
+async function escolherPlataforma() {
+  const provavel = process.platform === 'win32' ? 'windows' : 'linux';
+
+  console.log(`  ${branco(neg('Onde o JARVIS vai rodar?'))}`);
   console.log();
-  console.log(`      ${fraco('wsl')}`);
-  console.log(`      ${fraco('npx @fefsbenson/jarvis install')}`);
+  console.log(`    ${laranja('[1]')} ${branco(PLATAFORMAS.windows.rotulo)}` +
+              `${provavel === 'windows' ? fraco('   ← detectei este') : ''}`);
+  console.log(`    ${laranja('[2]')} ${branco(PLATAFORMAS.linux.rotulo)}` +
+              `${provavel === 'linux' ? fraco('   ← detectei este') : ''}`);
   console.log();
-  console.log(`  ${fraco('Não tem WSL? No PowerShell como administrador:')} ${cinza('wsl --install')}`);
+  console.log(`  ${fraco('São pacotes diferentes: o de Windows não usa bash.')}`);
   console.log();
-  return false;
+
+  const mapa = { '1': 'windows', '2': 'linux' };
+  for (;;) {
+    // `perguntar` já desenha o marcador ▸ — repetir aqui produzia "▸  ▸ Escolha"
+    const r = (await perguntar(`Escolha ${fraco('(1-2, enter = detectado)')}`))
+      .trim().toLowerCase();
+    if (!r) return provavel;
+    if (mapa[r]) return mapa[r];
+    // Ordem importa: "wsl" começa com 'w' e cairia em Windows se a regra
+    // genérica viesse antes — mas WSL é justamente o pacote POSIX. As
+    // palavras inteiras são testadas primeiro; os prefixos, depois.
+    if (/\b(wsl|ubuntu|linux|debian|mac|macos|posix)\b/.test(r)) return 'linux';
+    if (/\b(windows|powershell|win|ps)\b/.test(r)) return 'windows';
+    if (r.startsWith('l') || r.startsWith('m')) return 'linux';
+    if (r.startsWith('w') || r.startsWith('p')) return 'windows';
+    console.log(`    ${fraco('não entendi — digite 1 ou 2')}`);
+  }
 }
 
 async function instalar(args) {
   abertura();
 
-  if (!avisarWindows()) return 1;
+  const plataforma = await escolherPlataforma();
+  console.log();
+  console.log(`  ${verde('✓')}  ${branco('Pacote')} ${cinza(PLATAFORMAS[plataforma].rotulo)}`);
+  console.log();
 
   const py = acharPython();
   if (!py) {
@@ -223,8 +264,14 @@ async function instalar(args) {
     console.log();
     console.log(`  ${cinza('O JARVIS roda em Python. O Node serve só para este baixador.')}`);
     console.log();
-    console.log(`  ${branco('No Ubuntu/WSL:')}  ${fraco('sudo apt install python3 python3-venv')}`);
-    console.log(`  ${branco('No macOS:')}       ${fraco('brew install python@3.12')}`);
+    if (plataforma === 'windows') {
+      console.log(`  ${branco('Baixe em:')}  ${fraco('https://python.org/downloads')}`);
+      console.log(`  ${fraco('Marque "Add python.exe to PATH" durante a instalação.')}`);
+      console.log(`  ${fraco('O Python da Microsoft Store não serve — ele é um atalho para a loja.')}`);
+    } else {
+      console.log(`  ${branco('No Ubuntu/WSL:')}  ${fraco('sudo apt install python3 python3-venv')}`);
+      console.log(`  ${branco('No macOS:')}       ${fraco('brew install python@3.12')}`);
+    }
     console.log();
     return 1;
   }
@@ -259,7 +306,7 @@ async function instalar(args) {
 
   console.log();
   try {
-    await baixar(token, destino);
+    await baixar(token, destino, plataforma);
   } catch (e) {
     if (e.message === 'TOKEN_INVALIDO' || e.message === 'SEM_ACESSO') {
       erroDeAcesso(e.message);
@@ -278,11 +325,368 @@ async function instalar(args) {
   return r.status ?? 0;
 }
 
+// ══════════════════════════════════════════════════════════════════
+//  UPDATE — traz a versão nova sem apagar o que o dono fez
+// ══════════════════════════════════════════════════════════════════
+
+/**
+ * O manifesto que a instalação grava: hash de cada arquivo COMO SAIU do
+ * pacote. É ele que torna a atualização possível sem escolher entre duas
+ * coisas ruins — apagar o trabalho do dono, ou nunca entregar correção.
+ *
+ * Sem manifesto (instalação anterior à v1.1.7) o update ainda funciona,
+ * mas não sabe o que foi alterado: aí ele preserva por precaução tudo que
+ * difere do pacote novo, e diz isso na tela.
+ */
+function lerManifesto(raiz) {
+  const f = join(raiz, '.claude', 'jarvis', 'instalacao-original.json');
+  if (!existsSync(f)) return null;
+  try {
+    const d = JSON.parse(readFileSync(f, 'utf8'));
+    return (d && d.arquivos) ? d : null;
+  } catch { return null; }
+}
+
+function hashDe(caminho) {
+  try {
+    return createHash('sha256').update(readFileSync(caminho)).digest('hex');
+  } catch { return null; }
+}
+
+/**
+ * Pastas que NUNCA se sobrescreve, porque são do dono por natureza:
+ * credenciais, memória do sistema, o trabalho dele, estado e registros.
+ * Isto não depende do manifesto — é contrato, e vale mesmo sem ele.
+ */
+const INTOCAVEIS = [
+  '.env', '.venv', 'node_modules', '.git',
+  'jarvis.config.yaml',
+  '.claude/settings.local.json',
+  '.claude/jarvis/',          // memória, estado, ponteiros
+  '.claude/sessions/',        // histórico de sessões
+  'workspace/',               // o negócio do dono
+  'knowledge/business/', 'knowledge/personal/',
+  'logs/', '.data/', 'artifacts/', 'processing/',
+];
+
+/**
+ * Exceções DENTRO de pasta protegida: arquivos que o sistema mantém e o dono
+ * não escreve. Sem esta lista, `.claude/jarvis/` inteiro fica congelado — e o
+ * manifesto nunca se renova, então uma instalação antiga seguiria para sempre
+ * sem saber o que o dono alterou.
+ */
+const SEMPRE_ATUALIZA = ['VERSION', 'MANIFESTO-PACOTE.json', 'LICENSE'];
+
+const EXCECOES = [
+  '.claude/jarvis/instalacao-original.json',
+];
+
+function ehIntocavel(rel) {
+  const n = rel.split('\\').join('/');
+  if (EXCECOES.includes(n)) return false;
+  return INTOCAVEIS.some(i => i.endsWith('/') ? n.startsWith(i) : n === i);
+}
+
+function listar(dir, base = dir, saida = []) {
+  for (const e of readdirSync(dir, { withFileTypes: true })) {
+    if (e.name === 'node_modules' || e.name === '.git' ||
+        e.name === '__pycache__' || e.name === '.venv') continue;
+    const cheio = join(dir, e.name);
+    const rel = cheio.slice(base.length + 1).split('\\').join('/');
+    if (e.isDirectory()) listar(cheio, base, saida);
+    else saida.push(rel);
+  }
+  return saida;
+}
+
+/**
+ * Compara a instalação atual com o pacote novo e classifica cada arquivo.
+ *
+ * Os quatro casos, e por que cada um se resolve assim:
+ *
+ *   novo       — não existe aqui: entra.
+ *   igual      — o dono não mexeu E o pacote não mudou: nada a fazer.
+ *   atualiza   — o dono não mexeu e o pacote mudou: entra (é a correção).
+ *   preserva   — o dono MEXEU: fica o dele. É o ponto todo do manifesto;
+ *                sem ele, "atualizar" seria apagar o trabalho de alguém.
+ */
+/**
+ * O "motor": o que faz o sistema funcionar, por oposição ao que ele guarda.
+ * Numa instalação sem manifesto é a única forma de distinguir a correção
+ * chegando de uma edição do dono — e a chance de alguém ter editado um hook
+ * à mão é muito menor que a de ficar sem o conserto.
+ */
+function ehDoMotor(rel) {
+  const n = rel.split('\\').join('/');
+  return n.startsWith('.claude/hooks/') ||
+         n.startsWith('.claude/scripts/') ||
+         n.startsWith('core/') ||
+         n.startsWith('bin/') ||
+         n === 'install.py' ||
+         n === 'requirements.txt' ||
+         n === 'requirements-opcional.txt';
+}
+
+function planejar(raizAtual, raizNova, manifesto) {
+  const orig = manifesto ? manifesto.arquivos : null;
+  const plano = { novo: [], atualiza: [], preserva: [], igual: [], protegido: [] };
+
+  for (const rel of listar(raizNova)) {
+    if (ehIntocavel(rel)) { plano.protegido.push(rel); continue; }
+
+    const aqui = join(raizAtual, rel);
+    if (!existsSync(aqui)) { plano.novo.push(rel); continue; }
+
+    const hAqui = hashDe(aqui);
+    const hNovo = hashDe(join(raizNova, rel));
+    if (hAqui === hNovo) { plano.igual.push(rel); continue; }
+
+    // difere do pacote novo. Foi o dono que mexeu, ou é a correção chegando?
+    // Metadados do pacote são do sistema por definição — o dono nunca os
+    // edita. Preservar o VERSION deixaria o update dizendo "já está na versão
+    // mais recente" para sempre numa instalação sem manifesto.
+    if (SEMPRE_ATUALIZA.includes(rel)) { plano.atualiza.push(rel); continue; }
+
+    if (orig) {
+      const hOrig = orig[rel];
+      // sem registro de origem = arquivo que o dono criou depois: preserva
+      if (!hOrig) { plano.preserva.push(rel); continue; }
+      // igual ao que foi instalado = intocado pelo dono: pode atualizar
+      if (hAqui === hOrig) { plano.atualiza.push(rel); continue; }
+      plano.preserva.push(rel);
+    } else {
+      // Sem manifesto não dá para saber quem alterou o quê. Preservar TUDO
+      // parece seguro, mas trava o update onde ele mais importa: numa
+      // instalação antiga, os arquivos do MOTOR (scripts, hooks, instalador)
+      // são exatamente os que carregam a correção — e quase nunca são
+      // editados pelo dono. Preservá-los entregaria um update que não
+      // atualiza nada, com um .novo inerte ao lado.
+      //
+      // Então: motor atualiza, conteúdo preserva. E o que for sobrescrito
+      // ganha backup .antigo, para nada ser perdido sem volta.
+      plano[ehDoMotor(rel) ? 'atualiza' : 'preserva'].push(rel);
+    }
+  }
+  return plano;
+}
+
+function mostrarPlano(plano, semManifesto) {
+  const l = (rot, arr, cor) => {
+    if (!arr.length) return;
+    console.log(`  ${cor(String(arr.length).padStart(5))}  ${branco(rot)}`);
+  };
+  console.log();
+  console.log(`  ${branco(neg('O que vai acontecer'))}`);
+  console.log();
+  l('arquivos novos', plano.novo, verde);
+  l('atualizados', plano.atualiza, verde);
+  l('preservados (você alterou)', plano.preserva, laranja);
+  l('já estavam iguais', plano.igual, fraco);
+  l('protegidos (memória, workspace, .env)', plano.protegido, cinza);
+  console.log();
+
+  if (plano.preserva.length) {
+    const amostra = plano.preserva.slice(0, 6);
+    console.log(`  ${laranja('Preservados')} ${fraco('— fica a SUA versão, e guardo a nova ao lado como .novo')}`);
+    for (const a of amostra) console.log(`    ${fraco('·')} ${cinza(a)}`);
+    if (plano.preserva.length > amostra.length) {
+      console.log(`    ${fraco(`· e mais ${plano.preserva.length - amostra.length}`)}`);
+    }
+    console.log();
+  }
+
+  if (semManifesto) {
+    console.log(`  ${laranja('!')}  ${cinza('Sua instalação é anterior ao registro de arquivos.')}`);
+    console.log(`     ${fraco('Sem ele não sei o que você alterou. Então atualizo o motor do sistema')}`);
+    console.log(`     ${fraco('(hooks, scripts, instalador) — é onde a correção vem — e preservo o')}`);
+    console.log(`     ${fraco('resto. O que for sobrescrito fica salvo como .antigo, e dá para voltar.')}`);
+    console.log(`     ${fraco('A partir desta atualização, o registro passa a existir.')}`);
+    console.log();
+  }
+}
+
+function aplicar(raizAtual, raizNova, plano) {
+  let n = 0;
+  for (const rel of [...plano.novo, ...plano.atualiza]) {
+    const destino = join(raizAtual, rel);
+    mkdirSync(join(destino, '..'), { recursive: true });
+    // guarda o anterior quando o conteúdo difere: sem manifesto a decisão de
+    // atualizar é uma aposta informada, e aposta precisa ter volta.
+    if (existsSync(destino) && hashDe(destino) !== hashDe(join(raizNova, rel))) {
+      try { copyFileSync(destino, destino + '.antigo'); } catch {}
+    }
+    copyFileSync(join(raizNova, rel), destino);
+    n++;
+  }
+  // o que o dono alterou fica intacto; a versão nova vai ao lado, para ele ver
+  for (const rel of plano.preserva) {
+    copyFileSync(join(raizNova, rel), join(raizAtual, rel + '.novo'));
+  }
+  return n;
+}
+
+async function atualizar(args) {
+  abertura();
+
+  const raiz = resolve(process.cwd(), args[0] || '.');
+  const marca = join(raiz, '.claude', 'hooks');
+  if (!existsSync(marca)) {
+    console.log(`  ${vermelho(neg('Não encontrei um JARVIS aqui.'))}`);
+    console.log(`  ${cinza('Rode este comando DENTRO da pasta do JARVIS, ou passe o caminho:')}`);
+    console.log(`      ${fraco('npx @fefsbenson/jarvis update C:\\Users\\voce\\jarvis')}`);
+    console.log();
+    return 1;
+  }
+
+  const versaoAtual = existsSync(join(raiz, 'VERSION'))
+    ? readFileSync(join(raiz, 'VERSION'), 'utf8').trim() : '?';
+
+  const py = acharPython();
+  const plataforma = existsSync(join(raiz, '.claude', 'hooks', 'pyrun.py'))
+    ? 'windows' : 'linux';
+
+  console.log(`  ${verde('✓')}  ${branco('JARVIS encontrado')}  ${fraco(raiz)}`);
+  console.log(`  ${verde('✓')}  ${branco('Versão atual')}  ${cinza('v' + versaoAtual)}` +
+              `   ${fraco('edição ' + PLATAFORMAS[plataforma].rotulo)}`);
+  console.log();
+  console.log(`  ${cinza('Vou baixar a versão mais recente e trazer só o que mudou.')}`);
+  console.log(`  ${cinza('O que você alterou fica como está — nada seu é sobrescrito.')}`);
+  console.log();
+
+  const token = process.env.JARVIS_TOKEN || await perguntar('Token:', true);
+  if (!token) {
+    console.log(`\n  ${fraco('Sem token, não há o que baixar. Cancelado.')}\n`);
+    return 130;
+  }
+
+  const tmp = join(tmpdir(), `jarvis-update-${Date.now()}`);
+  console.log();
+  try {
+    await baixar(token, tmp, plataforma);
+  } catch (e) {
+    if (e.message === 'TOKEN_INVALIDO' || e.message === 'SEM_ACESSO') erroDeAcesso(e.message);
+    else {
+      console.log(`\n  ${vermelho(neg('Não consegui baixar.'))}`);
+      console.log(`  ${cinza(e.message)}\n`);
+    }
+    return 1;
+  }
+
+  const versaoNova = existsSync(join(tmp, 'VERSION'))
+    ? readFileSync(join(tmp, 'VERSION'), 'utf8').trim() : '?';
+
+  if (versaoNova === versaoAtual) {
+    console.log();
+    console.log(`  ${verde('✓')}  ${branco('Você já está na versão mais recente')} ${cinza('(v' + versaoNova + ')')}`);
+    console.log();
+    rmSync(tmp, { recursive: true, force: true });
+    return 0;
+  }
+
+  // Sanidade do que foi baixado, ANTES de encostar na pasta do dono.
+  // Um pacote que extrai pela metade (rede caindo, disco cheio) não faz o tar
+  // falhar necessariamente — e aplicar um pacote incompleto por cima de uma
+  // instalação boa é exatamente o estrago que este comando não pode causar.
+  const marcasEsperadas = ['.claude/hooks', '.claude/scripts', 'VERSION', 'install.py'];
+  const faltando = marcasEsperadas.filter(m => !existsSync(join(tmp, m)));
+  const totalBaixado = listar(tmp).length;
+  if (faltando.length || totalBaixado < 500) {
+    console.log();
+    console.log(`  ${vermelho(neg('O pacote baixado veio incompleto.'))}`);
+    console.log(`  ${cinza(faltando.length ? 'falta: ' + faltando.join(', ')
+                                            : `só ${totalBaixado} arquivos`)}`);
+    console.log();
+    console.log(`  ${branco('Sua instalação NÃO foi tocada.')} ${fraco('Tente de novo.')}`);
+    console.log();
+    rmSync(tmp, { recursive: true, force: true });
+    return 1;
+  }
+
+  const manifesto = lerManifesto(raiz);
+  const plano = planejar(raiz, tmp, manifesto);
+
+  console.log();
+  console.log(`  ${branco(neg(`v${versaoAtual}`))} ${fraco('→')} ${verde(neg(`v${versaoNova}`))}`);
+  mostrarPlano(plano, !manifesto);
+
+  if (!plano.novo.length && !plano.atualiza.length) {
+    console.log(`  ${verde('✓')}  ${branco('Nada a mudar nos arquivos do sistema.')}`);
+    console.log();
+    rmSync(tmp, { recursive: true, force: true });
+    return 0;
+  }
+
+  const ok = (await perguntar(`Aplicar? ${fraco('(enter = sim, n = cancelar)')}`)).trim().toLowerCase();
+  if (ok === 'n' || ok === 'nao' || ok === 'não') {
+    console.log(`\n  ${fraco('Cancelado. Nada foi alterado.')}\n`);
+    rmSync(tmp, { recursive: true, force: true });
+    return 130;
+  }
+
+  console.log();
+  const n = aplicar(raiz, tmp, plano);
+  console.log(`  ${verde('✓')}  ${branco('Aplicado')}  ${fraco(n.toLocaleString('pt-BR') + ' arquivo(s)')}`);
+  rmSync(tmp, { recursive: true, force: true });
+
+  // O settings.json que veio no pacote traz o caminho como `$CLAUDE_PROJECT_DIR`
+  // — sintaxe POSIX. Precisa virar o caminho ABSOLUTO desta máquina, senão no
+  // Windows os 105 hooks morrem (foi o defeito que quebrou a instalação de um
+  // aluno em 24/08).
+  //
+  // Chamar o médico com --fix NÃO basta: em Linux o exame passa (lá a variável
+  // expande), então o conserto nem é acionado e o marcador fica. Por isso a
+  // regravação é INCONDICIONAL — o install.py sabe fazê-la, e é a mesma função
+  // que roda em toda instalação.
+  if (py) {
+    console.log();
+    console.log(`  ${cinza('Ajustando os caminhos para esta máquina...')}`);
+    const fix = spawnSync(py.cmd, [...(py.args || []), '-c',
+      'import sys;sys.path.insert(0,sys.argv[1]);import install;' +
+      'r=install.fixar_launcher_dos_hooks();print(r[0],r[1])', raiz],
+      { encoding: 'utf8', cwd: raiz });
+    if (fix.status === 0) {
+      console.log(`  ${verde('✓')}  ${branco('Caminhos e launcher gravados')} ${fraco((fix.stdout || '').trim())}`);
+    } else {
+      console.log(`  ${laranja('!')}  ${cinza('Não consegui regravar os caminhos automaticamente.')}`);
+      console.log(`     ${fraco('Rode: ' + py.cmd + ' .claude/scripts/jarvis_doctor.py --fix')}`);
+    }
+
+    // e o registro de arquivos precisa refletir a versão que acabou de entrar,
+    // senão a PRÓXIMA atualização compara contra a versão errada
+    spawnSync(py.cmd, [...(py.args || []), '-c',
+      'import sys;sys.path.insert(0,sys.argv[1]);import install;install.gravar_impressao_digital()', raiz],
+      { encoding: 'utf8', cwd: raiz });
+
+    console.log();
+    console.log(`  ${cinza('Conferindo a instalação...')}`);
+    console.log();
+    const r = spawnSync(py.cmd, [...(py.args || []),
+                                 join(raiz, '.claude', 'scripts', 'jarvis_doctor.py')],
+                        { stdio: 'inherit', cwd: raiz });
+    if (r.status !== 0) {
+      console.log();
+      console.log(`  ${laranja('!')}  ${cinza('O médico apontou algo. Veja acima o que ficou pendente.')}`);
+    }
+  }
+
+  console.log();
+  console.log(`  ${verde(neg('Atualizado para v' + versaoNova + '.'))}`);
+  if (plano.preserva.length) {
+    console.log(`  ${fraco('Seus arquivos alterados continuam lá; a versão nova de cada um está como *.novo')}`);
+  }
+  console.log();
+  return 0;
+}
+
 function ajuda() {
   abertura();
   console.log(`  ${branco('npx @fefsbenson/jarvis install')}          ${fraco('baixa e instala em ./jarvis')}`);
   console.log(`  ${branco('npx @fefsbenson/jarvis install PASTA')}    ${fraco('instala na pasta que você escolher')}`);
   console.log();
+  console.log(`  ${branco('npx @fefsbenson/jarvis update')}           ${fraco('atualiza o JARVIS desta pasta')}`);
+  console.log(`  ${branco('npx @fefsbenson/jarvis update PASTA')}     ${fraco('atualiza o de outra pasta')}`);
+  console.log(`  ${fraco('       o update preserva o que você alterou — nada seu é sobrescrito')}`);
+  console.log();
   console.log(`  ${fraco('Precisa de: Node 18+, Python 3.10+ e o token de acesso.')}`);
   console.log(`  ${fraco('O token também pode vir da variável JARVIS_TOKEN.')}`);
   console.log();
@@ -291,6 +695,8 @@ function ajuda() {
 const [, , comando, ...resto] = process.argv;
 if (comando === 'install') {
   instalar(resto).then(cod => process.exit(cod));
+} else if (comando === 'update' || comando === 'atualizar') {
+  atualizar(resto).then(cod => process.exit(cod));
 } else {
   ajuda();
   process.exit(comando ? 1 : 0);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fefsbenson/jarvis",
-  "version": "1.0.2",
-  "description": "JARVIS — sistema operacional de conhecimento e agentes para Claude Code",
+  "version": "1.2.0",
+  "description": "JARVIS — sistema operacional de conhecimento e agentes para Claude Code (Windows e Linux)",
   "bin": {
     "jarvis": "bin/cli.js"
   },
@@ -27,4 +27,4 @@
     "knowledge-management",
     "pragma"
   ]
-}
+}