aios-core 2.1.6 → 2.2.1

package/.aios-core/index.esm.js

@@ -1,16 +1,16 @@
-// @aios-fullstack/core - ES Module Entry Point
-import MetaAgent from './utils/component-generator.js';
-import TaskManager from './utils/batch-creator.js';
-import ElicitationEngine from './utils/elicitation-engine.js';
-import TemplateEngine from './utils/template-engine.js';
-import ComponentSearch from './utils/component-search.js';
-import DependencyAnalyzer from './utils/dependency-analyzer.js';
-
-export {
-    MetaAgent,
-    TaskManager,
-    ElicitationEngine,
-    TemplateEngine,
-    ComponentSearch,
-    DependencyAnalyzer
+// @synkra/aios-core/core - ES Module Entry Point
+import MetaAgent from './utils/component-generator.js';
+import TaskManager from './utils/batch-creator.js';
+import ElicitationEngine from './utils/elicitation-engine.js';
+import TemplateEngine from './utils/template-engine.js';
+import ComponentSearch from './utils/component-search.js';
+import DependencyAnalyzer from './utils/dependency-analyzer.js';
+
+export {
+    MetaAgent,
+    TaskManager,
+    ElicitationEngine,
+    TemplateEngine,
+    ComponentSearch,
+    DependencyAnalyzer
 };

package/.aios-core/index.js

@@ -1,4 +1,4 @@
-// @aios-fullstack/core - CommonJS Entry Point
+// @synkra/aios-core/core - CommonJS Entry Point
 const MetaAgent = require('./infrastructure/scripts/component-generator.js');
 const TaskManager = require('./infrastructure/scripts/batch-creator.js');
 const ElicitationEngine = require('./scripts/elicitation-engine.js');

package/.aios-core/infrastructure/README.md

@@ -1,126 +1,126 @@
-# Infrastructure Module
-
-Base layer of the AIOS modular architecture. Contains tools, integrations, scripts, and PM adapters.
-
-## Structure
-
-```
-infrastructure/
-├── tools/                      # Tool configurations (14 files)
-│   ├── cli/                    # CLI tools (github-cli, railway-cli, supabase-cli)
-│   ├── local/                  # Local tools (ffmpeg)
-│   ├── mcp/                    # MCP tools (9 configs)
-│   └── README.md
-│
-├── scripts/                    # Infrastructure scripts (50+)
-│   ├── _archived/              # Archived migration scripts
-│   └── *.js                    # Active infrastructure scripts
-│
-├── integrations/               # External integrations
-│   └── pm-adapters/            # PM tool adapters (4 adapters)
-│
-├── tests/                      # Test utilities
-│   ├── project-status-loader.test.js
-│   └── regression-suite-v2.md
-│
-├── index.js                    # Module exports
-└── README.md                   # This file
-```
-
-## Dependency Direction
-
-Infrastructure is the **base layer** - it has no dependencies on other modules:
-
-```
-infrastructure/ ← core/ ← development/ ← product/
-```
-
-- `infrastructure/` CAN import from: nothing (base layer)
-- `core/` CAN import from: `infrastructure/`
-- `development/` CAN import from: `infrastructure/`, `core/`
-- `product/` CAN import from: `infrastructure/`, `core/`
-
-## Key Components
-
-### Git Integration
-- `GitWrapper` - Git CLI wrapper for all git operations
-- `GitConfigDetector` - Detects git configuration status
-- `BranchManager` - Branch management utilities
-- `CommitMessageGenerator` - Generates commit messages
-
-### PM Integration
-- `getPMAdapter()` - Factory for PM tool adapters
-- `PMAdapter` - Base adapter class
-- Adapters: ClickUp, GitHub Projects, Jira, Local (standalone)
-
-### Template & Generation
-- `TemplateEngine` - Template rendering
-- `ComponentGenerator` - AIOS component generation
-- `BatchCreator` - Batch operations
-
-### Validation
-- `AiosValidator` - AIOS component validation
-- `TemplateValidator` - Template validation
-- `SpotCheckValidator` - Spot check validation
-
-### Analysis
-- `DependencyAnalyzer` - Dependency analysis
-- `SecurityChecker` - Security validation
-- `CapabilityAnalyzer` - Capability analysis
-
-### Testing
-- `TestGenerator` - Test file generation
-- `CoverageAnalyzer` - Coverage analysis
-- `SandboxTester` - Sandbox testing
-
-### Performance
-- `PerformanceAnalyzer` - Performance analysis
-- `PerformanceTracker` - Performance tracking
-- `PerformanceOptimizer` - Performance optimization
-
-### Quality
-- `CodeQualityImprover` - Code quality improvements
-- `RefactoringSuggester` - Refactoring suggestions
-- `ImprovementEngine` - General improvements
-
-## Usage
-
-```javascript
-// Import from infrastructure module
-const {
-  GitWrapper,
-  getPMAdapter,
-  TemplateEngine,
-  resolveTool
-} = require('.aios-core/infrastructure');
-
-// Or import directly from scripts
-const GitWrapper = require('.aios-core/infrastructure/scripts/git-wrapper');
-```
-
-## Tool Resolution
-
-```javascript
-const { resolveTool } = require('.aios-core/infrastructure');
-
-// Get tool configuration
-const clickupTool = await resolveTool('clickup');
-const githubCli = await resolveTool('github-cli');
-```
-
-## PM Adapters
-
-```javascript
-const { getPMAdapter, isPMToolConfigured } = require('.aios-core/infrastructure');
-
-// Check if PM tool is configured
-if (isPMToolConfigured()) {
-  const adapter = getPMAdapter();
-  await adapter.syncStory(storyPath);
-}
-```
-
-## Migration Reference
-
-Created as part of Story 2.5 - Infrastructure Module Creation.
-See [ADR-002 Migration Map](../../docs/architecture/decisions/ADR-002-migration-map.md).
+# Infrastructure Module
+
+Base layer of the AIOS modular architecture. Contains tools, integrations, scripts, and PM adapters.
+
+## Structure
+
+```
+infrastructure/
+├── tools/                      # Tool configurations (14 files)
+│   ├── cli/                    # CLI tools (github-cli, railway-cli, supabase-cli)
+│   ├── local/                  # Local tools (ffmpeg)
+│   ├── mcp/                    # MCP tools (9 configs)
+│   └── README.md
+│
+├── scripts/                    # Infrastructure scripts (50+)
+│   ├── _archived/              # Archived migration scripts
+│   └── *.js                    # Active infrastructure scripts
+│
+├── integrations/               # External integrations
+│   └── pm-adapters/            # PM tool adapters (4 adapters)
+│
+├── tests/                      # Test utilities
+│   ├── project-status-loader.test.js
+│   └── regression-suite-v2.md
+│
+├── index.js                    # Module exports
+└── README.md                   # This file
+```
+
+## Dependency Direction
+
+Infrastructure is the **base layer** - it has no dependencies on other modules:
+
+```
+infrastructure/ ← core/ ← development/ ← product/
+```
+
+- `infrastructure/` CAN import from: nothing (base layer)
+- `core/` CAN import from: `infrastructure/`
+- `development/` CAN import from: `infrastructure/`, `core/`
+- `product/` CAN import from: `infrastructure/`, `core/`
+
+## Key Components
+
+### Git Integration
+- `GitWrapper` - Git CLI wrapper for all git operations
+- `GitConfigDetector` - Detects git configuration status
+- `BranchManager` - Branch management utilities
+- `CommitMessageGenerator` - Generates commit messages
+
+### PM Integration
+- `getPMAdapter()` - Factory for PM tool adapters
+- `PMAdapter` - Base adapter class
+- Adapters: ClickUp, GitHub Projects, Jira, Local (standalone)
+
+### Template & Generation
+- `TemplateEngine` - Template rendering
+- `ComponentGenerator` - AIOS component generation
+- `BatchCreator` - Batch operations
+
+### Validation
+- `AiosValidator` - AIOS component validation
+- `TemplateValidator` - Template validation
+- `SpotCheckValidator` - Spot check validation
+
+### Analysis
+- `DependencyAnalyzer` - Dependency analysis
+- `SecurityChecker` - Security validation
+- `CapabilityAnalyzer` - Capability analysis
+
+### Testing
+- `TestGenerator` - Test file generation
+- `CoverageAnalyzer` - Coverage analysis
+- `SandboxTester` - Sandbox testing
+
+### Performance
+- `PerformanceAnalyzer` - Performance analysis
+- `PerformanceTracker` - Performance tracking
+- `PerformanceOptimizer` - Performance optimization
+
+### Quality
+- `CodeQualityImprover` - Code quality improvements
+- `RefactoringSuggester` - Refactoring suggestions
+- `ImprovementEngine` - General improvements
+
+## Usage
+
+```javascript
+// Import from infrastructure module
+const {
+  GitWrapper,
+  getPMAdapter,
+  TemplateEngine,
+  resolveTool
+} = require('.aios-core/infrastructure');
+
+// Or import directly from scripts
+const GitWrapper = require('.aios-core/infrastructure/scripts/git-wrapper');
+```
+
+## Tool Resolution
+
+```javascript
+const { resolveTool } = require('.aios-core/infrastructure');
+
+// Get tool configuration
+const clickupTool = await resolveTool('clickup');
+const githubCli = await resolveTool('github-cli');
+```
+
+## PM Adapters
+
+```javascript
+const { getPMAdapter, isPMToolConfigured } = require('.aios-core/infrastructure');
+
+// Check if PM tool is configured
+if (isPMToolConfigured()) {
+  const adapter = getPMAdapter();
+  await adapter.syncStory(storyPath);
+}
+```
+
+## Migration Reference
+
+Created as part of Story 2.5 - Infrastructure Module Creation.
+See [ADR-002 Migration Map](../../docs/architecture/decisions/ADR-002-migration-map.md).

package/.aios-core/infrastructure/integrations/pm-adapters/README.md

@@ -1,59 +1,59 @@
-# PM Adapters
-
-Project Management tool adapters for AIOS. Enables story synchronization with various PM tools.
-
-## Available Adapters
-
-| Adapter | File | Description |
-|---------|------|-------------|
-| ClickUp | `clickup-adapter.js` | Full integration with ClickUp |
-| GitHub Projects | `github-adapter.js` | GitHub Projects v2 integration |
-| Jira | `jira-adapter.js` | Basic Jira integration |
-| Local | `local-adapter.js` | Standalone mode (no external PM) |
-
-## Usage
-
-```javascript
-const { getPMAdapter, isPMToolConfigured } = require('../scripts/pm-adapter-factory');
-
-// Check if PM tool is configured
-if (isPMToolConfigured()) {
-  const adapter = getPMAdapter();
-
-  // Sync story
-  const result = await adapter.syncStory(storyPath);
-
-  // Get story updates
-  const updates = await adapter.pullStoryUpdates(storyId);
-}
-```
-
-## Configuration
-
-PM tool is configured via `.aios-pm-config.yaml` in the project root:
-
-```yaml
-pmTool: clickup  # Options: clickup, github, jira, local
-credentials:
-  # Tool-specific credentials
-```
-
-If no configuration exists, Local adapter is used by default.
-
-## Adapter Interface
-
-All adapters extend `PMAdapter` and implement:
-
-- `getName()` - Returns adapter name
-- `syncStory(storyPath)` - Sync story to PM tool
-- `pullStoryUpdates(storyId)` - Pull updates from PM tool
-- `updateStoryStatus(storyId, status)` - Update story status
-
-## Adding New Adapters
-
-1. Create `new-adapter.js` extending `PMAdapter`
-2. Implement required methods
-3. Register in `pm-adapter-factory.js`
-4. Add to adapter map in factory
-
-See existing adapters for implementation examples.
+# PM Adapters
+
+Project Management tool adapters for AIOS. Enables story synchronization with various PM tools.
+
+## Available Adapters
+
+| Adapter | File | Description |
+|---------|------|-------------|
+| ClickUp | `clickup-adapter.js` | Full integration with ClickUp |
+| GitHub Projects | `github-adapter.js` | GitHub Projects v2 integration |
+| Jira | `jira-adapter.js` | Basic Jira integration |
+| Local | `local-adapter.js` | Standalone mode (no external PM) |
+
+## Usage
+
+```javascript
+const { getPMAdapter, isPMToolConfigured } = require('../scripts/pm-adapter-factory');
+
+// Check if PM tool is configured
+if (isPMToolConfigured()) {
+  const adapter = getPMAdapter();
+
+  // Sync story
+  const result = await adapter.syncStory(storyPath);
+
+  // Get story updates
+  const updates = await adapter.pullStoryUpdates(storyId);
+}
+```
+
+## Configuration
+
+PM tool is configured via `.aios-pm-config.yaml` in the project root:
+
+```yaml
+pmTool: clickup  # Options: clickup, github, jira, local
+credentials:
+  # Tool-specific credentials
+```
+
+If no configuration exists, Local adapter is used by default.
+
+## Adapter Interface
+
+All adapters extend `PMAdapter` and implement:
+
+- `getName()` - Returns adapter name
+- `syncStory(storyPath)` - Sync story to PM tool
+- `pullStoryUpdates(storyId)` - Pull updates from PM tool
+- `updateStoryStatus(storyId, status)` - Update story status
+
+## Adding New Adapters
+
+1. Create `new-adapter.js` extending `PMAdapter`
+2. Implement required methods
+3. Register in `pm-adapter-factory.js`
+4. Add to adapter map in factory
+
+See existing adapters for implementation examples.

package/.aios-core/infrastructure/scripts/approval-workflow.js

@@ -4,7 +4,7 @@ const chalk = require('chalk');
 const inquirer = require('inquirer');
 
 /**
- * Approval workflow for AIOS-FULLSTACK framework
+ * Approval workflow for Synkra AIOS framework
  * Manages approval process for high-impact modifications
  */
 class ApprovalWorkflow {

package/.aios-core/infrastructure/scripts/batch-creator.js

@@ -1,5 +1,5 @@
 /**
- * Batch Component Creator for AIOS-FULLSTACK
+ * Batch Component Creator for Synkra AIOS
  * Creates multiple related components in a single operation
  * @module batch-creator
  */

package/.aios-core/infrastructure/scripts/component-generator.js

@@ -1,5 +1,5 @@
 /**
- * Component Generator for AIOS-FULLSTACK
+ * Component Generator for Synkra AIOS
  * Generates agents, tasks, and workflows using templates
  * @module component-generator
  */
@@ -411,7 +411,7 @@ class ComponentGenerator {
         }
         
         // Notes
-        variables.EACH_NOTES = ['Generated using AIOS-FULLSTACK template system'];
+        variables.EACH_NOTES = ['Generated using Synkra AIOS template system'];
         break;
         
       case 'workflow':
@@ -422,7 +422,7 @@ class ComponentGenerator {
         variables.WORKFLOW_TYPE = answers.workflowType;
         
         // Metadata
-        variables.AUTHOR = process.env.USER || 'AIOS-FULLSTACK';
+        variables.AUTHOR = process.env.USER || 'Synkra AIOS';
         variables.CREATED_DATE = new Date().toISOString();
         variables.LAST_MODIFIED = new Date().toISOString();
         variables.EACH_TAGS = ['generated', componentType];

package/.aios-core/infrastructure/scripts/component-metadata.js

@@ -1,5 +1,5 @@
 /**
- * Component Metadata Manager for AIOS-FULLSTACK
+ * Component Metadata Manager for Synkra AIOS
  * Manages detailed metadata for all framework components
  * @module component-metadata
  */

package/.aios-core/infrastructure/scripts/component-search.js

@@ -3,7 +3,7 @@ const path = require('path');
 const chalk = require('chalk');
 
 /**
- * Component search utility for AIOS-FULLSTACK framework
+ * Component search utility for Synkra AIOS framework
  * Finds and searches components across the framework
  */
 class ComponentSearch {

package/.aios-core/infrastructure/scripts/coverage-analyzer.js

@@ -3,7 +3,7 @@ const path = require('path');
 const chalk = require('chalk');
 
 /**
- * Coverage analyzer for AIOS-FULLSTACK test generation
+ * Coverage analyzer for Synkra AIOS test generation
  * Analyzes existing test coverage and identifies gaps
  */
 class CoverageAnalyzer {

package/.aios-core/infrastructure/scripts/dependency-analyzer.js

@@ -1,5 +1,5 @@
 /**
- * Dependency Analyzer for AIOS-FULLSTACK
+ * Dependency Analyzer for Synkra AIOS
  * Analyzes and resolves dependencies between components
  * @module dependency-analyzer
  */

package/.aios-core/infrastructure/scripts/dependency-impact-analyzer.js

@@ -3,7 +3,7 @@ const path = require('path');
 const chalk = require('chalk');
 
 /**
- * Dependency impact analyzer for AIOS-FULLSTACK framework
+ * Dependency impact analyzer for Synkra AIOS framework
  * Analyzes how component modifications affect dependent components
  */
 class DependencyImpactAnalyzer {

package/.aios-core/infrastructure/scripts/framework-analyzer.js

@@ -4,7 +4,7 @@ const yaml = require('js-yaml');
 const chalk = require('chalk');
 
 /**
- * Framework structure analyzer for AIOS-FULLSTACK
+ * Framework structure analyzer for Synkra AIOS
  * Discovers and catalogs all framework components
  */
 class FrameworkAnalyzer {

package/.aios-core/infrastructure/scripts/improvement-engine.js

@@ -3,7 +3,7 @@ const path = require('path');
 const chalk = require('chalk');
 
 /**
- * Framework improvement suggestion engine for AIOS-FULLSTACK
+ * Framework improvement suggestion engine for Synkra AIOS
  * Generates actionable improvement recommendations based on analysis results
  */
 class ImprovementEngine {

package/.aios-core/infrastructure/scripts/llm-routing/install-llm-routing.js

@@ -17,7 +17,7 @@ const path = require('path');
 const os = require('os');
 
 const isWindows = os.platform() === 'win32';
-const LLM_ROUTING_VERSION = '1.0.0';
+const LLM_ROUTING_VERSION = '1.1.0'; // Added usage tracking support
 
 /**
  * Get the installation directory for commands
@@ -61,6 +61,7 @@ function getInstallDir() {
  * @param {Object} options - Installation options
  * @param {string} options.projectRoot - Project root directory
  * @param {string} options.templatesDir - Templates directory
+ * @param {boolean} options.enableTracking - Enable usage tracking (default: true)
  * @param {Function} options.onProgress - Progress callback
  * @param {Function} options.onError - Error callback
  * @returns {Object} Installation result
@@ -69,6 +70,7 @@ function installLLMRouting(options = {}) {
   const {
     projectRoot = process.cwd(),
     templatesDir = path.join(__dirname, 'templates'),
+    enableTracking = true,
     onProgress = console.log,
     onError = console.error
   } = options;
@@ -94,13 +96,16 @@ function installLLMRouting(options = {}) {
   onProgress(`📂 Installing to: ${installDir}`);
 
   // Determine which scripts to install
+  // Use tracked version of claude-free if tracking is enabled
+  const claudeFreeScript = enableTracking ? 'claude-free-tracked' : 'claude-free';
+
   const scripts = isWindows
-    ? ['claude-free.cmd', 'claude-max.cmd']
-    : ['claude-free.sh', 'claude-max.sh'];
+    ? [`${claudeFreeScript}.cmd`, 'claude-max.cmd', 'deepseek-usage.cmd', 'deepseek-proxy.cmd']
+    : [`${claudeFreeScript}.sh`, 'claude-max.sh', 'deepseek-usage.sh', 'deepseek-proxy.sh'];
 
   const targetNames = isWindows
-    ? ['claude-free.cmd', 'claude-max.cmd']
-    : ['claude-free', 'claude-max'];
+    ? ['claude-free.cmd', 'claude-max.cmd', 'deepseek-usage.cmd', 'deepseek-proxy.cmd']
+    : ['claude-free', 'claude-max', 'deepseek-usage', 'deepseek-proxy'];
 
   // Install each script
   scripts.forEach((script, index) => {
@@ -158,7 +163,7 @@ function installLLMRouting(options = {}) {
 
   // Only update ~/.claude.json when installation succeeded
   if (result.success) {
-    updateClaudeConfig();
+    updateClaudeConfig(enableTracking);
   }
 
   return result;
@@ -166,8 +171,9 @@ function installLLMRouting(options = {}) {
 
 /**
  * Update ~/.claude.json to mark LLM routing as installed
+ * @param {boolean} trackingEnabled - Whether tracking is enabled
  */
-function updateClaudeConfig() {
+function updateClaudeConfig(trackingEnabled = true) {
   const claudeConfigPath = path.join(os.homedir(), '.claude.json');
 
   try {
@@ -180,7 +186,8 @@ function updateClaudeConfig() {
     config.aiosLLMRouting = {
       version: LLM_ROUTING_VERSION,
       installedAt: new Date().toISOString(),
-      commands: ['claude-max', 'claude-free']
+      commands: ['claude-max', 'claude-free', 'deepseek-usage', 'deepseek-proxy'],
+      trackingEnabled
     };
 
     fs.writeFileSync(claudeConfigPath, JSON.stringify(config, null, 2));
@@ -216,11 +223,13 @@ function getInstallationSummary(result) {
   if (result.success) {
     summary.push('');
     summary.push('📋 LLM Routing Installation Complete!');
-    summary.push('═'.repeat(50));
+    summary.push('═'.repeat(60));
     summary.push('');
     summary.push('Commands installed:');
-    summary.push('  • claude-max   → Uses your Claude Max subscription');
-    summary.push('  • claude-free  → Uses DeepSeek (~$0.14/M tokens)');
+    summary.push('  • claude-max      → Uses your Claude Max subscription');
+    summary.push('  • claude-free     → Uses DeepSeek (~$0.14/M tokens) with tracking');
+    summary.push('  • deepseek-usage  → View usage statistics by alias');
+    summary.push('  • deepseek-proxy  → Manage the usage tracking proxy');
     summary.push('');
 
     if (result.envCreated) {
@@ -231,8 +240,12 @@ function getInstallationSummary(result) {
     }
 
     summary.push('Usage:');
-    summary.push('  claude-max   # For premium Claude experience');
-    summary.push('  claude-free  # For cost-effective development');
+    summary.push('  claude-max          # Premium Claude experience');
+    summary.push('  claude-free         # Cost-effective development (tracked)');
+    summary.push('  deepseek-usage      # View all usage stats');
+    summary.push('  deepseek-usage <alias>  # Stats for specific alias');
+    summary.push('');
+    summary.push('Usage data saved to: ~/.aios/usage-tracking/deepseek-usage.json');
     summary.push('');
   } else {
     summary.push('');