mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-05 01:50:27 +08:00
release: v3.2.3 - Version Management System
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 <noreply@anthropic.com>
This commit is contained in:
catlog22
119
CHANGELOG.md
119
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
|
||||
|
||||
17
README.md
17
README.md
@@ -2,7 +2,7 @@
|
||||
|
||||
<div align="center">
|
||||
|
||||
[](https://github.com/catlog22/Claude-Code-Workflow/releases)
|
||||
[](https://github.com/catlog22/Claude-Code-Workflow/releases)
|
||||
[](LICENSE)
|
||||
[]()
|
||||
[](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. |
|
||||
|
||||
---
|
||||
|
||||
|
||||
17
README_CN.md
17
README_CN.md
@@ -2,7 +2,7 @@
|
||||
|
||||
<div align="center">
|
||||
|
||||
[](https://github.com/catlog22/Claude-Code-Workflow/releases)
|
||||
[](https://github.com/catlog22/Claude-Code-Workflow/releases)
|
||||
[](LICENSE)
|
||||
[]()
|
||||
[](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 更新。 |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -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)
|
||||
@@ -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)
|
||||
252
RELEASE_NOTES_v3.2.3.md
Normal file
252
RELEASE_NOTES_v3.2.3.md
Normal file
@@ -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)
|
||||
Reference in New Issue
Block a user