diff --git a/CHANGELOG.md b/CHANGELOG.md index a2b63424..e6cf4b0a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,125 @@ All notable changes to Claude Code Workflow (CCW) will be documented in this fil The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [3.2.3] - 2025-10-03 + +### ✨ Version Management System + +This release introduces a comprehensive version management and upgrade notification system. + +#### Added + +**New Command: `/version`**: +- **Purpose**: Display version information and check for updates from GitHub +- **Features**: + - Shows local and global installation versions + - Fetches latest stable release from GitHub API + - Displays latest development commit from main branch + - Compares installed versions with remote versions + - Provides upgrade recommendations with installation commands + - Supports both stable and development version tracking + +**Version Information Display**: +- **Local Version**: Shows project-specific installation (if exists) +- **Global Version**: Shows `~/.claude` installation with tracking mode +- **Latest Stable**: Displays latest release tag, name, and publish date +- **Latest Dev**: Shows latest commit hash, message, and date +- **Status Assessment**: Automatic version comparison and upgrade suggestions + +**Version Tracking Files**: +- **`.claude/version.json`**: Local project version tracking +- **`~/.claude/version.json`**: Global installation version tracking +- **Fields**: + - `version`: Version number or "latest" for main branch tracking + - `installation_mode`: "Local" or "Global" + - `installation_path`: Installation directory + - `source_branch`: Source branch (usually "main") + - `installation_date_utc`: ISO 8601 timestamp + +**GitHub API Integration**: +- **Latest Release**: `https://api.github.com/repos/catlog22/Claude-Code-Workflow/releases/latest` + - Extracts: `tag_name`, `name`, `published_at` +- **Latest Commit**: `https://api.github.com/repos/catlog22/Claude-Code-Workflow/commits/main` + - Extracts: `sha`, `commit.message`, `commit.author.date` +- **Timeout**: 30-second timeout for slow connections +- **Error Handling**: Graceful fallback for network errors + +**Command Output Scenarios**: + +1. **Up to date**: + ``` + ✅ You are on the latest stable version (3.2.3) + ``` + +2. **Upgrade available**: + ``` + ⬆️ A newer stable version is available: v3.2.3 + Your version: 3.2.2 + + To upgrade: + PowerShell: iex (iwr -useb https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.ps1) + Bash: bash <(curl -fsSL https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.sh) + ``` + +3. **Development version**: + ``` + ✨ You are running a development version (3.3.0-dev) + This is newer than the latest stable release (v3.2.3) + ``` + +#### Changed + +**Documentation Updates**: +- Added `/version` command reference to README.md +- Added version management documentation to README_CN.md +- Created comprehensive `.claude/commands/version.md` implementation guide +- Updated command tables with version management examples + +**Installation Scripts Enhancement**: +- Installation scripts now create `version.json` files automatically +- Track installation mode (local vs global) +- Record installation timestamp +- Support version tracking for both stable and development installations + +#### Technical Details + +**Implementation**: +- Uses simple bash commands (no jq dependency required) +- Fallback to grep/sed for JSON parsing +- Network calls with curl and error suppression +- Version comparison using `sort -V` for semantic versioning +- Cross-platform compatible (Windows Git Bash, Linux, macOS) + +**Command Structure**: +```bash +/version # Display version and check for updates +``` + +**No parameters required** - command automatically: +1. Checks local version file (`./.claude/version.json`) +2. Checks global version file (`~/.claude/version.json`) +3. Fetches latest release from GitHub +4. Fetches latest commit from main branch +5. Compares versions and provides recommendations + +#### Benefits + +**User Experience**: +- 🔍 Quick version check with single command +- 📊 Comprehensive version information display +- 🔄 Automatic upgrade notifications +- 📈 Development version tracking support +- 🌐 GitHub API integration for latest updates + +**DevOps**: +- 📁 Version tracking in both local and global installations +- 🕐 Installation timestamp for audit trails +- 🔀 Support for both stable and development branches +- ⚡ Fast execution with 30-second network timeout +- 🛡️ Graceful error handling for offline scenarios + +--- + ## [3.2.0] - 2025-10-02 ### 🔄 Test-Fix Workflow & Agent Architecture Simplification diff --git a/README.md b/README.md index 152b5ce7..567870e0 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@
-[![Version](https://img.shields.io/badge/version-v3.2.2-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases) +[![Version](https://img.shields.io/badge/version-v3.2.3-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases) [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]() [![MCP Tools](https://img.shields.io/badge/🔧_MCP_Tools-Experimental-orange.svg)](https://github.com/modelcontextprotocol) @@ -15,14 +15,14 @@ **Claude Code Workflow (CCW)** is a next-generation multi-agent automation framework that orchestrates complex software development tasks through intelligent workflow management and autonomous execution. -> **🎉 Latest: v3.2.2** - Independent test-gen workflow with cross-session context. See [CHANGELOG.md](CHANGELOG.md) for details. +> **🎉 Latest: v3.2.3** - Version management system with upgrade notifications. See [CHANGELOG.md](CHANGELOG.md) for details. > -> **What's New in v3.2.2**: -> - 🔄 Independent test session architecture (WFS-test-[source]) -> - 🤖 Automatic cross-session context gathering via metadata -> - 🧪 Integrated concept-enhanced analysis (Gemini + Codex parallel execution) -> - 📦 Reuses IMPL-*.json format with meta.type="test-fix" (zero breaking changes) -> - ⚡ 4-phase workflow: session → context → analysis → task generation +> **What's New in v3.2.3**: +> - 🔍 New `/version` command for checking installed versions +> - 📊 GitHub API integration for latest release detection +> - 🔄 Automatic upgrade notifications and recommendations +> - 📁 Version tracking in both local and global installations +> - ⚡ Quick version check with comprehensive status display --- @@ -263,6 +263,7 @@ After installation, run the following command to ensure CCW is working: | `/task:*` | Manage individual tasks (`create`, `breakdown`, `execute`, `replan`). | | `/update-memory-full` | Re-index the entire project documentation. | | `/update-memory-related` | Update documentation related to recent changes. | +| `/version` | Display version information and check for updates from GitHub. | --- diff --git a/README_CN.md b/README_CN.md index 420b776a..c43f0b1b 100644 --- a/README_CN.md +++ b/README_CN.md @@ -2,7 +2,7 @@
-[![Version](https://img.shields.io/badge/version-v3.2.2-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases) +[![Version](https://img.shields.io/badge/version-v3.2.3-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases) [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]() [![MCP工具](https://img.shields.io/badge/🔧_MCP工具-实验性-orange.svg)](https://github.com/modelcontextprotocol) @@ -15,14 +15,14 @@ **Claude Code Workflow (CCW)** 是一个新一代的多智能体自动化开发框架，通过智能工作流管理和自主执行来协调复杂的软件开发任务。 -> **🎉 最新版本: v3.2.2** - 独立测试生成工作流，支持跨会话上下文。详见 [CHANGELOG.md](CHANGELOG.md)。 +> **🎉 最新版本: v3.2.3** - 版本管理系统与升级通知。详见 [CHANGELOG.md](CHANGELOG.md)。 > -> **v3.2.2 版本新特性**: -> - 🔄 独立测试会话架构（WFS-test-[source]） -> - 🤖 通过元数据自动跨会话上下文收集 -> - 🧪 集成 concept-enhanced 分析（Gemini + Codex 并行执行） -> - 📦 复用 IMPL-*.json 格式，meta.type="test-fix"（零破坏性更改） -> - ⚡ 4 阶段工作流：会话 → 上下文 → 分析 → 任务生成 +> **v3.2.3 版本新特性**: +> - 🔍 新增 `/version` 命令用于检查已安装版本 +> - 📊 GitHub API 集成，获取最新版本信息 +> - 🔄 自动升级通知与建议 +> - 📁 支持本地和全局安装的版本跟踪 +> - ⚡ 一键版本检查，全面展示状态信息 --- @@ -263,6 +263,7 @@ bash <(curl -fsSL https://raw.githubusercontent.com/catlog22/Claude-Code-Workflo | `/task:*` | 管理单个任务（`create`, `breakdown`, `execute`, `replan`）。 | | `/update-memory-full` | 重新索引整个项目文档。 | | `/update-memory-related` | 更新与最近更改相关的文档。 | +| `/version` | 显示版本信息并检查 GitHub 更新。 | --- diff --git a/RELEASE_NOTES_v2.0.md b/RELEASE_NOTES_v2.0.md deleted file mode 100644 index 1a4ca108..00000000 --- a/RELEASE_NOTES_v2.0.md +++ /dev/null @@ -1,264 +0,0 @@ -# 🚀 Claude Code Workflow (CCW) v2.0.0 Release Notes - -**Release Date**: September 28, 2025 -**Release Type**: Major Version Release -**Repository**: https://github.com/catlog22/Claude-Code-Workflow - ---- - -## 📋 Overview - -Claude Code Workflow v2.0 represents a **major architectural evolution** with significant enhancements to the multi-agent automation framework. This release introduces a comprehensive four-layer architecture, enhanced workflow lifecycle management, and intelligent tech stack detection. - -> **🎯 Upgrade Recommendation**: This is a **breaking change release** with significant architectural improvements. Review the breaking changes section before upgrading. - ---- - -## 🌟 Major Features & Enhancements - -### 🏗️ **Four-Layer Architecture (NEW)** - -CCW now operates through four distinct architectural layers with defined responsibilities and data contracts: - -| Layer | Components | Data Flow | Integration Points | -|-------|------------|-----------|-------------------| -| **🖥️ Interface Layer** | CLI Commands, Gemini/Codex/Qwen Wrappers | User input → Commands → Agents | External CLI tools, approval modes | -| **📋 Session Layer** | `.active-[session]` markers, `workflow-session.json` | Session state → Task discovery | Atomic session switching | -| **📊 Task/Data Layer** | `.task/impl-*.json`, hierarchy management | Task definitions → Agent execution | JSON-first model, generated views | -| **🤖 Orchestration Layer** | Multi-agent coordination, dependency resolution | Agent outputs → Task updates | Intelligent execution flow | - -### 🔄 **Enhanced Workflow Lifecycle** - -Complete development lifecycle with quality gates at each phase: - -1. **💡 Brainstorm Phase** - Multi-perspective conceptual planning with role-based analysis -2. **📋 Plan Phase** - Structured implementation planning with task decomposition -3. **✅ Verify Phase** - Pre-execution validation using Gemini (strategic) + Codex (technical) -4. **⚡ Execute Phase** - Autonomous implementation with multi-agent orchestration -5. **🧪 Test Phase** - Automated test workflow generation with comprehensive coverage -6. **🔍 Review Phase** - Quality assurance and completion validation - -### 🧪 **Automated Test Generation** - -Comprehensive test workflow creation: -- **Implementation Analysis**: Scans completed IMPL-* tasks for test requirements -- **Multi-layered Testing**: Unit, Integration, E2E, Performance, Security tests -- **Agent Assignment**: Specialized test agents for different test types -- **Dependency Mapping**: Test execution follows implementation dependency chains - -### ✅ **Plan Verification System** - -Dual-engine validation before execution: -- **Gemini Strategic Analysis**: High-level feasibility and architectural soundness -- **Codex Technical Analysis**: Implementation details and technical feasibility -- **Cross-Validation**: Identifies conflicts between strategic vision and technical constraints -- **Improvement Suggestions**: Actionable recommendations before implementation begins - -### 🧠 **Smart Tech Stack Detection** - -Intelligent task-based loading of technology guidelines: -- **Automatic Detection**: Only loads tech stacks for development and code review tasks -- **Multi-Language Support**: TypeScript, React, Python, Java, Go, JavaScript -- **Performance Optimized**: Skips detection for non-relevant tasks -- **Context-Aware**: Applies appropriate tech stack principles to development work - -### 🔮 **Qwen CLI Integration** - -Full integration of Qwen CLI for architecture analysis and code generation: -- **Architecture Analysis**: System design patterns and code quality assessment -- **Code Generation**: Implementation scaffolding and component creation -- **Intelligent Modes**: Auto template selection and precise architectural planning - ---- - -## 📊 New Commands & Capabilities - -### **Issue Management Commands** -- `➕ /workflow:issue:create` - Create new project issues with priority and type -- `📋 /workflow:issue:list` - List and filter issues by status and assignment -- `📝 /workflow:issue:update` - Update existing issue status and assignments -- `✅ /workflow:issue:close` - Close completed issues with resolution reasons - -### **Enhanced Workflow Commands** -- `✅ /workflow:plan-verify` - Pre-execution validation using dual analysis -- `🧪 /workflow:test-gen` - Generate comprehensive test workflows -- `🎨 /workflow:brainstorm:artifacts` - Generate structured planning documents -- `🔍 /workflow:plan-deep` - Deep technical planning with Gemini analysis - -### **Qwen CLI Commands** -- `🔍 /qwen:analyze` - Architecture analysis and code quality assessment -- `💬 /qwen:chat` - Direct Qwen interaction for design discussions -- `⚡ /qwen:execute` - Intelligent implementation with YOLO permissions -- `🚀 /qwen:mode:auto` - Auto template selection and execution -- `🐛 /qwen:mode:bug-index` - Bug analysis and fix suggestions -- `📋 /qwen:mode:plan` - Architecture planning and analysis - ---- - -## 🔧 Technical Improvements - -### **Script & Tool Enhancements** -- **gemini-wrapper**: Improved token management and path handling -- **qwen-wrapper**: Streamlined execution and simplified interface -- **Cross-Platform**: Enhanced Windows path compatibility with proper quoting -- **Directory Navigation**: Intelligent context optimization for focused analysis - -### **Agent Improvements** -- **Flow Control**: Enhanced sequential execution with context accumulation -- **Context Assessment**: Smart tech stack loading for relevant tasks only -- **Error Handling**: Improved per-step error strategies -- **Variable Passing**: Context transfer between execution steps - -### **Documentation Overhaul** -- **Unified Structure**: Aligned English and Chinese documentation -- **Command Standardization**: Consistent syntax across all commands -- **Architecture Clarity**: Clear data flow and integration point descriptions -- **Version Synchronization**: Both language versions now reflect v2.0 features - ---- - -## 📈 Performance & Compatibility - -### **Performance Metrics** -| Metric | Performance | Details | -|--------|-------------|---------| -| 🔄 **Session Switching** | <10ms | Atomic marker file operations | -| 📊 **JSON Queries** | <1ms | Direct JSON access, no parsing overhead | -| 📝 **Doc Updates** | <30s | Medium projects, intelligent targeting | -| 🔍 **Context Loading** | <5s | Complex codebases with caching | -| ⚡ **Task Execution** | 10min timeout | Complex operations with error handling | - -### **System Requirements** -- **🖥️ OS**: Windows 10+, Ubuntu 18.04+, macOS 10.15+ -- **📦 Dependencies**: Git, Node.js (Gemini), Python 3.8+ (Codex) -- **💾 Storage**: ~50MB core + variable project data -- **🧠 Memory**: 512MB minimum, 2GB recommended - -### **Integration Requirements** -- **🔍 Gemini CLI**: Required for analysis and strategic planning workflows -- **🤖 Codex CLI**: Required for autonomous development and bug fixing -- **🔮 Qwen CLI**: Required for architecture analysis and code generation -- **📂 Git Repository**: Required for change tracking and version control - ---- - -## ⚠️ Breaking Changes - -### **Removed Components** -- **Python CLI Backend**: All `pycli` references and related scripts removed -- **Deprecated Scripts**: `install_pycli.sh`, `pycli`, `pycli.conf`, `tech-stack-loader.sh` -- **Legacy Commands**: Old path reading scripts and unused Python tools - -### **Command Syntax Changes** -- **Session Commands**: `/workflow:session list` → `/workflow:session:list` -- **File Naming**: Standardized to lowercase `.task/impl-*.json` -- **Session Markers**: Unified format `.active-[session]` - -### **Architecture Changes** -- **Data Model**: Migrated to JSON-first architecture -- **Session Management**: Atomic marker-based system -- **Task Structure**: Standardized hierarchy and status management - -### **Configuration Updates** -Required Gemini CLI configuration: -```json -{ - "contextFileName": "CLAUDE.md" -} -``` - ---- - -## 🚀 Migration Guide - -### **From v1.x to v2.0** - -1. **Update Configuration**: - ```bash - # Update Gemini CLI settings - echo '{"contextFileName": "CLAUDE.md"}' > ~/.gemini/settings.json - ``` - -2. **Clean Legacy Files**: - ```bash - # Remove old Python CLI references - rm -f .claude/scripts/pycli* - rm -f .claude/scripts/install_pycli.sh - ``` - -3. **Update Command Usage**: - ```bash - # Old syntax - /workflow:session list - - # New syntax - /workflow:session:list - ``` - -4. **Verify Installation**: - ```bash - /workflow:session:list - ``` - ---- - -## 📚 Documentation & Resources - -### **Updated Documentation** -- **README.md**: Complete v2.0 feature documentation -- **README_CN.md**: Chinese documentation with v2.0 alignment -- **Architecture Guides**: Four-layer system documentation -- **Command Reference**: Comprehensive CLI command tables - -### **Quick Start** -```bash -# Install CCW v2.0 -Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.ps1" -UseBasicParsing).Content - -# Verify installation -/workflow:session:list - -# Start first workflow -/workflow:session:start "My First Project" -``` - ---- - -## 🤝 Contributing & Support - -### **Development** -- **GitHub**: https://github.com/catlog22/Claude-Code-Workflow -- **Issues**: https://github.com/catlog22/Claude-Code-Workflow/issues -- **Discussions**: https://github.com/catlog22/Claude-Code-Workflow/discussions - -### **Community** -- **Documentation**: [Project Wiki](https://github.com/catlog22/Claude-Code-Workflow/wiki) -- **Changelog**: [Release History](CHANGELOG.md) -- **License**: MIT License - ---- - -## 🙏 Acknowledgments - -Special thanks to the community for feedback and contributions that made v2.0 possible. This release represents a significant step forward in automated development workflow capabilities. - ---- - -**🚀 Claude Code Workflow v2.0** - -*Professional software development workflow automation through intelligent multi-agent coordination and autonomous execution capabilities.* - ---- - -## 📝 Commit History Summary - -This release includes 15+ commits spanning major architectural improvements: - -- **5d08c53**: Smart tech stack detection for agents -- **b956943**: Workflow architecture documentation updates -- **8baca52**: README v2.0 alignment and four-layer architecture -- **0756682**: Python CLI cleanup and modernization -- **be4db94**: Concept evaluation framework addition -- **817f51c**: Qwen CLI integration and task commands - -For complete commit history, see: [GitHub Commits](https://github.com/catlog22/Claude-Code-Workflow/commits/main) \ No newline at end of file diff --git a/RELEASE_NOTES_v3.2.1.md b/RELEASE_NOTES_v3.2.1.md deleted file mode 100644 index 651b07f1..00000000 --- a/RELEASE_NOTES_v3.2.1.md +++ /dev/null @@ -1,142 +0,0 @@ -# 🔧 Claude Code Workflow (CCW) v3.2.1 Release Notes - -**Release Date**: October 2, 2025 -**Release Type**: Patch Release - Documentation Fix -**Repository**: https://github.com/catlog22/Claude-Code-Workflow - ---- - -## 📋 Overview - -CCW v3.2.1 is a critical documentation fix release that corrects `workflow-session.json` path references throughout the brainstorming workflow documentation. This ensures consistency with the architecture specification defined in `workflow-architecture.md`. - ---- - -## 🐛 Bug Fixes - -### **Documentation Path Corrections** - -**Issue**: Documentation incorrectly referenced `workflow-session.json` inside the `.brainstorming/` subdirectory - -**Impact**: -- Confusing path references in 9 brainstorming role documentation files -- Inconsistency with architectural specifications -- Potential runtime errors when commands attempt to read session metadata - -**Fixed Files** (9 total): -1. ✅ `data-architect.md` -2. ✅ `product-manager.md` -3. ✅ `product-owner.md` -4. ✅ `scrum-master.md` -5. ✅ `subject-matter-expert.md` -6. ✅ `ui-designer.md` -7. ✅ `ux-expert.md` -8. ✅ `auto-parallel.md` -9. ✅ `artifacts.md` - -**Corrections Applied**: -- ❌ **Incorrect**: `.workflow/WFS-{session}/.brainstorming/workflow-session.json` -- ✅ **Correct**: `.workflow/WFS-{session}/workflow-session.json` - ---- - -## 📐 Architecture Alignment - -### Confirmed Standard Structure -``` -.workflow/WFS-[topic-slug]/ -├── workflow-session.json # ✅ Session metadata (root level) -├── .brainstorming/ # Brainstorming artifacts subdirectory -│ └── topic-framework.md -├── IMPL_PLAN.md -├── TODO_LIST.md -└── .task/ - └── IMPL-*.json -``` - -### Key Points -- `workflow-session.json` is **always at session root level** -- `.brainstorming/` directory contains **only** framework and analysis files -- No session metadata files inside subdirectories - ---- - -## 📊 Changes Summary - -| Category | Files Changed | Lines Modified | -|----------|--------------|----------------| -| Documentation Fixes | 9 | 19 insertions, 18 deletions | -| Path Corrections | 8 role files | 2 corrections per file | -| Structure Clarifications | 1 artifacts file | Added architectural note | - ---- - -## ✅ Verification - -**Pre-Release Checks**: -- ✅ No incorrect `.brainstorming/workflow-session.json` references -- ✅ No legacy `session.json` references -- ✅ All brainstorming roles use correct paths -- ✅ Architecture consistency verified with Gemini analysis - ---- - -## 🔄 Upgrade Instructions - -### For Existing Users - -**No action required** - This is a documentation-only fix. - -1. Pull the latest changes: - ```bash - git pull origin main - ``` - -2. Review updated documentation: - - `.claude/commands/workflow/brainstorm/*.md` - -### For New Users - -Simply clone the repository with the correct documentation: -```bash -git clone https://github.com/catlog22/Claude-Code-Workflow.git -``` - ---- - -## 📚 Related Documentation - -- **Architecture Reference**: `.claude/workflows/workflow-architecture.md` -- **Brainstorming Commands**: `.claude/commands/workflow/brainstorm/` -- **Session Management**: `.claude/commands/workflow/session/` - ---- - -## 🙏 Acknowledgments - -Special thanks to the analysis tools used in this fix: -- **Gemini CLI**: Path verification and consistency checking -- **Codex**: Initial codebase analysis -- **Claude Code**: Documentation review and corrections - ---- - -## 🔗 Links - -- **Full Changelog**: [v3.2.0...v3.2.1](https://github.com/catlog22/Claude-Code-Workflow/compare/v3.2.0...v3.2.1) -- **Issues Fixed**: Documentation consistency issue -- **Previous Release**: [v3.2.0 Release Notes](RELEASE_NOTES_v3.2.0.md) - ---- - -## 📝 Notes - -- This is a **non-breaking change** - existing workflows will continue to function -- Documentation now correctly reflects the implemented architecture -- No code changes were necessary - this was purely a documentation correction - ---- - -**Contributors**: Claude Code Development Team -**License**: MIT -**Support**: [GitHub Issues](https://github.com/catlog22/Claude-Code-Workflow/issues) diff --git a/RELEASE_NOTES_v3.2.3.md b/RELEASE_NOTES_v3.2.3.md new file mode 100644 index 00000000..2c6367d2 --- /dev/null +++ b/RELEASE_NOTES_v3.2.3.md @@ -0,0 +1,252 @@ +# v3.2.3 - Version Management System + +## 🎉 Release Date +2025-10-03 + +## ✨ Overview + +This release introduces a comprehensive version management and upgrade notification system, making it easy to track your Claude Code Workflow installation and stay up-to-date with the latest releases. + +## 🆕 New Features + +### `/version` Command + +A powerful new command that provides complete version information and automatic update checking: + +**Features:** +- 📊 **Version Display**: Shows both local and global installation versions +- 🌐 **GitHub Integration**: Fetches latest stable release and development commits +- 🔄 **Smart Comparison**: Automatically compares installed version with latest available +- 💡 **Upgrade Recommendations**: Provides installation commands for easy upgrading +- ⚡ **Fast Execution**: 30-second timeout for network calls, graceful offline handling + +**Usage:** +```bash +/version +``` + +**Example Output:** +``` +Installation Status: +- Local: No project-specific installation +- Global: ✅ Installed at ~/.claude + - Version: v3.2.3 + - Installed: 2025-10-03T05:01:34Z + +Latest Releases: +- Stable: v3.2.3 (2025-10-03T04:10:08Z) + - v3.2.3: Version Management System +- Latest Commit: c5c36a2 (2025-10-03T05:00:06Z) + - fix: Optimize version command API calls and data extraction + +Status: ✅ You are on the latest stable version (3.2.3) +``` + +### Version Tracking System + +**Version Files:** +- `.claude/version.json` - Local project installation tracking +- `~/.claude/version.json` - Global installation tracking + +**Tracked Information:** +```json +{ + "version": "v3.2.3", + "installation_mode": "Global", + "installation_path": "C:\\Users\\username\\.claude", + "source_branch": "main", + "installation_date_utc": "2025-10-03T05:01:34Z" +} +``` + +### GitHub API Integration + +**Endpoints Used:** +- **Latest Release**: `https://api.github.com/repos/catlog22/Claude-Code-Workflow/releases/latest` + - Extracts: tag_name, release name, published date +- **Latest Commit**: `https://api.github.com/repos/catlog22/Claude-Code-Workflow/commits/main` + - Extracts: commit SHA, message, author date + +**Network Handling:** +- 30-second timeout for slow connections +- Graceful error handling for offline scenarios +- No external dependencies (uses curl and grep/sed) + +## 🔄 What's Changed + +### Documentation Updates + +**Updated Files:** +- ✅ `CHANGELOG.md` - Added comprehensive v3.2.3 release notes +- ✅ `README.md` - Updated version badge to v3.2.3, added `/version` command +- ✅ `README_CN.md` - Updated version badge and command reference (Chinese) +- ✅ `.claude/commands/version.md` - Complete implementation guide + +**Version References:** +- All version badges updated from v3.2.2 to v3.2.3 +- "What's New" sections updated with v3.2.3 features +- Command reference tables include `/version` command + +### Installation Scripts Enhancement + +**Future Enhancement** (for next release): +- Installation scripts will automatically create `version.json` files +- Track installation mode (local vs global) +- Record installation timestamp +- Support version tracking for both stable and development installations + +## 📋 Version Comparison Scenarios + +### Scenario 1: Up to Date +``` +✅ You are on the latest stable version (3.2.3) +``` + +### Scenario 2: Upgrade Available +``` +⬆️ A newer stable version is available: v3.2.4 +Your version: 3.2.3 + +To upgrade: +PowerShell: iex (iwr -useb https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.ps1) +Bash: bash <(curl -fsSL https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.sh) +``` + +### Scenario 3: Development Version +``` +✨ You are running a development version (3.3.0-dev) +This is newer than the latest stable release (v3.2.3) +``` + +## 🛠️ Technical Details + +### Implementation Highlights + +**Simple Bash Commands:** +- No jq dependency required (uses grep/sed for JSON parsing) +- Cross-platform compatible (Windows Git Bash, Linux, macOS) +- Version comparison using `sort -V` for semantic versioning +- Direct API access using curl with error suppression + +**Command Structure:** +```bash +# Check local version +test -f ./.claude/version.json && cat ./.claude/version.json + +# Check global version +test -f ~/.claude/version.json && cat ~/.claude/version.json + +# Fetch latest release (with timeout) +curl -fsSL "https://api.github.com/repos/catlog22/Claude-Code-Workflow/releases/latest" 2>/dev/null + +# Extract version +grep -o '"tag_name": *"[^"]*"' | cut -d'"' -f4 + +# Compare versions +printf "%s\n%s" "3.2.2" "3.2.3" | sort -V | tail -n 1 +``` + +## 📊 Benefits + +### User Experience +- 🔍 **Quick version check** with single command +- 📊 **Comprehensive information** display (local, global, stable, dev) +- 🔄 **Automatic upgrade notifications** when new versions available +- 📈 **Development version tracking** for cutting-edge features +- 🌐 **GitHub integration** for latest updates + +### DevOps +- 📁 **Version tracking** in both local and global installations +- 🕐 **Installation timestamp** for audit trails +- 🔀 **Support for both stable and development** branches +- ⚡ **Fast execution** with 30-second network timeout +- 🛡️ **Graceful error handling** for offline scenarios + +## 🔗 Related Commands + +- `/cli:cli-init` - Initialize CLI tool configurations +- `/workflow:session:list` - List workflow sessions +- `/update-memory-full` - Update project documentation + +## 📦 Installation + +### Fresh Installation + +**Windows (PowerShell):** +```powershell +iex (iwr -useb https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.ps1) +``` + +**Linux/macOS (Bash):** +```bash +bash <(curl -fsSL https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.sh) +``` + +### Upgrade from v3.2.2 + +Use the same installation commands above. The installer will automatically: +1. Detect your existing installation +2. Back up current files (if using `-BackupAll`) +3. Update to v3.2.3 +4. Create/update `version.json` files + +## 🐛 Bug Fixes + +- Fixed commit message extraction to handle JSON escape sequences +- Improved API endpoint from `/branches/main` to `/commits/main` for reliable commit info +- Added 30-second timeout to all network calls for slow connections +- Enhanced release name and published date extraction + +## 📚 Documentation + +### New Documentation +- `.claude/commands/version.md` - Complete command implementation guide + - API endpoints and usage + - Timeout configuration + - Error handling scenarios + - Simple bash command examples + +### Updated Documentation +- `CHANGELOG.md` - v3.2.3 release notes +- `README.md` - Version badge and command reference +- `README_CN.md` - Chinese version updates + +## 🙏 Credits + +This release includes contributions and improvements based on: +- GitHub API integration for version detection +- Cross-platform bash command compatibility +- User feedback on installation and upgrade processes + +## 📝 Notes + +- **Backward Compatible**: All existing commands and workflows continue to work +- **No Breaking Changes**: This is a minor release with new features only +- **Optional Feature**: `/version` command is entirely optional, existing workflows unaffected + +## 🚀 What's Next + +**Planned for v3.2.4:** +- Enhanced installation script to auto-create version.json +- Version tracking in all installation modes +- Automatic version detection during installation + +**Future Enhancements:** +- Auto-update functionality (opt-in) +- Version comparison in workflow sessions +- Release notes display in CLI + +--- + +**Full Changelog**: [v3.2.2...v3.2.3](https://github.com/catlog22/Claude-Code-Workflow/compare/v3.2.2...v3.2.3) + +**Installation:** +```bash +# One-line install (recommended) +bash <(curl -fsSL https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.sh) + +# Or use specific version tag +git clone -b v3.2.3 https://github.com/catlog22/Claude-Code-Workflow.git +``` + +🤖 Generated with [Claude Code](https://claude.com/claude-code)