auroq-os 2.3.6 → 2.4.0

package/installer/install.sh

@@ -0,0 +1,500 @@
+#!/bin/bash
+# Auroq OS — instalador do Mac.
+#
+#   curl -fsSL https://arka.education/install.sh | bash
+#
+# Este script roda na maquina de alguem que ainda nao tem NADA: sem Git, sem o
+# motor do sistema, as vezes sem as ferramentas da Apple. Por isso ele e escrito
+# pro bash 3.2 (o que vem no macOS), nao pede senha nenhuma e nao usa sudo.
+#
+# Ordem obrigatoria (PRD "Embarque em 2 passos" §4.2):
+#   diagnostico -> Git -> motor -> login da mentoria -> pasta do negocio -> init
+#
+# O `init` e quem escreve o registro do conteudo ao vivo. O instalador nao mexe
+# nisso (ADR-7) — a maquina do aluno tem um dono so pra esse arquivo.
+#
+# Modo biblioteca (usado pelos testes):  AUROQ_INSTALL_LIB=1 . install.sh
+# Modo ensaio (nao toca em nada):        AUROQ_INSTALL_DRY_RUN=1 bash install.sh
+
+set -u
+
+SUPORTE="11 97312-2273"
+NODE_MIN=20
+MACOS_MIN=13
+DISCO_MIN_MB=2048
+AUROQ_DIR="${HOME}/.auroq"
+NODE_DIR="${AUROQ_DIR}/node"
+
+# Cores — desligadas quando a saida nao e um terminal (log de suporte fica limpo).
+if [ -t 1 ]; then
+  ROXO=$'\033[38;2;120;80;200m'; CIANO=$'\033[38;2;34;211;238m'; VERDE=$'\033[38;2;52;211;153m'
+  AMBAR=$'\033[38;2;251;191;36m'; VERMELHO=$'\033[38;2;248;113;113m'; FRACO=$'\033[2m'; FIM=$'\033[0m'
+else
+  ROXO=''; CIANO=''; VERDE=''; AMBAR=''; VERMELHO=''; FRACO=''; FIM=''
+fi
+
+# ─── Fala com o aluno ─────────────────────────────────────────────────────────
+
+diz()      { printf '  %s\n' "$*"; }
+titulo()   { printf '\n%s  %s%s\n\n' "$ROXO" "$*" "$FIM"; }
+passo()    { printf '\n  %s>%s %s\n' "$CIANO" "$FIM" "$*"; }
+ok_feito() { printf '  %s+%s %s\n' "$VERDE" "$FIM" "$*"; }
+aviso()    { printf '  %s!%s %s\n' "$AMBAR" "$FIM" "$*"; }
+
+# Toda falha diz tres coisas: o que aconteceu, o que fazer agora e o suporte.
+# Um instalador que trava calado e pior que o passo a passo manual.
+auroq_erro() {
+  printf '\n  %sParou aqui:%s %s\n' "$VERMELHO" "$FIM" "${1:-Algo deu errado.}"
+  printf '\n  %sO que fazer agora:%s %s\n' "$CIANO" "$FIM" "${2:-Rode o mesmo comando de novo.}"
+  printf '\n  %sSe continuar travado, chame o suporte: %s%s\n\n' "$FRACO" "$SUPORTE" "$FIM"
+  auroq_registrar_log "erro" "${1:-}"
+  exit 1
+}
+
+# ─── Registro pro suporte (§5.7) ──────────────────────────────────────────────
+# Uma linha por evento. Nunca entra senha, token ou e-mail — o suporte precisa
+# saber o que aconteceu na maquina, nao quem e a pessoa.
+
+auroq_registrar_log() {
+  [ -n "${AUROQ_INSTALL_DRY_RUN:-}" ] && return 0
+  mkdir -p "${HOME}/.auroq" 2>/dev/null || return 0
+  printf '%s\t%s\t%s\n' "$(date -u '+%Y-%m-%dT%H:%M:%SZ')" "${1:-}" "${2:-}" \
+    >> "${HOME}/.auroq/install.log" 2>/dev/null || true
+}
+
+# ─── Decisoes puras (testadas uma a uma) ──────────────────────────────────────
+
+# So letras minusculas, numeros e hifen. Recusar e melhor que "consertar" sozinho:
+# o nome da pasta e o nome do negocio dele, e ele precisa reconhecer.
+auroq_validar_pasta() {
+  local nome="${1:-}"
+  local ok=1
+  # Enter vazio nao e erro do aluno: ele ainda nao escreveu nada. So repete a
+  # pergunta — acusar "nome errado" aqui assusta a toa.
+  if [ -z "$nome" ]; then
+    return 1
+  fi
+  case "$nome" in
+    '' ) ok=0 ;;
+    * ) LC_ALL=C; case "$nome" in
+          *[!a-z0-9-]* ) ok=0 ;;
+          -* | *-- ) ok=0 ;;
+          * ) ok=1 ;;
+        esac ;;
+  esac
+  if [ "$ok" -eq 1 ]; then
+    return 0
+  fi
+  diz "Esse nome nao serve: use so letras minusculas, numeros e hifen."
+  diz "${FRACO}Exemplo bom: minha-empresa${FIM}"
+  return 1
+}
+
+auroq_macos_serve() {
+  local versao="${1:-0}"
+  local maior="${versao%%.*}"
+  case "$maior" in
+    ''|*[!0-9]* ) return 1 ;;
+  esac
+  [ "$maior" -ge "$MACOS_MIN" ]
+}
+
+auroq_node_serve() {
+  local versao="${1:-}"
+  versao="${versao#v}"
+  local maior="${versao%%.*}"
+  case "$maior" in
+    ''|*[!0-9]* ) return 1 ;;
+  esac
+  [ "$maior" -ge "$NODE_MIN" ]
+}
+
+auroq_node_tarball() {
+  local versao="${1:-}"
+  local arq="${2:-}"
+  local alvo="x64"
+  [ "$arq" = "arm64" ] && alvo="arm64"
+  printf 'node-v%s-darwin-%s.tar.gz\n' "$versao" "$alvo"
+}
+
+# ─── Falar com o aluno de dentro de um `curl | bash` ──────────────────────────
+# Quando o script chega por `curl ... | bash`, a entrada padrao dele — e de TUDO
+# que ele chamar — e o proprio texto do script. Um programa filho que pergunta
+# "qual o seu e-mail?" leria a proxima linha do install.sh como resposta.
+# Por isso todo comando que conversa com o aluno e ligado no terminal de verdade.
+
+auroq_tem_terminal() {
+  [ -t 0 ] && return 0
+  [ -e /dev/tty ] && (exec 3< /dev/tty) 2>/dev/null && return 0
+  return 1
+}
+
+# npx que o aluno consegue responder. Sem isso, login e as perguntas do `init`
+# recebem pedaco do script no lugar da resposta dele.
+auroq_npx_aluno() {
+  if [ -t 0 ]; then
+    npx -y auroq-os@latest "$@"
+  else
+    npx -y auroq-os@latest "$@" < /dev/tty
+  fi
+}
+
+# nova | vazia | auroq | ocupada — decidido ANTES de escrever qualquer coisa.
+auroq_estado_pasta() {
+  local dir="${1:-}"
+  if [ ! -d "$dir" ]; then printf 'nova\n'; return 0; fi
+  if [ -d "${dir}/.auroq-core" ]; then printf 'auroq\n'; return 0; fi
+  local resto
+  resto="$(ls -A "$dir" 2>/dev/null | grep -v -x -e '.DS_Store' -e '.localized' | head -1)"
+  if [ -z "$resto" ]; then printf 'vazia\n'; else printf 'ocupada\n'; fi
+}
+
+# ─── O motor visivel pra quem abre pelo icone (§5.4) ──────────────────────────
+# A falha mais perigosa do projeto: o app aberto pelo Dock monta o ambiente lendo
+# os arquivos de perfil. Se o motor nao estiver la, o app sobe SEM ERRO NENHUM e
+# o Companion parece burro. Por isso escrevemos nos dois arquivos, sempre.
+
+auroq_aplicar_path() {
+  local arquivo="${1:-}"
+  local bin="${2:-}"
+  local tmp="${arquivo}.auroq-tmp.$$"
+  [ -f "$arquivo" ] || : > "$arquivo"
+  # tira o bloco antigo (se houver) e escreve o novo — nunca empilha
+  awk '
+    /^# >>> auroq >>>$/ { pulando=1; next }
+    /^# <<< auroq <<<$/ { pulando=0; next }
+    pulando != 1 { print }
+  ' "$arquivo" > "$tmp" 2>/dev/null || cp "$arquivo" "$tmp"
+  {
+    printf '# >>> auroq >>>\n'
+    printf '# Motor do Auroq OS. Bloco gerado pelo instalador — pode apagar se desinstalar.\n'
+    printf 'export PATH="%s:$PATH"\n' "$bin"
+    printf '# <<< auroq <<<\n'
+  } >> "$tmp"
+  mv "$tmp" "$arquivo"
+}
+
+auroq_publicar_node_no_path() {
+  local bin="${1:-}"
+  local arquivo
+  for arquivo in "${HOME}/.zshrc" "${HOME}/.zprofile"; do
+    auroq_aplicar_path "$arquivo" "$bin"
+  done
+}
+
+# ─── Passo 1: diagnostico (§5.1) ──────────────────────────────────────────────
+
+auroq_diagnostico() {
+  passo "Vendo o seu computador..."
+
+  local sistema
+  sistema="$(uname -s 2>/dev/null || echo desconhecido)"
+  if [ "$sistema" != "Darwin" ]; then
+    auroq_erro "Este instalador e do Mac, e aqui nao parece ser um Mac." "No Windows, use o outro endereco: arka.education/install.ps1"
+  fi
+
+  local versao
+  versao="${AUROQ_INSTALL_FAKE_MACOS:-$(sw_vers -productVersion 2>/dev/null || echo 0)}"
+  if ! auroq_macos_serve "$versao"; then
+    auroq_erro "Seu Mac esta no macOS ${versao} e o sistema precisa do 13 ou mais novo." "Atualize o Mac em Ajustes > Geral > Atualizacao de Software, ou fale com o suporte antes de continuar."
+  fi
+
+  local chip
+  chip="$(uname -m 2>/dev/null || echo desconhecido)"
+  local nome_chip="Intel"
+  [ "$chip" = "arm64" ] && nome_chip="chip Apple"
+  ok_feito "Mac com ${nome_chip}, macOS ${versao} — serve"
+
+  local livre_mb
+  livre_mb="${AUROQ_INSTALL_FAKE_DISCO_MB:-$(df -m "$HOME" 2>/dev/null | awk 'NR==2 {print $4}')}"
+  case "${livre_mb:-0}" in
+    ''|*[!0-9]* ) livre_mb=999999 ;;
+  esac
+  if [ "$livre_mb" -lt "$DISCO_MIN_MB" ]; then
+    auroq_erro "Falta espaco no disco: sobram ${livre_mb} MB e sao necessarios pelo menos 2 GB." "Libere espaco (Ajustes > Geral > Armazenamento) e rode o mesmo comando de novo."
+  fi
+
+  if [ -n "${AUROQ_INSTALL_FAKE_SEM_INTERNET:-}" ]; then
+    auroq_erro "Nao consegui falar com a internet." "Conecte na internet e rode o mesmo comando de novo. Nada foi instalado pela metade."
+  fi
+  if [ -z "${AUROQ_INSTALL_DRY_RUN:-}" ]; then
+    if ! curl -sfI --max-time 15 https://registry.npmjs.org/ >/dev/null 2>&1; then
+      auroq_erro "Nao consegui falar com a internet." "Conecte na internet e rode o mesmo comando de novo. Nada foi instalado pela metade."
+    fi
+  fi
+  auroq_registrar_log "diagnostico" "macos=${versao} chip=${chip} disco_mb=${livre_mb}"
+}
+
+# ─── Passo 2: Git (§5.2) ──────────────────────────────────────────────────────
+# No Mac o Git vem junto das ferramentas da Apple. O script abre a janela; quem
+# clica em "Instalar" e o aluno. Isso nao da pra automatizar — e janela do sistema.
+
+auroq_git_responde() {
+  git --version >/dev/null 2>&1 && return 0
+  [ -x /usr/bin/git ] && /usr/bin/git --version >/dev/null 2>&1 && return 0
+  return 1
+}
+
+auroq_garantir_git() {
+  passo "Verificando o Git (o programa que guarda as versoes do seu trabalho)..."
+
+  if [ -n "${AUROQ_INSTALL_DRY_RUN:-}" ]; then
+    ok_feito "Git — seria verificado aqui"
+    return 0
+  fi
+
+  if auroq_git_responde; then
+    ok_feito "Git ja estava instalado"
+    auroq_registrar_log "git" "ja-existia"
+    return 0
+  fi
+
+  aviso "Falta instalar. Vai abrir uma janela da Apple agora."
+  diz "  Clique em \"Instalar\" e volte pra ca — pode levar de 5 a 10 minutos."
+  diz "  Pode deixar baixando e ir tomar um cafe; eu espero."
+  xcode-select --install >/dev/null 2>&1 || true
+
+  local esperou=0
+  while [ "$esperou" -lt 1200 ]; do
+    if auroq_git_responde; then
+      ok_feito "Git instalado"
+      auroq_registrar_log "git" "instalado-pelas-ferramentas-da-apple"
+      return 0
+    fi
+    sleep 10
+    esperou=$((esperou + 10))
+    if [ $((esperou % 120)) -eq 0 ]; then
+      diz "${FRACO}  ainda baixando... (${esperou}s)${FIM}"
+    fi
+  done
+
+  auroq_erro "A instalacao das ferramentas da Apple nao terminou." "Termine a janela da Apple e rode o mesmo comando de novo — nada do que ja foi feito se perde."
+}
+
+# ─── Passo 3: o motor (§5.3) ──────────────────────────────────────────────────
+# 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.
+
+auroq_garantir_node() {
+  passo "Verificando o motor do sistema..."
+
+  if [ -n "${AUROQ_INSTALL_DRY_RUN:-}" ]; then
+    ok_feito "Motor — seria instalado em uma pasta sua, sem senha"
+    return 0
+  fi
+
+  local atual
+  atual="$(node --version 2>/dev/null || true)"
+  if auroq_node_serve "$atual"; then
+    ok_feito "O motor ja estava instalado (${atual})"
+    auroq_registrar_log "motor" "ja-existia versao=${atual} origem=$(command -v node 2>/dev/null || echo desconhecida)"
+    return 0
+  fi
+
+  if [ -n "$atual" ]; then
+    aviso "Voce ja tinha um motor antigo (${atual}); vou instalar um novo do lado, sem mexer no seu."
+  fi
+  diz "  (e um programa que fica numa pasta sua, nao pede senha e nao mexe em nada do seu Mac)"
+
+  local chip alvo indice versao tarball url tmpdir
+  chip="$(uname -m)"
+  alvo="$(auroq_node_tarball "0" "$chip")"
+
+  indice="$(curl -fsSL --max-time 30 https://nodejs.org/dist/index.json 2>/dev/null || true)"
+  [ -z "$indice" ] && auroq_erro "Nao consegui baixar o motor do sistema." "Confira a internet (ou o antivirus, se houver) e rode o mesmo comando de novo."
+
+  versao="$(printf '%s' "$indice" | tr ',' '\n' | grep -o '"version":"v24\.[0-9.]*"' | head -1 | sed 's/.*"v//; s/"//')"
+  [ -z "$versao" ] && versao="$(printf '%s' "$indice" | tr ',' '\n' | grep -o '"version":"v2[0-9]\.[0-9.]*"' | head -1 | sed 's/.*"v//; s/"//')"
+  [ -z "$versao" ] && auroq_erro "Nao consegui descobrir qual motor baixar." "Rode o mesmo comando de novo em alguns minutos. Se insistir, chame o suporte."
+
+  tarball="$(auroq_node_tarball "$versao" "$chip")"
+  url="https://nodejs.org/dist/v${versao}/${tarball}"
+  tmpdir="$(mktemp -d)"
+
+  curl -fsSL --max-time 600 -o "${tmpdir}/${tarball}" "$url" 2>/dev/null \
+    || auroq_erro "O download do motor nao completou." "Pode ser antivirus ou rede instavel. Rode o mesmo comando de novo; se repetir, chame o suporte."
+
+  # Sem conferir a soma oficial, nao instala. Binario nao verificado nao entra.
+  local somas esperado obtido
+  somas="$(curl -fsSL --max-time 60 "https://nodejs.org/dist/v${versao}/SHASUMS256.txt" 2>/dev/null || true)"
+  esperado="$(printf '%s' "$somas" | grep " ${tarball}\$" | awk '{print $1}')"
+  obtido="$(shasum -a 256 "${tmpdir}/${tarball}" 2>/dev/null | awk '{print $1}')"
+  if [ -z "$esperado" ] || [ "$esperado" != "$obtido" ]; then
+    rm -rf "$tmpdir"
+    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 \
+    || { 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"
+
+  auroq_publicar_node_no_path "${NODE_DIR}/bin"
+  export PATH="${NODE_DIR}/bin:${PATH}"
+  # npm global dentro da pasta do aluno: instalar ferramenta depois nao pede senha
+  export npm_config_prefix="${NODE_DIR}"
+
+  ok_feito "Motor instalado (${versao})"
+  auroq_registrar_log "motor" "instalado versao=${versao} chip=${chip}"
+}
+
+# ─── Passo 4: login da mentoria (§5.5) ────────────────────────────────────────
+# Mesma checagem que o resto do sistema usa. So contrato ativo instala.
+
+auroq_login_mentoria() {
+  passo "Agora entre com o seu acesso da Mentoria Arcane."
+
+  if [ -n "${AUROQ_INSTALL_DRY_RUN:-}" ]; then
+    ok_feito "Login — seria pedido aqui (e-mail e senha da plataforma)"
+    return 0
+  fi
+
+  if ! auroq_tem_terminal; then
+    auroq_erro "Preciso do seu e-mail e senha da Mentoria Arcane, e esta janela nao aceita resposta." "Abra o Terminal (ou o terminal de dentro do Claude Code) e cole o mesmo comando la."
+  fi
+
+  # `check-access` e a mesma regua do resto do sistema: exit 0 so com contrato
+  # ativo conferido agora. Sem sessao salva, ele mesmo pede e-mail e senha; com
+  # sessao boa, passa direto e nao pergunta de novo.
+  #
+  # NAO usar `whoami` aqui: ele imprime "Nao autenticado" e mesmo assim sai com
+  # 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.
+  if ! auroq_npx_aluno check-access; then
+    auroq_registrar_log "login" "recusado"
+    printf '\n  %sSem acesso ativo, a instalacao para aqui — e nada foi criado no seu computador.%s\n' "$FRACO" "$FIM"
+    printf '  %sO que fazer agora: fale com o suporte %s%s\n\n' "$FRACO" "$SUPORTE" "$FIM"
+    exit 1
+  fi
+  auroq_registrar_log "login" "ok"
+}
+
+# ─── Passo 5: pasta do negocio (§5.6) ─────────────────────────────────────────
+
+auroq_escolher_pasta() {
+  passo "Qual o nome da pasta do seu negocio?"
+  diz "${FRACO}(so letras minusculas e hifen — ex: minha-empresa)${FIM}"
+
+  local nome="${AUROQ_INSTALL_PASTA:-}"
+  local tentativas=0
+
+  while : ; do
+    if [ -z "$nome" ]; then
+      # Rodando por `curl ... | bash`, a entrada padrao e o proprio script:
+      # a pergunta tem que ir pro terminal de verdade.
+      if [ ! -t 0 ]; then
+        if [ -e /dev/tty ] && (exec 3< /dev/tty) 2>/dev/null; then
+          printf '  Nome: '
+          read -r nome < /dev/tty 2>/dev/null || nome=''
+        else
+          auroq_erro "Nao consegui te perguntar o nome da pasta: esta janela nao aceita resposta." "Abra o Terminal (ou o terminal de dentro do Claude Code) e cole o mesmo comando la."
+        fi
+      else
+        printf '  Nome: '
+        read -r nome || nome=''
+      fi
+    fi
+
+    if auroq_validar_pasta "$nome"; then
+      PASTA_ALVO="${HOME}/${nome}"
+      case "$(auroq_estado_pasta "$PASTA_ALVO")" in
+        auroq )
+          printf '\n'
+          aviso "Ja existe um Auroq em ${PASTA_ALVO} — nao vou mexer nele."
+          diz "Pra conferir se esta tudo certo la, abra essa pasta e rode:"
+          diz "${CIANO}  auroq-os doctor${FIM}"
+          auroq_registrar_log "pasta" "ja-tinha-auroq"
+          exit 0
+          ;;
+        ocupada )
+          aviso "A pasta ${nome} ja existe e tem coisa sua dentro. Escolha outro nome."
+          nome=''
+          ;;
+        * )
+          break
+          ;;
+      esac
+    else
+      nome=''
+    fi
+
+    tentativas=$((tentativas + 1))
+    if [ "$tentativas" -ge 5 ]; then
+      auroq_erro "Nao consegui um nome valido pra pasta." "Rode o mesmo comando de novo e escreva algo como: minha-empresa"
+    fi
+  done
+
+  if [ -n "${AUROQ_INSTALL_DRY_RUN:-}" ]; then
+    ok_feito "Pasta ${PASTA_ALVO} — seria criada aqui"
+    return 0
+  fi
+
+  mkdir -p "$PASTA_ALVO" 2>/dev/null \
+    || auroq_erro "Nao consegui criar a pasta ${PASTA_ALVO}." "Confira se voce tem permissao de escrita na sua pasta pessoal e rode de novo."
+  auroq_registrar_log "pasta" "criada"
+}
+
+# ─── Passo 6: montar o Auroq ──────────────────────────────────────────────────
+
+auroq_rodar_init() {
+  passo "Montando o Auroq dentro de ${PASTA_ALVO}..."
+
+  if [ -n "${AUROQ_INSTALL_DRY_RUN:-}" ]; then
+    ok_feito "Sistema — seria montado aqui"
+    return 0
+  fi
+
+  cd "$PASTA_ALVO" || auroq_erro "Nao consegui entrar na pasta ${PASTA_ALVO}." "Rode o mesmo comando de novo."
+  # ligado no terminal de verdade: o `init` ainda pergunta se ele ja usa o Auroq
+  # em outra maquina (3a pergunta do §4.4), e essa resposta e do aluno.
+  if ! auroq_npx_aluno init; then
+    auroq_registrar_log "init" "falhou"
+    auroq_erro "A montagem do sistema parou no meio." "Rode o mesmo comando de novo. Se repetir, mande pro suporte o arquivo ~/.auroq/install.log"
+  fi
+  auroq_registrar_log "init" "ok"
+}
+
+# ─── Passo 7: fecho ───────────────────────────────────────────────────────────
+
+auroq_fecho() {
+  printf '\n  %s%s%s\n\n' "$ROXO" "─────────────────────────────────────────────" "$FIM"
+  diz "Pronto. O Auroq esta em ${PASTA_ALVO}"
+  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 "     ${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}"
+  printf '\n'
+  diz "O Ops instala o resto e te guia daqui pra frente."
+  printf '\n'
+  auroq_registrar_log "fim" "ok pasta=${PASTA_ALVO##*/}"
+}
+
+# ─── Fluxo ────────────────────────────────────────────────────────────────────
+
+auroq_main() {
+  titulo "Auroq OS — instalacao"
+  auroq_diagnostico
+  auroq_garantir_git
+  auroq_garantir_node
+  auroq_login_mentoria
+  auroq_escolher_pasta
+  auroq_rodar_init
+  auroq_fecho
+}
+
+# Carregado pelos testes: so define as funcoes e sai.
+if [ -n "${AUROQ_INSTALL_LIB:-}" ]; then
+  return 0 2>/dev/null || true
+else
+  PASTA_ALVO=""
+  auroq_main
+fi

package/lib/auth.js

@@ -296,13 +296,24 @@ async function logout() {
   ok('Sessao encerrada. Credenciais locais removidas.');
 }
 
+/**
+ * Mostra quem esta autenticado NESTA maquina, pelo que esta salvo no disco.
+ *
+ * Retorna `true` so quando ha sessao salva com o ultimo status conhecido
+ * 'ativo' — e o CLI transforma isso em codigo de saida. Antes ele saia com
+ * sucesso ate sem credencial nenhuma, e quem usasse `whoami` como pergunta de
+ * sim/nao (era o caso do instalador) concluia que o aluno ja estava logado.
+ *
+ * Continua sendo uma leitura LOCAL: pra decidir acesso de verdade, o portao e
+ * `check-access` / `requireActiveAccess()`, que confere online.
+ */
 function whoami() {
   const cred = credentials.load();
   if (!cred) {
     log(`${DIM}Nao autenticado.${RESET}`);
     log('');
     log(`${DIM}Para entrar: ${CYAN}auroq-os login${RESET}`);
-    return;
+    return false;
   }
   const now = Math.floor(Date.now() / 1000);
   const validatedAgo = cred.last_validated_at ? Math.floor((now - cred.last_validated_at) / 60) : null;
@@ -320,6 +331,7 @@ function whoami() {
   }
   log(`${DIM}Access token:${RESET} ${expired ? `${GOLD}expirado${RESET}` : `${GREEN}valido${RESET}`}`);
   log('');
+  return cred.last_status === 'ativo';
 }
 
 /**

package/lib/diagnostico.js

@@ -0,0 +1,125 @@
+/**
+ * Diagnostico do motor — as perguntas que o `doctor` faz em voz alta.
+ *
+ * Existe por causa de uma falha que nao aparece na tela: o programa aberto pelo
+ * icone (Dock no Mac, Menu Iniciar no Windows) monta o ambiente lendo o perfil do
+ * usuario, nao a janela do terminal onde a instalacao rodou. Se o motor ficou so
+ * na sessao, tudo funciona no terminal e nada funciona no app — e o aluno conclui
+ * que o Companion "nao sabe de nada".
+ *
+ * PRD "Embarque em 2 passos" §5.4.
+ */
+const fs = require('fs');
+const path = require('path');
+
+const INICIO = '# >>> auroq >>>';
+const FIM = '# <<< auroq <<<';
+const PERFIS = ['.zshrc', '.zprofile'];
+const NODE_MIN = 20;
+
+/** Devolve o caminho que o bloco do instalador publica, ou null. */
+function lerBlocoAuroq(conteudo) {
+  if (!conteudo || typeof conteudo !== 'string') return null;
+  const i = conteudo.indexOf(INICIO);
+  if (i === -1) return null;
+  const f = conteudo.indexOf(FIM, i);
+  const trecho = f === -1 ? conteudo.slice(i) : conteudo.slice(i, f);
+  const m = trecho.match(/export PATH="([^":]+):\$PATH"/);
+  return m ? m[1] : null;
+}
+
+/**
+ * O programa aberto pelo icone vai enxergar o motor?
+ *
+ * No Mac a resposta mora nos perfis do usuario. No Windows o ambiente do usuario
+ * ja e herdado pelo processo grafico, entao a pergunta se resolve no proprio PATH.
+ */
+function appEnxergaMotor({ homeDir, pathAtual = '', caminhoMotor = '', plataforma = process.platform } = {}) {
+  const partes = String(pathAtual).split(plataforma === 'win32' ? ';' : ':').filter(Boolean);
+
+  if (plataforma === 'win32') {
+    const temAuroq = partes.some((p) => /auroq/i.test(p));
+    return {
+      visivel: partes.length > 0,
+      perfisSemBloco: [],
+      motivo: temAuroq ? '' : 'O motor esta valendo nesta janela.',
+    };
+  }
+
+  const perfisSemBloco = [];
+  const conteudos = [];
+  let declarado = null;
+  for (const nome of PERFIS) {
+    let conteudo = null;
+    try {
+      conteudo = fs.readFileSync(path.join(homeDir, nome), 'utf8');
+    } catch {
+      conteudo = null;
+    }
+    conteudos.push(conteudo || '');
+    const bin = lerBlocoAuroq(conteudo);
+    if (bin) declarado = declarado || bin;
+    else perfisSemBloco.push(nome);
+  }
+
+  // A pergunta e "o app aberto pelo icone vai achar UM motor?", nao "o instalador
+  // passou por aqui?". Quem ja tinha Homebrew ou nvm declarado no perfil esta
+  // servido — acusar essa gente encheria o suporte de chamado sem defeito.
+  if (!declarado && caminhoMotor) {
+    const dir = path.dirname(String(caminhoMotor));
+    // /usr/bin e /bin ja estao no caminho padrao de qualquer programa do sistema
+    if (dir === '/usr/bin' || dir === '/bin') {
+      return { visivel: true, perfisSemBloco: [], motivo: '' };
+    }
+    const juntos = conteudos.join('\n');
+    const raiz = dir.replace(/\/(bin|sbin)$/, '');
+    if (juntos.includes(dir) || (raiz && raiz !== dir && juntos.includes(raiz))) {
+      return { visivel: true, perfisSemBloco: [], motivo: '' };
+    }
+  }
+
+  if (!declarado) {
+    return {
+      visivel: false,
+      perfisSemBloco,
+      motivo: 'O motor nao esta no seu perfil: quem abre o programa pelo icone (Dock) pode nao enxergar ele.',
+    };
+  }
+  if (perfisSemBloco.length > 0) {
+    return {
+      visivel: false,
+      perfisSemBloco,
+      motivo: `Falta o motor em ${perfisSemBloco.join(' e ')} — dependendo de como voce abre o programa, ele nao aparece.`,
+    };
+  }
+  const noPathAgora = partes.some((p) => p === declarado || p.startsWith(declarado));
+  return {
+    visivel: true,
+    perfisSemBloco: [],
+    motivo: noPathAgora ? '' : 'Esta no seu perfil. Feche e abra o programa pra ele passar a enxergar.',
+  };
+}
+
+/** De onde veio o motor que esta rodando — importa quando ha mais de um. */
+function origemDoMotor(caminho) {
+  if (!caminho || typeof caminho !== 'string') return 'desconhecida';
+  if (caminho.includes('/.auroq/') || /\\Auroq\\/i.test(caminho)) return 'Auroq';
+  if (caminho.includes('/.nvm/') || caminho.includes('/.fnm/')) return 'nvm';
+  if (caminho.startsWith('/opt/homebrew/') || caminho.startsWith('/usr/local/')) return 'Homebrew';
+  if (caminho.startsWith('/usr/')) return 'sistema';
+  return 'desconhecida';
+}
+
+/** Uma frase que o aluno entende, sem jargao. */
+function resumoDoMotor({ versao = '', caminho = '' } = {}) {
+  const limpa = String(versao).replace(/^v/, '');
+  const maior = parseInt(limpa.split('.')[0], 10);
+  const origem = origemDoMotor(caminho);
+  const base = `Motor do sistema: ${limpa || 'nao encontrado'} (instalado por: ${origem})`;
+  if (Number.isFinite(maior) && maior < NODE_MIN) {
+    return `${base} — esse motor e antigo demais pro sistema; rode o instalador de novo.`;
+  }
+  return base;
+}
+
+module.exports = { lerBlocoAuroq, appEnxergaMotor, origemDoMotor, resumoDoMotor, PERFIS };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auroq-os",
-  "version": "2.3.6",
+  "version": "2.4.0",
   "description": "Auroq OS — Sistema Operacional de IA para Experts",
   "bin": {
     "auroq-os": "bin/auroq-os.js"
@@ -18,7 +18,7 @@
     "auroq:sync:codex:check": "npm run sync:codex:check",
     "auroq:validate": "npm run validate:hybrid",
     "validate:hybrid": "node scripts/validate-hybrid.mjs",
-    "lint": "node --check bin/auroq-os.js && node --check lib/auth.js && node --check lib/credentials.js && node --check lib/onepassword.js && node --check lib/supabase.js && node --check scripts/sync-codex-skills.mjs && node --check scripts/validate-hybrid.mjs && node --check scripts/prepack-casca.mjs && node --check scripts/postpack-casca.mjs",
+    "lint": "node --check bin/auroq-os.js && node --check lib/auth.js && node --check lib/diagnostico.js && node --check lib/credentials.js && node --check lib/onepassword.js && node --check lib/supabase.js && node --check scripts/sync-codex-skills.mjs && node --check scripts/validate-hybrid.mjs && node --check scripts/prepack-casca.mjs && node --check scripts/postpack-casca.mjs",
     "typecheck": "npm run validate:hybrid",
     "test": "node --test tests/*.test.mjs",
     "prepack": "node scripts/prepack-casca.mjs",
@@ -29,6 +29,7 @@
     "bin/",
     "lib/",
     "scripts/",
+    "installer/",
     "seeds/",
     ".auroq-core/core/",
     ".auroq-core/core-config.yaml",