From f549dfcc9bd7ffef8ba92977a22a68aa37086517 Mon Sep 17 00:00:00 2001 From: catlog22 Date: Fri, 3 Oct 2025 13:09:37 +0800 Subject: [PATCH] release: v3.2.3 - Version Management System MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add comprehensive version management and upgrade notification system: New Features: - Add /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 Documentation Updates: - Update CHANGELOG.md with v3.2.3 release notes - Update README.md version badge to v3.2.3 - Update README_CN.md with Chinese version documentation - Add RELEASE_NOTES_v3.2.3.md with detailed release information - Add /version command to command reference tables Cleanup: - Remove old release notes (RELEASE_NOTES_v2.0.md, RELEASE_NOTES_v3.2.1.md) Version Files: - Update ~/.claude/version.json to v3.2.3 ๐Ÿค– Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- CHANGELOG.md | 119 ++++++++++++++++++ README.md | 17 +-- README_CN.md | 17 +-- RELEASE_NOTES_v2.0.md | 264 ---------------------------------------- RELEASE_NOTES_v3.2.1.md | 142 --------------------- RELEASE_NOTES_v3.2.3.md | 252 ++++++++++++++++++++++++++++++++++++++ 6 files changed, 389 insertions(+), 422 deletions(-) delete mode 100644 RELEASE_NOTES_v2.0.md delete mode 100644 RELEASE_NOTES_v3.2.1.md create mode 100644 RELEASE_NOTES_v3.2.3.md 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)