aios-core 4.2.13 → 4.2.15

package/README.md

@@ -1,5 +1,7 @@
 # Synkra AIOS: Framework Universal de Agentes IA 🚀
 
+> 🌍 [English](README.en.md) | **[Português](README.md)**
+
 [![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%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
@@ -479,7 +481,7 @@ O Synkra AIOS vem com 11 agentes especializados:
 ### Guias Essenciais
 
 - 📖 **[Guia do Usuário](docs/guides/user-guide.md)** - Passo a passo completo desde a concepção até a conclusão do projeto
-- 🏗️ **[Arquitetura Principal](docs/architecture/ARCHITECTURE-INDEX.md)** - Mergulho técnico profundo e design do sistema
+- 🏗️ **[Arquitetura Principal](docs/architecture/AIOS-VISUAL-OVERVIEW.md)** - Mergulho técnico profundo e design do sistema
 - 🚀 **[Guia de Squads](docs/guides/squads-guide.md)** - Estenda o AIOS para qualquer domínio além do desenvolvimento de software
 
 ### Documentação Adicional
@@ -488,7 +490,7 @@ O Synkra AIOS vem com 11 agentes especializados:
 - 📋 **[Primeiros Passos](docs/getting-started.md)** - Tutorial passo a passo para iniciantes
 - 🔧 **[Solução de Problemas](docs/troubleshooting.md)** - Soluções para problemas comuns
 - 🎯 **[Princípios Orientadores](docs/GUIDING-PRINCIPLES.md)** - Filosofia e melhores práticas do AIOS
-- 🏛️ **[Visão Geral da Arquitetura](docs/architecture/ARCHITECTURE-INDEX.md)** - Visão detalhada da arquitetura do sistema
+- 🏛️ **[Visão Geral da Arquitetura](docs/architecture/AIOS-VISUAL-OVERVIEW.md)** - Visão detalhada da arquitetura do sistema
 - ⚙️ **[Guia de Ajuste de Performance](docs/performance-tuning-guide.md)** - Otimize seu fluxo de trabalho AIOS
 - 🔒 **[Melhores Práticas de Segurança](docs/security-best-practices.md)** - Segurança e proteção de dados
 - 🔄 **[Guia de Migração](docs/migration-guide.md)** - Migração de versões anteriores

package/bin/aios.js

@@ -199,10 +199,13 @@ function showInfo() {
       }
     };
 
-    console.log(`  - Agents: ${countFiles(path.join(aiosCoreDir, 'agents'))}`);
-    console.log(`  - Tasks: ${countFiles(path.join(aiosCoreDir, 'tasks'))}`);
-    console.log(`  - Templates: ${countFiles(path.join(aiosCoreDir, 'templates'))}`);
-    console.log(`  - Workflows: ${countFiles(path.join(aiosCoreDir, 'workflows'))}`);
+    const devDir = path.join(aiosCoreDir, 'development');
+    const componentBase = fs.existsSync(devDir) ? devDir : aiosCoreDir;
+
+    console.log(`  - Agents: ${countFiles(path.join(componentBase, 'agents'))}`);
+    console.log(`  - Tasks: ${countFiles(path.join(componentBase, 'tasks'))}`);
+    console.log(`  - Templates: ${countFiles(path.join(componentBase, 'templates'))}`);
+    console.log(`  - Workflows: ${countFiles(path.join(componentBase, 'workflows'))}`);
   } else {
     console.log('\n⚠️  AIOS Core not found');
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aios-core",
-  "version": "4.2.13",
+  "version": "4.2.15",
   "description": "Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework",
   "bin": {
     "aios": "bin/aios.js",

package/packages/aios-pro-cli/src/recover.js

@@ -14,7 +14,7 @@
 
 const readline = require('readline');
 
-const RECOVERY_URL = 'https://pro.synkra.ai/recover';
+const RECOVERY_URL = 'https://aios-license-server.vercel.app/reset-password';
 
 const RECOVERY_MESSAGE =
   'Se este email estiver associado a uma licenca, voce recebera instrucoes de recuperacao.';

package/packages/installer/src/wizard/ide-config-generator.js

@@ -659,8 +659,8 @@ async function copyClaudeHooksFolder(projectRoot) {
 
   // Only copy JS hooks that work standalone (no Python/shell deps)
   const HOOKS_TO_COPY = [
-    'synapse-engine.js',
-    'precompact-session-digest.js',
+    'synapse-engine.cjs',
+    'precompact-session-digest.cjs',
     'README.md',
   ];
 
@@ -692,7 +692,7 @@ async function copyClaudeHooksFolder(projectRoot) {
  */
 async function createClaudeSettingsLocal(projectRoot) {
   const settingsPath = path.join(projectRoot, '.claude', 'settings.local.json');
-  const hookFile = path.join(projectRoot, '.claude', 'hooks', 'synapse-engine.js');
+  const hookFile = path.join(projectRoot, '.claude', 'hooks', 'synapse-engine.cjs');
 
   // Only create if the hook file was actually copied
   if (!await fs.pathExists(hookFile)) {
@@ -705,7 +705,7 @@ async function createClaudeSettingsLocal(projectRoot) {
     hooks: [
       {
         type: 'command',
-        command: 'node ".claude/hooks/synapse-engine.js"',
+        command: 'node ".claude/hooks/synapse-engine.cjs"',
       },
     ],
   };
@@ -736,10 +736,10 @@ async function createClaudeSettingsLocal(projectRoot) {
   const alreadyRegistered = settings.hooks.UserPromptSubmit.some(entry => {
     // Nested format: entry.hooks[].command
     if (Array.isArray(entry.hooks)) {
-      return entry.hooks.some(h => h.command && h.command.includes('synapse-engine.js'));
+      return entry.hooks.some(h => h.command && h.command.includes('synapse-engine'));
     }
     // Flat format (legacy): entry.command
-    return entry.command && entry.command.includes('synapse-engine.js');
+    return entry.command && entry.command.includes('synapse-engine');
   });
 
   if (!alreadyRegistered) {

package/packages/installer/src/wizard/pro-setup.js

@@ -426,11 +426,11 @@ async function loginWithRetry(client, email) {
         const remaining = MAX_RETRIES - attempt;
         if (remaining > 0) {
           spinner.fail(`Incorrect password. ${remaining} attempt${remaining > 1 ? 's' : ''} remaining.`);
-          showInfo('Forgot your password? Visit https://pro.synkra.ai/reset-password');
+          showInfo('Forgot your password? Visit https://aios-license-server.vercel.app/reset-password');
         } else {
           spinner.fail('Maximum login attempts reached.');
-          showInfo('Forgot your password? Visit https://pro.synkra.ai/reset-password');
-          showInfo('Or contact support: support@synkra.ai');
+          showInfo('Forgot your password? Visit https://aios-license-server.vercel.app/reset-password');
+          showInfo('Or open an issue: https://github.com/SynkraAI/aios-core/issues');
           return { success: false, error: 'Maximum login attempts reached.' };
         }
       } else if (loginError.code === 'AUTH_RATE_LIMITED') {

package/pro/license/degradation.js

@@ -1,220 +1,220 @@
-/**
- * Graceful Degradation Module
- *
- * Utilities for handling pro feature unavailability with user-friendly
- * messages that preserve data and provide clear next steps.
- *
- * Per ADR-PRO-003 and AC-8:
- * - Never show upgrade prompts on core features
- * - Never delete or corrupt user data
- * - Always provide actionable next steps
- * - Keep messages non-intrusive
- *
- * @module pro/license/degradation
- * @see ADR-PRO-003 - Feature Gating & Licensing
- * @see Story PRO-6 - License Key & Feature Gating System
- */
-
-'use strict';
-
-const { featureGate } = require('./feature-gate');
-const { ProFeatureError } = require('./errors');
-
-/**
- * Default degradation message template.
- * @private Reserved for future customization support.
- */
-const _DEFAULT_MESSAGE_TEMPLATE = `
-{featureName} requires an active AIOS Pro license.
-
-Your data and configurations are preserved.
-
-Activate: aios pro activate --key <KEY>
-Purchase: https://synkra.ai/pro
-`;
-
-/**
- * Handle pro feature gracefully - return fallback instead of throwing.
- *
- * Use this when you want to provide a degraded experience instead
- * of completely blocking the feature.
- *
- * @param {string} featureId - Feature ID to check
- * @param {Function} proAction - Function to execute if feature is available
- * @param {Function} [fallbackAction] - Function to execute if not available
- * @param {object} [options] - Options
- * @param {boolean} [options.silent=false] - Don't log degradation message
- * @returns {*} Result of proAction or fallbackAction
- */
-function withGracefulDegradation(featureId, proAction, fallbackAction, options = {}) {
-  if (featureGate.isAvailable(featureId)) {
-    return proAction();
-  }
-
-  if (!options.silent) {
-    const featureName = getFeatureFriendlyName(featureId);
-    logDegradationMessage(featureName, featureId);
-  }
-
-  if (typeof fallbackAction === 'function') {
-    return fallbackAction();
-  }
-
-  return null;
-}
-
-/**
- * Execute action only if pro feature is available.
- *
- * Unlike featureGate.require(), this doesn't throw - it just
- * returns undefined if the feature isn't available.
- *
- * @param {string} featureId - Feature ID to check
- * @param {Function} action - Action to execute if available
- * @returns {*|undefined} Result of action or undefined
- */
-function ifProAvailable(featureId, action) {
-  if (featureGate.isAvailable(featureId)) {
-    return action();
-  }
-  return undefined;
-}
-
-/**
- * Get a user-friendly name for a feature.
- *
- * @param {string} featureId - Feature ID
- * @returns {string} Friendly name
- */
-function getFeatureFriendlyName(featureId) {
-  const all = featureGate.listAll();
-  const feature = all.find((f) => f.id === featureId);
-  return feature ? feature.name : featureId;
-}
-
-/**
- * Log a degradation message to the console.
- *
- * This is used internally when a pro feature is accessed without
- * a license. Messages are non-intrusive and informative.
- *
- * @param {string} featureName - Human-friendly feature name
- * @param {string} _featureId - Feature ID for reference (reserved for logging)
- */
-function logDegradationMessage(featureName, _featureId) {
-  console.log('');
-  console.log(`  ${featureName} requires an active AIOS Pro license.`);
-  console.log('');
-  console.log('  Your data and configurations are preserved.');
-  console.log('');
-  console.log('  Activate: aios pro activate --key <KEY>');
-  console.log('  Purchase: https://synkra.ai/pro');
-  console.log('');
-}
-
-/**
- * Create a degradation-aware wrapper for a pro module.
- *
- * This creates a proxy that catches ProFeatureError and provides
- * a graceful degradation experience.
- *
- * @param {object} proModule - Pro module with methods
- * @param {object} fallbacks - Map of method names to fallback functions
- * @returns {Proxy} Wrapped module
- *
- * @example
- *   const safePremiumSquads = createDegradationWrapper(
- *     PremiumSquads,
- *     {
- *       listTemplates: () => ['basic'], // Fallback to basic templates
- *       exportSquad: () => null,        // No export without license
- *     }
- *   );
- */
-function createDegradationWrapper(proModule, fallbacks = {}) {
-  return new Proxy(proModule, {
-    get(target, prop) {
-      const original = target[prop];
-
-      if (typeof original !== 'function') {
-        return original;
-      }
-
-      return function (...args) {
-        try {
-          return original.apply(target, args);
-        } catch (error) {
-          if (error instanceof ProFeatureError) {
-            if (fallbacks[prop]) {
-              logDegradationMessage(error.friendlyName, error.featureId);
-              return fallbacks[prop](...args);
-            }
-            // Re-throw if no fallback
-            throw error;
-          }
-          // Re-throw non-license errors
-          throw error;
-        }
-      };
-    },
-  });
-}
-
-/**
- * Check if the system is in degraded mode (expired/no license).
- *
- * @returns {boolean} true if pro features are unavailable
- */
-function isInDegradedMode() {
-  const state = featureGate.getLicenseState();
-  return state === 'Expired' || state === 'Not Activated';
-}
-
-/**
- * Get degradation status summary.
- *
- * @returns {{ degraded: boolean, reason: string, action: string }}
- */
-function getDegradationStatus() {
-  const state = featureGate.getLicenseState();
-
-  if (state === 'Active') {
-    return {
-      degraded: false,
-      reason: 'License is active',
-      action: null,
-    };
-  }
-
-  if (state === 'Grace') {
-    return {
-      degraded: false,
-      reason: 'License in grace period - revalidate soon',
-      action: 'aios pro validate',
-    };
-  }
-
-  if (state === 'Expired') {
-    return {
-      degraded: true,
-      reason: 'License has expired',
-      action: 'aios pro activate --key <KEY>',
-    };
-  }
-
-  return {
-    degraded: true,
-    reason: 'No license activated',
-    action: 'aios pro activate --key <KEY>',
-  };
-}
-
-module.exports = {
-  withGracefulDegradation,
-  ifProAvailable,
-  getFeatureFriendlyName,
-  logDegradationMessage,
-  createDegradationWrapper,
-  isInDegradedMode,
-  getDegradationStatus,
-};
+/**
+ * Graceful Degradation Module
+ *
+ * Utilities for handling pro feature unavailability with user-friendly
+ * messages that preserve data and provide clear next steps.
+ *
+ * Per ADR-PRO-003 and AC-8:
+ * - Never show upgrade prompts on core features
+ * - Never delete or corrupt user data
+ * - Always provide actionable next steps
+ * - Keep messages non-intrusive
+ *
+ * @module pro/license/degradation
+ * @see ADR-PRO-003 - Feature Gating & Licensing
+ * @see Story PRO-6 - License Key & Feature Gating System
+ */
+
+'use strict';
+
+const { featureGate } = require('./feature-gate');
+const { ProFeatureError } = require('./errors');
+
+/**
+ * Default degradation message template.
+ * @private Reserved for future customization support.
+ */
+const _DEFAULT_MESSAGE_TEMPLATE = `
+{featureName} requires an active AIOS Pro license.
+
+Your data and configurations are preserved.
+
+Activate: aios pro activate --key <KEY>
+Purchase: https://synkra.ai/pro
+`;
+
+/**
+ * Handle pro feature gracefully - return fallback instead of throwing.
+ *
+ * Use this when you want to provide a degraded experience instead
+ * of completely blocking the feature.
+ *
+ * @param {string} featureId - Feature ID to check
+ * @param {Function} proAction - Function to execute if feature is available
+ * @param {Function} [fallbackAction] - Function to execute if not available
+ * @param {object} [options] - Options
+ * @param {boolean} [options.silent=false] - Don't log degradation message
+ * @returns {*} Result of proAction or fallbackAction
+ */
+function withGracefulDegradation(featureId, proAction, fallbackAction, options = {}) {
+  if (featureGate.isAvailable(featureId)) {
+    return proAction();
+  }
+
+  if (!options.silent) {
+    const featureName = getFeatureFriendlyName(featureId);
+    logDegradationMessage(featureName, featureId);
+  }
+
+  if (typeof fallbackAction === 'function') {
+    return fallbackAction();
+  }
+
+  return null;
+}
+
+/**
+ * Execute action only if pro feature is available.
+ *
+ * Unlike featureGate.require(), this doesn't throw - it just
+ * returns undefined if the feature isn't available.
+ *
+ * @param {string} featureId - Feature ID to check
+ * @param {Function} action - Action to execute if available
+ * @returns {*|undefined} Result of action or undefined
+ */
+function ifProAvailable(featureId, action) {
+  if (featureGate.isAvailable(featureId)) {
+    return action();
+  }
+  return undefined;
+}
+
+/**
+ * Get a user-friendly name for a feature.
+ *
+ * @param {string} featureId - Feature ID
+ * @returns {string} Friendly name
+ */
+function getFeatureFriendlyName(featureId) {
+  const all = featureGate.listAll();
+  const feature = all.find((f) => f.id === featureId);
+  return feature ? feature.name : featureId;
+}
+
+/**
+ * Log a degradation message to the console.
+ *
+ * This is used internally when a pro feature is accessed without
+ * a license. Messages are non-intrusive and informative.
+ *
+ * @param {string} featureName - Human-friendly feature name
+ * @param {string} _featureId - Feature ID for reference (reserved for logging)
+ */
+function logDegradationMessage(featureName, _featureId) {
+  console.log('');
+  console.log(`  ${featureName} requires an active AIOS Pro license.`);
+  console.log('');
+  console.log('  Your data and configurations are preserved.');
+  console.log('');
+  console.log('  Activate: aios pro activate --key <KEY>');
+  console.log('  Purchase: https://synkra.ai/pro');
+  console.log('');
+}
+
+/**
+ * Create a degradation-aware wrapper for a pro module.
+ *
+ * This creates a proxy that catches ProFeatureError and provides
+ * a graceful degradation experience.
+ *
+ * @param {object} proModule - Pro module with methods
+ * @param {object} fallbacks - Map of method names to fallback functions
+ * @returns {Proxy} Wrapped module
+ *
+ * @example
+ *   const safePremiumSquads = createDegradationWrapper(
+ *     PremiumSquads,
+ *     {
+ *       listTemplates: () => ['basic'], // Fallback to basic templates
+ *       exportSquad: () => null,        // No export without license
+ *     }
+ *   );
+ */
+function createDegradationWrapper(proModule, fallbacks = {}) {
+  return new Proxy(proModule, {
+    get(target, prop) {
+      const original = target[prop];
+
+      if (typeof original !== 'function') {
+        return original;
+      }
+
+      return function (...args) {
+        try {
+          return original.apply(target, args);
+        } catch (error) {
+          if (error instanceof ProFeatureError) {
+            if (fallbacks[prop]) {
+              logDegradationMessage(error.friendlyName, error.featureId);
+              return fallbacks[prop](...args);
+            }
+            // Re-throw if no fallback
+            throw error;
+          }
+          // Re-throw non-license errors
+          throw error;
+        }
+      };
+    },
+  });
+}
+
+/**
+ * Check if the system is in degraded mode (expired/no license).
+ *
+ * @returns {boolean} true if pro features are unavailable
+ */
+function isInDegradedMode() {
+  const state = featureGate.getLicenseState();
+  return state === 'Expired' || state === 'Not Activated';
+}
+
+/**
+ * Get degradation status summary.
+ *
+ * @returns {{ degraded: boolean, reason: string, action: string }}
+ */
+function getDegradationStatus() {
+  const state = featureGate.getLicenseState();
+
+  if (state === 'Active') {
+    return {
+      degraded: false,
+      reason: 'License is active',
+      action: null,
+    };
+  }
+
+  if (state === 'Grace') {
+    return {
+      degraded: false,
+      reason: 'License in grace period - revalidate soon',
+      action: 'aios pro validate',
+    };
+  }
+
+  if (state === 'Expired') {
+    return {
+      degraded: true,
+      reason: 'License has expired',
+      action: 'aios pro activate --key <KEY>',
+    };
+  }
+
+  return {
+    degraded: true,
+    reason: 'No license activated',
+    action: 'aios pro activate --key <KEY>',
+  };
+}
+
+module.exports = {
+  withGracefulDegradation,
+  ifProAvailable,
+  getFeatureFriendlyName,
+  logDegradationMessage,
+  createDegradationWrapper,
+  isInDegradedMode,
+  getDegradationStatus,
+};