@sylphx/flow 1.7.0 → 1.8.1

package/src/commands/flow-orchestrator.ts

@@ -4,7 +4,7 @@
  */
 
 import chalk from 'chalk';
-import type { FlowOptions } from './flow-command.js';
+import type { FlowOptions } from './flow/types.js';
 import { StateDetector, type ProjectState } from '../core/state-detector.js';
 import { UpgradeManager } from '../core/upgrade-manager.js';
 import { targetManager } from '../core/target-manager.js';
@@ -165,7 +165,7 @@ export async function checkSyncStatus(
   if (!state.target) return;
 
   try {
-    const { buildSyncManifest } = await import('../utils/sync-utils.js');
+    const { buildSyncManifest } = await import('../utils/files/sync-utils.js');
     const target = targetManager.getTarget(state.target);
 
     if (target._tag === 'None') return;
@@ -210,9 +210,18 @@ export async function selectTarget(
 ): Promise<string | undefined> {
   // Force target selection when cleaning
   if (options.clean) {
-    const targetId = await targetManager.promptForTargetSelection();
-    console.log(chalk.green(`✅ Selected target: ${targetId}`));
-    return targetId;
+    try {
+      const targetId = await targetManager.promptForTargetSelection();
+      console.log(chalk.green(`✅ Selected target: ${targetId}`));
+      return targetId;
+    } catch (error) {
+      // User cancelled with Ctrl+C - exit gracefully
+      if (error instanceof Error && error.name === 'ExitPromptError') {
+        console.log('\n');
+        process.exit(0);
+      }
+      throw error;
+    }
   }
 
   // Use existing target or option

package/src/commands/hook-command.ts

@@ -14,7 +14,7 @@ import { exec } from 'node:child_process';
 import os from 'node:os';
 import { promisify } from 'node:util';
 import { Command } from 'commander';
-import { cli } from '../utils/cli-output.js';
+import { cli } from '../utils/display/cli-output.js';
 
 const execAsync = promisify(exec);
 

package/src/commands/init-core.ts

@@ -7,8 +7,8 @@ import chalk from 'chalk';
 import ora from 'ora';
 import { targetManager } from '../core/target-manager.js';
 import { CLIError } from '../utils/error-handler.js';
-import { projectSettings } from '../utils/settings.js';
-import { validateTarget } from '../utils/target-config.js';
+import { projectSettings } from '../utils/config/settings.js';
+import { validateTarget } from '../utils/config/target-config.js';
 import { ConfigService } from '../services/config-service.js';
 
 export interface InitOptions {
@@ -47,7 +47,16 @@ export async function selectAndValidateTarget(options: InitOptions): Promise<str
 
   // Target selection (with UI prompt if needed)
   if (!targetId) {
-    targetId = await targetManager.promptForTargetSelection();
+    try {
+      targetId = await targetManager.promptForTargetSelection();
+    } catch (error) {
+      // User cancelled with Ctrl+C - exit gracefully
+      if (error instanceof Error && error.name === 'ExitPromptError') {
+        console.log('\n');
+        process.exit(0);
+      }
+      throw error;
+    }
   }
 
   // Validate target

package/src/commands/run-command.ts

@@ -3,7 +3,7 @@ import path from 'node:path';
 import { Command } from 'commander';
 import { targetManager } from '../core/target-manager.js';
 import { CLIError } from '../utils/error-handler.js';
-import { getAgentsDir } from '../utils/paths.js';
+import { getAgentsDir } from '../utils/config/paths.js';
 
 export async function loadAgentContent(agentName: string, agentFilePath?: string): Promise<string> {
   const { enhanceAgentContent } = await import('../utils/agent-enhancer.js');

package/src/config/rules.ts

@@ -2,7 +2,7 @@
  * Rules configuration
  */
 
-import { getRuleFile } from '../utils/paths.js';
+import { getRuleFile } from '../utils/config/paths.js';
 
 export const CORE_RULES = {
   core: 'core.md',

package/src/core/error-handling.ts

@@ -3,7 +3,7 @@
  * Functional, composable error handling system
  */
 
-import { logger } from '../utils/logger.js';
+import { logger } from '../utils/display/logger.js';
 import type { Result } from './result.js';
 
 /**

package/src/core/loop-controller.ts

@@ -10,7 +10,7 @@
  */
 
 import chalk from 'chalk';
-import type { FlowOptions } from '../commands/flow-command.js';
+import type { FlowOptions } from '../commands/flow/types.js';
 
 export interface LoopOptions {
   enabled: boolean;

package/src/core/state-detector.ts

@@ -1,7 +1,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { projectSettings } from '../utils/settings.js';
+import { projectSettings } from '../utils/config/settings.js';
 import { targetManager } from './target-manager.js';
 import { ConfigService } from '../services/config-service.js';
 

package/src/core/target-manager.ts

@@ -10,7 +10,7 @@ import {
   isTargetImplemented,
 } from '../config/targets.js';
 import { getOrElse, isSome } from '../core/functional/option.js';
-import { projectSettings } from '../utils/settings.js';
+import { projectSettings } from '../utils/config/settings.js';
 
 /**
  * Target Manager interface

package/src/index.ts

@@ -15,8 +15,8 @@ import {
   setupCommand,
   doctorCommand,
   upgradeCommand,
-  executeFlow,
 } from './commands/flow-command.js';
+import { executeFlow } from './commands/flow/execute.js';
 
 // Read version from package.json
 const __filename = fileURLToPath(import.meta.url);

package/src/shared/files/index.ts

@@ -8,7 +8,7 @@ import {
   getFileInfo,
   readDirectorySafe,
   readFileSafe,
-} from '../../utils/file-operations.js';
+} from '../../utils/files/file-operations.js';
 import type { ProcessResult } from '../types/index.js';
 
 /**

package/src/shared/processing/index.ts

@@ -3,7 +3,7 @@
  */
 
 import path from 'node:path';
-import { ensureDirectory, readFileSafe, writeFileSafe } from '../../utils/file-operations.js';
+import { ensureDirectory, readFileSafe, writeFileSafe } from '../../utils/files/file-operations.js';
 import { getLocalFileInfo } from '../files/index.js';
 import { log } from '../logging/index.js';
 import type { ProcessResult } from '../types/index.js';

package/src/targets/claude-code.ts

@@ -8,9 +8,9 @@ import { MCPInstaller } from '../core/installers/mcp-installer.js';
 import type { AgentMetadata } from '../types/target-config.types.js';
 import type { CommonOptions, MCPServerConfigUnion, SetupResult, Target } from '../types.js';
 import { CLIError } from '../utils/error-handler.js';
-import { getAgentsDir, getSlashCommandsDir } from '../utils/paths.js';
-import { sanitize } from '../utils/security.js';
-import { fileUtils, generateHelpText, pathUtils, yamlUtils } from '../utils/target-utils.js';
+import { getAgentsDir, getSlashCommandsDir } from '../utils/config/paths.js';
+import { sanitize } from '../utils/security/security.js';
+import { fileUtils, generateHelpText, pathUtils, yamlUtils } from '../utils/config/target-utils.js';
 
 /**
  * Claude Code target - composition approach with all original functionality

package/src/targets/opencode.ts

@@ -7,9 +7,9 @@ import { FileInstaller } from '../core/installers/file-installer.js';
 import { MCPInstaller } from '../core/installers/mcp-installer.js';
 import type { AgentMetadata } from '../types/target-config.types.js';
 import type { CommonOptions, MCPServerConfigUnion, SetupResult, Target } from '../types.js';
-import { getAgentsDir, getOutputStylesDir, getSlashCommandsDir } from '../utils/paths.js';
-import { secretUtils } from '../utils/secret-utils.js';
-import { fileUtils, generateHelpText, yamlUtils } from '../utils/target-utils.js';
+import { getAgentsDir, getOutputStylesDir, getSlashCommandsDir } from '../utils/config/paths.js';
+import { secretUtils } from '../utils/security/secret-utils.js';
+import { fileUtils, generateHelpText, yamlUtils } from '../utils/config/target-utils.js';
 import { CLIError } from '../utils/error-handler.js';
 
 /**

package/src/utils/agent-enhancer.ts

@@ -12,8 +12,8 @@
 
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { getOutputStylesDir, getRulesDir } from './paths.js';
-import { yamlUtils } from './target-utils.js';
+import { getOutputStylesDir, getRulesDir } from './config/paths.js';
+import { yamlUtils } from './config/target-utils.js';
 
 /**
  * Load and combine rules and output styles

package/src/utils/{mcp-config.ts → config/mcp-config.ts}

@@ -1,10 +1,10 @@
 import chalk from 'chalk';
 
 import inquirer from 'inquirer';
-import type { MCPServerID } from '../config/servers.js';
-import { getAllServerIDs, MCP_SERVER_REGISTRY } from '../config/servers.js';
-import { targetManager } from '../core/target-manager.js';
-import { getNestedProperty, setNestedProperty } from '../utils/target-config.js';
+import type { MCPServerID } from '../../config/servers.js';
+import { getAllServerIDs, MCP_SERVER_REGISTRY } from '../../config/servers.js';
+import { targetManager } from '../../core/target-manager.js';
+import { getNestedProperty, setNestedProperty } from './target-config.js';
 
 interface MCPConfigOptions {
   serverId?: MCPServerID;

package/src/utils/{paths.ts → config/paths.ts}

@@ -13,7 +13,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { pathSecurity } from './security.js';
+import { pathSecurity } from '../security/security.js';
 
 /**
  * Find package root by walking up directory tree

package/src/utils/{settings.ts → config/settings.ts}

@@ -5,7 +5,7 @@
 
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { type Result, success, tryCatchAsync } from '../core/functional/result.js';
+import { type Result, success, tryCatchAsync } from '../../core/functional/result.js';
 
 export interface ProjectSettings {
   /** Default target for the project */

package/src/utils/{target-config.ts → config/target-config.ts}

@@ -6,11 +6,11 @@ import {
   getSecretEnvVars,
   MCP_SERVER_REGISTRY,
   type MCPServerID,
-} from '../config/servers.js';
-import { targetManager } from '../core/target-manager.js';
-import { resolveConfig } from '../services/mcp-service.js';
-import { deleteNestedProperty, getNestedProperty, setNestedProperty } from './object-utils.js';
-import { secretUtils } from './secret-utils.js';
+} from '../../config/servers.js';
+import { targetManager } from '../../core/target-manager.js';
+import { resolveConfig } from '../../services/mcp-service.js';
+import { deleteNestedProperty, getNestedProperty, setNestedProperty } from '../object-utils.js';
+import { secretUtils } from '../security/secret-utils.js';
 
 /**
  * Target-specific MCP configuration utilities

package/src/utils/{target-utils.ts → config/target-utils.ts}

@@ -1,9 +1,9 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
-import type { MCPServerConfigUnion, TargetConfig } from '../types.js';
-import { readJSONCFile, writeJSONCFile } from './jsonc.js';
-import { pathSecurity, sanitize } from './security.js';
+import type { MCPServerConfigUnion, TargetConfig } from '../../types.js';
+import { readJSONCFile, writeJSONCFile } from '../files/jsonc.js';
+import { pathSecurity, sanitize } from '../security/security.js';
 
 /**
  * File system utilities for targets

package/src/utils/display/banner.ts

@@ -0,0 +1,25 @@
+/**
+ * Banner Display Utilities
+ * Welcome messages and branding
+ */
+
+import chalk from 'chalk';
+import boxen from 'boxen';
+
+/**
+ * Display welcome banner
+ */
+export function showWelcome(): void {
+  console.log(
+    boxen(
+      `${chalk.cyan.bold('Sylphx Flow')} ${chalk.dim('- AI-Powered Development Framework')}\n` +
+      `${chalk.dim('Auto-initialization • Smart upgrades • One-click launch')}`,
+      {
+        padding: 1,
+        margin: { bottom: 1 },
+        borderStyle: 'round',
+        borderColor: 'cyan',
+      }
+    )
+  );
+}

package/src/utils/display/status.ts

@@ -0,0 +1,55 @@
+/**
+ * Status Display Utilities
+ * Project status and component information
+ */
+
+import chalk from 'chalk';
+import type { ProjectState } from '../../core/state-detector.js';
+import { isVersionOutdated } from '../version.js';
+
+/**
+ * Display project status
+ */
+export async function showStatus(state: ProjectState): Promise<void> {
+  console.log(chalk.cyan.bold('📊 Project Status\n'));
+
+  if (!state.initialized) {
+    console.log('  ' + chalk.yellow('⚠  Not initialized'));
+  } else {
+    console.log(`  ${chalk.green('✓')} Initialized (Flow v${state.version || 'unknown'})`);
+
+    if (state.target) {
+      const versionStr = state.targetVersion ? ` (v${state.targetVersion})` : '';
+      console.log(`  ${chalk.green('✓')} Target platform: ${state.target}${versionStr}`);
+    }
+
+    // Component status
+    const components = state.components;
+    console.log(`\n  ${chalk.cyan('Components:')}`);
+    console.log(`    Agents: ${components.agents.installed ? chalk.green(`✓ ${components.agents.count}`) : chalk.red('✗')}`);
+    console.log(`    Rules: ${components.rules.installed ? chalk.green(`✓ ${components.rules.count}`) : chalk.red('✗')}`);
+    console.log(`    Hooks: ${components.hooks.installed ? chalk.green('✓') : chalk.red('✗')}`);
+    console.log(`    MCP: ${components.mcp.installed ? chalk.green(`✓ ${components.mcp.serverCount} servers`) : chalk.red('✗')}`);
+    console.log(`    Output styles: ${components.outputStyles.installed ? chalk.green('✓') : chalk.red('✗')}`);
+    console.log(`    Slash commands: ${components.slashCommands.installed ? chalk.green(`✓ ${components.slashCommands.count}`) : chalk.red('✗')}`);
+
+    // Outdated warnings
+    if (state.outdated) {
+      console.log(`\n  ${chalk.yellow('⚠')} Flow version outdated: ${state.version} → ${state.latestVersion}`);
+    }
+
+    if (state.targetVersion && state.targetLatestVersion &&
+        isVersionOutdated(state.targetVersion, state.targetLatestVersion)) {
+      console.log(`  ${chalk.yellow('⚠')} ${state.target} update available: v${state.targetVersion} → v${state.targetLatestVersion}`);
+    }
+
+    if (state.lastUpdated) {
+      const days = Math.floor((Date.now() - state.lastUpdated.getTime()) / (1000 * 60 * 60 * 24));
+      if (days > 7) {
+        console.log(`\n  ${chalk.yellow('⚠')} Last updated: ${days} days ago`);
+      }
+    }
+  }
+
+  console.log('');
+}

package/src/utils/{file-operations.ts → files/file-operations.ts}

@@ -5,8 +5,8 @@
 
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { pathSecurity } from './security.js';
-import { formatFileSize as formatFileSizeCore } from '../core/formatting/bytes.js';
+import { pathSecurity } from '../security/security.js';
+import { formatFileSize as formatFileSizeCore } from '../../core/formatting/bytes.js';
 
 export interface FileReadOptions {
   encoding?: BufferEncoding;

package/src/utils/files/jsonc.ts

@@ -0,0 +1,36 @@
+/**
+ * JSONC (JSON with Comments) utilities
+ * Simple parser for JSON files that support comments
+ */
+
+import fs from 'node:fs/promises';
+
+/**
+ * Remove comments from JSONC content
+ */
+function stripComments(content: string): string {
+  // Remove single-line comments (// ...)
+  let result = content.replace(/\/\/.*$/gm, '');
+
+  // Remove multi-line comments (/* ... */)
+  result = result.replace(/\/\*[\s\S]*?\*\//g, '');
+
+  return result;
+}
+
+/**
+ * Read and parse JSONC file
+ */
+export async function readJSONCFile(filePath: string): Promise<any> {
+  const content = await fs.readFile(filePath, 'utf-8');
+  const stripped = stripComments(content);
+  return JSON.parse(stripped);
+}
+
+/**
+ * Write JSONC file (writes as regular JSON)
+ */
+export async function writeJSONCFile(filePath: string, data: any): Promise<void> {
+  const content = JSON.stringify(data, null, 2);
+  await fs.writeFile(filePath, content, 'utf-8');
+}

package/src/utils/{sync-utils.ts → files/sync-utils.ts}

@@ -1,9 +1,9 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import chalk from 'chalk';
-import type { Target } from '../types.js';
-import { MCP_SERVER_REGISTRY } from '../config/servers.js';
-import { getAgentsDir, getSlashCommandsDir, getRulesDir } from './paths.js';
+import type { Target } from '../../types.js';
+import { MCP_SERVER_REGISTRY } from '../../config/servers.js';
+import { getAgentsDir, getSlashCommandsDir, getRulesDir } from '../config/paths.js';
 
 /**
  * Scan directory for .md files and return basenames

package/src/utils/index.ts

@@ -1,78 +1,59 @@
 /**
  * Centralized utility exports
- * Provides both legacy organization and new feature-based organization
+ * Feature-based organization for better modularity
  */
 
 // ============================================================================
-// FEATURE-BASED ORGANIZATION (Removed - migrated to domains/ and services/)
+// CONFIG & SETTINGS
 // ============================================================================
-// Features now organized in:
-// - src/domains/ for domain-specific logic
-// - src/services/ for shared infrastructure
+export * from './config/settings.js';
+export * from './config/mcp-config.js';
+export * from './config/target-config.js';
+export * from './config/target-utils.js';
+export * from './config/paths.js';
 
 // ============================================================================
-// LEGACY ORGANIZATION (Backward Compatibility)
+// DISPLAY & OUTPUT
 // ============================================================================
-// Direct exports for backward compatibility - @deprecated
+export * from './display/banner.js';
+export * from './display/status.js';
+export * from './display/cli-output.js';
+export * from './display/logger.js';
+export * from './display/notifications.js';
 
-export * from './cache-storage.js';
-export * from './database-errors.js';
-// Database utilities
-export * from './drizzle-storage.js';
-// Error handling
-export * from './error-handler.js';
-// File operations
-export * from './file-operations.js';
-// JSONC utilities
-export * from './jsonc.js';
-// Logger utilities
-export * from './logger.js';
-export * from './memory-storage.js';
-// Path utilities
-export * from './paths.js';
-// Security utilities
-export * from './security.js';
-export * from './simplified-errors.js';
-// Target configuration
-export * from './target-config.js';
-
-// Search and indexing - moved to services/search/
+// ============================================================================
+// FILES & SYNC
+// ============================================================================
+export * from './files/file-operations.js';
+export * from './files/sync-utils.js';
 
-// Command builder
-export * from './command-builder.js';
-// Console UI utilities
-export * from './console-ui.js';
-// Prompt utilities
-export * from './prompts.js';
-// Secret utilities
-export * from './secret-utils.js';
-// Template engine
-export * from './template-engine.js';
+// ============================================================================
+// SECURITY
+// ============================================================================
+export * from './security/security.js';
+export * from './security/secret-utils.js';
 
-// Embeddings and TF-IDF - moved to services/search/
+// ============================================================================
+// ERROR HANDLING
+// ============================================================================
+export * from './error-handler.js';
 
-// Help utilities
-export * from './help.js';
+// ============================================================================
+// VERSIONING
+// ============================================================================
+export * from './version.js';
 
-// Target utilities
-export * from './target-utils.js';
+// ============================================================================
+// AGENTS
+// ============================================================================
+export * from './agent-enhancer.js';
 
-// Migration examples - removed (obsolete)
-// Test utilities - removed (obsolete)
+// ============================================================================
+// FUNCTIONAL PROGRAMMING
+// ============================================================================
+export * from './functional.js';
 
-// Shared utilities
+// ============================================================================
+// SHARED UTILITIES
+// ============================================================================
 export * from '../shared/index.js';
-
-// Base indexer - moved to services/search/
-
-// LanceDB vector storage
-export * from './lancedb-vector-storage.js';
-// Separated storage
-export * from './separated-storage.js';
-// Settings utilities
-export * from './settings.js';
-
-// Target config types
-export * from './target-config.js';
-// Vector storage
-export * from './vector-storage.js';

package/src/utils/version.ts

@@ -0,0 +1,47 @@
+/**
+ * Version Utilities
+ * Semantic version comparison and validation
+ */
+
+/**
+ * Compare two semantic version strings
+ * @returns Negative if v1 < v2, positive if v1 > v2, zero if equal
+ */
+export function compareVersions(v1: string, v2: string): number {
+  const parts1 = v1.split('.').map(Number);
+  const parts2 = v2.split('.').map(Number);
+
+  for (let i = 0; i < Math.min(parts1.length, parts2.length); i++) {
+    if (parts1[i] !== parts2[i]) {
+      return parts1[i] - parts2[i];
+    }
+  }
+
+  return parts1.length - parts2.length;
+}
+
+/**
+ * Check if current version is outdated compared to latest
+ */
+export function isVersionOutdated(current: string, latest: string): boolean {
+  try {
+    return compareVersions(current, latest) < 0;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Parse version string into components
+ */
+export function parseVersion(version: string): { major: number; minor: number; patch: number } | null {
+  const parts = version.split('.').map(Number);
+  if (parts.length < 3 || parts.some(isNaN)) {
+    return null;
+  }
+  return {
+    major: parts[0],
+    minor: parts[1],
+    patch: parts[2],
+  };
+}