aios-core 4.2.4 → 4.2.5

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

@@ -1,6 +1,6 @@
 metadata:
   version: 1.0.0
-  lastUpdated: '2026-02-16T01:41:14.537Z'
+  lastUpdated: '2026-02-16T01:40:14.162Z'
   entityCount: 505
   checksumAlgorithm: sha256
 entities:
@@ -4778,7 +4778,7 @@ entities:
         constraints: []
         extensionPoints: []
       checksum: sha256:352b928acd0a477875192ce96fa3aebb278fe9d9b55bc24a144e7aaafa180b45
-      lastVerified: '2026-02-16T01:41:14.535Z'
+      lastVerified: '2026-02-16T01:40:14.160Z'
   scripts:
     agent-assignment-resolver:
       path: .aios-core/development/scripts/agent-assignment-resolver.js

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

@@ -171,3 +171,9 @@
 {"timestamp":"2026-02-16T01:24:17.176Z","action":"add","path":".aios-core/core/code-intel/providers/provider-interface.js","trigger":"watcher"}
 {"timestamp":"2026-02-16T01:40:14.161Z","action":"add","path":".aios-core/product/templates/statusline/statusline-script.js","trigger":"watcher"}
 {"timestamp":"2026-02-16T01:41:14.535Z","action":"add","path":".aios-core/product/templates/statusline/statusline-script.js","trigger":"watcher"}
+{"timestamp":"2026-02-16T01:46:55.003Z","action":"change","path":".aios-core/core/code-intel/code-intel-enricher.js","trigger":"watcher"}
+{"timestamp":"2026-02-16T01:46:55.004Z","action":"change","path":".aios-core/core/code-intel/index.js","trigger":"watcher"}
+{"timestamp":"2026-02-16T01:46:55.004Z","action":"change","path":".aios-core/core/code-intel/providers/code-graph-provider.js","trigger":"watcher"}
+{"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"}

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

@@ -7,8 +7,8 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 4.2.4
-generated_at: "2026-02-16T01:41:22.479Z"
+version: 4.2.5
+generated_at: "2026-02-16T02:46:13.044Z"
 generator: scripts/generate-install-manifest.js
 file_count: 995
 files:
@@ -1013,7 +1013,7 @@ files:
     type: data
     size: 34251
   - path: data/entity-registry.yaml
-    hash: sha256:edec5a66aec966e122185c213f71974a8b57d8b9d227927630b6561762d0debd
+    hash: sha256:ac383b2adae912c065b537029c218a05a0bd20cd89b41d8d83abf70b01a65569
     type: data
     size: 289345
   - path: data/learned-patterns.yaml

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aios-core",
-  "version": "4.2.4",
+  "version": "4.2.5",
   "description": "Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework",
   "bin": {
     "aios": "bin/aios.js",
@@ -19,6 +19,7 @@
     ".claude/CLAUDE.md",
     ".claude/rules/",
     ".claude/hooks/",
+    "pro/license/",
     "README.md",
     "LICENSE"
   ],

package/pro/README.md

@@ -0,0 +1,66 @@
+# AIOS Pro
+
+Premium features for [Synkra AIOS](https://github.com/SynkraAI/aios-core).
+
+## Overview
+
+AIOS Pro extends the open-source AIOS framework with premium capabilities:
+
+- **Premium Squads** - Pre-built squads for SaaS, e-commerce, and fintech
+- **Persistent Memory** - Cross-session context and memory analytics
+- **Usage Metrics** - Dashboards, team analytics, and cost tracking
+- **Enterprise Integrations** - ClickUp, Google Drive, GitLab, Jira, Azure DevOps
+
+## Installation
+
+AIOS Pro requires an active license and is distributed via npm.
+
+```bash
+# Install
+npm install @aios-fullstack/pro
+
+# Activate license
+aios pro activate --key PRO-XXXX-XXXX-XXXX-XXXX
+```
+
+## Usage with aios-core
+
+AIOS Pro is designed to work as a git submodule of `aios-core`:
+
+```bash
+# Clone aios-core with pro submodule
+git clone --recurse-submodules https://github.com/SynkraAI/aios-core.git
+
+# Or add to existing clone
+cd aios-core
+git submodule update --init pro
+```
+
+## Activate License
+
+```bash
+aios pro activate --key PRO-XXXX-XXXX-XXXX-XXXX
+aios pro status
+```
+
+## Structure
+
+```
+aios-pro/
+├── squads/          # Premium squad definitions
+├── memory/          # Persistent memory modules
+├── metrics/         # Usage dashboards and analytics
+├── integrations/    # Enterprise integration adapters
+├── license/         # License infrastructure
+└── pro-config.yaml  # Pro extension configuration
+```
+
+## Requirements
+
+- Node.js >= 18
+- aios-core >= 3.12.0
+- Active AIOS Pro license
+
+## License
+
+Proprietary - Copyright (c) 2026 SynkraAI. All rights reserved.

package/pro/license/degradation.js

@@ -0,0 +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,
+};