flowmind 1.2.3 → 1.4.0

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+## [1.3.0] - 2026-06-26
+
+### Fixed
+- Missing `os` import in config-manager.js
+- MCP Server version hardcoded instead of reading from package.json
+- `config --set` and `skill --set` CLI commands broken (Commander arg parsing)
+- `learn --reset` and `learn --delete` were unimplemented stubs
+- Learning engine race condition on concurrent file writes (added WriteQueue)
+- TUI/Dashboard crash on non-TTY stdin (Ink raw mode error)
+
+### Added
+- All 17 skills now have working `execute()` implementations
+- Global uncaughtException/unhandledRejection handlers
+- Graceful exit handling in TUI via onExit callback
+
+## [1.2.2] - 2026-06-26
+
+### Fixed
+- ChatPanel React import issue with ink-text-input and ink-spinner ESM/CJS interop
+
+## [1.2.0] - 2026-06-26
+
+### Added
+- TUI with split panels, skill browser, dragon display
+- Dashboard with real-time activity feed and stats
+- Event system for cross-component communication
+- Update command for auto-updating flowmind
+
+## [1.1.0] - 2026-06-25
+
+### Added
+- Mainstream AI model providers (GLM, MiMo, Qwen, ERNIE, DeepSeek)
+- AI model integration with rule-based fallback
+- MCP Server for Claude/Codex integration
+
+## [1.0.1] - 2026-06-24
+
+### Added
+- Initial release
+- Skill loading and execution engine
+- Learning engine for user corrections and preferences
+- Honor engine with dragon totem gamification
+- Scene matcher for workflow automation
+- Configuration manager

package/README.md

@@ -8,7 +8,7 @@
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
-[![Version](https://img.shields.io/badge/version-1.1.0-blue)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-1.3.0-blue)](CHANGELOG.md)
 
 [中文](README_CN.md) | [Quick Start](#-quick-start) | [How It Works](#-how-it-works) | [Use Cases](#-use-cases) | [Architecture](#-architecture)
 

package/bin/flowmind.js

@@ -536,11 +536,15 @@ program
         await fm.importLearnings(data);
         console.log(chalk.green('✓ Learnings imported successfully'));
       } else if (options.reset) {
-        console.log(chalk.yellow('Resetting learnings for:'), options.reset);
-        // Implementation would go here
+        const count = await fm.learning.resetSkill(options.reset);
+        console.log(chalk.green(`✓ Reset ${count} learning(s) for skill: ${options.reset}`));
       } else if (options.delete) {
-        console.log(chalk.yellow('Deleting learning:'), options.delete);
-        // Implementation would go here
+        const deleted = await fm.learning.deleteRecord(options.delete);
+        if (deleted) {
+          console.log(chalk.green(`✓ Deleted learning record: ${options.delete}`));
+        } else {
+          console.log(chalk.yellow(`Record not found: ${options.delete}`));
+        }
       } else {
         // Default to list
         const stats = await fm.getStats();
@@ -620,7 +624,7 @@ program
   .description('View or modify skill configuration')
   .option('-i, --info', 'Show skill info (default)')
   .option('-c, --config', 'Show/edit skill configuration')
-  .option('-s, --set <key> <value>', 'Set config value')
+  .option('-s, --set <key>', 'Set config value (value as next argument)')
   .option('-r, --read', 'Read SKILL.md content')
   .option('-e, --edit', 'Open SKILL.md in editor')
   .option('-j, --json', 'Output as JSON (for tool integration)')
@@ -650,13 +654,10 @@ program
       } else if (options.config) {
         await showSkillConfig(skill, fm, options.json);
       } else if (options.set) {
-        // options.set is the key, need value from next arg
-        const value = options.set;
-        const key = options.set;
-        // Get key and value from command line
         const args = process.argv.slice(3);
-        if (args.length >= 2) {
-          await setSkillConfig(skill, fm, args[0], args[1]);
+        const value = args.find(a => !a.startsWith('-'));
+        if (value) {
+          await setSkillConfig(skill, fm, options.set, value);
         } else {
           console.error(chalk.red('Usage: flowmind skill <name> --set <key> <value>'));
         }
@@ -775,7 +776,7 @@ program
   .command('config')
   .description('Manage configuration')
   .option('-l, --list', 'List configuration')
-  .option('-s, --set <key> <value>', 'Set configuration value')
+  .option('-s, --set <key>', 'Set configuration value (value as next argument)')
   .option('-g, --get <key>', 'Get configuration value')
   .action(async (options) => {
     try {
@@ -785,10 +786,16 @@ program
         const config = fm.config.getAll();
         console.log(chalk.cyan('\nFlowMind Configuration:'));
         console.log(JSON.stringify(config, null, 2));
-      } else if (options.set && options.value) {
-        fm.config.set(options.set, options.value);
-        await fm.config.save();
-        console.log(chalk.green('✓ Configuration updated'));
+      } else if (options.set) {
+        const args = process.argv.slice(3);
+        const value = args.find(a => !a.startsWith('-'));
+        if (value) {
+          fm.config.set(options.set, value);
+          await fm.config.save();
+          console.log(chalk.green('✓ Configuration updated'));
+        } else {
+          console.error(chalk.red('Usage: flowmind config --set <key> <value>'));
+        }
       } else if (options.get) {
         const value = fm.config.get(options.get);
         console.log(value);
@@ -1453,6 +1460,52 @@ program
     }
   });
 
+// Doctor command - System health check
+program
+  .command('doctor')
+  .description('Run system health checks and diagnostics')
+  .option('-j, --json', 'Output as JSON')
+  .action(async (options) => {
+    try {
+      const fm = await initFlowMind();
+      const result = await fm.doctor();
+
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      console.log(chalk.cyan('\nFlowMind Health Check\n'));
+      console.log('─'.repeat(60));
+
+      for (const check of result.checks) {
+        const icon = check.status === 'ok' ? chalk.green('✓')
+          : check.status === 'warning' ? chalk.yellow('⚠')
+          : chalk.red('✗');
+        console.log(`  ${icon} ${check.name.padEnd(20)} ${check.message}`);
+      }
+
+      console.log('─'.repeat(60));
+      const { ok, warnings, errors } = result.summary;
+      const summaryLine = [
+        chalk.green(`${ok} ok`),
+        warnings > 0 ? chalk.yellow(`${warnings} warning(s)`) : null,
+        errors > 0 ? chalk.red(`${errors} error(s)`) : null
+      ].filter(Boolean).join(', ');
+      console.log(`\n  Result: ${summaryLine}`);
+
+      if (errors > 0) {
+        console.log(chalk.red('\n  Some checks failed. Please fix the errors above.'));
+      } else if (warnings > 0) {
+        console.log(chalk.yellow('\n  Some warnings detected. Review for potential issues.'));
+      } else {
+        console.log(chalk.green('\n  All checks passed!'));
+      }
+    } catch (error) {
+      console.error(chalk.red('Doctor Error:'), error.message);
+    }
+  });
+
 // Update command - Auto-update flowmind
 program
   .command('update')

package/core/ai/base-model.js

@@ -8,48 +8,27 @@ class BaseModel {
     this.name = name;
     this.config = config;
     this.initialized = false;
+    this.requestTimeout = config.requestTimeout || 30000;
+    this.maxRetries = config.maxRetries || 3;
+    this.retryDelay = config.retryDelay || 1000;
   }
 
-  /**
-   * 初始化模型
-   * @returns {Promise<void>}
-   */
   async init() {
     throw new Error('init() must be implemented by subclass');
   }
 
-  /**
-   * 发送聊天请求
-   * @param {Array} messages - 消息数组 [{role, content}]
-   * @param {Object} options - 请求选项
-   * @returns {Promise<string>} 模型响应
-   */
   async chat(messages, options = {}) {
     throw new Error('chat() must be implemented by subclass');
   }
 
-  /**
-   * 发送补全请求
-   * @param {string} prompt - 提示词
-   * @param {Object} options - 请求选项
-   * @returns {Promise<string>} 模型响应
-   */
   async complete(prompt, options = {}) {
     throw new Error('complete() must be implemented by subclass');
   }
 
-  /**
-   * 检查模型是否可用
-   * @returns {Promise<boolean>}
-   */
   async isAvailable() {
     throw new Error('isAvailable() must be implemented by subclass');
   }
 
-  /**
-   * 获取模型信息
-   * @returns {Object}
-   */
   getInfo() {
     return {
       name: this.name,
@@ -58,13 +37,53 @@ class BaseModel {
     };
   }
 
-  /**
-   * 验证配置
-   * @returns {boolean}
-   */
   validateConfig() {
     return true;
   }
+
+  /**
+   * Fetch with retry, timeout, and exponential backoff
+   */
+  async fetchWithRetry(url, options = {}) {
+    const timeout = options.timeout || this.requestTimeout;
+    const maxRetries = options.retries || this.maxRetries;
+
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+      try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeout);
+
+        const response = await fetch(url, {
+          ...options,
+          signal: controller.signal
+        });
+
+        clearTimeout(timer);
+
+        // Retry on rate limit (429) and server errors (5xx)
+        if (response.status === 429 || response.status >= 500) {
+          if (attempt < maxRetries) {
+            const delay = this.retryDelay * Math.pow(2, attempt);
+            await new Promise(r => setTimeout(r, delay));
+            continue;
+          }
+        }
+
+        return response;
+      } catch (error) {
+        if (error.name === 'AbortError') {
+          if (attempt < maxRetries) continue;
+          throw new Error(`Request timeout after ${timeout}ms`);
+        }
+        if (attempt < maxRetries) {
+          const delay = this.retryDelay * Math.pow(2, attempt);
+          await new Promise(r => setTimeout(r, delay));
+          continue;
+        }
+        throw error;
+      }
+    }
+  }
 }
 
 module.exports = BaseModel;

package/core/ai/model-manager.js

@@ -28,6 +28,9 @@ class ModelManager {
     };
     this.fallbackToRules = config.fallbackToRules !== false;
     this.initialized = false;
+    this.cache = new Map();
+    this.cacheMaxAge = config.cacheMaxAge || 300000; // 5 minutes
+    this.cacheMaxSize = config.cacheMaxSize || 100;
   }
 
   /**
@@ -119,30 +122,16 @@ class ModelManager {
    * @returns {Promise<Object>} 意图分析结果
    */
   async understandIntent(input, context = {}) {
-    if (!this.features.intentUnderstanding) {
-      return null;
-    }
-
-    const provider = this.getDefaultProvider();
-    if (!provider) {
-      return this._fallback('intentUnderstanding', input, context);
-    }
+    if (!this.features.intentUnderstanding) return null;
 
-    try {
+    return this._callWithFailover(async (provider) => {
       const messages = [
         { role: 'system', content: prompts.intent.system },
         { role: 'user', content: prompts.intent.user(input, context) }
       ];
-
-      const response = await provider.chat(messages, {
-        responseFormat: { type: 'json_object' }
-      });
-
+      const response = await provider.chat(messages, { responseFormat: { type: 'json_object' } });
       return JSON.parse(response);
-    } catch (error) {
-      console.warn(`AI intent understanding failed: ${error.message}`);
-      return this._fallback('intentUnderstanding', input, context);
-    }
+    }, 'intentUnderstanding');
   }
 
   /**
@@ -153,30 +142,16 @@ class ModelManager {
    * @returns {Promise<Object>} 提取的参数
    */
   async extractParameters(input, skillName, skillSchema = {}) {
-    if (!this.features.parameterExtraction) {
-      return {};
-    }
+    if (!this.features.parameterExtraction) return {};
 
-    const provider = this.getDefaultProvider();
-    if (!provider) {
-      return this._fallback('parameterExtraction', input, { skillName });
-    }
-
-    try {
+    return this._callWithFailover(async (provider) => {
       const messages = [
         { role: 'system', content: prompts.extraction.system },
         { role: 'user', content: prompts.extraction.user(input, skillName, skillSchema) }
       ];
-
-      const response = await provider.chat(messages, {
-        responseFormat: { type: 'json_object' }
-      });
-
+      const response = await provider.chat(messages, { responseFormat: { type: 'json_object' } });
       return JSON.parse(response);
-    } catch (error) {
-      console.warn(`AI parameter extraction failed: ${error.message}`);
-      return this._fallback('parameterExtraction', input, { skillName });
-    }
+    }, 'parameterExtraction');
   }
 
   /**
@@ -186,30 +161,16 @@ class ModelManager {
    * @returns {Promise<Object>} 选择的技能
    */
   async selectSkill(input, candidates) {
-    if (!this.features.skillSelection) {
-      return null;
-    }
+    if (!this.features.skillSelection) return null;
 
-    const provider = this.getDefaultProvider();
-    if (!provider) {
-      return this._fallback('skillSelection', input, { candidates });
-    }
-
-    try {
+    return this._callWithFailover(async (provider) => {
       const messages = [
         { role: 'system', content: prompts.selection.system },
         { role: 'user', content: prompts.selection.user(input, candidates) }
       ];
-
-      const response = await provider.chat(messages, {
-        responseFormat: { type: 'json_object' }
-      });
-
+      const response = await provider.chat(messages, { responseFormat: { type: 'json_object' } });
       return JSON.parse(response);
-    } catch (error) {
-      console.warn(`AI skill selection failed: ${error.message}`);
-      return this._fallback('skillSelection', input, { candidates });
-    }
+    }, 'skillSelection');
   }
 
   /**
@@ -219,26 +180,15 @@ class ModelManager {
    * @returns {Promise<string>} 摘要文本
    */
   async summarizeResult(result, context = {}) {
-    if (!this.features.resultSummary) {
-      return null;
-    }
+    if (!this.features.resultSummary) return null;
 
-    const provider = this.getDefaultProvider();
-    if (!provider) {
-      return this._fallback('resultSummary', result, context);
-    }
-
-    try {
+    return this._callWithFailover(async (provider) => {
       const messages = [
         { role: 'system', content: prompts.summary.system },
         { role: 'user', content: prompts.summary.user(result, context) }
       ];
-
       return await provider.chat(messages);
-    } catch (error) {
-      console.warn(`AI result summary failed: ${error.message}`);
-      return this._fallback('resultSummary', result, context);
-    }
+    }, 'resultSummary');
   }
 
   /**
@@ -248,42 +198,102 @@ class ModelManager {
    * @returns {Promise<Object>} 学习分析结果
    */
   async analyzeLearningFeedback(input, context = {}) {
-    if (!this.features.learningFeedback) {
-      return null;
-    }
-
-    const provider = this.getDefaultProvider();
-    if (!provider) {
-      return this._fallback('learningFeedback', input, context);
-    }
+    if (!this.features.learningFeedback) return null;
 
-    try {
+    return this._callWithFailover(async (provider) => {
       const messages = [
         { role: 'system', content: prompts.learning.system },
         { role: 'user', content: prompts.learning.user(input, context) }
       ];
+      const response = await provider.chat(messages, { responseFormat: { type: 'json_object' } });
+      return JSON.parse(response);
+    }, 'learningFeedback');
+  }
 
-      const response = await provider.chat(messages, {
-        responseFormat: { type: 'json_object' }
-      });
+  /**
+   * Get cached result if available and not expired
+   * @private
+   */
+  _getCached(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return null;
+    if (Date.now() - entry.timestamp > this.cacheMaxAge) {
+      this.cache.delete(key);
+      return null;
+    }
+    return entry.value;
+  }
 
-      return JSON.parse(response);
-    } catch (error) {
-      console.warn(`AI learning feedback analysis failed: ${error.message}`);
-      return this._fallback('learningFeedback', input, context);
+  /**
+   * Set cache entry, evicting oldest if at capacity
+   * @private
+   */
+  _setCache(key, value) {
+    if (this.cache.size >= this.cacheMaxSize) {
+      const oldest = this.cache.keys().next().value;
+      this.cache.delete(oldest);
+    }
+    this.cache.set(key, { value, timestamp: Date.now() });
+  }
+
+  /**
+   * Clear the AI response cache
+   */
+  clearCache() {
+    this.cache.clear();
+  }
+
+  /**
+   * Call AI with automatic failover to other providers
+   * @private
+   */
+  async _callWithFailover(fn, feature) {
+    // Try default provider first
+    const defaultProvider = this.getDefaultProvider();
+    if (defaultProvider) {
+      try {
+        return await fn(defaultProvider);
+      } catch (error) {
+        console.warn(`Default provider (${this.defaultProvider}) failed for ${feature}: ${error.message}`);
+      }
     }
+
+    // Try other providers
+    for (const [name, provider] of this.providers) {
+      if (name === this.defaultProvider || !provider.initialized) continue;
+      try {
+        console.warn(`Failing over to provider: ${name} for ${feature}`);
+        return await fn(provider);
+      } catch (error) {
+        console.warn(`Failover provider ${name} failed for ${feature}: ${error.message}`);
+      }
+    }
+
+    // All providers failed, use rule-based fallback
+    return this._fallback(feature);
   }
 
   /**
-   * 降级处理
+   * Rule-based fallback when AI is unavailable
    * @private
    */
-  _fallback(feature, input, context) {
-    if (!this.fallbackToRules) {
-      return null;
+  _fallback(feature) {
+    if (!this.fallbackToRules) return null;
+
+    switch (feature) {
+      case 'intentUnderstanding':
+        return { intent: 'unknown', confidence: 0, source: 'rules' };
+      case 'parameterExtraction':
+        return {};
+      case 'skillSelection':
+        return { selectedSkill: null, confidence: 0, source: 'rules' };
+      case 'resultSummary':
+        return null;
+      case 'learningFeedback':
+        return { isLearning: false, source: 'rules' };
+      default:
+        return null;
     }
-    // 返回 null，让调用方使用规则引擎
-    return null;
   }
 
   /**

package/core/ai/providers/anthropic.js

@@ -8,7 +8,7 @@ class AnthropicProvider extends BaseModel {
   constructor(config = {}) {
     super('anthropic', config);
     this.apiKey = config.apiKey || process.env.ANTHROPIC_API_KEY;
-    this.model = config.model || 'claude-3-sonnet-20240229';
+    this.model = config.model || 'claude-sonnet-4-20250514';
     this.baseUrl = config.baseUrl || 'https://api.anthropic.com';
     this.maxTokens = config.maxTokens ?? 2000;
     this.temperature = config.temperature ?? 0.3;
@@ -26,14 +26,10 @@ class AnthropicProvider extends BaseModel {
   }
 
   async chat(messages, options = {}) {
-    if (!this.initialized) {
-      await this.init();
-    }
+    if (!this.initialized) await this.init();
 
-    // 转换消息格式：提取 system 消息
     let systemPrompt = '';
     const userMessages = [];
-
     for (const msg of messages) {
       if (msg.role === 'system') {
         systemPrompt = msg.content;
@@ -42,7 +38,7 @@ class AnthropicProvider extends BaseModel {
       }
     }
 
-    const response = await fetch(`${this.baseUrl}/v1/messages`, {
+    const response = await this.fetchWithRetry(`${this.baseUrl}/v1/messages`, {
       method: 'POST',
       headers: {
         'Content-Type': 'application/json',
@@ -74,19 +70,30 @@ class AnthropicProvider extends BaseModel {
   async isAvailable() {
     try {
       if (!this.apiKey) return false;
-      // Anthropic 没有 models 端点，直接尝试调用
-      return true;
+      // Anthropic has no /models endpoint; make a lightweight messages call to verify
+      const response = await this.fetchWithRetry(`${this.baseUrl}/v1/messages`, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'x-api-key': this.apiKey,
+          'anthropic-version': '2023-06-01'
+        },
+        body: JSON.stringify({
+          model: this.model,
+          max_tokens: 1,
+          messages: [{ role: 'user', content: 'hi' }]
+        }),
+        retries: 1,
+        timeout: 10000
+      });
+      return response.ok || response.status === 400; // 400 = bad request but API is reachable
     } catch {
       return false;
     }
   }
 
   getInfo() {
-    return {
-      ...super.getInfo(),
-      model: this.model,
-      baseUrl: this.baseUrl
-    };
+    return { ...super.getInfo(), model: this.model, baseUrl: this.baseUrl };
   }
 }
 

package/core/ai/providers/deepseek.js

@@ -31,7 +31,7 @@ class DeepSeekProvider extends BaseModel {
       await this.init();
     }
 
-    const response = await fetch(`${this.baseUrl}/chat/completions`, {
+    const response = await this.fetchWithRetry(`${this.baseUrl}/chat/completions`, {
       method: 'POST',
       headers: {
         'Content-Type': 'application/json',
@@ -61,7 +61,17 @@ class DeepSeekProvider extends BaseModel {
   async isAvailable() {
     try {
       if (!this.apiKey) return false;
-      return true;
+      const response = await this.fetchWithRetry(`${this.baseUrl}/chat/completions`, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'Authorization': `Bearer ${this.apiKey}`
+        },
+        body: JSON.stringify({ model: this.model, messages: [{ role: 'user', content: 'hi' }], max_tokens: 1 }),
+        retries: 1,
+        timeout: 10000
+      });
+      return response.ok || response.status === 400;
     } catch {
       return false;
     }

package/core/ai/providers/ernie.js

@@ -26,7 +26,7 @@ class ERNIEProvider extends BaseModel {
   }
 
   async refreshAccessToken() {
-    const response = await fetch(
+    const response = await this.fetchWithRetry(
       `https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=${this.apiKey}&client_secret=${this.secretKey}`,
       { method: 'POST' }
     );
@@ -51,7 +51,7 @@ class ERNIEProvider extends BaseModel {
     const model = options.model || this.model;
     const endpoint = this.getEndpoint(model);
 
-    const response = await fetch(`${this.baseUrl}${endpoint}?access_token=${this.accessToken}`, {
+    const response = await this.fetchWithRetry(`${this.baseUrl}${endpoint}?access_token=${this.accessToken}`, {
       method: 'POST',
       headers: {
         'Content-Type': 'application/json'