snow-flow 8.39.0 → 8.39.2

package/README.md

@@ -4,7 +4,7 @@
   </picture>
 </p>
 
-<h1 align="center">SnowCode</h1>
+<h1 align="center">Snow-Flow</h1>
 <h3 align="center">AI-Powered ServiceNow Development IDE</h3>
 <p align="center"><strong>Part of the Snow-Flow Enterprise Suite</strong></p>
 
@@ -39,7 +39,7 @@ snow-flow init
 snow-flow auth login
 
 # Start building
-snow-flow swarm "create an incident dashboard widget"
+snow-flow agent "create an incident dashboard widget"
 ```
 
 That's it. You're now developing ServiceNow through conversation.
@@ -82,16 +82,16 @@ All through natural conversation.
 
 ```bash
 # Create widgets
-snow-flow swarm "create incident dashboard with priority charts and SLA timers"
+snow-flow agent "create incident dashboard with priority charts and SLA timers"
 
 # Build automation
-snow-flow swarm "create business rule to auto-assign incidents by category"
+snow-flow agent "create business rule to auto-assign incidents by category"
 
 # Query data
-snow-flow swarm "show me all P1 incidents from last week"
+snow-flow agent "show me all P1 incidents from last week"
 
 # Complex workflows
-snow-flow swarm "analyze incident patterns and create a knowledge article with recommendations"
+snow-flow agent "analyze incident patterns and create a knowledge article with recommendations"
 ```
 
 ---
@@ -177,7 +177,7 @@ Snow-Flow works with any MCP-compatible tool:
 
 | Tool | Setup |
 |------|-------|
-| **snow-code** (recommended) | Built-in, just run `snow-flow swarm` |
+| **snow-code** (recommended) | Built-in, just run `snow-flow agent` |
 | **Claude Desktop** | Copy config to `claude_desktop_config.json` |
 | **Cursor** | Copy config to `.cursor/mcp.json` |
 | **Windsurf** | Copy config to `mcp_config.json` |
@@ -199,7 +199,7 @@ cat .snow-code/config.json
 snow-flow init          # Initialize project
 snow-flow auth login    # Authenticate (ServiceNow + enterprise)
 snow-flow auth status   # Check authentication status
-snow-flow swarm "task"  # Execute any ServiceNow task
+snow-flow agent "task"  # Execute any ServiceNow task
 
 # Direct commands
 snow-flow deploy        # Deploy artifacts
@@ -234,5 +234,5 @@ Elastic License 2.0 - Free for commercial use, cannot resell as competing SaaS.
 **Snow-Flow** - The free, open-source ServiceNow Build Agent alternative. Built by developers, for developers.
 
 ```bash
-npm install -g snow-flow && snow-flow init && snow-flow auth login && snow-flow swarm "hello servicenow"
+npm install -g snow-flow && snow-flow init && snow-flow auth login && snow-flow agent "hello servicenow"
 ```

package/dist/cli/enterprise.js

@@ -159,7 +159,7 @@ async function loginCommand(licenseKey) {
         console.log(chalk_1.default.gray('Your credentials have been saved to:'), chalk_1.default.gray(AUTH_FILE));
         console.log('');
         console.log(chalk_1.default.blue('💡 Enterprise tools are now available!'));
-        console.log(chalk_1.default.gray('   Run'), chalk_1.default.cyan('snow-flow swarm "<task>"'), chalk_1.default.gray('to use them.'));
+        console.log(chalk_1.default.gray('   Run'), chalk_1.default.cyan('snow-flow agent "<task>"'), chalk_1.default.gray('to use them.'));
         console.log(chalk_1.default.gray('   Run'), chalk_1.default.cyan('snow-flow portal'), chalk_1.default.gray('to configure integrations.'));
         console.log(chalk_1.default.gray('   Run'), chalk_1.default.cyan('snow-flow status'), chalk_1.default.gray('to view your account details.'));
     }

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;GAEG;AA+vEH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CA6Sf"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;GAEG;AAmwEH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CA6Sf"}

package/dist/cli.js

@@ -65,7 +65,7 @@ const sync_mcp_configs_js_1 = require("./utils/sync-mcp-configs.js");
 const config_cache_js_1 = require("./utils/config-cache.js");
 // Activate MCP guard ONLY for commands that actually use MCP servers
 // Explicitly exclude: init, version, help, auth, export, config commands
-const commandsNeedingMCP = ['swarm', 'status', 'monitor', 'mcp'];
+const commandsNeedingMCP = ['agent', 'swarm', 'status', 'monitor', 'mcp'];
 const commandsNotNeedingMCP = ['init', 'version', 'help', 'auth', 'export', '-v', '--version', '-h', '--help'];
 const currentCommand = process.argv[2];
 // Only activate guard if it's a command that needs MCP AND not explicitly excluded
@@ -150,9 +150,11 @@ function checkFlowDeprecation(command, objective) {
         process.exit(1);
     }
 }
-// Swarm command - the main orchestration command with EVERYTHING
+// Agent command - the main orchestration command with EVERYTHING
+// Note: 'swarm' is kept as an alias for backward compatibility
 program
-    .command('swarm <objective>')
+    .command('agent <objective>')
+    .alias('swarm')
     .description('Execute multi-agent orchestration for a ServiceNow task - één command voor alles!')
     // New engine selector: defaults to auto (uses config-driven agent when available)
     .option('--engine <engine>', 'Execution engine (auto|agent|claude)', 'auto')
@@ -206,7 +208,7 @@ program
     .option('--debug-all', 'Enable ALL debug output (WARNING: Very verbose!)')
     .action(async (objective, options) => {
     // Check for flow deprecation first
-    checkFlowDeprecation('swarm', objective);
+    checkFlowDeprecation('agent', objective);
     // Set debug levels based on options
     if (options.debugAll) {
         process.env.DEBUG = '*';
@@ -261,7 +263,7 @@ program
         console.log(chalk_1.default.blue(`📋 ${objective}`));
     }
     // Run snow-code update check in background (non-blocking)
-    // Don't await - let swarm start immediately while update runs async
+    // Don't await - let agent start immediately while update runs async
     if (options.verbose) {
         cliLogger.info('🔄 Checking for snow-code updates (background)...');
     }
@@ -385,12 +387,12 @@ program
         cliLogger.info('\n🌟 Snow-Flow Enterprise: ❌ Not active');
         cliLogger.info('💡 Run "snow-flow login <license-key>" to enable enterprise features');
     }
-    // Initialize Queen Agent memory system (with graceful fallback)
+    // Initialize Agent memory system (with graceful fallback)
     let memorySystem = null;
-    let sessionId = `swarm_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    let sessionId = `agent_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
     try {
         if (options.verbose) {
-            cliLogger.info('\n💾 Initializing swarm memory system...');
+            cliLogger.info('\n💾 Initializing agent memory system...');
         }
         const { SessionMemorySystem } = await Promise.resolve().then(() => __importStar(require('./memory/session-memory')));
         memorySystem = new SessionMemorySystem();
@@ -398,7 +400,7 @@ program
         if (options.verbose) {
             cliLogger.info(`🔖 Session: ${sessionId}`);
         }
-        // Store swarm session in memory
+        // Store agent session in memory
         await memorySystem.storeLearning(`session_${sessionId}`, {
             objective,
             taskAnalysis,
@@ -408,7 +410,7 @@ program
         });
     }
     catch (error) {
-        // Memory system is optional - swarm works without it
+        // Memory system is optional - agent works without it
         if (options.verbose) {
             cliLogger.warn('⚠️  Memory tracking unavailable (will continue without session tracking)');
         }
@@ -682,14 +684,16 @@ function extractName(objective, type) {
     }
     return `Generated ${type}`;
 }
-// Swarm status command - monitor running swarms
+// Agent status command - monitor running agent sessions
+// Note: 'swarm-status' is kept as an alias for backward compatibility
 program
-    .command('swarm-status [sessionId]')
-    .description('Check the status of a running swarm session')
-    .option('--watch', 'Continuously monitor the swarm progress')
+    .command('agent-status [sessionId]')
+    .alias('swarm-status')
+    .description('Check the status of a running agent session')
+    .option('--watch', 'Continuously monitor the agent progress')
     .option('--interval <seconds>', 'Watch interval in seconds', '5')
     .action(async (sessionId, options) => {
-    cliLogger.info('\n🔍 Checking swarm status...\n');
+    cliLogger.info('\n🔍 Checking agent status...\n');
     try {
         // Try to load memory system
         let memorySystem;
@@ -704,14 +708,14 @@ program
             return;
         }
         if (!sessionId) {
-            // List all recent swarm sessions
-            cliLogger.info('📋 Recent swarm sessions:');
+            // List all recent agent sessions
+            cliLogger.info('📋 Recent agent sessions:');
             cliLogger.info('(Provide a session ID to see detailed status)\n');
             // Get all session keys from learnings
             const sessionKeys = [];
             // Note: This is a simplified approach - in production, you'd query the memory files directly
-            cliLogger.info('💡 Use: snow-flow swarm-status <sessionId> to see details');
-            cliLogger.info('💡 Session IDs are displayed when you start a swarm\n');
+            cliLogger.info('💡 Use: snow-flow agent-status <sessionId> to see details');
+            cliLogger.info('💡 Session IDs are displayed when you start an agent session\n');
             return;
         }
         // Get specific session data
@@ -719,11 +723,11 @@ program
         const launchData = await memorySystem.getLearning(`launch_${sessionId}`);
         const errorData = await memorySystem.getLearning(`error_${sessionId}`);
         if (!sessionData) {
-            console.error(`❌ No swarm session found with ID: ${sessionId}`);
-            cliLogger.info('💡 Make sure to use the exact session ID displayed when starting the swarm');
+            console.error(`❌ No agent session found with ID: ${sessionId}`);
+            cliLogger.info('💡 Make sure to use the exact session ID displayed when starting the agent');
             return;
         }
-        cliLogger.info(`👑 Swarm Session: ${sessionId}`);
+        cliLogger.info(`👑 Agent Session: ${sessionId}`);
         cliLogger.info(`📋 Objective: ${sessionData.objective}`);
         cliLogger.info(`🕐 Started: ${sessionData.started_at}`);
         cliLogger.info(`📊 Task Type: ${sessionData.taskAnalysis.taskType}`);
@@ -744,7 +748,7 @@ program
         }
         cliLogger.info('\n💡 Tips:');
         cliLogger.info('   - Check SnowCode for real-time agent progress');
-        cliLogger.info('   - Use Memory.get("swarm_session_' + sessionId + '") in SnowCode');
+        cliLogger.info('   - Use Memory.get("agent_session_' + sessionId + '") in SnowCode');
         cliLogger.info('   - Monitor TodoRead for task completion status');
         if (options.watch) {
             cliLogger.info(`\n👀 Watching for updates every ${options.interval} seconds...`);
@@ -761,13 +765,13 @@ program
             // Handle graceful shutdown
             process.on('SIGINT', () => {
                 clearInterval(watchInterval);
-                cliLogger.info('\n\n✋ Stopped watching swarm status');
+                cliLogger.info('\n\n✋ Stopped watching agent status');
                 process.exit(0);
             });
         }
     }
     catch (error) {
-        console.error('❌ Failed to check swarm status:', error instanceof Error ? error.message : String(error));
+        console.error('❌ Failed to check agent status:', error instanceof Error ? error.message : String(error));
     }
 });
 // Spawn agent command
@@ -989,7 +993,7 @@ program
         prompts.log.info('     snow-flow auth login');
         prompts.log.message('');
         prompts.log.message('  2. Start developing:');
-        prompts.log.info('     snow-flow swarm "create incident dashboard"');
+        prompts.log.info('     snow-flow agent "create incident dashboard"');
         prompts.log.message('');
         prompts.outro(chalk_1.default.green('✅ Snow-Flow initialized successfully!'));
         // Force exit to prevent hanging
@@ -1012,18 +1016,18 @@ program
 📋 Essential Commands:
   snow-flow init              Initialize project with MCP servers
   snow-flow auth login        Complete authentication setup
-  snow-flow swarm "task"      Execute AI-powered ServiceNow development
+  snow-flow agent "task"      Execute AI-powered ServiceNow development
 
 🎯 Quick Start:
   1. snow-flow init                           # Set up your project
   2. snow-flow auth login                     # Authenticate (LLM + ServiceNow + Enterprise)
-  3. snow-flow swarm "your task"              # Let AI build your solution
+  3. snow-flow agent "your task"              # Let AI build your solution
 
 💡 Example Tasks:
-  snow-flow swarm "create incident dashboard widget"
-  snow-flow swarm "build auto-assignment business rule"
-  snow-flow swarm "generate 5000 test incidents with realistic data"
-  snow-flow swarm "refactor legacy client scripts to modern patterns"
+  snow-flow agent "create incident dashboard widget"
+  snow-flow agent "build auto-assignment business rule"
+  snow-flow agent "generate 5000 test incidents with realistic data"
+  snow-flow agent "refactor legacy client scripts to modern patterns"
 
 🔗 What You Get:
   • 75+ LLM providers (Claude, GPT, Gemini, Llama, Mistral, DeepSeek, etc.)
@@ -2465,7 +2469,7 @@ program
         // Use generic artifact deployment instead
         console.log('🎯 Creating widget using template system...');
         console.log('✨ Use: snow-flow deploy-artifact -t widget -c <config-file>');
-        console.log('📝 Or use: snow-flow swarm "create a widget for incident management"');
+        console.log('📝 Or use: snow-flow agent "create a widget for incident management"');
     }
     catch (error) {
         console.error('❌ Error creating widget:', error);
@@ -2483,7 +2487,7 @@ program
     console.log(chalk_1.default.blue('ℹ️  MCP servers configured for SnowCode (also compatible with Claude Code)'));
     console.log(chalk_1.default.yellow('⚠️  Manual MCP commands are no longer needed'));
     console.log(chalk_1.default.green('✅ SnowCode automatically handles all MCP server lifecycle'));
-    console.log(chalk_1.default.blue('\n💡 Simply run your swarm commands - SnowCode handles the rest!'));
+    console.log(chalk_1.default.blue('\n💡 Simply run your agent commands - SnowCode handles the rest!'));
     return;
 });
 // SPARC Detailed Help Command - DISABLED (sparc-help.js file missing)
@@ -2560,9 +2564,9 @@ program
 // 🔄 BACKWARD COMPATIBILITY ENHANCEMENTS
 // ===================================================
 /**
- * Enhance existing swarm command with optional Queen intelligence
+ * Enhance existing agent command with optional Queen intelligence
  *
- * Note: Users can use: snow-flow swarm "objective" --queen
+ * Note: Users can use: snow-flow agent "objective" --queen
  * This will be implemented in a future version once the Queen system is stable.
  */
 // ===================================================
@@ -2575,7 +2579,7 @@ program
 // - Configuration management
 // - Performance analytics
 // Comment out the line below to disable the integrated commands
-// CLI integration removed - swarm command is implemented directly above
+// CLI integration removed - agent command is implemented directly above
 program.parse(process.argv);
 // Show help if no command provided
 if (!process.argv.slice(2).length) {