stigmergy 1.1.6 → 1.2.6

package/scripts/preinstall-check.js

@@ -1,111 +1,173 @@
-#!/usr/bin/env node
-
-/**
- * Stigmergy Pre-installation Safety Check
- * This script prevents installation conflicts by checking for potential issues
- */
-
-const fs = require('fs');
-const path = require('path');
-const { spawnSync } = require('child_process');
-
-console.log('[PRE-INSTALL] Running safety checks...');
-
-// Check 1: Verify no conflicting "node" package is already installed
-function checkConflictingNodePackage() {
-    console.log('[CHECK] Looking for conflicting node packages...');
-    
-    try {
-        const result = spawnSync('npm', ['list', '-g', 'node'], { 
-            encoding: 'utf8',
-            timeout: 5000
-        });
-        
-        if (result.stdout && result.stdout.includes('node@')) {
-            console.error('[ERROR] Conflicting "node" package detected!');
-            console.error('[ERROR] This will interfere with CLI tools. Please run:');
-            console.error('[ERROR] npm uninstall -g node');
-            console.error('[ERROR] Then try installing stigmergy again.');
-            process.exit(1);
-        }
-    } catch (error) {
-        // If npm command fails, continue anyway
-        console.log('[INFO] Could not verify node package status, continuing...');
-    }
-    
-    console.log('[OK] No conflicting node package found.');
-}
-
-// Check 2: Verify system Node.js installation
-function checkSystemNode() {
-    console.log('[CHECK] Verifying system Node.js installation...');
-    
-    const nodeVersion = process.version;
-    const majorVersion = parseInt(nodeVersion.match(/^v(\d+)/)[1]);
-    
-    if (majorVersion < 16) {
-        console.error('[ERROR] Node.js version 16 or higher is required.');
-        console.error(`[ERROR] Current version: ${nodeVersion}`);
-        process.exit(1);
-    }
-    
-    console.log(`[OK] Node.js ${nodeVersion} detected.`);
-}
-
-// Check 3: Verify npm installation
-function checkNpm() {
-    console.log('[CHECK] Verifying npm installation...');
-    
-    // On Windows, npm might not be directly executable
-    if (process.platform === 'win32') {
-        console.log('[INFO] Skipping npm verification on Windows (may not be directly executable)');
-        return;
-    }
-    
-    try {
-        const result = spawnSync('npm', ['--version'], { 
-            encoding: 'utf8',
-            timeout: 5000
-        });
-        
-        if (result.status !== 0) {
-            console.error('[ERROR] npm is not properly installed or accessible.');
-            process.exit(1);
-        }
-        
-        console.log(`[OK] npm ${result.stdout.trim()} detected.`);
-    } catch (error) {
-        console.error('[ERROR] Failed to verify npm installation.');
-        process.exit(1);
-    }
-}
-
-// Check 4: Check for existing stigmergy installation conflicts
-function checkExistingInstallation() {
-    console.log('[CHECK] Looking for existing Stigmergy installations...');
-    
-    const npmBinDir = path.join(process.env.APPDATA || process.env.HOME, 'npm');
-    const stigmergyBin = path.join(npmBinDir, 'stigmergy');
-    
-    if (fs.existsSync(stigmergyBin)) {
-        console.log('[WARNING] Existing Stigmergy installation detected.');
-        console.log('[WARNING] This may cause conflicts. Consider uninstalling first:');
-        console.log('[WARNING] npm uninstall -g stigmergy');
-    }
-    
-    console.log('[OK] No conflicting Stigmergy installation found.');
-}
-
-// Run all checks
-try {
-    checkSystemNode();
-    checkNpm();
-    checkConflictingNodePackage();
-    checkExistingInstallation();
-    
-    console.log('[SUCCESS] All safety checks passed. Proceeding with installation.');
-    process.exit(0);
-} catch (error) {
-    console.error('[FATAL] Safety check failed:', error.message);
-    process.exit(1);
-}
+#!/usr/bin/env node
+
+/**
+ * Enhanced Stigmergy Pre-installation Check
+ * This script prevents installation conflicts and cleans historical caches
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+console.log('[PRE-INSTALL] Running enhanced installation preparation...');
+
+// Check 1: Verify no conflicting "node" package is already installed
+function checkConflictingNodePackage() {
+    console.log('[CHECK] Looking for conflicting node packages...');
+    
+    try {
+        const result = spawnSync('npm', ['list', '-g', 'node'], { 
+            encoding: 'utf8',
+            timeout: 5000
+        });
+        
+        if (result.stdout && result.stdout.includes('node@')) {
+            console.error('[ERROR] Conflicting "node" package detected!');
+            console.error('[ERROR] This will interfere with CLI tools. Please run:');
+            console.error('[ERROR] npm uninstall -g node');
+            console.error('[ERROR] Then try installing stigmergy again.');
+            process.exit(1);
+        }
+    } catch (error) {
+        // If npm command fails, continue anyway
+        console.log('[INFO] Could not verify node package status, continuing...');
+    }
+    
+    console.log('[OK] No conflicting node package found.');
+}
+
+// Check 2: Verify system Node.js installation
+function checkSystemNode() {
+    console.log('[CHECK] Verifying system Node.js installation...');
+    
+    const nodeVersion = process.version;
+    const majorVersion = parseInt(nodeVersion.match(/^v(\d+)/)[1]);
+    
+    if (majorVersion < 16) {
+        console.error('[ERROR] Node.js version 16 or higher is required.');
+        console.error(`[ERROR] Current version: ${nodeVersion}`);
+        process.exit(1);
+    }
+    
+    console.log(`[OK] Node.js ${nodeVersion} detected.`);
+}
+
+// Check 3: Verify npm installation
+function checkNpm() {
+    console.log('[CHECK] Verifying npm installation...');
+    
+    // On Windows, npm might not be directly executable
+    if (process.platform === 'win32') {
+        console.log('[INFO] Skipping npm verification on Windows (may not be directly executable)');
+        return;
+    }
+    
+    try {
+        const result = spawnSync('npm', ['--version'], { 
+            encoding: 'utf8',
+            timeout: 5000
+        });
+        
+        if (result.status !== 0) {
+            console.error('[ERROR] npm is not properly installed or accessible.');
+            process.exit(1);
+        }
+        
+        console.log(`[OK] npm ${result.stdout.trim()} detected.`);
+    } catch (error) {
+        console.error('[ERROR] Failed to verify npm installation.');
+        process.exit(1);
+    }
+}
+
+// Check 4: Check for existing stigmergy installation conflicts
+function checkExistingInstallation() {
+    console.log('[CHECK] Looking for existing Stigmergy installations...');
+    
+    const npmBinDir = path.join(process.env.APPDATA || process.env.HOME, 'npm');
+    const stigmergyBin = path.join(npmBinDir, 'stigmergy');
+    
+    if (fs.existsSync(stigmergyBin)) {
+        console.log('[WARNING] Existing Stigmergy installation detected.');
+        console.log('[WARNING] This may cause conflicts. Consider uninstalling first:');
+        console.log('[WARNING] npm uninstall -g stigmergy');
+    }
+    
+    console.log('[OK] No conflicting Stigmergy installation found.');
+}
+
+// Check 5: Clean historical caches (NEW FUNCTION)
+function cleanHistoricalCaches() {
+    console.log('[CLEAN] Cleaning historical caches to prevent conflicts...');
+
+    try {
+        // Import and use our enhanced cache cleaner
+        const CacheCleaner = require('../src/core/cache_cleaner');
+        const cleaner = new CacheCleaner({
+            dryRun: false,
+            force: true,
+            verbose: false,
+            preserveRecent: 60 * 60 * 1000 // Preserve files from last hour
+        });
+
+        // Clean only safe items before installation
+        cleaner.cleanAllCaches({
+            cleanStigmergy: false,  // Don't clean main config during install
+            cleanNPX: true,          // Clean NPX cache (safe)
+            cleanNPM: false,         // Don't clean NPM cache during install
+            cleanCLI: false,         // Don't clean CLI configs during install
+            cleanTemp: true          // Clean temporary files (safe)
+        }).then(results => {
+            if (results.filesRemoved > 0) {
+                console.log(`[CLEAN] Removed ${results.filesRemoved} cache files`);
+                console.log(`[CLEAN] Freed ${formatBytes(results.bytesFreed)} space`);
+            } else {
+                console.log('[CLEAN] No cache files needed cleaning');
+            }
+        }).catch(error => {
+            console.log(`[WARN] Cache cleaning failed: ${error.message}`);
+            console.log('[INFO] Continuing with installation...');
+        });
+
+    } catch (error) {
+        console.log(`[WARN] Could not initialize cache cleaner: ${error.message}`);
+        console.log('[INFO] Continuing with installation...');
+    }
+}
+
+// Helper function to format bytes
+function formatBytes(bytes) {
+    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+    if (bytes === 0) return '0 Bytes';
+    const i = Math.floor(Math.log(bytes) / Math.log(1024));
+    return Math.round(bytes / Math.pow(1024, i) * 100) / 100 + ' ' + sizes[i];
+}
+
+// Run all checks and preparation
+async function runInstallationPreparation() {
+    try {
+        // System requirements first
+        checkSystemNode();
+        checkNpm();
+        checkConflictingNodePackage();
+        checkExistingInstallation();
+
+        // Clean caches (async, but don't wait for completion to avoid blocking npm install)
+        cleanHistoricalCaches();
+
+        console.log('[SUCCESS] Enhanced installation preparation completed.');
+        console.log('[INFO] Proceeding with package installation...');
+
+        // Give cache cleaning a moment to start
+        setTimeout(() => {
+            process.exit(0);
+        }, 1000);
+
+    } catch (error) {
+        console.error('[FATAL] Installation preparation failed:', error.message);
+        process.exit(1);
+    }
+}
+
+// Run the enhanced preparation
+runInstallationPreparation();

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 "=========================================="