auroq-os 2.3.7 → 2.4.0

package/README.md

@@ -14,6 +14,24 @@ Transforma Claude Code, Codex CLI ou Grok Build num centro de comando inteligent
 
 ### Setup
 
+Cole **um endereco** no terminal (o de dentro do Claude Code ou do Codex serve).
+Ele instala o Git, o motor do sistema, faz o login da mentoria, cria a pasta do seu
+negocio e monta tudo — sem senha e sem voce baixar nada na mao:
+
+```bash
+# Mac
+curl -fsSL https://arka.education/install.sh | bash
+
+# Windows (PowerShell, sem Administrador)
+irm https://arka.education/install.ps1 | iex
+```
+
+Depois, **feche e abra** o Claude Code ou o Codex — senao ele nao enxerga o que
+acabou de ser instalado.
+
+<details>
+<summary>Caminho manual (se o instalador nao servir na sua maquina)</summary>
+
 ```bash
 # 1. Crie uma pasta pro seu negocio
 mkdir meu-negocio && cd meu-negocio
@@ -40,6 +58,9 @@ grok
 /auroq-companion
 ```
 
+</details>
+
+
 > **Grok:** nao precisa de `sync:codex`. Ele descobre `.claude/commands/`,
 > `.claude/rules/` e `AGENTS.md` sozinho. Use Claude/Grok com slash commands;
 > use Codex com `$nome` apos o sync de skills.
@@ -58,6 +79,7 @@ grok
 | `auroq-os login` | Forca novo login (substitui credencial atual) |
 | `auroq-os logout` | Encerra sessao local (remove `~/.arcane/credentials.json`) |
 | `auroq-os whoami` | Mostra usuario autenticado e status de acesso |
+| `auroq-os doctor` | Diagnostico do suporte: arquivos, motor do sistema (e se o programa aberto pelo icone enxerga ele), registro do conteudo ao vivo, login e servidor |
 | `auroq-os sync-codex` | Regenera e verifica as skills locais do Codex |
 | `auroq-os conectar-1password` | Conecta o 1Password CLI — le o token de Service Account direto do Ctrl+C (nunca digitado nem exposto), instala o `op` se faltar, valida online e salva permanente (Mac/Windows) |
 

package/bin/auroq-os.js

@@ -16,6 +16,7 @@ const path = require('path');
 const fs = require('fs-extra');
 const { execSync, execFileSync } = require('child_process');
 const auth = require('../lib/auth');
+const diagnostico = require('../lib/diagnostico');
 
 const PKG_VERSION = require('../package.json').version;
 
@@ -162,6 +163,65 @@ const HEALTH_CHECKS = [
   ['scripts/validate-hybrid.mjs', 'Validador hibrido'],
 ];
 
+/**
+ * Registro pro suporte (PRD "Embarque em 2 passos" §5.7).
+ *
+ * Uma linha por evento em ~/.auroq/install.log. Nunca entra e-mail, senha nem
+ * token: o suporte precisa saber o que aconteceu na maquina, nao quem e a pessoa.
+ * Falhar aqui nunca pode derrubar a instalacao — e conveniencia, nao requisito.
+ */
+function registrarInstallLog(evento, detalhe = '') {
+  try {
+    const dir = path.join(require('os').homedir(), '.auroq');
+    fs.ensureDirSync(dir);
+    const quando = new Date().toISOString().replace(/\.\d+Z$/, 'Z');
+    const limpo = String(detalhe).replace(/[^\w .:=+/\\-]/g, '');
+    fs.appendFileSync(path.join(dir, 'install.log'), `${quando}\t${evento}\t${limpo}\n`);
+  } catch {
+    /* registro e conveniencia pro suporte */
+  }
+}
+
+/**
+ * Identificador curto e nao reversivel da maquina — so pro suporte casar dois
+ * registros do mesmo computador. Nao sai da maquina e nao contem nome nem e-mail.
+ */
+function idDaMaquina() {
+  try {
+    const os = require('os');
+    const cru = `${os.hostname()}|${os.userInfo().username}|${os.platform()}|${os.arch()}`;
+    return require('crypto').createHash('sha256').update(cru).digest('hex').slice(0, 12);
+  } catch {
+    return 'desconhecida';
+  }
+}
+
+/**
+ * `--pasta <nome>`: o instalador pede pro CLI criar e entrar na pasta, em vez de
+ * depender de um `cd` ter funcionado la fora. Mesma regra de nome do instalador —
+ * so minusculas, numeros e hifen, sem escapar da pasta de cima.
+ */
+function resolverPastaAlvo(nome, baseDir) {
+  if (!/^[a-z0-9][a-z0-9-]*$/.test(String(nome || ''))) {
+    error('');
+    error(`${GOLD}Esse nome de pasta nao serve: "${nome}"${RESET}`);
+    error('Use so letras minusculas, numeros e hifen. Exemplo: minha-empresa');
+    error('');
+    process.exit(1);
+  }
+  const alvo = path.join(baseDir, nome);
+  try {
+    fs.ensureDirSync(alvo);
+  } catch (e) {
+    error('');
+    error(`${GOLD}Nao consegui criar a pasta ${alvo}.${RESET}`);
+    error(`O que fazer agora: confira se voce tem permissao de escrita ai e rode de novo. (${e.message})`);
+    error('');
+    process.exit(1);
+  }
+  return alvo;
+}
+
 async function runHealthChecks(targetDir) {
   let passed = 0;
   const missing = [];
@@ -207,13 +267,39 @@ async function runDoctor(targetDir) {
     problemas.push('Rode *update-auroq dentro do Claude Code pra repor o que falta.');
   }
 
-  // 2. Node visivel pra quem abre pelo icone (NFR-06 — o caso real de falha)
+  // 2. O motor — e, principalmente, se quem abre pelo icone vai enxergar ele.
+  //    Esta e a falha silenciosa do §5.4: no terminal funciona, no app nao, e
+  //    ninguem ve erro nenhum — so um Companion que "nao sabe de nada".
+  const homeDir = require('os').homedir();
+  let caminhoMotor = '';
+  try {
+    caminhoMotor = execSync('command -v node', {
+      encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], shell: '/bin/bash',
+    }).trim();
+  } catch {
+    caminhoMotor = process.execPath || '';
+  }
+
+  let versaoMotor = '';
   try {
-    const v = execSync('npx --version', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
-    success(`Node/npx no caminho: npx ${v}`);
+    versaoMotor = execSync('node --version', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
   } catch {
-    error('Node/npx nao encontrado no caminho deste programa');
-    problemas.push('O app do Claude aberto pelo icone nao enxerga o Node. Abra o Ops e peca o *bootstrap, ou abra o Claude pelo Terminal.');
+    versaoMotor = '';
+  }
+
+  if (versaoMotor) {
+    success(diagnostico.resumoDoMotor({ versao: versaoMotor, caminho: caminhoMotor }));
+  } else {
+    error('Nao encontrei o motor do sistema nesta janela');
+    problemas.push('Rode o instalador de novo: arka.education/install.sh (no Windows, install.ps1).');
+  }
+
+  const visao = diagnostico.appEnxergaMotor({ homeDir, pathAtual: process.env.PATH || '', caminhoMotor });
+  if (visao.visivel && !visao.motivo) {
+    success('O programa aberto pelo icone tambem enxerga o motor');
+  } else {
+    error(visao.motivo || 'O programa aberto pelo icone pode nao enxergar o motor');
+    problemas.push('Rode o instalador de novo (arka.education/install.sh) e, depois, FECHE e abra o Claude Code ou o Codex.');
   }
 
   // 3. registro do MCP nos dois runtimes
@@ -316,11 +402,12 @@ async function patchEnableAllProjectMcpServers(targetDir) {
 }
 
 // ─── INSTALACAO ──────────────────────────────────────────
-async function init() {
+async function init({ pasta = null } = {}) {
   showBanner();
   await sleep(500);
 
-  const targetDir = process.cwd();
+  const targetDir = pasta ? resolverPastaAlvo(pasta, process.cwd()) : process.cwd();
+  if (pasta) process.chdir(targetDir);
   const sourceDir = path.resolve(__dirname, '..');
   const homeDir = require('os').homedir();
 
@@ -758,6 +845,8 @@ async function init() {
   step('Verificando integridade...');
   await runHealthChecks(targetDir);
 
+  registrarInstallLog('init', `ok versao=${PKG_VERSION} maquina=${idDaMaquina()}`);
+
   // ─── Resultado final
   console.log(`
 ${PURPLE}${BOLD}  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}
@@ -964,7 +1053,11 @@ ${DIM}  Auroq OS v${PKG_VERSION} — Sistema Operacional de IA para Experts${RES
 const command = process.argv[2];
 
 if (command === 'init' || command === 'install') {
-  init().catch(err => {
+  // `--pasta <nome>`: o instalador manda o CLI criar e entrar na pasta do negocio,
+  // em vez de depender de um `cd` ter dado certo la fora (PRD Embarque §6).
+  const iPasta = process.argv.indexOf('--pasta');
+  const pasta = iPasta !== -1 ? process.argv[iPasta + 1] : null;
+  init({ pasta }).catch(err => {
     error(`Falha na instalacao: ${err.message}`);
     process.exit(1);
   });
@@ -992,8 +1085,10 @@ if (command === 'init' || command === 'install') {
     process.exit(1);
   });
 } else if (command === 'whoami') {
+  // Codigo de saida honesto: 0 so com sessao salva e ultimo status 'ativo'.
+  // Quem precisa do portao de verdade (online) usa `check-access`.
   try {
-    auth.whoami();
+    process.exit(auth.whoami() ? 0 : 1);
   } catch (err) {
     error(`Falha: ${err.message}`);
     process.exit(1);

package/installer/README.md

@@ -0,0 +1,102 @@
+# Instalador do Auroq OS
+
+Os dois scripts desta pasta são a **porta de entrada do aluno**. Depois de baixar
+o Claude Code ou o Codex, ele cola **um endereço** e o resto acontece sozinho:
+
+```
+Mac:      curl -fsSL https://arka.education/install.sh | bash
+Windows:  irm https://arka.education/install.ps1 | iex
+```
+
+Contrato completo: `arka1/docs/prd/prd-embarque-2-passos.md`.
+
+## O que eles fazem, nesta ordem
+
+1. **Diagnóstico** — sistema, versão mínima, espaço em disco, internet
+2. **Git** — Mac: abre a janela das ferramentas da Apple e espera; Windows: winget, com o instalador oficial como reserva
+3. **Motor** — reaproveita o que já existe se servir; senão baixa o oficial pra uma pasta do próprio usuário, confere a soma SHA256 e publica no ambiente dele
+4. **Login da mentoria** — mesma checagem do resto do sistema; só contrato `ativo` instala
+5. **Pasta do negócio** — pergunta o nome, valida e cria
+6. **Montagem** — chama o `init`, que é quem registra o conteúdo ao vivo (ADR-7)
+7. **Fecho** — diz pra fechar e abrir o programa, e como chamar o Ops
+
+## Regras que não se negociam
+
+- **Sem `sudo`, sem Administrador.** No Mac a única janela é a da Apple; no Windows, a de permissão do winget.
+- **Bash 3.2 e PowerShell 5.1.** É o que vem de fábrica nas máquinas dos alunos. Nada de `declare -A`, `${var,,}`, `mapfile` ou `&&`.
+- **Toda falha diz três coisas:** o que aconteceu, o que fazer agora e o contato do suporte. Um instalador que trava calado é pior que o passo a passo manual.
+- **O aluno não lê jargão.** Nada de `npm`, `npx`, `PATH`, "binário", "runtime" na tela. O motor é "o motor do sistema".
+- **O instalador não escreve o registro do conteúdo ao vivo.** Quem faz isso é o `init` — um dono só pra esse arquivo.
+- **Nada é apagado.** Node, Homebrew e nvm que o aluno já tinha ficam onde estão.
+
+## A falha que mais importa
+
+O programa aberto pelo ícone (Dock no Mac, Menu Iniciar no Windows) monta o
+ambiente lendo o **perfil do usuário**, não a janela onde a instalação rodou. Se o
+motor ficar só na sessão, tudo funciona no terminal, nada funciona no app — e
+**não aparece erro nenhum**. O aluno só vê um Companion que não sabe de nada.
+
+Por isso o instalador escreve nos dois arquivos de perfil (`~/.zshrc` e
+`~/.zprofile`) e o `auroq-os doctor` compara o que o perfil declara com o que está
+valendo agora. Se você mexer nessa parte, rode `tests/diagnostico.test.mjs`.
+
+## Testar sem instalar nada
+
+Os dois scripts têm modo ensaio e modo biblioteca.
+
+```bash
+# ensaio: mostra o plano inteiro e não toca na máquina
+AUROQ_INSTALL_DRY_RUN=1 AUROQ_INSTALL_PASTA=minha-empresa bash installer/install.sh
+
+# simular máquina velha, disco cheio, sem internet
+AUROQ_INSTALL_DRY_RUN=1 AUROQ_INSTALL_FAKE_MACOS=12.6      bash installer/install.sh
+AUROQ_INSTALL_DRY_RUN=1 AUROQ_INSTALL_FAKE_DISCO_MB=300    bash installer/install.sh
+AUROQ_INSTALL_DRY_RUN=1 AUROQ_INSTALL_FAKE_SEM_INTERNET=1  bash installer/install.sh
+
+# biblioteca: carrega só as funções, pra testar decisão por decisão
+AUROQ_INSTALL_LIB=1 . installer/install.sh && auroq_validar_pasta "minha-empresa"
+```
+
+No PowerShell é a mesma ideia:
+
+```powershell
+$env:AUROQ_INSTALL_LIB='1'; . ./installer/install.ps1; Test-AuroqPasta 'minha-empresa'
+$env:AUROQ_INSTALL_DRY_RUN='1'; ./installer/install.ps1
+```
+
+| Variável | Pra que serve |
+|---|---|
+| `AUROQ_INSTALL_LIB` | carrega só as funções (testes) |
+| `AUROQ_INSTALL_DRY_RUN` | mostra o plano, não escreve nada |
+| `AUROQ_INSTALL_PASTA` | responde a pergunta do nome da pasta |
+| `AUROQ_INSTALL_HOME` | troca a pasta pessoal (só testes) |
+| `AUROQ_INSTALL_FAKE_MACOS` · `FAKE_BUILD` | finge a versão do sistema |
+| `AUROQ_INSTALL_FAKE_DISCO_MB` | finge o espaço livre |
+| `AUROQ_INSTALL_FAKE_SEM_INTERNET` | finge queda de rede |
+
+Suíte: `npm test` (`tests/installer-sh.test.mjs`, `tests/installer-ps1.test.mjs`,
+`tests/diagnostico.test.mjs`, `tests/cli-embarque.test.mjs`).
+
+Os testes do PowerShell rodam de verdade quando existe um `pwsh` na máquina —
+inclusive um portátil, apontado por `AUROQ_PWSH=/caminho/pwsh`. Sem ele, sobra a
+checagem estrutural, que já pega as pegadinhas clássicas do 5.1.
+
+## Publicar
+
+A fonte da verdade é **esta pasta**. A plataforma serve uma cópia; quem copia é o
+script, nunca a mão:
+
+```bash
+cd ../plataforma-arcane && npm run sync:installer          # copia
+cd ../plataforma-arcane && npm run sync:installer:check    # confere se está igual
+```
+
+O `sync:installer:check` roda no `pretest` da plataforma: se alguém editar a cópia
+em vez do original, o teste quebra e diz qual é o certo.
+
+## `--pasta`, no CLI
+
+`npx auroq-os init --pasta minha-empresa` cria a pasta e instala dentro dela.
+Existe pra quem não pode depender de um `cd` ter funcionado. O instalador do Mac
+entra na pasta antes de chamar o `init`, então não precisa da opção — mas ela é a
+rede de segurança de qualquer outro chamador.