@sylphx/flow 2.1.3 → 2.1.5

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @sylphx/flow
 
+## 2.1.5 (2025-11-28)
+
+### 🐛 Bug Fixes
+
+- **settings:** use MCP_SERVER_REGISTRY instead of hardcoded list ([79fb625](https://github.com/SylphxAI/flow/commit/79fb625c27f58f7f62902314d92c205fdc84a06e))
+
+### ♻️ Refactoring
+
+- **settings:** extract checkbox configuration handler ([66303bb](https://github.com/SylphxAI/flow/commit/66303bb21a5281e5f358c69b8a6c143f3866fa76))
+- **attach:** extract file attachment pure functions ([5723be3](https://github.com/SylphxAI/flow/commit/5723be3817804228014ceec8de27f267c990fbe8))
+- **targets:** extract shared pure functions for MCP transforms ([0bba2cb](https://github.com/SylphxAI/flow/commit/0bba2cbc4a4233e0d63a78875346a2e9c341d803))
+
+### 🔧 Chores
+
+- remove dead cursor target references ([bf16f75](https://github.com/SylphxAI/flow/commit/bf16f759ec4705ddf0a763ea0ef6c778c91ccbbe))
+
+## 2.1.4 (2025-11-28)
+
+### ♻️ Refactoring
+
+- **flow:** eliminate hardcoded target checks with Target interface ([1dc75f9](https://github.com/SylphxAI/flow/commit/1dc75f9d4936b51554b1d09bf8576f832ce131e9))
+
+### 🔧 Chores
+
+- apply @sylphx/doctor fixes for 100% health score ([ae55969](https://github.com/SylphxAI/flow/commit/ae5596924dab48675ff3100b40f67651e7ebe26f))
+- remove unused api.types.ts re-export file ([ad8f6a6](https://github.com/SylphxAI/flow/commit/ad8f6a6b8dcad75d2c0201f2286e52adccb728c7))
+- remove dead code and unused modules ([6eaa904](https://github.com/SylphxAI/flow/commit/6eaa90438dcb40f9508953e874bf8c04204ae017))
+
 ## 2.1.3
 
 ### Patch Changes

package/README.md

@@ -0,0 +1,44 @@
+# @sylphx/flow
+
+**One CLI to rule them all.**
+
+Unified orchestration layer for Claude Code, OpenCode, Cursor and all AI development tools. Auto-detection, auto-installation, auto-upgrade.
+
+## Installation
+
+```bash
+npm install -g @sylphx/flow
+```
+
+## Usage
+
+```bash
+# Run with a prompt
+sylphx-flow "your prompt here"
+
+# Configure settings
+sylphx-flow settings
+
+# Check status
+sylphx-flow status
+```
+
+## Features
+
+- **Auto-detect** - Automatically detects installed AI CLIs
+- **Auto-install** - Installs missing dependencies on demand
+- **Auto-upgrade** - Upgrades before each session
+- **Unified settings** - One configuration for all tools
+- **MEP system** - Minimal Effective Prompts for optimal context
+
+## Documentation
+
+See the [main repository](https://github.com/sylphxltd/flow) for full documentation.
+
+## License
+
+MIT License - see [LICENSE](../../LICENSE) file for details.
+
+---
+
+Powered by [@sylphx](https://github.com/SylphxAI)

package/package.json

@@ -1,75 +1,81 @@
 {
-  "name": "@sylphx/flow",
-  "version": "2.1.3",
-  "description": "One CLI to rule them all. Unified orchestration layer for Claude Code, OpenCode, Cursor and all AI development tools. Auto-detection, auto-installation, auto-upgrade.",
-  "type": "module",
-  "bin": {
-    "sylphx-flow": "./src/index.ts"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "scripts": {
-    "dev": "bun src/index.ts",
-    "start": "bun src/index.ts",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "type-check": "tsc --noEmit",
-    "prepublishOnly": "echo 'Using assets from packages/flow/assets'"
-  },
-  "dependencies": {
-    "commander": "^14.0.2",
-    "chalk": "^5.6.2",
-    "boxen": "^8.0.1",
-    "gradient-string": "^3.0.0",
-    "ora": "^9.0.0",
-    "inquirer": "^12.10.0",
-    "gray-matter": "^4.0.3",
-    "yaml": "^2.8.1",
-    "zod": "^4.1.12",
-    "debug": "^4.4.3"
-  },
-  "devDependencies": {
-    "@types/node": "^24.9.2",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.6"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "files": [
-    "src",
-    "assets",
-    "README.md",
-    "CHANGELOG.md",
-    "LOOP_MODE.md",
-    "UPGRADE.md",
-    "package.json"
-  ],
-  "keywords": [
-    "ai",
-    "automation",
-    "workflow",
-    "claude-code",
-    "opencode",
-    "cursor",
-    "cli",
-    "orchestration",
-    "unified",
-    "meta-layer",
-    "developer-tools",
-    "auto-install",
-    "auto-upgrade"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/sylphxltd/flow.git",
-    "directory": "packages/flow"
-  },
-  "bugs": {
-    "url": "https://github.com/sylphxltd/flow/issues"
-  },
-  "homepage": "https://github.com/sylphxltd/flow#readme",
-  "license": "MIT",
-  "author": "sylphxltd"
+	"name": "@sylphx/flow",
+	"version": "2.1.5",
+	"description": "One CLI to rule them all. Unified orchestration layer for Claude Code, OpenCode, Cursor and all AI development tools. Auto-detection, auto-installation, auto-upgrade.",
+	"type": "module",
+	"bin": {
+		"sylphx-flow": "./src/index.ts"
+	},
+	"exports": {
+		".": {
+			"import": "./src/index.ts",
+			"types": "./src/index.ts"
+		}
+	},
+	"engines": {
+		"node": ">=18.0.0"
+	},
+	"scripts": {
+		"dev": "bun src/index.ts",
+		"start": "bun src/index.ts",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"type-check": "tsc --noEmit",
+		"prepublishOnly": "echo 'Using assets from packages/flow/assets'"
+	},
+	"dependencies": {
+		"commander": "^14.0.2",
+		"chalk": "^5.6.2",
+		"boxen": "^8.0.1",
+		"gradient-string": "^3.0.0",
+		"ora": "^9.0.0",
+		"inquirer": "^12.10.0",
+		"gray-matter": "^4.0.3",
+		"yaml": "^2.8.1",
+		"zod": "^4.1.12",
+		"debug": "^4.4.3"
+	},
+	"devDependencies": {
+		"@types/node": "^24.9.2",
+		"typescript": "^5.9.3",
+		"vitest": "^4.0.6"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"files": [
+		"src",
+		"assets",
+		"README.md",
+		"CHANGELOG.md",
+		"LOOP_MODE.md",
+		"UPGRADE.md",
+		"package.json"
+	],
+	"keywords": [
+		"ai",
+		"automation",
+		"workflow",
+		"claude-code",
+		"opencode",
+		"cursor",
+		"cli",
+		"orchestration",
+		"unified",
+		"meta-layer",
+		"developer-tools",
+		"auto-install",
+		"auto-upgrade"
+	],
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/sylphxltd/flow.git",
+		"directory": "packages/flow"
+	},
+	"bugs": {
+		"url": "https://github.com/sylphxltd/flow/issues"
+	},
+	"homepage": "https://github.com/sylphxltd/flow#readme",
+	"license": "MIT",
+	"author": "sylphxltd"
 }

package/src/commands/flow/execute-v2.ts

@@ -7,26 +7,22 @@ import chalk from 'chalk';
 import inquirer from 'inquirer';
 import { FlowExecutor } from '../../core/flow-executor.js';
 import { targetManager } from '../../core/target-manager.js';
-import { UpgradeManager } from '../../core/upgrade-manager.js';
+import { AutoUpgrade } from '../../services/auto-upgrade.js';
+import { GlobalConfigService } from '../../services/global-config.js';
+import { TargetInstaller } from '../../services/target-installer.js';
+import type { RunCommandOptions } from '../../types.js';
+import { extractAgentInstructions, loadAgentContent } from '../../utils/agent-enhancer.js';
 import { showWelcome } from '../../utils/display/banner.js';
-import { loadAgentContent, extractAgentInstructions } from '../../utils/agent-enhancer.js';
 import { CLIError } from '../../utils/error-handler.js';
-import type { RunCommandOptions } from '../../types.js';
-import type { FlowOptions } from './types.js';
-import { resolvePrompt } from './prompt.js';
-import { GlobalConfigService } from '../../services/global-config.js';
 import { UserCancelledError } from '../../utils/errors.js';
-import { TargetInstaller } from '../../services/target-installer.js';
-import { AutoUpgrade } from '../../services/auto-upgrade.js';
-import { promptForTargetSelection, ensureTargetInstalled } from '../../utils/target-selection.js';
+import { ensureTargetInstalled, promptForTargetSelection } from '../../utils/target-selection.js';
+import { resolvePrompt } from './prompt.js';
+import type { FlowOptions } from './types.js';
 
 /**
  * Configure provider environment variables
  */
-function configureProviderEnv(
-  provider: 'kimi' | 'zai',
-  apiKey: string
-): void {
+function configureProviderEnv(provider: 'kimi' | 'zai', apiKey: string): void {
   const providerConfig = {
     kimi: {
       baseUrl: 'https://api.moonshot.cn/v1',
@@ -46,9 +42,7 @@ function configureProviderEnv(
 /**
  * Select and configure provider for Claude Code
  */
-async function selectProvider(
-  configService: GlobalConfigService
-): Promise<void> {
+async function selectProvider(configService: GlobalConfigService): Promise<void> {
   try {
     const providerConfig = await configService.loadProviderConfig();
     const defaultProvider = providerConfig.claudeCode.defaultProvider;
@@ -95,9 +89,10 @@ async function selectProvider(
     } else {
       console.log(chalk.green('✓ Using default Claude Code provider\n'));
     }
-  } catch (error: any) {
+  } catch (error: unknown) {
     // Handle user cancellation (Ctrl+C)
-    if (error.name === 'ExitPromptError' || error.message?.includes('force closed')) {
+    const err = error as Error & { name?: string };
+    if (err.name === 'ExitPromptError' || err.message?.includes('force closed')) {
       throw new UserCancelledError('Provider selection cancelled');
     }
     throw error;
@@ -107,7 +102,7 @@ async function selectProvider(
 /**
  * Execute command using target's executeCommand method
  */
-async function executeTargetCommand(
+function executeTargetCommand(
   targetId: string,
   systemPrompt: string,
   userPrompt: string,
@@ -173,7 +168,11 @@ export async function executeFlowV2(
     );
 
     const installation = targetInstaller.getInstallationInfo(selectedTargetId);
-    const installed = await ensureTargetInstalled(selectedTargetId, targetInstaller, installedTargets);
+    const installed = await ensureTargetInstalled(
+      selectedTargetId,
+      targetInstaller,
+      installedTargets
+    );
 
     if (!installed) {
       process.exit(1);
@@ -200,7 +199,11 @@ export async function executeFlowV2(
       );
 
       const installation = targetInstaller.getInstallationInfo(selectedTargetId);
-      const installed = await ensureTargetInstalled(selectedTargetId, targetInstaller, installedTargets);
+      const installed = await ensureTargetInstalled(
+        selectedTargetId,
+        targetInstaller,
+        installedTargets
+      );
 
       if (!installed) {
         process.exit(1);
@@ -225,7 +228,11 @@ export async function executeFlowV2(
 
       if (!installed) {
         // Installation failed - show error and exit
-        console.log(chalk.red(`\n✗ Cannot proceed: ${installation?.name} is not installed and auto-install failed`));
+        console.log(
+          chalk.red(
+            `\n✗ Cannot proceed: ${installation?.name} is not installed and auto-install failed`
+          )
+        );
         console.log(chalk.yellow('   Please either:'));
         console.log(chalk.cyan('   1. Install manually (see instructions above)'));
         console.log(chalk.cyan('   2. Change default target: sylphx-flow settings\n'));
@@ -242,16 +249,20 @@ export async function executeFlowV2(
 
   // Mode info
   if (options.merge) {
-    console.log(chalk.cyan('🔗 Merge mode: Flow settings will be merged with your existing settings'));
+    console.log(
+      chalk.cyan('🔗 Merge mode: Flow settings will be merged with your existing settings')
+    );
     console.log(chalk.dim('   Settings will be restored after execution\n'));
   } else {
-    console.log(chalk.yellow('🔄 Replace mode (default): All settings will use Flow configuration'));
+    console.log(
+      chalk.yellow('🔄 Replace mode (default): All settings will use Flow configuration')
+    );
     console.log(chalk.dim('   Use --merge to keep your existing settings\n'));
   }
 
   // Create executor
   const executor = new FlowExecutor();
-  const projectManager = executor.getProjectManager();
+  const _projectManager = executor.getProjectManager();
 
   // Step 2: Execute attach mode lifecycle
   try {
@@ -361,10 +372,7 @@ export async function executeFlowV2(
 /**
  * Main flow execution entry point
  */
-export async function executeFlow(
-  prompt: string | undefined,
-  options: FlowOptions
-): Promise<void> {
+export async function executeFlow(prompt: string | undefined, options: FlowOptions): Promise<void> {
   // Resolve prompt (handle file input)
   const resolvedPrompt = await resolvePrompt(prompt);
 

package/src/commands/flow/prompt.ts

@@ -3,8 +3,8 @@
  * Handle file input (@file.txt) and prompt loading
  */
 
-import path from 'node:path';
 import fs from 'node:fs/promises';
+import path from 'node:path';
 import chalk from 'chalk';
 
 /**
@@ -12,7 +12,9 @@ import chalk from 'chalk';
  * Supports @filename syntax: @prompt.txt or @/path/to/prompt.txt
  */
 export async function resolvePrompt(prompt: string | undefined): Promise<string | undefined> {
-  if (!prompt) return prompt;
+  if (!prompt) {
+    return prompt;
+  }
 
   // Check for file input syntax: @filename
   if (prompt.startsWith('@')) {
@@ -26,7 +28,7 @@ export async function resolvePrompt(prompt: string | undefined): Promise<string
       const content = await fs.readFile(resolvedPath, 'utf-8');
       console.log(chalk.dim(`  ✓ Loaded prompt from: ${filePath}\n`));
       return content.trim();
-    } catch (error) {
+    } catch (_error) {
       throw new Error(`Failed to read prompt file: ${filePath}`);
     }
   }

package/src/commands/flow/types.ts

@@ -2,8 +2,6 @@
  * Flow Command Types
  */
 
-import type { RunCommandOptions } from '../../types.js';
-
 export interface FlowOptions {
   target?: string;
   verbose?: boolean;

package/src/commands/flow-command.ts

@@ -3,10 +3,10 @@
  * Entry point for all flow-related CLI commands
  */
 
-import { Command } from 'commander';
-import chalk from 'chalk';
-import path from 'node:path';
 import fs from 'node:fs/promises';
+import path from 'node:path';
+import chalk from 'chalk';
+import { Command } from 'commander';
 import { StateDetector } from '../core/state-detector.js';
 import { UpgradeManager } from '../core/upgrade-manager.js';
 import { showWelcome } from '../utils/display/banner.js';
@@ -30,7 +30,10 @@ export const flowCommand = new Command('flow')
   .option('--merge', 'Merge Flow settings with existing settings (default: replace all)')
 
   // Prompt argument
-  .argument('[prompt]', 'Prompt to execute with agent (optional, supports @file.txt for file input)')
+  .argument(
+    '[prompt]',
+    'Prompt to execute with agent (optional, supports @file.txt for file input)'
+  )
 
   .action(async (prompt, options: FlowOptions) => {
     await executeFlow(prompt, options);
@@ -41,7 +44,7 @@ export const flowCommand = new Command('flow')
  */
 export const setupCommand = new Command('setup')
   .description('[DEPRECATED] No longer needed - Flow uses automatic attach mode')
-  .action(async () => {
+  .action(() => {
     console.log(chalk.yellow('⚠️  The "setup" command is deprecated.\n'));
     console.log(chalk.cyan('Flow now uses automatic attach mode:'));
     console.log(chalk.dim('   • No installation needed'));
@@ -118,23 +121,23 @@ export const doctorCommand = new Command('doctor')
         await executeFlow(undefined, { sync: true } as FlowOptions);
         console.log(chalk.green('  ✓ 已修复'));
       }
-    } else if (!state.initialized) {
+    } else if (state.initialized) {
+      console.log(chalk.green('  ✓ 配置正常'));
+    } else {
       console.log(chalk.yellow('  ⚠ 项目未初始化'));
       issuesFound = true;
-    } else {
-      console.log(chalk.green('  ✓ 配置正常'));
     }
 
     // Check 3: Components
     console.log('\n检查组件...');
     Object.entries(state.components).forEach(([name, component]) => {
       const status = component.installed ? chalk.green('✓') : chalk.red('✗');
-      const count = ('count' in component && component.count) ? ` (${component.count})` : '';
+      const count = 'count' in component && component.count ? ` (${component.count})` : '';
       console.log(`  ${status} ${name}${count}`);
     });
 
     // Summary
-    console.log('\n' + chalk.bold('结果:'));
+    console.log(`\n${chalk.bold('结果:')}`);
     if (!issuesFound) {
       console.log(chalk.green('✓ 所有检查通过'));
     } else if (options.fix) {
@@ -168,16 +171,20 @@ export const upgradeCommand = new Command('upgrade')
     }
 
     if (updates.flowVersion) {
-      console.log(`Sylphx Flow: ${updates.flowVersion.current} → ${chalk.green(updates.flowVersion.latest)}`);
+      console.log(
+        `Sylphx Flow: ${updates.flowVersion.current} → ${chalk.green(updates.flowVersion.latest)}`
+      );
     }
 
     if (updates.targetVersion) {
-      console.log(`${updates.targetVersion.current ? 'claude-code' : 'target'}: ${updates.targetVersion.current} → ${chalk.green(updates.targetVersion.latest)}`);
+      console.log(
+        `${updates.targetVersion.current ? 'claude-code' : 'target'}: ${updates.targetVersion.current} → ${chalk.green(updates.targetVersion.latest)}`
+      );
     }
 
     // Check only
     if (options.check) {
-      console.log('\n' + chalk.dim('Run without --check to upgrade'));
+      console.log(`\n${chalk.dim('Run without --check to upgrade')}`);
       return;
     }
 

package/src/commands/hook-command.ts

@@ -153,9 +153,7 @@ async function sendLinuxNotification(title: string, message: string): Promise<vo
   try {
     await execAsync('which notify-send');
     // Use Flow-themed spiral emoji as icon for Sylphx Flow
-    await execAsync(
-      `notify-send -i "🌀" "${escapeForShell(title)}" "${escapeForShell(message)}"`
-    );
+    await execAsync(`notify-send -i "🌀" "${escapeForShell(title)}" "${escapeForShell(message)}"`);
   } catch {
     // notify-send not available, skip notification silently
   }

package/src/commands/settings/checkbox-config.ts

@@ -0,0 +1,128 @@
+/**
+ * Generic checkbox configuration handler
+ * Pure functions for settings UI patterns
+ */
+
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface ConfigItem {
+  enabled: boolean;
+}
+
+export type ConfigMap = Record<string, ConfigItem>;
+
+export interface CheckboxConfigOptions<T extends string> {
+  /** Section title (e.g., "Agents Configuration") */
+  title: string;
+  /** Icon for the section (e.g., "🤖") */
+  icon: string;
+  /** Prompt message (e.g., "Select agents to enable:") */
+  message: string;
+  /** Available items with display names */
+  available: Record<T, string>;
+  /** Current config state */
+  current: ConfigMap;
+  /** Item type name for confirmation (e.g., "agents", "rules") */
+  itemType: string;
+}
+
+export interface CheckboxConfigResult<T extends string> {
+  selected: T[];
+  updated: ConfigMap;
+}
+
+// ============================================================================
+// Pure Functions
+// ============================================================================
+
+/**
+ * Get currently enabled keys from config
+ */
+export const getEnabledKeys = (config: ConfigMap): string[] =>
+  Object.keys(config).filter((key) => config[key]?.enabled);
+
+/**
+ * Build checkbox choices from available items
+ */
+export const buildChoices = <T extends string>(
+  available: Record<T, string>,
+  enabledKeys: string[]
+): Array<{ name: string; value: T; checked: boolean }> =>
+  Object.entries(available).map(([key, name]) => ({
+    name: name as string,
+    value: key as T,
+    checked: enabledKeys.includes(key),
+  }));
+
+/**
+ * Update config based on selection
+ * Returns new config object (immutable)
+ */
+export const updateConfig = <T extends string>(
+  available: Record<T, string>,
+  selected: T[]
+): ConfigMap => {
+  const updated: ConfigMap = {};
+  for (const key of Object.keys(available)) {
+    updated[key] = { enabled: selected.includes(key as T) };
+  }
+  return updated;
+};
+
+/**
+ * Print section header
+ */
+export const printHeader = (icon: string, title: string): void => {
+  console.log(chalk.cyan.bold(`\n━━━ ${icon} ${title}\n`));
+};
+
+/**
+ * Print confirmation message
+ */
+export const printConfirmation = (itemType: string, count: number): void => {
+  console.log(chalk.green(`\n✓ ${itemType} configuration saved`));
+  console.log(chalk.dim(`  Enabled ${itemType.toLowerCase()}: ${count}`));
+};
+
+// ============================================================================
+// Main Handler
+// ============================================================================
+
+/**
+ * Generic checkbox configuration handler
+ * Handles the common pattern of select → update → save
+ */
+export const handleCheckboxConfig = async <T extends string>(
+  options: CheckboxConfigOptions<T>
+): Promise<CheckboxConfigResult<T>> => {
+  const { title, icon, message, available, current, itemType } = options;
+
+  // Print header
+  printHeader(icon, title);
+
+  // Get current enabled items
+  const enabledKeys = getEnabledKeys(current);
+
+  // Show checkbox prompt
+  const { selected } = await inquirer.prompt([
+    {
+      type: 'checkbox',
+      name: 'selected',
+      message,
+      choices: buildChoices(available, enabledKeys),
+    },
+  ]);
+
+  // Update config
+  const updated = updateConfig(available, selected);
+
+  // Print confirmation
+  printConfirmation(itemType, selected.length);
+
+  return { selected, updated };
+};

package/src/commands/settings/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Settings utilities
+ * Shared handlers for settings UI patterns
+ */
+
+export * from './checkbox-config.js';