auroq-os 2.4.0 → 2.4.2

package/.auroq-core/core-config.yaml

@@ -1,7 +1,7 @@
 project:
   name: "Auroq OS"
   type: greenfield
-  version: 2.2.4
+  version: 2.4.2
   installedAt: '2026-03-16'
 
 ide:

package/bin/auroq-os.js

@@ -59,6 +59,20 @@ function sleep(ms) { return new Promise(r => setTimeout(r, ms)); }
 // Pergunta sim/nao no terminal. Funciona em TTY e com stdin encadeado (pipe).
 // Se o stdin estiver fechado (automatos/CI), question() nunca resolve — por isso
 // a corrida com o evento 'close': EOF vira resposta vazia, ou seja, "nao".
+/**
+ * Grava no core-config da instalacao a versao que esta sendo instalada agora e
+ * o dia de hoje. Sem isso os dois campos ficam congelados no que o arquivo
+ * modelo trazia dentro do pacote.
+ */
+async function carimbarVersao(configPath) {
+  if (!(await fs.pathExists(configPath))) return;
+  let texto = await fs.readFile(configPath, 'utf8');
+  const hoje = new Date().toISOString().slice(0, 10);
+  texto = texto.replace(/^(\s*version:).*$/m, `$1 ${PKG_VERSION}`);
+  texto = texto.replace(/^(\s*installedAt:).*$/m, `$1 '${hoje}'`);
+  await fs.writeFile(configPath, texto);
+}
+
 async function askYesNo(question) {
   const readline = require('node:readline/promises');
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
@@ -237,7 +251,7 @@ async function runHealthChecks(targetDir) {
   } else {
     error(`${passed}/${HEALTH_CHECKS.length} verificacoes OK — arquivo de autoload faltando:`);
     for (const item of missing) error(`  - ${item}`);
-    error('Nenhum arquivo de autoload pode faltar em silencio. Contato: 11 97312-2273');
+    error('Nenhum arquivo de autoload pode faltar em silencio. Contato: 11 93621-4486');
     process.exit(1);
   }
   return { passed, total: HEALTH_CHECKS.length };
@@ -360,7 +374,7 @@ async function runDoctor(targetDir) {
   error(`${problemas.length} coisa(s) pra resolver:`);
   for (const p of problemas) log(`  ${DIM}- ${p}${RESET}`);
   log('');
-  log(`${DIM}Se travar, chame o suporte: 11 97312-2273${RESET}`);
+  log(`${DIM}Se travar, chame o suporte: 11 93621-4486${RESET}`);
   return 1;
 }
 
@@ -736,6 +750,13 @@ async function init({ pasta = null } = {}) {
   }
   success(`${copied} arquivos instalados`);
 
+  // O core-config.yaml e copiado cru do pacote. Como ninguem lembra de edita-lo
+  // a cada release, toda instalacao nova jurava ser a versao de quando o arquivo
+  // foi escrito — 2.2.4 numa maquina rodando 2.4.1, no piloto de 27/08. Quem
+  // abre um chamado com esse numero manda o suporte investigar a versao errada.
+  // Carimbar aqui e a unica forma de nunca mais divergir.
+  await carimbarVersao(path.join(targetDir, '.auroq-core', 'core-config.yaml'));
+
   const seedRoot = path.join(sourceDir, 'seeds');
   if (await fs.pathExists(seedRoot)) {
     await fs.copy(seedRoot, targetDir, { overwrite: false });

package/installer/install.ps1

@@ -1,4 +1,4 @@
-# Auroq OS — instalador do Windows.
+# Auroq OS - instalador do Windows.
 #
 #   irm https://arka.education/install.ps1 | iex
 #
@@ -6,7 +6,7 @@
 # de execucao nao entra aqui: ela so afeta arquivo .ps1 salvo em disco, e este
 # script roda em memoria. Exigir elevacao era resto da era npm.
 #
-# Ordem obrigatoria (PRD "Embarque em 2 passos" §4.2):
+# Ordem obrigatoria (PRD "Embarque em 2 passos" sec. 4.2):
 #   diagnostico -> Git -> motor -> login da mentoria -> pasta do negocio -> init
 #
 # O `init` e quem escreve o registro do conteudo ao vivo (ADR-7).
@@ -14,14 +14,27 @@
 # Modo biblioteca (usado pelos testes):  $env:AUROQ_INSTALL_LIB='1'; . install.ps1
 # Modo ensaio (nao toca em nada):        $env:AUROQ_INSTALL_DRY_RUN='1'
 
-# TLS 1.2 antes de qualquer download — sem isto o Windows 10 antigo estoura em SSL.
+# TLS 1.2 antes de qualquer download - sem isto o Windows 10 antigo estoura em SSL.
+# ATENCAO: este arquivo e ASCII PURO de proposito. Nao coloque acento, travessao
+# nem simbolo aqui.
+#
+# O Windows PowerShell 5.1 (o que vem no Windows, e o que o aluno usa) le script
+# sem BOM na codepage do sistema - Windows-1252 no Brasil. Cada caractere UTF-8
+# de dois ou tres bytes vira lixo, e o parser morre com "Missing closing '}'"
+# antes de executar UMA linha. Provado numa maquina Windows real: lido como
+# Windows-1252 => 4 erros de sintaxe; lido como UTF-8 => nenhum.
+#
+# ASCII puro resolve os dois caminhos de uma vez: rodar o arquivo do disco e
+# baixar por `irm ... | iex`, onde a decodificacao depende do que o servidor
+# declara.
+
 try {
   [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
 } catch {
   # PowerShell 7 ja negocia TLS moderno sozinho
 }
 
-$AuroqSuporte    = '11 97312-2273'
+$AuroqSuporte    = '11 93621-4486'
 $AuroqNodeMin    = 20
 $AuroqBuildMin   = 17763   # Windows 10 1809
 $AuroqDiscoMinMb = 2048
@@ -38,7 +51,7 @@ function Get-AuroqNodeDir {
   return (Join-Path $base 'Auroq\node')
 }
 
-# ─── Fala com o aluno ─────────────────────────────────────────────────────────
+# --- Fala com o aluno ---------------------------------------------------------
 
 function Write-AuroqTitulo { param([string]$Texto) Write-Host ''; Write-Host "  $Texto" -ForegroundColor Magenta; Write-Host '' }
 function Write-AuroqPasso  { param([string]$Texto) Write-Host ''; Write-Host "  > $Texto" -ForegroundColor Cyan }
@@ -60,7 +73,7 @@ function Write-AuroqErro {
   exit 1
 }
 
-# ─── Registro pro suporte (§5.7) ──────────────────────────────────────────────
+# --- Registro pro suporte (sec. 5.7) ----------------------------------------------
 # Uma linha por evento. Nunca entra senha, token ou e-mail.
 
 function Write-AuroqLog {
@@ -76,7 +89,7 @@ function Write-AuroqLog {
   }
 }
 
-# ─── Decisoes puras (testadas uma a uma) ──────────────────────────────────────
+# --- Decisoes puras (testadas uma a uma) --------------------------------------
 
 # So letras minusculas, numeros e hifen. -cmatch porque o -match do PowerShell
 # ignora maiuscula por padrao e deixaria passar "MinhaEmpresa".
@@ -104,7 +117,7 @@ function Get-AuroqNodeZip {
   return "node-v$Versao-win-$alvo.zip"
 }
 
-# nova | vazia | auroq | ocupada — decidido ANTES de escrever qualquer coisa.
+# nova | vazia | auroq | ocupada - decidido ANTES de escrever qualquer coisa.
 function Get-AuroqEstadoPasta {
   param([string]$Caminho = '')
   if (-not (Test-Path $Caminho)) { return 'nova' }
@@ -115,9 +128,9 @@ function Get-AuroqEstadoPasta {
   return 'ocupada'
 }
 
-# ─── O motor visivel pra quem abre pelo icone (§5.4) ──────────────────────────
+# --- O motor visivel pra quem abre pelo icone (sec. 5.4) --------------------------
 # No Windows o programa aberto pelo Menu Iniciar herda o ambiente do USUARIO.
-# Gravar no escopo da maquina inteira exigiria elevacao — o PRD proibe pedir isso.
+# Gravar no escopo da maquina inteira exigiria elevacao - o PRD proibe pedir isso.
 
 function Set-AuroqPath {
   param([string]$Bin = '')
@@ -129,7 +142,45 @@ function Set-AuroqPath {
   $env:Path = "$Bin;$env:Path"
 }
 
-# ─── Passo 1: diagnostico (§5.1) ──────────────────────────────────────────────
+# --- Como chamar o npx sem esbarrar na politica do Windows ----------------------
+
+# O PowerShell resolve `.ps1` antes de `.cmd`. Chamado pelado, `npx` vira
+# `npx.ps1` (um arquivo em disco) e a politica padrao do Windows recusa abrir
+# arquivo de script. Num piloto real a instalacao morreu exatamente ai, com
+# "npx.ps1 cannot be loaded because running scripts is disabled on this system".
+#
+# Mexer na politica resolveria e esta proibido (ADR-3: zero privilegio, e mudar
+# regra de seguranca da maquina do aluno pra instalar um sistema e abuso).
+# O `.cmd` faz o mesmo trabalho e nao passa pelo interpretador de script.
+function Get-AuroqNpx {
+  $doMotor = Join-Path (Get-AuroqNodeDir) 'npx.cmd'
+  if (Test-Path $doMotor) { return $doMotor }
+
+  # Quem ja tinha Node nem baixa o motor de bolso: a pasta acima nao existe.
+  $noCaminho = Get-Command 'npx.cmd' -ErrorAction SilentlyContinue
+  if ($noCaminho) { return $noCaminho.Source }
+
+  return 'npx.cmd'
+}
+
+# --- A ferramenta do aluno, visivel de qualquer janela --------------------------
+
+# O Claude Code se instala em %USERPROFILE%\.local\bin e nao publica essa pasta
+# no ambiente do usuario. Resultado do piloto: o aluno terminava a parada 1,
+# digitava `claude`, nao acontecia nada, e concluia que a instalacao falhou.
+function Set-AuroqCaminhoDaFerramenta {
+  $bin = Join-Path $env:USERPROFILE '.local\bin'
+  if (-not (Test-Path (Join-Path $bin 'claude.exe'))) { return }
+
+  $atual = [Environment]::GetEnvironmentVariable('Path', 'User')
+  if ($atual -and ($atual -split ';' | Where-Object { $_ -eq $bin })) { return }
+
+  Set-AuroqPath $bin
+  Write-AuroqOk 'Deixei o Claude Code visivel em qualquer janela'
+  Write-AuroqLog 'ferramenta' 'claude-publicado'
+}
+
+# --- Passo 1: diagnostico (sec. 5.1) ----------------------------------------------
 
 function Test-AuroqMaquina {
   Write-AuroqPasso 'Vendo o seu computador...'
@@ -150,7 +201,7 @@ function Test-AuroqMaquina {
 
   $chip = $env:PROCESSOR_ARCHITECTURE
   if (-not $chip) { $chip = 'AMD64' }
-  Write-AuroqOk "Windows 64 bits, compilacao $build — serve"
+  Write-AuroqOk "Windows 64 bits, compilacao $build - serve"
 
   $livreMb = 999999
   if ($env:AUROQ_INSTALL_FAKE_DISCO_MB) {
@@ -181,7 +232,7 @@ function Test-AuroqMaquina {
   Write-AuroqLog 'diagnostico' "build=$build chip=$chip disco_mb=$livreMb"
 }
 
-# ─── Passo 2: Git (§5.2) ──────────────────────────────────────────────────────
+# --- Passo 2: Git (sec. 5.2) ------------------------------------------------------
 
 function Test-AuroqGitResponde {
   try {
@@ -190,10 +241,19 @@ function Test-AuroqGitResponde {
   } catch {
     # segue pro caminho padrao
   }
-  $padrao = Join-Path $env:ProgramFiles 'Git\cmd\git.exe'
-  if (Test-Path $padrao) {
-    $env:Path = "$(Split-Path $padrao);$env:Path"
-    return $true
+  # Dois lugares, porque sao duas instalacoes possiveis: com administrador o Git
+  # vai pra Program Files; sem administrador ele vai pra pasta do usuario. Olhar
+  # so o primeiro fazia o script jurar que o Git nao existe e ficar esperando sem fim.
+  $candidatos = @(
+    (Join-Path $env:ProgramFiles 'Git\cmd\git.exe'),
+    (Join-Path ${env:ProgramFiles(x86)} 'Git\cmd\git.exe'),
+    (Join-Path $env:LOCALAPPDATA 'Programs\Git\cmd\git.exe')
+  )
+  foreach ($padrao in $candidatos) {
+    if ($padrao -and (Test-Path $padrao)) {
+      $env:Path = "$(Split-Path $padrao);$env:Path"
+      return $true
+    }
   }
   return $false
 }
@@ -201,7 +261,7 @@ function Test-AuroqGitResponde {
 function Install-AuroqGit {
   Write-AuroqPasso 'Verificando o Git (o programa que guarda as versoes do seu trabalho)...'
 
-  if ($env:AUROQ_INSTALL_DRY_RUN) { Write-AuroqOk 'Git — seria verificado aqui'; return }
+  if ($env:AUROQ_INSTALL_DRY_RUN) { Write-AuroqOk 'Git - seria verificado aqui'; return }
 
   if (Test-AuroqGitResponde) {
     Write-AuroqOk 'Git ja estava instalado'
@@ -218,7 +278,10 @@ function Install-AuroqGit {
   }
 
   if ($temWinget) {
-    Write-AuroqAviso 'Falta instalar. Vai aparecer uma janela pedindo permissao — clique em "Sim".'
+    Write-AuroqAviso 'Falta instalar o Git. Vai aparecer uma janela pedindo permissao.'
+    Write-AuroqDiz '  Se ela perguntar so "Sim ou Nao", clique em Sim.'
+    Write-AuroqDiz '  Se ela pedir SENHA DE ADMINISTRADOR e voce nao tiver, pode fechar:'
+    Write-AuroqDiz '  eu instalo de outro jeito, que nao precisa de administrador.'
     & winget install --id Git.Git -e --source winget --accept-package-agreements --accept-source-agreements | Out-Null
     Start-Sleep -Seconds 3
     if (Test-AuroqGitResponde) {
@@ -226,19 +289,31 @@ function Install-AuroqGit {
       Write-AuroqLog 'git' 'instalado-winget'
       return
     }
-    Write-AuroqErro 'A instalacao do Git nao terminou (a permissao pode ter sido recusada).' 'Rode o mesmo comando de novo e clique em "Sim" na janela de permissao.'
+    # Nao morre aqui. Quem nao e administrador NUNCA vai conseguir passar dessa
+    # janela, e mandar "rode de novo e clique em Sim" tranca essa pessoa num
+    # loop. O caminho de baixo instala sem administrador nenhum.
+    Write-AuroqAviso 'A janela de permissao nao passou. Vou pelo caminho que nao precisa de administrador.'
+    Write-AuroqLog 'git' 'winget-nao-passou'
   }
 
-  # Windows 10 antigo nao tem winget: abre o instalador oficial e espera o aluno.
-  Write-AuroqAviso 'Falta instalar o Git. Vou abrir a pagina oficial no seu navegador.'
+  # Duas situacoes caem aqui: Windows 10 antigo sem winget, e aluno sem direito
+  # de administrador. O instalador oficial do Git resolve as duas: ele declara
+  # `PrivilegesRequired=none` e sabe instalar so pro usuario, em %LOCALAPPDATA%.
+  Write-AuroqAviso 'Vou abrir a pagina oficial do Git no seu navegador.'
   Write-AuroqDiz '  1. Baixe o instalador que a pagina oferecer'
   Write-AuroqDiz '  2. De dois cliques no arquivo baixado'
-  Write-AuroqDiz '  3. Clique em "Next" em todas as telas e depois em "Install"'
-  Write-AuroqDiz '  4. No fim, clique em "Finish" e volte pra ca — eu espero'
+  Write-AuroqDiz '  3. Se ele perguntar para quem instalar, escolha a opcao de instalar'
+  Write-AuroqDiz '     SO PRA VOCE - ela nao pede senha de administrador'
+  Write-AuroqDiz '  4. Clique em "Next" em todas as telas e depois em "Install"'
+  Write-AuroqDiz '  5. No fim, clique em "Finish" e volte pra ca - eu espero'
   Start-Process 'https://git-scm.com/downloads/win'
 
+  # 20 minutos de espera pelo aluno. O teto e regulavel so pra maquina limpa do
+  # CI nao gastar 20 minutos de runner provando uma mensagem.
+  $teto = 1200
+  if ($env:AUROQ_INSTALL_ESPERA_GIT) { $teto = [int]$env:AUROQ_INSTALL_ESPERA_GIT }
   $esperou = 0
-  while ($esperou -lt 1200) {
+  while ($esperou -lt $teto) {
     if (Test-AuroqGitResponde) {
       Write-AuroqOk 'Git instalado'
       Write-AuroqLog 'git' 'instalado-manual'
@@ -248,15 +323,15 @@ function Install-AuroqGit {
     $esperou = $esperou + 10
     if (($esperou % 120) -eq 0) { Write-AuroqDiz "  ainda esperando... ($esperou s)" }
   }
-  Write-AuroqErro 'A instalacao do Git nao terminou.' 'Termine a instalacao e rode o mesmo comando de novo — nada do que ja foi feito se perde.'
+  Write-AuroqErro 'A instalacao do Git nao terminou.' 'Termine a instalacao e rode o mesmo comando de novo - nada do que ja foi feito se perde.'
 }
 
-# ─── Passo 3: o motor (§5.3) ──────────────────────────────────────────────────
+# --- Passo 3: o motor (sec. 5.3) --------------------------------------------------
 
 function Install-AuroqNode {
   Write-AuroqPasso 'Verificando o motor do sistema...'
 
-  if ($env:AUROQ_INSTALL_DRY_RUN) { Write-AuroqOk 'Motor — seria instalado em uma pasta sua, sem senha'; return }
+  if ($env:AUROQ_INSTALL_DRY_RUN) { Write-AuroqOk 'Motor - seria instalado em uma pasta sua, sem senha'; return }
 
   $atual = ''
   try {
@@ -309,7 +384,7 @@ function Install-AuroqNode {
   }
   if (-not $esperado -or ($esperado.ToLower() -ne $obtido.ToLower())) {
     Remove-Item $destino -Force -ErrorAction SilentlyContinue
-    Write-AuroqErro 'O arquivo do motor baixou com defeito.' 'Rode o mesmo comando de novo — o arquivo estragado ja foi apagado.'
+    Write-AuroqErro 'O arquivo do motor baixou com defeito.' 'Rode o mesmo comando de novo - o arquivo estragado ja foi apagado.'
   }
 
   # mark-of-the-web: sem desbloquear, o Windows recusa abrir o que veio da internet
@@ -336,12 +411,12 @@ function Install-AuroqNode {
   Write-AuroqLog 'motor' "instalado versao=$versao chip=$chip"
 }
 
-# ─── Passo 4: login da mentoria (§5.5) ────────────────────────────────────────
+# --- Passo 4: login da mentoria (sec. 5.5) ----------------------------------------
 
 function Invoke-AuroqLogin {
   Write-AuroqPasso 'Agora entre com o seu acesso da Mentoria Arcane.'
 
-  if ($env:AUROQ_INSTALL_DRY_RUN) { Write-AuroqOk 'Login — seria pedido aqui (e-mail e senha da plataforma)'; return }
+  if ($env:AUROQ_INSTALL_DRY_RUN) { Write-AuroqOk 'Login - seria pedido aqui (e-mail e senha da plataforma)'; return }
 
   # `check-access` e a mesma regua do resto do sistema: sai com sucesso so com
   # contrato ativo conferido agora. Sem sessao salva, ele mesmo pede e-mail e
@@ -351,11 +426,11 @@ function Invoke-AuroqLogin {
   # sucesso. Usado como pergunta de sim/nao, ele dizia "voce ja estava logado"
   # pra quem nunca logou, pulava o portao e deixava a conta sem acesso chegar ate
   # a criacao da pasta.
-  & npx -y auroq-os@latest check-access
+  & (Get-AuroqNpx) -y auroq-os@latest check-access
   if ($LASTEXITCODE -ne 0) {
     Write-AuroqLog 'login' 'recusado'
     Write-Host ''
-    Write-Host '  Sem acesso ativo, a instalacao para aqui — e nada foi criado no seu computador.' -ForegroundColor DarkGray
+    Write-Host '  Sem acesso ativo, a instalacao para aqui - e nada foi criado no seu computador.' -ForegroundColor DarkGray
     Write-Host "  O que fazer agora: fale com o suporte $AuroqSuporte" -ForegroundColor DarkGray
     Write-Host ''
     exit 1
@@ -363,11 +438,11 @@ function Invoke-AuroqLogin {
   Write-AuroqLog 'login' 'ok'
 }
 
-# ─── Passo 5: pasta do negocio (§5.6) ─────────────────────────────────────────
+# --- Passo 5: pasta do negocio (sec. 5.6) -----------------------------------------
 
 function Get-AuroqPasta {
   Write-AuroqPasso 'Qual o nome da pasta do seu negocio?'
-  Write-AuroqDiz '(so letras minusculas e hifen — ex: minha-empresa)'
+  Write-AuroqDiz '(so letras minusculas e hifen - ex: minha-empresa)'
 
   $nome = $env:AUROQ_INSTALL_PASTA
   $tentativas = 0
@@ -380,7 +455,7 @@ function Get-AuroqPasta {
       $estado = Get-AuroqEstadoPasta $alvo
       if ($estado -eq 'auroq') {
         Write-Host ''
-        Write-AuroqAviso "Ja existe um Auroq em $alvo — nao vou mexer nele."
+        Write-AuroqAviso "Ja existe um Auroq em $alvo - nao vou mexer nele."
         Write-AuroqDiz 'Pra conferir se esta tudo certo la, abra essa pasta e rode:'
         Write-AuroqDiz '  auroq-os doctor'
         Write-AuroqLog 'pasta' 'ja-tinha-auroq'
@@ -394,7 +469,7 @@ function Get-AuroqPasta {
         break
       }
     } elseif ([string]::IsNullOrWhiteSpace($nome)) {
-      # Enter vazio so repete a pergunta — o aluno ainda nao escreveu nada.
+      # Enter vazio so repete a pergunta - o aluno ainda nao escreveu nada.
       $nome = ''
     } else {
       Write-AuroqDiz 'Esse nome nao serve: use so letras minusculas, numeros e hifen.'
@@ -408,7 +483,7 @@ function Get-AuroqPasta {
     }
   }
 
-  if ($env:AUROQ_INSTALL_DRY_RUN) { Write-AuroqOk "Pasta $script:AuroqPastaAlvo — seria criada aqui"; return }
+  if ($env:AUROQ_INSTALL_DRY_RUN) { Write-AuroqOk "Pasta $script:AuroqPastaAlvo - seria criada aqui"; return }
 
   try {
     if (-not (Test-Path $script:AuroqPastaAlvo)) {
@@ -420,15 +495,15 @@ function Get-AuroqPasta {
   Write-AuroqLog 'pasta' 'criada'
 }
 
-# ─── Passo 6: montar o Auroq ──────────────────────────────────────────────────
+# --- Passo 6: montar o Auroq --------------------------------------------------
 
 function Invoke-AuroqInit {
   Write-AuroqPasso "Montando o Auroq dentro de $script:AuroqPastaAlvo..."
 
-  if ($env:AUROQ_INSTALL_DRY_RUN) { Write-AuroqOk 'Sistema — seria montado aqui'; return }
+  if ($env:AUROQ_INSTALL_DRY_RUN) { Write-AuroqOk 'Sistema - seria montado aqui'; return }
 
   Set-Location $script:AuroqPastaAlvo
-  & npx -y auroq-os@latest init
+  & (Get-AuroqNpx) -y auroq-os@latest init
   if ($LASTEXITCODE -ne 0) {
     Write-AuroqLog 'init' 'falhou'
     Write-AuroqErro 'A montagem do sistema parou no meio.' 'Rode o mesmo comando de novo. Se repetir, mande pro suporte o arquivo install.log da pasta .auroq.'
@@ -436,33 +511,36 @@ function Invoke-AuroqInit {
   Write-AuroqLog 'init' 'ok'
 }
 
-# ─── Passo 7: fecho ───────────────────────────────────────────────────────────
+# --- Passo 7: fecho -----------------------------------------------------------
 
 function Write-AuroqFecho {
   $nome = Split-Path $script:AuroqPastaAlvo -Leaf
   Write-Host ''
-  Write-Host '  ─────────────────────────────────────────────' -ForegroundColor Magenta
+  Write-Host '  ---------------------------------------------' -ForegroundColor Magenta
   Write-Host ''
   Write-AuroqDiz "Pronto. O Auroq esta em $script:AuroqPastaAlvo"
   Write-Host ''
   Write-AuroqDiz 'Falta um detalhe importante:'
   Write-Host ''
-  Write-AuroqDiz '  1. FECHE o Claude Code (ou o Codex) por completo e abra de novo'
-  Write-AuroqDiz '     — sem isso ele nao enxerga o que acabou de ser instalado'
-  Write-AuroqDiz "  2. Abra a pasta $nome"
-  Write-AuroqDiz '  3. Chame o Ops:  /AuroqOS:agents:ops   (no Codex: $ops)'
-  Write-AuroqDiz '  4. Digite:  *bootstrap'
+  Write-AuroqDiz '  1. FECHE esta janela por completo e abra o PowerShell de novo'
+  Write-AuroqDiz '     - sem isso ele nao enxerga o que acabou de ser instalado'
+  Write-AuroqDiz '  2. Entre na pasta do seu negocio. Copie e cole esta linha:'
+  Write-AuroqDiz "       cd `"$script:AuroqPastaAlvo`""
+  Write-AuroqDiz '  3. Abra a ferramenta escrevendo:  claude     (no Codex: codex)'
+  Write-AuroqDiz '  4. Chame o Ops:  /AuroqOS:agents:ops   (no Codex: $ops)'
+  Write-AuroqDiz '  5. Digite:  *bootstrap'
   Write-Host ''
   Write-AuroqDiz 'O Ops instala o resto e te guia daqui pra frente.'
   Write-Host ''
   Write-AuroqLog 'fim' "ok pasta=$nome"
 }
 
-# ─── Fluxo ────────────────────────────────────────────────────────────────────
+# --- Fluxo --------------------------------------------------------------------
 
 function Invoke-AuroqInstalacao {
-  Write-AuroqTitulo 'Auroq OS — instalacao'
+  Write-AuroqTitulo 'Auroq OS - instalacao'
   Test-AuroqMaquina
+  Set-AuroqCaminhoDaFerramenta
   Install-AuroqGit
   Install-AuroqNode
   Invoke-AuroqLogin

package/installer/install.sh

@@ -18,7 +18,7 @@
 
 set -u
 
-SUPORTE="11 97312-2273"
+SUPORTE="11 93621-4486"
 NODE_MIN=20
 MACOS_MIN=13
 DISCO_MIN_MB=2048
@@ -174,12 +174,62 @@ auroq_aplicar_path() {
   mv "$tmp" "$arquivo"
 }
 
+# O motor precisa aparecer em DOIS lugares diferentes, por motivos diferentes.
+#
+# Os arquivos do zsh sao obrigatorios sempre: e por eles que o Claude Code e o
+# Codex abertos pelo ICONE montam o ambiente. Sem isso o app sobe sem erro
+# nenhum e o Companion "nao sabe de nada" (§5.4 do PRD).
+#
+# Os do shell do aluno sao pra janela que ele digita. O macOS 13+ usa zsh e os
+# dois coincidem — mas quem trocou pra bash instalava com sucesso, nao via erro,
+# e depois nenhum comando era reconhecido. Falha silenciosa e a pior de todas:
+# nao tem o que pesquisar, entao a conclusao vira "esse sistema e ruim".
 auroq_publicar_node_no_path() {
   local bin="${1:-}"
   local arquivo
+
+  # Sempre: o app aberto pelo icone le daqui.
   for arquivo in "${HOME}/.zshrc" "${HOME}/.zprofile"; do
     auroq_aplicar_path "$arquivo" "$bin"
   done
+
+  case "${SHELL:-}" in
+    *zsh )
+      : # ja coberto acima
+      ;;
+    *bash )
+      for arquivo in "${HOME}/.bash_profile" "${HOME}/.bashrc"; do
+        auroq_aplicar_path "$arquivo" "$bin"
+      done
+      ;;
+    '' )
+      : # sem SHELL definido (roda dentro de outro programa): o zsh cobre
+      ;;
+    * )
+      # Nao invento a sintaxe de um shell que nao sei testar. Melhor o aluno
+      # saber agora, com nome e saida, do que descobrir que "nada funciona".
+      aviso "O seu terminal (${SHELL##*/}) nao e o padrao do Mac, entao eu nao consigo"
+      diz "  deixar o sistema pronto nele. Use o app Terminal (que vem no Mac) pra"
+      diz "  trabalhar com o Auroq, ou chame o suporte ${SUPORTE} pra ajustar o seu."
+      auroq_registrar_log "path" "shell-nao-suportado=${SHELL##*/}"
+      ;;
+  esac
+}
+
+# A ferramenta do aluno (Claude Code) se instala em ~/.local/bin e nem sempre
+# publica essa pasta. Achado num piloto real no Windows: o aluno terminava a
+# parada 1, escrevia `claude`, nao acontecia nada, e concluia que tinha falhado.
+# O mesmo vale aqui — e o conserto e o mesmo caminho que ja publica o motor.
+auroq_publicar_ferramenta_no_path() {
+  local bin="${HOME}/.local/bin"
+  [ -x "${bin}/claude" ] || return 0
+  case ":${PATH}:" in *":${bin}:"* ) return 0 ;; esac
+
+  auroq_publicar_node_no_path "$bin"
+  PATH="${bin}:${PATH}"
+  export PATH
+  ok_feito "Deixei o Claude Code visivel em qualquer janela"
+  auroq_registrar_log "ferramenta" "claude-publicado"
 }
 
 # ─── Passo 1: diagnostico (§5.1) ──────────────────────────────────────────────
@@ -275,6 +325,30 @@ auroq_garantir_git() {
 # Fica numa pasta do proprio aluno. Sem senha, sem sudo, sem tocar no que ele ja
 # tinha instalado: se ja existe um motor bom, usamos o dele.
 
+# Abre o pacote do motor direto na pasta final.
+#
+# A versao anterior descompactava ao lado e movia com `mv .../node-v*-darwin-* destino`.
+# O curinga pegava DOIS caminhos — a pasta aberta e o proprio .tar.gz, que mora no
+# mesmo lugar — e `mv` com duas origens exige que o destino ja seja uma pasta. Como
+# o destino tinha acabado de ser renomeado pra `.antigo`, ele nao existia: todo aluno
+# sem motor na maquina batia em "Nao consegui guardar o motor na sua pasta".
+#
+# Aqui nao existe curinga: `--strip-components=1` joga o conteudo direto no destino.
+auroq_desempacotar_node() {
+  local pacote="$1" destino="$2"
+
+  rm -rf "${destino}.antigo" 2>/dev/null || true
+  if [ -d "$destino" ]; then
+    mv "$destino" "${destino}.antigo" 2>/dev/null || return 1
+  fi
+
+  mkdir -p "$destino" 2>/dev/null || return 1
+  tar -xzf "$pacote" -C "$destino" --strip-components=1 2>/dev/null || return 1
+
+  # So e sucesso se o motor de fato ficou de pe.
+  [ -x "${destino}/bin/node" ] || return 1
+}
+
 auroq_garantir_node() {
   passo "Verificando o motor do sistema..."
 
@@ -324,12 +398,7 @@ auroq_garantir_node() {
     auroq_erro "O arquivo do motor baixou com defeito." "Rode o mesmo comando de novo — o arquivo estragado ja foi apagado."
   fi
 
-  mkdir -p "$NODE_DIR" 2>/dev/null || auroq_erro "Nao consegui criar a pasta ${NODE_DIR}." "Confira se voce tem permissao de escrita na sua pasta pessoal e rode de novo."
-  tar -xzf "${tmpdir}/${tarball}" -C "$tmpdir" 2>/dev/null \
-    || { rm -rf "$tmpdir"; auroq_erro "Nao consegui abrir o arquivo do motor." "Rode o mesmo comando de novo."; }
-  rm -rf "${NODE_DIR}.antigo" 2>/dev/null || true
-  [ -d "$NODE_DIR" ] && mv "$NODE_DIR" "${NODE_DIR}.antigo" 2>/dev/null || true
-  mv "${tmpdir}/node-v${versao}-darwin-"* "$NODE_DIR" 2>/dev/null \
+  auroq_desempacotar_node "${tmpdir}/${tarball}" "$NODE_DIR" \
     || { rm -rf "$tmpdir"; auroq_erro "Nao consegui guardar o motor na sua pasta." "Rode o mesmo comando de novo."; }
   rm -rf "$tmpdir" "${NODE_DIR}.antigo"
 
@@ -467,11 +536,13 @@ auroq_fecho() {
   printf '\n'
   diz "Falta um detalhe importante:"
   printf '\n'
-  diz "  1. FECHE o Claude Code (ou o Codex) por completo e abra de novo"
+  diz "  1. FECHE esta janela por completo e abra o Terminal de novo"
   diz "     ${FRACO}— sem isso ele nao enxerga o que acabou de ser instalado${FIM}"
-  diz "  2. Abra a pasta ${PASTA_ALVO##*/}"
-  diz "  3. Chame o Ops:  ${CIANO}/AuroqOS:agents:ops${FIM}   ${FRACO}(no Codex: \$ops)${FIM}"
-  diz "  4. Digite:  ${CIANO}*bootstrap${FIM}"
+  diz "  2. Entre na pasta do seu negocio. Copie e cole esta linha:"
+  diz "       ${CIANO}cd \"${PASTA_ALVO}\"${FIM}"
+  diz "  3. Abra a ferramenta escrevendo:  ${CIANO}claude${FIM}     ${FRACO}(no Codex: codex)${FIM}"
+  diz "  4. Chame o Ops:  ${CIANO}/AuroqOS:agents:ops${FIM}   ${FRACO}(no Codex: \$ops)${FIM}"
+  diz "  5. Digite:  ${CIANO}*bootstrap${FIM}"
   printf '\n'
   diz "O Ops instala o resto e te guia daqui pra frente."
   printf '\n'
@@ -483,6 +554,7 @@ auroq_fecho() {
 auroq_main() {
   titulo "Auroq OS — instalacao"
   auroq_diagnostico
+  auroq_publicar_ferramenta_no_path
   auroq_garantir_git
   auroq_garantir_node
   auroq_login_mentoria

package/lib/auth.js

@@ -5,7 +5,7 @@ const { createAuthClient } = require('./supabase');
 const credentials = require('./credentials');
 
 const PLATFORM_URL = 'https://arcane.arka.education';
-const SUPPORT_CONTACT = '11 97312-2273';
+const SUPPORT_CONTACT = '11 93621-4486';
 const MAX_LOGIN_ATTEMPTS = 3;
 
 const PURPLE = '\x1b[38;2;120;80;200m';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auroq-os",
-  "version": "2.4.0",
+  "version": "2.4.2",
   "description": "Auroq OS — Sistema Operacional de IA para Experts",
   "bin": {
     "auroq-os": "bin/auroq-os.js"