stigmergy 1.2.6 → 1.2.10

package/README.md

@@ -1,38 +1,79 @@
 # Stigmergy CLI Multi-Agents System
 
-A comprehensive system for collaboration between multiple AI CLI tools. This monorepo contains several related packages:
-
-## Packages
-
-- `stigmergy` (Core): Main coordination system for multi-agent AI CLI tools
-- `@stigmergy/skills`: Natural language skills for AI CLI tools
-- `@stigmergy/resume`: Cross-CLI memory sharing and session recovery
-- `@stigmergy/sessions`: Cross-CLI session management and recovery
+A comprehensive system for collaboration between multiple AI CLI tools. This system enables seamless cross-CLI communication and intelligent task routing between different AI tools.
 
 ## Features
 
-- 🤖 Multi-agent AI CLI tools collaboration (Claude, Gemini, Qwen, etc.)
-- 🎯 Natural language skills processing
+- 🤖 Multi-agent AI CLI tools collaboration (Claude, Gemini, Qwen, iFlow, Qoder, CodeBuddy, Copilot, Codex)
+- 🎯 Natural language skills processing and cross-CLI task routing
 - 🧠 Cross-CLI memory sharing and session recovery
 - 🔗 Hook integration for seamless AI tool usage
-- 🌍 International encoding support (ANSI-based for global compatibility)
+- 🌍 JavaScript-based implementation (no Python dependencies)
 - ⚡ Intelligent command routing and execution
 
 ## Quick Start
 
-```bash
-# Install the core system
+### Installation (One Command)
+
+**Windows:**
+```powershell
+# Method 1: Right-click PowerShell and "Run as Administrator"
 npm install -g stigmergy
 
-# Install packages
-npm install -g @stigmergy/skills @stigmergy/resume @stigmergy/sessions
+# Method 2: Start PowerShell as Administrator from command line
+Start-Process PowerShell -Verb RunAs -ArgumentList "npm install -g stigmergy"
+```
+
+**macOS/Linux:**
+```bash
+sudo npm install -g stigmergy
+```
+
+### Setup and Use
+
+```bash
+# Install all AI CLI tools
+stigmergy install
 
-# Use unified commands
-sg-skills "translate this to English"
-sg-resume status
-sg-sessions stats
+# Deploy hooks for cross-CLI integration
+stigmergy deploy
+
+# Use cross-CLI collaboration
+stigmergy claude "write a Python function"
+stigmergy gemini "translate this text"
+stigmergy qwen "analyze this code"
 ```
 
+### Permission Issues?
+
+**Windows:**
+```powershell
+# If you get permission errors:
+npm install -g stigmergy --force
+```
+
+**macOS/Linux:**
+```bash
+# If you get permission errors:
+sudo npm install -g stigmergy --unsafe-perm=true --allow-root
+```
+
+## Cross-CLI Communication
+
+When you need to call other AI tools, use the following format:
+```bash
+stigmergy <tool_name> <task_description>
+```
+
+Examples:
+```bash
+stigmergy claude "write a Python function"
+stigmergy gemini "translate this text"
+stigmergy qwen "analyze this code"
+```
+
+Available tools: claude, gemini, qwen, iflow, qodercli, codebuddy, copilot, codex
+
 ## Documentation
 
 - [Main System](./README.md)
@@ -42,4 +83,12 @@ sg-sessions stats
 
 ## Contributing
 
-This project follows the MIT License. Contributions are welcome!
+This project is a collaboration between multiple AI systems:
+- Claude (Anthropic)
+- Qwen (Alibaba)
+- iFlow (Intelligent Workflow)
+- QoderCLI
+- GLM4.5 (Zhipu AI)
+- And other AI systems
+
+Contributions are welcome!

package/STIGMERGY.md

@@ -14,22 +14,41 @@ Cross-CLI communication is enabled between all supported AI tools:
 - GitHub Copilot
 - OpenAI Codex
 
+## Project Contributors
+
+This project is made possible through the contribution of various AI systems:
+- Claude (Anthropic)
+- Qwen (Alibaba)
+- iFlow (Intelligent Workflow)
+- QoderCLI
+- GLM4.5 (Zhipu AI)
+- And other AI systems
+
 ## Cross-CLI Collaboration
 
-Instead of using a central command, cross-CLI communication happens directly between tools through hooks:
+Stigmergy provides a unified command interface for cross-CLI communication:
 
 ### How It Works
 1. Each CLI tool has hooks deployed by Stigmergy
-2. When one tool detects a request to use another tool, it triggers cross-CLI communication
+2. Use the stigmergy command to route tasks to specific AI tools
 3. The target tool executes the requested task and returns results
 
 ### Usage Pattern
-From any supported CLI tool, use natural language patterns:
+Use the stigmergy command with the following format:
+```bash
+stigmergy <tool_name> <task_description>
+```
+
+Examples:
 ```bash
-# Natural language patterns recognized by hooks
-"use qwen to translate this code to Python"
-"ask claude to review this algorithm"
-"call gemini to explain this concept"
+stigmergy claude "write a Python function"
+stigmergy gemini "translate this text"
+stigmergy qwen "analyze this code"
+stigmergy iflow "create a workflow"
+stigmergy qodercli "review this code"
+stigmergy codebuddy "help me debug"
+stigmergy copilot "suggest improvements"
+stigmergy codex "generate documentation"
 ```
 
 ## Project Memory and Documentation

package/docs/MULTI_USER_WIKI_COLLABORATION_SYSTEM.md

@@ -0,0 +1,523 @@
+# 多用户Wiki协同编辑技能系统设计
+
+## 🎯 系统概述
+
+基于Wiki理念的多用户实时协同编辑系统，让多个用户能够同时编辑、创建和优化AI技能，实现真正的"集体智慧"技能开发。
+
+## 🏗️ 系统架构
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    Wiki协同编辑系统                           │
+├─────────────────────────────────────────────────────────────┤
+│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
+│  │  前端编辑器   │  │  实时同步层   │  │  后端服务层   │         │
+│  │             │  │             │  │             │         │
+│  │ • Monaco    │  │ • WebSocket  │  │ • Express   │         │
+│  │ • Yjs协作    │  │ • CRDT算法   │  │ • MongoDB   │         │
+│  │ • 实时预览   │  │ • 冲突解决   │  │ • Redis缓存  │         │
+│  └─────────────┘  └─────────────┘  └─────────────┘         │
+│         │                │                │               │
+│         ▼                ▼                ▼               │
+│  ┌─────────────────────────────────────────────────────┐   │
+│  │              AI技能处理引擎                             │   │
+│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  │   │
+│  │  │  版本控制    │  │  技能解析器   │  │  自动测试    │  │   │
+│  │  │             │  │             │  │             │  │   │
+│  │  │ • Git集成   │  │ • 实时解析   │  │ • 自动验证   │  │   │
+│  │  │ • 分支管理   │  │ • 语法检查   │  │ • 性能测试   │  │   │
+│  │  │ • 合并请求   │  │ • 智能提示   │  │ • 安全扫描   │  │   │
+│  │  └─────────────┘  └─────────────┘  └─────────────┘  │   │
+│  └─────────────────────────────────────────────────────┘   │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## 🎨 核心功能模块
+
+### 1. 实时协同编辑器
+
+#### 前端实现（基于Monaco Editor + Yjs）
+```javascript
+// 协同编辑器初始化
+class CollaborativeEditor {
+  constructor(container, skillId) {
+    this.editor = monaco.editor.create(container, {
+      theme: 'vs-dark',
+      language: 'markdown',
+      automaticLayout: true
+    });
+    
+    // Yjs协同编辑集成
+    this.yDoc = new Y.Doc();
+    this.yText = this.yDoc.getText('skill-content');
+    
+    // WebSocket连接
+    this.websocket = new WebSocket(`ws://localhost:3001/skills/${skillId}`);
+    
+    // 绑定协同编辑
+    this.bindCollaboration();
+  }
+  
+  bindCollaboration() {
+    // Monaco Editor与Yjs绑定
+    const binding = new MonacoBinding(this.yText, this.editor);
+    
+    // WebSocket同步
+    this.websocket.onmessage = (event) => {
+      const update = JSON.parse(event.data);
+      Y.applyUpdate(this.yDoc, update);
+    };
+    
+    // 本地更改同步
+    this.yDoc.on('update', (update) => {
+      this.websocket.send(JSON.stringify(update));
+    });
+  }
+}
+```
+
+#### 后端WebSocket服务器
+```javascript
+// WebSocket服务器
+class SkillCollaborationServer {
+  constructor() {
+    this.wss = new WebSocket.Server({ port: 3001 });
+    this.skillRooms = new Map(); // 技能房间管理
+    this.setupRoutes();
+  }
+  
+  setupRoutes() {
+    this.wss.on('connection', (ws, request) => {
+      const skillId = this.extractSkillId(request.url);
+      this.joinSkillRoom(ws, skillId);
+    });
+  }
+  
+  joinSkillRoom(ws, skillId) {
+    if (!this.skillRooms.has(skillId)) {
+      this.skillRooms.set(skillId, new Set());
+    }
+    
+    const room = this.skillRooms.get(skillId);
+    room.add(ws);
+    
+    // 广播给房间内其他用户
+    ws.on('message', (message) => {
+      room.forEach(client => {
+        if (client !== ws && client.readyState === WebSocket.OPEN) {
+          client.send(message);
+        }
+      });
+    });
+    
+    // 用户离开时清理
+    ws.on('close', () => {
+      room.delete(ws);
+      if (room.size === 0) {
+        this.skillRooms.delete(skillId);
+      }
+    });
+  }
+}
+```
+
+### 2. Wiki版本控制系统
+
+#### Git集成管理
+```javascript
+class WikiVersionControl {
+  constructor(skillRepo) {
+    this.repo = skillRepo;
+    this.git = simpleGit(skillRepo);
+  }
+  
+  // 自动保存版本
+  async saveVersion(skillId, content, author, message) {
+    const timestamp = new Date().toISOString();
+    const filename = `skills/${skillId}.md`;
+    
+    // 写入文件
+    await fs.writeFile(filename, content);
+    
+    // Git操作
+    await this.git.add(filename);
+    await this.git.commit(`${message}\n\nAuthor: ${author}\nTime: ${timestamp}`);
+    
+    // 创建标签（可选）
+    if (message.includes('发布')) {
+      await this.git.addTag(`v${Date.now()}`, filename);
+    }
+  }
+  
+  // 获取版本历史
+  async getVersionHistory(skillId) {
+    const log = await this.git.log({
+      file: `skills/${skillId}.md`,
+      maxCount: 50
+    });
+    
+    return log.all.map(commit => ({
+      hash: commit.hash,
+      message: commit.message,
+      author: commit.author_name,
+      date: commit.date,
+      changes: commit.diff?.changes
+    }));
+  }
+  
+  // 分支管理
+  async createBranch(skillId, branchName, author) {
+    await this.git.checkoutLocalBranch(branchName);
+    await this.saveVersion(skillId, '', author, `创建分支: ${branchName}`);
+  }
+  
+  // 合并请求
+  async mergeRequest(sourceBranch, targetBranch, reviewer) {
+    await this.git.checkoutBranch(targetBranch);
+    await this.git.merge([sourceBranch]);
+    await this.git.push('origin', targetBranch);
+    
+    // 通知审查者
+    await this.notifyReviewer(reviewer, sourceBranch, targetBranch);
+  }
+}
+```
+
+### 3. 智能技能解析器
+
+#### 实时解析引擎
+```javascript
+class RealTimeSkillParser {
+  constructor() {
+    this.parser = new Parser();
+    this.debounceTimer = null;
+  }
+  
+  // 实时解析（防抖处理）
+  parseRealTime(content, callback) {
+    clearTimeout(this.debounceTimer);
+    
+    this.debounceTimer = setTimeout(async () => {
+      try {
+        const parsed = await this.parser.parse(content);
+        const validation = await this.validateSkill(parsed);
+        
+        callback({
+          success: true,
+          parsed,
+          validation,
+          timestamp: new Date().toISOString()
+        });
+      } catch (error) {
+        callback({
+          success: false,
+          error: error.message,
+          suggestions: this.getSuggestions(error)
+        });
+      }
+    }, 500); // 500ms防抖
+  }
+  
+  // 技能验证
+  async validateSkill(parsed) {
+    const validation = {
+      errors: [],
+      warnings: [],
+      suggestions: []
+    };
+    
+    // 结构验证
+    if (!parsed.name) {
+      validation.errors.push('技能名称不能为空');
+    }
+    
+    if (!parsed.triggers || parsed.triggers.length === 0) {
+      validation.warnings.push('没有定义触发条件，技能可能无法被调用');
+    }
+    
+    // 语法验证
+    if (parsed.workflow) {
+      parsed.workflow.forEach((step, index) => {
+        if (!step.action) {
+          validation.errors.push(`步骤${index + 1}缺少执行动作`);
+        }
+      });
+    }
+    
+    // 性能建议
+    if (parsed.tools && parsed.tools.length > 5) {
+      validation.suggestions.push('考虑减少依赖工具数量以提高性能');
+    }
+    
+    return validation;
+  }
+  
+  // 智能建议
+  getSuggestions(error) {
+    const suggestions = [];
+    
+    if (error.message.includes('syntax')) {
+      suggestions.push('检查YAML语法是否正确');
+      suggestions.push('确保缩进使用空格而非制表符');
+    }
+    
+    if (error.message.includes('trigger')) {
+      suggestions.push('添加关键词触发条件，如：keywords: ["翻译", "translate"]');
+    }
+    
+    return suggestions;
+  }
+}
+```
+
+### 4. 多用户权限管理
+
+#### 基于角色的权限系统
+```javascript
+class WikiPermissionManager {
+  constructor() {
+    this.roles = new Map();
+    this.permissions = new Map();
+    this.setupDefaultRoles();
+  }
+  
+  setupDefaultRoles() {
+    // 定义角色
+    this.roles.set('owner', {
+      name: '所有者',
+      permissions: ['read', 'write', 'delete', 'manage_users', 'merge']
+    });
+    
+    this.roles.set('editor', {
+      name: '编辑者',
+      permissions: ['read', 'write', 'suggest']
+    });
+    
+    this.roles.set('viewer', {
+      name: '查看者',
+      permissions: ['read', 'comment']
+    });
+    
+    this.roles.set('guest', {
+      name: '访客',
+      permissions: ['read']
+    });
+  }
+  
+  // 检查权限
+  hasPermission(userId, skillId, permission) {
+    const userRole = this.getUserRole(userId, skillId);
+    const rolePermissions = this.roles.get(userRole)?.permissions || [];
+    
+    return rolePermissions.includes(permission);
+  }
+  
+  // 分配角色
+  assignRole(userId, skillId, role, assignedBy) {
+    // 检查分配者权限
+    if (!this.hasPermission(assignedBy, skillId, 'manage_users')) {
+      throw new Error('无权限分配角色');
+    }
+    
+    this.permissions.set(`${userId}:${skillId}`, role);
+  }
+  
+  // 协作规则
+  getCollaborationRules(skillId) {
+    return {
+      maxConcurrentEditors: 10,
+      editConflictResolution: 'latest_wins',
+      suggestionRequired: false,
+      autoSaveInterval: 30000, // 30秒
+      versionControl: true
+    };
+  }
+}
+```
+
+## 🎯 用户界面设计
+
+### 1. 主编辑界面
+```html
+<!-- Wiki协同编辑主界面 -->
+<div class="wiki-editor">
+  <!-- 顶部工具栏 -->
+  <div class="editor-toolbar">
+    <div class="toolbar-left">
+      <h1 contenteditable="true" class="skill-title">{{ skill.name }}</h1>
+      <span class="skill-status">{{ status }}</span>
+    </div>
+    
+    <div class="toolbar-right">
+      <button class="btn-save" @click="save">💾 保存</button>
+      <button class="btn-preview" @click="togglePreview">👁️ 预览</button>
+      <button class="btn-share" @click="share">🔗 分享</button>
+      <div class="active-users">
+        <div v-for="user in activeUsers" :key="user.id" 
+             class="user-avatar" 
+             :style="{backgroundColor: user.color}">
+          {{ user.initial }}
+        </div>
+      </div>
+    </div>
+  </div>
+  
+  <!-- 主编辑区域 -->
+  <div class="editor-main">
+    <!-- 左侧编辑器 -->
+    <div class="editor-pane">
+      <div class="editor-tabs">
+        <div class="tab active" @click="switchTab('edit')">编辑</div>
+        <div class="tab" @click="switchTab('preview')">预览</div>
+        <div class="tab" @click="switchTab('debug')">调试</div>
+      </div>
+      
+      <div id="monaco-editor" class="monaco-editor"></div>
+    </div>
+    
+    <!-- 右侧辅助面板 -->
+    <div class="assistant-panel">
+      <!-- 实时解析结果 -->
+      <div class="parse-results">
+        <h3>解析结果</h3>
+        <div v-if="parseResult.errors.length > 0" class="errors">
+          <div v-for="error in parseResult.errors" 
+               class="error-item" 
+               :key="error.line">
+            ❌ {{ error.message }}
+          </div>
+        </div>
+        
+        <div v-if="parseResult.warnings.length > 0" class="warnings">
+          <div v-for="warning in parseResult.warnings" 
+               class="warning-item" 
+               :key="warning.line">
+            ⚠️ {{ warning.message }}
+          </div>
+        </div>
+      </div>
+      
+      <!-- 协作者列表 -->
+      <div class="collaborators">
+        <h3>协作者</h3>
+        <div v-for="user in collaborators" :key="user.id" class="collaborator">
+          <div class="user-info">
+            <span class="user-name">{{ user.name }}</span>
+            <span class="user-role">{{ user.role }}</span>
+          </div>
+          <div class="user-status" :class="user.status">
+            {{ user.status === 'online' ? '🟢' : '🔴' }}
+          </div>
+        </div>
+      </div>
+      
+      <!-- 版本历史 -->
+      <div class="version-history">
+        <h3>版本历史</h3>
+        <div v-for="version in versions" :key="version.hash" class="version-item">
+          <div class="version-info">
+            <span class="version-message">{{ version.message }}</span>
+            <span class="version-author">{{ version.author }}</span>
+            <span class="version-time">{{ formatTime(version.date) }}</span>
+          </div>
+          <button @click="restoreVersion(version.hash)" class="btn-restore">
+            恢复
+          </button>
+        </div>
+      </div>
+    </div>
+  </div>
+  
+  <!-- 底部状态栏 -->
+  <div class="editor-statusbar">
+    <div class="status-left">
+      <span>行: {{ cursorPosition.line }}, 列: {{ cursorPosition.column }}</span>
+      <span>字数: {{ wordCount }}</span>
+    </div>
+    <div class="status-right">
+      <span v-if="isSaving" class="saving-indicator">💾 保存中...</span>
+      <span v-else-if="lastSaved" class="saved-indicator">
+        ✅ 已保存于 {{ formatTime(lastSaved) }}
+      </span>
+      <span class="connection-status" :class="connectionStatus">
+        {{ connectionStatus === 'connected' ? '🟢' : '🔴' }}
+      </span>
+    </div>
+  </div>
+</div>
+```
+
+### 2. 移动端适配
+```css
+/* 移动端响应式设计 */
+@media (max-width: 768px) {
+  .wiki-editor {
+    flex-direction: column;
+  }
+  
+  .editor-main {
+    flex-direction: column;
+  }
+  
+  .assistant-panel {
+    position: fixed;
+    bottom: 0;
+    left: 0;
+    right: 0;
+    height: 40vh;
+    transform: translateY(calc(100% - 50px));
+    transition: transform 0.3s ease;
+  }
+  
+  .assistant-panel.expanded {
+    transform: translateY(0);
+  }
+}
+```
+
+## 🚀 实施计划
+
+### 第一阶段：基础协同编辑（1-2个月）
+- [x] 系统架构设计
+- [ ] WebSocket实时通信
+- [ ] Monaco Editor集成
+- [ ] 基础冲突解决
+
+### 第二阶段：Wiki功能完善（2-3个月）
+- [ ] 版本控制系统
+- [ ] 权限管理
+- [ ] 用户认证
+- [ ] 移动端适配
+
+### 第三阶段：智能辅助功能（3-4个月）
+- [ ] 实时语法解析
+- [ ] 智能提示系统
+- [ ] 自动补全
+- [ ] 性能优化
+
+### 第四阶段：高级功能（4-6个月）
+- [ ] 技能测试平台
+- [ ] 自动化部署
+- [ ] 社区功能
+- [ ] 分析统计
+
+## 📊 技术优势
+
+1. **实时性**：基于WebSocket的毫秒级同步
+2. **可靠性**：CRDT算法保证数据一致性
+3. **扩展性**：微服务架构支持水平扩展
+4. **易用性**：直观的Wiki风格编辑体验
+5. **智能化**：AI辅助的语法检查和优化建议
+
+## 🎯 预期效果
+
+- **协作效率提升200%**：多人同时编辑，实时同步
+- **技能质量提升150%**：AI辅助检查和优化
+- **学习成本降低80%**：Wiki风格，所见即所得
+- **社区活跃度提升300%**：易用的协作工具促进参与
+
+---
+
+**设计团队**：Stigmergy架构团队  
+**设计日期**：2025年12月  
+**版本**：v1.0