stigmergy 1.2.0 → 1.2.8

package/scripts/publish.js

@@ -1,268 +1,58 @@
-#!/usr/bin/env node
-
-/**
- * Stigmergy CLI 发布脚本
- * 自动化发布流程到npm
- */
-
-import { execSync } from 'child_process';
-import { readFile, writeFile } from 'fs/promises';
-import { join } from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = join(__filename, '..');
-
-class NPMPublisher {
-    constructor() {
-        this.rootDir = __dirname;
-        this.packagePath = join(this.rootDir, 'package.json');
-    }
-
-    log(message, type = 'info') {
-        const timestamp = new Date().toISOString();
-        const prefix = {
-            'info': '📦 ',
-            'success': '✅ ',
-            'error': '❌ ',
-            'warning': '⚠️ '
-        }[type] || '📦 ';
-
-        console.log(`${timestamp} ${prefix}${message}`);
-    }
-
-    async readPackage() {
-        try {
-            const content = await readFile(this.packagePath, 'utf8');
-            return JSON.parse(content);
-        } catch (error) {
-            this.log(`读取package.json失败: ${error.message}`, 'error');
-            throw error;
-        }
-    }
-
-    async checkRequirements() {
-        this.log('检查发布要求...', 'info');
-
-        const pkg = await this.readPackage();
-
-        // 检查必要字段
-        const required = ['name', 'version', 'description', 'main', 'bin', 'repository'];
-        for (const field of required) {
-            if (!pkg[field]) {
-                throw new Error(`缺少必要字段: ${field}`);
-            }
-        }
-
-        // 检查版本格式
-        if (!/^\d+\.\d+\.\d+$/.test(pkg.version)) {
-            throw new Error(`版本格式不正确: ${pkg.version}`);
-        }
-
-        // 检查仓库URL
-        if (!pkg.repository?.url) {
-            throw new Error('缺少repository.url');
-        }
-
-        this.log('所有检查通过', 'success');
-    }
-
-    async buildProject() {
-        this.log('构建项目...', 'info');
-
-        try {
-            // 清理之前的构建
-            execSync('rm -rf dist', { cwd: this.rootDir });
-
-            // 创建dist目录
-            execSync('mkdir -p dist', { cwd: this.rootDir });
-
-            // 复制必要文件
-            const filesToCopy = [
-                'src/index.js',
-                'src/adapters/',
-                'src/templates/',
-                'package.json',
-                'README.md',
-                'LICENSE'
-            ];
-
-            for (const file of filesToCopy) {
-                if (file.endsWith('/')) {
-                    execSync(`cp -r ${file} dist/`, { cwd: this.rootDir });
-                } else {
-                    execSync(`cp ${file} dist/`, { cwd: this.rootDir });
-                }
-            }
-
-            // 复制bin文件
-            execSync('mkdir -p dist/bin', { cwd: this.rootDir });
-            execSync('cp bin/* dist/bin/', { cwd: this.rootDir });
-
-            // 生成package.json用于发布
-            const publishPackage = await this.readPackage();
-            const publishConfig = {
-                ...publishPackage,
-                files: [
-                    'src/index.js',
-                    'src/adapters/**',
-                    'src/templates/**',
-                    'bin/**',
-                    'README.md',
-                    'LICENSE'
-                ],
-                main: 'src/index.js',
-                bin: {
-                    'stigmergy-cli': 'src/index.js'
-                }
-            };
-
-            await writeFile(
-                join(this.rootDir, 'dist/package.json'),
-                JSON.stringify(publishConfig, null, 2),
-                'utf8'
-            );
-
-            this.log('构建完成', 'success');
-        } catch (error) {
-            this.log(`构建失败: ${error.message}`, 'error');
-            throw error;
-        }
-    }
-
-    async runTests() {
-        this.log('运行测试...', 'info');
-
-        try {
-            execSync('npm test', { cwd: this.rootDir, stdio: 'inherit' });
-            this.log('测试通过', 'success');
-        } catch (error) {
-            this.log(`测试失败: ${error.message}`, 'error');
-            throw error;
-        }
-    }
-
-    async publishToNPM(dryRun = false) {
-        this.log('准备发布到npm...', 'info');
-
-        try {
-            // 检查是否已登录npm
-            try {
-                execSync('npm whoami', { stdio: 'pipe' });
-                this.log('npm登录状态: 已登录', 'success');
-            } catch {
-                this.log('请先登录npm: npm login', 'warning');
-                throw new Error('需要先登录npm');
-            }
-
-            // 检查包名是否可用
-            const pkg = await this.readPackage();
-            try {
-                execSync(`npm view ${pkg.name}`, { stdio: 'pipe' });
-                this.log(`包名 ${pkg.name} 已存在，将覆盖发布`, 'warning');
-            } catch {
-                this.log(`包名 ${pkg.name} 可用`, 'success');
-            }
-
-            // 发布命令
-            const publishCmd = dryRun ? 'npm publish --dry-run' : 'npm publish --access public';
-
-            if (dryRun) {
-                this.log('模拟发布中...', 'info');
-                execSync(publishCmd, { cwd: join(this.rootDir, 'dist'), stdio: 'inherit' });
-                this.log('模拟发布完成', 'success');
-            } else {
-                this.log('发布到npm...', 'info');
-                execSync(publishCmd, { cwd: join(this.rootDir, 'dist'), stdio: 'inherit' });
-                this.log('发布成功！', 'success');
-            }
-
-        } catch (error) {
-            this.log(`发布失败: ${error.message}`, 'error');
-            throw error;
-        }
-    }
-
-    async versionUpdate(type = 'patch') {
-        this.log(`更新版本 (${type})...`, 'info');
-
-        try {
-            execSync(`npm version ${type}`, { cwd: this.rootDir, stdio: 'inherit' });
-            this.log('版本更新完成', 'success');
-        } catch (error) {
-            this.log(`版本更新失败: ${error.message}`, 'error');
-            throw error;
-        }
-    }
-
-    async showHelp() {
-        console.log(`
-🚀 Stigmergy CLI 发布工具
-
-用法: node scripts/publish.js [选项]
-
-选项:
-  --dry-run     模拟发布，不实际上传到npm
-  --patch       更新补丁版本 (默认)
-  --minor       更新次版本
-  --major       更新主版本
-  --help, -h   显示帮助信息
-
-示例:
-  node scripts/publish.js              # 发布到npm
-  node scripts/publish.js --dry-run     # 模拟发布
-  node scripts/publish.js --minor         # 更新次版本并发布
-  node scripts/publish.js --help           # 显示帮助
-
-工作流程:
-  1. 检查发布要求
-  2. 运行测试
-  3. 构建项目
-  4. 更新版本 (可选)
-  5. 发布到npm
-        `);
-    }
-}
-
-async function main() {
-    const publisher = new NPMPublisher();
-    const args = process.argv.slice(2);
-
-    // 显示帮助
-    if (args.includes('--help') || args.includes('-h')) {
-        publisher.showHelp();
-        return;
-    }
-
-    try {
-        // 检查发布要求
-        await publisher.checkRequirements();
-
-        // 运行测试
-        await publisher.runTests();
-
-        // 构建项目
-        await publisher.buildProject();
-
-        // 处理版本更新
-        let versionType = 'patch';
-        if (args.includes('--minor')) versionType = 'minor';
-        if (args.includes('--major')) versionType = 'major';
-
-        if (versionType !== 'patch') {
-            await publisher.versionUpdate(versionType);
-        }
-
-        // 发布到npm
-        const dryRun = args.includes('--dry-run');
-        await publisher.publishToNPM(dryRun);
-
-    } catch (error) {
-        console.error('发布失败:', error.message);
-        process.exit(1);
-    }
-}
-
-if (import.meta.url === `file://${process.argv[1]}`) {
-    main();
-}
+#!/bin/bash
+# Release script for Stigmergy CLI v1.2.1
+
+echo "=========================================="
+echo "Stigmergy CLI v1.2.1 Release Preparation"
+echo "=========================================="
+
+echo ""
+echo "Changes in v1.2.1:"
+echo "- Added 'call' command implementation to modular architecture"
+echo "- Moved old main.js and main_english.js implementations to archive directory"
+echo "- Fixed missing call command functionality in new system"
+echo "- Updated version from 1.2.0 to 1.2.1"
+echo ""
+
+# Verify package
+echo "Verifying package..."
+npm pack
+echo "Package stigmergy-1.2.1.tgz created successfully"
+
+# Show important files for verification
+echo ""
+echo "Important files to verify before publishing:"
+echo "- package.json: version updated to 1.2.1"
+echo "- CHANGELOG.md: updated with v1.2.1 changes"
+echo "- src/cli/router.js: contains call command implementation"
+echo "- archive/main.js.backup: old implementation preserved"
+
+# Instructions for publishing
+echo ""
+echo "=========================================="
+echo "Publishing Instructions (for maintainers):"
+echo "=========================================="
+echo ""
+echo "Before publishing, ensure you have:"
+echo "1. npm login credentials"
+echo "2. Two-factor authentication set up (if required)"
+echo "3. Permissions to publish to 'stigmergy' package"
+echo ""
+echo "To publish the package, run:"
+echo "  npm publish"
+echo ""
+echo "To publish a specific tag (e.g., beta):"
+echo "  npm publish --tag beta"
+echo ""
+echo "After publishing, verify the release:"
+echo "  npm view stigmergy@1.2.1"
+echo ""
+echo "=========================================="
+echo "Git Tagging Commands:"
+echo "=========================================="
+echo "After successful npm publish, tag the release:"
+echo "  git add ."
+echo "  git commit -m \"Release v1.2.1 - Add call command to modular architecture\""
+echo "  git tag -a v1.2.1 -m \"Release v1.2.1\""
+echo "  git push origin main"
+echo "  git push origin v1.2.1"
+echo "=========================================="

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 ? 'PASS' : 'FAIL';
+      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;