aios-core 2.2.0 → 2.2.2

package/README.md

@@ -1,8 +1,8 @@
 # Synkra AIOS: Framework Universal de Agentes IA 🚀
 
-[![Versão NPM](https://img.shields.io/npm/v/@synkra/aios-core.svg)](https://www.npmjs.com/package/@synkra/aios-core)
+[![Versão NPM](https://img.shields.io/npm/v/aios-core.svg)](https://www.npmjs.com/package/aios-core)
 [![Licença: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Versão Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg)](https://nodejs.org/)
+[![Versão Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
 [![Documentação](https://img.shields.io/badge/docs-disponível-orange.svg)](https://synkra.ai)
 [![Open Source](https://img.shields.io/badge/Open%20Source-Yes-success.svg)](LICENSE)
 [![Contributions Welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)](CONTRIBUTING.md)
@@ -24,9 +24,11 @@ Esta abordagem de duas fases elimina tanto a **inconsistência de planejamento**
 
 ## Pré-requisitos
 
-- Node.js >=20.0.0
-- npm
-- GitHub CLI (necessário para colaboração em equipe)
+- Node.js >=18.0.0 (v20+ recomendado)
+- npm >=9.0.0
+- GitHub CLI (opcional, necessário para colaboração em equipe)
+
+> **Problemas de instalação?** Consulte o [Guia de Troubleshooting](docs/guides/installation-troubleshooting.md)
 
 **Guias específicos por plataforma:**
 - 📖 [Guia de Instalação para macOS](docs/installation/macos.md)
@@ -81,14 +83,14 @@ Isto facilita beneficiar-se das últimas melhorias, correções de bugs e novos
 
 ```bash
 # Criar um novo projeto com assistente interativo moderno
-npx @synkra/aios-core init meu-projeto
+npx aios-core init meu-projeto
 
 # Ou instalar em projeto existente
 cd seu-projeto
-npx @synkra/aios-core install
+npx aios-core install
 
 # Ou usar uma versão específica
-npx @synkra/aios-core@latest init meu-projeto
+npx aios-core@latest init meu-projeto
 ```
 
 ### ✨ Assistente de Instalação Moderno
@@ -118,7 +120,7 @@ O Synkra AIOS agora inclui uma experiência de instalação interativa de últim
 
 > **É isso!** Sem clonar, sem configuração manual - apenas um comando e você está pronto para começar com uma experiência de instalação moderna e profissional.
 
-**Pré-requisitos**: [Node.js](https://nodejs.org) v18+ necessário (v20+ recomendado)
+**Pré-requisitos**: [Node.js](https://nodejs.org) v18+ necessário (v20+ recomendado) | [Troubleshooting](docs/guides/installation-troubleshooting.md)
 
 ### Atualizando uma Instalação Existente
 
@@ -164,27 +166,27 @@ O Synkra AIOS oferece uma CLI moderna e cross-platform com comandos intuitivos:
 
 ```bash
 # Gerenciamento de Projeto (com assistente interativo)
-npx @synkra/aios-core init <nome-projeto> [opções]
+npx aios-core init <nome-projeto> [opções]
   --force              Forçar criação em diretório não vazio
   --skip-install       Pular instalação de dependências npm
   --template <nome>    Usar template específico (default, minimal, enterprise)
 
 # Instalação e Configuração (com prompts modernos)
-npx @synkra/aios-core install [opções]
+npx aios-core install [opções]
   --force              Sobrescrever configuração existente
   --quiet              Saída mínima durante instalação
   --dry-run            Simular instalação sem modificar arquivos
 
 # Comandos do Sistema
-npx @synkra/aios-core --version   Exibir versão instalada
-npx @synkra/aios-core --help      Exibir ajuda detalhada
-npx @synkra/aios-core info        Exibir informações do sistema
-npx @synkra/aios-core doctor      Executar diagnósticos do sistema
-npx @synkra/aios-core doctor --fix Corrigir problemas detectados automaticamente
+npx aios-core --version   Exibir versão instalada
+npx aios-core --help      Exibir ajuda detalhada
+npx aios-core info        Exibir informações do sistema
+npx aios-core doctor      Executar diagnósticos do sistema
+npx aios-core doctor --fix Corrigir problemas detectados automaticamente
 
 # Manutenção
-npx @synkra/aios-core update      Atualizar para versão mais recente
-npx @synkra/aios-core uninstall   Remover Synkra AIOS
+npx aios-core update      Atualizar para versão mais recente
+npx aios-core uninstall   Remover Synkra AIOS
 ```
 
 **Recursos da CLI:**
@@ -199,7 +201,7 @@ npx @synkra/aios-core uninstall   Remover Synkra AIOS
 #### Instalação Interativa Completa
 
 ```bash
-$ npx @synkra/aios-core install
+$ npx aios-core install
 
 🚀 Synkra AIOS Installation
 
@@ -237,15 +239,15 @@ $ npx @synkra/aios-core install
 
 Next steps:
   cd my-awesome-project
-  @synkra/aios-core doctor     # Verify installation
-  @synkra/aios-core --help     # See available commands
+  aios-core doctor     # Verify installation
+  aios-core --help     # See available commands
 ```
 
 #### Instalação Silenciosa (CI/CD)
 
 ```bash
 # Instalação automatizada sem prompts
-$ npx @synkra/aios-core install --quiet --force
+$ npx aios-core install --quiet --force
 ✔ Synkra AIOS installed successfully
 ```
 
@@ -253,7 +255,7 @@ $ npx @synkra/aios-core install --quiet --force
 
 ```bash
 # Testar instalação sem modificar arquivos
-$ npx @synkra/aios-core install --dry-run
+$ npx aios-core install --dry-run
 
 [DRY RUN] Would create: ./my-project/
 [DRY RUN] Would copy: .aios-core/ (45 files)
@@ -265,7 +267,7 @@ $ npx @synkra/aios-core install --dry-run
 #### Diagnóstico do Sistema
 
 ```bash
-$ npx @synkra/aios-core doctor
+$ npx aios-core doctor
 
 🏥 AIOS System Diagnostics
 
@@ -294,9 +296,9 @@ Dependencies:
 #### Obter Ajuda
 
 ```bash
-$ npx @synkra/aios-core --help
+$ npx aios-core --help
 
-Usage: @synkra/aios-core [options] [command]
+Usage: aios-core [options] [command]
 
 Synkra AIOS: AI-Orchestrated System for Full Stack Development
 
@@ -311,7 +313,7 @@ Commands:
   doctor [options]             Run system diagnostics and health checks
   help [command]               display help for command
 
-Run '@synkra/aios-core <command> --help' for detailed information about each command.
+Run 'aios-core <command> --help' for detailed information about each command.
 ```
 
 ### Alternativa: Clonar e Construir
@@ -699,4 +701,4 @@ Veja também:
 
 ---
 
-**[⬆ Voltar ao topo](#@synkra/aios-core-framework-universal-de-agentes-ia-)**
+**[⬆ Voltar ao topo](#synkra-aios-framework-universal-de-agentes-ia-)**

package/bin/aios-init.js

@@ -289,11 +289,12 @@ async function main() {
     }
 
     // Step 2: Install AIOS CORE agents and tasks for Claude Code
+    // v2.1: Agents and tasks are in development/ module
     if (ides.includes('claude')) {
-      const coreAgentsSource = path.join(targetCoreDir, 'agents');
+      const coreAgentsSource = path.join(targetCoreDir, 'development', 'agents');
       const coreAgentsTarget = path.join(context.projectRoot, '.claude', 'commands', 'AIOS', 'agents');
 
-      const coreTasksSource = path.join(targetCoreDir, 'tasks');
+      const coreTasksSource = path.join(targetCoreDir, 'development', 'tasks');
       const coreTasksTarget = path.join(context.projectRoot, '.claude', 'commands', 'AIOS', 'tasks');
 
       if (fs.existsSync(coreAgentsSource)) {
@@ -325,8 +326,9 @@ See .aios-core/user-guide.md for complete documentation.
     }
 
     // Step 3: Install AIOS CORE agents for Cursor
+    // v2.1: Agents are in development/ module
     if (ides.includes('cursor')) {
-      const coreAgentsSource = path.join(targetCoreDir, 'agents');
+      const coreAgentsSource = path.join(targetCoreDir, 'development', 'agents');
       const cursorRulesTarget = path.join(context.projectRoot, '.cursor', 'rules', 'AIOS', 'agents');
 
       if (fs.existsSync(coreAgentsSource)) {
@@ -360,10 +362,11 @@ See .aios-core/user-guide.md for complete documentation.
     }
 
     // Step 4: Install AIOS CORE agents for other IDEs (Trae, Cline, Gemini, AntiGravity)
+    // v2.1: Agents are in development/ module
     const otherIdeInstalls = ['trae', 'cline', 'gemini', 'antigravity'];
     for (const ide of otherIdeInstalls) {
       if (ides.includes(ide)) {
-        const coreAgentsSource = path.join(targetCoreDir, 'agents');
+        const coreAgentsSource = path.join(targetCoreDir, 'development', 'agents');
         const ideRulesDir = ide === 'gemini' ? '.gemini' : `.${ide}`;
         const ideRulesTarget = path.join(context.projectRoot, ideRulesDir, 'rules', 'AIOS', 'agents');
 
@@ -385,8 +388,9 @@ See .aios-core/user-guide.md for complete documentation.
     }
 
     // Step 5: Install Roo Code modes
+    // v2.1: Agents are in development/ module
     if (ides.includes('roo')) {
-      const coreAgentsSource = path.join(targetCoreDir, 'agents');
+      const coreAgentsSource = path.join(targetCoreDir, 'development', 'agents');
       const rooModesPath = path.join(context.projectRoot, '.roomodes');
 
       if (fs.existsSync(coreAgentsSource)) {
@@ -412,8 +416,9 @@ See .aios-core/user-guide.md for complete documentation.
     }
 
     // Step 6: Install GitHub Copilot chat modes
+    // v2.1: Agents are in development/ module
     if (ides.includes('github-copilot')) {
-      const coreAgentsSource = path.join(targetCoreDir, 'agents');
+      const coreAgentsSource = path.join(targetCoreDir, 'development', 'agents');
       const copilotModesDir = path.join(context.projectRoot, '.github', 'chatmodes');
 
       if (fs.existsSync(coreAgentsSource)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aios-core",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "description": "Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework",
   "main": "index.js",
   "module": "index.esm.js",

package/packages/installer/tests/integration/environment-configuration.test.js

@@ -9,7 +9,6 @@ const fs = require('fs-extra');
 const path = require('path');
 const os = require('os');
 const { configureEnvironment, updateGitignore } = require('../../src/config/configure-environment');
-const pkg = require('../../../../package.json');
 
 /**
  * Cleanup helper with retry logic for flaky file system operations
@@ -73,7 +72,8 @@ describe('Environment Configuration Integration', () => {
 
       const content = await fs.readFile(envPath, 'utf8');
       expect(content).toContain('NODE_ENV=development');
-      expect(content).toContain(`AIOS_VERSION=${pkg.version}`);
+      // Version-agnostic: check AIOS_VERSION exists with valid semver format
+      expect(content).toMatch(/AIOS_VERSION=\d+\.\d+\.\d+/);
     });
 
     it('should create .env.example file', async () => {

package/packages/installer/tests/unit/env-template.test.js

@@ -6,7 +6,6 @@
  */
 
 const { generateEnvContent, generateEnvExample } = require('../../src/config/templates/env-template');
-const pkg = require('../../../../package.json');
 
 describe('.env Template Generator', () => {
   describe('generateEnvContent', () => {
@@ -14,7 +13,8 @@ describe('.env Template Generator', () => {
       const content = generateEnvContent();
 
       expect(content).toContain('NODE_ENV=development');
-      expect(content).toContain(`AIOS_VERSION=${pkg.version}`);
+      // Version-agnostic: check AIOS_VERSION exists with valid semver format
+      expect(content).toMatch(/AIOS_VERSION=\d+\.\d+\.\d+/);
       expect(content).toContain('OPENAI_API_KEY=');
       expect(content).toContain('ANTHROPIC_API_KEY=');
       expect(content).toContain('# Synkra AIOS Environment Configuration');
@@ -84,7 +84,8 @@ describe('.env Template Generator', () => {
       const content = generateEnvExample();
 
       expect(content).toContain('NODE_ENV=development');
-      expect(content).toContain(`AIOS_VERSION=${pkg.version}`);
+      // Version-agnostic: check AIOS_VERSION exists with valid semver format
+      expect(content).toMatch(/AIOS_VERSION=\d+\.\d+\.\d+/);
       expect(content).toContain('OPENAI_API_KEY=');
       expect(content).toContain('ANTHROPIC_API_KEY=');
       expect(content).toContain('CLICKUP_API_KEY=');

package/tools/diagnose-installation.js

@@ -0,0 +1,266 @@
+#!/usr/bin/env node
+/**
+ * AIOS-Core Installation Diagnostic Tool
+ *
+ * Run this script to diagnose installation issues:
+ *   node diagnose-installation.js
+ *
+ * Or directly from URL:
+ *   npx https://raw.githubusercontent.com/SynkraAI/aios-core/main/tools/diagnose-installation.js
+ */
+
+const { execSync, spawnSync } = require('child_process');
+const os = require('os');
+const path = require('path');
+const fs = require('fs');
+
+const REQUIRED_NODE = '18.0.0';
+const REQUIRED_NPM = '9.0.0';
+
+console.log('');
+console.log('╔══════════════════════════════════════════════════════════════════╗');
+console.log('║          AIOS-Core Installation Diagnostic Tool                  ║');
+console.log('╚══════════════════════════════════════════════════════════════════╝');
+console.log('');
+
+// Helper functions
+function exec(cmd) {
+  try {
+    return execSync(cmd, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+  } catch (e) {
+    return null;
+  }
+}
+
+function compareVersions(v1, v2) {
+  const parts1 = v1.split('.').map(Number);
+  const parts2 = v2.split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((parts1[i] || 0) > (parts2[i] || 0)) return 1;
+    if ((parts1[i] || 0) < (parts2[i] || 0)) return -1;
+  }
+  return 0;
+}
+
+function checkMark(ok) {
+  return ok ? '✓' : '✗';
+}
+
+let hasErrors = false;
+let hasWarnings = false;
+
+// 1. System Information
+console.log('── System Information ──────────────────────────────────────────────');
+console.log(`  Platform:     ${os.platform()} (${os.arch()})`);
+console.log(`  OS:           ${os.type()} ${os.release()}`);
+console.log(`  Hostname:     ${os.hostname()}`);
+console.log(`  Home:         ${os.homedir()}`);
+console.log(`  User:         ${os.userInfo().username}`);
+console.log('');
+
+// 2. Node.js Check
+console.log('── Node.js ─────────────────────────────────────────────────────────');
+const nodeVersion = exec('node --version');
+if (nodeVersion) {
+  const nodeVer = nodeVersion.replace('v', '');
+  const nodeOk = compareVersions(nodeVer, REQUIRED_NODE) >= 0;
+  console.log(`  ${checkMark(nodeOk)} Version:     ${nodeVersion} (required: >= v${REQUIRED_NODE})`);
+  if (!nodeOk) {
+    console.log(`    ⚠️  ERROR: Node.js version too old! Please upgrade to v${REQUIRED_NODE} or higher.`);
+    console.log(`    📥 Download: https://nodejs.org/`);
+    hasErrors = true;
+  }
+  const nodePath = exec('where node') || exec('which node');
+  console.log(`  Path:         ${nodePath ? nodePath.split('\n')[0] : 'NOT FOUND'}`);
+} else {
+  console.log('  ✗ Node.js:    NOT INSTALLED');
+  console.log('    ⚠️  ERROR: Node.js is required!');
+  console.log('    📥 Download: https://nodejs.org/');
+  hasErrors = true;
+}
+console.log('');
+
+// 3. npm Check
+console.log('── npm ─────────────────────────────────────────────────────────────');
+const npmVersion = exec('npm --version');
+if (npmVersion) {
+  const npmOk = compareVersions(npmVersion, REQUIRED_NPM) >= 0;
+  console.log(`  ${checkMark(npmOk)} Version:     v${npmVersion} (required: >= v${REQUIRED_NPM})`);
+  if (!npmOk) {
+    console.log(`    ⚠️  ERROR: npm version too old! Please upgrade.`);
+    console.log(`    📥 Run: npm install -g npm@latest`);
+    hasErrors = true;
+  }
+  const npmPath = exec('where npm') || exec('which npm');
+  console.log(`  Path:         ${npmPath ? npmPath.split('\n')[0] : 'NOT FOUND'}`);
+} else {
+  console.log('  ✗ npm:        NOT INSTALLED');
+  console.log('    ⚠️  ERROR: npm is required!');
+  hasErrors = true;
+}
+console.log('');
+
+// 4. npx Check
+console.log('── npx ─────────────────────────────────────────────────────────────');
+const npxVersion = exec('npx --version');
+if (npxVersion) {
+  console.log(`  ✓ Version:     v${npxVersion}`);
+  const npxPath = exec('where npx') || exec('which npx');
+  console.log(`  Path:         ${npxPath ? npxPath.split('\n')[0] : 'NOT FOUND'}`);
+} else {
+  console.log('  ✗ npx:        NOT FOUND');
+  console.log('    ⚠️  ERROR: npx is required! Usually comes with npm.');
+  hasErrors = true;
+}
+console.log('');
+
+// 5. Git Check
+console.log('── Git ─────────────────────────────────────────────────────────────');
+const gitVersion = exec('git --version');
+if (gitVersion) {
+  console.log(`  ✓ Version:     ${gitVersion.replace('git version ', 'v')}`);
+} else {
+  console.log('  ✗ Git:        NOT INSTALLED');
+  console.log('    ⚠️  WARNING: Git is recommended for full functionality.');
+  console.log('    📥 Download: https://git-scm.com/');
+  hasWarnings = true;
+}
+console.log('');
+
+// 6. npm Configuration
+console.log('── npm Configuration ───────────────────────────────────────────────');
+const npmPrefix = exec('npm config get prefix');
+const npmCache = exec('npm config get cache');
+const npmRegistry = exec('npm config get registry');
+console.log(`  Prefix:       ${npmPrefix || 'NOT SET'}`);
+console.log(`  Cache:        ${npmCache || 'NOT SET'}`);
+console.log(`  Registry:     ${npmRegistry || 'NOT SET'}`);
+
+// Check if prefix is in PATH
+if (npmPrefix) {
+  const pathEnv = process.env.PATH || process.env.Path || '';
+  const inPath = pathEnv.toLowerCase().includes(npmPrefix.toLowerCase());
+  console.log(`  ${checkMark(inPath)} In PATH:     ${inPath ? 'Yes' : 'NO - This may cause issues!'}`);
+  if (!inPath) {
+    console.log(`    ⚠️  WARNING: npm prefix is not in PATH!`);
+    console.log(`    📝 Add this to your PATH: ${npmPrefix}`);
+    hasWarnings = true;
+  }
+}
+console.log('');
+
+// 7. Network Check
+console.log('── Network Access ──────────────────────────────────────────────────');
+const registryCheck = exec('npm ping 2>&1');
+if (registryCheck && registryCheck.includes('PONG')) {
+  console.log('  ✓ npm registry is accessible');
+} else {
+  // Try curl/wget
+  const curlCheck = exec('curl -s -o /dev/null -w "%{http_code}" https://registry.npmjs.org/ 2>&1');
+  if (curlCheck === '200') {
+    console.log('  ✓ npm registry is accessible (via curl)');
+  } else {
+    console.log('  ⚠️  Cannot verify npm registry access');
+    console.log(`    Registry check result: ${registryCheck || 'no response'}`);
+    hasWarnings = true;
+  }
+}
+console.log('');
+
+// 8. Package Availability Check
+console.log('── Package Availability ────────────────────────────────────────────');
+const pkgInfo = exec('npm view aios-core version 2>&1');
+if (pkgInfo && !pkgInfo.includes('E404') && !pkgInfo.includes('error')) {
+  console.log(`  ✓ aios-core v${pkgInfo} is available on npm`);
+} else {
+  console.log('  ⚠️  Cannot verify aios-core package availability');
+  console.log(`    Result: ${pkgInfo || 'no response'}`);
+  hasWarnings = true;
+}
+console.log('');
+
+// 9. Permission Check (Windows/Unix)
+console.log('── Permissions ─────────────────────────────────────────────────────');
+if (os.platform() === 'win32') {
+  // Check PowerShell execution policy
+  const psPolicy = exec('powershell -Command "Get-ExecutionPolicy"');
+  if (psPolicy) {
+    const policyOk = ['Unrestricted', 'RemoteSigned', 'Bypass'].includes(psPolicy);
+    console.log(`  ${checkMark(policyOk)} PowerShell Execution Policy: ${psPolicy}`);
+    if (!policyOk) {
+      console.log('    ⚠️  WARNING: Restricted policy may block scripts.');
+      console.log('    📝 Run: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser');
+      hasWarnings = true;
+    }
+  }
+} else {
+  // Check npm global folder permissions
+  if (npmPrefix && fs.existsSync(npmPrefix)) {
+    try {
+      fs.accessSync(npmPrefix, fs.constants.W_OK);
+      console.log('  ✓ npm prefix is writable');
+    } catch {
+      console.log('  ✗ npm prefix is NOT writable');
+      console.log('    ⚠️  WARNING: May need sudo or fix permissions');
+      hasWarnings = true;
+    }
+  }
+}
+console.log('');
+
+// 10. Test npx execution
+console.log('── npx Test ────────────────────────────────────────────────────────');
+console.log('  Testing: npx aios-core@latest --version');
+const npxTest = exec('npx aios-core@latest --version 2>&1');
+if (npxTest && npxTest.match(/\d+\.\d+\.\d+/)) {
+  console.log(`  ✓ SUCCESS: ${npxTest}`);
+} else {
+  console.log(`  ✗ FAILED: ${npxTest || 'no output'}`);
+  hasErrors = true;
+}
+console.log('');
+
+// Summary
+console.log('══════════════════════════════════════════════════════════════════');
+if (hasErrors) {
+  console.log('❌ RESULT: Installation requirements NOT met');
+  console.log('');
+  console.log('COMMON FIXES:');
+  console.log('  1. Update Node.js: https://nodejs.org/ (download LTS version)');
+  console.log('  2. Update npm: npm install -g npm@latest');
+  console.log('  3. Clear npm cache: npm cache clean --force');
+  console.log('  4. Check firewall/proxy settings');
+  console.log('');
+} else if (hasWarnings) {
+  console.log('⚠️  RESULT: May work but some issues detected');
+  console.log('   Review warnings above for optimal setup.');
+  console.log('');
+} else {
+  console.log('✅ RESULT: All requirements met!');
+  console.log('');
+  console.log('You can install AIOS-Core with:');
+  console.log('  npx aios-core@latest');
+  console.log('');
+}
+
+// Output machine-readable summary
+const summary = {
+  timestamp: new Date().toISOString(),
+  platform: os.platform(),
+  arch: os.arch(),
+  node: nodeVersion,
+  npm: npmVersion,
+  npx: npxVersion,
+  git: gitVersion,
+  npmPrefix,
+  npmCache,
+  npmRegistry,
+  hasErrors,
+  hasWarnings,
+  npxTestResult: npxTest
+};
+
+const summaryFile = path.join(os.tmpdir(), 'aios-diagnostic-result.json');
+fs.writeFileSync(summaryFile, JSON.stringify(summary, null, 2));
+console.log(`📋 Full diagnostic saved to: ${summaryFile}`);
+console.log('');

package/tools/diagnose-npx-issue.ps1

@@ -0,0 +1,96 @@
+# Diagnóstico de problema com npx aios-core
+# Execute este script no PC com problema
+
+Write-Host ""
+Write-Host "========================================" -ForegroundColor Cyan
+Write-Host "   Diagnóstico NPX aios-core" -ForegroundColor Cyan
+Write-Host "========================================" -ForegroundColor Cyan
+Write-Host ""
+
+# 1. Verificar versões
+Write-Host "[1] Versões instaladas:" -ForegroundColor Yellow
+Write-Host "    Node.js: $(node --version)"
+Write-Host "    npm: $(npm --version)"
+Write-Host "    npx: $(npx --version)"
+Write-Host ""
+
+# 2. Verificar se Node funciona corretamente
+Write-Host "[2] Testando Node.js básico:" -ForegroundColor Yellow
+$nodeTest = node -e "console.log('OK: Node funciona')" 2>&1
+Write-Host "    $nodeTest"
+Write-Host ""
+
+# 3. Verificar cache npx
+Write-Host "[3] Limpando cache npx..." -ForegroundColor Yellow
+npm cache clean --force 2>&1 | Out-Null
+Write-Host "    Cache limpo"
+Write-Host ""
+
+# 4. Tentar baixar e executar manualmente
+Write-Host "[4] Baixando aios-core manualmente..." -ForegroundColor Yellow
+$tempDir = "$env:TEMP\aios-test-$(Get-Random)"
+New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+Set-Location $tempDir
+
+Write-Host "    Diretório: $tempDir"
+npm pack aios-core@2.2.0 2>&1 | Out-Null
+
+if (Test-Path "aios-core-2.2.0.tgz") {
+    Write-Host "    Download: OK" -ForegroundColor Green
+
+    # Extrair
+    tar -xzf aios-core-2.2.0.tgz 2>&1 | Out-Null
+
+    if (Test-Path "package/bin/aios.js") {
+        Write-Host "    Extração: OK" -ForegroundColor Green
+
+        # Tentar executar
+        Write-Host ""
+        Write-Host "[5] Executando bin/aios.js --version:" -ForegroundColor Yellow
+        try {
+            $result = node package/bin/aios.js --version 2>&1
+            if ($result -match "^\d+\.\d+\.\d+$") {
+                Write-Host "    Resultado: $result" -ForegroundColor Green
+            } else {
+                Write-Host "    Resultado inesperado: $result" -ForegroundColor Red
+            }
+        } catch {
+            Write-Host "    ERRO: $($_.Exception.Message)" -ForegroundColor Red
+        }
+
+        # Tentar executar o wizard
+        Write-Host ""
+        Write-Host "[6] Testando wizard (Ctrl+C para cancelar):" -ForegroundColor Yellow
+        Write-Host "    Executando: node package/bin/aios.js --help"
+        node package/bin/aios.js --help 2>&1
+
+    } else {
+        Write-Host "    Extração: FALHOU - bin/aios.js não encontrado" -ForegroundColor Red
+        Write-Host "    Conteúdo do package:"
+        Get-ChildItem package -Recurse | Select-Object -First 20
+    }
+} else {
+    Write-Host "    Download: FALHOU" -ForegroundColor Red
+    Write-Host "    Verifique sua conexão com a internet"
+}
+
+# Limpar
+Set-Location $env:USERPROFILE
+Remove-Item -Recurse -Force $tempDir -ErrorAction SilentlyContinue
+
+Write-Host ""
+Write-Host "========================================" -ForegroundColor Cyan
+Write-Host "   Diagnóstico Completo" -ForegroundColor Cyan
+Write-Host "========================================" -ForegroundColor Cyan
+Write-Host ""
+
+# Recomendação
+Write-Host "RECOMENDAÇÃO:" -ForegroundColor Yellow
+Write-Host "Node v24 é uma versão EXPERIMENTAL e pode ter problemas."
+Write-Host ""
+Write-Host "Solução recomendada:" -ForegroundColor Green
+Write-Host "1. Baixe Node.js LTS (v22 ou v20) de: https://nodejs.org/"
+Write-Host "2. Desinstale Node v24"
+Write-Host "3. Instale a versão LTS"
+Write-Host "4. Tente novamente: npx aios-core@latest"
+Write-Host ""

package/tools/quick-diagnose.cmd

@@ -0,0 +1,85 @@
+@echo off
+echo.
+echo ========================================
+echo    AIOS-Core Quick Diagnostic (CMD)
+echo ========================================
+echo.
+
+echo Checking Node.js...
+node --version 2>nul
+if %errorlevel% neq 0 (
+    echo   ERROR: Node.js NOT INSTALLED!
+    echo   Download: https://nodejs.org/
+) else (
+    echo   Node.js: OK
+)
+
+echo.
+echo Checking npm...
+npm --version 2>nul
+if %errorlevel% neq 0 (
+    echo   ERROR: npm NOT INSTALLED!
+) else (
+    echo   npm: OK
+)
+
+echo.
+echo Checking npx...
+npx --version 2>nul
+if %errorlevel% neq 0 (
+    echo   ERROR: npx NOT FOUND!
+) else (
+    echo   npx: OK
+)
+
+echo.
+echo Checking Git...
+git --version 2>nul
+if %errorlevel% neq 0 (
+    echo   WARNING: Git not installed (optional)
+    echo   Download: https://git-scm.com/
+) else (
+    echo   Git: OK
+)
+
+echo.
+echo Checking npm prefix...
+for /f "tokens=*" %%i in ('npm config get prefix 2^>nul') do set NPM_PREFIX=%%i
+echo   npm prefix: %NPM_PREFIX%
+
+echo.
+echo Checking aios-core availability on npm...
+npm view aios-core version 2>nul
+if %errorlevel% neq 0 (
+    echo   ERROR: Cannot access npm registry!
+    echo   Check your internet/firewall settings
+) else (
+    echo   aios-core: Available
+)
+
+echo.
+echo ========================================
+echo    Testing npx aios-core@latest
+echo ========================================
+echo.
+echo Running: npx aios-core@latest --version
+echo (This may take a moment on first run...)
+echo.
+npx aios-core@latest --version
+if %errorlevel% neq 0 (
+    echo.
+    echo   ERROR: npx aios-core failed!
+    echo.
+    echo Common fixes:
+    echo   1. Update Node.js to v18+: https://nodejs.org/
+    echo   2. Update npm: npm install -g npm@latest
+    echo   3. Clear cache: npm cache clean --force
+    echo   4. Check firewall/proxy settings
+) else (
+    echo.
+    echo   SUCCESS! You can now run:
+    echo   npx aios-core@latest
+)
+
+echo.
+pause

package/tools/quick-diagnose.ps1

@@ -0,0 +1,117 @@
+# AIOS-Core Quick Diagnostic - Run this in PowerShell
+# Usage: Copy and paste this entire script into PowerShell on the target machine
+
+Write-Host ""
+Write-Host "========================================" -ForegroundColor Cyan
+Write-Host "   AIOS-Core Quick Diagnostic" -ForegroundColor Cyan
+Write-Host "========================================" -ForegroundColor Cyan
+Write-Host ""
+
+# Check Node.js
+Write-Host "Checking Node.js..." -ForegroundColor Yellow
+$nodeVersion = & node --version 2>$null
+if ($nodeVersion) {
+    Write-Host "  Node.js: $nodeVersion" -ForegroundColor Green
+    $nodeMajor = [int]($nodeVersion -replace 'v(\d+)\..*', '$1')
+    if ($nodeMajor -lt 18) {
+        Write-Host "  ERROR: Node.js 18+ required!" -ForegroundColor Red
+    }
+} else {
+    Write-Host "  ERROR: Node.js NOT INSTALLED!" -ForegroundColor Red
+    Write-Host "  Download: https://nodejs.org/" -ForegroundColor Yellow
+}
+
+# Check npm
+Write-Host ""
+Write-Host "Checking npm..." -ForegroundColor Yellow
+$npmVersion = & npm --version 2>$null
+if ($npmVersion) {
+    Write-Host "  npm: v$npmVersion" -ForegroundColor Green
+    $npmMajor = [int]($npmVersion -replace '(\d+)\..*', '$1')
+    if ($npmMajor -lt 9) {
+        Write-Host "  ERROR: npm 9+ required!" -ForegroundColor Red
+        Write-Host "  Run: npm install -g npm@latest" -ForegroundColor Yellow
+    }
+} else {
+    Write-Host "  ERROR: npm NOT INSTALLED!" -ForegroundColor Red
+}
+
+# Check npx
+Write-Host ""
+Write-Host "Checking npx..." -ForegroundColor Yellow
+$npxVersion = & npx --version 2>$null
+if ($npxVersion) {
+    Write-Host "  npx: v$npxVersion" -ForegroundColor Green
+} else {
+    Write-Host "  ERROR: npx NOT FOUND!" -ForegroundColor Red
+}
+
+# Check Git
+Write-Host ""
+Write-Host "Checking Git..." -ForegroundColor Yellow
+$gitVersion = & git --version 2>$null
+if ($gitVersion) {
+    Write-Host "  $gitVersion" -ForegroundColor Green
+} else {
+    Write-Host "  WARNING: Git not installed (optional but recommended)" -ForegroundColor Yellow
+    Write-Host "  Download: https://git-scm.com/" -ForegroundColor Yellow
+}
+
+# Check PowerShell Execution Policy
+Write-Host ""
+Write-Host "Checking PowerShell Policy..." -ForegroundColor Yellow
+$policy = Get-ExecutionPolicy
+Write-Host "  Execution Policy: $policy" -ForegroundColor $(if ($policy -in @('Unrestricted', 'RemoteSigned', 'Bypass')) { 'Green' } else { 'Red' })
+if ($policy -notin @('Unrestricted', 'RemoteSigned', 'Bypass')) {
+    Write-Host "  WARNING: May need to run:" -ForegroundColor Yellow
+    Write-Host "  Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser" -ForegroundColor Yellow
+}
+
+# Check npm prefix in PATH
+Write-Host ""
+Write-Host "Checking npm PATH..." -ForegroundColor Yellow
+$npmPrefix = & npm config get prefix 2>$null
+if ($npmPrefix) {
+    $inPath = $env:PATH -like "*$npmPrefix*"
+    if ($inPath) {
+        Write-Host "  npm prefix in PATH: Yes" -ForegroundColor Green
+    } else {
+        Write-Host "  npm prefix NOT in PATH!" -ForegroundColor Red
+        Write-Host "  Add to PATH: $npmPrefix" -ForegroundColor Yellow
+    }
+}
+
+# Check npm registry
+Write-Host ""
+Write-Host "Checking npm registry access..." -ForegroundColor Yellow
+$registryTest = & npm view aios-core version 2>$null
+if ($registryTest) {
+    Write-Host "  aios-core v$registryTest available" -ForegroundColor Green
+} else {
+    Write-Host "  Cannot access npm registry!" -ForegroundColor Red
+    Write-Host "  Check firewall/proxy settings" -ForegroundColor Yellow
+}
+
+# Test npx aios-core
+Write-Host ""
+Write-Host "Testing: npx aios-core@latest --version" -ForegroundColor Yellow
+Write-Host "(This may take a moment...)" -ForegroundColor Gray
+try {
+    $result = & npx aios-core@latest --version 2>&1
+    if ($result -match '\d+\.\d+\.\d+') {
+        Write-Host "  SUCCESS: $result" -ForegroundColor Green
+    } else {
+        Write-Host "  FAILED: $result" -ForegroundColor Red
+    }
+} catch {
+    Write-Host "  ERROR: $($_.Exception.Message)" -ForegroundColor Red
+}
+
+Write-Host ""
+Write-Host "========================================" -ForegroundColor Cyan
+Write-Host "   Diagnostic Complete" -ForegroundColor Cyan
+Write-Host "========================================" -ForegroundColor Cyan
+Write-Host ""
+Write-Host "If all checks passed, run:" -ForegroundColor Green
+Write-Host "  npx aios-core@latest" -ForegroundColor White
+Write-Host ""