auroq-os 2.3.1 → 2.3.3

package/bin/auroq-os.js

@@ -183,6 +183,101 @@ async function runHealthChecks(targetDir) {
   return { passed, total: HEALTH_CHECKS.length };
 }
 
+/**
+ * `doctor` — o diagnostico que o suporte pede primeiro. Existe por causa do NFR-06:
+ * a falha do MCP e silenciosa (conteudo simplesmente nao aparece), entao alguem
+ * precisa perguntar em voz alta se o caminho inteiro esta de pe.
+ */
+async function runDoctor(targetDir) {
+  showBanner();
+  log(`${BOLD}Diagnostico do Auroq${RESET}`);
+  log('');
+
+  const problemas = [];
+
+  // 1. arquivos de autoload
+  let faltando = 0;
+  for (const [file] of HEALTH_CHECKS) {
+    if (!(await fs.pathExists(path.join(targetDir, file)))) faltando++;
+  }
+  if (faltando === 0) {
+    success(`Arquivos do sistema: ${HEALTH_CHECKS.length}/${HEALTH_CHECKS.length} no lugar`);
+  } else {
+    error(`Arquivos do sistema: faltam ${faltando}`);
+    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)
+  try {
+    const v = execSync('npx --version', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+    success(`Node/npx no caminho: npx ${v}`);
+  } 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.');
+  }
+
+  // 3. registro do MCP nos dois runtimes
+  const mcpPath = path.join(targetDir, '.mcp.json');
+  let pin = null;
+  if (await fs.pathExists(mcpPath)) {
+    try {
+      const json = await fs.readJSON(mcpPath);
+      pin = json?.mcpServers?.arcane?.args?.find(a => String(a).startsWith('arcane-mcp@')) || null;
+    } catch { /* arquivo corrompido cai no erro abaixo */ }
+  }
+  if (pin) {
+    success(`MCP arcane registrado no Claude Code (${pin})`);
+  } else {
+    error('MCP arcane nao registrado em .mcp.json');
+    problemas.push('Rode *update-auroq — ele reescreve o registro do MCP.');
+  }
+  const tomlPath = path.join(targetDir, '.codex', 'config.toml');
+  const temToml = (await fs.pathExists(tomlPath)) &&
+    (await fs.readFile(tomlPath, 'utf8')).includes('[mcp_servers.arcane]');
+  if (temToml) success('MCP arcane registrado no Codex');
+  else log(`  ${DIM}MCP arcane ainda nao registrado no Codex (so importa se voce usa o Codex)${RESET}`);
+
+  // 4. login e licenca — o unico jeito de saber se o conteudo vai chegar
+  const credPath = path.join(require('os').homedir(), '.arcane', 'credentials.json');
+  let cred = null;
+  try {
+    if (await fs.pathExists(credPath)) cred = await fs.readJSON(credPath);
+  } catch { /* arquivo ilegivel = tratado como sem login */ }
+  if (cred?.user?.email) {
+    success(`Logado como ${cred.user.email}`);
+  } else {
+    error('Voce nao esta logado');
+    problemas.push('Rode: npx arcane-mcp login (mesmo email e senha da plataforma).');
+  }
+
+  // 5. o servidor do conteudo responde?
+  try {
+    const r = await fetch('https://arcane.arka.education/api/mcp/verify', { method: 'POST' });
+    if (r.status === 401) {
+      success('Servidor do conteudo respondendo (pediu login, como esperado)');
+    } else if (r.ok) {
+      success('Servidor do conteudo respondendo');
+    } else {
+      error(`Servidor do conteudo respondeu ${r.status}`);
+      problemas.push('O conteudo ao vivo pode estar fora do ar. Seus arquivos locais continuam funcionando.');
+    }
+  } catch {
+    error('Sem resposta do servidor do conteudo');
+    problemas.push('Confira sua internet. Sem servidor, o conteudo ao vivo nao chega — o resto do Auroq continua.');
+  }
+
+  log('');
+  if (problemas.length === 0) {
+    success('Tudo certo. Pode chamar o Companion.');
+    return 0;
+  }
+  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}`);
+  return 1;
+}
+
 async function writeArcaneMcpConfig(targetDir) {
   const pin = 'arcane-mcp@0.2.0';
   const mcpPath = path.join(targetDir, '.mcp.json');
@@ -927,6 +1022,11 @@ if (command === 'init' || command === 'install') {
     error(`Falha ao conectar 1Password: ${e.message}`);
     process.exit(1);
   });
+} else if (command === 'doctor' || command === 'diagnostico') {
+  runDoctor(process.cwd()).then(code => process.exit(code)).catch(e => {
+    error(`Falha no diagnostico: ${e.message}`);
+    process.exit(1);
+  });
 } else if (command === 'sync-codex') {
   // Regenera as skills do Codex CLI a partir dos comandos atuais do projeto.
   try {
@@ -948,6 +1048,7 @@ if (command === 'init' || command === 'install') {
   log(`  ${CYAN}whoami${RESET}   Mostrar usuario autenticado`);
   log(`  ${CYAN}check-access${RESET}  Validar acesso ativo (online; exit 0=ativo, 1=bloqueado)`);
   log(`  ${CYAN}update${RESET}   Atualizar (via Ops dentro do Claude Code)`);
+  log(`  ${CYAN}doctor${RESET}   Diagnostico: arquivos, Node, MCP arcane, login e servidor`);
   log(`  ${CYAN}sync-codex${RESET}  Gerar e verificar as skills locais do Codex CLI ($nome)`);
   log(`  ${CYAN}conectar-1password${RESET}  Conectar o 1Password CLI (token lido do Ctrl+C, nunca digitado)`);
   log('');

package/package.json

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

package/scripts/sync-codex-skills.mjs

@@ -88,6 +88,12 @@ function collectSkills() {
 
 function skillContent(name, commandFile, outRoot) {
   const commandRef = sourceRef(commandFile, outRoot);
+  // Casca de MCP: mandar o Codex "resolver em agents/" faz ele varrer pasta vazia
+  // e improvisar. Quando o comando ja aponta pro MCP, a skill tem que dizer o mesmo.
+  let viaMcp = false;
+  try {
+    viaMcp = /MCP `arcane`/.test(fs.readFileSync(commandFile, 'utf8'));
+  } catch { /* comando ilegivel = trata como local */ }
   const agentsRef = sourceRef(path.join(root, 'agents'), outRoot);
   const agentsMdRef = sourceRef(path.join(root, 'AGENTS.md'), outRoot);
   const description = `Ativa o agente Auroq '${name}' no Codex CLI. Use quando o usuario digitar $${name}, /${name}, /auroq-${name}, @${name}, pedir o agente '${name}', ou solicitar seu fluxo de trabalho. Fonte de verdade: ${commandRef}.`;
@@ -105,7 +111,9 @@ ${summaryFromMarkdown(commandFile)}
 
 - Leia \`${commandRef}\` por completo.
 - Siga as instrucoes CRITICAL exatamente como escritas, incluindo persona, task, dependencias e exit behavior.
-- Resolva referencias relativas a partir de \`${root.replaceAll('\\', '/')}\`; agentes e squads ficam em \`${agentsRef}\`.
+${viaMcp
+  ? '- O conteudo deste agente vem pelo MCP `arcane`. Nao procurar em `' + agentsRef + '` — la nao ha nada deste agente.'
+  : '- Resolva referencias relativas a partir de `' + root.replaceAll('\\', '/') + '`; agentes e squads ficam em `' + agentsRef + '`.'}
 - Carregue KBs, tasks e assets apenas quando o comando ou pedido exigir.
 - Mantenha a persona ativa ate \`*exit\` ou troca explicita.