flowmind 1.5.3 → 1.5.6

package/CHANGELOG.md

@@ -1,6 +1,36 @@
 # Changelog
 
-## [Unreleased]
+## [1.5.6] - 2026-07-02
+
+### Added
+- Added a `check-update` script and CLI command so already installed users can quickly see whether a newer npm release is available
+
+### Fixed
+- TUI and dashboard now degrade gracefully on narrow or very small terminals instead of crashing on resize
+- CLI TUI/dashboard startup now uses a shared Ink launcher with consistent stdin proxy cleanup
+- Auto-flow remote checklist resolution now requires an exact service/pipeline descriptor match, so a neighboring service can no longer be started by index position alone
+- Log audit now extracts quoted Chinese exception text as a query keyword, shows explicit no-records guidance, and surfaces raw MCP response summaries for TUI debugging
+- Log audit now also tries to infer a keyword from natural-language log queries when the user forgets to add quotes
+- Log audit and SLS log audit now share a natural-language parser for keyword, level, and time-window extraction
+- Natural-language log queries now also infer service and project names when the user writes "项目" or "服务" in a loose sentence
+
+### Changed
+- Sidebar, chat, status, and dashboard panels now switch to compact layouts when terminal width drops below the normal threshold
+- Terminal resize handling now keeps the current session alive and shows a recovery hint instead of exiting on render errors
+
+## [1.5.4] - 2026-07-01
+
+### Added
+- FlowMind now resolves deferred MCP invocations from skill outputs and executes them through the registered adapter when available
+- Auto-flow, YApi, Yuque, and log audit skills now return concise execution summaries instead of raw MCP payload shapes
+
+### Fixed
+- Repeated TUI submissions are now serialized to avoid multi-input crashes during fast follow-up commands
+- CLI startup now falls back to ASCII-friendly banners in managed terminal environments that can crash on full graphics rendering
+
+### Changed
+- `resource-bind` and related learned bindings now surface clearer resource summaries for follow-up skill reuse
+- Result formatting now unwraps nested execution payloads so the TUI shows the actual output instead of intermediate envelopes
 
 ## [1.5.2] - 2026-07-01
 

package/README.md

@@ -15,6 +15,8 @@
 
 </div>
 
+Weekly downloads: 3,280
+
 ---
 
 ## What It Is

package/README_CN.md

@@ -15,6 +15,8 @@
 
 </div>
 
+本周下载量：3,280 次
+
 ---
 
 ## 它是什么

package/bin/flowmind.js

@@ -14,8 +14,10 @@ const path = require('path');
 const { execSync } = require('child_process');
 const FlowMind = require('../core');
 const HonorEngine = require('../core/honor-engine');
+const { main: runUpdateCheck } = require('../scripts/check-update');
+const { launchInkApp } = require('../core/cli-ink');
 const { syncSddAgentToFlowMind } = require('../core/sdd-agent-sync');
-const { detectManagedCliHost, shouldUseAsciiUi, shouldProxyInkStdin, getNestedTuiGuardMessage } = require('../core/utils');
+const { detectManagedCliHost, shouldUseAsciiUi, getNestedTuiGuardMessage } = require('../core/utils');
 const { isExitCommand } = require('../tui/ui');
 
 /**
@@ -75,7 +77,19 @@ async function initFlowMind(options = {}) {
 /**
  * Display banner
  */
-function showBanner() {
+function showBanner(asciiMode = false) {
+  if (asciiMode) {
+    console.log(chalk.cyan(`
+  +--------------------------------------------------+
+  |                                                  |
+  |   FlowMind                                       |
+  |   The AI Agent That Learns How You Work          |
+  |                                                  |
+  +--------------------------------------------------+
+  `));
+    return;
+  }
+
   console.log(chalk.cyan(`
   ╔══════════════════════════════════════════════════╗
   ║                                                ║
@@ -89,7 +103,71 @@ function showBanner() {
 /**
  * Dragon Totem ASCII Art by level - Chinese Dragon (中国龙)
  */
-function getDragonArt(level) {
+function getDragonArt(level, asciiMode = false) {
+  if (asciiMode) {
+    const asciiArts = {
+      0: [
+        '        /-----\\        ',
+        '       /  /-\\  \\       ',
+        '      |  | o |  |      ',
+        '      |  |   |  |      ',
+        '      |   \\_/   |      ',
+        '       \\       /       ',
+        '        \\-----/        ',
+        '        Dragon Egg     '
+      ],
+      1: [
+        '          /--\\          ',
+        '     /----/  \\---\\      ',
+        '    /  o    \\/    \\     ',
+        '    \\    /\\    /\\  /    ',
+        '     \\/\\/  \\/\\/  \\/     ',
+        '      Hatchling Dragon  '
+      ],
+      2: [
+        '       /-\\  /-\\         ',
+        '  /----/  \\/  \\---\\     ',
+        ' /  o      __      \\    ',
+        ' \\     /--------\\  /    ',
+        '  \\---/  //////  \\/     ',
+        '   \\_/          \\_/     ',
+        '      Juvenile Dragon   '
+      ],
+      3: [
+        '     /---\\  /---\\       ',
+        ' /---/   \\/   \\---\\     ',
+        '/  o       __      \\    ',
+        '|    /----------\\  |    ',
+        ' \\--/  ////////  \\-/    ',
+        '  \\/  //////////  \\/    ',
+        '   \\_/          \\_/     ',
+        '       Adult Dragon     '
+      ],
+      4: [
+        '   /---\\      /---\\     ',
+        '/---/   \\____/   \\---\\  ',
+        '| o        __        |  ',
+        '|   /------------\\   |  ',
+        ' \\-/  //////////// \\-/  ',
+        '  /  ////////////  \\    ',
+        ' /_/              \\_\\   ',
+        '       Elder Dragon     '
+      ],
+      5: [
+        ' * /---\\      /---\\ *   ',
+        '/-/   \\______/   \\-\\    ',
+        '| o        __        |  ',
+        '|   /--------------\\ |  ',
+        ' \\-/  /////**/////  \\-/ ',
+        '  /  /////    /////  \\  ',
+        ' /_/   **      **   \\_\\ ',
+        ' * \\______________/ *   ',
+        '     Ascended Dragon    '
+      ]
+    };
+    return asciiArts[level] || asciiArts[0];
+  }
+
   const arts = {
     0: [
       '        ╭─────╮        ',
@@ -192,11 +270,11 @@ function getHighlightColor(level) {
 /**
  * Render dragon totem with honor data
  */
-function renderDragonTotem(honorData) {
+function renderDragonTotem(honorData, asciiMode = false) {
   const info = getLevelInfo(honorData.points);
   const dragonColor = getDragonColor(info.level);
   const highlightColor = getHighlightColor(info.level);
-  const art = getDragonArt(info.level);
+  const art = getDragonArt(info.level, asciiMode);
 
   // Calculate max art line width for proper padding
   const maxArtWidth = Math.max(...art.map(l => l.length));
@@ -210,7 +288,8 @@ function renderDragonTotem(honorData) {
 
   console.log('');
   console.log(chalk.cyan('  ┌' + border + '┐'));
-  console.log(chalk.cyan('  │') + '  🐉 Dragon Totem of Honor  ' + padRight('  🐉 Dragon Totem of Honor  ', boxWidth - 2) + chalk.cyan('│'));
+  const title = asciiMode ? '  Dragon Totem of Honor  ' : '  🐉 Dragon Totem of Honor  ';
+  console.log(chalk.cyan('  │') + title + padRight(title, boxWidth - 2) + chalk.cyan('│'));
   console.log(chalk.cyan('  ├' + border + '┤'));
 
   for (const line of art) {
@@ -366,7 +445,7 @@ program
   .description('Initialize FlowMind in current directory')
   .option('--ai <provider>', 'Initialize with AI provider (openai/anthropic/glm/mimo/qwen/ernie/deepseek/ollama)')
   .action(async (options) => {
-    showBanner();
+    showBanner(options.ascii || shouldUseAsciiUi());
 
     const spinner = ora('Initializing FlowMind...').start();
 
@@ -836,7 +915,7 @@ program
       } else if (options.publish) {
         await publishHonor({ output: options.output, gist: options.gist });
       } else {
-        renderDragonTotem(honorData);
+        renderDragonTotem(honorData, shouldUseAsciiUi());
         console.log(chalk.gray(`  ${getNextLevelHint(honorData.points)}`));
       }
     } catch (error) {
@@ -959,7 +1038,7 @@ program
 
 // Interactive mode
 async function runInteractiveMode(fm) {
-  showBanner();
+  showBanner(shouldUseAsciiUi());
   console.log(chalk.cyan('Interactive mode started. Type "exit" to quit.\n'));
 
   try {
@@ -1529,8 +1608,6 @@ program
   .description('Launch enhanced TUI with split panels, skill browser, and dragon display')
   .option('--ascii', 'Force ASCII-safe terminal rendering')
   .action(async (options) => {
-    let stdinWrapper = null;
-    let stdinForwarder = null;
     try {
       const managedHost = detectManagedCliHost();
       if (managedHost) {
@@ -1540,71 +1617,21 @@ program
         return;
       }
 
-      // Register .jsx extension for CJS
-      require('module')._extensions['.jsx'] = require('module')._extensions['.js'];
-
       const React = require('react');
-      const { render } = require('ink');
-      const { PassThrough } = require('stream');
       const App = require('../tui/app.jsx');
       const asciiMode = options.ascii || shouldUseAsciiUi();
 
       const fm = await initFlowMind();
-
-      const realStdin = process.stdin;
-      let inkStdin = realStdin;
-
-      // Only proxy stdin when the host stream cannot satisfy Ink's raw-mode requirements.
-      if (shouldProxyInkStdin(realStdin)) {
-        stdinWrapper = new PassThrough();
-        stdinWrapper.isTTY = true;
-        stdinWrapper.isRaw = false;
-        stdinWrapper.setRawMode = (mode) => {
-          try {
-            if (realStdin.setRawMode) {
-              realStdin.setRawMode(mode);
-            }
-          } catch (e) {
-            // Suppress raw mode errors in non-TTY environments
-          }
-          return stdinWrapper;
-        };
-        // Forward real stdin data to the wrapper (store reference for cleanup)
-        if (realStdin.readable) {
-          stdinForwarder = (chunk) => {
-            if (!stdinWrapper.destroyed) {
-              try {
-                stdinWrapper.write(chunk);
-              } catch (e) {
-                // Ignore write-after-destroy errors
-              }
-            }
-          };
-          realStdin.on('data', stdinForwarder);
-        }
-
-        inkStdin = stdinWrapper;
-      }
-
-      const { unmount, waitUntilExit } = render(
-        React.createElement(App, { flowmind: fm, asciiMode: asciiMode }),
-        { stdin: inkStdin }
-      );
-      await waitUntilExit();
-      unmount();
+      await launchInkApp({
+        element: React.createElement(App, { flowmind: fm, asciiMode: asciiMode }),
+        stdin: process.stdin
+      });
     } catch (error) {
       console.error(chalk.red('TUI Error:'), error.message);
       if (error.message.includes('Cannot find module')) {
         console.log(chalk.yellow('Try running: npm install ink@3 react ink-text-input ink-spinner'));
       }
     } finally {
-      // Clean up stdin listener to prevent leak
-      if (stdinForwarder) {
-        process.stdin.removeListener('data', stdinForwarder);
-      }
-      if (stdinWrapper && !stdinWrapper.destroyed) {
-        stdinWrapper.destroy();
-      }
       restoreTerminal();
     }
   });
@@ -1615,8 +1642,6 @@ program
   .description('Launch real-time monitoring dashboard for MCP activity and events')
   .option('--ascii', 'Force ASCII-safe terminal rendering')
   .action(async (options) => {
-    let stdinWrapper = null;
-    let stdinForwarder = null;
     try {
       const managedHost = detectManagedCliHost();
       if (managedHost) {
@@ -1626,68 +1651,22 @@ program
         return;
       }
 
-      // Register .jsx extension for CJS
-      require('module')._extensions['.jsx'] = require('module')._extensions['.js'];
-
       const React = require('react');
-      const { render } = require('ink');
-      const { PassThrough } = require('stream');
       const DashboardApp = require('../dashboard/app.jsx');
       const eventBus = require('../core/event-bus');
       const asciiMode = options.ascii || shouldUseAsciiUi();
 
       const fm = await initFlowMind();
-
-      const realStdin = process.stdin;
-      let inkStdin = realStdin;
-
-      // Only proxy stdin when the host stream cannot satisfy Ink's raw-mode requirements.
-      if (shouldProxyInkStdin(realStdin)) {
-        stdinWrapper = new PassThrough();
-        stdinWrapper.isTTY = true;
-        stdinWrapper.isRaw = false;
-        stdinWrapper.setRawMode = (mode) => {
-          try {
-            if (realStdin.setRawMode) {
-              realStdin.setRawMode(mode);
-            }
-          } catch (e) {
-            // Suppress raw mode errors in non-TTY environments
-          }
-          return stdinWrapper;
-        };
-        if (realStdin.readable) {
-          stdinForwarder = (chunk) => {
-            if (!stdinWrapper.destroyed) {
-              try {
-                stdinWrapper.write(chunk);
-              } catch (e) { /* ignore write-after-destroy */ }
-            }
-          };
-          realStdin.on('data', stdinForwarder);
-        }
-
-        inkStdin = stdinWrapper;
-      }
-
-      const { unmount, waitUntilExit } = render(
-        React.createElement(DashboardApp, { flowmind: fm, eventBus, asciiMode: asciiMode }),
-        { stdin: inkStdin }
-      );
-      await waitUntilExit();
-      unmount();
+      await launchInkApp({
+        element: React.createElement(DashboardApp, { flowmind: fm, eventBus, asciiMode: asciiMode }),
+        stdin: process.stdin
+      });
     } catch (error) {
       console.error(chalk.red('Dashboard Error:'), error.message);
       if (error.message.includes('Cannot find module')) {
         console.log(chalk.yellow('Try running: npm install ink@3 react'));
       }
     } finally {
-      if (stdinForwarder) {
-        process.stdin.removeListener('data', stdinForwarder);
-      }
-      if (stdinWrapper && !stdinWrapper.destroyed) {
-        stdinWrapper.destroy();
-      }
       restoreTerminal();
     }
   });
@@ -1813,10 +1792,17 @@ program
     }
   });
 
+program
+  .command('check-update')
+  .description('Check whether a newer FlowMind version is available')
+  .action(async () => {
+    await runUpdateCheck();
+  });
+
 // Parse arguments
 const knownCommands = new Set([
   'init', 'process', 'p', 'learn', 'scenes', 'skills', 'skill', 'resource', 'res',
-  'stats', 'honor', 'config', 'ai', 'tui', 'dashboard', 'doctor', 'update', 'help'
+  'stats', 'honor', 'config', 'ai', 'tui', 'dashboard', 'doctor', 'update', 'check-update', 'help'
 ]);
 const cliArgs = process.argv.slice(2);
 

package/core/adapters/mcp-adapter.js

@@ -66,15 +66,10 @@ class McpAdapter extends BaseAdapter {
     return this.config.transport || this.config.mcpServerConfig || this.config.mcpTransport || {};
   }
 
-  async callMcpTool(localName, args = {}) {
-    const tool = this.resolveTool(localName);
-    if (!tool) {
-      throw new Error(`Unknown MCP tool mapping: ${localName}`);
-    }
-
+  async callTool(tool, args = {}) {
     const transport = this.getTransportConfig();
     const serverName = this.mcpServer || this.providerName;
-    const response = await callMcpTool({
+    return callMcpTool({
       url: transport.url || transport.endpoint || transport.baseUrl,
       headers: transport.headers || {},
       tool,
@@ -82,8 +77,14 @@ class McpAdapter extends BaseAdapter {
       timeoutMs: transport.timeoutMs || 60000,
       serverName
     });
+  }
 
-    return response;
+  async callMcpTool(localName, args = {}) {
+    const tool = this.resolveTool(localName);
+    if (!tool) {
+      throw new Error(`Unknown MCP tool mapping: ${localName}`);
+    }
+    return this.callTool(tool, args);
   }
 }
 

package/core/ai/providers/mimo.js

@@ -82,7 +82,7 @@ class MiMoProvider extends BaseModel {
       ...super.getInfo(),
       model: this.model,
       baseUrl: this.baseUrl,
-      provider: 'Xiaomi'
+      provider: 'MiMo'
     };
   }
 }

package/core/cli-ink.js

@@ -0,0 +1,79 @@
+const { PassThrough } = require('stream');
+const { shouldProxyInkStdin } = require('./utils');
+
+function registerJsxExtension() {
+  require('module')._extensions['.jsx'] = require('module')._extensions['.js'];
+}
+
+function createInkStdinProxy(realStdin) {
+  if (!realStdin) {
+    return { stdin: null, wrapper: null, forwarder: null };
+  }
+
+  const wrapper = new PassThrough();
+  wrapper.isTTY = true;
+  wrapper.isRaw = false;
+  wrapper.setRawMode = (mode) => {
+    try {
+      if (realStdin.setRawMode) {
+        realStdin.setRawMode(mode);
+      }
+    } catch (error) {
+      // Ignore raw mode failures in wrapped environments.
+    }
+    return wrapper;
+  };
+
+  let forwarder = null;
+  if (realStdin.readable) {
+    forwarder = (chunk) => {
+      if (!wrapper.destroyed) {
+        try {
+          wrapper.write(chunk);
+        } catch (error) {
+          // Ignore write-after-destroy errors while shutting down.
+        }
+      }
+    };
+    realStdin.on('data', forwarder);
+  }
+
+  return { stdin: wrapper, wrapper, forwarder };
+}
+
+function cleanupInkStdinProxy(realStdin, proxy) {
+  if (!proxy) return;
+
+  if (proxy.forwarder && realStdin?.removeListener) {
+    realStdin.removeListener('data', proxy.forwarder);
+  }
+
+  if (proxy.wrapper && !proxy.wrapper.destroyed) {
+    proxy.wrapper.destroy();
+  }
+}
+
+async function launchInkApp({ element, stdin = process.stdin }) {
+  registerJsxExtension();
+  const { render } = require('ink');
+  const proxy = shouldProxyInkStdin(stdin) ? createInkStdinProxy(stdin) : { stdin: null, wrapper: null, forwarder: null };
+  let unmount = null;
+
+  try {
+    const rendered = render(element, { stdin: proxy.stdin || stdin });
+    unmount = rendered.unmount;
+    await rendered.waitUntilExit();
+  } finally {
+    if (typeof unmount === 'function') {
+      unmount();
+    }
+    cleanupInkStdinProxy(stdin, proxy);
+  }
+}
+
+module.exports = {
+  cleanupInkStdinProxy,
+  createInkStdinProxy,
+  launchInkApp,
+  registerJsxExtension
+};

package/core/index.js

@@ -217,6 +217,7 @@ class FlowMind {
 
     // Execute skill
     const result = await skill.execute(input, enhancedContext);
+    const resolvedResult = await this.resolveDeferredMcpResult(result, skill, enhancedContext);
 
     if (resourceBinding?.id) {
       await this.learning.markResourceBindingUsed(resourceBinding.id, {
@@ -239,7 +240,144 @@ class FlowMind {
     // Award honor point for skill use
     await this.honor.award('skill_use', `Used skill: ${skill.name}`);
 
-    return result;
+    return resolvedResult;
+  }
+
+  async resolveDeferredMcpResult(result, skill, context = {}) {
+    const invocation = this.extractMcpInvocation(result);
+    if (!invocation) {
+      return result;
+    }
+
+    const adapter = this.resolveDeferredAdapter(invocation, skill, context);
+    if (!adapter) {
+      return result;
+    }
+
+    const executor = typeof adapter.callTool === 'function'
+      ? adapter.callTool.bind(adapter)
+      : typeof adapter.callMcpTool === 'function'
+        ? adapter.callMcpTool.bind(adapter)
+        : null;
+
+    if (!executor) {
+      return result;
+    }
+
+    try {
+      const execution = await executor(invocation.tool, invocation.args || {});
+      const resultData = result && typeof result === 'object' && !Array.isArray(result) && result.data && typeof result.data === 'object'
+        ? result.data
+        : {};
+
+      return {
+        ...result,
+        data: {
+          ...resultData,
+          execution,
+          mcpTool: invocation.tool,
+          mcpExecuted: true,
+          mcpServer: invocation.mcpServer || adapter.mcpServer || adapter.providerName
+        }
+      };
+    } catch (error) {
+      return {
+        ...result,
+        type: result?.type || 'error',
+        success: false,
+        message: result?.message || error.message,
+        data: {
+          ...(result && typeof result === 'object' && result.data && typeof result.data === 'object' ? result.data : {}),
+          mcpTool: invocation.tool,
+          mcpExecuted: false,
+          mcpError: error.message
+        }
+      };
+    }
+  }
+
+  extractMcpInvocation(result) {
+    if (!result || typeof result !== 'object') {
+      return null;
+    }
+
+    const candidates = [
+      result.data,
+      result
+    ];
+
+    for (const candidate of candidates) {
+      if (!candidate || typeof candidate !== 'object' || Array.isArray(candidate)) {
+        continue;
+      }
+
+      const tool = candidate.mcpTool || candidate.tool;
+      if (!tool || typeof tool !== 'string') {
+        continue;
+      }
+
+      const args = candidate.args || candidate.params || {};
+      if (args && typeof args !== 'object') {
+        continue;
+      }
+
+      return {
+        tool,
+        args,
+        mcpServer: candidate.mcpServer || null
+      };
+    }
+
+    return null;
+  }
+
+  resolveDeferredAdapter(invocation, skill, context = {}) {
+    const registry = context.componentRegistry || this.components;
+    if (!registry) {
+      return null;
+    }
+
+    const bindingComponentType = context.resourceBinding?.componentType || context.resolvedBinding?.componentType || null;
+    const skillComponentType = this.inferSkillComponentType(skill, context);
+    const componentTypes = [
+      bindingComponentType,
+      skillComponentType,
+      invocation.componentType
+    ].filter(Boolean);
+
+    for (const componentType of componentTypes) {
+      const adapter = registry.getAdapter(componentType);
+      if (adapter) {
+        return adapter;
+      }
+    }
+
+    if (typeof registry.getAll === 'function') {
+      const allAdapters = registry.getAll();
+      for (const entry of allAdapters) {
+        const adapter = registry.getAdapterByProvider?.(entry.type, entry.provider) || null;
+        if (adapter && (adapter.mcpServer === invocation.mcpServer || adapter.providerName === invocation.provider)) {
+          return adapter;
+        }
+      }
+    }
+
+    return null;
+  }
+
+  inferSkillComponentType(skill, context = {}) {
+    const name = skill?.name || context.currentSkill || '';
+    const mapping = {
+      'log-audit': 'logService',
+      'sls-log-audit': 'logService',
+      'yapi-sync-interface': 'apiDoc',
+      'yuque-sync-design': 'knowledgeBase',
+      'data-logic-validation': 'databaseQuery',
+      'resource-bind': null,
+      'auto-flow': 'workflow'
+    };
+
+    return mapping[name] || null;
   }
 
   /**