flowmind 1.4.8 → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [Unreleased]
+
+## [1.5.0] - 2026-07-01
+
+### Added
+- `resource --sync-sdd-agent` now imports local `sdd-agent` bindings, scenes, and component state into FlowMind without touching remote services
+- Passive learning can now auto-promote repeated resource-binding choices into reusable skill preferences after enough successful local runs
+- Passive scene learning can now turn repeated successful scene executions into reusable default scene preferences
+- `resource-bind` can now save business-specific MCP, address, token, namespace, and project bindings into local learning files
+- Runtime context now injects matched learned bindings so follow-up skills can reuse the saved business connection automatically
+
+### Changed
+- The CLI now treats direct text input as `process`, so `flowmind "..."` works without manually adding the subcommand
+- Resource overview output now exposes synced bindings, scene counts, and component activation state more clearly
+- Default config bootstrapping now seeds built-in values before reading local files, including passive learning thresholds
+
+### Fixed
+- Binding-style requests such as `绑定发布平台 mcp=friday-auto-flow token=xxx env=uat` now route through `resource-bind` reliably instead of being swallowed by execution skills
+- Startup now avoids a false `Missing required field: version` warning when local config files do not exist yet
+- `flowmind tui` and `flowmind dashboard` now refuse to start inside managed Codex/Claude-style CLI hosts where nested fullscreen input can terminate the outer session
+
 ## [1.4.8] - 2026-06-30
 
 ### Changed

package/bin/flowmind.js

@@ -14,6 +14,9 @@ const path = require('path');
 const { execSync } = require('child_process');
 const FlowMind = require('../core');
 const HonorEngine = require('../core/honor-engine');
+const { syncSddAgentToFlowMind } = require('../core/sdd-agent-sync');
+const { detectManagedCliHost, shouldUseAsciiUi, shouldProxyInkStdin, getNestedTuiGuardMessage } = require('../core/utils');
+const { isExitCommand } = require('../tui/ui');
 
 /**
  * Restore terminal to sane state (cancel raw mode, show cursor, reset colors)
@@ -714,19 +717,32 @@ program
 program
   .command('resource')
   .alias('res')
-  .description('Manage local resource files')
+  .description('Manage resource connections, learned bindings, and local resource files')
   .option('-l, --list [dir]', 'List resource directory')
   .option('-s, --show <file>', 'Show file content')
   .option('-e, --edit <file>', 'Edit file')
   .option('-c, --config', 'Show resource configuration')
+  .option('--sync-sdd-agent [dir]', 'Sync local SDD-Agent resources and scenes into FlowMind')
   .option('-j, --json', 'Output as JSON (for tool integration)')
   .action(async (options) => {
     try {
       const fm = await initFlowMind();
       const resourceConfig = fm.config.get('resources', {});
       const configDir = path.join(process.env.HOME || process.env.USERPROFILE, '.flowmind');
+      const componentStatus = fm.getComponentStatus ? fm.getComponentStatus() : {};
+      const bindings = await fm.learning.listResourceBindings();
 
-      if (options.config) {
+      if (options.syncSddAgent !== undefined) {
+        const summary = await syncSddAgentToFlowMind({
+          sourceDir: typeof options.syncSddAgent === 'string' ? options.syncSddAgent : undefined
+        });
+
+        if (options.json) {
+          console.log(JSON.stringify({ synced: summary }, null, 2));
+        } else {
+          displayResourceSyncSummary(summary);
+        }
+      } else if (options.config) {
         // Show resource configuration
         if (options.json) {
           console.log(JSON.stringify({ resources: resourceConfig }, null, 2));
@@ -752,7 +768,7 @@ program
         // Edit file
         const filePath = resolveResourcePath(options.edit, configDir);
         await openInEditor(filePath);
-      } else {
+      } else if (options.list !== undefined) {
         // List directory (default)
         const targetDir = options.list && typeof options.list === 'string'
           ? resolveResourcePath(options.list, configDir)
@@ -768,6 +784,20 @@ program
         } else {
           console.error(chalk.red(`Directory not found: ${targetDir}`));
         }
+      } else if (options.json) {
+        console.log(JSON.stringify({
+          resources: resourceConfig,
+          componentStatus,
+          bindings,
+          examples: getResourceSetupExamples()
+        }, null, 2));
+      } else {
+        displayResourceOverview({
+          resourceConfig,
+          componentStatus,
+          bindings,
+          configDir
+        });
       }
     } catch (error) {
       console.error(chalk.red('Error:'), error.message);
@@ -951,7 +981,7 @@ async function runInteractiveMode(fm) {
         break;
       }
 
-      if (input.toLowerCase() === 'exit' || input.toLowerCase() === 'quit') {
+      if (isExitCommand(input)) {
         console.log(chalk.cyan('\nGoodbye! FlowMind will remember your preferences. 👋\n'));
         break;
       }
@@ -1337,6 +1367,99 @@ function displayResourceConfig(config) {
   console.log(chalk.cyan('└─────────────────────────────────────────────────────┘'));
 }
 
+function getResourceSetupExamples() {
+  return [
+    'flowmind resource',
+    'flowmind resource --config',
+    'flowmind "绑定零售业务 mcp=yapi-mcp 地址=https://yapi.example.com token=xxx project=retail"',
+    'flowmind "绑定发布业务 mcp=friday-auto-flow token=xxx env=uat"',
+    'flowmind "同步零售业务接口到 YApi"',
+    'flowmind "部署零售服务到 UAT"'
+  ];
+}
+
+function maskSecret(value) {
+  if (!value) return null;
+  const stringValue = String(value);
+  if (stringValue.length <= 6) return '***';
+  return `${stringValue.slice(0, 3)}***${stringValue.slice(-2)}`;
+}
+
+function describeConnection(binding) {
+  const parts = [];
+  if (binding.mcpServer) parts.push(`mcp=${binding.mcpServer}`);
+  if (binding.connection?.address) parts.push(`address=${binding.connection.address}`);
+  if (binding.connection?.project) parts.push(`project=${binding.connection.project}`);
+  if (binding.connection?.namespace) parts.push(`namespace=${binding.connection.namespace}`);
+  if (binding.connection?.env) parts.push(`env=${binding.connection.env}`);
+  if (binding.connection?.token) parts.push(`token=${maskSecret(binding.connection.token)}`);
+  return parts;
+}
+
+function displayResourceOverview({ resourceConfig, componentStatus, bindings, configDir }) {
+  const configuredResources = Object.keys(resourceConfig || {});
+  const activeComponents = Object.entries(componentStatus || {}).filter(([, value]) => value?.active);
+
+  console.log(chalk.cyan('\nFlowMind Resource Overview'));
+  console.log(chalk.gray('─'.repeat(60)));
+  console.log(chalk.white(`Config dir: ${configDir}`));
+  console.log(chalk.white(`Configured resources: ${configuredResources.length}`));
+  console.log(chalk.white(`Active components: ${activeComponents.length}/${Object.keys(componentStatus || {}).length}`));
+  console.log(chalk.white(`Learned bindings: ${bindings.length}`));
+
+  console.log(chalk.cyan('\nActive Components'));
+  if (activeComponents.length === 0) {
+    console.log(chalk.gray('  (none)'));
+  } else {
+    for (const [name, info] of activeComponents) {
+      const provider = info.provider ? ` provider=${info.provider}` : '';
+      console.log(chalk.white(`  - ${name}${provider}`));
+    }
+  }
+
+  console.log(chalk.cyan('\nLearned Bindings'));
+  if (bindings.length === 0) {
+    console.log(chalk.gray('  (none)'));
+    console.log(chalk.gray('  Save one with natural language, for example:'));
+    console.log(chalk.white('  flowmind "绑定零售业务 mcp=yapi-mcp 地址=https://yapi.example.com token=xxx project=retail"'));
+  } else {
+    for (const binding of bindings.slice(0, 8)) {
+      const label = `${binding.business || 'default'} [${binding.componentType || 'unknown'}]`;
+      console.log(chalk.white(`  - ${label}`));
+      const details = describeConnection(binding);
+      if (details.length > 0) {
+        console.log(chalk.gray(`    ${details.join('  ')}`));
+      }
+    }
+    if (bindings.length > 8) {
+      console.log(chalk.gray(`  ... and ${bindings.length - 8} more`));
+    }
+  }
+
+  console.log(chalk.cyan('\nCommon Commands'));
+  for (const example of getResourceSetupExamples()) {
+    console.log(chalk.white(`  ${example}`));
+  }
+
+  console.log(chalk.cyan('\nNext Step'));
+  console.log(chalk.white('  For deployment workflows, bind `friday-auto-flow` first, then run your deploy request in natural language.'));
+}
+
+function displayResourceSyncSummary(summary) {
+  console.log(chalk.cyan('\nFlowMind Sync Complete'));
+  console.log(chalk.gray('─'.repeat(60)));
+  console.log(chalk.white(`Source: ${summary.sourceDir}`));
+  console.log(chalk.white(`Target: ${summary.targetDir}`));
+  console.log(chalk.white(`Bindings imported: ${summary.counts.importedBindings}`));
+  console.log(chalk.white(`Scenes imported: ${summary.counts.importedScenes}`));
+  console.log(chalk.white(`Components synced: ${summary.counts.components}`));
+  console.log(chalk.gray('\nLocal files updated:'));
+  console.log(chalk.white(`  ${summary.files.resourceConfig}`));
+  console.log(chalk.white(`  ${summary.files.componentConfig}`));
+  console.log(chalk.white(`  ${summary.files.resourceBindings}`));
+  console.log(chalk.white(`  ${summary.files.scenes}`));
+}
+
 function displayAIStatus(status) {
   console.log(chalk.cyan('\n┌─────────────────────────────────────────────────────┐'));
   console.log(chalk.cyan('│ AI Model Status                                     │'));
@@ -1404,10 +1527,19 @@ async function openInEditor(filePath) {
 program
   .command('tui')
   .description('Launch enhanced TUI with split panels, skill browser, and dragon display')
-  .action(async () => {
+  .option('--ascii', 'Force ASCII-safe terminal rendering')
+  .action(async (options) => {
     let stdinWrapper = null;
     let stdinForwarder = null;
     try {
+      const managedHost = detectManagedCliHost();
+      if (managedHost) {
+        console.error(chalk.red(`TUI is not supported inside ${managedHost.name}.`));
+        console.log(chalk.yellow(getNestedTuiGuardMessage(managedHost)));
+        process.exitCode = 1;
+        return;
+      }
+
       // Register .jsx extension for CJS
       require('module')._extensions['.jsx'] = require('module')._extensions['.js'];
 
@@ -1415,42 +1547,48 @@ program
       const { render } = require('ink');
       const { PassThrough } = require('stream');
       const App = require('../tui/app.jsx');
+      const asciiMode = options.ascii || shouldUseAsciiUi();
 
       const fm = await initFlowMind();
 
-      // Create a stdin wrapper to handle non-TTY environments (e.g., piped stdin).
-      // Ink v3's useInput hook calls setRawMode(true) which throws if stdin is not a TTY.
       const realStdin = process.stdin;
-      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
+      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;
         };
-        realStdin.on('data', stdinForwarder);
+        // 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 }),
-        { stdin: stdinWrapper }
+        React.createElement(App, { flowmind: fm, asciiMode: asciiMode }),
+        { stdin: inkStdin }
       );
       await waitUntilExit();
       unmount();
@@ -1475,10 +1613,19 @@ program
 program
   .command('dashboard')
   .description('Launch real-time monitoring dashboard for MCP activity and events')
-  .action(async () => {
+  .option('--ascii', 'Force ASCII-safe terminal rendering')
+  .action(async (options) => {
     let stdinWrapper = null;
     let stdinForwarder = null;
     try {
+      const managedHost = detectManagedCliHost();
+      if (managedHost) {
+        console.error(chalk.red(`Dashboard is not supported inside ${managedHost.name}.`));
+        console.log(chalk.yellow(getNestedTuiGuardMessage(managedHost)));
+        process.exitCode = 1;
+        return;
+      }
+
       // Register .jsx extension for CJS
       require('module')._extensions['.jsx'] = require('module')._extensions['.js'];
 
@@ -1487,38 +1634,45 @@ program
       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();
 
-      // Create a stdin wrapper to handle non-TTY environments
       const realStdin = process.stdin;
-      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 */ }
+      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;
         };
-        realStdin.on('data', stdinForwarder);
+        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 }),
-        { stdin: stdinWrapper }
+        React.createElement(DashboardApp, { flowmind: fm, eventBus, asciiMode: asciiMode }),
+        { stdin: inkStdin }
       );
       await waitUntilExit();
       unmount();
@@ -1660,6 +1814,16 @@ program
   });
 
 // Parse arguments
+const knownCommands = new Set([
+  'init', 'process', 'p', 'learn', 'scenes', 'skills', 'skill', 'resource', 'res',
+  'stats', 'honor', 'config', 'ai', 'tui', 'dashboard', 'doctor', 'update', 'help'
+]);
+const cliArgs = process.argv.slice(2);
+
+if (cliArgs.length > 0 && !cliArgs[0].startsWith('-') && !knownCommands.has(cliArgs[0])) {
+  process.argv.splice(2, 0, 'process');
+}
+
 program.parse(process.argv);
 
 // Default to interactive mode if no command specified

package/core/adapters/workflow-adapter.js

@@ -38,6 +38,15 @@ class WorkflowAdapter extends McpAdapter {
     throw new Error('Subclasses must implement startPipelineRun()');
   }
 
+  /**
+   * Start a batch pipeline run.
+   * @param {object} params
+   * @returns {Promise<object>}
+   */
+  async startBatchPipelineRun(params) {
+    throw new Error('Subclasses must implement startBatchPipelineRun()');
+  }
+
   /**
    * Get pipeline run status.
    * @param {string} pipelineId

package/core/config-manager.js

@@ -19,6 +19,8 @@ class ConfigManager {
    * Load configuration
    */
   async load() {
+    this.config = this.deepMerge({}, this.defaults);
+
     // Try to load from specified path
     if (this.configPath) {
       await this.loadFromFile(this.configPath);
@@ -181,7 +183,12 @@ class ConfigManager {
         autoApply: true,
         confidenceThreshold: 0.7,
         maxRecordsPerSkill: 100,
-        storagePath: path.join(this.getHomeDir(), '.flowmind', 'learning')
+        storagePath: path.join(this.getHomeDir(), '.flowmind', 'learning'),
+        autoPromote: {
+          enabled: true,
+          resourceBindingMinUses: 3,
+          sceneMinUses: 2
+        }
       },
 
       // Scene mapping settings

package/core/index.js

@@ -190,6 +190,7 @@ class FlowMind {
 
     // Get learning rules for this skill
     const learnings = await this.learning.getSkillLearnings(skill.name);
+    const resourceBinding = await this.learning.matchResourceBinding(input, skill.name);
 
     // Apply learning rules to context
     const enhancedContext = {
@@ -197,12 +198,21 @@ class FlowMind {
       flowmind: context.flowmind || this,
       currentSkill: context.currentSkill || skill.name,
       learnings: learnings,
-      preferences: await this.learning.getPreferences(skill.name)
+      preferences: await this.learning.getPreferences(skill.name),
+      resourceBinding
     };
 
     // Execute skill
     const result = await skill.execute(input, enhancedContext);
 
+    if (resourceBinding?.id) {
+      await this.learning.markResourceBindingUsed(resourceBinding.id, {
+        input,
+        skillName: skill.name,
+        currentSkill: enhancedContext.currentSkill
+      });
+    }
+
     const duration = Date.now() - skillStartTime;
 
     // Emit skill execution event
@@ -226,23 +236,29 @@ class FlowMind {
     const { scene, params } = sceneMatch;
     const results = [];
 
-    for (const step of scene.workflow.skills) {
-      const skill = this.skills.get(step.skill);
-      if (!skill) continue;
-
-      const stepContext = {
-        ...context,
-        params: { ...step.params, ...params },
-        previousResults: results,
-        flowmind: this,
-        currentSkill: step.skill
-      };
+    try {
+      for (const step of scene.workflow.skills) {
+        const skill = this.skills.get(step.skill);
+        if (!skill) continue;
+
+        const stepContext = {
+          ...context,
+          params: { ...step.params, ...params },
+          previousResults: results,
+          flowmind: this,
+          currentSkill: step.skill
+        };
 
-      const result = await this.executeWithLearning(skill, input, stepContext);
-      results.push({
-        skill: step.skill,
-        result: result
-      });
+        const result = await this.executeWithLearning(skill, input, stepContext);
+        results.push({
+          skill: step.skill,
+          result: result
+        });
+      }
+      await this.matcher.updateSceneStats(scene.id, true, { input });
+    } catch (error) {
+      await this.matcher.updateSceneStats(scene.id, false, { input });
+      throw error;
     }
 
     return {