flowmind 1.5.4 → 1.5.7

package/CHANGELOG.md

@@ -1,6 +1,23 @@
 # Changelog
 
-## [Unreleased]
+## [1.5.7] - 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
+- TUI now checks npm for a newer release after startup and shows a non-blocking update reminder banner when one 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
 

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');
 
 /**
@@ -1606,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) {
@@ -1617,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();
     }
   });
@@ -1692,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) {
@@ -1703,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();
     }
   });
@@ -1890,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/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/log-query-parser.js

@@ -0,0 +1,324 @@
+function parseLogQueryParams(input, options = {}) {
+  const params = {};
+  const text = String(input || '');
+
+  const traceMatch = text.match(/(?:trace[_-]?id|调用链)\s*[:=]?\s*(\S+)/i);
+  if (traceMatch) params.traceId = traceMatch[1];
+
+  const naturalProjectService = options.allowNaturalService !== false || options.allowNaturalProject !== false
+    ? extractNaturalProjectServicePair(text)
+    : null;
+  if (naturalProjectService) {
+    if (naturalProjectService.project && !params.project) {
+      params.project = naturalProjectService.project;
+    }
+    if (naturalProjectService.service && !params.service) {
+      params.service = naturalProjectService.service;
+    }
+  }
+
+  const serviceMatch = text.match(/(?:服务|service)\s*[:=]?\s*(\S+)/i);
+  if (serviceMatch) {
+    params.service = serviceMatch[1];
+  } else if (!params.service && options.allowNaturalService !== false) {
+    const naturalService = extractNaturalService(text);
+    if (naturalService) {
+      params.service = naturalService;
+    }
+  }
+
+  const levelMatch = text.match(/(?:级别|level)\s*[:=]?\s*(ERROR|WARN|INFO|DEBUG)/i);
+  if (levelMatch) {
+    params.level = levelMatch[1].toUpperCase();
+  } else if (options.allowNaturalLevel !== false) {
+    const naturalLevel = extractNaturalLevel(text);
+    if (naturalLevel) {
+      params.level = naturalLevel;
+    }
+  }
+
+  const projectMatch = text.match(/(?:项目|project)\s*[:=]?\s*([A-Za-z][A-Za-z0-9._-]{2,})\b/i);
+  if (projectMatch) {
+    params.project = projectMatch[1];
+  } else if (!params.project && options.allowNaturalProject !== false) {
+    const naturalProject = extractNaturalProject(text);
+    if (naturalProject) {
+      params.project = naturalProject;
+    }
+  }
+
+  const logstoreMatch = text.match(/(?:logstore|日志库)\s*[:=]?\s*(\S+)/i);
+  if (logstoreMatch) params.logstore = logstoreMatch[1];
+
+  const envMatch = text.match(/(?:环境|env)\s*[:=]?\s*(test|uat|gray|prod)/i);
+  if (envMatch) params.env = envMatch[1].toLowerCase();
+
+  const keywordMatch = text.match(/(?:^|[^A-Za-z0-9._-])(?:关键词|keyword|搜索|search)(?![A-Za-z0-9._-])\s*[:=]?\s*(.+?)(?:\s*$)/i);
+  if (keywordMatch) {
+    params.keyword = keywordMatch[1].trim();
+  } else if (options.allowQuotedKeyword !== false) {
+    const quotedKeyword = extractQuotedText(text);
+    if (quotedKeyword) {
+      params.keyword = quotedKeyword;
+    }
+  }
+
+  if (!params.keyword && options.allowNaturalKeyword !== false) {
+    const naturalKeyword = extractNaturalKeyword(text);
+    if (naturalKeyword) {
+      params.keyword = naturalKeyword;
+    }
+  }
+
+  const timeWindow = extractTimeWindow(text);
+  if (timeWindow) {
+    params.timeRange = timeWindow.label;
+    params.from = timeWindow.from;
+    params.to = timeWindow.to;
+  } else {
+    const timeMatch = text.match(/(?:最近|last)\s*(\d+)\s*(分钟|小时|天|min|hour|day)/i);
+    if (timeMatch) {
+      params.timeRange = `last ${timeMatch[1]} ${timeMatch[2]}`;
+    }
+  }
+
+  return params;
+}
+
+function extractNaturalLevel(text) {
+  const normalized = String(text || '').toLowerCase();
+  if (/(错误|异常|报错|失败|宕机|超时|timeout|error|fail)/i.test(normalized)) {
+    return 'ERROR';
+  }
+  if (/(告警|警告|warning|warn)/i.test(normalized)) {
+    return 'WARN';
+  }
+  if (/(信息|info)/i.test(normalized)) {
+    return 'INFO';
+  }
+  if (/(调试|debug)/i.test(normalized)) {
+    return 'DEBUG';
+  }
+  return null;
+}
+
+function extractQuotedText(input) {
+  const quotedMatches = [...String(input || '').matchAll(/["'“”‘’]([^"'“”‘’]{2,})["'“”‘’]/g)];
+  if (quotedMatches.length === 0) {
+    return null;
+  }
+
+  let best = '';
+  for (const match of quotedMatches) {
+    const candidate = (match[1] || '').trim();
+    if (candidate.length > best.length) {
+      best = candidate;
+    }
+  }
+
+  return normalizeNaturalKeyword(best);
+}
+
+function extractNaturalKeyword(input) {
+  const text = String(input || '').trim();
+  if (!text) return null;
+
+  const patterns = [
+    /(?:日志|log(?:s| audit| analysis)?)[，,、:：\s]+([^。！？\n]{2,120}?)(?=(?:是\s*什么异常|是什么异常|怎么回事|为什么|什么原因|原因|报错|错误|异常|问题|$))/i,
+    /(?:日志|log(?:s| audit| analysis)?)[，,、:：\s]+([^。！？\n]{2,120}?)(?=$|\n|[。！？])/i
+  ];
+
+  for (const pattern of patterns) {
+    const match = text.match(pattern);
+    if (!match || !match[1]) continue;
+    const candidate = normalizeNaturalKeyword(match[1]);
+    if (candidate) {
+      return candidate;
+    }
+  }
+
+  return null;
+}
+
+function extractNaturalService(input) {
+  const text = String(input || '').trim();
+  if (!text) return null;
+
+  const patterns = [
+    /([A-Za-z][A-Za-z0-9._-]{2,})\s*项目(?:的)?\s*([A-Za-z][A-Za-z0-9._-]{2,})\s*(?:错误|异常|告警|故障|问题|调试|排查)?(?:日志|log|链路|trace|调用链)(?![A-Za-z0-9._-])/i,
+    /([A-Za-z][A-Za-z0-9._-]{2,})\s*(?:的)?\s*(?:错误|异常|告警|故障|问题|调试|排查)?(?:日志|log|链路|trace|调用链)(?![A-Za-z0-9._-])/i,
+    /(?:查|查询|查看|排查|分析|定位)?(?:下)?(?:服务|service|应用|app|系统|模块)?\s*([A-Za-z][A-Za-z0-9._-]{2,})\s*(?:的)?(?:错误|异常|告警|故障|问题|调试|排查)?(?:日志|log|链路|trace|调用链)(?![A-Za-z0-9._-])/i,
+    /(?:项目|project)\s*(?:的)?\s*([A-Za-z][A-Za-z0-9._-]{2,})\s*(?:错误|异常|告警|故障|问题|调试|排查)?(?:日志|log|链路|trace|调用链)(?![A-Za-z0-9._-])/i,
+    /(?:错误|异常|告警|故障|问题|调试|排查)?(?:日志|log|链路|trace)\s*[:：\s]*([A-Za-z][A-Za-z0-9._-]{2,})/i
+  ];
+
+  for (const pattern of patterns) {
+    const match = text.match(pattern);
+    if (!match || !match[1]) continue;
+    const candidate = normalizeEntityCandidate(match[1]);
+    if (candidate) {
+      return candidate;
+    }
+  }
+
+  return null;
+}
+
+function extractNaturalProject(input) {
+  const text = String(input || '').trim();
+  if (!text) return null;
+
+  const patterns = [
+    /([A-Za-z][A-Za-z0-9._-]{2,})\s*项目(?:的)?\s*[A-Za-z][A-Za-z0-9._-]{2,}\s*(?:错误|异常|告警|故障|问题|调试|排查)?(?:日志|log|链路|trace|调用链)(?![A-Za-z0-9._-])/i,
+    /(?:项目|project)\s*[:=]?\s*([A-Za-z][A-Za-z0-9._-]{2,})/i,
+    /([A-Za-z][A-Za-z0-9._-]{2,})\s*(?:项目|project)(?:的)?/i
+  ];
+
+  for (const pattern of patterns) {
+    const match = text.match(pattern);
+    if (!match || !match[1]) continue;
+    const candidate = normalizeEntityCandidate(match[1]);
+    if (candidate) {
+      return candidate;
+    }
+  }
+
+  return null;
+}
+
+function normalizeNaturalKeyword(value) {
+  const candidate = String(value || '')
+    .replace(/^[，,、:：\s]+/, '')
+    .replace(/[，,、:：\s]+$/, '')
+    .replace(/^(查询|查|查看|分析|定位|排查)\s*(?:下)?\s*/i, '')
+    .replace(/^(最近|近|过去|前)\s*\d+\s*(分钟|小时|天|min|hour|day)\s*的?/i, '')
+    .replace(/^(今天|今日|昨天|昨日|本周|这周|近7天|近24小时|近1小时|最近1小时|最近1天)\s*的?/i, '')
+    .replace(/^(下|下个|一下|一下子)/, '')
+    .trim();
+
+  if (!candidate) return null;
+  if (/^(日志|log|logs|错误|异常|报错|失败|问题|警告|告警|error|warn|info|debug)$/i.test(candidate)) {
+    return null;
+  }
+  if (/(?:项目|服务|日志|log|trace|调用链)/i.test(candidate) && /[A-Za-z][A-Za-z0-9._-]{2,}/.test(candidate)) {
+    return null;
+  }
+
+  return candidate;
+}
+
+function normalizeEntityCandidate(value) {
+  const candidate = String(value || '').trim();
+  if (!candidate) return null;
+  if (/^(日志|log|logs|错误|异常|报错|失败|问题|警告|告警|error|warn|info|debug)$/i.test(candidate)) {
+    return null;
+  }
+  return candidate;
+}
+
+function extractNaturalProjectServicePair(input) {
+  const text = String(input || '').trim();
+  if (!text) return null;
+
+  const patterns = [
+    /([A-Za-z][A-Za-z0-9._-]{2,})\s*项目(?:的)?\s*([A-Za-z][A-Za-z0-9._-]{2,})\b/i,
+    /(?:项目|project)\s*(?:的)?\s*([A-Za-z][A-Za-z0-9._-]{2,})\b/i
+  ];
+
+  for (const pattern of patterns) {
+    const match = text.match(pattern);
+    if (!match) continue;
+
+    if (match.length >= 3) {
+      const project = normalizeEntityCandidate(match[1]);
+      const service = normalizeEntityCandidate(match[2]);
+      if (project || service) {
+        return { project, service };
+      }
+    }
+
+    const service = normalizeEntityCandidate(match[1]);
+    if (service) {
+      return { service };
+    }
+  }
+
+  return null;
+}
+
+function extractTimeWindow(input) {
+  const text = String(input || '');
+  const now = new Date();
+
+  const recentMatch = text.match(/(?:最近|近|过去|前)\s*(\d+)\s*(分钟|小时|天|min|hour|day)/i);
+  if (recentMatch) {
+    const amount = Number(recentMatch[1]);
+    const unit = normalizeTimeUnit(recentMatch[2]);
+    if (Number.isFinite(amount) && amount > 0 && unit) {
+      const from = new Date(now.getTime() - amount * unitToMs(unit));
+      return {
+        label: `last ${amount} ${recentMatch[2]}`,
+        from: from.toISOString(),
+        to: now.toISOString()
+      };
+    }
+  }
+
+  if (/今天|今日/i.test(text)) {
+    const from = new Date(now);
+    from.setHours(0, 0, 0, 0);
+    return {
+      label: 'today',
+      from: from.toISOString(),
+      to: now.toISOString()
+    };
+  }
+
+  if (/昨天|昨日/i.test(text)) {
+    const to = new Date(now);
+    to.setHours(0, 0, 0, 0);
+    const from = new Date(to.getTime() - 24 * 60 * 60 * 1000);
+    return {
+      label: 'yesterday',
+      from: from.toISOString(),
+      to: to.toISOString()
+    };
+  }
+
+  if (/本周|这周|近7天/i.test(text)) {
+    const to = new Date(now);
+    const from = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
+    return {
+      label: 'last 7 days',
+      from: from.toISOString(),
+      to: to.toISOString()
+    };
+  }
+
+  return null;
+}
+
+function normalizeTimeUnit(unit) {
+  const text = String(unit || '').toLowerCase();
+  if (text === 'min' || text === 'minute' || text === 'minutes' || text === '分钟') return 'minute';
+  if (text === 'hour' || text === 'hours' || text === '小时') return 'hour';
+  if (text === 'day' || text === 'days' || text === '天') return 'day';
+  return null;
+}
+
+function unitToMs(unit) {
+  if (unit === 'minute') return 60 * 1000;
+  if (unit === 'hour') return 60 * 60 * 1000;
+  if (unit === 'day') return 24 * 60 * 60 * 1000;
+  return 0;
+}
+
+module.exports = {
+  detectNaturalLevel: extractNaturalLevel,
+  extractNaturalProject,
+  extractNaturalService,
+  extractNaturalKeyword,
+  extractQuotedText,
+  extractTimeWindow,
+  parseLogQueryParams
+};