@sylphx/flow 1.8.2 → 2.1.0

package/CHANGELOG.md

@@ -1,5 +1,164 @@
 # @sylphx/flow
 
+## 2.1.0
+
+### Minor Changes
+
+- 09608be: Auto-installation and auto-upgrade features
+
+  **New Features:**
+
+  - **Auto-detection**: Automatically detects installed AI CLIs (Claude Code, OpenCode, Cursor)
+  - **Auto-installation**: If no AI CLI is detected, prompts user to select and installs it automatically
+  - **Auto-upgrade**: Before each Flow execution, automatically checks and upgrades Flow and target CLI to latest versions
+  - **Zero-friction setup**: New users can install Flow and start using it immediately without manual setup
+
+  **Implementation:**
+
+  - Created `TargetInstaller` service for detecting and installing AI CLI tools
+  - Created `AutoUpgrade` service for automatic version checking and upgrading
+  - Integrated both services into execution flow (`execute-v2.ts`)
+  - Smart package manager detection (npm, bun, pnpm, yarn)
+
+  **User Experience:**
+
+  Flow 2.0 now delivers on the promise of "One CLI to rule them all":
+
+  1. **First run**: User installs Flow → Flow detects no AI CLI → Prompts to select one → Installs it automatically
+  2. **Every run**: Flow checks for updates → Upgrades Flow and AI CLI to latest → Runs user's task
+
+  Example flow:
+
+  ```
+  $ npm install -g @sylphx/flow
+  $ sylphx-flow "build my app"
+
+  🔍 Detecting installed AI CLIs...
+  ⚠️  No AI CLI detected
+
+  ? No AI CLI detected. Which would you like to use?
+  ❯ Claude Code
+    OpenCode
+    Cursor
+
+  ✓ Claude Code installed successfully
+
+  🔄 Checking for updates...
+  ✓ Flow is up to date
+  ✓ Claude Code is up to date
+
+  🚀 Starting Flow session...
+  ```
+
+  **Philosophy:**
+
+  This implements Flow's core principle of "Transcendent Simplicity" - users don't need to know which AI CLI to use or how to install/upgrade it. Flow handles everything automatically.
+
+### Patch Changes
+
+- cc065f2: Code cleanup and refactoring
+
+  **Removed:**
+
+  - All legacy config migration code (~70 lines)
+  - OpenCode old directory cleanup logic (~16 lines)
+  - Deprecated FileInstaller and MCPInstaller classes (~60 lines)
+  - Unused deprecated exports (ALL_TARGETS, IMPLEMENTED_TARGETS)
+
+  **Refactored:**
+
+  - Migrated from class-based installers to functional API
+  - opencode.ts: Direct function calls instead of class wrappers
+  - claude-code.ts: Direct function calls instead of class wrappers
+
+  **Improved:**
+
+  - Removed ~179 lines of dead code
+  - Cleaner functional API
+  - Better code organization and modularity
+  - Comprehensive JSDoc documentation
+  - Consistent error handling patterns
+
+  **Result:**
+
+  - Zero technical debt
+  - Zero deprecated code
+  - Modern, maintainable codebase
+
+- edb043c: Fix target selection logic to properly distinguish between three cases
+
+  **Fixed:**
+
+  - Target selection now correctly handles three distinct scenarios:
+    1. User explicitly set "ask-every-time" → always prompt
+    2. User has no setting (undefined/null) → allow auto-detect
+    3. User has specific target → use that target
+
+  **Improved:**
+
+  - Better code clarity with explicit case handling
+  - More predictable behavior for different user preferences
+  - Enhanced logic comments for maintainability
+
+## 2.0.0
+
+### Major Changes
+
+- aaadcaa: Settings-based configuration and improved user experience
+
+  **New Features:**
+
+  - **Settings management**: Configure agents, rules, and output styles via `sylphx-flow settings`
+    - Select which agents are enabled
+    - Set default agent to use
+    - Enable/disable specific rules (core, code-standards, workspace)
+    - Enable/disable output styles (silent)
+  - **Settings-driven execution**: Flow respects your settings and only loads enabled components
+  - **Config files**: All settings stored in `~/.sylphx-flow/` (settings.json, flow-config.json, provider-config.json, mcp-config.json)
+  - **Git skip-worktree integration**: Flow automatically hides `.claude/` and `.opencode/` changes from git
+    - Uses `git update-index --skip-worktree` to hide Flow's temporary modifications
+    - Prevents LLM from seeing or committing Flow's settings changes
+    - Automatically restores git tracking after execution
+    - Works seamlessly with version-controlled settings
+
+  **Breaking Changes:**
+
+  - Removed `--quick` flag - no longer needed
+  - Removed first-run setup wizard - configs are created automatically with sensible defaults
+  - Agent loading now respects enabled rules and output styles from settings
+
+  **Improvements:**
+
+  - Config files are automatically initialized on first use with default values
+  - Provider selection happens inline when needed (if set to "ask-every-time")
+  - Fixed Ctrl+C handling to ensure settings are restored immediately
+  - Simplified CLI options - only `--merge` flag for attach strategy
+  - Default agent can be set in settings (falls back to 'coder' if not set)
+
+  **Ctrl+C Fix:**
+  When users press Ctrl+C during interactive prompts, the application now:
+
+  - Catches the cancellation gracefully
+  - Runs cleanup (restores backed-up settings)
+  - Shows a friendly cancellation message
+  - Exits cleanly
+
+  Previously, pressing Ctrl+C would exit immediately without restoring settings, requiring recovery on the next run.
+
+### Minor Changes
+
+- 9fa65d4: Add automatic upgrade detection with smart package manager support
+
+  - Auto-detect updates on startup with non-intrusive notifications
+  - Enhanced `upgrade` command with `--auto` flag for automatic installation
+  - Smart package manager detection (npm, bun, pnpm, yarn)
+  - Version checking against npm registry for both Flow and target platforms
+  - Package-manager-specific upgrade commands in notifications
+  - New UPGRADE.md documentation with package manager support
+  - Silent background checks that don't block execution
+  - Support for both interactive and automatic upgrade flows
+  - Comprehensive test coverage for package manager detection
+
 ## 1.8.2
 
 ### Patch Changes

package/UPGRADE.md

@@ -0,0 +1,151 @@
+# Upgrade Guide
+
+Flow 2.0 includes **automatic upgrade before every session** with smart package manager detection. No more manual version management—Flow keeps itself and your AI CLI tools up to date.
+
+## Auto-Upgrade on Every Execution
+
+**Before each Flow session**, Flow automatically:
+
+1. **Checks for Flow updates**: Compares installed version with npm registry
+2. **Checks for AI CLI updates**: Verifies Claude Code, OpenCode, or Cursor versions
+3. **Upgrades automatically**: Installs latest versions if available
+4. **Detects package manager**: Uses npm, bun, pnpm, or yarn based on your environment
+
+Example output:
+```
+🔄 Checking for updates...
+✓ Flow 2.0.0 → 2.1.0 (latest)
+✓ Claude Code 1.5.0 → 1.6.0 (latest)
+📦 Installing updates...
+✓ All tools upgraded
+
+🚀 Starting Flow session...
+```
+
+This happens automatically. No flags needed, no configuration required.
+
+## Manual Upgrade Check
+
+Check for available updates without installing:
+
+```bash
+sylphx-flow upgrade --check
+```
+
+## Upgrade Commands
+
+### Upgrade Sylphx Flow
+
+Upgrade to the latest version:
+
+```bash
+# Interactive upgrade (manual installation required)
+sylphx-flow upgrade
+
+# Automatic installation via npm
+sylphx-flow upgrade --auto
+```
+
+### Upgrade Target Platform
+
+Upgrade Claude Code or other target platforms:
+
+```bash
+# Interactive upgrade
+sylphx-flow upgrade --target
+
+# Automatic installation via npm
+sylphx-flow upgrade --target --auto
+```
+
+### Combined Upgrade
+
+Upgrade both Sylphx Flow and target platform:
+
+```bash
+sylphx-flow upgrade --target --auto
+```
+
+## Options
+
+- `--check` - Only check for updates, don't install
+- `--auto` - Automatically install updates via npm (no manual steps)
+- `--target` - Include target platform (Claude Code/OpenCode) upgrade
+- `--verbose` - Show detailed installation output
+
+## Package Manager Detection
+
+Sylphx Flow automatically detects which package manager you're using:
+
+1. **From Environment** (`npm_config_user_agent`): Most reliable when running as npm script
+2. **From Lock Files**: Checks for `bun.lock`, `pnpm-lock.yaml`, `yarn.lock`, or `package-lock.json`
+3. **Default**: Falls back to `npm` if no detection method works
+
+**Priority Order**: bun > pnpm > yarn > npm
+
+### Supported Package Managers
+
+| Package Manager | Global Install Command |
+|----------------|------------------------|
+| npm            | `npm install -g @sylphx/flow@latest` |
+| bun            | `bun install -g @sylphx/flow@latest` |
+| pnpm           | `pnpm install -g @sylphx/flow@latest` |
+| yarn           | `yarn global add @sylphx/flow@latest` |
+
+## How It Works
+
+1. **Version Detection**: Checks npm registry for latest published versions
+2. **Comparison**: Compares installed version with latest available
+3. **Package Manager Detection**: Automatically detects npm/bun/pnpm/yarn
+4. **Notification**: Shows update availability with package-manager-specific command
+5. **Installation**:
+   - Without `--auto`: Shows manual install command for your package manager
+   - With `--auto`: Runs the appropriate install command automatically
+
+## Philosophy: Always Latest
+
+Flow 2.0 embraces the principle of **always running the latest stable versions**. This ensures:
+
+- Latest features and improvements
+- Security patches applied immediately
+- Compatibility with newest AI models
+- Bug fixes without manual intervention
+
+Auto-upgrade cannot be disabled—it's core to Flow's philosophy of zero-friction excellence.
+
+## Troubleshooting
+
+### Auto-Install Fails
+
+If `--auto` installation fails, the error message will show the exact command to run manually. The command is tailored to your package manager:
+
+```bash
+# Example for bun users
+bun install -g @sylphx/flow@latest
+
+# Example for npm users
+npm install -g @sylphx/flow@latest
+```
+
+### Version Mismatch
+
+If you see version mismatches after upgrade, try:
+
+```bash
+# Re-sync components with latest templates
+sylphx-flow --sync
+```
+
+### Offline Mode
+
+Update checks require internet connection. If offline, checks will fail silently and won't block execution.
+
+## Version Compatibility
+
+Sylphx Flow follows semantic versioning:
+
+- **Patch** (1.8.x): Bug fixes, safe to upgrade
+- **Minor** (1.x.0): New features, backward compatible
+- **Major** (x.0.0): Breaking changes, check migration guide
+
+Always check CHANGELOG.md for breaking changes before upgrading major versions.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sylphx/flow",
-  "version": "1.8.2",
-  "description": "AI-powered development workflow automation with autonomous loop mode and smart configuration",
+  "version": "2.1.0",
+  "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"
@@ -43,18 +43,23 @@
     "README.md",
     "CHANGELOG.md",
     "LOOP_MODE.md",
+    "UPGRADE.md",
     "package.json"
   ],
   "keywords": [
     "ai",
     "automation",
     "workflow",
-    "claude",
+    "claude-code",
     "opencode",
+    "cursor",
     "cli",
-    "autonomous",
-    "loop-mode",
-    "developer-tools"
+    "orchestration",
+    "unified",
+    "meta-layer",
+    "developer-tools",
+    "auto-install",
+    "auto-upgrade"
   ],
   "repository": {
     "type": "git",