aios-core 4.2.11 → 4.2.13

package/.aios-core/core/code-intel/registry-syncer.js

@@ -0,0 +1,331 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const yaml = require('js-yaml');
+const { getClient, isCodeIntelAvailable } = require('../code-intel');
+const { RegistryLoader, DEFAULT_REGISTRY_PATH } = require('../ids/registry-loader');
+
+// Role inference from entity path (order matters: more specific patterns first)
+const ROLE_MAP = [
+  ['tasks/', 'task'],
+  ['templates/', 'template'],
+  ['agents/', 'agent'],
+  ['workflows/', 'workflow'],
+  ['scripts/', 'script'],
+  ['/data/', 'config'],
+  ['/core/', 'module'],
+];
+
+/**
+ * Infer entity role from its file path.
+ * @param {string} entityPath - Entity source path
+ * @returns {string} Inferred role
+ */
+function inferRole(entityPath) {
+  if (!entityPath) return 'unknown';
+  const normalized = entityPath.replace(/\\/g, '/');
+  for (const [pattern, role] of ROLE_MAP) {
+    if (normalized.includes(pattern)) return role;
+  }
+  return 'unknown';
+}
+
+/**
+ * RegistrySyncer — Enriches entity registry with code intelligence data.
+ *
+ * Features:
+ * - Batch enrichment of usedBy, dependencies, keywords via code intelligence
+ * - Incremental sync (mtime-based) and full resync (--full flag)
+ * - Atomic write (temp file + rename) to prevent registry corruption
+ * - Graceful fallback when no provider is available
+ */
+class RegistrySyncer {
+  /**
+   * @param {Object} [options]
+   * @param {string} [options.registryPath] - Path to entity-registry.yaml
+   * @param {string} [options.repoRoot] - Repository root for resolving entity paths
+   * @param {Object} [options.client] - Code intel client (for testing injection)
+   * @param {Function} [options.logger] - Logger function (defaults to console.log)
+   */
+  constructor(options = {}) {
+    this._registryPath = options.registryPath || DEFAULT_REGISTRY_PATH;
+    this._repoRoot = options.repoRoot || path.resolve(__dirname, '../../../');
+    this._client = options.client || null;
+    this._logger = options.logger || console.log;
+    this._stats = { processed: 0, skipped: 0, errors: 0, total: 0 };
+  }
+
+  /**
+   * Get code intel client (lazy, allows injection for testing).
+   * @returns {Object|null}
+   */
+  _getClient() {
+    if (this._client) return this._client;
+    return getClient();
+  }
+
+  /**
+   * Sync the entity registry with code intelligence data.
+   * @param {Object} [options]
+   * @param {boolean} [options.full=false] - Force full resync (ignore lastSynced)
+   * @returns {Promise<Object>} Sync stats
+   */
+  async sync(options = {}) {
+    const isFull = options.full === true;
+
+    // AC5: Fallback — check provider availability first
+    if (!this._isProviderAvailable()) {
+      this._logger('[registry-syncer] No code intelligence provider available, skipping enrichment');
+      return { processed: 0, skipped: 0, errors: 0, total: 0, aborted: true };
+    }
+
+    // Load registry
+    const loader = new RegistryLoader(this._registryPath);
+    const registry = loader.load();
+    const entities = registry.entities || {};
+
+    // Flatten all entities for iteration
+    const allEntities = [];
+    for (const [category, categoryEntities] of Object.entries(entities)) {
+      if (!categoryEntities || typeof categoryEntities !== 'object') continue;
+      for (const [entityId, entityData] of Object.entries(categoryEntities)) {
+        allEntities.push({ id: entityId, category, data: entityData });
+      }
+    }
+
+    this._stats = { processed: 0, skipped: 0, errors: 0, total: allEntities.length };
+    this._logger(`[registry-syncer] Starting ${isFull ? 'full' : 'incremental'} sync of ${allEntities.length} entities`);
+
+    // Iterate and enrich
+    for (const entity of allEntities) {
+      try {
+        const wasProcessed = await this.syncEntity(entity, entities, isFull);
+        if (wasProcessed) {
+          this._stats.processed++;
+        } else {
+          this._stats.skipped++;
+        }
+      } catch (error) {
+        this._stats.errors++;
+        this._logger(`[registry-syncer] Error enriching ${entity.id}: ${error.message}`);
+      }
+    }
+
+    // Update metadata
+    registry.metadata = registry.metadata || {};
+    registry.metadata.lastUpdated = new Date().toISOString();
+    registry.metadata.entityCount = allEntities.length;
+
+    // Atomic write
+    this._atomicWrite(this._registryPath, registry);
+
+    this._logger(`[registry-syncer] Sync complete: ${this._stats.processed} processed, ${this._stats.skipped} skipped, ${this._stats.errors} errors`);
+    return { ...this._stats };
+  }
+
+  /**
+   * Enrich a single entity with code intelligence data.
+   * @param {Object} entity - { id, category, data }
+   * @param {Object} entities - Full entities map (for cross-reference)
+   * @param {boolean} isFull - Force full resync
+   * @returns {Promise<boolean>} true if entity was processed, false if skipped
+   */
+  async syncEntity(entity, entities, isFull) {
+    const { id, data } = entity;
+    const sourcePath = data.path;
+
+    // Skip entities without source path
+    if (!sourcePath) {
+      return false;
+    }
+
+    // AC6: Incremental sync — check mtime vs lastSynced
+    if (!isFull) {
+      const shouldSkip = this._shouldSkipIncremental(data);
+      if (shouldSkip) {
+        return false;
+      }
+    }
+
+    const client = this._getClient();
+    const now = new Date().toISOString();
+
+    // AC2: Populate usedBy via findReferences
+    const usedByIds = await this._findUsedBy(client, id, entities);
+    if (usedByIds !== null) {
+      data.usedBy = usedByIds;
+    }
+
+    // AC3: Populate dependencies via analyzeDependencies (JS/TS files only)
+    const deps = await this._findDependencies(client, sourcePath);
+    if (deps !== null) {
+      data.dependencies = deps;
+    }
+
+    // AC4: Populate codeIntelMetadata
+    const callerCount = Array.isArray(data.usedBy) ? data.usedBy.length : 0;
+    data.codeIntelMetadata = {
+      callerCount,
+      role: inferRole(sourcePath),
+      lastSynced: now,
+      provider: client._activeProvider ? client._activeProvider.name : 'unknown',
+    };
+
+    return true;
+  }
+
+  /**
+   * Check if provider is available.
+   * @returns {boolean}
+   * @private
+   */
+  _isProviderAvailable() {
+    if (this._client) {
+      return typeof this._client.findReferences === 'function';
+    }
+    return isCodeIntelAvailable();
+  }
+
+  /**
+   * Check if entity should be skipped in incremental mode.
+   * @param {Object} entityData
+   * @returns {boolean} true if should skip
+   * @private
+   */
+  _shouldSkipIncremental(entityData) {
+    const metadata = entityData.codeIntelMetadata;
+
+    // Entities without lastSynced are always processed (AC6)
+    if (!metadata || !metadata.lastSynced) {
+      return false;
+    }
+
+    // Get file mtime
+    const sourcePath = entityData.path;
+    if (!sourcePath) return true;
+
+    const fullPath = path.resolve(this._repoRoot, sourcePath);
+    try {
+      const stat = fs.statSync(fullPath);
+      const lastSyncedMs = new Date(metadata.lastSynced).getTime();
+      // Skip if file hasn't changed since last sync
+      return stat.mtimeMs <= lastSyncedMs;
+    } catch (_error) {
+      // File doesn't exist — clear metadata and skip
+      this._logger(`[registry-syncer] Warning: source file not found for ${sourcePath}, skipping`);
+      return true;
+    }
+  }
+
+  /**
+   * Find entities that reference this entity (usedBy).
+   * @param {Object} client - Code intel client
+   * @param {string} entityId - Entity ID to search for
+   * @param {Object} entities - Full entities map for cross-referencing
+   * @returns {Promise<string[]|null>} Array of entity IDs or null on failure
+   * @private
+   */
+  async _findUsedBy(client, entityId, entities) {
+    try {
+      const references = await client.findReferences(entityId);
+      if (!references || !Array.isArray(references)) return null;
+
+      // Cross-reference with registry to get entity IDs
+      const usedByIds = [];
+      for (const ref of references) {
+        const refPath = ref.file || ref.path || ref;
+        if (typeof refPath !== 'string') continue;
+
+        const matchedId = this._findEntityByPath(refPath, entities);
+        if (matchedId && matchedId !== entityId) {
+          usedByIds.push(matchedId);
+        }
+      }
+
+      return [...new Set(usedByIds)]; // Deduplicate
+    } catch (_error) {
+      return null;
+    }
+  }
+
+  /**
+   * Find dependencies of a source file.
+   * @param {Object} client - Code intel client
+   * @param {string} sourcePath - Source file path
+   * @returns {Promise<string[]|null>} Array of dependency names or null on failure
+   * @private
+   */
+  async _findDependencies(client, sourcePath) {
+    // Only analyze JS/TS files for import dependencies
+    if (!sourcePath.match(/\.(js|ts|mjs|cjs)$/)) return null;
+
+    try {
+      const fullPath = path.resolve(this._repoRoot, sourcePath);
+      const result = await client.analyzeDependencies(fullPath);
+      if (!result) return null;
+
+      // Filter to internal project dependencies only
+      const deps = [];
+      const items = result.dependencies || result.imports || result;
+      if (!Array.isArray(items)) return null;
+
+      for (const dep of items) {
+        const depPath = dep.path || dep.source || dep;
+        if (typeof depPath !== 'string') continue;
+        // Internal deps: relative paths or project paths (not node_modules)
+        if (depPath.startsWith('.') || depPath.startsWith('/') || depPath.includes('.aios-core')) {
+          deps.push(depPath);
+        }
+      }
+
+      return deps;
+    } catch (_error) {
+      return null;
+    }
+  }
+
+  /**
+   * Find entity ID by file path (cross-reference lookup).
+   * @param {string} filePath - File path from reference
+   * @param {Object} entities - Full entities map
+   * @returns {string|null} Entity ID or null
+   * @private
+   */
+  _findEntityByPath(filePath, entities) {
+    const normalized = filePath.replace(/\\/g, '/');
+    for (const [_category, categoryEntities] of Object.entries(entities)) {
+      if (!categoryEntities || typeof categoryEntities !== 'object') continue;
+      for (const [entityId, entityData] of Object.entries(categoryEntities)) {
+        if (entityData.path && normalized.includes(entityData.path.replace(/\\/g, '/'))) {
+          return entityId;
+        }
+      }
+    }
+    return null;
+  }
+
+  /**
+   * Atomic write: write to temp file then rename.
+   * Prevents partial corruption if process crashes mid-write.
+   * @param {string} registryPath - Target path
+   * @param {Object} registry - Registry data to write
+   * @private
+   */
+  _atomicWrite(registryPath, registry) {
+    const tmpPath = registryPath + '.tmp';
+    const content = yaml.dump(registry, { lineWidth: 120, noRefs: true });
+    fs.writeFileSync(tmpPath, content, 'utf8');
+    fs.renameSync(tmpPath, registryPath);
+  }
+
+  /**
+   * Get sync statistics from last run.
+   * @returns {Object}
+   */
+  getStats() {
+    return { ...this._stats };
+  }
+}
+
+module.exports = { RegistrySyncer, inferRole, ROLE_MAP };

package/.aios-core/core/ids/registry-loader.js

@@ -232,6 +232,35 @@ class RegistryLoader {
     return entity;
   }
 
+  /**
+   * Get entity with code intelligence metadata (Story NOG-2).
+   * @param {string} entityId - Entity ID
+   * @returns {Object|null} Entity with codeIntelMetadata or null
+   */
+  getEntityWithIntel(entityId) {
+    const entity = this._findById(entityId);
+    if (!entity) return null;
+    return {
+      ...entity,
+      codeIntelMetadata: entity.codeIntelMetadata || null,
+    };
+  }
+
+  /**
+   * Query entities by keywords with optional role filter (Story NOG-2).
+   * @param {string[]} keywords - Keywords to search
+   * @param {Object} [options]
+   * @param {string} [options.role] - Filter by codeIntelMetadata.role
+   * @returns {Object[]} Matching entities
+   */
+  findByKeyword(keywords, options = {}) {
+    const results = this.queryByKeywords(keywords);
+    if (!options.role) return results;
+    return results.filter(
+      (e) => e.codeIntelMetadata && e.codeIntelMetadata.role === options.role,
+    );
+  }
+
   /**
    * Get registry metadata.
    */

package/.aios-core/core/synapse/runtime/hook-runtime.js

@@ -6,7 +6,7 @@ const fs = require('fs');
 /**
  * Resolve runtime dependencies for Synapse hook execution.
  *
- * @param {{cwd?: string, sessionId?: string}} input
+ * @param {{cwd?: string, session_id?: string, sessionId?: string}} input
  * @returns {{
  *   engine: import('../engine').SynapseEngine,
  *   session: Object
@@ -14,7 +14,7 @@ const fs = require('fs');
  */
 function resolveHookRuntime(input) {
   const cwd = input && input.cwd;
-  const sessionId = input && input.sessionId;
+  const sessionId = input && (input.session_id || input.sessionId);
   if (!cwd || typeof cwd !== 'string') return null;
 
   const synapsePath = path.join(cwd, '.synapse');

package/.aios-core/data/entity-registry.yaml

@@ -1,7 +1,7 @@
 metadata:
   version: 1.0.0
-  lastUpdated: '2026-02-16T04:49:07.416Z'
-  entityCount: 506
+  lastUpdated: '2026-02-16T20:22:35.905Z'
+  entityCount: 508
   checksumAlgorithm: sha256
 entities:
   tasks:
@@ -3909,6 +3909,24 @@ entities:
         extensionPoints: []
       checksum: sha256:f7a0bb8fed5663c88ad691b8871fdf7a861b6a7c02599f0c2db3eb9393d353c8
       lastVerified: '2026-02-16T01:21:26.585Z'
+    sync-registry-intel:
+      path: .aios-core/development/tasks/sync-registry-intel.md
+      type: task
+      purpose: 'Task: Sync Registry Intel'
+      keywords:
+        - sync
+        - registry
+        - intel
+        - 'task:'
+      usedBy: []
+      dependencies:
+        - registry-syncer
+      adaptability:
+        score: 0.8
+        constraints: []
+        extensionPoints: []
+      checksum: sha256:0e69435307db814563823896e7ba9b29a4a9c10d90f6dedec5cb7a6d6f7ba936
+      lastVerified: '2026-02-16T20:19:27.659Z'
   templates:
     activation-instructions-inline-greeting:
       path: .aios-core/product/templates/activation-instructions-inline-greeting.yaml
@@ -5979,6 +5997,24 @@ entities:
       checksum: sha256:310884d94b81be976a346987822306a16a73ba812c08c3b805f4a03216ffef38
       lastVerified: '2026-02-15T19:28:17.743Z'
   modules:
+    registry-syncer:
+      path: .aios-core/core/code-intel/registry-syncer.js
+      type: module
+      purpose: Entity at .aios-core\core\code-intel\registry-syncer.js
+      keywords:
+        - registry
+        - syncer
+      usedBy:
+        - sync-registry-intel
+      dependencies:
+        - code-intel
+        - registry-loader
+      adaptability:
+        score: 0.4
+        constraints: []
+        extensionPoints: []
+      checksum: sha256:011318e2ba5c250daae2e565a8e8fb1570c99b7569e631276a2bf46e887fc514
+      lastVerified: '2026-02-16T20:19:27.658Z'
     index.esm:
       path: .aios-core/core/index.esm.js
       type: module
@@ -6562,6 +6598,7 @@ entities:
         - registry
         - loader
       usedBy:
+        - registry-syncer
         - index
         - framework-governor
       dependencies: []
@@ -6569,8 +6606,8 @@ entities:
         score: 0.4
         constraints: []
         extensionPoints: []
-      checksum: sha256:7fb2edb5a605765757d5ca7201025a7ff4cf7bfa9b18f35a311e2b658532a865
-      lastVerified: '2026-02-08T13:33:24.336Z'
+      checksum: sha256:88c67bace0a5ab6a14cb1d096e3f9cab9f5edc0dd8377788e27b692ccefbd487
+      lastVerified: '2026-02-16T20:19:27.659Z'
     manifest-generator:
       path: .aios-core/core/manifest/manifest-generator.js
       type: module
@@ -8536,7 +8573,7 @@ entities:
     hook-runtime:
       path: .aios-core/core/synapse/runtime/hook-runtime.js
       type: module
-      purpose: Entity at .aios-core/core/synapse/runtime/hook-runtime.js
+      purpose: Entity at .aios-core\core\synapse\runtime\hook-runtime.js
       keywords:
         - hook
         - runtime
@@ -8546,8 +8583,8 @@ entities:
         score: 0.4
         constraints: []
         extensionPoints: []
-      checksum: sha256:441bdee8bbfea448f4e20eeb0ff1277352b33e79c9cf6cde9012c6d150fee08b
-      lastVerified: '2026-02-15T19:28:17.742Z'
+      checksum: sha256:2fdd54f36a1bbb4ba05d6577c607cf2d6711dcf9a06284fc935676189a461fa2
+      lastVerified: '2026-02-16T20:22:35.904Z'
     migration-config:
       path: .aios-core/core/migration/migration-config.yaml
       type: module
@@ -8819,8 +8856,8 @@ entities:
         score: 0.3
         constraints: []
         extensionPoints: []
-      checksum: sha256:538fff4398eba7c2492b446fce3a1d9115e5f1c6f494f0c3b45a991526c2295a
-      lastVerified: '2026-02-10T16:04:17.827Z'
+      checksum: sha256:092161d318ab523b8cd5c3dc8a2bd19accc23ab7fa731d5b4fa11c5afb8b5a08
+      lastVerified: '2026-02-16T19:52:18.846Z'
     analyst:
       path: .aios-core/development/agents/analyst.md
       type: agent

package/.aios-core/data/registry-update-log.jsonl

@@ -177,3 +177,15 @@
 {"timestamp":"2026-02-16T01:46:56.302Z","action":"change","path":".aios-core/core/code-intel/code-intel-enricher.js","trigger":"watcher"}
 {"timestamp":"2026-02-16T01:46:56.302Z","action":"change","path":".aios-core/core/code-intel/index.js","trigger":"watcher"}
 {"timestamp":"2026-02-16T01:46:56.303Z","action":"change","path":".aios-core/core/code-intel/providers/code-graph-provider.js","trigger":"watcher"}
+{"timestamp":"2026-02-16T19:52:18.842Z","action":"add","path":".aios-core/core/code-intel/registry-syncer.js","trigger":"watcher"}
+{"timestamp":"2026-02-16T19:52:18.845Z","action":"change","path":".aios-core/core/ids/registry-loader.js","trigger":"watcher"}
+{"timestamp":"2026-02-16T19:52:18.846Z","action":"change","path":".aios-core/development/agents/aios-master.md","trigger":"watcher"}
+{"timestamp":"2026-02-16T19:52:18.847Z","action":"add","path":".aios-core/development/tasks/sync-registry-intel.md","trigger":"watcher"}
+{"timestamp":"2026-02-16T20:19:21.429Z","action":"change","path":".aios-core/core/code-intel/registry-syncer.js","trigger":"watcher"}
+{"timestamp":"2026-02-16T20:19:21.430Z","action":"change","path":".aios-core/core/ids/registry-loader.js","trigger":"watcher"}
+{"timestamp":"2026-02-16T20:19:21.431Z","action":"change","path":".aios-core/development/tasks/sync-registry-intel.md","trigger":"watcher"}
+{"timestamp":"2026-02-16T20:19:27.658Z","action":"change","path":".aios-core/core/code-intel/registry-syncer.js","trigger":"watcher"}
+{"timestamp":"2026-02-16T20:19:27.659Z","action":"change","path":".aios-core/core/ids/registry-loader.js","trigger":"watcher"}
+{"timestamp":"2026-02-16T20:19:27.659Z","action":"change","path":".aios-core/development/tasks/sync-registry-intel.md","trigger":"watcher"}
+{"timestamp":"2026-02-16T20:22:31.161Z","action":"change","path":".aios-core/core/synapse/runtime/hook-runtime.js","trigger":"watcher"}
+{"timestamp":"2026-02-16T20:22:35.904Z","action":"change","path":".aios-core/core/synapse/runtime/hook-runtime.js","trigger":"watcher"}

package/.aios-core/development/agents/aios-master.md

@@ -217,6 +217,11 @@ commands:
   - name: ids stats
     description: 'Registry statistics (entity count by type, categories, health score)'
 
+  # Code Intelligence — Registry Enrichment (Story NOG-2)
+  - name: sync-registry-intel
+    args: '[--full]'
+    description: 'Enrich entity registry with code intelligence data (usedBy, dependencies, codeIntelMetadata). Use --full to force full resync.'
+
 # IDS Pre-Action Hooks (Story IDS-7)
 # These hooks run BEFORE *create and *modify commands as advisory (non-blocking) steps.
 ids_hooks:
@@ -282,6 +287,7 @@ dependencies:
     - run-workflow.md
     - run-workflow-engine.md
     - ids-governor.md
+    - sync-registry-intel.md
   # Delegated tasks (Story 6.1.2.3):
   #   brownfield-create-epic.md → @pm
   #   brownfield-create-story.md → @pm

package/.aios-core/development/tasks/sync-registry-intel.md

@@ -0,0 +1,79 @@
+# Task: Sync Registry Intel
+
+## Metadata
+- **Task ID:** sync-registry-intel
+- **Agent:** @aios-master
+- **Story:** NOG-2
+- **Type:** Command Task
+- **Elicit:** false
+
+---
+
+## Description
+
+Enrich the entity registry with code intelligence data (usedBy, dependencies, codeIntelMetadata) using the configured code intelligence provider.
+
+---
+
+## Prerequisites
+
+- Code intelligence provider available (NOG-1 complete)
+- Entity registry exists at `.aios-core/data/entity-registry.yaml`
+
+---
+
+## Execution Steps
+
+### Step 1: Parse Arguments
+
+```text
+Arguments:
+  --full    Force full resync (reprocess all entities regardless of lastSynced)
+
+Default: Incremental sync (only entities whose source file mtime > lastSynced)
+```
+
+### Step 2: Execute Sync
+
+```javascript
+const { RegistrySyncer } = require('.aios-core/core/code-intel/registry-syncer');
+
+const syncer = new RegistrySyncer();
+const stats = await syncer.sync({ full: hasFullFlag });
+```
+
+### Step 3: Report Results
+
+Display sync statistics:
+- Total entities in registry
+- Entities processed (enriched)
+- Entities skipped (unchanged)
+- Errors encountered
+
+### Step 4: Handle Fallback
+
+If no code intelligence provider is available:
+- Display: "No code intelligence provider available, skipping enrichment"
+- Exit gracefully with zero modifications
+
+---
+
+## Output
+
+```yaml
+success: true
+stats:
+  total: 506
+  processed: 42
+  skipped: 464
+  errors: 0
+```
+
+---
+
+## Error Handling
+
+- **No provider:** Graceful exit, zero modifications
+- **Registry not found:** Error message, exit
+- **Partial failure:** Continue batch, log errors, report count
+- **Write failure:** Atomic write prevents corruption (temp + rename)

package/.aios-core/docs/standards/AIOS-COLOR-PALETTE-QUICK-REFERENCE.md

@@ -68,7 +68,7 @@ console.log(status.tip('Press Enter to continue'));
 
 ### Welcome Screen
 ```javascript
-console.log(headings.h1('🎉 Welcome to AIOS v4.0.4 Installer!'));
+console.log(headings.h1('🎉 Welcome to AIOS v4.2 Installer!'));
 console.log(colors.info('Let\'s configure your project...\n'));
 ```
 

package/.aios-core/docs/standards/AIOS-COLOR-PALETTE-V2.1.md

@@ -1,4 +1,4 @@
-# AIOS Color Palette v4.0.4
+# AIOS Color Palette v4.2
 
 **Version:** 2.1.0  
 **Created:** 2025-01-20  
@@ -66,7 +66,7 @@ For special effects, animations, and branding moments:
 ```javascript
 const chalk = require('chalk');
 
-// AIOS Color Palette v4.0.4
+// AIOS Color Palette v4.2
 const colors = {
   // Core Brand Colors
   primary: chalk.hex('#8B5CF6'),      // ClickUp-inspired purple
@@ -162,7 +162,7 @@ module.exports = {
 - Example: Welcome screens, major section headers
 
 ```javascript
-console.log(colors.brandPrimary('🎉 AIOS v4.0.4 Installer'));
+console.log(colors.brandPrimary('🎉 AIOS v4.2 Installer'));
 ```
 
 **Level 2: Primary Content**
@@ -193,7 +193,7 @@ console.log(colors.info('💡 Tip: You can change this later'));
 **Installer & Wizards:**
 ```javascript
 // Welcome
-console.log(colors.brandPrimary('\n🎉 Welcome to AIOS v4.0.4\n'));
+console.log(colors.brandPrimary('\n🎉 Welcome to AIOS v4.2\n'));
 console.log(colors.info('Let\'s get your project set up...\n'));
 
 // Questions

package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md

@@ -1,4 +1,4 @@
-# AIOS Framework - Livro de Ouro v4.0.4 (Complete)
+# AIOS Framework - Livro de Ouro v4.2 (Complete)
 
 ## O Sistema Operacional Definitivo para Orquestração de Agentes IA
 
@@ -17,7 +17,7 @@
 
 ## 📣 IMPORTANTE: Sobre Este Documento
 
-Este documento é a **versão consolidada v4.0.4** que incorpora todas as mudanças dos Sprints 2-5:
+Este documento é a **versão consolidada v4.2** que incorpora todas as mudanças dos Sprints 2-5:
 
 - ✅ **Modular Architecture** (4 módulos: core, development, product, infrastructure)
 - ✅ **Squad System** (nova terminologia, substituindo "Squad")
@@ -34,7 +34,7 @@ Este documento é a **versão consolidada v4.0.4** que incorpora todas as mudan
 
 ---
 
-## 📜 Open Source vs. Serviço - Business Model v4.0.4
+## 📜 Open Source vs. Serviço - Business Model v4.2
 
 ### O Que Mudou de v2.0 para v4.0.4
 
@@ -106,7 +106,7 @@ Este documento é a **versão consolidada v4.0.4** que incorpora todas as mudan
 | LangChain     | ✅ Complete              | ❌ None (commodity)            |
 | CrewAI        | ✅ Complete              | ❌ None (commodity)            |
 | AutoGen       | ✅ Complete              | ❌ None (commodity)            |
-| **AIOS v4.0.4** | ✅ **Complete**          | ✅ **Clones (DNA Mental™)** ⭐ |
+| **AIOS v4.2** | ✅ **Complete**          | ✅ **Clones (DNA Mental™)** ⭐ |
 
 **Analogia:** Linux é open source, mas Red Hat Enterprise Linux adiciona suporte e otimizações. Ambos são Linux, mas o valor agregado varia. AIOS funciona igual.
 
@@ -119,7 +119,7 @@ Este não é um documento para ser lido do início ao fim. É um **sistema de ap
 - 🚀 **Layer 0: DISCOVERY** - Descubra seu caminho (5 min)
 - 🎯 **Layer 1: UNDERSTANDING** - 5 essays que ensinam o modelo mental (75 min)
 - 🎨 **Layer 2: COMPONENT LIBRARY** - Catálogo completo de componentes
-- 📋 **Layer 3: USAGE GUIDE** - Como usar AIOS v4.0.4 no seu contexto
+- 📋 **Layer 3: USAGE GUIDE** - Como usar AIOS v4.2 no seu contexto
 - 📚 **Layer 4: COMPLETE REFERENCE** - Especificação técnica completa
 - 🔄 **META: EVOLUTION** - Como contribuir e evoluir o framework
 
@@ -129,7 +129,7 @@ Este não é um documento para ser lido do início ao fim. É um **sistema de ap
 
 # 🚀 LAYER 0: DISCOVERY ROUTER
 
-## Bem-vindo ao AIOS v4.0.4 - Vamos Encontrar Seu Caminho
+## Bem-vindo ao AIOS v4.2 - Vamos Encontrar Seu Caminho
 
 ### Learning Tracks Disponíveis
 
@@ -192,7 +192,7 @@ AIOS fornece **orquestração estruturada**:
 
 ---
 
-## Essay 3: Business Model v4.0.4
+## Essay 3: Business Model v4.2
 
 ### Por Que Workers São Open-Source Agora?
 
@@ -212,7 +212,7 @@ AIOS fornece **orquestração estruturada**:
 
 ## Essay 4: Agent System
 
-### Os 11 Agents v4.0.4
+### Os 11 Agents v4.2
 
 | Agent     | ID              | Archetype    | Responsabilidade        |
 | --------- | --------------- | ------------ | ----------------------- |
@@ -288,7 +288,7 @@ responsavel_type: Clone    # Year 2
 
 # 🎨 LAYER 2: COMPONENT LIBRARY
 
-## Arquitetura Modular v4.0.4
+## Arquitetura Modular v4.2
 
 ### Os 4 Módulos
 
@@ -342,7 +342,7 @@ Regras:
 
 ---
 
-## Squad System (Novo em v4.0.4)
+## Squad System (Novo em v4.2)
 
 ### Terminologia
 
@@ -600,7 +600,7 @@ npm install @aios/mcp-presets
 
 # 📋 LAYER 3: USAGE GUIDE
 
-## Quick Start v4.0.4
+## Quick Start v4.2
 
 ### Installation (5 minutes)
 
@@ -700,7 +700,7 @@ $ aios workflow brownfield-integration --target=./existing-project
 
 # 📚 LAYER 4: COMPLETE REFERENCE
 
-## Source Tree v4.0.4 (Current)
+## Source Tree v4.2 (Current)
 
 ```
 @synkra/aios-core/                        # Root project
@@ -785,7 +785,7 @@ $ aios workflow brownfield-integration --target=./existing-project
 
 ### Installation
 
-| Metric          | v2.0       | v4.0.4      | Improvement     |
+| Metric          | v2.0       | v4.2      | Improvement     |
 | --------------- | ---------- | --------- | --------------- |
 | Time to install | 2-4 hours  | 5 minutes | **96% faster**  |
 | Steps required  | 15+ manual | 1 command | **93% simpler** |
@@ -793,7 +793,7 @@ $ aios workflow brownfield-integration --target=./existing-project
 
 ### Development Speed
 
-| Metric                | v2.0     | v4.0.4       | Improvement       |
+| Metric                | v2.0     | v4.2       | Improvement       |
 | --------------------- | -------- | ---------- | ----------------- |
 | Find reusable Worker  | N/A      | 30 seconds | **∞**             |
 | Quality issues caught | 20%      | 80%        | **4x**            |
@@ -801,7 +801,7 @@ $ aios workflow brownfield-integration --target=./existing-project
 
 ### Quality
 
-| Metric              | v2.0       | v4.0.4          |
+| Metric              | v2.0       | v4.2          |
 | ------------------- | ---------- | ------------- |
 | Quality Gate Layers | 1 (manual) | 3 (automated) |
 | Auto-caught issues  | 0%         | 80%           |

package/.aios-core/docs/standards/OPEN-SOURCE-VS-SERVICE-DIFFERENCES.md

@@ -3,7 +3,7 @@
 **Version:** 2.1.0
 **Date:** 2025-12-09
 **Purpose:** Document differences between AIOS open-source and AIOS service implementations
-**Status:** ⚠️ Needs Review - Updated for v4.0.4 Multi-Repo Strategy
+**Status:** ⚠️ Needs Review - Updated for v4.2 Multi-Repo Strategy
 
 ---
 
@@ -17,7 +17,7 @@ This document clarifies which features apply to which context.
 
 ---
 
-## Multi-Repo Strategy (v4.0.4)
+## Multi-Repo Strategy (v4.2)
 
 ### Repository Organization
 
@@ -489,7 +489,7 @@ function validateTask(task) {
 
 ## Related Documents
 
-- [AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md](./AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md) - Complete v4.0.4 framework guide
+- [AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md](./AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md) - Complete v4.2 framework guide
 - [STANDARDS-INDEX.md](./STANDARDS-INDEX.md) - Standards navigation
 - [TASK-FORMAT-SPECIFICATION-V1.md](./TASK-FORMAT-SPECIFICATION-V1.md) - Complete task format spec
 - [AGENT-PERSONALIZATION-STANDARD-V1.md](./AGENT-PERSONALIZATION-STANDARD-V1.md) - Personality guidelines
@@ -508,4 +508,4 @@ function validateTask(task) {
 
 **Last Updated:** 2025-12-09
 **Version:** 2.1.0
-**Applies to:** AIOS v4.0.4+
+**Applies to:** AIOS v4.2+

package/.aios-core/docs/standards/QUALITY-GATES-SPECIFICATION.md

@@ -1,4 +1,4 @@
-# Quality Gates Specification v4.0.4
+# Quality Gates Specification v4.2
 
 **Version:** 2.1.0
 **Last Updated:** 2025-12-09
@@ -481,7 +481,7 @@ reviews:
         Verify:
         - Terminology uses 'Squad' not 'Squad'
         - All internal links work
-        - Version numbers are v4.0.4
+        - Version numbers are v4.2
 
     - path: "squads/**"
       instructions: |
@@ -512,7 +512,7 @@ reviews:
 | Issues escaping to production | ~15% |
 | Developer context switches | High |
 
-### After Quality Gates (v4.0.4)
+### After Quality Gates (v4.2)
 
 | Metric | Value | Improvement |
 |--------|-------|-------------|

package/.aios-core/docs/standards/STANDARDS-INDEX.md

@@ -23,11 +23,11 @@
 
 ## 📚 Standards by Category
 
-### Core Framework Standards (Current v4.0.4)
+### Core Framework Standards (Current v4.2)
 
 | Document | Description | Status | Version |
 |----------|-------------|--------|---------|
-| [AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md](./AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md) | **Complete v4.0.4 framework guide** | ✅ Current | 2.1.0 |
+| [AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md](./AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md) | **Complete v4.2 framework guide** | ✅ Current | 2.1.0 |
 | [QUALITY-GATES-SPECIFICATION.md](./QUALITY-GATES-SPECIFICATION.md) | 3-layer quality gates system | ✅ Current | 2.1.0 |
 | [STORY-TEMPLATE-V2-SPECIFICATION.md](./STORY-TEMPLATE-V2-SPECIFICATION.md) | Story template v2.0 specification | ✅ Current | 2.0.0 |
 | [TASK-FORMAT-SPECIFICATION-V1.md](./TASK-FORMAT-SPECIFICATION-V1.md) | Task-First architecture format | ✅ Current | 1.0.0 |
@@ -60,13 +60,13 @@
 
 ---
 
-## 🔄 What Changed in v4.0.4
+## 🔄 What Changed in v4.2
 
 ### New Documents Created
 
 | Document | Purpose |
 |----------|---------|
-| AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md | Consolidated v4.0.4 documentation |
+| AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md | Consolidated v4.2 documentation |
 | QUALITY-GATES-SPECIFICATION.md | 3-layer quality gates |
 | STORY-TEMPLATE-V2-SPECIFICATION.md | Story template v2.0 |
 | STANDARDS-INDEX.md | This navigation document |
@@ -101,8 +101,8 @@
 .aios-core/docs/standards/
 ├── STANDARDS-INDEX.md                     # This file - navigation
 │
-├── Current v4.0.4 Standards
-│   ├── AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md  # Complete v4.0.4 guide
+├── Current v4.2 Standards
+│   ├── AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md  # Complete v4.2 guide
 │   ├── QUALITY-GATES-SPECIFICATION.md       # Quality gates
 │   ├── STORY-TEMPLATE-V2-SPECIFICATION.md   # Story template
 │   ├── TASK-FORMAT-SPECIFICATION-V1.md      # Task format
@@ -156,7 +156,7 @@ Located in `docs/`:
 
 | Status | Meaning | Action |
 |--------|---------|--------|
-| ✅ Current | Up-to-date with v4.0.4 | Use as reference |
+| ✅ Current | Up-to-date with v4.2 | Use as reference |
 | ⚠️ Deprecated | Superseded by newer document | Refer to replacement |
 | ⚠️ Needs Update | Content outdated | Update planned |
 | 📦 Archive Candidate | Should be archived | Move to _archived/ |
@@ -201,7 +201,7 @@ grep -r "v2.0" .aios-core/docs/standards --include="*.md"
 
 | Date | Version | Changes | Author |
 |------|---------|---------|--------|
-| 2025-12-09 | 2.1.0 | Initial STANDARDS-INDEX creation for v4.0.4 | @dev (Dex) |
+| 2025-12-09 | 2.1.0 | Initial STANDARDS-INDEX creation for v4.2 | @dev (Dex) |
 
 ---
 

package/.aios-core/install-manifest.yaml

@@ -7,10 +7,10 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 4.2.11
-generated_at: "2026-02-16T17:42:52.251Z"
+version: 4.2.13
+generated_at: "2026-02-16T21:09:06.284Z"
 generator: scripts/generate-install-manifest.js
-file_count: 1004
+file_count: 1006
 files:
   - path: cli/commands/config/index.js
     hash: sha256:ebcad2ce3807eda29dcddff76d7a95ddc9b7fa160df21fd608f94b802237e862
@@ -200,6 +200,10 @@ files:
     hash: sha256:7d16aa715155e9c077720a6bffc7e9e5411b65f821b6b4e5e909f226796e7acb
     type: core
     size: 3079
+  - path: core/code-intel/registry-syncer.js
+    hash: sha256:011318e2ba5c250daae2e565a8e8fb1570c99b7569e631276a2bf46e887fc514
+    type: core
+    size: 10891
   - path: core/config/config-cache.js
     hash: sha256:527a788cbe650aa6b13d1101ebc16419489bfef20b2ee93042f6eb6a51e898e9
     type: core
@@ -565,9 +569,9 @@ files:
     type: core
     size: 26179
   - path: core/ids/registry-loader.js
-    hash: sha256:e98cee3af79091e972b379786345d15ae451afbcba968c10fb3da9bf981bb363
+    hash: sha256:88c67bace0a5ab6a14cb1d096e3f9cab9f5edc0dd8377788e27b692ccefbd487
     type: core
-    size: 7170
+    size: 8096
   - path: core/ids/registry-updater.js
     hash: sha256:6d87ec21d32acff1ba9b9d13025118c106ce6db59c1339c3a6ef4b2a02fd7f52
     type: core
@@ -985,9 +989,9 @@ files:
     type: core
     size: 16418
   - path: core/synapse/runtime/hook-runtime.js
-    hash: sha256:441bdee8bbfea448f4e20eeb0ff1277352b33e79c9cf6cde9012c6d150fee08b
+    hash: sha256:2fdd54f36a1bbb4ba05d6577c607cf2d6711dcf9a06284fc935676189a461fa2
     type: core
-    size: 1529
+    size: 1572
   - path: core/synapse/scripts/generate-constitution.js
     hash: sha256:65405d3e4ee080d19a25fb8967e159360a289e773c15253a351ee163b469e877
     type: script
@@ -1037,9 +1041,9 @@ files:
     type: data
     size: 34251
   - path: data/entity-registry.yaml
-    hash: sha256:7b9bb3a5354107f9ec29105b5948d5c538e2a3b19d49fa42e2e785e4a767c38b
+    hash: sha256:fefd5d2eba3de2c49a3dbf6219cda466062b05a05b894dc2f89886b1f937bd21
     type: data
-    size: 289966
+    size: 291072
   - path: data/learned-patterns.yaml
     hash: sha256:24ac0b160615583a0ff783d3da8af80b7f94191575d6db2054ec8e10a3f945dc
     type: data
@@ -1085,9 +1089,9 @@ files:
     type: development
     size: 5012
   - path: development/agents/aios-master.md
-    hash: sha256:538fff4398eba7c2492b446fce3a1d9115e5f1c6f494f0c3b45a991526c2295a
+    hash: sha256:092161d318ab523b8cd5c3dc8a2bd19accc23ab7fa731d5b4fa11c5afb8b5a08
     type: agent
-    size: 17534
+    size: 17821
   - path: development/agents/analyst.md
     hash: sha256:470384d9ee05d1373fe7519602f135179a88a35895252277823b35339dafd2a3
     type: agent
@@ -2180,6 +2184,10 @@ files:
     hash: sha256:caa2077e7a5bbbba9269b04e878b7772a71422ed6fd138447fe5cfb7345f96fb
     type: task
     size: 23362
+  - path: development/tasks/sync-registry-intel.md
+    hash: sha256:0e69435307db814563823896e7ba9b29a4a9c10d90f6dedec5cb7a6d6f7ba936
+    type: task
+    size: 1664
   - path: development/tasks/tailwind-upgrade.md
     hash: sha256:c369df0a28d8be7f0092405ecaed669a40075841427337990e2346b8c1d43c3a
     type: task
@@ -2429,29 +2437,29 @@ files:
     type: documentation
     size: 16023
   - path: docs/standards/AIOS-COLOR-PALETTE-QUICK-REFERENCE.md
-    hash: sha256:3bf52aa948c6f5a79a43ab6cd4170b5ab476737e88813176d4d7a33f4a659edb
+    hash: sha256:b521992d1f6a17b7b624ddbb9e78cb54b9efce62ca78d36b425a3f74f55e5c07
     type: documentation
-    size: 4095
+    size: 4093
   - path: docs/standards/AIOS-COLOR-PALETTE-V2.1.md
-    hash: sha256:08ddcacf88f3cf5251108de5e30429cb93ba5dcaf5bd0ac88bbcacf6a4b06667
+    hash: sha256:075760cd1734967e8af366fd6824cb3cd37cfae850d18340451d8c4df9f35889
     type: documentation
-    size: 9482
+    size: 9474
   - path: docs/standards/EXECUTOR-DECISION-TREE.md
     hash: sha256:106af2a8bc009c129618fbd501e68c6927862dbbc2e28d1a5b67be9b5fc2bb5b
     type: documentation
     size: 19268
   - path: docs/standards/OPEN-SOURCE-VS-SERVICE-DIFFERENCES.md
-    hash: sha256:3cb48a85705305a5a70ec35cd110570a5cb71056d151ca226367e83d4a67e0f7
+    hash: sha256:2411b48a14bc11ef78684cd3fb488165d13406832e0b1bc3fae0a15bf1714f3a
     type: documentation
-    size: 16398
+    size: 16390
   - path: docs/standards/QUALITY-GATES-SPECIFICATION.md
-    hash: sha256:3c9b4ed28b5cf1ec0116d5a0095493beb261f1fe7dbef6ac6dc5e8651660e118
+    hash: sha256:05df49e8ae8909fd583cf131bc2190a1709ba0249b761bf5d51c2e4bedbb4aeb
     type: documentation
-    size: 19752
+    size: 19746
   - path: docs/standards/STANDARDS-INDEX.md
-    hash: sha256:d099262e71e64bfe8e723203c64f26cbd9645b6e7862d33915151bc2ec6ab4c2
+    hash: sha256:f9c22b0fb6ac3240c44d71a44deeae9ef3a3b873ccae9bf2401f08edec61382a
     type: documentation
-    size: 8385
+    size: 8369
   - path: docs/standards/STORY-TEMPLATE-V2-SPECIFICATION.md
     hash: sha256:31cf0854013c05a39020406bcdd8937f48ab7fe85c17274c8a077bdb3c45131f
     type: documentation

package/README.md

@@ -36,7 +36,7 @@ npx aios-core install
 Definição de first-value (binária): ativação de agente + greeting válido + comando inicial com output útil em <= 10 minutos.
 
 
-## Compatibilidade de Hooks por IDE (Realidade AIOS 4.0.4)
+## Compatibilidade de Hooks por IDE (Realidade AIOS 4.2)
 
 Muitos recursos avançados do AIOS dependem de eventos de ciclo de vida (hooks). A tabela abaixo mostra a paridade real entre IDEs/plataformas:
 
@@ -227,7 +227,7 @@ O Synkra AIOS inclui regras pré-configuradas para IDE para melhorar sua experi
 
 #### Para Codex CLI:
 
-- ✅ Integração de primeira classe no AIOS 4.0.4 (pipeline de ativação e greeting compartilhado)
+- ✅ Integração de primeira classe no AIOS 4.2 (pipeline de ativação e greeting compartilhado)
 - ✅ Já configurado! O arquivo `AGENTS.md` na raiz é carregado automaticamente
 - Opcional: sincronize agentes auxiliares com `npm run sync:ide:codex`
 - Recomendado neste repositório: gerar e versionar skills locais com `npm run sync:skills:codex`
@@ -376,7 +376,7 @@ $ npx aios-core doctor
 ✔ npm version: 10.2.3
 ✔ Git installed: version 2.43.0
 ✔ GitHub CLI: gh 2.40.1
-✔ Synkra AIOS: v1.0.0
+✔ Synkra AIOS: v4.2.11
 
 Configuration:
 ✔ .aios-core/ directory exists
@@ -496,7 +496,7 @@ O Synkra AIOS vem com 11 agentes especializados:
 
 ## 🤖 AIOS Autonomous Development Engine (ADE)
 
-O Synkra AIOS v1.0.0 introduz o **Autonomous Development Engine (ADE)** - um sistema completo para desenvolvimento autônomo que transforma requisitos em código funcional.
+O Synkra AIOS introduz o **Autonomous Development Engine (ADE)** - um sistema completo para desenvolvimento autônomo que transforma requisitos em código funcional.
 
 ### 🎯 O Que é o ADE?
 

package/package.json

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

package/packages/installer/src/wizard/index.js

@@ -719,23 +719,49 @@ async function runWizard(options = {}) {
           answers.proInstalled = proResult.success;
           answers.proResult = proResult;
         } else if (!isCI && !options.quiet) {
-          // Interactive mode: ask if user has a Pro license
-          const { hasPro } = await inquirer.prompt([
+          // Interactive mode: ask which edition to install
+          const { edition } = await inquirer.prompt([
             {
-              type: 'confirm',
-              name: 'hasPro',
-              message: colors.primary('Do you have an AIOS Pro license key?'),
-              default: false,
+              type: 'list',
+              name: 'edition',
+              message: colors.primary('Which edition do you want to install?'),
+              choices: [
+                {
+                  name: 'Community (free) — agents, workflows, squads, full CLI',
+                  value: 'community',
+                },
+                {
+                  name: 'Pro (requires account) — premium squads, minds, priority support',
+                  value: 'pro',
+                },
+              ],
+              default: 'community',
             },
           ]);
 
-          if (hasPro) {
+          if (edition === 'pro') {
             const proResult = await runProWizard(proOptions);
             answers.proInstalled = proResult.success;
             answers.proResult = proResult;
 
             if (!proResult.success && proResult.error) {
-              console.error(`\n⚠️  Pro installation issue: ${proResult.error}`);
+              console.error(`\n⚠️  Pro activation failed: ${proResult.error}`);
+
+              const { fallback } = await inquirer.prompt([
+                {
+                  type: 'confirm',
+                  name: 'fallback',
+                  message: colors.primary('Continue with Community (free) edition instead?'),
+                  default: true,
+                },
+              ]);
+
+              if (!fallback) {
+                console.log('\n👋 Installation cancelled. Run again when ready.');
+                return answers;
+              }
+
+              console.log('\n📦 Continuing with Community edition...\n');
             }
           } else {
             answers.proInstalled = false;

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

@@ -395,7 +395,34 @@ async function loginWithRetry(client, email) {
       // Activate Pro
       return activateProByAuth(client, loginResult.sessionToken);
     } catch (loginError) {
-      if (loginError.code === 'INVALID_CREDENTIALS') {
+      if (loginError.code === 'EMAIL_NOT_VERIFIED') {
+        // Email not verified — poll by retrying login until verified
+        spinner.info('Email not verified yet. Please check your inbox and click the verification link.');
+        console.log(colors.dim('  (Checking every 5 seconds... timeout in 10 minutes)'));
+
+        const startTime = Date.now();
+        while (Date.now() - startTime < VERIFY_POLL_TIMEOUT_MS) {
+          await new Promise((resolve) => setTimeout(resolve, VERIFY_POLL_INTERVAL_MS));
+          try {
+            const retryLogin = await client.login(email, password);
+            showSuccess('Email verified!');
+            if (!retryLogin.emailVerified) {
+              const verifyResult = await waitForEmailVerification(client, retryLogin.sessionToken, email);
+              if (!verifyResult.success) return verifyResult;
+            }
+            return activateProByAuth(client, retryLogin.sessionToken);
+          } catch (retryError) {
+            if (retryError.code !== 'EMAIL_NOT_VERIFIED') {
+              return { success: false, error: retryError.message };
+            }
+            // Still not verified, continue polling
+          }
+        }
+
+        showError('Email verification timed out after 10 minutes.');
+        showInfo('Run the installer again to retry.');
+        return { success: false, error: 'Email verification timed out.' };
+      } else if (loginError.code === 'INVALID_CREDENTIALS') {
         const remaining = MAX_RETRIES - attempt;
         if (remaining > 0) {
           spinner.fail(`Incorrect password. ${remaining} attempt${remaining > 1 ? 's' : ''} remaining.`);

package/pro/license/license-api.js

@@ -151,7 +151,24 @@ class LicenseApiClient {
         break;
 
       case 401:
-        reject(LicenseActivationError.invalidKey());
+        // Preserve server error code (e.g., INVALID_CREDENTIALS, EMAIL_NOT_VERIFIED)
+        reject(
+          new LicenseActivationError(
+            message || 'Unauthorized',
+            code || 'INVALID_KEY',
+            details,
+          ),
+        );
+        break;
+
+      case 409:
+        reject(
+          new LicenseActivationError(
+            message || 'Conflict',
+            code || 'CONFLICT',
+            details,
+          ),
+        );
         break;
 
       case 403:
@@ -198,11 +215,12 @@ class LicenseApiClient {
         break;
 
       default:
+        // Preserve server error code/message when available
         reject(
           new LicenseActivationError(
-            `Unexpected response: ${statusCode}`,
-            'UNEXPECTED_STATUS',
-            { statusCode, response },
+            message || `Unexpected response: ${statusCode}`,
+            code || 'UNEXPECTED_STATUS',
+            details || { statusCode, response },
           ),
         );
     }
@@ -402,7 +420,10 @@ class LicenseApiClient {
         message: response.message || 'Verification email sent. Please check your inbox.',
       };
     } catch (error) {
-      if (error.code === 'BAD_REQUEST' && error.message.includes('already')) {
+      if (
+        error.code === 'EMAIL_ALREADY_REGISTERED' ||
+        (error.code === 'BAD_REQUEST' && error.message.includes('already'))
+      ) {
         throw AuthError.emailAlreadyRegistered();
       }
       if (error.code === 'RATE_LIMITED') {
@@ -437,7 +458,14 @@ class LicenseApiClient {
         emailVerified: response.emailVerified !== false,
       };
     } catch (error) {
-      if (error.code === 'INVALID_KEY' || error.code === 'BAD_REQUEST') {
+      if (error.code === 'EMAIL_NOT_VERIFIED') {
+        throw AuthError.emailNotVerified();
+      }
+      if (
+        error.code === 'INVALID_KEY' ||
+        error.code === 'INVALID_CREDENTIALS' ||
+        error.code === 'BAD_REQUEST'
+      ) {
         throw AuthError.invalidCredentials();
       }
       if (error.code === 'RATE_LIMITED') {