auroq-os 2.3.7 → 2.4.1

package/installer/install.ps1

@@ -0,0 +1,515 @@
+# Auroq OS - instalador do Windows.
+#
+#   irm https://arka.education/install.ps1 | iex
+#
+# Roda no PowerShell 5.1 (o que vem no Windows 10) sem privilegio elevado. A politica
+# 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" 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).
+#
+# 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.
+# 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 93621-4486'
+$AuroqNodeMin    = 20
+$AuroqBuildMin   = 17763   # Windows 10 1809
+$AuroqDiscoMinMb = 2048
+
+function Get-AuroqHome {
+  if ($env:AUROQ_INSTALL_HOME) { return $env:AUROQ_INSTALL_HOME }
+  if ($env:USERPROFILE) { return $env:USERPROFILE }
+  return $HOME
+}
+
+function Get-AuroqNodeDir {
+  $base = $env:LOCALAPPDATA
+  if (-not $base) { $base = Join-Path (Get-AuroqHome) 'AppData\Local' }
+  return (Join-Path $base 'Auroq\node')
+}
+
+# --- 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 }
+function Write-AuroqDiz    { param([string]$Texto) Write-Host "  $Texto" }
+function Write-AuroqOk     { param([string]$Texto) Write-Host "  + $Texto" -ForegroundColor Green }
+function Write-AuroqAviso  { param([string]$Texto) Write-Host "  ! $Texto" -ForegroundColor Yellow }
+
+# Toda falha diz tres coisas: o que aconteceu, o que fazer agora e o suporte.
+function Write-AuroqErro {
+  param([string]$Aconteceu = 'Algo deu errado.', [string]$OqueFazer = 'Rode o mesmo comando de novo.')
+  Write-Host ''
+  Write-Host "  Parou aqui: $Aconteceu" -ForegroundColor Red
+  Write-Host ''
+  Write-Host "  O que fazer agora: $OqueFazer" -ForegroundColor Cyan
+  Write-Host ''
+  Write-Host "  Se continuar travado, chame o suporte: $AuroqSuporte" -ForegroundColor DarkGray
+  Write-Host ''
+  Write-AuroqLog 'erro' $Aconteceu
+  exit 1
+}
+
+# --- Registro pro suporte (sec. 5.7) ----------------------------------------------
+# Uma linha por evento. Nunca entra senha, token ou e-mail.
+
+function Write-AuroqLog {
+  param([string]$Evento = '', [string]$Detalhe = '')
+  if ($env:AUROQ_INSTALL_DRY_RUN) { return }
+  try {
+    $dir = Join-Path (Get-AuroqHome) '.auroq'
+    if (-not (Test-Path $dir)) { New-Item -ItemType Directory -Path $dir -Force | Out-Null }
+    $quando = (Get-Date).ToUniversalTime().ToString('yyyy-MM-ddTHH:mm:ssZ')
+    Add-Content -Path (Join-Path $dir 'install.log') -Value "$quando`t$Evento`t$Detalhe" -Encoding UTF8
+  } catch {
+    # registro e conveniencia pro suporte; nunca derruba a instalacao
+  }
+}
+
+# --- 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".
+function Test-AuroqPasta {
+  param([string]$Nome = '')
+  if ([string]::IsNullOrWhiteSpace($Nome)) { return $false }
+  if ($Nome -cmatch '^[a-z0-9][a-z0-9-]*$') { return $true }
+  return $false
+}
+
+function Test-AuroqNode {
+  param([string]$Versao = '')
+  if ([string]::IsNullOrWhiteSpace($Versao)) { return $false }
+  $limpa = $Versao.TrimStart('v')
+  $maior = ($limpa -split '\.')[0]
+  $numero = 0
+  if (-not [int]::TryParse($maior, [ref]$numero)) { return $false }
+  return ($numero -ge $AuroqNodeMin)
+}
+
+function Get-AuroqNodeZip {
+  param([string]$Versao = '', [string]$Arquitetura = 'AMD64')
+  $alvo = 'x64'
+  if ($Arquitetura -eq 'ARM64') { $alvo = 'arm64' }
+  return "node-v$Versao-win-$alvo.zip"
+}
+
+# nova | vazia | auroq | ocupada - decidido ANTES de escrever qualquer coisa.
+function Get-AuroqEstadoPasta {
+  param([string]$Caminho = '')
+  if (-not (Test-Path $Caminho)) { return 'nova' }
+  if (Test-Path (Join-Path $Caminho '.auroq-core')) { return 'auroq' }
+  $itens = @(Get-ChildItem -LiteralPath $Caminho -Force -ErrorAction SilentlyContinue |
+    Where-Object { $_.Name -ne 'desktop.ini' -and $_.Name -ne 'Thumbs.db' -and $_.Name -ne '.DS_Store' })
+  if ($itens.Count -eq 0) { return 'vazia' }
+  return 'ocupada'
+}
+
+# --- 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.
+
+function Set-AuroqPath {
+  param([string]$Bin = '')
+  $atual = [Environment]::GetEnvironmentVariable('Path', 'User')
+  if (-not $atual) { $atual = '' }
+  $partes = @($atual -split ';' | Where-Object { $_ -and ($_ -ne $Bin) })
+  $novo = (@($Bin) + $partes) -join ';'
+  [Environment]::SetEnvironmentVariable('Path', $novo, 'User')
+  $env:Path = "$Bin;$env:Path"
+}
+
+# --- Passo 1: diagnostico (sec. 5.1) ----------------------------------------------
+
+function Test-AuroqMaquina {
+  Write-AuroqPasso 'Vendo o seu computador...'
+
+  if (-not [Environment]::Is64BitProcess) {
+    Write-AuroqErro 'Voce abriu a versao de 32 bits do PowerShell.' 'Feche esta janela. No menu Iniciar procure por "Windows PowerShell" (sem x86), abra e cole o comando de novo.'
+  }
+
+  $build = 0
+  if ($env:AUROQ_INSTALL_FAKE_BUILD) {
+    $build = [int]$env:AUROQ_INSTALL_FAKE_BUILD
+  } else {
+    try { $build = [System.Environment]::OSVersion.Version.Build } catch { $build = $AuroqBuildMin }
+  }
+  if ($build -lt $AuroqBuildMin) {
+    Write-AuroqErro "Seu Windows esta numa versao antiga (compilacao $build) e o sistema precisa da 1809 ou mais nova." 'Rode o Windows Update ate o fim e tente de novo, ou fale com o suporte antes de continuar.'
+  }
+
+  $chip = $env:PROCESSOR_ARCHITECTURE
+  if (-not $chip) { $chip = 'AMD64' }
+  Write-AuroqOk "Windows 64 bits, compilacao $build - serve"
+
+  $livreMb = 999999
+  if ($env:AUROQ_INSTALL_FAKE_DISCO_MB) {
+    $livreMb = [int]$env:AUROQ_INSTALL_FAKE_DISCO_MB
+  } else {
+    try {
+      $unidade = (Get-AuroqHome).Substring(0, 1)
+      $drive = Get-PSDrive -Name $unidade -ErrorAction SilentlyContinue
+      if ($drive -and $drive.Free) { $livreMb = [int]($drive.Free / 1MB) }
+    } catch {
+      $livreMb = 999999
+    }
+  }
+  if ($livreMb -lt $AuroqDiscoMinMb) {
+    Write-AuroqErro "Falta espaco no disco: sobram $livreMb MB e sao necessarios pelo menos 2 GB." 'Libere espaco (Configuracoes > Sistema > Armazenamento) e rode o mesmo comando de novo.'
+  }
+
+  if ($env:AUROQ_INSTALL_FAKE_SEM_INTERNET) {
+    Write-AuroqErro 'Nao consegui falar com a internet.' 'Conecte na internet e rode o mesmo comando de novo. Nada foi instalado pela metade.'
+  }
+  if (-not $env:AUROQ_INSTALL_DRY_RUN) {
+    try {
+      Invoke-WebRequest -Uri 'https://registry.npmjs.org/' -Method Head -TimeoutSec 15 -UseBasicParsing | Out-Null
+    } catch {
+      Write-AuroqErro 'Nao consegui falar com a internet.' 'Conecte na internet e rode o mesmo comando de novo. Nada foi instalado pela metade.'
+    }
+  }
+  Write-AuroqLog 'diagnostico' "build=$build chip=$chip disco_mb=$livreMb"
+}
+
+# --- Passo 2: Git (sec. 5.2) ------------------------------------------------------
+
+function Test-AuroqGitResponde {
+  try {
+    $null = & git --version 2>$null
+    if ($LASTEXITCODE -eq 0) { return $true }
+  } catch {
+    # segue pro caminho padrao
+  }
+  # 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
+}
+
+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 (Test-AuroqGitResponde) {
+    Write-AuroqOk 'Git ja estava instalado'
+    Write-AuroqLog 'git' 'ja-existia'
+    return
+  }
+
+  $temWinget = $false
+  try {
+    $null = & winget --version 2>$null
+    if ($LASTEXITCODE -eq 0) { $temWinget = $true }
+  } catch {
+    $temWinget = $false
+  }
+
+  if ($temWinget) {
+    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) {
+      Write-AuroqOk 'Git instalado'
+      Write-AuroqLog 'git' 'instalado-winget'
+      return
+    }
+    # 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'
+  }
+
+  # 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. 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 $teto) {
+    if (Test-AuroqGitResponde) {
+      Write-AuroqOk 'Git instalado'
+      Write-AuroqLog 'git' 'instalado-manual'
+      return
+    }
+    Start-Sleep -Seconds 10
+    $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.'
+}
+
+# --- 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 }
+
+  $atual = ''
+  try {
+    $atual = (& node --version 2>$null)
+  } catch {
+    $atual = ''
+  }
+  if (Test-AuroqNode $atual) {
+    Write-AuroqOk "O motor ja estava instalado ($atual)"
+    Write-AuroqLog 'motor' "ja-existia versao=$atual"
+    return
+  }
+  if ($atual) {
+    Write-AuroqAviso "Voce ja tinha um motor antigo ($atual); vou instalar um novo do lado, sem mexer no seu."
+  }
+  Write-AuroqDiz '  (e um programa que fica numa pasta sua, nao pede senha e nao mexe em nada do seu Windows)'
+
+  $chip = $env:PROCESSOR_ARCHITECTURE
+  if (-not $chip) { $chip = 'AMD64' }
+
+  try {
+    $indice = Invoke-RestMethod -Uri 'https://nodejs.org/dist/index.json' -TimeoutSec 30 -UseBasicParsing
+  } catch {
+    Write-AuroqErro 'Nao consegui baixar o motor do sistema.' 'Confira a internet (ou o antivirus, se houver) e rode o mesmo comando de novo.'
+  }
+  $escolhido = $indice | Where-Object { $_.version -like 'v24.*' } | Select-Object -First 1
+  if (-not $escolhido) { $escolhido = $indice | Where-Object { $_.lts } | Select-Object -First 1 }
+  if (-not $escolhido) {
+    Write-AuroqErro 'Nao consegui descobrir qual motor baixar.' 'Rode o mesmo comando de novo em alguns minutos. Se insistir, chame o suporte.'
+  }
+  $versao = $escolhido.version.TrimStart('v')
+  $zip = Get-AuroqNodeZip $versao $chip
+  $destino = Join-Path $env:TEMP $zip
+
+  try {
+    Invoke-WebRequest -Uri "https://nodejs.org/dist/v$versao/$zip" -OutFile $destino -TimeoutSec 600 -UseBasicParsing
+  } catch {
+    Write-AuroqErro '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.
+  try {
+    $somas = (Invoke-WebRequest -Uri "https://nodejs.org/dist/v$versao/SHASUMS256.txt" -TimeoutSec 60 -UseBasicParsing).Content
+    $linha = ($somas -split "`n" | Where-Object { $_ -match [regex]::Escape($zip) } | Select-Object -First 1)
+    $esperado = ($linha -split '\s+')[0]
+    $obtido = (Get-FileHash -Path $destino -Algorithm SHA256).Hash
+  } catch {
+    $esperado = ''
+    $obtido = 'x'
+  }
+  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.'
+  }
+
+  # mark-of-the-web: sem desbloquear, o Windows recusa abrir o que veio da internet
+  Unblock-File -Path $destino -ErrorAction SilentlyContinue
+
+  $nodeDir = Get-AuroqNodeDir
+  $pai = Split-Path $nodeDir
+  try {
+    if (-not (Test-Path $pai)) { New-Item -ItemType Directory -Path $pai -Force | Out-Null }
+    if (Test-Path $nodeDir) { Remove-Item $nodeDir -Recurse -Force -ErrorAction SilentlyContinue }
+    Expand-Archive -Path $destino -DestinationPath $pai -Force
+    $extraido = Join-Path $pai "node-v$versao-win-$(if ($chip -eq 'ARM64') { 'arm64' } else { 'x64' })"
+    Rename-Item -Path $extraido -NewName 'node' -Force
+  } catch {
+    Write-AuroqErro 'Nao consegui guardar o motor na sua pasta.' 'Rode o mesmo comando de novo. Se repetir, mande pro suporte o arquivo install.log da pasta .auroq.'
+  }
+  Remove-Item $destino -Force -ErrorAction SilentlyContinue
+
+  Set-AuroqPath $nodeDir
+  # instalar ferramenta depois nao pode pedir elevacao
+  $env:npm_config_prefix = $nodeDir
+
+  Write-AuroqOk "Motor instalado ($versao)"
+  Write-AuroqLog 'motor' "instalado versao=$versao chip=$chip"
+}
+
+# --- 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 }
+
+  # `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
+  # 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.
+  & npx -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 "  O que fazer agora: fale com o suporte $AuroqSuporte" -ForegroundColor DarkGray
+    Write-Host ''
+    exit 1
+  }
+  Write-AuroqLog 'login' 'ok'
+}
+
+# --- 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)'
+
+  $nome = $env:AUROQ_INSTALL_PASTA
+  $tentativas = 0
+
+  while ($true) {
+    if (-not $nome) { $nome = Read-Host '  Nome' }
+
+    if (Test-AuroqPasta $nome) {
+      $alvo = Join-Path (Get-AuroqHome) $nome
+      $estado = Get-AuroqEstadoPasta $alvo
+      if ($estado -eq 'auroq') {
+        Write-Host ''
+        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'
+        exit 0
+      }
+      if ($estado -eq 'ocupada') {
+        Write-AuroqAviso "A pasta $nome ja existe e tem coisa sua dentro. Escolha outro nome."
+        $nome = ''
+      } else {
+        $script:AuroqPastaAlvo = $alvo
+        break
+      }
+    } elseif ([string]::IsNullOrWhiteSpace($nome)) {
+      # 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.'
+      Write-AuroqDiz 'Exemplo bom: minha-empresa'
+      $nome = ''
+    }
+
+    $tentativas = $tentativas + 1
+    if ($tentativas -ge 5) {
+      Write-AuroqErro 'Nao consegui um nome valido pra pasta.' 'Rode o mesmo comando de novo e escreva algo como: minha-empresa'
+    }
+  }
+
+  if ($env:AUROQ_INSTALL_DRY_RUN) { Write-AuroqOk "Pasta $script:AuroqPastaAlvo - seria criada aqui"; return }
+
+  try {
+    if (-not (Test-Path $script:AuroqPastaAlvo)) {
+      New-Item -ItemType Directory -Path $script:AuroqPastaAlvo -Force | Out-Null
+    }
+  } catch {
+    Write-AuroqErro "Nao consegui criar a pasta $script:AuroqPastaAlvo." 'Confira se voce tem permissao de escrita na sua pasta pessoal e rode de novo.'
+  }
+  Write-AuroqLog 'pasta' 'criada'
+}
+
+# --- 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 }
+
+  Set-Location $script:AuroqPastaAlvo
+  & npx -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.'
+  }
+  Write-AuroqLog 'init' 'ok'
+}
+
+# --- Passo 7: fecho -----------------------------------------------------------
+
+function Write-AuroqFecho {
+  $nome = Split-Path $script:AuroqPastaAlvo -Leaf
+  Write-Host ''
+  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-Host ''
+  Write-AuroqDiz 'O Ops instala o resto e te guia daqui pra frente.'
+  Write-Host ''
+  Write-AuroqLog 'fim' "ok pasta=$nome"
+}
+
+# --- Fluxo --------------------------------------------------------------------
+
+function Invoke-AuroqInstalacao {
+  Write-AuroqTitulo 'Auroq OS - instalacao'
+  Test-AuroqMaquina
+  Install-AuroqGit
+  Install-AuroqNode
+  Invoke-AuroqLogin
+  Get-AuroqPasta
+  Invoke-AuroqInit
+  Write-AuroqFecho
+}
+
+# Carregado pelos testes: so define as funcoes e sai.
+if (-not $env:AUROQ_INSTALL_LIB) {
+  $script:AuroqPastaAlvo = ''
+  Invoke-AuroqInstalacao
+}