@codepack/workflow-cli/CHANGELOG.md

AI-powered workflow management CLI for developers

# Changelog

All notable changes to @codepack/workflow-cli will be documented in this file.

## [0.2.5] - 2025-07-06

### Added
- **Task Orchestrator**: Hook-based task orchestration for Claude Code
  - Automatic task assignment and instruction generation
  - Task completion detection via code markers
  - Session-aware task management
  - Hook integration for progress tracking
  - Support for continuous task execution
  
- **Orchestrate Command**: New command suite for task orchestration
  - `orchestrate start` - Start task orchestration with auto-assignment
  - `orchestrate stop` - Stop orchestration gracefully
  - `orchestrate current` - View current task instruction
  - `orchestrate config` - Configure orchestration settings
  - Hook callback commands for automated workflows
  
- **Enhanced Hook Integration**: Deeper Claude Code integration
  - Automatic hook setup in settings.local.json
  - Code edit detection hooks
  - Task completion hooks
  - Session start hooks
  
### Enhanced
- Task instruction generation with UTOPIA cycle guidance
- Project context detection (language, framework, commands)
- Task complexity and time estimation in instructions
- Simplified task prompts for quick reference

### Documentation
- Added comprehensive `ORCHESTRATE-GUIDE.md`
- Added `HOW-TO-24H-DEV.md` for 24-hour development guidance
- Example scripts for continuous development
- Troubleshooting guide for orchestration

### Technical
- Fixed grep-based completion marker detection
- Improved task state persistence
- Better error handling in orchestration
- Optimized hook timeout settings

## [0.2.4] - 2025-01-07

### Added
- **Team Collaboration System**: Complete multi-user support for team development
  - Team initialization and member management
  - Role-based permissions (owner/admin/member/viewer)
  - Skill-based task assignment
  - Real-time status tracking (available/busy/away/offline)
  
- **Task Assignment Features**: Intelligent task distribution
  - Manual and automatic assignment strategies
  - Skill-based recommendations
  - Round-robin and load-balanced assignment
  - Assignment history tracking
  
- **Real-time Sync**: Team state synchronization
  - 5-second auto-sync interval
  - Conflict resolution strategies
  - Optional encryption for sensitive data
  - Offline support with sync on reconnect
  
- **Team Dashboard**: Comprehensive team overview
  - Current tasks for all members
  - Activity timeline
  - Team availability status
  - Task duration tracking

- **Notification System**: Multi-channel real-time notifications
  - Server-Sent Events (SSE) for real-time push
  - MCP tool integration for AI notifications
  - File-based persistence
  - Webhook support for external integrations
  - Browser notification API support
  - Priority levels and action buttons

### Enhanced
- Task state now includes assignee and task type fields
- WorkflowManager supports team-aware task updates
- CLI includes new `team` command with subcommands
- Added `notify` command for notification management

### Commands
- `workflow team init` - Initialize team for project
- `workflow team add` - Add team member
- `workflow team list` - List all members
- `workflow team me` - Set/show current user
- `workflow team status` - Update availability
- `workflow team assign` - Assign tasks
- `workflow team activity` - Show team activity
- `workflow team dashboard` - Team overview
- `workflow team settings` - Configure team
- `workflow notify send` - Send notifications
- `workflow notify list` - View notifications
- `workflow notify server` - Start SSE server
- `workflow notify test` - Send test notification

## [0.2.3] - 2025-01-07

### Added
- **Task Template System**: Pre-built templates for common development tasks
  - 6 built-in templates across 5 categories (feature, bugfix, performance, security, documentation)
  - Create custom templates with `template create`
  - Use templates with variable substitution
  - Search and filter templates by category/tag

- **Dependency Visualization**: Multiple formats for visualizing task dependencies
  - Tree format: Hierarchical view with critical path highlighting
  - Graph format: ASCII box diagram (experimental)
  - Mermaid format: Export to Mermaid diagrams for documentation

### Enhanced
- Task split command now supports `--format tree/graph/mermaid` options
- Template system integrated with task splitting and auto-dev
- Better visual representation of task relationships

### Commands
- `workflow template list` - List available templates
- `workflow template show <id>` - Show template details
- `workflow template use <id>` - Create task from template
- `workflow template create` - Interactive template creation
- `workflow template search <query>` - Search templates

## [0.2.2] - 2025-01-07

### Added
- **Task Time Estimation**: Added `--estimate` flag to `task start` and new `task estimate` command
  - Smart time calculation based on task complexity (0-100 score)
  - Support for batch estimation from files
  - Multiple output formats (text/json)
  - Human-friendly duration formatting (minutes/hours/days)

- **Task Splitting**: New `task split` command for breaking down large tasks
  - Automatic subtask generation based on task type
  - Dependency management and critical path calculation
  - Multiple splitting strategies (balanced/sequential/parallel)
  - Gantt chart visualization
  - Save and load split results

- **Auto-Dev Mode**: 24-hour automated development with `auto-dev` command
  - Automatic task selection and prioritization
  - UTOPIA cycle execution (Understand→Think→Organize→Program→Inspect→Archive)
  - Auto-splitting for large tasks (>4 hours)
  - Dry-run mode for testing
  - Configurable pause between tasks
  - Optional auto-commit after task completion
  - Real-time status tracking and logging

### Changed
- Enhanced WorkflowManager with time estimation capabilities
- Improved task state to include split information
- Better task recommendations with time estimates

### Performance
- Task estimation using optimized algorithms
- Efficient critical path calculation for dependencies
- Minimal overhead in auto-dev mode

## [0.2.1] - 2025-01-05

### Published
- Successfully published to npm registry
- Available via `npm install -g @codepack/workflow-cli`

## [0.2.0] - 2025-01-05

### Added
- Complete test coverage (100% - 43/43 tests passing)
- Enhanced error handling in ServiceRegistry
- Better environment variable support in ConfigManager
- Import validation for configuration management
- Encrypted storage support for sensitive data
- **Enhanced Claude Code Integration**:
  - Automatic detection of Claude Code environment
  - Automatic configuration of permissions in settings.local.json
  - Command shortcuts in .claude/commands (/task, /kb, /workflow-init)
  - Optional safe hooks configuration
  - Symlink from .workflow to .claude/workflow for better integration
  - --claude and --no-hooks flags for init command
  - Support for CLAUDE_CODE and WORKFLOW_NO_HOOKS environment variables

### Fixed
- ConfigManager getNested null value handling
- ConfigManager environment variable nested object support
- ConfigManager import method validation logic
- ConfigManager encrypted storage test cases
- ServiceRegistry restart test logic and error propagation
- Init command configuration validation (schema alignment with WorkflowConfig interface)
- Task complete recommendation feature (correct analyzer method call)
- **Performance Issues with Hooks**:
  - Removed ts-node dependency from all hook scripts
  - All hooks now use compiled JavaScript for 50x+ performance improvement
  - Added timeout protection to prevent Claude Code crashes

### Changed
- Improved test timeout handling for long-running tests
- Better error messages for configuration validation failures
- More robust service restart mechanism with proper error throwing
- Task command now has 't' alias for shorter commands
- Init command now supports Claude Code integration options

### Technical Details
- Fixed `getNested` method to handle undefined values gracefully
- Enhanced `loadEnvironmentVariables` to correctly create nested objects from env vars
- Updated `workflowConfigSchema` to match `WorkflowConfig` interface structure
- Fixed `recommendNextTask` to use correct `analyzer.analyze` method
- Added proper error propagation in `handleServiceFailure` method
- Created `ClaudeIntegration` class for managing Claude Code setup
- All hook scripts converted from TypeScript to compiled JavaScript execution

## [0.1.0] - 2025-01-03

### Initial Release
- AI-powered workflow management CLI
- Task management (start, status, complete, list)
- Workflow templates (feature, bugfix, refactor)
- Knowledge base system
- Context engineering capabilities
- MCP integration support
- Multi-layer configuration system
- Service registry with health checks
- Event-driven architecture