aios-core 1.0.0

package/templates/squad/squad.yaml

@@ -0,0 +1,25 @@
+name: "{{squad-name}}"
+version: 0.1.0
+description: "{{description}}"
+author: "{{author}}"
+license: MIT
+
+aios:
+  minVersion: "2.1.0"
+  type: squad
+
+components:
+  agents:
+    - agents/*.yaml
+  tasks:
+    - tasks/*.yaml
+  workflows:
+    - workflows/*.yaml
+  templates:
+    - templates/*.md
+
+dependencies: []
+
+keywords:
+  - aios
+  - squad

package/templates/squad/tasks/example-task.yaml

@@ -0,0 +1,46 @@
+# Example Task Definition
+# Replace placeholders with your task's details
+
+name: example-task
+version: 1.0.0
+description: Brief description of what this task accomplishes
+
+inputs:
+  - name: input1
+    type: string
+    required: true
+    description: Primary input for the task
+
+  - name: options
+    type: object
+    required: false
+    description: Optional configuration object
+
+outputs:
+  - name: result
+    type: object
+    description: The processed result
+
+  - name: metadata
+    type: object
+    description: Additional information about the execution
+
+steps:
+  - id: validate
+    action: validate-inputs
+    description: Validate all required inputs are present and valid
+
+  - id: process
+    action: process-data
+    description: Main processing logic
+    depends_on: [validate]
+
+  - id: finalize
+    action: prepare-output
+    description: Format and return the result
+    depends_on: [process]
+
+error_handling:
+  on_validation_error: "Invalid input: {{error.message}}"
+  on_process_error: "Processing failed: {{error.message}}"
+  retry_count: 1

package/templates/squad/templates/example-template.md

@@ -0,0 +1,24 @@
+# {{title}}
+
+**Created:** {{date}}
+**Author:** {{author}}
+
+---
+
+## Overview
+
+{{overview}}
+
+## Details
+
+{{details}}
+
+## Next Steps
+
+- [ ] Step 1
+- [ ] Step 2
+- [ ] Step 3
+
+---
+
+*Generated by {{squad-name}}*

package/templates/squad/tests/example-agent.test.js

@@ -0,0 +1,53 @@
+/**
+ * Example Agent Tests
+ * Replace with your actual test cases
+ */
+
+import { loadAgent, executeCommand } from '@aios/testing';
+
+describe('example-agent', () => {
+  let agent;
+
+  beforeAll(async () => {
+    agent = await loadAgent('./agents/example-agent.yaml');
+  });
+
+  describe('initialization', () => {
+    test('should load agent successfully', () => {
+      expect(agent).toBeDefined();
+      expect(agent.name).toBe('example-agent');
+    });
+
+    test('should have required persona fields', () => {
+      expect(agent.persona.name).toBeDefined();
+      expect(agent.persona.role).toBeDefined();
+      expect(agent.persona.expertise).toBeInstanceOf(Array);
+    });
+  });
+
+  describe('commands', () => {
+    test('should have example-command registered', () => {
+      const command = agent.commands.find(c => c.name === 'example-command');
+      expect(command).toBeDefined();
+      expect(command.workflow).toBe('example-workflow');
+    });
+  });
+
+  describe('execution', () => {
+    test('should execute example-command successfully', async () => {
+      const result = await executeCommand(agent, '*example-command', {
+        input1: 'test-input'
+      });
+
+      expect(result.success).toBe(true);
+      expect(result.output).toBeDefined();
+    });
+
+    test('should handle invalid input gracefully', async () => {
+      const result = await executeCommand(agent, '*example-command', {});
+
+      expect(result.success).toBe(false);
+      expect(result.error).toContain('input');
+    });
+  });
+});

package/templates/squad/workflows/example-workflow.yaml

@@ -0,0 +1,54 @@
+# Example Workflow Definition
+# Replace placeholders with your workflow's details
+
+name: example-workflow
+version: 1.0.0
+description: Multi-step workflow that orchestrates tasks
+
+trigger:
+  command: "*example-command"
+  agent: example-agent
+
+elicitation:
+  enabled: true
+  questions:
+    - id: action_type
+      prompt: "What would you like to do?"
+      type: choice
+      options:
+        - Create new item
+        - Update existing item
+        - Delete item
+
+    - id: item_name
+      prompt: "What is the name of the item?"
+      type: text
+      required: true
+
+steps:
+  - id: step-1
+    task: example-task
+    inputs:
+      input1: "{{elicitation.item_name}}"
+      options:
+        action: "{{elicitation.action_type}}"
+    on_success: step-2
+    on_error: error-handler
+
+  - id: step-2
+    action: log-result
+    description: Log the successful result
+    inputs:
+      message: "Operation completed successfully"
+
+error_handling:
+  - id: error-handler
+    action: notify
+    message: "Workflow failed: {{error.message}}"
+    severity: error
+
+completion:
+  message: "Workflow completed successfully!"
+  next_steps:
+    - Review the output
+    - Verify the changes

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