auroq-os 2.5.10 → 2.5.11

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

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

package/CHANGELOG.md

@@ -1,3 +1,12 @@
+## 2.5.11 — 2026-09-21
+
+### O diagnostico passa a dizer o que achou (EMB-050)
+
+- Sair com 1 no `doctor` nao e mais `INSTALL_FAILED`: agora e `DOCTOR_FINDINGS`. Pendencia encontrada e o diagnostico trabalhando, nao instalacao quebrada — na janela de 20/09 isso gerou 3 alarmes de gravidade maxima para zero instalacoes quebradas.
+- O `doctor` grava o resultado em `~/.auroq/install.log`: `pendencias=N etiqueta,etiqueta` quando acha algo e `ok` quando fecha limpo. As etiquetas sao vocabulario fechado (`arquivos-faltando`, `motor-fora-do-perfil`, `sem-login`, ...) e nunca levam caminho, e-mail, token nem nome de maquina. O suporte pede uma linha: `cat ~/.auroq/install.log`.
+- Registro MCP passa a `arcane-mcp@0.6.1` (publicado no npm em 21/09/2026), que conhece o codigo novo: os dois clientes compartilham a mesma fila local e qualquer um dos dois a envia, entao a lista de codigos tem que ser a mesma nos dois e no servidor. Feche e abra o Claude Code e o Codex depois da manutencao.
+- Instaladores oficiais continuam fixando 2.5.10; promover a versao que instalacoes NOVAS recebem segue sendo ato explicito.
+
 ## 2.5.10 — 2026-09-19
 
 ### Conteudo ao vivo passa a usar o cliente 0.6.0

package/README.md

@@ -230,12 +230,12 @@ agents/             → Seu exercito (companion, workers, minds, squads)
 
 ## Observabilidade do motor (candidato 2.5.2)
 
-Apos publicacao, `npx -y auroq-os@2.5.10 doctor` mostra a fila local segura e os comandos pinados de
-manutencao/diagnostico. `npx -y auroq-os@2.5.10 manutencao` preserva o caminho existente
+Apos publicacao, `npx -y auroq-os@2.5.11 doctor` mostra a fila local segura e os comandos pinados de
+manutencao/diagnostico. `npx -y auroq-os@2.5.11 manutencao` preserva o caminho existente
 de consentimento legado, studentFiles, customizacoes e dados do negocio. Nao ha
-migracao forcada. O registro MCP aponta para `arcane-mcp@0.6.0`, publicado no npm em
-19/09/2026; `npm run release:verify` recusa publicar com um pin que o npm nao resolva.
-Os instaladores oficiais devem fixar 2.5.10 depois da publicacao e da verificacao do tarball.
+migracao forcada. O registro MCP aponta para `arcane-mcp@0.6.1`, publicado no npm em
+21/09/2026; `npm run release:verify` recusa publicar com um pin que o npm nao resolva.
+Os instaladores oficiais seguem em 2.5.10; promover pra 2.5.11 e ato explicito, depois da publicacao e da verificacao do tarball.
 
 O CLI inicia captura antes das dependencias pesadas e registra resultado ao sair.
 Eventos com identidade ja existente podem seguir pela rota autenticada na proxima

package/bin/auroq-os.js

@@ -20,7 +20,10 @@ async function observedMain() {
  const record = (outcome, error_code) => telemetry.enqueue(owner,{endpoint:'lifecycle',stage,outcome,error_code});
  telemetry.setHost('auroq-os');telemetry.importInstallerSpool();record('started');
  let importing = true;
- process.once('exit',code=>record(code===0?'ok':'error',code===0?null:importing?'BOOTSTRAP_IMPORT':stage==='update'?'UPDATE_FAILED':'INSTALL_FAILED'));
+ // Sair com 1 no `doctor` e o diagnostico fazendo o trabalho dele, nao a instalacao quebrando:
+ // `DOCTOR_FINDINGS` = achou pendencia pra resolver. Chamar isso de INSTALL_FAILED gerava alarme
+ // de gravidade maxima pra aluno com o caminho inteiro de pe (Marinei e Alessandra, 20/09).
+ process.once('exit',code=>record(code===0?'ok':'error',code===0?null:importing?'BOOTSTRAP_IMPORT':stage==='update'?'UPDATE_FAILED':stage==='doctor'?'DOCTOR_FINDINGS':'INSTALL_FAILED'));
  process.once('uncaughtException',()=>{console.error('[auroq-os] RUNTIME_FAILURE');process.exit(1);});
  process.once('unhandledRejection',()=>{console.error('[auroq-os] RUNTIME_FAILURE');process.exit(1);});
  const cred = credentials.load();await telemetry.flush(cred?.user?.id,cred?.access_token);
@@ -28,7 +31,7 @@ async function observedMain() {
 telemetry.runtimeReady=()=>{importing=false;};
 runRuntime(telemetry);
  } catch {
-  console.error('[auroq-os] '+(importing?'BOOTSTRAP_IMPORT':'RUNTIME_FAILURE')+'. Rode: npx -y auroq-os@2.5.10 doctor');
+  console.error('[auroq-os] '+(importing?'BOOTSTRAP_IMPORT':'RUNTIME_FAILURE')+'. Rode: npx -y auroq-os@2.5.11 doctor');
   process.exitCode=1;
  }
 }
@@ -214,13 +217,45 @@ function registrarInstallLog(evento, detalhe = '') {
     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, '');
+    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 */
   }
 }
 
+/**
+ * Etiqueta curta e FIXA pra cada pendencia que o `doctor` lista (EMB-050).
+ *
+ * O suporte precisa saber "falhou no que", nao so "falhou": a lista do doctor morria na tela do
+ * aluno e o plantao ficava adivinhando (da Alessandra nunca soubemos qual item era). A etiqueta e
+ * vocabulario fechado de proposito — nunca caminho, e-mail, token, nome de maquina nem o texto da
+ * pendencia. O casamento e por trecho estavel da mensagem; o teste `doctor-recibo` reprova qualquer
+ * pendencia nova que caia em `outro`.
+ */
+const ETIQUETAS_DOCTOR = [
+  ['repor o que falta', 'arquivos-faltando'],
+  ['sem tirar nada seu', 'synapse-nao-registrado'],
+  ['Synapse antigo', 'synapse-antigo'],
+  ['no Windows, install.ps1', 'motor-ausente'],
+  ['FECHE e abra', 'motor-fora-do-perfil'],
+  ['2 minutos de espera', 'mcp-timeout-curto'],
+  ['com o tempo certo', 'codex-timeout-curto'],
+  ['mais tempo ao Codex', 'arranque-lento'],
+  ['reescreve o registro)', 'mcp-nao-registrado'],
+  ['register-mcp na pasta. Depois', 'mcp-pin-antigo'],
+  ['arcane-mcp login', 'sem-login'],
+  ['fora do ar', 'servidor-fora'],
+  ['Confira sua internet', 'servidor-fora'],
+  ['whoami', 'mcp-nao-abre'],
+  ['tela INTEIRA', 'codex-sem-conteudo'],
+];
+function rotulo(pendencia) {
+  const texto = String(pendencia || '');
+  for (const [marca, etiqueta] of ETIQUETAS_DOCTOR) if (texto.includes(marca)) return etiqueta;
+  return 'outro';
+}
+
 /**
  * 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.
@@ -503,12 +538,22 @@ async function runDoctor(targetDir) {
   }
 
   log('');
+  // Recibo duravel pro suporte, inclusive quando fechou limpo: sem o historico completo o plantao
+  // nao sabe se a pendencia de ontem foi resolvida. Conveniencia — nunca pode derrubar o doctor,
+  // por isso montar o texto tambem fica DENTRO do try.
+  const recibo = pendencias => {
+    try {
+      registrarInstallLog('doctor', pendencias.length ? `pendencias=${pendencias.length} ${pendencias.map(p => rotulo(p)).join(',')}` : 'ok');
+    } catch { /* recibo e conveniencia pro suporte */ }
+  };
   if (problemas.length === 0) {
     success('Tudo certo. Pode chamar o Companion.');
+    recibo(problemas);
     return 0;
   }
   error(`${problemas.length} coisa(s) pra resolver:`);
   for (const p of problemas) log(`  ${DIM}- ${p}${RESET}`);
+  recibo(problemas);
   log('');
   log(`${DIM}Se travar, chame o suporte: 11 93621-4486${RESET}`);
   return 1;
@@ -524,7 +569,7 @@ async function runDoctor(targetDir) {
 // 2.5.4/2.5.5 pinaram uma versao que ainda nao estava no npm e o MCP fechava a conexao.
 // Por isso `scripts/assert-mcp-pin.mjs` (release:verify/prepublishOnly) recusa publicar
 // com um pin que o `npm view` nao resolva exatamente. Trocar o pin aqui exige o pacote ja publicado.
-const ARCANE_MCP_PIN = 'arcane-mcp@0.6.0';
+const ARCANE_MCP_PIN = 'arcane-mcp@0.6.1';
 const CODEX_MCP_STARTUP_SEC = 120;
 // O Claude Code tambem desistia aos 30s (MCP_TIMEOUT) e o aluno via CONNECT_TIMEOUT com o
 // servidor no ar e nenhum pedido chegando nele (11/09, EMB-041). Ele le o tempo do `env` das
@@ -577,7 +622,7 @@ function blocoCodexArcane(pin, opcoes) {
 }
 
 // Baixa o pacote do conteudo ao vivo com o MESMO nome que o registro usa (o cache do
-// npx e por nome+versao: `arcane-mcp` e `arcane-mcp@0.6.0` sao caches diferentes).
+// npx e por nome+versao: `arcane-mcp` e `arcane-mcp@0.6.1` sao caches diferentes).
 // `npx` no Windows e um .cmd: sem shell o Node recusa (EINVAL) e com `shell: true` o Node 24
 // imprime um DeprecationWarning na tela do aluno (DEP0190). Chamar o cmd.exe direto, sem shell.
 function comandoNpx(args) {
@@ -1803,7 +1848,7 @@ if (['init', 'install', 'update'].includes(command)) {
   error('Comando aposentado. Nada foi instalado ou alterado.');
   error('Primeira instalacao: https://arcane.arka.education/auroq');
   error('No negocio existente, peca ao Ops: manutencao do motor. Conteudo chega pelo MCP.');
-  error('Diagnostico: npx -y auroq-os@2.5.10 doctor. Manutencao: npx -y auroq-os@2.5.10 manutencao.');
+  error('Diagnostico: npx -y auroq-os@2.5.11 doctor. Manutencao: npx -y auroq-os@2.5.11 manutencao.');
   process.exitCode = 1;
 } else if (command === 'instalar' || command === 'manutencao') {
   // `--pasta <nome>`: o instalador manda o CLI criar e entrar na pasta do negocio,
@@ -1930,6 +1975,6 @@ if (['init', 'install', 'update'].includes(command)) {
   log('');
 }
 
-if (process.env.AUROQ_EXPORTA_INTERNOS === '1') module.exports = { blocoCodexArcane, envCodexArcane, lerBlocoArcane, lerEnvDoBloco, limparArcaneDoGlobal, envComoCodex, argumentosCodexSmoke, avaliarEventosCodex, ARCANE_MCP_PIN };
+if (process.env.AUROQ_EXPORTA_INTERNOS === '1') module.exports = { blocoCodexArcane, envCodexArcane, lerBlocoArcane, lerEnvDoBloco, limparArcaneDoGlobal, envComoCodex, argumentosCodexSmoke, avaliarEventosCodex, rotulo, ARCANE_MCP_PIN };
 
 }

package/lib/telemetry.mjs

@@ -20,7 +20,10 @@ export function networkCode(e) {
 }
 const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 const uuid = v => typeof v === 'string' && UUID.test(v) ? v : null;
-const ERRORS = new Set(['NETWORK_TLS','NETWORK_DNS','NETWORK_TIMEOUT','NETWORK_OTHER','AUTH_MISSING','AUTH_REFRESH','HTTP_ERROR','CLIENT_ERROR','BOOTSTRAP_IMPORT','RUNTIME_FAILURE','INSTALL_FAILED','UPDATE_FAILED']);
+// DOCTOR_FINDINGS: o doctor achou pendencia e saiu com 1 — diagnostico trabalhando, nao instalacao
+// quebrada. Os dois clientes gravam no MESMO outbox e qualquer um faz o flush, entao a lista tem que
+// ser a mesma nos dois (e no servidor): o que falta aqui vira null e apaga o alarme (EMB-050).
+const ERRORS = new Set(['NETWORK_TLS','NETWORK_DNS','NETWORK_TIMEOUT','NETWORK_OTHER','AUTH_MISSING','AUTH_REFRESH','HTTP_ERROR','CLIENT_ERROR','BOOTSTRAP_IMPORT','RUNTIME_FAILURE','INSTALL_FAILED','UPDATE_FAILED','DOCTOR_FINDINGS']);
 const STAGES = new Set(['startup','runtime','install','update','doctor','login','bootstrap','git','node','access','folder','framework']);
 const tools = new Set(['catalogo_listar','squad_ativar','squad_passo','squad_conhecimento','forja_bundle','busca']);
 const TTL = 7*86400000;

package/package.json

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