stigmergy 1.2.0 → 1.2.6

package/scripts/run-layered-tests.js

@@ -0,0 +1,247 @@
+#!/usr/bin/env node
+
+/**
+ * Layered Test Runner
+ * Executes tests in layers with appropriate filtering based on CLI availability
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const CLIAvailabilityChecker = require('../src/test/cli-availability-checker');
+
+class LayeredTestRunner {
+  constructor() {
+    this.baseDir = path.resolve(__dirname, '..');
+    this.coverageDir = path.join(this.baseDir, 'coverage');
+  }
+
+  /**
+   * Run all test layers
+   */
+  async runAll(options = {}) {
+    console.log('🧪 Stigmergy CLI Layered Test Runner');
+    console.log('=====================================\n');
+
+    const { skipE2E = false, onlyAvailable = false } = options;
+
+    // Check CLI availability
+    console.log('1. Checking CLI tool availability...');
+    const availabilityChecker = new CLIAvailabilityChecker();
+    await availabilityChecker.printAvailabilityReport();
+
+    // Layer 1: Unit Tests
+    console.log('\n2. Running Unit Tests...');
+    const unitResult = await this.runUnitTests();
+
+    // Layer 2: Integration Tests
+    console.log('\n3. Running Integration Tests...');
+    const integrationResult = await this.runIntegrationTests();
+
+    // Layer 3: E2E Tests (optional)
+    let e2eResult = null;
+    if (!skipE2E) {
+      console.log('\n4. Running E2E Tests...');
+      e2eResult = await this.runE2ETests(onlyAvailable);
+    }
+
+    // Generate report
+    this.printSummary({
+      unit: unitResult,
+      integration: integrationResult,
+      e2e: e2eResult
+    });
+
+    // Exit with appropriate code
+    const allPassed = this.allTestsPassed(unitResult, integrationResult, e2eResult);
+    process.exit(allPassed ? 0 : 1);
+  }
+
+  /**
+   * Run unit tests
+   */
+  async runUnitTests() {
+    return this.runJest('tests/unit', {
+      coverage: true,
+      coverageDirectory: 'coverage/unit',
+      testPathIgnorePatterns: ['<rootDir>/tests/e2e/', '<rootDir>/tests/integration/']
+    });
+  }
+
+  /**
+   * Run integration tests
+   */
+  async runIntegrationTests() {
+    return this.runJest('tests/integration', {
+      coverage: true,
+      coverageDirectory: 'coverage/integration',
+      testPathIgnorePatterns: ['<rootDir>/tests/unit/', '<rootDir>/tests/e2e/']
+    });
+  }
+
+  /**
+   * Run E2E tests
+   */
+  async runE2ETests(onlyAvailable = false) {
+    const env = onlyAvailable ? { ONLY_AVAILABLE_CLIS: 'true' } : {};
+
+    return this.runJest('tests/e2e', {
+      coverage: false, // Usually not needed for E2E
+      testTimeout: 60000, // Longer timeout for E2E
+      maxWorkers: 1, // Run E2E tests serially to avoid conflicts
+      env
+    });
+  }
+
+  /**
+   * Run Jest with specific options
+   */
+  async runJest(testPath, options = {}) {
+    return new Promise((resolve) => {
+      const args = [
+        testPath,
+        '--verbose',
+        '--no-cache',
+        `--testTimeout=${options.testTimeout || 30000}`,
+        `--maxWorkers=${options.maxWorkers || 4}`
+      ];
+
+      if (options.coverage) {
+        args.push('--coverage');
+        args.push(`--coverageDirectory=${options.coverageDirectory}`);
+      }
+
+      if (options.testPathIgnorePatterns) {
+        options.testPathIgnorePatterns.forEach(pattern => {
+          args.push('--testPathIgnorePatterns=' + pattern);
+        });
+      }
+
+        const jestPath = process.platform === 'win32'
+        ? path.join(this.baseDir, 'node_modules', '.bin', 'jest.cmd')
+        : path.join(this.baseDir, 'node_modules', '.bin', 'jest');
+
+      const child = spawn(jestPath, args, {
+        cwd: this.baseDir,
+        stdio: 'pipe',
+        env: { ...process.env, ...options.env }
+      });
+
+      let stdout = '';
+      let stderr = '';
+
+      child.stdout.on('data', (data) => {
+        stdout += data.toString();
+        process.stdout.write(data);
+      });
+
+      child.stderr.on('data', (data) => {
+        stderr += data.toString();
+        process.stderr.write(data);
+      });
+
+      child.on('close', (code) => {
+        resolve({
+          success: code === 0,
+          exitCode: code,
+          stdout,
+          stderr
+        });
+      });
+    });
+  }
+
+  /**
+   * Check if all tests passed
+   */
+  allTestsPassed(unit, integration, e2e) {
+    const results = [unit, integration];
+    if (e2e) results.push(e2e);
+
+    return results.every(result => result && result.success);
+  }
+
+  /**
+   * Print test summary
+   */
+  printSummary(results) {
+    console.log('\n=====================================');
+    console.log('Test Layer Summary:');
+    console.log('=====================================');
+
+    const layers = [
+      { name: 'Unit Tests', result: results.unit },
+      { name: 'Integration Tests', result: results.integration },
+      { name: 'E2E Tests', result: results.e2e, optional: true }
+    ];
+
+    let allPassed = true;
+
+    layers.forEach(layer => {
+      if (!layer.result) {
+        console.log(`${layer.name}: SKIPPED`);
+        return;
+      }
+
+      const status = layer.result.success ? '�? : '�?;
+      console.log(`${layer.name}: ${status} (exit code: ${layer.result.exitCode})`);
+
+      if (!layer.result.success) {
+        allPassed = false;
+      }
+    });
+
+    console.log('=====================================');
+    console.log(`Overall: ${allPassed ? '�?ALL TESTS PASSED' : '�?SOME TESTS FAILED'}`);
+    console.log('=====================================\n');
+
+    if (allPassed) {
+      console.log('🎉 Ready for deployment!');
+    } else {
+      console.log('�?Please fix failing tests before deployment.');
+    }
+  }
+}
+
+// CLI interface
+async function main() {
+  const args = process.argv.slice(2);
+  const options = {};
+
+  if (args.includes('--skip-e2e')) {
+    options.skipE2E = true;
+  }
+
+  if (args.includes('--only-available')) {
+    options.onlyAvailable = true;
+  }
+
+  if (args.includes('--help') || args.includes('-h')) {
+    console.log(`
+Usage: node scripts/run-layered-tests.js [options]
+
+Options:
+  --skip-e2e        Skip end-to-end tests
+  --only-available  Only test with available CLI tools
+  --help, -h       Show this help message
+
+Examples:
+  node scripts/run-layered-tests.js
+  node scripts/run-layered-tests.js --skip-e2e
+  node scripts/run-layered-tests.js --only-available
+    `);
+    process.exit(0);
+  }
+
+  const runner = new LayeredTestRunner();
+  await runner.runAll(options);
+}
+
+// Run if called directly
+if (require.main === module) {
+  main().catch(error => {
+    console.error('Test runner failed:', error);
+    process.exit(1);
+  });
+}
+
+module.exports = LayeredTestRunner;

package/scripts/safe-install.js

@@ -1,139 +1,139 @@
-#!/usr/bin/env node
-
-/**
- * Stigmergy Safe Installation Script
- * This script ensures safe installation without conflicting with other CLI tools
- */
-
-const fs = require('fs').promises;
-const path = require('path');
-const { spawn } = require('child_process');
-
-class SafeInstaller {
-    constructor() {
-        this.npmBinDir = path.join(process.env.APPDATA || process.env.HOME, 'npm');
-        this.backupDir = path.join(process.env.TEMP || '/tmp', 'stigmergy-backup-' + Date.now());
-    }
-    
-    // Backup existing files that might conflict
-    async backupPotentialConflicts() {
-        console.log('[BACKUP] Creating backup of potential conflicting files...');
-        
-        try {
-            await fs.mkdir(this.backupDir, { recursive: true });
-        } catch (error) {
-            console.log('[INFO] Could not create backup directory, continuing without backup...');
-            return;
-        }
-        
-        const potentialConflicts = [
-            'node',
-            'node.exe',
-            'node.cmd'
-        ];
-        
-        for (const fileName of potentialConflicts) {
-            const filePath = path.join(this.npmBinDir, fileName);
-            const backupPath = path.join(this.backupDir, fileName);
-            
-            try {
-                await fs.access(filePath);
-                console.log(`[BACKUP] Backing up ${fileName}...`);
-                await fs.copyFile(filePath, backupPath);
-            } catch (error) {
-                // File doesn't exist, that's fine
-            }
-        }
-        
-        console.log(`[OK] Backup created at: ${this.backupDir}`);
-    }
-    
-    // Restore backed up files if installation fails
-    async restoreBackupIfNeeded(success) {
-        if (success) {
-            console.log('[CLEANUP] Installation successful, cleaning up backup...');
-            try {
-                const rimraf = require('rimraf');
-                rimraf.sync(this.backupDir);
-            } catch (error) {
-                // If rimraf is not available, just leave the backup
-            }
-        } else {
-            console.log('[RESTORE] Installation failed, restoring backed up files...');
-            // We would restore files here if needed
-        }
-    }
-    
-    // Monitor installation for conflicts
-    async monitorInstallation() {
-        console.log('[MONITOR] Monitoring installation for conflicts...');
-        
-        // Check for the specific issue we're trying to prevent
-        const nodePackageDir = path.join(this.npmBinDir, 'node_modules', 'node');
-        try {
-            await fs.access(nodePackageDir);
-            console.warn('[WARNING] Detected "node" package installation during installation!');
-            console.warn('[WARNING] This may cause conflicts with other CLI tools.');
-            console.warn('[WARNING] If you experience issues, run: npm run fix-node-conflict');
-        } catch (error) {
-            // Package doesn't exist, that's good
-        }
-    }
-    
-    // Safe installation process
-    async install() {
-        let success = false;
-        
-        try {
-            // Step 1: Backup potential conflicts
-            await this.backupPotentialConflicts();
-            
-            // Step 2: Run the actual installation
-            console.log('[INSTALL] Starting safe installation...');
-            
-            // This would be where we run the actual installation logic
-            // For now, we'll just simulate it
-            
-            success = true;
-            console.log('[SUCCESS] Safe installation completed.');
-            
-        } catch (error) {
-            console.error('[ERROR] Installation failed:', error.message);
-        } finally {
-            // Step 3: Restore backups if needed
-            await this.restoreBackupIfNeeded(success);
-            
-            // Step 4: Monitor for conflicts
-            await this.monitorInstallation();
-        }
-        
-        return success;
-    }
-}
-
-// Run safe installation
-async function runSafeInstallation() {
-    console.log('Stigmergy Safe Installation');
-    console.log('='.repeat(30));
-    
-    const installer = new SafeInstaller();
-    const success = await installer.install();
-    
-    if (success) {
-        console.log('\n[COMPLETE] Stigmergy installed safely!');
-        console.log('[NEXT] Run "stigmergy --help" to get started.');
-    } else {
-        console.log('\n[FAILED] Installation failed. Please check the errors above.');
-        process.exit(1);
-    }
-}
-
-// Only run if this script is called directly
-if (require.main === module) {
-    runSafeInstallation().catch(error => {
-        console.error('[FATAL]', error.message);
-        process.exit(1);
-    });
-}
-
-module.exports = { SafeInstaller };
+#!/usr/bin/env node
+
+/**
+ * Stigmergy Safe Installation Script
+ * This script ensures safe installation without conflicting with other CLI tools
+ */
+
+const fs = require('fs').promises;
+const path = require('path');
+const { spawn } = require('child_process');
+
+class SafeInstaller {
+    constructor() {
+        this.npmBinDir = path.join(process.env.APPDATA || process.env.HOME, 'npm');
+        this.backupDir = path.join(process.env.TEMP || '/tmp', 'stigmergy-backup-' + Date.now());
+    }
+    
+    // Backup existing files that might conflict
+    async backupPotentialConflicts() {
+        console.log('[BACKUP] Creating backup of potential conflicting files...');
+        
+        try {
+            await fs.mkdir(this.backupDir, { recursive: true });
+        } catch (error) {
+            console.log('[INFO] Could not create backup directory, continuing without backup...');
+            return;
+        }
+        
+        const potentialConflicts = [
+            'node',
+            'node.exe',
+            'node.cmd'
+        ];
+        
+        for (const fileName of potentialConflicts) {
+            const filePath = path.join(this.npmBinDir, fileName);
+            const backupPath = path.join(this.backupDir, fileName);
+            
+            try {
+                await fs.access(filePath);
+                console.log(`[BACKUP] Backing up ${fileName}...`);
+                await fs.copyFile(filePath, backupPath);
+            } catch (error) {
+                // File doesn't exist, that's fine
+            }
+        }
+        
+        console.log(`[OK] Backup created at: ${this.backupDir}`);
+    }
+    
+    // Restore backed up files if installation fails
+    async restoreBackupIfNeeded(success) {
+        if (success) {
+            console.log('[CLEANUP] Installation successful, cleaning up backup...');
+            try {
+                const rimraf = require('rimraf');
+                rimraf.sync(this.backupDir);
+            } catch (error) {
+                // If rimraf is not available, just leave the backup
+            }
+        } else {
+            console.log('[RESTORE] Installation failed, restoring backed up files...');
+            // We would restore files here if needed
+        }
+    }
+    
+    // Monitor installation for conflicts
+    async monitorInstallation() {
+        console.log('[MONITOR] Monitoring installation for conflicts...');
+        
+        // Check for the specific issue we're trying to prevent
+        const nodePackageDir = path.join(this.npmBinDir, 'node_modules', 'node');
+        try {
+            await fs.access(nodePackageDir);
+            console.warn('[WARNING] Detected "node" package installation during installation!');
+            console.warn('[WARNING] This may cause conflicts with other CLI tools.');
+            console.warn('[WARNING] If you experience issues, run: npm run fix-node-conflict');
+        } catch (error) {
+            // Package doesn't exist, that's good
+        }
+    }
+    
+    // Safe installation process
+    async install() {
+        let success = false;
+        
+        try {
+            // Step 1: Backup potential conflicts
+            await this.backupPotentialConflicts();
+            
+            // Step 2: Run the actual installation
+            console.log('[INSTALL] Starting safe installation...');
+            
+            // This would be where we run the actual installation logic
+            // For now, we'll just simulate it
+            
+            success = true;
+            console.log('[SUCCESS] Safe installation completed.');
+            
+        } catch (error) {
+            console.error('[ERROR] Installation failed:', error.message);
+        } finally {
+            // Step 3: Restore backups if needed
+            await this.restoreBackupIfNeeded(success);
+            
+            // Step 4: Monitor for conflicts
+            await this.monitorInstallation();
+        }
+        
+        return success;
+    }
+}
+
+// Run safe installation
+async function runSafeInstallation() {
+    console.log('Stigmergy Safe Installation');
+    console.log('='.repeat(30));
+    
+    const installer = new SafeInstaller();
+    const success = await installer.install();
+    
+    if (success) {
+        console.log('\n[COMPLETE] Stigmergy installed safely!');
+        console.log('[NEXT] Run "stigmergy --help" to get started.');
+    } else {
+        console.log('\n[FAILED] Installation failed. Please check the errors above.');
+        process.exit(1);
+    }
+}
+
+// Only run if this script is called directly
+if (require.main === module) {
+    runSafeInstallation().catch(error => {
+        console.error('[FATAL]', error.message);
+        process.exit(1);
+    });
+}
+
+module.exports = { SafeInstaller };

package/scripts/simple-publish.js

@@ -1,59 +1,57 @@
-#!/usr/bin/env node
-
-/**
- * Stigmergy CLI 简化发布脚本
- */
-
-const { execSync } = 'child_process';
-const { readFile } from 'fs/promises';
-const { join, dirname } from 'path';
-const { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-console.log('🚀 Stigmergy CLI 发布工具');
-
-async function main() {
-    try {
-        // 读取package.json
-        const packagePath = join(__dirname, 'package.json');
-        const pkg = JSON.parse(await readFile(packagePath, 'utf8'));
-
-        console.log(`📦 包名: ${pkg.name}`);
-        console.log(`📦 版本: ${pkg.version}`);
-        console.log(`📦 描述: ${pkg.description}`);
-
-        // 检查必要文件
-        const requiredFiles = ['src/index.js', 'package.json', 'README.md', 'LICENSE'];
-        console.log('📍 检查必要文件...');
-
-        for (const file of requiredFiles) {
-            try {
-                execSync(`test -f ${file}`, { cwd: __dirname });
-                console.log(`✅ ${file} 存在`);
-            } catch {
-                console.log(`❌ ${file} 不存在`);
-                throw new Error(`缺少必要文件: ${file}`);
-            }
-        }
-
-        // 模拟npm发布
-        console.log('📤 模拟npm发布...');
-        console.log('⚠️  注意: 这是模拟发布，实际发布需要:');
-        console.log('   1. npm login');
-        console.log('   2. node scripts/simple-publish.js');
-        console.log('   3. npm publish');
-
-        console.log('✅ 模拟发布完成！');
-        console.log('📦 包准备就绪，可以实际发布');
-
-    } catch (error) {
-        console.error('❌ 发布过程失败:', error.message);
-        process.exit(1);
-    }
-}
-
-if (import.meta.url === `file://${process.argv[1]}`) {
-    main();
-}
+#!/usr/bin/env node
+
+/**
+ * Stigmergy CLI 简化发布脚�? */
+
+const { execSync } = 'child_process';
+const { readFile } from 'fs/promises';
+const { join, dirname } from 'path';
+const { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+console.log('🚀 Stigmergy CLI 发布工具');
+
+async function main() {
+    try {
+        // 读取package.json
+        const packagePath = join(__dirname, 'package.json');
+        const pkg = JSON.parse(await readFile(packagePath, 'utf8'));
+
+        console.log(`📦 包名: ${pkg.name}`);
+        console.log(`📦 版本: ${pkg.version}`);
+        console.log(`📦 描述: ${pkg.description}`);
+
+        // 检查必要文�?        const requiredFiles = ['src/index.js', 'package.json', 'README.md', 'LICENSE'];
+        console.log('📍 检查必要文�?..');
+
+        for (const file of requiredFiles) {
+            try {
+                execSync(`test -f ${file}`, { cwd: __dirname });
+                console.log(`�?${file} 存在`);
+            } catch {
+                console.log(`�?${file} 不存在`);
+                throw new Error(`缺少必要文件: ${file}`);
+            }
+        }
+
+        // 模拟npm发布
+        console.log('📤 模拟npm发布...');
+        console.log('⚠️  注意: 这是模拟发布，实际发布需�?');
+        console.log('   1. npm login');
+        console.log('   2. node scripts/simple-publish.js');
+        console.log('   3. npm publish');
+
+        console.log('�?模拟发布完成�?);
+        console.log('📦 包准备就绪，可以实际发布');
+
+    } catch (error) {
+        console.error('�?发布过程失败:', error.message);
+        process.exit(1);
+    }
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main();
+}