aiox-core 5.0.4 → 5.0.5

package/pro/feature-registry.yaml

@@ -1,225 +0,0 @@
-# AIOS Pro Feature Registry
-#
-# Complete registry of all premium features available in AIOS Pro.
-# Feature IDs follow the format: pro.{module}.{feature-name}
-#
-# @see ADR-PRO-003 - Feature Gating & Licensing
-# @see Story PRO-6 - License Key & Feature Gating System
-#
-# License keys grant access to features via patterns:
-# - Exact match: "pro.squads.premium" grants only that feature
-# - Wildcard: "pro.squads.*" grants all squads features
-# - Module: "pro.*" grants all pro features (enterprise tier)
-
-version: 1
-lastUpdated: "2026-02-05"
-
-# Module: Squads (Premium squad-based workflows)
-squads:
-  - id: pro.squads.premium
-    name: Premium Squads
-    description: Access to premium squad templates and configurations
-    module: squads
-
-  - id: pro.squads.custom
-    name: Custom Squads
-    description: Create and manage custom squad configurations
-    module: squads
-
-  - id: pro.squads.marketplace
-    name: Squad Marketplace
-    description: Browse and install community squads from marketplace
-    module: squads
-
-  - id: pro.squads.export
-    name: Squad Export
-    description: Export squads as shareable packages
-    module: squads
-
-# Module: Memory (Enhanced AI memory and context)
-memory:
-  - id: pro.memory.extended
-    name: Extended Memory
-    description: Extended context window for AI agents
-    module: memory
-
-  - id: pro.memory.pipeline-integration
-    name: Pipeline Integration
-    description: Automatic memory injection during agent activation (MIS-6)
-    module: memory
-
-  - id: pro.memory.persistence
-    name: Memory Persistence
-    description: Persistent memory across sessions
-    module: memory
-
-  - id: pro.memory.search
-    name: Memory Search
-    description: Semantic search across memory stores
-    module: memory
-
-  - id: pro.memory.self_learning
-    name: Self-Learning Engine
-    description: Analyzes session digests, extracts corrections/patterns/heuristics with confidence scoring (MIS-5)
-    module: memory
-
-  - id: pro.memory.auto_evolution
-    name: Auto-Evolution
-    description: Proposes CLAUDE.md, rules, and agent config improvements from learned heuristics (MIS-7)
-    module: memory
-
-  - id: pro.memory.synapse
-    name: SYNAPSE Memory Bridge
-    description: Feature-gated MIS consumer for SYNAPSE engine bracket-aware memory injection (SYN-10)
-    module: memory
-
-  - id: pro.memory.sync
-    name: Memory Sync
-    description: Cross-device memory synchronization
-    module: memory
-
-# Module: Metrics (Advanced analytics and observability)
-metrics:
-  - id: pro.metrics.advanced
-    name: Advanced Metrics
-    description: Detailed agent performance analytics
-    module: metrics
-
-  - id: pro.metrics.dashboard
-    name: Metrics Dashboard
-    description: Real-time metrics visualization dashboard
-    module: metrics
-
-  - id: pro.metrics.export
-    name: Metrics Export
-    description: Export metrics data to external systems
-    module: metrics
-
-  - id: pro.metrics.alerts
-    name: Metric Alerts
-    description: Configurable alerts for metric thresholds
-    module: metrics
-
-# Module: Integrations (Third-party platform integrations)
-integrations:
-  - id: pro.integrations.clickup
-    name: ClickUp Integration
-    description: Full ClickUp synchronization (bidirectional)
-    module: integrations
-
-  - id: pro.integrations.jira
-    name: Jira Integration
-    description: Jira Cloud integration for enterprise workflows
-    module: integrations
-
-  - id: pro.integrations.linear
-    name: Linear Integration
-    description: Linear app integration for modern teams
-    module: integrations
-
-  - id: pro.integrations.github-enterprise
-    name: GitHub Enterprise
-    description: GitHub Enterprise Server integration
-    module: integrations
-
-  - id: pro.integrations.slack
-    name: Slack Integration
-    description: Slack notifications and commands
-    module: integrations
-
-  - id: pro.integrations.notion
-    name: Notion Integration
-    description: Notion database synchronization
-    module: integrations
-
-# Module: Agents (Premium agent capabilities)
-agents:
-  - id: pro.agents.custom
-    name: Custom Agents
-    description: Create custom agents with specialized behaviors
-    module: agents
-
-  - id: pro.agents.teams
-    name: Agent Teams
-    description: Coordinate multiple agents in team workflows
-    module: agents
-
-  - id: pro.agents.autonomy
-    name: Enhanced Autonomy
-    description: Extended autonomous operation capabilities
-    module: agents
-
-  - id: pro.agents.learning
-    name: Agent Learning
-    description: Agents that learn and improve over time
-    module: agents
-
-# Module: CLI (Premium CLI features)
-cli:
-  - id: pro.cli.parallel
-    name: Parallel Execution
-    description: Run multiple agents in parallel
-    module: cli
-
-  - id: pro.cli.scripting
-    name: Advanced Scripting
-    description: Custom CLI scripting and automation
-    module: cli
-
-  - id: pro.cli.profiles
-    name: CLI Profiles
-    description: Multiple configuration profiles
-    module: cli
-
-  - id: pro.cli.remote
-    name: Remote Execution
-    description: Execute agents on remote systems
-    module: cli
-
-# Module: Config (Premium configuration options)
-config:
-  - id: pro.config.enterprise
-    name: Enterprise Config
-    description: Enterprise-grade configuration management
-    module: config
-
-  - id: pro.config.secrets
-    name: Secrets Management
-    description: Secure secrets vault integration
-    module: config
-
-  - id: pro.config.audit
-    name: Config Audit
-    description: Configuration change audit logging
-    module: config
-
-  - id: pro.config.templates
-    name: Config Templates
-    description: Shareable configuration templates
-    module: config
-
-# Feature ID patterns for license validation
-# These patterns are used in license keys to grant access
-patterns:
-  enterprise:
-    pattern: "pro.*"
-    description: Full access to all pro features
-    tier: enterprise
-
-  team:
-    pattern:
-      - "pro.squads.*"
-      - "pro.memory.*"
-      - "pro.metrics.*"
-      - "pro.integrations.*"
-    description: Team tier - core premium features
-    tier: team
-
-  individual:
-    pattern:
-      - "pro.squads.premium"
-      - "pro.memory.extended"
-      - "pro.memory.synapse"
-      - "pro.cli.parallel"
-    description: Individual tier - essential premium features
-    tier: individual

package/pro/license/degradation.js

@@ -1,220 +0,0 @@
-/**
- * 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,
-};